From d52c9966bcf67d985c77752cbec8b4872f1b31cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 15:50:10 +0100
Subject: [PATCH 0001/4023] [2.x] Set up HydePHP v2

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0624889cb02..1fd59536328 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -1,4 +1,4 @@
-## [Unreleased] - YYYY-MM-DD
+## [v2-dev] - YYYY-MM-DD
 
 ### About
 

From cd0b22753dd991e1a6853355b1cfb682d8abdc25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:01:53 +0100
Subject: [PATCH 0002/4023] Reset release notes

---
 RELEASE_NOTES.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1fd59536328..3f1a32d1613 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,10 +10,10 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
-- Added info banners when dashboard content sections are empty in https://github.com/hydephp/develop/pull/1494
+- for new features.
 
 ### Changed
-- Shortened the path printed to console when using the dashboard to create a page in https://github.com/hydephp/develop/pull/1492
+- for changes in existing functionality.
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -22,8 +22,7 @@ This serves two purposes:
 - for now removed features.
 
 ### Fixed
-- Improved support for running HydePHP through the Phar archive in https://github.com/hydephp/develop/pull/1491
-- Fixed wrong section title in the dashboard page in https://github.com/hydephp/develop/pull/1493
+- for any bug fixes.
 
 ### Security
 - in case of vulnerabilities.

From 4e3a0c2a1ea3924923b8e5c6b519647fee075130 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 15:57:53 +0100
Subject: [PATCH 0003/4023] Deprecate GenerateSearch.php

---
 RELEASE_NOTES.md                                                | 2 +-
 .../src/Framework/Actions/PostBuildTasks/GenerateSearch.php     | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3f1a32d1613..9e868506daa 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -16,7 +16,7 @@ This serves two purposes:
 - for changes in existing functionality.
 
 ### Deprecated
-- for soon-to-be removed features.
+- \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
 
 ### Removed
 - for now removed features.
diff --git a/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php b/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php
index 991190ff4b2..a2d115a6e96 100644
--- a/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php
+++ b/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php
@@ -9,6 +9,7 @@
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
+/** @deprecated */
 class GenerateSearch extends PostBuildTask
 {
     use InteractsWithDirectories;

From d9eec2881648aab1742a18689257daf20668d79c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:11:45 +0100
Subject: [PATCH 0004/4023] Add new internal
 `GeneratesDocumentationSearchIndex::generate` method

---
 .../Actions/GeneratesDocumentationSearchIndex.php     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 1e0948e47cf..5e5882bf234 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -39,6 +39,17 @@ public static function handle(): string
         return $service->path;
     }
 
+    /**
+     * Generate the search index return it as a string.
+     */
+    public static function generate(): string
+    {
+        $service = new static();
+        $service->run();
+
+        return $service->index->toJson();
+    }
+
     protected function __construct()
     {
         $this->index = new Collection();

From feb99e9d681f802554e38a9235f856cdc651de63 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 15:59:24 +0100
Subject: [PATCH 0005/4023] Deprecate internal
 `GeneratesDocumentationSearchIndex::handle` method

---
 .../src/Framework/Actions/GeneratesDocumentationSearchIndex.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 5e5882bf234..85e17aa1448 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -26,7 +26,7 @@ class GeneratesDocumentationSearchIndex
     protected string $path;
 
     /**
-     * Generate the search index and save it to disk.
+     * @deprecated Generate the search index and save it to disk.
      *
      * @return string The path to the generated file.
      */

From 697e016fb300334e602576084775d28fd5b81d59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:10:43 +0100
Subject: [PATCH 0006/4023] Add experimental `InMemoryPage::getOutputPath`
 overload support

---
 RELEASE_NOTES.md                              |  2 +-
 packages/framework/src/Pages/InMemoryPage.php | 10 ++++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9e868506daa..18fd270e216 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,7 +10,7 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
-- for new features.
+- Add experimental InMemoryPage::getOutputPath overload support
 
 ### Changed
 - for changes in existing functionality.
diff --git a/packages/framework/src/Pages/InMemoryPage.php b/packages/framework/src/Pages/InMemoryPage.php
index 541e9356ec9..56a429344e2 100644
--- a/packages/framework/src/Pages/InMemoryPage.php
+++ b/packages/framework/src/Pages/InMemoryPage.php
@@ -82,6 +82,16 @@ public function getBladeView(): string
         return $this->view;
     }
 
+    /** @experimental Get the path to the output file for the page. */
+    public function getOutputPath(): string
+    {
+        if ($this->hasMacro('getOutputPath')) {
+            return $this->__call('getOutputPath', []);
+        }
+
+        return parent::getOutputPath();
+    }
+
     /**
      * Get the contents that will be saved to disk for this page.
      *

From d48918410f17c4ab6ede24d254d94fb58f228912 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:22:32 +0100
Subject: [PATCH 0007/4023] Add upgrade guide section

---
 RELEASE_NOTES.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3f1a32d1613..f5a0bd794e1 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -26,3 +26,7 @@ This serves two purposes:
 
 ### Security
 - in case of vulnerabilities.
+
+### Upgrade Guide
+
+If there are any breaking changes, include an upgrade guide here.

From 9bee9cd05ac3b1efb8eef8236b51804a5c6c5413 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:23:19 +0100
Subject: [PATCH 0008/4023] Update build task service to not call deprecated
 search generator

---
 .../framework/src/Framework/Services/BuildTaskService.php  | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/src/Framework/Services/BuildTaskService.php b/packages/framework/src/Framework/Services/BuildTaskService.php
index a976526e214..d2eb432a015 100644
--- a/packages/framework/src/Framework/Services/BuildTaskService.php
+++ b/packages/framework/src/Framework/Services/BuildTaskService.php
@@ -11,7 +11,6 @@
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
 use Hyde\Framework\Features\BuildTasks\PostBuildTask;
 use Hyde\Framework\Actions\PreBuildTasks\CleanSiteDirectory;
-use Hyde\Framework\Actions\PostBuildTasks\GenerateSearch;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateBuildManifest;
@@ -136,7 +135,6 @@ private function registerFrameworkTasks(): void
         $this->registerIf(GenerateBuildManifest::class, $this->canGenerateManifest());
         $this->registerIf(GenerateSitemap::class, $this->canGenerateSitemap());
         $this->registerIf(GenerateRssFeed::class, $this->canGenerateFeed());
-        $this->registerIf(GenerateSearch::class, $this->canGenerateSearch());
     }
 
     private function canCleanSiteDirectory(): bool
@@ -158,9 +156,4 @@ private function canGenerateFeed(): bool
     {
         return Features::rss();
     }
-
-    private function canGenerateSearch(): bool
-    {
-        return Features::hasDocumentationSearch();
-    }
 }

From c8937ad292344fc3bbb68adb9793627dbf343918 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:38:24 +0100
Subject: [PATCH 0009/4023] Update core extension to add search index as an in
 memory page

---
 .../src/Foundation/HydeCoreExtension.php        | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 6c48936a370..95f1963bfad 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -8,9 +8,12 @@
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Concerns\HydeExtension;
 use Hyde\Facades\Features;
+use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
 use function array_filter;
 use function array_keys;
@@ -28,4 +31,18 @@ public static function getPageClasses(): array
             DocumentationPage::class => Features::hasDocumentationPages(),
         ], fn (bool $value): bool => $value));
     }
+
+    public function discoverPages(PageCollection $collection): void
+    {
+        if (Features::hasDocumentationSearch()) {
+            $collection->addPage(tap(new InMemoryPage('search.json'), function (InMemoryPage $page): void {
+                $page->macro('compile', function (): string {
+                    return GeneratesDocumentationSearchIndex::generate();
+                });
+                $page->macro('getOutputPath', function (): string {
+                    return DocumentationPage::outputDirectory().'/search.json';
+                });
+            }));
+        }
+    }
 }

From 30f3ce6b809ede0b93b4007af67a6dc219eea681 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 17:00:56 +0100
Subject: [PATCH 0010/4023] Update core extension to inject search page during
 discovery

---
 packages/framework/src/Foundation/HydeCoreExtension.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 95f1963bfad..4f1784d1b8a 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -14,6 +14,7 @@
 use Hyde\Foundation\Concerns\HydeExtension;
 use Hyde\Facades\Features;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
+use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 
 use function array_filter;
 use function array_keys;
@@ -43,6 +44,10 @@ public function discoverPages(PageCollection $collection): void
                     return DocumentationPage::outputDirectory().'/search.json';
                 });
             }));
+
+            if (DocumentationSearchPage::enabled()) {
+                $collection->addPage(new DocumentationSearchPage());
+            }
         }
     }
 }

From 733b95f5995d43c5e01c5fda97019d29b6474df5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 17:06:34 +0100
Subject: [PATCH 0011/4023] Hide dynamic search pages from navigation

---
 packages/framework/src/Foundation/HydeCoreExtension.php         | 2 +-
 .../Features/Documentation/DocumentationSearchPage.php          | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 4f1784d1b8a..27c0706a93c 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -36,7 +36,7 @@ public static function getPageClasses(): array
     public function discoverPages(PageCollection $collection): void
     {
         if (Features::hasDocumentationSearch()) {
-            $collection->addPage(tap(new InMemoryPage('search.json'), function (InMemoryPage $page): void {
+            $collection->addPage(tap(new InMemoryPage('search.json', ['navigation' => ['hidden' => true]]), function (InMemoryPage $page): void {
                 $page->macro('compile', function (): string {
                     return GeneratesDocumentationSearchIndex::generate();
                 });
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 4563eb45337..f58ff0b83ca 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -36,6 +36,7 @@ public function __construct()
     {
         parent::__construct('search', [
             'title' => 'Search',
+            'navigation' => ['hidden' => true],
         ]);
     }
 

From 8bfe35ea59f0463ed0d585d77c0d74d13ac3a177 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 17:54:55 +0100
Subject: [PATCH 0012/4023] Run tests without documentation search feature

---
 .../tests/Feature/PageCollectionTest.php      | 10 +++++++++
 .../tests/Feature/RouteCollectionTest.php     |  4 ++++
 .../Unit/Pages/PageModelGetHelperTest.php     |  4 ++++
 packages/testing/src/ResetsApplication.php    | 22 +++++++++++++++++++
 4 files changed, 40 insertions(+)

diff --git a/packages/framework/tests/Feature/PageCollectionTest.php b/packages/framework/tests/Feature/PageCollectionTest.php
index 19a961b761d..f055ae3bf24 100644
--- a/packages/framework/tests/Feature/PageCollectionTest.php
+++ b/packages/framework/tests/Feature/PageCollectionTest.php
@@ -80,6 +80,7 @@ public function test_get_page_returns_parsed_page_object_for_given_source_path()
     public function test_get_pages_returns_collection_of_pages_of_given_class()
     {
         $this->withoutDefaultPages();
+        $this->withoutDocumentationSearch();
 
         $this->file('_pages/foo.blade.php');
         $this->file('_pages/foo.md');
@@ -103,11 +104,13 @@ public function test_get_pages_returns_collection_of_pages_of_given_class()
         $this->assertEquals(new HtmlPage('foo'), Pages::getPages(HtmlPage::class)->first());
 
         $this->restoreDefaultPages();
+        $this->restoreDocumentationSearch();
     }
 
     public function test_get_pages_returns_all_pages_when_not_supplied_with_class_string()
     {
         $this->withoutDefaultPages();
+        $this->withoutDocumentationSearch();
 
         $this->file('_pages/foo.blade.php');
         $this->file('_pages/foo.md');
@@ -125,13 +128,16 @@ public function test_get_pages_returns_all_pages_when_not_supplied_with_class_st
         $this->assertEquals(new HtmlPage('foo'), $collection->get('_pages/foo.html'));
 
         $this->restoreDefaultPages();
+        $this->restoreDocumentationSearch();
     }
 
     public function test_get_pages_returns_empty_collection_when_no_pages_are_discovered()
     {
         $this->withoutDefaultPages();
+        $this->withoutDocumentationSearch();
         $this->assertEmpty(Pages::getPages());
         $this->restoreDefaultPages();
+        $this->restoreDocumentationSearch();
     }
 
     public function test_pages_are_not_discovered_for_disabled_features()
@@ -155,6 +161,8 @@ public function test_pages_are_not_discovered_for_disabled_features()
 
     public function test_pages_with_custom_source_directories_are_discovered_properly()
     {
+        $this->withoutDocumentationSearch();
+
         BladePage::setSourceDirectory('.source/pages');
         MarkdownPage::setSourceDirectory('.source/pages');
         MarkdownPost::setSourceDirectory('.source/posts');
@@ -177,6 +185,8 @@ public function test_pages_with_custom_source_directories_are_discovered_properl
         $this->assertEquals(new MarkdownPage('foo'), $collection->get('.source/pages/foo.md'));
         $this->assertEquals(new MarkdownPost('foo'), $collection->get('.source/posts/foo.md'));
         $this->assertEquals(new DocumentationPage('foo'), $collection->get('.source/docs/foo.md'));
+
+        $this->restoreDocumentationSearch();
     }
 
     public function test_get_file_throws_exception_when_file_is_not_found()
diff --git a/packages/framework/tests/Feature/RouteCollectionTest.php b/packages/framework/tests/Feature/RouteCollectionTest.php
index 383ef835a47..e1b8c74a0dd 100644
--- a/packages/framework/tests/Feature/RouteCollectionTest.php
+++ b/packages/framework/tests/Feature/RouteCollectionTest.php
@@ -40,6 +40,7 @@ public function test_boot_method_discovers_all_pages()
     public function test_boot_method_discovers_all_page_types()
     {
         $this->withoutDefaultPages();
+        $this->withoutDocumentationSearch();
 
         $this->file('_pages/blade.blade.php');
         $this->file('_pages/markdown.md');
@@ -61,6 +62,7 @@ public function test_boot_method_discovers_all_page_types()
         ], $collection->all());
 
         $this->restoreDefaultPages();
+        $this->restoreDocumentationSearch();
     }
 
     public function test_get_routes_returns_all_routes()
@@ -77,6 +79,7 @@ public function test_get_routes_returns_all_routes()
     public function test_get_routes_for_model_returns_collection_of_routes_of_given_class()
     {
         $this->withoutDefaultPages();
+        $this->withoutDocumentationSearch();
 
         $this->file('_pages/blade.blade.php');
         $this->file('_pages/markdown.md');
@@ -94,6 +97,7 @@ public function test_get_routes_for_model_returns_collection_of_routes_of_given_
         $this->assertEquals(new Route(new HtmlPage('html')), Routes::getRoutes(HtmlPage::class)->first());
 
         $this->restoreDefaultPages();
+        $this->restoreDocumentationSearch();
     }
 
     public function test_add_route_adds_new_route()
diff --git a/packages/framework/tests/Unit/Pages/PageModelGetHelperTest.php b/packages/framework/tests/Unit/Pages/PageModelGetHelperTest.php
index fea50135306..f8727b4caed 100644
--- a/packages/framework/tests/Unit/Pages/PageModelGetHelperTest.php
+++ b/packages/framework/tests/Unit/Pages/PageModelGetHelperTest.php
@@ -51,6 +51,8 @@ public function test_markdown_post_get_helper_returns_markdown_post_collection()
 
     public function test_documentation_page_get_helper_returns_documentation_page_collection()
     {
+        $this->withoutDocumentationSearch();
+
         Filesystem::touch('_docs/test-page.md');
 
         $collection = DocumentationPage::all();
@@ -59,5 +61,7 @@ public function test_documentation_page_get_helper_returns_documentation_page_co
         $this->assertContainsOnlyInstancesOf(DocumentationPage::class, $collection);
 
         Filesystem::unlink('_docs/test-page.md');
+
+        $this->restoreDocumentationSearch();
     }
 }
diff --git a/packages/testing/src/ResetsApplication.php b/packages/testing/src/ResetsApplication.php
index f5db985f41f..96729828402 100644
--- a/packages/testing/src/ResetsApplication.php
+++ b/packages/testing/src/ResetsApplication.php
@@ -50,6 +50,28 @@ protected function restoreDefaultPages(): void
         copy(Hyde::vendorPath('resources/views/pages/404.blade.php'), Hyde::path('_pages/404.blade.php'));
     }
 
+    /** @experimental We may want to make this a part of {@see static::withoutDefaultPages()} */
+    protected function withoutDocumentationSearch(): void
+    {
+        $features = config('hyde.features');
+
+        $flipped = array_flip($features);
+        unset($flipped['documentation-search']);
+        $features = array_flip($flipped);
+
+        config(['hyde.features' => $features]);
+    }
+
+    /** @experimental We may want to make this a part of {@see static::restoreDefaultPages()} */
+    protected function restoreDocumentationSearch(): void
+    {
+        $features = config('hyde.features');
+
+        $features[] = 'documentation-search';
+
+        config(['hyde.features' => $features]);
+    }
+
     protected static function unlinkUnlessDefault(string $filepath): void
     {
         $protected = [

From f55ad51f56a502619e95a96996157ddf9dd590d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 18:06:56 +0100
Subject: [PATCH 0013/4023] Hide the search page from sidebar generation

Could cause issues if the user wants to document their search page, maybe we tie it into the create_search_page config option? Because if they have a custom search page, they would want to disable that feature, and then this should also be disabled.
---
 .../src/Framework/Actions/GeneratesDocumentationSearchIndex.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 85e17aa1448..368895b599d 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -59,7 +59,7 @@ protected function __construct()
     protected function run(): void
     {
         DocumentationPage::all()->each(function (DocumentationPage $page): void {
-            if (! in_array($page->identifier, Config::getArray('docs.exclude_from_search', []))) {
+            if (! in_array($page->identifier, array_merge(Config::getArray('docs.exclude_from_search', []), ['search']))) {
                 $this->index->push($this->generatePageEntry($page));
             }
         });

From ba44d871ba03516d4ea0c0a5b06ac58397f7bcb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 20:12:16 +0100
Subject: [PATCH 0014/4023] Test documentation search sitemap integration

---
 .../Feature/Services/SitemapServiceTest.php     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/SitemapServiceTest.php b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
index e82342eb974..0c735f08819 100644
--- a/packages/framework/tests/Feature/Services/SitemapServiceTest.php
+++ b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
@@ -67,6 +67,7 @@ public function test_generate_adds_markdown_posts_to_xml()
 
     public function test_generate_adds_documentation_pages_to_xml()
     {
+        $this->withoutDocumentationSearch();
         Filesystem::touch('_docs/foo.md');
 
         $service = new SitemapGenerator();
@@ -74,6 +75,19 @@ public function test_generate_adds_documentation_pages_to_xml()
 
         $this->assertCount(3, $service->getXmlElement()->url);
 
+        Filesystem::unlink('_docs/foo.md');
+        $this->restoreDocumentationSearch();
+    }
+
+    public function test_generate_adds_documentation_search_pages_to_xml()
+    {
+        Filesystem::touch('_docs/foo.md');
+
+        $service = new SitemapGenerator();
+        $service->generate();
+
+        $this->assertCount(5, $service->getXmlElement()->url);
+
         Filesystem::unlink('_docs/foo.md');
     }
 
@@ -131,6 +145,7 @@ public function test_all_route_types_are_discovered()
     {
         config(['hyde.url' => 'foo']);
         Filesystem::unlink(['_pages/index.blade.php', '_pages/404.blade.php']);
+        $this->withoutDocumentationSearch();
 
         $files = [
             '_pages/blade.blade.php',
@@ -157,6 +172,8 @@ public function test_all_route_types_are_discovered()
 
         copy(Hyde::vendorPath('resources/views/homepages/welcome.blade.php'), Hyde::path('_pages/index.blade.php'));
         copy(Hyde::vendorPath('resources/views/pages/404.blade.php'), Hyde::path('_pages/404.blade.php'));
+
+        $this->restoreDocumentationSearch();
     }
 
     public function testLinksFallbackToRelativeLinksWhenASiteUrlIsNotSet()

From c45a64e6aabd3a037b028da05e39593c0cf9a963 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 20:29:02 +0100
Subject: [PATCH 0015/4023] Remove blanket assertion

Was probably added as a blanket to include build task output. Can't find any info in the Git log. Since it's unclear, and removing it makes the test pass, that's exactly what I'm going to do.
---
 packages/framework/tests/Feature/StaticSiteServiceTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index c4bc8d35dbf..165a11ad07b 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -83,7 +83,6 @@ public function test_all_page_types_can_be_compiled()
             ->expectsOutput('Creating Markdown Pages...')
             ->expectsOutput('Creating Markdown Posts...')
             ->expectsOutput('Creating Documentation Pages...')
-            ->doesntExpectOutputToContain('Creating')
             ->assertExitCode(0);
 
         $this->assertFileExists(Hyde::path('_site/html.html'));

From 49de93d20f9d1f3594b889fecf7b378b1b3d3e73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Dec 2023 16:58:36 +0100
Subject: [PATCH 0016/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c5a5421e35c..afe7ac9692f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -13,7 +13,7 @@ This serves two purposes:
 - Add experimental InMemoryPage::getOutputPath overload support
 
 ### Changed
-- for changes in existing functionality.
+- Changed how the documentation search is generated, to be an InMemoryPage instead of a post-build task.
 
 ### Deprecated
 - \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
@@ -30,3 +30,11 @@ This serves two purposes:
 ### Upgrade Guide
 
 If there are any breaking changes, include an upgrade guide here.
+
+#### Documentation search changes
+
+The documentation search page and search index have been changed to be generated as InMemoryPages instead of a post-build task.
+
+In case you have customized the GenerateSearch post-build task, you will need to adapt your code to the new InMemoryPage, which is generated in the HydeCoreExtension class.
+
+For more information, see https://github.com/hydephp/develop/pull/1498.

From 5728f7ad29a4295d3fb003cdb533feaf6f199f17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 10:38:23 +0100
Subject: [PATCH 0017/4023] Extract helper method

---
 .../Actions/GeneratesDocumentationSearchIndex.php          | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 368895b599d..dfc7c4f95d8 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -59,7 +59,7 @@ protected function __construct()
     protected function run(): void
     {
         DocumentationPage::all()->each(function (DocumentationPage $page): void {
-            if (! in_array($page->identifier, array_merge(Config::getArray('docs.exclude_from_search', []), ['search']))) {
+            if (! in_array($page->identifier, $this->getPagesToExcludeFromSearch())) {
                 $this->index->push($this->generatePageEntry($page));
             }
         });
@@ -103,4 +103,9 @@ protected function getPath(): string
     {
         return Hyde::sitePath(DocumentationPage::outputDirectory().'/search.json');
     }
+
+    protected function getPagesToExcludeFromSearch(): array
+    {
+        return array_merge(Config::getArray('docs.exclude_from_search', []), ['search']);
+    }
 }

From 3cb7f404f0b03f05b9ad6b02a14e959552741325 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 10:40:11 +0100
Subject: [PATCH 0018/4023] Make search index page exclusion dependent on
 config setting

> Because if they have a custom search page, they would want to disable that feature, and then this should also be disabled.

See https://github.com/hydephp/develop/pull/1498#discussion_r1425650912
---
 .../src/Framework/Actions/GeneratesDocumentationSearchIndex.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index dfc7c4f95d8..64bbb7d8e67 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -106,6 +106,6 @@ protected function getPath(): string
 
     protected function getPagesToExcludeFromSearch(): array
     {
-        return array_merge(Config::getArray('docs.exclude_from_search', []), ['search']);
+        return array_merge(Config::getArray('docs.exclude_from_search', []), Config::getBool('docs.create_search_page', true) ? ['search'] : []);
     }
 }

From bd140499e0d7850ca3e333eaddb9c9d45ba79a59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 12:22:23 +0100
Subject: [PATCH 0019/4023] Extract experimental helper method

Decoupling it from the extension cleans up the code, and allows us to use it in the build search command, even if it's not injected due to the search feature being disabled (then we still allow the user to force it like before)
---
 .../src/Foundation/HydeCoreExtension.php          | 10 +---------
 .../Actions/GeneratesDocumentationSearchIndex.php | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 27c0706a93c..50d5d40a0ed 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -8,7 +8,6 @@
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
-use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Concerns\HydeExtension;
@@ -36,14 +35,7 @@ public static function getPageClasses(): array
     public function discoverPages(PageCollection $collection): void
     {
         if (Features::hasDocumentationSearch()) {
-            $collection->addPage(tap(new InMemoryPage('search.json', ['navigation' => ['hidden' => true]]), function (InMemoryPage $page): void {
-                $page->macro('compile', function (): string {
-                    return GeneratesDocumentationSearchIndex::generate();
-                });
-                $page->macro('getOutputPath', function (): string {
-                    return DocumentationPage::outputDirectory().'/search.json';
-                });
-            }));
+            $collection->addPage(GeneratesDocumentationSearchIndex::makePage());
 
             if (DocumentationSearchPage::enabled()) {
                 $collection->addPage(new DocumentationSearchPage());
diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 64bbb7d8e67..125f6098316 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -7,10 +7,12 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 
+use function tap;
 use function basename;
 use function in_array;
 use function trim;
@@ -50,6 +52,19 @@ public static function generate(): string
         return $service->index->toJson();
     }
 
+    /** @experimental May be moved to a DocumentationSearch class */
+    public static function makePage(): InMemoryPage
+    {
+        return tap(new InMemoryPage('search.json', ['navigation' => ['hidden' => true]]), function (InMemoryPage $page): void {
+            $page->macro('compile', function (): string {
+                return GeneratesDocumentationSearchIndex::generate();
+            });
+            $page->macro('getOutputPath', function (): string {
+                return DocumentationPage::outputDirectory().'/search.json';
+            });
+        });
+    }
+
     protected function __construct()
     {
         $this->index = new Collection();

From 158c6f223d736ee2af2b26afb22614bd5fb30485 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 15:51:35 +0100
Subject: [PATCH 0020/4023] Update build search command to use new search page
 system

---
 .../src/Console/Commands/BuildSearchCommand.php      | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 03cf8f95934..594fc5c3917 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -4,8 +4,10 @@
 
 namespace Hyde\Console\Commands;
 
-use Hyde\Framework\Actions\PostBuildTasks\GenerateSearch;
 use LaravelZero\Framework\Commands\Command;
+use Hyde\Framework\Actions\StaticPageBuilder;
+use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
+use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 
 /**
  * Run the build process for the documentation search index.
@@ -20,6 +22,12 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        return (new GenerateSearch())->run($this->output);
+        StaticPageBuilder::handle(GeneratesDocumentationSearchIndex::makePage());
+
+        if (DocumentationSearchPage::enabled()) {
+            DocumentationSearchPage::generate();
+        }
+
+        return Command::SUCCESS;
     }
 }

From 873b928714cb3b123df794a40c2ee9300f264355 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 15:52:46 +0100
Subject: [PATCH 0021/4023] Support getting the search page from the kernel

In case it's been modified or injected somehow, this is a nicety to have
---
 .../src/Console/Commands/BuildSearchCommand.php  | 16 ++++++++++++++--
 .../Feature/Commands/BuildSearchCommandTest.php  | 16 ++++++++++++++++
 2 files changed, 30 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 594fc5c3917..225980b2689 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -4,8 +4,11 @@
 
 namespace Hyde\Console\Commands;
 
-use LaravelZero\Framework\Commands\Command;
+use Hyde\Pages\Concerns\HydePage;
+use Hyde\Foundation\Facades\Pages;
 use Hyde\Framework\Actions\StaticPageBuilder;
+use Hyde\Framework\Exceptions\FileNotFoundException;
+use LaravelZero\Framework\Commands\Command;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 
@@ -22,7 +25,7 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        StaticPageBuilder::handle(GeneratesDocumentationSearchIndex::makePage());
+        StaticPageBuilder::handle($this->getPageFromKernel() ?? GeneratesDocumentationSearchIndex::makePage());
 
         if (DocumentationSearchPage::enabled()) {
             DocumentationSearchPage::generate();
@@ -30,4 +33,13 @@ public function handle(): int
 
         return Command::SUCCESS;
     }
+
+    protected function getPageFromKernel(): ?HydePage
+    {
+        try {
+            return Pages::getPage('search.json');
+        } catch (FileNotFoundException) {
+            return null;
+        }
+    }
 }
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index d8dc55a2826..bd25e01bd78 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -6,8 +6,10 @@
 
 use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
+use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
 /**
  * @covers \Hyde\Console\Commands\BuildSearchCommand
@@ -103,4 +105,18 @@ public function test_search_files_can_be_generated_for_custom_site_and_nested_do
 
         Filesystem::deleteDirectory('foo');
     }
+
+    public function test_command_uses_page_from_kernel_when_present()
+    {
+        Hyde::pages()->addPage(tap(GeneratesDocumentationSearchIndex::makePage(), function (InMemoryPage $page): void {
+            $page->macro('compile', fn () => '{"foo":"bar"}');
+        }));
+
+        $this->artisan('build:search')->assertExitCode(0);
+        $this->assertFileExists(Hyde::path('_site/docs/search.json'));
+        $this->assertSame('{"foo":"bar"}', Filesystem::getContents('_site/docs/search.json'));
+
+        Filesystem::unlink('_site/docs/search.json');
+        Filesystem::unlink('_site/docs/search.html');
+    }
 }

From 4f91f82c9a841889039ad2f5638610348ca2b644 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 17:11:10 +0100
Subject: [PATCH 0022/4023] Simplify logic to use nullable helper

---
 .../framework/src/Console/Commands/BuildSearchCommand.php  | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 225980b2689..21992b51668 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -7,7 +7,6 @@
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Foundation\Facades\Pages;
 use Hyde\Framework\Actions\StaticPageBuilder;
-use Hyde\Framework\Exceptions\FileNotFoundException;
 use LaravelZero\Framework\Commands\Command;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
@@ -36,10 +35,6 @@ public function handle(): int
 
     protected function getPageFromKernel(): ?HydePage
     {
-        try {
-            return Pages::getPage('search.json');
-        } catch (FileNotFoundException) {
-            return null;
-        }
+        return Pages::get('search.json');
     }
 }

From e80cbb2f495dabf51435edfb3bf962b997c37a54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 17:11:26 +0100
Subject: [PATCH 0023/4023] Inline simplified helper method

---
 .../framework/src/Console/Commands/BuildSearchCommand.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 21992b51668..a0248172a17 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Console\Commands;
 
-use Hyde\Pages\Concerns\HydePage;
 use Hyde\Foundation\Facades\Pages;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use LaravelZero\Framework\Commands\Command;
@@ -24,7 +23,7 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        StaticPageBuilder::handle($this->getPageFromKernel() ?? GeneratesDocumentationSearchIndex::makePage());
+        StaticPageBuilder::handle(Pages::get('search.json') ?? GeneratesDocumentationSearchIndex::makePage());
 
         if (DocumentationSearchPage::enabled()) {
             DocumentationSearchPage::generate();
@@ -32,9 +31,4 @@ public function handle(): int
 
         return Command::SUCCESS;
     }
-
-    protected function getPageFromKernel(): ?HydePage
-    {
-        return Pages::get('search.json');
-    }
 }

From 03f7fd897735c097bffb7b3cd27da505059c8680 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 17:15:54 +0100
Subject: [PATCH 0024/4023] Get the search page from the kernel as well

---
 .../framework/src/Console/Commands/BuildSearchCommand.php | 2 +-
 .../tests/Feature/Commands/BuildSearchCommandTest.php     | 8 +++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index a0248172a17..563778da0b1 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -26,7 +26,7 @@ public function handle(): int
         StaticPageBuilder::handle(Pages::get('search.json') ?? GeneratesDocumentationSearchIndex::makePage());
 
         if (DocumentationSearchPage::enabled()) {
-            DocumentationSearchPage::generate();
+            StaticPageBuilder::handle(Pages::get('docs/search') ?? new DocumentationSearchPage());
         }
 
         return Command::SUCCESS;
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index bd25e01bd78..72a5f591930 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -106,15 +106,21 @@ public function test_search_files_can_be_generated_for_custom_site_and_nested_do
         Filesystem::deleteDirectory('foo');
     }
 
-    public function test_command_uses_page_from_kernel_when_present()
+    public function test_command_uses_search_pages_from_kernel_when_present()
     {
         Hyde::pages()->addPage(tap(GeneratesDocumentationSearchIndex::makePage(), function (InMemoryPage $page): void {
             $page->macro('compile', fn () => '{"foo":"bar"}');
         }));
 
+        Hyde::pages()->addPage(tap(new InMemoryPage('docs/search'), function (InMemoryPage $page): void {
+            $page->macro('compile', fn () => 'Foo');
+        }));
+
         $this->artisan('build:search')->assertExitCode(0);
         $this->assertFileExists(Hyde::path('_site/docs/search.json'));
+        $this->assertFileExists(Hyde::path('_site/docs/search.html'));
         $this->assertSame('{"foo":"bar"}', Filesystem::getContents('_site/docs/search.json'));
+        $this->assertSame('Foo', Filesystem::getContents('_site/docs/search.html'));
 
         Filesystem::unlink('_site/docs/search.json');
         Filesystem::unlink('_site/docs/search.html');

From b021766d2f16be15a6c988e8b2b17e45384f2a22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 17:17:42 +0100
Subject: [PATCH 0025/4023] Clean up test method

---
 .../framework/tests/Feature/Commands/BuildSearchCommandTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 72a5f591930..2c289a5b4f9 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -117,8 +117,10 @@ public function test_command_uses_search_pages_from_kernel_when_present()
         }));
 
         $this->artisan('build:search')->assertExitCode(0);
+
         $this->assertFileExists(Hyde::path('_site/docs/search.json'));
         $this->assertFileExists(Hyde::path('_site/docs/search.html'));
+
         $this->assertSame('{"foo":"bar"}', Filesystem::getContents('_site/docs/search.json'));
         $this->assertSame('Foo', Filesystem::getContents('_site/docs/search.html'));
 

From 799d51f4a9b164ff5f3bdd6d64559d7b2d6ae034 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 18:17:06 +0100
Subject: [PATCH 0026/4023] Extract a model class for the documentation search
 index

---
 .../GeneratesDocumentationSearchIndex.php     | 11 +----
 .../DocumentationSearchIndex.php              | 46 +++++++++++++++++++
 .../Commands/BuildSearchCommandTest.php       |  4 +-
 3 files changed, 50 insertions(+), 11 deletions(-)
 create mode 100644 packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 125f6098316..e76c20496dd 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -11,8 +11,8 @@
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
-use function tap;
 use function basename;
 use function in_array;
 use function trim;
@@ -55,14 +55,7 @@ public static function generate(): string
     /** @experimental May be moved to a DocumentationSearch class */
     public static function makePage(): InMemoryPage
     {
-        return tap(new InMemoryPage('search.json', ['navigation' => ['hidden' => true]]), function (InMemoryPage $page): void {
-            $page->macro('compile', function (): string {
-                return GeneratesDocumentationSearchIndex::generate();
-            });
-            $page->macro('getOutputPath', function (): string {
-                return DocumentationPage::outputDirectory().'/search.json';
-            });
-        });
+        return DocumentationSearchIndex::make();
     }
 
     protected function __construct()
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
new file mode 100644
index 00000000000..b5b650c722f
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Documentation;
+
+use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Framework\Actions\StaticPageBuilder;
+use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
+
+/**
+ * @internal This page is used to render the search index for the documentation.
+ */
+class DocumentationSearchIndex extends InMemoryPage
+{
+    /**
+     * Generate the search page and save it to disk.
+     *
+     * @return string The path to the generated file.
+     */
+    public static function generate(): string
+    {
+        return StaticPageBuilder::handle(new static());
+    }
+
+    /**
+     * Create a new DocumentationSearchPage instance.
+     */
+    public function __construct()
+    {
+        parent::__construct('search.json', [
+            'navigation' => ['hidden' => true],
+        ]);
+    }
+
+    public function compile(): string
+    {
+        return GeneratesDocumentationSearchIndex::generate();
+    }
+
+    public function getOutputPath(): string
+    {
+        return DocumentationPage::outputDirectory().'/search.json';
+    }
+}
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 2c289a5b4f9..454b63196d3 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -9,7 +9,6 @@
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
 /**
  * @covers \Hyde\Console\Commands\BuildSearchCommand
@@ -108,8 +107,9 @@ public function test_search_files_can_be_generated_for_custom_site_and_nested_do
 
     public function test_command_uses_search_pages_from_kernel_when_present()
     {
-        Hyde::pages()->addPage(tap(GeneratesDocumentationSearchIndex::makePage(), function (InMemoryPage $page): void {
+        Hyde::pages()->addPage(tap(new InMemoryPage('search.json'), function (InMemoryPage $page): void {
             $page->macro('compile', fn () => '{"foo":"bar"}');
+            $page->macro('getOutputPath', fn () => 'docs/search.json');
         }));
 
         Hyde::pages()->addPage(tap(new InMemoryPage('docs/search'), function (InMemoryPage $page): void {

From 76c1c3ef2911ae5959ceb6eb71021cb3cfdadbda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 18:44:28 +0100
Subject: [PATCH 0027/4023] Remove unused method

---
 .../Documentation/DocumentationSearchIndex.php        | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index b5b650c722f..b33845960a5 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -6,7 +6,6 @@
 
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
-use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
 /**
@@ -14,16 +13,6 @@
  */
 class DocumentationSearchIndex extends InMemoryPage
 {
-    /**
-     * Generate the search page and save it to disk.
-     *
-     * @return string The path to the generated file.
-     */
-    public static function generate(): string
-    {
-        return StaticPageBuilder::handle(new static());
-    }
-
     /**
      * Create a new DocumentationSearchPage instance.
      */

From 44e97cd41508eccf6ce57142e2141fd14e0ee97b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 18:48:24 +0100
Subject: [PATCH 0028/4023] Merge in source directory prefix for search index
 identifier

---
 .../Features/Documentation/DocumentationSearchIndex.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index b33845960a5..f1dcaaa1acb 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -18,7 +18,7 @@ class DocumentationSearchIndex extends InMemoryPage
      */
     public function __construct()
     {
-        parent::__construct('search.json', [
+        parent::__construct(DocumentationPage::sourceDirectory().'/search.json', [
             'navigation' => ['hidden' => true],
         ]);
     }

From 01cba90c8a9ac168e57f4f5001039bef0f3b9fd1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 19:46:01 +0100
Subject: [PATCH 0029/4023] Trim leading slashes from assembled paths

---
 .../Features/Documentation/DocumentationSearchIndex.php       | 4 ++--
 .../Features/Documentation/DocumentationSearchPage.php        | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index f1dcaaa1acb..4ad3e5deb30 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -18,7 +18,7 @@ class DocumentationSearchIndex extends InMemoryPage
      */
     public function __construct()
     {
-        parent::__construct(DocumentationPage::sourceDirectory().'/search.json', [
+        parent::__construct(ltrim(DocumentationPage::sourceDirectory().'/search.json', '/'), [
             'navigation' => ['hidden' => true],
         ]);
     }
@@ -30,6 +30,6 @@ public function compile(): string
 
     public function getOutputPath(): string
     {
-        return DocumentationPage::outputDirectory().'/search.json';
+        return ltrim(DocumentationPage::outputDirectory().'/search.json', '/');
     }
 }
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index f58ff0b83ca..b582111b529 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -52,6 +52,6 @@ public static function enabled(): bool
 
     public static function routeKey(): string
     {
-        return parent::outputDirectory().'/search';
+        return ltrim(parent::outputDirectory().'/search');
     }
 }

From 57bdecb2bc2c593c9cf5ed129953f559a3fe115d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 19:50:38 +0100
Subject: [PATCH 0030/4023] Inline added simplified experimental method

---
 .../framework/src/Console/Commands/BuildSearchCommand.php | 4 ++--
 packages/framework/src/Foundation/HydeCoreExtension.php   | 4 ++--
 .../Actions/GeneratesDocumentationSearchIndex.php         | 8 --------
 3 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 563778da0b1..814f69ed751 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -7,8 +7,8 @@
 use Hyde\Foundation\Facades\Pages;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use LaravelZero\Framework\Commands\Command;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 /**
  * Run the build process for the documentation search index.
@@ -23,7 +23,7 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        StaticPageBuilder::handle(Pages::get('search.json') ?? GeneratesDocumentationSearchIndex::makePage());
+        StaticPageBuilder::handle(Pages::get('search.json') ?? DocumentationSearchIndex::make());
 
         if (DocumentationSearchPage::enabled()) {
             StaticPageBuilder::handle(Pages::get('docs/search') ?? new DocumentationSearchPage());
diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 50d5d40a0ed..5ecf1e90ef2 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -12,8 +12,8 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Concerns\HydeExtension;
 use Hyde\Facades\Features;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 use function array_filter;
 use function array_keys;
@@ -35,7 +35,7 @@ public static function getPageClasses(): array
     public function discoverPages(PageCollection $collection): void
     {
         if (Features::hasDocumentationSearch()) {
-            $collection->addPage(GeneratesDocumentationSearchIndex::makePage());
+            $collection->addPage(DocumentationSearchIndex::make());
 
             if (DocumentationSearchPage::enabled()) {
                 $collection->addPage(new DocumentationSearchPage());
diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index e76c20496dd..64bbb7d8e67 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -7,11 +7,9 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
-use Hyde\Pages\InMemoryPage;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
-use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 use function basename;
 use function in_array;
@@ -52,12 +50,6 @@ public static function generate(): string
         return $service->index->toJson();
     }
 
-    /** @experimental May be moved to a DocumentationSearch class */
-    public static function makePage(): InMemoryPage
-    {
-        return DocumentationSearchIndex::make();
-    }
-
     protected function __construct()
     {
         $this->index = new Collection();

From cca3610b786864df861a769c744a4d8db9793fc1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 19:52:21 +0100
Subject: [PATCH 0031/4023] Change constructor style

Just makes it visually consistent
---
 packages/framework/src/Console/Commands/BuildSearchCommand.php | 2 +-
 packages/framework/src/Foundation/HydeCoreExtension.php        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index 814f69ed751..d73a9112500 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -23,7 +23,7 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        StaticPageBuilder::handle(Pages::get('search.json') ?? DocumentationSearchIndex::make());
+        StaticPageBuilder::handle(Pages::get('search.json') ?? new DocumentationSearchIndex());
 
         if (DocumentationSearchPage::enabled()) {
             StaticPageBuilder::handle(Pages::get('docs/search') ?? new DocumentationSearchPage());
diff --git a/packages/framework/src/Foundation/HydeCoreExtension.php b/packages/framework/src/Foundation/HydeCoreExtension.php
index 5ecf1e90ef2..38772c55871 100644
--- a/packages/framework/src/Foundation/HydeCoreExtension.php
+++ b/packages/framework/src/Foundation/HydeCoreExtension.php
@@ -35,7 +35,7 @@ public static function getPageClasses(): array
     public function discoverPages(PageCollection $collection): void
     {
         if (Features::hasDocumentationSearch()) {
-            $collection->addPage(DocumentationSearchIndex::make());
+            $collection->addPage(new DocumentationSearchIndex());
 
             if (DocumentationSearchPage::enabled()) {
                 $collection->addPage(new DocumentationSearchPage());

From 37f7046251b8c0514b8d8ef821de4ef3d35bbac8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Dec 2023 20:05:28 +0100
Subject: [PATCH 0032/4023] Refractor internal search page to extend in memory
 page

I think this is more semantic
---
 .../Documentation/DocumentationSearchPage.php     | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index b582111b529..0bf7f8ad8c6 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -5,10 +5,10 @@
 namespace Hyde\Framework\Features\Documentation;
 
 use Hyde\Hyde;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Facades\Config;
-use Illuminate\Support\Facades\View;
 
 /**
  * @internal This page is used to render the search page for the documentation.
@@ -17,7 +17,7 @@
  * If you want to override this page, you can create a page with the route key "docs/search",
  * then this class will not be applied. For example, `_pages/docs/search.blade.php`.
  */
-class DocumentationSearchPage extends DocumentationPage
+class DocumentationSearchPage extends InMemoryPage
 {
     /**
      * Generate the search page and save it to disk.
@@ -34,15 +34,10 @@ public static function generate(): string
      */
     public function __construct()
     {
-        parent::__construct('search', [
+        parent::__construct(ltrim(DocumentationPage::outputDirectory().'/search', '/'), [
             'title' => 'Search',
             'navigation' => ['hidden' => true],
-        ]);
-    }
-
-    public function compile(): string
-    {
-        return View::make('hyde::pages.documentation-search')->render();
+        ], view: 'hyde::pages.documentation-search');
     }
 
     public static function enabled(): bool
@@ -52,6 +47,6 @@ public static function enabled(): bool
 
     public static function routeKey(): string
     {
-        return ltrim(parent::outputDirectory().'/search');
+        return ltrim(DocumentationPage::outputDirectory().'/search');
     }
 }

From 34ba8552a08210b82e597ede3472a534c62f1aeb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 11:12:57 +0100
Subject: [PATCH 0033/4023] Update documentation article component to support
 existing variables

Allows for them to be passed from a model class, for example.
---
 RELEASE_NOTES.md                                                | 1 +
 .../views/components/docs/documentation-article.blade.php       | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index afe7ac9692f..d1ba26e97a6 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -14,6 +14,7 @@ This serves two purposes:
 
 ### Changed
 - Changed how the documentation search is generated, to be an InMemoryPage instead of a post-build task.
+- Updated the documentation article component to support existing $document instance.
 
 ### Deprecated
 - \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
diff --git a/packages/framework/resources/views/components/docs/documentation-article.blade.php b/packages/framework/resources/views/components/docs/documentation-article.blade.php
index 1bacc9e5c42..4565069d6a0 100644
--- a/packages/framework/resources/views/components/docs/documentation-article.blade.php
+++ b/packages/framework/resources/views/components/docs/documentation-article.blade.php
@@ -1,5 +1,5 @@
 @php
-    $document = \Hyde\Framework\Features\Documentation\SemanticDocumentationArticle::make($page);
+    $document ??= \Hyde\Framework\Features\Documentation\SemanticDocumentationArticle::make($page);
 @endphp
 
 <article id="document" itemscope itemtype="https://schema.org/Article" @class([

From e6f6a98b1fced5f1428ad39be2ff7422f95bbdc2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 11:13:37 +0100
Subject: [PATCH 0034/4023] Update search page to mock document

See https://github.com/hydephp/develop/commit/37f7046251b8c0514b8d8ef821de4ef3d35bbac8#commitcomment-135026537
---
 .../Features/Documentation/DocumentationSearchPage.php     | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 0bf7f8ad8c6..af1c39b5892 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -37,6 +37,7 @@ public function __construct()
         parent::__construct(ltrim(DocumentationPage::outputDirectory().'/search', '/'), [
             'title' => 'Search',
             'navigation' => ['hidden' => true],
+            'document' => $this->makeDocument(),
         ], view: 'hyde::pages.documentation-search');
     }
 
@@ -49,4 +50,10 @@ public static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search');
     }
+
+    /** @experimental Fixes type issue {@see https://github.com/hydephp/develop/commit/37f7046251b8c0514b8d8ef821de4ef3d35bbac8#commitcomment-135026537} */
+    protected function makeDocument(): SemanticDocumentationArticle
+    {
+        return SemanticDocumentationArticle::make(new DocumentationPage());
+    }
 }

From b6eca700b4bb96037e55f7fe12071306fad2e074 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 11:36:00 +0100
Subject: [PATCH 0035/4023] Fix added search index page should include docs
 prefix

These in-memory page identifiers should include the route key prefix they would get if they were documentation pages
---
 packages/framework/src/Console/Commands/BuildSearchCommand.php  | 2 +-
 .../framework/tests/Feature/Commands/BuildSearchCommandTest.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
index d73a9112500..4388c64cb68 100644
--- a/packages/framework/src/Console/Commands/BuildSearchCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -23,7 +23,7 @@ class BuildSearchCommand extends Command
 
     public function handle(): int
     {
-        StaticPageBuilder::handle(Pages::get('search.json') ?? new DocumentationSearchIndex());
+        StaticPageBuilder::handle(Pages::get('docs/search.json') ?? new DocumentationSearchIndex());
 
         if (DocumentationSearchPage::enabled()) {
             StaticPageBuilder::handle(Pages::get('docs/search') ?? new DocumentationSearchPage());
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 454b63196d3..9dcdc335552 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -107,7 +107,7 @@ public function test_search_files_can_be_generated_for_custom_site_and_nested_do
 
     public function test_command_uses_search_pages_from_kernel_when_present()
     {
-        Hyde::pages()->addPage(tap(new InMemoryPage('search.json'), function (InMemoryPage $page): void {
+        Hyde::pages()->addPage(tap(new InMemoryPage('docs/search.json'), function (InMemoryPage $page): void {
             $page->macro('compile', fn () => '{"foo":"bar"}');
             $page->macro('getOutputPath', fn () => 'docs/search.json');
         }));

From 6c932a1bf49cce15e0214a063532c85ca50d7306 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 11:38:23 +0100
Subject: [PATCH 0036/4023] Deprecate internal logic to be removed within
 refactor

---
 .../Framework/Features/Documentation/DocumentationSearchPage.php | 1 +
 packages/realtime-compiler/src/Routing/PageRouter.php            | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index af1c39b5892..06530bb84a9 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -46,6 +46,7 @@ public static function enabled(): bool
         return Config::getBool('docs.create_search_page', true) && ! Hyde::routes()->has(self::routeKey());
     }
 
+    /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
     public static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search');
diff --git a/packages/realtime-compiler/src/Routing/PageRouter.php b/packages/realtime-compiler/src/Routing/PageRouter.php
index 1e41b531bd4..3d29cc7d18c 100644
--- a/packages/realtime-compiler/src/Routing/PageRouter.php
+++ b/packages/realtime-compiler/src/Routing/PageRouter.php
@@ -90,6 +90,7 @@ public static function handle(Request $request): Response
 
     protected function getPageFromRoute(): HydePage
     {
+        /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
         if (unslash($this->request->path) === DocumentationSearchPage::routeKey() && DocumentationSearchPage::enabled()) {
             // Since this page is not present within the search index (as it's normally generated by a build task)
             // we instantiate and return it here.

From 4556eed47894c9d5e5bd85aa85559445b9300cec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 12:56:30 +0100
Subject: [PATCH 0037/4023] Fix wrong method used to emulate route key

---
 .../Features/Documentation/DocumentationSearchIndex.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 4ad3e5deb30..2cb5aab6298 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -18,7 +18,7 @@ class DocumentationSearchIndex extends InMemoryPage
      */
     public function __construct()
     {
-        parent::__construct(ltrim(DocumentationPage::sourceDirectory().'/search.json', '/'), [
+        parent::__construct(ltrim(DocumentationPage::outputDirectory().'/search.json', '/'), [
             'navigation' => ['hidden' => true],
         ]);
     }

From 790689e0bfa3960e0585319801c299c6f2fa4bf0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 12:57:57 +0100
Subject: [PATCH 0038/4023] Create DocumentationSearchIndexTest.php

---
 .../Feature/DocumentationSearchIndexTest.php  | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 packages/framework/tests/Feature/DocumentationSearchIndexTest.php

diff --git a/packages/framework/tests/Feature/DocumentationSearchIndexTest.php b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
new file mode 100644
index 00000000000..58de0d066dd
--- /dev/null
+++ b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
+
+/**
+ * @covers \Hyde\Framework\Features\Documentation\DocumentationSearchIndex
+ *
+ * @see \Hyde\Framework\Testing\Feature\Commands\BuildSearchCommandTest
+ */
+class DocumentationSearchIndexTest extends TestCase
+{
+    public function testCanCreateDocumentationSearchIndexInstance()
+    {
+        $this->assertInstanceOf(DocumentationSearchIndex::class, new DocumentationSearchIndex());
+    }
+
+    public function testRouteKeyIsSetToDocumentationOutputDirectory()
+    {
+        $page = new DocumentationSearchIndex();
+        $this->assertSame('docs/search.json', $page->routeKey);
+    }
+
+    public function testRouteKeyIsSetToConfiguredDocumentationOutputDirectory()
+    {
+        DocumentationPage::setOutputDirectory('foo');
+
+        $page = new DocumentationSearchIndex();
+        $this->assertSame('foo/search.json', $page->routeKey);
+    }
+}

From 37c2dde6b063579dbdb3ad4444c9ae27b3ef27bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 12:58:05 +0100
Subject: [PATCH 0039/4023] Add coverage annotation

---
 .../framework/tests/Feature/Commands/BuildSearchCommandTest.php  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 9dcdc335552..faa5f89b75a 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -14,6 +14,7 @@
  * @covers \Hyde\Console\Commands\BuildSearchCommand
  * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
  * @covers \Hyde\Framework\Features\Documentation\DocumentationSearchPage
+ * @covers \Hyde\Framework\Features\Documentation\DocumentationSearchIndex
  */
 class BuildSearchCommandTest extends TestCase
 {

From 38608b81dde77497e6a1283f0f3b9e81432ed039 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 13:32:59 +0100
Subject: [PATCH 0040/4023] Remove hacky route injection in favour of new
 search page implementation

Targets the realtime compiler v4 as it's a breaking change that requires Hyde v2. See https://github.com/hydephp/develop/pull/1498
---
 packages/realtime-compiler/src/Routing/PageRouter.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/realtime-compiler/src/Routing/PageRouter.php b/packages/realtime-compiler/src/Routing/PageRouter.php
index 3d29cc7d18c..a3a3876203a 100644
--- a/packages/realtime-compiler/src/Routing/PageRouter.php
+++ b/packages/realtime-compiler/src/Routing/PageRouter.php
@@ -8,7 +8,6 @@
 use Hyde\Pages\Concerns\BaseMarkdownPage;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\RealtimeCompiler\Http\LiveEditController;
-use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\RealtimeCompiler\Concerns\InteractsWithLaravel;
 use Hyde\RealtimeCompiler\Concerns\SendsErrorResponses;
@@ -90,13 +89,6 @@ public static function handle(Request $request): Response
 
     protected function getPageFromRoute(): HydePage
     {
-        /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
-        if (unslash($this->request->path) === DocumentationSearchPage::routeKey() && DocumentationSearchPage::enabled()) {
-            // Since this page is not present within the search index (as it's normally generated by a build task)
-            // we instantiate and return it here.
-            return new DocumentationSearchPage();
-        }
-
         return Routes::getOrFail($this->normalizePath($this->request->path))->getPage();
     }
 }

From 9c100594e1292ebee8ab2c2329199fc71398fad3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 13:42:25 +0100
Subject: [PATCH 0041/4023] Update test to use new search page implementation

---
 packages/realtime-compiler/tests/RealtimeCompilerTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/realtime-compiler/tests/RealtimeCompilerTest.php b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
index 9f48e9467a9..5c2cec606c3 100644
--- a/packages/realtime-compiler/tests/RealtimeCompilerTest.php
+++ b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
@@ -164,6 +164,8 @@
 });
 
 test('docs/search renders search page', function () {
+    Filesystem::put('_docs/index.md', '# Hello World!');
+
     mockRoute('docs/search');
 
     $kernel = new HttpKernel();
@@ -175,6 +177,7 @@
 
     expect($response->body)->toContain('Search the documentation site');
 
+    Filesystem::unlink('_docs/index.md');
     Filesystem::unlink('_site/docs/search.html');
 });
 

From 0838ab4f25f75299f28495dcb9191e03a1ea0f3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 15:10:29 +0100
Subject: [PATCH 0042/4023] Remove internal
 `DocumentationSearchPage::routeKey()` method

This is now no longer needed thanks to https://github.com/hydephp/develop/pull/1498, but is kept as protected so the `enabled` method can use it
---
 .../Documentation/DocumentationSearchPage.php         |  3 +--
 .../tests/Feature/DocumentationSearchPageTest.php     | 11 -----------
 2 files changed, 1 insertion(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 06530bb84a9..a27408c92fd 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -46,8 +46,7 @@ public static function enabled(): bool
         return Config::getBool('docs.create_search_page', true) && ! Hyde::routes()->has(self::routeKey());
     }
 
-    /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
-    public static function routeKey(): string
+    protected static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search');
     }
diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index 22a9b53ed1c..ec91f318044 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -59,15 +59,4 @@ public function testEnabledIsFalseWhenDisabledAndRouteExists()
         Hyde::routes()->put('docs/search', new InMemoryPage('docs/search'));
         $this->assertFalse(DocumentationSearchPage::enabled());
     }
-
-    public function testStaticRouteKeyHelper()
-    {
-        $this->assertSame('docs/search', DocumentationSearchPage::routeKey());
-    }
-
-    public function testStaticRouteKeyHelperWithCustomOutputDirectory()
-    {
-        DocumentationPage::setOutputDirectory('foo');
-        $this->assertSame('foo/search', DocumentationSearchPage::routeKey());
-    }
 }

From 82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Dec 2023 15:50:21 +0100
Subject: [PATCH 0043/4023] Add improved conditional to fix override priority

As part of the v2 refactors, since routes aren't discovered yet, we need to check the pages directly.

This also means that custom search pages are now not built by the build:search command. We could change it so that it is, but we don't know if the custom page is a custom search feature, or a page that documents a search feature. So we don't know if this is what the user would want/expect.

Additionally, the kernel API changes to needing to put the overrides in the pages collection instead of the route collection. This is also a very very minor implementation change with minimal impact.
---
 .../Features/Documentation/DocumentationSearchPage.php   | 9 ++++++++-
 .../tests/Feature/Commands/BuildSearchCommandTest.php    | 6 +++---
 .../tests/Feature/DocumentationSearchPageTest.php        | 4 ++--
 3 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index a27408c92fd..a352a250358 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\Concerns\HydePage;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Facades\Config;
 
@@ -43,7 +44,13 @@ public function __construct()
 
     public static function enabled(): bool
     {
-        return Config::getBool('docs.create_search_page', true) && ! Hyde::routes()->has(self::routeKey());
+        return Config::getBool('docs.create_search_page', true) && ! static::anotherSearchPageExists();
+    }
+
+    protected static function anotherSearchPageExists(): bool
+    {
+        // Since routes aren't discovered yet, we need to check the pages directly
+        return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
 
     protected static function routeKey(): string
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index faa5f89b75a..dfcf392d5bf 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -120,12 +120,12 @@ public function test_command_uses_search_pages_from_kernel_when_present()
         $this->artisan('build:search')->assertExitCode(0);
 
         $this->assertFileExists(Hyde::path('_site/docs/search.json'));
-        $this->assertFileExists(Hyde::path('_site/docs/search.html'));
+//        $this->assertFileExists(Hyde::path('_site/docs/search.html'));
 
         $this->assertSame('{"foo":"bar"}', Filesystem::getContents('_site/docs/search.json'));
-        $this->assertSame('Foo', Filesystem::getContents('_site/docs/search.html'));
+//        $this->assertSame('Foo', Filesystem::getContents('_site/docs/search.html'));
 
         Filesystem::unlink('_site/docs/search.json');
-        Filesystem::unlink('_site/docs/search.html');
+//        Filesystem::unlink('_site/docs/search.html');
     }
 }
diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index ec91f318044..9f1d2546bec 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -49,14 +49,14 @@ public function testEnabledIsFalseWhenDisabled()
 
     public function testEnabledIsFalseWhenRouteExists()
     {
-        Hyde::routes()->put('docs/search', new InMemoryPage('docs/search'));
+        Hyde::pages()->put('docs/search', new InMemoryPage('docs/search'));
         $this->assertFalse(DocumentationSearchPage::enabled());
     }
 
     public function testEnabledIsFalseWhenDisabledAndRouteExists()
     {
         config(['docs.create_search_page' => false]);
-        Hyde::routes()->put('docs/search', new InMemoryPage('docs/search'));
+        Hyde::pages()->put('docs/search', new InMemoryPage('docs/search'));
         $this->assertFalse(DocumentationSearchPage::enabled());
     }
 }

From 53d41b81c8e916f0fcc4246b2fa05f51b9079d59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Dec 2023 16:40:15 +0100
Subject: [PATCH 0044/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d1ba26e97a6..31f6df9770b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,3 +39,16 @@ The documentation search page and search index have been changed to be generated
 In case you have customized the GenerateSearch post-build task, you will need to adapt your code to the new InMemoryPage, which is generated in the HydeCoreExtension class.
 
 For more information, see https://github.com/hydephp/develop/pull/1498.
+
+### Breaking changes
+
+#### Low impact
+- The `GenerateSearch` post-build task has been removed. If you have previously extended or customized this class, 
+  you will need to adapt your code, as the search index files are now handled implicitly during the standard build process,
+  as the search pages are now added to the kernel page and route collection. (https://github.com/hydephp/develop/pull/1498)
+- If your site has a custom documentation search page, for example `_docs/search.md` or `_pages/docs/search.blade.php`,
+  that page will no longer be build when using the specific `build:search` command. It will, of course, 
+  be built using the standard `build` command. https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
+- In the highly unlikely event your site customizes any of the search pages by replacing them in the kernel route collection,
+  you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
+  https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced

From 3bad9138c1e785f3b2a28c7c0530e1fc93bcc14f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Dec 2023 19:59:55 +0100
Subject: [PATCH 0045/4023] Breaking: Remove the GenerateSearch build task

---
 .../Actions/PostBuildTasks/GenerateSearch.php | 34 -------------------
 .../Commands/BuildSearchCommandTest.php       |  1 -
 .../Feature/Services/BuildTaskServiceTest.php |  1 -
 .../tests/Unit/BuildTaskServiceUnitTest.php   |  6 ----
 4 files changed, 42 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php

diff --git a/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php b/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php
deleted file mode 100644
index a2d115a6e96..00000000000
--- a/packages/framework/src/Framework/Actions/PostBuildTasks/GenerateSearch.php
+++ /dev/null
@@ -1,34 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Actions\PostBuildTasks;
-
-use Hyde\Framework\Concerns\InteractsWithDirectories;
-use Hyde\Framework\Features\BuildTasks\PostBuildTask;
-use Hyde\Framework\Features\Documentation\DocumentationSearchPage;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
-
-/** @deprecated */
-class GenerateSearch extends PostBuildTask
-{
-    use InteractsWithDirectories;
-
-    public static string $message = 'Generating search index';
-
-    protected string $path;
-
-    public function handle(): void
-    {
-        $this->path = GeneratesDocumentationSearchIndex::handle();
-
-        if (DocumentationSearchPage::enabled()) {
-            $this->createdSiteFile(DocumentationSearchPage::generate());
-        }
-    }
-
-    public function printFinishMessage(): void
-    {
-        $this->createdSiteFile($this->path)->withExecutionTime();
-    }
-}
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index dfcf392d5bf..9562ae12512 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -12,7 +12,6 @@
 
 /**
  * @covers \Hyde\Console\Commands\BuildSearchCommand
- * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
  * @covers \Hyde\Framework\Features\Documentation\DocumentationSearchPage
  * @covers \Hyde\Framework\Features\Documentation\DocumentationSearchIndex
  */
diff --git a/packages/framework/tests/Feature/Services/BuildTaskServiceTest.php b/packages/framework/tests/Feature/Services/BuildTaskServiceTest.php
index 0260d37a8f6..347f83530ca 100644
--- a/packages/framework/tests/Feature/Services/BuildTaskServiceTest.php
+++ b/packages/framework/tests/Feature/Services/BuildTaskServiceTest.php
@@ -19,7 +19,6 @@
  * @covers \Hyde\Framework\Features\BuildTasks\PostBuildTask
  * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap
  * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed
- * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
  *
  * @see \Hyde\Framework\Testing\Unit\BuildTaskServiceUnitTest
  */
diff --git a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
index 1b08979d54f..bcf14ff42a2 100644
--- a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
@@ -8,7 +8,6 @@
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateBuildManifest;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed;
-use Hyde\Framework\Actions\PostBuildTasks\GenerateSearch;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap as FrameworkGenerateSitemap;
 use Hyde\Framework\Features\BuildTasks\BuildTask;
 use Hyde\Framework\Features\BuildTasks\PostBuildTask;
@@ -167,11 +166,6 @@ public function testGenerateRssFeedExtendsPostBuildTask()
         $this->assertInstanceOf(PostBuildTask::class, new GenerateRssFeed());
     }
 
-    public function testGenerateSearchExtendsPostBuildTask()
-    {
-        $this->assertInstanceOf(PostBuildTask::class, new GenerateSearch());
-    }
-
     public function testGenerateSitemapExtendsPostBuildTask()
     {
         $this->assertInstanceOf(PostBuildTask::class, new FrameworkGenerateSitemap());

From aeeed9f4fab5edab6513ef1c5210e9a1a4e349e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Dec 2023 20:26:26 +0100
Subject: [PATCH 0046/4023] Cleanup and improve release notes

---
 RELEASE_NOTES.md | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 31f6df9770b..599dcd1e614 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,17 +10,17 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
-- Add experimental InMemoryPage::getOutputPath overload support
+- Add experimental `InMemoryPage::getOutputPath` overload support
 
 ### Changed
-- Changed how the documentation search is generated, to be an InMemoryPage instead of a post-build task.
-- Updated the documentation article component to support existing $document instance.
+- Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
+- Updated the documentation article component to support existing `$document` instance.
 
 ### Deprecated
-- \Hyde\Framework\Actions\PostBuildTasks\GenerateSearch
+- for soon-to-be removed features.
 
 ### Removed
-- for now removed features.
+- Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 
 ### Fixed
 - for any bug fixes.
@@ -32,23 +32,29 @@ This serves two purposes:
 
 If there are any breaking changes, include an upgrade guide here.
 
-#### Documentation search changes
+#### Documentation search page changes
 
-The documentation search page and search index have been changed to be generated as InMemoryPages instead of a post-build task.
+The documentation search page and search index have been changed to be generated as `InMemoryPages` instead of a post-build task.
 
-In case you have customized the GenerateSearch post-build task, you will need to adapt your code to the new InMemoryPage, which is generated in the HydeCoreExtension class.
+The main impact noticeable to most users by this is the implicit changes, like the pages showing up in the dashboard and route list command.
+
+In case you have customized the `GenerateSearch` post-build task you may, depending on what you were trying to do, 
+want to adapt your code to interact with the new `InMemoryPage`, which is generated in the `HydeCoreExtension` class.
 
 For more information, see https://github.com/hydephp/develop/pull/1498.
 
 ### Breaking changes
 
 #### Low impact
+
 - The `GenerateSearch` post-build task has been removed. If you have previously extended or customized this class, 
   you will need to adapt your code, as the search index files are now handled implicitly during the standard build process,
   as the search pages are now added to the kernel page and route collection. (https://github.com/hydephp/develop/pull/1498)
+
 - If your site has a custom documentation search page, for example `_docs/search.md` or `_pages/docs/search.blade.php`,
-  that page will no longer be build when using the specific `build:search` command. It will, of course, 
+  that page will no longer be built when using the specific `build:search` command. It will, of course, 
   be built using the standard `build` command. https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
+- 
 - In the highly unlikely event your site customizes any of the search pages by replacing them in the kernel route collection,
   you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
   https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced

From e43d6e829ce914422cf927c21bbc0575b105b145 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 10:47:03 +0100
Subject: [PATCH 0047/4023] Improve code comment

---
 .../Features/Documentation/DocumentationSearchPage.php         | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index a352a250358..27150145f3d 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -49,7 +49,8 @@ public static function enabled(): bool
 
     protected static function anotherSearchPageExists(): bool
     {
-        // Since routes aren't discovered yet, we need to check the pages directly
+        // Since routes aren't discovered yet due to this page being added in the core extension,
+        // we need to check the page collection directly, instead of the route collection.
         return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
 

From 32a1ee5e085bf367d96a6546acfa2d05672c26f3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 10:46:00 +0100
Subject: [PATCH 0048/4023] Use helper method with same code

---
 .../Features/Documentation/DocumentationSearchPage.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 27150145f3d..e3070f59897 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -35,7 +35,7 @@ public static function generate(): string
      */
     public function __construct()
     {
-        parent::__construct(ltrim(DocumentationPage::outputDirectory().'/search', '/'), [
+        parent::__construct(static::routeKey(), [
             'title' => 'Search',
             'navigation' => ['hidden' => true],
             'document' => $this->makeDocument(),

From eb07152ae1cdece442145fd5f44808d74234e912 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:12:23 +0100
Subject: [PATCH 0049/4023] Revert "Remove internal
 `DocumentationSearchPage::routeKey()` method"

This reverts commit 0838ab4f25f75299f28495dcb9191e03a1ea0f3a as the class is internal it doesn't bog up the public API, but we can still use it to reduce overlapping logic in our codebase.
---
 .../Documentation/DocumentationSearchPage.php         |  3 ++-
 .../tests/Feature/DocumentationSearchPageTest.php     | 11 +++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index e3070f59897..d5d90690c25 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -54,7 +54,8 @@ protected static function anotherSearchPageExists(): bool
         return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
 
-    protected static function routeKey(): string
+    /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
+    public static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search');
     }
diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index 9f1d2546bec..cfb45b76a0c 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -59,4 +59,15 @@ public function testEnabledIsFalseWhenDisabledAndRouteExists()
         Hyde::pages()->put('docs/search', new InMemoryPage('docs/search'));
         $this->assertFalse(DocumentationSearchPage::enabled());
     }
+
+    public function testStaticRouteKeyHelper()
+    {
+        $this->assertSame('docs/search', DocumentationSearchPage::routeKey());
+    }
+
+    public function testStaticRouteKeyHelperWithCustomOutputDirectory()
+    {
+        DocumentationPage::setOutputDirectory('foo');
+        $this->assertSame('foo/search', DocumentationSearchPage::routeKey());
+    }
 }

From ef0fa703c47ec82f9218bb8eab1b325efefc6deb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:13:49 +0100
Subject: [PATCH 0050/4023] Revert internal deprecation

This partially reverts commit 6c932a1bf49cce15e0214a063532c85ca50d7306.
---
 .../Framework/Features/Documentation/DocumentationSearchPage.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index d5d90690c25..d61a24b8105 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -54,7 +54,6 @@ protected static function anotherSearchPageExists(): bool
         return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
 
-    /** @deprecated Can be removed by https://github.com/hydephp/develop/pull/1498 */
     public static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search');

From 883c09d9474ac9d003fede67f9f21e6ad2131186 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:21:48 +0100
Subject: [PATCH 0051/4023] Move up public method

---
 .../Features/Documentation/DocumentationSearchPage.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index d61a24b8105..f9d92c1556e 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -47,6 +47,11 @@ public static function enabled(): bool
         return Config::getBool('docs.create_search_page', true) && ! static::anotherSearchPageExists();
     }
 
+    public static function routeKey(): string
+    {
+        return ltrim(DocumentationPage::outputDirectory().'/search');
+    }
+
     protected static function anotherSearchPageExists(): bool
     {
         // Since routes aren't discovered yet due to this page being added in the core extension,
@@ -54,11 +59,6 @@ protected static function anotherSearchPageExists(): bool
         return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
 
-    public static function routeKey(): string
-    {
-        return ltrim(DocumentationPage::outputDirectory().'/search');
-    }
-
     /** @experimental Fixes type issue {@see https://github.com/hydephp/develop/commit/37f7046251b8c0514b8d8ef821de4ef3d35bbac8#commitcomment-135026537} */
     protected function makeDocument(): SemanticDocumentationArticle
     {

From 89c63523196e5816938b3a9eecb957041faffaad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:21:59 +0100
Subject: [PATCH 0052/4023] Import used function

---
 .../Features/Documentation/DocumentationSearchPage.php          | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index f9d92c1556e..4e6c1778678 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -11,6 +11,8 @@
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Facades\Config;
 
+use function ltrim;
+
 /**
  * @internal This page is used to render the search page for the documentation.
  *

From 0f8fe02c68cace2d5ab9567195d8f6d7e6ce243c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:35:38 +0100
Subject: [PATCH 0053/4023] Fix missing trim argument

Required in case of root outputs so that the route key is relative
---
 .../Features/Documentation/DocumentationSearchPage.php      | 2 +-
 .../framework/tests/Feature/DocumentationSearchPageTest.php | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 4e6c1778678..e16fe950279 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -51,7 +51,7 @@ public static function enabled(): bool
 
     public static function routeKey(): string
     {
-        return ltrim(DocumentationPage::outputDirectory().'/search');
+        return ltrim(DocumentationPage::outputDirectory().'/search', '/');
     }
 
     protected static function anotherSearchPageExists(): bool
diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index cfb45b76a0c..e7a2adc4dc3 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -70,4 +70,10 @@ public function testStaticRouteKeyHelperWithCustomOutputDirectory()
         DocumentationPage::setOutputDirectory('foo');
         $this->assertSame('foo/search', DocumentationSearchPage::routeKey());
     }
+
+    public function testStaticRouteKeyHelperWithRootOutputDirectory()
+    {
+        DocumentationPage::setOutputDirectory('');
+        $this->assertSame('search', DocumentationSearchPage::routeKey());
+    }
 }

From b7a253777b8c0caca3d697f679fba3bb30450810 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 11:43:30 +0100
Subject: [PATCH 0054/4023] Extract internal route key helper

Reduces the amount of times and places we call the exact same logic
---
 .../components/docs/search-scripts.blade.php    |  2 +-
 .../GeneratesDocumentationSearchIndex.php       |  3 ++-
 .../Documentation/DocumentationSearchIndex.php  |  9 ++++++++-
 .../Feature/DocumentationSearchIndexTest.php    | 17 +++++++++++++++++
 4 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-scripts.blade.php b/packages/framework/resources/views/components/docs/search-scripts.blade.php
index 0d381221c29..f2561c84b61 100644
--- a/packages/framework/resources/views/components/docs/search-scripts.blade.php
+++ b/packages/framework/resources/views/components/docs/search-scripts.blade.php
@@ -1,7 +1,7 @@
 <script src="https://cdn.jsdelivr.net/npm/hydesearch@0.2.1/dist/HydeSearch.min.js" defer></script>
 <script>
     window.addEventListener('load', function () {
-        const searchIndexLocation = '{{ Hyde::relativeLink(ltrim(DocumentationPage::outputDirectory().'/search.json', '/')) }}';
+        const searchIndexLocation = '{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::routeKey()) }}';
         const Search = new HydeSearch(searchIndexLocation);
 
         Search.init();
diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 64bbb7d8e67..cf55338757c 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -10,6 +10,7 @@
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 use function basename;
 use function in_array;
@@ -101,7 +102,7 @@ protected function formatDestination(string $slug): string
 
     protected function getPath(): string
     {
-        return Hyde::sitePath(DocumentationPage::outputDirectory().'/search.json');
+        return Hyde::sitePath(DocumentationSearchIndex::routeKey());
     }
 
     protected function getPagesToExcludeFromSearch(): array
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 2cb5aab6298..5d88dbc7a41 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -8,6 +8,8 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
+use function ltrim;
+
 /**
  * @internal This page is used to render the search index for the documentation.
  */
@@ -18,7 +20,7 @@ class DocumentationSearchIndex extends InMemoryPage
      */
     public function __construct()
     {
-        parent::__construct(ltrim(DocumentationPage::outputDirectory().'/search.json', '/'), [
+        parent::__construct(static::routeKey(), [
             'navigation' => ['hidden' => true],
         ]);
     }
@@ -29,6 +31,11 @@ public function compile(): string
     }
 
     public function getOutputPath(): string
+    {
+        return static::routeKey();
+    }
+
+    public static function routeKey(): string
     {
         return ltrim(DocumentationPage::outputDirectory().'/search.json', '/');
     }
diff --git a/packages/framework/tests/Feature/DocumentationSearchIndexTest.php b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
index 58de0d066dd..77c51e57052 100644
--- a/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
@@ -33,4 +33,21 @@ public function testRouteKeyIsSetToConfiguredDocumentationOutputDirectory()
         $page = new DocumentationSearchIndex();
         $this->assertSame('foo/search.json', $page->routeKey);
     }
+
+    public function testStaticRouteKeyHelper()
+    {
+        $this->assertSame('docs/search.json', DocumentationSearchIndex::routeKey());
+    }
+
+    public function testStaticRouteKeyHelperWithCustomOutputDirectory()
+    {
+        DocumentationPage::setOutputDirectory('foo');
+        $this->assertSame('foo/search.json', DocumentationSearchIndex::routeKey());
+    }
+
+    public function testStaticRouteKeyHelperWithRootOutputDirectory()
+    {
+        DocumentationPage::setOutputDirectory('');
+        $this->assertSame('search.json', DocumentationSearchIndex::routeKey());
+    }
 }

From 2d46f6bbd1707f149473218fcc43946e24d69443 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 12:01:00 +0100
Subject: [PATCH 0055/4023] Revert "Add experimental
 `InMemoryPage::getOutputPath` overload support"

This reverts commit 697e016fb300334e602576084775d28fd5b81d59. See https://github.com/hydephp/develop/pull/1498/files#r1429894023

Also updates a test to use a test class instead of using the macro (which was it's only current usage)
---
 RELEASE_NOTES.md                              |  2 +-
 packages/framework/src/Pages/InMemoryPage.php | 10 ----------
 .../Commands/BuildSearchCommandTest.php       | 19 +++++++++++++++----
 3 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 599dcd1e614..011f4567940 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,7 +10,7 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
-- Add experimental `InMemoryPage::getOutputPath` overload support
+- for new features.
 
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
diff --git a/packages/framework/src/Pages/InMemoryPage.php b/packages/framework/src/Pages/InMemoryPage.php
index 56a429344e2..541e9356ec9 100644
--- a/packages/framework/src/Pages/InMemoryPage.php
+++ b/packages/framework/src/Pages/InMemoryPage.php
@@ -82,16 +82,6 @@ public function getBladeView(): string
         return $this->view;
     }
 
-    /** @experimental Get the path to the output file for the page. */
-    public function getOutputPath(): string
-    {
-        if ($this->hasMacro('getOutputPath')) {
-            return $this->__call('getOutputPath', []);
-        }
-
-        return parent::getOutputPath();
-    }
-
     /**
      * Get the contents that will be saved to disk for this page.
      *
diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 9562ae12512..2ba0891886e 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -9,6 +9,7 @@
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
+use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 /**
  * @covers \Hyde\Console\Commands\BuildSearchCommand
@@ -107,10 +108,7 @@ public function test_search_files_can_be_generated_for_custom_site_and_nested_do
 
     public function test_command_uses_search_pages_from_kernel_when_present()
     {
-        Hyde::pages()->addPage(tap(new InMemoryPage('docs/search.json'), function (InMemoryPage $page): void {
-            $page->macro('compile', fn () => '{"foo":"bar"}');
-            $page->macro('getOutputPath', fn () => 'docs/search.json');
-        }));
+        Hyde::pages()->addPage(new SearchIndexOverrideTestPage());
 
         Hyde::pages()->addPage(tap(new InMemoryPage('docs/search'), function (InMemoryPage $page): void {
             $page->macro('compile', fn () => 'Foo');
@@ -128,3 +126,16 @@ public function test_command_uses_search_pages_from_kernel_when_present()
 //        Filesystem::unlink('_site/docs/search.html');
     }
 }
+
+class SearchIndexOverrideTestPage extends DocumentationSearchIndex
+{
+    public function compile(): string
+    {
+        return '{"foo":"bar"}';
+    }
+
+    public function getOutputPath(): string
+    {
+        return 'docs/search.json';
+    }
+}

From d86f5433365c540bf9a14c4f97e3b937711db353 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 15:40:04 +0100
Subject: [PATCH 0056/4023] Replace instance override with static

Same semantics, just cleaner
---
 .../Features/Documentation/DocumentationSearchIndex.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 5d88dbc7a41..c7b5ea94ec1 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -30,7 +30,7 @@ public function compile(): string
         return GeneratesDocumentationSearchIndex::generate();
     }
 
-    public function getOutputPath(): string
+    public static function outputPath(string $identifier): string
     {
         return static::routeKey();
     }

From a33a3f57dc8cfc98436606032da80255c35b58a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 15:47:35 +0100
Subject: [PATCH 0057/4023] Refactor to use RouteKey helper

Now it uses the same code as the default parent outputPath helper but with a different extension
---
 .../Features/Documentation/DocumentationSearchIndex.php      | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index c7b5ea94ec1..81f9ca514eb 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -6,10 +6,9 @@
 
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Support\Models\RouteKey;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
-use function ltrim;
-
 /**
  * @internal This page is used to render the search index for the documentation.
  */
@@ -37,6 +36,6 @@ public static function outputPath(string $identifier): string
 
     public static function routeKey(): string
     {
-        return ltrim(DocumentationPage::outputDirectory().'/search.json', '/');
+        return RouteKey::fromPage(DocumentationPage::class, 'search').'.json';
     }
 }

From 076c39831b6e578940f659189c7d60991c21cb89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 15:50:57 +0100
Subject: [PATCH 0058/4023] Add default value to make parameter optional

Since it is ignored here it's weird to require it
---
 .../Features/Documentation/DocumentationSearchIndex.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 81f9ca514eb..d83de6d14dc 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -29,7 +29,7 @@ public function compile(): string
         return GeneratesDocumentationSearchIndex::generate();
     }
 
-    public static function outputPath(string $identifier): string
+    public static function outputPath(string $identifier = ''): string
     {
         return static::routeKey();
     }

From be553d7bb739c2ff504773fa21e008294598c88f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 15:51:07 +0100
Subject: [PATCH 0059/4023] Shift logic to different internal helper

---
 .../Features/Documentation/DocumentationSearchIndex.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index d83de6d14dc..68b927b45d7 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -31,11 +31,11 @@ public function compile(): string
 
     public static function outputPath(string $identifier = ''): string
     {
-        return static::routeKey();
+        return RouteKey::fromPage(DocumentationPage::class, 'search').'.json';
     }
 
     public static function routeKey(): string
     {
-        return RouteKey::fromPage(DocumentationPage::class, 'search').'.json';
+        return static::outputPath();
     }
 }

From 83cfa5abb76e0bae24bda7e977855d1e0202b4fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 15:52:35 +0100
Subject: [PATCH 0060/4023] Inline simplified helper

---
 .../views/components/docs/search-scripts.blade.php   |  2 +-
 .../Actions/GeneratesDocumentationSearchIndex.php    |  2 +-
 .../Documentation/DocumentationSearchIndex.php       |  7 +------
 .../tests/Feature/DocumentationSearchIndexTest.php   | 12 ++++++------
 4 files changed, 9 insertions(+), 14 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-scripts.blade.php b/packages/framework/resources/views/components/docs/search-scripts.blade.php
index f2561c84b61..6da5968e532 100644
--- a/packages/framework/resources/views/components/docs/search-scripts.blade.php
+++ b/packages/framework/resources/views/components/docs/search-scripts.blade.php
@@ -1,7 +1,7 @@
 <script src="https://cdn.jsdelivr.net/npm/hydesearch@0.2.1/dist/HydeSearch.min.js" defer></script>
 <script>
     window.addEventListener('load', function () {
-        const searchIndexLocation = '{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::routeKey()) }}';
+        const searchIndexLocation = '{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}';
         const Search = new HydeSearch(searchIndexLocation);
 
         Search.init();
diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index cf55338757c..45f7a24c5e9 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -102,7 +102,7 @@ protected function formatDestination(string $slug): string
 
     protected function getPath(): string
     {
-        return Hyde::sitePath(DocumentationSearchIndex::routeKey());
+        return Hyde::sitePath(DocumentationSearchIndex::outputPath());
     }
 
     protected function getPagesToExcludeFromSearch(): array
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 68b927b45d7..5ec5b32db00 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -19,7 +19,7 @@ class DocumentationSearchIndex extends InMemoryPage
      */
     public function __construct()
     {
-        parent::__construct(static::routeKey(), [
+        parent::__construct(DocumentationSearchIndex::outputPath(), [
             'navigation' => ['hidden' => true],
         ]);
     }
@@ -33,9 +33,4 @@ public static function outputPath(string $identifier = ''): string
     {
         return RouteKey::fromPage(DocumentationPage::class, 'search').'.json';
     }
-
-    public static function routeKey(): string
-    {
-        return static::outputPath();
-    }
 }
diff --git a/packages/framework/tests/Feature/DocumentationSearchIndexTest.php b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
index 77c51e57052..7cc9b8939d7 100644
--- a/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchIndexTest.php
@@ -34,20 +34,20 @@ public function testRouteKeyIsSetToConfiguredDocumentationOutputDirectory()
         $this->assertSame('foo/search.json', $page->routeKey);
     }
 
-    public function testStaticRouteKeyHelper()
+    public function testStaticOutputPathHelper()
     {
-        $this->assertSame('docs/search.json', DocumentationSearchIndex::routeKey());
+        $this->assertSame('docs/search.json', DocumentationSearchIndex::outputPath());
     }
 
-    public function testStaticRouteKeyHelperWithCustomOutputDirectory()
+    public function testStaticOutputPathHelperWithCustomOutputDirectory()
     {
         DocumentationPage::setOutputDirectory('foo');
-        $this->assertSame('foo/search.json', DocumentationSearchIndex::routeKey());
+        $this->assertSame('foo/search.json', DocumentationSearchIndex::outputPath());
     }
 
-    public function testStaticRouteKeyHelperWithRootOutputDirectory()
+    public function testStaticOutputPathHelperWithRootOutputDirectory()
     {
         DocumentationPage::setOutputDirectory('');
-        $this->assertSame('search.json', DocumentationSearchIndex::routeKey());
+        $this->assertSame('search.json', DocumentationSearchIndex::outputPath());
     }
 }

From d81a2abed260bd693985910be5066ee142735e64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 19:19:52 +0100
Subject: [PATCH 0061/4023] Use the RouteKey helper

---
 .../Features/Documentation/DocumentationSearchPage.php       | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index e16fe950279..ed91c2c87f1 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -8,11 +8,10 @@
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\Concerns\HydePage;
+use Hyde\Support\Models\RouteKey;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Facades\Config;
 
-use function ltrim;
-
 /**
  * @internal This page is used to render the search page for the documentation.
  *
@@ -51,7 +50,7 @@ public static function enabled(): bool
 
     public static function routeKey(): string
     {
-        return ltrim(DocumentationPage::outputDirectory().'/search', '/');
+        return RouteKey::fromPage(DocumentationPage::class, 'search')->get();
     }
 
     protected static function anotherSearchPageExists(): bool

From aa625168be131ef5a341eeb672503a891f014a7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 22:35:40 +0100
Subject: [PATCH 0062/4023] Revert "Deprecate internal
 `GeneratesDocumentationSearchIndex::handle` method"

This reverts commit feb99e9d681f802554e38a9235f856cdc651de63.
---
 .../src/Framework/Actions/GeneratesDocumentationSearchIndex.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 45f7a24c5e9..835084bfd39 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -27,7 +27,7 @@ class GeneratesDocumentationSearchIndex
     protected string $path;
 
     /**
-     * @deprecated Generate the search index and save it to disk.
+     * Generate the search index and save it to disk.
      *
      * @return string The path to the generated file.
      */

From 02ed17d00935f1e5a086605222a3a1fcee54b63b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 22:36:12 +0100
Subject: [PATCH 0063/4023] Revert "Add new internal
 `GeneratesDocumentationSearchIndex::generate` method"

This reverts commit d9eec2881648aab1742a18689257daf20668d79c.
---
 .../Actions/GeneratesDocumentationSearchIndex.php     | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 835084bfd39..30aeecc0d7f 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -40,17 +40,6 @@ public static function handle(): string
         return $service->path;
     }
 
-    /**
-     * Generate the search index return it as a string.
-     */
-    public static function generate(): string
-    {
-        $service = new static();
-        $service->run();
-
-        return $service->index->toJson();
-    }
-
     protected function __construct()
     {
         $this->index = new Collection();

From 1c378515fe2d8f637e2b0f27a0d7b9059f69e222 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Dec 2023 22:35:19 +0100
Subject: [PATCH 0064/4023] Change internal search generator method to return
 JSON directly

Since saving to disk is handled by the build process, this class now just needs to be responsible for generating the JSON. See https://github.com/hydephp/develop/pull/1498
---
 .../GeneratesDocumentationSearchIndex.php     | 24 +++--------------
 .../DocumentationSearchIndex.php              |  2 +-
 .../DocumentationSearchServiceTest.php        | 26 +++----------------
 3 files changed, 7 insertions(+), 45 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 30aeecc0d7f..17f9a103474 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -4,30 +4,26 @@
 
 namespace Hyde\Framework\Actions;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Hyde\Facades\Filesystem;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
-use Hyde\Framework\Features\Documentation\DocumentationSearchIndex;
 
 use function basename;
 use function in_array;
 use function trim;
 
 /**
- * @internal Generate a JSON file that can be used as a search index for documentation pages.
+ * @internal Generate a JSON string that can be used as a search index for documentation pages.
  */
 class GeneratesDocumentationSearchIndex
 {
     use InteractsWithDirectories;
 
     protected Collection $index;
-    protected string $path;
 
     /**
-     * Generate the search index and save it to disk.
+     * @since v2.x This method returns the JSON string instead of saving it to disk and returning the path.
      *
      * @return string The path to the generated file.
      */
@@ -35,15 +31,13 @@ public static function handle(): string
     {
         $service = new static();
         $service->run();
-        $service->save();
 
-        return $service->path;
+        return $service->index->toJson();
     }
 
     protected function __construct()
     {
         $this->index = new Collection();
-        $this->path = $this->getPath();
     }
 
     protected function run(): void
@@ -68,13 +62,6 @@ protected function generatePageEntry(DocumentationPage $page): array
         ];
     }
 
-    protected function save(): void
-    {
-        $this->needsParentDirectory($this->path);
-
-        Filesystem::putContents($this->path, $this->index->toJson());
-    }
-
     protected function getSearchContentForDocument(DocumentationPage $page): string
     {
         return (new ConvertsMarkdownToPlainText($page->markdown->body()))->execute();
@@ -89,11 +76,6 @@ protected function formatDestination(string $slug): string
         return "$slug.html";
     }
 
-    protected function getPath(): string
-    {
-        return Hyde::sitePath(DocumentationSearchIndex::outputPath());
-    }
-
     protected function getPagesToExcludeFromSearch(): array
     {
         return array_merge(Config::getArray('docs.exclude_from_search', []), Config::getBool('docs.create_search_page', true) ? ['search'] : []);
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
index 5ec5b32db00..ac14115b422 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchIndex.php
@@ -26,7 +26,7 @@ public function __construct()
 
     public function compile(): string
     {
-        return GeneratesDocumentationSearchIndex::generate();
+        return GeneratesDocumentationSearchIndex::handle();
     }
 
     public static function outputPath(string $identifier = ''): string
diff --git a/packages/framework/tests/Feature/Services/DocumentationSearchServiceTest.php b/packages/framework/tests/Feature/Services/DocumentationSearchServiceTest.php
index 0689b4665bb..f43165cdafa 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSearchServiceTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSearchServiceTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature\Services;
 
-use Hyde\Facades\Filesystem;
 use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 use Hyde\Hyde;
 use Hyde\Testing\CreatesTemporaryFiles;
@@ -32,14 +31,12 @@ public function test_it_generates_a_json_file_with_a_search_index()
     {
         $this->file('_docs/foo.md');
 
-        GeneratesDocumentationSearchIndex::handle();
-
         $this->assertSame(json_encode([[
             'slug' => 'foo',
             'title' => 'Foo',
             'content' => '',
             'destination' => 'foo.html',
-        ]]), file_get_contents('_site/docs/search.json'));
+        ]]), GeneratesDocumentationSearchIndex::handle());
     }
 
     public function test_it_adds_all_files_to_search_index()
@@ -53,20 +50,7 @@ public function test_it_adds_all_files_to_search_index()
 
     public function test_it_handles_generation_even_when_there_are_no_pages()
     {
-        GeneratesDocumentationSearchIndex::handle();
-
-        $this->assertSame('[]', file_get_contents('_site/docs/search.json'));
-
-        Filesystem::unlink('_site/docs/search.json');
-    }
-
-    public function test_save_method_saves_the_file_to_the_correct_location()
-    {
-        GeneratesDocumentationSearchIndex::handle();
-
-        $this->assertFileExists('_site/docs/search.json');
-
-        Filesystem::unlink('_site/docs/search.json');
+        $this->assertSame('[]', GeneratesDocumentationSearchIndex::handle());
     }
 
     public function test_it_generates_a_valid_JSON()
@@ -134,10 +118,6 @@ public function test_nested_source_files_do_not_retain_directory_name_in_search_
 
     protected function getArray(): array
     {
-        GeneratesDocumentationSearchIndex::handle();
-        $array = json_decode(file_get_contents('_site/docs/search.json'), true);
-        Filesystem::unlink('_site/docs/search.json');
-
-        return $array;
+        return json_decode(GeneratesDocumentationSearchIndex::handle(), true);
     }
 }

From b868613ff66502798a36f7ab34347f6831a84f21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 19 Dec 2023 14:42:04 +0100
Subject: [PATCH 0065/4023] Format long line

---
 .../Framework/Actions/GeneratesDocumentationSearchIndex.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
index 17f9a103474..7cd75691d9d 100644
--- a/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
+++ b/packages/framework/src/Framework/Actions/GeneratesDocumentationSearchIndex.php
@@ -78,6 +78,8 @@ protected function formatDestination(string $slug): string
 
     protected function getPagesToExcludeFromSearch(): array
     {
-        return array_merge(Config::getArray('docs.exclude_from_search', []), Config::getBool('docs.create_search_page', true) ? ['search'] : []);
+        return array_merge(Config::getArray('docs.exclude_from_search', []),
+            Config::getBool('docs.create_search_page', true) ? ['search'] : []
+        );
     }
 }

From f72e5038e4f5fcb5c4299a934d91f3ace15c3a5d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 19 Dec 2023 16:39:04 +0100
Subject: [PATCH 0066/4023] Remove legacy assertions

The change in behaviour has been documented, so we can remove the disabled legacy assertions
---
 .../tests/Feature/Commands/BuildSearchCommandTest.php          | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
index 2ba0891886e..6accb4a1370 100644
--- a/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSearchCommandTest.php
@@ -117,13 +117,10 @@ public function test_command_uses_search_pages_from_kernel_when_present()
         $this->artisan('build:search')->assertExitCode(0);
 
         $this->assertFileExists(Hyde::path('_site/docs/search.json'));
-//        $this->assertFileExists(Hyde::path('_site/docs/search.html'));
 
         $this->assertSame('{"foo":"bar"}', Filesystem::getContents('_site/docs/search.json'));
-//        $this->assertSame('Foo', Filesystem::getContents('_site/docs/search.html'));
 
         Filesystem::unlink('_site/docs/search.json');
-//        Filesystem::unlink('_site/docs/search.html');
     }
 }
 

From ac269982ab9051b54822bbc14336a2d445739958 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:01:46 +0100
Subject: [PATCH 0067/4023] Create TransferMediaAssets.php

---
 .../Actions/PreBuildTasks/TransferMediaAssets.php    | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
new file mode 100644
index 00000000000..a36d8ce9a72
--- /dev/null
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Actions\PreBuildTasks;
+
+use Hyde\Framework\Features\BuildTasks\PreBuildTask;
+
+class TransferMediaAssets extends PreBuildTask
+{
+    //
+}

From 6b67a3cce61b1591a234a44452066aa6f4b321f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:03:04 +0100
Subject: [PATCH 0068/4023] Set message

---
 .../src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index a36d8ce9a72..657fa9ffac3 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -8,5 +8,5 @@
 
 class TransferMediaAssets extends PreBuildTask
 {
-    //
+    protected static string $message = 'Transferring Media Assets';
 }

From 2259a40b3fff6323aad2a63a32429c4599758fb7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:03:08 +0100
Subject: [PATCH 0069/4023] Register task

---
 packages/framework/src/Framework/Services/BuildTaskService.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Services/BuildTaskService.php b/packages/framework/src/Framework/Services/BuildTaskService.php
index d2eb432a015..c65452ef09d 100644
--- a/packages/framework/src/Framework/Services/BuildTaskService.php
+++ b/packages/framework/src/Framework/Services/BuildTaskService.php
@@ -13,6 +13,7 @@
 use Hyde\Framework\Actions\PreBuildTasks\CleanSiteDirectory;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap;
+use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateBuildManifest;
 use Illuminate\Console\OutputStyle;
 use Illuminate\Support\Str;
@@ -132,6 +133,7 @@ protected function makeTaskIdentifier(BuildTask $class): string
     private function registerFrameworkTasks(): void
     {
         $this->registerIf(CleanSiteDirectory::class, $this->canCleanSiteDirectory());
+        $this->registerTask(TransferMediaAssets::class);
         $this->registerIf(GenerateBuildManifest::class, $this->canGenerateManifest());
         $this->registerIf(GenerateSitemap::class, $this->canGenerateSitemap());
         $this->registerIf(GenerateRssFeed::class, $this->canGenerateFeed());

From cfb9148e8d5feefc97935b628e95f4cb16e3e714 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:06:57 +0100
Subject: [PATCH 0070/4023] Move media asset transfer logic to build task

---
 .../PreBuildTasks/TransferMediaAssets.php        | 16 ++++++++++++++++
 .../src/Framework/Services/BuildService.php      | 15 +--------------
 2 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 657fa9ffac3..025c0ee7bcc 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -4,9 +4,25 @@
 
 namespace Hyde\Framework\Actions\PreBuildTasks;
 
+use Hyde\Hyde;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
+use Hyde\Framework\Concerns\InteractsWithDirectories;
 
 class TransferMediaAssets extends PreBuildTask
 {
     protected static string $message = 'Transferring Media Assets';
+
+    use InteractsWithDirectories;
+
+    public function handle(): void
+    {
+        $this->needsDirectory(Hyde::siteMediaPath());
+
+        $this->withProgressBar(MediaFile::files(), function (string $identifier): void {
+            $sitePath = Hyde::siteMediaPath($identifier);
+            $this->needsParentDirectory($sitePath);
+            copy(Hyde::mediaPath($identifier), $sitePath);
+        });
+    }
 }
diff --git a/packages/framework/src/Framework/Services/BuildService.php b/packages/framework/src/Framework/Services/BuildService.php
index 83c2686e011..55a59ef4937 100644
--- a/packages/framework/src/Framework/Services/BuildService.php
+++ b/packages/framework/src/Framework/Services/BuildService.php
@@ -8,9 +8,7 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Actions\StaticPageBuilder;
-use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Hyde\Pages\Concerns\HydePage;
-use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Support\Models\Route;
 use Illuminate\Console\Concerns\InteractsWithIO;
 use Illuminate\Console\OutputStyle;
@@ -18,7 +16,6 @@
 use function class_basename;
 use function preg_replace;
 use function collect;
-use function copy;
 
 /**
  * Moves logic from the build command to a service.
@@ -30,7 +27,6 @@
 class BuildService
 {
     use InteractsWithIO;
-    use InteractsWithDirectories;
 
     protected RouteCollection $router;
 
@@ -50,16 +46,7 @@ public function compileStaticPages(): void
 
     public function transferMediaAssets(): void
     {
-        $this->needsDirectory(Hyde::siteMediaPath());
-
-        $this->comment('Transferring Media Assets...');
-        $this->withProgressBar(MediaFile::files(), function (string $identifier): void {
-            $sitePath = Hyde::siteMediaPath($identifier);
-            $this->needsParentDirectory($sitePath);
-            copy(Hyde::mediaPath($identifier), $sitePath);
-        });
-
-        $this->newLine(2);
+        //
     }
 
     /**

From 4413fdf03e135c3e7c66ae098b3044dfb261cdaf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:19:27 +0100
Subject: [PATCH 0071/4023] Disable finishing message

---
 .../Framework/Actions/PreBuildTasks/TransferMediaAssets.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 025c0ee7bcc..76117cc9375 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -25,4 +25,9 @@ public function handle(): void
             copy(Hyde::mediaPath($identifier), $sitePath);
         });
     }
+
+    public function printFinishMessage(): void
+    {
+        // We don't need a finish message for this task.
+    }
 }

From 2a5bd9df9b92d33aba09b3da265cd1d54679aa5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:23:54 +0100
Subject: [PATCH 0072/4023] Newline is required for progress bar not to clear
 message

For some reason the start message is stripped by the progress bar otherwise
---
 .../src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 76117cc9375..c072f603045 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -19,6 +19,8 @@ public function handle(): void
     {
         $this->needsDirectory(Hyde::siteMediaPath());
 
+        $this->newLine();
+
         $this->withProgressBar(MediaFile::files(), function (string $identifier): void {
             $sitePath = Hyde::siteMediaPath($identifier);
             $this->needsParentDirectory($sitePath);

From 756bb7d4f11ee88944ad54c4c12b41db1333dcf5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:24:20 +0100
Subject: [PATCH 0073/4023] Add newline after progress bar

Just for style
---
 .../src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index c072f603045..fdec03a75ff 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -26,6 +26,8 @@ public function handle(): void
             $this->needsParentDirectory($sitePath);
             copy(Hyde::mediaPath($identifier), $sitePath);
         });
+
+        $this->newLine();
     }
 
     public function printFinishMessage(): void

From 2420e20e8ff29969280e971582bf01de7393805a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:31:28 +0100
Subject: [PATCH 0074/4023] Update command to use new build task

---
 .../framework/src/Console/Commands/RebuildPageCommand.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/RebuildPageCommand.php b/packages/framework/src/Console/Commands/RebuildPageCommand.php
index 1ac5e920fbb..715ac6a6696 100644
--- a/packages/framework/src/Console/Commands/RebuildPageCommand.php
+++ b/packages/framework/src/Console/Commands/RebuildPageCommand.php
@@ -9,7 +9,7 @@
 use Hyde\Foundation\Facades\Pages;
 use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Framework\Features\BuildTasks\BuildTask;
-use Hyde\Framework\Services\BuildService;
+use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
 use Hyde\Hyde;
 use Hyde\Pages\BladePage;
 use Hyde\Pages\DocumentationPage;
@@ -37,7 +37,7 @@ class RebuildPageCommand extends Command
     public function handle(): int
     {
         if ($this->argument('path') === Hyde::getMediaDirectory()) {
-            (new BuildService($this->getOutput()))->transferMediaAssets();
+            return (new TransferMediaAssets())->run($this->output);
 
             $this->info('All done!');
 

From fc4146de37d08b6958fafa86fd8ea27310cc3b37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:40:32 +0100
Subject: [PATCH 0075/4023] Update unit test to expect media transfer action

---
 .../tests/Unit/BuildTaskServiceUnitTest.php   | 70 +++++++++++++++----
 1 file changed, 56 insertions(+), 14 deletions(-)

diff --git a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
index bcf14ff42a2..df6293de9ea 100644
--- a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Kernel\Filesystem;
+use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateBuildManifest;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap as FrameworkGenerateSitemap;
@@ -50,49 +51,75 @@ public function testConstruct()
 
     public function testGetTasks()
     {
-        $this->assertSame([], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testGetTasksWithTaskRegisteredInConfig()
     {
-        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [TestBuildTask::class]]));
-        $this->assertSame([TestBuildTask::class], $this->createService()->getRegisteredTasks());
+        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ]]));
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ], $this->createService()->getRegisteredTasks());
     }
 
     public function testRegisterTask()
     {
         $this->service->registerTask(TestBuildTask::class);
-        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterPreBuildTask()
     {
         $this->service->registerTask(TestPreBuildTask::class);
-        $this->assertSame([TestPreBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestPreBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterPostBuildTask()
     {
         $this->service->registerTask(TestPostBuildTask::class);
-        $this->assertSame([TestPostBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestPostBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedTask()
     {
         $this->service->registerTask(new TestBuildTask());
-        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedPreBuildTask()
     {
         $this->service->registerTask(new TestPreBuildTask());
-        $this->assertSame([TestPreBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestPreBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedPostBuildTask()
     {
         $this->service->registerTask(new TestPostBuildTask());
-        $this->assertSame([TestPostBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestPostBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterTaskWithInvalidClassTypeThrowsException()
@@ -118,22 +145,34 @@ public function testRegisterTaskWithAlreadyRegisteredTask()
         $this->service->registerTask(TestBuildTask::class);
         $this->service->registerTask(TestBuildTask::class);
 
-        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterTaskWithTaskAlreadyRegisteredInConfig()
     {
-        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [TestBuildTask::class]]));
+        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ]]));
         $this->createService();
 
         $this->service->registerTask(TestBuildTask::class);
-        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            TestBuildTask::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testCanRegisterFrameworkTasks()
     {
         $this->service->registerTask(FrameworkGenerateSitemap::class);
-        $this->assertSame([FrameworkGenerateSitemap::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            FrameworkGenerateSitemap::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testCanOverloadFrameworkTasks()
@@ -141,7 +180,10 @@ public function testCanOverloadFrameworkTasks()
         $this->service->registerTask(FrameworkGenerateSitemap::class);
         $this->service->registerTask(GenerateSitemap::class);
 
-        $this->assertSame([GenerateSitemap::class], $this->service->getRegisteredTasks());
+        $this->assertSame([
+            TransferMediaAssets::class,
+            GenerateSitemap::class
+        ], $this->service->getRegisteredTasks());
     }
 
     public function testSetOutputWithNull()

From ee94ef80e6ee2d0c5b0d047353dd3c28c664c76a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:41:20 +0100
Subject: [PATCH 0076/4023] Add "hidden" config option to disable the media
 asset transfer

Let's us skip it in tests
---
 .../framework/src/Framework/Services/BuildTaskService.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Services/BuildTaskService.php b/packages/framework/src/Framework/Services/BuildTaskService.php
index c65452ef09d..78176329d89 100644
--- a/packages/framework/src/Framework/Services/BuildTaskService.php
+++ b/packages/framework/src/Framework/Services/BuildTaskService.php
@@ -133,7 +133,7 @@ protected function makeTaskIdentifier(BuildTask $class): string
     private function registerFrameworkTasks(): void
     {
         $this->registerIf(CleanSiteDirectory::class, $this->canCleanSiteDirectory());
-        $this->registerTask(TransferMediaAssets::class);
+        $this->registerIf(TransferMediaAssets::class, $this->canTransferMediaAssets());
         $this->registerIf(GenerateBuildManifest::class, $this->canGenerateManifest());
         $this->registerIf(GenerateSitemap::class, $this->canGenerateSitemap());
         $this->registerIf(GenerateRssFeed::class, $this->canGenerateFeed());
@@ -144,6 +144,11 @@ private function canCleanSiteDirectory(): bool
         return Config::getBool('hyde.empty_output_directory', true);
     }
 
+    private function canTransferMediaAssets(): bool
+    {
+        return Config::getBool('hyde.transfer_media_assets', true);
+    }
+
     private function canGenerateManifest(): bool
     {
         return Config::getBool('hyde.generate_build_manifest', true);

From 5e8d7987c823b246a64215afff70f4c6ff2c627b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:41:26 +0100
Subject: [PATCH 0077/4023] Revert "Update unit test to expect media transfer
 action"

This reverts commit fc4146de37d08b6958fafa86fd8ea27310cc3b37.
---
 .../tests/Unit/BuildTaskServiceUnitTest.php   | 70 ++++---------------
 1 file changed, 14 insertions(+), 56 deletions(-)

diff --git a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
index df6293de9ea..bcf14ff42a2 100644
--- a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
@@ -6,7 +6,6 @@
 
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Kernel\Filesystem;
-use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateBuildManifest;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateRssFeed;
 use Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap as FrameworkGenerateSitemap;
@@ -51,75 +50,49 @@ public function testConstruct()
 
     public function testGetTasks()
     {
-        $this->assertSame([
-            TransferMediaAssets::class,
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([], $this->service->getRegisteredTasks());
     }
 
     public function testGetTasksWithTaskRegisteredInConfig()
     {
-        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ]]));
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ], $this->createService()->getRegisteredTasks());
+        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [TestBuildTask::class]]));
+        $this->assertSame([TestBuildTask::class], $this->createService()->getRegisteredTasks());
     }
 
     public function testRegisterTask()
     {
         $this->service->registerTask(TestBuildTask::class);
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterPreBuildTask()
     {
         $this->service->registerTask(TestPreBuildTask::class);
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestPreBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestPreBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterPostBuildTask()
     {
         $this->service->registerTask(TestPostBuildTask::class);
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestPostBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestPostBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedTask()
     {
         $this->service->registerTask(new TestBuildTask());
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedPreBuildTask()
     {
         $this->service->registerTask(new TestPreBuildTask());
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestPreBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestPreBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterInstantiatedPostBuildTask()
     {
         $this->service->registerTask(new TestPostBuildTask());
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestPostBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestPostBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterTaskWithInvalidClassTypeThrowsException()
@@ -145,34 +118,22 @@ public function testRegisterTaskWithAlreadyRegisteredTask()
         $this->service->registerTask(TestBuildTask::class);
         $this->service->registerTask(TestBuildTask::class);
 
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testRegisterTaskWithTaskAlreadyRegisteredInConfig()
     {
-        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ]]));
+        self::mockConfig(array_merge(config()->all(), ['hyde.build_tasks' => [TestBuildTask::class]]));
         $this->createService();
 
         $this->service->registerTask(TestBuildTask::class);
-        $this->assertSame([
-            TransferMediaAssets::class,
-            TestBuildTask::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([TestBuildTask::class], $this->service->getRegisteredTasks());
     }
 
     public function testCanRegisterFrameworkTasks()
     {
         $this->service->registerTask(FrameworkGenerateSitemap::class);
-        $this->assertSame([
-            TransferMediaAssets::class,
-            FrameworkGenerateSitemap::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([FrameworkGenerateSitemap::class], $this->service->getRegisteredTasks());
     }
 
     public function testCanOverloadFrameworkTasks()
@@ -180,10 +141,7 @@ public function testCanOverloadFrameworkTasks()
         $this->service->registerTask(FrameworkGenerateSitemap::class);
         $this->service->registerTask(GenerateSitemap::class);
 
-        $this->assertSame([
-            TransferMediaAssets::class,
-            GenerateSitemap::class
-        ], $this->service->getRegisteredTasks());
+        $this->assertSame([GenerateSitemap::class], $this->service->getRegisteredTasks());
     }
 
     public function testSetOutputWithNull()

From fd9b173ab366a7c96c70153b7f0559eda7e748d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:42:00 +0100
Subject: [PATCH 0078/4023] Don't transfer media assets for unit test

---
 packages/framework/tests/Unit/BuildTaskServiceUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
index bcf14ff42a2..aea5acbc22b 100644
--- a/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskServiceUnitTest.php
@@ -39,6 +39,7 @@ protected function setUp(): void
         self::mockConfig(['hyde' => [
             'empty_output_directory' => false,
             'generate_build_manifest' => false,
+            'transfer_media_assets' => false,
         ]]);
         $this->createService();
     }

From 3fca01781a29d1977e27c9b0d03d1eb2c3f1b467 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 12:57:53 +0100
Subject: [PATCH 0079/4023] Remove method `BuildService::transferMediaAssets()`

Deprecated in https://github.com/hydephp/develop/pull/1533
---
 packages/framework/src/Console/Commands/BuildSiteCommand.php | 2 --
 packages/framework/src/Framework/Services/BuildService.php   | 5 -----
 2 files changed, 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index 263ca07c495..cfa73df8a74 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -50,8 +50,6 @@ public function handle(): int
 
         $this->runPreBuildActions();
 
-        $this->service->transferMediaAssets();
-
         $this->service->compileStaticPages();
 
         $this->runPostBuildActions();
diff --git a/packages/framework/src/Framework/Services/BuildService.php b/packages/framework/src/Framework/Services/BuildService.php
index 55a59ef4937..e275ed2dd39 100644
--- a/packages/framework/src/Framework/Services/BuildService.php
+++ b/packages/framework/src/Framework/Services/BuildService.php
@@ -44,11 +44,6 @@ public function compileStaticPages(): void
         });
     }
 
-    public function transferMediaAssets(): void
-    {
-        //
-    }
-
     /**
      * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
      */

From cd0365ea98e554513a4061e28ab89c04dd52eeed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 13:05:27 +0100
Subject: [PATCH 0080/4023] Formatting

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1c266190574..6bd754eadc7 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -53,7 +53,7 @@ For more information, see https://github.com/hydephp/develop/pull/1498.
 - If your site has a custom documentation search page, for example `_docs/search.md` or `_pages/docs/search.blade.php`,
   that page will no longer be built when using the specific `build:search` command. It will, of course, 
   be built using the standard `build` command. https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
-- 
+ 
 - In the highly unlikely event your site customizes any of the search pages by replacing them in the kernel route collection,
   you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
   https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced

From 301f1035c4be358456795038e40dde89bc7b9c16 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 13:15:08 +0100
Subject: [PATCH 0081/4023] Improve upgrade guide

---
 RELEASE_NOTES.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 6bd754eadc7..f043bf70b30 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -29,9 +29,17 @@ This serves two purposes:
 
 ### Upgrade Guide
 
-If there are any breaking changes, include an upgrade guide here.
+Please see the "Breaking changes & upgrade guide" section below for more information.
 
-#### Documentation search page changes
+## Breaking changes & upgrade guide
+
+<!-- Editors note: The following will be part of the documentation and not the changelog, which is why the heading levels are reset. -->
+
+Please read through this section to ensure your site upgrades smoothly.
+
+## General impact
+
+### Documentation search page changes
 
 The documentation search page and search index have been changed to be generated as `InMemoryPages` instead of a post-build task.
 
@@ -42,9 +50,12 @@ want to adapt your code to interact with the new `InMemoryPage`, which is genera
 
 For more information, see https://github.com/hydephp/develop/pull/1498.
 
-### Breaking changes
+## Low impact
+
+### New documentation search implementation
 
-#### Low impact
+As the new documentation search implementation brings changes to their code API you may need to adapt your code
+according to the information below in case you wrote custom code that interacted with these parts of the codebase.
 
 - The `GenerateSearch` post-build task has been removed. If you have previously extended or customized this class, 
   you will need to adapt your code, as the search index files are now handled implicitly during the standard build process,

From a5d47507b7147c44f5f623de9d84f8734ea45834 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 13:56:45 +0100
Subject: [PATCH 0082/4023] Update test to use new build task

---
 .../Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index d02b3851b63..5dfec04d50f 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -9,6 +9,7 @@
 use Hyde\Framework\Services\BuildService;
 use Illuminate\Console\OutputStyle;
 use Mockery;
+use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
 use Symfony\Component\Console\Formatter\OutputFormatterInterface;
 use Symfony\Component\Console\Helper\ProgressBar;
 
@@ -92,7 +93,7 @@ public function test_relative_links_across_pages_retains_integrity()
             'write' => null,
         ]));
 
-        $service->transferMediaAssets();
+        (new TransferMediaAssets())->run();
         $service->compileStaticPages();
 
         $this->assertSee('root', [

From 27ef8fbcb6d33ae98c3f3bd9e7cbe0bd953724ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 14:03:49 +0100
Subject: [PATCH 0083/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index f043bf70b30..c6a42fe904d 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,16 +10,18 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
-- for new features.
+- Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
+- Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 
 ### Deprecated
 - for soon-to-be removed features.
 
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
+- Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 
 ### Fixed
 - for any bug fixes.
@@ -68,3 +70,17 @@ according to the information below in case you wrote custom code that interacted
 - In the highly unlikely event your site customizes any of the search pages by replacing them in the kernel route collection,
   you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
   https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
+
+### Media asset transfers
+
+The internals of how media asset files are copied during the build process have been changed. For most users, this change
+has no impact. However, if you have previously extended this method, or called it directly from your custom code,
+you will need to adapt your code to use the new `TransferMediaAssets` build task.
+
+For example, if you triggered the media transfer with a build service method call, use the new build task instead:
+
+```php
+(new BuildService)->transferMediaAssets();
+
+(new TransferMediaAssets())->run();
+```

From 7e2d3d5c979f10f865639df46e5790ce72c6d19f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 14:04:05 +0100
Subject: [PATCH 0084/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c6a42fe904d..42b678e6888 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -71,7 +71,7 @@ according to the information below in case you wrote custom code that interacted
   you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
   https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
 
-### Media asset transfers
+### Media asset transfer implementation changes
 
 The internals of how media asset files are copied during the build process have been changed. For most users, this change
 has no impact. However, if you have previously extended this method, or called it directly from your custom code,

From 91829ea601a9e0ce550327da8321c842b0e5aec4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:11:49 +0100
Subject: [PATCH 0085/4023] Only render semantic documentation article markup
 when truthy

---
 .../docs/documentation-article.blade.php      | 22 ++++++++++---------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/documentation-article.blade.php b/packages/framework/resources/views/components/docs/documentation-article.blade.php
index 328f370982d..56c71641771 100644
--- a/packages/framework/resources/views/components/docs/documentation-article.blade.php
+++ b/packages/framework/resources/views/components/docs/documentation-article.blade.php
@@ -5,16 +5,18 @@
 <article id="document" itemscope itemtype="https://schema.org/Article" @class([
         'mx-auto lg:ml-8 max-w-3xl p-12 md:px-16 max-w-[1000px] min-h-[calc(100vh_-_4rem)]',
         config('markdown.prose_classes', 'prose dark:prose-invert'),
-        'torchlight-enabled' => $article->hasTorchlight()])>
+        'torchlight-enabled' => $article && $article->hasTorchlight()])>
     @yield('content')
 
-    <header id="document-header" class="flex items-center flex-wrap justify-between prose-h1:mb-3">
-        {{ $article->renderHeader() }}
-    </header>
-    <section id="document-main-content" itemprop="articleBody">
-        {{ $article->renderBody() }}
-    </section>
-    <footer id="document-footer" class="flex items-center flex-wrap mt-8 prose-p:my-3 justify-between text-[90%]">
-        {{ $article->renderFooter() }}
-    </footer>
+    @if ($article)
+        <header id="document-header" class="flex items-center flex-wrap justify-between prose-h1:mb-3">
+            {{ $article->renderHeader() }}
+        </header>
+        <section id="document-main-content" itemprop="articleBody">
+            {{ $article->renderBody() }}
+        </section>
+        <footer id="document-footer" class="flex items-center flex-wrap mt-8 prose-p:my-3 justify-between text-[90%]">
+            {{ $article->renderFooter() }}
+        </footer>
+    @endif
 </article>
\ No newline at end of file

From e1f010c129bf75f97d22754dbb124e138c5e7f37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:12:14 +0100
Subject: [PATCH 0086/4023] Update documentation search page to set article to
 false

---
 .../Features/Documentation/DocumentationSearchPage.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 7db4a83ca97..e31ae29d1a1 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -39,7 +39,7 @@ public function __construct()
         parent::__construct(static::routeKey(), [
             'title' => 'Search',
             'navigation' => ['hidden' => true],
-            'article' => $this->makeArticle(),
+            'article' => false,
         ], view: 'hyde::pages.documentation-search');
     }
 

From 7df529e085a02bce6b1425e3a5dc9c98c60177e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:12:24 +0100
Subject: [PATCH 0087/4023] Remove now unused internal experimental method

---
 .../Features/Documentation/DocumentationSearchPage.php      | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index e31ae29d1a1..61f4b2e8930 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -59,10 +59,4 @@ protected static function anotherSearchPageExists(): bool
         // we need to check the page collection directly, instead of the route collection.
         return Hyde::pages()->first(fn (HydePage $file): bool => $file->getRouteKey() === static::routeKey()) !== null;
     }
-
-    /** @experimental Fixes type issue {@see https://github.com/hydephp/develop/commit/37f7046251b8c0514b8d8ef821de4ef3d35bbac8#commitcomment-135026537} */
-    protected function makeArticle(): SemanticDocumentationArticle
-    {
-        return SemanticDocumentationArticle::make(new DocumentationPage());
-    }
 }

From 9febd5dd0a12bf4b62873d36c0a16431711e0d76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:20:19 +0100
Subject: [PATCH 0088/4023] Update search page test to test the rendered HTML

---
 .../Feature/DocumentationSearchPageTest.php   | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index e7a2adc4dc3..2a237064dbc 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -76,4 +76,34 @@ public function testStaticRouteKeyHelperWithRootOutputDirectory()
         DocumentationPage::setOutputDirectory('');
         $this->assertSame('search', DocumentationSearchPage::routeKey());
     }
+
+    public function testCanRenderSearchPage()
+    {
+        $page = new DocumentationSearchPage();
+
+        Hyde::shareViewData($page);
+        $this->assertStringContainsString('<h1>Search the documentation site</h1>', $page->compile());
+    }
+
+    public function testRenderedSearchPageUsesDocumentationPageLayout()
+    {
+        $page = new DocumentationSearchPage();
+
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $this->assertStringContainsString('<body id="hyde-docs"', $html);
+    }
+
+    public function testRenderedSearchPageDoesNotUseSemanticDocumentationMarkup()
+    {
+        $page = new DocumentationSearchPage();
+
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $this->assertStringNotContainsString('<header id="document-header"', $html);
+        $this->assertStringNotContainsString('<section id="document-main-content"', $html);
+        $this->assertStringNotContainsString('<footer id="document-footer"', $html);
+    }
 }

From 886c9c6a9ecb752acd90d1b5d6dadced985f0a36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:20:21 +0100
Subject: [PATCH 0089/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 42b678e6888..99512f0f661 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -15,6 +15,7 @@ This serves two purposes:
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
+- Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
 
 ### Deprecated
 - for soon-to-be removed features.

From 193feff11a863ceed686e66b6a5e2ae74e845159 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:49:25 +0100
Subject: [PATCH 0090/4023] Create NavigationMenus.php

---
 .../Framework/Features/Navigation/NavigationMenus.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationMenus.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
new file mode 100644
index 00000000000..851e36bc5d6
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationMenus
+{
+    //
+}

From f7f96bada621e6ded9a64f3ca5c789f70d50b58c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:50:35 +0100
Subject: [PATCH 0091/4023] Create NavigationMenusTest.php

---
 .../tests/Feature/NavigationMenusTest.php         | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Feature/NavigationMenusTest.php

diff --git a/packages/framework/tests/Feature/NavigationMenusTest.php b/packages/framework/tests/Feature/NavigationMenusTest.php
new file mode 100644
index 00000000000..7ccd5d5973f
--- /dev/null
+++ b/packages/framework/tests/Feature/NavigationMenusTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenus
+ */
+class NavigationMenusTest extends TestCase
+{
+    //
+}

From 018aaa138fcb26c2a3e9b8c24375485186a6b1ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:49:44 +0100
Subject: [PATCH 0092/4023] Add PHPDoc

---
 .../src/Framework/Features/Navigation/NavigationMenus.php      | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
index 851e36bc5d6..a04ccafb587 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * Interact with the navigation menus for the project.
+ */
 class NavigationMenus
 {
     //

From 92f01418fb8cc3485cd302dfe46932414975a259 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 15:57:17 +0100
Subject: [PATCH 0093/4023] Remove unused internal generate method

---
 RELEASE_NOTES.md                                      |  1 +
 .../Documentation/DocumentationSearchPage.php         | 11 -----------
 2 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 99512f0f661..2cc8b136fc6 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -23,6 +23,7 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
+- Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed
 - for any bug fixes.
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 61f4b2e8930..21c440102e3 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -9,7 +9,6 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Support\Models\RouteKey;
-use Hyde\Framework\Actions\StaticPageBuilder;
 use Hyde\Facades\Config;
 
 /**
@@ -21,16 +20,6 @@
  */
 class DocumentationSearchPage extends InMemoryPage
 {
-    /**
-     * Generate the search page and save it to disk.
-     *
-     * @return string The path to the generated file.
-     */
-    public static function generate(): string
-    {
-        return StaticPageBuilder::handle(new static());
-    }
-
     /**
      * Create a new DocumentationSearchPage instance.
      */

From bd638057ab21f2b73f971ccf8eec6a91054d5213 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 16:00:58 +0100
Subject: [PATCH 0094/4023] Add menus array to the new navigation menus class

---
 .../src/Framework/Features/Navigation/NavigationMenus.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
index a04ccafb587..53b36fceff1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
@@ -9,5 +9,10 @@
  */
 class NavigationMenus
 {
-    //
+    /**
+     * The menus that are available for the project, keyed by their name identifier.
+     *
+     * @var array<string, \Hyde\Framework\Features\Navigation\BaseNavigationMenu>
+     */
+    protected array $menus = [];
 }

From 6a318c3a6f0a8dfb5c9e8e28cc813477b37d9cf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 16:03:11 +0100
Subject: [PATCH 0095/4023] Sketch out base contract

---
 .../Features/Navigation/NavigationMenus.php      | 16 ++++++++++++++++
 .../tests/Feature/NavigationMenusTest.php        | 10 +++++++++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
index 53b36fceff1..31ffdb366d4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
@@ -15,4 +15,20 @@ class NavigationMenus
      * @var array<string, \Hyde\Framework\Features\Navigation\BaseNavigationMenu>
      */
     protected array $menus = [];
+
+    /**
+     * Register a new menu for the project.
+     */
+    public function registerMenu(string $name, BaseNavigationMenu $menu): void
+    {
+        $this->menus[$name] = $menu;
+    }
+
+    /**
+     * Get a menu by its name.
+     */
+    public function getMenu(string $name): BaseNavigationMenu
+    {
+        return $this->menus[$name];
+    }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenusTest.php b/packages/framework/tests/Feature/NavigationMenusTest.php
index 7ccd5d5973f..90612248389 100644
--- a/packages/framework/tests/Feature/NavigationMenusTest.php
+++ b/packages/framework/tests/Feature/NavigationMenusTest.php
@@ -11,5 +11,13 @@
  */
 class NavigationMenusTest extends TestCase
 {
-    //
+    public function testRegisterMenu()
+    {
+        // Todo
+    }
+
+    public function testGetMenu()
+    {
+        // Todo
+    }
 }

From 068df5fe966c231c4a5fc47da3884e71cc30ca6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 17:04:53 +0100
Subject: [PATCH 0096/4023] Rename class to NavigationManager

---
 .../Navigation/{NavigationMenus.php => NavigationManager.php} | 2 +-
 .../{NavigationMenusTest.php => NavigationManagerTest.php}    | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{NavigationMenus.php => NavigationManager.php} (96%)
 rename packages/framework/tests/Feature/{NavigationMenusTest.php => NavigationManagerTest.php} (69%)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
similarity index 96%
rename from packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
rename to packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 31ffdb366d4..45485f32043 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenus.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -7,7 +7,7 @@
 /**
  * Interact with the navigation menus for the project.
  */
-class NavigationMenus
+class NavigationManager
 {
     /**
      * The menus that are available for the project, keyed by their name identifier.
diff --git a/packages/framework/tests/Feature/NavigationMenusTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
similarity index 69%
rename from packages/framework/tests/Feature/NavigationMenusTest.php
rename to packages/framework/tests/Feature/NavigationManagerTest.php
index 90612248389..09baf01df1e 100644
--- a/packages/framework/tests/Feature/NavigationMenusTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -7,9 +7,9 @@
 use Hyde\Testing\TestCase;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenus
+ * @covers \Hyde\Framework\Features\Navigation\NavigationManager
  */
-class NavigationMenusTest extends TestCase
+class NavigationManagerTest extends TestCase
 {
     public function testRegisterMenu()
     {

From 6064b5ddb468f832d000a497974682368fae2365 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 17:05:13 +0100
Subject: [PATCH 0097/4023] Update PHPDoc for renamed class

---
 .../src/Framework/Features/Navigation/NavigationManager.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 45485f32043..677a9264082 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -5,7 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 /**
- * Interact with the navigation menus for the project.
+ * Manages the navigation menus for the project.
  */
 class NavigationManager
 {

From 79b82d506b129add9c28b36c96df48c950b8a499 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 17:20:53 +0100
Subject: [PATCH 0098/4023] Copilot generate tests

---
 .../tests/Feature/NavigationManagerTest.php   | 38 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 09baf01df1e..9380eefd8f1 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Framework\Features\Navigation\NavigationManager;
+use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -11,13 +13,45 @@
  */
 class NavigationManagerTest extends TestCase
 {
+    protected NavigationManager $navigationManager;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->navigationManager = new NavigationManager();
+    }
+
+    /** @author Copilot */
     public function testRegisterMenu()
     {
-        // Todo
+        $menu = $this->createMock(BaseNavigationMenu::class);
+        $this->navigationManager->registerMenu('test', $menu);
+
+        $reflection = new \ReflectionClass($this->navigationManager);
+        $property = $reflection->getProperty('menus');
+        $property->setAccessible(true);
+
+        $menus = $property->getValue($this->navigationManager);
+
+        $this->assertArrayHasKey('test', $menus);
+        $this->assertSame($menu, $menus['test']);
     }
 
+    /** @author Copilot */
     public function testGetMenu()
     {
-        // Todo
+        $menu = $this->createMock(BaseNavigationMenu::class);
+        $this->navigationManager->registerMenu('test', $menu);
+
+        $retrievedMenu = $this->navigationManager->getMenu('test');
+
+        $this->assertSame($menu, $retrievedMenu);
+    }
+
+    /** @author Copilot */
+    public function testGetMenuThrowsExceptionForNonExistentMenu()
+    {
+        $this->expectException(\Exception::class);
+        $this->navigationManager->getMenu('nonexistent');
     }
 }

From ae9859911e984bd28b30301481457bddd7dcdb3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 17:25:16 +0100
Subject: [PATCH 0099/4023] Clean up generated test

---
 .../tests/Feature/NavigationManagerTest.php   | 36 ++++++++-----------
 1 file changed, 15 insertions(+), 21 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 9380eefd8f1..6b622349cb8 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -13,45 +13,39 @@
  */
 class NavigationManagerTest extends TestCase
 {
-    protected NavigationManager $navigationManager;
-
-    protected function setUp(): void
+    public function testCanRegisterMenu()
     {
-        parent::setUp();
-        $this->navigationManager = new NavigationManager();
-    }
+        $manager = new NavigationManager();
 
-    /** @author Copilot */
-    public function testRegisterMenu()
-    {
         $menu = $this->createMock(BaseNavigationMenu::class);
-        $this->navigationManager->registerMenu('test', $menu);
+        $manager->registerMenu('foo', $menu);
 
-        $reflection = new \ReflectionClass($this->navigationManager);
+        $reflection = new \ReflectionClass($manager);
         $property = $reflection->getProperty('menus');
-        $property->setAccessible(true);
 
-        $menus = $property->getValue($this->navigationManager);
+        $menus = $property->getValue($manager);
 
-        $this->assertArrayHasKey('test', $menus);
-        $this->assertSame($menu, $menus['test']);
+        $this->assertArrayHasKey('foo', $menus);
+        $this->assertSame($menu, $menus['foo']);
     }
 
-    /** @author Copilot */
-    public function testGetMenu()
+    public function testCanGetMenu()
     {
+        $manager = new NavigationManager();
+
         $menu = $this->createMock(BaseNavigationMenu::class);
-        $this->navigationManager->registerMenu('test', $menu);
+        $manager->registerMenu('foo', $menu);
 
-        $retrievedMenu = $this->navigationManager->getMenu('test');
+        $retrievedMenu = $manager->getMenu('foo');
 
         $this->assertSame($menu, $retrievedMenu);
     }
 
-    /** @author Copilot */
     public function testGetMenuThrowsExceptionForNonExistentMenu()
     {
+        $manager = new NavigationManager();
+
         $this->expectException(\Exception::class);
-        $this->navigationManager->getMenu('nonexistent');
+        $manager->getMenu('foo');
     }
 }

From 7edcb821aecdb44ca858320fc3383c131f9b073d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 18:42:22 +0100
Subject: [PATCH 0100/4023] Breaking: Rename class `NavigationMenu` to
 `MainNavigationMenu`

---
 docs/digging-deeper/navigation.md             |  4 +-
 .../views/layouts/navigation.blade.php        |  2 +-
 ...igationMenu.php => MainNavigationMenu.php} |  2 +-
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 ...enuTest.php => MainNavigationMenuTest.php} | 64 +++++++++----------
 packages/framework/tests/Unit/NavItemTest.php |  2 +-
 .../Unit/Views/NavigationBrandViewTest.php    |  4 +-
 7 files changed, 40 insertions(+), 40 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{NavigationMenu.php => MainNavigationMenu.php} (97%)
 rename packages/framework/tests/Feature/{NavigationMenuTest.php => MainNavigationMenuTest.php} (86%)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index a9d865d45df..10d3ba73c90 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -296,11 +296,11 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 While not required to know, you may find it interesting to learn more about how the navigation is handled internally.
 The best way to learn about this is to look at the source code, so here is a high-level overview with details on where to look in the source code.
 
-The main navigation menu is the `NavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class.
+The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class.
 Both extend the same `BaseNavigationMenu` class:
 
 ```php
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
 ```
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 17707d5e10a..3324c3a79f2 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,5 @@
 @php
-    $navigation = \Hyde\Framework\Features\Navigation\NavigationMenu::create();
+    $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
similarity index 97%
rename from packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
rename to packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index bcc844dca75..084cc2e19cd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -9,7 +9,7 @@
 use Hyde\Pages\DocumentationPage;
 use BadMethodCallException;
 
-class NavigationMenu extends BaseNavigationMenu
+class MainNavigationMenu extends BaseNavigationMenu
 {
     protected function generate(): void
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7a57b554282..d3b39db3dca 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -11,7 +11,7 @@
 use Stringable;
 
 /**
- * Abstraction for a navigation menu item. Used by the NavigationMenu and DocumentationSidebar classes.
+ * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/MainNavigationMenuTest.php
similarity index 86%
rename from packages/framework/tests/Feature/NavigationMenuTest.php
rename to packages/framework/tests/Feature/MainNavigationMenuTest.php
index a6c2a18501b..c7bb9bd1826 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/MainNavigationMenuTest.php
@@ -12,7 +12,7 @@
 
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\MarkdownPage;
@@ -21,24 +21,24 @@
 use Illuminate\Support\Collection;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
  */
-class NavigationMenuTest extends TestCase
+class MainNavigationMenuTest extends TestCase
 {
     public function testConstructor()
     {
-        $this->assertInstanceOf(NavigationMenu::class, NavigationMenu::create());
+        $this->assertInstanceOf(MainNavigationMenu::class, MainNavigationMenu::create());
     }
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
-        $this->assertInstanceOf(Collection::class, NavigationMenu::create()->items);
+        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->items);
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals(NavigationMenu::create()->items, NavigationMenu::create()->getItems());
+        $this->assertEquals(MainNavigationMenu::create()->items, MainNavigationMenu::create()->getItems());
     }
 
     public function testItemsAreSortedByPriority()
@@ -47,7 +47,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], NavigationMenu::create()->items->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->items->pluck('label')->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -55,7 +55,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], NavigationMenu::create()->items->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->items->pluck('label')->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -63,7 +63,7 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $this->file('_pages/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -79,7 +79,7 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
     {
         $this->file('_pages/foo.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -92,14 +92,14 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
 
     public function testCollectionOnlyContainsNavItems()
     {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, NavigationMenu::create()->items);
+        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->items);
     }
 
     public function testExternalLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -114,7 +114,7 @@ public function testPathLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -132,7 +132,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
             NavItem::forLink('foo', 'foo'),
         ]]);
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -150,7 +150,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
             NavItem::forLink('bar', 'foo'),
         ]]);
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -167,7 +167,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
 
         config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -183,7 +183,7 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $this->file('_docs/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -199,7 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->items);
@@ -212,7 +212,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute(Routes::get('foo/bar')),
@@ -228,7 +228,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             DropdownNavItem::fromArray('foo', [
@@ -243,7 +243,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $this->assertFalse($menu->hasDropdowns());
     }
 
@@ -251,20 +251,20 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $this->assertTrue($menu->hasDropdowns());
     }
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse(NavigationMenu::create()->hasDropdowns());
+        $this->assertFalse(MainNavigationMenu::create()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
     }
@@ -273,7 +273,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
@@ -288,7 +288,7 @@ public function testGetDropdownsWithMultipleItems()
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $this->assertCount(1, $menu->getDropdowns());
 
@@ -308,7 +308,7 @@ public function testGetDropdownsWithMultipleDropdowns()
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
         Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $this->assertCount(2, $menu->getDropdowns());
 
@@ -328,7 +328,7 @@ public function testGetDropdownsThrowsExceptionWhenDisabled()
         $this->expectException(BadMethodCallException::class);
         $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $menu->getDropdowns();
     }
 
@@ -338,7 +338,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
         Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
@@ -351,7 +351,7 @@ public function testBlogPostsDoNotGetAddedToDropdowns()
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());
         Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
     }
@@ -362,7 +362,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
 
         $this->assertCount(3, $menu->items);
         $this->assertEquals([
@@ -382,7 +382,7 @@ public function testDropdownMenuItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
 
-        $menu = NavigationMenu::create();
+        $menu = MainNavigationMenu::create();
         $dropdowns = $menu->getDropdowns();
 
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 379fbf581eb..6ab0458ee1b 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -17,7 +17,7 @@
 
 /**
  * This unit test covers the basics of the NavItem class.
- * For the full feature test, see the NavigationMenuTest class.
+ * For the full feature test, see the MainNavigationMenuTest class.
  *
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  *
diff --git a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
index 577295f5cf0..b34478273d6 100644
--- a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -22,7 +22,7 @@ protected function setUp(): void
     protected function render(): string
     {
         return view('hyde::components.navigation.navigation-brand', [
-            'navigation' => NavigationMenu::create(),
+            'navigation' => MainNavigationMenu::create(),
         ])->render();
     }
 

From 0873f53dc8e404984ae8c1ab7b476c2c2c9b6f8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 18:43:38 +0100
Subject: [PATCH 0101/4023] Create NavigationMenu.php

---
 .../Framework/Features/Navigation/NavigationMenu.php   | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
new file mode 100644
index 00000000000..418a992bd4f
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationMenu
+{
+    //
+}

From 64e14590e83c0a74fbc0a6cc76297dea44ce9b93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 18:45:21 +0100
Subject: [PATCH 0102/4023] Create NavigationMenuTest.php

---
 .../tests/Feature/NavigationMenuTest.php          | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Feature/NavigationMenuTest.php

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
new file mode 100644
index 00000000000..b75fa735190
--- /dev/null
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ */
+class NavigationMenuTest extends TestCase
+{
+    //
+}

From e658b6383eaf4535c17a9dd9fbe6973f9a9f453a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 18:47:47 +0100
Subject: [PATCH 0103/4023] Add protected items collection

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 418a992bd4f..2667031b7a6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,7 +4,10 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Collection;
+
 class NavigationMenu
 {
-    //
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    protected Collection $items;
 }

From 5f6458fcd05fb8eb344e22540d049cd8f3f20288 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:07:37 +0100
Subject: [PATCH 0104/4023] Deprecate class `BaseNavigationMenu`

---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index d802662c974..d8bf84ebfab 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -11,6 +11,7 @@
 
 use function collect;
 
+/** @deprecated Use the new NavigationMenu class instead */
 abstract class BaseNavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */

From ce71cab4e303ffea2714cf07a939a00c7f872def Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:07:18 +0100
Subject: [PATCH 0105/4023] Deprecate class `MainNavigationMenu`

---
 .../src/Framework/Features/Navigation/MainNavigationMenu.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 084cc2e19cd..db72a3569bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -9,6 +9,7 @@
 use Hyde\Pages\DocumentationPage;
 use BadMethodCallException;
 
+/** @deprecated Use the new NavigationMenu class instead */
 class MainNavigationMenu extends BaseNavigationMenu
 {
     protected function generate(): void

From a1ba9c2b85d25184c5f0a6a1a244029d39c95854 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:07:32 +0100
Subject: [PATCH 0106/4023] Deprecate class `DocumentationSidebar`

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 919b93434a6..ccfaacafbf9 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -15,6 +15,7 @@
 
 use function collect;
 
+/** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends BaseNavigationMenu
 {
     protected function generate(): void

From d3868f5931af9cd7cd6335a4c7b3359a31a3db3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:12:46 +0100
Subject: [PATCH 0107/4023] Scaffold new generation method

---
 .../Features/Navigation/NavigationManager.php         | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 677a9264082..359de3f2830 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -31,4 +31,15 @@ public function getMenu(string $name): BaseNavigationMenu
     {
         return $this->menus[$name];
     }
+
+    /**
+     * Temporary logic moved from MainNavigationMenu.php
+     *
+     * @internal
+     * @experimental
+     */
+    public static function generateMainMenu(): NavigationMenu
+    {
+        //
+    }
 }

From 32b6b8a15f95021a73f03cc1d76e45bdeec5250c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:12:49 +0100
Subject: [PATCH 0108/4023] Revert "Scaffold new generation method"

This reverts commit d3868f5931af9cd7cd6335a4c7b3359a31a3db3a.
---
 .../Features/Navigation/NavigationManager.php         | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 359de3f2830..677a9264082 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -31,15 +31,4 @@ public function getMenu(string $name): BaseNavigationMenu
     {
         return $this->menus[$name];
     }
-
-    /**
-     * Temporary logic moved from MainNavigationMenu.php
-     *
-     * @internal
-     * @experimental
-     */
-    public static function generateMainMenu(): NavigationMenu
-    {
-        //
-    }
 }

From fdf4f3ac00853374ebe9a2d3e270324c932fe232 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:15:37 +0100
Subject: [PATCH 0109/4023] Create NavigationServiceProvider.php

---
 .../Foundation/Providers/NavigationServiceProvider.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Foundation/Providers/NavigationServiceProvider.php

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
new file mode 100644
index 00000000000..40801e73cbb
--- /dev/null
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Foundation\Providers;
+
+class NavigationServiceProvider
+{
+    //
+}

From 765223e1c616808fc0c7aa067f39ba402960e4b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:17:46 +0100
Subject: [PATCH 0110/4023] Register NavigationServiceProvider

---
 app/config.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/config.php b/app/config.php
index 9af0e0cdf05..627c80c2d13 100644
--- a/app/config.php
+++ b/app/config.php
@@ -73,6 +73,7 @@
         Hyde\Foundation\Providers\ConfigurationServiceProvider::class,
         Hyde\Framework\HydeServiceProvider::class,
         Hyde\Foundation\Providers\ViewServiceProvider::class,
+        Hyde\Foundation\Providers\NavigationServiceProvider::class,
         Hyde\Console\ConsoleServiceProvider::class,
     ],
 

From f433a7d4a27471ebc9eb5414bb31923dcab0a0bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:17:50 +0100
Subject: [PATCH 0111/4023] Cover NavigationServiceProvider

---
 packages/framework/tests/Feature/HydeServiceProviderTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index e350de913c2..83e437c4acc 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -31,6 +31,7 @@
  * @covers \Hyde\Framework\HydeServiceProvider
  * @covers \Hyde\Framework\Concerns\RegistersFileLocations
  * @covers \Hyde\Foundation\Providers\ConfigurationServiceProvider
+ * @covers \Hyde\Foundation\Providers\NavigationServiceProvider
  * @covers \Hyde\Foundation\Providers\ViewServiceProvider
  */
 class HydeServiceProviderTest extends TestCase

From 233ecae531a3906c26d9ac31ee2a87f4928ac29e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:18:31 +0100
Subject: [PATCH 0112/4023] Extend ServiceProvider

---
 .../src/Foundation/Providers/NavigationServiceProvider.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 40801e73cbb..b6676237253 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Foundation\Providers;
 
-class NavigationServiceProvider
+use Illuminate\Support\ServiceProvider;
+
+class NavigationServiceProvider extends ServiceProvider
 {
     //
 }

From 786bdf68203340e588f6b6bcf4da3ed7e7930fa8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:21:01 +0100
Subject: [PATCH 0113/4023] Register NavigationManager as a singleton

---
 .../Foundation/Providers/NavigationServiceProvider.php   | 8 +++++++-
 .../framework/tests/Feature/HydeServiceProviderTest.php  | 9 +++++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index b6676237253..c23e3762da8 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -5,8 +5,14 @@
 namespace Hyde\Foundation\Providers;
 
 use Illuminate\Support\ServiceProvider;
+use Hyde\Framework\Features\Navigation\NavigationManager;
 
 class NavigationServiceProvider extends ServiceProvider
 {
-    //
+    public function register(): void
+    {
+        $this->app->singleton(NavigationManager::class, function ($app) {
+            return new NavigationManager();
+        });
+    }
 }
diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 83e437c4acc..69f5b525ccc 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Framework\Features\Navigation\NavigationManager;
+
 use function app;
 use function array_map;
 use function basename;
@@ -327,4 +329,11 @@ public function testOutputDirectoriesCanBeSetUsingKebabCaseClassNames()
         $this->assertEquals('foo', MarkdownPost::outputDirectory());
         $this->assertEquals('foo', DocumentationPage::outputDirectory());
     }
+
+    public function testNavigationManagerIsRegisteredAsSingleton()
+    {
+        $this->assertTrue($this->app->bound(NavigationManager::class));
+        $this->assertInstanceOf(NavigationManager::class, $this->app->make(NavigationManager::class));
+        $this->assertSame($this->app->make(NavigationManager::class), $this->app->make(NavigationManager::class));
+    }
 }

From 4089cb568093f118f3196b66eca03d7065aa95cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:23:37 +0100
Subject: [PATCH 0114/4023] Register navigation manager alias in container

---
 .../src/Foundation/Providers/NavigationServiceProvider.php | 2 ++
 .../framework/tests/Feature/HydeServiceProviderTest.php    | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index c23e3762da8..849317ef3d4 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -14,5 +14,7 @@ public function register(): void
         $this->app->singleton(NavigationManager::class, function ($app) {
             return new NavigationManager();
         });
+
+        $this->app->alias(NavigationManager::class, 'navigation');
     }
 }
diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 69f5b525ccc..6ad340537de 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -336,4 +336,11 @@ public function testNavigationManagerIsRegisteredAsSingleton()
         $this->assertInstanceOf(NavigationManager::class, $this->app->make(NavigationManager::class));
         $this->assertSame($this->app->make(NavigationManager::class), $this->app->make(NavigationManager::class));
     }
+
+    public function testProviderRegistersNavigationManagerAlias()
+    {
+        $this->assertTrue($this->app->bound('navigation'));
+        $this->assertInstanceOf(NavigationManager::class, $this->app->make('navigation'));
+        $this->assertSame($this->app->make(NavigationManager::class), $this->app->make('navigation'));
+    }
 }

From c511af840ad2de40255f2b5f2c6faf64c991fe70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:26:11 +0100
Subject: [PATCH 0115/4023] Remove unused parameter

---
 .../src/Foundation/Providers/NavigationServiceProvider.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 849317ef3d4..cd39be72fcc 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -11,7 +11,7 @@ class NavigationServiceProvider extends ServiceProvider
 {
     public function register(): void
     {
-        $this->app->singleton(NavigationManager::class, function ($app) {
+        $this->app->singleton(NavigationManager::class, function () {
             return new NavigationManager();
         });
 

From 6565a2e7e96e8ad7d263a6851c2e936d324f695c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 19:26:54 +0100
Subject: [PATCH 0116/4023] Type hint new menu class

---
 .../src/Framework/Features/Navigation/NavigationManager.php | 6 +++---
 packages/framework/tests/Feature/NavigationManagerTest.php  | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 677a9264082..3d65a8597f8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -12,14 +12,14 @@ class NavigationManager
     /**
      * The menus that are available for the project, keyed by their name identifier.
      *
-     * @var array<string, \Hyde\Framework\Features\Navigation\BaseNavigationMenu>
+     * @var array<string, \Hyde\Framework\Features\Navigation\NavigationMenu>
      */
     protected array $menus = [];
 
     /**
      * Register a new menu for the project.
      */
-    public function registerMenu(string $name, BaseNavigationMenu $menu): void
+    public function registerMenu(string $name, NavigationMenu $menu): void
     {
         $this->menus[$name] = $menu;
     }
@@ -27,7 +27,7 @@ public function registerMenu(string $name, BaseNavigationMenu $menu): void
     /**
      * Get a menu by its name.
      */
-    public function getMenu(string $name): BaseNavigationMenu
+    public function getMenu(string $name): NavigationMenu
     {
         return $this->menus[$name];
     }
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 6b622349cb8..97f2c1b83a9 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -5,7 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Framework\Features\Navigation\NavigationManager;
-use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -17,7 +17,7 @@ public function testCanRegisterMenu()
     {
         $manager = new NavigationManager();
 
-        $menu = $this->createMock(BaseNavigationMenu::class);
+        $menu = $this->createMock(NavigationMenu::class);
         $manager->registerMenu('foo', $menu);
 
         $reflection = new \ReflectionClass($manager);
@@ -33,7 +33,7 @@ public function testCanGetMenu()
     {
         $manager = new NavigationManager();
 
-        $menu = $this->createMock(BaseNavigationMenu::class);
+        $menu = $this->createMock(NavigationMenu::class);
         $manager->registerMenu('foo', $menu);
 
         $retrievedMenu = $manager->getMenu('foo');

From 9997235617aaae1c1a8e6b6542c1a8294a1deb81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:02:00 +0100
Subject: [PATCH 0117/4023] Add booted callback to register the navigation menu

---
 .../src/Foundation/Providers/NavigationServiceProvider.php  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index cd39be72fcc..55b59aa704d 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Foundation\Providers;
 
+use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 
 class NavigationServiceProvider extends ServiceProvider
@@ -16,5 +18,9 @@ public function register(): void
         });
 
         $this->app->alias(NavigationManager::class, 'navigation');
+
+        $this->app->make(HydeKernel::class)->booted(function (HydeKernel $kernel) {
+            $this->app->make(NavigationManager::class)->registerMenu('main', new NavigationMenu());
+        });
     }
 }

From f007eb6d140e47662e97ebbe75012bbf9d84cd78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:03:18 +0100
Subject: [PATCH 0118/4023] Remove unused parameter

---
 .../src/Foundation/Providers/NavigationServiceProvider.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 55b59aa704d..7eb3ada7949 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -19,7 +19,7 @@ public function register(): void
 
         $this->app->alias(NavigationManager::class, 'navigation');
 
-        $this->app->make(HydeKernel::class)->booted(function (HydeKernel $kernel) {
+        $this->app->make(HydeKernel::class)->booted(function () {
             $this->app->make(NavigationManager::class)->registerMenu('main', new NavigationMenu());
         });
     }

From 74e7901420cbbef24f407e515226bc411ab76889 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:04:32 +0100
Subject: [PATCH 0119/4023] Add navigation menu constructor

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 2667031b7a6..77386e24cee 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -10,4 +10,9 @@ class NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
+
+    public function __construct(Collection $items)
+    {
+        $this->items = $items;
+    }
 }

From ed6796411e3c39b0c0d837a4e4a0504ab533d8f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:06:35 +0100
Subject: [PATCH 0120/4023] Update constructor to support arrayables

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 77386e24cee..3bb7089c6fe 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -5,14 +5,15 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Illuminate\Support\Collection;
+use Illuminate\Contracts\Support\Arrayable;
 
 class NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    public function __construct(Collection $items)
+    public function __construct(Arrayable|array $items = [])
     {
-        $this->items = $items;
+        $this->items = new Collection($items);
     }
 }

From 7c0af951a78b6d7b5ad298258cf6f98931a3a046 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:07:30 +0100
Subject: [PATCH 0121/4023] Change return type to new menu class

Breaking: Change `BaseNavigationMenu::create()` return type to new NavigationMenu
---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index d8bf84ebfab..a69842b8af7 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -22,7 +22,7 @@ final protected function __construct()
         $this->items = new Collection();
     }
 
-    public static function create(): static
+    public static function create(): NavigationMenu
     {
         $menu = new static();
 
@@ -30,7 +30,7 @@ public static function create(): static
         $menu->sortByPriority();
         $menu->removeDuplicateItems();
 
-        return $menu;
+        return new NavigationMenu($menu->getItems());
     }
 
     protected function generate(): void

From 2683762b1a4d062efcde24e7596bd58caaca6c64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:08:04 +0100
Subject: [PATCH 0122/4023] Revert "Change return type to new menu class"

This reverts commit 7c0af951a78b6d7b5ad298258cf6f98931a3a046.
---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index a69842b8af7..d8bf84ebfab 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -22,7 +22,7 @@ final protected function __construct()
         $this->items = new Collection();
     }
 
-    public static function create(): NavigationMenu
+    public static function create(): static
     {
         $menu = new static();
 
@@ -30,7 +30,7 @@ public static function create(): NavigationMenu
         $menu->sortByPriority();
         $menu->removeDuplicateItems();
 
-        return new NavigationMenu($menu->getItems());
+        return $menu;
     }
 
     protected function generate(): void

From 30e11f0fd4b0d896c0deef86e0e32d7ed628531e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:08:41 +0100
Subject: [PATCH 0123/4023] Create GeneratesMainNavigationMenu.php

---
 .../Navigation/GeneratesMainNavigationMenu.php         | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
new file mode 100644
index 00000000000..0dea48b085f
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class GeneratesMainNavigationMenu
+{
+    //
+}

From cc05a1ec5d71bc9f3fe0167900729f583462784e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:09:11 +0100
Subject: [PATCH 0124/4023] Mark class as experimental

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php        | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0dea48b085f..99e50dce6d5 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * @experimental This class may change significantly before its release.
+ */
 class GeneratesMainNavigationMenu
 {
     //

From 72303ec98ab2b2598df7fd28d546885870f2f25d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:10:22 +0100
Subject: [PATCH 0125/4023] Sketch out contract

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 99e50dce6d5..81a888de847 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -9,5 +9,8 @@
  */
 class GeneratesMainNavigationMenu
 {
-    //
+    public function execute(): NavigationMenu
+    {
+        //
+    }
 }

From c8e1cff4b02519ca425174875e5eb53ef13fe0dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:11:00 +0100
Subject: [PATCH 0126/4023] Defer logic to new action

---
 .../src/Foundation/Providers/NavigationServiceProvider.php    | 4 ++--
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 7eb3ada7949..4dcbb297c99 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -6,8 +6,8 @@
 
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationManager;
+use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 class NavigationServiceProvider extends ServiceProvider
 {
@@ -20,7 +20,7 @@ public function register(): void
         $this->app->alias(NavigationManager::class, 'navigation');
 
         $this->app->make(HydeKernel::class)->booted(function () {
-            $this->app->make(NavigationManager::class)->registerMenu('main', new NavigationMenu());
+            $this->app->make(NavigationManager::class)->registerMenu('main', (new GeneratesMainNavigationMenu())->execute());
         });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 81a888de847..4523df0eba4 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,6 +11,6 @@ class GeneratesMainNavigationMenu
 {
     public function execute(): NavigationMenu
     {
-        //
+        return new NavigationMenu();
     }
 }

From 47df911f5d4ff41743acc7d8c317922ff6fc86a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:14:33 +0100
Subject: [PATCH 0127/4023] Use the legacy entrypoint to create menu in the new
 action

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 4523df0eba4..3c0d081c9bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,6 +11,8 @@ class GeneratesMainNavigationMenu
 {
     public function execute(): NavigationMenu
     {
-        return new NavigationMenu();
+        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
+
+        return new NavigationMenu($navigation->items);
     }
 }

From b617d88c3d9ef7a9c181e94f971bc5d0a19fd373 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:15:35 +0100
Subject: [PATCH 0128/4023] Add todo

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 3c0d081c9bb..1c0872a8b4e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,6 +6,8 @@
 
 /**
  * @experimental This class may change significantly before its release.
+ *
+ * @todo Refactor to move logic to the new action
  */
 class GeneratesMainNavigationMenu
 {

From a944a276c59a4e23b47e615267ea4c83d448f12b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:16:55 +0100
Subject: [PATCH 0129/4023] Refactor action entry point to be static

---
 .../src/Foundation/Providers/NavigationServiceProvider.php      | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 4dcbb297c99..edb8ee9bf13 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -20,7 +20,7 @@ public function register(): void
         $this->app->alias(NavigationManager::class, 'navigation');
 
         $this->app->make(HydeKernel::class)->booted(function () {
-            $this->app->make(NavigationManager::class)->registerMenu('main', (new GeneratesMainNavigationMenu())->execute());
+            $this->app->make(NavigationManager::class)->registerMenu('main', GeneratesMainNavigationMenu::handle());
         });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 1c0872a8b4e..c160f6d8723 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,7 +11,7 @@
  */
 class GeneratesMainNavigationMenu
 {
-    public function execute(): NavigationMenu
+    public static function handle(): NavigationMenu
     {
         $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
 

From f2ca7616e96b1ceec508040531c85f36bb75060f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:23:19 +0100
Subject: [PATCH 0130/4023] Ensure kernel is booted when trying to get a menu

---
 .../src/Framework/Features/Navigation/NavigationManager.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 3d65a8597f8..4a44371ddb6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
+
 /**
  * Manages the navigation menus for the project.
  */
@@ -29,6 +31,10 @@ public function registerMenu(string $name, NavigationMenu $menu): void
      */
     public function getMenu(string $name): NavigationMenu
     {
+        if (! Hyde::isBooted()) {
+            Hyde::boot();
+        }
+
         return $this->menus[$name];
     }
 }

From 23edc36bc280110e626a076ef84feb6b68683e16 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:23:24 +0100
Subject: [PATCH 0131/4023] Add todo

---
 .../src/Framework/Features/Navigation/NavigationManager.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 4a44371ddb6..7fc836be42c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -32,6 +32,7 @@ public function registerMenu(string $name, NavigationMenu $menu): void
     public function getMenu(string $name): NavigationMenu
     {
         if (! Hyde::isBooted()) {
+            // Todo: This could be an anti-pattern so we may consider throwing an exception instead.
             Hyde::boot();
         }
 

From e18fbf9d357e92e57e33e5f966c6d9b52fe32b9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:24:24 +0100
Subject: [PATCH 0132/4023] Add items getter

---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 3bb7089c6fe..4919ceb1bf1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -16,4 +16,10 @@ public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection($items);
     }
+
+    /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    public function getItems(): Collection
+    {
+        return $this->items;
+    }
 }

From 7a9aada2fe5fbc34ac4754e6fdce7b052021a34f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:24:54 +0100
Subject: [PATCH 0133/4023] Update navigation view to use accessor

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 3324c3a79f2..ef15fe3f127 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -33,7 +33,7 @@
     <div id="main-navigation-links" class="w-full x-uncloak-md md:flex flex-grow md:flex-grow-0 md:items-center md:w-auto px-6 -mx-4 border-t mt-3 pt-3 md:border-none md:mt-0 md:py-0 border-gray-200 dark:border-gray-700"
          :class="navigationOpen ? '' : 'hidden'" x-cloak>
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
-            @foreach ($navigation->items as $item)
+            @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item instanceof \Hyde\Framework\Features\Navigation\DropdownNavItem)
                         <x-hyde::navigation.dropdown :label="\Hyde\Hyde::makeTitle($item->label)" :items="$item->items"/>

From 94714ec0416c997a9a9713b64f14e30f8e8b695c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 20:27:47 +0100
Subject: [PATCH 0134/4023] Update navigation component to use new menu class

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index ef15fe3f127..ba8c148b583 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,5 @@
 @php
-    $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
+    $navigation = app('navigation')->getMenu('main');
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">

From 0c701d96da5121817360af943969565a54fd798b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:04:08 +0100
Subject: [PATCH 0135/4023] Add back temporary compatibility with old system

Routes must be deferred first
---
 .../framework/resources/views/layouts/navigation.blade.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index ba8c148b583..4831f46b9b2 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,6 @@
 @php
-    $navigation = app('navigation')->getMenu('main');
+    // $navigation = app('navigation')->getMenu('main');
+    $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">

From 2e30221f7d3bad7898ef713495a786eb23088a28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:05:45 +0100
Subject: [PATCH 0136/4023] Create ExternalRoute.php

---
 .../framework/src/Support/Models/ExternalRoute.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Support/Models/ExternalRoute.php

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
new file mode 100644
index 00000000000..62eccf78c8a
--- /dev/null
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Support\Models;
+
+class ExternalRoute
+{
+    //
+}

From b17f2a3f6a5497cc1d349d35cd5ee1ea6961d737 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:05:54 +0100
Subject: [PATCH 0137/4023] Class ExternalRoute extends Route

---
 packages/framework/src/Support/Models/ExternalRoute.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index 62eccf78c8a..9f7ffcc036b 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Support\Models;
 
-class ExternalRoute
+class ExternalRoute extends Route
 {
     //
 }

From c2ae06f71e445b8d6a689d0359cbae359134e44f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:06:08 +0100
Subject: [PATCH 0138/4023] Add class description

---
 packages/framework/src/Support/Models/ExternalRoute.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index 9f7ffcc036b..33364dc5fdf 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Support\Models;
 
+/**
+ * A route that leads to an external URI.
+ */
 class ExternalRoute extends Route
 {
     //

From de56a661ae7b149ca8effb1a58806e6ac35b8017 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:07:29 +0100
Subject: [PATCH 0139/4023] Add destination property

---
 packages/framework/src/Support/Models/ExternalRoute.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index 33364dc5fdf..bcc7fd2172f 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -9,5 +9,5 @@
  */
 class ExternalRoute extends Route
 {
-    //
+    protected string $destination;
 }

From e5550d24cc5ac3e5d1533649065cef4a4be8be0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:07:53 +0100
Subject: [PATCH 0140/4023] Construct destination

---
 packages/framework/src/Support/Models/ExternalRoute.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index bcc7fd2172f..b2f6769546f 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -10,4 +10,9 @@
 class ExternalRoute extends Route
 {
     protected string $destination;
+
+    public function __construct(string $destination)
+    {
+        $this->destination = $destination;
+    }
 }

From 26d1773cadee7a5d166d558ba64e3385d1ce19fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:08:06 +0100
Subject: [PATCH 0141/4023] Add noinspection annotation

---
 packages/framework/src/Support/Models/ExternalRoute.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index b2f6769546f..ba26ab629a9 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -11,6 +11,7 @@ class ExternalRoute extends Route
 {
     protected string $destination;
 
+    /** @noinspection PhpMissingParentConstructorInspection */
     public function __construct(string $destination)
     {
         $this->destination = $destination;

From 7c1a5635e98e96fd51837fb00b228e362b0ae6b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:08:45 +0100
Subject: [PATCH 0142/4023] Mark class as experimental

---
 packages/framework/src/Support/Models/ExternalRoute.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index ba26ab629a9..e3ed9d7d22c 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -6,6 +6,8 @@
 
 /**
  * A route that leads to an external URI.
+ *
+ * @experimental Take caution when using this class, as it may be subject to change.
  */
 class ExternalRoute extends Route
 {

From fdedbbd7c87e6e06cee0a9d4574264251d0838c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:09:00 +0100
Subject: [PATCH 0143/4023] Override link resolver

---
 packages/framework/src/Support/Models/ExternalRoute.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index e3ed9d7d22c..f6ad450b071 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -18,4 +18,9 @@ public function __construct(string $destination)
     {
         $this->destination = $destination;
     }
+
+    public function getLink(): string
+    {
+        return $this->destination;
+    }
 }

From d42a11b029f3a90f43f1525fc4c66ae375e28c81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:11:09 +0100
Subject: [PATCH 0144/4023] Turn NavItem links to ExternalRoutes when using
 forLink helper

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d3b39db3dca..f90cbc4a2bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -9,6 +9,7 @@
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
+use Hyde\Support\Models\ExternalRoute;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
@@ -54,7 +55,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
      */
     public static function forLink(string $href, string $label, int $priority = 500): static
     {
-        return new static($href, $label, $priority);
+        return new static(new ExternalRoute($href), $label, $priority);
     }
 
     /**

From f8dda2b779da89453033445284f07660bb8a7129 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:12:08 +0100
Subject: [PATCH 0145/4023] Cast string to external route upon NavItem
 construct

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index f90cbc4a2bb..69bdad9fc27 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -31,6 +31,10 @@ class NavItem implements Stringable
      */
     public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null)
     {
+        if (is_string($destination)) {
+            $destination = new ExternalRoute($destination);
+        }
+
         $this->destination = (string) $destination;
         $this->label = $label;
         $this->priority = $priority;

From a2b4131071c73a761345777be6b6e7863ada9e20 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:17:14 +0100
Subject: [PATCH 0146/4023] Revert "Turn NavItem links to ExternalRoutes when
 using forLink helper"

This reverts commit d42a11b029f3a90f43f1525fc4c66ae375e28c81.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 69bdad9fc27..5bff052b649 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -9,7 +9,6 @@
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
-use Hyde\Support\Models\ExternalRoute;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
@@ -59,7 +58,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
      */
     public static function forLink(string $href, string $label, int $priority = 500): static
     {
-        return new static(new ExternalRoute($href), $label, $priority);
+        return new static($href, $label, $priority);
     }
 
     /**

From ff85c3ab19d3699c8324867cb792be38bfb13a45 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:13:28 +0100
Subject: [PATCH 0147/4023] Breaking: `NavItem::$destination` is now a Route
 instead of string

This is necessary in order to defer route resolving to compile time
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5bff052b649..f7f9e34d917 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -20,7 +20,7 @@
  */
 class NavItem implements Stringable
 {
-    public readonly string $destination;
+    public readonly Route $destination;
     public readonly string $label;
     public readonly int $priority;
     public readonly ?string $group;
@@ -34,7 +34,7 @@ public function __construct(Route|string $destination, string $label, int $prior
             $destination = new ExternalRoute($destination);
         }
 
-        $this->destination = (string) $destination;
+        $this->destination = $destination;
         $this->label = $label;
         $this->priority = $priority;
         $this->group = $group;

From f21b91c532044a1761d09db40cec48463db7e393 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:18:53 +0100
Subject: [PATCH 0148/4023] Update NavItemTest.php

---
 packages/framework/tests/Unit/NavItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 6ab0458ee1b..17ccf81697a 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -43,7 +43,7 @@ public function testConstruct()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Test', 500);
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
     }
 
     public function testGetDestination()

From 9ae32df0525ab2ae16d52e76736e3a377ae1ac52 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:56:09 +0100
Subject: [PATCH 0149/4023] Add string cast to string resolver

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index f7f9e34d917..fdb1e963bd7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -79,7 +79,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public function __toString(): string
     {
-        return $this->destination;
+        return (string) $this->destination;
     }
 
     /**

From a1fcbe980aa2477a07564df7b63bb272155fd512 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:20:40 +0100
Subject: [PATCH 0150/4023] Import class

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index fdb1e963bd7..7af82b15ff5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -9,6 +9,7 @@
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
+use Hyde\Support\Models\ExternalRoute;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.

From 77a17155b5ebf83a70ae6b945137e0af47cec8fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:20:54 +0100
Subject: [PATCH 0151/4023] Getter now returns Route object

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7af82b15ff5..0ee3bd1a779 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -89,7 +89,7 @@ public function __toString(): string
      * If the navigation item is an external link, this will return the link as is,
      * if it's for a route, a resolved relative link will be returned.
      */
-    public function getDestination(): string
+    public function getDestination(): Route
     {
         return $this->destination;
     }

From 8f0d41a186c985efd139a38565b7392cc2a7ec9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:27:24 +0100
Subject: [PATCH 0152/4023] Split getDestination method into new getLink method

---
 .../src/Framework/Features/Navigation/NavItem.php | 15 ++++++++++-----
 packages/framework/tests/Unit/NavItemTest.php     | 10 +++++++++-
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0ee3bd1a779..a488911d1a0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -80,20 +80,25 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public function __toString(): string
     {
-        return (string) $this->destination;
+        return $this->getLink();
     }
 
     /**
-     * Get the destination link of the navigation item.
-     *
-     * If the navigation item is an external link, this will return the link as is,
-     * if it's for a route, a resolved relative link will be returned.
+     * Get the destination route of the navigation item.
      */
     public function getDestination(): Route
     {
         return $this->destination;
     }
 
+    /**
+     * Resolve the destination link of the navigation item.
+     */
+    public function getLink(): string
+    {
+        return (string) $this->destination;
+    }
+
     /**
      * Get the label of the navigation item.
      */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 17ccf81697a..230da11728e 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -47,9 +47,17 @@ public function testConstruct()
     }
 
     public function testGetDestination()
+    {
+        $route = new Route(new InMemoryPage('foo'));
+        $navItem = new NavItem($route, 'Page', 500);
+
+        $this->assertSame($route, $navItem->getDestination());
+    }
+
+    public function testGetLink()
     {
         $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('foo.html', $navItem->getDestination());
+        $this->assertSame('foo.html', $navItem->getLink());
     }
 
     public function testGetLabel()

From d653aac6863ca8cbdb39c3f648b32f7c985101fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:27:29 +0100
Subject: [PATCH 0153/4023] Update NavItemTest.php

---
 packages/framework/tests/Unit/NavItemTest.php | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 230da11728e..a9d4e227462 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Pages\InMemoryPage;
@@ -83,7 +84,7 @@ public function testFromRoute()
         $route = new Route(new MarkdownPage());
         $item = NavItem::fromRoute($route);
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route, $item->destination);
     }
 
     public function testToString()
@@ -97,7 +98,7 @@ public function testForLink()
     {
         $item = NavItem::forLink('foo', 'bar');
 
-        $this->assertSame('foo', $item->destination);
+        $this->assertEquals(new ExternalRoute('foo'), $item->destination);
         $this->assertSame('bar', $item->label);
         $this->assertSame(500, $item->priority);
     }
@@ -112,7 +113,7 @@ public function testForRoute()
         $route = Routes::get('404');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route->getLink(), $item->destination->getLink());
         $this->assertSame('foo', $item->label);
         $this->assertSame(999, $item->priority);
     }
@@ -122,7 +123,7 @@ public function testForIndexRoute()
         $route = Routes::get('index');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination);
+        $this->assertSame($route->getLink(), $item->destination->getLink());
         $this->assertSame('foo', $item->label);
         $this->assertSame(0, $item->priority);
     }

From 7fc22d9deea7747688469185525bd8d6100adf7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 8 Feb 2024 18:58:53 +0100
Subject: [PATCH 0154/4023] Compare current state as string

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a488911d1a0..75836e2e3ad 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -130,7 +130,7 @@ public function getGroup(): ?string
      */
     public function isCurrent(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->destination;
+        return Hyde::currentRoute()->getLink() === (string) $this->destination;
     }
 
     protected static function getRouteGroup(Route $route): ?string

From 1fb6ec0990a73fe6cebb6c3193c11bb832d3dcd5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:29:11 +0100
Subject: [PATCH 0155/4023] Remove early route resolving

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 2 +-
 packages/framework/tests/Unit/NavItemTest.php                 | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 75836e2e3ad..d5e09b898f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -47,7 +47,7 @@ public function __construct(Route|string $destination, string $label, int $prior
     public static function fromRoute(Route $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
         return new static(
-            $route->getLink(),
+            $route,
             $label ?? $route->getPage()->navigationMenuLabel(),
             $priority ?? $route->getPage()->navigationMenuPriority(),
             $group ?? static::getRouteGroup($route),
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index a9d4e227462..b7ccacf3622 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -113,7 +113,7 @@ public function testForRoute()
         $route = Routes::get('404');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination->getLink());
+        $this->assertSame($route, $item->destination);
         $this->assertSame('foo', $item->label);
         $this->assertSame(999, $item->priority);
     }
@@ -123,7 +123,7 @@ public function testForIndexRoute()
         $route = Routes::get('index');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route->getLink(), $item->destination->getLink());
+        $this->assertSame($route, $item->destination);
         $this->assertSame('foo', $item->label);
         $this->assertSame(0, $item->priority);
     }

From 66dc3ded958eea4f85354120c2f89c2adb0cf8bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:29:49 +0100
Subject: [PATCH 0156/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d5e09b898f3..971450c970f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -14,6 +14,8 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
+ * @FIXME Before merge: Add release notes from https://github.com/hydephp/develop/pull/1539
+ *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route

From 5ed58f4d20855ba6d7e27012f75edcb04f0c2f8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 21:58:07 +0100
Subject: [PATCH 0157/4023] Revert "Add todo"

This reverts commit 66dc3ded958eea4f85354120c2f89c2adb0cf8bf.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 971450c970f..d5e09b898f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -14,8 +14,6 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
- * @FIXME Before merge: Add release notes from https://github.com/hydephp/develop/pull/1539
- *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route

From a2945fb0e1d40c05886923d8be9ed9e784bade93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 22:03:02 +0100
Subject: [PATCH 0158/4023] Revert "Add back temporary compatibility with old
 system"

This reverts commit 0c701d96da5121817360af943969565a54fd798b.
---
 .../framework/resources/views/layouts/navigation.blade.php     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 4831f46b9b2..ba8c148b583 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,6 +1,5 @@
 @php
-    // $navigation = app('navigation')->getMenu('main');
-    $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
+    $navigation = app('navigation')->getMenu('main');
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">

From c133c82ca93a12b27954aff50a69970072edf6d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 22:12:43 +0100
Subject: [PATCH 0159/4023] Merge pull request #1539 from
 hydephp/update-navitem-class-to-support-deferring-route-resolves

Update NavItem class to support deferring route resolves
---
 RELEASE_NOTES.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2cc8b136fc6..c5fd968e74f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,11 +11,14 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
+- Added a new `NavItem::getLink()` method contain the previous `NavItem::getDestination()` logic, to return the link URL.
 
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
+- Breaking: The `NavItem` class now always stores the destination as a `Route` instance.
+- Breaking: The `NavItem::getDestination()` method now returns its `Route` instance.
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -56,6 +59,14 @@ For more information, see https://github.com/hydephp/develop/pull/1498.
 
 ## Low impact
 
+### Navigation item changes
+
+The `NavItem::getDestination()` method now returns its `Route` instance. This allows for deferring the route evaluation.
+
+If you have previously used this method directly and expected a string to be returned, you may need to adapt your code to handle the new return type.
+
+If you want to retain the previous state where a string is always returned, you can use the new `NavItem::getLink()` method instead, which will resolve the route immediately.
+
 ### New documentation search implementation
 
 As the new documentation search implementation brings changes to their code API you may need to adapt your code

From 88fd2e7bdb8f2a753626868e2b4e1af1c979054c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 13 Feb 2024 22:13:12 +0100
Subject: [PATCH 0160/4023] Add ExternalRoute class to release notes

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c5fd968e74f..3ff8919c416 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,6 +11,7 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
+- Added a new `ExternalRoute` class to represent external routes.
 - Added a new `NavItem::getLink()` method contain the previous `NavItem::getDestination()` logic, to return the link URL.
 
 ### Changed

From f9884c1d51654adcafe7bfd6eb774b84f7bed605 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 13:13:24 +0100
Subject: [PATCH 0161/4023] Split out temporary method for refactor

---
 .../Features/Navigation/BaseNavigationMenu.php       | 12 +++++++++++-
 .../Navigation/GeneratesMainNavigationMenu.php       |  2 +-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index d8bf84ebfab..4e83f7f1cc9 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -22,7 +22,8 @@ final protected function __construct()
         $this->items = new Collection();
     }
 
-    public static function create(): static
+    /** @deprecated Temporary method for refactor */
+    public static function __generate(): static
     {
         $menu = new static();
 
@@ -33,6 +34,15 @@ public static function create(): static
         return $menu;
     }
 
+    /** @deprecated Temporary method for refactor */
+    public static function create(): static
+    {
+        $menu = new static();
+        $menu->items = GeneratesMainNavigationMenu::handle()->getItems();
+
+        return $menu;
+    }
+
     protected function generate(): void
     {
         Routes::each(function (Route $route): void {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index c160f6d8723..3a776e61ade 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,7 +13,7 @@ class GeneratesMainNavigationMenu
 {
     public static function handle(): NavigationMenu
     {
-        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
+        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::__generate();
 
         return new NavigationMenu($navigation->items);
     }

From af7e0d9727ccdad45451cf2e8af8baeaf1962448 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 13:30:32 +0100
Subject: [PATCH 0162/4023] Revert "Split out temporary method for refactor"

This reverts commit f9884c1d51654adcafe7bfd6eb774b84f7bed605.
---
 .../Features/Navigation/BaseNavigationMenu.php       | 12 +-----------
 .../Navigation/GeneratesMainNavigationMenu.php       |  2 +-
 2 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index 4e83f7f1cc9..d8bf84ebfab 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -22,8 +22,7 @@ final protected function __construct()
         $this->items = new Collection();
     }
 
-    /** @deprecated Temporary method for refactor */
-    public static function __generate(): static
+    public static function create(): static
     {
         $menu = new static();
 
@@ -34,15 +33,6 @@ public static function __generate(): static
         return $menu;
     }
 
-    /** @deprecated Temporary method for refactor */
-    public static function create(): static
-    {
-        $menu = new static();
-        $menu->items = GeneratesMainNavigationMenu::handle()->getItems();
-
-        return $menu;
-    }
-
     protected function generate(): void
     {
         Routes::each(function (Route $route): void {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 3a776e61ade..c160f6d8723 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,7 +13,7 @@ class GeneratesMainNavigationMenu
 {
     public static function handle(): NavigationMenu
     {
-        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::__generate();
+        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
 
         return new NavigationMenu($navigation->items);
     }

From c61fbb43c163f1fde84e8703b3507c32f8d8766e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 13:31:16 +0100
Subject: [PATCH 0163/4023] Split out granular temporary method for refactor

---
 .../GeneratesMainNavigationMenu.php           |  2 +-
 .../Navigation/MainNavigationMenu.php         | 21 +++++++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index c160f6d8723..3a776e61ade 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,7 +13,7 @@ class GeneratesMainNavigationMenu
 {
     public static function handle(): NavigationMenu
     {
-        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::create();
+        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::__generate();
 
         return new NavigationMenu($navigation->items);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index db72a3569bb..f82a962ca5d 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -12,6 +12,27 @@
 /** @deprecated Use the new NavigationMenu class instead */
 class MainNavigationMenu extends BaseNavigationMenu
 {
+    /** @deprecated Temporary method for refactor */
+    public static function __generate(): static
+    {
+        $menu = new static();
+
+        $menu->generate();
+        $menu->sortByPriority();
+        $menu->removeDuplicateItems();
+
+        return $menu;
+    }
+
+    /** @deprecated Temporary method for refactor */
+    public static function create(): static
+    {
+        $menu = new static();
+        $menu->items = GeneratesMainNavigationMenu::handle()->getItems();
+
+        return $menu;
+    }
+
     protected function generate(): void
     {
         parent::generate();

From b40f5987eea67663991335e42f34a3f334abd4d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:32:08 +0100
Subject: [PATCH 0164/4023] Temporary rename

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 .../src/Framework/Features/Navigation/MainNavigationMenu.php    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 3a776e61ade..3ed96a630ad 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,7 +13,7 @@ class GeneratesMainNavigationMenu
 {
     public static function handle(): NavigationMenu
     {
-        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::__generate();
+        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::temp__generate();
 
         return new NavigationMenu($navigation->items);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index f82a962ca5d..929c6c213cb 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -13,7 +13,7 @@
 class MainNavigationMenu extends BaseNavigationMenu
 {
     /** @deprecated Temporary method for refactor */
-    public static function __generate(): static
+    public static function temp__generate(): static
     {
         $menu = new static();
 

From 850de857bed3ae354f97400d37fdad24d7c98e94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:32:20 +0100
Subject: [PATCH 0165/4023] Copy temporary parent methods

---
 .../GeneratesMainNavigationMenu.php           | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 3ed96a630ad..fa3d76e59d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -4,6 +4,11 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
+use Hyde\Support\Models\Route;
+use Hyde\Foundation\Facades\Routes;
+use function collect;
+
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -17,4 +22,36 @@ public static function handle(): NavigationMenu
 
         return new NavigationMenu($navigation->items);
     }
+
+    protected function parent__generate(): void
+    {
+        Routes::each(function (Route $route): void {
+            if ($this->canAddRoute($route)) {
+                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+            }
+        });
+
+        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
+            // Since these were added explicitly by the user, we can assume they should always be shown
+            $this->items->push($item);
+        });
+    }
+
+    protected function parent__canAddRoute(Route $route): bool
+    {
+        return $route->getPage()->showInNavigation();
+    }
+
+    protected function parent__removeDuplicateItems(): void
+    {
+        $this->items = $this->items->unique(function (NavItem $item): string {
+            // Filter using a combination of the group and label to allow duplicate labels in different groups
+            return $item->getGroup().$item->label;
+        });
+    }
+
+    protected function parent__sortByPriority(): void
+    {
+        $this->items = $this->items->sortBy('priority')->values();
+    }
 }

From f445c7a5183cb0c590e5547d6cf6a4ba4ae573d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:33:10 +0100
Subject: [PATCH 0166/4023] Copy over temporary child methods

---
 .../GeneratesMainNavigationMenu.php           | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index fa3d76e59d2..14bf4e60c2f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,7 +6,9 @@
 
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
+
 use function collect;
 
 /**
@@ -23,6 +25,50 @@ public static function handle(): NavigationMenu
         return new NavigationMenu($navigation->items);
     }
 
+    protected function generate(): void
+    {
+        $this->parent__generate();
+
+        if ($this->dropdownsEnabled()) {
+            $this->moveGroupedItemsIntoDropdowns();
+        }
+    }
+
+    protected function moveGroupedItemsIntoDropdowns(): void
+    {
+        $dropdowns = [];
+
+        foreach ($this->items as $key => $item) {
+            if ($this->canAddItemToDropdown($item)) {
+                // Buffer the item in the dropdowns array
+                $dropdowns[$item->getGroup()][] = $item;
+
+                // Remove the item from the main items collection
+                $this->items->forget($key);
+            }
+        }
+
+        foreach ($dropdowns as $group => $items) {
+            // Create a new dropdown item containing the buffered items
+            $this->items->add(new DropdownNavItem($group, $items));
+        }
+    }
+
+    protected function canAddRoute(Route $route): bool
+    {
+        return $this->parent__canAddRoute($route) && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
+    }
+
+    protected function canAddItemToDropdown(NavItem $item): bool
+    {
+        return $item->getGroup() !== null;
+    }
+
+    protected function dropdownsEnabled(): bool
+    {
+        return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
+    }
+
     protected function parent__generate(): void
     {
         Routes::each(function (Route $route): void {

From 8ca7263c51f8400e88e313746ddd1d648115ba7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:39:01 +0100
Subject: [PATCH 0167/4023] Inline temporary refactoring method

---
 .../Navigation/GeneratesMainNavigationMenu.php  | 17 +++++++++++++++--
 .../Features/Navigation/MainNavigationMenu.php  | 12 ------------
 2 files changed, 15 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 14bf4e60c2f..11acdfa71a7 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
+use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 
 use function collect;
@@ -18,11 +19,23 @@
  */
 class GeneratesMainNavigationMenu
 {
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    protected Collection $items;
+
+    protected function __construct()
+    {
+        $this->items = new Collection();
+    }
+
     public static function handle(): NavigationMenu
     {
-        $navigation = \Hyde\Framework\Features\Navigation\MainNavigationMenu::temp__generate();
+        $menu = new static();
+
+        $menu->generate();
+        $menu->parent__sortByPriority();
+        $menu->parent__removeDuplicateItems();
 
-        return new NavigationMenu($navigation->items);
+        return new NavigationMenu($menu->items);
     }
 
     protected function generate(): void
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 929c6c213cb..61fad3c0fec 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -12,18 +12,6 @@
 /** @deprecated Use the new NavigationMenu class instead */
 class MainNavigationMenu extends BaseNavigationMenu
 {
-    /** @deprecated Temporary method for refactor */
-    public static function temp__generate(): static
-    {
-        $menu = new static();
-
-        $menu->generate();
-        $menu->sortByPriority();
-        $menu->removeDuplicateItems();
-
-        return $menu;
-    }
-
     /** @deprecated Temporary method for refactor */
     public static function create(): static
     {

From 70959896044f7276c626c99ced49f6137d3436f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:42:53 +0100
Subject: [PATCH 0168/4023] Merge back old renamed test with new one

---
 .../tests/Feature/MainNavigationMenuTest.php  | 390 ------------------
 .../tests/Feature/NavigationMenuTest.php      | 378 ++++++++++++++++-
 2 files changed, 377 insertions(+), 391 deletions(-)
 delete mode 100644 packages/framework/tests/Feature/MainNavigationMenuTest.php

diff --git a/packages/framework/tests/Feature/MainNavigationMenuTest.php b/packages/framework/tests/Feature/MainNavigationMenuTest.php
deleted file mode 100644
index c7bb9bd1826..00000000000
--- a/packages/framework/tests/Feature/MainNavigationMenuTest.php
+++ /dev/null
@@ -1,390 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Feature;
-
-use BadMethodCallException;
-use Hyde\Support\Models\Route;
-
-use function collect;
-use function config;
-
-use Hyde\Foundation\Facades\Routes;
-use Hyde\Framework\Features\Navigation\DropdownNavItem;
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Pages\DocumentationPage;
-use Hyde\Pages\MarkdownPage;
-use Hyde\Pages\MarkdownPost;
-use Hyde\Testing\TestCase;
-use Illuminate\Support\Collection;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
- */
-class MainNavigationMenuTest extends TestCase
-{
-    public function testConstructor()
-    {
-        $this->assertInstanceOf(MainNavigationMenu::class, MainNavigationMenu::create());
-    }
-
-    public function testGenerateMethodCreatesCollectionOfNavItems()
-    {
-        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->items);
-    }
-
-    public function testGetItemsReturnsItems()
-    {
-        $this->assertEquals(MainNavigationMenu::create()->items, MainNavigationMenu::create()->getItems());
-    }
-
-    public function testItemsAreSortedByPriority()
-    {
-        Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.priority' => 1])));
-        Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
-        Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
-
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->items->pluck('label')->toArray());
-    }
-
-    public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
-    {
-        Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
-        Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
-
-        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->items->pluck('label')->toArray());
-    }
-
-    public function testCreatedCollectionIsSortedByNavigationMenuPriority()
-    {
-        $this->file('_pages/foo.md');
-        $this->file('_docs/index.md');
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo')),
-            NavItem::fromRoute(Routes::get('docs/index')),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
-    {
-        $this->file('_pages/foo.md');
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo')),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testCollectionOnlyContainsNavItems()
-    {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->items);
-    }
-
-    public function testExternalLinkCanBeAddedInConfig()
-    {
-        config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::forLink('https://example.com', 'foo'),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testPathLinkCanBeAddedInConfig()
-    {
-        config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testDuplicatesAreRemovedWhenAddingInConfig()
-    {
-        config(['hyde.navigation.custom' => [
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('foo', 'foo'),
-        ]]);
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestination()
-    {
-        config(['hyde.navigation.custom' => [
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('bar', 'foo'),
-        ]]);
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testConfigItemsTakePrecedenceOverGeneratedItems()
-    {
-        $this->file('_pages/foo.md');
-
-        config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::forLink('bar', 'Foo'),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
-    {
-        $this->file('_docs/foo.md');
-        $this->file('_docs/index.md');
-
-        $menu = MainNavigationMenu::create();
-
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('docs/index')),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
-    {
-        $this->directory('_pages/foo');
-        $this->file('_pages/foo/bar.md');
-
-        $menu = MainNavigationMenu::create();
-        $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfigFlatSetting()
-    {
-        config(['hyde.navigation.subdirectories' => 'flat']);
-        $this->directory('_pages/foo');
-        $this->file('_pages/foo/bar.md');
-
-        $menu = MainNavigationMenu::create();
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo/bar')),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfigDropdownSetting()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $this->directory('_pages/foo');
-        $this->file('_pages/foo/bar.md');
-
-        $menu = MainNavigationMenu::create();
-        $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            DropdownNavItem::fromArray('foo', [
-                NavItem::fromRoute(Routes::get('foo/bar')),
-            ]),
-        ]);
-
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
-    }
-
-    public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = MainNavigationMenu::create();
-        $this->assertFalse($menu->hasDropdowns());
-    }
-
-    public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = MainNavigationMenu::create();
-        $this->assertTrue($menu->hasDropdowns());
-    }
-
-    public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
-    {
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse(MainNavigationMenu::create()->hasDropdowns());
-    }
-
-    public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = MainNavigationMenu::create();
-        $this->assertCount(0, $menu->getDropdowns());
-        $this->assertSame([], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = MainNavigationMenu::create();
-        $this->assertCount(1, $menu->getDropdowns());
-
-        $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-            ]), ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsWithMultipleItems()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
-
-        $this->assertCount(1, $menu->getDropdowns());
-
-        $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
-            ]),
-        ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsWithMultipleDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
-
-        $menu = MainNavigationMenu::create();
-
-        $this->assertCount(2, $menu->getDropdowns());
-
-        $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
-            ]),
-            DropdownNavItem::fromArray('cat', [
-                NavItem::fromRoute((new MarkdownPage('cat/hat'))->getRoute()),
-            ]),
-        ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsThrowsExceptionWhenDisabled()
-    {
-        $this->expectException(BadMethodCallException::class);
-        $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
-
-        $menu = MainNavigationMenu::create();
-        $menu->getDropdowns();
-    }
-
-    public function testDocumentationPagesDoNotGetAddedToDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new DocumentationPage('foo'))->getRoute());
-        Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
-
-        $this->assertFalse($menu->hasDropdowns());
-        $this->assertCount(0, $menu->getDropdowns());
-    }
-
-    public function testBlogPostsDoNotGetAddedToDropdowns()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPost('foo'))->getRoute());
-        Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
-
-        $menu = MainNavigationMenu::create();
-        $this->assertFalse($menu->hasDropdowns());
-        $this->assertCount(0, $menu->getDropdowns());
-    }
-
-    public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::push((new MarkdownPage('foo'))->getRoute());
-        Routes::push((new MarkdownPage('bar/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
-
-        $this->assertCount(3, $menu->items);
-        $this->assertEquals([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            DropdownNavItem::fromArray('bar', [
-                NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
-            ]),
-        ], $menu->items->all());
-    }
-
-    public function testDropdownMenuItemsAreSortedByPriority()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));
-        Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
-        Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
-
-        $menu = MainNavigationMenu::create();
-        $dropdowns = $menu->getDropdowns();
-
-        $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
-    }
-}
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index b75fa735190..3f2fdb6afef 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,12 +4,388 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use BadMethodCallException;
+use Hyde\Support\Models\Route;
+
+use function collect;
+use function config;
+
+use Hyde\Foundation\Facades\Routes;
+use Hyde\Framework\Features\Navigation\DropdownNavItem;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Collection;
 
 /**
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  */
 class NavigationMenuTest extends TestCase
 {
-    //
+    public function testConstructor()
+    {
+        $this->assertInstanceOf(MainNavigationMenu::class, MainNavigationMenu::create());
+    }
+
+    public function testGenerateMethodCreatesCollectionOfNavItems()
+    {
+        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->items);
+    }
+
+    public function testGetItemsReturnsItems()
+    {
+        $this->assertEquals(MainNavigationMenu::create()->items, MainNavigationMenu::create()->getItems());
+    }
+
+    public function testItemsAreSortedByPriority()
+    {
+        Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.priority' => 1])));
+        Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
+        Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
+
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->items->pluck('label')->toArray());
+    }
+
+    public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
+    {
+        Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
+        Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
+
+        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->items->pluck('label')->toArray());
+    }
+
+    public function testCreatedCollectionIsSortedByNavigationMenuPriority()
+    {
+        $this->file('_pages/foo.md');
+        $this->file('_docs/index.md');
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::fromRoute(Routes::get('foo')),
+            NavItem::fromRoute(Routes::get('docs/index')),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
+    {
+        $this->file('_pages/foo.md');
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::fromRoute(Routes::get('foo')),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testCollectionOnlyContainsNavItems()
+    {
+        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->items);
+    }
+
+    public function testExternalLinkCanBeAddedInConfig()
+    {
+        config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forLink('https://example.com', 'foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testPathLinkCanBeAddedInConfig()
+    {
+        config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forLink('foo', 'foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testDuplicatesAreRemovedWhenAddingInConfig()
+    {
+        config(['hyde.navigation.custom' => [
+            NavItem::forLink('foo', 'foo'),
+            NavItem::forLink('foo', 'foo'),
+        ]]);
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forLink('foo', 'foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestination()
+    {
+        config(['hyde.navigation.custom' => [
+            NavItem::forLink('foo', 'foo'),
+            NavItem::forLink('bar', 'foo'),
+        ]]);
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forLink('foo', 'foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testConfigItemsTakePrecedenceOverGeneratedItems()
+    {
+        $this->file('_pages/foo.md');
+
+        config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forLink('bar', 'Foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
+    {
+        $this->file('_docs/foo.md');
+        $this->file('_docs/index.md');
+
+        $menu = MainNavigationMenu::create();
+
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::fromRoute(Routes::get('docs/index')),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
+    {
+        $this->directory('_pages/foo');
+        $this->file('_pages/foo/bar.md');
+
+        $menu = MainNavigationMenu::create();
+        $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfigFlatSetting()
+    {
+        config(['hyde.navigation.subdirectories' => 'flat']);
+        $this->directory('_pages/foo');
+        $this->file('_pages/foo/bar.md');
+
+        $menu = MainNavigationMenu::create();
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::fromRoute(Routes::get('foo/bar')),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfigDropdownSetting()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        $this->directory('_pages/foo');
+        $this->file('_pages/foo/bar.md');
+
+        $menu = MainNavigationMenu::create();
+        $expected = collect([
+            NavItem::fromRoute(Routes::get('index')),
+            DropdownNavItem::fromArray('foo', [
+                NavItem::fromRoute(Routes::get('foo/bar')),
+            ]),
+        ]);
+
+        $this->assertCount(count($expected), $menu->items);
+        $this->assertEquals($expected, $menu->items);
+    }
+
+    public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        $menu = MainNavigationMenu::create();
+        $this->assertFalse($menu->hasDropdowns());
+    }
+
+    public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
+        $menu = MainNavigationMenu::create();
+        $this->assertTrue($menu->hasDropdowns());
+    }
+
+    public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
+    {
+        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
+        $this->assertFalse(MainNavigationMenu::create()->hasDropdowns());
+    }
+
+    public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        $menu = MainNavigationMenu::create();
+        $this->assertCount(0, $menu->getDropdowns());
+        $this->assertSame([], $menu->getDropdowns());
+    }
+
+    public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
+        $menu = MainNavigationMenu::create();
+        $this->assertCount(1, $menu->getDropdowns());
+
+        $this->assertEquals([
+            DropdownNavItem::fromArray('foo', [
+                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
+            ]), ], $menu->getDropdowns());
+    }
+
+    public function testGetDropdownsWithMultipleItems()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
+        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
+        $menu = MainNavigationMenu::create();
+
+        $this->assertCount(1, $menu->getDropdowns());
+
+        $this->assertEquals([
+            DropdownNavItem::fromArray('foo', [
+                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
+                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
+            ]),
+        ], $menu->getDropdowns());
+    }
+
+    public function testGetDropdownsWithMultipleDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
+        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
+        Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
+
+        $menu = MainNavigationMenu::create();
+
+        $this->assertCount(2, $menu->getDropdowns());
+
+        $this->assertEquals([
+            DropdownNavItem::fromArray('foo', [
+                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
+                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
+            ]),
+            DropdownNavItem::fromArray('cat', [
+                NavItem::fromRoute((new MarkdownPage('cat/hat'))->getRoute()),
+            ]),
+        ], $menu->getDropdowns());
+    }
+
+    public function testGetDropdownsThrowsExceptionWhenDisabled()
+    {
+        $this->expectException(BadMethodCallException::class);
+        $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
+
+        $menu = MainNavigationMenu::create();
+        $menu->getDropdowns();
+    }
+
+    public function testDocumentationPagesDoNotGetAddedToDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::addRoute((new DocumentationPage('foo'))->getRoute());
+        Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
+        $menu = MainNavigationMenu::create();
+
+        $this->assertFalse($menu->hasDropdowns());
+        $this->assertCount(0, $menu->getDropdowns());
+    }
+
+    public function testBlogPostsDoNotGetAddedToDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::addRoute((new MarkdownPost('foo'))->getRoute());
+        Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
+
+        $menu = MainNavigationMenu::create();
+        $this->assertFalse($menu->hasDropdowns());
+        $this->assertCount(0, $menu->getDropdowns());
+    }
+
+    public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::push((new MarkdownPage('foo'))->getRoute());
+        Routes::push((new MarkdownPage('bar/baz'))->getRoute());
+        $menu = MainNavigationMenu::create();
+
+        $this->assertCount(3, $menu->items);
+        $this->assertEquals([
+            NavItem::fromRoute(Routes::get('index')),
+            NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
+            DropdownNavItem::fromArray('bar', [
+                NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
+            ]),
+        ], $menu->items->all());
+    }
+
+    public function testDropdownMenuItemsAreSortedByPriority()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));
+        Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
+        Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
+
+        $menu = MainNavigationMenu::create();
+        $dropdowns = $menu->getDropdowns();
+
+        $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
+    }
 }

From 197b80723db0899c15577056c291bce48e4dcbe7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:47:58 +0100
Subject: [PATCH 0169/4023] Formatting

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 3f2fdb6afef..97f2673dcdf 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -6,10 +6,6 @@
 
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
-
-use function collect;
-use function config;
-
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;

From a6132c710d5f274c00288d3e7020168fb4d8c1ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:54:46 +0100
Subject: [PATCH 0170/4023] Add coverage annotation

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 97f2673dcdf..c7a5d614f71 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -17,6 +17,7 @@
 use Illuminate\Support\Collection;
 
 /**
+ * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu

From 1a4d66f3c7896efddd12185be77398a8695969bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:54:54 +0100
Subject: [PATCH 0171/4023] Remove resolved todo

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 11acdfa71a7..56aab99c18b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -14,8 +14,6 @@
 
 /**
  * @experimental This class may change significantly before its release.
- *
- * @todo Refactor to move logic to the new action
  */
 class GeneratesMainNavigationMenu
 {

From aab36f0eb75961323907e794dbc8bba98bd690d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:56:21 +0100
Subject: [PATCH 0172/4023] Remove temporary parent prefixes from standalone
 methods

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 56aab99c18b..cab76d9dd8f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -30,8 +30,8 @@ public static function handle(): NavigationMenu
         $menu = new static();
 
         $menu->generate();
-        $menu->parent__sortByPriority();
-        $menu->parent__removeDuplicateItems();
+        $menu->sortByPriority();
+        $menu->removeDuplicateItems();
 
         return new NavigationMenu($menu->items);
     }
@@ -99,7 +99,7 @@ protected function parent__canAddRoute(Route $route): bool
         return $route->getPage()->showInNavigation();
     }
 
-    protected function parent__removeDuplicateItems(): void
+    protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
             // Filter using a combination of the group and label to allow duplicate labels in different groups
@@ -107,7 +107,7 @@ protected function parent__removeDuplicateItems(): void
         });
     }
 
-    protected function parent__sortByPriority(): void
+    protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy('priority')->values();
     }

From dd12c9fb9adb52c7ca6a97bdd8d9d1800360bf36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:58:23 +0100
Subject: [PATCH 0173/4023] Inline temporary parent method copies

---
 .../GeneratesMainNavigationMenu.php           | 32 +++++++------------
 1 file changed, 11 insertions(+), 21 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index cab76d9dd8f..8eb8bf2b3d6 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -38,7 +38,16 @@ public static function handle(): NavigationMenu
 
     protected function generate(): void
     {
-        $this->parent__generate();
+        Routes::each(function (Route $route): void {
+            if ($this->canAddRoute($route)) {
+                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+            }
+        });
+
+        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
+            // Since these were added explicitly by the user, we can assume they should always be shown
+            $this->items->push($item);
+        });
 
         if ($this->dropdownsEnabled()) {
             $this->moveGroupedItemsIntoDropdowns();
@@ -67,7 +76,7 @@ protected function moveGroupedItemsIntoDropdowns(): void
 
     protected function canAddRoute(Route $route): bool
     {
-        return $this->parent__canAddRoute($route) && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
+        return $route->getPage()->showInNavigation() && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
     }
 
     protected function canAddItemToDropdown(NavItem $item): bool
@@ -80,25 +89,6 @@ protected function dropdownsEnabled(): bool
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }
 
-    protected function parent__generate(): void
-    {
-        Routes::each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-            }
-        });
-
-        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
-            // Since these were added explicitly by the user, we can assume they should always be shown
-            $this->items->push($item);
-        });
-    }
-
-    protected function parent__canAddRoute(Route $route): bool
-    {
-        return $route->getPage()->showInNavigation();
-    }
-
     protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {

From db45a35186911b7d5887eeea538a5ef0e6aa9973 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 14:59:50 +0100
Subject: [PATCH 0174/4023] Remove helper methods moved to new action

---
 .../Navigation/MainNavigationMenu.php         | 41 -------------------
 1 file changed, 41 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 61fad3c0fec..c0f51cc4b3b 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -5,8 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use Hyde\Support\Models\Route;
-use Hyde\Pages\DocumentationPage;
 use BadMethodCallException;
 
 /** @deprecated Use the new NavigationMenu class instead */
@@ -21,15 +19,6 @@ public static function create(): static
         return $menu;
     }
 
-    protected function generate(): void
-    {
-        parent::generate();
-
-        if ($this->dropdownsEnabled()) {
-            $this->moveGroupedItemsIntoDropdowns();
-        }
-    }
-
     public function hasDropdowns(): bool
     {
         return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
@@ -47,36 +36,6 @@ public function getDropdowns(): array
         })->values()->all();
     }
 
-    protected function moveGroupedItemsIntoDropdowns(): void
-    {
-        $dropdowns = [];
-
-        foreach ($this->items as $key => $item) {
-            if ($this->canAddItemToDropdown($item)) {
-                // Buffer the item in the dropdowns array
-                $dropdowns[$item->getGroup()][] = $item;
-
-                // Remove the item from the main items collection
-                $this->items->forget($key);
-            }
-        }
-
-        foreach ($dropdowns as $group => $items) {
-            // Create a new dropdown item containing the buffered items
-            $this->items->add(new DropdownNavItem($group, $items));
-        }
-    }
-
-    protected function canAddRoute(Route $route): bool
-    {
-        return parent::canAddRoute($route) && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
-    }
-
-    protected function canAddItemToDropdown(NavItem $item): bool
-    {
-        return $item->getGroup() !== null;
-    }
-
     protected function dropdownsEnabled(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';

From ee786d706f8729977588817642c5d9217c5ae37c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:06:16 +0100
Subject: [PATCH 0175/4023] Breaking: Make `BaseNavigationMenu::$items`
 protected

---
 .../components/docs/sidebar-items.blade.php   |  2 +-
 .../Navigation/BaseNavigationMenu.php         |  2 +-
 .../tests/Feature/NavigationMenuTest.php      | 58 +++++++++----------
 .../Services/DocumentationSidebarTest.php     | 36 ++++++------
 4 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 4c26062cf9f..cebd57f4833 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -1,7 +1,7 @@
 @php /** @var \Hyde\Framework\Features\Navigation\DocumentationSidebar $sidebar */ @endphp
 @if(! $sidebar->hasGroups())
     <ul id="sidebar-items" role="list" class="pl-2">
-        @foreach ($sidebar->items as $item)
+        @foreach ($sidebar->getItems() as $item)
             @include('hyde::components.docs.sidebar-item')
         @endforeach
     </ul>
diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index d8bf84ebfab..9761a13a465 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -15,7 +15,7 @@
 abstract class BaseNavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
-    public Collection $items;
+    protected Collection $items;
 
     final protected function __construct()
     {
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index c7a5d614f71..5bc2caf372d 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -31,12 +31,12 @@ public function testConstructor()
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
-        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->items);
+        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals(MainNavigationMenu::create()->items, MainNavigationMenu::create()->getItems());
+        $this->assertEquals(MainNavigationMenu::create()->getItems(), MainNavigationMenu::create()->getItems());
     }
 
     public function testItemsAreSortedByPriority()
@@ -45,7 +45,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->items->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->getItems()->pluck('label')->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -53,7 +53,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->items->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->getItems()->pluck('label')->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -69,8 +69,8 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
             NavItem::fromRoute(Routes::get('docs/index')),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
@@ -84,13 +84,13 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
             NavItem::fromRoute(Routes::get('foo')),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testCollectionOnlyContainsNavItems()
     {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->items);
+        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->getItems());
     }
 
     public function testExternalLinkCanBeAddedInConfig()
@@ -104,8 +104,8 @@ public function testExternalLinkCanBeAddedInConfig()
             NavItem::forLink('https://example.com', 'foo'),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testPathLinkCanBeAddedInConfig()
@@ -119,8 +119,8 @@ public function testPathLinkCanBeAddedInConfig()
             NavItem::forLink('foo', 'foo'),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testDuplicatesAreRemovedWhenAddingInConfig()
@@ -137,8 +137,8 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
             NavItem::forLink('foo', 'foo'),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestination()
@@ -155,8 +155,8 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
             NavItem::forLink('foo', 'foo'),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testConfigItemsTakePrecedenceOverGeneratedItems()
@@ -172,8 +172,8 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
             NavItem::forLink('bar', 'Foo'),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
@@ -188,8 +188,8 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
             NavItem::fromRoute(Routes::get('docs/index')),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
@@ -200,8 +200,8 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $menu = MainNavigationMenu::create();
         $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfigFlatSetting()
@@ -216,8 +216,8 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
             NavItem::fromRoute(Routes::get('foo/bar')),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfigDropdownSetting()
@@ -234,8 +234,8 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
             ]),
         ]);
 
-        $this->assertCount(count($expected), $menu->items);
-        $this->assertEquals($expected, $menu->items);
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
     }
 
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
@@ -362,14 +362,14 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
         $menu = MainNavigationMenu::create();
 
-        $this->assertCount(3, $menu->items);
+        $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
             DropdownNavItem::fromArray('bar', [
                 NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
-        ], $menu->items->all());
+        ], $menu->getItems()->all());
     }
 
     public function testDropdownMenuItemsAreSortedByPriority()
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 54290a8e34d..e27a832ab3b 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -51,7 +51,7 @@ public function testSidebarItemsAreAddedAutomatically()
 
         $sidebar = DocumentationSidebar::create();
 
-        $this->assertCount(5, $sidebar->items);
+        $this->assertCount(5, $sidebar->getItems());
     }
 
     public function testIndexPageIsRemovedFromSidebar()
@@ -60,7 +60,7 @@ public function testIndexPageIsRemovedFromSidebar()
         Filesystem::touch('_docs/index.md');
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(5, $sidebar->items);
+        $this->assertCount(5, $sidebar->getItems());
     }
 
     public function testFilesWithFrontMatterHiddenSetToTrueAreRemovedFromSidebar()
@@ -69,7 +69,7 @@ public function testFilesWithFrontMatterHiddenSetToTrueAreRemovedFromSidebar()
         File::put(Hyde::path('_docs/test.md'), "---\nnavigation:\n    hidden: true\n---\n\n# Foo");
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(5, $sidebar->items);
+        $this->assertCount(5, $sidebar->getItems());
     }
 
     public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
@@ -85,7 +85,7 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
                 NavItem::fromRoute(Routes::get('docs/b'), priority: 999),
                 NavItem::fromRoute(Routes::get('docs/c'), priority: 999),
             ]),
-            DocumentationSidebar::create()->items
+            DocumentationSidebar::create()->getItems()
         );
     }
 
@@ -106,7 +106,7 @@ public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
                 NavItem::fromRoute(Routes::get('docs/b'), priority: 250 + 251),
                 NavItem::fromRoute(Routes::get('docs/a'), priority: 250 + 252),
             ]),
-            DocumentationSidebar::create()->items
+            DocumentationSidebar::create()->getItems()
         );
     }
 
@@ -114,7 +114,7 @@ public function testSidebarItemPriorityCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.priority' => 25]);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->items->first()->priority);
+        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->priority);
     }
 
     public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
@@ -123,7 +123,7 @@ public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
 
         Config::set('docs.sidebar_order', ['foo']);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->items->first()->priority);
+        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->priority);
     }
 
     public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
@@ -145,7 +145,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
                 NavItem::fromRoute(Routes::get('docs/second'), priority: 250 + 252),
                 NavItem::fromRoute(Routes::get('docs/third'), priority: 250 + 300),
             ]),
-            DocumentationSidebar::create()->items
+            DocumentationSidebar::create()->getItems()
         );
     }
 
@@ -153,7 +153,7 @@ public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
 
-        $this->assertEquals('bar', DocumentationSidebar::create()->items->first()->getGroup());
+        $this->assertEquals('bar', DocumentationSidebar::create()->getItems()->first()->getGroup());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
@@ -276,7 +276,7 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
 
         $this->assertEquals(
             collect([NavItem::fromRoute(Routes::get('docs/foo'), priority: 999)]),
-            DocumentationSidebar::create()->items
+            DocumentationSidebar::create()->getItems()
         );
     }
 
@@ -361,14 +361,14 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
         $this->makePage('bar', ['navigation.group' => 'bar', 'navigation.label' => 'Foo']);
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(2, $sidebar->items);
+        $this->assertCount(2, $sidebar->getItems());
 
         $this->assertEquals(
             collect([
                 NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
                 NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
             ]),
-            $sidebar->items
+            $sidebar->getItems()
         );
     }
 
@@ -378,11 +378,11 @@ public function testDuplicateLabelsWithinTheSameGroupIsRemoved()
         $this->makePage('bar', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(1, $sidebar->items);
+        $this->assertCount(1, $sidebar->getItems());
 
         $this->assertEquals(
             collect([NavItem::fromRoute(Routes::get('docs/bar'), priority: 999)]),
-            $sidebar->items
+            $sidebar->getItems()
         );
     }
 
@@ -399,10 +399,10 @@ public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
         Filesystem::touch('_docs/index.md');
         $sidebar = DocumentationSidebar::create();
 
-        $this->assertCount(1, $sidebar->items);
+        $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
             collect([NavItem::fromRoute(Routes::get('docs/index'))]),
-            $sidebar->items
+            $sidebar->getItems()
         );
     }
 
@@ -412,10 +412,10 @@ public function testIndexPageNotAddedToSidebarWhenOtherPagesExist()
         Filesystem::touch('_docs/index.md');
         $sidebar = DocumentationSidebar::create();
 
-        $this->assertCount(1, $sidebar->items);
+        $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
             collect([NavItem::fromRoute(Routes::get('docs/test-0'))]),
-            $sidebar->items
+            $sidebar->getItems()
         );
     }
 

From f60ababd60d29016b83a336d5b39445aa3ec889c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:10:11 +0100
Subject: [PATCH 0176/4023] Return the values to match annotation generics

---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index 9761a13a465..c2ea70c25ff 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -68,6 +68,6 @@ protected function sortByPriority(): void
     /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
-        return $this->items;
+        return $this->items->values();
     }
 }

From 9c193771fb2fa6a2a9eaac7564f9ec0754baa772 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:15:58 +0100
Subject: [PATCH 0177/4023] Extract testing helper method

---
 .../tests/Feature/NavigationMenuTest.php      | 63 ++++++++++---------
 1 file changed, 34 insertions(+), 29 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 5bc2caf372d..dfb5e89f147 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -26,17 +26,17 @@ class NavigationMenuTest extends TestCase
 {
     public function testConstructor()
     {
-        $this->assertInstanceOf(MainNavigationMenu::class, MainNavigationMenu::create());
+        $this->assertInstanceOf(MainNavigationMenu::class, $this->createMainNavigationMenu());
     }
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
-        $this->assertInstanceOf(Collection::class, MainNavigationMenu::create()->getItems());
+        $this->assertInstanceOf(Collection::class, $this->createMainNavigationMenu()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals(MainNavigationMenu::create()->getItems(), MainNavigationMenu::create()->getItems());
+        $this->assertEquals($this->createMainNavigationMenu()->getItems(), $this->createMainNavigationMenu()->getItems());
     }
 
     public function testItemsAreSortedByPriority()
@@ -45,7 +45,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], MainNavigationMenu::create()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createMainNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -53,7 +53,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], MainNavigationMenu::create()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], $this->createMainNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -61,7 +61,7 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $this->file('_pages/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -77,7 +77,7 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
     {
         $this->file('_pages/foo.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -90,14 +90,14 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
 
     public function testCollectionOnlyContainsNavItems()
     {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, MainNavigationMenu::create()->getItems());
+        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createMainNavigationMenu()->getItems());
     }
 
     public function testExternalLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -112,7 +112,7 @@ public function testPathLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -130,7 +130,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
             NavItem::forLink('foo', 'foo'),
         ]]);
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -148,7 +148,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
             NavItem::forLink('bar', 'foo'),
         ]]);
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -165,7 +165,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
 
         config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -181,7 +181,7 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $this->file('_docs/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -197,7 +197,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -210,7 +210,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute(Routes::get('foo/bar')),
@@ -226,7 +226,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             DropdownNavItem::fromArray('foo', [
@@ -241,7 +241,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
     }
 
@@ -249,20 +249,20 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $this->assertTrue($menu->hasDropdowns());
     }
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse(MainNavigationMenu::create()->hasDropdowns());
+        $this->assertFalse($this->createMainNavigationMenu()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
     }
@@ -271,7 +271,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
@@ -286,7 +286,7 @@ public function testGetDropdownsWithMultipleItems()
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $this->assertCount(1, $menu->getDropdowns());
 
@@ -306,7 +306,7 @@ public function testGetDropdownsWithMultipleDropdowns()
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
         Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $this->assertCount(2, $menu->getDropdowns());
 
@@ -326,7 +326,7 @@ public function testGetDropdownsThrowsExceptionWhenDisabled()
         $this->expectException(BadMethodCallException::class);
         $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $menu->getDropdowns();
     }
 
@@ -336,7 +336,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
         Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
@@ -349,7 +349,7 @@ public function testBlogPostsDoNotGetAddedToDropdowns()
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());
         Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
     }
@@ -360,7 +360,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
@@ -380,9 +380,14 @@ public function testDropdownMenuItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
 
-        $menu = MainNavigationMenu::create();
+        $menu = $this->createMainNavigationMenu();
         $dropdowns = $menu->getDropdowns();
 
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
     }
+
+    protected function createMainNavigationMenu(): MainNavigationMenu
+    {
+        return MainNavigationMenu::create();
+    }
 }

From cf3869fe45d250417e77a73f872464570eede7be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:19:28 +0100
Subject: [PATCH 0178/4023] Refactor to make the base navigation menu
 constructor public

Starting to normalize the API so we can merge the classes
---
 .../src/Framework/Features/Navigation/BaseNavigationMenu.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index c2ea70c25ff..2f16ac49b46 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -8,6 +8,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Illuminate\Support\Collection;
+use Illuminate\Contracts\Support\Arrayable;
 
 use function collect;
 
@@ -17,9 +18,9 @@ abstract class BaseNavigationMenu
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    final protected function __construct()
+    public function __construct(Arrayable|array $items = [])
     {
-        $this->items = new Collection();
+        $this->items = new Collection($items);
     }
 
     public static function create(): static

From a673b411b7ec3292916235a24a211354d8588fc0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:23:06 +0100
Subject: [PATCH 0179/4023] Simplify static constructor

---
 .../src/Framework/Features/Navigation/MainNavigationMenu.php | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index c0f51cc4b3b..da092f24a26 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -13,10 +13,7 @@ class MainNavigationMenu extends BaseNavigationMenu
     /** @deprecated Temporary method for refactor */
     public static function create(): static
     {
-        $menu = new static();
-        $menu->items = GeneratesMainNavigationMenu::handle()->getItems();
-
-        return $menu;
+        return new static(GeneratesMainNavigationMenu::handle()->getItems());
     }
 
     public function hasDropdowns(): bool

From 2b94061ab95248f7d095967c8dec52b830eb02d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:26:14 +0100
Subject: [PATCH 0180/4023] Move parent logic now only used by sidebar to that
 class

---
 .../Navigation/BaseNavigationMenu.php         | 37 -------------------
 .../Navigation/DocumentationSidebar.php       | 34 ++++++++++++++++-
 2 files changed, 33 insertions(+), 38 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index 2f16ac49b46..e95c6e715a0 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -4,14 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
-use Hyde\Support\Models\Route;
-use Hyde\Foundation\Facades\Routes;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
-use function collect;
-
 /** @deprecated Use the new NavigationMenu class instead */
 abstract class BaseNavigationMenu
 {
@@ -34,38 +29,6 @@ public static function create(): static
         return $menu;
     }
 
-    protected function generate(): void
-    {
-        Routes::each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-            }
-        });
-
-        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
-            // Since these were added explicitly by the user, we can assume they should always be shown
-            $this->items->push($item);
-        });
-    }
-
-    protected function canAddRoute(Route $route): bool
-    {
-        return $route->getPage()->showInNavigation();
-    }
-
-    protected function removeDuplicateItems(): void
-    {
-        $this->items = $this->items->unique(function (NavItem $item): string {
-            // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().$item->label;
-        });
-    }
-
-    protected function sortByPriority(): void
-    {
-        $this->items = $this->items->sortBy('priority')->values();
-    }
-
     /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ccfaacafbf9..5b316f08362 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -66,7 +66,39 @@ public function makeGroupTitle(string $group): string
 
     protected function canAddRoute(Route $route): bool
     {
-        return parent::canAddRoute($route) && ! $route->is(DocumentationPage::homeRouteName());
+        return $this->parent__canAddRoute($route) && ! $route->is(DocumentationPage::homeRouteName());
+    }
+
+    protected function parent__generate(): void
+    {
+        Routes::each(function (Route $route): void {
+            if ($this->canAddRoute($route)) {
+                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+            }
+        });
+
+        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
+            // Since these were added explicitly by the user, we can assume they should always be shown
+            $this->items->push($item);
+        });
+    }
+
+    protected function parent__canAddRoute(Route $route): bool
+    {
+        return $route->getPage()->showInNavigation();
+    }
+
+    protected function removeDuplicateItems(): void
+    {
+        $this->items = $this->items->unique(function (NavItem $item): string {
+            // Filter using a combination of the group and label to allow duplicate labels in different groups
+            return $item->getGroup().$item->label;
+        });
+    }
+
+    protected function sortByPriority(): void
+    {
+        $this->items = $this->items->sortBy('priority')->values();
     }
 
     private function isPageIndexPage(): bool

From 4afa8126367b4377acefaa103ed4b819ce9858dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:36:57 +0100
Subject: [PATCH 0181/4023] Move static create method to sidebar class

---
 .../Features/Navigation/BaseNavigationMenu.php        | 11 -----------
 .../Features/Navigation/DocumentationSidebar.php      | 11 +++++++++++
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index e95c6e715a0..950eb034e31 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -18,17 +18,6 @@ public function __construct(Arrayable|array $items = [])
         $this->items = new Collection($items);
     }
 
-    public static function create(): static
-    {
-        $menu = new static();
-
-        $menu->generate();
-        $menu->sortByPriority();
-        $menu->removeDuplicateItems();
-
-        return $menu;
-    }
-
     /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5b316f08362..ce7c9f4238d 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -18,6 +18,17 @@
 /** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends BaseNavigationMenu
 {
+    public static function create(): static
+    {
+        $menu = new static();
+
+        $menu->generate();
+        $menu->sortByPriority();
+        $menu->removeDuplicateItems();
+
+        return $menu;
+    }
+
     protected function generate(): void
     {
         Routes::getRoutes(DocumentationPage::class)->each(function (Route $route): void {

From fd9dfdbee0a94928961c952c91c036f2948d7774 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:37:34 +0100
Subject: [PATCH 0182/4023] Remove unused temporary parent function copy

---
 .../Features/Navigation/DocumentationSidebar.php   | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ce7c9f4238d..8f6cbe803c7 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -80,20 +80,6 @@ protected function canAddRoute(Route $route): bool
         return $this->parent__canAddRoute($route) && ! $route->is(DocumentationPage::homeRouteName());
     }
 
-    protected function parent__generate(): void
-    {
-        Routes::each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-            }
-        });
-
-        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
-            // Since these were added explicitly by the user, we can assume they should always be shown
-            $this->items->push($item);
-        });
-    }
-
     protected function parent__canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation();

From 209aa9b6d4c4f507b62d4e0c523bd7ce42f4b242 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:37:47 +0100
Subject: [PATCH 0183/4023] Inline parent method copy

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8f6cbe803c7..c782e8cf16e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -77,12 +77,7 @@ public function makeGroupTitle(string $group): string
 
     protected function canAddRoute(Route $route): bool
     {
-        return $this->parent__canAddRoute($route) && ! $route->is(DocumentationPage::homeRouteName());
-    }
-
-    protected function parent__canAddRoute(Route $route): bool
-    {
-        return $route->getPage()->showInNavigation();
+        return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
     }
 
     protected function removeDuplicateItems(): void

From 5f12a8692506bfa2821c68b9e1b9e90078ed56a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:42:47 +0100
Subject: [PATCH 0184/4023] Deprecate create method

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c782e8cf16e..13f3d340817 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -18,6 +18,7 @@
 /** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends BaseNavigationMenu
 {
+    /** @deprecated Will be moved to an action */
     public static function create(): static
     {
         $menu = new static();

From a3ae79254e7eb613cfea7256f501fc06d1f7d7c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:43:15 +0100
Subject: [PATCH 0185/4023] Add todo

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 8eb8bf2b3d6..6ad2aba5717 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -14,6 +14,8 @@
 
 /**
  * @experimental This class may change significantly before its release.
+ *
+ * @todo Consider making into a service which can create the sidebar as well.
  */
 class GeneratesMainNavigationMenu
 {

From 54338f03be64ac2488bbb4ee3afc8d31afe5c303 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:49:58 +0100
Subject: [PATCH 0186/4023] Add testing helper for the new menu to aid in
 refactor

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index dfb5e89f147..1956ef3b391 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -7,6 +7,7 @@
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -15,6 +16,7 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Collection;
+use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
@@ -386,6 +388,12 @@ public function testDropdownMenuItemsAreSortedByPriority()
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
     }
 
+    protected function createNewMainNavigationMenu(): NavigationMenu
+    {
+        return GeneratesMainNavigationMenu::handle();
+    }
+
+    /** @deprecated */
     protected function createMainNavigationMenu(): MainNavigationMenu
     {
         return MainNavigationMenu::create();

From cac6d904ef262b68fcfdfd1631d42d6640f691e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:50:26 +0100
Subject: [PATCH 0187/4023] Move dropdown accessors to new menu class

---
 .../Navigation/MainNavigationMenu.php         | 25 -------------------
 .../Features/Navigation/NavigationMenu.php    | 24 ++++++++++++++++++
 .../tests/Feature/NavigationMenuTest.php      | 22 ++++++++--------
 3 files changed, 35 insertions(+), 36 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index da092f24a26..bb046359779 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,9 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
-use BadMethodCallException;
-
 /** @deprecated Use the new NavigationMenu class instead */
 class MainNavigationMenu extends BaseNavigationMenu
 {
@@ -15,26 +12,4 @@ public static function create(): static
     {
         return new static(GeneratesMainNavigationMenu::handle()->getItems());
     }
-
-    public function hasDropdowns(): bool
-    {
-        return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
-    }
-
-    /** @return array<string, DropdownNavItem> */
-    public function getDropdowns(): array
-    {
-        if (! $this->dropdownsEnabled()) {
-            throw new BadMethodCallException('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
-        }
-
-        return $this->items->filter(function (NavItem $item): bool {
-            return $item instanceof DropdownNavItem;
-        })->values()->all();
-    }
-
-    protected function dropdownsEnabled(): bool
-    {
-        return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 4919ceb1bf1..983404b9616 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
+use BadMethodCallException;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -22,4 +24,26 @@ public function getItems(): Collection
     {
         return $this->items;
     }
+
+    public function hasDropdowns(): bool
+    {
+        return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
+    }
+
+    /** @return array<string, DropdownNavItem> */
+    public function getDropdowns(): array
+    {
+        if (! $this->dropdownsEnabled()) {
+            throw new BadMethodCallException('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
+        }
+
+        return $this->items->filter(function (NavItem $item): bool {
+            return $item instanceof DropdownNavItem;
+        })->values()->all();
+    }
+
+    protected function dropdownsEnabled(): bool
+    {
+        return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
+    }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 1956ef3b391..485c97e2026 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -243,7 +243,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
     }
 
@@ -251,20 +251,20 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $this->assertTrue($menu->hasDropdowns());
     }
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse($this->createMainNavigationMenu()->hasDropdowns());
+        $this->assertFalse($this->createNewMainNavigationMenu()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
     }
@@ -273,7 +273,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
@@ -288,7 +288,7 @@ public function testGetDropdownsWithMultipleItems()
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
 
         $this->assertCount(1, $menu->getDropdowns());
 
@@ -308,7 +308,7 @@ public function testGetDropdownsWithMultipleDropdowns()
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
         Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
 
         $this->assertCount(2, $menu->getDropdowns());
 
@@ -328,7 +328,7 @@ public function testGetDropdownsThrowsExceptionWhenDisabled()
         $this->expectException(BadMethodCallException::class);
         $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $menu->getDropdowns();
     }
 
@@ -338,7 +338,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
         Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
 
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
@@ -351,7 +351,7 @@ public function testBlogPostsDoNotGetAddedToDropdowns()
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());
         Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
     }
@@ -382,7 +382,7 @@ public function testDropdownMenuItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createNewMainNavigationMenu();
         $dropdowns = $menu->getDropdowns();
 
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());

From 1df963693c345d4b095c42f0eca67bc96c874292 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 15:51:54 +0100
Subject: [PATCH 0188/4023] Deprecate dropdown accessors in new class

---
 .../Features/Navigation/NavigationMenu.php          | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 983404b9616..3d2538f4877 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -25,12 +25,23 @@ public function getItems(): Collection
         return $this->items;
     }
 
+    /**
+     * @experimental These do not seem to be used outside of tests and may be removed
+     *
+     * @deprecated If kept, they should be renamed to be more generic.
+     */
     public function hasDropdowns(): bool
     {
         return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
     }
 
-    /** @return array<string, DropdownNavItem> */
+    /**
+     * @experimental These do not seem to be used outside of tests and may be removed
+     *
+     * @deprecated If kept, they should be renamed to be more generic.
+     *
+     * @return array<string, DropdownNavItem>
+     */
     public function getDropdowns(): array
     {
         if (! $this->dropdownsEnabled()) {

From 323dcce9488639b92e4993ced5a47b5706d56f4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:32:42 +0100
Subject: [PATCH 0189/4023] Begin testing against new class

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 485c97e2026..d41f4e28ef9 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -28,17 +28,17 @@ class NavigationMenuTest extends TestCase
 {
     public function testConstructor()
     {
-        $this->assertInstanceOf(MainNavigationMenu::class, $this->createMainNavigationMenu());
+        $this->assertInstanceOf(NavigationMenu::class, $this->createNewMainNavigationMenu());
     }
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
-        $this->assertInstanceOf(Collection::class, $this->createMainNavigationMenu()->getItems());
+        $this->assertInstanceOf(Collection::class, $this->createNewMainNavigationMenu()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals($this->createMainNavigationMenu()->getItems(), $this->createMainNavigationMenu()->getItems());
+        $this->assertEquals($this->createNewMainNavigationMenu()->getItems(), $this->createNewMainNavigationMenu()->getItems());
     }
 
     public function testItemsAreSortedByPriority()

From 6915770b395ac27097161b85d9fab107d145416c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:33:13 +0100
Subject: [PATCH 0190/4023] Invert testing helper method names

---
 .../tests/Feature/NavigationMenuTest.php      | 62 +++++++++----------
 1 file changed, 31 insertions(+), 31 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index d41f4e28ef9..9482d6d1c64 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -28,17 +28,17 @@ class NavigationMenuTest extends TestCase
 {
     public function testConstructor()
     {
-        $this->assertInstanceOf(NavigationMenu::class, $this->createNewMainNavigationMenu());
+        $this->assertInstanceOf(NavigationMenu::class, $this->createNavigationMenu());
     }
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
-        $this->assertInstanceOf(Collection::class, $this->createNewMainNavigationMenu()->getItems());
+        $this->assertInstanceOf(Collection::class, $this->createNavigationMenu()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals($this->createNewMainNavigationMenu()->getItems(), $this->createNewMainNavigationMenu()->getItems());
+        $this->assertEquals($this->createNavigationMenu()->getItems(), $this->createNavigationMenu()->getItems());
     }
 
     public function testItemsAreSortedByPriority()
@@ -47,7 +47,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createMainNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createLegacyMainNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -55,7 +55,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], $this->createMainNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], $this->createLegacyMainNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -63,7 +63,7 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $this->file('_pages/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -79,7 +79,7 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
     {
         $this->file('_pages/foo.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -92,14 +92,14 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
 
     public function testCollectionOnlyContainsNavItems()
     {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createMainNavigationMenu()->getItems());
+        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createLegacyMainNavigationMenu()->getItems());
     }
 
     public function testExternalLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -114,7 +114,7 @@ public function testPathLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -132,7 +132,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
             NavItem::forLink('foo', 'foo'),
         ]]);
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -150,7 +150,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
             NavItem::forLink('bar', 'foo'),
         ]]);
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -167,7 +167,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
 
         config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -183,7 +183,7 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $this->file('_docs/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -199,7 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
         $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -212,7 +212,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute(Routes::get('foo/bar')),
@@ -228,7 +228,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             DropdownNavItem::fromArray('foo', [
@@ -243,7 +243,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
     }
 
@@ -251,20 +251,20 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $this->assertTrue($menu->hasDropdowns());
     }
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse($this->createNewMainNavigationMenu()->hasDropdowns());
+        $this->assertFalse($this->createNavigationMenu()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
     }
@@ -273,7 +273,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
@@ -288,7 +288,7 @@ public function testGetDropdownsWithMultipleItems()
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $this->assertCount(1, $menu->getDropdowns());
 
@@ -308,7 +308,7 @@ public function testGetDropdownsWithMultipleDropdowns()
         Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
         Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
 
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $this->assertCount(2, $menu->getDropdowns());
 
@@ -328,7 +328,7 @@ public function testGetDropdownsThrowsExceptionWhenDisabled()
         $this->expectException(BadMethodCallException::class);
         $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
 
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $menu->getDropdowns();
     }
 
@@ -338,7 +338,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
         Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
@@ -351,7 +351,7 @@ public function testBlogPostsDoNotGetAddedToDropdowns()
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());
         Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
 
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
         $this->assertCount(0, $menu->getDropdowns());
     }
@@ -362,7 +362,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
-        $menu = $this->createMainNavigationMenu();
+        $menu = $this->createLegacyMainNavigationMenu();
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
@@ -382,19 +382,19 @@ public function testDropdownMenuItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
 
-        $menu = $this->createNewMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $dropdowns = $menu->getDropdowns();
 
         $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
     }
 
-    protected function createNewMainNavigationMenu(): NavigationMenu
+    protected function createNavigationMenu(): NavigationMenu
     {
         return GeneratesMainNavigationMenu::handle();
     }
 
     /** @deprecated */
-    protected function createMainNavigationMenu(): MainNavigationMenu
+    protected function createLegacyMainNavigationMenu(): MainNavigationMenu
     {
         return MainNavigationMenu::create();
     }

From 483284c7becc12a57e76e3f308e144a03e41485a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:36:29 +0100
Subject: [PATCH 0191/4023] Update tests to have more helpful assertions

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 9482d6d1c64..d87b89ef843 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -34,11 +34,14 @@ public function testConstructor()
     public function testGenerateMethodCreatesCollectionOfNavItems()
     {
         $this->assertInstanceOf(Collection::class, $this->createNavigationMenu()->getItems());
+        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createNavigationMenu()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $this->assertEquals($this->createNavigationMenu()->getItems(), $this->createNavigationMenu()->getItems());
+        $this->assertEquals(collect([
+            NavItem::fromRoute(Routes::get('index')),
+        ]), $this->createNavigationMenu()->getItems());
     }
 
     public function testItemsAreSortedByPriority()

From 0eb760ed80f45787caa1d6736ed0321f476408e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:47:19 +0100
Subject: [PATCH 0192/4023] Remove duplicate test

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index d87b89ef843..a1e0e992f84 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -93,11 +93,6 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
         $this->assertEquals($expected, $menu->getItems());
     }
 
-    public function testCollectionOnlyContainsNavItems()
-    {
-        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createLegacyMainNavigationMenu()->getItems());
-    }
-
     public function testExternalLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);

From 7ef717531970738e1a327f726f8f22bd846a9e5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:48:05 +0100
Subject: [PATCH 0193/4023] Move over to test new class

---
 .../tests/Feature/NavigationMenuTest.php      | 34 ++++++++-----------
 1 file changed, 14 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index a1e0e992f84..072a65eac6e 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -50,7 +50,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createLegacyMainNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -58,7 +58,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], $this->createLegacyMainNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], $this->createNavigationMenu()->getItems()->pluck('label')->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -66,7 +66,7 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $this->file('_pages/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -82,7 +82,7 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
     {
         $this->file('_pages/foo.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -97,7 +97,7 @@ public function testExternalLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -112,7 +112,7 @@ public function testPathLinkCanBeAddedInConfig()
     {
         config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -130,7 +130,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
             NavItem::forLink('foo', 'foo'),
         ]]);
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -148,7 +148,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
             NavItem::forLink('bar', 'foo'),
         ]]);
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -165,7 +165,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
 
         config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -181,7 +181,7 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $this->file('_docs/foo.md');
         $this->file('_docs/index.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
@@ -197,7 +197,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -210,7 +210,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute(Routes::get('foo/bar')),
@@ -226,7 +226,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             DropdownNavItem::fromArray('foo', [
@@ -360,7 +360,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
-        $menu = $this->createLegacyMainNavigationMenu();
+        $menu = $this->createNavigationMenu();
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
@@ -390,10 +390,4 @@ protected function createNavigationMenu(): NavigationMenu
     {
         return GeneratesMainNavigationMenu::handle();
     }
-
-    /** @deprecated */
-    protected function createLegacyMainNavigationMenu(): MainNavigationMenu
-    {
-        return MainNavigationMenu::create();
-    }
 }

From 78d646972417a5f3fc832f4ba4bc02f9e2b9e2a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:48:14 +0100
Subject: [PATCH 0194/4023] Remove unused import

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 072a65eac6e..b722161f4d6 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -9,7 +9,6 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\MarkdownPage;

From d133dd62130ce5e5c1baed4b0035563a5701c99a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:51:35 +0100
Subject: [PATCH 0195/4023] Breaking: Remove class `MainNavigationMenu`

---
 .../Features/Navigation/MainNavigationMenu.php    | 15 ---------------
 .../tests/Feature/NavigationMenuTest.php          |  1 -
 2 files changed, 16 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
deleted file mode 100644
index bb046359779..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ /dev/null
@@ -1,15 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/** @deprecated Use the new NavigationMenu class instead */
-class MainNavigationMenu extends BaseNavigationMenu
-{
-    /** @deprecated Temporary method for refactor */
-    public static function create(): static
-    {
-        return new static(GeneratesMainNavigationMenu::handle()->getItems());
-    }
-}
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index b722161f4d6..6aed9038c02 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -19,7 +19,6 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  */

From d2660f2b9aa7b8cf491e8e27dbed31f9783444f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:51:51 +0100
Subject: [PATCH 0196/4023] Mark code that must be adapted before merge

---
 docs/digging-deeper/navigation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 10d3ba73c90..eda34de5fea 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -300,6 +300,8 @@ The main navigation menu is the `MainNavigationMenu` class, and the documentatio
 Both extend the same `BaseNavigationMenu` class:
 
 ```php
+// TODO: Update these examples
+
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\BaseNavigationMenu;

From 98854e30a704751f55b264572badc6dc540998f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:54:00 +0100
Subject: [PATCH 0197/4023] Update test to use the new logic location

---
 .../framework/tests/Unit/Views/NavigationBrandViewTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
index b34478273d6..f47b998ac37 100644
--- a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -22,7 +22,7 @@ protected function setUp(): void
     protected function render(): string
     {
         return view('hyde::components.navigation.navigation-brand', [
-            'navigation' => MainNavigationMenu::create(),
+            'navigation' => GeneratesMainNavigationMenu::handle(),
         ])->render();
     }
 

From e89e44a057ade7a07e0f75d1e9f69913c8c040a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:55:28 +0100
Subject: [PATCH 0198/4023] Simplify test data setup

---
 .../framework/tests/Unit/Views/NavigationBrandViewTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
index f47b998ac37..47fe6c7c640 100644
--- a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
-use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -22,7 +22,7 @@ protected function setUp(): void
     protected function render(): string
     {
         return view('hyde::components.navigation.navigation-brand', [
-            'navigation' => GeneratesMainNavigationMenu::handle(),
+            'navigation' => new NavigationMenu(),
         ])->render();
     }
 

From f054e91dd339a18998a44b7d9a35502720b3c8c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 16:58:41 +0100
Subject: [PATCH 0199/4023] Inline parent methods to only child

---
 .../Features/Navigation/BaseNavigationMenu.php  | 17 +----------------
 .../Navigation/DocumentationSidebar.php         | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
index 950eb034e31..36449e0b8db 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
@@ -4,23 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Illuminate\Support\Collection;
-use Illuminate\Contracts\Support\Arrayable;
-
 /** @deprecated Use the new NavigationMenu class instead */
 abstract class BaseNavigationMenu
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
-    protected Collection $items;
-
-    public function __construct(Arrayable|array $items = [])
-    {
-        $this->items = new Collection($items);
-    }
-
-    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
-    public function getItems(): Collection
-    {
-        return $this->items->values();
-    }
+    //
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 13f3d340817..d1d52cc5e67 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -12,12 +12,27 @@
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
+use Illuminate\Contracts\Support\Arrayable;
 
 use function collect;
 
 /** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends BaseNavigationMenu
 {
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    protected Collection $items;
+
+    public function __construct(Arrayable|array $items = [])
+    {
+        $this->items = new Collection($items);
+    }
+
+    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
+    public function getItems(): Collection
+    {
+        return $this->items->values();
+    }
+
     /** @deprecated Will be moved to an action */
     public static function create(): static
     {

From 12ff4cebceb24924dee33bfe14cf9fef14f40f02 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:03:53 +0100
Subject: [PATCH 0200/4023] DocumentationSidebar no longer extends
 BaseNavigationMenu

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d1d52cc5e67..790ac82e595 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -17,7 +17,7 @@
 use function collect;
 
 /** @deprecated Use the new NavigationMenu class instead */
-class DocumentationSidebar extends BaseNavigationMenu
+class DocumentationSidebar
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;

From bcf8ffb2d3d770c86fa652d30acf67699d6e9e66 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:04:17 +0100
Subject: [PATCH 0201/4023] Remove BaseNavigationMenu coverage annotation

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 6aed9038c02..1b5ee518592 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -19,7 +19,6 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\BaseNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  */
 class NavigationMenuTest extends TestCase

From 4065016d90c7e56382afe16bf8ded83d1cd08795 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:05:02 +0100
Subject: [PATCH 0202/4023] Breaking: Remove class `BaseNavigationMenu`

---
 .../Features/Navigation/BaseNavigationMenu.php        | 11 -----------
 1 file changed, 11 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
deleted file mode 100644
index 36449e0b8db..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/BaseNavigationMenu.php
+++ /dev/null
@@ -1,11 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/** @deprecated Use the new NavigationMenu class instead */
-abstract class BaseNavigationMenu
-{
-    //
-}

From ae1b24d8449bb9c01e03596f07ce8cead0c573f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:14:26 +0100
Subject: [PATCH 0203/4023] Add additional unit tests

---
 packages/framework/tests/Unit/NavItemTest.php | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index b7ccacf3622..47227d4d8c3 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -47,6 +47,28 @@ public function testConstruct()
         $this->assertSame($route, $item->destination);
     }
 
+    public function testPassingRouteInstanceToConstructorUsesRouteInstance()
+    {
+        $route = new Route(new MarkdownPage());
+        $this->assertSame($route, (new NavItem($route, 'Home'))->destination);
+    }
+
+    public function testPassingUrlToConstructorUsesExternalRoute()
+    {
+        $item = new NavItem('https://example.com', 'Home');
+        $this->assertInstanceOf(ExternalRoute::class, $item->destination);
+        $this->assertEquals(new ExternalRoute('https://example.com'), $item->destination);
+        $this->assertSame('https://example.com', (string) $item->destination);
+    }
+
+    public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
+    {
+        $item = new NavItem('foo', 'Home');
+        $this->assertInstanceOf(ExternalRoute::class, $item->destination);
+        $this->assertEquals(new ExternalRoute('foo'), $item->destination);
+        $this->assertSame('foo', (string) $item->destination);
+    }
+
     public function testGetDestination()
     {
         $route = new Route(new InMemoryPage('foo'));

From 18d2bdf05a9ba9fae2b60b672b25ce4ad7e166db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:14:46 +0100
Subject: [PATCH 0204/4023] Update NavItem constructor to resolve existing
 routes by key

---
 .../src/Framework/Features/Navigation/NavItem.php          | 2 +-
 packages/framework/tests/Unit/NavItemTest.php              | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d5e09b898f3..19b4172afe1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -32,7 +32,7 @@ class NavItem implements Stringable
     public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null)
     {
         if (is_string($destination)) {
-            $destination = new ExternalRoute($destination);
+            $destination = Routes::get($destination) ?? new ExternalRoute($destination);
         }
 
         $this->destination = $destination;
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 47227d4d8c3..9c7d5b2b2b0 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -53,6 +53,13 @@ public function testPassingRouteInstanceToConstructorUsesRouteInstance()
         $this->assertSame($route, (new NavItem($route, 'Home'))->destination);
     }
 
+    public function testPassingRouteKeyToConstructorUsesRouteInstance()
+    {
+        $route = Routes::get('index');
+
+        $this->assertSame($route, (new NavItem('index', 'Home'))->destination);
+    }
+
     public function testPassingUrlToConstructorUsesExternalRoute()
     {
         $item = new NavItem('https://example.com', 'Home');

From 9716f2cc3e00a67245d458e0a0f1cb38740c3f2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 17:28:12 +0100
Subject: [PATCH 0205/4023] Deprecate class `DropdownNavItem`

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index aef24a99973..3a8aa3f0a50 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -12,6 +12,8 @@
 /**
  * A navigation item that contains other navigation items.
  *
+ * @deprecated Use the `NavItem::getChildren()` instead.
+ *
  * Unlike a regular navigation items, a dropdown item does not have a route or URL destination.
  */
 class DropdownNavItem extends NavItem

From 68c3b7f6f522a5f20ff7f8ef17907900618b6e34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:12:09 +0100
Subject: [PATCH 0206/4023] Add new `$children` array to `NavItem` class

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 19b4172afe1..0959a516a49 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -26,6 +26,9 @@ class NavItem implements Stringable
     public readonly int $priority;
     public readonly ?string $group;
 
+    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
+    public readonly array $children;
+
     /**
      * Create a new navigation menu item.
      */

From 55d4745932240eac90241a5c3c3969901b46726a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:13:27 +0100
Subject: [PATCH 0207/4023] Add children array to constructor

---
 .../src/Framework/Features/Navigation/NavItem.php     |  3 ++-
 packages/framework/tests/Unit/NavItemTest.php         | 11 +++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0959a516a49..61a14cf3ba9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -32,7 +32,7 @@ class NavItem implements Stringable
     /**
      * Create a new navigation menu item.
      */
-    public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null)
+    public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null, array $children = [])
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);
@@ -42,6 +42,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = $group;
+        $this->children = $children;
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 9c7d5b2b2b0..bd4702f7676 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -76,6 +76,17 @@ public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
         $this->assertSame('foo', (string) $item->destination);
     }
 
+    public function testCanConstructWithChildren()
+    {
+        $route = new Route(new MarkdownPage());
+        $item = new NavItem($route, 'Test', 500, null, [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ]);
+
+        $this->assertCount(2, $item->children);
+    }
+
     public function testGetDestination()
     {
         $route = new Route(new InMemoryPage('foo'));

From 1a9fc5229b75c767f65967d4c06ff4330ab63278 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:14:53 +0100
Subject: [PATCH 0208/4023] Add child getter

---
 .../Framework/Features/Navigation/NavItem.php   | 12 ++++++++++++
 packages/framework/tests/Unit/NavItemTest.php   | 17 +++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 61a14cf3ba9..8aed5f37ed8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -137,6 +137,18 @@ public function isCurrent(): bool
         return Hyde::currentRoute()->getLink() === (string) $this->destination;
     }
 
+    /**
+     * Get the children of the navigation item.
+     *
+     * For the main navigation menu, this stores any dropdown items.
+     *
+     * @return array<\Hyde\Framework\Features\Navigation\NavItem>
+     */
+    public function getChildren(): array
+    {
+        return $this->children;
+    }
+
     protected static function getRouteGroup(Route $route): ?string
     {
         /** @var string|null $group */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index bd4702f7676..d1aeb3eced7 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -119,6 +119,23 @@ public function testGetGroup()
         $this->assertNull($navItem->getGroup());
     }
 
+    public function testGetChildren()
+    {
+        $children = [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ];
+
+        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500, null, $children);
+        $this->assertSame($children, $navItem->getChildren());
+    }
+
+    public function testGetChildrenWithNoChildren()
+    {
+        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertEmpty($navItem->getChildren());
+    }
+
     public function testFromRoute()
     {
         $route = new Route(new MarkdownPage());

From 5374dc07f5a0194f731f4fae176a8766b3e73146 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:27:47 +0100
Subject: [PATCH 0209/4023] Add new Navigation API section

---
 docs/digging-deeper/navigation.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index eda34de5fea..4ead086dd8c 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -319,3 +319,9 @@ Dropdowns are represented by `DropdownNavItem` instances, which extend the `NavI
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
 ```
+
+## The Navigation API
+
+If you want to interact with the site navigation programmatically, you can do so through the new Navigation API.
+
+For most cases you don't need this, as Hyde creates the navigation for you. But it can be useful for advanced users and package developers.

From 98e10b65a5d0f646715a4c6fbffe9b4c36fbdd0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:33:01 +0100
Subject: [PATCH 0210/4023] Add prefixes to test method names

---
 .../framework/tests/Unit/DropdownNavItemTest.php   | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/DropdownNavItemTest.php b/packages/framework/tests/Unit/DropdownNavItemTest.php
index 884045acb46..e5d1eaf1cc0 100644
--- a/packages/framework/tests/Unit/DropdownNavItemTest.php
+++ b/packages/framework/tests/Unit/DropdownNavItemTest.php
@@ -32,7 +32,7 @@ public static function tearDownAfterClass(): void
         Render::swap(new RenderData());
     }
 
-    public function testConstruct()
+    public function testDropdownConstruct()
     {
         $item = new DropdownNavItem('foo', []);
 
@@ -41,21 +41,21 @@ public function testConstruct()
         $this->assertSame(999, $item->priority);
     }
 
-    public function testConstructWithCustomPriority()
+    public function testDropdownConstructWithCustomPriority()
     {
         $item = new DropdownNavItem('foo', [], 500);
 
         $this->assertSame(500, $item->priority);
     }
 
-    public function testConstructWithNullPriority()
+    public function testDropdownConstructWithNullPriority()
     {
         $item = new DropdownNavItem('foo', [], null);
 
         $this->assertSame(999, $item->priority);
     }
 
-    public function testFromArray()
+    public function testDropdownFromArray()
     {
         $item = DropdownNavItem::fromArray('foo', []);
 
@@ -63,7 +63,7 @@ public function testFromArray()
         $this->assertSame([], $item->items);
     }
 
-    public function testWithChildren()
+    public function testDropdownWithChildren()
     {
         $children = [
             new NavItem(new Route(new MarkdownPage()), 'bar'),
@@ -76,7 +76,7 @@ public function testWithChildren()
         $this->assertSame($children, $item->items);
     }
 
-    public function testGetItems()
+    public function testDropdownGetItems()
     {
         $children = [
             new NavItem(new Route(new MarkdownPage()), 'bar'),
@@ -89,7 +89,7 @@ public function testGetItems()
         $this->assertSame($children, $item->getItems()->all());
     }
 
-    public function testCanSetPriorityInConfig()
+    public function testCanSetDropdownPriorityInConfig()
     {
         $root = Config::getFacadeRoot();
         $mock = clone $root;

From 7ad9e4913fd1ed074c4ae0efc4fac29e41b21e50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:36:55 +0100
Subject: [PATCH 0211/4023] Copy legacy config resolver to new class

---
 .../src/Framework/Features/Navigation/NavItem.php    | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8aed5f37ed8..6ac062d6721 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -161,4 +161,16 @@ protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
+
+    protected function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
+    {
+        /** @var array<string, int> $config */
+        $config = Config::getArray('hyde.navigation.order', [
+            'index' => 0,
+            'posts' => 10,
+            'docs/index' => 100,
+        ]);
+
+        return $config[$groupKey] ?? null;
+    }
 }

From 43e8d5ea5e199b2249adb7dd19efb688d8add15f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:38:28 +0100
Subject: [PATCH 0212/4023] Import namespace

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6ac062d6721..2084d91bfe8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;

From 82ee80d61c086c2ef09c95a09a3c8e2d992ed29a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:40:01 +0100
Subject: [PATCH 0213/4023] Remove child method inherited by parent

---
 .../Features/Navigation/DropdownNavItem.php         | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 3a8aa3f0a50..a5e55fffd6b 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
 
 use function collect;
@@ -39,16 +38,4 @@ public function getItems(): Collection
     {
         return collect($this->items);
     }
-
-    private function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
-    {
-        /** @var array<string, int> $config */
-        $config = Config::getArray('hyde.navigation.order', [
-            'index' => 0,
-            'posts' => 10,
-            'docs/index' => 100,
-        ]);
-
-        return $config[$groupKey] ?? null;
-    }
 }

From 229adab2a1d53c64a4973fdfa2558f81c769f414 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:46:29 +0100
Subject: [PATCH 0214/4023] Make helper static

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php       | 2 +-
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index a5e55fffd6b..b3119bb0827 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -23,7 +23,7 @@ class DropdownNavItem extends NavItem
     /** @param array<NavItem> $items */
     public function __construct(string $label, array $items, ?int $priority = null)
     {
-        parent::__construct('', $label, $priority ?? $this->searchForDropdownPriorityInNavigationConfig($label) ?? 999);
+        parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999);
         $this->items = $items;
     }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 2084d91bfe8..663954b5ef6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -163,7 +163,7 @@ protected static function normalizeGroupKey(?string $group): ?string
         return $group ? Str::slug($group) : null;
     }
 
-    protected function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
+    protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
         /** @var array<string, int> $config */
         $config = Config::getArray('hyde.navigation.order', [

From 47f1b9b49c6f7d447d2f206602bbde139c84af30 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:46:34 +0100
Subject: [PATCH 0215/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 663954b5ef6..dfe6e0a8a91 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -15,6 +15,8 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
+ * @todo Consider splitting facade methods to actual facade class.
+ *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route

From a90d49c75da01b13f3d7a68e4cbcce4b1885e047 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 18:52:55 +0100
Subject: [PATCH 0216/4023] Add a `NavItem::dropdown()` facade helper

---
 .../Framework/Features/Navigation/NavItem.php | 12 +++++++++
 packages/framework/tests/Unit/NavItemTest.php | 27 +++++++++++++++++++
 2 files changed, 39 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index dfe6e0a8a91..4f5f6fdbde0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -82,6 +82,18 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
         return static::fromRoute($route instanceof Route ? $route : Routes::getOrFail($route), $label, $priority, $group);
     }
 
+    /**
+     * Create a new dropdown navigation menu item.
+     *
+     * @param  string  $label  The label of the dropdown item.
+     * @param  array<NavItem>  $items  The items to be included in the dropdown.
+     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority.
+     */
+    public static function dropdown(string $label, array $items, ?int $priority = null): static
+    {
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
+    }
+
     /**
      * Resolve a link to the navigation item.
      */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index d1aeb3eced7..e7b68398824 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -231,6 +231,33 @@ public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
         $this->assertSame('../../foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
     }
 
+    public function testDropdownFacade()
+    {
+        $item = NavItem::dropdown('foo', []);
+
+        $this->assertSame('foo', $item->label);
+        $this->assertSame([], $item->getChildren());
+        $this->assertSame(999, $item->priority);
+    }
+
+    public function testDropdownFacadeWithChildren()
+    {
+        $children = [
+            new NavItem(new Route(new MarkdownPage()), 'bar'),
+        ];
+
+        $item = NavItem::dropdown('foo', $children);
+        $this->assertSame($children, $item->getChildren());
+        $this->assertSame(999, $item->priority);
+    }
+
+    public function testDropdownFacadeWithCustomPriority()
+    {
+        $item = NavItem::dropdown('foo', [], 500);
+
+        $this->assertSame(500, $item->priority);
+    }
+
     public function testIsCurrent()
     {
         Render::swap(Mockery::mock(RenderData::class, [

From 8068a2c0951e8813ae026c62c7e150bb4da3063e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:05:26 +0100
Subject: [PATCH 0217/4023] Merge legacy tests into new class

---
 .../tests/Unit/DropdownNavItemTest.php        | 92 +------------------
 packages/framework/tests/Unit/NavItemTest.php | 34 ++++++-
 2 files changed, 33 insertions(+), 93 deletions(-)

diff --git a/packages/framework/tests/Unit/DropdownNavItemTest.php b/packages/framework/tests/Unit/DropdownNavItemTest.php
index e5d1eaf1cc0..66b046c3008 100644
--- a/packages/framework/tests/Unit/DropdownNavItemTest.php
+++ b/packages/framework/tests/Unit/DropdownNavItemTest.php
@@ -4,13 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Facades\Config;
-use Hyde\Framework\Features\Navigation\DropdownNavItem;
-use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Pages\MarkdownPage;
-use Hyde\Support\Facades\Render;
-use Hyde\Support\Models\RenderData;
-use Hyde\Support\Models\Route;
 use Hyde\Testing\UnitTestCase;
 
 /**
@@ -18,88 +11,5 @@
  */
 class DropdownNavItemTest extends UnitTestCase
 {
-    protected static bool $needsKernel = true;
-    protected static bool $needsConfig = true;
-
-    public static function setUpBeforeClass(): void
-    {
-        parent::setUpBeforeClass();
-        Render::swap(new RenderData());
-    }
-
-    public static function tearDownAfterClass(): void
-    {
-        Render::swap(new RenderData());
-    }
-
-    public function testDropdownConstruct()
-    {
-        $item = new DropdownNavItem('foo', []);
-
-        $this->assertSame('foo', $item->label);
-        $this->assertSame([], $item->items);
-        $this->assertSame(999, $item->priority);
-    }
-
-    public function testDropdownConstructWithCustomPriority()
-    {
-        $item = new DropdownNavItem('foo', [], 500);
-
-        $this->assertSame(500, $item->priority);
-    }
-
-    public function testDropdownConstructWithNullPriority()
-    {
-        $item = new DropdownNavItem('foo', [], null);
-
-        $this->assertSame(999, $item->priority);
-    }
-
-    public function testDropdownFromArray()
-    {
-        $item = DropdownNavItem::fromArray('foo', []);
-
-        $this->assertSame('foo', $item->label);
-        $this->assertSame([], $item->items);
-    }
-
-    public function testDropdownWithChildren()
-    {
-        $children = [
-            new NavItem(new Route(new MarkdownPage()), 'bar'),
-        ];
-
-        $item = new DropdownNavItem('foo', $children);
-        $this->assertSame($children, $item->items);
-
-        $item = DropdownNavItem::fromArray('foo', $children);
-        $this->assertSame($children, $item->items);
-    }
-
-    public function testDropdownGetItems()
-    {
-        $children = [
-            new NavItem(new Route(new MarkdownPage()), 'bar'),
-        ];
-
-        $item = new DropdownNavItem('foo', $children);
-        $this->assertSame($children, $item->getItems()->all());
-
-        $item = DropdownNavItem::fromArray('foo', $children);
-        $this->assertSame($children, $item->getItems()->all());
-    }
-
-    public function testCanSetDropdownPriorityInConfig()
-    {
-        $root = Config::getFacadeRoot();
-        $mock = clone $root;
-        Config::swap($mock);
-
-        Config::set('hyde.navigation.order.foo', 500);
-        $item = new DropdownNavItem('foo', []);
-
-        $this->assertSame(500, $item->priority);
-
-        Config::swap($root);
-    }
+    //
 }
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index e7b68398824..50627013951 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -79,12 +79,42 @@ public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     public function testCanConstructWithChildren()
     {
         $route = new Route(new MarkdownPage());
-        $item = new NavItem($route, 'Test', 500, null, [
+        $children = [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ];
+        $item = new NavItem($route, 'Test', 500, null, $children);
+
+        $this->assertSame('Test', $item->label);
+        $this->assertSame($route, $item->destination);
+        $this->assertSame(500, $item->priority);
+
+        $this->assertCount(2, $item->children);
+        $this->assertSame($children, $item->children);
+
+        $this->assertSame('Foo', $item->children[0]->label);
+        $this->assertSame('Bar', $item->children[1]->label);
+
+        $this->assertSame('foo.html', $item->children[0]->getLink());
+        $this->assertSame('bar.html', $item->children[1]->getLink());
+
+        $this->assertSame(500, $item->children[0]->priority);
+        $this->assertSame(500, $item->children[1]->priority);
+    }
+
+    public function testCanConstructWithChildrenWithoutRoute()
+    {
+        $children = [
             new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
             new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ]);
+        ];
+        $item = new NavItem('', 'Test', 500, null, $children);
+
+        $this->assertSame('Test', $item->label);
+        $this->assertSame('', $item->destination->getLink());
 
         $this->assertCount(2, $item->children);
+        $this->assertSame($children, $item->children);
     }
 
     public function testGetDestination()

From 920868f1b1c0faa1ca3b7630b976d542b525203c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:20:05 +0100
Subject: [PATCH 0218/4023] Delete DropdownNavItemTest.php

---
 .../framework/tests/Unit/DropdownNavItemTest.php  | 15 ---------------
 1 file changed, 15 deletions(-)
 delete mode 100644 packages/framework/tests/Unit/DropdownNavItemTest.php

diff --git a/packages/framework/tests/Unit/DropdownNavItemTest.php b/packages/framework/tests/Unit/DropdownNavItemTest.php
deleted file mode 100644
index 66b046c3008..00000000000
--- a/packages/framework/tests/Unit/DropdownNavItemTest.php
+++ /dev/null
@@ -1,15 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Testing\UnitTestCase;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\DropdownNavItem
- */
-class DropdownNavItemTest extends UnitTestCase
-{
-    //
-}

From c1848d2556866bc0de0a380c4c70fc1b241118fa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:25:37 +0100
Subject: [PATCH 0219/4023] Inline fromArray method to simplify impending class
 removal

---
 .../Features/Navigation/DropdownNavItem.php          |  6 ------
 .../framework/tests/Feature/NavigationMenuTest.php   | 12 ++++++------
 2 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index b3119bb0827..04bf803cdd0 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -27,12 +27,6 @@ public function __construct(string $label, array $items, ?int $priority = null)
         $this->items = $items;
     }
 
-    /** @param array<NavItem> $items */
-    public static function fromArray(string $name, array $items): static
-    {
-        return new static($name, $items);
-    }
-
     /** @return Collection<NavItem> */
     public function getItems(): Collection
     {
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 1b5ee518592..e7b3fc1e454 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -226,7 +226,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
-            DropdownNavItem::fromArray('foo', [
+            new DropdownNavItem('foo', [
                 NavItem::fromRoute(Routes::get('foo/bar')),
             ]),
         ]);
@@ -272,7 +272,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
+            new DropdownNavItem('foo', [
                 NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
             ]), ], $menu->getDropdowns());
     }
@@ -288,7 +288,7 @@ public function testGetDropdownsWithMultipleItems()
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
+            new DropdownNavItem('foo', [
                 NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
                 NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
             ]),
@@ -308,11 +308,11 @@ public function testGetDropdownsWithMultipleDropdowns()
         $this->assertCount(2, $menu->getDropdowns());
 
         $this->assertEquals([
-            DropdownNavItem::fromArray('foo', [
+            new DropdownNavItem('foo', [
                 NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
                 NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
             ]),
-            DropdownNavItem::fromArray('cat', [
+            new DropdownNavItem('cat', [
                 NavItem::fromRoute((new MarkdownPage('cat/hat'))->getRoute()),
             ]),
         ], $menu->getDropdowns());
@@ -363,7 +363,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         $this->assertEquals([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            DropdownNavItem::fromArray('bar', [
+            new DropdownNavItem('bar', [
                 NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());

From 948d64766f58d741aa29f2e67bc3fed376eb1bcb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:42:27 +0100
Subject: [PATCH 0220/4023] Inline getItems method to simplify impending class
 removal

---
 .../Framework/Features/Navigation/DropdownNavItem.php  | 10 ----------
 .../framework/tests/Feature/NavigationMenuTest.php     |  2 +-
 2 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 04bf803cdd0..5aaa80eeed5 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -4,10 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Illuminate\Support\Collection;
-
-use function collect;
-
 /**
  * A navigation item that contains other navigation items.
  *
@@ -26,10 +22,4 @@ public function __construct(string $label, array $items, ?int $priority = null)
         parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999);
         $this->items = $items;
     }
-
-    /** @return Collection<NavItem> */
-    public function getItems(): Collection
-    {
-        return collect($this->items);
-    }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index e7b3fc1e454..75134937f07 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -380,7 +380,7 @@ public function testDropdownMenuItemsAreSortedByPriority()
         $menu = $this->createNavigationMenu();
         $dropdowns = $menu->getDropdowns();
 
-        $this->assertSame(['Foo', 'Bar', 'Baz'], $dropdowns[0]->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Foo', 'Bar', 'Baz'], collect($dropdowns[0]->items)->pluck('label')->toArray());
     }
 
     protected function createNavigationMenu(): NavigationMenu

From 0747f2824f4493b1a92901226481ee7ba302bf3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:49:10 +0100
Subject: [PATCH 0221/4023] Deprecate items array

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 5aaa80eeed5..38fc99d055f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -13,7 +13,7 @@
  */
 class DropdownNavItem extends NavItem
 {
-    /** @var array<NavItem> */
+    /** @deprecated */
     public array $items;
 
     /** @param array<NavItem> $items */

From 74c2d9a806fe407c736c0d2f57eb390ce3e2b530 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:49:27 +0100
Subject: [PATCH 0222/4023] Add temporary compatibility for class being removed

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 38fc99d055f..99620af32e2 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -21,5 +21,6 @@ public function __construct(string $label, array $items, ?int $priority = null)
     {
         parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999);
         $this->items = $items;
+        $this->children = $items;
     }
 }

From 57f0f151b9ccf4be4277ba8b0f9fb5eabf525827 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:49:52 +0100
Subject: [PATCH 0223/4023] Fix readonly assignment

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 99620af32e2..84753e80fa9 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -19,8 +19,7 @@ class DropdownNavItem extends NavItem
     /** @param array<NavItem> $items */
     public function __construct(string $label, array $items, ?int $priority = null)
     {
-        parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999);
+        parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, children: $items);
         $this->items = $items;
-        $this->children = $items;
     }
 }

From cf888d9435cb6d22b7c097179742683ada3ca8b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:56:00 +0100
Subject: [PATCH 0224/4023] Get children instead of deprecated items

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 packages/framework/tests/Feature/NavigationMenuTest.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index ba8c148b583..aabc9e671f0 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -36,7 +36,7 @@
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item instanceof \Hyde\Framework\Features\Navigation\DropdownNavItem)
-                        <x-hyde::navigation.dropdown :label="\Hyde\Hyde::makeTitle($item->label)" :items="$item->items"/>
+                        <x-hyde::navigation.dropdown :label="\Hyde\Hyde::makeTitle($item->label)" :items="$item->getChildren()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')
                     @endif
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 75134937f07..e9c522c0f4f 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -380,7 +380,7 @@ public function testDropdownMenuItemsAreSortedByPriority()
         $menu = $this->createNavigationMenu();
         $dropdowns = $menu->getDropdowns();
 
-        $this->assertSame(['Foo', 'Bar', 'Baz'], collect($dropdowns[0]->items)->pluck('label')->toArray());
+        $this->assertSame(['Foo', 'Bar', 'Baz'], collect($dropdowns[0]->getChildren())->pluck('label')->toArray());
     }
 
     protected function createNavigationMenu(): NavigationMenu

From 04128ab455ea88888cc9aa9bece9e1c2ef82f09e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 19:57:21 +0100
Subject: [PATCH 0225/4023] Remove items array

---
 .../src/Framework/Features/Navigation/DropdownNavItem.php     | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
index 84753e80fa9..d774008d46f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
@@ -13,13 +13,9 @@
  */
 class DropdownNavItem extends NavItem
 {
-    /** @deprecated */
-    public array $items;
-
     /** @param array<NavItem> $items */
     public function __construct(string $label, array $items, ?int $priority = null)
     {
         parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, children: $items);
-        $this->items = $items;
     }
 }

From e093242a243007f841e8271c748b331ad551613e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:05:15 +0100
Subject: [PATCH 0226/4023] Add additional unit test

---
 packages/framework/tests/Unit/NavItemTest.php | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 50627013951..2d3a81ed193 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -298,6 +298,24 @@ public function testIsCurrent()
         $this->assertFalse(NavItem::fromRoute(new Route(new InMemoryPage('bar')))->isCurrent());
     }
 
+    public function testIsCurrentWithExternalRoute()
+    {
+        Render::swap(Mockery::mock(RenderData::class, [
+            'getRoute' => (new Route(new InMemoryPage('foo'))),
+            'getRouteKey' => 'foo',
+        ]));
+        $this->assertFalse(NavItem::forLink('foo', 'bar')->isCurrent());
+        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isCurrent());
+
+        Render::swap(Mockery::mock(RenderData::class, [
+            'getRoute' => new ExternalRoute('foo'),
+            'getRouteKey' => 'foo',
+        ]));
+
+        $this->assertTrue(NavItem::forLink('foo', 'bar')->isCurrent());
+        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isCurrent());
+    }
+
     public function testGetGroupWithNoGroup()
     {
         $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroup());

From d6a031dc84bb134bb1e5be378b990779dfaedf27 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:05:35 +0100
Subject: [PATCH 0227/4023] Remove assertions not reachable by code

This should not be possible by the code itself
---
 packages/framework/tests/Unit/NavItemTest.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 2d3a81ed193..e5860a02726 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -306,14 +306,6 @@ public function testIsCurrentWithExternalRoute()
         ]));
         $this->assertFalse(NavItem::forLink('foo', 'bar')->isCurrent());
         $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isCurrent());
-
-        Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => new ExternalRoute('foo'),
-            'getRouteKey' => 'foo',
-        ]));
-
-        $this->assertTrue(NavItem::forLink('foo', 'bar')->isCurrent());
-        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isCurrent());
     }
 
     public function testGetGroupWithNoGroup()

From 9cb345be077fbfb2421dd67c799b5bd7d787ea70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:05:56 +0100
Subject: [PATCH 0228/4023] Remove unnecessary parentheses in file

---
 packages/framework/tests/Unit/NavItemTest.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index e5860a02726..a91f22f060b 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -237,7 +237,7 @@ public function testForRouteWithCustomPriority()
     public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
     {
         Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => (new Route(new InMemoryPage('foo'))),
+            'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
 
@@ -245,7 +245,7 @@ public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
         $this->assertSame('foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => (new Route(new InMemoryPage('foo/bar'))),
+            'getRoute' => new Route(new InMemoryPage('foo/bar')),
             'getRouteKey' => 'foo/bar',
         ]));
 
@@ -253,7 +253,7 @@ public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
         $this->assertSame('../foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => (new Route(new InMemoryPage('foo/bar/baz'))),
+            'getRoute' => new Route(new InMemoryPage('foo/bar/baz')),
             'getRouteKey' => 'foo/bar/baz',
         ]));
 
@@ -291,7 +291,7 @@ public function testDropdownFacadeWithCustomPriority()
     public function testIsCurrent()
     {
         Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => (new Route(new InMemoryPage('foo'))),
+            'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
         $this->assertTrue(NavItem::fromRoute(new Route(new InMemoryPage('foo')))->isCurrent());
@@ -301,7 +301,7 @@ public function testIsCurrent()
     public function testIsCurrentWithExternalRoute()
     {
         Render::swap(Mockery::mock(RenderData::class, [
-            'getRoute' => (new Route(new InMemoryPage('foo'))),
+            'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
         $this->assertFalse(NavItem::forLink('foo', 'bar')->isCurrent());

From ca831e2303b538f1bb1573cbd3abb6024c738b2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:06:34 +0100
Subject: [PATCH 0229/4023] Move up helper in source

---
 .../Framework/Features/Navigation/NavItem.php    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4f5f6fdbde0..45700426222 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -144,14 +144,6 @@ public function getGroup(): ?string
         return $this->group;
     }
 
-    /**
-     * Check if the NavItem instance is the current page.
-     */
-    public function isCurrent(): bool
-    {
-        return Hyde::currentRoute()->getLink() === (string) $this->destination;
-    }
-
     /**
      * Get the children of the navigation item.
      *
@@ -164,6 +156,14 @@ public function getChildren(): array
         return $this->children;
     }
 
+    /**
+     * Check if the NavItem instance is the current page.
+     */
+    public function isCurrent(): bool
+    {
+        return Hyde::currentRoute()->getLink() === (string) $this->destination;
+    }
+
     protected static function getRouteGroup(Route $route): ?string
     {
         /** @var string|null $group */

From 90b2c44b41141af362afb85190a496956812822f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:08:01 +0100
Subject: [PATCH 0230/4023] Add a `NavItem::hasChildren()` helper

---
 .../src/Framework/Features/Navigation/NavItem.php |  8 ++++++++
 packages/framework/tests/Unit/NavItemTest.php     | 15 +++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 45700426222..562b8b55922 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -156,6 +156,14 @@ public function getChildren(): array
         return $this->children;
     }
 
+    /**
+     * Check if the NavItem instance has children.
+     */
+    public function hasChildren(): bool
+    {
+        return count($this->children) > 0;
+    }
+
     /**
      * Check if the NavItem instance is the current page.
      */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index a91f22f060b..78e3407b0f7 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -288,6 +288,21 @@ public function testDropdownFacadeWithCustomPriority()
         $this->assertSame(500, $item->priority);
     }
 
+    public function testHasChildren()
+    {
+        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500);
+        $this->assertFalse($item->hasChildren());
+    }
+
+    public function testHasChildrenWithChildren()
+    {
+        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, null, [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ]);
+        $this->assertTrue($item->hasChildren());
+    }
+
     public function testIsCurrent()
     {
         Render::swap(Mockery::mock(RenderData::class, [

From 98a3b6c81a7f5f643d0899c084f774b72f88ccee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:09:26 +0100
Subject: [PATCH 0231/4023] Check dropdown state using helper instead of
 instanceof

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index aabc9e671f0..899ccd75f31 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -35,7 +35,7 @@
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
-                    @if($item instanceof \Hyde\Framework\Features\Navigation\DropdownNavItem)
+                    @if($item->hasChildren())
                         <x-hyde::navigation.dropdown :label="\Hyde\Hyde::makeTitle($item->label)" :items="$item->getChildren()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')

From 7f754b5fb96d63bece7b8bb6259ca066800a5d36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:24:35 +0100
Subject: [PATCH 0232/4023] Add todo

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 562b8b55922..8aa758eb100 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -16,6 +16,7 @@
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
  * @todo Consider splitting facade methods to actual facade class.
+ * @todo Consider adding an "identifier" property to make it more visible how items are identified, for example when modifying sidebars in the config.
  *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor

From 6d0603309eb53a2ccfea96ebb4f60b151b0de539 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:32:57 +0100
Subject: [PATCH 0233/4023] No longer throw exception when disabled

Since children can now manually be added we can't throw for this anymore
---
 .../src/Framework/Features/Navigation/NavigationMenu.php | 5 -----
 packages/framework/tests/Feature/NavigationMenuTest.php  | 9 +++------
 2 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 3d2538f4877..6bc0ccfb2f1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use BadMethodCallException;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -44,10 +43,6 @@ public function hasDropdowns(): bool
      */
     public function getDropdowns(): array
     {
-        if (! $this->dropdownsEnabled()) {
-            throw new BadMethodCallException('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
-        }
-
         return $this->items->filter(function (NavItem $item): bool {
             return $item instanceof DropdownNavItem;
         })->values()->all();
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index e9c522c0f4f..50df269e621 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
@@ -318,13 +317,11 @@ public function testGetDropdownsWithMultipleDropdowns()
         ], $menu->getDropdowns());
     }
 
-    public function testGetDropdownsThrowsExceptionWhenDisabled()
+    public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
     {
-        $this->expectException(BadMethodCallException::class);
-        $this->expectExceptionMessage('Dropdowns are not enabled. Enable it by setting `hyde.navigation.subdirectories` to `dropdown`.');
-
         $menu = $this->createNavigationMenu();
-        $menu->getDropdowns();
+        $this->assertCount(0, $menu->getDropdowns());
+        $this->assertSame([], $menu->getDropdowns());
     }
 
     public function testDocumentationPagesDoNotGetAddedToDropdowns()

From 74fbe6b2ab28e9afd166e43398ca6f79331d993c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:44:46 +0100
Subject: [PATCH 0234/4023] Skip tests for deprecated method

Want to see the impact of this
---
 packages/framework/tests/Feature/NavigationMenuTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 50df269e621..29e25ac4add 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -236,6 +236,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
@@ -243,6 +244,7 @@ public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
 
     public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $menu = $this->createNavigationMenu();
@@ -251,6 +253,7 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $this->assertFalse($this->createNavigationMenu()->hasDropdowns());
     }
@@ -326,6 +329,7 @@ public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
 
     public function testDocumentationPagesDoNotGetAddedToDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
@@ -338,6 +342,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
     public function testBlogPostsDoNotGetAddedToDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());

From 72c969ebb57e88cabc9b718fb26fd6fd321b8d93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:48:42 +0100
Subject: [PATCH 0235/4023] Skip tests for deprecated method

Want to see the impact of this
---
 packages/framework/tests/Feature/NavigationMenuTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 29e25ac4add..ff3b1851b35 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -260,6 +260,7 @@ public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
@@ -268,6 +269,7 @@ public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
 
     public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $menu = $this->createNavigationMenu();
@@ -281,6 +283,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
 
     public function testGetDropdownsWithMultipleItems()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
@@ -299,6 +302,7 @@ public function testGetDropdownsWithMultipleItems()
 
     public function testGetDropdownsWithMultipleDropdowns()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
@@ -322,6 +326,7 @@ public function testGetDropdownsWithMultipleDropdowns()
 
     public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
@@ -373,6 +378,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
     public function testDropdownMenuItemsAreSortedByPriority()
     {
+        $this->markTestSkipped('Tested method may be removed.');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));

From b9554d270afd1c906295c2d69f1eb279404d0131 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:49:32 +0100
Subject: [PATCH 0236/4023] Prefix legacy methods

Want to see the impact of this
---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 6bc0ccfb2f1..b172afab164 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -29,7 +29,7 @@ public function getItems(): Collection
      *
      * @deprecated If kept, they should be renamed to be more generic.
      */
-    public function hasDropdowns(): bool
+    public function legacy_hasDropdowns(): bool
     {
         return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
     }
@@ -41,7 +41,7 @@ public function hasDropdowns(): bool
      *
      * @return array<string, DropdownNavItem>
      */
-    public function getDropdowns(): array
+    public function legacy_getDropdowns(): array
     {
         return $this->items->filter(function (NavItem $item): bool {
             return $item instanceof DropdownNavItem;

From 70525cb76fc2a39e3265d877a80af51ec3d4ea48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:50:55 +0100
Subject: [PATCH 0237/4023] Add dropdowns as new implementation type

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 2 +-
 packages/framework/tests/Feature/NavigationMenuTest.php       | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 6ad2aba5717..0131bf34f31 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -72,7 +72,7 @@ protected function moveGroupedItemsIntoDropdowns(): void
 
         foreach ($dropdowns as $group => $items) {
             // Create a new dropdown item containing the buffered items
-            $this->items->add(new DropdownNavItem($group, $items));
+            $this->items->add(NavItem::dropdown($group, $items));
         }
     }
 
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index ff3b1851b35..ffcc289e1d3 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -225,7 +225,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
-            new DropdownNavItem('foo', [
+            NavItem::dropdown('foo', [
                 NavItem::fromRoute(Routes::get('foo/bar')),
             ]),
         ]);
@@ -370,7 +370,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         $this->assertEquals([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            new DropdownNavItem('bar', [
+            NavItem::dropdown('bar', [
                 NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());

From a62664bb30bbec99e29c4c2e71c3203c24743633 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 20:57:23 +0100
Subject: [PATCH 0238/4023] Breaking: Remove class `DropdownNavItem`

---
 .../Features/Navigation/DropdownNavItem.php   | 21 -------------------
 1 file changed, 21 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php

diff --git a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php b/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
deleted file mode 100644
index d774008d46f..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/DropdownNavItem.php
+++ /dev/null
@@ -1,21 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/**
- * A navigation item that contains other navigation items.
- *
- * @deprecated Use the `NavItem::getChildren()` instead.
- *
- * Unlike a regular navigation items, a dropdown item does not have a route or URL destination.
- */
-class DropdownNavItem extends NavItem
-{
-    /** @param array<NavItem> $items */
-    public function __construct(string $label, array $items, ?int $priority = null)
-    {
-        parent::__construct('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, children: $items);
-    }
-}

From 78d7570060718c5bca1428e4464aaf630d66ec6a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:03:32 +0100
Subject: [PATCH 0239/4023] Remove NavigationMenu dropdown accessor methods

These do not seem to be used outside of tests and don't offer anything useful
---
 .../Features/Navigation/NavigationMenu.php    | 30 -------------------
 1 file changed, 30 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index b172afab164..4919ceb1bf1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -23,33 +22,4 @@ public function getItems(): Collection
     {
         return $this->items;
     }
-
-    /**
-     * @experimental These do not seem to be used outside of tests and may be removed
-     *
-     * @deprecated If kept, they should be renamed to be more generic.
-     */
-    public function legacy_hasDropdowns(): bool
-    {
-        return $this->dropdownsEnabled() && count($this->getDropdowns()) >= 1;
-    }
-
-    /**
-     * @experimental These do not seem to be used outside of tests and may be removed
-     *
-     * @deprecated If kept, they should be renamed to be more generic.
-     *
-     * @return array<string, DropdownNavItem>
-     */
-    public function legacy_getDropdowns(): array
-    {
-        return $this->items->filter(function (NavItem $item): bool {
-            return $item instanceof DropdownNavItem;
-        })->values()->all();
-    }
-
-    protected function dropdownsEnabled(): bool
-    {
-        return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
-    }
 }

From f2becade2f9dcba19f06dc9061e43a121967bb83 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:04:24 +0100
Subject: [PATCH 0240/4023] Update test method skip notice for
 https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a

---
 .../framework/tests/Feature/NavigationMenuTest.php     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index ffcc289e1d3..5c8fdcafcbe 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -236,7 +236,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
@@ -244,7 +244,7 @@ public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
 
     public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $menu = $this->createNavigationMenu();
@@ -253,14 +253,14 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
 
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $this->assertFalse($this->createNavigationMenu()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
@@ -378,7 +378,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
     public function testDropdownMenuItemsAreSortedByPriority()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));

From 91e6d6ad43b9d4b4b7664ed22ee648ddfef35e27 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:07:12 +0100
Subject: [PATCH 0241/4023] Formatting

---
 .../framework/tests/Feature/NavigationMenuTest.php    | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 5c8fdcafcbe..64fda5a768a 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -237,6 +237,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
     public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     {
         $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
@@ -245,6 +246,7 @@ public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
     public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     {
         $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $menu = $this->createNavigationMenu();
@@ -254,6 +256,7 @@ public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
     public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     {
         $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
+
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $this->assertFalse($this->createNavigationMenu()->hasDropdowns());
     }
@@ -261,6 +264,7 @@ public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
     public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     {
         $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
@@ -270,6 +274,7 @@ public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
     public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
         $menu = $this->createNavigationMenu();
@@ -284,6 +289,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     public function testGetDropdownsWithMultipleItems()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
@@ -303,6 +309,7 @@ public function testGetDropdownsWithMultipleItems()
     public function testGetDropdownsWithMultipleDropdowns()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
@@ -327,6 +334,7 @@ public function testGetDropdownsWithMultipleDropdowns()
     public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
         $this->assertSame([], $menu->getDropdowns());
@@ -335,6 +343,7 @@ public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
     public function testDocumentationPagesDoNotGetAddedToDropdowns()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new DocumentationPage('foo'))->getRoute());
@@ -348,6 +357,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
     public function testBlogPostsDoNotGetAddedToDropdowns()
     {
         $this->markTestSkipped('Tested method may be removed.');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute((new MarkdownPost('foo'))->getRoute());
@@ -379,6 +389,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
     public function testDropdownMenuItemsAreSortedByPriority()
     {
         $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
+
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));

From 7c8ea3b86464095a594ce3e45c4feaa9e82f2964 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:09:38 +0100
Subject: [PATCH 0242/4023] Create NavigationMenuUnitTest.php

---
 .../tests/Unit/NavigationMenuUnitTest.php       | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 packages/framework/tests/Unit/NavigationMenuUnitTest.php

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
new file mode 100644
index 00000000000..3e22cc5fbf3
--- /dev/null
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ *
+ * @see \Hyde\Framework\Testing\Feature\NavigationMenuTest
+ */
+class NavigationMenuUnitTest extends UnitTestCase
+{
+    //
+}

From bd0381ba6462996b225642a5413379acae4bd3c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:09:44 +0100
Subject: [PATCH 0243/4023] Link to unit test

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 64fda5a768a..6bee9dd592c 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -19,6 +19,8 @@
 /**
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ *
+ * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
  */
 class NavigationMenuTest extends TestCase
 {

From abd5c186d83963d574d4bba869bfb0d0b99efb97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:18:04 +0100
Subject: [PATCH 0244/4023] Test construction

---
 .../tests/Unit/NavigationMenuUnitTest.php     | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 3e22cc5fbf3..d743dc3f151 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
@@ -13,5 +14,24 @@
  */
 class NavigationMenuUnitTest extends UnitTestCase
 {
-    //
+    public function testCanConstruct()
+    {
+        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu());
+    }
+
+    public function testCanConstructWithItemsArray()
+    {
+        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu([
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ]));
+    }
+
+    public function testCanConstructWithItemsArrayable()
+    {
+        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu(collect([
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ])));
+    }
 }

From 336c48df900f9340a66f640dcb6670f977d0b766 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:18:22 +0100
Subject: [PATCH 0245/4023] Test getter

---
 .../tests/Unit/NavigationMenuUnitTest.php     | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index d743dc3f151..c9ad45b2082 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -34,4 +34,25 @@ public function testCanConstructWithItemsArrayable()
             'item2' => 'value2',
         ])));
     }
+
+    public function testGetItemsReturnsCollection()
+    {
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu())->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArray()
+    {
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu([
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ]))->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
+    {
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu(collect([
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ])))->getItems());
+    }
 }

From d7625aee9bcefe4058da12cd89f617ad8643c1c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:18:55 +0100
Subject: [PATCH 0246/4023] Test retrieval

---
 .../tests/Unit/NavigationMenuUnitTest.php     | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index c9ad45b2082..eeb51958740 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -55,4 +55,27 @@ public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
             'item2' => 'value2',
         ])))->getItems());
     }
+
+    public function testGetItemsReturnsItems()
+    {
+        $items = [
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ];
+        $this->assertSame($items, (new NavigationMenu($items))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsItemsWhenSuppliedArrayable()
+    {
+        $items = [
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ];
+        $this->assertSame($items, (new NavigationMenu(collect($items)))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsEmptyArrayWhenNoItems()
+    {
+        $this->assertSame([], (new NavigationMenu())->getItems()->all());
+    }
 }

From a520f06aa43103bd70b3b16370b28ad81a757c93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:19:17 +0100
Subject: [PATCH 0247/4023] Extract testing helper

---
 .../tests/Unit/NavigationMenuUnitTest.php     | 38 +++++++------------
 1 file changed, 14 insertions(+), 24 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index eeb51958740..52f8d444203 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -21,18 +21,12 @@ public function testCanConstruct()
 
     public function testCanConstructWithItemsArray()
     {
-        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu([
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ]));
+        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu($this->getItems()));
     }
 
     public function testCanConstructWithItemsArrayable()
     {
-        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu(collect([
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ])));
+        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu(collect($this->getItems())));
     }
 
     public function testGetItemsReturnsCollection()
@@ -42,35 +36,23 @@ public function testGetItemsReturnsCollection()
 
     public function testGetItemsReturnsCollectionWhenSuppliedArray()
     {
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu([
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ]))->getItems());
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu($this->getItems()))->getItems());
     }
 
     public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
     {
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu(collect([
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ])))->getItems());
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu(collect($this->getItems())))->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
-        $items = [
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ];
+        $items = $this->getItems();
         $this->assertSame($items, (new NavigationMenu($items))->getItems()->all());
     }
 
     public function testGetItemsReturnsItemsWhenSuppliedArrayable()
     {
-        $items = [
-            'item1' => 'value1',
-            'item2' => 'value2',
-        ];
+        $items = $this->getItems();
         $this->assertSame($items, (new NavigationMenu(collect($items)))->getItems()->all());
     }
 
@@ -78,4 +60,12 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     {
         $this->assertSame([], (new NavigationMenu())->getItems()->all());
     }
+
+    protected function getItems(): array
+    {
+        return [
+            'item1' => 'value1',
+            'item2' => 'value2',
+        ];
+    }
 }

From 57b11fb683700bfe50b7e47c556a4fa97c215569 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:19:57 +0100
Subject: [PATCH 0248/4023] Add code spacing

---
 packages/framework/tests/Unit/NavigationMenuUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 52f8d444203..5a0137bdf48 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -47,12 +47,14 @@ public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
     public function testGetItemsReturnsItems()
     {
         $items = $this->getItems();
+
         $this->assertSame($items, (new NavigationMenu($items))->getItems()->all());
     }
 
     public function testGetItemsReturnsItemsWhenSuppliedArrayable()
     {
         $items = $this->getItems();
+
         $this->assertSame($items, (new NavigationMenu(collect($items)))->getItems()->all());
     }
 

From f0396bcb71cb91a4a53b0bc437e71c4ecd7ba335 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:20:03 +0100
Subject: [PATCH 0249/4023] Cleanup code

---
 packages/framework/tests/Unit/NavigationMenuUnitTest.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 5a0137bdf48..a1b7d58c786 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
@@ -31,17 +32,17 @@ public function testCanConstructWithItemsArrayable()
 
     public function testGetItemsReturnsCollection()
     {
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu())->getItems());
+        $this->assertInstanceOf(Collection::class, (new NavigationMenu())->getItems());
     }
 
     public function testGetItemsReturnsCollectionWhenSuppliedArray()
     {
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu($this->getItems()))->getItems());
+        $this->assertInstanceOf(Collection::class, (new NavigationMenu($this->getItems()))->getItems());
     }
 
     public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
     {
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, (new NavigationMenu(collect($this->getItems())))->getItems());
+        $this->assertInstanceOf(Collection::class, (new NavigationMenu(collect($this->getItems())))->getItems());
     }
 
     public function testGetItemsReturnsItems()

From 51f4c64ca57e97d6c2f3ff2134b0ca8051138615 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:24:16 +0100
Subject: [PATCH 0250/4023] Sketch out add method contract

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 4919ceb1bf1..c0174ea2134 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -22,4 +22,9 @@ public function getItems(): Collection
     {
         return $this->items;
     }
+
+    public function add(NavItem $item): void
+    {
+        //
+    }
 }

From 238dac75d43f1192079d826eafb0d7778484bb1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:27:07 +0100
Subject: [PATCH 0251/4023] Add todo concerning priorities

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index c0174ea2134..82aaf2bfc2f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,6 +20,8 @@ public function __construct(Arrayable|array $items = [])
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
+        // TODO: Consider sorting by priority here, as orders may have been changed after adding items
+
         return $this->items;
     }
 

From 5cb76da6e7dc87a8aa22320ce5c868874a48a427 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:29:44 +0100
Subject: [PATCH 0252/4023] Sketch out implementation idea

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 82aaf2bfc2f..cf3fb231968 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -27,6 +27,6 @@ public function getItems(): Collection
 
     public function add(NavItem $item): void
     {
-        //
+        // If item has identifier, put $this->items->put($item->identifier(), $item);
     }
 }

From 2a31157686fb0ff4a73a5090fc25451809cb5ec2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:29:47 +0100
Subject: [PATCH 0253/4023] Revert "Add todo concerning priorities"

This reverts commit 238dac75d43f1192079d826eafb0d7778484bb1d. See https://github.com/hydephp/develop/pull/1568/files#r1490023195
---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index cf3fb231968..0019292c4e4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,8 +20,6 @@ public function __construct(Arrayable|array $items = [])
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
-        // TODO: Consider sorting by priority here, as orders may have been changed after adding items
-
         return $this->items;
     }
 

From ffe7ad81544defc8331603a3b74cb78196714662 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:31:15 +0100
Subject: [PATCH 0254/4023] Push added items directly

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 0019292c4e4..9e4901c484b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -25,6 +25,6 @@ public function getItems(): Collection
 
     public function add(NavItem $item): void
     {
-        // If item has identifier, put $this->items->put($item->identifier(), $item);
+        $this->items->push($item);
     }
 }

From 9330ac7a1c1d98892bb0855bd649875065136d73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:33:22 +0100
Subject: [PATCH 0255/4023] Test the add method

---
 .../framework/tests/Unit/NavigationMenuUnitTest.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index a1b7d58c786..c960b2dce01 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -6,6 +6,8 @@
 
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
+use Hyde\Support\Models\ExternalRoute;
+use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 
 /**
@@ -64,6 +66,17 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
         $this->assertSame([], (new NavigationMenu())->getItems()->all());
     }
 
+    public function testCanAddItems()
+    {
+        $menu = new NavigationMenu();
+        $item = new NavItem(new ExternalRoute('/'), 'Home');
+
+        $menu->add($item);
+
+        $this->assertCount(1, $menu->getItems());
+        $this->assertSame($item, $menu->getItems()->first());
+    }
+
     protected function getItems(): array
     {
         return [

From 95b395ce69a1b3e0e373285adcb64aa0f3cc57d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:37:09 +0100
Subject: [PATCH 0256/4023] Update navigation menu to construct items using add
 method

This adds an implicit type system ensuring the types of the internal array
---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 +++++-
 packages/framework/tests/Unit/NavigationMenuUnitTest.php    | 5 +++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 9e4901c484b..9edc2783dd6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -14,7 +14,11 @@ class NavigationMenu
 
     public function __construct(Arrayable|array $items = [])
     {
-        $this->items = new Collection($items);
+        $this->items = new Collection();
+
+        foreach ($items as $item) {
+            $this->add($item);
+        }
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index c960b2dce01..57ad6222993 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -80,8 +80,9 @@ public function testCanAddItems()
     protected function getItems(): array
     {
         return [
-            'item1' => 'value1',
-            'item2' => 'value2',
+            new NavItem(new ExternalRoute('/'), 'Home'),
+            new NavItem(new ExternalRoute('/about'), 'About'),
+            new NavItem(new ExternalRoute('/contact'), 'Contact'),
         ];
     }
 }

From 088d5b5e6f55d61050890c2cbe4bab312fa62bb6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:38:21 +0100
Subject: [PATCH 0257/4023] Update array generics to match new forced data
 state

Data format is ensured by https://github.com/hydephp/develop/pull/1568/commits/95b395ce69a1b3e0e373285adcb64aa0f3cc57d5
---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 9edc2783dd6..d187de988bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -9,7 +9,7 @@
 
 class NavigationMenu
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
     public function __construct(Arrayable|array $items = [])
@@ -21,7 +21,7 @@ public function __construct(Arrayable|array $items = [])
         }
     }
 
-    /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {
         return $this->items;

From dcc1a5ff94285f56b683f3eba635c4515936a3a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:42:27 +0100
Subject: [PATCH 0258/4023] Add code documentation for the navigation menu
 class

---
 .../Features/Navigation/NavigationMenu.php        | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index d187de988bb..4f5a40ba4b8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -7,11 +7,17 @@
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
+/**
+ * Represents a site navigation menu, and contains all of its navigation items.
+ */
 class NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
+    /**
+     * Create a new navigation menu instance.
+     */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
@@ -21,12 +27,19 @@ public function __construct(Arrayable|array $items = [])
         }
     }
 
-    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
+    /**
+     * Get the navigation items in the menu.
+     *
+     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem>
+     */
     public function getItems(): Collection
     {
         return $this->items;
     }
 
+    /**
+     * Add a navigation item to the navigation menu.
+     */
     public function add(NavItem $item): void
     {
         $this->items->push($item);

From 1078ee6a1506f708b37ab68be7dda2fb21e1aeac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:48:16 +0100
Subject: [PATCH 0259/4023] Normalize skip message

---
 .../framework/tests/Feature/NavigationMenuTest.php   | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 6bee9dd592c..cf3e5f2d451 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -275,7 +275,7 @@ public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
 
     public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         config(['hyde.navigation.subdirectories' => 'dropdown']);
         Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
@@ -290,7 +290,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
 
     public function testGetDropdownsWithMultipleItems()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
@@ -310,7 +310,7 @@ public function testGetDropdownsWithMultipleItems()
 
     public function testGetDropdownsWithMultipleDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
@@ -335,7 +335,7 @@ public function testGetDropdownsWithMultipleDropdowns()
 
     public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         $menu = $this->createNavigationMenu();
         $this->assertCount(0, $menu->getDropdowns());
@@ -344,7 +344,7 @@ public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
 
     public function testDocumentationPagesDoNotGetAddedToDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
@@ -358,7 +358,7 @@ public function testDocumentationPagesDoNotGetAddedToDropdowns()
 
     public function testBlogPostsDoNotGetAddedToDropdowns()
     {
-        $this->markTestSkipped('Tested method may be removed.');
+        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
 
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 

From c1ca8fc0125ed51f5535e6627bdbdbb40baa2611 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 21:48:53 +0100
Subject: [PATCH 0260/4023] Test service container integration

---
 .../tests/Feature/NavigationMenuTest.php          | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index cf3e5f2d451..00bac2a5c96 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\DropdownNavItem;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -404,6 +405,20 @@ public function testDropdownMenuItemsAreSortedByPriority()
         $this->assertSame(['Foo', 'Bar', 'Baz'], collect($dropdowns[0]->getChildren())->pluck('label')->toArray());
     }
 
+    public function testCanGetMenuFromServiceContainer()
+    {
+        $this->assertEquals($this->createNavigationMenu(), app('navigation')->getMenu('main'));
+    }
+
+    public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
+    {
+        $navigation = app('navigation')->getMenu('main');
+        $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
+
+        $this->assertCount(2, $navigation->getItems());
+        $this->assertSame('Foo', $navigation->getItems()->last()->label);
+    }
+
     protected function createNavigationMenu(): NavigationMenu
     {
         return GeneratesMainNavigationMenu::handle();

From 8b0f21c9d5348bf946f64747e90f54eff74bde94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 22:04:28 +0100
Subject: [PATCH 0261/4023] Automatically sort items by priority upon retrieval

I considered adding a secondary method to get sorted items, but I anticipate most people will want it sorted. Otherwise they can extend the class and change it. Or suggest a PR to add a $sort parameter. The values are reset to reorder the keys.
---
 .../Features/Navigation/NavigationMenu.php    |  2 +-
 .../tests/Unit/NavigationMenuUnitTest.php     | 28 +++++++++++++++++++
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 4f5a40ba4b8..4473baca808 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -34,7 +34,7 @@ public function __construct(Arrayable|array $items = [])
      */
     public function getItems(): Collection
     {
-        return $this->items;
+        return $this->items->sortBy('priority')->values();
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 57ad6222993..5242dd9f317 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -77,6 +77,34 @@ public function testCanAddItems()
         $this->assertSame($item, $menu->getItems()->first());
     }
 
+    public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
+    {
+        $menu = new NavigationMenu();
+        $item1 = new NavItem(new ExternalRoute('/'), 'Home');
+        $item2 = new NavItem(new ExternalRoute('/about'), 'About');
+        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
+
+        $menu->add($item1);
+        $menu->add($item2);
+        $menu->add($item3);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
+    public function testItemsAreSortedByPriority()
+    {
+        $menu = new NavigationMenu();
+        $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
+        $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
+        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
+
+        $menu->add($item3);
+        $menu->add($item1);
+        $menu->add($item2);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
     protected function getItems(): array
     {
         return [

From 3a7280394136825c64e0c643c0b9c0681f63d534 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 22:16:38 +0100
Subject: [PATCH 0262/4023] Document sorting

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 4473baca808..ca3021f1336 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -30,6 +30,8 @@ public function __construct(Arrayable|array $items = [])
     /**
      * Get the navigation items in the menu.
      *
+     * Items are automatically sorted by their priority, falling back to the order they were added.
+     *
      * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem>
      */
     public function getItems(): Collection

From 86e9e48208b221b77777aa5065fe1019cdc875a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 22:17:34 +0100
Subject: [PATCH 0263/4023] Begin overview

---
 docs/digging-deeper/navigation.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4ead086dd8c..4d201775d42 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -325,3 +325,11 @@ use Hyde\Framework\Features\Navigation\DropdownNavItem;
 If you want to interact with the site navigation programmatically, you can do so through the new Navigation API.
 
 For most cases you don't need this, as Hyde creates the navigation for you. But it can be useful for advanced users and package developers.
+
+### Overview
+
+The Navigation API consists of the following classes, allowing you to fluently interact with the navigation menus:
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+```

From 80899397081abadbd821dc014ac6599e181dc5b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 14 Feb 2024 22:23:03 +0100
Subject: [PATCH 0264/4023] Remove tests for methods removed in
 https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a

---
 .../tests/Feature/NavigationMenuTest.php      | 153 ------------------
 1 file changed, 153 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 00bac2a5c96..83c10b62dd5 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -8,11 +8,8 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
-use Hyde\Framework\Features\Navigation\DropdownNavItem;
 use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\MarkdownPage;
-use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
@@ -237,140 +234,6 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->assertEquals($expected, $menu->getItems());
     }
 
-    public function testHasDropdownsReturnsFalseWhenThereAreNoDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createNavigationMenu();
-        $this->assertFalse($menu->hasDropdowns());
-    }
-
-    public function testHasDropdownsReturnsTrueWhenThereAreDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createNavigationMenu();
-        $this->assertTrue($menu->hasDropdowns());
-    }
-
-    public function testHasDropdownsAlwaysReturnsFalseWhenDropdownsAreDisabled()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $this->assertFalse($this->createNavigationMenu()->hasDropdowns());
-    }
-
-    public function testGetDropdownsReturnsEmptyArrayThereAreNoDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        $menu = $this->createNavigationMenu();
-        $this->assertCount(0, $menu->getDropdowns());
-        $this->assertSame([], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsReturnsCorrectArrayWhenThereAreDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        $menu = $this->createNavigationMenu();
-        $this->assertCount(1, $menu->getDropdowns());
-
-        $this->assertEquals([
-            new DropdownNavItem('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-            ]), ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsWithMultipleItems()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        $menu = $this->createNavigationMenu();
-
-        $this->assertCount(1, $menu->getDropdowns());
-
-        $this->assertEquals([
-            new DropdownNavItem('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
-            ]),
-        ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsWithMultipleDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPage('foo/bar'))->getRoute());
-        Routes::addRoute((new MarkdownPage('foo/baz'))->getRoute());
-        Routes::addRoute((new MarkdownPage('cat/hat'))->getRoute());
-
-        $menu = $this->createNavigationMenu();
-
-        $this->assertCount(2, $menu->getDropdowns());
-
-        $this->assertEquals([
-            new DropdownNavItem('foo', [
-                NavItem::fromRoute((new MarkdownPage('foo/bar'))->getRoute()),
-                NavItem::fromRoute((new MarkdownPage('foo/baz'))->getRoute()),
-            ]),
-            new DropdownNavItem('cat', [
-                NavItem::fromRoute((new MarkdownPage('cat/hat'))->getRoute()),
-            ]),
-        ], $menu->getDropdowns());
-    }
-
-    public function testGetDropdownsDoesNotThrowWhenAutomaticDropdownsIsDisabled()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        $menu = $this->createNavigationMenu();
-        $this->assertCount(0, $menu->getDropdowns());
-        $this->assertSame([], $menu->getDropdowns());
-    }
-
-    public function testDocumentationPagesDoNotGetAddedToDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new DocumentationPage('foo'))->getRoute());
-        Routes::addRoute((new DocumentationPage('bar/baz'))->getRoute());
-        $menu = $this->createNavigationMenu();
-
-        $this->assertFalse($menu->hasDropdowns());
-        $this->assertCount(0, $menu->getDropdowns());
-    }
-
-    public function testBlogPostsDoNotGetAddedToDropdowns()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute((new MarkdownPost('foo'))->getRoute());
-        Routes::addRoute((new MarkdownPost('bar/baz'))->getRoute());
-
-        $menu = $this->createNavigationMenu();
-        $this->assertFalse($menu->hasDropdowns());
-        $this->assertCount(0, $menu->getDropdowns());
-    }
-
     public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
@@ -389,22 +252,6 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         ], $menu->getItems()->all());
     }
 
-    public function testDropdownMenuItemsAreSortedByPriority()
-    {
-        $this->markTestSkipped('Tested method removed in https://github.com/hydephp/develop/commit/78d7570060718c5bca1428e4464aaf630d66ec6a');
-
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        Routes::addRoute(new Route(new MarkdownPage('foo/foo', ['navigation.priority' => 1])));
-        Routes::addRoute(new Route(new MarkdownPage('foo/bar', ['navigation.priority' => 2])));
-        Routes::addRoute(new Route(new MarkdownPage('foo/baz', ['navigation.priority' => 3])));
-
-        $menu = $this->createNavigationMenu();
-        $dropdowns = $menu->getDropdowns();
-
-        $this->assertSame(['Foo', 'Bar', 'Baz'], collect($dropdowns[0]->getChildren())->pluck('label')->toArray());
-    }
-
     public function testCanGetMenuFromServiceContainer()
     {
         $this->assertEquals($this->createNavigationMenu(), app('navigation')->getMenu('main'));

From 1647be4f748f0493e642b466b706944e9ab6d62a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:08:33 +0100
Subject: [PATCH 0265/4023] Create GeneratesDocumentationSidebarMenu.php

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
new file mode 100644
index 00000000000..d9e6d69e081
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class GeneratesDocumentationSidebarMenu
+{
+    //
+}

From 2a21f77e02e4462fdaaacf334dc46bbab6f889a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:08:47 +0100
Subject: [PATCH 0266/4023] Add design annotations

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index d9e6d69e081..e72cb873f49 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,11 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * @experimental This class may change significantly before its release.
+ *
+ * @todo Consider making into a service which can create the sidebar as well.
+ */
 class GeneratesDocumentationSidebarMenu
 {
     //

From a9342cfb765601f1047aa02c4db84aca793b6f2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:09:34 +0100
Subject: [PATCH 0267/4023] Copy over base contract from related class

---
 .../GeneratesDocumentationSidebarMenu.php     | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e72cb873f49..50715a1f245 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Collection;
+
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -11,5 +13,22 @@
  */
 class GeneratesDocumentationSidebarMenu
 {
-    //
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    protected Collection $items;
+
+    protected function __construct()
+    {
+        $this->items = new Collection();
+    }
+
+    public static function handle(): DocumentationSidebar
+    {
+        $menu = new static();
+
+        $menu->generate();
+        $menu->sortByPriority();
+        $menu->removeDuplicateItems();
+
+        return new DocumentationSidebar($menu->items);
+    }
 }

From 80df7fffdabf6fae2d4c2e912654e0e5fea93dd4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:10:09 +0100
Subject: [PATCH 0268/4023] Copy over helper methods for refactor

---
 .../GeneratesDocumentationSidebarMenu.php     | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 50715a1f245..a71d19c6a97 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,8 +4,13 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Support\Models\Route;
+use Hyde\Support\Facades\Render;
+use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 
+use function collect;
+
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -31,4 +36,32 @@ public static function handle(): DocumentationSidebar
 
         return new DocumentationSidebar($menu->items);
     }
+
+    protected function canAddRoute(Route $route): bool
+    {
+        return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
+    }
+
+    protected function removeDuplicateItems(): void
+    {
+        $this->items = $this->items->unique(function (NavItem $item): string {
+            // Filter using a combination of the group and label to allow duplicate labels in different groups
+            return $item->getGroup().$item->label;
+        });
+    }
+
+    protected function sortByPriority(): void
+    {
+        $this->items = $this->items->sortBy('priority')->values();
+    }
+
+    private function isPageIndexPage(): bool
+    {
+        return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
+    }
+
+    private function shouldIndexPageBeActive(string $group): bool
+    {
+        return Render::getPage()->navigationMenuGroup() === 'other' && $group === collect($this->getGroups())->first();
+    }
 }

From fe4b91fd32a8f3ce5035df417add227ecbfefb75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:14:27 +0100
Subject: [PATCH 0269/4023] Deprecate methods being refactored

---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 790ac82e595..c9a029020d6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -91,11 +91,13 @@ public function makeGroupTitle(string $group): string
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
     }
 
+    /** @deprecated Move to new action */
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
     }
 
+    /** @deprecated Move to new action */
     protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
@@ -104,16 +106,19 @@ protected function removeDuplicateItems(): void
         });
     }
 
+    /** @deprecated Move to new action */
     protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy('priority')->values();
     }
 
+    /** @deprecated Move to new action */
     private function isPageIndexPage(): bool
     {
         return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
     }
 
+    /** @deprecated Move to new action */
     private function shouldIndexPageBeActive(string $group): bool
     {
         return Render::getPage()->navigationMenuGroup() === 'other' && $group === collect($this->getGroups())->first();

From bed0d5d8d0a3d7678bf6529b673b25312809e487 Mon Sep 17 00:00:00 2001
From: caendesilva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:17:34 +0100
Subject: [PATCH 0270/4023] Begin copying over generate method to action

---
 .../Features/Navigation/DocumentationSidebar.php  |  1 +
 .../GeneratesDocumentationSidebarMenu.php         | 15 +++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c9a029020d6..c4ffabaf2fa 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -45,6 +45,7 @@ public static function create(): static
         return $menu;
     }
 
+    /** @deprecated Move to new action */
     protected function generate(): void
     {
         Routes::getRoutes(DocumentationPage::class)->each(function (Route $route): void {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a71d19c6a97..7fe9094cafd 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -8,6 +8,7 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
+use Hyde\Foundation\Facades\Routes;
 
 use function collect;
 
@@ -37,6 +38,20 @@ public static function handle(): DocumentationSidebar
         return new DocumentationSidebar($menu->items);
     }
 
+    protected function generate(): void
+    {
+        Routes::getRoutes(DocumentationPage::class)->each(function (Route $route): void {
+            if ($this->canAddRoute($route)) {
+                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+            }
+        });
+
+        // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
+        if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
+            $this->items->push(NavItem::fromRoute(DocumentationPage::home(), group: 'other'));
+        }
+    }
+
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());

From 80243ae50e29cee54cfaf24b2aa9740a2227ea75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:29:55 +0100
Subject: [PATCH 0271/4023] Defer logic to new action

---
 .../Features/Navigation/DocumentationSidebar.php          | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c4ffabaf2fa..665e845c341 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -36,13 +36,7 @@ public function getItems(): Collection
     /** @deprecated Will be moved to an action */
     public static function create(): static
     {
-        $menu = new static();
-
-        $menu->generate();
-        $menu->sortByPriority();
-        $menu->removeDuplicateItems();
-
-        return $menu;
+        return GeneratesDocumentationSidebarMenu::handle();
     }
 
     /** @deprecated Move to new action */

From c1105f06335f10f479e5e5bf8e07e184dece30e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:30:58 +0100
Subject: [PATCH 0272/4023] Remove now moved methods

---
 .../Navigation/DocumentationSidebar.php       | 38 -------------------
 1 file changed, 38 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 665e845c341..3ec019cd188 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -6,10 +6,8 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Hyde\Foundation\Facades\Routes;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
-use Hyde\Support\Models\Route;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 use Illuminate\Contracts\Support\Arrayable;
@@ -39,21 +37,6 @@ public static function create(): static
         return GeneratesDocumentationSidebarMenu::handle();
     }
 
-    /** @deprecated Move to new action */
-    protected function generate(): void
-    {
-        Routes::getRoutes(DocumentationPage::class)->each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-            }
-        });
-
-        // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
-        if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-            $this->items->push(NavItem::fromRoute(DocumentationPage::home(), group: 'other'));
-        }
-    }
-
     public function hasGroups(): bool
     {
         return (count($this->getGroups()) >= 1) && ($this->getGroups() !== ['other']);
@@ -86,27 +69,6 @@ public function makeGroupTitle(string $group): string
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
     }
 
-    /** @deprecated Move to new action */
-    protected function canAddRoute(Route $route): bool
-    {
-        return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
-    }
-
-    /** @deprecated Move to new action */
-    protected function removeDuplicateItems(): void
-    {
-        $this->items = $this->items->unique(function (NavItem $item): string {
-            // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().$item->label;
-        });
-    }
-
-    /** @deprecated Move to new action */
-    protected function sortByPriority(): void
-    {
-        $this->items = $this->items->sortBy('priority')->values();
-    }
-
     /** @deprecated Move to new action */
     private function isPageIndexPage(): bool
     {

From 189c515bbc3a277b8b8fd5d0b12be4ce8452268b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:32:49 +0100
Subject: [PATCH 0273/4023] Deprecate method
 `DocumentationSidebar::makeGroupTitle()`

With the new NavItem system this should not be necessary, as the parent has a title
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3ec019cd188..0e2027dcb15 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -64,6 +64,7 @@ public function isGroupActive(string $group): bool
             || $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
     }
 
+    /** @deprecated With the new NavItem system this should not be necessary, as the parent has a title */
     public function makeGroupTitle(string $group): string
     {
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);

From 92ea7ea99f877ac086f5ae2024de07f891499a3f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:35:39 +0100
Subject: [PATCH 0274/4023] Revert private method deprecations

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0e2027dcb15..4a661bfaafe 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -70,13 +70,11 @@ public function makeGroupTitle(string $group): string
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
     }
 
-    /** @deprecated Move to new action */
     private function isPageIndexPage(): bool
     {
         return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
     }
 
-    /** @deprecated Move to new action */
     private function shouldIndexPageBeActive(string $group): bool
     {
         return Render::getPage()->navigationMenuGroup() === 'other' && $group === collect($this->getGroups())->first();

From 41849e670aee8e614a5367f4301002bc070dc7dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 13:35:46 +0100
Subject: [PATCH 0275/4023] Remove unused methods

---
 .../GeneratesDocumentationSidebarMenu.php           | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7fe9094cafd..3221bfa3ada 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -5,13 +5,10 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Support\Models\Route;
-use Hyde\Support\Facades\Render;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 
-use function collect;
-
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -69,14 +66,4 @@ protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy('priority')->values();
     }
-
-    private function isPageIndexPage(): bool
-    {
-        return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
-    }
-
-    private function shouldIndexPageBeActive(string $group): bool
-    {
-        return Render::getPage()->navigationMenuGroup() === 'other' && $group === collect($this->getGroups())->first();
-    }
 }

From 831983e525588c73d9ebc4586cf62514b375f2b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 14:00:35 +0100
Subject: [PATCH 0276/4023] Document public method

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4a661bfaafe..04e33c4b60f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -58,6 +58,9 @@ public function getItemsInGroup(?string $group): Collection
         })->sortBy('navigation.priority')->values();
     }
 
+    /**
+     * Is a page within the group the current page?
+     */
     public function isGroupActive(string $group): bool
     {
         return Str::slug(Render::getPage()->navigationMenuGroup()) === $group

From b1a800fa1b1d0aa402ae7b0fd6265dd7ca3f965a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 14:01:38 +0100
Subject: [PATCH 0277/4023] Explain complex logic regarding
 https://github.com/hydephp/develop/pull/1084

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 04e33c4b60f..3646fe7e250 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -60,6 +60,8 @@ public function getItemsInGroup(?string $group): Collection
 
     /**
      * Is a page within the group the current page?
+     *
+     * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */
     public function isGroupActive(string $group): bool
     {

From 1876a680b67b42312923af6a8b2fcc98bbc854ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 14:02:52 +0100
Subject: [PATCH 0278/4023] Introduce local variables to make complex logic
 clearer

---
 .../Features/Navigation/DocumentationSidebar.php      | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3646fe7e250..5bc6cb04c0e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -65,8 +65,10 @@ public function getItemsInGroup(?string $group): Collection
      */
     public function isGroupActive(string $group): bool
     {
-        return Str::slug(Render::getPage()->navigationMenuGroup()) === $group
-            || $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
+        $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
+        $currentPageIsIndexPageAndShouldBeActive = $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
+
+        return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;
     }
 
     /** @deprecated With the new NavItem system this should not be necessary, as the parent has a title */
@@ -82,6 +84,9 @@ private function isPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        return Render::getPage()->navigationMenuGroup() === 'other' && $group === collect($this->getGroups())->first();
+        $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === 'other';
+        $groupIsTheFirstOneInSidebar = $group === collect($this->getGroups())->first();
+
+        return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
     }
 }

From 206a57f98281156c19f7adc24d5ded8de5825c40 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 14:58:00 +0100
Subject: [PATCH 0279/4023] Add todo

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index d9406d6f2ca..51827a4d0a0 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -210,6 +210,7 @@ private function canUseSubdirectoryForGroups(): bool
 
     private function defaultGroup(): ?string
     {
+        // TODO: It would be better if this was null in all cases, considering 'other' is used a a sort of confusing pseudo-null
         return $this->isInstanceOf(DocumentationPage::class) ? 'other' : null;
     }
 

From a1a4d115d24dd1dd1137d989d1ebcfbc538a1352 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 15:13:38 +0100
Subject: [PATCH 0280/4023] Add todo to deprecation notice

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5bc6cb04c0e..d071b031480 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -71,7 +71,11 @@ public function isGroupActive(string $group): bool
         return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;
     }
 
-    /** @deprecated With the new NavItem system this should not be necessary, as the parent has a title */
+    /**
+     * @deprecated With the new NavItem system this should not be necessary, as the parent has a title
+     *
+     * @todo Get title from instance
+     */
     public function makeGroupTitle(string $group): string
     {
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);

From 27afe8e4e3f62ff1038136698b67ccd6cf46ed89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 15:18:29 +0100
Subject: [PATCH 0281/4023] Add todo

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d071b031480..eba36a0d3ac 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -54,6 +54,7 @@ public function getGroups(): array
     public function getItemsInGroup(?string $group): Collection
     {
         return $this->items->filter(function (NavItem $item) use ($group): bool {
+            // Todo: Use identifier instead of slug
             return ($item->getGroup() === $group) || ($item->getGroup() === Str::slug($group));
         })->sortBy('navigation.priority')->values();
     }

From 67a98047d6b7bed1241adee5874a480adc45054e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 16:32:07 +0100
Subject: [PATCH 0282/4023] Create AutomaticNavigationConfigurationsTest.php

---
 .../AutomaticNavigationConfigurationsTest.php | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
new file mode 100644
index 00000000000..50dabdca18c
--- /dev/null
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
+ *
+ * @covers \Hyde\Framework\Factories\NavigationDataFactory
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
+ * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\NavItem
+ */
+class AutomaticNavigationConfigurationsTest extends TestCase
+{
+    //
+}

From 10c43d5a462b725340a0efcba19337c434ef9578 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:14:54 +0100
Subject: [PATCH 0283/4023] Begin creating metatest framework

---
 .../AutomaticNavigationConfigurationsTest.php | 122 +++++++++++++++++-
 1 file changed, 121 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 50dabdca18c..aa13b13a4e7 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,6 +5,9 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 /**
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
@@ -17,5 +20,122 @@
  */
 class AutomaticNavigationConfigurationsTest extends TestCase
 {
-    //
+    public function testMainNavigationMenu()
+    {
+        $this->menu()
+            ->assertHasItem('Home')
+            ->assertMatchesFormat([
+                [
+                    'label' => 'Home',
+                    'group' => null,
+                    'priority' => 0,
+                    'children' => [],
+                ],
+            ]);
+    }
+
+    protected function menu(): AssertableNavigationMenu
+    {
+        return new AssertableNavigationMenu($this);
+    }
+}
+
+class TestNavItem
+{
+    public readonly string $label;
+    public readonly ?string $group;
+    public readonly int $priority;
+    public readonly array $children;
+
+    public function __construct(string $label, ?string $group, int $priority, array $children)
+    {
+        $this->label = $label;
+        $this->group = $group;
+        $this->priority = $priority;
+        $this->children = collect($children)->map(fn (NavItem $child) => $child->getLabel())->toArray();
+    }
+
+    public static function properties(): array
+    {
+        return ['label', 'group', 'priority', 'children'];
+    }
+}
+
+class AssertableNavigationMenu extends NavigationMenu
+{
+    protected TestCase $test;
+
+    public function __construct(TestCase $test)
+    {
+        parent::__construct(GeneratesMainNavigationMenu::handle()->getItems());
+
+        $this->test = $test;
+    }
+
+    /** A simplified serialized format for comparisons */
+    public function format(): array
+    {
+        return $this->items->map(function (NavItem $item) {
+            return new TestNavItem(
+                $item->getLabel(),
+                $item->getGroup(),
+                $item->getPriority(),
+                $item->getChildren()
+            );
+        })->toArray();
+    }
+
+    /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
+    public function dd(): void
+    {
+        dd($this->items);
+    }
+
+    /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
+    public function ddFormat(): void
+    {
+        dd($this->format());
+    }
+
+    /**
+     * @param  array  $expected  The expected format
+     * @param  bool  $strict  If false, missing array keys are ignored
+     */
+    public function assertMatchesFormat(array $expected, bool $strict = false): static
+    {
+        // $this->test->assertEquals($expected, $this->format(), 'Failed to match the expected format');
+
+        foreach ($expected as $index => $item) {
+            foreach (TestNavItem::properties() as $property) {
+                $actual = $this->format()[$index] ?? null;
+
+                if ($actual === null) {
+                    // Count mismatch which we will catch at end of loop
+
+                    continue;
+                }
+
+                if (! isset($item[$property])) {
+                    if ($strict) {
+                        $this->test->fail("Missing array key '$property' in the expected format");
+                    }
+
+                    continue;
+                }
+
+                $this->test->assertSame($item[$property], $actual->$property, "Failed to match the expected value for '$property'");
+            }
+
+            $this->test->assertCount(count($expected), $this->format(), 'The expected format has a different count than the actual format');
+        }
+
+        return $this;
+    }
+
+    public function assertHasItem(string $label): static
+    {
+        $this->test->assertNotEmpty($this->items->first(fn ($item) => $item->getLabel() === $label), "Item with label '$label' not found in the main navigation menu");
+
+        return $this;
+    }
 }

From 62a7b36f2c48422c662b2febccf3dc11490cc70b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:17:30 +0100
Subject: [PATCH 0284/4023] Rename testing helper

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index aa13b13a4e7..dcf9a6162d4 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -24,7 +24,7 @@ public function testMainNavigationMenu()
     {
         $this->menu()
             ->assertHasItem('Home')
-            ->assertMatchesFormat([
+            ->assertEquals([
                 [
                     'label' => 'Home',
                     'group' => null,
@@ -101,7 +101,7 @@ public function ddFormat(): void
      * @param  array  $expected  The expected format
      * @param  bool  $strict  If false, missing array keys are ignored
      */
-    public function assertMatchesFormat(array $expected, bool $strict = false): static
+    public function assertEquals(array $expected, bool $strict = false): static
     {
         // $this->test->assertEquals($expected, $this->format(), 'Failed to match the expected format');
 

From 0ff7bda614aaf3dd68431dd67e97f4f444fae7ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:17:38 +0100
Subject: [PATCH 0285/4023] Join comma-separated values into a single line

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index dcf9a6162d4..d81e2afcdd8 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -76,12 +76,7 @@ public function __construct(TestCase $test)
     public function format(): array
     {
         return $this->items->map(function (NavItem $item) {
-            return new TestNavItem(
-                $item->getLabel(),
-                $item->getGroup(),
-                $item->getPriority(),
-                $item->getChildren()
-            );
+            return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
         })->toArray();
     }
 

From c126b4916296e938d6946e287bc66c2e15459492 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:17:51 +0100
Subject: [PATCH 0286/4023] Add closure return type

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d81e2afcdd8..f5e65c6cb5e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -75,7 +75,7 @@ public function __construct(TestCase $test)
     /** A simplified serialized format for comparisons */
     public function format(): array
     {
-        return $this->items->map(function (NavItem $item) {
+        return $this->items->map(function (NavItem $item): TestNavItem {
             return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
         })->toArray();
     }

From 70f55a94868850b2aa3c86576adc9c5ca809ca96 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:18:16 +0100
Subject: [PATCH 0287/4023] Remove comment

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f5e65c6cb5e..5460d007492 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -98,8 +98,6 @@ public function ddFormat(): void
      */
     public function assertEquals(array $expected, bool $strict = false): static
     {
-        // $this->test->assertEquals($expected, $this->format(), 'Failed to match the expected format');
-
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
                 $actual = $this->format()[$index] ?? null;

From 24ae3e7539802b685a031514c9d29fbdfe428610 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:19:38 +0100
Subject: [PATCH 0288/4023] Rename test term to be more specific

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5460d007492..bb3b7039341 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -73,7 +73,7 @@ public function __construct(TestCase $test)
     }
 
     /** A simplified serialized format for comparisons */
-    public function format(): array
+    public function state(): array
     {
         return $this->items->map(function (NavItem $item): TestNavItem {
             return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
@@ -89,18 +89,18 @@ public function dd(): void
     /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
     public function ddFormat(): void
     {
-        dd($this->format());
+        dd($this->state());
     }
 
     /**
-     * @param  array  $expected  The expected format
+     * @param  array  $expected  The expected state format
      * @param  bool  $strict  If false, missing array keys are ignored
      */
     public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                $actual = $this->format()[$index] ?? null;
+                $actual = $this->state()[$index] ?? null;
 
                 if ($actual === null) {
                     // Count mismatch which we will catch at end of loop
@@ -110,7 +110,7 @@ public function assertEquals(array $expected, bool $strict = false): static
 
                 if (! isset($item[$property])) {
                     if ($strict) {
-                        $this->test->fail("Missing array key '$property' in the expected format");
+                        $this->test->fail("Missing array key '$property' in the expected state");
                     }
 
                     continue;
@@ -119,7 +119,7 @@ public function assertEquals(array $expected, bool $strict = false): static
                 $this->test->assertSame($item[$property], $actual->$property, "Failed to match the expected value for '$property'");
             }
 
-            $this->test->assertCount(count($expected), $this->format(), 'The expected format has a different count than the actual format');
+            $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state');
         }
 
         return $this;

From 28d9ede3c5ccdf2f9b066fcd36b0b7408b1b5a7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:21:03 +0100
Subject: [PATCH 0289/4023] Add option to get single state

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index bb3b7039341..a8608efa41e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -73,8 +73,12 @@ public function __construct(TestCase $test)
     }
 
     /** A simplified serialized format for comparisons */
-    public function state(): array
+    public function state(?int $index = null): TestNavItem|array
     {
+        if ($index !== null) {
+            return $this->state()[$index];
+        }
+
         return $this->items->map(function (NavItem $item): TestNavItem {
             return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
         })->toArray();
@@ -100,7 +104,7 @@ public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                $actual = $this->state()[$index] ?? null;
+                $actual = $this->state($index) ?? null;
 
                 if ($actual === null) {
                     // Count mismatch which we will catch at end of loop

From 97c6de8f8fb17178e2c0f8d8ef0aa5b041735f01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:21:07 +0100
Subject: [PATCH 0290/4023] Revert "Add option to get single state"

This reverts commit 28d9ede3c5ccdf2f9b066fcd36b0b7408b1b5a7f.
---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a8608efa41e..bb3b7039341 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -73,12 +73,8 @@ public function __construct(TestCase $test)
     }
 
     /** A simplified serialized format for comparisons */
-    public function state(?int $index = null): TestNavItem|array
+    public function state(): array
     {
-        if ($index !== null) {
-            return $this->state()[$index];
-        }
-
         return $this->items->map(function (NavItem $item): TestNavItem {
             return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
         })->toArray();
@@ -104,7 +100,7 @@ public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                $actual = $this->state($index) ?? null;
+                $actual = $this->state()[$index] ?? null;
 
                 if ($actual === null) {
                     // Count mismatch which we will catch at end of loop

From a741c8eb4093104f0c8d271f976e5286bca9e826 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:21:46 +0100
Subject: [PATCH 0291/4023] Add helper to get single state

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index bb3b7039341..6231ca3ad4b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -80,6 +80,11 @@ public function state(): array
         })->toArray();
     }
 
+    public function getState(int $index): ?TestNavItem
+    {
+        return $this->state()[$index] ?? null;
+    }
+
     /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
     public function dd(): void
     {
@@ -100,7 +105,7 @@ public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                $actual = $this->state()[$index] ?? null;
+                $actual = $this->getState($index);
 
                 if ($actual === null) {
                     // Count mismatch which we will catch at end of loop

From cd8b33f9e5fae115e4dc400aced8c13f2bf512e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:21:55 +0100
Subject: [PATCH 0292/4023] Inline local variable

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 6231ca3ad4b..5f303481684 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -105,9 +105,7 @@ public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                $actual = $this->getState($index);
-
-                if ($actual === null) {
+                if ($this->getState($index) === null) {
                     // Count mismatch which we will catch at end of loop
 
                     continue;
@@ -121,7 +119,7 @@ public function assertEquals(array $expected, bool $strict = false): static
                     continue;
                 }
 
-                $this->test->assertSame($item[$property], $actual->$property, "Failed to match the expected value for '$property'");
+                $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
             }
 
             $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state');

From d1714175d1dff84c8de7bd6cb636f0584d346238 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:22:57 +0100
Subject: [PATCH 0293/4023] Fix assertion should run after all loops

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5f303481684..98668ae4be4 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -121,10 +121,10 @@ public function assertEquals(array $expected, bool $strict = false): static
 
                 $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
             }
-
-            $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state');
         }
 
+        $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state');
+
         return $this;
     }
 

From 986694cc02d3041bc026594e83e2d0c2b8f614e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:24:09 +0100
Subject: [PATCH 0294/4023] Refactor loop control flow

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 98668ae4be4..e3a1ba39739 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -111,15 +111,11 @@ public function assertEquals(array $expected, bool $strict = false): static
                     continue;
                 }
 
-                if (! isset($item[$property])) {
-                    if ($strict) {
-                        $this->test->fail("Missing array key '$property' in the expected state");
-                    }
-
-                    continue;
+                if (isset($item[$property])) {
+                    $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
+                } elseif ($strict) {
+                    $this->test->fail("Missing array key '$property' in the expected state");
                 }
-
-                $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
             }
         }
 

From 789cfa045f683c3df0503f2cbce9aef20faf2b7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:25:53 +0100
Subject: [PATCH 0295/4023] Refactor inner loop control flow

---
 .../AutomaticNavigationConfigurationsTest.php    | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e3a1ba39739..2c0d1032e29 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -105,16 +105,12 @@ public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
             foreach (TestNavItem::properties() as $property) {
-                if ($this->getState($index) === null) {
-                    // Count mismatch which we will catch at end of loop
-
-                    continue;
-                }
-
-                if (isset($item[$property])) {
-                    $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
-                } elseif ($strict) {
-                    $this->test->fail("Missing array key '$property' in the expected state");
+                if ($this->getState($index) !== null) {
+                    if (isset($item[$property])) {
+                        $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
+                    } elseif ($strict) {
+                        $this->test->fail("Missing array key '$property' in the expected state");
+                    }
                 }
             }
         }

From 07956df1e632f47c602d4803fd4f094726bad9c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:37:35 +0100
Subject: [PATCH 0296/4023] Add shorthand to compare labels

---
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 2c0d1032e29..95abc807742 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -24,14 +24,7 @@ public function testMainNavigationMenu()
     {
         $this->menu()
             ->assertHasItem('Home')
-            ->assertEquals([
-                [
-                    'label' => 'Home',
-                    'group' => null,
-                    'priority' => 0,
-                    'children' => [],
-                ],
-            ]);
+            ->assertEquals(['Home']);
     }
 
     protected function menu(): AssertableNavigationMenu
@@ -104,6 +97,10 @@ public function ddFormat(): void
     public function assertEquals(array $expected, bool $strict = false): static
     {
         foreach ($expected as $index => $item) {
+            if (! is_array($item)) {
+                $item = ['label' => $item];
+            }
+
             foreach (TestNavItem::properties() as $property) {
                 if ($this->getState($index) !== null) {
                     if (isset($item[$property])) {

From 68fa1d9a1de483887c10690c297319de74a525bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:38:36 +0100
Subject: [PATCH 0297/4023] Simplify comparison

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 95abc807742..e5f72c8a14a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -22,9 +22,7 @@ class AutomaticNavigationConfigurationsTest extends TestCase
 {
     public function testMainNavigationMenu()
     {
-        $this->menu()
-            ->assertHasItem('Home')
-            ->assertEquals(['Home']);
+        $this->menu()->assertEquals(['Home']);
     }
 
     protected function menu(): AssertableNavigationMenu

From 47fe9e92652293a64508bc7901524814575fcd57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:40:42 +0100
Subject: [PATCH 0298/4023] Add property instead of extension

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e5f72c8a14a..d69fa94b658 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,8 +5,8 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 /**
@@ -52,13 +52,14 @@ public static function properties(): array
     }
 }
 
-class AssertableNavigationMenu extends NavigationMenu
+class AssertableNavigationMenu
 {
     protected TestCase $test;
+    protected Collection $items;
 
     public function __construct(TestCase $test)
     {
-        parent::__construct(GeneratesMainNavigationMenu::handle()->getItems());
+        $this->items = GeneratesMainNavigationMenu::handle()->getItems();
 
         $this->test = $test;
     }

From 723d49c6737082387100564234c3dcd5c31a9ef9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 17:43:09 +0100
Subject: [PATCH 0299/4023] Add scaffolding to test sidebars

---
 .../AutomaticNavigationConfigurationsTest.php   | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d69fa94b658..be75abaf099 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -8,6 +8,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
+use Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu;
 
 /**
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
@@ -25,10 +26,20 @@ public function testMainNavigationMenu()
         $this->menu()->assertEquals(['Home']);
     }
 
+    public function testDocumentationSidebarMenu()
+    {
+        $this->sidebar()->assertEquals([]);
+    }
+
     protected function menu(): AssertableNavigationMenu
     {
         return new AssertableNavigationMenu($this);
     }
+
+    protected function sidebar(): AssertableNavigationMenu
+    {
+        return new AssertableNavigationMenu($this, true);
+    }
 }
 
 class TestNavItem
@@ -57,9 +68,11 @@ class AssertableNavigationMenu
     protected TestCase $test;
     protected Collection $items;
 
-    public function __construct(TestCase $test)
+    public function __construct(TestCase $test, $sidebar = false)
     {
-        $this->items = GeneratesMainNavigationMenu::handle()->getItems();
+        $this->items = $sidebar
+            ? GeneratesDocumentationSidebarMenu::handle()->getItems()
+            : GeneratesMainNavigationMenu::handle()->getItems();
 
         $this->test = $test;
     }

From 88af77f2a24b2a2a5c43f0d005738a9b5bd2016f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:10:43 +0100
Subject: [PATCH 0300/4023] Set up test kernel

---
 .../AutomaticNavigationConfigurationsTest.php | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index be75abaf099..a52c853a5fd 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,7 +5,9 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\Collection;
+use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 use Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu;
@@ -21,6 +23,14 @@
  */
 class AutomaticNavigationConfigurationsTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->kernel = new TestKernel();
+        HydeKernel::setInstance($this->kernel);
+    }
+
     public function testMainNavigationMenu()
     {
         $this->menu()->assertEquals(['Home']);
@@ -136,3 +146,19 @@ public function assertHasItem(string $label): static
         return $this;
     }
 }
+
+class TestKernel extends HydeKernel
+{
+    protected ?RouteCollection $mockRoutes = null;
+
+    public function setRoutes(Collection $routes): void
+    {
+        $this->mockRoutes = RouteCollection::make($routes);
+    }
+
+    /** @return \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
+    public function routes(): RouteCollection
+    {
+        return $this->mockRoutes ?? parent::routes();
+    }
+}

From 118d1331cc888689602e05d016e9d07c74158a15 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:12:03 +0100
Subject: [PATCH 0301/4023] Test with pages

---
 .../AutomaticNavigationConfigurationsTest.php | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a52c853a5fd..572c8cd404a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,6 +5,8 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
@@ -41,6 +43,29 @@ public function testDocumentationSidebarMenu()
         $this->sidebar()->assertEquals([]);
     }
 
+    public function testMainNavigationMenuWithPages()
+    {
+        $this->withPages([
+            'About' => MarkdownPage::class,
+            'Contact' => MarkdownPage::class,
+        ]);
+
+        $this->menu()->assertEquals([
+            'About',
+            'Contact',
+        ]);
+    }
+
+    protected function withPages(array $pages): static
+    {
+        $routes = collect($pages)->mapWithKeys(/** @param class-string<\Hyde\Pages\Concerns\HydePage> $page */ function (string $page, string $title) {
+            return [Str::slug($title) => $page::make(Str::slug($title), ['title' => $title])->getRoute()];
+        });
+        $this->kernel->setRoutes($routes);
+
+        return $this;
+    }
+
     protected function menu(): AssertableNavigationMenu
     {
         return new AssertableNavigationMenu($this);

From f9d55c816a14fb7cb9b6d353dc3d379a51bdad27 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:12:36 +0100
Subject: [PATCH 0302/4023] Merge fluent method calls

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 572c8cd404a..c63a39b9a6f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -48,9 +48,7 @@ public function testMainNavigationMenuWithPages()
         $this->withPages([
             'About' => MarkdownPage::class,
             'Contact' => MarkdownPage::class,
-        ]);
-
-        $this->menu()->assertEquals([
+        ])->menu()->assertEquals([
             'About',
             'Contact',
         ]);

From a56a071be1441604dde0ba52379a44fd333a040e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:37:17 +0100
Subject: [PATCH 0303/4023] Simplify test data handling

---
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c63a39b9a6f..474edf688c2 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,9 +5,9 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
-use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Foundation\HydeKernel;
+use Hyde\Pages\Concerns\HydePage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -46,8 +46,8 @@ public function testDocumentationSidebarMenu()
     public function testMainNavigationMenuWithPages()
     {
         $this->withPages([
-            'About' => MarkdownPage::class,
-            'Contact' => MarkdownPage::class,
+            new MarkdownPage('about'),
+            new MarkdownPage('contact'),
         ])->menu()->assertEquals([
             'About',
             'Contact',
@@ -56,10 +56,7 @@ public function testMainNavigationMenuWithPages()
 
     protected function withPages(array $pages): static
     {
-        $routes = collect($pages)->mapWithKeys(/** @param class-string<\Hyde\Pages\Concerns\HydePage> $page */ function (string $page, string $title) {
-            return [Str::slug($title) => $page::make(Str::slug($title), ['title' => $title])->getRoute()];
-        });
-        $this->kernel->setRoutes($routes);
+        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
 
         return $this;
     }

From 996debd08126e92e5d6b4d48950b629aa89b7a03 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:49:44 +0100
Subject: [PATCH 0304/4023] Rename method to match other rename

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 474edf688c2..5022cb91237 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -127,7 +127,7 @@ public function dd(): void
     }
 
     /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
-    public function ddFormat(): void
+    public function ddState(): void
     {
         dd($this->state());
     }

From 2e04862b5197da3a4944470a325a4ba1dab8692f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:49:22 +0100
Subject: [PATCH 0305/4023] Test main navigation menu with front matter
 priorities

---
 .../AutomaticNavigationConfigurationsTest.php | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5022cb91237..dfea0f05b02 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -54,6 +54,33 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
+    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
+    {
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.priority' => 1]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+        ])->menu()->assertEquals([
+            'First',
+            'Second',
+        ]);
+
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.priority' => 2]),
+            new MarkdownPage('second', ['navigation.priority' => 1]),
+        ])->menu()->assertEquals([
+            'Second',
+            'First',
+        ]);
+
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.order' => 2]),
+            new MarkdownPage('second', ['navigation.order' => 1]),
+        ])->menu()->assertEquals([
+            'Second',
+            'First',
+        ]);
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From b195e8b08cd658dfa7c1e4f0b71b3f53b7e67f98 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:51:56 +0100
Subject: [PATCH 0306/4023] Improve test specificity

---
 .../AutomaticNavigationConfigurationsTest.php | 27 ++++++++++++++++---
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index dfea0f05b02..3fe78583315 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -59,23 +59,42 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
         $this->withPages([
             new MarkdownPage('first', ['navigation.priority' => 1]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 3]),
         ])->menu()->assertEquals([
             'First',
             'Second',
+            'Third',
         ]);
 
         $this->withPages([
-            new MarkdownPage('first', ['navigation.priority' => 2]),
-            new MarkdownPage('second', ['navigation.priority' => 1]),
+            new MarkdownPage('first', ['navigation.priority' => 3]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 1]),
         ])->menu()->assertEquals([
+            'Third',
             'Second',
             'First',
         ]);
+    }
+
+    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
+    {
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.order' => 1]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 3]),
+        ])->menu()->assertEquals([
+            'First',
+            'Second',
+            'Third',
+        ]);
 
         $this->withPages([
-            new MarkdownPage('first', ['navigation.order' => 2]),
-            new MarkdownPage('second', ['navigation.order' => 1]),
+            new MarkdownPage('first', ['navigation.order' => 3]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 1]),
         ])->menu()->assertEquals([
+            'Third',
             'Second',
             'First',
         ]);

From 0eaaa096e1a3b5e18ecdc3edb31e9bc83676a9ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 18:59:19 +0100
Subject: [PATCH 0307/4023] Refactor to extract helper to reduce boilerplate

---
 .../AutomaticNavigationConfigurationsTest.php | 50 +++++--------------
 1 file changed, 13 insertions(+), 37 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 3fe78583315..ae8b55be136 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
@@ -56,48 +57,23 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->withPages([
-            new MarkdownPage('first', ['navigation.priority' => 1]),
-            new MarkdownPage('second', ['navigation.priority' => 2]),
-            new MarkdownPage('third', ['navigation.priority' => 3]),
-        ])->menu()->assertEquals([
-            'First',
-            'Second',
-            'Third',
-        ]);
-
-        $this->withPages([
-            new MarkdownPage('first', ['navigation.priority' => 3]),
-            new MarkdownPage('second', ['navigation.priority' => 2]),
-            new MarkdownPage('third', ['navigation.priority' => 1]),
-        ])->menu()->assertEquals([
-            'Third',
-            'Second',
-            'First',
-        ]);
+        $this->testNavigationMenuWithPages('priority', [1, 2, 3], ['First', 'Second', 'Third']);
+        $this->testNavigationMenuWithPages('priority', [3, 2, 1], ['Third', 'Second', 'First']);
     }
 
     public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
-        $this->withPages([
-            new MarkdownPage('first', ['navigation.order' => 1]),
-            new MarkdownPage('second', ['navigation.order' => 2]),
-            new MarkdownPage('third', ['navigation.order' => 3]),
-        ])->menu()->assertEquals([
-            'First',
-            'Second',
-            'Third',
-        ]);
+        $this->testNavigationMenuWithPages('order', [1, 2, 3], ['First', 'Second', 'Third']);
+        $this->testNavigationMenuWithPages('order', [3, 2, 1], ['Third', 'Second', 'First']);
+    }
 
-        $this->withPages([
-            new MarkdownPage('first', ['navigation.order' => 3]),
-            new MarkdownPage('second', ['navigation.order' => 2]),
-            new MarkdownPage('third', ['navigation.order' => 1]),
-        ])->menu()->assertEquals([
-            'Third',
-            'Second',
-            'First',
-        ]);
+    protected function testNavigationMenuWithPages($field, $priorities, $expectedOrder): void
+    {
+        $pages = collect($priorities)->map(function ($value) use ($expectedOrder, $field) {
+            return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
+        })->all();
+
+        $this->withPages($pages)->menu()->assertEquals($expectedOrder);
     }
 
     protected function withPages(array $pages): static

From 0b216709a132efc9e218a52af5c159593f1575d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:01:11 +0100
Subject: [PATCH 0308/4023] Improve testing helper implementation

---
 .../AutomaticNavigationConfigurationsTest.php  | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ae8b55be136..7940346a495 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -55,21 +55,23 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
+    public function testMainNavigationMenuWithPagesPriority()
     {
-        $this->testNavigationMenuWithPages('priority', [1, 2, 3], ['First', 'Second', 'Third']);
-        $this->testNavigationMenuWithPages('priority', [3, 2, 1], ['Third', 'Second', 'First']);
+        $this->assertMenuOrder(['priority' => [1, 2, 3]], ['First', 'Second', 'Third']);
+        $this->assertMenuOrder(['priority' => [3, 2, 1]], ['Third', 'Second', 'First']);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
+    public function testMainNavigationMenuWithPagesOrder()
     {
-        $this->testNavigationMenuWithPages('order', [1, 2, 3], ['First', 'Second', 'Third']);
-        $this->testNavigationMenuWithPages('order', [3, 2, 1], ['Third', 'Second', 'First']);
+        $this->assertMenuOrder(['order' => [1, 2, 3]], ['First', 'Second', 'Third']);
+        $this->assertMenuOrder(['order' => [3, 2, 1]], ['Third', 'Second', 'First']);
     }
 
-    protected function testNavigationMenuWithPages($field, $priorities, $expectedOrder): void
+    protected function assertMenuOrder(array $frontMatterValues, array $expectedOrder): void
     {
-        $pages = collect($priorities)->map(function ($value) use ($expectedOrder, $field) {
+        $field = key($frontMatterValues);
+
+        $pages = collect($frontMatterValues[$field])->map(function ($value) use ($expectedOrder, $field) {
             return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
         })->all();
 

From 24fb65ac3f74aa7d2b81381e513ad24ff5bae1c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:03:17 +0100
Subject: [PATCH 0309/4023] Rename tests to be clearer

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 7940346a495..14c8b8ee7b0 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -55,13 +55,13 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesPriority()
+    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
         $this->assertMenuOrder(['priority' => [1, 2, 3]], ['First', 'Second', 'Third']);
         $this->assertMenuOrder(['priority' => [3, 2, 1]], ['Third', 'Second', 'First']);
     }
 
-    public function testMainNavigationMenuWithPagesOrder()
+    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
         $this->assertMenuOrder(['order' => [1, 2, 3]], ['First', 'Second', 'Third']);
         $this->assertMenuOrder(['order' => [3, 2, 1]], ['Third', 'Second', 'First']);

From c17a6c644dccebb65a25238f04b13fbbf65fe36d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:07:43 +0100
Subject: [PATCH 0310/4023] Merge test methods to further assess field
 interoperability

---
 .../AutomaticNavigationConfigurationsTest.php | 24 +++++++------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 14c8b8ee7b0..08a04343910 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -57,25 +57,19 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->assertMenuOrder(['priority' => [1, 2, 3]], ['First', 'Second', 'Third']);
-        $this->assertMenuOrder(['priority' => [3, 2, 1]], ['Third', 'Second', 'First']);
+        $this->assertMenuOrder(['priority', 'order'], [1, 2, 3], ['First', 'Second', 'Third']);
+        $this->assertMenuOrder(['priority', 'order'], [3, 2, 1], ['Third', 'Second', 'First']);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
+    protected function assertMenuOrder(array $fields, array $frontMatterValues, array $expectedOrder): void
     {
-        $this->assertMenuOrder(['order' => [1, 2, 3]], ['First', 'Second', 'Third']);
-        $this->assertMenuOrder(['order' => [3, 2, 1]], ['Third', 'Second', 'First']);
-    }
-
-    protected function assertMenuOrder(array $frontMatterValues, array $expectedOrder): void
-    {
-        $field = key($frontMatterValues);
+        foreach ($fields as $field) {
+            $pages = collect($frontMatterValues)->map(function ($value) use ($expectedOrder, $field) {
+                return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
+            })->all();
 
-        $pages = collect($frontMatterValues[$field])->map(function ($value) use ($expectedOrder, $field) {
-            return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
-        })->all();
-
-        $this->withPages($pages)->menu()->assertEquals($expectedOrder);
+            $this->withPages($pages)->menu()->assertEquals($expectedOrder);
+        }
     }
 
     protected function withPages(array $pages): static

From 80e56fbba53a8519f312d81ed2a4c7278608458b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:08:24 +0100
Subject: [PATCH 0311/4023] Inline constant parameter value

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 08a04343910..cc3c2530945 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -57,12 +57,14 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->assertMenuOrder(['priority', 'order'], [1, 2, 3], ['First', 'Second', 'Third']);
-        $this->assertMenuOrder(['priority', 'order'], [3, 2, 1], ['Third', 'Second', 'First']);
+        $this->assertMenuOrder([1, 2, 3], ['First', 'Second', 'Third']);
+        $this->assertMenuOrder([3, 2, 1], ['Third', 'Second', 'First']);
     }
 
-    protected function assertMenuOrder(array $fields, array $frontMatterValues, array $expectedOrder): void
+    protected function assertMenuOrder(array $frontMatterValues, array $expectedOrder): void
     {
+        $fields = ['priority', 'order'];
+
         foreach ($fields as $field) {
             $pages = collect($frontMatterValues)->map(function ($value) use ($expectedOrder, $field) {
                 return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);

From 4db97af9c29c1037fb4b0101567ce1136cfbc778 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:08:46 +0100
Subject: [PATCH 0312/4023] Inline local variable

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index cc3c2530945..ea4377c9060 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -63,9 +63,7 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
 
     protected function assertMenuOrder(array $frontMatterValues, array $expectedOrder): void
     {
-        $fields = ['priority', 'order'];
-
-        foreach ($fields as $field) {
+        foreach (['priority', 'order'] as $field) {
             $pages = collect($frontMatterValues)->map(function ($value) use ($expectedOrder, $field) {
                 return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
             })->all();

From af4f9b89b47b45af515fb5a106e579bad1c36e89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:09:14 +0100
Subject: [PATCH 0313/4023] Simplify parameter name

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ea4377c9060..0e3715acab8 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -61,10 +61,10 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
         $this->assertMenuOrder([3, 2, 1], ['Third', 'Second', 'First']);
     }
 
-    protected function assertMenuOrder(array $frontMatterValues, array $expectedOrder): void
+    protected function assertMenuOrder(array $priorities, array $expectedOrder): void
     {
         foreach (['priority', 'order'] as $field) {
-            $pages = collect($frontMatterValues)->map(function ($value) use ($expectedOrder, $field) {
+            $pages = collect($priorities)->map(function ($value) use ($expectedOrder, $field) {
                 return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
             })->all();
 

From ccc78e08b7482c7611d863fecf508a159095dd18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:10:17 +0100
Subject: [PATCH 0314/4023] Remove unnecessary suffix for merged methods

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0e3715acab8..1a721c3a4d8 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -55,7 +55,7 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
+    public function testMainNavigationMenuWithPagesWithFrontMatter()
     {
         $this->assertMenuOrder([1, 2, 3], ['First', 'Second', 'Third']);
         $this->assertMenuOrder([3, 2, 1], ['Third', 'Second', 'First']);

From 7c9100e1d4f8825c6359d138f05bd0934aa1207f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 19:17:26 +0100
Subject: [PATCH 0315/4023] Rollback to
 b195e8b08cd658dfa7c1e4f0b71b3f53b7e67f98

This quickly lost its use now that we want to test more options
---
 .../AutomaticNavigationConfigurationsTest.php | 50 +++++++++++++++----
 1 file changed, 39 insertions(+), 11 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 1a721c3a4d8..3fe78583315 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
-use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
@@ -55,21 +54,50 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatter()
+    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->assertMenuOrder([1, 2, 3], ['First', 'Second', 'Third']);
-        $this->assertMenuOrder([3, 2, 1], ['Third', 'Second', 'First']);
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.priority' => 1]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 3]),
+        ])->menu()->assertEquals([
+            'First',
+            'Second',
+            'Third',
+        ]);
+
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.priority' => 3]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 1]),
+        ])->menu()->assertEquals([
+            'Third',
+            'Second',
+            'First',
+        ]);
     }
 
-    protected function assertMenuOrder(array $priorities, array $expectedOrder): void
+    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
-        foreach (['priority', 'order'] as $field) {
-            $pages = collect($priorities)->map(function ($value) use ($expectedOrder, $field) {
-                return new MarkdownPage(Str::slug($expectedOrder[$value - 1]), ["navigation.$field" => $value]);
-            })->all();
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.order' => 1]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 3]),
+        ])->menu()->assertEquals([
+            'First',
+            'Second',
+            'Third',
+        ]);
 
-            $this->withPages($pages)->menu()->assertEquals($expectedOrder);
-        }
+        $this->withPages([
+            new MarkdownPage('first', ['navigation.order' => 3]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 1]),
+        ])->menu()->assertEquals([
+            'Third',
+            'Second',
+            'First',
+        ]);
     }
 
     protected function withPages(array $pages): static

From 3d81244039918f7373b58157745d77de36152411 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:07:19 +0100
Subject: [PATCH 0316/4023] Add shorthand option

---
 .../AutomaticNavigationConfigurationsTest.php | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 3fe78583315..12ceb8fb17e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -56,21 +56,21 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->withPages([
+        $this->menu([
             new MarkdownPage('first', ['navigation.priority' => 1]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 3]),
-        ])->menu()->assertEquals([
+        ])->assertEquals([
             'First',
             'Second',
             'Third',
         ]);
 
-        $this->withPages([
+        $this->menu([
             new MarkdownPage('first', ['navigation.priority' => 3]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 1]),
-        ])->menu()->assertEquals([
+        ])->assertEquals([
             'Third',
             'Second',
             'First',
@@ -79,21 +79,21 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
-        $this->withPages([
+        $this->menu([
             new MarkdownPage('first', ['navigation.order' => 1]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 3]),
-        ])->menu()->assertEquals([
+        ])->assertEquals([
             'First',
             'Second',
             'Third',
         ]);
 
-        $this->withPages([
+        $this->menu([
             new MarkdownPage('first', ['navigation.order' => 3]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 1]),
-        ])->menu()->assertEquals([
+        ])->assertEquals([
             'Third',
             'Second',
             'First',
@@ -107,8 +107,12 @@ protected function withPages(array $pages): static
         return $this;
     }
 
-    protected function menu(): AssertableNavigationMenu
+    protected function menu(?array $withPages = null): AssertableNavigationMenu
     {
+        if ($withPages) {
+            $this->withPages($withPages);
+        }
+
         return new AssertableNavigationMenu($this);
     }
 

From 6f2ce09e87453640ccc9f186e7ed71eb0ea21a08 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:11:21 +0100
Subject: [PATCH 0317/4023] Move up method in source

---
 .../AutomaticNavigationConfigurationsTest.php      | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 12ceb8fb17e..466f12833f5 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -100,13 +100,6 @@ public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
         ]);
     }
 
-    protected function withPages(array $pages): static
-    {
-        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
-
-        return $this;
-    }
-
     protected function menu(?array $withPages = null): AssertableNavigationMenu
     {
         if ($withPages) {
@@ -116,6 +109,13 @@ protected function menu(?array $withPages = null): AssertableNavigationMenu
         return new AssertableNavigationMenu($this);
     }
 
+    protected function withPages(array $pages): static
+    {
+        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
+
+        return $this;
+    }
+
     protected function sidebar(): AssertableNavigationMenu
     {
         return new AssertableNavigationMenu($this, true);

From ae3328de7a37dc113019e38dc515909f07d962a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:12:40 +0100
Subject: [PATCH 0318/4023] Add additional simplified assertion helper

---
 .../AutomaticNavigationConfigurationsTest.php | 21 ++++++++++++-------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 466f12833f5..dae030aafb2 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -56,21 +56,21 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->menu([
+        $this->assertMenuEquals([
             new MarkdownPage('first', ['navigation.priority' => 1]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 3]),
-        ])->assertEquals([
+        ], [
             'First',
             'Second',
             'Third',
         ]);
 
-        $this->menu([
+        $this->assertMenuEquals([
             new MarkdownPage('first', ['navigation.priority' => 3]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 1]),
-        ])->assertEquals([
+        ], [
             'Third',
             'Second',
             'First',
@@ -79,27 +79,32 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
-        $this->menu([
+        $this->assertMenuEquals([
             new MarkdownPage('first', ['navigation.order' => 1]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 3]),
-        ])->assertEquals([
+        ], [
             'First',
             'Second',
             'Third',
         ]);
 
-        $this->menu([
+        $this->assertMenuEquals([
             new MarkdownPage('first', ['navigation.order' => 3]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 1]),
-        ])->assertEquals([
+        ], [
             'Third',
             'Second',
             'First',
         ]);
     }
 
+    protected function assertMenuEquals(array $menuPages, array $expected): void
+    {
+        $this->menu($menuPages)->assertEquals($expected);
+    }
+
     protected function menu(?array $withPages = null): AssertableNavigationMenu
     {
         if ($withPages) {

From 92af696d3cc89105a9a2465bce793a0c9ada5805 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:13:12 +0100
Subject: [PATCH 0319/4023] Flip helper parameter order to match base assertion
 order

---
 .../AutomaticNavigationConfigurationsTest.php | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index dae030aafb2..3b501f90f19 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -57,50 +57,50 @@ public function testMainNavigationMenuWithPages()
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
         $this->assertMenuEquals([
-            new MarkdownPage('first', ['navigation.priority' => 1]),
-            new MarkdownPage('second', ['navigation.priority' => 2]),
-            new MarkdownPage('third', ['navigation.priority' => 3]),
-        ], [
             'First',
             'Second',
             'Third',
+        ], [
+            new MarkdownPage('first', ['navigation.priority' => 1]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 3]),
         ]);
 
         $this->assertMenuEquals([
-            new MarkdownPage('first', ['navigation.priority' => 3]),
-            new MarkdownPage('second', ['navigation.priority' => 2]),
-            new MarkdownPage('third', ['navigation.priority' => 1]),
-        ], [
             'Third',
             'Second',
             'First',
+        ], [
+            new MarkdownPage('first', ['navigation.priority' => 3]),
+            new MarkdownPage('second', ['navigation.priority' => 2]),
+            new MarkdownPage('third', ['navigation.priority' => 1]),
         ]);
     }
 
     public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
         $this->assertMenuEquals([
-            new MarkdownPage('first', ['navigation.order' => 1]),
-            new MarkdownPage('second', ['navigation.order' => 2]),
-            new MarkdownPage('third', ['navigation.order' => 3]),
-        ], [
             'First',
             'Second',
             'Third',
+        ], [
+            new MarkdownPage('first', ['navigation.order' => 1]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 3]),
         ]);
 
         $this->assertMenuEquals([
-            new MarkdownPage('first', ['navigation.order' => 3]),
-            new MarkdownPage('second', ['navigation.order' => 2]),
-            new MarkdownPage('third', ['navigation.order' => 1]),
-        ], [
             'Third',
             'Second',
             'First',
+        ], [
+            new MarkdownPage('first', ['navigation.order' => 3]),
+            new MarkdownPage('second', ['navigation.order' => 2]),
+            new MarkdownPage('third', ['navigation.order' => 1]),
         ]);
     }
 
-    protected function assertMenuEquals(array $menuPages, array $expected): void
+    protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);
     }

From af247f82ed63913272715dcb54cc3ab39e473d5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:13:45 +0100
Subject: [PATCH 0320/4023] Join comma-separated values into a single line

---
 .../AutomaticNavigationConfigurationsTest.php | 24 ++++---------------
 1 file changed, 4 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 3b501f90f19..5a61719ffdf 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -56,21 +56,13 @@ public function testMainNavigationMenuWithPages()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
     {
-        $this->assertMenuEquals([
-            'First',
-            'Second',
-            'Third',
-        ], [
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
             new MarkdownPage('first', ['navigation.priority' => 1]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 3]),
         ]);
 
-        $this->assertMenuEquals([
-            'Third',
-            'Second',
-            'First',
-        ], [
+        $this->assertMenuEquals(['Third', 'Second', 'First'], [
             new MarkdownPage('first', ['navigation.priority' => 3]),
             new MarkdownPage('second', ['navigation.priority' => 2]),
             new MarkdownPage('third', ['navigation.priority' => 1]),
@@ -79,21 +71,13 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
 
     public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
     {
-        $this->assertMenuEquals([
-            'First',
-            'Second',
-            'Third',
-        ], [
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
             new MarkdownPage('first', ['navigation.order' => 1]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 3]),
         ]);
 
-        $this->assertMenuEquals([
-            'Third',
-            'Second',
-            'First',
-        ], [
+        $this->assertMenuEquals(['Third', 'Second', 'First'], [
             new MarkdownPage('first', ['navigation.order' => 3]),
             new MarkdownPage('second', ['navigation.order' => 2]),
             new MarkdownPage('third', ['navigation.order' => 1]),

From c0b3b4bd0cb3e831016ab4f85f8e92cc7bba4091 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:16:00 +0100
Subject: [PATCH 0321/4023] Remove unnecessary qualifiers from test method
 names

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5a61719ffdf..1158bdc003f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -54,7 +54,7 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
+    public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [
             new MarkdownPage('first', ['navigation.priority' => 1]),
@@ -69,7 +69,7 @@ public function testMainNavigationMenuWithPagesWithFrontMatterPriority()
         ]);
     }
 
-    public function testMainNavigationMenuWithPagesWithFrontMatterOrder()
+    public function testMainNavigationMenuWithFrontMatterOrder()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [
             new MarkdownPage('first', ['navigation.order' => 1]),

From cfcdf12ff23cd0b01bc1fb1f2545abe6e866e4e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:17:02 +0100
Subject: [PATCH 0322/4023] Test main navigation menu with front matter label

---
 .../Feature/AutomaticNavigationConfigurationsTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 1158bdc003f..fa4b1827a64 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -84,6 +84,15 @@ public function testMainNavigationMenuWithFrontMatterOrder()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterLabel()
+    {
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
+            new MarkdownPage('foo', ['navigation.label' => 'First']),
+            new MarkdownPage('bar', ['navigation.label' => 'Second']),
+            new MarkdownPage('baz', ['navigation.label' => 'Third']),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From 734276d74234351d33d53a80b807abbd32e37be3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:19:41 +0100
Subject: [PATCH 0323/4023] Test front matter visibility control

---
 .../AutomaticNavigationConfigurationsTest.php | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fa4b1827a64..bca57f42e1d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -93,6 +93,36 @@ public function testMainNavigationMenuWithFrontMatterLabel()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterHidden()
+    {
+        $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
+            new MarkdownPage('foo', ['navigation.hidden' => false]),
+            new MarkdownPage('bar', ['navigation.hidden' => false]),
+            new MarkdownPage('baz', ['navigation.hidden' => false]),
+        ]);
+
+        $this->assertMenuEquals([], [
+            new MarkdownPage('foo', ['navigation.hidden' => true]),
+            new MarkdownPage('bar', ['navigation.hidden' => true]),
+            new MarkdownPage('baz', ['navigation.hidden' => true]),
+        ]);
+    }
+
+    public function testMainNavigationMenuWithFrontMatterVisible()
+    {
+        $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
+            new MarkdownPage('foo', ['navigation.visible' => true]),
+            new MarkdownPage('bar', ['navigation.visible' => true]),
+            new MarkdownPage('baz', ['navigation.visible' => true]),
+        ]);
+
+        $this->assertMenuEquals([], [
+            new MarkdownPage('foo', ['navigation.visible' => false]),
+            new MarkdownPage('bar', ['navigation.visible' => false]),
+            new MarkdownPage('baz', ['navigation.visible' => false]),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From 23315ece834fe2530e5a426f06db76c796adcc7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:22:08 +0100
Subject: [PATCH 0324/4023] Test main navigation menu with front matter group

---
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index bca57f42e1d..2134e5bd324 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -123,6 +123,19 @@ public function testMainNavigationMenuWithFrontMatterVisible()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterGroup()
+    {
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Bar', 'group' => 'group-1'],
+            ['label' => 'Baz', 'group' => 'group-1'],
+        ], [
+            new MarkdownPage('foo', ['navigation.group' => 'Group 1']),
+            new MarkdownPage('bar', ['navigation.group' => 'Group 1']),
+            new MarkdownPage('baz', ['navigation.group' => 'Group 1']),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From cd2b957522dc299e8bada37f3129b40043a712e9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:23:33 +0100
Subject: [PATCH 0325/4023] Test main navigation menu with front matter
 category

---
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 2134e5bd324..e5cc03dabc6 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -136,6 +136,19 @@ public function testMainNavigationMenuWithFrontMatterGroup()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterCategory()
+    {
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Bar', 'group' => 'group-1'],
+            ['label' => 'Baz', 'group' => 'group-1'],
+        ], [
+            new MarkdownPage('foo', ['navigation.category' => 'Group 1']),
+            new MarkdownPage('bar', ['navigation.category' => 'Group 1']),
+            new MarkdownPage('baz', ['navigation.category' => 'Group 1']),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From 469f4c8afb5c61a5d71a9b1b8a9db776d389596e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:23:46 +0100
Subject: [PATCH 0326/4023] Add todo

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e5cc03dabc6..43594b3b5e0 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -125,6 +125,8 @@ public function testMainNavigationMenuWithFrontMatterVisible()
 
     public function testMainNavigationMenuWithFrontMatterGroup()
     {
+        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
+
         $this->assertMenuEquals([
             ['label' => 'Foo', 'group' => 'group-1'],
             ['label' => 'Bar', 'group' => 'group-1'],
@@ -138,6 +140,8 @@ public function testMainNavigationMenuWithFrontMatterGroup()
 
     public function testMainNavigationMenuWithFrontMatterCategory()
     {
+        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
+
         $this->assertMenuEquals([
             ['label' => 'Foo', 'group' => 'group-1'],
             ['label' => 'Bar', 'group' => 'group-1'],

From 06159f65764bc1592bea1be79059f4c5494873e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:28:04 +0100
Subject: [PATCH 0327/4023] Test conflicting priority state to assert
 precedence

---
 .../AutomaticNavigationConfigurationsTest.php | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 43594b3b5e0..86d18f916ec 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -153,6 +153,29 @@ public function testMainNavigationMenuWithFrontMatterCategory()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterPriorityAndOrder()
+    {
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'priority' => 1],
+            ['label' => 'Bar', 'priority' => 2],
+            ['label' => 'Baz', 'priority' => 3],
+        ], [
+            new MarkdownPage('foo', ['navigation.priority' => 1, 'navigation.order' => 10]),
+            new MarkdownPage('bar', ['navigation.priority' => 2, 'navigation.order' => 20]),
+            new MarkdownPage('baz', ['navigation.priority' => 3, 'navigation.order' => 30]),
+        ]);
+
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'priority' => 1],
+            ['label' => 'Bar', 'priority' => 2],
+            ['label' => 'Baz', 'priority' => 3],
+        ], [
+            new MarkdownPage('foo', ['navigation.order' => 10, 'navigation.priority' => 1]),
+            new MarkdownPage('bar', ['navigation.order' => 20, 'navigation.priority' => 2]),
+            new MarkdownPage('baz', ['navigation.order' => 30, 'navigation.priority' => 3]),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From da3205ba1954b79d598f376bb732898819206c36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:28:59 +0100
Subject: [PATCH 0328/4023] Document precedence reason

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 86d18f916ec..eb34df4053f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -155,6 +155,8 @@ public function testMainNavigationMenuWithFrontMatterCategory()
 
     public function testMainNavigationMenuWithFrontMatterPriorityAndOrder()
     {
+        // Since the main key in the navigation schema is 'priority', that takes precedence over its 'order' alias
+
         $this->assertMenuEquals([
             ['label' => 'Foo', 'priority' => 1],
             ['label' => 'Bar', 'priority' => 2],

From 98ddc00aff6156be1bae89c8359d2b017e51dfac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:29:57 +0100
Subject: [PATCH 0329/4023] Introduce local variable for duplicate array

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index eb34df4053f..46208be7905 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -157,21 +157,19 @@ public function testMainNavigationMenuWithFrontMatterPriorityAndOrder()
     {
         // Since the main key in the navigation schema is 'priority', that takes precedence over its 'order' alias
 
-        $this->assertMenuEquals([
+        $expected = [
             ['label' => 'Foo', 'priority' => 1],
             ['label' => 'Bar', 'priority' => 2],
             ['label' => 'Baz', 'priority' => 3],
-        ], [
+        ];
+
+        $this->assertMenuEquals($expected, [
             new MarkdownPage('foo', ['navigation.priority' => 1, 'navigation.order' => 10]),
             new MarkdownPage('bar', ['navigation.priority' => 2, 'navigation.order' => 20]),
             new MarkdownPage('baz', ['navigation.priority' => 3, 'navigation.order' => 30]),
         ]);
 
-        $this->assertMenuEquals([
-            ['label' => 'Foo', 'priority' => 1],
-            ['label' => 'Bar', 'priority' => 2],
-            ['label' => 'Baz', 'priority' => 3],
-        ], [
+        $this->assertMenuEquals($expected, [
             new MarkdownPage('foo', ['navigation.order' => 10, 'navigation.priority' => 1]),
             new MarkdownPage('bar', ['navigation.order' => 20, 'navigation.priority' => 2]),
             new MarkdownPage('baz', ['navigation.order' => 30, 'navigation.priority' => 3]),

From 80bf7decdf7784f22361b5f49ac8c75f8ab6a38f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:32:18 +0100
Subject: [PATCH 0330/4023] Test visibility conflict precedence

---
 .../AutomaticNavigationConfigurationsTest.php | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 46208be7905..142673a42ee 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -176,6 +176,41 @@ public function testMainNavigationMenuWithFrontMatterPriorityAndOrder()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterHiddenAndVisible()
+    {
+        // Since the main key in the navigation schema is 'hidden', that takes precedence over its 'visible' alias
+
+        $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
+            new MarkdownPage('foo', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new MarkdownPage('bar', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new MarkdownPage('baz', ['navigation.hidden' => false, 'navigation.visible' => true]),
+        ]);
+
+        $this->assertMenuEquals([], [
+            new MarkdownPage('foo', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new MarkdownPage('bar', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new MarkdownPage('baz', ['navigation.hidden' => true, 'navigation.visible' => false]),
+        ]);
+
+        $this->assertMenuEquals([], [
+            new MarkdownPage('foo', ['navigation.hidden' => true, 'navigation.visible' => true]),
+            new MarkdownPage('bar', ['navigation.hidden' => true, 'navigation.visible' => true]),
+            new MarkdownPage('baz', ['navigation.hidden' => true, 'navigation.visible' => true]),
+        ]);
+
+        $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
+            new MarkdownPage('foo', ['navigation.hidden' => false, 'navigation.visible' => false]),
+            new MarkdownPage('bar', ['navigation.hidden' => false, 'navigation.visible' => false]),
+            new MarkdownPage('baz', ['navigation.hidden' => false, 'navigation.visible' => false]),
+        ]);
+
+        $this->assertMenuEquals(['Bar'], [
+            new MarkdownPage('foo', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new MarkdownPage('bar', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new MarkdownPage('baz', ['navigation.hidden' => true, 'navigation.visible' => false]),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From 9c02dcf24e11c1709c64d576a46b0900b0da221a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:35:35 +0100
Subject: [PATCH 0331/4023] Test group conflict precedence

---
 .../AutomaticNavigationConfigurationsTest.php     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 142673a42ee..0cb8b22ddd6 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -211,6 +211,21 @@ public function testMainNavigationMenuWithFrontMatterHiddenAndVisible()
         ]);
     }
 
+    public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
+    {
+        // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
+
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Bar', 'group' => 'group-1'],
+            ['label' => 'Baz', 'group' => 'group-1'],
+        ], [
+            new MarkdownPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+            new MarkdownPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+            new MarkdownPage('baz', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+        ]);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From afe3f91377925664e2610e50c098eee4d27ff221 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:35:54 +0100
Subject: [PATCH 0332/4023] Remove data from test that has no impact on result

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0cb8b22ddd6..8b9ca8d1803 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -216,9 +216,9 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
 
         $this->assertMenuEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Bar', 'group' => 'group-1'],
-            ['label' => 'Baz', 'group' => 'group-1'],
+            ['group' => 'group-1'],
+            ['group' => 'group-1'],
+            ['group' => 'group-1'],
         ], [
             new MarkdownPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new MarkdownPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),

From c6a92eac4a4eccfd794988e3880f6459012d0689 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 20:36:46 +0100
Subject: [PATCH 0333/4023] Fill repeated array

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8b9ca8d1803..65987a64866 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -215,11 +215,7 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
     {
         // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
 
-        $this->assertMenuEquals([
-            ['group' => 'group-1'],
-            ['group' => 'group-1'],
-            ['group' => 'group-1'],
-        ], [
+        $this->assertMenuEquals(array_fill(0, 3, ['group' => 'group-1']), [
             new MarkdownPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new MarkdownPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new MarkdownPage('baz', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),

From 0cc29e1e9d99c921b4cf2b2555d29252156cc61b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 21:27:14 +0100
Subject: [PATCH 0334/4023] Test default configuration results

---
 .../AutomaticNavigationConfigurationsTest.php | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 65987a64866..f9452fbfca1 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -4,10 +4,15 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Pages\HtmlPage;
+use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\MarkdownPost;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
+use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -54,6 +59,29 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
+    public function testMainNavigationDoesNotInclude404Page()
+    {
+        $this->assertMenuEquals([], [new MarkdownPage('404')]);
+    }
+
+    public function testOnlyRootTypePagesAreAddedToNavigationMenu()
+    {
+        $this->assertMenuEquals(['Html Page', 'Blade Page', 'Markdown Page'], [
+            new HtmlPage('html-page'),
+            new BladePage('blade-page'),
+            new MarkdownPage('markdown-page'),
+            new MarkdownPost('markdown-post'),
+            new DocumentationPage('documentation-page'),
+        ]);
+    }
+
+    public function testInMemoryPagesIsAddedToNavigationMenu()
+    {
+        $this->assertMenuEquals(['In Memory Page'], [
+            new InMemoryPage('in-memory-page'),
+        ]);
+    }
+
     public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [

From 0b880c0b7dc556fb0c9a9febd5363cb44d1df280 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 21:29:26 +0100
Subject: [PATCH 0335/4023] Test duplicated identifier states

---
 .../AutomaticNavigationConfigurationsTest.php | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f9452fbfca1..ffe21af1e42 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -82,6 +82,27 @@ public function testInMemoryPagesIsAddedToNavigationMenu()
         ]);
     }
 
+    public function testOnlyFirstItemWithDuplicateIdentifierIsUsed()
+    {
+        $this->assertMenuEquals(['Markdown'], [
+            new MarkdownPage('foo', ['navigation.label' => 'Markdown']),
+            new BladePage('foo', ['navigation.label' => 'Blade']),
+        ]);
+    }
+
+    public function testItemWithHighestPriorityIsUsedForDuplicateIdentifier()
+    {
+        $this->assertMenuEquals(['Markdown'], [
+            new MarkdownPage('foo', ['navigation.label' => 'Markdown', 'navigation.priority' => 1]),
+            new BladePage('foo', ['navigation.label' => 'Blade', 'navigation.priority' => 2]),
+        ]);
+
+        $this->assertMenuEquals(['Blade'], [
+            new MarkdownPage('foo', ['navigation.label' => 'Markdown', 'navigation.priority' => 2]),
+            new BladePage('foo', ['navigation.label' => 'Blade', 'navigation.priority' => 1]),
+        ]);
+    }
+
     public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [

From 5ec271384839aabb0f449d1a0417cbae21bf1b90 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 15 Feb 2024 21:29:29 +0100
Subject: [PATCH 0336/4023] Revert "Test duplicated identifier states"

This reverts commit 0b880c0b7dc556fb0c9a9febd5363cb44d1df280. This is a bad idea, we do not at all want to handle cases like these. We can't imply support for something that simply cannot work.
---
 .../AutomaticNavigationConfigurationsTest.php | 21 -------------------
 1 file changed, 21 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ffe21af1e42..f9452fbfca1 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -82,27 +82,6 @@ public function testInMemoryPagesIsAddedToNavigationMenu()
         ]);
     }
 
-    public function testOnlyFirstItemWithDuplicateIdentifierIsUsed()
-    {
-        $this->assertMenuEquals(['Markdown'], [
-            new MarkdownPage('foo', ['navigation.label' => 'Markdown']),
-            new BladePage('foo', ['navigation.label' => 'Blade']),
-        ]);
-    }
-
-    public function testItemWithHighestPriorityIsUsedForDuplicateIdentifier()
-    {
-        $this->assertMenuEquals(['Markdown'], [
-            new MarkdownPage('foo', ['navigation.label' => 'Markdown', 'navigation.priority' => 1]),
-            new BladePage('foo', ['navigation.label' => 'Blade', 'navigation.priority' => 2]),
-        ]);
-
-        $this->assertMenuEquals(['Blade'], [
-            new MarkdownPage('foo', ['navigation.label' => 'Markdown', 'navigation.priority' => 2]),
-            new BladePage('foo', ['navigation.label' => 'Blade', 'navigation.priority' => 1]),
-        ]);
-    }
-
     public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [

From d7d75aba994e14f913b0233542ada3a3ee2ec78f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 16 Feb 2024 20:47:50 +0100
Subject: [PATCH 0337/4023] Fix test method name grammar

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f9452fbfca1..a64fc927423 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -75,7 +75,7 @@ public function testOnlyRootTypePagesAreAddedToNavigationMenu()
         ]);
     }
 
-    public function testInMemoryPagesIsAddedToNavigationMenu()
+    public function testInMemoryPagesAreAddedToNavigationMenu()
     {
         $this->assertMenuEquals(['In Memory Page'], [
             new InMemoryPage('in-memory-page'),

From 376278b5ef5f04eb36237c78becccb8783eddfc4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 16 Feb 2024 20:51:37 +0100
Subject: [PATCH 0338/4023] Test default navigation priorities

---
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a64fc927423..fb643574990 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -82,6 +82,19 @@ public function testInMemoryPagesAreAddedToNavigationMenu()
         ]);
     }
 
+    public function testDefaultNavigationPriorities()
+    {
+        $this->assertMenuEquals([
+            ['priority' => 0],
+            ['priority' => 10],
+            ['priority' => 100],
+        ], [
+            new MarkdownPage('index'),
+            new MarkdownPage('posts'),
+            new MarkdownPage('docs/index'),
+        ]);
+    }
+
     public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [

From eba2918733f0b2e45de9e8ac7281a89cb08294af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 16 Feb 2024 20:51:46 +0100
Subject: [PATCH 0339/4023] Test default navigation labels

---
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fb643574990..b7477191832 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -95,6 +95,17 @@ public function testDefaultNavigationPriorities()
         ]);
     }
 
+    public function testDefaultNavigationLabels()
+    {
+        $this->assertMenuEquals([
+            ['label' => 'Home'],
+            ['label' => 'Docs'],
+        ], [
+            new MarkdownPage('index'),
+            new MarkdownPage('docs/index'),
+        ]);
+    }
+
     public function testMainNavigationMenuWithFrontMatterPriority()
     {
         $this->assertMenuEquals(['First', 'Second', 'Third'], [

From 90bbd6b79c6a15d4f999f146fba08b99c1f3b004 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 11:51:37 +0100
Subject: [PATCH 0340/4023] Test documentation index pages are added to
 navigation menu

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index b7477191832..af380e02e2d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -75,6 +75,13 @@ public function testOnlyRootTypePagesAreAddedToNavigationMenu()
         ]);
     }
 
+    public function testDocumentationIndexPagesAreAddedToNavigationMenu()
+    {
+        $this->assertMenuEquals(['Docs'], [
+            new DocumentationPage('index'),
+        ]);
+    }
+
     public function testInMemoryPagesAreAddedToNavigationMenu()
     {
         $this->assertMenuEquals(['In Memory Page'], [

From 42fefd6170760bcc579e1c4464b4342134c0b580 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 11:52:09 +0100
Subject: [PATCH 0341/4023] Add auxiliary assertion

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index af380e02e2d..177cbfc9b70 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -79,6 +79,7 @@ public function testDocumentationIndexPagesAreAddedToNavigationMenu()
     {
         $this->assertMenuEquals(['Docs'], [
             new DocumentationPage('index'),
+            new DocumentationPage('foo'),
         ]);
     }
 

From 7c87eddcba9015e5975175184becb615608fd592 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 11:55:00 +0100
Subject: [PATCH 0342/4023] Reorder test methods

---
 .../Feature/AutomaticNavigationConfigurationsTest.php  | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 177cbfc9b70..ac60f39af5a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -59,11 +59,6 @@ public function testMainNavigationMenuWithPages()
         ]);
     }
 
-    public function testMainNavigationDoesNotInclude404Page()
-    {
-        $this->assertMenuEquals([], [new MarkdownPage('404')]);
-    }
-
     public function testOnlyRootTypePagesAreAddedToNavigationMenu()
     {
         $this->assertMenuEquals(['Html Page', 'Blade Page', 'Markdown Page'], [
@@ -90,6 +85,11 @@ public function testInMemoryPagesAreAddedToNavigationMenu()
         ]);
     }
 
+    public function testMainNavigationDoesNotInclude404Page()
+    {
+        $this->assertMenuEquals([], [new MarkdownPage('404')]);
+    }
+
     public function testDefaultNavigationPriorities()
     {
         $this->assertMenuEquals([

From ed59f2c74edfba4fac53ffb4f00bf7b7a7c89533 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 11:55:22 +0100
Subject: [PATCH 0343/4023] Test redirect pages are added to navigation menu

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ac60f39af5a..73d5451985b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -13,6 +13,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Support\Models\Redirect;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -90,6 +91,13 @@ public function testMainNavigationDoesNotInclude404Page()
         $this->assertMenuEquals([], [new MarkdownPage('404')]);
     }
 
+    public function testRedirectPagesAreAddedToNavigationMenu()
+    {
+        $this->assertMenuEquals(['Redirect'], [
+            new Redirect('redirect', 'destination'),
+        ]);
+    }
+
     public function testDefaultNavigationPriorities()
     {
         $this->assertMenuEquals([

From 2ff05f5d5630348f0c910db7426bb46fa9960940 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 12:01:27 +0100
Subject: [PATCH 0344/4023] Remove unused assertion helper

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 73d5451985b..d5c5af688a6 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -403,13 +403,6 @@ public function assertEquals(array $expected, bool $strict = false): static
 
         return $this;
     }
-
-    public function assertHasItem(string $label): static
-    {
-        $this->test->assertNotEmpty($this->items->first(fn ($item) => $item->getLabel() === $label), "Item with label '$label' not found in the main navigation menu");
-
-        return $this;
-    }
 }
 
 class TestKernel extends HydeKernel

From bab57f1ced4e6dafe86936a2876f60b4e59c7fa3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 12:14:27 +0100
Subject: [PATCH 0345/4023] Update sidebar testing helper to allow pages

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d5c5af688a6..152d79c1c55 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -311,8 +311,12 @@ protected function withPages(array $pages): static
         return $this;
     }
 
-    protected function sidebar(): AssertableNavigationMenu
+    protected function sidebar(?array $withPages = null): AssertableNavigationMenu
     {
+        if ($withPages) {
+            $this->withPages($withPages);
+        }
+
         return new AssertableNavigationMenu($this, true);
     }
 }

From d48c4b2c90b51be915eb5aaa8ad970c2bad5ef9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 12:14:55 +0100
Subject: [PATCH 0346/4023] Add sidebar assertion helper

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 152d79c1c55..84de380a864 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -290,6 +290,11 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    protected function assertSidebarEquals(array $expected, array $menuPages): void
+    {
+        $this->sidebar($menuPages)->assertEquals($expected);
+    }
+
     protected function assertMenuEquals(array $expected, array $menuPages): void
     {
         $this->menu($menuPages)->assertEquals($expected);

From 26fb57b001ba807c582c255bbf2ee9b96e289c1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 12:15:08 +0100
Subject: [PATCH 0347/4023] Test sidebar with pages

---
 .../Feature/AutomaticNavigationConfigurationsTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 84de380a864..f85f320f098 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -290,6 +290,15 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    public function testSidebarWithPages()
+    {
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ]);
+    }
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From 34c9c2e0fcb20962f0e4e2d3c594018208dee41a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 13:27:16 +0100
Subject: [PATCH 0348/4023] Test only documentation pages are added to sidebar

---
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f85f320f098..f79d2577573 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -299,6 +299,19 @@ public function testSidebarWithPages()
         ]);
     }
 
+    public function testOnlyDocumentationPagesAreAddedToSidebar()
+    {
+        $this->assertSidebarEquals(['Documentation Page'], [
+            new HtmlPage('html-page'),
+            new BladePage('blade-page'),
+            new MarkdownPage('markdown-page'),
+            new MarkdownPost('markdown-post'),
+            new DocumentationPage('documentation-page'),
+            new InMemoryPage('in-memory-page'),
+            new Redirect('redirect', 'destination'),
+        ]);
+    }
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From 7abfce51728dfbec9cdba57ff8079cd36a6eba78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 13:53:25 +0100
Subject: [PATCH 0349/4023] Add base sidebar front matter tests

---
 .../AutomaticNavigationConfigurationsTest.php | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f79d2577573..824c0409641 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -312,6 +312,75 @@ public function testOnlyDocumentationPagesAreAddedToSidebar()
         ]);
     }
 
+    public function testSidebarWithFrontMatterPriority()
+    {
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('first', ['navigation.priority' => 1]),
+            new DocumentationPage('second', ['navigation.priority' => 2]),
+            new DocumentationPage('third', ['navigation.priority' => 3]),
+        ]);
+
+        $this->assertSidebarEquals(['Third', 'Second', 'First'], [
+            new DocumentationPage('first', ['navigation.priority' => 3]),
+            new DocumentationPage('second', ['navigation.priority' => 2]),
+            new DocumentationPage('third', ['navigation.priority' => 1]),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterOrder()
+    {
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('first', ['navigation.order' => 1]),
+            new DocumentationPage('second', ['navigation.order' => 2]),
+            new DocumentationPage('third', ['navigation.order' => 3]),
+        ]);
+
+        $this->assertSidebarEquals(['Third', 'Second', 'First'], [
+            new DocumentationPage('first', ['navigation.order' => 3]),
+            new DocumentationPage('second', ['navigation.order' => 2]),
+            new DocumentationPage('third', ['navigation.order' => 1]),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterLabel()
+    {
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('foo', ['navigation.label' => 'First']),
+            new DocumentationPage('bar', ['navigation.label' => 'Second']),
+            new DocumentationPage('baz', ['navigation.label' => 'Third']),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterHidden()
+    {
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('foo', ['navigation.hidden' => false]),
+            new DocumentationPage('bar', ['navigation.hidden' => false]),
+            new DocumentationPage('baz', ['navigation.hidden' => false]),
+        ]);
+
+        $this->assertSidebarEquals([], [
+            new DocumentationPage('foo', ['navigation.hidden' => true]),
+            new DocumentationPage('bar', ['navigation.hidden' => true]),
+            new DocumentationPage('baz', ['navigation.hidden' => true]),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterVisible()
+    {
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('foo', ['navigation.visible' => true]),
+            new DocumentationPage('bar', ['navigation.visible' => true]),
+            new DocumentationPage('baz', ['navigation.visible' => true]),
+        ]);
+
+        $this->assertSidebarEquals([], [
+            new DocumentationPage('foo', ['navigation.visible' => false]),
+            new DocumentationPage('bar', ['navigation.visible' => false]),
+            new DocumentationPage('baz', ['navigation.visible' => false]),
+        ]);
+    }
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From f9df95aff83817e3791eb4b204f990c26a2c530b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 13:57:30 +0100
Subject: [PATCH 0350/4023] Add sidebar category front matter tests

---
 .../AutomaticNavigationConfigurationsTest.php | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 824c0409641..cd93444832a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -381,6 +381,36 @@ public function testSidebarWithFrontMatterVisible()
         ]);
     }
 
+    public function testSidebarWithFrontMatterGroup()
+    {
+        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
+
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Bar', 'group' => 'group-1'],
+            ['label' => 'Baz', 'group' => 'group-1'],
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'Group 1']),
+            new DocumentationPage('bar', ['navigation.group' => 'Group 1']),
+            new DocumentationPage('baz', ['navigation.group' => 'Group 1']),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterCategory()
+    {
+        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
+
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Bar', 'group' => 'group-1'],
+            ['label' => 'Baz', 'group' => 'group-1'],
+        ], [
+            new DocumentationPage('foo', ['navigation.category' => 'Group 1']),
+            new DocumentationPage('bar', ['navigation.category' => 'Group 1']),
+            new DocumentationPage('baz', ['navigation.category' => 'Group 1']),
+        ]);
+    }
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From 199360ae10dbdb5334804ce943df6af9cb9e3b4b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 13:58:31 +0100
Subject: [PATCH 0351/4023] Add sidebar front matter precedence tests

---
 .../AutomaticNavigationConfigurationsTest.php | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index cd93444832a..5881a571428 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -411,6 +411,75 @@ public function testSidebarWithFrontMatterCategory()
         ]);
     }
 
+    public function testSidebarWithFrontMatterPriorityAndOrder()
+    {
+        // Since the main key in the navigation schema is 'priority', that takes precedence over its 'order' alias
+
+        $expected = [
+            ['label' => 'Foo', 'priority' => 1],
+            ['label' => 'Bar', 'priority' => 2],
+            ['label' => 'Baz', 'priority' => 3],
+        ];
+
+        $this->assertSidebarEquals($expected, [
+            new DocumentationPage('foo', ['navigation.priority' => 1, 'navigation.order' => 10]),
+            new DocumentationPage('bar', ['navigation.priority' => 2, 'navigation.order' => 20]),
+            new DocumentationPage('baz', ['navigation.priority' => 3, 'navigation.order' => 30]),
+        ]);
+
+        $this->assertSidebarEquals($expected, [
+            new DocumentationPage('foo', ['navigation.order' => 10, 'navigation.priority' => 1]),
+            new DocumentationPage('bar', ['navigation.order' => 20, 'navigation.priority' => 2]),
+            new DocumentationPage('baz', ['navigation.order' => 30, 'navigation.priority' => 3]),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterHiddenAndVisible()
+    {
+        // Since the main key in the navigation schema is 'hidden', that takes precedence over its 'visible' alias
+
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('foo', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new DocumentationPage('bar', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new DocumentationPage('baz', ['navigation.hidden' => false, 'navigation.visible' => true]),
+        ]);
+
+        $this->assertSidebarEquals([], [
+            new DocumentationPage('foo', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new DocumentationPage('bar', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new DocumentationPage('baz', ['navigation.hidden' => true, 'navigation.visible' => false]),
+        ]);
+
+        $this->assertSidebarEquals([], [
+            new DocumentationPage('foo', ['navigation.hidden' => true, 'navigation.visible' => true]),
+            new DocumentationPage('bar', ['navigation.hidden' => true, 'navigation.visible' => true]),
+            new DocumentationPage('baz', ['navigation.hidden' => true, 'navigation.visible' => true]),
+        ]);
+
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('foo', ['navigation.hidden' => false, 'navigation.visible' => false]),
+            new DocumentationPage('bar', ['navigation.hidden' => false, 'navigation.visible' => false]),
+            new DocumentationPage('baz', ['navigation.hidden' => false, 'navigation.visible' => false]),
+        ]);
+
+        $this->assertSidebarEquals(['Bar'], [
+            new DocumentationPage('foo', ['navigation.hidden' => true, 'navigation.visible' => false]),
+            new DocumentationPage('bar', ['navigation.hidden' => false, 'navigation.visible' => true]),
+            new DocumentationPage('baz', ['navigation.hidden' => true, 'navigation.visible' => false]),
+        ]);
+    }
+
+    public function testSidebarWithFrontMatterGroupAndCategory()
+    {
+        // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
+
+        $this->assertSidebarEquals(array_fill(0, 3, ['group' => 'group-1']), [
+            new DocumentationPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+            new DocumentationPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+            new DocumentationPage('baz', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
+        ]);
+    }
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From cd4e77f7602526ef8df475fb1d9a01ad5637e6d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 14:07:30 +0100
Subject: [PATCH 0352/4023] Add section comments to test

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5881a571428..a9253494fb7 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -39,6 +39,8 @@ protected function setUp(): void
         HydeKernel::setInstance($this->kernel);
     }
 
+    // Base tests
+
     public function testMainNavigationMenu()
     {
         $this->menu()->assertEquals(['Home']);
@@ -49,6 +51,8 @@ public function testDocumentationSidebarMenu()
         $this->sidebar()->assertEquals([]);
     }
 
+    // Main navigation menu tests
+
     public function testMainNavigationMenuWithPages()
     {
         $this->withPages([
@@ -290,6 +294,8 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Documentation sidebar menu tests
+
     public function testSidebarWithPages()
     {
         $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
@@ -480,6 +486,8 @@ public function testSidebarWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Testing helpers
+
     protected function assertSidebarEquals(array $expected, array $menuPages): void
     {
         $this->sidebar($menuPages)->assertEquals($expected);

From f6b3564d6af6283b9de9c80679fae97f2842ced2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 14:17:16 +0100
Subject: [PATCH 0353/4023] Add base main navigation subdirectory handling
 tests

---
 .../AutomaticNavigationConfigurationsTest.php | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a9253494fb7..20d36b0cdc4 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -294,6 +294,42 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Main navigation subdirectory handling tests
+
+    public function testPagesInSubdirectoriesAreNotAddedToNavigation()
+    {
+        $this->assertMenuEquals([], [
+            new MarkdownPage('about/foo'),
+            new MarkdownPage('about/bar'),
+            new MarkdownPage('about/baz'),
+        ]);
+    }
+
+    public function testPagesInSubdirectoriesAreAddedToNavigationWhenNavigationSubdirectoriesIsSetToFlat()
+    {
+        config(['hyde.navigation.subdirectories' => 'flat']);
+
+        $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
+            new MarkdownPage('about/foo'),
+            new MarkdownPage('about/bar'),
+            new MarkdownPage('about/baz'),
+        ]);
+    }
+
+    public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdirectoriesIsSetToDropdown()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals([
+            ['Foo', 'Bar', 'Baz'],
+            // TODO: New state will be ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
+        ], [
+            new MarkdownPage('about/foo'),
+            new MarkdownPage('about/bar'),
+            new MarkdownPage('about/baz'),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()

From 388b31faa74a89c7729dea0424c8803f79561a29 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 15:05:49 +0100
Subject: [PATCH 0354/4023] Add base sidebar subdirectory handling tests

---
 .../AutomaticNavigationConfigurationsTest.php | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 20d36b0cdc4..4941d20feb3 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -522,6 +522,46 @@ public function testSidebarWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Sidebar subdirectory handling tests
+
+    public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()
+    {
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'group' => 'about'],
+            ['label' => 'Bar', 'group' => 'about'],
+            ['label' => 'Baz', 'group' => 'about'],
+        ], [
+            new DocumentationPage('about/foo'),
+            new DocumentationPage('about/bar'),
+            new DocumentationPage('about/baz'),
+        ]);
+    }
+
+    public function testPagesInSubdirectoriesAreAddedToSidebarWhenSidebarSubdirectoriesIsSetToFlat()
+    {
+        config(['hyde.navigation.subdirectories' => 'flat']);
+
+        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
+            new DocumentationPage('about/foo'),
+            new DocumentationPage('about/bar'),
+            new DocumentationPage('about/baz'),
+        ]);
+    }
+
+    public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenSidebarSubdirectoriesIsSetToDropdown()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertSidebarEquals([
+            'Foo', 'Bar', 'Baz',
+            // TODO: New state will be ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
+        ], [
+            new DocumentationPage('about/foo'),
+            new DocumentationPage('about/bar'),
+            new DocumentationPage('about/baz'),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From 58d25c186c9a389dc7505188206e887022c12776 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:27:42 +0100
Subject: [PATCH 0355/4023] Proof of concept for using index pages as dropdown
 parent

See https://github.com/hydephp/develop/pull/1568#issuecomment-1950223514
---
 .../Navigation/GeneratesMainNavigationMenu.php     | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0131bf34f31..bbc972966f0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -71,8 +71,20 @@ protected function moveGroupedItemsIntoDropdowns(): void
         }
 
         foreach ($dropdowns as $group => $items) {
+            // If items contain an index page, we use that as the dropdown root (TODO handle external links)
+            $hasIndex = collect($items)->first(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index');
+
+            if ($hasIndex) {
+                /** @var NavItem $index */
+                $index = collect($items)->first(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index');
+                $items = collect($items)->reject(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index')->values();
+                $dropdown = new NavItem($index->getDestination(), $index->getLabel(), $index->getPriority(), $group, $items->all());
+            } else {
+                $dropdown = NavItem::dropdown($group, $items);
+            }
+
             // Create a new dropdown item containing the buffered items
-            $this->items->add(NavItem::dropdown($group, $items));
+            $this->items->add($dropdown);
         }
     }
 

From 74684acb54c3299e72381f846538930a97ebfccf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:28:03 +0100
Subject: [PATCH 0356/4023] Add todo

---
 packages/framework/resources/views/layouts/navigation.blade.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 899ccd75f31..6884496f0d4 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,4 +1,5 @@
 @php
+    // Todo consider passing from shared view data?
     $navigation = app('navigation')->getMenu('main');
 @endphp
 

From 8f1511d7972cab40c03acb4fac60b43529588a74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:28:06 +0100
Subject: [PATCH 0357/4023] Revert "Add todo"

This reverts commit 74684acb54c3299e72381f846538930a97ebfccf.
---
 packages/framework/resources/views/layouts/navigation.blade.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 6884496f0d4..899ccd75f31 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,4 @@
 @php
-    // Todo consider passing from shared view data?
     $navigation = app('navigation')->getMenu('main');
 @endphp
 

From b00c434bd45986e606e1ffd17498fbc506d8c8d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:28:15 +0100
Subject: [PATCH 0358/4023] Revert "Proof of concept for using index pages as
 dropdown parent"

This reverts commit 58d25c186c9a389dc7505188206e887022c12776 as it has issues on mobile UX. See https://twitter.com/CodeWithCaen/status/1758864331083489579
---
 .../Navigation/GeneratesMainNavigationMenu.php     | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index bbc972966f0..0131bf34f31 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -71,20 +71,8 @@ protected function moveGroupedItemsIntoDropdowns(): void
         }
 
         foreach ($dropdowns as $group => $items) {
-            // If items contain an index page, we use that as the dropdown root (TODO handle external links)
-            $hasIndex = collect($items)->first(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index');
-
-            if ($hasIndex) {
-                /** @var NavItem $index */
-                $index = collect($items)->first(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index');
-                $items = collect($items)->reject(fn (NavItem $item): bool => basename($item->getDestination()->getPageIdentifier()) === 'index')->values();
-                $dropdown = new NavItem($index->getDestination(), $index->getLabel(), $index->getPriority(), $group, $items->all());
-            } else {
-                $dropdown = NavItem::dropdown($group, $items);
-            }
-
             // Create a new dropdown item containing the buffered items
-            $this->items->add($dropdown);
+            $this->items->add(NavItem::dropdown($group, $items));
         }
     }
 

From 1224416c283b24897295e02d4764d60b7438b493 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:31:32 +0100
Subject: [PATCH 0359/4023] Add todo

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8aa758eb100..77d2403a3e6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -92,6 +92,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
+        // TODO resolve label from config here instead of view
         return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
     }
 

From 4b4a9abab5960dcfe0c93676f0403f0d8d7da48a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:38:54 +0100
Subject: [PATCH 0360/4023] Normalize navigation item group keys at construct
 time

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 2 +-
 packages/framework/tests/Unit/NavItemTest.php               | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 77d2403a3e6..c01de3a004b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -45,7 +45,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->destination = $destination;
         $this->label = $label;
         $this->priority = $priority;
-        $this->group = $group;
+        $this->group = static::normalizeGroupKey($group);
         $this->children = $children;
     }
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 78e3407b0f7..c3996365c55 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -342,4 +342,10 @@ public function testGetGroupForRouteWithGroup()
     {
         $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroup());
     }
+
+    public function testGroupKeysAreNormalized()
+    {
+        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
+        $this->assertSame('foo-bar', $item->getGroup());
+    }
 }

From 6905c631ba5532d1cda75bbd111e1888a4e7c9aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:42:47 +0100
Subject: [PATCH 0361/4023] Simplify static helper for logic now handled in
 constructor

---
 .../src/Framework/Features/Navigation/NavItem.php      | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c01de3a004b..ce0f247ed48 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -58,7 +58,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
             $route,
             $label ?? $route->getPage()->navigationMenuLabel(),
             $priority ?? $route->getPage()->navigationMenuPriority(),
-            $group ?? static::getRouteGroup($route),
+            $group ?? $route->getPage()->data('navigation.group'),
         );
     }
 
@@ -174,14 +174,6 @@ public function isCurrent(): bool
         return Hyde::currentRoute()->getLink() === (string) $this->destination;
     }
 
-    protected static function getRouteGroup(Route $route): ?string
-    {
-        /** @var string|null $group */
-        $group = $route->getPage()->data('navigation.group');
-
-        return static::normalizeGroupKey($group);
-    }
-
     protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;

From 42ab213a44a94ee24d28640c5d6a00b889e7b800 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 18:44:10 +0100
Subject: [PATCH 0362/4023] Remove title logic from view

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 899ccd75f31..d7f8edcde5b 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -36,7 +36,7 @@
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item->hasChildren())
-                        <x-hyde::navigation.dropdown :label="\Hyde\Hyde::makeTitle($item->label)" :items="$item->getChildren()"/>
+                        <x-hyde::navigation.dropdown :label="$item->label" :items="$item->getChildren()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')
                     @endif

From 0d4897b23f1b508d146a0c83a8f2348cec03003c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:21:51 +0100
Subject: [PATCH 0363/4023] Add section comments

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 4941d20feb3..78d218ed38c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -102,6 +102,8 @@ public function testRedirectPagesAreAddedToNavigationMenu()
         ]);
     }
 
+    // Main navigation front matter tests
+
     public function testDefaultNavigationPriorities()
     {
         $this->assertMenuEquals([
@@ -354,6 +356,8 @@ public function testOnlyDocumentationPagesAreAddedToSidebar()
         ]);
     }
 
+    // Documentation sidebar front matter tests
+
     public function testSidebarWithFrontMatterPriority()
     {
         $this->assertSidebarEquals(['First', 'Second', 'Third'], [

From 193f0b597f8d0d81e3848b1e8f319bf5a4f09fde Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:38:40 +0100
Subject: [PATCH 0364/4023] Add main navigation configuration tests section

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 78d218ed38c..e7918deabdd 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -296,6 +296,8 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Main navigation configuration tests
+
     // Main navigation subdirectory handling tests
 
     public function testPagesInSubdirectoriesAreNotAddedToNavigation()

From 1381d299695c71bf81fe3cc2421716fbeedb3454 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:40:03 +0100
Subject: [PATCH 0365/4023] Add config order tests

---
 .../AutomaticNavigationConfigurationsTest.php | 90 +++++++++++++++++++
 1 file changed, 90 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e7918deabdd..a26691191f1 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -298,6 +298,96 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
 
     // Main navigation configuration tests
 
+    public function testMainNavigationMenuWithConfigOrder()
+    {
+        config(['hyde.navigation.order' => ['first', 'second', 'third']]);
+
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+
+        config(['hyde.navigation.order' => ['third', 'second', 'first']]);
+
+        $this->assertMenuEquals(['Third', 'Second', 'First'], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+    }
+
+    public function testMainNavigationMenuWithConfigOrderHasInferredPriorities()
+    {
+        $this->assertMenuEquals([
+            ['priority' => 999],
+            ['priority' => 999],
+            ['priority' => 999],
+        ], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+
+        config(['hyde.navigation.order' => ['first', 'second', 'third']]);
+
+        $this->assertMenuEquals([
+            ['priority' => 500],
+            ['priority' => 501],
+            ['priority' => 502],
+        ], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+    }
+
+    public function testMainNavigationMenuWithExplicitConfigOrder()
+    {
+        config(['hyde.navigation.order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+
+        config(['hyde.navigation.order' => ['first' => 3, 'second' => 2, 'third' => 1]]);
+
+        $this->assertMenuEquals(['Third', 'Second', 'First'], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+
+        config(['hyde.navigation.order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+
+        $this->assertMenuEquals([
+            ['label' => 'First', 'priority' => 1],
+            ['label' => 'Second', 'priority' => 2],
+            ['label' => 'Third', 'priority' => 3],
+        ], [
+            new MarkdownPage('first'),
+            new MarkdownPage('second'),
+            new MarkdownPage('third'),
+        ]);
+    }
+
+    public function testMainNavigationMenuWithMixedConfigOrders()
+    {
+        config(['hyde.navigation.order' => ['foo', 'bar' => 650]]);
+
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'priority' => 500],
+            ['label' => 'Bar', 'priority' => 650],
+            ['label' => 'Baz', 'priority' => 999],
+        ], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('bar'),
+            new MarkdownPage('baz'),
+        ]);
+    }
+
     // Main navigation subdirectory handling tests
 
     public function testPagesInSubdirectoriesAreNotAddedToNavigation()

From 71d12989ea5d35230852fa5f050ec607def889c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:51:25 +0100
Subject: [PATCH 0366/4023] Test main navigation menu with config labels

---
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a26691191f1..c1d3ecfd633 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -388,6 +388,17 @@ public function testMainNavigationMenuWithMixedConfigOrders()
         ]);
     }
 
+    public function testMainNavigationMenuWithConfigLabels()
+    {
+        config(['hyde.navigation.labels' => ['foo' => 'First', 'bar' => 'Second', 'baz' => 'Third']]);
+
+        $this->assertMenuEquals(['First', 'Second', 'Third'], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('bar'),
+            new MarkdownPage('baz'),
+        ]);
+    }
+
     // Main navigation subdirectory handling tests
 
     public function testPagesInSubdirectoriesAreNotAddedToNavigation()

From 9f3b40c20f789deb9d6a67f5b2aa94b9daaf7dc0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:52:59 +0100
Subject: [PATCH 0367/4023] Test main navigation menu with config hidden

---
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c1d3ecfd633..959464b80c0 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -399,6 +399,17 @@ public function testMainNavigationMenuWithConfigLabels()
         ]);
     }
 
+    public function testMainNavigationMenuWithConfigHidden()
+    {
+        config(['hyde.navigation.exclude' => ['foo', 'bar', 'baz']]);
+
+        $this->assertMenuEquals([], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('bar'),
+            new MarkdownPage('baz'),
+        ]);
+    }
+
     // Main navigation subdirectory handling tests
 
     public function testPagesInSubdirectoriesAreNotAddedToNavigation()

From 4ce527a6d6f64e66421fbce4416c6a1b5b80be2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 17 Feb 2024 21:58:36 +0100
Subject: [PATCH 0368/4023] Add test placeholders

---
 .../Feature/AutomaticNavigationConfigurationsTest.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 959464b80c0..d502b09d0ed 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -399,6 +399,16 @@ public function testMainNavigationMenuWithConfigLabels()
         ]);
     }
 
+    public function testMainNavigationDropdownLabelsCanBeSetInConfig()
+    {
+        $this->markTestSkipped('Not yet implemented');
+    }
+
+    public function testMainNavigationAutomaticDropdownLabelsCanBeSetInConfig()
+    {
+        $this->markTestSkipped('Not yet implemented');
+    }
+
     public function testMainNavigationMenuWithConfigHidden()
     {
         config(['hyde.navigation.exclude' => ['foo', 'bar', 'baz']]);

From 9ceeda415b52148dea2b0d7dedeb01777ad58fc1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 13:16:08 +0100
Subject: [PATCH 0369/4023] Add sidebar config tests

---
 .../AutomaticNavigationConfigurationsTest.php | 130 ++++++++++++++++++
 1 file changed, 130 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d502b09d0ed..7a757b9e48c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -650,6 +650,136 @@ public function testSidebarWithFrontMatterGroupAndCategory()
         ]);
     }
 
+    // Sidebar configuration tests
+
+    public function testSidebarWithConfigOrder()
+    {
+        // TODO should be sidebar.order instead of docs.sidebar_order
+
+        config(['docs.sidebar_order' => ['first', 'second', 'third']]);
+
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+
+        config(['docs.sidebar_order' => ['third', 'second', 'first']]);
+
+        $this->assertSidebarEquals(['Third', 'Second', 'First'], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+    }
+
+    public function testSidebarWithConfigOrderHasInferredPriorities()
+    {
+        $this->assertSidebarEquals([
+            ['priority' => 999],
+            ['priority' => 999],
+            ['priority' => 999],
+        ], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+
+        config(['docs.sidebar_order' => ['first', 'second', 'third']]);
+
+        $this->assertSidebarEquals([
+            ['priority' => 500],
+            ['priority' => 501],
+            ['priority' => 502],
+        ], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+    }
+
+    public function testSidebarWithExplicitConfigOrder()
+    {
+        config(['docs.sidebar_order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+
+        config(['docs.sidebar_order' => ['first' => 3, 'second' => 2, 'third' => 1]]);
+
+        $this->assertSidebarEquals(['Third', 'Second', 'First'], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+
+        config(['docs.sidebar_order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+
+        $this->assertSidebarEquals([
+            ['label' => 'First', 'priority' => 1],
+            ['label' => 'Second', 'priority' => 2],
+            ['label' => 'Third', 'priority' => 3],
+        ], [
+            new DocumentationPage('first'),
+            new DocumentationPage('second'),
+            new DocumentationPage('third'),
+        ]);
+    }
+
+    public function testSidebarWithMixedConfigOrders()
+    {
+        config(['docs.sidebar_order' => ['foo', 'bar' => 650]]);
+
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'priority' => 500],
+            ['label' => 'Bar', 'priority' => 650],
+            ['label' => 'Baz', 'priority' => 999],
+        ], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ]);
+    }
+
+    public function testSidebarWithConfigLabels()
+    {
+        $this->markTestSkipped('Not supported (yet?)');
+
+        config(['docs.sidebar.labels' => ['foo' => 'First', 'bar' => 'Second', 'baz' => 'Third']]);
+
+        $this->assertSidebarEquals(['First', 'Second', 'Third'], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ]);
+    }
+
+    public function testSidebarDropdownLabelsCanBeSetInConfig()
+    {
+        $this->markTestSkipped('Not yet implemented');
+    }
+
+    public function testSidebarAutomaticDropdownLabelsCanBeSetInConfig()
+    {
+        $this->markTestSkipped('Not yet implemented');
+    }
+
+    public function testSidebarWithConfigHidden()
+    {
+        $this->markTestSkipped('Not supported (yet?)');
+
+        config(['docs.sidebar.exclude' => ['foo', 'bar', 'baz']]);
+
+        $this->assertSidebarEquals([], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ]);
+    }
+
     // Sidebar subdirectory handling tests
 
     public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()

From afd5e6c265ba3414ce63b62f8f843f161a245fcf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 14:49:00 +0100
Subject: [PATCH 0370/4023] Merge tests to use loop providing better clarity

---
 .../AutomaticNavigationConfigurationsTest.php | 40 ++++++++-----------
 1 file changed, 17 insertions(+), 23 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 7a757b9e48c..d9687910ee4 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -795,29 +795,23 @@ public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()
         ]);
     }
 
-    public function testPagesInSubdirectoriesAreAddedToSidebarWhenSidebarSubdirectoriesIsSetToFlat()
-    {
-        config(['hyde.navigation.subdirectories' => 'flat']);
-
-        $this->assertSidebarEquals(['Foo', 'Bar', 'Baz'], [
-            new DocumentationPage('about/foo'),
-            new DocumentationPage('about/bar'),
-            new DocumentationPage('about/baz'),
-        ]);
-    }
-
-    public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenSidebarSubdirectoriesIsSetToDropdown()
-    {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
-
-        $this->assertSidebarEquals([
-            'Foo', 'Bar', 'Baz',
-            // TODO: New state will be ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
-        ], [
-            new DocumentationPage('about/foo'),
-            new DocumentationPage('about/bar'),
-            new DocumentationPage('about/baz'),
-        ]);
+    public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfiguration()
+    {
+        $options = ['dropdown', 'flat', 'hidden'];
+
+        foreach ($options as $option) {
+            config(['docs.sidebar.subdirectories' => $option]);
+
+            $this->assertSidebarEquals([
+                ['label' => 'Foo', 'group' => 'about'],
+                ['label' => 'Bar', 'group' => 'about'],
+                ['label' => 'Baz', 'group' => 'about'],
+            ], [
+                new DocumentationPage('about/foo'),
+                new DocumentationPage('about/bar'),
+                new DocumentationPage('about/baz'),
+            ]);
+        }
     }
 
     // Testing helpers

From c639ccce8faef690d9729721d3a32315844dbc8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 14:50:52 +0100
Subject: [PATCH 0371/4023] Temporarily commit broken Idea file (WI-76125)

Getting tired of having to unstage this file all the time, so committing it to be removed before PR merge. This is due to a known bug that does not have high enough priority. See https://youtrack.jetbrains.com/issue/WI-76125/PhpStorm-has-started-to-add-an-undesired-line-to-.idea-php-test-framework.xml-when-running-Pest-PHPUnit-tests
---
 .idea/php-test-framework.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.idea/php-test-framework.xml b/.idea/php-test-framework.xml
index f990e0a96bb..8ecfa3b3072 100644
--- a/.idea/php-test-framework.xml
+++ b/.idea/php-test-framework.xml
@@ -17,6 +17,7 @@
         <cache>
           <versions>
             <info id="Local" version="9.5.21" />
+            <info id="LocalH:\monorepo\vendor\autoload.php" version="10.4.2" />
           </versions>
         </cache>
       </tool>

From 5fd8344328541b5c30eb3555364d105dba72d4de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 14:55:23 +0100
Subject: [PATCH 0372/4023] Add crosslinks between related actions

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 ++
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 3221bfa3ada..77562aabef1 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -13,6 +13,8 @@
  * @experimental This class may change significantly before its release.
  *
  * @todo Consider making into a service which can create the sidebar as well.
+ *
+ * @see \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  */
 class GeneratesDocumentationSidebarMenu
 {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0131bf34f31..832248bd43f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -16,6 +16,8 @@
  * @experimental This class may change significantly before its release.
  *
  * @todo Consider making into a service which can create the sidebar as well.
+ *
+ * @see \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  */
 class GeneratesMainNavigationMenu
 {

From de4bedaab4c707d94bf26488f3157b746ee39b36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 15:24:32 +0100
Subject: [PATCH 0373/4023] Add navigation item label filtering tests

---
 .../AutomaticNavigationConfigurationsTest.php | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d9687910ee4..320f10d73d2 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -456,6 +456,34 @@ public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdir
         ]);
     }
 
+    public function testMainNavigationMenuItemsWithTheSameLabelAreFiltered()
+    {
+        $this->assertMenuEquals(['Foo'], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('foo'),
+        ]);
+
+        $this->assertMenuEquals(['Foo'], [
+            new MarkdownPage('foo', ['navigation.label' => 'Foo']),
+            new MarkdownPage('bar', ['navigation.label' => 'Foo']),
+        ]);
+    }
+
+    public function testMainNavigationMenuItemsWithTheSameLabelAreFilteredCaseInsensitive()
+    {
+        $this->markTestSkipped('Not yet implemented, but we should, as identifiers on some systems are case insensitive, and it makes sense to match that to labels');
+
+        $this->assertMenuEquals(['Foo'], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('FOO'),
+        ]);
+
+        $this->assertMenuEquals(['Foo'], [
+            new MarkdownPage('foo', ['navigation.label' => 'foo']),
+            new MarkdownPage('bar', ['navigation.label' => 'Foo']),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()
@@ -814,6 +842,34 @@ public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfigurat
         }
     }
 
+    public function testSidebarItemsWithTheSameLabelAreFiltered()
+    {
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('foo'),
+        ]);
+
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('foo', ['navigation.label' => 'Foo']),
+            new DocumentationPage('bar', ['navigation.label' => 'Foo']),
+        ]);
+    }
+
+    public function testSidebarItemsWithTheSameLabelAreFilteredCaseInsensitive()
+    {
+        $this->markTestSkipped('Not yet implemented, but we should, as identifiers on some systems are case insensitive, and it makes sense to match that to labels');
+
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('foo'),
+            new DocumentationPage('FOO'),
+        ]);
+
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('foo', ['navigation.label' => 'foo']),
+            new DocumentationPage('bar', ['navigation.label' => 'Foo']),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From c9ab278724299fe9884ce72f9d193ac94553ba2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 16:05:05 +0100
Subject: [PATCH 0374/4023] Add navigation group filtering tests

---
 .../AutomaticNavigationConfigurationsTest.php | 93 +++++++++++++++++++
 1 file changed, 93 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 320f10d73d2..6f01a7fc931 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -484,6 +484,45 @@ public function testMainNavigationMenuItemsWithTheSameLabelAreFilteredCaseInsens
         ]);
     }
 
+    public function testMainNavigationMenuItemsWithSameLabelButDifferentGroupsAreNotFiltered()
+    {
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Foo', 'group' => 'group-2'],
+        ], [
+            new MarkdownPage('foo', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 1']),
+            new MarkdownPage('bar', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 2']),
+        ]);
+    }
+
+    public function testMainNavigationMenuDropdownItemsWithSameLabelButDifferentGroupsAreNotFiltered()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals([
+            // Todo: Should use proper group name
+            ['label' => 'group-1', 'children' => ['Foo']],
+            ['label' => 'group-2', 'children' => ['Foo']],
+        ], [
+            new MarkdownPage('one/foo', ['navigation.group' => 'Group 1']),
+            new MarkdownPage('two/foo', ['navigation.group' => 'Group 2']),
+        ]);
+    }
+
+    public function testMainNavigationMenuAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreNotFiltered()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals([
+            // Todo: Should use proper group name
+            ['label' => 'one', 'children' => ['Foo']],
+            ['label' => 'two', 'children' => ['Foo']],
+        ], [
+            new MarkdownPage('one/foo'),
+            new MarkdownPage('two/foo'),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()
@@ -870,6 +909,60 @@ public function testSidebarItemsWithTheSameLabelAreFilteredCaseInsensitive()
         ]);
     }
 
+    public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
+    {
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Foo', 'group' => 'group-2'],
+        ], [
+            new DocumentationPage('foo', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 1']),
+            new DocumentationPage('bar', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 2']),
+        ]);
+    }
+
+    public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
+    {
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
+            new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
+        ]);
+    }
+
+    public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
+    {
+        $this->assertSidebarEquals(['Foo'], [
+            new DocumentationPage('one/foo'),
+            new DocumentationPage('two/foo'),
+        ]);
+    }
+
+    public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreNotFilteredWithFlattenedOutputPaths()
+    {
+        config(['docs.flattened_output_paths' => false]);
+
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'group' => 'group-1'],
+            ['label' => 'Foo', 'group' => 'group-2'],
+        ], [
+            new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
+            new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
+        ]);
+    }
+
+    public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreNotFilteredWithFlattenedOutputPaths()
+    {
+        config(['docs.flattened_output_paths' => false]);
+
+        $this->assertSidebarEquals([
+            // Todo: Should use proper group name
+            ['label' => 'Foo', 'group' => 'one'],
+            ['label' => 'Foo', 'group' => 'two'],
+        ], [
+            new DocumentationPage('one/foo'),
+            new DocumentationPage('two/foo'),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From 3088d902a16c3face3739938721dd1a6f1bea5b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 17:58:28 +0100
Subject: [PATCH 0375/4023] Make navigation item duplicate filtering case
 insensitive

As identifiers on some systems are case insensitive, and it makes sense to match that to labels
---
 .../Navigation/GeneratesDocumentationSidebarMenu.php |  3 ++-
 .../Navigation/GeneratesMainNavigationMenu.php       |  3 ++-
 .../AutomaticNavigationConfigurationsTest.php        | 12 ++++++------
 3 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 77562aabef1..9b254c75e31 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -60,7 +61,7 @@ protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
             // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().$item->label;
+            return $item->getGroup().Str::slug($item->getLabel());
         });
     }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 832248bd43f..a6edfdafa83 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
+use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -97,7 +98,7 @@ protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
             // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().$item->label;
+            return $item->getGroup().Str::slug($item->getLabel());
         });
     }
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 6f01a7fc931..fe8ffd13a65 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -471,16 +471,16 @@ public function testMainNavigationMenuItemsWithTheSameLabelAreFiltered()
 
     public function testMainNavigationMenuItemsWithTheSameLabelAreFilteredCaseInsensitive()
     {
-        $this->markTestSkipped('Not yet implemented, but we should, as identifiers on some systems are case insensitive, and it makes sense to match that to labels');
-
         $this->assertMenuEquals(['Foo'], [
             new MarkdownPage('foo'),
+            new MarkdownPage('Foo'),
             new MarkdownPage('FOO'),
         ]);
 
-        $this->assertMenuEquals(['Foo'], [
+        $this->assertMenuEquals(['foo'], [
             new MarkdownPage('foo', ['navigation.label' => 'foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
+            new MarkdownPage('baz', ['navigation.label' => 'FOO']),
         ]);
     }
 
@@ -896,16 +896,16 @@ public function testSidebarItemsWithTheSameLabelAreFiltered()
 
     public function testSidebarItemsWithTheSameLabelAreFilteredCaseInsensitive()
     {
-        $this->markTestSkipped('Not yet implemented, but we should, as identifiers on some systems are case insensitive, and it makes sense to match that to labels');
-
         $this->assertSidebarEquals(['Foo'], [
             new DocumentationPage('foo'),
+            new DocumentationPage('Foo'),
             new DocumentationPage('FOO'),
         ]);
 
-        $this->assertSidebarEquals(['Foo'], [
+        $this->assertSidebarEquals(['foo'], [
             new DocumentationPage('foo', ['navigation.label' => 'foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),
+            new DocumentationPage('baz', ['navigation.label' => 'FOO']),
         ]);
     }
 

From 2ca0ec6b6917639ca5ff70fba093683595255974 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 19:04:07 +0100
Subject: [PATCH 0376/4023] Remove unused test helpers

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fe8ffd13a65..d4e6df9af5b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1049,18 +1049,6 @@ public function getState(int $index): ?TestNavItem
         return $this->state()[$index] ?? null;
     }
 
-    /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
-    public function dd(): void
-    {
-        dd($this->items);
-    }
-
-    /** @noinspection PhpUnused, PhpNoReturnAttributeCanBeAddedInspection */
-    public function ddState(): void
-    {
-        dd($this->state());
-    }
-
     /**
      * @param  array  $expected  The expected state format
      * @param  bool  $strict  If false, missing array keys are ignored

From b0a7e94dd14518eb78fff27a85960723c9fb337a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 20:00:40 +0100
Subject: [PATCH 0377/4023] Add todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 9b254c75e31..cc9b9e25488 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -61,7 +61,7 @@ protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
             // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().Str::slug($item->getLabel());
+            return $item->getGroup().Str::slug($item->getLabel()); // Todo we could use this as the "identifier" for the item, as it uniquely identifies it
         });
     }
 

From b773f12ab653267108c10678f9ee0d4f47b380f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:05:29 +0100
Subject: [PATCH 0378/4023] Add testing helper

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d4e6df9af5b..c866603b2ee 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -11,6 +11,7 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Foundation\HydeKernel;
+use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\Redirect;
@@ -975,6 +976,12 @@ protected function assertMenuEquals(array $expected, array $menuPages): void
         $this->menu($menuPages)->assertEquals($expected);
     }
 
+    #[NoReturn]
+    protected function ddMenu(?array $menuPages = null): void
+    {
+        dd($this->menu($menuPages)->state());
+    }
+
     protected function menu(?array $withPages = null): AssertableNavigationMenu
     {
         if ($withPages) {

From f03eb689f862900f32d58a55e6762c6ceaca6ccc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:05:58 +0100
Subject: [PATCH 0379/4023] Assert on the new state

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c866603b2ee..f42c61c8d3a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -448,8 +448,8 @@ public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdir
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         $this->assertMenuEquals([
-            ['Foo', 'Bar', 'Baz'],
-            // TODO: New state will be ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
+            ['label' => 'about', 'children' => ['Foo', 'Bar', 'Baz']],
+            // TODO: Label should be About
         ], [
             new MarkdownPage('about/foo'),
             new MarkdownPage('about/bar'),

From 66a4b903988297f58e0cfcd7ed8ba02d95b3c40a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:19:15 +0100
Subject: [PATCH 0380/4023] Update testing helper

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f42c61c8d3a..971dfd11f9c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -977,8 +977,12 @@ protected function assertMenuEquals(array $expected, array $menuPages): void
     }
 
     #[NoReturn]
-    protected function ddMenu(?array $menuPages = null): void
+    protected function ddMenu(?array $menuPages = null, ?string $menu = 'menu'): void
     {
+        if ($menu === 'sidebar') {
+            dd($this->sidebar($menuPages)->state());
+        }
+
         dd($this->menu($menuPages)->state());
     }
 

From 74c9fd0b70310557af36ec3d1ee468f344004073 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:24:44 +0100
Subject: [PATCH 0381/4023] Push group as null

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index cc9b9e25488..1275944aebf 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -48,7 +48,7 @@ protected function generate(): void
 
         // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
         if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-            $this->items->push(NavItem::fromRoute(DocumentationPage::home(), group: 'other'));
+            $this->items->push(NavItem::fromRoute(DocumentationPage::home(), group: null));
         }
     }
 

From 1eb8a5aed8ee386e778fe0f450e4dd3c639dd07a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:25:16 +0100
Subject: [PATCH 0382/4023] Compare against null

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index eba36a0d3ac..7ac9725e22d 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -39,7 +39,7 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        return (count($this->getGroups()) >= 1) && ($this->getGroups() !== ['other']);
+        return (count($this->getGroups()) >= 1) && ($this->getGroups() !== [null]);
     }
 
     /** @return array<string> */
@@ -89,7 +89,7 @@ private function isPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === 'other';
+        $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
         $groupIsTheFirstOneInSidebar = $group === collect($this->getGroups())->first();
 
         return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;

From 9ef346504686484aa5725c5e8c0918061a753590 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:30:57 +0100
Subject: [PATCH 0383/4023] Compare against null

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php | 2 +-
 packages/framework/tests/Feature/HydePageTest.php               | 2 +-
 .../framework/tests/Unit/Pages/DocumentationPageUnitTest.php    | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 51827a4d0a0..12f6267a6fc 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -211,7 +211,7 @@ private function canUseSubdirectoryForGroups(): bool
     private function defaultGroup(): ?string
     {
         // TODO: It would be better if this was null in all cases, considering 'other' is used a a sort of confusing pseudo-null
-        return $this->isInstanceOf(DocumentationPage::class) ? 'other' : null;
+        return $this->isInstanceOf(DocumentationPage::class) ? null : null;
     }
 
     private function pageIsInSubdirectory(): bool
diff --git a/packages/framework/tests/Feature/HydePageTest.php b/packages/framework/tests/Feature/HydePageTest.php
index dde95fffb96..4e545c1a9d6 100644
--- a/packages/framework/tests/Feature/HydePageTest.php
+++ b/packages/framework/tests/Feature/HydePageTest.php
@@ -239,7 +239,7 @@ public function testNavigationMenuGroup()
         $this->assertNull((new MarkdownPage())->navigationMenuGroup());
         $this->assertNull((new MarkdownPost())->navigationMenuGroup());
         $this->assertNull((new HtmlPage())->navigationMenuGroup());
-        $this->assertSame('other', (new DocumentationPage())->navigationMenuGroup());
+        $this->assertSame(null, (new DocumentationPage())->navigationMenuGroup());
         $this->assertSame('foo', DocumentationPage::make(matter: ['navigation' => ['group' => 'foo']])->navigationMenuGroup());
     }
 
diff --git a/packages/framework/tests/Unit/Pages/DocumentationPageUnitTest.php b/packages/framework/tests/Unit/Pages/DocumentationPageUnitTest.php
index 2ef2ae376ed..f24ded96215 100644
--- a/packages/framework/tests/Unit/Pages/DocumentationPageUnitTest.php
+++ b/packages/framework/tests/Unit/Pages/DocumentationPageUnitTest.php
@@ -98,7 +98,7 @@ public function testNavigationMenuLabel()
 
     public function testNavigationMenuGroup()
     {
-        $this->assertSame('other', (new DocumentationPage('foo'))->navigationMenuGroup());
+        $this->assertSame(null, (new DocumentationPage('foo'))->navigationMenuGroup());
     }
 
     public function testNavigationMenuGroupWithData()

From 8b66dd025c5b268fbe37479c45032934016f217e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:35:02 +0100
Subject: [PATCH 0384/4023] Expect null

---
 packages/framework/tests/Unit/HydePageSerializableUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HydePageSerializableUnitTest.php b/packages/framework/tests/Unit/HydePageSerializableUnitTest.php
index 9462f29728c..149e184dee6 100644
--- a/packages/framework/tests/Unit/HydePageSerializableUnitTest.php
+++ b/packages/framework/tests/Unit/HydePageSerializableUnitTest.php
@@ -347,7 +347,7 @@ public function testJsonSerializedDocumentationPageContents()
                     "label": "",
                     "priority": 999,
                     "hidden": false,
-                    "group": "other"
+                    "group": null
                 },
                 "title": ""
             }

From 8cd042487ef22371cca574f9a6f147d1784bae3e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:33:37 +0100
Subject: [PATCH 0385/4023] Allow nullable return

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 7ac9725e22d..06f8e12286a 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -45,7 +45,7 @@ public function hasGroups(): bool
     /** @return array<string> */
     public function getGroups(): array
     {
-        return $this->items->map(function (NavItem $item): string {
+        return $this->items->map(function (NavItem $item): ?string {
             return $item->getGroup();
         })->unique()->toArray();
     }

From 4dca8c5fc75cf85413385890429a75efd07d2f54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:47:38 +0100
Subject: [PATCH 0386/4023] Test sidebar with mixed grouped and ungrouped items

---
 .../tests/Feature/SidebarViewTest.php         | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index 44840e6440e..2dcd7646d91 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -169,6 +169,31 @@ public function testSidebarWithNonCollapsibleGroupedItems()
         $this->assertViewWasNotRendered(view('hyde::components.docs.sidebar-group-toggle-button'));
     }
 
+    public function testSidebarWithMixedGroupedAndUngroupedItems()
+    {
+        $this->mockRoute();
+        $this->mockPage();
+        $this->file('_docs/index.md');
+        $this->markdown('_docs/first.md', matter: ['navigation.group' => 'Group 1']);
+        $this->markdown('_docs/second.md');
+
+        $this->renderComponent(view('hyde::components.docs.sidebar'))
+            ->assertSeeText('Group 1')
+            ->assertSeeText('First')
+            ->assertSeeText('Other')
+            ->assertSeeText('Second')
+            ->assertSeeHtml('href="docs/first.html"')
+            ->assertSeeHtml('href="docs/second.html"')
+            ->allGood();
+
+        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
+            'sidebar' => DocumentationSidebar::create(),
+            'grouped' => true,
+        ]));
+
+        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-group-toggle-button'));
+    }
+
     protected function renderComponent(View $view): self
     {
         try {

From deb0e57cb18eafc8610753ec517e0bd0cf50c81e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:50:00 +0100
Subject: [PATCH 0387/4023] Allow null group in parameter

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 06f8e12286a..5cd4893cb34 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -64,7 +64,7 @@ public function getItemsInGroup(?string $group): Collection
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */
-    public function isGroupActive(string $group): bool
+    public function isGroupActive(?string $group): bool
     {
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);

From 66d250b72b21c9064786693017da4b05ee29788d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:50:15 +0100
Subject: [PATCH 0388/4023] Return false if group is null

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5cd4893cb34..13fdfd4469b 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -66,6 +66,10 @@ public function getItemsInGroup(?string $group): Collection
      */
     public function isGroupActive(?string $group): bool
     {
+        if ($group === null) {
+            return false;
+        }
+
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
 

From 67422aee238d1a0bd4ae3bbbe3c5e4744d0911fa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:50:59 +0100
Subject: [PATCH 0389/4023] Null coalesce to other when making group title

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 13fdfd4469b..596b1aba075 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -81,9 +81,9 @@ public function isGroupActive(?string $group): bool
      *
      * @todo Get title from instance
      */
-    public function makeGroupTitle(string $group): string
+    public function makeGroupTitle(?string $group): string
     {
-        return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
+        return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group ?? 'Other');
     }
 
     private function isPageIndexPage(): bool

From 960415b72ef6991292190ef4ba93dc5959459c46 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:54:56 +0100
Subject: [PATCH 0390/4023] Remove resolved todo

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 12f6267a6fc..2eaede36b70 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -210,7 +210,6 @@ private function canUseSubdirectoryForGroups(): bool
 
     private function defaultGroup(): ?string
     {
-        // TODO: It would be better if this was null in all cases, considering 'other' is used a a sort of confusing pseudo-null
         return $this->isInstanceOf(DocumentationPage::class) ? null : null;
     }
 

From db4166b9bd6040bd0d35c4f3e3df19a3b8891dac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:55:43 +0100
Subject: [PATCH 0391/4023] Evaluate conditional with same operands

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 2eaede36b70..1bedb99c117 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -210,7 +210,7 @@ private function canUseSubdirectoryForGroups(): bool
 
     private function defaultGroup(): ?string
     {
-        return $this->isInstanceOf(DocumentationPage::class) ? null : null;
+        return null;
     }
 
     private function pageIsInSubdirectory(): bool

From 03ce8261dad7083672e6999a47587d31718a38aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:55:58 +0100
Subject: [PATCH 0392/4023] Inline constant private helper method

---
 .../src/Framework/Factories/NavigationDataFactory.php      | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 1bedb99c117..26c230cdada 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -84,7 +84,7 @@ protected function makeGroup(): ?string
             return $this->getSubdirectoryName();
         }
 
-        return $this->searchForGroupInFrontMatter() ?? $this->defaultGroup();
+        return $this->searchForGroupInFrontMatter() ?? null;
     }
 
     protected function makeHidden(): bool
@@ -208,11 +208,6 @@ private function canUseSubdirectoryForGroups(): bool
             || $this->isInstanceOf(DocumentationPage::class);
     }
 
-    private function defaultGroup(): ?string
-    {
-        return null;
-    }
-
     private function pageIsInSubdirectory(): bool
     {
         return Str::contains($this->identifier, '/');

From 4be1a4550837702952a83166711f9bee41728aaa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:56:09 +0100
Subject: [PATCH 0393/4023] Remove unnecessary null coalesce to null

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 26c230cdada..0fb46e79da2 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -84,7 +84,7 @@ protected function makeGroup(): ?string
             return $this->getSubdirectoryName();
         }
 
-        return $this->searchForGroupInFrontMatter() ?? null;
+        return $this->searchForGroupInFrontMatter();
     }
 
     protected function makeHidden(): bool

From 3ce096794b831e348b3dcec0bd0a4f077d667bc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 21:57:46 +0100
Subject: [PATCH 0394/4023] Use null assertion helper helper

---
 packages/framework/tests/Feature/HydePageTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/HydePageTest.php b/packages/framework/tests/Feature/HydePageTest.php
index 4e545c1a9d6..158e06e56c6 100644
--- a/packages/framework/tests/Feature/HydePageTest.php
+++ b/packages/framework/tests/Feature/HydePageTest.php
@@ -239,7 +239,7 @@ public function testNavigationMenuGroup()
         $this->assertNull((new MarkdownPage())->navigationMenuGroup());
         $this->assertNull((new MarkdownPost())->navigationMenuGroup());
         $this->assertNull((new HtmlPage())->navigationMenuGroup());
-        $this->assertSame(null, (new DocumentationPage())->navigationMenuGroup());
+        $this->assertNull((new DocumentationPage())->navigationMenuGroup());
         $this->assertSame('foo', DocumentationPage::make(matter: ['navigation' => ['group' => 'foo']])->navigationMenuGroup());
     }
 

From 89f32fb98c34041fe2345aca4a36c2225281a652 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 22:05:25 +0100
Subject: [PATCH 0395/4023] Update navigation provider to register the sidebar
 generation

---
 .../src/Foundation/Providers/NavigationServiceProvider.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index edb8ee9bf13..6b10ab8d13f 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -8,6 +8,7 @@
 use Illuminate\Support\ServiceProvider;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
+use Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu;
 
 class NavigationServiceProvider extends ServiceProvider
 {
@@ -21,6 +22,7 @@ public function register(): void
 
         $this->app->make(HydeKernel::class)->booted(function () {
             $this->app->make(NavigationManager::class)->registerMenu('main', GeneratesMainNavigationMenu::handle());
+            $this->app->make(NavigationManager::class)->registerMenu('sidebar', GeneratesDocumentationSidebarMenu::handle());
         });
     }
 }

From a63e293bb43bf880086e5fc4355914f223905b2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 Feb 2024 22:08:24 +0100
Subject: [PATCH 0396/4023] Update DocumentationSidebar class to extend
 NavigationMenu

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 596b1aba075..f62493b6164 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -15,7 +15,7 @@
 use function collect;
 
 /** @deprecated Use the new NavigationMenu class instead */
-class DocumentationSidebar
+class DocumentationSidebar extends NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;

From a5f8378cb059ac3f6057ea069ea6e251fb92dbc2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 10:14:59 +0100
Subject: [PATCH 0397/4023] Use constructor from parent

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index f62493b6164..d899d4acf38 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -10,7 +10,6 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
-use Illuminate\Contracts\Support\Arrayable;
 
 use function collect;
 
@@ -20,11 +19,6 @@ class DocumentationSidebar extends NavigationMenu
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    public function __construct(Arrayable|array $items = [])
-    {
-        $this->items = new Collection($items);
-    }
-
     /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItems(): Collection
     {

From 5bd62d529c45948b8c7337ef3c5a8c991803dc46 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 10:19:50 +0100
Subject: [PATCH 0398/4023] Update sidebar component to get menu from container

---
 .../framework/resources/views/components/docs/sidebar.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 04b9857a1d5..f4f3d9c2cb3 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -4,7 +4,7 @@
     </header>
     <nav id="sidebar-navigation" class="p-2 overflow-y-auto border-y border-gray-300 dark:border-[#1b2533] h-full">
         @include('hyde::components.docs.sidebar-items', [
-            'sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::create(),
+            'sidebar' => app('navigation')->getMenu('sidebar'),
         ])
     </nav>
     @if(config('docs.sidebar.footer', true) !== false)

From daf092af323cf0146c606c2c27d3b3f7e9ed4cf3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 10:23:01 +0100
Subject: [PATCH 0399/4023] Get items from the parent method

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d899d4acf38..b5b1fb74e1e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -19,12 +19,6 @@ class DocumentationSidebar extends NavigationMenu
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
-    public function getItems(): Collection
-    {
-        return $this->items->values();
-    }
-
     /** @deprecated Will be moved to an action */
     public static function create(): static
     {

From 9765785bc12ca80169888b8403a63a791fa3540b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 10:33:58 +0100
Subject: [PATCH 0400/4023] Expand on method description

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b5b1fb74e1e..d6faae266f4 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -48,7 +48,7 @@ public function getItemsInGroup(?string $group): Collection
     }
 
     /**
-     * Is a page within the group the current page?
+     * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */

From c05b8b3a1f6ad97f0115b91e7b8dd15e4acc4e5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:37:44 +0100
Subject: [PATCH 0401/4023] Simplify conditional

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d6faae266f4..e0346aacc8c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -27,7 +27,7 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        return (count($this->getGroups()) >= 1) && ($this->getGroups() !== [null]);
+        return (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
     }
 
     /** @return array<string> */

From f16ed77c9d8ecb40e501285d4bc12002d379c829 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:42:06 +0100
Subject: [PATCH 0402/4023] Rename factory helper method to be more clear

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index a6edfdafa83..dcc88fe5878 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -54,7 +54,7 @@ protected function generate(): void
             $this->items->push($item);
         });
 
-        if ($this->dropdownsEnabled()) {
+        if ($this->useSubdirectoriesAsDropdowns()) {
             $this->moveGroupedItemsIntoDropdowns();
         }
     }
@@ -89,7 +89,7 @@ protected function canAddItemToDropdown(NavItem $item): bool
         return $item->getGroup() !== null;
     }
 
-    protected function dropdownsEnabled(): bool
+    protected function useSubdirectoriesAsDropdowns(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }

From aebee358014fa628ffbe6140d4f801f64232985e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:42:27 +0100
Subject: [PATCH 0403/4023] Remove redundant argument

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 1275944aebf..dd017b21772 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -48,7 +48,7 @@ protected function generate(): void
 
         // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
         if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-            $this->items->push(NavItem::fromRoute(DocumentationPage::home(), group: null));
+            $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
         }
     }
 

From 896f8e19d0b6431694ae701d7fe6894e580dfc8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:45:47 +0100
Subject: [PATCH 0404/4023] Introduce local variable for loop routes

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index dd017b21772..70eca4faef0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -40,7 +40,9 @@ public static function handle(): DocumentationSidebar
 
     protected function generate(): void
     {
-        Routes::getRoutes(DocumentationPage::class)->each(function (Route $route): void {
+        $routes = Routes::getRoutes(DocumentationPage::class);
+
+        $routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
             }

From b577ccc3f46b137cd09f1b9eaf170b13bdbe2bb4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:50:17 +0100
Subject: [PATCH 0405/4023] Add helper to prefind sidebar groups

---
 .../GeneratesDocumentationSidebarMenu.php       | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 70eca4faef0..7c16e7b6f1c 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -9,6 +9,7 @@
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -54,6 +55,22 @@ protected function generate(): void
         }
     }
 
+    protected function findSidebarGroups(RouteCollection $routes): array
+    {
+        // In order to know if we should use groups in the sidebar,
+        // we need to loop through all the pages and see if they have a group set
+
+        $groups = [];
+
+        $routes->each(function (Route $route) use (&$groups): void {
+            if ($route->getPage()->data('navigation.group')) {
+                $groups[Str::slug($route->getPage()->data('navigation.group'))] = true;
+            }
+        });
+
+        return array_keys($groups);
+    }
+
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());

From f41a5450897c70748c38591c0a1f7018a539ce2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:51:18 +0100
Subject: [PATCH 0406/4023] Add todo

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index e0346aacc8c..1e639981876 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -27,6 +27,8 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
+        // Todo check if any items have children
+
         return (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
     }
 

From 2d160af61c566b8a5d3fb00950865d7b455b23c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 11:51:41 +0100
Subject: [PATCH 0407/4023] Deprecate group accessor

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1e639981876..d87bcbd2313 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -32,7 +32,11 @@ public function hasGroups(): bool
         return (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
     }
 
-    /** @return array<string> */
+    /**
+     * @deprecated Use children instead
+     *
+     * @return array<string>
+     */
     public function getGroups(): array
     {
         return $this->items->map(function (NavItem $item): ?string {

From 7579dfdc6f1fb99173119963c21cfe904a7c04c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:08:01 +0100
Subject: [PATCH 0408/4023] Mark new method as experimental

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7c16e7b6f1c..cc7a7d832e4 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -55,6 +55,7 @@ protected function generate(): void
         }
     }
 
+    /** @experimental Might not actually be needed now that groups default to null */
     protected function findSidebarGroups(RouteCollection $routes): array
     {
         // In order to know if we should use groups in the sidebar,

From c6a0e406d6ad14299ef4ae147300acb0ec0ec097 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:08:15 +0100
Subject: [PATCH 0409/4023] Find the sidebar groups

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index cc7a7d832e4..e54bfd93570 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -43,6 +43,8 @@ protected function generate(): void
     {
         $routes = Routes::getRoutes(DocumentationPage::class);
 
+        $groups = $this->findSidebarGroups($routes);
+
         $routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));

From f4e21dfee8393d6077bdc8f7aa33ae5347c2adea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:09:09 +0100
Subject: [PATCH 0410/4023] Introduce local variable

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e54bfd93570..55fd915ff38 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -47,7 +47,9 @@ protected function generate(): void
 
         $routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+                $item = NavItem::fromRoute($route);
+
+                $this->items->put($route->getRouteKey(), $item);
             }
         });
 

From a06508435b46f7fe036817fd42179630318e8b0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:10:17 +0100
Subject: [PATCH 0411/4023] Add groups to closure use construct

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 55fd915ff38..ddf00b8e159 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -45,7 +45,7 @@ protected function generate(): void
 
         $groups = $this->findSidebarGroups($routes);
 
-        $routes->each(function (Route $route): void {
+        $routes->each(function (Route $route) use ($groups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
 

From 6d780915edafc73ad71bd7168b78753e3d38129d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:11:03 +0100
Subject: [PATCH 0412/4023] Get the item group

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index ddf00b8e159..1d4d7130dee 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -48,6 +48,7 @@ protected function generate(): void
         $routes->each(function (Route $route) use ($groups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
+                $group = $item->getGroup();
 
                 $this->items->put($route->getRouteKey(), $item);
             }

From bf8abd8c1caef9d180347c0bf7b31a2af099c5bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:11:19 +0100
Subject: [PATCH 0413/4023] Check for group state

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 1d4d7130dee..fcb2d850eba 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -50,6 +50,10 @@ protected function generate(): void
                 $item = NavItem::fromRoute($route);
                 $group = $item->getGroup();
 
+                if ($groups && $group === null) {
+                    // Todo: Add item
+                }
+
                 $this->items->put($route->getRouteKey(), $item);
             }
         });

From afa61fd1bfc7541330225e31b10e28f44edcd52f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:13:21 +0100
Subject: [PATCH 0414/4023] Add navigation item identifier property

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ce0f247ed48..80f32711fed 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -30,6 +30,8 @@ class NavItem implements Stringable
     public readonly int $priority;
     public readonly ?string $group;
 
+    public readonly string $identifier;
+
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
     public readonly array $children;
 

From 9e016e8206e2c9d669d00a30ee29c680a66b6df2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:15:23 +0100
Subject: [PATCH 0415/4023] Set identifier to route key

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 80f32711fed..396092a9690 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,6 +48,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
+        $this->identifier = $destination->getRouteKey();
         $this->children = $children;
     }
 

From 406cd50f9a0d765d15423a25296b058c1b369ed5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:16:33 +0100
Subject: [PATCH 0416/4023] Coerce falsy route keys to label slug

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 396092a9690..5ba78965564 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,7 +48,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        $this->identifier = $destination->getRouteKey();
+        $this->identifier = $destination->getRouteKey() ?: Str::slug($label);
         $this->children = $children;
     }
 

From 82f59e883b310691c0e26a82fed2726a57a7c6d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:17:44 +0100
Subject: [PATCH 0417/4023] Replace '?:' with if

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5ba78965564..8c6aee51ee5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,7 +48,11 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        $this->identifier = $destination->getRouteKey() ?: Str::slug($label);
+        if ($destination->getRouteKey()) {
+            $this->identifier = $destination->getRouteKey();
+        } else {
+            $this->identifier = Str::slug($label);
+        }
         $this->children = $children;
     }
 

From d8a97d915ea9ae51bc3508e5b81cf1d5473315d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:18:23 +0100
Subject: [PATCH 0418/4023] Add type check

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8c6aee51ee5..aa0b504d5bc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,7 +48,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        if ($destination->getRouteKey()) {
+        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
             $this->identifier = $destination->getRouteKey();
         } else {
             $this->identifier = Str::slug($label);

From fd20252088fb31a23992e4d75663173e6f527f07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:20:06 +0100
Subject: [PATCH 0419/4023] Extract helper method

---
 .../Framework/Features/Navigation/NavItem.php   | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index aa0b504d5bc..2a5e2249565 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,11 +48,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
-            $this->identifier = $destination->getRouteKey();
-        } else {
-            $this->identifier = Str::slug($label);
-        }
+        $this->identifier = $this->makeIdentifier($destination, $label);
         $this->children = $children;
     }
 
@@ -197,4 +193,15 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
 
         return $config[$groupKey] ?? null;
     }
+
+    protected static function makeIdentifier(Route|ExternalRoute $destination, string $label): string
+    {
+        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
+            $identifier = $destination->getRouteKey();
+        } else {
+            $identifier = Str::slug($label);
+        }
+
+        return $identifier;
+    }
 }

From 06d3fdfa3c9279c30fed3d2d49454c7c9b086803 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:21:56 +0100
Subject: [PATCH 0420/4023] Remove already evaluated union type

Right hand is inherited by left hand parent
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 2a5e2249565..d6169ebc322 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -194,7 +194,7 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
         return $config[$groupKey] ?? null;
     }
 
-    protected static function makeIdentifier(Route|ExternalRoute $destination, string $label): string
+    protected static function makeIdentifier(Route $destination, string $label): string
     {
         if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
             $identifier = $destination->getRouteKey();

From aac2e9c95e470e698f284bc55c0406c552ef8220 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:24:31 +0100
Subject: [PATCH 0421/4023] Move up helper method

---
 .../Framework/Features/Navigation/NavItem.php | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d6169ebc322..583632d07b2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -182,6 +182,17 @@ protected static function normalizeGroupKey(?string $group): ?string
         return $group ? Str::slug($group) : null;
     }
 
+    protected static function makeIdentifier(Route $destination, string $label): string
+    {
+        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
+            $identifier = $destination->getRouteKey();
+        } else {
+            $identifier = Str::slug($label);
+        }
+
+        return $identifier;
+    }
+
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
         /** @var array<string, int> $config */
@@ -193,15 +204,4 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
 
         return $config[$groupKey] ?? null;
     }
-
-    protected static function makeIdentifier(Route $destination, string $label): string
-    {
-        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
-            $identifier = $destination->getRouteKey();
-        } else {
-            $identifier = Str::slug($label);
-        }
-
-        return $identifier;
-    }
 }

From 4b803f01d2107684c054abb2bc7eca46a40d4c56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:24:43 +0100
Subject: [PATCH 0422/4023] Refactor control flow

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 583632d07b2..a675b9bd679 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -185,12 +185,10 @@ protected static function normalizeGroupKey(?string $group): ?string
     protected static function makeIdentifier(Route $destination, string $label): string
     {
         if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
-            $identifier = $destination->getRouteKey();
+            return $destination->getRouteKey();
         } else {
-            $identifier = Str::slug($label);
+            return Str::slug($label);
         }
-
-        return $identifier;
     }
 
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int

From a388822f38272dbf8c884cac22d03f245e9f1d3e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 12:25:09 +0100
Subject: [PATCH 0423/4023] Simplify if with ternary return

---
 .../src/Framework/Features/Navigation/NavItem.php         | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a675b9bd679..6c125864430 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -184,11 +184,9 @@ protected static function normalizeGroupKey(?string $group): ?string
 
     protected static function makeIdentifier(Route $destination, string $label): string
     {
-        if (! $destination instanceof ExternalRoute && $destination->getRouteKey()) {
-            return $destination->getRouteKey();
-        } else {
-            return Str::slug($label);
-        }
+        return ! $destination instanceof ExternalRoute && $destination->getRouteKey()
+            ? $destination->getRouteKey()
+            : Str::slug($label);
     }
 
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int

From 50afd828ddafb25ab4ed23a079d887bdacdc01a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:35:03 +0100
Subject: [PATCH 0424/4023] Add identifier tests

---
 packages/framework/tests/Unit/NavItemTest.php | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index c3996365c55..56748364ee8 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -348,4 +348,40 @@ public function testGroupKeysAreNormalized()
         $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
         $this->assertSame('foo-bar', $item->getGroup());
     }
+
+    public function testIdentifier()
+    {
+        $route = new Route(new MarkdownPage());
+        $item = new NavItem($route, 'Test', 500);
+
+        $this->assertSame('test', $item->identifier);
+    }
+
+    public function testIdentifierWithCustomLabel()
+    {
+        $route = new Route(new MarkdownPage());
+        $item = new NavItem($route, 'Foo Bar', 500);
+
+        $this->assertSame('foo-bar', $item->identifier);
+    }
+
+    public function testIdentifierFromRouteKey()
+    {
+        $item = NavItem::fromRoute(Routes::get('index'));
+        $this->assertSame('index', $item->identifier);
+    }
+
+    public function testIdentifierUsesLabelWhenRouteKeyIsFalsy()
+    {
+        $route = new Route(new MarkdownPage());
+        $item = new NavItem($route, 'Foo Bar', 500);
+
+        $this->assertSame('foo-bar', $item->identifier);
+    }
+
+    public function testIdentifierUsesLabelForExternalRoute()
+    {
+        $item = NavItem::forLink('https://example.com', 'Foo Bar');
+        $this->assertSame('foo-bar', $item->identifier);
+    }
 }

From b94d684ff557887838723731db04ec4560c5c905 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:43:05 +0100
Subject: [PATCH 0425/4023] Document identifier property

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6c125864430..e6226f87626 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -30,6 +30,7 @@ class NavItem implements Stringable
     public readonly int $priority;
     public readonly ?string $group;
 
+    /** The route key, or a "slugified" version of the label if the route has no key, for example external links and dropdowns items. */
     public readonly string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */

From 06605a0b4fcfb70535026075eebdb1a1488ec9b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:43:37 +0100
Subject: [PATCH 0426/4023] Use the item identifier to determine uniqueness

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index fcb2d850eba..8ca04be8895 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -89,8 +89,8 @@ protected function canAddRoute(Route $route): bool
     protected function removeDuplicateItems(): void
     {
         $this->items = $this->items->unique(function (NavItem $item): string {
-            // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().Str::slug($item->getLabel()); // Todo we could use this as the "identifier" for the item, as it uniquely identifies it
+            // Filter using a combination of the group and identifier to allow duplicate labels in different groups
+            return $item->getGroup().$item->identifier;
         });
     }
 

From 6137a7df04a91107c4f55f8968dea2da26bdf89f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:46:00 +0100
Subject: [PATCH 0427/4023] Remove resolved todo

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e6226f87626..622f2c9a712 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -16,7 +16,6 @@
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
  * @todo Consider splitting facade methods to actual facade class.
- * @todo Consider adding an "identifier" property to make it more visible how items are identified, for example when modifying sidebars in the config.
  *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor

From 22979d4a6944882579d8dcd5a22f7fa84476628d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:50:23 +0100
Subject: [PATCH 0428/4023] Generate navigation item identifier solely on label

Originally added route keys so that page labels can be set in config and provide compatibility for that, but realized that that happens way earlier, so at this point we only need to sort against labels.
---
 .../src/Framework/Features/Navigation/NavItem.php      | 10 ++++------
 packages/framework/tests/Unit/NavItemTest.php          |  2 +-
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 622f2c9a712..e89d293efad 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -29,7 +29,7 @@ class NavItem implements Stringable
     public readonly int $priority;
     public readonly ?string $group;
 
-    /** The route key, or a "slugified" version of the label if the route has no key, for example external links and dropdowns items. */
+    /** The "slugified" version of the label. */
     public readonly string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
@@ -48,7 +48,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        $this->identifier = $this->makeIdentifier($destination, $label);
+        $this->identifier = $this->makeIdentifier($label);
         $this->children = $children;
     }
 
@@ -182,11 +182,9 @@ protected static function normalizeGroupKey(?string $group): ?string
         return $group ? Str::slug($group) : null;
     }
 
-    protected static function makeIdentifier(Route $destination, string $label): string
+    protected static function makeIdentifier(string $label): string
     {
-        return ! $destination instanceof ExternalRoute && $destination->getRouteKey()
-            ? $destination->getRouteKey()
-            : Str::slug($label);
+        return Str::slug($label);
     }
 
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 56748364ee8..71f6697fc7a 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -368,7 +368,7 @@ public function testIdentifierWithCustomLabel()
     public function testIdentifierFromRouteKey()
     {
         $item = NavItem::fromRoute(Routes::get('index'));
-        $this->assertSame('index', $item->identifier);
+        $this->assertSame('home', $item->identifier);
     }
 
     public function testIdentifierUsesLabelWhenRouteKeyIsFalsy()

From 1f149a435c6368658355dbaaa40b1b7005d4dee5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:50:28 +0100
Subject: [PATCH 0429/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e89d293efad..a885d3eb9ad 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -184,7 +184,7 @@ protected static function normalizeGroupKey(?string $group): ?string
 
     protected static function makeIdentifier(string $label): string
     {
-        return Str::slug($label);
+        return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int

From c8a145b1bbd831dd82613e5f3acc27da392337fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 13:54:21 +0100
Subject: [PATCH 0430/4023] Remove duplicate item filtering from navigation
 menu generator

---
 .../Navigation/GeneratesMainNavigationMenu.php        | 10 ----------
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 ++++++-----
 .../framework/tests/Feature/NavigationMenuTest.php    |  7 +++++--
 3 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index dcc88fe5878..de4e5af2503 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -36,7 +35,6 @@ public static function handle(): NavigationMenu
 
         $menu->generate();
         $menu->sortByPriority();
-        $menu->removeDuplicateItems();
 
         return new NavigationMenu($menu->items);
     }
@@ -94,14 +92,6 @@ protected function useSubdirectoriesAsDropdowns(): bool
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }
 
-    protected function removeDuplicateItems(): void
-    {
-        $this->items = $this->items->unique(function (NavItem $item): string {
-            // Filter using a combination of the group and label to allow duplicate labels in different groups
-            return $item->getGroup().Str::slug($item->getLabel());
-        });
-    }
-
     protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy('priority')->values();
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 971dfd11f9c..fc10f0ec95f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -457,28 +457,29 @@ public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdir
         ]);
     }
 
-    public function testMainNavigationMenuItemsWithTheSameLabelAreFiltered()
+    public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDuplicates()
     {
+        // Since the route key is the same, only one route is actually added
         $this->assertMenuEquals(['Foo'], [
             new MarkdownPage('foo'),
             new MarkdownPage('foo'),
         ]);
 
-        $this->assertMenuEquals(['Foo'], [
+        $this->assertMenuEquals(['Foo', 'Foo'], [
             new MarkdownPage('foo', ['navigation.label' => 'Foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
         ]);
     }
 
-    public function testMainNavigationMenuItemsWithTheSameLabelAreFilteredCaseInsensitive()
+    public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDuplicatesRegardlessOfCase()
     {
-        $this->assertMenuEquals(['Foo'], [
+        $this->assertMenuEquals(['Foo', 'Foo', 'FOO'], [
             new MarkdownPage('foo'),
             new MarkdownPage('Foo'),
             new MarkdownPage('FOO'),
         ]);
 
-        $this->assertMenuEquals(['foo'], [
+        $this->assertMenuEquals(['foo', 'Foo', 'FOO'], [
             new MarkdownPage('foo', ['navigation.label' => 'foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
             new MarkdownPage('baz', ['navigation.label' => 'FOO']),
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 83c10b62dd5..e19f0039018 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -119,7 +119,7 @@ public function testPathLinkCanBeAddedInConfig()
         $this->assertEquals($expected, $menu->getItems());
     }
 
-    public function testDuplicatesAreRemovedWhenAddingInConfig()
+    public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     {
         config(['hyde.navigation.custom' => [
             NavItem::forLink('foo', 'foo'),
@@ -131,13 +131,14 @@ public function testDuplicatesAreRemovedWhenAddingInConfig()
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::forLink('foo', 'foo'),
+            NavItem::forLink('foo', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
         $this->assertEquals($expected, $menu->getItems());
     }
 
-    public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestination()
+    public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestination()
     {
         config(['hyde.navigation.custom' => [
             NavItem::forLink('foo', 'foo'),
@@ -149,6 +150,7 @@ public function testDuplicatesAreRemovedWhenAddingInConfigRegardlessOfDestinatio
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::forLink('foo', 'foo'),
+            NavItem::forLink('bar', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -166,6 +168,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::forLink('bar', 'Foo'),
+            NavItem::fromRoute(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());

From 03f0f94cf3ee9be5a10d67663e3bd45b754f3ce7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:04:01 +0100
Subject: [PATCH 0431/4023] Remove duplicate item filtering from documentation
 sidebar generator

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php  |  9 ---------
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 ++++++-----
 .../Feature/Services/DocumentationSidebarTest.php     |  9 ++++++---
 3 files changed, 12 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 8ca04be8895..ef28dd5457d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -34,7 +34,6 @@ public static function handle(): DocumentationSidebar
 
         $menu->generate();
         $menu->sortByPriority();
-        $menu->removeDuplicateItems();
 
         return new DocumentationSidebar($menu->items);
     }
@@ -86,14 +85,6 @@ protected function canAddRoute(Route $route): bool
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
     }
 
-    protected function removeDuplicateItems(): void
-    {
-        $this->items = $this->items->unique(function (NavItem $item): string {
-            // Filter using a combination of the group and identifier to allow duplicate labels in different groups
-            return $item->getGroup().$item->identifier;
-        });
-    }
-
     protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy('priority')->values();
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fc10f0ec95f..6849d3e23e0 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -883,28 +883,29 @@ public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfigurat
         }
     }
 
-    public function testSidebarItemsWithTheSameLabelAreFiltered()
+    public function testSidebarItemsWithTheSameLabelAreNotFiltered()
     {
+        // Since the route key is the same, only one route is actually added
         $this->assertSidebarEquals(['Foo'], [
             new DocumentationPage('foo'),
             new DocumentationPage('foo'),
         ]);
 
-        $this->assertSidebarEquals(['Foo'], [
+        $this->assertSidebarEquals(['Foo', 'Foo'], [
             new DocumentationPage('foo', ['navigation.label' => 'Foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),
         ]);
     }
 
-    public function testSidebarItemsWithTheSameLabelAreFilteredCaseInsensitive()
+    public function testSidebarItemsWithTheSameLabelAreNotFilteredForDuplicatesRegardlessOfCase()
     {
-        $this->assertSidebarEquals(['Foo'], [
+        $this->assertSidebarEquals(['Foo', 'Foo', 'FOO'], [
             new DocumentationPage('foo'),
             new DocumentationPage('Foo'),
             new DocumentationPage('FOO'),
         ]);
 
-        $this->assertSidebarEquals(['foo'], [
+        $this->assertSidebarEquals(['foo', 'Foo', 'FOO'], [
             new DocumentationPage('foo', ['navigation.label' => 'foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),
             new DocumentationPage('baz', ['navigation.label' => 'FOO']),
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index e27a832ab3b..4d09e812e2c 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -372,16 +372,19 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
         );
     }
 
-    public function testDuplicateLabelsWithinTheSameGroupIsRemoved()
+    public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
     {
         $this->makePage('foo', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
         $this->makePage('bar', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(1, $sidebar->getItems());
+        $this->assertCount(2, $sidebar->getItems());
 
         $this->assertEquals(
-            collect([NavItem::fromRoute(Routes::get('docs/bar'), priority: 999)]),
+            collect([
+                NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
+                NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+            ]),
             $sidebar->getItems()
         );
     }

From bd90f9386e197798dc2577965347e9660c2faa31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:06:36 +0100
Subject: [PATCH 0432/4023] Clean up tests

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 6849d3e23e0..6cb83ced334 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -459,12 +459,6 @@ public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdir
 
     public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDuplicates()
     {
-        // Since the route key is the same, only one route is actually added
-        $this->assertMenuEquals(['Foo'], [
-            new MarkdownPage('foo'),
-            new MarkdownPage('foo'),
-        ]);
-
         $this->assertMenuEquals(['Foo', 'Foo'], [
             new MarkdownPage('foo', ['navigation.label' => 'Foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
@@ -885,12 +879,6 @@ public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfigurat
 
     public function testSidebarItemsWithTheSameLabelAreNotFiltered()
     {
-        // Since the route key is the same, only one route is actually added
-        $this->assertSidebarEquals(['Foo'], [
-            new DocumentationPage('foo'),
-            new DocumentationPage('foo'),
-        ]);
-
         $this->assertSidebarEquals(['Foo', 'Foo'], [
             new DocumentationPage('foo', ['navigation.label' => 'Foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),

From a3cd45330e3e5175e8f4c577301917a71dec1747 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:06:40 +0100
Subject: [PATCH 0433/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3ff8919c416..6e4e58d51d3 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -18,6 +18,7 @@ This serves two purposes:
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
+- Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Breaking: The `NavItem` class now always stores the destination as a `Route` instance.
 - Breaking: The `NavItem::getDestination()` method now returns its `Route` instance.
 

From b018e7d73e300b6b39c003717fd2f1364d1007f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:17:04 +0100
Subject: [PATCH 0434/4023] Fix boolean logic

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index ef28dd5457d..178dfe4b5f9 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -49,7 +49,7 @@ protected function generate(): void
                 $item = NavItem::fromRoute($route);
                 $group = $item->getGroup();
 
-                if ($groups && $group === null) {
+                if ($groups && $group !== null) {
                     // Todo: Add item
                 }
 

From 26b263237ffb95a505833e679ef392329723c99e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:21:25 +0100
Subject: [PATCH 0435/4023] Remove readonly modifiers from NavItem class
 properties

---
 .../src/Framework/Features/Navigation/NavItem.php    | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a885d3eb9ad..c2b35be9acc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -24,16 +24,16 @@
  */
 class NavItem implements Stringable
 {
-    public readonly Route $destination;
-    public readonly string $label;
-    public readonly int $priority;
-    public readonly ?string $group;
+    public Route $destination;
+    public string $label;
+    public int $priority;
+    public ?string $group;
 
     /** The "slugified" version of the label. */
-    public readonly string $identifier;
+    public string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
-    public readonly array $children;
+    public array $children;
 
     /**
      * Create a new navigation menu item.

From e2a8f366d93326e2039e073179f4eb6cf4396a0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:27:05 +0100
Subject: [PATCH 0436/4023] Breaking: Make `NavItem::$destination` property
 protected

---
 .../components/docs/sidebar-item.blade.php    |  4 +--
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 packages/framework/tests/Unit/NavItemTest.php | 30 +++++++++----------
 3 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index a6da983c180..98e259d0950 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -5,7 +5,7 @@
         : 'active bg-black/5 dark:bg-black/10' => $item->isCurrent()
     ]) role="listitem">
     @if($item->isCurrent())
-        <a href="{{ $item->destination }}" aria-current="true" @class([$grouped
+        <a href="{{ $item->getDestination() }}" aria-current="true" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
         ])>
@@ -17,7 +17,7 @@
             {!! ($page->getTableOfContents()) !!}
         @endif
     @else
-        <a href="{{ $item->destination }}" @class([$grouped
+        <a href="{{ $item->getDestination() }}" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block border-l-[0.325rem] border-transparent transition-colors duration-300 ease-in-out hover:bg-black/10'
             : 'block -ml-4 p-2 border-l-[0.325rem] border-transparent hover:bg-black/5 dark:hover:bg-black/10'
         ])>
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c2b35be9acc..7b996af28c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -24,7 +24,7 @@
  */
 class NavItem implements Stringable
 {
-    public Route $destination;
+    protected Route $destination;
     public string $label;
     public int $priority;
     public ?string $group;
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 71f6697fc7a..3832cec8874 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -44,36 +44,36 @@ public function testConstruct()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Test', 500);
 
-        $this->assertSame($route, $item->destination);
+        $this->assertSame($route, $item->getDestination());
     }
 
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());
-        $this->assertSame($route, (new NavItem($route, 'Home'))->destination);
+        $this->assertSame($route, (new NavItem($route, 'Home'))->getDestination());
     }
 
     public function testPassingRouteKeyToConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');
 
-        $this->assertSame($route, (new NavItem('index', 'Home'))->destination);
+        $this->assertSame($route, (new NavItem('index', 'Home'))->getDestination());
     }
 
     public function testPassingUrlToConstructorUsesExternalRoute()
     {
         $item = new NavItem('https://example.com', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->destination);
-        $this->assertEquals(new ExternalRoute('https://example.com'), $item->destination);
-        $this->assertSame('https://example.com', (string) $item->destination);
+        $this->assertInstanceOf(ExternalRoute::class, $item->getDestination());
+        $this->assertEquals(new ExternalRoute('https://example.com'), $item->getDestination());
+        $this->assertSame('https://example.com', (string) $item->getDestination());
     }
 
     public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     {
         $item = new NavItem('foo', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->destination);
-        $this->assertEquals(new ExternalRoute('foo'), $item->destination);
-        $this->assertSame('foo', (string) $item->destination);
+        $this->assertInstanceOf(ExternalRoute::class, $item->getDestination());
+        $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
+        $this->assertSame('foo', (string) $item->getDestination());
     }
 
     public function testCanConstructWithChildren()
@@ -86,7 +86,7 @@ public function testCanConstructWithChildren()
         $item = new NavItem($route, 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->label);
-        $this->assertSame($route, $item->destination);
+        $this->assertSame($route, $item->getDestination());
         $this->assertSame(500, $item->priority);
 
         $this->assertCount(2, $item->children);
@@ -111,7 +111,7 @@ public function testCanConstructWithChildrenWithoutRoute()
         $item = new NavItem('', 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->label);
-        $this->assertSame('', $item->destination->getLink());
+        $this->assertSame('', $item->getDestination()->getLink());
 
         $this->assertCount(2, $item->children);
         $this->assertSame($children, $item->children);
@@ -171,7 +171,7 @@ public function testFromRoute()
         $route = new Route(new MarkdownPage());
         $item = NavItem::fromRoute($route);
 
-        $this->assertSame($route, $item->destination);
+        $this->assertSame($route, $item->getDestination());
     }
 
     public function testToString()
@@ -185,7 +185,7 @@ public function testForLink()
     {
         $item = NavItem::forLink('foo', 'bar');
 
-        $this->assertEquals(new ExternalRoute('foo'), $item->destination);
+        $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
         $this->assertSame('bar', $item->label);
         $this->assertSame(500, $item->priority);
     }
@@ -200,7 +200,7 @@ public function testForRoute()
         $route = Routes::get('404');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route, $item->destination);
+        $this->assertSame($route, $item->getDestination());
         $this->assertSame('foo', $item->label);
         $this->assertSame(999, $item->priority);
     }
@@ -210,7 +210,7 @@ public function testForIndexRoute()
         $route = Routes::get('index');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route, $item->destination);
+        $this->assertSame($route, $item->getDestination());
         $this->assertSame('foo', $item->label);
         $this->assertSame(0, $item->priority);
     }

From 5fa2bb206844314bfa97431e37815acb7cf3e6ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 14:32:52 +0100
Subject: [PATCH 0437/4023] Breaking: Make `NavItem::$label` property protected

---
 .../views/components/docs/sidebar-item.blade.php |  4 ++--
 .../navigation/navigation-link.blade.php         |  2 +-
 .../Framework/Features/Navigation/NavItem.php    |  2 +-
 .../tests/Feature/NavigationMenuTest.php         |  6 +++---
 packages/framework/tests/Unit/NavItemTest.php    | 16 ++++++++--------
 5 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index 98e259d0950..012947357c0 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -9,7 +9,7 @@
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
         ])>
-            {{ $item->label }}
+            {{ $item->getLabel() }}
         </a>
 
         @if(config('docs.table_of_contents.enabled', true))
@@ -21,7 +21,7 @@
             ? '-ml-8 pl-4 py-1 px-2 block border-l-[0.325rem] border-transparent transition-colors duration-300 ease-in-out hover:bg-black/10'
             : 'block -ml-4 p-2 border-l-[0.325rem] border-transparent hover:bg-black/5 dark:hover:bg-black/10'
         ])>
-            {{ $item->label }}
+            {{ $item->getLabel() }}
         </a>
     @endif
 </li>
\ No newline at end of file
diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index cfad8bdb1e2..dbb5407245a 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,4 +1,4 @@
 <a href="{{ $item }}" {!! $item->isCurrent() ? 'aria-current="page"' : '' !!} @class([
     'block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isCurrent()
-])>{{ $item->label }}</a>
\ No newline at end of file
+])>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7b996af28c3..1bd1fe61505 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -25,7 +25,7 @@
 class NavItem implements Stringable
 {
     protected Route $destination;
-    public string $label;
+    protected string $label;
     public int $priority;
     public ?string $group;
 
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index e19f0039018..31bb0ad3f19 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -46,7 +46,7 @@ public function testItemsAreSortedByPriority()
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.priority' => 2])));
         Routes::addRoute(new Route(new MarkdownPage('baz', ['navigation.priority' => 3])));
 
-        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Foo', 'Bar', 'Baz'], $this->createNavigationMenu()->getItems()->map(fn ($item) => $item->getLabel())->toArray());
     }
 
     public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
@@ -54,7 +54,7 @@ public function testItemsWithHiddenPropertySetToTrueAreNotAdded()
         Routes::addRoute(new Route(new MarkdownPage('foo', ['navigation.hidden' => true])));
         Routes::addRoute(new Route(new MarkdownPage('bar', ['navigation.hidden' => false])));
 
-        $this->assertSame(['Home', 'Bar'], $this->createNavigationMenu()->getItems()->pluck('label')->toArray());
+        $this->assertSame(['Home', 'Bar'], $this->createNavigationMenu()->getItems()->map(fn ($item) => $item->getLabel())->toArray());
     }
 
     public function testCreatedCollectionIsSortedByNavigationMenuPriority()
@@ -266,7 +266,7 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
 
         $this->assertCount(2, $navigation->getItems());
-        $this->assertSame('Foo', $navigation->getItems()->last()->label);
+        $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
     }
 
     protected function createNavigationMenu(): NavigationMenu
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 3832cec8874..dd28a2d6e24 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -85,15 +85,15 @@ public function testCanConstructWithChildren()
         ];
         $item = new NavItem($route, 'Test', 500, null, $children);
 
-        $this->assertSame('Test', $item->label);
+        $this->assertSame('Test', $item->getLabel());
         $this->assertSame($route, $item->getDestination());
         $this->assertSame(500, $item->priority);
 
         $this->assertCount(2, $item->children);
         $this->assertSame($children, $item->children);
 
-        $this->assertSame('Foo', $item->children[0]->label);
-        $this->assertSame('Bar', $item->children[1]->label);
+        $this->assertSame('Foo', $item->children[0]->getLabel());
+        $this->assertSame('Bar', $item->children[1]->getLabel());
 
         $this->assertSame('foo.html', $item->children[0]->getLink());
         $this->assertSame('bar.html', $item->children[1]->getLink());
@@ -110,7 +110,7 @@ public function testCanConstructWithChildrenWithoutRoute()
         ];
         $item = new NavItem('', 'Test', 500, null, $children);
 
-        $this->assertSame('Test', $item->label);
+        $this->assertSame('Test', $item->getLabel());
         $this->assertSame('', $item->getDestination()->getLink());
 
         $this->assertCount(2, $item->children);
@@ -186,7 +186,7 @@ public function testForLink()
         $item = NavItem::forLink('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
-        $this->assertSame('bar', $item->label);
+        $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->priority);
     }
 
@@ -201,7 +201,7 @@ public function testForRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('foo', $item->label);
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame(999, $item->priority);
     }
 
@@ -211,7 +211,7 @@ public function testForIndexRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('foo', $item->label);
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame(0, $item->priority);
     }
 
@@ -265,7 +265,7 @@ public function testDropdownFacade()
     {
         $item = NavItem::dropdown('foo', []);
 
-        $this->assertSame('foo', $item->label);
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
         $this->assertSame(999, $item->priority);
     }

From d51186d4f902bca0889e3cf2d8e06852df801baf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 15:20:13 +0100
Subject: [PATCH 0438/4023] Breaking: Make `NavItem::$priority` property
 protected

---
 .../GeneratesDocumentationSidebarMenu.php     |  2 +-
 .../GeneratesMainNavigationMenu.php           |  2 +-
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 .../Features/Navigation/NavigationMenu.php    |  2 +-
 .../Services/DocumentationSidebarTest.php     |  4 ++--
 packages/framework/tests/Unit/NavItemTest.php | 22 +++++++++----------
 6 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 178dfe4b5f9..43ca0b929db 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -87,6 +87,6 @@ protected function canAddRoute(Route $route): bool
 
     protected function sortByPriority(): void
     {
-        $this->items = $this->items->sortBy('priority')->values();
+        $this->items = $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index de4e5af2503..b3dda7b9f73 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -94,6 +94,6 @@ protected function useSubdirectoriesAsDropdowns(): bool
 
     protected function sortByPriority(): void
     {
-        $this->items = $this->items->sortBy('priority')->values();
+        $this->items = $this->items->sortBy(fn (NavItem $item): int => $item->getPriority())->values();
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 1bd1fe61505..bc0c7694fd7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -26,7 +26,7 @@ class NavItem implements Stringable
 {
     protected Route $destination;
     protected string $label;
-    public int $priority;
+    protected int $priority;
     public ?string $group;
 
     /** The "slugified" version of the label. */
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index ca3021f1336..0c1e610a0e2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -36,7 +36,7 @@ public function __construct(Arrayable|array $items = [])
      */
     public function getItems(): Collection
     {
-        return $this->items->sortBy('priority')->values();
+        return $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 4d09e812e2c..ed2df0ba297 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -114,7 +114,7 @@ public function testSidebarItemPriorityCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.priority' => 25]);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->priority);
+        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->getPriority());
     }
 
     public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
@@ -123,7 +123,7 @@ public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
 
         Config::set('docs.sidebar_order', ['foo']);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->priority);
+        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->getPriority());
     }
 
     public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index dd28a2d6e24..b908101810d 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -87,7 +87,7 @@ public function testCanConstructWithChildren()
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame(500, $item->priority);
+        $this->assertSame(500, $item->getPriority());
 
         $this->assertCount(2, $item->children);
         $this->assertSame($children, $item->children);
@@ -98,8 +98,8 @@ public function testCanConstructWithChildren()
         $this->assertSame('foo.html', $item->children[0]->getLink());
         $this->assertSame('bar.html', $item->children[1]->getLink());
 
-        $this->assertSame(500, $item->children[0]->priority);
-        $this->assertSame(500, $item->children[1]->priority);
+        $this->assertSame(500, $item->children[0]->getPriority());
+        $this->assertSame(500, $item->children[1]->getPriority());
     }
 
     public function testCanConstructWithChildrenWithoutRoute()
@@ -187,12 +187,12 @@ public function testForLink()
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
         $this->assertSame('bar', $item->getLabel());
-        $this->assertSame(500, $item->priority);
+        $this->assertSame(500, $item->getPriority());
     }
 
     public function testForLinkWithCustomPriority()
     {
-        $this->assertSame(100, NavItem::forLink('foo', 'bar', 100)->priority);
+        $this->assertSame(100, NavItem::forLink('foo', 'bar', 100)->getPriority());
     }
 
     public function testForRoute()
@@ -202,7 +202,7 @@ public function testForRoute()
 
         $this->assertSame($route, $item->getDestination());
         $this->assertSame('foo', $item->getLabel());
-        $this->assertSame(999, $item->priority);
+        $this->assertSame(999, $item->getPriority());
     }
 
     public function testForIndexRoute()
@@ -212,7 +212,7 @@ public function testForIndexRoute()
 
         $this->assertSame($route, $item->getDestination());
         $this->assertSame('foo', $item->getLabel());
-        $this->assertSame(0, $item->priority);
+        $this->assertSame(0, $item->getPriority());
     }
 
     public function testForRouteWithRouteKey()
@@ -231,7 +231,7 @@ public function testForRouteWithMissingRouteKey()
 
     public function testForRouteWithCustomPriority()
     {
-        $this->assertSame(100, NavItem::forRoute(Routes::get('index'), 'foo', 100)->priority);
+        $this->assertSame(100, NavItem::forRoute(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
     public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
@@ -267,7 +267,7 @@ public function testDropdownFacade()
 
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
-        $this->assertSame(999, $item->priority);
+        $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithChildren()
@@ -278,14 +278,14 @@ public function testDropdownFacadeWithChildren()
 
         $item = NavItem::dropdown('foo', $children);
         $this->assertSame($children, $item->getChildren());
-        $this->assertSame(999, $item->priority);
+        $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()
     {
         $item = NavItem::dropdown('foo', [], 500);
 
-        $this->assertSame(500, $item->priority);
+        $this->assertSame(500, $item->getPriority());
     }
 
     public function testHasChildren()

From 597e6c6e7cf6fdc9e56588b0605be354fc0db603 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 15:40:00 +0100
Subject: [PATCH 0439/4023] Breaking: Make `NavItem::$group` property protected

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index bc0c7694fd7..3f096d557ed 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -27,7 +27,7 @@ class NavItem implements Stringable
     protected Route $destination;
     protected string $label;
     protected int $priority;
-    public ?string $group;
+    protected ?string $group;
 
     /** The "slugified" version of the label. */
     public string $identifier;

From 55da9624572e1ab2ec1e97425b40e567067cecf5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 15:44:01 +0100
Subject: [PATCH 0440/4023] Breaking: Make `NavItem::$children` property
 protected

---
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 packages/framework/tests/Unit/NavItemTest.php | 20 +++++++++----------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 3f096d557ed..ce42587f8f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -33,7 +33,7 @@ class NavItem implements Stringable
     public string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
-    public array $children;
+    protected array $children;
 
     /**
      * Create a new navigation menu item.
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index b908101810d..82a4023243d 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -89,17 +89,17 @@ public function testCanConstructWithChildren()
         $this->assertSame($route, $item->getDestination());
         $this->assertSame(500, $item->getPriority());
 
-        $this->assertCount(2, $item->children);
-        $this->assertSame($children, $item->children);
+        $this->assertCount(2, $item->getChildren());
+        $this->assertSame($children, $item->getChildren());
 
-        $this->assertSame('Foo', $item->children[0]->getLabel());
-        $this->assertSame('Bar', $item->children[1]->getLabel());
+        $this->assertSame('Foo', $item->getChildren()[0]->getLabel());
+        $this->assertSame('Bar', $item->getChildren()[1]->getLabel());
 
-        $this->assertSame('foo.html', $item->children[0]->getLink());
-        $this->assertSame('bar.html', $item->children[1]->getLink());
+        $this->assertSame('foo.html', $item->getChildren()[0]->getLink());
+        $this->assertSame('bar.html', $item->getChildren()[1]->getLink());
 
-        $this->assertSame(500, $item->children[0]->getPriority());
-        $this->assertSame(500, $item->children[1]->getPriority());
+        $this->assertSame(500, $item->getChildren()[0]->getPriority());
+        $this->assertSame(500, $item->getChildren()[1]->getPriority());
     }
 
     public function testCanConstructWithChildrenWithoutRoute()
@@ -113,8 +113,8 @@ public function testCanConstructWithChildrenWithoutRoute()
         $this->assertSame('Test', $item->getLabel());
         $this->assertSame('', $item->getDestination()->getLink());
 
-        $this->assertCount(2, $item->children);
-        $this->assertSame($children, $item->children);
+        $this->assertCount(2, $item->getChildren());
+        $this->assertSame($children, $item->getChildren());
     }
 
     public function testGetDestination()

From 482ac8a32f48accef23f334ab8b6e683be11baf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 15:46:15 +0100
Subject: [PATCH 0441/4023] Add accessor for the identifier and protect the
 property

Not breaking as it is a new property
---
 .../src/Framework/Features/Navigation/NavItem.php      | 10 +++++++++-
 packages/framework/tests/Unit/NavItemTest.php          | 10 +++++-----
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ce42587f8f3..0b290e3ca32 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -30,7 +30,7 @@ class NavItem implements Stringable
     protected ?string $group;
 
     /** The "slugified" version of the label. */
-    public string $identifier;
+    protected string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
     protected array $children;
@@ -149,6 +149,14 @@ public function getGroup(): ?string
         return $this->group;
     }
 
+    /**
+     * Get the identifier of the navigation item.
+     */
+    public function getIdentifier(): string
+    {
+        return $this->identifier;
+    }
+
     /**
      * Get the children of the navigation item.
      *
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 82a4023243d..49670868bb9 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -354,7 +354,7 @@ public function testIdentifier()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Test', 500);
 
-        $this->assertSame('test', $item->identifier);
+        $this->assertSame('test', $item->getIdentifier());
     }
 
     public function testIdentifierWithCustomLabel()
@@ -362,13 +362,13 @@ public function testIdentifierWithCustomLabel()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Foo Bar', 500);
 
-        $this->assertSame('foo-bar', $item->identifier);
+        $this->assertSame('foo-bar', $item->getIdentifier());
     }
 
     public function testIdentifierFromRouteKey()
     {
         $item = NavItem::fromRoute(Routes::get('index'));
-        $this->assertSame('home', $item->identifier);
+        $this->assertSame('home', $item->getIdentifier());
     }
 
     public function testIdentifierUsesLabelWhenRouteKeyIsFalsy()
@@ -376,12 +376,12 @@ public function testIdentifierUsesLabelWhenRouteKeyIsFalsy()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Foo Bar', 500);
 
-        $this->assertSame('foo-bar', $item->identifier);
+        $this->assertSame('foo-bar', $item->getIdentifier());
     }
 
     public function testIdentifierUsesLabelForExternalRoute()
     {
         $item = NavItem::forLink('https://example.com', 'Foo Bar');
-        $this->assertSame('foo-bar', $item->identifier);
+        $this->assertSame('foo-bar', $item->getIdentifier());
     }
 }

From 7b5cabc08ed53bd5a5da846f692e869f746477e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 16:07:16 +0100
Subject: [PATCH 0442/4023] Remove unnecessary priority sorting from navigation
 generator

We don't need to sort this as the accessor sorts it on retrieval
---
 .../Features/Navigation/GeneratesMainNavigationMenu.php     | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index b3dda7b9f73..9ed815aa01d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -34,7 +34,6 @@ public static function handle(): NavigationMenu
         $menu = new static();
 
         $menu->generate();
-        $menu->sortByPriority();
 
         return new NavigationMenu($menu->items);
     }
@@ -91,9 +90,4 @@ protected function useSubdirectoriesAsDropdowns(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }
-
-    protected function sortByPriority(): void
-    {
-        $this->items = $this->items->sortBy(fn (NavItem $item): int => $item->getPriority())->values();
-    }
 }

From fe3a4ceb8e7f751145f7ac7fd4aa8c4a6b05836d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 16:08:55 +0100
Subject: [PATCH 0443/4023] Use the item accessor to get groups

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d87bcbd2313..ad92eaa31c9 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -39,7 +39,7 @@ public function hasGroups(): bool
      */
     public function getGroups(): array
     {
-        return $this->items->map(function (NavItem $item): ?string {
+        return $this->getItems()->map(function (NavItem $item): ?string {
             return $item->getGroup();
         })->unique()->toArray();
     }
@@ -47,7 +47,7 @@ public function getGroups(): array
     /** @return Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItemsInGroup(?string $group): Collection
     {
-        return $this->items->filter(function (NavItem $item) use ($group): bool {
+        return $this->getItems()->filter(function (NavItem $item) use ($group): bool {
             // Todo: Use identifier instead of slug
             return ($item->getGroup() === $group) || ($item->getGroup() === Str::slug($group));
         })->sortBy('navigation.priority')->values();

From 4c3fd2c03826b3681b58bc7eaebf2176afd08f65 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 16:09:07 +0100
Subject: [PATCH 0444/4023] Remove unnecessary priority sorting from sidebar
 generator

We don't need to sort this as the accessor sorts it on retrieval
---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 43ca0b929db..88602279c7e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -33,7 +33,6 @@ public static function handle(): DocumentationSidebar
         $menu = new static();
 
         $menu->generate();
-        $menu->sortByPriority();
 
         return new DocumentationSidebar($menu->items);
     }
@@ -84,9 +83,4 @@ protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
     }
-
-    protected function sortByPriority(): void
-    {
-        $this->items = $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
-    }
 }

From 9b0cb0f0d370038f58fb7f9b62bd97de1f4e5e32 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 16:13:08 +0100
Subject: [PATCH 0445/4023] Add helper to add child items to navigation items

---
 .../src/Framework/Features/Navigation/NavItem.php    |  8 ++++++++
 packages/framework/tests/Unit/NavItemTest.php        | 12 ++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0b290e3ca32..2b16f03cfff 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -185,6 +185,14 @@ public function isCurrent(): bool
         return Hyde::currentRoute()->getLink() === (string) $this->destination;
     }
 
+    /**
+     * Add a navigation item to the children of the navigation item.
+     */
+    public function addChild(NavItem $item): void
+    {
+        $this->children[] = $item;
+    }
+
     protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 49670868bb9..f2caf94538c 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -384,4 +384,16 @@ public function testIdentifierUsesLabelForExternalRoute()
         $item = NavItem::forLink('https://example.com', 'Foo Bar');
         $this->assertSame('foo-bar', $item->getIdentifier());
     }
+
+    public function testCanAddItemToDropdown()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+
+        $this->assertSame([], $parent->getChildren());
+
+        $parent->addChild($child);
+
+        $this->assertSame([$child], $parent->getChildren());
+    }
 }

From 744b2722a034a725baedc66936e31aed1d6b90f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 17:49:19 +0100
Subject: [PATCH 0446/4023] Update testing helper to dump state

---
 .../AutomaticNavigationConfigurationsTest.php      | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 6cb83ced334..7e095aa4ef3 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1064,7 +1064,19 @@ public function assertEquals(array $expected, bool $strict = false): static
             foreach (TestNavItem::properties() as $property) {
                 if ($this->getState($index) !== null) {
                     if (isset($item[$property])) {
-                        $this->test->assertSame($item[$property], $this->getState($index)->$property, "Failed to match the expected value for '$property'");
+                        $a = $item[$property];
+                        $b = $this->getState($index)->$property;
+
+                        if ($a !== $b) {
+                            dump([
+                                'error' => "Failed to match the expected value for '$property'",
+                                'expected' => $a,
+                                'actual' => $b,
+                                'menu' => $this->state(),
+                            ]);
+                        }
+
+                        $this->test->assertSame($a, $b, "Failed to match the expected value for '$property'");
                     } elseif ($strict) {
                         $this->test->fail("Missing array key '$property' in the expected state");
                     }

From 9f675e1c9680f19a69073faf40fa1766cee28041 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 18:01:17 +0100
Subject: [PATCH 0447/4023] Begin making sidebar group assembly deterministic

Changes how sidebar groups are assembled so that they conform to the new dropdown system
---
 .../Navigation/DocumentationSidebar.php       | 30 ++++++---
 .../GeneratesDocumentationSidebarMenu.php     | 21 +++++-
 .../AutomaticNavigationConfigurationsTest.php | 67 ++++++++++---------
 .../Services/DocumentationSidebarTest.php     | 19 ++++--
 4 files changed, 88 insertions(+), 49 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ad92eaa31c9..a35bbd9d94b 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -27,9 +27,14 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        // Todo check if any items have children
+        /** @deprecated */
+        $legacyCompat = (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
 
-        return (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
+        $newLogic = $this->getItems()->filter(function (NavItem $item): bool {
+            return $item->hasChildren();
+        })->isNotEmpty();
+
+        return $legacyCompat || $newLogic;
     }
 
     /**
@@ -39,18 +44,25 @@ public function hasGroups(): bool
      */
     public function getGroups(): array
     {
-        return $this->getItems()->map(function (NavItem $item): ?string {
-            return $item->getGroup();
-        })->unique()->toArray();
+        return $this->getItems()->filter(function (NavItem $item): bool {
+            return $item->hasChildren();
+        })->sortBy(function (NavItem $item): int {
+            // Sort by lowest priority found in each group
+            return collect($item->getChildren())->min(
+                fn (NavItem $child): int => $child->getPriority()
+            );
+        })->map(function (NavItem $item): string {
+            return $item->getIdentifier();
+        })->values()->toArray();
     }
 
     /** @return Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     public function getItemsInGroup(?string $group): Collection
     {
-        return $this->getItems()->filter(function (NavItem $item) use ($group): bool {
-            // Todo: Use identifier instead of slug
-            return ($item->getGroup() === $group) || ($item->getGroup() === Str::slug($group));
-        })->sortBy('navigation.priority')->values();
+        // Todo might not need collections here
+        return collect($this->getItems()->first(function (NavItem $item) use ($group): bool {
+            return $item->getIdentifier() === Str::slug($group);
+        })?->getChildren() ?? []);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 88602279c7e..c0856952ff2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -48,8 +48,25 @@ protected function generate(): void
                 $item = NavItem::fromRoute($route);
                 $group = $item->getGroup();
 
-                if ($groups && $group !== null) {
-                    // Todo: Add item
+                if ($groups) {
+                    if (! $group) {
+                        $group = 'Other';
+                    }
+
+                    $groupItem = $this->items->get($group);
+
+                    if ($groupItem === null) {
+                        // Todo get group label
+                        $groupItem = NavItem::dropdown($group, []);
+                    }
+
+                    $groupItem->addChild($item);
+
+                    if (! $this->items->has($group)) {
+                        $this->items->put($group, $groupItem);
+                    }
+
+                    return;
                 }
 
                 $this->items->put($route->getRouteKey(), $item);
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 7e095aa4ef3..2a38498ec23 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -616,12 +616,9 @@ public function testSidebarWithFrontMatterVisible()
 
     public function testSidebarWithFrontMatterGroup()
     {
-        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
-
-        $this->assertSidebarEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Bar', 'group' => 'group-1'],
-            ['label' => 'Baz', 'group' => 'group-1'],
+        $this->assertSidebarEquals([[
+            'label' => 'group-1', // Todo: Should use proper group name
+            'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new DocumentationPage('foo', ['navigation.group' => 'Group 1']),
             new DocumentationPage('bar', ['navigation.group' => 'Group 1']),
@@ -631,12 +628,9 @@ public function testSidebarWithFrontMatterGroup()
 
     public function testSidebarWithFrontMatterCategory()
     {
-        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
-
-        $this->assertSidebarEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Bar', 'group' => 'group-1'],
-            ['label' => 'Baz', 'group' => 'group-1'],
+        $this->assertSidebarEquals([[
+            'label' => 'group-1', // Todo: Should use proper group name
+            'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new DocumentationPage('foo', ['navigation.category' => 'Group 1']),
             new DocumentationPage('bar', ['navigation.category' => 'Group 1']),
@@ -706,7 +700,10 @@ public function testSidebarWithFrontMatterGroupAndCategory()
     {
         // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
 
-        $this->assertSidebarEquals(array_fill(0, 3, ['group' => 'group-1']), [
+        $this->assertSidebarEquals([[
+            'label' => 'group-1', // Todo: Should use proper group name
+            'children' => ['Foo', 'Bar', 'Baz'],
+        ]], [
             new DocumentationPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new DocumentationPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new DocumentationPage('baz', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
@@ -847,11 +844,10 @@ public function testSidebarWithConfigHidden()
 
     public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()
     {
-        $this->assertSidebarEquals([
-            ['label' => 'Foo', 'group' => 'about'],
-            ['label' => 'Bar', 'group' => 'about'],
-            ['label' => 'Baz', 'group' => 'about'],
-        ], [
+        $this->assertSidebarEquals([[
+            'label' => 'about', // Todo: Should use proper group name
+            'children' => ['Foo', 'Bar', 'Baz'],
+        ]], [
             new DocumentationPage('about/foo'),
             new DocumentationPage('about/bar'),
             new DocumentationPage('about/baz'),
@@ -865,11 +861,10 @@ public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfigurat
         foreach ($options as $option) {
             config(['docs.sidebar.subdirectories' => $option]);
 
-            $this->assertSidebarEquals([
-                ['label' => 'Foo', 'group' => 'about'],
-                ['label' => 'Bar', 'group' => 'about'],
-                ['label' => 'Baz', 'group' => 'about'],
-            ], [
+            $this->assertSidebarEquals([[
+                'label' => 'about', // Todo: Should use proper group name
+                'children' => ['Foo', 'Bar', 'Baz'],
+            ]], [
                 new DocumentationPage('about/foo'),
                 new DocumentationPage('about/bar'),
                 new DocumentationPage('about/baz'),
@@ -903,8 +898,9 @@ public function testSidebarItemsWithTheSameLabelAreNotFilteredForDuplicatesRegar
     public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     {
         $this->assertSidebarEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Foo', 'group' => 'group-2'],
+            // Todo: Should use proper group name
+            ['label' => 'group-1', 'children' => ['Foo']],
+            ['label' => 'group-2', 'children' => ['Foo']],
         ], [
             new DocumentationPage('foo', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 1']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 2']),
@@ -913,7 +909,11 @@ public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
 
     public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
     {
-        $this->assertSidebarEquals(['Foo'], [
+        $this->assertSidebarEquals([
+            // Todo: Should use proper group name
+            ['label' => 'group-1', 'children' => ['Foo']],
+            ['label' => 'group-2', 'children' => ['Foo']],
+        ], [
             new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
             new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
         ]);
@@ -921,7 +921,11 @@ public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFilter
 
     public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
     {
-        $this->assertSidebarEquals(['Foo'], [
+        $this->assertSidebarEquals([
+            // Todo: Should use proper group name
+            ['label' => 'one', 'children' => ['Foo']],
+            ['label' => 'two', 'children' => ['Foo']],
+        ], [
             new DocumentationPage('one/foo'),
             new DocumentationPage('two/foo'),
         ]);
@@ -932,8 +936,9 @@ public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreNotFil
         config(['docs.flattened_output_paths' => false]);
 
         $this->assertSidebarEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Foo', 'group' => 'group-2'],
+            // Todo: Should use proper group name
+            ['label' => 'group-1', 'children' => ['Foo']],
+            ['label' => 'group-2', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
             new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
@@ -946,8 +951,8 @@ public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroups
 
         $this->assertSidebarEquals([
             // Todo: Should use proper group name
-            ['label' => 'Foo', 'group' => 'one'],
-            ['label' => 'Foo', 'group' => 'two'],
+            ['label' => 'one', 'children' => ['Foo']],
+            ['label' => 'two', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo'),
             new DocumentationPage('two/foo'),
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index ed2df0ba297..76ca6abe6f9 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -152,8 +152,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-
-        $this->assertEquals('bar', DocumentationSidebar::create()->getItems()->first()->getGroup());
+        $this->assertEquals('bar', collect(DocumentationSidebar::create()->getItems()->first()->getChildren())->first()->getGroup());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
@@ -365,8 +364,12 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
 
         $this->assertEquals(
             collect([
-                NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                NavItem::dropdown('bar', [
+                    NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
+                ]),
+                NavItem::dropdown('foo', [
+                    NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                ]),
             ]),
             $sidebar->getItems()
         );
@@ -378,12 +381,14 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
         $this->makePage('bar', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
 
         $sidebar = DocumentationSidebar::create();
-        $this->assertCount(2, $sidebar->getItems());
+        $this->assertCount(1, $sidebar->getItems());
 
         $this->assertEquals(
             collect([
-                NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                NavItem::dropdown('foo', [
+                    NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
+                    NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                ]),
             ]),
             $sidebar->getItems()
         );

From 78ff763bacb3ab2f1aa8cfc15b09325e373660cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 18:54:42 +0100
Subject: [PATCH 0448/4023] Remove temporary legacy compat

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index a35bbd9d94b..7427c1df10b 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -27,14 +27,9 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        /** @deprecated */
-        $legacyCompat = (! empty($this->getGroups())) && ($this->getGroups() !== [null]);
-
-        $newLogic = $this->getItems()->filter(function (NavItem $item): bool {
+        return $this->getItems()->filter(function (NavItem $item): bool {
             return $item->hasChildren();
         })->isNotEmpty();
-
-        return $legacyCompat || $newLogic;
     }
 
     /**

From 4646103a74a3a9482c6c9ce7582a55d5aa6761f3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:00:54 +0100
Subject: [PATCH 0449/4023] Revert "Remove unnecessary priority sorting from
 sidebar generator"

This reverts commit 4c3fd2c03826b3681b58bc7eaebf2176afd08f65.
---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c0856952ff2..c3579ed29dd 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -33,6 +33,7 @@ public static function handle(): DocumentationSidebar
         $menu = new static();
 
         $menu->generate();
+        $menu->sortByPriority();
 
         return new DocumentationSidebar($menu->items);
     }
@@ -100,4 +101,9 @@ protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
     }
+
+    protected function sortByPriority(): void
+    {
+        $this->items = $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
+    }
 }

From 5b099efd90446f784b037a70a18874e9e5df15d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:10:52 +0100
Subject: [PATCH 0450/4023] Handle complex sidebar sorting in generator action

---
 .../Features/Navigation/DocumentationSidebar.php    |  5 -----
 .../GeneratesDocumentationSidebarMenu.php           | 13 ++++++++++++-
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 7427c1df10b..bce1b607ddf 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -41,11 +41,6 @@ public function getGroups(): array
     {
         return $this->getItems()->filter(function (NavItem $item): bool {
             return $item->hasChildren();
-        })->sortBy(function (NavItem $item): int {
-            // Sort by lowest priority found in each group
-            return collect($item->getChildren())->min(
-                fn (NavItem $child): int => $child->getPriority()
-            );
         })->map(function (NavItem $item): string {
             return $item->getIdentifier();
         })->values()->toArray();
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c3579ed29dd..7b1265c121b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -11,6 +11,8 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 
+use function collect;
+
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -104,6 +106,15 @@ protected function canAddRoute(Route $route): bool
 
     protected function sortByPriority(): void
     {
-        $this->items = $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
+        $this->items = $this->items->sortBy(function (NavItem $item): int {
+            if ($item->getChildren()) {
+                // Sort by lowest priority found in each group
+                return collect($item->getChildren())->min(
+                    fn (NavItem $child): int => $child->getPriority()
+                );
+            } else {
+                return $item->getPriority();
+            }
+        })->values();
     }
 }

From e687790c53db49dcd5c85bba2df15b34191076a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:14:21 +0100
Subject: [PATCH 0451/4023] Deprecate helper method

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index bce1b607ddf..32cafd492d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -46,7 +46,11 @@ public function getGroups(): array
         })->values()->toArray();
     }
 
-    /** @return Collection<\Hyde\Framework\Features\Navigation\NavItem> */
+    /**
+     * @deprecated Use children instead
+     *
+     * @return Collection<\Hyde\Framework\Features\Navigation\NavItem>
+     */
     public function getItemsInGroup(?string $group): Collection
     {
         // Todo might not need collections here

From 7269ecb51f7ee0483b5ff7d67f328752e6870ac8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:15:34 +0100
Subject: [PATCH 0452/4023] Extract helper method

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7b1265c121b..3edfdaa41b9 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -108,13 +108,15 @@ protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy(function (NavItem $item): int {
             if ($item->getChildren()) {
-                // Sort by lowest priority found in each group
-                return collect($item->getChildren())->min(
-                    fn (NavItem $child): int => $child->getPriority()
-                );
+                return $this->getLowestPriorityInGroup($item);
             } else {
                 return $item->getPriority();
             }
         })->values();
     }
+
+    protected function getLowestPriorityInGroup(NavItem $item): int
+    {
+        return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
+    }
 }

From ea67d1d762d402d09958b3e8932a4cb732a58feb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:18:06 +0100
Subject: [PATCH 0453/4023] Use clearer helper method

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 3edfdaa41b9..4305672648a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -107,7 +107,7 @@ protected function canAddRoute(Route $route): bool
     protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy(function (NavItem $item): int {
-            if ($item->getChildren()) {
+            if ($item->hasChildren()) {
                 return $this->getLowestPriorityInGroup($item);
             } else {
                 return $item->getPriority();

From 792e1d7a1a50d82a5e9582cc7867c12aa5c04ee0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 19:18:36 +0100
Subject: [PATCH 0454/4023] Simplify conditional returns with simple ternary
 return expression

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 4305672648a..bf445ddce9b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -107,11 +107,9 @@ protected function canAddRoute(Route $route): bool
     protected function sortByPriority(): void
     {
         $this->items = $this->items->sortBy(function (NavItem $item): int {
-            if ($item->hasChildren()) {
-                return $this->getLowestPriorityInGroup($item);
-            } else {
-                return $item->getPriority();
-            }
+            return $item->hasChildren()
+                ? $this->getLowestPriorityInGroup($item)
+                : $item->getPriority();
         })->values();
     }
 

From 397de0086d51b19230f12854f967ed8d1fcba790 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 20:18:36 +0100
Subject: [PATCH 0455/4023] Get items directly as all items are evaluated to be
 groups at this point

If there is a single group, the generator puts all null groups into "Other".
---
 .../resources/views/components/docs/sidebar-items.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index cebd57f4833..b05aad8f57b 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -8,7 +8,7 @@
 @else
     <ul id="sidebar-items" role="list">
         @php ($collapsible = config('docs.sidebar.collapsible', true))
-        @foreach ($sidebar->getGroups() as $group)
+        @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group) ? 'true' : 'false' }} }" @endif>
                 <header class="sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center @if($collapsible) group hover:bg-black/10 @endif" @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
                     <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ $sidebar->makeGroupTitle($group) }}</h4>

From 2235f56164e5b5bba66882c5648f1a4dc12f64f3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 20:27:33 +0100
Subject: [PATCH 0456/4023] Update sidebar view to use new navigation item
 format

---
 .../resources/views/components/docs/sidebar-items.blade.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index b05aad8f57b..a0acc5d1b3a 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -11,13 +11,13 @@
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group) ? 'true' : 'false' }} }" @endif>
                 <header class="sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center @if($collapsible) group hover:bg-black/10 @endif" @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
-                    <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ $sidebar->makeGroupTitle($group) }}</h4>
+                    <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ Hyde::makeTitle($group->getLabel()) }}</h4>
                     @if($collapsible)
                         @include('hyde::components.docs.sidebar-group-toggle-button')
                     @endif
                 </header>
                 <ul class="sidebar-group-items ml-4 px-2 mb-2" role="list" @if($collapsible) x-show="groupOpen" @endif>
-                    @foreach ($sidebar->getItemsInGroup($group) as $item)
+                    @foreach ($group->getChildren() as $item)
                         @include('hyde::components.docs.sidebar-item', ['grouped' => true])
                     @endforeach
                 </ul>

From 57c425450ca426ec3b6b79a81160e37caed441ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 20:44:17 +0100
Subject: [PATCH 0457/4023] Inline granular collection logic

We only need part of the getGroups method, so this inlines those semantics
---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 32cafd492d2..477105eb864 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -94,7 +94,10 @@ private function isPageIndexPage(): bool
     private function shouldIndexPageBeActive(string $group): bool
     {
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
-        $groupIsTheFirstOneInSidebar = $group === collect($this->getGroups())->first();
+
+        $groupIsTheFirstOneInSidebar = $group === $this->getItems()->firstWhere(function (NavItem $item): bool {
+            return $item->hasChildren();
+        })?->getIdentifier();
 
         return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
     }

From c554ad2268aaad964d0d2bbff2eebe4b16964ccd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 20:49:34 +0100
Subject: [PATCH 0458/4023] Use the identifier for comparison

---
 .../resources/views/components/docs/sidebar-items.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index a0acc5d1b3a..b2c6832f828 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -9,7 +9,7 @@
     <ul id="sidebar-items" role="list">
         @php ($collapsible = config('docs.sidebar.collapsible', true))
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
                 <header class="sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center @if($collapsible) group hover:bg-black/10 @endif" @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
                     <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ Hyde::makeTitle($group->getLabel()) }}</h4>
                     @if($collapsible)

From ba11d33b31b47dd4b32ca71366a8aa7ffbb491cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 20:59:10 +0100
Subject: [PATCH 0459/4023] Test sidebar groups are sorted by lowest found
 priority in each group

Moves test for method being deleted
---
 .../AutomaticNavigationConfigurationsTest.php | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 2a38498ec23..f926616f632 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -959,6 +959,34 @@ public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroups
         ]);
     }
 
+    public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
+    {
+        $this->assertSidebarEquals([
+            'a', 'b', 'c',
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 1]),
+            new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 2]),
+            new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 3]),
+        ]);
+
+        $this->assertSidebarEquals([
+            'c', 'b', 'a',
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 3]),
+            new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 2]),
+            new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 1]),
+        ]);
+
+        $this->assertSidebarEquals([
+            'c', 'a', 'b',
+        ], [
+            new DocumentationPage('a', ['navigation.group' => 'a', 'navigation.priority' => 100]),
+            new DocumentationPage('b', ['navigation.group' => 'b', 'navigation.priority' => 200]),
+            new DocumentationPage('c', ['navigation.group' => 'c', 'navigation.priority' => 300]),
+            new DocumentationPage('d', ['navigation.group' => 'c', 'navigation.priority' => 10]),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From 035dcd18ed9ee863bcf59eb6c7a3a3de4394b294 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:01:29 +0100
Subject: [PATCH 0460/4023] Breaking: Remove `DocumentationSidebar::getGroups`
 method

---
 .../Navigation/DocumentationSidebar.php       | 14 ---------
 .../Services/DocumentationSidebarTest.php     | 30 -------------------
 2 files changed, 44 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 477105eb864..59b8adf58a4 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -32,20 +32,6 @@ public function hasGroups(): bool
         })->isNotEmpty();
     }
 
-    /**
-     * @deprecated Use children instead
-     *
-     * @return array<string>
-     */
-    public function getGroups(): array
-    {
-        return $this->getItems()->filter(function (NavItem $item): bool {
-            return $item->hasChildren();
-        })->map(function (NavItem $item): string {
-            return $item->getIdentifier();
-        })->values()->toArray();
-    }
-
     /**
      * @deprecated Use children instead
      *
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 76ca6abe6f9..4339193631a 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -184,36 +184,6 @@ public function testHasGroupsReturnsTrueWhenThereAreMultipleGroupsMixedWithDefau
         $this->assertTrue(DocumentationSidebar::create()->hasGroups());
     }
 
-    public function testGetGroupsReturnsEmptyArrayWhenThereAreNoGroups()
-    {
-        $this->assertEquals([], DocumentationSidebar::create()->getGroups());
-    }
-
-    public function testGetGroupsReturnsArrayOfGroupsWhenThereAreGroups()
-    {
-        $this->makePage('foo', ['navigation.group' => 'bar']);
-
-        $this->assertEquals(['bar'], DocumentationSidebar::create()->getGroups());
-    }
-
-    public function testGetGroupsReturnsArrayWithNoDuplicates()
-    {
-        $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->makePage('bar', ['navigation.group' => 'bar']);
-        $this->makePage('baz', ['navigation.group' => 'baz']);
-
-        $this->assertEquals(['bar', 'baz'], DocumentationSidebar::create()->getGroups());
-    }
-
-    public function testGroupsAreSortedByLowestFoundPriorityInEachGroup()
-    {
-        $this->makePage('foo', ['navigation.group' => 'bar', 'navigation.priority' => 100]);
-        $this->makePage('bar', ['navigation.group' => 'bar', 'navigation.priority' => 200]);
-        $this->makePage('baz', ['navigation.group' => 'baz', 'navigation.priority' => 10]);
-
-        $this->assertEquals(['baz', 'bar'], DocumentationSidebar::create()->getGroups());
-    }
-
     public function testGetItemsInGroupReturnsEmptyCollectionWhenThereAreNoItems()
     {
         $this->assertEquals(collect(), DocumentationSidebar::create()->getItemsInGroup('foo'));

From e623d7b05d0cb60f82c2a3dd5c7db4b444ee747c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:06:50 +0100
Subject: [PATCH 0461/4023] Add additional sidebar grouping test

Test all sidebar items are placed in groups when at least one item is grouped
---
 .../Feature/AutomaticNavigationConfigurationsTest.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f926616f632..cd9dc14ecca 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -987,6 +987,17 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
         ]);
     }
 
+    public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped()
+    {
+        $this->assertSidebarEquals([
+            ['label' => 'foo', 'children' => ['Grouped']],
+            ['label' => 'Other', 'children' => ['Ungrouped']],
+        ], [
+            new DocumentationPage('grouped', ['navigation.group' => 'foo']),
+            new DocumentationPage('ungrouped'),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From d4849778504d519e984d516511be0fd2e2dcd9e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:25:32 +0100
Subject: [PATCH 0462/4023] Test documentation index page is not added to
 sidebar

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index cd9dc14ecca..de132b726ae 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -543,6 +543,11 @@ public function testOnlyDocumentationPagesAreAddedToSidebar()
         ]);
     }
 
+    public function testDocumentationIndexPageIsNotAddedToSidebar()
+    {
+        $this->assertSidebarEquals([], [new DocumentationPage('index')]);
+    }
+
     // Documentation sidebar front matter tests
 
     public function testSidebarWithFrontMatterPriority()

From ae2d500309b643fbb213ff5cd58aae84d1b2253f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:28:02 +0100
Subject: [PATCH 0463/4023] Test sidebar item grouping is case insensitive

---
 .../Feature/AutomaticNavigationConfigurationsTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index de132b726ae..25c7eecf10c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -964,6 +964,15 @@ public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroups
         ]);
     }
 
+    public function testSidebarItemGroupingIsCaseInsensitive()
+    {
+        $this->assertSidebarEquals(['foo'], [
+            new DocumentationPage('foo', ['navigation.group' => 'foo']),
+            new DocumentationPage('bar', ['navigation.group' => 'Foo']),
+            new DocumentationPage('baz', ['navigation.group' => 'FOO']),
+        ]);
+    }
+
     public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     {
         $this->assertSidebarEquals([

From c302496d24c0d1e5e762a05bbfdad55122a3891a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:30:23 +0100
Subject: [PATCH 0464/4023] Breaking: Remove
 `DocumentationSidebar::getItemsInGroup` method

---
 .../Navigation/DocumentationSidebar.php       | 15 ------
 .../Services/DocumentationSidebarTest.php     | 54 -------------------
 2 files changed, 69 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 59b8adf58a4..c7139248ef8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -11,8 +11,6 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
-use function collect;
-
 /** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends NavigationMenu
 {
@@ -32,19 +30,6 @@ public function hasGroups(): bool
         })->isNotEmpty();
     }
 
-    /**
-     * @deprecated Use children instead
-     *
-     * @return Collection<\Hyde\Framework\Features\Navigation\NavItem>
-     */
-    public function getItemsInGroup(?string $group): Collection
-    {
-        // Todo might not need collections here
-        return collect($this->getItems()->first(function (NavItem $item) use ($group): bool {
-            return $item->getIdentifier() === Str::slug($group);
-        })?->getChildren() ?? []);
-    }
-
     /**
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 4339193631a..06ec3c00223 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -184,60 +184,6 @@ public function testHasGroupsReturnsTrueWhenThereAreMultipleGroupsMixedWithDefau
         $this->assertTrue(DocumentationSidebar::create()->hasGroups());
     }
 
-    public function testGetItemsInGroupReturnsEmptyCollectionWhenThereAreNoItems()
-    {
-        $this->assertEquals(collect(), DocumentationSidebar::create()->getItemsInGroup('foo'));
-    }
-
-    public function testGetItemsInGroupReturnsCollectionOfItemsInGroup()
-    {
-        $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->makePage('bar', ['navigation.group' => 'bar']);
-        $this->makePage('baz', ['navigation.group' => 'baz']);
-
-        $this->assertEquals(
-            collect([
-                NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
-            ]),
-            DocumentationSidebar::create()->getItemsInGroup('bar')
-        );
-
-        $this->assertEquals(
-            collect([
-                NavItem::fromRoute(Routes::get('docs/baz'), priority: 999),
-            ]),
-            DocumentationSidebar::create()->getItemsInGroup('baz')
-        );
-    }
-
-    public function testGetItemsInGroupNormalizesGroupNameToSlugFormat()
-    {
-        $this->makePage('a', ['navigation.group' => 'foo bar']);
-        $this->makePage('b', ['navigation.group' => 'Foo Bar']);
-        $this->makePage('c', ['navigation.group' => 'foo-bar']);
-
-        $this->assertEquals(
-            collect([
-                NavItem::fromRoute(Routes::get('docs/a'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/b'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/c'), priority: 999),
-            ]),
-            DocumentationSidebar::create()->getItemsInGroup('Foo bar')
-        );
-    }
-
-    public function testGetItemsInGroupDoesNotIncludeItemsWithHiddenFrontMatter()
-    {
-        $this->makePage('a', ['navigation.hidden' => true, 'navigation.group' => 'foo']);
-        $this->makePage('b', ['navigation.group' => 'foo']);
-
-        $this->assertEquals(
-            collect([NavItem::fromRoute(Routes::get('docs/b'), priority: 999)]),
-            DocumentationSidebar::create()->getItemsInGroup('foo')
-        );
-    }
-
     public function testGetItemsInGroupDoesNotIncludeDocsIndex()
     {
         Filesystem::touch('_docs/foo.md');

From 403e2bf175041a3130dea368518743eda92f2a44 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:40:54 +0100
Subject: [PATCH 0465/4023] Refactor to simplify internal logic

---
 .../GeneratesDocumentationSidebarMenu.php     | 24 +++++++------------
 1 file changed, 8 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index bf445ddce9b..e45d4816eec 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -44,14 +43,14 @@ protected function generate(): void
     {
         $routes = Routes::getRoutes(DocumentationPage::class);
 
-        $groups = $this->findSidebarGroups($routes);
+        $useGroups = $this->usesSidebarGroups($routes);
 
-        $routes->each(function (Route $route) use ($groups): void {
+        $routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
                 $group = $item->getGroup();
 
-                if ($groups) {
+                if ($useGroups) {
                     if (! $group) {
                         $group = 'Other';
                     }
@@ -82,21 +81,14 @@ protected function generate(): void
         }
     }
 
-    /** @experimental Might not actually be needed now that groups default to null */
-    protected function findSidebarGroups(RouteCollection $routes): array
+    protected function usesSidebarGroups(RouteCollection $routes): bool
     {
         // In order to know if we should use groups in the sidebar,
-        // we need to loop through all the pages and see if they have a group set
+        // we need to loop through the pages and see if they have a group set
 
-        $groups = [];
-
-        $routes->each(function (Route $route) use (&$groups): void {
-            if ($route->getPage()->data('navigation.group')) {
-                $groups[Str::slug($route->getPage()->data('navigation.group'))] = true;
-            }
-        });
-
-        return array_keys($groups);
+        return $routes->first(function (Route $route): bool {
+            return filled($route->getPage()->data('navigation.group'));
+        }) !== null;
     }
 
     protected function canAddRoute(Route $route): bool

From 5ae82eadce173c1aa6afec3e89ac404a3e58077c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:43:21 +0100
Subject: [PATCH 0466/4023] Support category matter for comparison

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e45d4816eec..5ed8e86708b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -87,7 +87,7 @@ protected function usesSidebarGroups(RouteCollection $routes): bool
         // we need to loop through the pages and see if they have a group set
 
         return $routes->first(function (Route $route): bool {
-            return filled($route->getPage()->data('navigation.group'));
+            return filled($route->getPage()->data('navigation.group')) || filled($route->getPage()->data('navigation.category'));
         }) !== null;
     }
 

From 27c5b2d97f2467e78ad4dddf9cac9c5cd2daa201 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:44:43 +0100
Subject: [PATCH 0467/4023] Revert "Support category matter for comparison"

This reverts commit 5ae82eadce173c1aa6afec3e89ac404a3e58077c as it is not necessary since we are actually checking the already normalized navigation data
---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 5ed8e86708b..e45d4816eec 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -87,7 +87,7 @@ protected function usesSidebarGroups(RouteCollection $routes): bool
         // we need to loop through the pages and see if they have a group set
 
         return $routes->first(function (Route $route): bool {
-            return filled($route->getPage()->data('navigation.group')) || filled($route->getPage()->data('navigation.category'));
+            return filled($route->getPage()->data('navigation.group'));
         }) !== null;
     }
 

From 622f63520deb0d021382f4eb056adc366804b306 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 21:45:44 +0100
Subject: [PATCH 0468/4023] Use specific accessor to get same data

Makes it clearer where the data is coming from
---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e45d4816eec..63f629f8024 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -87,7 +87,7 @@ protected function usesSidebarGroups(RouteCollection $routes): bool
         // we need to loop through the pages and see if they have a group set
 
         return $routes->first(function (Route $route): bool {
-            return filled($route->getPage()->data('navigation.group'));
+            return filled($route->getPage()->navigationMenuGroup());
         }) !== null;
     }
 

From 9d5162adeb27da27f524fc4fd2c0edf9aea69d5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 22:42:06 +0100
Subject: [PATCH 0469/4023] Update todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 63f629f8024..4000d84900e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -58,7 +58,7 @@ protected function generate(): void
                     $groupItem = $this->items->get($group);
 
                     if ($groupItem === null) {
-                        // Todo get group label
+                        // Todo search for group label in config
                         $groupItem = NavItem::dropdown($group, []);
                     }
 

From d55fa5c309066ae901532f0a44e54061cc8f7e5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 22:42:32 +0100
Subject: [PATCH 0470/4023] Add to todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 4000d84900e..41a1e53658a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -58,7 +58,7 @@ protected function generate(): void
                     $groupItem = $this->items->get($group);
 
                     if ($groupItem === null) {
-                        // Todo search for group label in config
+                        // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
                         $groupItem = NavItem::dropdown($group, []);
                     }
 

From 05c391b7e850b3ec0f83fa8b676ebd0197a762ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 22:46:38 +0100
Subject: [PATCH 0471/4023] Format back the grouped navigation item titles

---
 .../components/docs/sidebar-items.blade.php   |  2 +-
 .../GeneratesDocumentationSidebarMenu.php     |  3 +-
 .../AutomaticNavigationConfigurationsTest.php | 45 +++++++++----------
 .../Services/DocumentationSidebarTest.php     |  6 +--
 4 files changed, 26 insertions(+), 30 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index b2c6832f828..37a416bdc89 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -11,7 +11,7 @@
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
                 <header class="sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center @if($collapsible) group hover:bg-black/10 @endif" @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
-                    <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ Hyde::makeTitle($group->getLabel()) }}</h4>
+                    <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ $group->getLabel() }}</h4>
                     @if($collapsible)
                         @include('hyde::components.docs.sidebar-group-toggle-button')
                     @endif
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 41a1e53658a..1168c20d964 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -59,7 +60,7 @@ protected function generate(): void
 
                     if ($groupItem === null) {
                         // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
-                        $groupItem = NavItem::dropdown($group, []);
+                        $groupItem = NavItem::dropdown(Hyde::makeTitle($group), []);
                     }
 
                     $groupItem->addChild($item);
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 25c7eecf10c..c88df773866 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -622,7 +622,7 @@ public function testSidebarWithFrontMatterVisible()
     public function testSidebarWithFrontMatterGroup()
     {
         $this->assertSidebarEquals([[
-            'label' => 'group-1', // Todo: Should use proper group name
+            'label' => 'Group 1',
             'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new DocumentationPage('foo', ['navigation.group' => 'Group 1']),
@@ -634,7 +634,7 @@ public function testSidebarWithFrontMatterGroup()
     public function testSidebarWithFrontMatterCategory()
     {
         $this->assertSidebarEquals([[
-            'label' => 'group-1', // Todo: Should use proper group name
+            'label' => 'Group 1',
             'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new DocumentationPage('foo', ['navigation.category' => 'Group 1']),
@@ -706,7 +706,7 @@ public function testSidebarWithFrontMatterGroupAndCategory()
         // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
 
         $this->assertSidebarEquals([[
-            'label' => 'group-1', // Todo: Should use proper group name
+            'label' => 'Group 1',
             'children' => ['Foo', 'Bar', 'Baz'],
         ]], [
             new DocumentationPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
@@ -850,7 +850,7 @@ public function testSidebarWithConfigHidden()
     public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()
     {
         $this->assertSidebarEquals([[
-            'label' => 'about', // Todo: Should use proper group name
+            'label' => 'About',
             'children' => ['Foo', 'Bar', 'Baz'],
         ]], [
             new DocumentationPage('about/foo'),
@@ -867,7 +867,7 @@ public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfigurat
             config(['docs.sidebar.subdirectories' => $option]);
 
             $this->assertSidebarEquals([[
-                'label' => 'about', // Todo: Should use proper group name
+                'label' => 'About',
                 'children' => ['Foo', 'Bar', 'Baz'],
             ]], [
                 new DocumentationPage('about/foo'),
@@ -903,9 +903,8 @@ public function testSidebarItemsWithTheSameLabelAreNotFilteredForDuplicatesRegar
     public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     {
         $this->assertSidebarEquals([
-            // Todo: Should use proper group name
-            ['label' => 'group-1', 'children' => ['Foo']],
-            ['label' => 'group-2', 'children' => ['Foo']],
+            ['label' => 'Group 1', 'children' => ['Foo']],
+            ['label' => 'Group 2', 'children' => ['Foo']],
         ], [
             new DocumentationPage('foo', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 1']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 2']),
@@ -915,9 +914,8 @@ public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
     {
         $this->assertSidebarEquals([
-            // Todo: Should use proper group name
-            ['label' => 'group-1', 'children' => ['Foo']],
-            ['label' => 'group-2', 'children' => ['Foo']],
+            ['label' => 'Group 1', 'children' => ['Foo']],
+            ['label' => 'Group 2', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
             new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
@@ -927,9 +925,8 @@ public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFilter
     public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
     {
         $this->assertSidebarEquals([
-            // Todo: Should use proper group name
-            ['label' => 'one', 'children' => ['Foo']],
-            ['label' => 'two', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo'),
             new DocumentationPage('two/foo'),
@@ -941,9 +938,8 @@ public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreNotFil
         config(['docs.flattened_output_paths' => false]);
 
         $this->assertSidebarEquals([
-            // Todo: Should use proper group name
-            ['label' => 'group-1', 'children' => ['Foo']],
-            ['label' => 'group-2', 'children' => ['Foo']],
+            ['label' => 'Group 1', 'children' => ['Foo']],
+            ['label' => 'Group 2', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
             new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
@@ -955,9 +951,8 @@ public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroups
         config(['docs.flattened_output_paths' => false]);
 
         $this->assertSidebarEquals([
-            // Todo: Should use proper group name
-            ['label' => 'one', 'children' => ['Foo']],
-            ['label' => 'two', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
             new DocumentationPage('one/foo'),
             new DocumentationPage('two/foo'),
@@ -966,7 +961,7 @@ public function testSidebarAutomaticDropdownItemsWithSameLabelButDifferentGroups
 
     public function testSidebarItemGroupingIsCaseInsensitive()
     {
-        $this->assertSidebarEquals(['foo'], [
+        $this->assertSidebarEquals(['Foo'], [
             new DocumentationPage('foo', ['navigation.group' => 'foo']),
             new DocumentationPage('bar', ['navigation.group' => 'Foo']),
             new DocumentationPage('baz', ['navigation.group' => 'FOO']),
@@ -976,7 +971,7 @@ public function testSidebarItemGroupingIsCaseInsensitive()
     public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     {
         $this->assertSidebarEquals([
-            'a', 'b', 'c',
+            'A', 'B', 'C',
         ], [
             new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 1]),
             new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 2]),
@@ -984,7 +979,7 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
         ]);
 
         $this->assertSidebarEquals([
-            'c', 'b', 'a',
+            'C', 'B', 'A',
         ], [
             new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 3]),
             new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 2]),
@@ -992,7 +987,7 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
         ]);
 
         $this->assertSidebarEquals([
-            'c', 'a', 'b',
+            'C', 'A', 'B',
         ], [
             new DocumentationPage('a', ['navigation.group' => 'a', 'navigation.priority' => 100]),
             new DocumentationPage('b', ['navigation.group' => 'b', 'navigation.priority' => 200]),
@@ -1004,7 +999,7 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped()
     {
         $this->assertSidebarEquals([
-            ['label' => 'foo', 'children' => ['Grouped']],
+            ['label' => 'Foo', 'children' => ['Grouped']],
             ['label' => 'Other', 'children' => ['Ungrouped']],
         ], [
             new DocumentationPage('grouped', ['navigation.group' => 'foo']),
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 06ec3c00223..e6bb1b17868 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -280,10 +280,10 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
 
         $this->assertEquals(
             collect([
-                NavItem::dropdown('bar', [
+                NavItem::dropdown('Bar', [
                     NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
                 ]),
-                NavItem::dropdown('foo', [
+                NavItem::dropdown('Foo', [
                     NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
@@ -301,7 +301,7 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
 
         $this->assertEquals(
             collect([
-                NavItem::dropdown('foo', [
+                NavItem::dropdown('Foo', [
                     NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
                     NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
                 ]),

From 0562e13df0f4fc8b4854202e9849ca67108308fa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 19 Feb 2024 22:54:18 +0100
Subject: [PATCH 0472/4023] Refactor view to use dynamic class directives

---
 .../resources/views/components/docs/sidebar-items.blade.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 37a416bdc89..615ea53dcd4 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -10,8 +10,8 @@
         @php ($collapsible = config('docs.sidebar.collapsible', true))
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
-                <header class="sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center @if($collapsible) group hover:bg-black/10 @endif" @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
-                    <h4 class="sidebar-group-heading text-base font-semibold @if($collapsible) cursor-pointer dark:group-hover:text-white @endif">{{ $group->getLabel() }}</h4>
+                <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $collapsible]) @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
+                    <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $collapsible])>{{ $group->getLabel() }}</h4>
                     @if($collapsible)
                         @include('hyde::components.docs.sidebar-group-toggle-button')
                     @endif

From 17441a679ca3d7e923c2c7aa3ed9237022f459dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:18:31 +0100
Subject: [PATCH 0473/4023] Print states on assertion fail

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c88df773866..9243f775ebd 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1137,7 +1137,7 @@ public function assertEquals(array $expected, bool $strict = false): static
             }
         }
 
-        $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state');
+        $this->test->assertCount(count($expected), $this->state(), 'The expected state has a different count than the actual state'."\n".json_encode($this->state(), JSON_PRETTY_PRINT));
 
         return $this;
     }

From 71e44c3b9284ec9ca3c75ba5239eb56b5769e297 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:19:15 +0100
Subject: [PATCH 0474/4023] Test sidebar item grouping is normalized

---
 .../Feature/AutomaticNavigationConfigurationsTest.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 9243f775ebd..ac84dbcc47f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -968,6 +968,16 @@ public function testSidebarItemGroupingIsCaseInsensitive()
         ]);
     }
 
+    public function testSidebarItemGroupingIsNormalized()
+    {
+        $this->assertSidebarEquals(['Hello World'], [
+            new DocumentationPage('foo', ['navigation.group' => 'hello world']),
+            new DocumentationPage('bar', ['navigation.group' => 'hello-world']),
+            new DocumentationPage('baz', ['navigation.group' => 'hello_world']),
+            new DocumentationPage('qux', ['navigation.group' => 'Hello World']),
+        ]);
+    }
+
     public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     {
         $this->assertSidebarEquals([

From 758cb3762acb0f0fdbf5d205ff1e42b682383627 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:26:06 +0100
Subject: [PATCH 0475/4023] Sketch out test

---
 .../Feature/AutomaticNavigationConfigurationsTest.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ac84dbcc47f..5a7205c1d10 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -978,6 +978,16 @@ public function testSidebarItemGroupingIsNormalized()
         ]);
     }
 
+    public function testSidebarLabelsRetainBestFormatting()
+    {
+        $this->markTestSkipped('Not yet implemented');
+
+        $this->assertSidebarEquals(['GitHub'], [
+            new DocumentationPage('foo', ['navigation.group' => 'GitHub']),
+            new DocumentationPage('bar', ['navigation.group' => 'github']),
+        ]);
+    }
+
     public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     {
         $this->assertSidebarEquals([

From cca7269f57b8f0f74621710b7c2bf99fa8622812 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:30:48 +0100
Subject: [PATCH 0476/4023] Extract helper method

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 1168c20d964..28c89a78325 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -59,8 +59,7 @@ protected function generate(): void
                     $groupItem = $this->items->get($group);
 
                     if ($groupItem === null) {
-                        // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
-                        $groupItem = NavItem::dropdown(Hyde::makeTitle($group), []);
+                        $groupItem = NavItem::dropdown($this->makeTitleForGroup($group), []);
                     }
 
                     $groupItem->addChild($item);
@@ -92,6 +91,13 @@ protected function usesSidebarGroups(RouteCollection $routes): bool
         }) !== null;
     }
 
+    protected function makeTitleForGroup(string $group): string
+    {
+        // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
+
+        return Hyde::makeTitle($group);
+    }
+
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());

From ed9701aec2eee78be175c921f76fc893826e205d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:37:09 +0100
Subject: [PATCH 0477/4023] Move sidebar group title generation to action

---
 .../GeneratesDocumentationSidebarMenu.php      |  3 ++-
 .../AutomaticNavigationConfigurationsTest.php  |  9 +++++++++
 .../Services/DocumentationSidebarTest.php      | 18 ------------------
 3 files changed, 11 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 28c89a78325..20becf179de 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Hyde;
+use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -95,7 +96,7 @@ protected function makeTitleForGroup(string $group): string
     {
         // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
 
-        return Hyde::makeTitle($group);
+        return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
     }
 
     protected function canAddRoute(Route $route): bool
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5a7205c1d10..03fc8d38a94 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -988,6 +988,15 @@ public function testSidebarLabelsRetainBestFormatting()
         ]);
     }
 
+    public function testSidebarLabelsCanBeSetInConfig()
+    {
+        config(['docs.sidebar_group_labels' => ['foo' => 'Hello world!']]);
+
+        $this->assertSidebarEquals(['Hello world!'], [
+            new DocumentationPage('foo', ['navigation.group' => 'foo']),
+        ]);
+    }
+
     public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
     {
         $this->assertSidebarEquals([
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index e6bb1b17868..c7d79c3faad 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -252,24 +252,6 @@ public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenu
         $this->assertTrue(DocumentationSidebar::create()->isGroupActive('baz'));
     }
 
-    public function testMakeGroupTitleTurnsGroupKeyIntoTitle()
-    {
-        $this->assertSame('Hello World', DocumentationSidebar::create()->makeGroupTitle('hello world'));
-        $this->assertSame('Hello World', DocumentationSidebar::create()->makeGroupTitle('hello-world'));
-        $this->assertSame('Hello World', DocumentationSidebar::create()->makeGroupTitle('hello_world'));
-        $this->assertSame('Hello World', DocumentationSidebar::create()->makeGroupTitle('helloWorld'));
-    }
-
-    public function testMakeGroupTitleUsesConfiguredSidebarGroupLabelsWhenAvailable()
-    {
-        Config::set('docs.sidebar_group_labels', [
-            'example' => 'Hello world!',
-        ]);
-
-        $this->assertSame('Hello world!', DocumentationSidebar::create()->makeGroupTitle('example'));
-        $this->assertSame('Default', DocumentationSidebar::create()->makeGroupTitle('default'));
-    }
-
     public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
     {
         $this->makePage('foo', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);

From 047950508cf76354e1a1c67b3e5c17dd93be1a34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 08:38:17 +0100
Subject: [PATCH 0478/4023] Breaking: Remove method
 `DocumentationSidebar::makeGroupTitle`

---
 .../Features/Navigation/DocumentationSidebar.php     | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c7139248ef8..413bf51d736 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
-use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Collection;
@@ -47,16 +45,6 @@ public function isGroupActive(?string $group): bool
         return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;
     }
 
-    /**
-     * @deprecated With the new NavItem system this should not be necessary, as the parent has a title
-     *
-     * @todo Get title from instance
-     */
-    public function makeGroupTitle(?string $group): string
-    {
-        return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group ?? 'Other');
-    }
-
     private function isPageIndexPage(): bool
     {
         return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());

From d3b858089c773d435327b947edf180aaa7818d4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 11:47:57 +0100
Subject: [PATCH 0479/4023] Simplify collection state check

It's about 0.001ms faster which does not matter at all, but it is more readable I think
---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 413bf51d736..8c32ef768c8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -23,9 +23,9 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->filter(function (NavItem $item): bool {
+        return $this->getItems()->contains(function (NavItem $item): bool {
             return $item->hasChildren();
-        })->isNotEmpty();
+        });
     }
 
     /**

From 869676f98464377c6a3db5a96e7d59583e6f166b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 11:48:10 +0100
Subject: [PATCH 0480/4023] Convert closure to arrow function

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8c32ef768c8..5c079ea2804 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -23,9 +23,7 @@ public static function create(): static
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(function (NavItem $item): bool {
-            return $item->hasChildren();
-        });
+        return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
     }
 
     /**

From 290664e9efe466c10e84000d373805c465ef2024 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 11:49:45 +0100
Subject: [PATCH 0481/4023] Introduce local variable to make operation clearer

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5c079ea2804..95b2d87abe9 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -52,9 +52,11 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
-        $groupIsTheFirstOneInSidebar = $group === $this->getItems()->firstWhere(function (NavItem $item): bool {
+        $firstGroupInSidebar = $this->getItems()->firstWhere(function (NavItem $item): bool {
             return $item->hasChildren();
-        })?->getIdentifier();
+        });
+
+        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getIdentifier();
 
         return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
     }

From 271f05a150b65f6132c7f8503a1a37eba8ab8ce0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 11:53:43 +0100
Subject: [PATCH 0482/4023] Document why item sorting is needed here

We could also trigger a resort when items are added, but I don't think it's that big of a problem (Sorting takes ~0.003ms)
---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 0c1e610a0e2..48427b978f9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -36,6 +36,10 @@ public function __construct(Arrayable|array $items = [])
      */
     public function getItems(): Collection
     {
+        // The reason we sort them here is that navigation items can be added from different sources,
+        // so any sorting we do in generator actions will only be partial. This way, we can ensure
+        // that the items are always freshly sorted by their priorities when they are retrieved.
+
         return $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
     }
 

From 84b5e27bc15d3aee0abd60dad1e2d69900e7a6ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 11:55:35 +0100
Subject: [PATCH 0483/4023] Document why items are added in a loop

---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 48427b978f9..d7a1a92d221 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -23,6 +23,10 @@ public function __construct(Arrayable|array $items = [])
         $this->items = new Collection();
 
         foreach ($items as $item) {
+            // Instead of adding the items directly, we iterate through them and
+            // add them through the helper. This ensures that all the items are
+            // of the correct type, bringing type safety to the menu's items.
+
             $this->add($item);
         }
     }

From 2a2dbb8dd922989002c6cd3bc7ddf76e928be71e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 12:16:54 +0100
Subject: [PATCH 0484/4023] Expand on class documentation

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index d7a1a92d221..23e3ba7b3f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -9,6 +9,11 @@
 
 /**
  * Represents a site navigation menu, and contains all of its navigation items.
+ *
+ * The automatic navigation menus are stored within the service container and can be resolved by their identifiers.
+ *
+ * @example `$menu = app('navigation')->getMenu('main');` for the main navigation menu.
+ * @example `$menu = app('navigation')->getMenu('sidebar');` for the documentation sidebar.
  */
 class NavigationMenu
 {

From a66e1ae11243240be34462ad3a71436b067024ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 12:17:46 +0100
Subject: [PATCH 0485/4023] Convert closure to arrow function

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 95b2d87abe9..4a0cbd53e46 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -52,9 +52,7 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
-        $firstGroupInSidebar = $this->getItems()->firstWhere(function (NavItem $item): bool {
-            return $item->hasChildren();
-        });
+        $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item->hasChildren());
 
         $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getIdentifier();
 

From 1ecc60c4edc757f337c8e0045da15fd5256ed16b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 12:19:25 +0100
Subject: [PATCH 0486/4023] Document method feature

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4a0cbd53e46..67fa6ae3c99 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -50,6 +50,8 @@ private function isPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
+        // Unless the index page has a specific group set, the first group in the sidebar should be active.
+
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
         $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item->hasChildren());

From 6d02202ae55f06342fbc558c4c08895030ca63c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 12:34:57 +0100
Subject: [PATCH 0487/4023] Remove null handling as type is evaluated at this
 point

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 67fa6ae3c99..cb9433ed093 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -31,12 +31,8 @@ public function hasGroups(): bool
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */
-    public function isGroupActive(?string $group): bool
+    public function isGroupActive(string $group): bool
     {
-        if ($group === null) {
-            return false;
-        }
-
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
 

From b50d06d47fb69e267dcea8993044a8a46c094885 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:31:43 +0100
Subject: [PATCH 0488/4023] Remove resolved part of todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 20becf179de..c26319125bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -94,7 +94,7 @@ protected function usesSidebarGroups(RouteCollection $routes): bool
 
     protected function makeTitleForGroup(string $group): string
     {
-        // Todo search for group label in config (we can also search for other labels in the group before slugifying them)
+        // Todo search for other labels in the group before slugifying them
 
         return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
     }

From 9b683e6f22ef187114d82caf3a4fd9ca83b72a06 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:38:53 +0100
Subject: [PATCH 0489/4023] Document reasoning behind extra sort

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c26319125bb..2af8b9626e8 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -106,6 +106,9 @@ protected function canAddRoute(Route $route): bool
 
     protected function sortByPriority(): void
     {
+        // While the items accessor sorts the items upon retrieval,
+        // we do an initial sorting here to order any groups.
+
         $this->items = $this->items->sortBy(function (NavItem $item): int {
             return $item->hasChildren()
                 ? $this->getLowestPriorityInGroup($item)

From 26b28d12dc61ca99ddf384c5ed3d23d5c0c12f8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:44:27 +0100
Subject: [PATCH 0490/4023] Break up coalesce return

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 2af8b9626e8..66cabdca506 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -96,7 +96,13 @@ protected function makeTitleForGroup(string $group): string
     {
         // Todo search for other labels in the group before slugifying them
 
-        return Config::getNullableString("docs.sidebar_group_labels.$group") ?? Hyde::makeTitle($group);
+        $configLabel = Config::getNullableString("docs.sidebar_group_labels.$group");
+
+        if ($configLabel) {
+            return $configLabel;
+        }
+
+        return Hyde::makeTitle($group);
     }
 
     protected function canAddRoute(Route $route): bool

From 97f74c3799e4d156b31f4f3f2a7b13ab6079789a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:48:32 +0100
Subject: [PATCH 0491/4023] Refactor local variable to instance property

---
 .../GeneratesDocumentationSidebarMenu.php          | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 66cabdca506..024aeb7e5a0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -26,9 +26,13 @@ class GeneratesDocumentationSidebarMenu
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
+    /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
+    protected RouteCollection $routes;
+
     protected function __construct()
     {
         $this->items = new Collection();
+        $this->routes = Routes::getRoutes(DocumentationPage::class);
     }
 
     public static function handle(): DocumentationSidebar
@@ -43,11 +47,9 @@ public static function handle(): DocumentationSidebar
 
     protected function generate(): void
     {
-        $routes = Routes::getRoutes(DocumentationPage::class);
-
-        $useGroups = $this->usesSidebarGroups($routes);
+        $useGroups = $this->usesSidebarGroups();
 
-        $routes->each(function (Route $route) use ($useGroups): void {
+        $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
                 $group = $item->getGroup();
@@ -82,12 +84,12 @@ protected function generate(): void
         }
     }
 
-    protected function usesSidebarGroups(RouteCollection $routes): bool
+    protected function usesSidebarGroups(): bool
     {
         // In order to know if we should use groups in the sidebar,
         // we need to loop through the pages and see if they have a group set
 
-        return $routes->first(function (Route $route): bool {
+        return $this->routes->first(function (Route $route): bool {
             return filled($route->getPage()->navigationMenuGroup());
         }) !== null;
     }

From ae14037e332fc06449a87187f4b858e88d9eecc2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:53:37 +0100
Subject: [PATCH 0492/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 2b16f03cfff..5e5b18588d5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -89,6 +89,8 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     /**
      * Create a new dropdown navigation menu item.
      *
+     * @TODO: Might be more semantic to have this named something else, as it also includes sidebars groups.
+     *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority.

From 2ad01e4979a5fb450b728e8b293683ba680294af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:56:23 +0100
Subject: [PATCH 0493/4023] Add todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 024aeb7e5a0..1153d1cad9b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -94,6 +94,7 @@ protected function usesSidebarGroups(): bool
         }) !== null;
     }
 
+    /** Todo: Refactor to move label resolver to model classRefactor to move label resolver to model class */
     protected function makeTitleForGroup(string $group): string
     {
         // Todo search for other labels in the group before slugifying them

From 7ca644fefd2620d6848f1fc023cedbb3a5dfaf41 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:58:20 +0100
Subject: [PATCH 0494/4023] Add todo

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5e5b18588d5..26c6a634350 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -205,6 +205,7 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
+    // TODO: Consider moving all of these to a dropdown factory
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
         /** @var array<string, int> $config */

From 6ef6f70e3c90f3c83612d474c4e345d3f8034129 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 13:59:17 +0100
Subject: [PATCH 0495/4023] Test default dropdown item priority

---
 packages/framework/tests/Unit/NavItemTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index f2caf94538c..2039c4b93d8 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -396,4 +396,9 @@ public function testCanAddItemToDropdown()
 
         $this->assertSame([$child], $parent->getChildren());
     }
+
+    public function testDefaultDropdownItemPriority()
+    {
+        $this->assertSame(999, NavItem::dropdown('foo', [])->getPriority());
+    }
 }

From dc68cadb846540a7f38167e33787ded90fb0fa89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:01:46 +0100
Subject: [PATCH 0496/4023] Test can resolve dropdown item priority from config

---
 packages/framework/tests/Unit/NavItemTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 2039c4b93d8..ebcd7e675dd 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -401,4 +401,11 @@ public function testDefaultDropdownItemPriority()
     {
         $this->assertSame(999, NavItem::dropdown('foo', [])->getPriority());
     }
+
+    public function testCanResolveDropdownItemPriorityFromConfig()
+    {
+        $this->mockConfig(['hyde.navigation.order' => ['foo' => 500]]);
+
+        $this->assertSame(500, NavItem::dropdown('foo', [])->getPriority());
+    }
 }

From 80d5644c89f80d81ecf789661b5398a12ca986a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:02:40 +0100
Subject: [PATCH 0497/4023] Extract new method for normalizing group labels

---
 .../src/Framework/Features/Navigation/NavItem.php          | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 26c6a634350..6c010022ee5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
         // TODO resolve label from config here instead of view
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
+        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
     }
 
     /**
@@ -205,6 +205,11 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
+    protected static function normalizeGroupLabel(string $label): string
+    {
+        return $label;
+    }
+
     // TODO: Consider moving all of these to a dropdown factory
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {

From 0a1c29cccc7499c74b642ae9215ea22cffd2c560 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:07:16 +0100
Subject: [PATCH 0498/4023] Fix todo comment

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 1153d1cad9b..e7751e47826 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -94,7 +94,7 @@ protected function usesSidebarGroups(): bool
         }) !== null;
     }
 
-    /** Todo: Refactor to move label resolver to model classRefactor to move label resolver to model class */
+    /** Todo: Refactor to move label resolver to model class */
     protected function makeTitleForGroup(string $group): string
     {
         // Todo search for other labels in the group before slugifying them

From d3a0a59175dc30243b05a64b702b3efe8a56f62e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:08:18 +0100
Subject: [PATCH 0499/4023] Refactor to move config label resolver to model
 class

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 --------
 .../src/Framework/Features/Navigation/NavItem.php         | 6 ++++++
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e7751e47826..9a964b53f1a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Hyde;
-use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -94,17 +93,10 @@ protected function usesSidebarGroups(): bool
         }) !== null;
     }
 
-    /** Todo: Refactor to move label resolver to model class */
     protected function makeTitleForGroup(string $group): string
     {
         // Todo search for other labels in the group before slugifying them
 
-        $configLabel = Config::getNullableString("docs.sidebar_group_labels.$group");
-
-        if ($configLabel) {
-            return $configLabel;
-        }
-
         return Hyde::makeTitle($group);
     }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6c010022ee5..317d11eda6e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -207,6 +207,12 @@ protected static function makeIdentifier(string $label): string
 
     protected static function normalizeGroupLabel(string $label): string
     {
+        $configLabel = Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($label));
+
+        if ($configLabel) {
+            return $configLabel;
+        }
+
         return $label;
     }
 

From 64f663491e23489983e4fec88d6d5f031d984a94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:34:22 +0100
Subject: [PATCH 0500/4023] Add accessor hook to make the group label

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 317d11eda6e..9900b45f62f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -130,6 +130,10 @@ public function getLink(): string
      */
     public function getLabel(): string
     {
+        if ($this->hasChildren()) {
+            return $this->makeGroupLabel();
+        }
+
         return $this->label;
     }
 

From 54a82d048a3ca6efbc62884066e61c7f2a37f4cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:35:05 +0100
Subject: [PATCH 0501/4023] Sketch out group label generator method

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 9900b45f62f..bb70406f858 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -232,4 +232,10 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
 
         return $config[$groupKey] ?? null;
     }
+
+    /** Find the best label for the group. */
+    protected function makeGroupLabel(): string
+    {
+        return static::normalizeGroupLabel($this->label);
+    }
 }

From 0cb1fad3a812131b6c21aab7843f2ed9a67ef7b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:37:33 +0100
Subject: [PATCH 0502/4023] Inline adapted normalization method

---
 .../src/Framework/Features/Navigation/NavItem.php         | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index bb70406f858..7e354f4ba7f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -236,6 +236,12 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
     /** Find the best label for the group. */
     protected function makeGroupLabel(): string
     {
-        return static::normalizeGroupLabel($this->label);
+        $configLabel = Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($this->identifier));
+
+        if ($configLabel) {
+            return $configLabel;
+        }
+
+        return $this->label;
     }
 }

From 6e858fcea79b14e422805ad2cc8ebe2e95a665c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:39:29 +0100
Subject: [PATCH 0503/4023] Remove label normalization at create time

We don't have all the context at this point
---
 .../src/Framework/Features/Navigation/NavItem.php   | 13 +------------
 1 file changed, 1 insertion(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7e354f4ba7f..e0246f4d5db 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
         // TODO resolve label from config here instead of view
-        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
     }
 
     /**
@@ -209,17 +209,6 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
-    protected static function normalizeGroupLabel(string $label): string
-    {
-        $configLabel = Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($label));
-
-        if ($configLabel) {
-            return $configLabel;
-        }
-
-        return $label;
-    }
-
     // TODO: Consider moving all of these to a dropdown factory
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {

From 9e5dc91f7676470eb30439e1470adf4c75e77d2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:43:08 +0100
Subject: [PATCH 0504/4023] Pass label as group key even for group parents

Can allow us to have two states, one pretty for labels, and one normalized internal one
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e0246f4d5db..a5cc738a5cf 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
         // TODO resolve label from config here instead of view
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, null, $items);
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**

From 7fd874e8c519e2c96a9c6bd9404dfe281bf8972a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:47:00 +0100
Subject: [PATCH 0505/4023] Use group identifier for internal generator state

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php       | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 9a964b53f1a..87a1311647e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Hyde;
+use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -58,7 +59,7 @@ protected function generate(): void
                         $group = 'Other';
                     }
 
-                    $groupItem = $this->items->get($group);
+                    $groupItem = $this->items->get(Str::slug($group));
 
                     if ($groupItem === null) {
                         $groupItem = NavItem::dropdown($this->makeTitleForGroup($group), []);
@@ -66,8 +67,8 @@ protected function generate(): void
 
                     $groupItem->addChild($item);
 
-                    if (! $this->items->has($group)) {
-                        $this->items->put($group, $groupItem);
+                    if (! $this->items->has($groupItem->getIdentifier())) {
+                        $this->items->put($groupItem->getIdentifier(), $groupItem);
                     }
 
                     return;

From 29f78ea5e50f13cbef354f661aee6b1ef035b695 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 14:54:55 +0100
Subject: [PATCH 0506/4023] Add auxiliary assertion case to improve accuracy

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 03fc8d38a94..53f9093b410 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -986,6 +986,11 @@ public function testSidebarLabelsRetainBestFormatting()
             new DocumentationPage('foo', ['navigation.group' => 'GitHub']),
             new DocumentationPage('bar', ['navigation.group' => 'github']),
         ]);
+
+        $this->assertSidebarEquals(['GitHub'], [
+            new DocumentationPage('foo', ['navigation.group' => 'github']),
+            new DocumentationPage('bar', ['navigation.group' => 'GitHub']),
+        ]);
     }
 
     public function testSidebarLabelsCanBeSetInConfig()

From edd20ab28c9ec42dede280e8ca9f330c81baa6e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:11:00 +0100
Subject: [PATCH 0507/4023] Create titles when necessary

---
 .../src/Framework/Features/Navigation/NavItem.php   |  5 +++++
 .../AutomaticNavigationConfigurationsTest.php       | 13 +++++--------
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a5cc738a5cf..adc18ad7b2a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -231,6 +231,11 @@ protected function makeGroupLabel(): string
             return $configLabel;
         }
 
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($this->group === $this->label && $this->group === strtolower($this->group)) {
+            return Hyde::makeTitle($this->group);
+        }
+
         return $this->label;
     }
 }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 53f9093b410..6377a29d95b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -448,8 +448,7 @@ public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdir
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         $this->assertMenuEquals([
-            ['label' => 'about', 'children' => ['Foo', 'Bar', 'Baz']],
-            // TODO: Label should be About
+            ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new MarkdownPage('about/foo'),
             new MarkdownPage('about/bar'),
@@ -496,9 +495,8 @@ public function testMainNavigationMenuDropdownItemsWithSameLabelButDifferentGrou
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         $this->assertMenuEquals([
-            // Todo: Should use proper group name
-            ['label' => 'group-1', 'children' => ['Foo']],
-            ['label' => 'group-2', 'children' => ['Foo']],
+            ['label' => 'Group 1', 'children' => ['Foo']],
+            ['label' => 'Group 2', 'children' => ['Foo']],
         ], [
             new MarkdownPage('one/foo', ['navigation.group' => 'Group 1']),
             new MarkdownPage('two/foo', ['navigation.group' => 'Group 2']),
@@ -510,9 +508,8 @@ public function testMainNavigationMenuAutomaticDropdownItemsWithSameLabelButDiff
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         $this->assertMenuEquals([
-            // Todo: Should use proper group name
-            ['label' => 'one', 'children' => ['Foo']],
-            ['label' => 'two', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
             new MarkdownPage('one/foo'),
             new MarkdownPage('two/foo'),

From 9ab9700774c161f890ab343c05e8b3a64521b6b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:22:17 +0100
Subject: [PATCH 0508/4023] Extract helper method

---
 .../src/Framework/Features/Navigation/NavItem.php     | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index adc18ad7b2a..ed5ad39cfdb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -232,10 +232,15 @@ protected function makeGroupLabel(): string
         }
 
         // If there is no label, and the group is a slug, we can make a title from it
-        if ($this->group === $this->label && $this->group === strtolower($this->group)) {
-            return Hyde::makeTitle($this->group);
+        return $this->normalizeLabel($this->group);
+    }
+
+    protected function normalizeLabel(string $label): ?string
+    {
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
         }
 
-        return $this->label;
+        return $label;
     }
 }

From 2a1c38fa9094906daff4f933c5a434b7fe9c87c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:23:32 +0100
Subject: [PATCH 0509/4023] Normalize label at construct

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ed5ad39cfdb..d9b48554a2d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -45,7 +45,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         }
 
         $this->destination = $destination;
-        $this->label = $label;
+        $this->label = $this->normalizeLabel($label);
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = $this->makeIdentifier($label);

From a9638ab3b6b67715d3f3626bdf32500a90e5f338 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:23:36 +0100
Subject: [PATCH 0510/4023] Remove redundant title generation

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 87a1311647e..a82d86721ba 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
@@ -62,7 +61,7 @@ protected function generate(): void
                     $groupItem = $this->items->get(Str::slug($group));
 
                     if ($groupItem === null) {
-                        $groupItem = NavItem::dropdown($this->makeTitleForGroup($group), []);
+                        $groupItem = NavItem::dropdown($group, []);
                     }
 
                     $groupItem->addChild($item);
@@ -94,13 +93,6 @@ protected function usesSidebarGroups(): bool
         }) !== null;
     }
 
-    protected function makeTitleForGroup(string $group): string
-    {
-        // Todo search for other labels in the group before slugifying them
-
-        return Hyde::makeTitle($group);
-    }
-
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());

From b7e858825e553a26f0568a167a74ab7ef731b6cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:25:35 +0100
Subject: [PATCH 0511/4023] Handle null case as property can be explicitly set
 to null

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d9b48554a2d..01c7ccaf4d8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -235,9 +235,9 @@ protected function makeGroupLabel(): string
         return $this->normalizeLabel($this->group);
     }
 
-    protected function normalizeLabel(string $label): ?string
+    protected function normalizeLabel(?string $label): ?string
     {
-        if ($label === strtolower($label)) {
+        if ($label && ($label === strtolower($label))) {
             return Hyde::makeTitle($label);
         }
 

From 9a228f160d38b7088b801816347243c3c717cd79 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:26:24 +0100
Subject: [PATCH 0512/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 01c7ccaf4d8..891e8ddbadd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -196,6 +196,8 @@ public function isCurrent(): bool
      */
     public function addChild(NavItem $item): void
     {
+        // Todo: Ensure that the item has a group identifier by creating it from the label if it doesn't exist?
+
         $this->children[] = $item;
     }
 

From 18e2511b870ece71b953bb11621ebf6867405112 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:29:57 +0100
Subject: [PATCH 0513/4023] Coalesce to try label

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 891e8ddbadd..ac4d5dc3e6a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -234,7 +234,7 @@ protected function makeGroupLabel(): string
         }
 
         // If there is no label, and the group is a slug, we can make a title from it
-        return $this->normalizeLabel($this->group);
+        return $this->normalizeLabel($this->group ?? $this->label);
     }
 
     protected function normalizeLabel(?string $label): ?string

From bb46d130f84cb0ce14cdcb72690305a63ad6be1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 15:31:11 +0100
Subject: [PATCH 0514/4023] Update to expect pretty labels

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 4 ++--
 packages/framework/tests/Unit/NavItemTest.php             | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 6377a29d95b..85ae4436594 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -472,7 +472,7 @@ public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDupl
             new MarkdownPage('FOO'),
         ]);
 
-        $this->assertMenuEquals(['foo', 'Foo', 'FOO'], [
+        $this->assertMenuEquals(['Foo', 'Foo', 'FOO'], [
             new MarkdownPage('foo', ['navigation.label' => 'foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
             new MarkdownPage('baz', ['navigation.label' => 'FOO']),
@@ -890,7 +890,7 @@ public function testSidebarItemsWithTheSameLabelAreNotFilteredForDuplicatesRegar
             new DocumentationPage('FOO'),
         ]);
 
-        $this->assertSidebarEquals(['foo', 'Foo', 'FOO'], [
+        $this->assertSidebarEquals(['Foo', 'Foo', 'FOO'], [
             new DocumentationPage('foo', ['navigation.label' => 'foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),
             new DocumentationPage('baz', ['navigation.label' => 'FOO']),
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index ebcd7e675dd..957ec88cbca 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -186,7 +186,7 @@ public function testForLink()
         $item = NavItem::forLink('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
-        $this->assertSame('bar', $item->getLabel());
+        $this->assertSame('Bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
     }
 
@@ -201,7 +201,7 @@ public function testForRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('foo', $item->getLabel());
+        $this->assertSame('Foo', $item->getLabel());
         $this->assertSame(999, $item->getPriority());
     }
 
@@ -211,7 +211,7 @@ public function testForIndexRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('foo', $item->getLabel());
+        $this->assertSame('Foo', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
     }
 
@@ -265,7 +265,7 @@ public function testDropdownFacade()
     {
         $item = NavItem::dropdown('foo', []);
 
-        $this->assertSame('foo', $item->getLabel());
+        $this->assertSame('Foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
         $this->assertSame(999, $item->getPriority());
     }

From 30373f7685de7146a3687473fa3997fcdbf0a0a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:08:40 +0100
Subject: [PATCH 0515/4023] Add label casing tests

---
 .../AutomaticNavigationConfigurationsTest.php | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 85ae4436594..8118ba124bb 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1038,6 +1038,68 @@ public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped(
         ]);
     }
 
+    // Label casing tests
+
+    public function testMainMenuNavigationItemCasing()
+    {
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('Hello World')]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello-world')]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello world')]);
+    }
+
+    public function testMainMenuNavigationItemCasingUsingFrontMatter()
+    {
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'Hello World'])]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'hello-world'])]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'hello world'])]);
+    }
+
+    public function testMainMenuNavigationGroupCasing()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('Hello World/foo')]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello-world/foo')]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello world/foo')]);
+    }
+
+    public function testMainMenuNavigationGroupCasingUsingFrontMatter()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
+
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'Hello World'])]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'hello-world'])]);
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'hello world'])]);
+    }
+
+    public function testSidebarItemCasing()
+    {
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('Hello World')]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello-world')]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello world')]);
+    }
+
+    public function testSidebarItemCasingUsingFrontMatter()
+    {
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'Hello World'])]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'hello-world'])]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'hello world'])]);
+    }
+
+    public function testSidebarGroupCasing()
+    {
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('Hello World/foo')]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello-world/foo')]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello world/foo')]);
+    }
+
+    public function testSidebarGroupCasingUsingFrontMatter()
+    {
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'Hello World'])]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello-world'])]);
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello world'])]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void

From 649142b78a521f4d82b4b71242db014a92383f60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:11:25 +0100
Subject: [PATCH 0516/4023] Revert "Normalize label at construct"

This reverts commit 2a1c38fa9094906daff4f933c5a434b7fe9c87c9.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ac4d5dc3e6a..99b7fc3414e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -45,7 +45,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         }
 
         $this->destination = $destination;
-        $this->label = $this->normalizeLabel($label);
+        $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = $this->makeIdentifier($label);

From ffe7314cbe80a325af56859e33be428ae8b7d96a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:12:03 +0100
Subject: [PATCH 0517/4023] Normalize group label at construct

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 99b7fc3414e..abadee85f53 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
         // TODO resolve label from config here instead of view
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', static::normalizeLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -237,7 +237,7 @@ protected function makeGroupLabel(): string
         return $this->normalizeLabel($this->group ?? $this->label);
     }
 
-    protected function normalizeLabel(?string $label): ?string
+    protected static function normalizeLabel(?string $label): ?string
     {
         if ($label && ($label === strtolower($label))) {
             return Hyde::makeTitle($label);

From e283b5a76e4f44bc5914057edd136459b4b9a66e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:12:07 +0100
Subject: [PATCH 0518/4023] Revert "Update to expect pretty labels"

This reverts commit bb46d130f84cb0ce14cdcb72690305a63ad6be1d.
---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 4 ++--
 packages/framework/tests/Unit/NavItemTest.php             | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8118ba124bb..c683ba1cf1d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -472,7 +472,7 @@ public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDupl
             new MarkdownPage('FOO'),
         ]);
 
-        $this->assertMenuEquals(['Foo', 'Foo', 'FOO'], [
+        $this->assertMenuEquals(['foo', 'Foo', 'FOO'], [
             new MarkdownPage('foo', ['navigation.label' => 'foo']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo']),
             new MarkdownPage('baz', ['navigation.label' => 'FOO']),
@@ -890,7 +890,7 @@ public function testSidebarItemsWithTheSameLabelAreNotFilteredForDuplicatesRegar
             new DocumentationPage('FOO'),
         ]);
 
-        $this->assertSidebarEquals(['Foo', 'Foo', 'FOO'], [
+        $this->assertSidebarEquals(['foo', 'Foo', 'FOO'], [
             new DocumentationPage('foo', ['navigation.label' => 'foo']),
             new DocumentationPage('bar', ['navigation.label' => 'Foo']),
             new DocumentationPage('baz', ['navigation.label' => 'FOO']),
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 957ec88cbca..ebcd7e675dd 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -186,7 +186,7 @@ public function testForLink()
         $item = NavItem::forLink('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
-        $this->assertSame('Bar', $item->getLabel());
+        $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
     }
 
@@ -201,7 +201,7 @@ public function testForRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('Foo', $item->getLabel());
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame(999, $item->getPriority());
     }
 
@@ -211,7 +211,7 @@ public function testForIndexRoute()
         $item = NavItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getDestination());
-        $this->assertSame('Foo', $item->getLabel());
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
     }
 
@@ -265,7 +265,7 @@ public function testDropdownFacade()
     {
         $item = NavItem::dropdown('foo', []);
 
-        $this->assertSame('Foo', $item->getLabel());
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
         $this->assertSame(999, $item->getPriority());
     }

From 008910c6c92690d73a2be9e684cbf64fc6b63e12 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:17:23 +0100
Subject: [PATCH 0519/4023] Expect explicitly set front matter to be what the
 user wants

See https://github.com/hydephp/develop/pull/1576#issuecomment-1954364613
---
 .../AutomaticNavigationConfigurationsTest.php | 32 ++++++++++++++++---
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c683ba1cf1d..eaba945cf0c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1042,6 +1042,8 @@ public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped(
 
     public function testMainMenuNavigationItemCasing()
     {
+        // These labels are based on the page titles, which are made from the file names, so we try to format them
+
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('Hello World')]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello-world')]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello world')]);
@@ -1049,15 +1051,23 @@ public function testMainMenuNavigationItemCasing()
 
     public function testMainMenuNavigationItemCasingUsingFrontMatter()
     {
+        // If the user explicitly sets the label, we should respect that and assume it's already formatted correctly
+
+        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['title' => 'Hello World'])]);
+        $this->assertMenuEquals(['hello-world'], [new MarkdownPage('foo', ['title' => 'hello-world'])]);
+        $this->assertMenuEquals(['hello world'], [new MarkdownPage('foo', ['title' => 'hello world'])]);
+
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'Hello World'])]);
-        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'hello-world'])]);
-        $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.label' => 'hello world'])]);
+        $this->assertMenuEquals(['hello-world'], [new MarkdownPage('foo', ['navigation.label' => 'hello-world'])]);
+        $this->assertMenuEquals(['hello world'], [new MarkdownPage('foo', ['navigation.label' => 'hello world'])]);
     }
 
     public function testMainMenuNavigationGroupCasing()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
+        // When using subdirectory groupings, we try to format them the same way as the page titles
+
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('Hello World/foo')]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello-world/foo')]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('hello world/foo')]);
@@ -1067,6 +1077,8 @@ public function testMainMenuNavigationGroupCasingUsingFrontMatter()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
 
+        // If the user explicitly sets the group, we should respect that and assume it's already formatted correctly
+
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'Hello World'])]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'hello-world'])]);
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'hello world'])]);
@@ -1074,6 +1086,8 @@ public function testMainMenuNavigationGroupCasingUsingFrontMatter()
 
     public function testSidebarItemCasing()
     {
+        // These labels are based on the page titles, which are made from the file names, so we try to format them
+
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('Hello World')]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello-world')]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello world')]);
@@ -1081,13 +1095,21 @@ public function testSidebarItemCasing()
 
     public function testSidebarItemCasingUsingFrontMatter()
     {
+        // If the user explicitly sets the label, we should respect that and assume it's already formatted correctly
+
+        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['title' => 'Hello World'])]);
+        $this->assertSidebarEquals(['hello-world'], [new DocumentationPage('foo', ['title' => 'hello-world'])]);
+        $this->assertSidebarEquals(['hello world'], [new DocumentationPage('foo', ['title' => 'hello world'])]);
+
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'Hello World'])]);
-        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'hello-world'])]);
-        $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.label' => 'hello world'])]);
+        $this->assertSidebarEquals(['hello-world'], [new DocumentationPage('foo', ['navigation.label' => 'hello-world'])]);
+        $this->assertSidebarEquals(['hello world'], [new DocumentationPage('foo', ['navigation.label' => 'hello world'])]);
     }
 
     public function testSidebarGroupCasing()
     {
+        // When using subdirectory groupings, we try to format them the same way as the page titles
+
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('Hello World/foo')]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello-world/foo')]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('hello world/foo')]);
@@ -1095,6 +1117,8 @@ public function testSidebarGroupCasing()
 
     public function testSidebarGroupCasingUsingFrontMatter()
     {
+        // If the user explicitly sets the group, we should respect that and assume it's already formatted correctly
+
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'Hello World'])]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello-world'])]);
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello world'])]);

From fceca310591d6543e16e98065d962d0f6f0cfe24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:18:19 +0100
Subject: [PATCH 0520/4023] Expect dropdown label to be formatted

---
 packages/framework/tests/Unit/NavItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index ebcd7e675dd..9dab7732acb 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -265,7 +265,7 @@ public function testDropdownFacade()
     {
         $item = NavItem::dropdown('foo', []);
 
-        $this->assertSame('foo', $item->getLabel());
+        $this->assertSame('Foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
         $this->assertSame(999, $item->getPriority());
     }

From 2296d30734dd79793d2e563263a69b028bbf9aba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:26:30 +0100
Subject: [PATCH 0521/4023] Rename back helper method name

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index abadee85f53..9ca73f04645 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
         // TODO resolve label from config here instead of view
-        return new static('', static::normalizeLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -234,10 +234,10 @@ protected function makeGroupLabel(): string
         }
 
         // If there is no label, and the group is a slug, we can make a title from it
-        return $this->normalizeLabel($this->group ?? $this->label);
+        return $this->normalizeGroupLabel($this->group ?? $this->label);
     }
 
-    protected static function normalizeLabel(?string $label): ?string
+    protected static function normalizeGroupLabel(?string $label): ?string
     {
         if ($label && ($label === strtolower($label))) {
             return Hyde::makeTitle($label);

From be556710bd289c38cfd5fb10acafa96de50e01fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:26:59 +0100
Subject: [PATCH 0522/4023] Switch order of helpers to group static methods

---
 .../Framework/Features/Navigation/NavItem.php  | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 9ca73f04645..08b50714aee 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -224,6 +224,15 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
         return $config[$groupKey] ?? null;
     }
 
+    protected static function normalizeGroupLabel(?string $label): ?string
+    {
+        if ($label && ($label === strtolower($label))) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
+
     /** Find the best label for the group. */
     protected function makeGroupLabel(): string
     {
@@ -236,13 +245,4 @@ protected function makeGroupLabel(): string
         // If there is no label, and the group is a slug, we can make a title from it
         return $this->normalizeGroupLabel($this->group ?? $this->label);
     }
-
-    protected static function normalizeGroupLabel(?string $label): ?string
-    {
-        if ($label && ($label === strtolower($label))) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
 }

From ed383406f91dc3426887622f2cb48214490444cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:27:37 +0100
Subject: [PATCH 0523/4023] Call static method statically

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 08b50714aee..93ea71bf326 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -243,6 +243,6 @@ protected function makeGroupLabel(): string
         }
 
         // If there is no label, and the group is a slug, we can make a title from it
-        return $this->normalizeGroupLabel($this->group ?? $this->label);
+        return static::normalizeGroupLabel($this->group ?? $this->label);
     }
 }

From a297250eec5699adfa6bb65a2083fc24f687b34c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:27:54 +0100
Subject: [PATCH 0524/4023] Move comment to more relevant location

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 93ea71bf326..924270c8847 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -226,6 +226,7 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
 
     protected static function normalizeGroupLabel(?string $label): ?string
     {
+        // If there is no label, and the group is a slug, we can make a title from it
         if ($label && ($label === strtolower($label))) {
             return Hyde::makeTitle($label);
         }
@@ -242,7 +243,6 @@ protected function makeGroupLabel(): string
             return $configLabel;
         }
 
-        // If there is no label, and the group is a slug, we can make a title from it
         return static::normalizeGroupLabel($this->group ?? $this->label);
     }
 }

From c6324bce2d2b74b32d58eb4dad4e2e9450f3517f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:28:10 +0100
Subject: [PATCH 0525/4023] Import used functions

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 924270c8847..0fdad4e0e32 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -12,6 +12,9 @@
 use Stringable;
 use Hyde\Support\Models\ExternalRoute;
 
+use function is_string;
+use function strtolower;
+
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *

From 36177faaf02a696e51b686559463550e2afe03b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:29:10 +0100
Subject: [PATCH 0526/4023] Simplify method return

---
 .../src/Framework/Features/Navigation/NavItem.php        | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0fdad4e0e32..ef9665fbafe 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -240,12 +240,7 @@ protected static function normalizeGroupLabel(?string $label): ?string
     /** Find the best label for the group. */
     protected function makeGroupLabel(): string
     {
-        $configLabel = Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($this->identifier));
-
-        if ($configLabel) {
-            return $configLabel;
-        }
-
-        return static::normalizeGroupLabel($this->group ?? $this->label);
+        return Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($this->identifier))
+            ?? static::normalizeGroupLabel($this->group ?? $this->label);
     }
 }

From 303562067d1d91b8dfc5eda0d80215d4cef694a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:30:55 +0100
Subject: [PATCH 0527/4023] Remove unnecessary method call for already executed
 operation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ef9665fbafe..bad6e1af237 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -241,6 +241,6 @@ protected static function normalizeGroupLabel(?string $label): ?string
     protected function makeGroupLabel(): string
     {
         return Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($this->identifier))
-            ?? static::normalizeGroupLabel($this->group ?? $this->label);
+            ?? $this->label;
     }
 }

From 913e8b9c7a36cb522350a79360d9e96cb747046c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:32:35 +0100
Subject: [PATCH 0528/4023] Revert "Handle null case as property can be
 explicitly set to null"

This reverts commit b7e858825e553a26f0568a167a74ab7ef731b6cf as a group without a title indicates an issue that should be thrown.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index bad6e1af237..c69719b5dce 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -227,10 +227,10 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
         return $config[$groupKey] ?? null;
     }
 
-    protected static function normalizeGroupLabel(?string $label): ?string
+    protected static function normalizeGroupLabel(string $label): string
     {
         // If there is no label, and the group is a slug, we can make a title from it
-        if ($label && ($label === strtolower($label))) {
+        if ($label === strtolower($label)) {
             return Hyde::makeTitle($label);
         }
 

From 0e55c2b55134e4ff9d543c3421a06d5b60a8f761 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:34:50 +0100
Subject: [PATCH 0529/4023] Remove unnecessary default values from config call

There is no reason to expect things like "index" to be a dropdown group. Posts maybe, if for some reason a user wants to list all posts in a dropdown but at that point they need to make other changes so I see no reason to have an extra line for something so uncommon.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c69719b5dce..6d9d80970f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -218,11 +218,7 @@ protected static function makeIdentifier(string $label): string
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
         /** @var array<string, int> $config */
-        $config = Config::getArray('hyde.navigation.order', [
-            'index' => 0,
-            'posts' => 10,
-            'docs/index' => 100,
-        ]);
+        $config = Config::getArray('hyde.navigation.order', []);
 
         return $config[$groupKey] ?? null;
     }

From 8e1ab831b4c162925138492d750d78033f77f322 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:43:39 +0100
Subject: [PATCH 0530/4023] Simplify config return

---
 .../framework/src/Framework/Features/Navigation/NavItem.php  | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6d9d80970f3..020f7883101 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -217,10 +217,7 @@ protected static function makeIdentifier(string $label): string
     // TODO: Consider moving all of these to a dropdown factory
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
-        /** @var array<string, int> $config */
-        $config = Config::getArray('hyde.navigation.order', []);
-
-        return $config[$groupKey] ?? null;
+        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }
 
     protected static function normalizeGroupLabel(string $label): string

From 8398351eeecc3a92ef96cd85103038f959d46faf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:44:56 +0100
Subject: [PATCH 0531/4023] Normalize config access

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 020f7883101..a4df1fe75c8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -233,7 +233,7 @@ protected static function normalizeGroupLabel(string $label): string
     /** Find the best label for the group. */
     protected function makeGroupLabel(): string
     {
-        return Config::getNullableString('docs.sidebar_group_labels.'.Str::slug($this->identifier))
+        return Config::getArray('docs.sidebar_group_labels', [])[Str::slug($this->identifier)]
             ?? $this->label;
     }
 }

From 8cc5bd6eb29bdebab698cc5e7b7a4e3510ebc687 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 16:45:33 +0100
Subject: [PATCH 0532/4023] Format to single line

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a4df1fe75c8..e7c6cc10dbb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -233,7 +233,6 @@ protected static function normalizeGroupLabel(string $label): string
     /** Find the best label for the group. */
     protected function makeGroupLabel(): string
     {
-        return Config::getArray('docs.sidebar_group_labels', [])[Str::slug($this->identifier)]
-            ?? $this->label;
+        return Config::getArray('docs.sidebar_group_labels', [])[Str::slug($this->identifier)] ?? $this->label;
     }
 }

From 2c06b5241f132aef35d3b1a754c9afe5bfa12b2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:46:26 +0100
Subject: [PATCH 0533/4023] Remove resolved todo

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e7c6cc10dbb..e4275b37fbb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -100,7 +100,6 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        // TODO resolve label from config here instead of view
         return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 

From 17a992ace5043396ed228a8e0196b557547c42a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:49:39 +0100
Subject: [PATCH 0534/4023] Remove complex logic from roadmap

This is not worth it as it adds a lot of complexity. For these cases, the user will have to add a custom label.
---
 .../AutomaticNavigationConfigurationsTest.php     | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index eaba945cf0c..51f873fbe18 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -975,21 +975,6 @@ public function testSidebarItemGroupingIsNormalized()
         ]);
     }
 
-    public function testSidebarLabelsRetainBestFormatting()
-    {
-        $this->markTestSkipped('Not yet implemented');
-
-        $this->assertSidebarEquals(['GitHub'], [
-            new DocumentationPage('foo', ['navigation.group' => 'GitHub']),
-            new DocumentationPage('bar', ['navigation.group' => 'github']),
-        ]);
-
-        $this->assertSidebarEquals(['GitHub'], [
-            new DocumentationPage('foo', ['navigation.group' => 'github']),
-            new DocumentationPage('bar', ['navigation.group' => 'GitHub']),
-        ]);
-    }
-
     public function testSidebarLabelsCanBeSetInConfig()
     {
         config(['docs.sidebar_group_labels' => ['foo' => 'Hello world!']]);

From e2b04d4f1269936c1d69d7e27d6c823273ee264e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:51:31 +0100
Subject: [PATCH 0535/4023] Move back group label logic to generator

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   |  3 ++-
 .../src/Framework/Features/Navigation/NavItem.php      | 10 ----------
 2 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a82d86721ba..eeaa0e11ee3 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
@@ -61,7 +62,7 @@ protected function generate(): void
                     $groupItem = $this->items->get(Str::slug($group));
 
                     if ($groupItem === null) {
-                        $groupItem = NavItem::dropdown($group, []);
+                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[Str::slug($group)] ?? $group, []);
                     }
 
                     $groupItem->addChild($item);
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e4275b37fbb..8096142db28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -132,10 +132,6 @@ public function getLink(): string
      */
     public function getLabel(): string
     {
-        if ($this->hasChildren()) {
-            return $this->makeGroupLabel();
-        }
-
         return $this->label;
     }
 
@@ -228,10 +224,4 @@ protected static function normalizeGroupLabel(string $label): string
 
         return $label;
     }
-
-    /** Find the best label for the group. */
-    protected function makeGroupLabel(): string
-    {
-        return Config::getArray('docs.sidebar_group_labels', [])[Str::slug($this->identifier)] ?? $this->label;
-    }
 }

From cde50ca0205117c910c845f44b73cd7d47c1808b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:52:47 +0100
Subject: [PATCH 0536/4023] Introduce local variable

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index eeaa0e11ee3..32045ace739 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -59,10 +59,11 @@ protected function generate(): void
                         $group = 'Other';
                     }
 
-                    $groupItem = $this->items->get(Str::slug($group));
+                    $groupIdentifier = Str::slug($group);
+                    $groupItem = $this->items->get($groupIdentifier);
 
                     if ($groupItem === null) {
-                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[Str::slug($group)] ?? $group, []);
+                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $group, []);
                     }
 
                     $groupItem->addChild($item);

From 4e1521f96c15e3e4ef32ec90acc47c5ec47abd7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:53:04 +0100
Subject: [PATCH 0537/4023] Rename local variable to be clearer

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 32045ace739..56598f838ea 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -52,18 +52,18 @@ protected function generate(): void
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
-                $group = $item->getGroup();
+                $groupName = $item->getGroup();
 
                 if ($useGroups) {
-                    if (! $group) {
-                        $group = 'Other';
+                    if (! $groupName) {
+                        $groupName = 'Other';
                     }
 
-                    $groupIdentifier = Str::slug($group);
+                    $groupIdentifier = Str::slug($groupName);
                     $groupItem = $this->items->get($groupIdentifier);
 
                     if ($groupItem === null) {
-                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $group, []);
+                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $groupName, []);
                     }
 
                     $groupItem->addChild($item);

From 08d7783db5878d7a38614232db05306bd331a956 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:54:50 +0100
Subject: [PATCH 0538/4023] Extract helper method

---
 .../GeneratesDocumentationSidebarMenu.php     | 27 ++++++++++++-------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 56598f838ea..fdedaf41e6d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -55,16 +55,7 @@ protected function generate(): void
                 $groupName = $item->getGroup();
 
                 if ($useGroups) {
-                    if (! $groupName) {
-                        $groupName = 'Other';
-                    }
-
-                    $groupIdentifier = Str::slug($groupName);
-                    $groupItem = $this->items->get($groupIdentifier);
-
-                    if ($groupItem === null) {
-                        $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $groupName, []);
-                    }
+                    $groupItem = $this->createGroupItem($groupName);
 
                     $groupItem->addChild($item);
 
@@ -116,4 +107,20 @@ protected function getLowestPriorityInGroup(NavItem $item): int
     {
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
+
+    protected function createGroupItem(?string $groupName): NavItem
+    {
+        if (! $groupName) {
+            $groupName = 'Other';
+        }
+
+        $groupIdentifier = Str::slug($groupName);
+        $groupItem = $this->items->get($groupIdentifier);
+
+        if ($groupItem === null) {
+            $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $groupName, []);
+        }
+
+        return $groupItem;
+    }
 }

From 78039310c608708bad70884c0c836924f9b9e66e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:56:50 +0100
Subject: [PATCH 0539/4023] Inline local variable

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index fdedaf41e6d..5049dad7808 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -52,10 +52,8 @@ protected function generate(): void
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
-                $groupName = $item->getGroup();
-
                 if ($useGroups) {
-                    $groupItem = $this->createGroupItem($groupName);
+                    $groupItem = $this->createGroupItem($item->getGroup());
 
                     $groupItem->addChild($item);
 

From 21076ecb8685a9d271e2fbb27e1fa2c84daf4e25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:57:24 +0100
Subject: [PATCH 0540/4023] Shift fallback to parameter coalesce

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 5049dad7808..7fcab729355 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -53,7 +53,7 @@ protected function generate(): void
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
                 if ($useGroups) {
-                    $groupItem = $this->createGroupItem($item->getGroup());
+                    $groupItem = $this->createGroupItem($item->getGroup() ?? 'Other');
 
                     $groupItem->addChild($item);
 
@@ -106,12 +106,8 @@ protected function getLowestPriorityInGroup(NavItem $item): int
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
 
-    protected function createGroupItem(?string $groupName): NavItem
+    protected function createGroupItem(string $groupName): NavItem
     {
-        if (! $groupName) {
-            $groupName = 'Other';
-        }
-
         $groupIdentifier = Str::slug($groupName);
         $groupItem = $this->items->get($groupIdentifier);
 

From f98333f552df932a1b66fd8a22d43f6fad9f757b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:57:59 +0100
Subject: [PATCH 0541/4023] Rename helper method to be clearer and more correct

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7fcab729355..cde08b69220 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -53,7 +53,7 @@ protected function generate(): void
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
                 if ($useGroups) {
-                    $groupItem = $this->createGroupItem($item->getGroup() ?? 'Other');
+                    $groupItem = $this->getOrCreateGroupItem($item->getGroup() ?? 'Other');
 
                     $groupItem->addChild($item);
 
@@ -106,7 +106,7 @@ protected function getLowestPriorityInGroup(NavItem $item): int
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
 
-    protected function createGroupItem(string $groupName): NavItem
+    protected function getOrCreateGroupItem(string $groupName): NavItem
     {
         $groupIdentifier = Str::slug($groupName);
         $groupItem = $this->items->get($groupIdentifier);

From 3e827976685eff77f592ce3486124dcfff9dd98a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 17:59:03 +0100
Subject: [PATCH 0542/4023] Remove unnecessary qualifiers from narrowed scope

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index cde08b69220..6cb507713fe 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -108,13 +108,13 @@ protected function getLowestPriorityInGroup(NavItem $item): int
 
     protected function getOrCreateGroupItem(string $groupName): NavItem
     {
-        $groupIdentifier = Str::slug($groupName);
-        $groupItem = $this->items->get($groupIdentifier);
+        $identifier = Str::slug($groupName);
+        $group = $this->items->get($identifier);
 
-        if ($groupItem === null) {
-            $groupItem = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$groupIdentifier] ?? $groupName, []);
+        if ($group === null) {
+            $group = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
         }
 
-        return $groupItem;
+        return $group;
     }
 }

From cb4cf0d28d63f79fffd31aec50e0e0d415c896d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:00:09 +0100
Subject: [PATCH 0543/4023] Simplify conditional return with coalescing return
 expression

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 6cb507713fe..493d7e520d4 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -111,10 +111,6 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
         $identifier = Str::slug($groupName);
         $group = $this->items->get($identifier);
 
-        if ($group === null) {
-            $group = NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
-        }
-
-        return $group;
+        return $group ?? NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
     }
 }

From 8365d594b0b22d44672848e37260ee20bfeb5b76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:01:20 +0100
Subject: [PATCH 0544/4023] Extract helper

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php       | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 493d7e520d4..a4c9b74031e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -111,6 +111,11 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
         $identifier = Str::slug($groupName);
         $group = $this->items->get($identifier);
 
-        return $group ?? NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
+        return $group ?? $this->createGroupItem($identifier, $groupName);
+    }
+
+    protected function createGroupItem(string $identifier, string $groupName): NavItem
+    {
+        return NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
     }
 }

From 17f4a265af2cf001bf418e2ecec83e0c1b2ec3e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:02:52 +0100
Subject: [PATCH 0545/4023] Extract helper

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php       | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a4c9b74031e..f5a23cc7bc0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -116,6 +116,11 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
-        return NavItem::dropdown(Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? $groupName, []);
+        return NavItem::dropdown($this->searchForGroupLabelInConfig($identifier) ?? $groupName, []);
+    }
+
+    protected function searchForGroupLabelInConfig(string $identifier): ?string
+    {
+        return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
 }

From 4ab40d50af5b1cc462d6dcd672d328e128872e6a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:04:24 +0100
Subject: [PATCH 0546/4023] Introduce local variable

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index f5a23cc7bc0..f339458686b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -116,7 +116,9 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
-        return NavItem::dropdown($this->searchForGroupLabelInConfig($identifier) ?? $groupName, []);
+        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+
+        return NavItem::dropdown($label, []);
     }
 
     protected function searchForGroupLabelInConfig(string $identifier): ?string

From c1fdebb3ff006330b1df9cd4117daafa52e74f55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:07:36 +0100
Subject: [PATCH 0547/4023] Move normalization logic to action

This is specific to the sidebar, so we don't need to pollute the global model with it
---
 .../GeneratesDocumentationSidebarMenu.php          | 14 +++++++++++++-
 .../src/Framework/Features/Navigation/NavItem.php  | 13 +------------
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index f339458686b..c0524e331e0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
@@ -13,6 +14,7 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function collect;
+use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -116,7 +118,7 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
-        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+        $label = $this->normalizeGroupLabel($this->searchForGroupLabelInConfig($identifier) ?? $groupName);
 
         return NavItem::dropdown($label, []);
     }
@@ -125,4 +127,14 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
+
+    protected function normalizeGroupLabel(string $label): string
+    {
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8096142db28..0d81cfb85b4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -13,7 +13,6 @@
 use Hyde\Support\Models\ExternalRoute;
 
 use function is_string;
-use function strtolower;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
@@ -100,7 +99,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -214,14 +213,4 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
     {
         return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }
-
-    protected static function normalizeGroupLabel(string $label): string
-    {
-        // If there is no label, and the group is a slug, we can make a title from it
-        if ($label === strtolower($label)) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
 }

From 3d831c0d34dd6d8d2e2c40a8bd8e6b45592685d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:10:45 +0100
Subject: [PATCH 0548/4023] Revert "Move normalization logic to action"

This reverts commit c1fdebb3ff006330b1df9cd4117daafa52e74f55.
---
 .../GeneratesDocumentationSidebarMenu.php          | 14 +-------------
 .../src/Framework/Features/Navigation/NavItem.php  | 13 ++++++++++++-
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c0524e331e0..f339458686b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
@@ -14,7 +13,6 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function collect;
-use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -118,7 +116,7 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
-        $label = $this->normalizeGroupLabel($this->searchForGroupLabelInConfig($identifier) ?? $groupName);
+        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
 
         return NavItem::dropdown($label, []);
     }
@@ -127,14 +125,4 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
-
-    protected function normalizeGroupLabel(string $label): string
-    {
-        // If there is no label, and the group is a slug, we can make a title from it
-        if ($label === strtolower($label)) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0d81cfb85b4..8096142db28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -13,6 +13,7 @@
 use Hyde\Support\Models\ExternalRoute;
 
 use function is_string;
+use function strtolower;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
@@ -99,7 +100,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -213,4 +214,14 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
     {
         return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }
+
+    protected static function normalizeGroupLabel(string $label): string
+    {
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
 }

From f0fb28637703d52bc9af5bbe9e03c10af6f064ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:30:23 +0100
Subject: [PATCH 0549/4023] Add test for conflicting configuration states

---
 .../AutomaticNavigationConfigurationsTest.php     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 51f873fbe18..0ecc49a463d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -516,6 +516,21 @@ public function testMainNavigationMenuAutomaticDropdownItemsWithSameLabelButDiff
         ]);
     }
 
+    public function testConflictingSubdirectoryAndFrontMatterDropdownConfigurationGivesPrecedenceToSubdirectory()
+    {
+        // In case subdirectories are set to be used as dropdowns, but a page has a group set in its front matter,
+        // we run into a conflicting state where we don't know what the user intended. We solve this by giving
+        // precedence to the subdirectory configuration. This is opinionated, but allows for good grouping.
+
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'children' => ['Child']],
+        ], [
+            new MarkdownPage('foo/child', ['navigation.group' => 'bar']),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()

From 194b9b849495b9fd17c2e9896a3f5f41e72ac624 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:33:35 +0100
Subject: [PATCH 0550/4023] Remove unnecessary data from test

---
 .../AutomaticNavigationConfigurationsTest.php | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0ecc49a463d..afa4b3fdc0f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -495,11 +495,11 @@ public function testMainNavigationMenuDropdownItemsWithSameLabelButDifferentGrou
         config(['hyde.navigation.subdirectories' => 'dropdown']);
 
         $this->assertMenuEquals([
-            ['label' => 'Group 1', 'children' => ['Foo']],
-            ['label' => 'Group 2', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
-            new MarkdownPage('one/foo', ['navigation.group' => 'Group 1']),
-            new MarkdownPage('two/foo', ['navigation.group' => 'Group 2']),
+            new MarkdownPage('one/foo'),
+            new MarkdownPage('two/foo'),
         ]);
     }
 
@@ -926,11 +926,11 @@ public function testSidebarItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreFiltered()
     {
         $this->assertSidebarEquals([
-            ['label' => 'Group 1', 'children' => ['Foo']],
-            ['label' => 'Group 2', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
-            new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
-            new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
+            new DocumentationPage('one/foo'),
+            new DocumentationPage('two/foo'),
         ]);
     }
 
@@ -950,11 +950,11 @@ public function testSidebarDropdownItemsWithSameLabelButDifferentGroupsAreNotFil
         config(['docs.flattened_output_paths' => false]);
 
         $this->assertSidebarEquals([
-            ['label' => 'Group 1', 'children' => ['Foo']],
-            ['label' => 'Group 2', 'children' => ['Foo']],
+            ['label' => 'One', 'children' => ['Foo']],
+            ['label' => 'Two', 'children' => ['Foo']],
         ], [
-            new DocumentationPage('one/foo', ['navigation.group' => 'Group 1']),
-            new DocumentationPage('two/foo', ['navigation.group' => 'Group 2']),
+            new DocumentationPage('one/foo'),
+            new DocumentationPage('two/foo'),
         ]);
     }
 

From bdcc4b5cdc1a4374b3ab16863ab254e8bb874a0c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:32:14 +0100
Subject: [PATCH 0551/4023] Use accessor to use fully processed data

Has slightly differing semantics, but ones that we probably want
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8096142db28..4b792447f14 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -64,7 +64,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
             $route,
             $label ?? $route->getPage()->navigationMenuLabel(),
             $priority ?? $route->getPage()->navigationMenuPriority(),
-            $group ?? $route->getPage()->data('navigation.group'),
+            $group ?? $route->getPage()->navigationMenuGroup(),
         );
     }
 

From 1eabf7e463ea9c108e2ebcb24f40fe36dc4d9d4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 18:46:26 +0100
Subject: [PATCH 0552/4023] Experiment with using factory to create sidebar
 data

See https://github.com/hydephp/develop/pull/1568#issuecomment-1954674961
---
 .../Framework/Features/Navigation/NavItem.php | 30 ++++++++++++++-----
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4b792447f14..b8643c128f4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,13 +4,15 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
+use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Support\Models\ExternalRoute;
+use Hyde\Framework\Factories\NavigationDataFactory;
+use Hyde\Framework\Factories\Concerns\CoreDataObject;
 
 use function is_string;
 use function strtolower;
@@ -100,7 +102,25 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        $data = (new NavigationDataFactory(new CoreDataObject(
+            new FrontMatter([
+                'navigation' => [
+                    'label' => static::normalizeGroupLabel($label),
+                    'priority' => $priority,
+                    'hidden' => false,
+                    'group' => static::normalizeGroupKey($label),
+                ]
+            ]),
+            false, '', '', '', '', Str::slug($label),
+        ), $label))->toArray();
+
+        return new static(
+            '',
+            $data['label'],
+            $data['priority'],
+            $data['group'],
+            $items
+        );
     }
 
     /**
@@ -209,12 +229,6 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
-    // TODO: Consider moving all of these to a dropdown factory
-    protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
-    {
-        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
-    }
-
     protected static function normalizeGroupLabel(string $label): string
     {
         // If there is no label, and the group is a slug, we can make a title from it

From 8ae48761639e9a9f626be6d7d086a4add8256fe1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 19:07:28 +0100
Subject: [PATCH 0553/4023] Revert "Experiment with using factory to create
 sidebar data"

This reverts commit 1eabf7e463ea9c108e2ebcb24f40fe36dc4d9d4a.
---
 .../Framework/Features/Navigation/NavItem.php | 30 +++++--------------
 1 file changed, 8 insertions(+), 22 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b8643c128f4..4b792447f14 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,15 +4,13 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
-use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Support\Models\ExternalRoute;
-use Hyde\Framework\Factories\NavigationDataFactory;
-use Hyde\Framework\Factories\Concerns\CoreDataObject;
 
 use function is_string;
 use function strtolower;
@@ -102,25 +100,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        $data = (new NavigationDataFactory(new CoreDataObject(
-            new FrontMatter([
-                'navigation' => [
-                    'label' => static::normalizeGroupLabel($label),
-                    'priority' => $priority,
-                    'hidden' => false,
-                    'group' => static::normalizeGroupKey($label),
-                ]
-            ]),
-            false, '', '', '', '', Str::slug($label),
-        ), $label))->toArray();
-
-        return new static(
-            '',
-            $data['label'],
-            $data['priority'],
-            $data['group'],
-            $items
-        );
+        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -229,6 +209,12 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
+    // TODO: Consider moving all of these to a dropdown factory
+    protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
+    {
+        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
+    }
+
     protected static function normalizeGroupLabel(string $label): string
     {
         // If there is no label, and the group is a slug, we can make a title from it

From 4bcfbeb4c91fd2df4c83f27c637c0935d8c6e1e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 19:11:51 +0100
Subject: [PATCH 0554/4023] Extract helper method

---
 .../GeneratesDocumentationSidebarMenu.php     | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index f339458686b..545355ad96d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -52,19 +52,12 @@ protected function generate(): void
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 $item = NavItem::fromRoute($route);
-                if ($useGroups) {
-                    $groupItem = $this->getOrCreateGroupItem($item->getGroup() ?? 'Other');
-
-                    $groupItem->addChild($item);
-
-                    if (! $this->items->has($groupItem->getIdentifier())) {
-                        $this->items->put($groupItem->getIdentifier(), $groupItem);
-                    }
 
-                    return;
+                if ($useGroups) {
+                    $this->addItemToGroup($item);
+                } else {
+                    $this->items->put($route->getRouteKey(), $item);
                 }
-
-                $this->items->put($route->getRouteKey(), $item);
             }
         });
 
@@ -101,6 +94,17 @@ protected function sortByPriority(): void
         })->values();
     }
 
+    protected function addItemToGroup(NavItem $item): void
+    {
+        $groupItem = $this->getOrCreateGroupItem($item->getGroup() ?? 'Other');
+
+        $groupItem->addChild($item);
+
+        if (! $this->items->has($groupItem->getIdentifier())) {
+            $this->items->put($groupItem->getIdentifier(), $groupItem);
+        }
+    }
+
     protected function getLowestPriorityInGroup(NavItem $item): int
     {
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());

From 942ebb765c1efab9856c403404a7a573bd79c97d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 19:15:05 +0100
Subject: [PATCH 0555/4023] Deprecate out of scope helpers

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4b792447f14..43314b92ccd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -209,12 +209,13 @@ protected static function makeIdentifier(string $label): string
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
 
-    // TODO: Consider moving all of these to a dropdown factory
+    /** @deprecated This responsibility does not belong here. This should happen before the NavItem is created. */
     protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
     {
         return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }
 
+    /** @deprecated This responsibility does not belong here. This should happen before the NavItem is created. */
     protected static function normalizeGroupLabel(string $label): string
     {
         // If there is no label, and the group is a slug, we can make a title from it

From 2c389e4b4aea7b4bd3a243dd92479fe3c6086816 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 19:21:03 +0100
Subject: [PATCH 0556/4023] Move label normalization to generators

This means that when creating navigation dropdown items directly, you no longer get the normalization
---
 .../GeneratesDocumentationSidebarMenu.php         | 15 ++++++++++++++-
 .../Navigation/GeneratesMainNavigationMenu.php    | 15 ++++++++++++++-
 .../src/Framework/Features/Navigation/NavItem.php | 14 +-------------
 .../tests/Feature/NavigationMenuTest.php          |  4 ++--
 packages/framework/tests/Unit/NavItemTest.php     |  2 +-
 5 files changed, 32 insertions(+), 18 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 545355ad96d..5105b3b12f0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
@@ -13,6 +14,7 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function collect;
+use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -122,11 +124,22 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
 
-        return NavItem::dropdown($label, []);
+        return NavItem::dropdown(static::normalizeGroupLabel($label), []);
     }
 
     protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
+
+    /** Todo: Move into shared class */
+    protected static function normalizeGroupLabel(string $label): string
+    {
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 9ed815aa01d..9b3adb0be56 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
@@ -11,6 +12,7 @@
 use Hyde\Foundation\Facades\Routes;
 
 use function collect;
+use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -72,7 +74,7 @@ protected function moveGroupedItemsIntoDropdowns(): void
 
         foreach ($dropdowns as $group => $items) {
             // Create a new dropdown item containing the buffered items
-            $this->items->add(NavItem::dropdown($group, $items));
+            $this->items->add(NavItem::dropdown(static::normalizeGroupLabel($group), $items));
         }
     }
 
@@ -90,4 +92,15 @@ protected function useSubdirectoriesAsDropdowns(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }
+
+    /** Todo: Move into shared class */
+    protected static function normalizeGroupLabel(string $label): string
+    {
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 43314b92ccd..6cfd3cae668 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -13,7 +13,6 @@
 use Hyde\Support\Models\ExternalRoute;
 
 use function is_string;
-use function strtolower;
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
@@ -100,7 +99,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', static::normalizeGroupLabel($label), $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
     }
 
     /**
@@ -214,15 +213,4 @@ protected static function searchForDropdownPriorityInNavigationConfig(string $gr
     {
         return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }
-
-    /** @deprecated This responsibility does not belong here. This should happen before the NavItem is created. */
-    protected static function normalizeGroupLabel(string $label): string
-    {
-        // If there is no label, and the group is a slug, we can make a title from it
-        if ($label === strtolower($label)) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 31bb0ad3f19..15c00178129 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -228,7 +228,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
-            NavItem::dropdown('foo', [
+            NavItem::dropdown('Foo', [
                 NavItem::fromRoute(Routes::get('foo/bar')),
             ]),
         ]);
@@ -249,7 +249,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         $this->assertEquals([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            NavItem::dropdown('bar', [
+            NavItem::dropdown('Bar', [
                 NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 9dab7732acb..ebcd7e675dd 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -265,7 +265,7 @@ public function testDropdownFacade()
     {
         $item = NavItem::dropdown('foo', []);
 
-        $this->assertSame('Foo', $item->getLabel());
+        $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
         $this->assertSame(999, $item->getPriority());
     }

From 514facdeca53f2c39eefbc930764fc03c4fb8b58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 21:05:32 +0100
Subject: [PATCH 0557/4023] Fix method should convert label to identifier for
 comparison

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6cfd3cae668..764d491d72e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -99,7 +99,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig($label) ?? 999, $label, $items);
+        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig(Str::slug($label)) ?? 999, $label, $items);
     }
 
     /**

From ffa86ffb6568894659e0f390079e76a15309c976 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 21:25:40 +0100
Subject: [PATCH 0558/4023] Add priority tests

---
 .../AutomaticNavigationConfigurationsTest.php | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index afa4b3fdc0f..7297b6da681 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1038,6 +1038,54 @@ public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped(
         ]);
     }
 
+    // Priority tests
+
+    public function testMainNavigationDropdownPriorityCanBeSetInConfig()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.order' => ['foo' => 500]]);
+
+        $this->assertMenuEquals(
+            [['label' => 'Foo', 'priority' => 500]],
+            [new MarkdownPage('foo/bar')]
+        );
+    }
+
+    public function testMainNavigationDropdownPriorityCanBeSetInConfigUsingDifferingCases()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.order' => ['hello-world' => 500]]);
+
+        $expected = [['label' => 'Hello World', 'priority' => 500]];
+        $this->assertMenuEquals($expected, [new MarkdownPage('Hello World/bar')]);
+        $this->assertMenuEquals($expected, [new MarkdownPage('hello-world/bar')]);
+        $this->assertMenuEquals($expected, [new MarkdownPage('hello world/bar')]);
+    }
+
+    public function testSidebarGroupPriorityCanBeSetInConfig()
+    {
+        $this->markTestSkipped('TODO');
+
+        config(['docs.sidebar_order' => ['foo' => 500]]);
+
+        $this->assertSidebarEquals(
+            [['label' => 'Foo', 'priority' => 500]],
+            [new DocumentationPage('foo/bar')]
+        );
+    }
+
+    public function testSidebarGroupPriorityCanBeSetInConfigUsingDifferingCases()
+    {
+        $this->markTestSkipped('TODO');
+
+        config(['docs.sidebar_order' => ['hello-world' => 500]]);
+
+        $expected = [['label' => 'Hello World', 'priority' => 500]];
+        $this->assertSidebarEquals($expected, [new DocumentationPage('Hello World/bar')]);
+        $this->assertSidebarEquals($expected, [new DocumentationPage('hello-world/bar')]);
+        $this->assertSidebarEquals($expected, [new DocumentationPage('hello world/bar')]);
+    }
+
     // Label casing tests
 
     public function testMainMenuNavigationItemCasing()

From e2e0f2d65fac3e935edfb83bad8a787842ba3219 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Feb 2024 21:30:08 +0100
Subject: [PATCH 0559/4023] Refactor to handle priority search in generators

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php | 10 +++++++++-
 .../Navigation/GeneratesMainNavigationMenu.php       |  8 +++++++-
 .../src/Framework/Features/Navigation/NavItem.php    |  9 +--------
 .../AutomaticNavigationConfigurationsTest.php        |  4 ----
 packages/framework/tests/Unit/NavItemTest.php        | 12 ------------
 5 files changed, 17 insertions(+), 26 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 5105b3b12f0..22f9d0609fe 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -13,6 +13,7 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 
+use function filled;
 use function collect;
 use function strtolower;
 
@@ -123,8 +124,9 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+        $priority = $this->searchForGroupPriorityInConfig($identifier);
 
-        return NavItem::dropdown(static::normalizeGroupLabel($label), []);
+        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }
 
     protected function searchForGroupLabelInConfig(string $identifier): ?string
@@ -142,4 +144,10 @@ protected static function normalizeGroupLabel(string $label): string
 
         return $label;
     }
+
+    /** Todo: Move into shared class */
+    protected static function searchForGroupPriorityInConfig(string $groupKey): ?int
+    {
+        return Config::getArray('docs.sidebar_order', [])[$groupKey] ?? null;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 9b3adb0be56..9eaea26bde6 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -74,7 +74,7 @@ protected function moveGroupedItemsIntoDropdowns(): void
 
         foreach ($dropdowns as $group => $items) {
             // Create a new dropdown item containing the buffered items
-            $this->items->add(NavItem::dropdown(static::normalizeGroupLabel($group), $items));
+            $this->items->add(NavItem::dropdown(static::normalizeGroupLabel($group), $items, static::searchForDropdownPriorityInConfig($group)));
         }
     }
 
@@ -103,4 +103,10 @@ protected static function normalizeGroupLabel(string $label): string
 
         return $label;
     }
+
+    /** Todo: Move into shared class */
+    protected static function searchForDropdownPriorityInConfig(string $groupKey): ?int
+    {
+        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 764d491d72e..ffbb2ac6234 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -99,7 +98,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority ?? static::searchForDropdownPriorityInNavigationConfig(Str::slug($label)) ?? 999, $label, $items);
+        return new static('', $label, $priority ?? 999, $label, $items);
     }
 
     /**
@@ -207,10 +206,4 @@ protected static function makeIdentifier(string $label): string
     {
         return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
     }
-
-    /** @deprecated This responsibility does not belong here. This should happen before the NavItem is created. */
-    protected static function searchForDropdownPriorityInNavigationConfig(string $groupKey): ?int
-    {
-        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
-    }
 }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 7297b6da681..0fea5535c0a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1064,8 +1064,6 @@ public function testMainNavigationDropdownPriorityCanBeSetInConfigUsingDiffering
 
     public function testSidebarGroupPriorityCanBeSetInConfig()
     {
-        $this->markTestSkipped('TODO');
-
         config(['docs.sidebar_order' => ['foo' => 500]]);
 
         $this->assertSidebarEquals(
@@ -1076,8 +1074,6 @@ public function testSidebarGroupPriorityCanBeSetInConfig()
 
     public function testSidebarGroupPriorityCanBeSetInConfigUsingDifferingCases()
     {
-        $this->markTestSkipped('TODO');
-
         config(['docs.sidebar_order' => ['hello-world' => 500]]);
 
         $expected = [['label' => 'Hello World', 'priority' => 500]];
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index ebcd7e675dd..f2caf94538c 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -396,16 +396,4 @@ public function testCanAddItemToDropdown()
 
         $this->assertSame([$child], $parent->getChildren());
     }
-
-    public function testDefaultDropdownItemPriority()
-    {
-        $this->assertSame(999, NavItem::dropdown('foo', [])->getPriority());
-    }
-
-    public function testCanResolveDropdownItemPriorityFromConfig()
-    {
-        $this->mockConfig(['hyde.navigation.order' => ['foo' => 500]]);
-
-        $this->assertSame(500, NavItem::dropdown('foo', [])->getPriority());
-    }
 }

From 66da2e4acb9cf085407808f6b408f7bb84e3d1ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:15:34 +0100
Subject: [PATCH 0560/4023] Deprecate internal helper method

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 9eaea26bde6..777e0723cd3 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -58,6 +58,7 @@ protected function generate(): void
         }
     }
 
+    /** @deprecated */
     protected function moveGroupedItemsIntoDropdowns(): void
     {
         $dropdowns = [];

From 2695ad37ef5e2eb23146812ddd258317bea939fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:18:00 +0100
Subject: [PATCH 0561/4023] Add outer conditional

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php        | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 777e0723cd3..cfe063288eb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -44,6 +44,9 @@ protected function generate(): void
     {
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
+                if ($this->useSubdirectoriesAsDropdowns()) {
+                    //
+                }
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
             }
         });

From 657462f966aaf62a43827269587e2ea95bf87fd6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:20:15 +0100
Subject: [PATCH 0562/4023] Add todo

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index cfe063288eb..b9467178d87 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -44,6 +44,7 @@ protected function generate(): void
     {
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
+                // TODO This conditional might not be needed as it might be evaluated by the NavDaF
                 if ($this->useSubdirectoriesAsDropdowns()) {
                     //
                 }

From e864054044aa8ead26fbbff330352ef991a150f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:20:30 +0100
Subject: [PATCH 0563/4023] Add new helper

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index b9467178d87..f86ee67cbfc 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -93,6 +93,11 @@ protected function canAddItemToDropdown(NavItem $item): bool
         return $item->getGroup() !== null;
     }
 
+    protected function canAddRouteToDropdown(Route $route): bool
+    {
+        return $route->getPage()->navigationMenuGroup() !== null;
+    }
+
     protected function useSubdirectoriesAsDropdowns(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';

From b0f682fc192a16f30ecc5d680e3c9eab8667063b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:22:45 +0100
Subject: [PATCH 0564/4023] Add inner conditional

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index f86ee67cbfc..0f62130071d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -46,7 +46,9 @@ protected function generate(): void
             if ($this->canAddRoute($route)) {
                 // TODO This conditional might not be needed as it might be evaluated by the NavDaF
                 if ($this->useSubdirectoriesAsDropdowns()) {
-                    //
+                    if ($this->canAddRouteToDropdown($route)) {
+                        //
+                    }
                 }
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
             }

From e7a9f6fd7bdb7a591499e3112767c4692e1fe7de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:30:42 +0100
Subject: [PATCH 0565/4023] Begin porting deterministic generation logic

---
 .../GeneratesMainNavigationMenu.php           | 43 ++++++++++++++++---
 1 file changed, 38 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0f62130071d..dea95364e9b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -47,7 +48,9 @@ protected function generate(): void
                 // TODO This conditional might not be needed as it might be evaluated by the NavDaF
                 if ($this->useSubdirectoriesAsDropdowns()) {
                     if ($this->canAddRouteToDropdown($route)) {
-                        //
+                        $this->addRouteToGroup($route);
+
+                        return;
                     }
                 }
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
@@ -58,10 +61,6 @@ protected function generate(): void
             // Since these were added explicitly by the user, we can assume they should always be shown
             $this->items->push($item);
         });
-
-        if ($this->useSubdirectoriesAsDropdowns()) {
-            $this->moveGroupedItemsIntoDropdowns();
-        }
     }
 
     /** @deprecated */
@@ -100,11 +99,45 @@ protected function canAddRouteToDropdown(Route $route): bool
         return $route->getPage()->navigationMenuGroup() !== null;
     }
 
+    protected function addRouteToGroup(Route $route): void
+    {
+        $group = $route->getPage()->navigationMenuGroup();
+
+        $groupItem = $this->getOrCreateGroupItem($group);
+
+        $groupItem->addChild(NavItem::fromRoute($route));
+
+        if (! $this->items->has($groupItem->getIdentifier())) {
+            $this->items->put($groupItem->getIdentifier(), $groupItem);
+        }
+    }
+
+    protected function getOrCreateGroupItem(string $groupName): NavItem
+    {
+        $identifier = Str::slug($groupName);
+        $group = $this->items->get($identifier);
+
+        return $group ?? $this->createGroupItem($identifier, $groupName);
+    }
+
+    protected function createGroupItem(string $identifier, string $groupName): NavItem
+    {
+        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+        $priority = $this->searchForDropdownPriorityInConfig($identifier);
+
+        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
+    }
+
     protected function useSubdirectoriesAsDropdowns(): bool
     {
         return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
     }
 
+    protected function searchForGroupLabelInConfig(string $identifier): ?string
+    {
+        return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;
+    }
+
     /** Todo: Move into shared class */
     protected static function normalizeGroupLabel(string $label): string
     {

From f505764cb02aa00d3c89528cd222bff48a76e988 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 12:57:43 +0100
Subject: [PATCH 0566/4023] Remove now unused helpers

---
 .../GeneratesMainNavigationMenu.php           | 26 -------------------
 1 file changed, 26 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index dea95364e9b..5e719a5ba62 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -63,37 +63,11 @@ protected function generate(): void
         });
     }
 
-    /** @deprecated */
-    protected function moveGroupedItemsIntoDropdowns(): void
-    {
-        $dropdowns = [];
-
-        foreach ($this->items as $key => $item) {
-            if ($this->canAddItemToDropdown($item)) {
-                // Buffer the item in the dropdowns array
-                $dropdowns[$item->getGroup()][] = $item;
-
-                // Remove the item from the main items collection
-                $this->items->forget($key);
-            }
-        }
-
-        foreach ($dropdowns as $group => $items) {
-            // Create a new dropdown item containing the buffered items
-            $this->items->add(NavItem::dropdown(static::normalizeGroupLabel($group), $items, static::searchForDropdownPriorityInConfig($group)));
-        }
-    }
-
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
     }
 
-    protected function canAddItemToDropdown(NavItem $item): bool
-    {
-        return $item->getGroup() !== null;
-    }
-
     protected function canAddRouteToDropdown(Route $route): bool
     {
         return $route->getPage()->navigationMenuGroup() !== null;

From 68f0d95095190ed8aac47327fff1058275efc7e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:02:12 +0100
Subject: [PATCH 0567/4023] Revert "Add todo"

This reverts commit 657462f966aaf62a43827269587e2ea95bf87fd6.
---
 .../Features/Navigation/GeneratesMainNavigationMenu.php          | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 5e719a5ba62..8ff3a52ee0b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -45,7 +45,6 @@ protected function generate(): void
     {
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                // TODO This conditional might not be needed as it might be evaluated by the NavDaF
                 if ($this->useSubdirectoriesAsDropdowns()) {
                     if ($this->canAddRouteToDropdown($route)) {
                         $this->addRouteToGroup($route);

From 2171de13e7d7ed7289692eb10c090c82df4f01f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:03:05 +0100
Subject: [PATCH 0568/4023] Rename helpers to be more generic

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 8ff3a52ee0b..c8bd7b95224 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -46,7 +46,7 @@ protected function generate(): void
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
                 if ($this->useSubdirectoriesAsDropdowns()) {
-                    if ($this->canAddRouteToDropdown($route)) {
+                    if ($this->canAddRouteToGroup($route)) {
                         $this->addRouteToGroup($route);
 
                         return;
@@ -67,7 +67,7 @@ protected function canAddRoute(Route $route): bool
         return $route->getPage()->showInNavigation() && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
     }
 
-    protected function canAddRouteToDropdown(Route $route): bool
+    protected function canAddRouteToGroup(Route $route): bool
     {
         return $route->getPage()->navigationMenuGroup() !== null;
     }

From de8069000609267aeae3b9ce5cf7102ddf805693 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:13:30 +0100
Subject: [PATCH 0569/4023] Merge with outer condition

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index c8bd7b95224..49cf9ff3867 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -45,12 +45,10 @@ protected function generate(): void
     {
         Routes::each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($this->useSubdirectoriesAsDropdowns()) {
-                    if ($this->canAddRouteToGroup($route)) {
-                        $this->addRouteToGroup($route);
+                if ($this->useSubdirectoriesAsDropdowns() && $this->canAddRouteToGroup($route)) {
+                    $this->addRouteToGroup($route);
 
-                        return;
-                    }
+                    return;
                 }
                 $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
             }

From 15621bfaee98392917acbb16f659c4d0a3f65ba9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:14:37 +0100
Subject: [PATCH 0570/4023] Replace closure return with else branch

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 49cf9ff3867..650cc3a8f71 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -47,10 +47,9 @@ protected function generate(): void
             if ($this->canAddRoute($route)) {
                 if ($this->useSubdirectoriesAsDropdowns() && $this->canAddRouteToGroup($route)) {
                     $this->addRouteToGroup($route);
-
-                    return;
+                } else {
+                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
                 }
-                $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
             }
         });
 

From 6f0e46d22a3e46805c9c9b4992da947ccb6434d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:19:50 +0100
Subject: [PATCH 0571/4023] Inline local variable

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 22f9d0609fe..e59666dbb99 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -54,12 +54,10 @@ protected function generate(): void
 
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
-                $item = NavItem::fromRoute($route);
-
                 if ($useGroups) {
-                    $this->addItemToGroup($item);
+                    $this->addItemToGroup(NavItem::fromRoute($route));
                 } else {
-                    $this->items->put($route->getRouteKey(), $item);
+                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
                 }
             }
         });

From 742ba39ff7e311e657b6fe1b5cad3aa0e2e0305f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 13:24:24 +0100
Subject: [PATCH 0572/4023] Shift item construction to normalize method
 signature

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index e59666dbb99..71f723b3df9 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -55,7 +55,7 @@ protected function generate(): void
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
                 if ($useGroups) {
-                    $this->addItemToGroup(NavItem::fromRoute($route));
+                    $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
                 }
@@ -95,8 +95,10 @@ protected function sortByPriority(): void
         })->values();
     }
 
-    protected function addItemToGroup(NavItem $item): void
+    protected function addRouteToGroup(Route $route): void
     {
+        $item = NavItem::fromRoute($route);
+
         $groupItem = $this->getOrCreateGroupItem($item->getGroup() ?? 'Other');
 
         $groupItem->addChild($item);

From cf175b6293c09130985d21619536ae7a4f60860a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:45:46 +0100
Subject: [PATCH 0573/4023] Normalize method implementation

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 650cc3a8f71..cc0e7f0017b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -71,9 +71,9 @@ protected function canAddRouteToGroup(Route $route): bool
 
     protected function addRouteToGroup(Route $route): void
     {
-        $group = $route->getPage()->navigationMenuGroup();
+        $item = NavItem::fromRoute($route);
 
-        $groupItem = $this->getOrCreateGroupItem($group);
+        $groupItem = $this->getOrCreateGroupItem($item->getGroup());
 
         $groupItem->addChild(NavItem::fromRoute($route));
 

From b96a898e72936028da9f234c9b8fba988967488d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:46:57 +0100
Subject: [PATCH 0574/4023] Use the local variable

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index cc0e7f0017b..28c4547fb44 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -75,7 +75,7 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem = $this->getOrCreateGroupItem($item->getGroup());
 
-        $groupItem->addChild(NavItem::fromRoute($route));
+        $groupItem->addChild($item);
 
         if (! $this->items->has($groupItem->getIdentifier())) {
             $this->items->put($groupItem->getIdentifier(), $groupItem);

From 034cf3fc39d2fe62877efeba461a2dce45718464 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:47:33 +0100
Subject: [PATCH 0575/4023] Create BaseMenuGenerator.php

---
 .../Features/Navigation/BaseMenuGenerator.php          | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
new file mode 100644
index 00000000000..adf8f5baf74
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class BaseMenuGenerator
+{
+    //
+}

From d6649f0526cf036433992db959fefa8226b05909 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:48:06 +0100
Subject: [PATCH 0576/4023] Make class abstract

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index adf8f5baf74..62bf88953e0 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-class BaseMenuGenerator
+abstract class BaseMenuGenerator
 {
     //
 }

From eef96d7b8af58b38300f4943bd97a7d5b90434a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:48:26 +0100
Subject: [PATCH 0577/4023] Mark class as experimental

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 62bf88953e0..73c31725aa0 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * @experimental This class may change significantly before its release.
+ */
 abstract class BaseMenuGenerator
 {
     //

From 9132c240c05b0cb07ea7fb508360c35e4c8ca4d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:48:56 +0100
Subject: [PATCH 0578/4023] Cover new base class

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0fea5535c0a..a79b92703a9 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -25,6 +25,7 @@
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
  *
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
+ * @covers \Hyde\Framework\Features\Navigation\BaseMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu

From 276f176f48cabcb16e5c3e4da336b24cc993db34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:49:27 +0100
Subject: [PATCH 0579/4023] Extend new base class

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 71f723b3df9..06e27d77a4e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -24,7 +24,7 @@
  *
  * @see \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  */
-class GeneratesDocumentationSidebarMenu
+class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 28c4547fb44..cc77cf17ee2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -22,7 +22,7 @@
  *
  * @see \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  */
-class GeneratesMainNavigationMenu
+class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;

From 3a8d1083b5ac31e8ea8252f613bd8bed5faeb719 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 14:50:26 +0100
Subject: [PATCH 0580/4023] Move shared property to base class

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php  | 5 ++++-
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 3 ---
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 3 ---
 3 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 73c31725aa0..da42a8bf8a2 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,10 +4,13 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Collection;
+
 /**
  * @experimental This class may change significantly before its release.
  */
 abstract class BaseMenuGenerator
 {
-    //
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    protected Collection $items;
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 06e27d77a4e..c13e8b35001 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -26,9 +26,6 @@
  */
 class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
-    protected Collection $items;
-
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
     protected RouteCollection $routes;
 
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index cc77cf17ee2..3b0a010b456 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -24,9 +24,6 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
-    protected Collection $items;
-
     protected function __construct()
     {
         $this->items = new Collection();

From f3a99ba6cb9be18cfc24def74610b2164d9934dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:13:48 +0100
Subject: [PATCH 0581/4023] Move routes property to base class

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php   | 4 ++++
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 ----
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index da42a8bf8a2..9348aec8c2e 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Illuminate\Support\Collection;
+use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -13,4 +14,7 @@ abstract class BaseMenuGenerator
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
+
+    /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
+    protected RouteCollection $routes;
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c13e8b35001..6af78e7a942 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -11,7 +11,6 @@
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Foundation\Kernel\RouteCollection;
 
 use function filled;
 use function collect;
@@ -26,9 +25,6 @@
  */
 class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
-    /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
-    protected RouteCollection $routes;
-
     protected function __construct()
     {
         $this->items = new Collection();

From 5609efa01f2f03c4d6956b309888496f3699d812 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:14:32 +0100
Subject: [PATCH 0582/4023] Move constructors to base class

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 8 ++++++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 --------
 .../Features/Navigation/GeneratesMainNavigationMenu.php   | 6 ------
 3 files changed, 8 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 9348aec8c2e..5bdf5f67eed 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
+use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
@@ -17,4 +19,10 @@ abstract class BaseMenuGenerator
 
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
     protected RouteCollection $routes;
+
+    protected function __construct()
+    {
+        $this->items = new Collection();
+        $this->routes = Routes::getRoutes(DocumentationPage::class);
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 6af78e7a942..5c62c01c6bb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -9,8 +9,6 @@
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
-use Illuminate\Support\Collection;
-use Hyde\Foundation\Facades\Routes;
 
 use function filled;
 use function collect;
@@ -25,12 +23,6 @@
  */
 class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
-    protected function __construct()
-    {
-        $this->items = new Collection();
-        $this->routes = Routes::getRoutes(DocumentationPage::class);
-    }
-
     public static function handle(): DocumentationSidebar
     {
         $menu = new static();
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 3b0a010b456..fd11bcdf237 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -9,7 +9,6 @@
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
-use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 
 use function collect;
@@ -24,11 +23,6 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    protected function __construct()
-    {
-        $this->items = new Collection();
-    }
-
     public static function handle(): NavigationMenu
     {
         $menu = new static();

From b2af8b4a67bb6f64e88030ec4d6b653b308e629b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:15:48 +0100
Subject: [PATCH 0583/4023] Use routes property

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php        | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index fd11bcdf237..543b4b67677 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -9,7 +9,6 @@
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
-use Hyde\Foundation\Facades\Routes;
 
 use function collect;
 use function strtolower;
@@ -34,7 +33,7 @@ public static function handle(): NavigationMenu
 
     protected function generate(): void
     {
-        Routes::each(function (Route $route): void {
+        $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
                 if ($this->useSubdirectoriesAsDropdowns() && $this->canAddRouteToGroup($route)) {
                     $this->addRouteToGroup($route);

From aa33de8bbad43a6bdab4ab7124acdf9bc58b0612 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:16:36 +0100
Subject: [PATCH 0584/4023] Fix route construction logic

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 5bdf5f67eed..4142ca13a15 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -23,6 +23,11 @@ abstract class BaseMenuGenerator
     protected function __construct()
     {
         $this->items = new Collection();
-        $this->routes = Routes::getRoutes(DocumentationPage::class);
+
+        if ($this instanceof GeneratesDocumentationSidebarMenu) {
+            $this->routes = Routes::getRoutes(DocumentationPage::class);
+        } else {
+            $this->routes = Routes::all();
+        }
     }
 }

From f4b336e1196ff0d638861f99a95de8502973434c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:17:30 +0100
Subject: [PATCH 0585/4023] Simplify 'if'

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 4142ca13a15..da9aef80df8 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -24,10 +24,8 @@ protected function __construct()
     {
         $this->items = new Collection();
 
-        if ($this instanceof GeneratesDocumentationSidebarMenu) {
-            $this->routes = Routes::getRoutes(DocumentationPage::class);
-        } else {
-            $this->routes = Routes::all();
-        }
+        $this->routes = $this instanceof GeneratesDocumentationSidebarMenu
+            ? Routes::getRoutes(DocumentationPage::class)
+            : Routes::all();
     }
 }

From 116ca5a0a44d30161609964d9c3af75352560a0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:27:07 +0100
Subject: [PATCH 0586/4023] Refactor to move entry point to base class

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php  | 9 +++++++++
 .../Features/Navigation/GeneratesMainNavigationMenu.php  | 9 ---------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index da9aef80df8..f26a29a3542 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -28,4 +28,13 @@ protected function __construct()
             ? Routes::getRoutes(DocumentationPage::class)
             : Routes::all();
     }
+
+    public static function handle(): NavigationMenu
+    {
+        $menu = new static();
+
+        $menu->generate();
+
+        return new NavigationMenu($menu->items);
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 543b4b67677..33b9f970590 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -22,15 +22,6 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    public static function handle(): NavigationMenu
-    {
-        $menu = new static();
-
-        $menu->generate();
-
-        return new NavigationMenu($menu->items);
-    }
-
     protected function generate(): void
     {
         $this->routes->each(function (Route $route): void {

From 65dbb894260330e9a3a0d3087236caa8a7ec9a38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:37:11 +0100
Subject: [PATCH 0587/4023] Introduce state field

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index f26a29a3542..85d5fc96c24 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -20,11 +20,15 @@ abstract class BaseMenuGenerator
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
     protected RouteCollection $routes;
 
+    protected bool $generatesSidebar;
+
     protected function __construct()
     {
         $this->items = new Collection();
 
-        $this->routes = $this instanceof GeneratesDocumentationSidebarMenu
+        $this->generatesSidebar = $this instanceof GeneratesDocumentationSidebarMenu;
+
+        $this->routes = $this->generatesSidebar
             ? Routes::getRoutes(DocumentationPage::class)
             : Routes::all();
     }

From 19cfb690ecc2bab5241cc1130b9558a88ca366b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:38:10 +0100
Subject: [PATCH 0588/4023] Contract abstract function

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 85d5fc96c24..b27fef3e8b3 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -41,4 +41,6 @@ public static function handle(): NavigationMenu
 
         return new NavigationMenu($menu->items);
     }
+
+    abstract protected function generate(): void;
 }

From 5ae81ea1836fc9ceec63a07bec7029d9a19a6816 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:40:43 +0100
Subject: [PATCH 0589/4023] Introduce polymorphic state field

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index b27fef3e8b3..31c9e210e2d 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -21,6 +21,7 @@ abstract class BaseMenuGenerator
     protected RouteCollection $routes;
 
     protected bool $generatesSidebar;
+    protected bool $usesGroups;
 
     protected function __construct()
     {
@@ -31,6 +32,10 @@ protected function __construct()
         $this->routes = $this->generatesSidebar
             ? Routes::getRoutes(DocumentationPage::class)
             : Routes::all();
+
+        $this->usesGroups = $this->generatesSidebar
+            ? $this->usesSidebarGroups()
+            : $this->useSubdirectoriesAsDropdowns();
     }
 
     public static function handle(): NavigationMenu

From 15453da8e4d73ab51743342a9f8a0354b79dc39e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:41:42 +0100
Subject: [PATCH 0590/4023] Extract helper method

---
 .../Features/Navigation/BaseMenuGenerator.php         | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 31c9e210e2d..44e0e89e6da 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -33,9 +33,7 @@ protected function __construct()
             ? Routes::getRoutes(DocumentationPage::class)
             : Routes::all();
 
-        $this->usesGroups = $this->generatesSidebar
-            ? $this->usesSidebarGroups()
-            : $this->useSubdirectoriesAsDropdowns();
+        $this->usesGroups = $this->usesGroups();
     }
 
     public static function handle(): NavigationMenu
@@ -48,4 +46,11 @@ public static function handle(): NavigationMenu
     }
 
     abstract protected function generate(): void;
+
+    protected function usesGroups(): bool
+    {
+        return $this->generatesSidebar
+            ? $this->usesSidebarGroups()
+            : $this->useSubdirectoriesAsDropdowns();
+    }
 }

From 4ef3834868f495c35473eee8fcb47f52cafe39f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:42:03 +0100
Subject: [PATCH 0591/4023] Replace '?:' with if

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 44e0e89e6da..ce732b543dc 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -49,8 +49,10 @@ abstract protected function generate(): void;
 
     protected function usesGroups(): bool
     {
-        return $this->generatesSidebar
-            ? $this->usesSidebarGroups()
-            : $this->useSubdirectoriesAsDropdowns();
+        if ($this->generatesSidebar) {
+            return $this->usesSidebarGroups();
+        } else {
+            return $this->useSubdirectoriesAsDropdowns();
+        }
     }
 }

From ce2e9ddb038dd67ca772e99ea913a80a3f8d6da7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:44:18 +0100
Subject: [PATCH 0592/4023] Use added state field

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 5c62c01c6bb..a65f1f5015e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -35,7 +35,7 @@ public static function handle(): DocumentationSidebar
 
     protected function generate(): void
     {
-        $useGroups = $this->usesSidebarGroups();
+        $useGroups = $this->usesGroups;
 
         $this->routes->each(function (Route $route) use ($useGroups): void {
             if ($this->canAddRoute($route)) {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 33b9f970590..f84afbd154b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -26,7 +26,7 @@ protected function generate(): void
     {
         $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($this->useSubdirectoriesAsDropdowns() && $this->canAddRouteToGroup($route)) {
+                if ($this->usesGroups && $this->canAddRouteToGroup($route)) {
                     $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));

From 8bb755202d463381ef716282ac4e20cb103e5b59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:44:44 +0100
Subject: [PATCH 0593/4023] Inline polymorphic helper methods

---
 .../Features/Navigation/BaseMenuGenerator.php       | 13 +++++++++++--
 .../GeneratesDocumentationSidebarMenu.php           | 11 -----------
 .../Navigation/GeneratesMainNavigationMenu.php      |  5 -----
 3 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index ce732b543dc..aa3900abe82 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,11 +4,15 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
+use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 
+use function filled;
+
 /**
  * @experimental This class may change significantly before its release.
  */
@@ -50,9 +54,14 @@ abstract protected function generate(): void;
     protected function usesGroups(): bool
     {
         if ($this->generatesSidebar) {
-            return $this->usesSidebarGroups();
+            // In order to know if we should use groups in the sidebar,
+            // we need to loop through the pages and see if they have a group set
+
+            return $this->routes->first(function (Route $route): bool {
+                return filled($route->getPage()->navigationMenuGroup());
+            }) !== null;
         } else {
-            return $this->useSubdirectoriesAsDropdowns();
+            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
         }
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a65f1f5015e..af70c970c75 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -10,7 +10,6 @@
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
-use function filled;
 use function collect;
 use function strtolower;
 
@@ -53,16 +52,6 @@ protected function generate(): void
         }
     }
 
-    protected function usesSidebarGroups(): bool
-    {
-        // In order to know if we should use groups in the sidebar,
-        // we need to loop through the pages and see if they have a group set
-
-        return $this->routes->first(function (Route $route): bool {
-            return filled($route->getPage()->navigationMenuGroup());
-        }) !== null;
-    }
-
     protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index f84afbd154b..e981b956897 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -79,11 +79,6 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
         return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }
 
-    protected function useSubdirectoriesAsDropdowns(): bool
-    {
-        return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
-    }
-
     protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;

From 5d9e82a0d1f3b74d9d4389e2bd0a7f6050266b5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:45:52 +0100
Subject: [PATCH 0594/4023] Convert closure to arrow function

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index aa3900abe82..d5781fab250 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -57,9 +57,7 @@ protected function usesGroups(): bool
             // In order to know if we should use groups in the sidebar,
             // we need to loop through the pages and see if they have a group set
 
-            return $this->routes->first(function (Route $route): bool {
-                return filled($route->getPage()->navigationMenuGroup());
-            }) !== null;
+            return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;
         } else {
             return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
         }

From 2778649c463670bc942dcfe12a20a484342a568f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:46:25 +0100
Subject: [PATCH 0595/4023] Clarify logic description

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index d5781fab250..9b360765859 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -55,7 +55,8 @@ protected function usesGroups(): bool
     {
         if ($this->generatesSidebar) {
             // In order to know if we should use groups in the sidebar,
-            // we need to loop through the pages and see if they have a group set
+            // we need to loop through the pages and see if they have a group set.
+            // This automatically enables the sidebar grouping for all pages if at least one group is set.
 
             return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;
         } else {

From 7c7f582899773a77567ca3e2f5f0dc8964ecb7cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:46:54 +0100
Subject: [PATCH 0596/4023] Format code comment

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 9b360765859..282e208e1e1 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -54,8 +54,7 @@ abstract protected function generate(): void;
     protected function usesGroups(): bool
     {
         if ($this->generatesSidebar) {
-            // In order to know if we should use groups in the sidebar,
-            // we need to loop through the pages and see if they have a group set.
+            // In order to know if we should use groups in the sidebar, we need to loop through the pages and see if they have a group set.
             // This automatically enables the sidebar grouping for all pages if at least one group is set.
 
             return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;

From a4ab7ada916bbaf63fd88bfe3487ac9ed70cf847 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:48:20 +0100
Subject: [PATCH 0597/4023] Inline local variable

---
 .../Navigation/GeneratesDocumentationSidebarMenu.php        | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index af70c970c75..0d9f3df0238 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -34,11 +34,9 @@ public static function handle(): DocumentationSidebar
 
     protected function generate(): void
     {
-        $useGroups = $this->usesGroups;
-
-        $this->routes->each(function (Route $route) use ($useGroups): void {
+        $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($useGroups) {
+                if ($this->usesGroups) {
                     $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));

From ae551a4c860a3bdbcab0b63d84bc0b5a255a2769 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 15:59:57 +0100
Subject: [PATCH 0598/4023] Document reasoning behind filter

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php     | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index e981b956897..d424848f011 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -42,7 +42,11 @@ protected function generate(): void
 
     protected function canAddRoute(Route $route): bool
     {
-        return $route->getPage()->showInNavigation() && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
+        return $route->getPage()->showInNavigation()
+            // While we for the most part can rely on the navigation visibility state provided by the navigation data factory,
+            // we need to make an exception for documentation pages, which generally have a visible state, as the data is
+            // also used in the sidebar. But we only want the documentation index page to be in the main navigation.
+            && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
     }
 
     protected function canAddRouteToGroup(Route $route): bool

From 31f7e626c5010ea1c1f0d4683e5ee5a0df5a7eef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 16:00:43 +0100
Subject: [PATCH 0599/4023] Document reasoning behind filter

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 0d9f3df0238..c510a4020ba 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -52,7 +52,9 @@ protected function generate(): void
 
     protected function canAddRoute(Route $route): bool
     {
-        return $route->getPage()->showInNavigation() && ! $route->is(DocumentationPage::homeRouteName());
+        return $route->getPage()->showInNavigation()
+            // Since the index page is linked in the header, we don't want it in the sidebar
+            && ! $route->is(DocumentationPage::homeRouteName());
     }
 
     protected function sortByPriority(): void

From 03599ca916f0c86be4fbca91837becea213b3e59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 16:01:58 +0100
Subject: [PATCH 0600/4023] Extract parent method

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php  | 5 +++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 2 +-
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 282e208e1e1..04451f46183 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -62,4 +62,9 @@ protected function usesGroups(): bool
             return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
         }
     }
+
+    protected function canAddRoute(Route $route): bool
+    {
+        return $route->getPage()->showInNavigation();
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index c510a4020ba..768c4ca43e5 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -52,7 +52,7 @@ protected function generate(): void
 
     protected function canAddRoute(Route $route): bool
     {
-        return $route->getPage()->showInNavigation()
+        return parent::canAddRoute($route)
             // Since the index page is linked in the header, we don't want it in the sidebar
             && ! $route->is(DocumentationPage::homeRouteName());
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index d424848f011..19d671d2b9f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -42,7 +42,7 @@ protected function generate(): void
 
     protected function canAddRoute(Route $route): bool
     {
-        return $route->getPage()->showInNavigation()
+        return parent::canAddRoute($route)
             // While we for the most part can rely on the navigation visibility state provided by the navigation data factory,
             // we need to make an exception for documentation pages, which generally have a visible state, as the data is
             // also used in the sidebar. But we only want the documentation index page to be in the main navigation.

From 8b2760cac48238aa27f16926f7a29a49a6e6051f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 16:12:51 +0100
Subject: [PATCH 0601/4023] Swap method source order

---
 .../GeneratesDocumentationSidebarMenu.php     | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 768c4ca43e5..cd43fcc66e2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -57,18 +57,6 @@ protected function canAddRoute(Route $route): bool
             && ! $route->is(DocumentationPage::homeRouteName());
     }
 
-    protected function sortByPriority(): void
-    {
-        // While the items accessor sorts the items upon retrieval,
-        // we do an initial sorting here to order any groups.
-
-        $this->items = $this->items->sortBy(function (NavItem $item): int {
-            return $item->hasChildren()
-                ? $this->getLowestPriorityInGroup($item)
-                : $item->getPriority();
-        })->values();
-    }
-
     protected function addRouteToGroup(Route $route): void
     {
         $item = NavItem::fromRoute($route);
@@ -82,6 +70,18 @@ protected function addRouteToGroup(Route $route): void
         }
     }
 
+    protected function sortByPriority(): void
+    {
+        // While the items accessor sorts the items upon retrieval,
+        // we do an initial sorting here to order any groups.
+
+        $this->items = $this->items->sortBy(function (NavItem $item): int {
+            return $item->hasChildren()
+                ? $this->getLowestPriorityInGroup($item)
+                : $item->getPriority();
+        })->values();
+    }
+
     protected function getLowestPriorityInGroup(NavItem $item): int
     {
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());

From 9e01c8d470fe5b1bacbaff08eb778bd53831490c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 16:14:56 +0100
Subject: [PATCH 0602/4023] Add abstract method stub

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 04451f46183..4ddf3daf910 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -67,4 +67,7 @@ protected function canAddRoute(Route $route): bool
     {
         return $route->getPage()->showInNavigation();
     }
+
+    // Todo: Refactor to bring logic here
+    abstract protected function addRouteToGroup(Route $route): void;
 }

From d67c695f3d3c18b2299696c7e7539551206bf73a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:26:38 +0100
Subject: [PATCH 0603/4023] Rename helper method

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 19d671d2b9f..75e5e3d05c6 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -26,7 +26,7 @@ protected function generate(): void
     {
         $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($this->usesGroups && $this->canAddRouteToGroup($route)) {
+                if ($this->usesGroups && $this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
@@ -49,7 +49,7 @@ protected function canAddRoute(Route $route): bool
             && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
     }
 
-    protected function canAddRouteToGroup(Route $route): bool
+    protected function canGroupRoute(Route $route): bool
     {
         return $route->getPage()->navigationMenuGroup() !== null;
     }

From d50c054fb6f1fe992257115679e8d7ce94e4950b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:28:40 +0100
Subject: [PATCH 0604/4023] Refactor to add parent method

Normalizes the implementations
---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php  | 5 +++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 4 ++--
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 4ddf3daf910..06dcf0bbe51 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -68,6 +68,11 @@ protected function canAddRoute(Route $route): bool
         return $route->getPage()->showInNavigation();
     }
 
+    protected function canGroupRoute(Route $route): bool
+    {
+        return $this->usesGroups;
+    }
+
     // Todo: Refactor to bring logic here
     abstract protected function addRouteToGroup(Route $route): void;
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index cd43fcc66e2..56ef1c1f9c0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -36,7 +36,7 @@ protected function generate(): void
     {
         $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($this->usesGroups) {
+                if ($this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 75e5e3d05c6..4414010134c 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -26,7 +26,7 @@ protected function generate(): void
     {
         $this->routes->each(function (Route $route): void {
             if ($this->canAddRoute($route)) {
-                if ($this->usesGroups && $this->canGroupRoute($route)) {
+                if ($this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
                     $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
@@ -51,7 +51,7 @@ protected function canAddRoute(Route $route): bool
 
     protected function canGroupRoute(Route $route): bool
     {
-        return $route->getPage()->navigationMenuGroup() !== null;
+        return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
     }
 
     protected function addRouteToGroup(Route $route): void

From ba428a8fac20fa63dbdf6bee090975fbcc7c3873 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:31:47 +0100
Subject: [PATCH 0605/4023] Add shared logic to parent class

---
 .../Features/Navigation/BaseMenuGenerator.php       | 13 ++++++++++++-
 .../GeneratesDocumentationSidebarMenu.php           | 10 +---------
 .../Navigation/GeneratesMainNavigationMenu.php      | 10 +---------
 3 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 06dcf0bbe51..0aa9c49630d 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -49,7 +49,18 @@ public static function handle(): NavigationMenu
         return new NavigationMenu($menu->items);
     }
 
-    abstract protected function generate(): void;
+    protected function generate(): void
+    {
+        $this->routes->each(function (Route $route): void {
+            if ($this->canAddRoute($route)) {
+                if ($this->canGroupRoute($route)) {
+                    $this->addRouteToGroup($route);
+                } else {
+                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+                }
+            }
+        });
+    }
 
     protected function usesGroups(): bool
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 56ef1c1f9c0..7b4193d909a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -34,15 +34,7 @@ public static function handle(): DocumentationSidebar
 
     protected function generate(): void
     {
-        $this->routes->each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                if ($this->canGroupRoute($route)) {
-                    $this->addRouteToGroup($route);
-                } else {
-                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-                }
-            }
-        });
+        parent::generate();
 
         // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
         if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 4414010134c..2eb0319488a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -24,15 +24,7 @@ class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
     protected function generate(): void
     {
-        $this->routes->each(function (Route $route): void {
-            if ($this->canAddRoute($route)) {
-                if ($this->canGroupRoute($route)) {
-                    $this->addRouteToGroup($route);
-                } else {
-                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
-                }
-            }
-        });
+        parent::generate();
 
         collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
             // Since these were added explicitly by the user, we can assume they should always be shown

From 0832057593c7d24a8a5359d79790a12c67e0191e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:33:24 +0100
Subject: [PATCH 0606/4023] Refactor to bring logic to parent

---
 .../Features/Navigation/BaseMenuGenerator.php | 20 +++++++++++++++++--
 .../GeneratesDocumentationSidebarMenu.php     | 13 ------------
 .../GeneratesMainNavigationMenu.php           | 13 ------------
 3 files changed, 18 insertions(+), 28 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 0aa9c49630d..5a2d1cf5dd2 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -84,6 +84,22 @@ protected function canGroupRoute(Route $route): bool
         return $this->usesGroups;
     }
 
-    // Todo: Refactor to bring logic here
-    abstract protected function addRouteToGroup(Route $route): void;
+    protected function addRouteToGroup(Route $route): void
+    {
+        $item = NavItem::fromRoute($route);
+
+        if ($this->generatesSidebar) {
+            $groupName = $item->getGroup() ?? 'Other';
+        } else {
+            $groupName = $item->getGroup();
+        }
+
+        $groupItem = $this->getOrCreateGroupItem($groupName);
+
+        $groupItem->addChild($item);
+
+        if (! $this->items->has($groupItem->getIdentifier())) {
+            $this->items->put($groupItem->getIdentifier(), $groupItem);
+        }
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7b4193d909a..80b8a13c4ca 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -49,19 +49,6 @@ protected function canAddRoute(Route $route): bool
             && ! $route->is(DocumentationPage::homeRouteName());
     }
 
-    protected function addRouteToGroup(Route $route): void
-    {
-        $item = NavItem::fromRoute($route);
-
-        $groupItem = $this->getOrCreateGroupItem($item->getGroup() ?? 'Other');
-
-        $groupItem->addChild($item);
-
-        if (! $this->items->has($groupItem->getIdentifier())) {
-            $this->items->put($groupItem->getIdentifier(), $groupItem);
-        }
-    }
-
     protected function sortByPriority(): void
     {
         // While the items accessor sorts the items upon retrieval,
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 2eb0319488a..29e933c46eb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -46,19 +46,6 @@ protected function canGroupRoute(Route $route): bool
         return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
     }
 
-    protected function addRouteToGroup(Route $route): void
-    {
-        $item = NavItem::fromRoute($route);
-
-        $groupItem = $this->getOrCreateGroupItem($item->getGroup());
-
-        $groupItem->addChild($item);
-
-        if (! $this->items->has($groupItem->getIdentifier())) {
-            $this->items->put($groupItem->getIdentifier(), $groupItem);
-        }
-    }
-
     protected function getOrCreateGroupItem(string $groupName): NavItem
     {
         $identifier = Str::slug($groupName);

From a0a64aae3028a37be112c5a6a411e124750cb0dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:34:26 +0100
Subject: [PATCH 0607/4023] Simplify 'if'

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 5a2d1cf5dd2..e470d0d8de4 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -88,11 +88,7 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavItem::fromRoute($route);
 
-        if ($this->generatesSidebar) {
-            $groupName = $item->getGroup() ?? 'Other';
-        } else {
-            $groupName = $item->getGroup();
-        }
+        $groupName = $this->generatesSidebar ? $item->getGroup() ?? 'Other' : $item->getGroup();
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 

From 800d1982ed477409d073824c37198f03b5385777 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:35:04 +0100
Subject: [PATCH 0608/4023] Add clarifying parentheses

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index e470d0d8de4..87eae0adac3 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -88,7 +88,7 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavItem::fromRoute($route);
 
-        $groupName = $this->generatesSidebar ? $item->getGroup() ?? 'Other' : $item->getGroup();
+        $groupName = $this->generatesSidebar ? ($item->getGroup() ?? 'Other') : $item->getGroup();
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 

From e759d5cacf002584479ccc4ed0fbb620dc7c9ad4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:36:07 +0100
Subject: [PATCH 0609/4023] Move shared method to parent

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php  | 9 +++++++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php     | 9 ---------
 .../Features/Navigation/GeneratesMainNavigationMenu.php  | 9 ---------
 3 files changed, 9 insertions(+), 18 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 87eae0adac3..272f8bb801e 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
+use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -98,4 +99,12 @@ protected function addRouteToGroup(Route $route): void
             $this->items->put($groupItem->getIdentifier(), $groupItem);
         }
     }
+
+    protected function getOrCreateGroupItem(string $groupName): NavItem
+    {
+        $identifier = Str::slug($groupName);
+        $group = $this->items->get($identifier);
+
+        return $group ?? $this->createGroupItem($identifier, $groupName);
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 80b8a13c4ca..8c4af350163 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
@@ -66,14 +65,6 @@ protected function getLowestPriorityInGroup(NavItem $item): int
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
 
-    protected function getOrCreateGroupItem(string $groupName): NavItem
-    {
-        $identifier = Str::slug($groupName);
-        $group = $this->items->get($identifier);
-
-        return $group ?? $this->createGroupItem($identifier, $groupName);
-    }
-
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 29e933c46eb..df7eb0339f4 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
@@ -46,14 +45,6 @@ protected function canGroupRoute(Route $route): bool
         return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
     }
 
-    protected function getOrCreateGroupItem(string $groupName): NavItem
-    {
-        $identifier = Str::slug($groupName);
-        $group = $this->items->get($identifier);
-
-        return $group ?? $this->createGroupItem($identifier, $groupName);
-    }
-
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;

From d40f25577986f61dd655928e049dfb616aa6e671 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:49:20 +0100
Subject: [PATCH 0610/4023] Begin refactoring method to parent class

---
 .../Features/Navigation/BaseMenuGenerator.php     | 15 +++++++++++++++
 .../GeneratesDocumentationSidebarMenu.php         |  8 --------
 .../Navigation/GeneratesMainNavigationMenu.php    |  8 --------
 3 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 272f8bb801e..0129239384f 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -107,4 +107,19 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
         return $group ?? $this->createGroupItem($identifier, $groupName);
     }
+
+    protected function createGroupItem(string $identifier, string $groupName): NavItem
+    {
+        if ($this->generatesSidebar) {
+            $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+            $priority = $this->searchForGroupPriorityInConfig($identifier);
+
+            return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
+        } else {
+            $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+            $priority = $this->searchForDropdownPriorityInConfig($identifier);
+
+            return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
+        }
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 8c4af350163..d9174598e4a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -65,14 +65,6 @@ protected function getLowestPriorityInGroup(NavItem $item): int
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
 
-    protected function createGroupItem(string $identifier, string $groupName): NavItem
-    {
-        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
-        $priority = $this->searchForGroupPriorityInConfig($identifier);
-
-        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
-    }
-
     protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index df7eb0339f4..4e093aa3cec 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -45,14 +45,6 @@ protected function canGroupRoute(Route $route): bool
         return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
     }
 
-    protected function createGroupItem(string $identifier, string $groupName): NavItem
-    {
-        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
-        $priority = $this->searchForDropdownPriorityInConfig($identifier);
-
-        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
-    }
-
     protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;

From b57a54922e035a5aa22fae82ec8f91dcea7a23b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:50:40 +0100
Subject: [PATCH 0611/4023] Extract common parts from if/else block

---
 .../Features/Navigation/BaseMenuGenerator.php          | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 0129239384f..db07ab50d0c 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -110,16 +110,14 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
 
     protected function createGroupItem(string $identifier, string $groupName): NavItem
     {
+        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+
         if ($this->generatesSidebar) {
-            $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
             $priority = $this->searchForGroupPriorityInConfig($identifier);
-
-            return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
         } else {
-            $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
             $priority = $this->searchForDropdownPriorityInConfig($identifier);
-
-            return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
         }
+
+        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }
 }

From d6c33aedf1017ab8a2ad6ac3e8a43eec1233d02f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:53:47 +0100
Subject: [PATCH 0612/4023] Simplify 'if'

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index db07ab50d0c..19085bc73f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -112,11 +112,9 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
 
-        if ($this->generatesSidebar) {
-            $priority = $this->searchForGroupPriorityInConfig($identifier);
-        } else {
-            $priority = $this->searchForDropdownPriorityInConfig($identifier);
-        }
+        $priority = $this->generatesSidebar
+            ? $this->searchForGroupPriorityInConfig($identifier)
+            : $this->searchForDropdownPriorityInConfig($identifier);
 
         return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }

From 338b453a4b355e091180c65022b73cae761d0c25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:55:56 +0100
Subject: [PATCH 0613/4023] Normalize method signatures

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php   | 4 +---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php       | 2 +-
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 19085bc73f7..5dadc5520e0 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -112,9 +112,7 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
     {
         $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
 
-        $priority = $this->generatesSidebar
-            ? $this->searchForGroupPriorityInConfig($identifier)
-            : $this->searchForDropdownPriorityInConfig($identifier);
+        $priority = $this->searchForGroupPriorityInConfig($identifier);
 
         return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index d9174598e4a..593b7863160 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -82,7 +82,7 @@ protected static function normalizeGroupLabel(string $label): string
     }
 
     /** Todo: Move into shared class */
-    protected static function searchForGroupPriorityInConfig(string $groupKey): ?int
+    protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         return Config::getArray('docs.sidebar_order', [])[$groupKey] ?? null;
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 4e093aa3cec..7129b82df1f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -62,7 +62,7 @@ protected static function normalizeGroupLabel(string $label): string
     }
 
     /** Todo: Move into shared class */
-    protected static function searchForDropdownPriorityInConfig(string $groupKey): ?int
+    protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
     }

From 9af0fbc4616bd9423a5312c10608924d3a2c14b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 17:57:59 +0100
Subject: [PATCH 0614/4023] Move shared method into base class

---
 .../Features/Navigation/BaseMenuGenerator.php       | 12 ++++++++++++
 .../GeneratesDocumentationSidebarMenu.php           | 13 -------------
 .../Navigation/GeneratesMainNavigationMenu.php      | 13 -------------
 3 files changed, 12 insertions(+), 26 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 5dadc5520e0..82d5b6a14a6 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
@@ -13,6 +14,7 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function filled;
+use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -116,4 +118,14 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
 
         return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
     }
+
+    protected static function normalizeGroupLabel(string $label): string
+    {
+        // If there is no label, and the group is a slug, we can make a title from it
+        if ($label === strtolower($label)) {
+            return Hyde::makeTitle($label);
+        }
+
+        return $label;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 593b7863160..cbd8309532e 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,13 +4,11 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
 use function collect;
-use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -70,17 +68,6 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
 
-    /** Todo: Move into shared class */
-    protected static function normalizeGroupLabel(string $label): string
-    {
-        // If there is no label, and the group is a slug, we can make a title from it
-        if ($label === strtolower($label)) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
-
     /** Todo: Move into shared class */
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 7129b82df1f..794fed0e571 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -4,13 +4,11 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
 use function collect;
-use function strtolower;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -50,17 +48,6 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
         return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;
     }
 
-    /** Todo: Move into shared class */
-    protected static function normalizeGroupLabel(string $label): string
-    {
-        // If there is no label, and the group is a slug, we can make a title from it
-        if ($label === strtolower($label)) {
-            return Hyde::makeTitle($label);
-        }
-
-        return $label;
-    }
-
     /** Todo: Move into shared class */
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {

From d167660042914030197aacc9ce271ce48294a16e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 18:04:12 +0100
Subject: [PATCH 0615/4023] Change static method to instance member

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 82d5b6a14a6..249903d18a4 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -116,10 +116,10 @@ protected function createGroupItem(string $identifier, string $groupName): NavIt
 
         $priority = $this->searchForGroupPriorityInConfig($identifier);
 
-        return NavItem::dropdown(static::normalizeGroupLabel($label), [], $priority);
+        return NavItem::dropdown($this->normalizeGroupLabel($label), [], $priority);
     }
 
-    protected static function normalizeGroupLabel(string $label): string
+    protected function normalizeGroupLabel(string $label): string
     {
         // If there is no label, and the group is a slug, we can make a title from it
         if ($label === strtolower($label)) {

From 5ee8ce1da782a1bffe8533fb9d131cadf6808d0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 18:06:55 +0100
Subject: [PATCH 0616/4023] Refactor to move method into parent class

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php    | 7 +++++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php       | 6 ------
 .../Features/Navigation/GeneratesMainNavigationMenu.php    | 6 ------
 3 files changed, 7 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 249903d18a4..79262d9abdb 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -128,4 +128,11 @@ protected function normalizeGroupLabel(string $label): string
 
         return $label;
     }
+
+    protected function searchForGroupPriorityInConfig(string $groupKey): ?int
+    {
+        $key = $this->generatesSidebar ? 'docs.sidebar_order' : 'hyde.navigation.order';
+
+        return Config::getArray($key, [])[$groupKey] ?? null;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index cbd8309532e..59737dce823 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -67,10 +67,4 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
     }
-
-    /** Todo: Move into shared class */
-    protected function searchForGroupPriorityInConfig(string $groupKey): ?int
-    {
-        return Config::getArray('docs.sidebar_order', [])[$groupKey] ?? null;
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 794fed0e571..aa36fddf141 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -47,10 +47,4 @@ protected function searchForGroupLabelInConfig(string $identifier): ?string
     {
         return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;
     }
-
-    /** Todo: Move into shared class */
-    protected function searchForGroupPriorityInConfig(string $groupKey): ?int
-    {
-        return Config::getArray('hyde.navigation.order', [])[$groupKey] ?? null;
-    }
 }

From 351ff643d588f66750bf797422e18e072e0c7f7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 18:08:44 +0100
Subject: [PATCH 0617/4023] Refactor to move method into parent class

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php    | 7 +++++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php       | 6 ------
 .../Features/Navigation/GeneratesMainNavigationMenu.php    | 5 -----
 3 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 79262d9abdb..ed5f73bfbda 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -129,6 +129,13 @@ protected function normalizeGroupLabel(string $label): string
         return $label;
     }
 
+    protected function searchForGroupLabelInConfig(string $identifier): ?string
+    {
+        $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
+
+        return Config::getArray($key, [])[$identifier] ?? null;
+    }
+
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_order' : 'hyde.navigation.order';
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 59737dce823..ed88032994f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
@@ -62,9 +61,4 @@ protected function getLowestPriorityInGroup(NavItem $item): int
     {
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
-
-    protected function searchForGroupLabelInConfig(string $identifier): ?string
-    {
-        return Config::getArray('docs.sidebar_group_labels', [])[$identifier] ?? null;
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index aa36fddf141..33b802cf4fb 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -42,9 +42,4 @@ protected function canGroupRoute(Route $route): bool
     {
         return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
     }
-
-    protected function searchForGroupLabelInConfig(string $identifier): ?string
-    {
-        return Config::getArray('hyde.navigation.labels', [])[$identifier] ?? null;
-    }
 }

From 02b327c315e52c8cbd83ab2ab068e8414ceb50fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 18:11:13 +0100
Subject: [PATCH 0618/4023] Normalize helper method signatures

Using groupKey instead of identifier as the latter can also apply to the pages
---
 .../Features/Navigation/BaseMenuGenerator.php    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index ed5f73bfbda..128ee3c0cc0 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -104,17 +104,17 @@ protected function addRouteToGroup(Route $route): void
 
     protected function getOrCreateGroupItem(string $groupName): NavItem
     {
-        $identifier = Str::slug($groupName);
-        $group = $this->items->get($identifier);
+        $groupKey = Str::slug($groupName);
+        $group = $this->items->get($groupKey);
 
-        return $group ?? $this->createGroupItem($identifier, $groupName);
+        return $group ?? $this->createGroupItem($groupKey, $groupName);
     }
 
-    protected function createGroupItem(string $identifier, string $groupName): NavItem
+    protected function createGroupItem(string $groupKey, string $groupName): NavItem
     {
-        $label = $this->searchForGroupLabelInConfig($identifier) ?? $groupName;
+        $label = $this->searchForGroupLabelInConfig($groupKey) ?? $groupName;
 
-        $priority = $this->searchForGroupPriorityInConfig($identifier);
+        $priority = $this->searchForGroupPriorityInConfig($groupKey);
 
         return NavItem::dropdown($this->normalizeGroupLabel($label), [], $priority);
     }
@@ -129,11 +129,11 @@ protected function normalizeGroupLabel(string $label): string
         return $label;
     }
 
-    protected function searchForGroupLabelInConfig(string $identifier): ?string
+    protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
 
-        return Config::getArray($key, [])[$identifier] ?? null;
+        return Config::getArray($key, [])[$groupKey] ?? null;
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int

From f14c7dd75f82b8622b00a8695dac3e54bd56973e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 18:16:15 +0100
Subject: [PATCH 0619/4023] Remove resolved todos

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 --
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 --
 2 files changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index ed88032994f..efa661ffdc7 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -12,8 +12,6 @@
 /**
  * @experimental This class may change significantly before its release.
  *
- * @todo Consider making into a service which can create the sidebar as well.
- *
  * @see \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  */
 class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 33b802cf4fb..00503a07751 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,8 +13,6 @@
 /**
  * @experimental This class may change significantly before its release.
  *
- * @todo Consider making into a service which can create the sidebar as well.
- *
  * @see \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator

From d8c378dca4421cea0783b4cdec23f4e630ce1ada Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:15:09 +0100
Subject: [PATCH 0620/4023] Move method call into method body

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index efa661ffdc7..b7fe4ab3bc0 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -21,7 +21,6 @@ public static function handle(): DocumentationSidebar
         $menu = new static();
 
         $menu->generate();
-        $menu->sortByPriority();
 
         return new DocumentationSidebar($menu->items);
     }
@@ -34,6 +33,8 @@ protected function generate(): void
         if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
             $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
         }
+
+        $this->sortByPriority();
     }
 
     protected function canAddRoute(Route $route): bool

From a4a8fb951cd91a7f1756ffcac4087bae3893d42d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:42:38 +0100
Subject: [PATCH 0621/4023] Add a type parameter to the base class

---
 .../Features/Navigation/BaseMenuGenerator.php          | 10 ++++++++--
 .../Navigation/GeneratesDocumentationSidebarMenu.php   |  2 +-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 128ee3c0cc0..d624ff198a9 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -27,11 +27,17 @@ abstract class BaseMenuGenerator
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
     protected RouteCollection $routes;
 
+    /** @var class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> */
+    protected string $menuType;
+
     protected bool $generatesSidebar;
     protected bool $usesGroups;
 
-    protected function __construct()
+    /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
+    protected function __construct(string $menuType)
     {
+        $this->menuType = $menuType;
+
         $this->items = new Collection();
 
         $this->generatesSidebar = $this instanceof GeneratesDocumentationSidebarMenu;
@@ -45,7 +51,7 @@ protected function __construct()
 
     public static function handle(): NavigationMenu
     {
-        $menu = new static();
+        $menu = new static(NavigationMenu::class);
 
         $menu->generate();
 
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index b7fe4ab3bc0..29ba4d18925 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -18,7 +18,7 @@ class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
     public static function handle(): DocumentationSidebar
     {
-        $menu = new static();
+        $menu = new static(DocumentationSidebar::class);
 
         $menu->generate();
 

From 84500ff4e84e2bcd045db024ea304a891aebd867 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:44:36 +0100
Subject: [PATCH 0622/4023] Replace type check

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index d624ff198a9..80de191640c 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -40,7 +40,7 @@ protected function __construct(string $menuType)
 
         $this->items = new Collection();
 
-        $this->generatesSidebar = $this instanceof GeneratesDocumentationSidebarMenu;
+        $this->generatesSidebar = $menuType === DocumentationSidebar::class;
 
         $this->routes = $this->generatesSidebar
             ? Routes::getRoutes(DocumentationPage::class)

From e05f5ea87014a5fab74663e3f03a13358a59019d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:48:33 +0100
Subject: [PATCH 0623/4023] Rename helper method

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 29ba4d18925..bb596fc456d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -34,7 +34,7 @@ protected function generate(): void
             $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
         }
 
-        $this->sortByPriority();
+        $this->sortSidebarGroupsByLowestPriority();
     }
 
     protected function canAddRoute(Route $route): bool
@@ -44,7 +44,7 @@ protected function canAddRoute(Route $route): bool
             && ! $route->is(DocumentationPage::homeRouteName());
     }
 
-    protected function sortByPriority(): void
+    protected function sortSidebarGroupsByLowestPriority(): void
     {
         // While the items accessor sorts the items upon retrieval,
         // we do an initial sorting here to order any groups.

From ed1e32a452330fb34ac1fdb6fa41bb52d1a0a08a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:49:13 +0100
Subject: [PATCH 0624/4023] Break out return expression

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 80de191640c..ed304d1f0a1 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -85,7 +85,11 @@ protected function usesGroups(): bool
 
     protected function canAddRoute(Route $route): bool
     {
-        return $route->getPage()->showInNavigation();
+        if (! $route->getPage()->showInNavigation()) {
+            return false;
+        }
+
+        return true;
     }
 
     protected function canGroupRoute(Route $route): bool

From ed5d0730c7def57ff342edba0d96ff401f8f0bf2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 19:50:00 +0100
Subject: [PATCH 0625/4023] Merge child method into parent block

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 5 +++++
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 --------
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index ed304d1f0a1..bee751211f3 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -89,6 +89,11 @@ protected function canAddRoute(Route $route): bool
             return false;
         }
 
+        if ($this->generatesSidebar) {
+            // Since the index page is linked in the header, we don't want it in the sidebar
+            return ! $route->is(DocumentationPage::homeRouteName());
+        }
+
         return true;
     }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index bb596fc456d..6d70a536159 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 
 use function collect;
@@ -37,13 +36,6 @@ protected function generate(): void
         $this->sortSidebarGroupsByLowestPriority();
     }
 
-    protected function canAddRoute(Route $route): bool
-    {
-        return parent::canAddRoute($route)
-            // Since the index page is linked in the header, we don't want it in the sidebar
-            && ! $route->is(DocumentationPage::homeRouteName());
-    }
-
     protected function sortSidebarGroupsByLowestPriority(): void
     {
         // While the items accessor sorts the items upon retrieval,

From 85674518281f4e9cff66599cf295bebc6a89aa06 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:00:53 +0100
Subject: [PATCH 0626/4023] Merge child method into parent block

---
 .../Features/Navigation/BaseMenuGenerator.php          |  7 +++++--
 .../Navigation/GeneratesMainNavigationMenu.php         | 10 ----------
 2 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index bee751211f3..214dc370fdc 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -92,9 +92,12 @@ protected function canAddRoute(Route $route): bool
         if ($this->generatesSidebar) {
             // Since the index page is linked in the header, we don't want it in the sidebar
             return ! $route->is(DocumentationPage::homeRouteName());
+        } else {
+            // While we for the most part can rely on the navigation visibility state provided by the navigation data factory,
+            // we need to make an exception for documentation pages, which generally have a visible state, as the data is
+            // also used in the sidebar. But we only want the documentation index page to be in the main navigation.
+            return ! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName());
         }
-
-        return true;
     }
 
     protected function canGroupRoute(Route $route): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 00503a07751..13a80ea62fa 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,7 +6,6 @@
 
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
-use Hyde\Pages\DocumentationPage;
 
 use function collect;
 
@@ -27,15 +26,6 @@ protected function generate(): void
         });
     }
 
-    protected function canAddRoute(Route $route): bool
-    {
-        return parent::canAddRoute($route)
-            // While we for the most part can rely on the navigation visibility state provided by the navigation data factory,
-            // we need to make an exception for documentation pages, which generally have a visible state, as the data is
-            // also used in the sidebar. But we only want the documentation index page to be in the main navigation.
-            && (! $route->getPage() instanceof DocumentationPage || $route->is(DocumentationPage::homeRouteName()));
-    }
-
     protected function canGroupRoute(Route $route): bool
     {
         return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;

From 3ec2a3aa49bed13c9c279a7cfde563cbd2f440de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:03:59 +0100
Subject: [PATCH 0627/4023] Break out return expression

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 214dc370fdc..ccf1a50bede 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -102,7 +102,11 @@ protected function canAddRoute(Route $route): bool
 
     protected function canGroupRoute(Route $route): bool
     {
-        return $this->usesGroups;
+        if (! $this->usesGroups) {
+            return false;
+        }
+
+        return true;
     }
 
     protected function addRouteToGroup(Route $route): void

From ea9305e42877293f7d7f2ac54d74c2b4ed221db4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:04:44 +0100
Subject: [PATCH 0628/4023] Merge child method into parent block

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php | 4 ++++
 .../Features/Navigation/GeneratesMainNavigationMenu.php     | 6 ------
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index ccf1a50bede..c37a13b0126 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -106,6 +106,10 @@ protected function canGroupRoute(Route $route): bool
             return false;
         }
 
+        if (! $this->generatesSidebar) {
+            return $route->getPage()->navigationMenuGroup() !== null;
+        }
+
         return true;
     }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 13a80ea62fa..fec562b9b76 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use Hyde\Support\Models\Route;
 
 use function collect;
 
@@ -25,9 +24,4 @@ protected function generate(): void
             $this->items->push($item);
         });
     }
-
-    protected function canGroupRoute(Route $route): bool
-    {
-        return parent::canGroupRoute($route) && $route->getPage()->navigationMenuGroup() !== null;
-    }
 }

From e9aac1c7b85c0848fa7d0d111bfb04360ce5b238 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:08:44 +0100
Subject: [PATCH 0629/4023] Add todo

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 6d70a536159..d318b8d0d50 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -50,6 +50,8 @@ protected function sortSidebarGroupsByLowestPriority(): void
 
     protected function getLowestPriorityInGroup(NavItem $item): int
     {
+        // Todo: Could actually be moved to the NavItem accessor
+
         return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
     }
 }

From 59a3cc4f5923a28cc40b9b932fc3ae698476fb47 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:12:49 +0100
Subject: [PATCH 0630/4023] Move logic to instance accessor

---
 .../GeneratesDocumentationSidebarMenu.php           | 13 +------------
 .../src/Framework/Features/Navigation/NavItem.php   |  7 +++++++
 packages/framework/tests/Unit/NavItemTest.php       |  2 +-
 3 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index d318b8d0d50..7e041eca0be 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -6,8 +6,6 @@
 
 use Hyde\Pages\DocumentationPage;
 
-use function collect;
-
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -42,16 +40,7 @@ protected function sortSidebarGroupsByLowestPriority(): void
         // we do an initial sorting here to order any groups.
 
         $this->items = $this->items->sortBy(function (NavItem $item): int {
-            return $item->hasChildren()
-                ? $this->getLowestPriorityInGroup($item)
-                : $item->getPriority();
+            return $item->getPriority();
         })->values();
     }
-
-    protected function getLowestPriorityInGroup(NavItem $item): int
-    {
-        // Todo: Could actually be moved to the NavItem accessor
-
-        return collect($item->getChildren())->min(fn (NavItem $child): int => $child->getPriority());
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ffbb2ac6234..309271bd21e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -11,6 +11,7 @@
 use Stringable;
 use Hyde\Support\Models\ExternalRoute;
 
+use function collect;
 use function is_string;
 
 /**
@@ -135,9 +136,15 @@ public function getLabel(): string
 
     /**
      * Get the priority to determine the order of the navigation item.
+     *
+     * For dropdowns, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
      */
     public function getPriority(): int
     {
+        if ($this->hasChildren()) {
+            return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
+        }
+
         return $this->priority;
     }
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index f2caf94538c..68145381e30 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -278,7 +278,7 @@ public function testDropdownFacadeWithChildren()
 
         $item = NavItem::dropdown('foo', $children);
         $this->assertSame($children, $item->getChildren());
-        $this->assertSame(999, $item->getPriority());
+        $this->assertSame(500, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()

From df2859546674a221f123152e637f4d3843cd2d09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:17:31 +0100
Subject: [PATCH 0631/4023] Initial sorting is now no longer needed

Thanks to https://github.com/hydephp/develop/commit/59a3cc4f5923a28cc40b9b932fc3ae698476fb47
---
 .../Navigation/GeneratesDocumentationSidebarMenu.php | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 7e041eca0be..2a56a4cd6ed 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -30,17 +30,5 @@ protected function generate(): void
         if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
             $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
         }
-
-        $this->sortSidebarGroupsByLowestPriority();
-    }
-
-    protected function sortSidebarGroupsByLowestPriority(): void
-    {
-        // While the items accessor sorts the items upon retrieval,
-        // we do an initial sorting here to order any groups.
-
-        $this->items = $this->items->sortBy(function (NavItem $item): int {
-            return $item->getPriority();
-        })->values();
     }
 }

From b70045e1779c591d47fca5faf201decc14a6a8cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:39:03 +0100
Subject: [PATCH 0632/4023] Refactor to move post-generation logic to base
 class

---
 .../Features/Navigation/BaseMenuGenerator.php      | 13 +++++++++++++
 .../GeneratesDocumentationSidebarMenu.php          | 12 ------------
 .../Navigation/GeneratesMainNavigationMenu.php     | 14 +-------------
 3 files changed, 14 insertions(+), 25 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index c37a13b0126..504bcf1680f 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -14,6 +14,7 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function filled;
+use function collect;
 use function strtolower;
 
 /**
@@ -69,6 +70,18 @@ protected function generate(): void
                 }
             }
         });
+
+        if ($this->generatesSidebar) {
+            // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
+            if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
+                $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
+            }
+        } else {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
+                // Since these were added explicitly by the user, we can assume they should always be shown
+                $this->items->push($item);
+            });
+        }
     }
 
     protected function usesGroups(): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 2a56a4cd6ed..d2245aa6893 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Pages\DocumentationPage;
-
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -21,14 +19,4 @@ public static function handle(): DocumentationSidebar
 
         return new DocumentationSidebar($menu->items);
     }
-
-    protected function generate(): void
-    {
-        parent::generate();
-
-        // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
-        if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-            $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
-        }
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index fec562b9b76..fc22addb6f2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -4,10 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
-
-use function collect;
-
 /**
  * @experimental This class may change significantly before its release.
  *
@@ -15,13 +11,5 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    protected function generate(): void
-    {
-        parent::generate();
-
-        collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
-            // Since these were added explicitly by the user, we can assume they should always be shown
-            $this->items->push($item);
-        });
-    }
+    //
 }

From c7459fb41f7314e195d3d13bffc6eb7d3d889d06 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:41:08 +0100
Subject: [PATCH 0633/4023] Move entrypoint to child

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php  | 9 +--------
 .../Features/Navigation/GeneratesMainNavigationMenu.php  | 9 ++++++++-
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 504bcf1680f..9bf8ae7591a 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -50,14 +50,7 @@ protected function __construct(string $menuType)
         $this->usesGroups = $this->usesGroups();
     }
 
-    public static function handle(): NavigationMenu
-    {
-        $menu = new static(NavigationMenu::class);
-
-        $menu->generate();
-
-        return new NavigationMenu($menu->items);
-    }
+    abstract public static function handle(): NavigationMenu;
 
     protected function generate(): void
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index fc22addb6f2..0190480ee04 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,5 +11,12 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    //
+    public static function handle(): NavigationMenu
+    {
+        $menu = new static(NavigationMenu::class);
+
+        $menu->generate();
+
+        return new NavigationMenu($menu->items);
+    }
 }

From f92c1d1edd60dac52068fdc0bf635175cf9699e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:41:47 +0100
Subject: [PATCH 0634/4023] Revert "Move entrypoint to child"

This reverts commit c7459fb41f7314e195d3d13bffc6eb7d3d889d06.
---
 .../Framework/Features/Navigation/BaseMenuGenerator.php  | 9 ++++++++-
 .../Features/Navigation/GeneratesMainNavigationMenu.php  | 9 +--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 9bf8ae7591a..504bcf1680f 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -50,7 +50,14 @@ protected function __construct(string $menuType)
         $this->usesGroups = $this->usesGroups();
     }
 
-    abstract public static function handle(): NavigationMenu;
+    public static function handle(): NavigationMenu
+    {
+        $menu = new static(NavigationMenu::class);
+
+        $menu->generate();
+
+        return new NavigationMenu($menu->items);
+    }
 
     protected function generate(): void
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0190480ee04..fc22addb6f2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,12 +11,5 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    public static function handle(): NavigationMenu
-    {
-        $menu = new static(NavigationMenu::class);
-
-        $menu->generate();
-
-        return new NavigationMenu($menu->items);
-    }
+    //
 }

From 372ee5377ff1f1102e50cbbd0f13d5803d95d790 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:42:03 +0100
Subject: [PATCH 0635/4023] Copy entrypoint to child

---
 .../Features/Navigation/GeneratesMainNavigationMenu.php  | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index fc22addb6f2..0190480ee04 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,5 +11,12 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    //
+    public static function handle(): NavigationMenu
+    {
+        $menu = new static(NavigationMenu::class);
+
+        $menu->generate();
+
+        return new NavigationMenu($menu->items);
+    }
 }

From 5aa4b4e6d6e33329a408a8f65068b1b6c5346665 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:45:11 +0100
Subject: [PATCH 0636/4023] Make base entrypoint dynamic

---
 .../Framework/Features/Navigation/BaseMenuGenerator.php   | 7 ++++---
 .../Navigation/GeneratesDocumentationSidebarMenu.php      | 8 ++------
 .../Features/Navigation/GeneratesMainNavigationMenu.php   | 8 ++------
 3 files changed, 8 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 504bcf1680f..b07ac46a1e7 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -50,13 +50,14 @@ protected function __construct(string $menuType)
         $this->usesGroups = $this->usesGroups();
     }
 
-    public static function handle(): NavigationMenu
+    /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
+    public static function handle(string $menuType): NavigationMenu
     {
-        $menu = new static(NavigationMenu::class);
+        $menu = new static($menuType);
 
         $menu->generate();
 
-        return new NavigationMenu($menu->items);
+        return new $menuType($menu->items);
     }
 
     protected function generate(): void
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index d2245aa6893..08b6ca3b4e2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -11,12 +11,8 @@
  */
 class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
-    public static function handle(): DocumentationSidebar
+    public static function handle(string $menuType = DocumentationSidebar::class): DocumentationSidebar
     {
-        $menu = new static(DocumentationSidebar::class);
-
-        $menu->generate();
-
-        return new DocumentationSidebar($menu->items);
+        return parent::handle($menuType);
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 0190480ee04..4bd8014ce1a 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,12 +11,8 @@
  */
 class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
-    public static function handle(): NavigationMenu
+    public static function handle(string $menuType = NavigationMenu::class): NavigationMenu
     {
-        $menu = new static(NavigationMenu::class);
-
-        $menu->generate();
-
-        return new NavigationMenu($menu->items);
+        return parent::handle($menuType);
     }
 }

From 8d16f180397539526d8942a488c8eb25d261bdc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:46:08 +0100
Subject: [PATCH 0637/4023] Union type auxiliary return type

---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index b07ac46a1e7..9b3ca985b8f 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -51,7 +51,7 @@ protected function __construct(string $menuType)
     }
 
     /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
-    public static function handle(string $menuType): NavigationMenu
+    public static function handle(string $menuType): NavigationMenu|DocumentationSidebar
     {
         $menu = new static($menuType);
 

From 5a16f7ad753fcb1e3c423adcd134ca14e62798f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:49:13 +0100
Subject: [PATCH 0638/4023] Revert "Make class abstract"

This reverts commit d6649f0526cf036433992db959fefa8226b05909.
---
 .../src/Framework/Features/Navigation/BaseMenuGenerator.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
index 9b3ca985b8f..357e68618a9 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
@@ -20,7 +20,7 @@
 /**
  * @experimental This class may change significantly before its release.
  */
-abstract class BaseMenuGenerator
+class BaseMenuGenerator
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;

From 5fca759959846ac624ee41726b61227b2be361ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:49:47 +0100
Subject: [PATCH 0639/4023] Replace parent syntax with direct parent call

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 08b6ca3b4e2..95fb06eb6b4 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -13,6 +13,6 @@ class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
     public static function handle(string $menuType = DocumentationSidebar::class): DocumentationSidebar
     {
-        return parent::handle($menuType);
+        return BaseMenuGenerator::handle($menuType);
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 4bd8014ce1a..44d02e2af42 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,6 +13,6 @@ class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
     public static function handle(string $menuType = NavigationMenu::class): NavigationMenu
     {
-        return parent::handle($menuType);
+        return BaseMenuGenerator::handle($menuType);
     }
 }

From 1b85b6857867dd1db58274af9f959326d976c15d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:50:51 +0100
Subject: [PATCH 0640/4023] Hardcode call type

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 95fb06eb6b4..a4bcd561a30 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -13,6 +13,6 @@ class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
 {
     public static function handle(string $menuType = DocumentationSidebar::class): DocumentationSidebar
     {
-        return BaseMenuGenerator::handle($menuType);
+        return BaseMenuGenerator::handle(DocumentationSidebar::class);
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 44d02e2af42..29789c4558b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -13,6 +13,6 @@ class GeneratesMainNavigationMenu extends BaseMenuGenerator
 {
     public static function handle(string $menuType = NavigationMenu::class): NavigationMenu
     {
-        return BaseMenuGenerator::handle($menuType);
+        return BaseMenuGenerator::handle(NavigationMenu::class);
     }
 }

From 4f1bedd01b3134823fb6100b68b9f4c4c69054f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:52:13 +0100
Subject: [PATCH 0641/4023] Generators no longer need to extend base generator

All logic has been moved to the base class
---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a4bcd561a30..f8719c3648f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -9,7 +9,7 @@
  *
  * @see \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  */
-class GeneratesDocumentationSidebarMenu extends BaseMenuGenerator
+class GeneratesDocumentationSidebarMenu
 {
     public static function handle(string $menuType = DocumentationSidebar::class): DocumentationSidebar
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 29789c4558b..f3b3b2d290f 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -9,7 +9,7 @@
  *
  * @see \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  */
-class GeneratesMainNavigationMenu extends BaseMenuGenerator
+class GeneratesMainNavigationMenu
 {
     public static function handle(string $menuType = NavigationMenu::class): NavigationMenu
     {

From 5bfa158a21b2798e4e0c12f88f492c1a25040c1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:53:24 +0100
Subject: [PATCH 0642/4023] Remove unused parameters

Was only needed for parent compatibility
---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index f8719c3648f..200fceda1b5 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -11,7 +11,7 @@
  */
 class GeneratesDocumentationSidebarMenu
 {
-    public static function handle(string $menuType = DocumentationSidebar::class): DocumentationSidebar
+    public static function handle(): DocumentationSidebar
     {
         return BaseMenuGenerator::handle(DocumentationSidebar::class);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index f3b3b2d290f..261a851264d 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,7 +11,7 @@
  */
 class GeneratesMainNavigationMenu
 {
-    public static function handle(string $menuType = NavigationMenu::class): NavigationMenu
+    public static function handle(): NavigationMenu
     {
         return BaseMenuGenerator::handle(NavigationMenu::class);
     }

From 22b3cac7a95ba19ae194eabf00a3505f0d0b7bd5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:53:36 +0100
Subject: [PATCH 0643/4023] Remove crosslinks

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 --
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 --
 2 files changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index 200fceda1b5..a3b851e2ec3 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -6,8 +6,6 @@
 
 /**
  * @experimental This class may change significantly before its release.
- *
- * @see \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  */
 class GeneratesDocumentationSidebarMenu
 {
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 261a851264d..4e7fda16843 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -6,8 +6,6 @@
 
 /**
  * @experimental This class may change significantly before its release.
- *
- * @see \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  */
 class GeneratesMainNavigationMenu
 {

From 84bec87842caf66e584c9b833419fdbcd26d7b7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:54:19 +0100
Subject: [PATCH 0644/4023] Rename base generator class for it to be standalone

---
 .../Features/Navigation/GeneratesDocumentationSidebarMenu.php   | 2 +-
 .../Features/Navigation/GeneratesMainNavigationMenu.php         | 2 +-
 .../{BaseMenuGenerator.php => NavigationMenuGenerator.php}      | 2 +-
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{BaseMenuGenerator.php => NavigationMenuGenerator.php} (99%)

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index a3b851e2ec3..ee07cac9ed3 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -11,6 +11,6 @@ class GeneratesDocumentationSidebarMenu
 {
     public static function handle(): DocumentationSidebar
     {
-        return BaseMenuGenerator::handle(DocumentationSidebar::class);
+        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index 4e7fda16843..c8c43230012 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -11,6 +11,6 @@ class GeneratesMainNavigationMenu
 {
     public static function handle(): NavigationMenu
     {
-        return BaseMenuGenerator::handle(NavigationMenu::class);
+        return NavigationMenuGenerator::handle(NavigationMenu::class);
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
similarity index 99%
rename from packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
rename to packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 357e68618a9..45c6986ab99 100644
--- a/packages/framework/src/Framework/Features/Navigation/BaseMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -20,7 +20,7 @@
 /**
  * @experimental This class may change significantly before its release.
  */
-class BaseMenuGenerator
+class NavigationMenuGenerator
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index a79b92703a9..b0de676cf72 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -25,7 +25,7 @@
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
  *
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
- * @covers \Hyde\Framework\Features\Navigation\BaseMenuGenerator
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu

From e06f1c027debcabe318a223b9d34f89e91f188f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:55:21 +0100
Subject: [PATCH 0645/4023] Inline `GeneratesDocumentationSidebarMenu::handle`
 method

---
 .../src/Foundation/Providers/NavigationServiceProvider.php   | 5 +++--
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 2 +-
 .../Navigation/GeneratesDocumentationSidebarMenu.php         | 5 +----
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 +++--
 4 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 6b10ab8d13f..2ef94f373ab 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -7,8 +7,9 @@
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
 use Hyde\Framework\Features\Navigation\NavigationManager;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
-use Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu;
 
 class NavigationServiceProvider extends ServiceProvider
 {
@@ -22,7 +23,7 @@ public function register(): void
 
         $this->app->make(HydeKernel::class)->booted(function () {
             $this->app->make(NavigationManager::class)->registerMenu('main', GeneratesMainNavigationMenu::handle());
-            $this->app->make(NavigationManager::class)->registerMenu('sidebar', GeneratesDocumentationSidebarMenu::handle());
+            $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index cb9433ed093..03829479837 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -18,7 +18,7 @@ class DocumentationSidebar extends NavigationMenu
     /** @deprecated Will be moved to an action */
     public static function create(): static
     {
-        return GeneratesDocumentationSidebarMenu::handle();
+        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
 
     public function hasGroups(): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
index ee07cac9ed3..07c3d77b86b 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
@@ -9,8 +9,5 @@
  */
 class GeneratesDocumentationSidebarMenu
 {
-    public static function handle(): DocumentationSidebar
-    {
-        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
-    }
+    //
 }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index b0de676cf72..cfcb1d98bfc 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,8 +18,9 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
-use Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu;
 
 /**
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
@@ -1246,7 +1247,7 @@ class AssertableNavigationMenu
     public function __construct(TestCase $test, $sidebar = false)
     {
         $this->items = $sidebar
-            ? GeneratesDocumentationSidebarMenu::handle()->getItems()
+            ? NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
             : GeneratesMainNavigationMenu::handle()->getItems();
 
         $this->test = $test;

From eb5d79eea61906b9341e6ddbb7f5fdc276196e00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:56:48 +0100
Subject: [PATCH 0646/4023] Inline `GeneratesMainNavigationMenu::handle` method

---
 .../src/Foundation/Providers/NavigationServiceProvider.php   | 4 ++--
 .../Features/Navigation/GeneratesMainNavigationMenu.php      | 5 +----
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 4 ++--
 packages/framework/tests/Feature/NavigationMenuTest.php      | 4 ++--
 4 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 2ef94f373ab..4e62984f336 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -6,10 +6,10 @@
 
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
-use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 class NavigationServiceProvider extends ServiceProvider
 {
@@ -22,7 +22,7 @@ public function register(): void
         $this->app->alias(NavigationManager::class, 'navigation');
 
         $this->app->make(HydeKernel::class)->booted(function () {
-            $this->app->make(NavigationManager::class)->registerMenu('main', GeneratesMainNavigationMenu::handle());
+            $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(NavigationMenu::class));
             $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
index c8c43230012..99e50dce6d5 100644
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
@@ -9,8 +9,5 @@
  */
 class GeneratesMainNavigationMenu
 {
-    public static function handle(): NavigationMenu
-    {
-        return NavigationMenuGenerator::handle(NavigationMenu::class);
-    }
+    //
 }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index cfcb1d98bfc..8c17b45ce9a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,9 +18,9 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
-use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
 
 /**
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
@@ -1248,7 +1248,7 @@ public function __construct(TestCase $test, $sidebar = false)
     {
         $this->items = $sidebar
             ? NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
-            : GeneratesMainNavigationMenu::handle()->getItems();
+            : NavigationMenuGenerator::handle(NavigationMenu::class)->getItems();
 
         $this->test = $test;
     }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 15c00178129..7dfce49320d 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -12,7 +12,7 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Collection;
-use Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
@@ -271,6 +271,6 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
 
     protected function createNavigationMenu(): NavigationMenu
     {
-        return GeneratesMainNavigationMenu::handle();
+        return NavigationMenuGenerator::handle(NavigationMenu::class);
     }
 }

From f1786340742ec5bee60099f454013f16ba15e07f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:58:40 +0100
Subject: [PATCH 0647/4023] Remove coverage annotations for old generators

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8c17b45ce9a..c555fc9890a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -28,8 +28,6 @@
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
- * @covers \Hyde\Framework\Features\Navigation\GeneratesDocumentationSidebarMenu
- * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  */
 class AutomaticNavigationConfigurationsTest extends TestCase

From 93056d3ffeeca585245b8a5e93ac75e1503965d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:59:24 +0100
Subject: [PATCH 0648/4023] Remove coverage annotation for old generator

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 7dfce49320d..22b32988d6b 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -15,7 +15,6 @@
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\GeneratesMainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  *
  * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest

From 647aec057c83cf3b08dc188361d83c4e2ef5a1be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 20:59:50 +0100
Subject: [PATCH 0649/4023] Delete GeneratesDocumentationSidebarMenu.php

---
 .../GeneratesDocumentationSidebarMenu.php           | 13 -------------
 1 file changed, 13 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
deleted file mode 100644
index 07c3d77b86b..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesDocumentationSidebarMenu.php
+++ /dev/null
@@ -1,13 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/**
- * @experimental This class may change significantly before its release.
- */
-class GeneratesDocumentationSidebarMenu
-{
-    //
-}

From 0668a817aee0e90dedaa1cdf3a28365c6acd7ef6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:00:01 +0100
Subject: [PATCH 0650/4023] Delete GeneratesMainNavigationMenu.php

---
 .../Navigation/GeneratesMainNavigationMenu.php      | 13 -------------
 1 file changed, 13 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php

diff --git a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
deleted file mode 100644
index 99e50dce6d5..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/GeneratesMainNavigationMenu.php
+++ /dev/null
@@ -1,13 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/**
- * @experimental This class may change significantly before its release.
- */
-class GeneratesMainNavigationMenu
-{
-    //
-}

From 1185f289224dd6dca3690685d22db689a0ad4f37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:03:03 +0100
Subject: [PATCH 0651/4023] Assert the type is one of two supported menus

The ternary logic used in the class requires that only one of these two classes are used
---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 45c6986ab99..93dd3fd7b3a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -37,6 +37,8 @@ class NavigationMenuGenerator
     /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
     protected function __construct(string $menuType)
     {
+        assert(in_array($menuType, [NavigationMenu::class, DocumentationSidebar::class]));
+
         $this->menuType = $menuType;
 
         $this->items = new Collection();

From cc2acab7ad506c0e9881e30c4ee0a060585e6030 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:03:16 +0100
Subject: [PATCH 0652/4023] Import used functions

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 93dd3fd7b3a..55366fc2561 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -14,7 +14,9 @@
 use Hyde\Foundation\Kernel\RouteCollection;
 
 use function filled;
+use function assert;
 use function collect;
+use function in_array;
 use function strtolower;
 
 /**

From 1d77ae10351d9899f480d3554fad983f2e616d81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:05:38 +0100
Subject: [PATCH 0653/4023] Cover the new generator class

---
 packages/framework/tests/Feature/NavigationMenuTest.php          | 1 +
 .../tests/Feature/Services/DocumentationSidebarTest.php          | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 22b32988d6b..1114c5735d4 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -16,6 +16,7 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  *
  * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
  */
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index c7d79c3faad..6cecf8bfb13 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -18,6 +18,7 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Factories\Concerns\HasFactory
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavItem

From ca328ccd00f7282d7c02cd217ead5af12ead6738 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:05:50 +0100
Subject: [PATCH 0654/4023] Cover the main menu class

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c555fc9890a..d16bf60aee3 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -28,6 +28,7 @@
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  */
 class AutomaticNavigationConfigurationsTest extends TestCase

From 447b65bb419716689e9f7946cb82c2076a097f8d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:17:25 +0100
Subject: [PATCH 0655/4023] Add additional priority test

---
 .../AutomaticNavigationConfigurationsTest.php | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index d16bf60aee3..e50c9015afc 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1028,6 +1028,35 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroup()
         ]);
     }
 
+    public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroupUnlessGroupPriorityIsLower()
+    {
+        $this->assertSidebarEquals([
+            'A', 'B', 'C',
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 10]),
+            new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 20]),
+            new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 30]),
+        ]);
+
+        $this->assertSidebarEquals([
+            'C', 'B', 'A',
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 30]),
+            new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 20]),
+            new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 10]),
+        ]);
+
+        config(['docs.sidebar_order' => ['a' => 5]]);
+
+        $this->assertSidebarEquals([
+            'A', 'C', 'B',
+        ], [
+            new DocumentationPage('foo', ['navigation.group' => 'a', 'navigation.priority' => 30]),
+            new DocumentationPage('bar', ['navigation.group' => 'b', 'navigation.priority' => 20]),
+            new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 10]),
+        ]);
+    }
+
     public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped()
     {
         $this->assertSidebarEquals([

From 097f69b2256f8f8fc37071d21b1d141ec72cb7d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:22:44 +0100
Subject: [PATCH 0656/4023] Only apply dynamic priority for sidebar groups

---
 .../framework/src/Framework/Features/Navigation/NavItem.php  | 5 +++--
 packages/framework/tests/Unit/NavItemTest.php                | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 309271bd21e..d8156963f27 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -137,11 +138,11 @@ public function getLabel(): string
     /**
      * Get the priority to determine the order of the navigation item.
      *
-     * For dropdowns, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
+     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren()) {
+        if ($this->hasChildren() && $this->children[0]->getDestination()->getPage() instanceof DocumentationPage) {
             return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 68145381e30..f2caf94538c 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -278,7 +278,7 @@ public function testDropdownFacadeWithChildren()
 
         $item = NavItem::dropdown('foo', $children);
         $this->assertSame($children, $item->getChildren());
-        $this->assertSame(500, $item->getPriority());
+        $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()

From a1e66bb2fd3b6f8794c5bf1127999e70e46c0979 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:27:05 +0100
Subject: [PATCH 0657/4023] Replace instanceof with class constant comparison

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d8156963f27..37c19993917 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -142,7 +142,7 @@ public function getLabel(): string
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && $this->children[0]->getDestination()->getPage() instanceof DocumentationPage) {
+        if ($this->hasChildren() && $this->children[0]->getDestination()->getPageClass() === DocumentationPage::class) {
             return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 

From 120777beeea9fc821ab4dcae2e0f228a182819e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:34:36 +0100
Subject: [PATCH 0658/4023] Import used function

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 37c19993917..fbca2681c6c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -12,6 +12,7 @@
 use Stringable;
 use Hyde\Support\Models\ExternalRoute;
 
+use function min;
 use function collect;
 use function is_string;
 

From 6a3d8fb86c83cf948beec90a6822e90fb5ad8147 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 21 Feb 2024 21:38:21 +0100
Subject: [PATCH 0659/4023] Add design note to todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index fbca2681c6c..69b8b18bac3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -213,6 +213,6 @@ protected static function normalizeGroupKey(?string $group): ?string
 
     protected static function makeIdentifier(string $label): string
     {
-        return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier
+        return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier (start by making a test to see if it's even possible to add a differing label)
     }
 }

From 7d59d30d750918ddfb485430c874e85bebd35723 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 11:54:15 +0100
Subject: [PATCH 0660/4023] Test can mix subdirectory dropdowns with front
 matter dropdowns

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e50c9015afc..cb57c06cc37 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -532,6 +532,18 @@ public function testConflictingSubdirectoryAndFrontMatterDropdownConfigurationGi
         ]);
     }
 
+    public function testCanMixSubdirectoryDropdownsWithFrontMatterDropdowns()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        $this->assertMenuEquals([
+            ['label' => 'Foo', 'children' => ['Bar', 'Baz']],
+        ], [
+            new MarkdownPage('foo/bar'),
+            new MarkdownPage('foo/baz', ['navigation.group' => 'foo']),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()

From 04718d4f59faca75487a7d601ca7ef997c2222dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 11:55:32 +0100
Subject: [PATCH 0661/4023] Test can mix subdirectory groups with front matter
 groups

---
 .../Feature/AutomaticNavigationConfigurationsTest.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index cb57c06cc37..14fc325dd9b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1080,6 +1080,16 @@ public function testAllSidebarItemsArePlacedInGroupsWhenAtLeastOneItemIsGrouped(
         ]);
     }
 
+    public function testSidebarCanMixSubdirectoryGroupsWithFrontMatterGroups()
+    {
+        $this->assertSidebarEquals([
+            ['label' => 'Foo', 'children' => ['Bar', 'Baz']],
+        ], [
+            new DocumentationPage('foo/bar'),
+            new DocumentationPage('foo/baz', ['navigation.group' => 'foo']),
+        ]);
+    }
+
     // Priority tests
 
     public function testMainNavigationDropdownPriorityCanBeSetInConfig()

From ac4e6892bfd883730dcfac5ca9c11c925380bf38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 12:07:20 +0100
Subject: [PATCH 0662/4023] Inline deprecated helper method

---
 .../Navigation/DocumentationSidebar.php       |  6 --
 .../Services/DocumentationSidebarTest.php     | 65 ++++++++++---------
 .../tests/Feature/SidebarViewTest.php         | 11 ++--
 3 files changed, 39 insertions(+), 43 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 03829479837..f0943a3b088 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -15,12 +15,6 @@ class DocumentationSidebar extends NavigationMenu
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    /** @deprecated Will be moved to an action */
-    public static function create(): static
-    {
-        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
-    }
-
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 6cecf8bfb13..b83d3226c83 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -15,6 +15,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\Facades\File;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
@@ -41,7 +42,7 @@ protected function tearDown(): void
 
     public function testSidebarCanBeCreated()
     {
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
 
         $this->assertInstanceOf(DocumentationSidebar::class, $sidebar);
     }
@@ -50,7 +51,7 @@ public function testSidebarItemsAreAddedAutomatically()
     {
         $this->createTestFiles();
 
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
 
         $this->assertCount(5, $sidebar->getItems());
     }
@@ -60,7 +61,7 @@ public function testIndexPageIsRemovedFromSidebar()
         $this->createTestFiles();
         Filesystem::touch('_docs/index.md');
 
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         $this->assertCount(5, $sidebar->getItems());
     }
 
@@ -69,7 +70,7 @@ public function testFilesWithFrontMatterHiddenSetToTrueAreRemovedFromSidebar()
         $this->createTestFiles();
         File::put(Hyde::path('_docs/test.md'), "---\nnavigation:\n    hidden: true\n---\n\n# Foo");
 
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         $this->assertCount(5, $sidebar->getItems());
     }
 
@@ -86,7 +87,7 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
                 NavItem::fromRoute(Routes::get('docs/b'), priority: 999),
                 NavItem::fromRoute(Routes::get('docs/c'), priority: 999),
             ]),
-            DocumentationSidebar::create()->getItems()
+            NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
 
@@ -107,7 +108,7 @@ public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
                 NavItem::fromRoute(Routes::get('docs/b'), priority: 250 + 251),
                 NavItem::fromRoute(Routes::get('docs/a'), priority: 250 + 252),
             ]),
-            DocumentationSidebar::create()->getItems()
+            NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
 
@@ -115,7 +116,7 @@ public function testSidebarItemPriorityCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.priority' => 25]);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->getPriority());
+        $this->assertEquals(25, NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getPriority());
     }
 
     public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
@@ -124,7 +125,7 @@ public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
 
         Config::set('docs.sidebar_order', ['foo']);
 
-        $this->assertEquals(25, DocumentationSidebar::create()->getItems()->first()->getPriority());
+        $this->assertEquals(25, NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getPriority());
     }
 
     public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
@@ -146,26 +147,26 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
                 NavItem::fromRoute(Routes::get('docs/second'), priority: 250 + 252),
                 NavItem::fromRoute(Routes::get('docs/third'), priority: 250 + 300),
             ]),
-            DocumentationSidebar::create()->getItems()
+            NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
 
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->assertEquals('bar', collect(DocumentationSidebar::create()->getItems()->first()->getChildren())->first()->getGroup());
+        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getChildren())->first()->getGroup());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
     {
-        $this->assertFalse(DocumentationSidebar::create()->hasGroups());
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->hasGroups());
     }
 
     public function testHasGroupsReturnsTrueWhenThereAreGroups()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
 
-        $this->assertTrue(DocumentationSidebar::create()->hasGroups());
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->hasGroups());
     }
 
     public function testHasGroupsReturnsTrueWhenThereAreMultipleGroups()
@@ -173,7 +174,7 @@ public function testHasGroupsReturnsTrueWhenThereAreMultipleGroups()
         $this->makePage('foo', ['navigation.group' => 'bar']);
         $this->makePage('bar', ['navigation.group' => 'baz']);
 
-        $this->assertTrue(DocumentationSidebar::create()->hasGroups());
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->hasGroups());
     }
 
     public function testHasGroupsReturnsTrueWhenThereAreMultipleGroupsMixedWithDefaults()
@@ -182,7 +183,7 @@ public function testHasGroupsReturnsTrueWhenThereAreMultipleGroupsMixedWithDefau
         $this->makePage('bar', ['navigation.group' => 'baz']);
         $this->makePage('baz');
 
-        $this->assertTrue(DocumentationSidebar::create()->hasGroups());
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->hasGroups());
     }
 
     public function testGetItemsInGroupDoesNotIncludeDocsIndex()
@@ -192,26 +193,26 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
 
         $this->assertEquals(
             collect([NavItem::fromRoute(Routes::get('docs/foo'), priority: 999)]),
-            DocumentationSidebar::create()->getItems()
+            NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
 
     public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('bar'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
     }
 
     public function testIsGroupActiveReturnsTrueWhenSuppliedGroupIsActive()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
-        $this->assertTrue(DocumentationSidebar::create()->isGroupActive('foo'));
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
     }
 
     public function testIsGroupActiveReturnsTrueForDifferingCasing()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'Foo Bar']));
-        $this->assertTrue(DocumentationSidebar::create()->isGroupActive('foo-bar'));
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo-bar'));
     }
 
     public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
@@ -222,9 +223,9 @@ public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
         $this->makePage('baz', ['navigation.group' => 'baz']);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertTrue(DocumentationSidebar::create()->isGroupActive('bar'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('foo'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('baz'));
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
     }
 
     public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
@@ -235,9 +236,9 @@ public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
         $this->makePage('baz', ['navigation.group' => 'baz', 'navigation.priority' => 3]);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertTrue(DocumentationSidebar::create()->isGroupActive('foo'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('bar'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('baz'));
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
     }
 
     public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenuSettings()
@@ -248,9 +249,9 @@ public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenu
         $this->makePage('baz', ['navigation.group' => 'baz', 'navigation.priority' => 3]);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('foo'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('bar'));
-        $this->assertTrue(DocumentationSidebar::create()->isGroupActive('baz'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
+        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
     }
 
     public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
@@ -258,7 +259,7 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
         $this->makePage('foo', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
         $this->makePage('bar', ['navigation.group' => 'bar', 'navigation.label' => 'Foo']);
 
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         $this->assertCount(2, $sidebar->getItems());
 
         $this->assertEquals(
@@ -279,7 +280,7 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
         $this->makePage('foo', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
         $this->makePage('bar', ['navigation.group' => 'foo', 'navigation.label' => 'Foo']);
 
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         $this->assertCount(1, $sidebar->getItems());
 
         $this->assertEquals(
@@ -298,13 +299,13 @@ public function testIsGroupActiveForIndexPageWithNoGroups()
         $this->makePage('index');
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertFalse(DocumentationSidebar::create()->isGroupActive('foo'));
+        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
     }
 
     public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
     {
         Filesystem::touch('_docs/index.md');
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
@@ -317,7 +318,7 @@ public function testIndexPageNotAddedToSidebarWhenOtherPagesExist()
     {
         $this->createTestFiles(1);
         Filesystem::touch('_docs/index.md');
-        $sidebar = DocumentationSidebar::create();
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index 2dcd7646d91..deab74d376d 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -11,6 +11,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Contracts\View\View;
 use Throwable;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 use function config;
 use function file_put_contents;
@@ -49,7 +50,7 @@ public function testBaseSidebar()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => DocumentationSidebar::create(),
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
         ]));
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-brand'));
@@ -102,7 +103,7 @@ public function testBaseSidebarWithItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => DocumentationSidebar::create(),
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
         ]));
     }
 
@@ -130,7 +131,7 @@ public function testSidebarWithGroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => DocumentationSidebar::create(),
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 
@@ -162,7 +163,7 @@ public function testSidebarWithNonCollapsibleGroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => DocumentationSidebar::create(),
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 
@@ -187,7 +188,7 @@ public function testSidebarWithMixedGroupedAndUngroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => DocumentationSidebar::create(),
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 

From 7f9b0c6adde2a89525261ed925bb69c66e268098 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 12:12:46 +0100
Subject: [PATCH 0663/4023] Split out base navigation menu class from main menu
 class

---
 .../Providers/NavigationServiceProvider.php   |  4 +--
 .../Navigation/DocumentationSidebar.php       |  1 -
 .../Navigation/MainNavigationMenu.php         | 10 +++++++
 .../Features/Navigation/NavigationMenu.php    |  2 +-
 .../Navigation/NavigationMenuGenerator.php    |  4 +--
 .../AutomaticNavigationConfigurationsTest.php |  6 ++--
 .../tests/Feature/NavigationManagerTest.php   |  6 ++--
 .../tests/Feature/NavigationMenuTest.php      | 10 +++----
 .../tests/Unit/NavigationMenuUnitTest.php     | 28 +++++++++----------
 .../Unit/Views/NavigationBrandViewTest.php    |  4 +--
 10 files changed, 42 insertions(+), 33 deletions(-)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 4e62984f336..857588c3dd3 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -6,7 +6,7 @@
 
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -22,7 +22,7 @@ public function register(): void
         $this->app->alias(NavigationManager::class, 'navigation');
 
         $this->app->make(HydeKernel::class)->booted(function () {
-            $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(NavigationMenu::class));
+            $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(MainNavigationMenu::class));
             $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index f0943a3b088..60bf526c7aa 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -9,7 +9,6 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
-/** @deprecated Use the new NavigationMenu class instead */
 class DocumentationSidebar extends NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
new file mode 100644
index 00000000000..96b228fa967
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class MainNavigationMenu extends NavigationMenu
+{
+    //
+}
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 23e3ba7b3f3..986dd7076be 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -15,7 +15,7 @@
  * @example `$menu = app('navigation')->getMenu('main');` for the main navigation menu.
  * @example `$menu = app('navigation')->getMenu('sidebar');` for the documentation sidebar.
  */
-class NavigationMenu
+abstract class NavigationMenu
 {
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 55366fc2561..bd31784144e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -39,7 +39,7 @@ class NavigationMenuGenerator
     /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
     protected function __construct(string $menuType)
     {
-        assert(in_array($menuType, [NavigationMenu::class, DocumentationSidebar::class]));
+        assert(in_array($menuType, [MainNavigationMenu::class, DocumentationSidebar::class]));
 
         $this->menuType = $menuType;
 
@@ -55,7 +55,7 @@ protected function __construct(string $menuType)
     }
 
     /** @param class-string<\Hyde\Framework\Features\Navigation\NavigationMenu> $menuType */
-    public static function handle(string $menuType): NavigationMenu|DocumentationSidebar
+    public static function handle(string $menuType): MainNavigationMenu|DocumentationSidebar
     {
         $menu = new static($menuType);
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 14fc325dd9b..2c9e9a27288 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,7 +18,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
@@ -28,7 +28,7 @@
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  */
 class AutomaticNavigationConfigurationsTest extends TestCase
@@ -1298,7 +1298,7 @@ public function __construct(TestCase $test, $sidebar = false)
     {
         $this->items = $sidebar
             ? NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
-            : NavigationMenuGenerator::handle(NavigationMenu::class)->getItems();
+            : NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems();
 
         $this->test = $test;
     }
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 97f2c1b83a9..41558e14a69 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -5,7 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Framework\Features\Navigation\NavigationManager;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -17,7 +17,7 @@ public function testCanRegisterMenu()
     {
         $manager = new NavigationManager();
 
-        $menu = $this->createMock(NavigationMenu::class);
+        $menu = $this->createMock(MainNavigationMenu::class);
         $manager->registerMenu('foo', $menu);
 
         $reflection = new \ReflectionClass($manager);
@@ -33,7 +33,7 @@ public function testCanGetMenu()
     {
         $manager = new NavigationManager();
 
-        $menu = $this->createMock(NavigationMenu::class);
+        $menu = $this->createMock(MainNavigationMenu::class);
         $manager->registerMenu('foo', $menu);
 
         $retrievedMenu = $manager->getMenu('foo');
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 1114c5735d4..aed4d880f64 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -7,7 +7,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\TestCase;
@@ -15,7 +15,7 @@
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  *
  * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
@@ -24,7 +24,7 @@ class NavigationMenuTest extends TestCase
 {
     public function testConstructor()
     {
-        $this->assertInstanceOf(NavigationMenu::class, $this->createNavigationMenu());
+        $this->assertInstanceOf(MainNavigationMenu::class, $this->createNavigationMenu());
     }
 
     public function testGenerateMethodCreatesCollectionOfNavItems()
@@ -269,8 +269,8 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
     }
 
-    protected function createNavigationMenu(): NavigationMenu
+    protected function createNavigationMenu(): MainNavigationMenu
     {
-        return NavigationMenuGenerator::handle(NavigationMenu::class);
+        return NavigationMenuGenerator::handle(MainNavigationMenu::class);
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 5242dd9f317..dc935d49329 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -8,10 +8,10 @@
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\NavigationMenuTest
  */
@@ -19,56 +19,56 @@ class NavigationMenuUnitTest extends UnitTestCase
 {
     public function testCanConstruct()
     {
-        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu());
+        $this->assertInstanceOf(MainNavigationMenu::class, new MainNavigationMenu());
     }
 
     public function testCanConstructWithItemsArray()
     {
-        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu($this->getItems()));
+        $this->assertInstanceOf(MainNavigationMenu::class, new MainNavigationMenu($this->getItems()));
     }
 
     public function testCanConstructWithItemsArrayable()
     {
-        $this->assertInstanceOf(NavigationMenu::class, new NavigationMenu(collect($this->getItems())));
+        $this->assertInstanceOf(MainNavigationMenu::class, new MainNavigationMenu(collect($this->getItems())));
     }
 
     public function testGetItemsReturnsCollection()
     {
-        $this->assertInstanceOf(Collection::class, (new NavigationMenu())->getItems());
+        $this->assertInstanceOf(Collection::class, (new MainNavigationMenu())->getItems());
     }
 
     public function testGetItemsReturnsCollectionWhenSuppliedArray()
     {
-        $this->assertInstanceOf(Collection::class, (new NavigationMenu($this->getItems()))->getItems());
+        $this->assertInstanceOf(Collection::class, (new MainNavigationMenu($this->getItems()))->getItems());
     }
 
     public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
     {
-        $this->assertInstanceOf(Collection::class, (new NavigationMenu(collect($this->getItems())))->getItems());
+        $this->assertInstanceOf(Collection::class, (new MainNavigationMenu(collect($this->getItems())))->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
         $items = $this->getItems();
 
-        $this->assertSame($items, (new NavigationMenu($items))->getItems()->all());
+        $this->assertSame($items, (new MainNavigationMenu($items))->getItems()->all());
     }
 
     public function testGetItemsReturnsItemsWhenSuppliedArrayable()
     {
         $items = $this->getItems();
 
-        $this->assertSame($items, (new NavigationMenu(collect($items)))->getItems()->all());
+        $this->assertSame($items, (new MainNavigationMenu(collect($items)))->getItems()->all());
     }
 
     public function testGetItemsReturnsEmptyArrayWhenNoItems()
     {
-        $this->assertSame([], (new NavigationMenu())->getItems()->all());
+        $this->assertSame([], (new MainNavigationMenu())->getItems()->all());
     }
 
     public function testCanAddItems()
     {
-        $menu = new NavigationMenu();
+        $menu = new MainNavigationMenu();
         $item = new NavItem(new ExternalRoute('/'), 'Home');
 
         $menu->add($item);
@@ -79,7 +79,7 @@ public function testCanAddItems()
 
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
-        $menu = new NavigationMenu();
+        $menu = new MainNavigationMenu();
         $item1 = new NavItem(new ExternalRoute('/'), 'Home');
         $item2 = new NavItem(new ExternalRoute('/about'), 'About');
         $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
@@ -93,7 +93,7 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
 
     public function testItemsAreSortedByPriority()
     {
-        $menu = new NavigationMenu();
+        $menu = new MainNavigationMenu();
         $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
         $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
         $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
diff --git a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
index 47fe6c7c640..a12a053b608 100644
--- a/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationBrandViewTest.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
-use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Testing\TestCase;
 
 /**
@@ -22,7 +22,7 @@ protected function setUp(): void
     protected function render(): string
     {
         return view('hyde::components.navigation.navigation-brand', [
-            'navigation' => new NavigationMenu(),
+            'navigation' => new MainNavigationMenu(),
         ])->render();
     }
 

From c9ba7f2f195cb17cd56a06cf60ab0e5d0ea04c14 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 13:05:22 +0100
Subject: [PATCH 0664/4023] Deprecate NavigationManager

---
 .../src/Framework/Features/Navigation/NavigationManager.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 7fc836be42c..9313fb65bd0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -8,6 +8,8 @@
 
 /**
  * Manages the navigation menus for the project.
+ *
+ * @deprecated Move to extension
  */
 class NavigationManager
 {

From 4c5e39a5fe11f5645ac1e2f28e2d644c2274a6ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 13:59:51 +0100
Subject: [PATCH 0665/4023] Remove redundant property already inherited by
 parent

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 60bf526c7aa..3928e2847f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -6,14 +6,10 @@
 
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
-use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
 class DocumentationSidebar extends NavigationMenu
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
-    protected Collection $items;
-
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());

From 90a231e1d6f86230ea9d5b686334649a3a9a383b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 14:01:24 +0100
Subject: [PATCH 0666/4023] Add coverage annotations

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php      | 1 +
 packages/framework/tests/Feature/NavigationMenuTest.php          | 1 +
 .../tests/Feature/Services/DocumentationSidebarTest.php          | 1 +
 packages/framework/tests/Unit/NavigationMenuUnitTest.php         | 1 +
 4 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 2c9e9a27288..c00e56054b6 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -29,6 +29,7 @@
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  */
 class AutomaticNavigationConfigurationsTest extends TestCase
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index aed4d880f64..a4ba8a92ce8 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -15,6 +15,7 @@
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  *
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index b83d3226c83..2e3fcbe6344 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -20,6 +20,7 @@
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Factories\Concerns\HasFactory
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavItem
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index dc935d49329..1b0f9a08a58 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -11,6 +11,7 @@
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
 /**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\NavigationMenuTest

From b17b7e3476a5f2f5ef621bd4a2f1715fdf508cbe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 14:07:26 +0100
Subject: [PATCH 0667/4023] Add static menu container access shorthands

---
 .../Navigation/DocumentationSidebar.php       |  7 ++++++
 .../Navigation/MainNavigationMenu.php         |  7 +++++-
 .../tests/Feature/NavigationManagerTest.php   | 24 +++++++++++++++++++
 3 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3928e2847f6..e8aeec5cab6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,8 +8,15 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Str;
 
+use function app;
+
 class DocumentationSidebar extends NavigationMenu
 {
+    public static function get(): static
+    {
+        return app('navigation')->getMenu('sidebar');
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 96b228fa967..b94dc0778ab 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,7 +4,12 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use function app;
+
 class MainNavigationMenu extends NavigationMenu
 {
-    //
+    public static function get(): static
+    {
+        return app('navigation')->getMenu('main');
+    }
 }
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 41558e14a69..b39e299f039 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -6,9 +6,13 @@
 
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Testing\TestCase;
 
 /**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\NavigationManager
  */
 class NavigationManagerTest extends TestCase
@@ -48,4 +52,24 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $this->expectException(\Exception::class);
         $manager->getMenu('foo');
     }
+
+    public function testCanGetMainNavigationMenuFromContainer()
+    {
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation')->getMenu('main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainer()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation')->getMenu('sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
+    {
+        $this->assertSame(MainNavigationMenu::get(), app('navigation')->getMenu('main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
+    {
+        $this->assertSame(DocumentationSidebar::get(), app('navigation')->getMenu('sidebar'));
+    }
 }

From e4957b863746b631c671d6b149767f62aa94fbb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:17:35 +0100
Subject: [PATCH 0668/4023] Throw when trying to get uninitialized menu before
 boot

---
 .../src/Framework/Features/Navigation/NavigationManager.php  | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 9313fb65bd0..624953fb886 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -33,9 +33,8 @@ public function registerMenu(string $name, NavigationMenu $menu): void
      */
     public function getMenu(string $name): NavigationMenu
     {
-        if (! Hyde::isBooted()) {
-            // Todo: This could be an anti-pattern so we may consider throwing an exception instead.
-            Hyde::boot();
+        if (! Hyde::isBooted() && ! isset($this->menus[$name])) {
+            throw new \Exception('Cannot get navigation menu before the Hyde Kernel is booted.');
         }
 
         return $this->menus[$name];

From b910e765ddf22b599fdd2f8b9831328fc9f4fa01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:17:39 +0100
Subject: [PATCH 0669/4023] Revert "Throw when trying to get uninitialized menu
 before boot"

This reverts commit e4957b863746b631c671d6b149767f62aa94fbb3.
---
 .../src/Framework/Features/Navigation/NavigationManager.php  | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
index 624953fb886..9313fb65bd0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
@@ -33,8 +33,9 @@ public function registerMenu(string $name, NavigationMenu $menu): void
      */
     public function getMenu(string $name): NavigationMenu
     {
-        if (! Hyde::isBooted() && ! isset($this->menus[$name])) {
-            throw new \Exception('Cannot get navigation menu before the Hyde Kernel is booted.');
+        if (! Hyde::isBooted()) {
+            // Todo: This could be an anti-pattern so we may consider throwing an exception instead.
+            Hyde::boot();
         }
 
         return $this->menus[$name];

From d6e5e3e56fb4a8e11136bc6e3e2635c9f50fd1ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:19:21 +0100
Subject: [PATCH 0670/4023] Bind menus directly into the service container

---
 .../Foundation/Providers/NavigationServiceProvider.php    | 8 ++++++++
 .../framework/tests/Feature/NavigationManagerTest.php     | 8 ++++----
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 857588c3dd3..0ab3d60dc35 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -22,6 +22,14 @@ public function register(): void
         $this->app->alias(NavigationManager::class, 'navigation');
 
         $this->app->make(HydeKernel::class)->booted(function () {
+            $this->app->singleton(MainNavigationMenu::class, function () {
+                return NavigationMenuGenerator::handle(MainNavigationMenu::class);
+            });
+
+            $this->app->singleton(DocumentationSidebar::class, function () {
+                return NavigationMenuGenerator::handle(DocumentationSidebar::class);
+            });
+
             $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(MainNavigationMenu::class));
             $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index b39e299f039..573d2c64fa1 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -55,21 +55,21 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation')->getMenu('main'));
+        $this->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation')->getMenu('sidebar'));
+        $this->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        $this->assertSame(MainNavigationMenu::get(), app('navigation')->getMenu('main'));
+        $this->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
-        $this->assertSame(DocumentationSidebar::get(), app('navigation')->getMenu('sidebar'));
+        $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
 }

From 91f8ce931a3452475efdb2ad345ff76646524101 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:27:13 +0100
Subject: [PATCH 0671/4023] Add initial null menu bindings

---
 .../src/Foundation/Providers/NavigationServiceProvider.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 0ab3d60dc35..216dd7cb92d 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -21,6 +21,10 @@ public function register(): void
 
         $this->app->alias(NavigationManager::class, 'navigation');
 
+        // Initially bind these to null, so that the container doesn't try to return them before the kernel has booted.
+        $this->app->singleton(MainNavigationMenu::class, fn () => null);
+        $this->app->singleton(DocumentationSidebar::class, fn () => null);
+
         $this->app->make(HydeKernel::class)->booted(function () {
             $this->app->singleton(MainNavigationMenu::class, function () {
                 return NavigationMenuGenerator::handle(MainNavigationMenu::class);

From 02296abad22c96e4763cfb3b90a128bcb8176430 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:28:00 +0100
Subject: [PATCH 0672/4023] Boot the kernel for each test

---
 .../framework/tests/Feature/NavigationManagerTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 573d2c64fa1..0954a35a12e 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
@@ -55,21 +56,29 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
+        Hyde::boot();
+
         $this->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
+        Hyde::boot();
+
         $this->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
+        Hyde::boot();
+
         $this->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
+        Hyde::boot();
+
         $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
 }

From 643eadf690feadcd120e8e44c2c312ce191ac500 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:28:49 +0100
Subject: [PATCH 0673/4023] Test container menus are null before kernel is
 booted

---
 packages/framework/tests/Feature/NavigationManagerTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 0954a35a12e..e1ae84fe154 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -54,6 +54,12 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $manager->getMenu('foo');
     }
 
+    public function testContainerMenusAreNullBeforeKernelIsBooted()
+    {
+        $this->assertNull(app(MainNavigationMenu::class));
+        $this->assertNull(app(DocumentationSidebar::class));
+    }
+
     public function testCanGetMainNavigationMenuFromContainer()
     {
         Hyde::boot();

From c9414b5dcbe6acf96852146df61e3b3b657b7e46 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:29:29 +0100
Subject: [PATCH 0674/4023] Get direct instance from container

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 .../src/Framework/Features/Navigation/MainNavigationMenu.php    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index e8aeec5cab6..ace9b349e71 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -14,7 +14,7 @@ class DocumentationSidebar extends NavigationMenu
 {
     public static function get(): static
     {
-        return app('navigation')->getMenu('sidebar');
+        return app(static::class);
     }
 
     public function hasGroups(): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index b94dc0778ab..b63f85e7720 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -10,6 +10,6 @@ class MainNavigationMenu extends NavigationMenu
 {
     public static function get(): static
     {
-        return app('navigation')->getMenu('main');
+        return app(static::class);
     }
 }

From 4349a4618eb76da137f7fd959ee0f65bfb41204f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:31:08 +0100
Subject: [PATCH 0675/4023] Remove now unnecessary method overrides

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 -------
 .../Framework/Features/Navigation/MainNavigationMenu.php   | 7 +------
 2 files changed, 1 insertion(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ace9b349e71..3928e2847f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,15 +8,8 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Str;
 
-use function app;
-
 class DocumentationSidebar extends NavigationMenu
 {
-    public static function get(): static
-    {
-        return app(static::class);
-    }
-
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index b63f85e7720..96b228fa967 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,12 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use function app;
-
 class MainNavigationMenu extends NavigationMenu
 {
-    public static function get(): static
-    {
-        return app(static::class);
-    }
+    //
 }

From 544fdfd051e65c70bf89918e242c7be112872f2c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:32:57 +0100
Subject: [PATCH 0676/4023] Revert "Remove now unnecessary method overrides"

This reverts commit 4349a4618eb76da137f7fd959ee0f65bfb41204f.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +++++++
 .../Framework/Features/Navigation/MainNavigationMenu.php   | 7 ++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3928e2847f6..ace9b349e71 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,8 +8,15 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Str;
 
+use function app;
+
 class DocumentationSidebar extends NavigationMenu
 {
+    public static function get(): static
+    {
+        return app(static::class);
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 96b228fa967..b63f85e7720 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,7 +4,12 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use function app;
+
 class MainNavigationMenu extends NavigationMenu
 {
-    //
+    public static function get(): static
+    {
+        return app(static::class);
+    }
 }

From 96756656eb06469edbbe96b39ac71c803bb0ebf6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:33:37 +0100
Subject: [PATCH 0677/4023] Move shared method to parent class

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 -------
 .../Framework/Features/Navigation/MainNavigationMenu.php   | 7 +------
 .../src/Framework/Features/Navigation/NavigationMenu.php   | 5 +++++
 3 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ace9b349e71..3928e2847f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,15 +8,8 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Str;
 
-use function app;
-
 class DocumentationSidebar extends NavigationMenu
 {
-    public static function get(): static
-    {
-        return app(static::class);
-    }
-
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index b63f85e7720..96b228fa967 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,12 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use function app;
-
 class MainNavigationMenu extends NavigationMenu
 {
-    public static function get(): static
-    {
-        return app(static::class);
-    }
+    //
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 986dd7076be..66434248648 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,6 +17,11 @@
  */
 abstract class NavigationMenu
 {
+    public static function get(): static
+    {
+        return app(static::class);
+    }
+
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 

From 596ca0b60715130756dd60fc93b22b82d7b3b956 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:36:33 +0100
Subject: [PATCH 0678/4023] Add menu aliases

---
 .../Providers/NavigationServiceProvider.php   |  3 +++
 .../tests/Feature/NavigationManagerTest.php   | 23 +++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 216dd7cb92d..5b5beae1ac0 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -34,6 +34,9 @@ public function register(): void
                 return NavigationMenuGenerator::handle(DocumentationSidebar::class);
             });
 
+            $this->app->alias(MainNavigationMenu::class, 'navigation.main');
+            $this->app->alias(DocumentationSidebar::class, 'navigation.sidebar');
+
             $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(MainNavigationMenu::class));
             $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index e1ae84fe154..b7a57cbedaf 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -9,6 +9,7 @@
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Testing\TestCase;
+use Illuminate\Contracts\Container\BindingResolutionException;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
@@ -60,6 +61,14 @@ public function testContainerMenusAreNullBeforeKernelIsBooted()
         $this->assertNull(app(DocumentationSidebar::class));
     }
 
+    public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
+    {
+        $this->expectException(BindingResolutionException::class);
+
+        $this->assertNull(app('navigation.main'));
+        $this->assertNull(app('navigation.sidebar'));
+    }
+
     public function testCanGetMainNavigationMenuFromContainer()
     {
         Hyde::boot();
@@ -87,4 +96,18 @@ public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
 
         $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
+
+    public function testCanGetMainNavigationMenuFromContainerUsingAlias()
+    {
+        Hyde::boot();
+
+        $this->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainerUsingAlias()
+    {
+        Hyde::boot();
+
+        $this->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+    }
 }

From a60def55317cb595400ecedbef43fa8029a4a30a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:37:57 +0100
Subject: [PATCH 0679/4023] Use the new container aliases to get menus

---
 .../resources/views/components/docs/sidebar.blade.php         | 2 +-
 .../framework/resources/views/layouts/navigation.blade.php    | 2 +-
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++--
 packages/framework/tests/Feature/NavigationMenuTest.php       | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index f4f3d9c2cb3..9cd5dad15c4 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -4,7 +4,7 @@
     </header>
     <nav id="sidebar-navigation" class="p-2 overflow-y-auto border-y border-gray-300 dark:border-[#1b2533] h-full">
         @include('hyde::components.docs.sidebar-items', [
-            'sidebar' => app('navigation')->getMenu('sidebar'),
+            'sidebar' => app('navigation.sidebar'),
         ])
     </nav>
     @if(config('docs.sidebar.footer', true) !== false)
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index d7f8edcde5b..a2d05aeb00b 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -1,5 +1,5 @@
 @php
-    $navigation = app('navigation')->getMenu('main');
+    $navigation = app('navigation.main');
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 66434248648..892aaf909f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -12,8 +12,8 @@
  *
  * The automatic navigation menus are stored within the service container and can be resolved by their identifiers.
  *
- * @example `$menu = app('navigation')->getMenu('main');` for the main navigation menu.
- * @example `$menu = app('navigation')->getMenu('sidebar');` for the documentation sidebar.
+ * @example `$menu = app('navigation.main');` for the main navigation menu.
+ * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
 abstract class NavigationMenu
 {
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index a4ba8a92ce8..62cf68d6aa2 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -258,12 +258,12 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
     public function testCanGetMenuFromServiceContainer()
     {
-        $this->assertEquals($this->createNavigationMenu(), app('navigation')->getMenu('main'));
+        $this->assertEquals($this->createNavigationMenu(), app('navigation.main'));
     }
 
     public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
     {
-        $navigation = app('navigation')->getMenu('main');
+        $navigation = app('navigation.main');
         $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
 
         $this->assertCount(2, $navigation->getItems());

From 5f9a8fcf3e1df1595c228ca84d636ae9e222661b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:41:44 +0100
Subject: [PATCH 0680/4023] Boot kernel for unit test

---
 packages/framework/tests/Unit/Views/NavigationMenuViewTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index be7fe698976..0d9145a99de 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,6 +18,8 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     protected function render(): string

From 75942a0a88a6553c7e53cac02f4fd6fa2b86ba28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:42:14 +0100
Subject: [PATCH 0681/4023] Clarify code comment

---
 .../src/Foundation/Providers/NavigationServiceProvider.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 5b5beae1ac0..81c13db5393 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -21,7 +21,7 @@ public function register(): void
 
         $this->app->alias(NavigationManager::class, 'navigation');
 
-        // Initially bind these to null, so that the container doesn't try to return them before the kernel has booted.
+        // Initially bind these to null, so that the container doesn't try to return empty menus before the kernel has booted.
         $this->app->singleton(MainNavigationMenu::class, fn () => null);
         $this->app->singleton(DocumentationSidebar::class, fn () => null);
 

From 06f0db4ce406950d3abebe03f6c423000aa94807 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:43:45 +0100
Subject: [PATCH 0682/4023] Boot kernel for test

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 62cf68d6aa2..0666afeb8b8 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
@@ -263,6 +264,8 @@ public function testCanGetMenuFromServiceContainer()
 
     public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
     {
+        Hyde::boot();
+
         $navigation = app('navigation.main');
         $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
 

From fb7a8d56464cc770140409d761b77185d305dd41 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:56:59 +0100
Subject: [PATCH 0683/4023] Extract fluent testing helper

---
 .../tests/Feature/NavigationManagerTest.php   | 27 ++++++++-----------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index b7a57cbedaf..eedafee570d 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -71,43 +71,38 @@ public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        Hyde::boot();
-
-        $this->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
+        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        Hyde::boot();
-
-        $this->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
+        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        Hyde::boot();
-
-        $this->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
+        $this->booted()->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
-        Hyde::boot();
-
-        $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
+        $this->booted()->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingAlias()
     {
-        Hyde::boot();
-
-        $this->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
+        $this->booted()->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingAlias()
+    {
+        $this->booted()->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+    }
+
+    protected function booted(): self
     {
         Hyde::boot();
 
-        $this->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+        return $this;
     }
 }

From d8192cdeb1ecfa7b05d656ee1c58859289525867 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 16:57:02 +0100
Subject: [PATCH 0684/4023] Lazy boot menus

Revert "Extract fluent testing helper"

This reverts commit 1a8112ec68000253509b4099857ac58ecc3d2fa9.

Revert "Boot kernel for test"

This reverts commit 06f0db4ce406950d3abebe03f6c423000aa94807.

Revert "Boot kernel for unit test"

This reverts commit 5f9a8fcf3e1df1595c228ca84d636ae9e222661b.

Revert "Boot the kernel for each test"

This reverts commit 02296abad22c96e4763cfb3b90a128bcb8176430.
---
 .../Features/Navigation/NavigationMenu.php    |  5 +++++
 .../tests/Feature/NavigationManagerTest.php   | 20 ++++++-------------
 .../tests/Feature/NavigationMenuTest.php      |  3 ---
 .../Unit/Views/NavigationMenuViewTest.php     |  2 --
 4 files changed, 11 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 892aaf909f7..5704a5e8a3a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Hyde;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -19,6 +20,10 @@ abstract class NavigationMenu
 {
     public static function get(): static
     {
+        if (! Hyde::isBooted()) {
+            Hyde::boot();
+        }
+
         return app(static::class);
     }
 
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index eedafee570d..3a702824fb6 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
@@ -71,38 +70,31 @@ public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
+        $this->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
+        $this->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        $this->booted()->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
+        $this->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
-        $this->booted()->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
+        $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingAlias()
     {
-        $this->booted()->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
+        $this->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingAlias()
     {
-        $this->booted()->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
-    }
-
-    protected function booted(): self
-    {
-        Hyde::boot();
-
-        return $this;
+        $this->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
     }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 0666afeb8b8..62cf68d6aa2 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
@@ -264,8 +263,6 @@ public function testCanGetMenuFromServiceContainer()
 
     public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
     {
-        Hyde::boot();
-
         $navigation = app('navigation.main');
         $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
 
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index 0d9145a99de..be7fe698976 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,8 +18,6 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
-
-        Hyde::boot();
     }
 
     protected function render(): string

From ff17137e710c055db60781be35b452a434ceee81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 17:05:11 +0100
Subject: [PATCH 0685/4023] Revert "Lazy boot menus"

This reverts commit a74659788806a4e42d9d072fca66defcb2a96f67.
---
 .../Features/Navigation/NavigationMenu.php    |  5 -----
 .../tests/Feature/NavigationManagerTest.php   | 20 +++++++++++++------
 .../tests/Feature/NavigationMenuTest.php      |  3 +++
 .../Unit/Views/NavigationMenuViewTest.php     |  2 ++
 4 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 5704a5e8a3a..892aaf909f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Hyde;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -20,10 +19,6 @@ abstract class NavigationMenu
 {
     public static function get(): static
     {
-        if (! Hyde::isBooted()) {
-            Hyde::boot();
-        }
-
         return app(static::class);
     }
 
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index 3a702824fb6..eedafee570d 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
@@ -70,31 +71,38 @@ public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        $this->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
+        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        $this->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
+        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        $this->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
+        $this->booted()->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
-        $this->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
+        $this->booted()->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingAlias()
     {
-        $this->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
+        $this->booted()->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingAlias()
     {
-        $this->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+        $this->booted()->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+    }
+
+    protected function booted(): self
+    {
+        Hyde::boot();
+
+        return $this;
     }
 }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 62cf68d6aa2..0666afeb8b8 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
@@ -263,6 +264,8 @@ public function testCanGetMenuFromServiceContainer()
 
     public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
     {
+        Hyde::boot();
+
         $navigation = app('navigation.main');
         $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
 
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index be7fe698976..0d9145a99de 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -18,6 +18,8 @@ protected function setUp(): void
         parent::setUp();
         $this->mockRoute();
         $this->mockPage();
+
+        Hyde::boot();
     }
 
     protected function render(): string

From dee5a44a6bfaef9c5291c3f63f7ec173ef64bdf3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 17:08:10 +0100
Subject: [PATCH 0686/4023] Boot the kernel

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index a1d710d25bd..bd5168d390e 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -38,6 +39,8 @@ public function testHasDarkmode()
 
     public function testLayoutHasToggleButtonAndScriptWhenEnabled()
     {
+        Hyde::boot();
+
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),
@@ -75,6 +78,8 @@ public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
 
     public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     {
+        Hyde::boot();
+
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),

From fce0950092d61836eab7f94ad4ca21a81976d913 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 17:57:19 +0100
Subject: [PATCH 0687/4023] Add method description

---
 .../src/Framework/Features/Navigation/NavigationMenu.php       | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 892aaf909f7..25c7b092058 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,6 +17,9 @@
  */
 abstract class NavigationMenu
 {
+    /**
+     * Get the navigation menu instance from the service container.
+     */
     public static function get(): static
     {
         return app(static::class);

From a25423e19bf961491cdf0f1de49f2fab16bc283e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:01:16 +0100
Subject: [PATCH 0688/4023] Remove menu manager binding from container

---
 .../Providers/NavigationServiceProvider.php      |  6 ------
 .../tests/Feature/HydeServiceProviderTest.php    | 16 ----------------
 2 files changed, 22 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 81c13db5393..948ecc47535 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -15,12 +15,6 @@ class NavigationServiceProvider extends ServiceProvider
 {
     public function register(): void
     {
-        $this->app->singleton(NavigationManager::class, function () {
-            return new NavigationManager();
-        });
-
-        $this->app->alias(NavigationManager::class, 'navigation');
-
         // Initially bind these to null, so that the container doesn't try to return empty menus before the kernel has booted.
         $this->app->singleton(MainNavigationMenu::class, fn () => null);
         $this->app->singleton(DocumentationSidebar::class, fn () => null);
diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 6ad340537de..83e437c4acc 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Framework\Features\Navigation\NavigationManager;
-
 use function app;
 use function array_map;
 use function basename;
@@ -329,18 +327,4 @@ public function testOutputDirectoriesCanBeSetUsingKebabCaseClassNames()
         $this->assertEquals('foo', MarkdownPost::outputDirectory());
         $this->assertEquals('foo', DocumentationPage::outputDirectory());
     }
-
-    public function testNavigationManagerIsRegisteredAsSingleton()
-    {
-        $this->assertTrue($this->app->bound(NavigationManager::class));
-        $this->assertInstanceOf(NavigationManager::class, $this->app->make(NavigationManager::class));
-        $this->assertSame($this->app->make(NavigationManager::class), $this->app->make(NavigationManager::class));
-    }
-
-    public function testProviderRegistersNavigationManagerAlias()
-    {
-        $this->assertTrue($this->app->bound('navigation'));
-        $this->assertInstanceOf(NavigationManager::class, $this->app->make('navigation'));
-        $this->assertSame($this->app->make(NavigationManager::class), $this->app->make('navigation'));
-    }
 }

From 6c8e1ac812ef3288cf77b4c2283b69834d2727fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:01:51 +0100
Subject: [PATCH 0689/4023] Remove menu manager registrations

---
 .../src/Foundation/Providers/NavigationServiceProvider.php    | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 948ecc47535..6d9937fdf59 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -7,7 +7,6 @@
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\ServiceProvider;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
@@ -30,9 +29,6 @@ public function register(): void
 
             $this->app->alias(MainNavigationMenu::class, 'navigation.main');
             $this->app->alias(DocumentationSidebar::class, 'navigation.sidebar');
-
-            $this->app->make(NavigationManager::class)->registerMenu('main', NavigationMenuGenerator::handle(MainNavigationMenu::class));
-            $this->app->make(NavigationManager::class)->registerMenu('sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
         });
     }
 }

From aad20361384c1b50f44b384f2afa660d2f3c024d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:04:22 +0100
Subject: [PATCH 0690/4023] Strictly type the closure returms

---
 .../src/Foundation/Providers/NavigationServiceProvider.php  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index 6d9937fdf59..f338c3caad9 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -18,12 +18,12 @@ public function register(): void
         $this->app->singleton(MainNavigationMenu::class, fn () => null);
         $this->app->singleton(DocumentationSidebar::class, fn () => null);
 
-        $this->app->make(HydeKernel::class)->booted(function () {
-            $this->app->singleton(MainNavigationMenu::class, function () {
+        $this->app->make(HydeKernel::class)->booted(function (): void {
+            $this->app->singleton(MainNavigationMenu::class, function (): MainNavigationMenu {
                 return NavigationMenuGenerator::handle(MainNavigationMenu::class);
             });
 
-            $this->app->singleton(DocumentationSidebar::class, function () {
+            $this->app->singleton(DocumentationSidebar::class, function (): DocumentationSidebar {
                 return NavigationMenuGenerator::handle(DocumentationSidebar::class);
             });
 

From 0a4e1c114e097ef12f31d03182e9d0dfb1ae8391 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:09:19 +0100
Subject: [PATCH 0691/4023] Simplify container bindings

Being able to do app(MainNavigationMenu::class) instead of MainNavigationMenu::get() offers little value. It does have some benefit compared to using the aliases as the former can probably get better IDE support, but since the idea behind the alias is convenience I don't think it's worth it since the static method offers full type support. We also don't need the initial null bindings as the string versions throw an exception instead of trying to resolve the classes. It does mean the static get method breaks but that's fine as I will revert that next
---
 .../Providers/NavigationServiceProvider.php   | 11 ++------
 .../tests/Feature/NavigationManagerTest.php   | 26 ++++---------------
 2 files changed, 7 insertions(+), 30 deletions(-)

diff --git a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
index f338c3caad9..02af9f13ec1 100644
--- a/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
+++ b/packages/framework/src/Foundation/Providers/NavigationServiceProvider.php
@@ -14,21 +14,14 @@ class NavigationServiceProvider extends ServiceProvider
 {
     public function register(): void
     {
-        // Initially bind these to null, so that the container doesn't try to return empty menus before the kernel has booted.
-        $this->app->singleton(MainNavigationMenu::class, fn () => null);
-        $this->app->singleton(DocumentationSidebar::class, fn () => null);
-
         $this->app->make(HydeKernel::class)->booted(function (): void {
-            $this->app->singleton(MainNavigationMenu::class, function (): MainNavigationMenu {
+            $this->app->singleton('navigation.main', function (): MainNavigationMenu {
                 return NavigationMenuGenerator::handle(MainNavigationMenu::class);
             });
 
-            $this->app->singleton(DocumentationSidebar::class, function (): DocumentationSidebar {
+            $this->app->singleton('navigation.sidebar', function (): DocumentationSidebar {
                 return NavigationMenuGenerator::handle(DocumentationSidebar::class);
             });
-
-            $this->app->alias(MainNavigationMenu::class, 'navigation.main');
-            $this->app->alias(DocumentationSidebar::class, 'navigation.sidebar');
         });
     }
 }
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index eedafee570d..e46f88757b3 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -55,13 +55,7 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $manager->getMenu('foo');
     }
 
-    public function testContainerMenusAreNullBeforeKernelIsBooted()
-    {
-        $this->assertNull(app(MainNavigationMenu::class));
-        $this->assertNull(app(DocumentationSidebar::class));
-    }
-
-    public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
+    public function testCannotGetContainerMenusBeforeKernelIsBooted()
     {
         $this->expectException(BindingResolutionException::class);
 
@@ -71,32 +65,22 @@ public function testCannotGetContainerMenusByAliasBeforeKernelIsBooted()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app(MainNavigationMenu::class));
+        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app(DocumentationSidebar::class));
+        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        $this->booted()->assertSame(MainNavigationMenu::get(), app(MainNavigationMenu::class));
+        $this->booted()->assertSame(MainNavigationMenu::get(), app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
-        $this->booted()->assertSame(DocumentationSidebar::get(), app(DocumentationSidebar::class));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainerUsingAlias()
-    {
-        $this->booted()->assertSame(app(MainNavigationMenu::class), app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainerUsingAlias()
-    {
-        $this->booted()->assertSame(app(DocumentationSidebar::class), app('navigation.sidebar'));
+        $this->booted()->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
     }
 
     protected function booted(): self

From 6f0ddf754a6dc15ef586ca83516629d37ae00019 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:10:50 +0100
Subject: [PATCH 0692/4023] Revert "Move shared method to parent class"

This reverts commit 96756656eb06469edbbe96b39ac71c803bb0ebf6.
---
 .../Features/Navigation/DocumentationSidebar.php       | 10 ++++++++++
 .../Features/Navigation/MainNavigationMenu.php         | 10 +++++++++-
 .../Framework/Features/Navigation/NavigationMenu.php   |  8 --------
 3 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3928e2847f6..3f2d3d54480 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,8 +8,18 @@
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\Str;
 
+use function app;
+
 class DocumentationSidebar extends NavigationMenu
 {
+    /**
+     * Get the navigation menu instance from the service container.
+     */
+    public static function get(): static
+    {
+        return app('navigation.sidebar');
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index 96b228fa967..e9f6f1a8dff 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -4,7 +4,15 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use function app;
+
 class MainNavigationMenu extends NavigationMenu
 {
-    //
+    /**
+     * Get the navigation menu instance from the service container.
+     */
+    public static function get(): static
+    {
+        return app('navigation.main');
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 25c7b092058..1de04be10df 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,14 +17,6 @@
  */
 abstract class NavigationMenu
 {
-    /**
-     * Get the navigation menu instance from the service container.
-     */
-    public static function get(): static
-    {
-        return app(static::class);
-    }
-
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 

From c0a02077975042daa49935e1bb5782c0b2020cf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:14:54 +0100
Subject: [PATCH 0693/4023] Revert "Add method description"

This reverts commit fce0950092d61836eab7f94ad4ca21a81976d913.
---
 .../src/Framework/Features/Navigation/MainNavigationMenu.php   | 3 ---
 .../src/Framework/Features/Navigation/NavigationMenu.php       | 3 ---
 2 files changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index e9f6f1a8dff..e6681c42ffd 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -8,9 +8,6 @@
 
 class MainNavigationMenu extends NavigationMenu
 {
-    /**
-     * Get the navigation menu instance from the service container.
-     */
     public static function get(): static
     {
         return app('navigation.main');
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 1de04be10df..84779c79eb9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,9 +20,6 @@ abstract class NavigationMenu
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 
-    /**
-     * Create a new navigation menu instance.
-     */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();

From a89814ce54ba7ee502b1b2a72348ae4de0b83086 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:17:20 +0100
Subject: [PATCH 0694/4023] Revert "Extract fluent testing helper"

This reverts commit fb7a8d56464cc770140409d761b77185d305dd41.
---
 .../tests/Feature/NavigationManagerTest.php   | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index e46f88757b3..d78ed77f32f 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -65,28 +65,29 @@ public function testCannotGetContainerMenusBeforeKernelIsBooted()
 
     public function testCanGetMainNavigationMenuFromContainer()
     {
-        $this->booted()->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
+        Hyde::boot();
+
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
     }
 
     public function testCanGetDocumentationSidebarFromContainer()
     {
-        $this->booted()->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
+        Hyde::boot();
+
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
     }
 
     public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
-        $this->booted()->assertSame(MainNavigationMenu::get(), app('navigation.main'));
-    }
+        Hyde::boot();
 
-    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
-    {
-        $this->booted()->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
+        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
     }
 
-    protected function booted(): self
+    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
         Hyde::boot();
 
-        return $this;
+        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
     }
 }

From c9b1127f3cd6d31c319c77c04bc3b152e3a7bcb8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:18:12 +0100
Subject: [PATCH 0695/4023] Move service container binding tests to menu test

---
 .../AutomaticNavigationConfigurationsTest.php | 40 +++++++++++++++++++
 .../tests/Feature/NavigationManagerTest.php   | 39 ------------------
 2 files changed, 40 insertions(+), 39 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c00e56054b6..e483d3ef0c4 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
@@ -20,6 +21,7 @@
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Illuminate\Contracts\Container\BindingResolutionException;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
@@ -1221,6 +1223,44 @@ public function testSidebarGroupCasingUsingFrontMatter()
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello world'])]);
     }
 
+    // Service container binding tests
+
+    public function testCannotGetContainerMenusBeforeKernelIsBooted()
+    {
+        $this->expectException(BindingResolutionException::class);
+
+        $this->assertNull(app('navigation.main'));
+        $this->assertNull(app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index d78ed77f32f..e4be9383d8e 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,12 +4,9 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Testing\TestCase;
-use Illuminate\Contracts\Container\BindingResolutionException;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
@@ -54,40 +51,4 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $this->expectException(\Exception::class);
         $manager->getMenu('foo');
     }
-
-    public function testCannotGetContainerMenusBeforeKernelIsBooted()
-    {
-        $this->expectException(BindingResolutionException::class);
-
-        $this->assertNull(app('navigation.main'));
-        $this->assertNull(app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
-    }
 }

From 2fe9ca81d46cc351bb67ce1faae58e57e2046dff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:25:11 +0100
Subject: [PATCH 0696/4023] Revert "Move service container binding tests to
 menu test"

This reverts commit c9b1127f3cd6d31c319c77c04bc3b152e3a7bcb8.
---
 .../AutomaticNavigationConfigurationsTest.php | 40 -------------------
 .../tests/Feature/NavigationManagerTest.php   | 39 ++++++++++++++++++
 2 files changed, 39 insertions(+), 40 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e483d3ef0c4..c00e56054b6 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
@@ -21,7 +20,6 @@
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Illuminate\Contracts\Container\BindingResolutionException;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
@@ -1223,44 +1221,6 @@ public function testSidebarGroupCasingUsingFrontMatter()
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello world'])]);
     }
 
-    // Service container binding tests
-
-    public function testCannotGetContainerMenusBeforeKernelIsBooted()
-    {
-        $this->expectException(BindingResolutionException::class);
-
-        $this->assertNull(app('navigation.main'));
-        $this->assertNull(app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
-    }
-
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): void
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index e4be9383d8e..d78ed77f32f 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,9 +4,12 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Testing\TestCase;
+use Illuminate\Contracts\Container\BindingResolutionException;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
@@ -51,4 +54,40 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $this->expectException(\Exception::class);
         $manager->getMenu('foo');
     }
+
+    public function testCannotGetContainerMenusBeforeKernelIsBooted()
+    {
+        $this->expectException(BindingResolutionException::class);
+
+        $this->assertNull(app('navigation.main'));
+        $this->assertNull(app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
+    }
 }

From 5afae61f036e124f9bea9c395272ff1bd9a8c1a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:25:52 +0100
Subject: [PATCH 0697/4023] Move service container binding tests to provider
 test

---
 .../tests/Feature/HydeServiceProviderTest.php | 40 +++++++++++++++++++
 .../tests/Feature/NavigationManagerTest.php   | 39 ------------------
 2 files changed, 40 insertions(+), 39 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 83e437c4acc..9c895230082 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -4,6 +4,10 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Illuminate\Contracts\Container\BindingResolutionException;
+
 use function app;
 use function array_map;
 use function basename;
@@ -327,4 +331,40 @@ public function testOutputDirectoriesCanBeSetUsingKebabCaseClassNames()
         $this->assertEquals('foo', MarkdownPost::outputDirectory());
         $this->assertEquals('foo', DocumentationPage::outputDirectory());
     }
+
+    public function testCannotGetContainerMenusBeforeKernelIsBooted()
+    {
+        $this->expectException(BindingResolutionException::class);
+
+        $this->assertNull(app('navigation.main'));
+        $this->assertNull(app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainer()
+    {
+        Hyde::boot();
+
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
+    }
+
+    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
+    }
+
+    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
+    {
+        Hyde::boot();
+
+        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
+    }
 }
diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
index d78ed77f32f..e4be9383d8e 100644
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ b/packages/framework/tests/Feature/NavigationManagerTest.php
@@ -4,12 +4,9 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Framework\Features\Navigation\NavigationManager;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Testing\TestCase;
-use Illuminate\Contracts\Container\BindingResolutionException;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
@@ -54,40 +51,4 @@ public function testGetMenuThrowsExceptionForNonExistentMenu()
         $this->expectException(\Exception::class);
         $manager->getMenu('foo');
     }
-
-    public function testCannotGetContainerMenusBeforeKernelIsBooted()
-    {
-        $this->expectException(BindingResolutionException::class);
-
-        $this->assertNull(app('navigation.main'));
-        $this->assertNull(app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainer()
-    {
-        Hyde::boot();
-
-        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
-    }
-
-    public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
-    }
-
-    public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
-    {
-        Hyde::boot();
-
-        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
-    }
 }

From 172cb8643e174eb258afd5f9be718522b9c6532f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:28:04 +0100
Subject: [PATCH 0698/4023] Swap wrong order of expected/actual

---
 packages/framework/tests/Feature/HydeServiceProviderTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 9c895230082..955e0e21be5 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -358,13 +358,13 @@ public function testCanGetMainNavigationMenuFromContainerUsingShorthand()
     {
         Hyde::boot();
 
-        $this->assertSame(MainNavigationMenu::get(), app('navigation.main'));
+        $this->assertSame(app('navigation.main'), MainNavigationMenu::get());
     }
 
     public function testCanGetDocumentationSidebarFromContainerUsingShorthand()
     {
         Hyde::boot();
 
-        $this->assertSame(DocumentationSidebar::get(), app('navigation.sidebar'));
+        $this->assertSame(app('navigation.sidebar'), DocumentationSidebar::get());
     }
 }

From 06d88e895950f8fb109a13061d824dcd234d8e3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:28:18 +0100
Subject: [PATCH 0699/4023] Clean up test

---
 packages/framework/tests/Feature/HydeServiceProviderTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 955e0e21be5..5704cdc160e 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -336,8 +336,8 @@ public function testCannotGetContainerMenusBeforeKernelIsBooted()
     {
         $this->expectException(BindingResolutionException::class);
 
-        $this->assertNull(app('navigation.main'));
-        $this->assertNull(app('navigation.sidebar'));
+        app('navigation.main');
+        app('navigation.sidebar');
     }
 
     public function testCanGetMainNavigationMenuFromContainer()

From 730c4276bfa984cac40b0cd4b5bebd6d3ea48dd8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:29:07 +0100
Subject: [PATCH 0700/4023] Split out test

---
 .../framework/tests/Feature/HydeServiceProviderTest.php   | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 5704cdc160e..5472304f46c 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -332,11 +332,17 @@ public function testOutputDirectoriesCanBeSetUsingKebabCaseClassNames()
         $this->assertEquals('foo', DocumentationPage::outputDirectory());
     }
 
-    public function testCannotGetContainerMenusBeforeKernelIsBooted()
+    public function testCannotMainNavigationMenuFromContainerBeforeKernelIsBooted()
     {
         $this->expectException(BindingResolutionException::class);
 
         app('navigation.main');
+    }
+
+    public function testCannotDocumentationSidebarFromContainerBeforeKernelIsBooted()
+    {
+        $this->expectException(BindingResolutionException::class);
+
         app('navigation.sidebar');
     }
 

From 7a281c0c90ef3cf54ae4f1bab9c0b9b2342036dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:41:36 +0100
Subject: [PATCH 0701/4023] Delete NavigationManagerTest.php

---
 .../tests/Feature/NavigationManagerTest.php   | 54 -------------------
 1 file changed, 54 deletions(-)
 delete mode 100644 packages/framework/tests/Feature/NavigationManagerTest.php

diff --git a/packages/framework/tests/Feature/NavigationManagerTest.php b/packages/framework/tests/Feature/NavigationManagerTest.php
deleted file mode 100644
index e4be9383d8e..00000000000
--- a/packages/framework/tests/Feature/NavigationManagerTest.php
+++ /dev/null
@@ -1,54 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Feature;
-
-use Hyde\Framework\Features\Navigation\NavigationManager;
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Testing\TestCase;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
- * @covers \Hyde\Framework\Features\Navigation\NavigationManager
- */
-class NavigationManagerTest extends TestCase
-{
-    public function testCanRegisterMenu()
-    {
-        $manager = new NavigationManager();
-
-        $menu = $this->createMock(MainNavigationMenu::class);
-        $manager->registerMenu('foo', $menu);
-
-        $reflection = new \ReflectionClass($manager);
-        $property = $reflection->getProperty('menus');
-
-        $menus = $property->getValue($manager);
-
-        $this->assertArrayHasKey('foo', $menus);
-        $this->assertSame($menu, $menus['foo']);
-    }
-
-    public function testCanGetMenu()
-    {
-        $manager = new NavigationManager();
-
-        $menu = $this->createMock(MainNavigationMenu::class);
-        $manager->registerMenu('foo', $menu);
-
-        $retrievedMenu = $manager->getMenu('foo');
-
-        $this->assertSame($menu, $retrievedMenu);
-    }
-
-    public function testGetMenuThrowsExceptionForNonExistentMenu()
-    {
-        $manager = new NavigationManager();
-
-        $this->expectException(\Exception::class);
-        $manager->getMenu('foo');
-    }
-}

From 805849b66379a584007376191e918fdecf793fb4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:41:38 +0100
Subject: [PATCH 0702/4023] Delete NavigationManager.php

---
 .../Features/Navigation/NavigationManager.php | 43 -------------------
 1 file changed, 43 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationManager.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php b/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
deleted file mode 100644
index 9313fb65bd0..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/NavigationManager.php
+++ /dev/null
@@ -1,43 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-use Hyde\Hyde;
-
-/**
- * Manages the navigation menus for the project.
- *
- * @deprecated Move to extension
- */
-class NavigationManager
-{
-    /**
-     * The menus that are available for the project, keyed by their name identifier.
-     *
-     * @var array<string, \Hyde\Framework\Features\Navigation\NavigationMenu>
-     */
-    protected array $menus = [];
-
-    /**
-     * Register a new menu for the project.
-     */
-    public function registerMenu(string $name, NavigationMenu $menu): void
-    {
-        $this->menus[$name] = $menu;
-    }
-
-    /**
-     * Get a menu by its name.
-     */
-    public function getMenu(string $name): NavigationMenu
-    {
-        if (! Hyde::isBooted()) {
-            // Todo: This could be an anti-pattern so we may consider throwing an exception instead.
-            Hyde::boot();
-        }
-
-        return $this->menus[$name];
-    }
-}

From f19e288a6bd572cf2d51f0e459d7ebeb1a0d8c26 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 18:42:40 +0100
Subject: [PATCH 0703/4023] Add missing part of test names

---
 packages/framework/tests/Feature/HydeServiceProviderTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 5472304f46c..c20ebac254e 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -332,14 +332,14 @@ public function testOutputDirectoriesCanBeSetUsingKebabCaseClassNames()
         $this->assertEquals('foo', DocumentationPage::outputDirectory());
     }
 
-    public function testCannotMainNavigationMenuFromContainerBeforeKernelIsBooted()
+    public function testCannotGetMainNavigationMenuFromContainerBeforeKernelIsBooted()
     {
         $this->expectException(BindingResolutionException::class);
 
         app('navigation.main');
     }
 
-    public function testCannotDocumentationSidebarFromContainerBeforeKernelIsBooted()
+    public function testCannotGetDocumentationSidebarFromContainerBeforeKernelIsBooted()
     {
         $this->expectException(BindingResolutionException::class);
 

From 7b8e90bac290ac49f03d712c42794cb53d781d47 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 19:41:10 +0100
Subject: [PATCH 0704/4023] Breaking: Change configuration option
 `sidebar_order` to `sidebar.order`

Breaking: This changes the configuration option `docs.sidebar_order` to `docs.sidebar.order` in order to normalize the configuration API.
---
 config/docs.php                               | 44 +++++++++----------
 docs/creating-content/documentation-pages.md  | 10 +++--
 docs/digging-deeper/customization.md          |  2 +-
 docs/digging-deeper/navigation.md             | 24 +++++-----
 packages/framework/config/docs.php            | 44 +++++++++----------
 .../Factories/NavigationDataFactory.php       |  2 +-
 .../Navigation/NavigationMenuGenerator.php    |  2 +-
 .../AutomaticNavigationConfigurationsTest.php | 22 +++++-----
 .../Services/DocumentationSidebarTest.php     |  8 ++--
 .../Unit/NavigationDataFactoryUnitTest.php    |  8 ++--
 10 files changed, 85 insertions(+), 81 deletions(-)

diff --git a/config/docs.php b/config/docs.php
index fab400e973d..652695339b6 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -33,29 +33,29 @@
         // Should the sidebar footer be shown? You can also set this to a string
         // of Markdown to show in the footer. Set to `false` to disable.
         'footer' => true,
-    ],
-
-    /*
-    |--------------------------------------------------------------------------
-    | Sidebar Page Order
-    |--------------------------------------------------------------------------
-    |
-    | In the generated Documentation pages the navigation links in the sidebar
-    | default to sort alphabetically. You can reorder the page identifiers
-    | in the list below, and the links will get sorted in that order.
-    |
-    | The items will get a priority of 500 plus the order its found in the list.
-    | Pages without a priority will fall back to the default priority of 999.
-    |
-    | You can also set explicit priorities in front matter or by specifying
-    | a value to the array key in the list to override the inferred value.
-    |
-    */
 
-    'sidebar_order' => [
-        'readme',
-        'installation',
-        'getting-started',
+        /*
+        |--------------------------------------------------------------------------
+        | Sidebar Page Order
+        |--------------------------------------------------------------------------
+        |
+        | In the generated Documentation pages the navigation links in the sidebar
+        | default to sort alphabetically. You can reorder the page identifiers
+        | in the list below, and the links will get sorted in that order.
+        |
+        | The items will get a priority of 500 plus the order its found in the list.
+        | Pages without a priority will fall back to the default priority of 999.
+        |
+        | You can also set explicit priorities in front matter or by specifying
+        | a value to the array key in the list to override the inferred value.
+        |
+        */
+
+        'order' => [
+            'readme',
+            'installation',
+            'getting-started',
+        ],
     ],
 
     /*
diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 005d2f324ba..9bbcedc205b 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -223,10 +223,12 @@ To quickly arrange the order of items in the sidebar, you can reorder the page i
 Link items without an entry here will fall back to the default priority of 999, putting them last.
 
 ```php
-'sidebar_order' => [
-    'readme',
-    'installation',
-    'getting-started',
+'sidebar' => [
+    'order' => [
+        'readme',
+        'installation',
+        'getting-started',
+    ],
 ]
 ```
 
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 8f8c455bc60..0ec2b9c934d 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -259,7 +259,7 @@ Learn more in the [Navigation Menu](navigation) documentation.
 
 #### Customizing the documentation sidebar
 
-- To customize the sidebar, use the setting `sidebar_order` in the `docs.php` config.
+- To customize the sidebar, use the setting `sidebar.order` in the `docs.php` config.
 - When customizing the sidebar, can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
 
 Learn more in the [Documentation Pages](documentation-pages) documentation.
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4d201775d42..f36a2f9a761 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -122,12 +122,12 @@ Next up, let's look at how to customize the navigation menus using the config fi
 - To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
 - When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.
 
-- To customize the sidebar, use the setting `sidebar_order` in the `docs.php` config.
+- To customize the sidebar, use the setting `sidebar.order` in the `docs.php` config.
 - When customizing the sidebar, can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
 
 ### Changing the priorities
 
-The `navigation.order` and `sidebar_order` settings allow you to customize the order of the pages in the navigation menus.
+The `navigation.order` and `sidebar.order` settings allow you to customize the order of the pages in the navigation menus.
 
 #### Basic syntax for changing the priorities
 
@@ -149,10 +149,12 @@ The offset is added to make it easier to place pages earlier in the list using f
 ```php
 // filepath: config/docs.php
 
-'sidebar_order' => [
-    'readme', // Gets priority 500
-    'installation', // Gets priority 501
-    'getting-started', // Gets priority 502
+'sidebar' => [
+    'order' => [
+        'readme', // Gets priority 500
+        'installation', // Gets priority 501
+        'getting-started', // Gets priority 502
+    ]
 ]
 ```
 
@@ -175,10 +177,12 @@ You can also specify explicit priorities by adding a value to the array key:
 ```php
 // filepath: config/docs.php
 
-'sidebar_order' => [
-    'readme' => 10, // Gets priority 10
-    'installation' => 15, // Gets priority 15
-    'getting-started' => 20, // Gets priority 20
+'sidebar' => [
+    'order' => [
+        'readme' => 10, // Gets priority 10
+        'installation' => 15, // Gets priority 15
+        'getting-started' => 20, // Gets priority 20
+    ]
 ]
 ```
 
diff --git a/packages/framework/config/docs.php b/packages/framework/config/docs.php
index fab400e973d..652695339b6 100644
--- a/packages/framework/config/docs.php
+++ b/packages/framework/config/docs.php
@@ -33,29 +33,29 @@
         // Should the sidebar footer be shown? You can also set this to a string
         // of Markdown to show in the footer. Set to `false` to disable.
         'footer' => true,
-    ],
-
-    /*
-    |--------------------------------------------------------------------------
-    | Sidebar Page Order
-    |--------------------------------------------------------------------------
-    |
-    | In the generated Documentation pages the navigation links in the sidebar
-    | default to sort alphabetically. You can reorder the page identifiers
-    | in the list below, and the links will get sorted in that order.
-    |
-    | The items will get a priority of 500 plus the order its found in the list.
-    | Pages without a priority will fall back to the default priority of 999.
-    |
-    | You can also set explicit priorities in front matter or by specifying
-    | a value to the array key in the list to override the inferred value.
-    |
-    */
 
-    'sidebar_order' => [
-        'readme',
-        'installation',
-        'getting-started',
+        /*
+        |--------------------------------------------------------------------------
+        | Sidebar Page Order
+        |--------------------------------------------------------------------------
+        |
+        | In the generated Documentation pages the navigation links in the sidebar
+        | default to sort alphabetically. You can reorder the page identifiers
+        | in the list below, and the links will get sorted in that order.
+        |
+        | The items will get a priority of 500 plus the order its found in the list.
+        | Pages without a priority will fall back to the default priority of 999.
+        |
+        | You can also set explicit priorities in front matter or by specifying
+        | a value to the array key in the list to override the inferred value.
+        |
+        */
+
+        'order' => [
+            'readme',
+            'installation',
+            'getting-started',
+        ],
     ],
 
     /*
diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 0fb46e79da2..7d02a193d4e 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -160,7 +160,7 @@ private function searchForPriorityInConfigs(): ?int
     private function searchForPriorityInSidebarConfig(): ?int
     {
         /** @var array<string>|array<string, int> $config */
-        $config = Config::getArray('docs.sidebar_order', []);
+        $config = Config::getArray('docs.sidebar.order', []);
 
         return
             // For consistency with the navigation config.
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index bd31784144e..b490ac19bc2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -182,7 +182,7 @@ protected function searchForGroupLabelInConfig(string $groupKey): ?string
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
-        $key = $this->generatesSidebar ? 'docs.sidebar_order' : 'hyde.navigation.order';
+        $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
 
         return Config::getArray($key, [])[$groupKey] ?? null;
     }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c00e56054b6..98541a8be20 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -745,9 +745,7 @@ public function testSidebarWithFrontMatterGroupAndCategory()
 
     public function testSidebarWithConfigOrder()
     {
-        // TODO should be sidebar.order instead of docs.sidebar_order
-
-        config(['docs.sidebar_order' => ['first', 'second', 'third']]);
+        config(['docs.sidebar.order' => ['first', 'second', 'third']]);
 
         $this->assertSidebarEquals(['First', 'Second', 'Third'], [
             new DocumentationPage('first'),
@@ -755,7 +753,7 @@ public function testSidebarWithConfigOrder()
             new DocumentationPage('third'),
         ]);
 
-        config(['docs.sidebar_order' => ['third', 'second', 'first']]);
+        config(['docs.sidebar.order' => ['third', 'second', 'first']]);
 
         $this->assertSidebarEquals(['Third', 'Second', 'First'], [
             new DocumentationPage('first'),
@@ -776,7 +774,7 @@ public function testSidebarWithConfigOrderHasInferredPriorities()
             new DocumentationPage('third'),
         ]);
 
-        config(['docs.sidebar_order' => ['first', 'second', 'third']]);
+        config(['docs.sidebar.order' => ['first', 'second', 'third']]);
 
         $this->assertSidebarEquals([
             ['priority' => 500],
@@ -791,7 +789,7 @@ public function testSidebarWithConfigOrderHasInferredPriorities()
 
     public function testSidebarWithExplicitConfigOrder()
     {
-        config(['docs.sidebar_order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+        config(['docs.sidebar.order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
 
         $this->assertSidebarEquals(['First', 'Second', 'Third'], [
             new DocumentationPage('first'),
@@ -799,7 +797,7 @@ public function testSidebarWithExplicitConfigOrder()
             new DocumentationPage('third'),
         ]);
 
-        config(['docs.sidebar_order' => ['first' => 3, 'second' => 2, 'third' => 1]]);
+        config(['docs.sidebar.order' => ['first' => 3, 'second' => 2, 'third' => 1]]);
 
         $this->assertSidebarEquals(['Third', 'Second', 'First'], [
             new DocumentationPage('first'),
@@ -807,7 +805,7 @@ public function testSidebarWithExplicitConfigOrder()
             new DocumentationPage('third'),
         ]);
 
-        config(['docs.sidebar_order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
+        config(['docs.sidebar.order' => ['first' => 1, 'second' => 2, 'third' => 3]]);
 
         $this->assertSidebarEquals([
             ['label' => 'First', 'priority' => 1],
@@ -822,7 +820,7 @@ public function testSidebarWithExplicitConfigOrder()
 
     public function testSidebarWithMixedConfigOrders()
     {
-        config(['docs.sidebar_order' => ['foo', 'bar' => 650]]);
+        config(['docs.sidebar.order' => ['foo', 'bar' => 650]]);
 
         $this->assertSidebarEquals([
             ['label' => 'Foo', 'priority' => 500],
@@ -1059,7 +1057,7 @@ public function testSidebarGroupsAreSortedByLowestFoundPriorityInEachGroupUnless
             new DocumentationPage('baz', ['navigation.group' => 'c', 'navigation.priority' => 10]),
         ]);
 
-        config(['docs.sidebar_order' => ['a' => 5]]);
+        config(['docs.sidebar.order' => ['a' => 5]]);
 
         $this->assertSidebarEquals([
             'A', 'C', 'B',
@@ -1117,7 +1115,7 @@ public function testMainNavigationDropdownPriorityCanBeSetInConfigUsingDiffering
 
     public function testSidebarGroupPriorityCanBeSetInConfig()
     {
-        config(['docs.sidebar_order' => ['foo' => 500]]);
+        config(['docs.sidebar.order' => ['foo' => 500]]);
 
         $this->assertSidebarEquals(
             [['label' => 'Foo', 'priority' => 500]],
@@ -1127,7 +1125,7 @@ public function testSidebarGroupPriorityCanBeSetInConfig()
 
     public function testSidebarGroupPriorityCanBeSetInConfigUsingDifferingCases()
     {
-        config(['docs.sidebar_order' => ['hello-world' => 500]]);
+        config(['docs.sidebar.order' => ['hello-world' => 500]]);
 
         $expected = [['label' => 'Hello World', 'priority' => 500]];
         $this->assertSidebarEquals($expected, [new DocumentationPage('Hello World/bar')]);
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 2e3fcbe6344..3bb0b2b6545 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -77,7 +77,7 @@ public function testFilesWithFrontMatterHiddenSetToTrueAreRemovedFromSidebar()
 
     public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
     {
-        Config::set('docs.sidebar_order', []);
+        Config::set('docs.sidebar.order', []);
         Filesystem::touch('_docs/a.md');
         Filesystem::touch('_docs/b.md');
         Filesystem::touch('_docs/c.md');
@@ -94,7 +94,7 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
 
     public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
     {
-        Config::set('docs.sidebar_order', [
+        Config::set('docs.sidebar.order', [
             'c',
             'b',
             'a',
@@ -124,14 +124,14 @@ public function testSidebarItemPrioritySetInConfigOverridesFrontMatter()
     {
         $this->makePage('foo', ['navigation.priority' => 25]);
 
-        Config::set('docs.sidebar_order', ['foo']);
+        Config::set('docs.sidebar.order', ['foo']);
 
         $this->assertEquals(25, NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getPriority());
     }
 
     public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     {
-        Config::set('docs.sidebar_order', [
+        Config::set('docs.sidebar.order', [
             'first',
             'third',
             'second',
diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index a118c695723..9674273bf75 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -74,7 +74,7 @@ public function testSearchForPriorityInNavigationConfigForMarkdownPageSupportsMi
 
     public function testSearchForPriorityInNavigationConfigForDocumentationPageWithListConfig()
     {
-        self::mockConfig(['docs.sidebar_order' => [
+        self::mockConfig(['docs.sidebar.order' => [
             'foo' => 15,
             'bar' => 10,
         ]]);
@@ -88,7 +88,7 @@ public function testSearchForPriorityInNavigationConfigForDocumentationPageWithL
 
     public function testSearchForPriorityInNavigationConfigForDocumentationPageWithKeyedConfig()
     {
-        self::mockConfig(['docs.sidebar_order' => [
+        self::mockConfig(['docs.sidebar.order' => [
             'foo',
             'bar' => 10,
             'baz',
@@ -109,7 +109,7 @@ public function testSearchForPriorityInNavigationConfigForDocumentationPageWithK
 
     public function testSearchForPriorityInNavigationConfigForDocumentationPageSupportsMixingKeyedAndListConfig()
     {
-        self::mockConfig(['docs.sidebar_order' => [
+        self::mockConfig(['docs.sidebar.order' => [
             'foo',
             'bar' => 10,
             'baz',
@@ -130,7 +130,7 @@ public function testSearchForPriorityInNavigationConfigForDocumentationPageSuppo
 
     public function testRouteKeysCanBeUsedForDocumentationSidebarPriorities()
     {
-        self::mockConfig(['docs.sidebar_order' => [
+        self::mockConfig(['docs.sidebar.order' => [
             'key/foo',
             'key/bar',
             'baz',

From 255aa0e18b4e258998129bd04fa82b5378e901be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 19:54:07 +0100
Subject: [PATCH 0705/4023] Breaking: Change configuration option
 `table_of_contents` to `sidebar.table_of_contents`

Breaking: This changes the configuration option `docs.table_of_contents` to `docs.sidebar.table_of_contents` in order to normalize the configuration API.
---
 config/docs.php                               | 31 ++++++++++---------
 docs/creating-content/documentation-pages.md  | 12 ++++---
 packages/framework/config/docs.php            | 31 ++++++++++---------
 .../components/docs/sidebar-item.blade.php    |  2 +-
 .../Actions/GeneratesTableOfContents.php      |  4 +--
 .../framework/src/Pages/DocumentationPage.php |  2 +-
 .../tests/Feature/MarkdownServiceTest.php     |  2 +-
 .../tests/Unit/DocumentationPageTest.php      |  4 +--
 8 files changed, 46 insertions(+), 42 deletions(-)

diff --git a/config/docs.php b/config/docs.php
index 652695339b6..93bbc751dc2 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -56,23 +56,24 @@
             'installation',
             'getting-started',
         ],
-    ],
 
-    /*
-    |--------------------------------------------------------------------------
-    | Table of Contents Settings
-    |--------------------------------------------------------------------------
-    |
-    | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
-    | has a Table of Contents included. Here, you can configure its behavior,
-    | content, look and feel. You can also disable the feature completely.
-    |
-    */
+        /*
+        |--------------------------------------------------------------------------
+        | Table of Contents Settings
+        |--------------------------------------------------------------------------
+        |
+        | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
+        | has a Table of Contents included. Here, you can configure its behavior,
+        | content, look and feel. You can also disable the feature completely.
+        |
+        */
+
+        'table_of_contents' => [
+            'enabled' => true,
+            'min_heading_level' => 2,
+            'max_heading_level' => 4,
+        ],
 
-    'table_of_contents' => [
-        'enabled' => true,
-        'min_heading_level' => 2,
-        'max_heading_level' => 4,
     ],
 
     /*
diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 9bbcedc205b..c978fa30447 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -258,11 +258,13 @@ In the `config/docs.php` file you can configure the behaviour, content, and the
 You can also disable the feature completely.
 
 ```php
-'table_of_contents' => [
-    'enabled' => true,
-    'min_heading_level' => 2,
-    'max_heading_level' => 4,
-    'smooth_page_scrolling' => true,
+'sidebar' => [
+    'table_of_contents' => [
+        'enabled' => true,
+        'min_heading_level' => 2,
+        'max_heading_level' => 4,
+        'smooth_page_scrolling' => true,
+    ],
 ],
 ```
 
diff --git a/packages/framework/config/docs.php b/packages/framework/config/docs.php
index 652695339b6..93bbc751dc2 100644
--- a/packages/framework/config/docs.php
+++ b/packages/framework/config/docs.php
@@ -56,23 +56,24 @@
             'installation',
             'getting-started',
         ],
-    ],
 
-    /*
-    |--------------------------------------------------------------------------
-    | Table of Contents Settings
-    |--------------------------------------------------------------------------
-    |
-    | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
-    | has a Table of Contents included. Here, you can configure its behavior,
-    | content, look and feel. You can also disable the feature completely.
-    |
-    */
+        /*
+        |--------------------------------------------------------------------------
+        | Table of Contents Settings
+        |--------------------------------------------------------------------------
+        |
+        | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
+        | has a Table of Contents included. Here, you can configure its behavior,
+        | content, look and feel. You can also disable the feature completely.
+        |
+        */
+
+        'table_of_contents' => [
+            'enabled' => true,
+            'min_heading_level' => 2,
+            'max_heading_level' => 4,
+        ],
 
-    'table_of_contents' => [
-        'enabled' => true,
-        'min_heading_level' => 2,
-        'max_heading_level' => 4,
     ],
 
     /*
diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index 012947357c0..bf97a15f88d 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -12,7 +12,7 @@
             {{ $item->getLabel() }}
         </a>
 
-        @if(config('docs.table_of_contents.enabled', true))
+        @if(config('docs.sidebar.table_of_contents.enabled', true))
             <span class="sr-only">Table of contents</span>
             {!! ($page->getTableOfContents()) !!}
         @endif
diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 0a68d1b032b..2889b0fe419 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -35,8 +35,8 @@ public function execute(): string
                 'position' => 'placeholder',
                 'placeholder' => '[[START_TOC]]',
                 'style' => 'bullet',
-                'min_heading_level' => Config::getInt('docs.table_of_contents.min_heading_level', 2),
-                'max_heading_level' => Config::getInt('docs.table_of_contents.max_heading_level', 4),
+                'min_heading_level' => Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2),
+                'max_heading_level' => Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4),
                 'normalize' => 'relative',
             ],
             'heading_permalink' => [
diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index c9df40fe15c..6ca14b5b9b8 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -51,7 +51,7 @@ public function getOnlineSourcePath(): string|false
 
     public static function hasTableOfContents(): bool
     {
-        return Config::getBool('docs.table_of_contents.enabled', true);
+        return Config::getBool('docs.sidebar.table_of_contents.enabled', true);
     }
 
     /**
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index d3c68a835ef..aac0df233e0 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -192,7 +192,7 @@ public function testMethodCanEnablePermalinksIsAutomaticallyForDocumentationPage
     {
         $service = new MarkdownServiceTestClass(pageClass: DocumentationPage::class);
 
-        Config::set('docs.table_of_contents.enabled', true);
+        Config::set('docs.sidebar.table_of_contents.enabled', true);
 
         $this->assertTrue($service->canEnablePermalinks());
     }
diff --git a/packages/framework/tests/Unit/DocumentationPageTest.php b/packages/framework/tests/Unit/DocumentationPageTest.php
index b725e59477a..9304a4955c1 100644
--- a/packages/framework/tests/Unit/DocumentationPageTest.php
+++ b/packages/framework/tests/Unit/DocumentationPageTest.php
@@ -195,10 +195,10 @@ public function testHasTableOfContents()
     {
         $this->assertIsBool(DocumentationPage::hasTableOfContents());
 
-        Config::set('docs.table_of_contents.enabled', true);
+        Config::set('docs.sidebar.table_of_contents.enabled', true);
         $this->assertTrue(DocumentationPage::hasTableOfContents());
 
-        Config::set('docs.table_of_contents.enabled', false);
+        Config::set('docs.sidebar.table_of_contents.enabled', false);
         $this->assertFalse(DocumentationPage::hasTableOfContents());
     }
 

From 57a013e7936690b0e73cce9a8ea3bb8b5f6da8a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 22 Feb 2024 21:12:27 +0100
Subject: [PATCH 0706/4023] Implement skipped tests

---
 .../AutomaticNavigationConfigurationsTest.php | 25 ++++++++++++++-----
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 98541a8be20..e6f8926327e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -545,6 +545,18 @@ public function testCanMixSubdirectoryDropdownsWithFrontMatterDropdowns()
         ]);
     }
 
+    public function testMainMenuAutomaticDropdownLabelsCanBeSetInConfig()
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.labels' => ['foo' => 'Bar']]);
+
+        $this->assertMenuEquals([
+            ['label' => 'Bar', 'children' => ['Bar']],
+        ], [
+            new MarkdownPage('foo/bar'),
+        ]);
+    }
+
     // Documentation sidebar menu tests
 
     public function testSidebarWithPages()
@@ -846,14 +858,15 @@ public function testSidebarWithConfigLabels()
         ]);
     }
 
-    public function testSidebarDropdownLabelsCanBeSetInConfig()
+    public function testSidebarGroupLabelsCanBeSetInConfig()
     {
-        $this->markTestSkipped('Not yet implemented');
-    }
+        config(['docs.sidebar_group_labels' => ['foo' => 'Bar']]);
 
-    public function testSidebarAutomaticDropdownLabelsCanBeSetInConfig()
-    {
-        $this->markTestSkipped('Not yet implemented');
+        $this->assertSidebarEquals([
+            ['label' => 'Bar', 'children' => ['Bar']],
+        ], [
+            new DocumentationPage('foo/bar'),
+        ]);
     }
 
     public function testSidebarWithConfigHidden()

From af79a2c591795fa3b3a2a18829613239dd08e269 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 11:05:34 +0100
Subject: [PATCH 0707/4023] Support setting sidebar labels in config

---
 .../Factories/NavigationDataFactory.php       | 21 +++++++++++++++++--
 .../AutomaticNavigationConfigurationsTest.php |  2 --
 2 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 7d02a193d4e..2503fa0c027 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -73,7 +73,7 @@ public function toArray(): array
     protected function makeLabel(): ?string
     {
         return $this->searchForLabelInFrontMatter()
-            ?? $this->searchForLabelInConfig()
+            ?? $this->searchForLabelInConfigs()
             ?? $this->getMatter('title')
             ?? $this->title;
     }
@@ -139,7 +139,14 @@ private function searchForPriorityInFrontMatter(): ?int
             ?? $this->getMatter('navigation.order');
     }
 
-    private function searchForLabelInConfig(): ?string
+    private function searchForLabelInConfigs(): ?string
+    {
+        return $this->isInstanceOf(DocumentationPage::class)
+            ? $this->searchForLabelInSidebarConfig()
+            : $this->searchForLabelInNavigationConfig();
+    }
+
+    private function searchForLabelInNavigationConfig(): ?string
     {
         /** @var array<string, string> $config */
         $config = Config::getArray('hyde.navigation.labels', [
@@ -150,6 +157,16 @@ private function searchForLabelInConfig(): ?string
         return $config[$this->routeKey] ?? null;
     }
 
+    private function searchForLabelInSidebarConfig(): ?string
+    {
+        /** @var array<string>|array<string, string> $config */
+        $config = Config::getArray('docs.sidebar.labels', [
+            DocumentationPage::homeRouteName() => 'Docs',
+        ]);
+
+        return $config[$this->routeKey] ?? $config[$this->identifier] ?? null;
+    }
+
     private function searchForPriorityInConfigs(): ?int
     {
         return $this->isInstanceOf(DocumentationPage::class)
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index e6f8926327e..319769282fc 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -847,8 +847,6 @@ public function testSidebarWithMixedConfigOrders()
 
     public function testSidebarWithConfigLabels()
     {
-        $this->markTestSkipped('Not supported (yet?)');
-
         config(['docs.sidebar.labels' => ['foo' => 'First', 'bar' => 'Second', 'baz' => 'Third']]);
 
         $this->assertSidebarEquals(['First', 'Second', 'Third'], [

From 3431ebebd606c4def6aff696f20414d01f5b7330 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 11:25:06 +0100
Subject: [PATCH 0708/4023] Generate tests from patch using GPT 4

---
 .../Unit/NavigationDataFactoryUnitTest.php    | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 9674273bf75..1b764372e0c 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -146,6 +146,53 @@ public function testRouteKeysCanBeUsedForDocumentationSidebarPriorities()
         $this->assertSame(502, $factory->makePriority());
     }
 
+    public function testSearchForLabelInNavigationConfigForMarkdownPage()
+    {
+        self::mockConfig([
+            'hyde.navigation.labels' => [
+                'foo' => 'Foo Label',
+                'bar' => 'Bar Label',
+            ],
+        ]);
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'foo'));
+        $this->assertSame('Foo Label', $factory->makeLabel());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'bar'));
+        $this->assertSame('Bar Label', $factory->makeLabel());
+    }
+
+    public function testSearchForLabelInSidebarConfigForDocumentationPage()
+    {
+        self::mockConfig([
+            'docs.sidebar.labels' => [
+                'foo' => 'Documentation Foo Label',
+                'bar' => 'Documentation Bar Label',
+            ],
+        ]);
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'foo', pageClass: DocumentationPage::class));
+        $this->assertSame('Documentation Foo Label', $factory->makeLabel());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'bar', pageClass: DocumentationPage::class));
+        $this->assertSame('Documentation Bar Label', $factory->makeLabel());
+    }
+
+    public function testLabelFallbackToTitleIfNotDefinedInConfig()
+    {
+        self::mockConfig([
+            'hyde.navigation.labels' => [],
+            'docs.sidebar.labels' => [],
+        ]);
+
+        // Assuming the title fallback is correctly set in front matter or title property
+        $frontMatter = new FrontMatter(['title' => 'Fallback Title']);
+        $coreDataObject = new CoreDataObject($frontMatter, new Markdown(), MarkdownPage::class, '', '', '', 'undefinedKey');
+
+        $factory = new NavigationConfigTestClass($coreDataObject);
+        $this->assertSame('Fallback Title', $factory->makeLabel());
+    }
+
     protected function makeCoreDataObject(string $identifier = '', string $routeKey = '', string $pageClass = MarkdownPage::class): CoreDataObject
     {
         return new CoreDataObject(new FrontMatter(), new Markdown(), $pageClass, $identifier, '', '', $routeKey);
@@ -163,4 +210,9 @@ public function makePriority(): int
     {
         return parent::makePriority();
     }
+
+    public function makeLabel(): ?string
+    {
+        return parent::makeLabel();
+    }
 }

From 7adb3435e1bce47829b679d5a2171502f85b2f39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 12:22:41 +0100
Subject: [PATCH 0709/4023] Support setting sidebar hidden state in config

---
 .../Factories/NavigationDataFactory.php          | 16 +++++++++++++++-
 .../AutomaticNavigationConfigurationsTest.php    |  2 --
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 2503fa0c027..6a40d250ece 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -91,7 +91,7 @@ protected function makeHidden(): bool
     {
         return $this->isInstanceOf(MarkdownPost::class)
             || $this->searchForHiddenInFrontMatter()
-            || $this->isPageHiddenInNavigationConfiguration()
+            || $this->searchForHiddenInConfigs()
             || $this->isNonDocumentationPageInHiddenSubdirectory();
     }
 
@@ -120,11 +120,25 @@ private function searchForHiddenInFrontMatter(): ?bool
             ?? $this->invert($this->getMatter('navigation.visible'));
     }
 
+    private function searchForHiddenInConfigs(): ?bool
+    {
+        return $this->isInstanceOf(DocumentationPage::class)
+            ? $this->isPageHiddenInSidebarConfiguration()
+            : $this->isPageHiddenInNavigationConfiguration();
+    }
+
     private function isPageHiddenInNavigationConfiguration(): ?bool
     {
         return in_array($this->routeKey, Config::getArray('hyde.navigation.exclude', ['404']));
     }
 
+    private function isPageHiddenInSidebarConfiguration(): ?bool
+    {
+        $config = Config::getArray('docs.sidebar.exclude', ['404']);
+
+        return in_array($this->routeKey, $config) || in_array($this->identifier, $config);
+    }
+
     private function isNonDocumentationPageInHiddenSubdirectory(): bool
     {
         return ! $this->isInstanceOf(DocumentationPage::class)
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 319769282fc..16436394c3e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -869,8 +869,6 @@ public function testSidebarGroupLabelsCanBeSetInConfig()
 
     public function testSidebarWithConfigHidden()
     {
-        $this->markTestSkipped('Not supported (yet?)');
-
         config(['docs.sidebar.exclude' => ['foo', 'bar', 'baz']]);
 
         $this->assertSidebarEquals([], [

From 2f0c88cba582a210463964430297753697acf884 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 12:31:13 +0100
Subject: [PATCH 0710/4023] Add auxiliary check to allow hiding docs index from
 main navigation

For backwards compatibility we keep this desired logic
---
 .../framework/src/Framework/Factories/NavigationDataFactory.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 6a40d250ece..c6c62d3c9e1 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -136,7 +136,7 @@ private function isPageHiddenInSidebarConfiguration(): ?bool
     {
         $config = Config::getArray('docs.sidebar.exclude', ['404']);
 
-        return in_array($this->routeKey, $config) || in_array($this->identifier, $config);
+        return in_array($this->routeKey, $config) || in_array($this->identifier, $config) || $this->isPageHiddenInNavigationConfiguration();
     }
 
     private function isNonDocumentationPageInHiddenSubdirectory(): bool

From f4606cc8edef4ba7d03ff90fd7a5cfbba3f68844 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 12:32:32 +0100
Subject: [PATCH 0711/4023] Generate tests from patch using GPT 4

---
 .../Unit/NavigationDataFactoryUnitTest.php    | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 1b764372e0c..85719ae6611 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -193,6 +193,50 @@ public function testLabelFallbackToTitleIfNotDefinedInConfig()
         $this->assertSame('Fallback Title', $factory->makeLabel());
     }
 
+    public function testPageIsHiddenBasedOnNavigationConfiguration()
+    {
+        self::mockConfig(['hyde.navigation.exclude' => ['hiddenPage']]);
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'hiddenPage'));
+        $this->assertTrue($factory->makeHidden());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'visiblePage'));
+        $this->assertFalse($factory->makeHidden());
+    }
+
+    public function testPageIsHiddenBasedOnSidebarConfigurationForDocumentationPage()
+    {
+        self::mockConfig(['docs.sidebar.exclude' => ['hiddenDocPage']]);
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject('hiddenDocPage', pageClass: DocumentationPage::class));
+        $this->assertTrue($factory->makeHidden());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject('visibleDocPage', pageClass: DocumentationPage::class));
+        $this->assertFalse($factory->makeHidden());
+    }
+
+    public function testSearchForHiddenInConfigsSelectsCorrectConfigurationBasedOnPageType()
+    {
+        self::mockConfig([
+            'hyde.navigation.exclude' => ['hiddenPage'],
+            'docs.sidebar.exclude' => ['hiddenDocPage'],
+        ]);
+
+        // Test for a Markdown page, should use navigation.exclude config
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'hiddenPage'));
+        $this->assertTrue($factory->makeHidden());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject(routeKey: 'visiblePage'));
+        $this->assertFalse($factory->makeHidden());
+
+        // Test for a Documentation page, should use docs.sidebar.exclude config
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject('hiddenDocPage', pageClass: DocumentationPage::class));
+        $this->assertTrue($factory->makeHidden());
+
+        $factory = new NavigationConfigTestClass($this->makeCoreDataObject('visibleDocPage', pageClass: DocumentationPage::class));
+        $this->assertFalse($factory->makeHidden());
+    }
+
     protected function makeCoreDataObject(string $identifier = '', string $routeKey = '', string $pageClass = MarkdownPage::class): CoreDataObject
     {
         return new CoreDataObject(new FrontMatter(), new Markdown(), $pageClass, $identifier, '', '', $routeKey);
@@ -215,4 +259,9 @@ public function makeLabel(): ?string
     {
         return parent::makeLabel();
     }
+
+    public function makeHidden(): bool
+    {
+        return parent::makeHidden();
+    }
 }

From b93174f9926b8ddfecb7b7c7504e09ba1dc68710 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 12:32:38 +0100
Subject: [PATCH 0712/4023] Document reasoning behind code

---
 .../src/Framework/Factories/NavigationDataFactory.php       | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index c6c62d3c9e1..e131e6adb21 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -136,7 +136,11 @@ private function isPageHiddenInSidebarConfiguration(): ?bool
     {
         $config = Config::getArray('docs.sidebar.exclude', ['404']);
 
-        return in_array($this->routeKey, $config) || in_array($this->identifier, $config) || $this->isPageHiddenInNavigationConfiguration();
+        return
+            // Check if the page is hidden from the sidebar by route key or identifier.
+            (in_array($this->routeKey, $config) || in_array($this->identifier, $config))
+            // Check if the page is hidden from the main navigation by its route key.
+            || $this->isPageHiddenInNavigationConfiguration();
     }
 
     private function isNonDocumentationPageInHiddenSubdirectory(): bool

From 956b5e387c7b19731cc3623aee2ad3495facd4c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 21:03:06 +0100
Subject: [PATCH 0713/4023] Clarify test method name

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 16436394c3e..4687c25118a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -407,7 +407,7 @@ public function testMainNavigationDropdownLabelsCanBeSetInConfig()
         $this->markTestSkipped('Not yet implemented');
     }
 
-    public function testMainNavigationAutomaticDropdownLabelsCanBeSetInConfig()
+    public function testMainNavigationAutomaticSubdirectoryDropdownLabelsCanBeSetInConfig()
     {
         $this->markTestSkipped('Not yet implemented');
     }

From aa55e5f3b1f953c8d95a657c5e86aa1c2ef78305 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 21:20:40 +0100
Subject: [PATCH 0714/4023] Implement test

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 4687c25118a..064f1a9b50c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -404,7 +404,12 @@ public function testMainNavigationMenuWithConfigLabels()
 
     public function testMainNavigationDropdownLabelsCanBeSetInConfig()
     {
-        $this->markTestSkipped('Not yet implemented');
+        config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
+        config(['hyde.navigation.labels' => ['foo' => 'Bar']]);
+
+        $this->assertMenuEquals(['Bar'], [
+            new MarkdownPage('child', ['navigation.group' => 'foo']),
+        ]);
     }
 
     public function testMainNavigationAutomaticSubdirectoryDropdownLabelsCanBeSetInConfig()

From 98459bbf1919ba908ab4451a3a07064b662dc510 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 21:21:00 +0100
Subject: [PATCH 0715/4023] Change test data to be clearer

Foo be confusing sometimes
---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 064f1a9b50c..f3012979fe0 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -405,10 +405,10 @@ public function testMainNavigationMenuWithConfigLabels()
     public function testMainNavigationDropdownLabelsCanBeSetInConfig()
     {
         config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
-        config(['hyde.navigation.labels' => ['foo' => 'Bar']]);
+        config(['hyde.navigation.labels' => ['hello' => 'World']]);
 
-        $this->assertMenuEquals(['Bar'], [
-            new MarkdownPage('child', ['navigation.group' => 'foo']),
+        $this->assertMenuEquals(['World'], [
+            new MarkdownPage('foo', ['navigation.group' => 'Hello']),
         ]);
     }
 

From aa4fc0f4eaef9d3776582889a61180c3b2d6ac5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 23 Feb 2024 21:22:54 +0100
Subject: [PATCH 0716/4023] Implement test

---
 .../Feature/AutomaticNavigationConfigurationsTest.php      | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index f3012979fe0..8c8142bbcea 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -414,7 +414,12 @@ public function testMainNavigationDropdownLabelsCanBeSetInConfig()
 
     public function testMainNavigationAutomaticSubdirectoryDropdownLabelsCanBeSetInConfig()
     {
-        $this->markTestSkipped('Not yet implemented');
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.labels' => ['hello' => 'World']]);
+
+        $this->assertMenuEquals(['World'], [
+            new MarkdownPage('hello/world'),
+        ]);
     }
 
     public function testMainNavigationMenuWithConfigHidden()

From 6dd834b38efa8520c464dc2d908c50d0dc98b6af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:26:24 +0100
Subject: [PATCH 0717/4023] Clarify helper method name

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3f2d3d54480..042f8186f44 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -33,12 +33,12 @@ public function hasGroups(): bool
     public function isGroupActive(string $group): bool
     {
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
-        $currentPageIsIndexPageAndShouldBeActive = $this->isPageIndexPage() && $this->shouldIndexPageBeActive($group);
+        $currentPageIsIndexPageAndShouldBeActive = $this->isCurrentPageIndexPage() && $this->shouldIndexPageBeActive($group);
 
         return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;
     }
 
-    private function isPageIndexPage(): bool
+    private function isCurrentPageIndexPage(): bool
     {
         return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
     }

From 3f68b03631c433b1c25982179646d32ce14dd6d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:29:33 +0100
Subject: [PATCH 0718/4023] Remove unnecessary type annotation comment

---
 .../resources/views/components/docs/sidebar-items.blade.php      | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 615ea53dcd4..9f7bfc12451 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -1,4 +1,3 @@
-@php /** @var \Hyde\Framework\Features\Navigation\DocumentationSidebar $sidebar */ @endphp
 @if(! $sidebar->hasGroups())
     <ul id="sidebar-items" role="list" class="pl-2">
         @foreach ($sidebar->getItems() as $item)

From 1f433e30f28d42f9dfc41a280c5a911c84fc3323 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:36:29 +0100
Subject: [PATCH 0719/4023] Create DocumentationSidebarUnitTest.php

---
 .../tests/Unit/DocumentationSidebarUnitTest.php | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
new file mode 100644
index 00000000000..a12224bee2a
--- /dev/null
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
+ */
+class DocumentationSidebarUnitTest extends UnitTestCase
+{
+    //
+}

From e35d45807e66e1ca29917103d7a6192628ced5de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:37:02 +0100
Subject: [PATCH 0720/4023] Link to unit test

---
 .../tests/Feature/Services/DocumentationSidebarTest.php         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 3bb0b2b6545..35de82258a4 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -24,6 +24,8 @@
  * @covers \Hyde\Framework\Factories\Concerns\HasFactory
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavItem
+ *
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarUnitTest
  */
 class DocumentationSidebarTest extends TestCase
 {

From 5323caf22b08ff370035b6060645e93a96096647 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:40:51 +0100
Subject: [PATCH 0721/4023] Copy over and adapt unit tests from navigation menu
 unit test

---
 .../Unit/DocumentationSidebarUnitTest.php     | 101 +++++++++++++++++-
 1 file changed, 100 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index a12224bee2a..f8123b073e3 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -5,6 +5,10 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\Collection;
+use Hyde\Support\Models\ExternalRoute;
+use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
@@ -13,5 +17,100 @@
  */
 class DocumentationSidebarUnitTest extends UnitTestCase
 {
-    //
+    public function testCanConstruct()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar());
+    }
+
+    public function testCanConstructWithItemsArray()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar($this->getItems()));
+    }
+
+    public function testCanConstructWithItemsArrayable()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar(collect($this->getItems())));
+    }
+
+    public function testGetItemsReturnsCollection()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar())->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArray()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar($this->getItems()))->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar(collect($this->getItems())))->getItems());
+    }
+
+    public function testGetItemsReturnsItems()
+    {
+        $items = $this->getItems();
+
+        $this->assertSame($items, (new DocumentationSidebar($items))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsItemsWhenSuppliedArrayable()
+    {
+        $items = $this->getItems();
+
+        $this->assertSame($items, (new DocumentationSidebar(collect($items)))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsEmptyArrayWhenNoItems()
+    {
+        $this->assertSame([], (new DocumentationSidebar())->getItems()->all());
+    }
+
+    public function testCanAddItems()
+    {
+        $menu = new DocumentationSidebar();
+        $item = new NavItem(new ExternalRoute('/'), 'Home');
+
+        $menu->add($item);
+
+        $this->assertCount(1, $menu->getItems());
+        $this->assertSame($item, $menu->getItems()->first());
+    }
+
+    public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
+    {
+        $menu = new DocumentationSidebar();
+        $item1 = new NavItem(new ExternalRoute('/'), 'Home');
+        $item2 = new NavItem(new ExternalRoute('/about'), 'About');
+        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
+
+        $menu->add($item1);
+        $menu->add($item2);
+        $menu->add($item3);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
+    public function testItemsAreSortedByPriority()
+    {
+        $menu = new DocumentationSidebar();
+        $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
+        $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
+        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
+
+        $menu->add($item3);
+        $menu->add($item1);
+        $menu->add($item2);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
+    protected function getItems(): array
+    {
+        return [
+            new NavItem(new ExternalRoute('/'), 'Home'),
+            new NavItem(new ExternalRoute('/about'), 'About'),
+            new NavItem(new ExternalRoute('/contact'), 'Contact'),
+        ];
+    }
 }

From a41b5aa1dc9977c2b909f232439c87bf02d5f37e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:46:35 +0100
Subject: [PATCH 0722/4023] Extract testing helper method

---
 .../Unit/DocumentationSidebarUnitTest.php     | 25 +++++++++++--------
 .../tests/Unit/NavigationMenuUnitTest.php     | 25 +++++++++++--------
 2 files changed, 30 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index f8123b073e3..0b5f6e170b8 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -69,7 +69,7 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new DocumentationSidebar();
-        $item = new NavItem(new ExternalRoute('/'), 'Home');
+        $item = $this->item('/', 'Home');
 
         $menu->add($item);
 
@@ -80,9 +80,9 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new DocumentationSidebar();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home');
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About');
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
+        $item1 = $this->item('/', 'Home');
+        $item2 = $this->item('/about', 'About');
+        $item3 = $this->item('/contact', 'Contact');
 
         $menu->add($item1);
         $menu->add($item2);
@@ -94,9 +94,9 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new DocumentationSidebar();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
+        $item1 = $this->item('/', 'Home', 100);
+        $item2 = $this->item('/about', 'About', 200);
+        $item3 = $this->item('/contact', 'Contact', 300);
 
         $menu->add($item3);
         $menu->add($item1);
@@ -108,9 +108,14 @@ public function testItemsAreSortedByPriority()
     protected function getItems(): array
     {
         return [
-            new NavItem(new ExternalRoute('/'), 'Home'),
-            new NavItem(new ExternalRoute('/about'), 'About'),
-            new NavItem(new ExternalRoute('/contact'), 'Contact'),
+            $this->item('/', 'Home'),
+            $this->item('/about', 'About'),
+            $this->item('/contact', 'Contact'),
         ];
     }
+
+    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    {
+        return new NavItem(new ExternalRoute($destination), $label, $priority);
+    }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 1b0f9a08a58..aa654e3cf2b 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -70,7 +70,7 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new MainNavigationMenu();
-        $item = new NavItem(new ExternalRoute('/'), 'Home');
+        $item = $this->item('/', 'Home');
 
         $menu->add($item);
 
@@ -81,9 +81,9 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new MainNavigationMenu();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home');
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About');
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
+        $item1 = $this->item('/', 'Home');
+        $item2 = $this->item('/about', 'About');
+        $item3 = $this->item('/contact', 'Contact');
 
         $menu->add($item1);
         $menu->add($item2);
@@ -95,9 +95,9 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new MainNavigationMenu();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
+        $item1 = $this->item('/', 'Home', 100);
+        $item2 = $this->item('/about', 'About', 200);
+        $item3 = $this->item('/contact', 'Contact', 300);
 
         $menu->add($item3);
         $menu->add($item1);
@@ -109,9 +109,14 @@ public function testItemsAreSortedByPriority()
     protected function getItems(): array
     {
         return [
-            new NavItem(new ExternalRoute('/'), 'Home'),
-            new NavItem(new ExternalRoute('/about'), 'About'),
-            new NavItem(new ExternalRoute('/contact'), 'Contact'),
+            $this->item('/', 'Home'),
+            $this->item('/about', 'About'),
+            $this->item('/contact', 'Contact'),
         ];
     }
+
+    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    {
+        return new NavItem(new ExternalRoute($destination), $label, $priority);
+    }
 }

From 29b14d6ea425972f7c92092e85ad3f356b751a05 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:54:51 +0100
Subject: [PATCH 0723/4023] Cover base class

---
 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 0b5f6e170b8..cce704cd337 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -12,6 +12,7 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
  */

From e5a298976487cfde3ba8a730f18d78355034bc24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:55:07 +0100
Subject: [PATCH 0724/4023] Update test data to better suit subject

---
 .../Unit/DocumentationSidebarUnitTest.php     | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index cce704cd337..b8db1d1ad6f 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -70,7 +70,7 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new DocumentationSidebar();
-        $item = $this->item('/', 'Home');
+        $item = $this->item('/', 'Docs');
 
         $menu->add($item);
 
@@ -81,9 +81,9 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new DocumentationSidebar();
-        $item1 = $this->item('/', 'Home');
-        $item2 = $this->item('/about', 'About');
-        $item3 = $this->item('/contact', 'Contact');
+        $item1 = $this->item('/', 'Docs');
+        $item2 = $this->item('/installation', 'Installation');
+        $item3 = $this->item('/getting-started', 'Getting Started');
 
         $menu->add($item1);
         $menu->add($item2);
@@ -95,9 +95,9 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new DocumentationSidebar();
-        $item1 = $this->item('/', 'Home', 100);
-        $item2 = $this->item('/about', 'About', 200);
-        $item3 = $this->item('/contact', 'Contact', 300);
+        $item1 = $this->item('/', 'Docs', 100);
+        $item2 = $this->item('/installation', 'Installation', 200);
+        $item3 = $this->item('/getting-started', 'Getting Started', 300);
 
         $menu->add($item3);
         $menu->add($item1);
@@ -109,9 +109,9 @@ public function testItemsAreSortedByPriority()
     protected function getItems(): array
     {
         return [
-            $this->item('/', 'Home'),
-            $this->item('/about', 'About'),
-            $this->item('/contact', 'Contact'),
+            $this->item('/', 'Docs'),
+            $this->item('/installation', 'Installation'),
+            $this->item('/getting-started', 'Getting Started'),
         ];
     }
 

From b3aad5a8e1baf17049dd94e78ebfd2c1f846843d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 13:56:01 +0100
Subject: [PATCH 0725/4023] Format test code

---
 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php | 3 +++
 packages/framework/tests/Unit/NavigationMenuUnitTest.php       | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index b8db1d1ad6f..2fd02cfd2cc 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -70,6 +70,7 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new DocumentationSidebar();
+
         $item = $this->item('/', 'Docs');
 
         $menu->add($item);
@@ -81,6 +82,7 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new DocumentationSidebar();
+
         $item1 = $this->item('/', 'Docs');
         $item2 = $this->item('/installation', 'Installation');
         $item3 = $this->item('/getting-started', 'Getting Started');
@@ -95,6 +97,7 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new DocumentationSidebar();
+
         $item1 = $this->item('/', 'Docs', 100);
         $item2 = $this->item('/installation', 'Installation', 200);
         $item3 = $this->item('/getting-started', 'Getting Started', 300);
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index aa654e3cf2b..5a9d765ea1c 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -70,6 +70,7 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new MainNavigationMenu();
+
         $item = $this->item('/', 'Home');
 
         $menu->add($item);
@@ -81,6 +82,7 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new MainNavigationMenu();
+
         $item1 = $this->item('/', 'Home');
         $item2 = $this->item('/about', 'About');
         $item3 = $this->item('/contact', 'Contact');
@@ -95,6 +97,7 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new MainNavigationMenu();
+
         $item1 = $this->item('/', 'Home', 100);
         $item2 = $this->item('/about', 'About', 200);
         $item3 = $this->item('/contact', 'Contact', 300);

From 86487fb9982bac1c7278dae6801cd1955af3d809 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:11:26 +0100
Subject: [PATCH 0726/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 69b8b18bac3..487f5c78135 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -206,6 +206,8 @@ public function addChild(NavItem $item): void
         $this->children[] = $item;
     }
 
+    // Todo add method to add multiple children at once?
+
     protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;

From 6d91c3171882d043822ab4470846398901c4228d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:12:05 +0100
Subject: [PATCH 0727/4023] Make `NavItem::addChild` method fluent

---
 .../src/Framework/Features/Navigation/NavItem.php         | 4 +++-
 packages/framework/tests/Unit/NavItemTest.php             | 8 ++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 487f5c78135..5be8695d751 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -199,11 +199,13 @@ public function isCurrent(): bool
     /**
      * Add a navigation item to the children of the navigation item.
      */
-    public function addChild(NavItem $item): void
+    public function addChild(NavItem $item): static
     {
         // Todo: Ensure that the item has a group identifier by creating it from the label if it doesn't exist?
 
         $this->children[] = $item;
+
+        return $this;
     }
 
     // Todo add method to add multiple children at once?
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index f2caf94538c..754d536f1ac 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -396,4 +396,12 @@ public function testCanAddItemToDropdown()
 
         $this->assertSame([$child], $parent->getChildren());
     }
+
+    public function testAddChildMethodReturnsSelf()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+
+        $this->assertSame($parent, $parent->addChild($child));
+    }
 }

From 14c40a8eba8b94b7812bdfdd02ca8fbb77220bb5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:14:49 +0100
Subject: [PATCH 0728/4023] Unit test has groups method

---
 .../Unit/DocumentationSidebarUnitTest.php     | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 2fd02cfd2cc..30aee410386 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavItem;
@@ -109,6 +110,25 @@ public function testItemsAreSortedByPriority()
         $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
     }
 
+    public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
+    {
+        $this->assertFalse((new DocumentationSidebar())->hasGroups());
+    }
+
+    public function testHasGroupsReturnsTrueWhenAtLeastOneItemHasChildren()
+    {
+        self::mockConfig();
+        self::setupKernel();
+
+        $page = new DocumentationPage('foo');
+        $child = new DocumentationPage('bar');
+        $menu = new DocumentationSidebar([
+            NavItem::fromRoute($page->getRoute())->addChild(NavItem::fromRoute($child->getRoute())),
+        ]);
+
+        $this->assertTrue($menu->hasGroups());
+    }
+
     protected function getItems(): array
     {
         return [

From ae36b95f4c4ec1fcbeea0ba798fc9cbf2b56c91d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:18:38 +0100
Subject: [PATCH 0729/4023] Categorize tests

---
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php     | 4 ++++
 packages/framework/tests/Unit/NavigationMenuUnitTest.php      | 2 ++
 2 files changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 30aee410386..f4cba3feb81 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -19,6 +19,8 @@
  */
 class DocumentationSidebarUnitTest extends UnitTestCase
 {
+    // Base menu tests
+
     public function testCanConstruct()
     {
         $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar());
@@ -110,6 +112,8 @@ public function testItemsAreSortedByPriority()
         $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
     }
 
+    // Sidebar specific tests
+
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 5a9d765ea1c..60948237682 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -18,6 +18,8 @@
  */
 class NavigationMenuUnitTest extends UnitTestCase
 {
+    // Base menu tests
+
     public function testCanConstruct()
     {
         $this->assertInstanceOf(MainNavigationMenu::class, new MainNavigationMenu());

From b456e324c6f87d4194e8e21997ec9ac2c6fc9e3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:19:04 +0100
Subject: [PATCH 0730/4023] Add test crosslinks

---
 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php | 1 +
 packages/framework/tests/Unit/NavigationMenuUnitTest.php       | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index f4cba3feb81..f6278a9291b 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -16,6 +16,7 @@
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
+ * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
  */
 class DocumentationSidebarUnitTest extends UnitTestCase
 {
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 60948237682..648bb55a092 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -15,6 +15,7 @@
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\NavigationMenuTest
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarUnitTest
  */
 class NavigationMenuUnitTest extends UnitTestCase
 {

From f01159a59d936865b470cace8e3ea690c585fcfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:20:11 +0100
Subject: [PATCH 0731/4023] Test get method resolves instance from service
 container

---
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php  | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index f6278a9291b..6b0a4e75484 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -115,6 +115,13 @@ public function testItemsAreSortedByPriority()
 
     // Sidebar specific tests
 
+    public function testGetMethodResolvesInstanceFromServiceContainer()
+    {
+        app()->instance('navigation.sidebar', $instance = new DocumentationSidebar());
+
+        $this->assertSame($instance, DocumentationSidebar::get());
+    }
+
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());

From 36493489eb5dd7f9a4d63a50bc35d5d7ba83ff8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:28:56 +0100
Subject: [PATCH 0732/4023] Add child constructor

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 042f8186f44..4300899ecdf 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -6,6 +6,7 @@
 
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
+use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Support\Str;
 
 use function app;
@@ -20,6 +21,11 @@ public static function get(): static
         return app('navigation.sidebar');
     }
 
+    public function __construct(Arrayable|array $items = [])
+    {
+        parent::__construct($items);
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());

From 1718f53390ecb9c87bd6e9d6bc8545ca0f4f9796 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 14:31:27 +0100
Subject: [PATCH 0733/4023] Add config accessor to the sidebar class

---
 .../Navigation/DocumentationSidebar.php       |  6 ++++++
 .../Unit/DocumentationSidebarUnitTest.php     | 21 +++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4300899ecdf..dab898839fa 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
 use Illuminate\Contracts\Support\Arrayable;
@@ -26,6 +27,11 @@ public function __construct(Arrayable|array $items = [])
         parent::__construct($items);
     }
 
+    public function isCollapsible(): bool
+    {
+        return Config::getBool('docs.sidebar.collapsible', true);
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 6b0a4e75484..71ebb676c4f 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -122,6 +122,27 @@ public function testGetMethodResolvesInstanceFromServiceContainer()
         $this->assertSame($instance, DocumentationSidebar::get());
     }
 
+    public function testIsCollapsibleReturnsTrueByDefault()
+    {
+        self::mockConfig();
+
+        $this->assertTrue((new DocumentationSidebar())->isCollapsible());
+    }
+
+    public function testIsCollapsibleReturnsTrueWhenConfigIsTrue()
+    {
+        self::mockConfig(['docs.sidebar.collapsible' => true]);
+
+        $this->assertTrue((new DocumentationSidebar())->isCollapsible());
+    }
+
+    public function testIsCollapsibleReturnsFalseWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.collapsible' => false]);
+
+        $this->assertFalse((new DocumentationSidebar())->isCollapsible());
+    }
+
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());

From 2fe21b8b368827b772527118dfafa52fdb85be8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 15:12:26 +0100
Subject: [PATCH 0734/4023] Use sidebar accessor method

---
 .../resources/views/components/docs/sidebar-items.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 9f7bfc12451..c029cfe468a 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -6,7 +6,7 @@
     </ul>
 @else
     <ul id="sidebar-items" role="list">
-        @php ($collapsible = config('docs.sidebar.collapsible', true))
+        @php ($collapsible = $sidebar->isCollapsible())
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $collapsible]) @if($collapsible) @click="groupOpen = ! groupOpen" @endif>

From 0de41c6d263dc99b51330aa0beca84f678118e67 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 15:12:41 +0100
Subject: [PATCH 0735/4023] Inline Blade variable

---
 .../views/components/docs/sidebar-items.blade.php     | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index c029cfe468a..2485420d786 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -6,16 +6,15 @@
     </ul>
 @else
     <ul id="sidebar-items" role="list">
-        @php ($collapsible = $sidebar->isCollapsible())
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($collapsible) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
-                <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $collapsible]) @if($collapsible) @click="groupOpen = ! groupOpen" @endif>
-                    <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $collapsible])>{{ $group->getLabel() }}</h4>
-                    @if($collapsible)
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
+                <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
+                    <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
+                    @if($sidebar->isCollapsible())
                         @include('hyde::components.docs.sidebar-group-toggle-button')
                     @endif
                 </header>
-                <ul class="sidebar-group-items ml-4 px-2 mb-2" role="list" @if($collapsible) x-show="groupOpen" @endif>
+                <ul class="sidebar-group-items ml-4 px-2 mb-2" role="list" @if($sidebar->isCollapsible()) x-show="groupOpen" @endif>
                     @foreach ($group->getChildren() as $item)
                         @include('hyde::components.docs.sidebar-item', ['grouped' => true])
                     @endforeach

From 381ada17cda32dce1cafe79198d94ef41c3ef046 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 17:58:30 +0100
Subject: [PATCH 0736/4023] Remove unnecessary type annotation comment

---
 .../resources/views/components/docs/sidebar-item.blade.php       | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index bf97a15f88d..caa2472f043 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -1,4 +1,3 @@
-@php /** @var \Hyde\Framework\Features\Navigation\NavItem $item */ @endphp
 @props(['grouped' => false])
 <li @class(['sidebar-item -ml-4 pl-4', $grouped
         ? 'active -ml-8 pl-8 bg-black/5 dark:bg-black/10'

From 959654c4900def9f30f2e9fe12275149c2343508 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 18:00:24 +0100
Subject: [PATCH 0737/4023] Remove unnecessary parentheses

---
 .../resources/views/components/docs/sidebar-item.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index caa2472f043..cb0274b5304 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -13,7 +13,7 @@
 
         @if(config('docs.sidebar.table_of_contents.enabled', true))
             <span class="sr-only">Table of contents</span>
-            {!! ($page->getTableOfContents()) !!}
+            {!! $page->getTableOfContents() !!}
         @endif
     @else
         <a href="{{ $item->getDestination() }}" @class([$grouped

From 0e56c4b3b527543a3923287777acfc862459b028 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 18:02:55 +0100
Subject: [PATCH 0738/4023] Add config accessor for the sidebar footer state

---
 .../Navigation/DocumentationSidebar.php       |  5 +++++
 .../Unit/DocumentationSidebarUnitTest.php     | 21 +++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index dab898839fa..b75d3382bbe 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -32,6 +32,11 @@ public function isCollapsible(): bool
         return Config::getBool('docs.sidebar.collapsible', true);
     }
 
+    public function hasFooter(): bool
+    {
+        return Config::getBool('docs.sidebar.footer', true);
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 71ebb676c4f..b2c9d2451c2 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -143,6 +143,27 @@ public function testIsCollapsibleReturnsFalseWhenConfigIsFalse()
         $this->assertFalse((new DocumentationSidebar())->isCollapsible());
     }
 
+    public function testHasFooterReturnsTrueByDefault()
+    {
+        self::mockConfig();
+
+        $this->assertTrue((new DocumentationSidebar())->hasFooter());
+    }
+
+    public function testHasFooterReturnsTrueWhenConfigIsTrue()
+    {
+        self::mockConfig(['docs.sidebar.footer' => true]);
+
+        $this->assertTrue((new DocumentationSidebar())->hasFooter());
+    }
+
+    public function testHasFooterReturnsFalseWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.footer' => false]);
+
+        $this->assertFalse((new DocumentationSidebar())->hasFooter());
+    }
+
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());

From afb462697fb076b05cd0233a1bea45df7871e1d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 18:09:26 +0100
Subject: [PATCH 0739/4023] Ensure compatibility with string values

Uses strict typing, though it could also return a bool cast to make 'false' and '' be false, but I prefer strict typing and want to nudge people to use false if they explicably want the sidebar footer to be disabled.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 5 +++++
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php  | 7 +++++++
 2 files changed, 12 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b75d3382bbe..763ab097f60 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -11,6 +11,7 @@
 use Illuminate\Support\Str;
 
 use function app;
+use function is_string;
 
 class DocumentationSidebar extends NavigationMenu
 {
@@ -34,6 +35,10 @@ public function isCollapsible(): bool
 
     public function hasFooter(): bool
     {
+        if (is_string(Config::get('docs.sidebar.footer'))) {
+            return true;
+        }
+
         return Config::getBool('docs.sidebar.footer', true);
     }
 
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index b2c9d2451c2..a3d8db53a54 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -150,6 +150,13 @@ public function testHasFooterReturnsTrueByDefault()
         $this->assertTrue((new DocumentationSidebar())->hasFooter());
     }
 
+    public function testHasFooterReturnsTrueWhenConfigIsString()
+    {
+        self::mockConfig(['docs.sidebar.footer' => 'Some footer content']);
+
+        $this->assertTrue((new DocumentationSidebar())->hasFooter());
+    }
+
     public function testHasFooterReturnsTrueWhenConfigIsTrue()
     {
         self::mockConfig(['docs.sidebar.footer' => true]);

From 89598f3dcb57de427ebb4fb36c7a1664f10298b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 18:11:26 +0100
Subject: [PATCH 0740/4023] Use the footer state accessor

---
 .../framework/resources/views/components/docs/sidebar.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 9cd5dad15c4..866b1813714 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -7,7 +7,7 @@
             'sidebar' => app('navigation.sidebar'),
         ])
     </nav>
-    @if(config('docs.sidebar.footer', true) !== false)
+    @if(app('navigation.sidebar')->hasFooter())
         <footer id="sidebar-footer" class="h-16 p-4 w-full bottom-0 left-0 text-center leading-8">
             @include('hyde::components.docs.sidebar-footer-text')
         </footer>

From 923d0301e3d673dae9e28adf9ad6a439ff76bd7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 18:12:06 +0100
Subject: [PATCH 0741/4023] Set default value

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 763ab097f60..92dbd6cd5d8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -35,7 +35,7 @@ public function isCollapsible(): bool
 
     public function hasFooter(): bool
     {
-        if (is_string(Config::get('docs.sidebar.footer'))) {
+        if (is_string(Config::get('docs.sidebar.footer', true))) {
             return true;
         }
 

From b5223fcd81c175e565f59a89647faeb985f6211f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 19:44:21 +0100
Subject: [PATCH 0742/4023] Add footer config accessor

---
 .../Navigation/DocumentationSidebar.php       |  5 ++++
 .../Unit/DocumentationSidebarUnitTest.php     | 28 +++++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 92dbd6cd5d8..426f708e509 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -23,6 +23,11 @@ public static function get(): static
         return app('navigation.sidebar');
     }
 
+    public function getFooter(): bool|string
+    {
+        return Config::get('docs.sidebar.footer', true);
+    }
+
     public function __construct(Arrayable|array $items = [])
     {
         parent::__construct($items);
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index a3d8db53a54..e85a7aca302 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -122,6 +122,34 @@ public function testGetMethodResolvesInstanceFromServiceContainer()
         $this->assertSame($instance, DocumentationSidebar::get());
     }
 
+    public function testGetFooterReturnsTrueByDefault()
+    {
+        self::mockConfig();
+
+        $this->assertTrue((new DocumentationSidebar())->getFooter());
+    }
+
+    public function testGetFooterReturnsStringWhenConfigIsString()
+    {
+        self::mockConfig(['docs.sidebar.footer' => 'Some footer content']);
+
+        $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooter());
+    }
+
+    public function testGetFooterReturnsTrueWhenConfigIsTrue()
+    {
+        self::mockConfig(['docs.sidebar.footer' => true]);
+
+        $this->assertTrue((new DocumentationSidebar())->getFooter());
+    }
+
+    public function testGetFooterReturnsFalseWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.footer' => false]);
+
+        $this->assertFalse((new DocumentationSidebar())->getFooter());
+    }
+
     public function testIsCollapsibleReturnsTrueByDefault()
     {
         self::mockConfig();

From bd773d7087d63d760fcd009c351a9deba5c337ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 19:56:02 +0100
Subject: [PATCH 0743/4023] Get data through sidebar instance

---
 .../components/docs/sidebar-footer-text.blade.php    |  4 ++--
 .../views/components/docs/sidebar.blade.php          |  4 +++-
 .../Feature/Views/SidebarFooterTextViewTest.php      | 12 +++++++++---
 3 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php b/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
index 6b49ca39bb1..49e2218fbdb 100644
--- a/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
@@ -1,7 +1,7 @@
 <p>
-    @if(is_bool(config('docs.sidebar.footer', true)))
+    @if(is_bool($sidebar->getFooter())))
         <a href="{{ Hyde::relativeLink('index.html') }}">Back to home page</a>
     @else
-        {{ Hyde::markdown(config('docs.sidebar.footer')) }}
+        {{ Hyde::markdown($sidebar->getFooter()) }}
     @endif
 </p>
\ No newline at end of file
diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 866b1813714..dcd158d993f 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -9,7 +9,9 @@
     </nav>
     @if(app('navigation.sidebar')->hasFooter())
         <footer id="sidebar-footer" class="h-16 p-4 w-full bottom-0 left-0 text-center leading-8">
-            @include('hyde::components.docs.sidebar-footer-text')
+            @include('hyde::components.docs.sidebar-footer-text', [
+            'sidebar' => app('navigation.sidebar'),
+        ])
         </footer>
     @endif
 </aside>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
index e4d5c21e9a3..f575483e0c9 100644
--- a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
 use Hyde\Testing\TestsBladeViews;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 class SidebarFooterTextViewTest extends TestCase
 {
@@ -14,7 +15,7 @@ class SidebarFooterTextViewTest extends TestCase
 
     public function testSidebarFooterTextViewWithDefaultConfig()
     {
-        $view = $this->test(view('hyde::components.docs.sidebar-footer-text'));
+        $view = $this->test(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
 
         $view->assertSeeHtml('<a href="index.html">Back to home page</a>');
     }
@@ -23,7 +24,7 @@ public function testSidebarFooterTextViewWhenConfigOptionIsTrue()
     {
         Config::set('docs.sidebar.footer', true);
 
-        $view = $this->test(view('hyde::components.docs.sidebar-footer-text'));
+        $view = $this->test(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
 
         $view->assertSeeHtml('<a href="index.html">Back to home page</a>');
     }
@@ -32,7 +33,7 @@ public function testSidebarFooterTextViewWhenConfigOptionIsMarkdownString()
     {
         Config::set('docs.sidebar.footer', 'Your Markdown String Here');
 
-        $view = $this->test(view('hyde::components.docs.sidebar-footer-text'));
+        $view = $this->test(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
 
         $view->assertSeeText('Your Markdown String Here');
     }
@@ -43,4 +44,9 @@ public function testSidebarFooterTextViewWhenConfigOptionIsFalse()
 
         $this->assertTrue(true);
     }
+
+    protected function withSidebar(): array
+    {
+        return ['sidebar' => new DocumentationSidebar()];
+    }
 }

From e5a8ad7fd3e4d6a0e261e9d7d93e37b5322b2386 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 24 Feb 2024 21:09:37 +0100
Subject: [PATCH 0744/4023] Initialize sidebar instance

---
 .../views/components/docs/sidebar.blade.php       | 11 +++++------
 .../framework/tests/Feature/SidebarViewTest.php   | 15 ++++++---------
 2 files changed, 11 insertions(+), 15 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index dcd158d993f..06a76534214 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -1,17 +1,16 @@
+@php
+$sidebar = app('navigation.sidebar');
+@endphp
 <aside id="sidebar" x-cloak :class="sidebarOpen ? 'visible left-0' : 'invisible -left-64 md:visible md:left-0'" class="bg-gray-100 dark:bg-gray-800 dark:text-gray-200 h-screen w-64 fixed z-30 md:flex flex-col shadow-lg md:shadow-none transition-all duration-300">
     <header id="sidebar-header" class="h-16">
         @include('hyde::components.docs.sidebar-brand')
     </header>
     <nav id="sidebar-navigation" class="p-2 overflow-y-auto border-y border-gray-300 dark:border-[#1b2533] h-full">
-        @include('hyde::components.docs.sidebar-items', [
-            'sidebar' => app('navigation.sidebar'),
-        ])
+        @include('hyde::components.docs.sidebar-items')
     </nav>
     @if(app('navigation.sidebar')->hasFooter())
         <footer id="sidebar-footer" class="h-16 p-4 w-full bottom-0 left-0 text-center leading-8">
-            @include('hyde::components.docs.sidebar-footer-text', [
-            'sidebar' => app('navigation.sidebar'),
-        ])
+            @include('hyde::components.docs.sidebar-footer-text')
         </footer>
     @endif
 </aside>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index a7b83594db7..0c338671485 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -43,9 +43,7 @@ public function testBaseSidebar()
             ->assertDontSee('<li class="sidebar-item')
             ->allGood();
 
-        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
-        ]));
+        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items'));
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-brand'));
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-footer-text'));
@@ -96,9 +94,7 @@ public function testBaseSidebarWithItems()
             ->assertSeeHtml('<li class="sidebar-item')
             ->allGood();
 
-        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
-        ]));
+        $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items'));
     }
 
     public function testSidebarWithGroupedItems()
@@ -125,7 +121,6 @@ public function testSidebarWithGroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 
@@ -157,7 +152,6 @@ public function testSidebarWithNonCollapsibleGroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 
@@ -182,7 +176,6 @@ public function testSidebarWithMixedGroupedAndUngroupedItems()
             ->allGood();
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
-            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
             'grouped' => true,
         ]));
 
@@ -191,6 +184,10 @@ public function testSidebarWithMixedGroupedAndUngroupedItems()
 
     protected function renderComponent(View $view): self
     {
+        $sidebar = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        app()->instance('navigation.sidebar', $sidebar);
+        view()->share('sidebar', $sidebar);
+
         try {
             $this->html = $view->render();
             /** @noinspection LaravelFunctionsInspection */

From aa05542b629ec557f65a3d75f471e726052ca2bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 11:29:34 +0100
Subject: [PATCH 0745/4023] Cherry pick unit test from
 https://github.com/hydephp/develop/pull/1587

---
 .../Unit/DocumentationSidebarUnitTest.php     | 142 ++++++++++++++++++
 1 file changed, 142 insertions(+)
 create mode 100644 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
new file mode 100644
index 00000000000..76d95bc8193
--- /dev/null
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -0,0 +1,142 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\Collection;
+use Hyde\Support\Models\ExternalRoute;
+use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
+ * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
+ */
+class DocumentationSidebarUnitTest extends UnitTestCase
+{
+    // Base menu tests
+
+    public function testCanConstruct()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar());
+    }
+
+    public function testCanConstructWithItemsArray()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar($this->getItems()));
+    }
+
+    public function testCanConstructWithItemsArrayable()
+    {
+        $this->assertInstanceOf(DocumentationSidebar::class, new DocumentationSidebar(collect($this->getItems())));
+    }
+
+    public function testGetItemsReturnsCollection()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar())->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArray()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar($this->getItems()))->getItems());
+    }
+
+    public function testGetItemsReturnsCollectionWhenSuppliedArrayable()
+    {
+        $this->assertInstanceOf(Collection::class, (new DocumentationSidebar(collect($this->getItems())))->getItems());
+    }
+
+    public function testGetItemsReturnsItems()
+    {
+        $items = $this->getItems();
+
+        $this->assertSame($items, (new DocumentationSidebar($items))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsItemsWhenSuppliedArrayable()
+    {
+        $items = $this->getItems();
+
+        $this->assertSame($items, (new DocumentationSidebar(collect($items)))->getItems()->all());
+    }
+
+    public function testGetItemsReturnsEmptyArrayWhenNoItems()
+    {
+        $this->assertSame([], (new DocumentationSidebar())->getItems()->all());
+    }
+
+    public function testCanAddItems()
+    {
+        $menu = new DocumentationSidebar();
+
+        $item = $this->item('/', 'Docs');
+
+        $menu->add($item);
+
+        $this->assertCount(1, $menu->getItems());
+        $this->assertSame($item, $menu->getItems()->first());
+    }
+
+    public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
+    {
+        $menu = new DocumentationSidebar();
+
+        $item1 = $this->item('/', 'Docs');
+        $item2 = $this->item('/installation', 'Installation');
+        $item3 = $this->item('/getting-started', 'Getting Started');
+
+        $menu->add($item1);
+        $menu->add($item2);
+        $menu->add($item3);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
+    public function testItemsAreSortedByPriority()
+    {
+        $menu = new DocumentationSidebar();
+
+        $item1 = $this->item('/', 'Docs', 100);
+        $item2 = $this->item('/installation', 'Installation', 200);
+        $item3 = $this->item('/getting-started', 'Getting Started', 300);
+
+        $menu->add($item3);
+        $menu->add($item1);
+        $menu->add($item2);
+
+        $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
+    }
+
+    // Sidebar specific tests
+
+    public function testGetMethodResolvesInstanceFromServiceContainer()
+    {
+        app()->instance('navigation.sidebar', $instance = new DocumentationSidebar());
+
+        $this->assertSame($instance, DocumentationSidebar::get());
+    }
+
+    public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
+    {
+        $this->assertFalse((new DocumentationSidebar())->hasGroups());
+    }
+
+    protected function getItems(): array
+    {
+        return [
+            $this->item('/', 'Docs'),
+            $this->item('/installation', 'Installation'),
+            $this->item('/getting-started', 'Getting Started'),
+        ];
+    }
+
+    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    {
+        return new NavItem(new ExternalRoute($destination), $label, $priority);
+    }
+}

From 9cf28093b73c8762398bdc59bb9e6c7161658028 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 11:30:14 +0100
Subject: [PATCH 0746/4023] Cherry pick changes to unit test from
 https://github.com/hydephp/develop/pull/1587

---
 .../tests/Unit/NavigationMenuUnitTest.php     | 31 +++++++++++++------
 1 file changed, 21 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 1b0f9a08a58..648bb55a092 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -15,9 +15,12 @@
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\NavigationMenuTest
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarUnitTest
  */
 class NavigationMenuUnitTest extends UnitTestCase
 {
+    // Base menu tests
+
     public function testCanConstruct()
     {
         $this->assertInstanceOf(MainNavigationMenu::class, new MainNavigationMenu());
@@ -70,7 +73,8 @@ public function testGetItemsReturnsEmptyArrayWhenNoItems()
     public function testCanAddItems()
     {
         $menu = new MainNavigationMenu();
-        $item = new NavItem(new ExternalRoute('/'), 'Home');
+
+        $item = $this->item('/', 'Home');
 
         $menu->add($item);
 
@@ -81,9 +85,10 @@ public function testCanAddItems()
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new MainNavigationMenu();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home');
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About');
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact');
+
+        $item1 = $this->item('/', 'Home');
+        $item2 = $this->item('/about', 'About');
+        $item3 = $this->item('/contact', 'Contact');
 
         $menu->add($item1);
         $menu->add($item2);
@@ -95,9 +100,10 @@ public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPrioritie
     public function testItemsAreSortedByPriority()
     {
         $menu = new MainNavigationMenu();
-        $item1 = new NavItem(new ExternalRoute('/'), 'Home', 100);
-        $item2 = new NavItem(new ExternalRoute('/about'), 'About', 200);
-        $item3 = new NavItem(new ExternalRoute('/contact'), 'Contact', 300);
+
+        $item1 = $this->item('/', 'Home', 100);
+        $item2 = $this->item('/about', 'About', 200);
+        $item3 = $this->item('/contact', 'Contact', 300);
 
         $menu->add($item3);
         $menu->add($item1);
@@ -109,9 +115,14 @@ public function testItemsAreSortedByPriority()
     protected function getItems(): array
     {
         return [
-            new NavItem(new ExternalRoute('/'), 'Home'),
-            new NavItem(new ExternalRoute('/about'), 'About'),
-            new NavItem(new ExternalRoute('/contact'), 'Contact'),
+            $this->item('/', 'Home'),
+            $this->item('/about', 'About'),
+            $this->item('/contact', 'Contact'),
         ];
     }
+
+    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    {
+        return new NavItem(new ExternalRoute($destination), $label, $priority);
+    }
 }

From 71fb1d782e4b9ccb67cec26855897121ed807c6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 11:32:03 +0100
Subject: [PATCH 0747/4023] Use the resolved sidebar instance

---
 .../framework/resources/views/components/docs/sidebar.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 06a76534214..35b845b1366 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -8,7 +8,7 @@
     <nav id="sidebar-navigation" class="p-2 overflow-y-auto border-y border-gray-300 dark:border-[#1b2533] h-full">
         @include('hyde::components.docs.sidebar-items')
     </nav>
-    @if(app('navigation.sidebar')->hasFooter())
+    @if($sidebar->hasFooter())
         <footer id="sidebar-footer" class="h-16 p-4 w-full bottom-0 left-0 text-center leading-8">
             @include('hyde::components.docs.sidebar-footer-text')
         </footer>

From d4358caa78e6280ef04249fcabfeb770f2733c77 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 11:36:58 +0100
Subject: [PATCH 0748/4023] Update IDE helper file with sidebar variable

---
 _ide_helper.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/_ide_helper.php b/_ide_helper.php
index 7d868d7bbb5..8cc231f850f 100644
--- a/_ide_helper.php
+++ b/_ide_helper.php
@@ -22,6 +22,11 @@
 /** @var string $routeKey The route key for the page being compiled/previewed */
 $routeKey = \Hyde\Support\Facades\Render::getRouteKey();
 
+// Variables available only to some page types
+
+/** @var \Hyde\Framework\Features\Navigation\DocumentationSidebar $sidebar */
+$sidebar = app('navigation.sidebar');
+
 // Facades (aliased in app/config.php)
 
 /** @mixin \Hyde\Foundation\HydeKernel */

From 6643a4abaa7035037d4fcef4e27dadbb9ec9d7a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 15:33:28 +0100
Subject: [PATCH 0749/4023] Fix method order

---
 .../Features/Navigation/DocumentationSidebar.php          | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 426f708e509..9197247b4e5 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -23,14 +23,14 @@ public static function get(): static
         return app('navigation.sidebar');
     }
 
-    public function getFooter(): bool|string
+    public function __construct(Arrayable|array $items = [])
     {
-        return Config::get('docs.sidebar.footer', true);
+        parent::__construct($items);
     }
 
-    public function __construct(Arrayable|array $items = [])
+    public function getFooter(): bool|string
     {
-        parent::__construct($items);
+        return Config::get('docs.sidebar.footer', true);
     }
 
     public function isCollapsible(): bool

From 28831efcdcc864567b77ce5900570dfef703bcc7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 15:33:46 +0100
Subject: [PATCH 0750/4023] Move down method

---
 .../Features/Navigation/DocumentationSidebar.php       | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 9197247b4e5..0c76bf0d97a 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -33,11 +33,6 @@ public function getFooter(): bool|string
         return Config::get('docs.sidebar.footer', true);
     }
 
-    public function isCollapsible(): bool
-    {
-        return Config::getBool('docs.sidebar.collapsible', true);
-    }
-
     public function hasFooter(): bool
     {
         if (is_string(Config::get('docs.sidebar.footer', true))) {
@@ -47,6 +42,11 @@ public function hasFooter(): bool
         return Config::getBool('docs.sidebar.footer', true);
     }
 
+    public function isCollapsible(): bool
+    {
+        return Config::getBool('docs.sidebar.collapsible', true);
+    }
+
     public function hasGroups(): bool
     {
         return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());

From 08bc6feee34a94a9140c78af2542c5b0cf312b23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 18:07:11 +0100
Subject: [PATCH 0751/4023] Add footer text accessor

---
 .../Navigation/DocumentationSidebar.php       | 11 ++++++++++
 .../Unit/DocumentationSidebarUnitTest.php     | 21 +++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0c76bf0d97a..e42ce5e5db7 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -33,6 +33,17 @@ public function getFooter(): bool|string
         return Config::get('docs.sidebar.footer', true);
     }
 
+    public function getFooterText(): ?string
+    {
+        $option = Config::get('docs.sidebar.footer', true);
+
+        if (is_string($option)) {
+            return $option;
+        }
+
+        return null;
+    }
+
     public function hasFooter(): bool
     {
         if (is_string(Config::get('docs.sidebar.footer', true))) {
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index e85a7aca302..1f6aba2bb97 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -150,6 +150,27 @@ public function testGetFooterReturnsFalseWhenConfigIsFalse()
         $this->assertFalse((new DocumentationSidebar())->getFooter());
     }
 
+    public function testGetFooterTextReturnsStringWhenConfigIsString()
+    {
+        self::mockConfig(['docs.sidebar.footer' => 'Some footer content']);
+
+        $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooterText());
+    }
+
+    public function testGetFooterTextReturnsNullWhenConfigIsTrue()
+    {
+        self::mockConfig(['docs.sidebar.footer' => true]);
+
+        $this->assertNull((new DocumentationSidebar())->getFooterText());
+    }
+
+    public function testGetFooterTextReturnsNullWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.footer' => false]);
+
+        $this->assertNull((new DocumentationSidebar())->getFooterText());
+    }
+
     public function testIsCollapsibleReturnsTrueByDefault()
     {
         self::mockConfig();

From b9f8e3dca0ce71e46394d8f8cb1b110a1527a889 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 26 Feb 2024 11:54:08 +0100
Subject: [PATCH 0752/4023] Change default navigation footer config option to
 be the default link

Uses the link from the view, in order to simplify the API. A drawback of this is that it no longer resolves dynamic links, but given the increased visibility of the option I think the tradeoff is worth it as it makes it easier to customize.
---
 config/docs.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/config/docs.php b/config/docs.php
index 93bbc751dc2..4ac1dd70706 100644
--- a/config/docs.php
+++ b/config/docs.php
@@ -30,9 +30,8 @@
         // When using a grouped sidebar, should the groups be collapsible?
         'collapsible' => true,
 
-        // Should the sidebar footer be shown? You can also set this to a string
-        // of Markdown to show in the footer. Set to `false` to disable.
-        'footer' => true,
+        // A string of Markdown to show in the footer. Set to `false` to disable.
+        'footer' => '[Back to home page](../)',
 
         /*
         |--------------------------------------------------------------------------

From 2fcf75a4c921914949d7b9c593d809a9e67ccc07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 26 Feb 2024 13:28:37 +0100
Subject: [PATCH 0753/4023] Massively simplify sidebar footer text handling

---
 .../docs/sidebar-footer-text.blade.php        |  8 +----
 .../Navigation/DocumentationSidebar.php       | 20 +++++------
 .../tests/Feature/SidebarViewTest.php         |  9 ++---
 .../Views/SidebarFooterTextViewTest.php       | 11 ++-----
 .../Unit/DocumentationSidebarUnitTest.php     | 33 ++++---------------
 ...veLinksAcrossPagesRetainsIntegrityTest.php |  2 +-
 6 files changed, 23 insertions(+), 60 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php b/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
index 49e2218fbdb..ddc7e711303 100644
--- a/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-footer-text.blade.php
@@ -1,7 +1 @@
-<p>
-    @if(is_bool($sidebar->getFooter())))
-        <a href="{{ Hyde::relativeLink('index.html') }}">Back to home page</a>
-    @else
-        {{ Hyde::markdown($sidebar->getFooter()) }}
-    @endif
-</p>
\ No newline at end of file
+{{ Hyde::markdown($sidebar->getFooter()) }}
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index e42ce5e5db7..600d1503abd 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -28,29 +28,25 @@ public function __construct(Arrayable|array $items = [])
         parent::__construct($items);
     }
 
-    public function getFooter(): bool|string
+    public function getFooter(): ?string
     {
-        return Config::get('docs.sidebar.footer', true);
-    }
-
-    public function getFooterText(): ?string
-    {
-        $option = Config::get('docs.sidebar.footer', true);
+        $option = Config::get('docs.sidebar.footer', '[Back to home page](../)');
 
         if (is_string($option)) {
             return $option;
         }
 
+        if ($option === true) {
+            /** @deprecated Backwards compatibility */
+            return '[Back to home page](../)';
+        }
+
         return null;
     }
 
     public function hasFooter(): bool
     {
-        if (is_string(Config::get('docs.sidebar.footer', true))) {
-            return true;
-        }
-
-        return Config::getBool('docs.sidebar.footer', true);
+        return $this->getFooter() !== null;
     }
 
     public function isCollapsible(): bool
diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index 0c338671485..522d25de033 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -37,7 +37,7 @@ public function testBaseSidebar()
             ->assertSeeHtml('<ul id="sidebar-items" role="list"')
             ->assertSeeHtml('<nav id="sidebar-navigation"')
             ->assertSeeHtml('<footer id="sidebar-footer"')
-            ->assertSeeHtml('<a href="index.html">Back to home page</a>')
+            ->assertSeeHtml('<a href="../">Back to home page</a>')
             ->assertSeeHtml('<span class="sr-only">Toggle dark theme</span>')
             ->assertDontSee('<a href="docs/index.html">')
             ->assertDontSee('<li class="sidebar-item')
@@ -53,9 +53,10 @@ public function testBaseSidebarWithoutFooter()
     {
         config(['docs.sidebar.footer' => false]);
 
-        $this->renderComponent(view('hyde::components.docs.sidebar'));
-
-        $this->assertViewWasNotRendered(view('hyde::components.docs.sidebar-footer-text'));
+        $this->renderComponent(view('hyde::components.docs.sidebar'))
+            ->assertDontSee('<footer id="sidebar-footer"')
+            ->assertDontSee('Back to home page')
+            ->allGood();
     }
 
     public function testBaseSidebarWithCustomFooterText()
diff --git a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
index f575483e0c9..7e9f407289b 100644
--- a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
@@ -17,7 +17,7 @@ public function testSidebarFooterTextViewWithDefaultConfig()
     {
         $view = $this->test(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
 
-        $view->assertSeeHtml('<a href="index.html">Back to home page</a>');
+        $view->assertSeeHtml('<a href="../">Back to home page</a>');
     }
 
     public function testSidebarFooterTextViewWhenConfigOptionIsTrue()
@@ -26,7 +26,7 @@ public function testSidebarFooterTextViewWhenConfigOptionIsTrue()
 
         $view = $this->test(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
 
-        $view->assertSeeHtml('<a href="index.html">Back to home page</a>');
+        $view->assertSeeHtml('<a href="../">Back to home page</a>');
     }
 
     public function testSidebarFooterTextViewWhenConfigOptionIsMarkdownString()
@@ -38,13 +38,6 @@ public function testSidebarFooterTextViewWhenConfigOptionIsMarkdownString()
         $view->assertSeeText('Your Markdown String Here');
     }
 
-    public function testSidebarFooterTextViewWhenConfigOptionIsFalse()
-    {
-        // This state is handled earlier in the component by the sidebar component so we don't need to test it here.
-
-        $this->assertTrue(true);
-    }
-
     protected function withSidebar(): array
     {
         return ['sidebar' => new DocumentationSidebar()];
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 1f6aba2bb97..41d658162b7 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -122,11 +122,11 @@ public function testGetMethodResolvesInstanceFromServiceContainer()
         $this->assertSame($instance, DocumentationSidebar::get());
     }
 
-    public function testGetFooterReturnsTrueByDefault()
+    public function testGetFooterReturnsBackLinkByDefault()
     {
         self::mockConfig();
 
-        $this->assertTrue((new DocumentationSidebar())->getFooter());
+        $this->assertSame('[Back to home page](../)', (new DocumentationSidebar())->getFooter());
     }
 
     public function testGetFooterReturnsStringWhenConfigIsString()
@@ -136,39 +136,18 @@ public function testGetFooterReturnsStringWhenConfigIsString()
         $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooter());
     }
 
-    public function testGetFooterReturnsTrueWhenConfigIsTrue()
+    public function testGetFooterReturnsBackLinkWhenConfigIsTrue()
     {
         self::mockConfig(['docs.sidebar.footer' => true]);
 
-        $this->assertTrue((new DocumentationSidebar())->getFooter());
+        $this->assertSame('[Back to home page](../)', (new DocumentationSidebar())->getFooter());
     }
 
-    public function testGetFooterReturnsFalseWhenConfigIsFalse()
+    public function testGetFooterReturnsNullWhenConfigIsFalse()
     {
         self::mockConfig(['docs.sidebar.footer' => false]);
 
-        $this->assertFalse((new DocumentationSidebar())->getFooter());
-    }
-
-    public function testGetFooterTextReturnsStringWhenConfigIsString()
-    {
-        self::mockConfig(['docs.sidebar.footer' => 'Some footer content']);
-
-        $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooterText());
-    }
-
-    public function testGetFooterTextReturnsNullWhenConfigIsTrue()
-    {
-        self::mockConfig(['docs.sidebar.footer' => true]);
-
-        $this->assertNull((new DocumentationSidebar())->getFooterText());
-    }
-
-    public function testGetFooterTextReturnsNullWhenConfigIsFalse()
-    {
-        self::mockConfig(['docs.sidebar.footer' => false]);
-
-        $this->assertNull((new DocumentationSidebar())->getFooterText());
+        $this->assertNull((new DocumentationSidebar())->getFooter());
     }
 
     public function testIsCollapsibleReturnsTrueByDefault()
diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index c263016b94f..facec7a3cc6 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -93,7 +93,7 @@ public function testRelativeLinksAcrossPagesRetainsIntegrity()
             '<link rel="stylesheet" href="../media/app.css">',
             '<a href="../docs/index.html">',
             '<a href="../docs/docs.html"',
-            '<a href="../index.html">Back to home page</a>',
+            '<a href="../">Back to home page</a>',
         ]);
     }
 }

From ca62c8c906f9b2394240d2224aa09daae1ae7219 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 26 Feb 2024 16:39:38 +0100
Subject: [PATCH 0754/4023] Pass sidebar instance as component variable

---
 .../resources/views/components/docs/sidebar.blade.php          | 3 ---
 packages/framework/resources/views/layouts/docs.blade.php      | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 35b845b1366..0196551d310 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -1,6 +1,3 @@
-@php
-$sidebar = app('navigation.sidebar');
-@endphp
 <aside id="sidebar" x-cloak :class="sidebarOpen ? 'visible left-0' : 'invisible -left-64 md:visible md:left-0'" class="bg-gray-100 dark:bg-gray-800 dark:text-gray-200 h-screen w-64 fixed z-30 md:flex flex-col shadow-lg md:shadow-none transition-all duration-300">
     <header id="sidebar-header" class="h-16">
         @include('hyde::components.docs.sidebar-brand')
diff --git a/packages/framework/resources/views/layouts/docs.blade.php b/packages/framework/resources/views/layouts/docs.blade.php
index 3f66d821517..e6bdb4886cf 100644
--- a/packages/framework/resources/views/layouts/docs.blade.php
+++ b/packages/framework/resources/views/layouts/docs.blade.php
@@ -8,7 +8,7 @@
 
     @include('hyde::components.skip-to-content-button')
     @include('hyde::components.docs.mobile-navigation')
-    @include('hyde::components.docs.sidebar')
+    @include('hyde::components.docs.sidebar', ['sidebar' => app('navigation.sidebar')])
 
     <main id="content" class="dark:bg-gray-900 min-h-screen bg-gray-50 md:bg-white absolute top-16 md:top-0 w-screen md:left-64 md:w-[calc(100vw_-_16rem)]">
         @include('hyde::components.docs.documentation-article')

From ee594f0eaaf1b4220a7719658b1ecdd8cf0a043b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 26 Feb 2024 17:10:02 +0100
Subject: [PATCH 0755/4023] Add sidebar header accessor

---
 .../Features/Navigation/DocumentationSidebar.php   |  5 +++++
 .../tests/Unit/DocumentationSidebarUnitTest.php    | 14 ++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 600d1503abd..11cb904cc7c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -28,6 +28,11 @@ public function __construct(Arrayable|array $items = [])
         parent::__construct($items);
     }
 
+    public function getHeader(): string
+    {
+        return Config::get('docs.sidebar.header', 'Documentation');
+    }
+
     public function getFooter(): ?string
     {
         $option = Config::get('docs.sidebar.footer', '[Back to home page](../)');
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 41d658162b7..fc3b74ea55f 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -122,6 +122,20 @@ public function testGetMethodResolvesInstanceFromServiceContainer()
         $this->assertSame($instance, DocumentationSidebar::get());
     }
 
+    public function testGetHeaderReturnsDefaultWhenNotConfigured()
+    {
+        self::mockConfig();
+
+        $this->assertSame('Documentation', (new DocumentationSidebar())->getHeader());
+    }
+
+    public function testGetHeaderReturnsConfiguredValue()
+    {
+        self::mockConfig(['docs.sidebar.header' => 'Some header']);
+
+        $this->assertSame('Some header', (new DocumentationSidebar())->getHeader());
+    }
+
     public function testGetFooterReturnsBackLinkByDefault()
     {
         self::mockConfig();

From 8d28069dafab3c12409d58a2739ecda5dc6f0367 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 26 Feb 2024 17:12:40 +0100
Subject: [PATCH 0756/4023] Use sidebar header accessor

---
 .../views/components/docs/sidebar-brand.blade.php         | 4 ++--
 .../tests/Feature/Views/SidebarBrandViewTest.php          | 8 ++++++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-brand.blade.php b/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
index ad693a85c96..e150f86e133 100644
--- a/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
@@ -2,10 +2,10 @@
     <strong class="px-2">
         @if(DocumentationPage::home())
             <a href="{{ DocumentationPage::home() }}">
-                {{ config('docs.sidebar.header', 'Documentation') }}
+                {{  $sidebar->getHeader() }}
             </a>
         @else
-            {{ config('docs.sidebar.header', 'Documentation') }}
+            {{ $sidebar->getHeader() }}
         @endif
     </strong>
     <x-hyde::navigation.theme-toggle-button class="opacity-75 hover:opacity-100"/>
diff --git a/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php b/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
index 10b840bf5e4..1086a1b40f6 100644
--- a/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
@@ -9,6 +9,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Testing\TestsBladeViews;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 class SidebarBrandViewTest extends TestCase
 {
@@ -68,4 +69,11 @@ public function testSidebarBrandViewWithoutDarkmodeFeature()
         $view->assertSee('HydePHP Docs');
         $view->assertDontSee('theme-toggle-button');
     }
+
+    protected function testViewData(): array
+    {
+        return [
+            'sidebar' => new DocumentationSidebar(),
+        ];
+    }
 }

From d12b00147f4853b75f08d0999d84e5b7374dbdd8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 27 Feb 2024 19:03:32 +0100
Subject: [PATCH 0757/4023] Change void testing helper to return instance

---
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8c8142bbcea..8a0109e4f13 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1240,14 +1240,14 @@ public function testSidebarGroupCasingUsingFrontMatter()
 
     // Testing helpers
 
-    protected function assertSidebarEquals(array $expected, array $menuPages): void
+    protected function assertSidebarEquals(array $expected, array $menuPages): AssertableNavigationMenu
     {
-        $this->sidebar($menuPages)->assertEquals($expected);
+        return $this->sidebar($menuPages)->assertEquals($expected);
     }
 
-    protected function assertMenuEquals(array $expected, array $menuPages): void
+    protected function assertMenuEquals(array $expected, array $menuPages): AssertableNavigationMenu
     {
-        $this->menu($menuPages)->assertEquals($expected);
+        return $this->menu($menuPages)->assertEquals($expected);
     }
 
     #[NoReturn]

From e2b14c91c9612793c93b71bcc0ffc3f7a87d3243 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 27 Feb 2024 19:05:15 +0100
Subject: [PATCH 0758/4023] Add back testing helper to die with the state

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8a0109e4f13..fdae21d2a38 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1334,6 +1334,11 @@ public function getState(int $index): ?TestNavItem
         return $this->state()[$index] ?? null;
     }
 
+    public function ddState(): void
+    {
+        dd($this->state());
+    }
+
     /**
      * @param  array  $expected  The expected state format
      * @param  bool  $strict  If false, missing array keys are ignored

From d02531b2c721b71441d827939d3658d2f9bef0dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 11:15:10 +0100
Subject: [PATCH 0759/4023] Rename test methods names to be clearer

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fdae21d2a38..79f42d1e1fe 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -200,7 +200,7 @@ public function testMainNavigationMenuWithFrontMatterVisible()
         ]);
     }
 
-    public function testMainNavigationMenuWithFrontMatterGroup()
+    public function testMainNavigationMenuWithExplicitFrontMatterGroupUsesDropdownsRegardlessOfConfigSetting()
     {
         // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
 
@@ -215,7 +215,7 @@ public function testMainNavigationMenuWithFrontMatterGroup()
         ]);
     }
 
-    public function testMainNavigationMenuWithFrontMatterCategory()
+    public function testMainNavigationMenuWithExplicitFrontMatterCategoryUsesDropdownsRegardlessOfConfigSetting()
     {
         // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
 

From 080d2043864b35d7851090d810a231c0c0160c5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 11:11:10 +0100
Subject: [PATCH 0760/4023] Move up conditional

---
 .../Features/Navigation/NavigationMenuGenerator.php       | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b490ac19bc2..00ed144add6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -120,14 +120,14 @@ protected function canAddRoute(Route $route): bool
 
     protected function canGroupRoute(Route $route): bool
     {
-        if (! $this->usesGroups) {
-            return false;
-        }
-
         if (! $this->generatesSidebar) {
             return $route->getPage()->navigationMenuGroup() !== null;
         }
 
+        if (! $this->usesGroups) {
+            return false;
+        }
+
         return true;
     }
 

From 8f171ad20e19e161204a57ca5bd6e6d505dab49f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 11:29:22 +0100
Subject: [PATCH 0761/4023] Expect root item with the group name and the
 children as the pages

---
 .../AutomaticNavigationConfigurationsTest.php        | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 79f42d1e1fe..3c9f8219b1c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -202,12 +202,8 @@ public function testMainNavigationMenuWithFrontMatterVisible()
 
     public function testMainNavigationMenuWithExplicitFrontMatterGroupUsesDropdownsRegardlessOfConfigSetting()
     {
-        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
-
         $this->assertMenuEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Bar', 'group' => 'group-1'],
-            ['label' => 'Baz', 'group' => 'group-1'],
+            ['label' => 'Group 1', 'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new MarkdownPage('foo', ['navigation.group' => 'Group 1']),
             new MarkdownPage('bar', ['navigation.group' => 'Group 1']),
@@ -217,12 +213,8 @@ public function testMainNavigationMenuWithExplicitFrontMatterGroupUsesDropdownsR
 
     public function testMainNavigationMenuWithExplicitFrontMatterCategoryUsesDropdownsRegardlessOfConfigSetting()
     {
-        // TODO: For new v2 system, this should insert a root item with the group name and the children as the pages
-
         $this->assertMenuEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Bar', 'group' => 'group-1'],
-            ['label' => 'Baz', 'group' => 'group-1'],
+            ['label' => 'Group 1', 'children' => ['Foo', 'Bar', 'Baz']],
         ], [
             new MarkdownPage('foo', ['navigation.category' => 'Group 1']),
             new MarkdownPage('bar', ['navigation.category' => 'Group 1']),

From 353603bb9ff22dedb1ac778b06ffac1cb3465e7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 11:37:19 +0100
Subject: [PATCH 0762/4023] Expect that menu items are always grouped when set
 in front matter

---
 .../Feature/AutomaticNavigationConfigurationsTest.php    | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 3c9f8219b1c..61ae342659d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -284,7 +284,10 @@ public function testMainNavigationMenuWithFrontMatterGroupAndCategory()
     {
         // Since the main key in the navigation schema is 'group', that takes precedence over its 'category' alias
 
-        $this->assertMenuEquals(array_fill(0, 3, ['group' => 'group-1']), [
+        $this->assertMenuEquals([[
+            'label' => 'Group 1',
+            'children' => ['Foo', 'Bar', 'Baz'],
+        ]], [
             new MarkdownPage('foo', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new MarkdownPage('bar', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
             new MarkdownPage('baz', ['navigation.group' => 'Group 1', 'navigation.category' => 'Group 2']),
@@ -486,8 +489,8 @@ public function testMainNavigationMenuItemsWithTheSameLabelAreNotFilteredForDupl
     public function testMainNavigationMenuItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     {
         $this->assertMenuEquals([
-            ['label' => 'Foo', 'group' => 'group-1'],
-            ['label' => 'Foo', 'group' => 'group-2'],
+            ['label' => 'Group 1', 'children' => ['Foo']],
+            ['label' => 'Group 2', 'children' => ['Foo']],
         ], [
             new MarkdownPage('foo', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 1']),
             new MarkdownPage('bar', ['navigation.label' => 'Foo', 'navigation.group' => 'Group 2']),

From 7c754535ce9c3e673d8e7236d6fedb9eb293d310 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 13:46:20 +0100
Subject: [PATCH 0763/4023] Remove resolved hotpatches from test

Fixed in https://github.com/hydephp/develop/pull/1597
---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 61ae342659d..ad5ac5a0712 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -399,7 +399,6 @@ public function testMainNavigationMenuWithConfigLabels()
 
     public function testMainNavigationDropdownLabelsCanBeSetInConfig()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
         config(['hyde.navigation.labels' => ['hello' => 'World']]);
 
         $this->assertMenuEquals(['World'], [
@@ -1184,8 +1183,6 @@ public function testMainMenuNavigationGroupCasing()
 
     public function testMainMenuNavigationGroupCasingUsingFrontMatter()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']); // TODO This should NOT be necessary when using front matter
-
         // If the user explicitly sets the group, we should respect that and assume it's already formatted correctly
 
         $this->assertMenuEquals(['Hello World'], [new MarkdownPage('foo', ['navigation.group' => 'Hello World'])]);

From e84e0f0e2e5f3942261fc5ad4e933529b71e8aeb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 21:53:47 +0100
Subject: [PATCH 0764/4023] Add method to add multiple children at once

---
 .../Framework/Features/Navigation/NavItem.php | 12 +++++++++-
 packages/framework/tests/Unit/NavItemTest.php | 22 +++++++++++++++++++
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5be8695d751..f80db61238c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -208,7 +208,17 @@ public function addChild(NavItem $item): static
         return $this;
     }
 
-    // Todo add method to add multiple children at once?
+    /**
+     * Add multiple navigation items to the children of the navigation item.
+     */
+    public function addChildren(array $items): static
+    {
+        foreach ($items as $item) {
+            $this->addChild($item);
+        }
+
+        return $this;
+    }
 
     protected static function normalizeGroupKey(?string $group): ?string
     {
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 754d536f1ac..0b925e936c8 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -404,4 +404,26 @@ public function testAddChildMethodReturnsSelf()
 
         $this->assertSame($parent, $parent->addChild($child));
     }
+
+    public function testCanAddMultipleItemsToDropdown()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+
+        $this->assertSame([], $parent->getChildren());
+
+        $parent->addChildren([$child1, $child2]);
+
+        $this->assertSame([$child1, $child2], $parent->getChildren());
+    }
+
+    public function testAddChildrenMethodReturnsSelf()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+
+        $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
+    }
 }

From cb580ed31a70a1d14a72f31cf4c47a2bceda7901 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 28 Feb 2024 21:54:41 +0100
Subject: [PATCH 0765/4023] Update todo

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index f80db61238c..89b7943214a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -93,7 +93,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     /**
      * Create a new dropdown navigation menu item.
      *
-     * @TODO: Might be more semantic to have this named something else, as it also includes sidebars groups.
+     * @TODO: Might be more semantic to have this named something else, as it also includes sidebars groups. (technically it only makes sense for the main navigation menu, but it's not enforced in the code, and the sidebar does use this method)
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.

From 0d53a8fb46812263de48ef5d1b5e8aa8c73f9bd2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:14:48 +0100
Subject: [PATCH 0766/4023] Create positioning priority constants in the
 navigation menu class

---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 84779c79eb9..93b54bb1bfe 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,6 +17,10 @@
  */
 abstract class NavigationMenu
 {
+    public const FIRST = 0;
+    public const MIDDLE = 500;
+    public const LAST = 999;
+
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
     protected Collection $items;
 

From b37b99a36e54b3e6e36c9c0413c7157f3f58830b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:16:12 +0100
Subject: [PATCH 0767/4023] Update factory to use menu class constant

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index e131e6adb21..76f3fa6d3f6 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -10,6 +10,7 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Framework\Factories\Concerns\CoreDataObject;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\NavigationSchema;
 
 use function basename;
@@ -30,7 +31,6 @@ class NavigationDataFactory extends Concerns\PageDataFactory implements Navigati
      */
     final public const SCHEMA = NavigationSchema::NAVIGATION_SCHEMA;
 
-    protected const FALLBACK_PRIORITY = 999;
     protected const CONFIG_OFFSET = 500;
 
     protected readonly ?string $label;
@@ -99,7 +99,7 @@ protected function makePriority(): int
     {
         return $this->searchForPriorityInFrontMatter()
             ?? $this->searchForPriorityInConfigs()
-            ?? self::FALLBACK_PRIORITY;
+            ?? NavigationMenu::LAST;
     }
 
     private function searchForLabelInFrontMatter(): ?string

From 80d6c9251e0d0f34d1e2e0a82f877df33995f97e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:18:32 +0100
Subject: [PATCH 0768/4023] Use base positioning constant for priority offset

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 76f3fa6d3f6..c3bca4c8f7c 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -31,8 +31,6 @@ class NavigationDataFactory extends Concerns\PageDataFactory implements Navigati
      */
     final public const SCHEMA = NavigationSchema::NAVIGATION_SCHEMA;
 
-    protected const CONFIG_OFFSET = 500;
-
     protected readonly ?string $label;
     protected readonly ?string $group;
     protected readonly ?bool $hidden;
@@ -230,7 +228,7 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
 
             return $this->offset(
                 array_flip($config)[$pageKey] ?? null,
-                self::CONFIG_OFFSET
+                NavigationMenu::MIDDLE
             );
         }
 

From 4807e9ff946ea1d67cffa54ea4f52cd99f011fce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:22:54 +0100
Subject: [PATCH 0769/4023] Use priority constant

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 89b7943214a..4aa3ab8f828 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -101,7 +101,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority ?? 999, $label, $items);
+        return new static('', $label, $priority ?? NavigationMenu::LAST, $label, $items);
     }
 
     /**

From d4e94e6db78a3b30ac8bcb2e4b940de97159bedf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:25:40 +0100
Subject: [PATCH 0770/4023] Use priority constants

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4aa3ab8f828..5e1ece187d7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -42,7 +42,7 @@ class NavItem implements Stringable
     /**
      * Create a new navigation menu item.
      */
-    public function __construct(Route|string $destination, string $label, int $priority = 500, ?string $group = null, array $children = [])
+    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::MIDDLE, ?string $group = null, array $children = [])
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);
@@ -72,7 +72,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
     /**
      * Create a new navigation menu item leading to an external URI.
      */
-    public static function forLink(string $href, string $label, int $priority = 500): static
+    public static function forLink(string $href, string $label, int $priority = NavigationMenu::MIDDLE): static
     {
         return new static($href, $label, $priority);
     }

From aaa17a01ca0e4cecbaaa82ba1375f8476a10ae62 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:26:57 +0100
Subject: [PATCH 0771/4023] Remove first constant

---
 .../src/Framework/Features/Navigation/NavigationMenu.php         | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 93b54bb1bfe..81cb0da760c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,7 +17,6 @@
  */
 abstract class NavigationMenu
 {
-    public const FIRST = 0;
     public const MIDDLE = 500;
     public const LAST = 999;
 

From 59175a353b1febf5a1643c884bf249ea01dc4253 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 10:27:30 +0100
Subject: [PATCH 0772/4023] Rename middle constant to default

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 2 +-
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index c3bca4c8f7c..adf2eacbb78 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -228,7 +228,7 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
 
             return $this->offset(
                 array_flip($config)[$pageKey] ?? null,
-                NavigationMenu::MIDDLE
+                NavigationMenu::DEFAULT
             );
         }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5e1ece187d7..94125f51ba0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -42,7 +42,7 @@ class NavItem implements Stringable
     /**
      * Create a new navigation menu item.
      */
-    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::MIDDLE, ?string $group = null, array $children = [])
+    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);
@@ -72,7 +72,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
     /**
      * Create a new navigation menu item leading to an external URI.
      */
-    public static function forLink(string $href, string $label, int $priority = NavigationMenu::MIDDLE): static
+    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): static
     {
         return new static($href, $label, $priority);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 81cb0da760c..979b952b95c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,7 +17,7 @@
  */
 abstract class NavigationMenu
 {
-    public const MIDDLE = 500;
+    public const DEFAULT = 500;
     public const LAST = 999;
 
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */

From 44a7adde0c6324da54d2a562f60b9f157a1333c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:48:27 +0100
Subject: [PATCH 0773/4023] Remove todo

No longer planned
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 94125f51ba0..52a03092b26 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -19,8 +19,6 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
- * @todo Consider splitting facade methods to actual facade class.
- *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route

From b851af8918f34e3f95a7e6f547285c1582314f6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:50:14 +0100
Subject: [PATCH 0774/4023] Elaborate dropdown method parameter documentation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 52a03092b26..79489b46247 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -95,7 +95,7 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
-     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority.
+     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
     public static function dropdown(string $label, array $items, ?int $priority = null): static
     {

From 06c73286c81a2105a9e606ec8f8bd3b23908f0a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:51:02 +0100
Subject: [PATCH 0775/4023] Change documentation wording

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 79489b46247..50b9decf093 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -76,9 +76,9 @@ public static function forLink(string $href, string $label, int $priority = Navi
     }
 
     /**
-     * Create a new navigation menu item leading to a Route model.
+     * Create a new navigation menu item leading to a Route instance.
      *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route model or route key
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.

From e172453909c06fffe50f23921b8fcad03d590773 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:51:42 +0100
Subject: [PATCH 0776/4023] Clarify usage documentation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 50b9decf093..43ae6e3bb58 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -31,7 +31,7 @@ class NavItem implements Stringable
     protected int $priority;
     protected ?string $group;
 
-    /** The "slugified" version of the label. */
+    /** The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
     protected string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */

From d2653e24523d09acb7d3415456e9e70375d0b41e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:52:33 +0100
Subject: [PATCH 0777/4023] Add more code documentation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 43ae6e3bb58..4b324da512c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -34,7 +34,11 @@ class NavItem implements Stringable
     /** The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
     protected string $identifier;
 
-    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
+    /**
+     * Navigation items can be turned into dropdowns or sidebar groups by adding children.
+     *
+     * @var array<\Hyde\Framework\Features\Navigation\NavItem>
+     */
     protected array $children;
 
     /**

From df90de8c9a6fb9d34a8c67015025fef2593d4ed6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:52:52 +0100
Subject: [PATCH 0778/4023] Revert "Add more code documentation"

This reverts commit d2653e24523d09acb7d3415456e9e70375d0b41e.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4b324da512c..43ae6e3bb58 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -34,11 +34,7 @@ class NavItem implements Stringable
     /** The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
     protected string $identifier;
 
-    /**
-     * Navigation items can be turned into dropdowns or sidebar groups by adding children.
-     *
-     * @var array<\Hyde\Framework\Features\Navigation\NavItem>
-     */
+    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
     protected array $children;
 
     /**

From df04558ec731205a90e5f4a62569ebb7d537c7ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:54:22 +0100
Subject: [PATCH 0779/4023] Add code documentation to class description

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 43ae6e3bb58..ce298a39ba1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -23,6 +23,8 @@
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route
  *   3. You can use NavItem::forLink() for an external or un-routed link
+ *
+ * Navigation items can be turned into dropdowns or sidebar groups by adding children.
  */
 class NavItem implements Stringable
 {

From 6aafad56c642d4c2e152a7f5f03e3e51f96aec3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:54:33 +0100
Subject: [PATCH 0780/4023] Add notes about parent destination state

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ce298a39ba1..87938516e73 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -25,6 +25,8 @@
  *   3. You can use NavItem::forLink() for an external or un-routed link
  *
  * Navigation items can be turned into dropdowns or sidebar groups by adding children.
+ * Note that doing so will mean that any link on the parent will no longer be clickable,
+ * as clicking the parent label will open the dropdown instead of leading to the destination.
  */
 class NavItem implements Stringable
 {

From 635d553245923bce0dbe7eef1e5de7f0d585df24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 11:58:13 +0100
Subject: [PATCH 0781/4023] Fix improper access to protected property

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index a2d05aeb00b..060e228eb0b 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -36,7 +36,7 @@
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item->hasChildren())
-                        <x-hyde::navigation.dropdown :label="$item->label" :items="$item->getChildren()"/>
+                        <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getChildren()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')
                     @endif

From 7cace47b5f2faac24cc50712e0d1b8edf0d31644 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 12:35:19 +0100
Subject: [PATCH 0782/4023] Remove destinations from items with children for a
 clearer state

These can't be clicked to returning null makes it clearer that the destination is disabled (for example when adding children to an existing instance)
---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +++++-
 packages/framework/tests/Unit/NavItemTest.php               | 4 ++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 87938516e73..a1132d02950 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -117,8 +117,12 @@ public function __toString(): string
     /**
      * Get the destination route of the navigation item.
      */
-    public function getDestination(): Route
+    public function getDestination(): ?Route
     {
+        if ($this->hasChildren()) {
+            return null;
+        }
+
         return $this->destination;
     }
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 0b925e936c8..4e864540cd7 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -86,7 +86,7 @@ public function testCanConstructWithChildren()
         $item = new NavItem($route, 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->getLabel());
-        $this->assertSame($route, $item->getDestination());
+        $this->assertNull($item->getDestination());
         $this->assertSame(500, $item->getPriority());
 
         $this->assertCount(2, $item->getChildren());
@@ -111,7 +111,7 @@ public function testCanConstructWithChildrenWithoutRoute()
         $item = new NavItem('', 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->getLabel());
-        $this->assertSame('', $item->getDestination()->getLink());
+        $this->assertNull($item->getDestination());
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());

From 4047320ee268b68a229b50f8ffbe046725a3827c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 13:44:27 +0100
Subject: [PATCH 0783/4023] Remove todo for an issue I don't think is possible

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a1132d02950..b1d09fb2621 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -233,6 +233,6 @@ protected static function normalizeGroupKey(?string $group): ?string
 
     protected static function makeIdentifier(string $label): string
     {
-        return Str::slug($label); // Todo: If it's a dropdown based on a subdirectory, we should use the subdirectory as the identifier (start by making a test to see if it's even possible to add a differing label)
+        return Str::slug($label);
     }
 }

From 5405db0d94f90be0469a56ab182dc313fdbabeef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 13:49:03 +0100
Subject: [PATCH 0784/4023] Coalesce assign parent group when added child group
 is null

---
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 packages/framework/tests/Unit/NavItemTest.php | 22 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b1d09fb2621..e6ecb310e8d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -207,7 +207,7 @@ public function isCurrent(): bool
      */
     public function addChild(NavItem $item): static
     {
-        // Todo: Ensure that the item has a group identifier by creating it from the label if it doesn't exist?
+        $item->group ??= $this->group;
 
         $this->children[] = $item;
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 4e864540cd7..b5ff9c6c0b7 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -426,4 +426,26 @@ public function testAddChildrenMethodReturnsSelf()
 
         $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
     }
+
+    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
+
+        $parent->addChild($child);
+
+        $this->assertSame('foo', $parent->getGroup());
+        $this->assertSame('bar', $child->getGroup());
+    }
+
+    public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
+
+        $parent->addChild($child);
+
+        $this->assertSame('foo', $parent->getGroup());
+        $this->assertSame('foo', $child->getGroup());
+    }
 }

From 439d9c6992c6102d0c5202a40a57752c6feb2eca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 18:37:09 +0100
Subject: [PATCH 0785/4023] Rename NavItem `dropdown` method to `forGroup`

Also considered using "grouped" but "forGroup" matches the other facade methods.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 4 +---
 .../Features/Navigation/NavigationMenuGenerator.php         | 2 +-
 packages/framework/tests/Feature/NavigationMenuTest.php     | 4 ++--
 .../tests/Feature/Services/DocumentationSidebarTest.php     | 6 +++---
 packages/framework/tests/Unit/NavItemTest.php               | 6 +++---
 5 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e6ecb310e8d..ab4ca0bcabd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -95,13 +95,11 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     /**
      * Create a new dropdown navigation menu item.
      *
-     * @TODO: Might be more semantic to have this named something else, as it also includes sidebars groups. (technically it only makes sense for the main navigation menu, but it's not enforced in the code, and the sidebar does use this method)
-     *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function dropdown(string $label, array $items, ?int $priority = null): static
+    public static function forGroup(string $label, array $items, ?int $priority = null): static
     {
         return new static('', $label, $priority ?? NavigationMenu::LAST, $label, $items);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 00ed144add6..bf82a3bbd5c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -160,7 +160,7 @@ protected function createGroupItem(string $groupKey, string $groupName): NavItem
 
         $priority = $this->searchForGroupPriorityInConfig($groupKey);
 
-        return NavItem::dropdown($this->normalizeGroupLabel($label), [], $priority);
+        return NavItem::forGroup($this->normalizeGroupLabel($label), [], $priority);
     }
 
     protected function normalizeGroupLabel(string $label): string
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 0666afeb8b8..2163dce6d6d 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -230,7 +230,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $menu = $this->createNavigationMenu();
         $expected = collect([
             NavItem::fromRoute(Routes::get('index')),
-            NavItem::dropdown('Foo', [
+            NavItem::forGroup('Foo', [
                 NavItem::fromRoute(Routes::get('foo/bar')),
             ]),
         ]);
@@ -251,7 +251,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         $this->assertEquals([
             NavItem::fromRoute(Routes::get('index')),
             NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            NavItem::dropdown('Bar', [
+            NavItem::forGroup('Bar', [
                 NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 35de82258a4..b2da470a8c5 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -267,10 +267,10 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
 
         $this->assertEquals(
             collect([
-                NavItem::dropdown('Bar', [
+                NavItem::forGroup('Bar', [
                     NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
                 ]),
-                NavItem::dropdown('Foo', [
+                NavItem::forGroup('Foo', [
                     NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
@@ -288,7 +288,7 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
 
         $this->assertEquals(
             collect([
-                NavItem::dropdown('Foo', [
+                NavItem::forGroup('Foo', [
                     NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
                     NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index b5ff9c6c0b7..1816633e0d1 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -263,7 +263,7 @@ public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
 
     public function testDropdownFacade()
     {
-        $item = NavItem::dropdown('foo', []);
+        $item = NavItem::forGroup('foo', []);
 
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getChildren());
@@ -276,14 +276,14 @@ public function testDropdownFacadeWithChildren()
             new NavItem(new Route(new MarkdownPage()), 'bar'),
         ];
 
-        $item = NavItem::dropdown('foo', $children);
+        $item = NavItem::forGroup('foo', $children);
         $this->assertSame($children, $item->getChildren());
         $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()
     {
-        $item = NavItem::dropdown('foo', [], 500);
+        $item = NavItem::forGroup('foo', [], 500);
 
         $this->assertSame(500, $item->getPriority());
     }

From 37cb4a83441be2099d592427b2e81c11303dfeff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 18:56:02 +0100
Subject: [PATCH 0786/4023] Call static method statically

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ab4ca0bcabd..0394d192294 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -54,7 +54,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        $this->identifier = $this->makeIdentifier($label);
+        $this->identifier = static::makeIdentifier($label);
         $this->children = $children;
     }
 

From e28ae7c8ba55a6507f021f3955f41d025734e05e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 18:56:49 +0100
Subject: [PATCH 0787/4023] Use explicit cast for equality comparison

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0394d192294..18ee08de286 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -197,7 +197,7 @@ public function hasChildren(): bool
      */
     public function isCurrent(): bool
     {
-        return Hyde::currentRoute()->getLink() === (string) $this->destination;
+        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
     }
 
     /**

From 228e3d4d59d15751332f32ec0f25d828f26be8a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 18:57:28 +0100
Subject: [PATCH 0788/4023] Use existing helper for equality comparison

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 18ee08de286..50e2c563bf7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -197,7 +197,7 @@ public function hasChildren(): bool
      */
     public function isCurrent(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
+        return $this->destination->is(Hyde::currentRoute());
     }
 
     /**

From 734c95e4f157ffd201b85444986868acbb6ab0b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:04:52 +0100
Subject: [PATCH 0789/4023] Revert "Use existing helper for equality
 comparison"

This reverts commit 228e3d4d59d15751332f32ec0f25d828f26be8a0 as existing helper depends on route keys which do not exist on external routes.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 50e2c563bf7..18ee08de286 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -197,7 +197,7 @@ public function hasChildren(): bool
      */
     public function isCurrent(): bool
     {
-        return $this->destination->is(Hyde::currentRoute());
+        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
     }
 
     /**

From faa87b4c403ba0797853b23482dcc7462560874b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:05:28 +0100
Subject: [PATCH 0790/4023] Clarify method description context

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 18ee08de286..17a8a750186 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -193,7 +193,7 @@ public function hasChildren(): bool
     }
 
     /**
-     * Check if the NavItem instance is the current page.
+     * Check if the NavItem instance is the current page being rendered.
      */
     public function isCurrent(): bool
     {

From 8c43c4f63670de6999cad50ce1d7758380812925 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:07:11 +0100
Subject: [PATCH 0791/4023] Move fallback value to default parameter value

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 17a8a750186..b6181fb08e8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -99,9 +99,9 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, ?int $priority = null): static
+    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
     {
-        return new static('', $label, $priority ?? NavigationMenu::LAST, $label, $items);
+        return new static('', $label, $priority, $label, $items);
     }
 
     /**

From 2d90f7cdc4801a6961586820fd3a623deb6968e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:07:52 +0100
Subject: [PATCH 0792/4023] Remove null type support from facade helper method

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b6181fb08e8..37686076f92 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -97,9 +97,9 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
-     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
+     * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
+    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
     {
         return new static('', $label, $priority, $label, $items);
     }

From 9042071b6848715807e3ad3a294aeca42cf34ad6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:11:23 +0100
Subject: [PATCH 0793/4023] Revert "Remove null type support from facade helper
 method"

This reverts commit 2d90f7cdc4801a6961586820fd3a623deb6968e1.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 37686076f92..b6181fb08e8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -97,9 +97,9 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
-     * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
+     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
+    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
     {
         return new static('', $label, $priority, $label, $items);
     }

From 12ac55f81d7eb5eb117355b2b8ad3a3ca3627212 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:11:26 +0100
Subject: [PATCH 0794/4023] Revert "Move fallback value to default parameter
 value"

This reverts commit 8c43c4f63670de6999cad50ce1d7758380812925.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b6181fb08e8..17a8a750186 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -99,9 +99,9 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
+    public static function forGroup(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority, $label, $items);
+        return new static('', $label, $priority ?? NavigationMenu::LAST, $label, $items);
     }
 
     /**

From 1eb85a6ba139d899b61a7ac9d065bf3d895c6f33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:15:30 +0100
Subject: [PATCH 0795/4023] Move up method in source

---
 .../Framework/Features/Navigation/NavItem.php    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 17a8a750186..0b7f2e29cc1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -71,14 +71,6 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
         );
     }
 
-    /**
-     * Create a new navigation menu item leading to an external URI.
-     */
-    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): static
-    {
-        return new static($href, $label, $priority);
-    }
-
     /**
      * Create a new navigation menu item leading to a Route instance.
      *
@@ -92,6 +84,14 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
         return static::fromRoute($route instanceof Route ? $route : Routes::getOrFail($route), $label, $priority, $group);
     }
 
+    /**
+     * Create a new navigation menu item leading to an external URI.
+     */
+    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): static
+    {
+        return new static($href, $label, $priority);
+    }
+
     /**
      * Create a new dropdown navigation menu item.
      *

From 6af588a94ea443c173bfeb85afcb069341f84d36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:17:22 +0100
Subject: [PATCH 0796/4023] Deprecate `NavItem::fromRoute()` method

We don't need two methods that do almost the same thing. I'm going to merge them, keeping the name of the other one to match the other similar helpers.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0b7f2e29cc1..429c4180153 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -60,6 +60,8 @@ public function __construct(Route|string $destination, string $label, int $prior
 
     /**
      * Create a new navigation menu item from a route.
+     *
+     * @deprecated Use NavItem::forRoute() instead.
      */
     public static function fromRoute(Route $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {

From 6ddd33ed1770d770de9c9d5cfcb5d010f47dafe7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:18:48 +0100
Subject: [PATCH 0797/4023] Inline usage of deprecated method for merged
 replacement

---
 .../src/Framework/Features/Navigation/NavItem.php          | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 429c4180153..08fd6cb011d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -83,7 +83,12 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
      */
     public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
-        return static::fromRoute($route instanceof Route ? $route : Routes::getOrFail($route), $label, $priority, $group);
+        return new static(
+            $route instanceof Route ? $route : Routes::getOrFail($route),
+            $label ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuLabel(),
+            $priority ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuPriority(),
+            $group ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuGroup(),
+        );
     }
 
     /**

From b67d9a5304e3028862a585519699ed905b29a2c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:22:27 +0100
Subject: [PATCH 0798/4023] Revert "Inline usage of deprecated method for
 merged replacement"

This reverts commit 6ddd33ed1770d770de9c9d5cfcb5d010f47dafe7.
---
 .../src/Framework/Features/Navigation/NavItem.php          | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 08fd6cb011d..429c4180153 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -83,12 +83,7 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
      */
     public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
-        return new static(
-            $route instanceof Route ? $route : Routes::getOrFail($route),
-            $label ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuLabel(),
-            $priority ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuPriority(),
-            $group ?? $route instanceof Route ? $route : Routes::getOrFail($route)->getPage()->navigationMenuGroup(),
-        );
+        return static::fromRoute($route instanceof Route ? $route : Routes::getOrFail($route), $label, $priority, $group);
     }
 
     /**

From 83235f0ee946819cec5836b8fcaaefa8cdaa1f99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:27:37 +0100
Subject: [PATCH 0799/4023] Introduce local variable

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 429c4180153..42e351ba0f1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -83,7 +83,9 @@ public static function fromRoute(Route $route, ?string $label = null, ?int $prio
      */
     public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
-        return static::fromRoute($route instanceof Route ? $route : Routes::getOrFail($route), $label, $priority, $group);
+        $route = $route instanceof Route ? $route : Routes::getOrFail($route);
+
+        return static::fromRoute($route, $label, $priority, $group);
     }
 
     /**

From f14bc66a3573ea5b59fe6712a180257b718a10e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:27:58 +0100
Subject: [PATCH 0800/4023] Reinline usage of deprecated method for merged
 replacement

---
 .../src/Framework/Features/Navigation/NavItem.php          | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 42e351ba0f1..7198c985f4a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -85,7 +85,12 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     {
         $route = $route instanceof Route ? $route : Routes::getOrFail($route);
 
-        return static::fromRoute($route, $label, $priority, $group);
+        return new static(
+            $route,
+            $label ?? $route->getPage()->navigationMenuLabel(),
+            $priority ?? $route->getPage()->navigationMenuPriority(),
+            $group ?? $route->getPage()->navigationMenuGroup(),
+        );
     }
 
     /**

From 870e00400c132c8e290726e5d3e929eb0a7aeb7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:40:32 +0100
Subject: [PATCH 0801/4023] Update deprecated method to point to replacement

---
 .../src/Framework/Features/Navigation/NavItem.php          | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7198c985f4a..e10ce0feffd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -65,12 +65,7 @@ public function __construct(Route|string $destination, string $label, int $prior
      */
     public static function fromRoute(Route $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
-        return new static(
-            $route,
-            $label ?? $route->getPage()->navigationMenuLabel(),
-            $priority ?? $route->getPage()->navigationMenuPriority(),
-            $group ?? $route->getPage()->navigationMenuGroup(),
-        );
+        return static::forRoute($route, $label, $priority, $group);
     }
 
     /**

From 1edb2f2255da8cec7060edddd9dff94114e2b54c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 19:50:07 +0100
Subject: [PATCH 0802/4023] Replace all usages of `fromRoute` with `forRoute`

---
 .../Navigation/NavigationMenuGenerator.php    |  6 +--
 .../tests/Feature/NavigationMenuTest.php      | 44 +++++++++----------
 .../Services/DocumentationSidebarTest.php     | 32 +++++++-------
 .../Unit/DocumentationSidebarUnitTest.php     |  2 +-
 .../tests/Unit/NavItemIsCurrentHelperTest.php | 26 +++++------
 packages/framework/tests/Unit/NavItemTest.php | 24 +++++-----
 6 files changed, 67 insertions(+), 67 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index bf82a3bbd5c..342a696d96b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -71,7 +71,7 @@ protected function generate(): void
                 if ($this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
-                    $this->items->put($route->getRouteKey(), NavItem::fromRoute($route));
+                    $this->items->put($route->getRouteKey(), NavItem::forRoute($route));
                 }
             }
         });
@@ -79,7 +79,7 @@ protected function generate(): void
         if ($this->generatesSidebar) {
             // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
             if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-                $this->items->push(NavItem::fromRoute(DocumentationPage::home()));
+                $this->items->push(NavItem::forRoute(DocumentationPage::home()));
             }
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
@@ -133,7 +133,7 @@ protected function canGroupRoute(Route $route): bool
 
     protected function addRouteToGroup(Route $route): void
     {
-        $item = NavItem::fromRoute($route);
+        $item = NavItem::forRoute($route);
 
         $groupName = $this->generatesSidebar ? ($item->getGroup() ?? 'Other') : $item->getGroup();
 
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 2163dce6d6d..2bd704cc40e 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -38,7 +38,7 @@ public function testGenerateMethodCreatesCollectionOfNavItems()
     public function testGetItemsReturnsItems()
     {
         $this->assertEquals(collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
         ]), $this->createNavigationMenu()->getItems());
     }
 
@@ -67,9 +67,9 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo')),
-            NavItem::fromRoute(Routes::get('docs/index')),
+            NavItem::forRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('foo')),
+            NavItem::forRoute(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -83,8 +83,8 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo')),
+            NavItem::forRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -98,7 +98,7 @@ public function testExternalLinkCanBeAddedInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forLink('https://example.com', 'foo'),
         ]);
 
@@ -113,7 +113,7 @@ public function testPathLinkCanBeAddedInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forLink('foo', 'foo'),
         ]);
 
@@ -131,7 +131,7 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forLink('foo', 'foo'),
             NavItem::forLink('foo', 'foo'),
         ]);
@@ -150,7 +150,7 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestina
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forLink('foo', 'foo'),
             NavItem::forLink('bar', 'foo'),
         ]);
@@ -168,9 +168,9 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forLink('bar', 'Foo'),
-            NavItem::fromRoute(Routes::get('foo')),
+            NavItem::forRoute(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -185,8 +185,8 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('docs/index')),
+            NavItem::forRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -199,7 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
-        $expected = collect([NavItem::fromRoute(Routes::get('index'))]);
+        $expected = collect([NavItem::forRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
         $this->assertEquals($expected, $menu->getItems());
@@ -213,8 +213,8 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute(Routes::get('foo/bar')),
+            NavItem::forRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('foo/bar')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -229,9 +229,9 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavItem::fromRoute(Routes::get('index')),
+            NavItem::forRoute(Routes::get('index')),
             NavItem::forGroup('Foo', [
-                NavItem::fromRoute(Routes::get('foo/bar')),
+                NavItem::forRoute(Routes::get('foo/bar')),
             ]),
         ]);
 
@@ -249,10 +249,10 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
-            NavItem::fromRoute(Routes::get('index')),
-            NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
+            NavItem::forRoute(Routes::get('index')),
+            NavItem::forRoute((new MarkdownPage('foo'))->getRoute()),
             NavItem::forGroup('Bar', [
-                NavItem::fromRoute((new MarkdownPage('bar/baz'))->getRoute()),
+                NavItem::forRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
     }
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index b2da470a8c5..5195d1f3fdc 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -86,9 +86,9 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::fromRoute(Routes::get('docs/a'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/b'), priority: 999),
-                NavItem::fromRoute(Routes::get('docs/c'), priority: 999),
+                NavItem::forRoute(Routes::get('docs/a'), priority: 999),
+                NavItem::forRoute(Routes::get('docs/b'), priority: 999),
+                NavItem::forRoute(Routes::get('docs/c'), priority: 999),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -107,9 +107,9 @@ public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::fromRoute(Routes::get('docs/c'), priority: 250 + 250),
-                NavItem::fromRoute(Routes::get('docs/b'), priority: 250 + 251),
-                NavItem::fromRoute(Routes::get('docs/a'), priority: 250 + 252),
+                NavItem::forRoute(Routes::get('docs/c'), priority: 250 + 250),
+                NavItem::forRoute(Routes::get('docs/b'), priority: 250 + 251),
+                NavItem::forRoute(Routes::get('docs/a'), priority: 250 + 252),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -146,9 +146,9 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::fromRoute(Routes::get('docs/first'), priority: 250 + 250),
-                NavItem::fromRoute(Routes::get('docs/second'), priority: 250 + 252),
-                NavItem::fromRoute(Routes::get('docs/third'), priority: 250 + 300),
+                NavItem::forRoute(Routes::get('docs/first'), priority: 250 + 250),
+                NavItem::forRoute(Routes::get('docs/second'), priority: 250 + 252),
+                NavItem::forRoute(Routes::get('docs/third'), priority: 250 + 300),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -195,7 +195,7 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
         Filesystem::touch('_docs/index.md');
 
         $this->assertEquals(
-            collect([NavItem::fromRoute(Routes::get('docs/foo'), priority: 999)]),
+            collect([NavItem::forRoute(Routes::get('docs/foo'), priority: 999)]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
@@ -268,10 +268,10 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
         $this->assertEquals(
             collect([
                 NavItem::forGroup('Bar', [
-                    NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
+                    NavItem::forRoute(Routes::get('docs/bar'), priority: 999),
                 ]),
                 NavItem::forGroup('Foo', [
-                    NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                    NavItem::forRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -289,8 +289,8 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
         $this->assertEquals(
             collect([
                 NavItem::forGroup('Foo', [
-                    NavItem::fromRoute(Routes::get('docs/bar'), priority: 999),
-                    NavItem::fromRoute(Routes::get('docs/foo'), priority: 999),
+                    NavItem::forRoute(Routes::get('docs/bar'), priority: 999),
+                    NavItem::forRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -312,7 +312,7 @@ public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavItem::fromRoute(Routes::get('docs/index'))]),
+            collect([NavItem::forRoute(Routes::get('docs/index'))]),
             $sidebar->getItems()
         );
     }
@@ -325,7 +325,7 @@ public function testIndexPageNotAddedToSidebarWhenOtherPagesExist()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavItem::fromRoute(Routes::get('docs/test-0'))]),
+            collect([NavItem::forRoute(Routes::get('docs/test-0'))]),
             $sidebar->getItems()
         );
     }
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index fc3b74ea55f..ee75d74d943 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -226,7 +226,7 @@ public function testHasGroupsReturnsTrueWhenAtLeastOneItemHasChildren()
         $page = new DocumentationPage('foo');
         $child = new DocumentationPage('bar');
         $menu = new DocumentationSidebar([
-            NavItem::fromRoute($page->getRoute())->addChild(NavItem::fromRoute($child->getRoute())),
+            NavItem::forRoute($page->getRoute())->addChild(NavItem::forRoute($child->getRoute())),
         ]);
 
         $this->assertTrue($menu->hasGroups());
diff --git a/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php b/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php
index d9500006247..97aa4de6f6f 100644
--- a/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php
+++ b/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php
@@ -34,19 +34,19 @@ protected function tearDown(): void
     public function testIsCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
     }
 
     public function testIsCurrentWhenCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertTrue(NavItem::fromRoute($this->makeRoute('foo'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo'))->isCurrent());
     }
 
     public function testIsCurrentUsingCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavItem::fromRoute(Routes::get('index'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute(Routes::get('index'))->isCurrent());
     }
 
     public function testIsCurrentUsingCurrentLink()
@@ -58,13 +58,13 @@ public function testIsCurrentUsingCurrentLink()
     public function testIsCurrentWhenNotCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
     }
 
     public function testIsCurrentUsingNotCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::fromRoute(Routes::get('index'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute(Routes::get('index'))->isCurrent());
     }
 
     public function testIsCurrentUsingNotCurrentLink()
@@ -76,49 +76,49 @@ public function testIsCurrentUsingNotCurrentLink()
     public function testIsCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::fromRoute($this->makeRoute('foo/bar'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isCurrent());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::fromRoute($this->makeRoute('foo/bar'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isCurrent());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('foo/baz'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz'))->isCurrent());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertTrue(NavItem::fromRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('foo/baz/bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz/bar'))->isCurrent());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNested()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverse()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::fromRoute($this->makeRoute('foo'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo'))->isCurrent());
     }
 
     public function testIsCurrentUsingCurrentLinkWithNestedCurrentPage()
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 1816633e0d1..525dad28367 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -169,7 +169,7 @@ public function testGetChildrenWithNoChildren()
     public function testFromRoute()
     {
         $route = new Route(new MarkdownPage());
-        $item = NavItem::fromRoute($route);
+        $item = NavItem::forRoute($route);
 
         $this->assertSame($route, $item->getDestination());
     }
@@ -178,7 +178,7 @@ public function testToString()
     {
         Render::shouldReceive('getRouteKey')->once()->andReturn('index');
 
-        $this->assertSame('index.html', (string) NavItem::fromRoute(Routes::get('index')));
+        $this->assertSame('index.html', (string) NavItem::forRoute(Routes::get('index')));
     }
 
     public function testForLink()
@@ -241,24 +241,24 @@ public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
             'getRouteKey' => 'foo',
         ]));
 
-        $this->assertSame('foo.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar')),
             'getRouteKey' => 'foo/bar',
         ]));
 
-        $this->assertSame('../foo.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar/baz')),
             'getRouteKey' => 'foo/bar/baz',
         ]));
 
-        $this->assertSame('../../foo.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../../foo/bar.html', (string) NavItem::fromRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../../foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../../foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
     }
 
     public function testDropdownFacade()
@@ -309,8 +309,8 @@ public function testIsCurrent()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertTrue(NavItem::fromRoute(new Route(new InMemoryPage('foo')))->isCurrent());
-        $this->assertFalse(NavItem::fromRoute(new Route(new InMemoryPage('bar')))->isCurrent());
+        $this->assertTrue(NavItem::forRoute(new Route(new InMemoryPage('foo')))->isCurrent());
+        $this->assertFalse(NavItem::forRoute(new Route(new InMemoryPage('bar')))->isCurrent());
     }
 
     public function testIsCurrentWithExternalRoute()
@@ -335,7 +335,7 @@ public function testGetGroupWithGroup()
 
     public function testGetGroupFromRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::fromRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroup());
+        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroup());
     }
 
     public function testGetGroupForRouteWithGroup()
@@ -367,7 +367,7 @@ public function testIdentifierWithCustomLabel()
 
     public function testIdentifierFromRouteKey()
     {
-        $item = NavItem::fromRoute(Routes::get('index'));
+        $item = NavItem::forRoute(Routes::get('index'));
         $this->assertSame('home', $item->getIdentifier());
     }
 

From e9cbf99d60f746da1592defc18410aa0406ab10c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 20:39:46 +0100
Subject: [PATCH 0803/4023] Breaking: Remove method `NavItem::fromRoute()`

---
 .../src/Framework/Features/Navigation/NavItem.php      | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e10ce0feffd..8db55c61800 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -58,16 +58,6 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->children = $children;
     }
 
-    /**
-     * Create a new navigation menu item from a route.
-     *
-     * @deprecated Use NavItem::forRoute() instead.
-     */
-    public static function fromRoute(Route $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
-    {
-        return static::forRoute($route, $label, $priority, $group);
-    }
-
     /**
      * Create a new navigation menu item leading to a Route instance.
      *

From 5970a041a45879e218392a5d04c7e9f0156be331 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 20:51:26 +0100
Subject: [PATCH 0804/4023] Annotate child array generics

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8db55c61800..15761616734 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -43,6 +43,8 @@ class NavItem implements Stringable
 
     /**
      * Create a new navigation menu item.
+     *
+     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $children
      */
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
     {
@@ -208,6 +210,8 @@ public function addChild(NavItem $item): static
 
     /**
      * Add multiple navigation items to the children of the navigation item.
+     *
+     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
      */
     public function addChildren(array $items): static
     {

From 87dbc8029904cb5f19c528c575af77081926c7d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:10:34 +0100
Subject: [PATCH 0805/4023] Update `NavItem::$destination` property to be
 nullable

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 15761616734..8d7c0c9b57b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -30,7 +30,7 @@
  */
 class NavItem implements Stringable
 {
-    protected Route $destination;
+    protected ?Route $destination;
     protected string $label;
     protected int $priority;
     protected ?string $group;
@@ -46,7 +46,7 @@ class NavItem implements Stringable
      *
      * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $children
      */
-    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
+    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);

From ab95f50e5217dd8f4896db8a096b2f40cfe09586 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:30:19 +0100
Subject: [PATCH 0806/4023] Set destination to null when creating group items

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8d7c0c9b57b..7bd1b7dc451 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -97,7 +97,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      */
     public static function forGroup(string $label, array $items, ?int $priority = null): static
     {
-        return new static('', $label, $priority ?? NavigationMenu::LAST, $label, $items);
+        return new static(null, $label, $priority ?? NavigationMenu::LAST, $label, $items);
     }
 
     /**

From fa9c01d05deab0984d7d6794fb0a2e07e6eb85a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:38:05 +0100
Subject: [PATCH 0807/4023] Document null state reasoning

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7bd1b7dc451..bd2925125cf 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -27,6 +27,7 @@
  * Navigation items can be turned into dropdowns or sidebar groups by adding children.
  * Note that doing so will mean that any link on the parent will no longer be clickable,
  * as clicking the parent label will open the dropdown instead of leading to the destination.
+ * For this reason, dropdown items will have their destination set to null.
  */
 class NavItem implements Stringable
 {
@@ -109,7 +110,7 @@ public function __toString(): string
     }
 
     /**
-     * Get the destination route of the navigation item.
+     * Get the destination route of the navigation item. For dropdowns, this will return null.
      */
     public function getDestination(): ?Route
     {

From f1d9ca7fdb8f4f99f40af54b9efaef5b7eb2ebba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:41:32 +0100
Subject: [PATCH 0808/4023] Enforce group destination null state when adding
 children

Provides a consistent state
---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index bd2925125cf..cf385c108c9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -205,6 +205,7 @@ public function addChild(NavItem $item): static
         $item->group ??= $this->group;
 
         $this->children[] = $item;
+        $this->destination = null;
 
         return $this;
     }

From c12f3de85d422708d9f0567f1df9c7a19eeacc88 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:41:40 +0100
Subject: [PATCH 0809/4023] Document null state enforcement

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index cf385c108c9..c963e0dc6fc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -199,6 +199,8 @@ public function isCurrent(): bool
 
     /**
      * Add a navigation item to the children of the navigation item.
+     *
+     * This will turn the parent item into a dropdown. Its destination will be set to null.
      */
     public function addChild(NavItem $item): static
     {

From 7c08dc66edee0824861e0e70b1ea184ea8932dd5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 21:57:14 +0100
Subject: [PATCH 0810/4023] Construct children using helper to enforce type
 state

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c963e0dc6fc..77047479849 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -58,7 +58,7 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = static::makeIdentifier($label);
-        $this->children = $children;
+        $this->addChildren($children);
     }
 
     /**

From 46dd08dd0ad2ab210bf3b6c01649e2c97b605504 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 29 Feb 2024 22:05:06 +0100
Subject: [PATCH 0811/4023] Ensure children are constructed

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 77047479849..e09a420f998 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -206,6 +206,10 @@ public function addChild(NavItem $item): static
     {
         $item->group ??= $this->group;
 
+        if (!isset($this->children)) {
+            $this->children = [];
+        }
+
         $this->children[] = $item;
         $this->destination = null;
 

From abf031618c82ac91f4bd7a610aaaa9b4f4d31f83 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:02:12 +0100
Subject: [PATCH 0812/4023] Revert "Ensure children are constructed"

This reverts commit 46dd08dd0ad2ab210bf3b6c01649e2c97b605504.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index e09a420f998..77047479849 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -206,10 +206,6 @@ public function addChild(NavItem $item): static
     {
         $item->group ??= $this->group;
 
-        if (!isset($this->children)) {
-            $this->children = [];
-        }
-
         $this->children[] = $item;
         $this->destination = null;
 

From 5b43c7c0eaeb3aedbe0bdca2e9d42e3932ddb573 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:02:39 +0100
Subject: [PATCH 0813/4023] Initialize children property

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 77047479849..31ccb67b004 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -40,7 +40,7 @@ class NavItem implements Stringable
     protected string $identifier;
 
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
-    protected array $children;
+    protected array $children = [];
 
     /**
      * Create a new navigation menu item.

From aeff6c45919f135da7e4032e76214a2107c91294 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:04:40 +0100
Subject: [PATCH 0814/4023] Remove redundant null return for null type

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 31ccb67b004..d71e642c7e6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -114,10 +114,6 @@ public function __toString(): string
      */
     public function getDestination(): ?Route
     {
-        if ($this->hasChildren()) {
-            return null;
-        }
-
         return $this->destination;
     }
 

From c76ec470fd9f48305e08e2d8b72e22d091bbf95b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:12:28 +0100
Subject: [PATCH 0815/4023] Add default value to method signature

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d71e642c7e6..cbec59c07ba 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -96,7 +96,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, ?int $priority = null): static
+    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
     {
         return new static(null, $label, $priority ?? NavigationMenu::LAST, $label, $items);
     }

From edb8b50f9f073d67a351b64b510fe7e2b181dcf4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:37:41 +0100
Subject: [PATCH 0816/4023] Add null coalesce to default priority in generator

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 342a696d96b..b407234ff98 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -160,7 +160,7 @@ protected function createGroupItem(string $groupKey, string $groupName): NavItem
 
         $priority = $this->searchForGroupPriorityInConfig($groupKey);
 
-        return NavItem::forGroup($this->normalizeGroupLabel($label), [], $priority);
+        return NavItem::forGroup($this->normalizeGroupLabel($label), [], $priority ?? NavigationMenu::LAST);
     }
 
     protected function normalizeGroupLabel(string $label): string

From 305b53bb328c1bd377888af4ed2ec7024ccc357e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:38:27 +0100
Subject: [PATCH 0817/4023] Remove null coalesce moved to default value

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index cbec59c07ba..577ebbe19fd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -98,7 +98,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      */
     public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
     {
-        return new static(null, $label, $priority ?? NavigationMenu::LAST, $label, $items);
+        return new static(null, $label, $priority, $label, $items);
     }
 
     /**

From 4036c3c3174e497ca3388440624c19fca825f346 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 12:49:55 +0100
Subject: [PATCH 0818/4023] Remove nullable priority parameter type

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 577ebbe19fd..c487e8094a2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -94,9 +94,9 @@ public static function forLink(string $href, string $label, int $priority = Navi
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
-     * @param  int|null  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
+     * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, ?int $priority = NavigationMenu::LAST): static
+    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
     {
         return new static(null, $label, $priority, $label, $items);
     }

From 418db0055b95d065628c03290f85d3a680647da2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 13:02:18 +0100
Subject: [PATCH 0819/4023] Document constructor

---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c487e8094a2..4132e9bd2f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -45,7 +45,11 @@ class NavItem implements Stringable
     /**
      * Create a new navigation menu item.
      *
-     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $children
+     * @param  \Hyde\Support\Models\Route|string|null  $destination  Route instance, route key, or external URI. For dropdowns/groups, this should be null.
+     * @param  string  $label  The label of the navigation item.
+     * @param  int  $priority  The priority to determine the order of the navigation item.
+     * @param  string|null  $group  The dropdown/group identifier of the navigation item, if any.
+     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $children  If the item is a dropdown, these are the items to be included in the dropdown.
      */
     public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
     {

From e6c8cc252bb2c8d42b667db456911d9e1661be82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 15:05:42 +0100
Subject: [PATCH 0820/4023] Rename protected `$destination` property to
 `$route`

---
 .../src/Framework/Features/Navigation/NavItem.php    | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4132e9bd2f6..a3e08699405 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -31,7 +31,7 @@
  */
 class NavItem implements Stringable
 {
-    protected ?Route $destination;
+    protected ?Route $route;
     protected string $label;
     protected int $priority;
     protected ?string $group;
@@ -57,7 +57,7 @@ public function __construct(Route|string|null $destination, string $label, int $
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);
         }
 
-        $this->destination = $destination;
+        $this->route = $destination;
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
@@ -118,7 +118,7 @@ public function __toString(): string
      */
     public function getDestination(): ?Route
     {
-        return $this->destination;
+        return $this->route;
     }
 
     /**
@@ -126,7 +126,7 @@ public function getDestination(): ?Route
      */
     public function getLink(): string
     {
-        return (string) $this->destination;
+        return (string) $this->route;
     }
 
     /**
@@ -194,7 +194,7 @@ public function hasChildren(): bool
      */
     public function isCurrent(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
+        return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
     /**
@@ -207,7 +207,7 @@ public function addChild(NavItem $item): static
         $item->group ??= $this->group;
 
         $this->children[] = $item;
-        $this->destination = null;
+        $this->route = null;
 
         return $this;
     }

From 0d74b95b043f8dccc0c6cb75d648e50f4fcd3f1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 15:06:21 +0100
Subject: [PATCH 0821/4023] Breaking: Rename `NavItem` method `getDestination`
 to `getRoute`

Since the destination property in v2 is normalized to always be a route it no longer makes sense to have a divergent name for it.
---
 .../components/docs/sidebar-item.blade.php    |  4 +--
 .../Framework/Features/Navigation/NavItem.php |  4 +--
 packages/framework/tests/Unit/NavItemTest.php | 32 +++++++++----------
 3 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index cb0274b5304..6ffdf19c025 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -4,7 +4,7 @@
         : 'active bg-black/5 dark:bg-black/10' => $item->isCurrent()
     ]) role="listitem">
     @if($item->isCurrent())
-        <a href="{{ $item->getDestination() }}" aria-current="true" @class([$grouped
+        <a href="{{ $item->getRoute() }}" aria-current="true" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
         ])>
@@ -16,7 +16,7 @@
             {!! $page->getTableOfContents() !!}
         @endif
     @else
-        <a href="{{ $item->getDestination() }}" @class([$grouped
+        <a href="{{ $item->getRoute() }}" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block border-l-[0.325rem] border-transparent transition-colors duration-300 ease-in-out hover:bg-black/10'
             : 'block -ml-4 p-2 border-l-[0.325rem] border-transparent hover:bg-black/5 dark:hover:bg-black/10'
         ])>
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a3e08699405..ec15982bc4f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -116,7 +116,7 @@ public function __toString(): string
     /**
      * Get the destination route of the navigation item. For dropdowns, this will return null.
      */
-    public function getDestination(): ?Route
+    public function getRoute(): ?Route
     {
         return $this->route;
     }
@@ -144,7 +144,7 @@ public function getLabel(): string
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && $this->children[0]->getDestination()->getPageClass() === DocumentationPage::class) {
+        if ($this->hasChildren() && $this->children[0]->getRoute()->getPageClass() === DocumentationPage::class) {
             return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 525dad28367..eeb3294fd7c 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -44,36 +44,36 @@ public function testConstruct()
         $route = new Route(new MarkdownPage());
         $item = new NavItem($route, 'Test', 500);
 
-        $this->assertSame($route, $item->getDestination());
+        $this->assertSame($route, $item->getRoute());
     }
 
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());
-        $this->assertSame($route, (new NavItem($route, 'Home'))->getDestination());
+        $this->assertSame($route, (new NavItem($route, 'Home'))->getRoute());
     }
 
     public function testPassingRouteKeyToConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');
 
-        $this->assertSame($route, (new NavItem('index', 'Home'))->getDestination());
+        $this->assertSame($route, (new NavItem('index', 'Home'))->getRoute());
     }
 
     public function testPassingUrlToConstructorUsesExternalRoute()
     {
         $item = new NavItem('https://example.com', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->getDestination());
-        $this->assertEquals(new ExternalRoute('https://example.com'), $item->getDestination());
-        $this->assertSame('https://example.com', (string) $item->getDestination());
+        $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
+        $this->assertEquals(new ExternalRoute('https://example.com'), $item->getRoute());
+        $this->assertSame('https://example.com', (string) $item->getRoute());
     }
 
     public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     {
         $item = new NavItem('foo', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->getDestination());
-        $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
-        $this->assertSame('foo', (string) $item->getDestination());
+        $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
+        $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
+        $this->assertSame('foo', (string) $item->getRoute());
     }
 
     public function testCanConstructWithChildren()
@@ -86,7 +86,7 @@ public function testCanConstructWithChildren()
         $item = new NavItem($route, 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getDestination());
+        $this->assertNull($item->getRoute());
         $this->assertSame(500, $item->getPriority());
 
         $this->assertCount(2, $item->getChildren());
@@ -111,7 +111,7 @@ public function testCanConstructWithChildrenWithoutRoute()
         $item = new NavItem('', 'Test', 500, null, $children);
 
         $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getDestination());
+        $this->assertNull($item->getRoute());
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());
@@ -122,7 +122,7 @@ public function testGetDestination()
         $route = new Route(new InMemoryPage('foo'));
         $navItem = new NavItem($route, 'Page', 500);
 
-        $this->assertSame($route, $navItem->getDestination());
+        $this->assertSame($route, $navItem->getRoute());
     }
 
     public function testGetLink()
@@ -171,7 +171,7 @@ public function testFromRoute()
         $route = new Route(new MarkdownPage());
         $item = NavItem::forRoute($route);
 
-        $this->assertSame($route, $item->getDestination());
+        $this->assertSame($route, $item->getRoute());
     }
 
     public function testToString()
@@ -185,7 +185,7 @@ public function testForLink()
     {
         $item = NavItem::forLink('foo', 'bar');
 
-        $this->assertEquals(new ExternalRoute('foo'), $item->getDestination());
+        $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
         $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
     }
@@ -200,7 +200,7 @@ public function testForRoute()
         $route = Routes::get('404');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route, $item->getDestination());
+        $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame(999, $item->getPriority());
     }
@@ -210,7 +210,7 @@ public function testForIndexRoute()
         $route = Routes::get('index');
         $item = NavItem::forRoute($route, 'foo');
 
-        $this->assertSame($route, $item->getDestination());
+        $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
     }

From 64c3e0e6fc9eeff4a33eaba012b4551071126521 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 15:18:48 +0100
Subject: [PATCH 0822/4023] Breaking: Rename `NavItem` method `isCurrent` to
 `isActive`

While the method is implemented by using the `currentRoute` helper, the actual end usage is to compare active state, so it makes more sense for this to use that in the name.

   - `isActive()` is more common and may be more intuitive to other developers, as it explicitly suggests that the method is checking if the item is active.
   - `isCurrent()` is also clear, but it might be slightly less common in this context. It still conveys the intended meaning effectively.
---
 .../components/docs/sidebar-item.blade.php    |  4 +-
 .../navigation/navigation-link.blade.php      |  4 +-
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 ...Test.php => NavItemIsActiveHelperTest.php} | 70 +++++++++----------
 packages/framework/tests/Unit/NavItemTest.php | 10 +--
 5 files changed, 45 insertions(+), 45 deletions(-)
 rename packages/framework/tests/Unit/{NavItemIsCurrentHelperTest.php => NavItemIsActiveHelperTest.php} (90%)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index 6ffdf19c025..cab03d7c3f3 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -1,9 +1,9 @@
 @props(['grouped' => false])
 <li @class(['sidebar-item -ml-4 pl-4', $grouped
         ? 'active -ml-8 pl-8 bg-black/5 dark:bg-black/10'
-        : 'active bg-black/5 dark:bg-black/10' => $item->isCurrent()
+        : 'active bg-black/5 dark:bg-black/10' => $item->isActive()
     ]) role="listitem">
-    @if($item->isCurrent())
+    @if($item->isActive())
         <a href="{{ $item->getRoute() }}" aria-current="true" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index dbb5407245a..048faaa6cba 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,4 +1,4 @@
-<a href="{{ $item }}" {!! $item->isCurrent() ? 'aria-current="page"' : '' !!} @class([
+<a href="{{ $item }}" {!! $item->isActive() ? 'aria-current="page"' : '' !!} @class([
     'block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
-    'border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isCurrent()
+    'border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
 ])>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ec15982bc4f..6601a7a0027 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -192,7 +192,7 @@ public function hasChildren(): bool
     /**
      * Check if the NavItem instance is the current page being rendered.
      */
-    public function isCurrent(): bool
+    public function isActive(): bool
     {
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
diff --git a/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php b/packages/framework/tests/Unit/NavItemIsActiveHelperTest.php
similarity index 90%
rename from packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php
rename to packages/framework/tests/Unit/NavItemIsActiveHelperTest.php
index 97aa4de6f6f..bbd6d82b4d2 100644
--- a/packages/framework/tests/Unit/NavItemIsCurrentHelperTest.php
+++ b/packages/framework/tests/Unit/NavItemIsActiveHelperTest.php
@@ -18,7 +18,7 @@
  *
  * @see \Hyde\Framework\Testing\Unit\NavItemTest
  */
-class NavItemIsCurrentHelperTest extends UnitTestCase
+class NavItemIsActiveHelperTest extends UnitTestCase
 {
     public static function setUpBeforeClass(): void
     {
@@ -34,205 +34,205 @@ protected function tearDown(): void
     public function testIsCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavItem::forRoute(Routes::get('index'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavItem::forLink('index.html', 'Home')->isCurrent());
+        $this->assertTrue(NavItem::forLink('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute(Routes::get('index'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('index.html', 'Home')->isCurrent());
+        $this->assertFalse(NavItem::forLink('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
+        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz/bar'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNested()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverse()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo'))->isCurrent());
+        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/baz/bar.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/baz/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/baz/bar', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/baz/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithAbsoluteLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('/foo', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('/foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('/foo/bar', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('/foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('/foo/bar/baz', 'foo')->isCurrent());
+        $this->assertFalse(NavItem::forLink('/foo/bar/baz', 'foo')->isActive());
     }
 
     protected function mockRenderData(Route $route): void
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index eeb3294fd7c..614f24baef3 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -22,7 +22,7 @@
  *
  * @covers \Hyde\Framework\Features\Navigation\NavItem
  *
- * @see \Hyde\Framework\Testing\Unit\NavItemIsCurrentHelperTest
+ * @see \Hyde\Framework\Testing\Unit\NavItemIsActiveHelperTest
  */
 class NavItemTest extends UnitTestCase
 {
@@ -309,8 +309,8 @@ public function testIsCurrent()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertTrue(NavItem::forRoute(new Route(new InMemoryPage('foo')))->isCurrent());
-        $this->assertFalse(NavItem::forRoute(new Route(new InMemoryPage('bar')))->isCurrent());
+        $this->assertTrue(NavItem::forRoute(new Route(new InMemoryPage('foo')))->isActive());
+        $this->assertFalse(NavItem::forRoute(new Route(new InMemoryPage('bar')))->isActive());
     }
 
     public function testIsCurrentWithExternalRoute()
@@ -319,8 +319,8 @@ public function testIsCurrentWithExternalRoute()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertFalse(NavItem::forLink('foo', 'bar')->isCurrent());
-        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isCurrent());
+        $this->assertFalse(NavItem::forLink('foo', 'bar')->isActive());
+        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isActive());
     }
 
     public function testGetGroupWithNoGroup()

From f17a412c77f2480862797816a00ec111600a96d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 15:23:47 +0100
Subject: [PATCH 0823/4023] Breaking: Rename `NavItem` method `getGroup` to
 `getGroupIdentifier`

Renames `getGroup()` to `getGroupIdentifier()` to clarify the purpose of the method.
---
 .../Framework/Features/Navigation/NavItem.php |  2 +-
 .../Navigation/NavigationMenuGenerator.php    |  2 +-
 .../AutomaticNavigationConfigurationsTest.php |  2 +-
 .../Services/DocumentationSidebarTest.php     |  2 +-
 packages/framework/tests/Unit/NavItemTest.php | 20 +++++++++----------
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 6601a7a0027..631183c8ed0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -156,7 +156,7 @@ public function getPriority(): int
      *
      * For sidebars this is the category key, for navigation menus this is the dropdown key.
      */
-    public function getGroup(): ?string
+    public function getGroupIdentifier(): ?string
     {
         return $this->group;
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b407234ff98..fdc5cf33415 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -135,7 +135,7 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavItem::forRoute($route);
 
-        $groupName = $this->generatesSidebar ? ($item->getGroup() ?? 'Other') : $item->getGroup();
+        $groupName = $this->generatesSidebar ? ($item->getGroupIdentifier() ?? 'Other') : $item->getGroupIdentifier();
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ad5ac5a0712..8c20c50acda 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1317,7 +1317,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavItem $item): TestNavItem {
-            return new TestNavItem($item->getLabel(), $item->getGroup(), $item->getPriority(), $item->getChildren());
+            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item->getChildren());
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 5195d1f3fdc..89c4d055e7d 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -157,7 +157,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getChildren())->first()->getGroup());
+        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getChildren())->first()->getGroupIdentifier());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 614f24baef3..607e976911a 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -146,7 +146,7 @@ public function testGetPriority()
     public function testGetGroup()
     {
         $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertNull($navItem->getGroup());
+        $this->assertNull($navItem->getGroupIdentifier());
     }
 
     public function testGetChildren()
@@ -325,28 +325,28 @@ public function testIsCurrentWithExternalRoute()
 
     public function testGetGroupWithNoGroup()
     {
-        $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroup());
+        $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupIdentifier());
     }
 
     public function testGetGroupWithGroup()
     {
-        $this->assertSame('foo', (new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroup());
+        $this->assertSame('foo', (new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupIdentifier());
     }
 
     public function testGetGroupFromRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroup());
+        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupIdentifier());
     }
 
     public function testGetGroupForRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroup());
+        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupIdentifier());
     }
 
     public function testGroupKeysAreNormalized()
     {
         $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
-        $this->assertSame('foo-bar', $item->getGroup());
+        $this->assertSame('foo-bar', $item->getGroupIdentifier());
     }
 
     public function testIdentifier()
@@ -434,8 +434,8 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
 
         $parent->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroup());
-        $this->assertSame('bar', $child->getGroup());
+        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('bar', $child->getGroupIdentifier());
     }
 
     public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
@@ -445,7 +445,7 @@ public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
 
         $parent->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroup());
-        $this->assertSame('foo', $child->getGroup());
+        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $child->getGroupIdentifier());
     }
 }

From 9646b5b55ec05d4ab1ca04f6754cf33206dcfd31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 17:02:54 +0100
Subject: [PATCH 0824/4023] Breaking: Rename `NavItem` method `getLink` to
 `getUrl`

Renames `getLink()` to `getUrl()` for clarity on what the method returns.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php | 4 ++--
 packages/framework/tests/Unit/NavItemTest.php               | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 631183c8ed0..b6d245d1cb2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -110,7 +110,7 @@ public static function forGroup(string $label, array $items, int $priority = Nav
      */
     public function __toString(): string
     {
-        return $this->getLink();
+        return $this->getUrl();
     }
 
     /**
@@ -124,7 +124,7 @@ public function getRoute(): ?Route
     /**
      * Resolve the destination link of the navigation item.
      */
-    public function getLink(): string
+    public function getUrl(): string
     {
         return (string) $this->route;
     }
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 607e976911a..5ecc2bb8d32 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -95,8 +95,8 @@ public function testCanConstructWithChildren()
         $this->assertSame('Foo', $item->getChildren()[0]->getLabel());
         $this->assertSame('Bar', $item->getChildren()[1]->getLabel());
 
-        $this->assertSame('foo.html', $item->getChildren()[0]->getLink());
-        $this->assertSame('bar.html', $item->getChildren()[1]->getLink());
+        $this->assertSame('foo.html', $item->getChildren()[0]->getUrl());
+        $this->assertSame('bar.html', $item->getChildren()[1]->getUrl());
 
         $this->assertSame(500, $item->getChildren()[0]->getPriority());
         $this->assertSame(500, $item->getChildren()[1]->getPriority());
@@ -128,7 +128,7 @@ public function testGetDestination()
     public function testGetLink()
     {
         $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('foo.html', $navItem->getLink());
+        $this->assertSame('foo.html', $navItem->getUrl());
     }
 
     public function testGetLabel()

From b40f49d29ea1827b8abeb3cfb9572dfc5e28682e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 16:04:35 +0100
Subject: [PATCH 0825/4023] Create NavGroupItem.php

---
 .../src/Framework/Features/Navigation/NavGroupItem.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavGroupItem.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
new file mode 100644
index 00000000000..29a95c96912
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavGroupItem
+{
+    //
+}

From e56696e6c7d40f542661350e069ff51e51436d65 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 16:51:58 +0100
Subject: [PATCH 0826/4023] Class `NavGroupItem` extends `NavItem`

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 29a95c96912..cef48c39482 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-class NavGroupItem
+class NavGroupItem extends NavItem
 {
     //
 }

From 2ba269ea8bf1105d43dc45662ec57e648c4c3d63 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:11:02 +0100
Subject: [PATCH 0827/4023] Begin move of child items array to child class

---
 .../src/Framework/Features/Navigation/NavGroupItem.php     | 7 ++++++-
 .../src/Framework/Features/Navigation/NavItem.php          | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index cef48c39482..2bd4f505a5e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -6,5 +6,10 @@
 
 class NavGroupItem extends NavItem
 {
-    //
+    /**
+     * @deprecated Rename to $items
+     *
+     * @var array<\Hyde\Framework\Features\Navigation\NavItem>
+     */
+    protected array $children = [];
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b6d245d1cb2..3b2e836ee8b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -39,7 +39,7 @@ class NavItem implements Stringable
     /** The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
     protected string $identifier;
 
-    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
+    /** @deprecated Use NavGroupItem::$items instead */
     protected array $children = [];
 
     /**

From f469ab266a86c5a2fadb2e0270ba52c13c1bf170 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:22:29 +0100
Subject: [PATCH 0828/4023] Update static group constructor to point to new
 class

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 3b2e836ee8b..178695f313c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -102,7 +102,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      */
     public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
     {
-        return new static(null, $label, $priority, $label, $items);
+        return new NavGroupItem(null, $label, $priority, $label, $items);
     }
 
     /**

From d64e6c06e57c1ff85946f489d62bde509a691bb5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:26:37 +0100
Subject: [PATCH 0829/4023] Move getChildren method to child class

---
 .../Framework/Features/Navigation/NavGroupItem.php   | 12 ++++++++++++
 .../src/Framework/Features/Navigation/NavItem.php    | 12 ------------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 2bd4f505a5e..32a8b3dbab1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -12,4 +12,16 @@ class NavGroupItem extends NavItem
      * @var array<\Hyde\Framework\Features\Navigation\NavItem>
      */
     protected array $children = [];
+
+    /**
+     * Get the children of the navigation item.
+     *
+     * For the main navigation menu, this stores any dropdown items.
+     *
+     * @return array<\Hyde\Framework\Features\Navigation\NavItem>
+     */
+    public function getChildren(): array
+    {
+        return $this->children;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 178695f313c..4440159f4be 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -169,18 +169,6 @@ public function getIdentifier(): string
         return $this->identifier;
     }
 
-    /**
-     * Get the children of the navigation item.
-     *
-     * For the main navigation menu, this stores any dropdown items.
-     *
-     * @return array<\Hyde\Framework\Features\Navigation\NavItem>
-     */
-    public function getChildren(): array
-    {
-        return $this->children;
-    }
-
     /**
      * Check if the NavItem instance has children.
      */

From f30baaf9b7f5fe86b3dc42c55390da30e3c47df9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:29:30 +0100
Subject: [PATCH 0830/4023] Add temporary deprecated compatibility

---
 .../src/Framework/Features/Navigation/NavItem.php         | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4440159f4be..1cb7976c60a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -169,6 +169,14 @@ public function getIdentifier(): string
         return $this->identifier;
     }
 
+    /**
+     * @deprecated Should not be called on this class
+     */
+    public function getChildren(): array
+    {
+        return $this->children;
+    }
+
     /**
      * Check if the NavItem instance has children.
      */

From 3fa5fdf6b85d0b6e3c7ab0e389826a20d3f5527c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:31:47 +0100
Subject: [PATCH 0831/4023] Begin hasChildren method move

---
 .../src/Framework/Features/Navigation/NavGroupItem.php    | 8 ++++++++
 .../src/Framework/Features/Navigation/NavItem.php         | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 32a8b3dbab1..7180f9d0fad 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -24,4 +24,12 @@ public function getChildren(): array
     {
         return $this->children;
     }
+
+    /**
+     * Check if the NavItem instance has children.
+     */
+    public function hasChildren(): bool
+    {
+        return count($this->children) > 0;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 1cb7976c60a..0da63796bc4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -178,7 +178,7 @@ public function getChildren(): array
     }
 
     /**
-     * Check if the NavItem instance has children.
+     * @deprecated Should not be called on this class
      */
     public function hasChildren(): bool
     {

From c55ded4dbda866cb0ef88fe623c00d9e03d54d11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:32:58 +0100
Subject: [PATCH 0832/4023] Begin addChild method move

---
 .../Features/Navigation/NavGroupItem.php          | 15 +++++++++++++++
 .../src/Framework/Features/Navigation/NavItem.php |  4 +---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 7180f9d0fad..9fe41aaf1b2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -32,4 +32,19 @@ public function hasChildren(): bool
     {
         return count($this->children) > 0;
     }
+
+    /**
+     * Add a navigation item to the children of the navigation item.
+     *
+     * This will turn the parent item into a dropdown. Its destination will be set to null.
+     */
+    public function addChild(NavItem $item): static
+    {
+        $item->group ??= $this->group;
+
+        $this->children[] = $item;
+        $this->route = null;
+
+        return $this;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0da63796bc4..32f7f2547e1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -194,9 +194,7 @@ public function isActive(): bool
     }
 
     /**
-     * Add a navigation item to the children of the navigation item.
-     *
-     * This will turn the parent item into a dropdown. Its destination will be set to null.
+     * @deprecated Should not be called on this class
      */
     public function addChild(NavItem $item): static
     {

From 10480ccb4d538dcdf65809b249527de7c1e9656b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:33:25 +0100
Subject: [PATCH 0833/4023] Begin addChildren method move

---
 .../Framework/Features/Navigation/NavGroupItem.php | 14 ++++++++++++++
 .../src/Framework/Features/Navigation/NavItem.php  |  4 +---
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 9fe41aaf1b2..71cc89bc3fc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -47,4 +47,18 @@ public function addChild(NavItem $item): static
 
         return $this;
     }
+
+    /**
+     * Add multiple navigation items to the children of the navigation item.
+     *
+     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
+     */
+    public function addChildren(array $items): static
+    {
+        foreach ($items as $item) {
+            $this->addChild($item);
+        }
+
+        return $this;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 32f7f2547e1..7405c2548f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -207,9 +207,7 @@ public function addChild(NavItem $item): static
     }
 
     /**
-     * Add multiple navigation items to the children of the navigation item.
-     *
-     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
+     * @deprecated Should not be called on this class
      */
     public function addChildren(array $items): static
     {

From 12512e5df4a2d3eaa45a4786672bb3adf5d12d74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:33:54 +0100
Subject: [PATCH 0834/4023] Add todo

---
 .../src/Framework/Features/Navigation/NavGroupItem.php         | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 71cc89bc3fc..edd892493ab 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * @todo Consider extracting trait for shared code with navigation menu class
+ */
 class NavGroupItem extends NavItem
 {
     /**

From 9996039a993111c4b81c8c3177cfdc79853aaa1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:35:47 +0100
Subject: [PATCH 0835/4023] Create initial child constructor

---
 .../src/Framework/Features/Navigation/NavGroupItem.php      | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index edd892493ab..65c12f08be6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -16,6 +16,12 @@ class NavGroupItem extends NavItem
      */
     protected array $children = [];
 
+    public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
+    {
+        parent::__construct(null, $label, $priority, $label);
+        $this->children = $children;
+    }
+
     /**
      * Get the children of the navigation item.
      *

From eceb24b8d1457375d6709e280f18669d6dae995c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:40:11 +0100
Subject: [PATCH 0836/4023] Fix constructor call

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7405c2548f7..c0dd042a613 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -102,7 +102,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      */
     public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
     {
-        return new NavGroupItem(null, $label, $priority, $label, $items);
+        return new NavGroupItem($label, $priority, $items);
     }
 
     /**

From a4c04085d0a9d1b1797acac56dad3638f7ac05ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:40:15 +0100
Subject: [PATCH 0837/4023] Normalize label as group key

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 65c12f08be6..61bd32caa77 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -18,7 +18,7 @@ class NavGroupItem extends NavItem
 
     public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
     {
-        parent::__construct(null, $label, $priority, $label);
+        parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
         $this->children = $children;
     }
 

From 5822bf7381c0d05a0c2e63b822f833f99b4bb336 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:44:13 +0100
Subject: [PATCH 0838/4023] Add children using method

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 61bd32caa77..bd1fb1adef7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -19,7 +19,7 @@ class NavGroupItem extends NavItem
     public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
-        $this->children = $children;
+        $this->addChildren($children);
     }
 
     /**

From b4928c51bf00fe46427a782623951be8b32a3b1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 1 Mar 2024 21:44:34 +0100
Subject: [PATCH 0839/4023] Remove child constructor from base class

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c0dd042a613..8e41a4c3567 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -62,7 +62,6 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = static::makeIdentifier($label);
-        $this->addChildren($children);
     }
 
     /**

From fadcc4639cffc056cc4f17be0c1da869e8b3043c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 11:46:54 +0100
Subject: [PATCH 0840/4023] Revert "Remove child constructor from base class"

This reverts commit b4928c51bf00fe46427a782623951be8b32a3b1d.
---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8e41a4c3567..c0dd042a613 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -62,6 +62,7 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = static::makeIdentifier($label);
+        $this->addChildren($children);
     }
 
     /**

From 5d7330681bb6f1d720dd95087e947a437d9b8381 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 11:49:28 +0100
Subject: [PATCH 0841/4023] Deprecate child parameter

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index c0dd042a613..4d7ce432adf 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Pages\DocumentationPage;
+use JetBrains\PhpStorm\Deprecated;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -49,9 +50,8 @@ class NavItem implements Stringable
      * @param  string  $label  The label of the navigation item.
      * @param  int  $priority  The priority to determine the order of the navigation item.
      * @param  string|null  $group  The dropdown/group identifier of the navigation item, if any.
-     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $children  If the item is a dropdown, these are the items to be included in the dropdown.
      */
-    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, array $children = [])
+    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, #[Deprecated] array $children = [])
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);

From 02e836e7b38e9bc975577b8472b3fca99819d693 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 11:51:46 +0100
Subject: [PATCH 0842/4023] Create NavGroupItemTest.php

---
 .../framework/tests/Unit/NavGroupItemTest.php | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 packages/framework/tests/Unit/NavGroupItemTest.php

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
new file mode 100644
index 00000000000..ab1d985b33e
--- /dev/null
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Facades\Render;
+use Hyde\Support\Models\RenderData;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavGroupItem
+ */
+class NavGroupItemTest extends UnitTestCase
+{
+    public static function setUpBeforeClass(): void
+    {
+        self::$hasSetUpKernel = false;
+
+        self::needsKernel();
+        self::mockConfig();
+    }
+
+    protected function setUp(): void
+    {
+        Render::swap(new RenderData());
+    }
+}

From 737734d904a171db22d34fdcb4d38b4be87b1788 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 11:53:15 +0100
Subject: [PATCH 0843/4023] Move group specific tests to new unit test

---
 .../framework/tests/Unit/NavGroupItemTest.php | 141 ++++++++++++++++++
 packages/framework/tests/Unit/NavItemTest.php | 137 -----------------
 2 files changed, 141 insertions(+), 137 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ab1d985b33e..68cda33f6cd 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -4,9 +4,13 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
+use Hyde\Framework\Features\Navigation\NavItem;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavGroupItem
@@ -25,4 +29,141 @@ protected function setUp(): void
     {
         Render::swap(new RenderData());
     }
+
+    public function testCanConstructWithChildren()
+    {
+        $route = new Route(new MarkdownPage());
+        $children = [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ];
+        $item = new NavItem($route, 'Test', 500, null, $children);
+
+        $this->assertSame('Test', $item->getLabel());
+        $this->assertNull($item->getRoute());
+        $this->assertSame(500, $item->getPriority());
+
+        $this->assertCount(2, $item->getChildren());
+        $this->assertSame($children, $item->getChildren());
+
+        $this->assertSame('Foo', $item->getChildren()[0]->getLabel());
+        $this->assertSame('Bar', $item->getChildren()[1]->getLabel());
+
+        $this->assertSame('foo.html', $item->getChildren()[0]->getUrl());
+        $this->assertSame('bar.html', $item->getChildren()[1]->getUrl());
+
+        $this->assertSame(500, $item->getChildren()[0]->getPriority());
+        $this->assertSame(500, $item->getChildren()[1]->getPriority());
+    }
+
+    public function testCanConstructWithChildrenWithoutRoute()
+    {
+        $children = [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ];
+        $item = new NavItem('', 'Test', 500, null, $children);
+
+        $this->assertSame('Test', $item->getLabel());
+        $this->assertNull($item->getRoute());
+
+        $this->assertCount(2, $item->getChildren());
+        $this->assertSame($children, $item->getChildren());
+    }
+
+    public function testGetChildren()
+    {
+        $children = [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ];
+
+        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500, null, $children);
+        $this->assertSame($children, $navItem->getChildren());
+    }
+
+    public function testGetChildrenWithNoChildren()
+    {
+        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertEmpty($navItem->getChildren());
+    }
+
+    public function testHasChildren()
+    {
+        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500);
+        $this->assertFalse($item->hasChildren());
+    }
+
+    public function testHasChildrenWithChildren()
+    {
+        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, null, [
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
+        ]);
+        $this->assertTrue($item->hasChildren());
+    }
+
+    public function testCanAddMultipleItemsToDropdown()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+
+        $this->assertSame([], $parent->getChildren());
+
+        $parent->addChildren([$child1, $child2]);
+
+        $this->assertSame([$child1, $child2], $parent->getChildren());
+    }
+
+    public function testAddChildrenMethodReturnsSelf()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+
+        $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
+    }
+
+    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
+
+        $parent->addChild($child);
+
+        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('bar', $child->getGroupIdentifier());
+    }
+
+    public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
+
+        $parent->addChild($child);
+
+        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $child->getGroupIdentifier());
+    }
+
+    public function testCanAddItemToDropdown()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+
+        $this->assertSame([], $parent->getChildren());
+
+        $parent->addChild($child);
+
+        $this->assertSame([$child], $parent->getChildren());
+    }
+
+    public function testAddChildMethodReturnsSelf()
+    {
+        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+
+        $this->assertSame($parent, $parent->addChild($child));
+    }
 }
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 5ecc2bb8d32..a56e057365b 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -76,47 +76,6 @@ public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
         $this->assertSame('foo', (string) $item->getRoute());
     }
 
-    public function testCanConstructWithChildren()
-    {
-        $route = new Route(new MarkdownPage());
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
-        $item = new NavItem($route, 'Test', 500, null, $children);
-
-        $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getRoute());
-        $this->assertSame(500, $item->getPriority());
-
-        $this->assertCount(2, $item->getChildren());
-        $this->assertSame($children, $item->getChildren());
-
-        $this->assertSame('Foo', $item->getChildren()[0]->getLabel());
-        $this->assertSame('Bar', $item->getChildren()[1]->getLabel());
-
-        $this->assertSame('foo.html', $item->getChildren()[0]->getUrl());
-        $this->assertSame('bar.html', $item->getChildren()[1]->getUrl());
-
-        $this->assertSame(500, $item->getChildren()[0]->getPriority());
-        $this->assertSame(500, $item->getChildren()[1]->getPriority());
-    }
-
-    public function testCanConstructWithChildrenWithoutRoute()
-    {
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
-        $item = new NavItem('', 'Test', 500, null, $children);
-
-        $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getRoute());
-
-        $this->assertCount(2, $item->getChildren());
-        $this->assertSame($children, $item->getChildren());
-    }
-
     public function testGetDestination()
     {
         $route = new Route(new InMemoryPage('foo'));
@@ -149,23 +108,6 @@ public function testGetGroup()
         $this->assertNull($navItem->getGroupIdentifier());
     }
 
-    public function testGetChildren()
-    {
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
-
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500, null, $children);
-        $this->assertSame($children, $navItem->getChildren());
-    }
-
-    public function testGetChildrenWithNoChildren()
-    {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertEmpty($navItem->getChildren());
-    }
-
     public function testFromRoute()
     {
         $route = new Route(new MarkdownPage());
@@ -288,21 +230,6 @@ public function testDropdownFacadeWithCustomPriority()
         $this->assertSame(500, $item->getPriority());
     }
 
-    public function testHasChildren()
-    {
-        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500);
-        $this->assertFalse($item->hasChildren());
-    }
-
-    public function testHasChildrenWithChildren()
-    {
-        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, null, [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ]);
-        $this->assertTrue($item->hasChildren());
-    }
-
     public function testIsCurrent()
     {
         Render::swap(Mockery::mock(RenderData::class, [
@@ -384,68 +311,4 @@ public function testIdentifierUsesLabelForExternalRoute()
         $item = NavItem::forLink('https://example.com', 'Foo Bar');
         $this->assertSame('foo-bar', $item->getIdentifier());
     }
-
-    public function testCanAddItemToDropdown()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
-
-        $this->assertSame([], $parent->getChildren());
-
-        $parent->addChild($child);
-
-        $this->assertSame([$child], $parent->getChildren());
-    }
-
-    public function testAddChildMethodReturnsSelf()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
-
-        $this->assertSame($parent, $parent->addChild($child));
-    }
-
-    public function testCanAddMultipleItemsToDropdown()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
-
-        $this->assertSame([], $parent->getChildren());
-
-        $parent->addChildren([$child1, $child2]);
-
-        $this->assertSame([$child1, $child2], $parent->getChildren());
-    }
-
-    public function testAddChildrenMethodReturnsSelf()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
-
-        $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
-    }
-
-    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
-
-        $parent->addChild($child);
-
-        $this->assertSame('foo', $parent->getGroupIdentifier());
-        $this->assertSame('bar', $child->getGroupIdentifier());
-    }
-
-    public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
-    {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
-
-        $parent->addChild($child);
-
-        $this->assertSame('foo', $parent->getGroupIdentifier());
-        $this->assertSame('foo', $child->getGroupIdentifier());
-    }
 }

From 8c54d451e2226ad349b8cd7632420b68e6476b05 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:09:57 +0100
Subject: [PATCH 0844/4023] Begin refactoring test to use the new child class

---
 .../framework/tests/Unit/NavGroupItemTest.php | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 68cda33f6cd..4e6db8e7af0 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -11,6 +11,7 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
 use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavGroupItem;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavGroupItem
@@ -32,12 +33,11 @@ protected function setUp(): void
 
     public function testCanConstructWithChildren()
     {
-        $route = new Route(new MarkdownPage());
         $children = [
             new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
             new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
         ];
-        $item = new NavItem($route, 'Test', 500, null, $children);
+        $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
@@ -62,7 +62,7 @@ public function testCanConstructWithChildrenWithoutRoute()
             new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
             new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
         ];
-        $item = new NavItem('', 'Test', 500, null, $children);
+        $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
@@ -78,25 +78,25 @@ public function testGetChildren()
             new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
         ];
 
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500, null, $children);
+        $navItem = new NavGroupItem('Page', 500, $children);
         $this->assertSame($children, $navItem->getChildren());
     }
 
     public function testGetChildrenWithNoChildren()
     {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $navItem = new NavGroupItem('Page', 500);
         $this->assertEmpty($navItem->getChildren());
     }
 
     public function testHasChildren()
     {
-        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500);
+        $item = new NavGroupItem('Test', 500);
         $this->assertFalse($item->hasChildren());
     }
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, null, [
+        $item = new NavGroupItem('Test', 500, [
             new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
             new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
         ]);
@@ -105,7 +105,7 @@ public function testHasChildrenWithChildren()
 
     public function testCanAddMultipleItemsToDropdown()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
 
@@ -118,7 +118,7 @@ public function testCanAddMultipleItemsToDropdown()
 
     public function testAddChildrenMethodReturnsSelf()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
 
@@ -127,29 +127,29 @@ public function testAddChildrenMethodReturnsSelf()
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
 
         $parent->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('parent', $parent->getGroupIdentifier());
         $this->assertSame('bar', $child->getGroupIdentifier());
     }
 
     public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
 
         $parent->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroupIdentifier());
-        $this->assertSame('foo', $child->getGroupIdentifier());
+        $this->assertSame('parent', $parent->getGroupIdentifier());
+        $this->assertSame('parent', $child->getGroupIdentifier());
     }
 
     public function testCanAddItemToDropdown()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
 
         $this->assertSame([], $parent->getChildren());
@@ -161,7 +161,7 @@ public function testCanAddItemToDropdown()
 
     public function testAddChildMethodReturnsSelf()
     {
-        $parent = new NavItem(new Route(new MarkdownPage()), 'Parent', 500, 'foo');
+        $parent = new NavGroupItem('Parent', 500);
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
 
         $this->assertSame($parent, $parent->addChild($child));

From 0132df14a25ff54d151b8cdb9fb65e7b1ea52e91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:17:15 +0100
Subject: [PATCH 0845/4023] Refactor test to use normalized mock data

Co-Authored-By: GPT 3.5 Turbo <openai-machine-user@hydephp.com>
---
 .../framework/tests/Unit/NavGroupItemTest.php | 39 +++++++------------
 1 file changed, 14 insertions(+), 25 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 4e6db8e7af0..b8415b0f000 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -33,10 +33,7 @@ protected function setUp(): void
 
     public function testCanConstructWithChildren()
     {
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
+        $children = $this->createNavItems(['foo', 'bar']);
         $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
@@ -45,23 +42,11 @@ public function testCanConstructWithChildren()
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());
-
-        $this->assertSame('Foo', $item->getChildren()[0]->getLabel());
-        $this->assertSame('Bar', $item->getChildren()[1]->getLabel());
-
-        $this->assertSame('foo.html', $item->getChildren()[0]->getUrl());
-        $this->assertSame('bar.html', $item->getChildren()[1]->getUrl());
-
-        $this->assertSame(500, $item->getChildren()[0]->getPriority());
-        $this->assertSame(500, $item->getChildren()[1]->getPriority());
     }
 
     public function testCanConstructWithChildrenWithoutRoute()
     {
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
+        $children = $this->createNavItems(['foo', 'bar']);
         $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
@@ -73,10 +58,7 @@ public function testCanConstructWithChildrenWithoutRoute()
 
     public function testGetChildren()
     {
-        $children = [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ];
+        $children = $this->createNavItems(['foo', 'bar']);
 
         $navItem = new NavGroupItem('Page', 500, $children);
         $this->assertSame($children, $navItem->getChildren());
@@ -96,10 +78,7 @@ public function testHasChildren()
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Test', 500, [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo', 500),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar', 500),
-        ]);
+        $item = new NavGroupItem('Test', 500, $this->createNavItems(['foo', 'bar']));
         $this->assertTrue($item->hasChildren());
     }
 
@@ -166,4 +145,14 @@ public function testAddChildMethodReturnsSelf()
 
         $this->assertSame($parent, $parent->addChild($child));
     }
+
+    private function createNavItems(array $pages): array
+    {
+        $navItems = [];
+        foreach ($pages as $page) {
+            $navItems[] = new NavItem(new Route(new InMemoryPage($page)), ucfirst($page), 500);
+        }
+
+        return $navItems;
+    }
 }

From dcff0fd8735a04b5f109f8f53f6bd8c312bf8637 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:23:48 +0100
Subject: [PATCH 0846/4023] Inline constant parameter value

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index b8415b0f000..ae1c63b952d 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -148,6 +148,7 @@ public function testAddChildMethodReturnsSelf()
 
     private function createNavItems(array $pages): array
     {
+        $pages = ['foo', 'bar'];
         $navItems = [];
         foreach ($pages as $page) {
             $navItems[] = new NavItem(new Route(new InMemoryPage($page)), ucfirst($page), 500);

From cb141dc685bcb05a8f27b0c22bb3cd7640dbef7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:23:52 +0100
Subject: [PATCH 0847/4023] Remove unused parameter

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ae1c63b952d..4f4c821779b 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -33,7 +33,7 @@ protected function setUp(): void
 
     public function testCanConstructWithChildren()
     {
-        $children = $this->createNavItems(['foo', 'bar']);
+        $children = $this->createNavItems();
         $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
@@ -46,7 +46,7 @@ public function testCanConstructWithChildren()
 
     public function testCanConstructWithChildrenWithoutRoute()
     {
-        $children = $this->createNavItems(['foo', 'bar']);
+        $children = $this->createNavItems();
         $item = new NavGroupItem('Test', 500, $children);
 
         $this->assertSame('Test', $item->getLabel());
@@ -58,7 +58,7 @@ public function testCanConstructWithChildrenWithoutRoute()
 
     public function testGetChildren()
     {
-        $children = $this->createNavItems(['foo', 'bar']);
+        $children = $this->createNavItems();
 
         $navItem = new NavGroupItem('Page', 500, $children);
         $this->assertSame($children, $navItem->getChildren());
@@ -78,7 +78,7 @@ public function testHasChildren()
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Test', 500, $this->createNavItems(['foo', 'bar']));
+        $item = new NavGroupItem('Test', 500, $this->createNavItems());
         $this->assertTrue($item->hasChildren());
     }
 
@@ -146,7 +146,7 @@ public function testAddChildMethodReturnsSelf()
         $this->assertSame($parent, $parent->addChild($child));
     }
 
-    private function createNavItems(array $pages): array
+    private function createNavItems(): array
     {
         $pages = ['foo', 'bar'];
         $navItems = [];

From 847197d1053d74fbba6b6db04778e85e49e19517 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:26:07 +0100
Subject: [PATCH 0848/4023] Inline loop

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 4f4c821779b..a055b752e36 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -148,12 +148,8 @@ public function testAddChildMethodReturnsSelf()
 
     private function createNavItems(): array
     {
-        $pages = ['foo', 'bar'];
-        $navItems = [];
-        foreach ($pages as $page) {
-            $navItems[] = new NavItem(new Route(new InMemoryPage($page)), ucfirst($page), 500);
-        }
-
-        return $navItems;
+        return array_map(function(string $page): NavItem {
+            return new NavItem(new Route(new InMemoryPage($page)), ucfirst($page), 500);
+        }, ['foo', 'bar']);
     }
 }

From e9d46dc391f2b705fb23ba538bf67f526d81ee4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:28:08 +0100
Subject: [PATCH 0849/4023] Remove priority data not needed for test

---
 .../framework/tests/Unit/NavGroupItemTest.php  | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index a055b752e36..21e43c13414 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -66,13 +66,13 @@ public function testGetChildren()
 
     public function testGetChildrenWithNoChildren()
     {
-        $navItem = new NavGroupItem('Page', 500);
+        $navItem = new NavGroupItem('Page');
         $this->assertEmpty($navItem->getChildren());
     }
 
     public function testHasChildren()
     {
-        $item = new NavGroupItem('Test', 500);
+        $item = new NavGroupItem('Test');
         $this->assertFalse($item->hasChildren());
     }
 
@@ -84,7 +84,7 @@ public function testHasChildrenWithChildren()
 
     public function testCanAddMultipleItemsToDropdown()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
 
@@ -97,7 +97,7 @@ public function testCanAddMultipleItemsToDropdown()
 
     public function testAddChildrenMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
 
@@ -106,7 +106,7 @@ public function testAddChildrenMethodReturnsSelf()
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
 
         $parent->addChild($child);
@@ -117,7 +117,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
 
     public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
 
         $parent->addChild($child);
@@ -128,7 +128,7 @@ public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
 
     public function testCanAddItemToDropdown()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
 
         $this->assertSame([], $parent->getChildren());
@@ -140,7 +140,7 @@ public function testCanAddItemToDropdown()
 
     public function testAddChildMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Parent', 500);
+        $parent = new NavGroupItem('Parent');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
 
         $this->assertSame($parent, $parent->addChild($child));
@@ -149,7 +149,7 @@ public function testAddChildMethodReturnsSelf()
     private function createNavItems(): array
     {
         return array_map(function(string $page): NavItem {
-            return new NavItem(new Route(new InMemoryPage($page)), ucfirst($page), 500);
+            return new NavItem(new Route(new InMemoryPage($page)), ucfirst($page));
         }, ['foo', 'bar']);
     }
 }

From f8872ac523c0f3199e4ae2e5508de4c137fa6664 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:28:37 +0100
Subject: [PATCH 0850/4023] Normalize test label

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 21e43c13414..2291344ba6a 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -60,25 +60,25 @@ public function testGetChildren()
     {
         $children = $this->createNavItems();
 
-        $navItem = new NavGroupItem('Page', 500, $children);
+        $navItem = new NavGroupItem('Parent', 500, $children);
         $this->assertSame($children, $navItem->getChildren());
     }
 
     public function testGetChildrenWithNoChildren()
     {
-        $navItem = new NavGroupItem('Page');
+        $navItem = new NavGroupItem('Parent');
         $this->assertEmpty($navItem->getChildren());
     }
 
     public function testHasChildren()
     {
-        $item = new NavGroupItem('Test');
+        $item = new NavGroupItem('Parent');
         $this->assertFalse($item->hasChildren());
     }
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Test', 500, $this->createNavItems());
+        $item = new NavGroupItem('Parent', 500, $this->createNavItems());
         $this->assertTrue($item->hasChildren());
     }
 

From ae4ff97df02ce24c77905b5b21b410347caf238a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:29:12 +0100
Subject: [PATCH 0851/4023] Formatting

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 2291344ba6a..e76e0390a7a 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -148,7 +148,7 @@ public function testAddChildMethodReturnsSelf()
 
     private function createNavItems(): array
     {
-        return array_map(function(string $page): NavItem {
+        return array_map(function (string $page): NavItem {
             return new NavItem(new Route(new InMemoryPage($page)), ucfirst($page));
         }, ['foo', 'bar']);
     }

From 09801f8734c5b1ee6a5e81bc0bbff9aaf7e43f21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:31:32 +0100
Subject: [PATCH 0852/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavGroupItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index bd1fb1adef7..74e60331d47 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -16,6 +16,7 @@ class NavGroupItem extends NavItem
      */
     protected array $children = [];
 
+    // Todo: Consider putting children before priority as it is more commonly used
     public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));

From f8697b553ca062187307f899327197234d43f743 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:41:59 +0100
Subject: [PATCH 0853/4023] Move group priority logic to new child class

---
 .../Features/Navigation/NavGroupItem.php      | 19 +++++++++++++++++++
 .../Framework/Features/Navigation/NavItem.php |  9 ---------
 2 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 74e60331d47..14ebb714881 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -4,6 +4,11 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Pages\DocumentationPage;
+
+use function min;
+use function collect;
+
 /**
  * @todo Consider extracting trait for shared code with navigation menu class
  */
@@ -71,4 +76,18 @@ public function addChildren(array $items): static
 
         return $this;
     }
+
+    /**
+     * Get the priority to determine the order of the navigation item.
+     *
+     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
+     */
+    public function getPriority(): int
+    {
+        if ($this->hasChildren() && $this->children[0]->getRoute()->getPageClass() === DocumentationPage::class) {
+            return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
+        }
+
+        return parent::getPriority();
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4d7ce432adf..ed12bd60ab6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Pages\DocumentationPage;
 use JetBrains\PhpStorm\Deprecated;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
@@ -13,8 +12,6 @@
 use Stringable;
 use Hyde\Support\Models\ExternalRoute;
 
-use function min;
-use function collect;
 use function is_string;
 
 /**
@@ -139,15 +136,9 @@ public function getLabel(): string
 
     /**
      * Get the priority to determine the order of the navigation item.
-     *
-     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && $this->children[0]->getRoute()->getPageClass() === DocumentationPage::class) {
-            return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
-        }
-
         return $this->priority;
     }
 

From 4e0c4ad500131b8120d601455a30c9889def57fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:47:10 +0100
Subject: [PATCH 0854/4023] Add clarifying parentheses

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 14ebb714881..b10aa1ddf8d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -84,7 +84,7 @@ public function addChildren(array $items): static
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && $this->children[0]->getRoute()->getPageClass() === DocumentationPage::class) {
+        if ($this->hasChildren() && ($this->children[0]->getRoute()->getPageClass() === DocumentationPage::class)) {
             return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 

From be87703d51b8b9ce1f5eb7ce2949dab04f50efd0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:49:56 +0100
Subject: [PATCH 0855/4023] Improve priority state testing

---
 .../framework/tests/Unit/NavGroupItemTest.php | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index e76e0390a7a..8dbb849bb36 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -9,6 +9,7 @@
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\RenderData;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
@@ -146,6 +147,34 @@ public function testAddChildMethodReturnsSelf()
         $this->assertSame($parent, $parent->addChild($child));
     }
 
+    public function testGetPriorityUsesDefaultPriority()
+    {
+        $parent = new NavGroupItem('Parent');
+        $this->assertSame(500, $parent->getPriority());
+    }
+
+    public function testGetPriorityWithNoChildrenUsesGroupPriority()
+    {
+        $parent = new NavGroupItem('Parent');
+        $this->assertSame(500, $parent->getPriority());
+    }
+
+    public function testGetPriorityWithChildrenUsesGroupPriority()
+    {
+        $parent = new NavGroupItem('Parent');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 400, 'foo');
+        $parent->addChild($child);
+        $this->assertSame(500, $parent->getPriority());
+    }
+
+    public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
+    {
+        $parent = new NavGroupItem('Parent');
+        $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 400);
+        $parent->addChild($child);
+        $this->assertSame(400, $parent->getPriority());
+    }
+
     private function createNavItems(): array
     {
         return array_map(function (string $page): NavItem {

From 59974c62107a644ed1d7da798cf74ea2c3007976 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 12:55:36 +0100
Subject: [PATCH 0856/4023] Test get priority handles mixed child types

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 8dbb849bb36..8862f614600 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -11,6 +11,7 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\RenderData;
+use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
 
@@ -175,6 +176,19 @@ public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
         $this->assertSame(400, $parent->getPriority());
     }
 
+    public function testGetPriorityHandlesMixedChildTypes()
+    {
+        $parent = new NavGroupItem('Parent');
+
+        $types = HydeCoreExtension::getPageClasses();
+        foreach ($types as $type) {
+            $child = new NavItem(new Route(new $type()), 'Child', 100);
+            $parent->addChild($child);
+        }
+
+        $this->assertSame(500, $parent->getPriority());
+    }
+
     private function createNavItems(): array
     {
         return array_map(function (string $page): NavItem {

From 765e57cbb0d5ec84020e0c2348c40002f490048b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:40:57 +0100
Subject: [PATCH 0857/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavGroupItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index b10aa1ddf8d..d1a55509d43 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -22,6 +22,7 @@ class NavGroupItem extends NavItem
     protected array $children = [];
 
     // Todo: Consider putting children before priority as it is more commonly used
+    // Todo use last priority as default for groups
     public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));

From 556eb76848ef6a25ad25a6ed3be1c9a90b1635c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:41:07 +0100
Subject: [PATCH 0858/4023] Add todo

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index d1a55509d43..8e14a6c02a5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -82,6 +82,8 @@ public function addChildren(array $items): static
      * Get the priority to determine the order of the navigation item.
      *
      * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
+     *
+     * @todo Ensure support for external URLs
      */
     public function getPriority(): int
     {

From 9e83cdc70e7ee42bdbb6bab904fd637595f43b7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:49:45 +0100
Subject: [PATCH 0859/4023] Extract helper method

---
 .../src/Framework/Features/Navigation/NavGroupItem.php     | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 8e14a6c02a5..70e8c9ab960 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -87,10 +87,15 @@ public function addChildren(array $items): static
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && ($this->children[0]->getRoute()->getPageClass() === DocumentationPage::class)) {
+        if ($this->hasChildren() && $this->containsOnlyDocumentationPages()) {
             return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 
         return parent::getPriority();
     }
+
+    protected function containsOnlyDocumentationPages(): bool
+    {
+        return ($this->children[0]->getRoute()->getPageClass() === DocumentationPage::class);
+    }
 }

From c6860bd1cbf9644db7fbcb8213458c066317a292 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:56:15 +0100
Subject: [PATCH 0860/4023] Add more accurate state logic

For example, if it's a main menu group we don't want to change positioning if the docs index is linked. We don't have information here about which menu type it is, so this is a fair compromise.
---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 70e8c9ab960..29942a09e2a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -96,6 +96,6 @@ public function getPriority(): int
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return ($this->children[0]->getRoute()->getPageClass() === DocumentationPage::class);
+        return collect($this->getChildren())->every(fn (NavItem $child): bool => $child->getRoute()->getPageClass() === DocumentationPage::class);
     }
 }

From a1e41fc9aebb6bb602d8a3f912c2d1adc44a2c6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:58:06 +0100
Subject: [PATCH 0861/4023] Convert the arrow function to a traditional closure

---
 .../src/Framework/Features/Navigation/NavGroupItem.php        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 29942a09e2a..b39e13d4e28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -96,6 +96,8 @@ public function getPriority(): int
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return collect($this->getChildren())->every(fn (NavItem $child): bool => $child->getRoute()->getPageClass() === DocumentationPage::class);
+        return collect($this->getChildren())->every(function (NavItem $child): bool {
+            return $child->getRoute()->getPageClass() === DocumentationPage::class;
+        });
     }
 }

From 145fa3f086cf57bedb777954157ffb9180eaed4e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 13:58:44 +0100
Subject: [PATCH 0862/4023] Return false to ensure support for external URLs

---
 .../src/Framework/Features/Navigation/NavGroupItem.php |  7 +++++--
 packages/framework/tests/Unit/NavGroupItemTest.php     | 10 ++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index b39e13d4e28..791d1069829 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Pages\DocumentationPage;
+use Hyde\Support\Models\ExternalRoute;
 
 use function min;
 use function collect;
@@ -82,8 +83,6 @@ public function addChildren(array $items): static
      * Get the priority to determine the order of the navigation item.
      *
      * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
-     *
-     * @todo Ensure support for external URLs
      */
     public function getPriority(): int
     {
@@ -97,6 +96,10 @@ public function getPriority(): int
     protected function containsOnlyDocumentationPages(): bool
     {
         return collect($this->getChildren())->every(function (NavItem $child): bool {
+            if ($child->getRoute() instanceof ExternalRoute) {
+                return false;
+            }
+
             return $child->getRoute()->getPageClass() === DocumentationPage::class;
         });
     }
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 8862f614600..57aff482b10 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -189,6 +189,16 @@ public function testGetPriorityHandlesMixedChildTypes()
         $this->assertSame(500, $parent->getPriority());
     }
 
+    public function testGetPriorityHandlesExternalUrlChild()
+    {
+        $parent = new NavGroupItem('Parent');
+
+        $child = new NavItem('foo', 'Child', 400);
+        $parent->addChild($child);
+
+        $this->assertSame(500, $parent->getPriority());
+    }
+
     private function createNavItems(): array
     {
         return array_map(function (string $page): NavItem {

From ecd86765787c25f2db2fc941701278d015511cfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:00:50 +0100
Subject: [PATCH 0863/4023] Use instanceof check

Mainly for style
---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 791d1069829..b755d5d525e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -100,7 +100,7 @@ protected function containsOnlyDocumentationPages(): bool
                 return false;
             }
 
-            return $child->getRoute()->getPageClass() === DocumentationPage::class;
+            return $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
 }

From 8a3d9baae1e20ac599ce710a03a72d49811f21e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:02:27 +0100
Subject: [PATCH 0864/4023] Simplify conditional returns

---
 .../src/Framework/Features/Navigation/NavGroupItem.php      | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index b755d5d525e..e2374f6e5ef 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -96,11 +96,7 @@ public function getPriority(): int
     protected function containsOnlyDocumentationPages(): bool
     {
         return collect($this->getChildren())->every(function (NavItem $child): bool {
-            if ($child->getRoute() instanceof ExternalRoute) {
-                return false;
-            }
-
-            return $child->getRoute()->getPage() instanceof DocumentationPage;
+            return ! $child->getRoute() instanceof ExternalRoute && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
 }

From 18f30081b47082788330ea96ad41f83fd6bbcf19 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:03:26 +0100
Subject: [PATCH 0865/4023] Add clarifying parentheses

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index e2374f6e5ef..a40f763f419 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -96,7 +96,7 @@ public function getPriority(): int
     protected function containsOnlyDocumentationPages(): bool
     {
         return collect($this->getChildren())->every(function (NavItem $child): bool {
-            return ! $child->getRoute() instanceof ExternalRoute && $child->getRoute()->getPage() instanceof DocumentationPage;
+            return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
 }

From de7710fd00f1c84b55f26240ec1ce0c26b6d5411 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:05:34 +0100
Subject: [PATCH 0866/4023] Preevaluate constant loop

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 57aff482b10..d5a3e055b52 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -201,8 +201,9 @@ public function testGetPriorityHandlesExternalUrlChild()
 
     private function createNavItems(): array
     {
-        return array_map(function (string $page): NavItem {
-            return new NavItem(new Route(new InMemoryPage($page)), ucfirst($page));
-        }, ['foo', 'bar']);
+        return [
+            new NavItem(new Route(new InMemoryPage('foo')), ucfirst('foo')),
+            new NavItem(new Route(new InMemoryPage('bar')), ucfirst('bar')),
+        ];
     }
 }

From aeb7f0553b09d167ecb8e770ef8084afe8c06b22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:05:50 +0100
Subject: [PATCH 0867/4023] Inline variable

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index d5a3e055b52..4e56ec5cd0a 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -180,8 +180,7 @@ public function testGetPriorityHandlesMixedChildTypes()
     {
         $parent = new NavGroupItem('Parent');
 
-        $types = HydeCoreExtension::getPageClasses();
-        foreach ($types as $type) {
+        foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavItem(new Route(new $type()), 'Child', 100);
             $parent->addChild($child);
         }

From db5d53478192ffdde48d8a38b5bee03ffeeb0be2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:07:26 +0100
Subject: [PATCH 0868/4023] Use "last" priority as default value to match
 generator

It's more common to have groups last, so we use that for the default value
---
 .../src/Framework/Features/Navigation/NavGroupItem.php |  3 +--
 packages/framework/tests/Unit/NavGroupItemTest.php     | 10 +++++-----
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index a40f763f419..83472819f87 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -23,8 +23,7 @@ class NavGroupItem extends NavItem
     protected array $children = [];
 
     // Todo: Consider putting children before priority as it is more commonly used
-    // Todo use last priority as default for groups
-    public function __construct(string $label, int $priority = NavigationMenu::DEFAULT, array $children = [])
+    public function __construct(string $label, int $priority = NavigationMenu::LAST, array $children = [])
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
         $this->addChildren($children);
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 4e56ec5cd0a..1266152633e 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -151,13 +151,13 @@ public function testAddChildMethodReturnsSelf()
     public function testGetPriorityUsesDefaultPriority()
     {
         $parent = new NavGroupItem('Parent');
-        $this->assertSame(500, $parent->getPriority());
+        $this->assertSame(999, $parent->getPriority());
     }
 
     public function testGetPriorityWithNoChildrenUsesGroupPriority()
     {
         $parent = new NavGroupItem('Parent');
-        $this->assertSame(500, $parent->getPriority());
+        $this->assertSame(999, $parent->getPriority());
     }
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
@@ -165,7 +165,7 @@ public function testGetPriorityWithChildrenUsesGroupPriority()
         $parent = new NavGroupItem('Parent');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 400, 'foo');
         $parent->addChild($child);
-        $this->assertSame(500, $parent->getPriority());
+        $this->assertSame(999, $parent->getPriority());
     }
 
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
@@ -185,7 +185,7 @@ public function testGetPriorityHandlesMixedChildTypes()
             $parent->addChild($child);
         }
 
-        $this->assertSame(500, $parent->getPriority());
+        $this->assertSame(999, $parent->getPriority());
     }
 
     public function testGetPriorityHandlesExternalUrlChild()
@@ -195,7 +195,7 @@ public function testGetPriorityHandlesExternalUrlChild()
         $child = new NavItem('foo', 'Child', 400);
         $parent->addChild($child);
 
-        $this->assertSame(500, $parent->getPriority());
+        $this->assertSame(999, $parent->getPriority());
     }
 
     private function createNavItems(): array

From fb2309f65ec4a05a0887a250f7c5dc57eaf9e2db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:11:47 +0100
Subject: [PATCH 0869/4023] Put children before priority as it is more commonly
 used

---
 .../src/Framework/Features/Navigation/NavGroupItem.php    | 3 +--
 .../src/Framework/Features/Navigation/NavItem.php         | 2 +-
 packages/framework/tests/Unit/NavGroupItemTest.php        | 8 ++++----
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 83472819f87..c73a67d8900 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -22,8 +22,7 @@ class NavGroupItem extends NavItem
      */
     protected array $children = [];
 
-    // Todo: Consider putting children before priority as it is more commonly used
-    public function __construct(string $label, int $priority = NavigationMenu::LAST, array $children = [])
+    public function __construct(string $label, array $children = [], int $priority = NavigationMenu::LAST)
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
         $this->addChildren($children);
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index ed12bd60ab6..8f8aec95e0c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -99,7 +99,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      */
     public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
     {
-        return new NavGroupItem($label, $priority, $items);
+        return new NavGroupItem($label, $items, $priority);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 1266152633e..5aa7161b4ac 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -36,7 +36,7 @@ protected function setUp(): void
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', 500, $children);
+        $item = new NavGroupItem('Test', $children, 500);
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
@@ -49,7 +49,7 @@ public function testCanConstructWithChildren()
     public function testCanConstructWithChildrenWithoutRoute()
     {
         $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', 500, $children);
+        $item = new NavGroupItem('Test', $children, 500);
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
@@ -62,7 +62,7 @@ public function testGetChildren()
     {
         $children = $this->createNavItems();
 
-        $navItem = new NavGroupItem('Parent', 500, $children);
+        $navItem = new NavGroupItem('Parent', $children, 500);
         $this->assertSame($children, $navItem->getChildren());
     }
 
@@ -80,7 +80,7 @@ public function testHasChildren()
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Parent', 500, $this->createNavItems());
+        $item = new NavGroupItem('Parent', $this->createNavItems(), 500);
         $this->assertTrue($item->hasChildren());
     }
 

From 2d03ee3d03f03323d5eb171be6d42a4379b776d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:19:06 +0100
Subject: [PATCH 0870/4023] Add todo

---
 .../framework/src/Framework/Features/Navigation/NavGroupItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index c73a67d8900..1f009847e12 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -12,6 +12,7 @@
 
 /**
  * @todo Consider extracting trait for shared code with navigation menu class
+ * @todo Consider inheritance issues with static constructors from NavItem class
  */
 class NavGroupItem extends NavItem
 {

From efda56f625fa173a1ef1e10bf19de4b5c0d2ec7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:22:12 +0100
Subject: [PATCH 0871/4023] Replace default value with named argument

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 5aa7161b4ac..21976d56dc1 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -87,8 +87,8 @@ public function testHasChildrenWithChildren()
     public function testCanAddMultipleItemsToDropdown()
     {
         $parent = new NavGroupItem('Parent');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
         $this->assertSame([], $parent->getChildren());
 
@@ -100,8 +100,8 @@ public function testCanAddMultipleItemsToDropdown()
     public function testAddChildrenMethodReturnsSelf()
     {
         $parent = new NavGroupItem('Parent');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', 500, 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', 500, 'foo');
+        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
+        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
         $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
     }
@@ -109,7 +109,7 @@ public function testAddChildrenMethodReturnsSelf()
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
         $parent = new NavGroupItem('Parent');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'bar');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
         $parent->addChild($child);
 
@@ -131,7 +131,7 @@ public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
     public function testCanAddItemToDropdown()
     {
         $parent = new NavGroupItem('Parent');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
 
         $this->assertSame([], $parent->getChildren());
 
@@ -143,7 +143,7 @@ public function testCanAddItemToDropdown()
     public function testAddChildMethodReturnsSelf()
     {
         $parent = new NavGroupItem('Parent');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
 
         $this->assertSame($parent, $parent->addChild($child));
     }

From 2d98fb08a7ba758e79e48933cea030647034c2ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:22:22 +0100
Subject: [PATCH 0872/4023] Remove test data not affecting test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 21976d56dc1..ed7cd253c60 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -120,7 +120,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
     {
         $parent = new NavGroupItem('Parent');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 500);
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child');
 
         $parent->addChild($child);
 

From fc74bba18822e41daa72bc15743f4fcc0fcf0890 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:23:30 +0100
Subject: [PATCH 0873/4023] Inline local variables

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ed7cd253c60..7f7e0de864b 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -68,14 +68,12 @@ public function testGetChildren()
 
     public function testGetChildrenWithNoChildren()
     {
-        $navItem = new NavGroupItem('Parent');
-        $this->assertEmpty($navItem->getChildren());
+        $this->assertEmpty((new NavGroupItem('Parent'))->getChildren());
     }
 
     public function testHasChildren()
     {
-        $item = new NavGroupItem('Parent');
-        $this->assertFalse($item->hasChildren());
+        $this->assertFalse((new NavGroupItem('Parent'))->hasChildren());
     }
 
     public function testHasChildrenWithChildren()
@@ -150,14 +148,12 @@ public function testAddChildMethodReturnsSelf()
 
     public function testGetPriorityUsesDefaultPriority()
     {
-        $parent = new NavGroupItem('Parent');
-        $this->assertSame(999, $parent->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Parent'))->getPriority());
     }
 
     public function testGetPriorityWithNoChildrenUsesGroupPriority()
     {
-        $parent = new NavGroupItem('Parent');
-        $this->assertSame(999, $parent->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Parent'))->getPriority());
     }
 
     public function testGetPriorityWithChildrenUsesGroupPriority()

From 7cc42d915df91a4443e4390e511cfc0687b926e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:23:58 +0100
Subject: [PATCH 0874/4023] Remove unnecessary setup method

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 7f7e0de864b..619dca2c304 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -8,9 +8,7 @@
 use Hyde\Pages\InMemoryPage;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
-use Hyde\Support\Facades\Render;
 use Hyde\Pages\DocumentationPage;
-use Hyde\Support\Models\RenderData;
 use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
@@ -28,11 +26,6 @@ public static function setUpBeforeClass(): void
         self::mockConfig();
     }
 
-    protected function setUp(): void
-    {
-        Render::swap(new RenderData());
-    }
-
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavItems();

From d14f273487815231a074419913ad999a052bc300 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:24:14 +0100
Subject: [PATCH 0875/4023] Remove unnecessary state modifier

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 619dca2c304..aa3f1356478 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -20,8 +20,6 @@ class NavGroupItemTest extends UnitTestCase
 {
     public static function setUpBeforeClass(): void
     {
-        self::$hasSetUpKernel = false;
-
         self::needsKernel();
         self::mockConfig();
     }

From 7ff0a934452b990a511087593b16f992e19cc21c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:28:28 +0100
Subject: [PATCH 0876/4023] Split out general assertions

---
 .../framework/tests/Unit/NavGroupItemTest.php  | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index aa3f1356478..7d3ad04ad11 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -24,14 +24,24 @@ public static function setUpBeforeClass(): void
         self::mockConfig();
     }
 
-    public function testCanConstructWithChildren()
+    public function testCanConstruct()
     {
-        $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', $children, 500);
+        $item = new NavGroupItem('Test');
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
-        $this->assertSame(500, $item->getPriority());
+        $this->assertSame(999, $item->getPriority());
+    }
+
+    public function testCanConstructWithPriority()
+    {
+        $this->assertSame(500, (new NavGroupItem('Test', priority: 500))->getPriority());
+    }
+
+    public function testCanConstructWithChildren()
+    {
+        $children = $this->createNavItems();
+        $item = new NavGroupItem('Test', $children);
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());

From 0d791bf6a4d3c6a7a139848ee75a8d1e1e82437f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:28:58 +0100
Subject: [PATCH 0877/4023] Remove test data not affecting test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 7d3ad04ad11..ec8d878c965 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -50,7 +50,7 @@ public function testCanConstructWithChildren()
     public function testCanConstructWithChildrenWithoutRoute()
     {
         $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', $children, 500);
+        $item = new NavGroupItem('Test', $children);
 
         $this->assertSame('Test', $item->getLabel());
         $this->assertNull($item->getRoute());
@@ -63,7 +63,7 @@ public function testGetChildren()
     {
         $children = $this->createNavItems();
 
-        $navItem = new NavGroupItem('Parent', $children, 500);
+        $navItem = new NavGroupItem('Parent', $children);
         $this->assertSame($children, $navItem->getChildren());
     }
 
@@ -79,7 +79,7 @@ public function testHasChildren()
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Parent', $this->createNavItems(), 500);
+        $item = new NavGroupItem('Parent', $this->createNavItems());
         $this->assertTrue($item->hasChildren());
     }
 

From 84922f6af080e6ca3874baef302d6c8a14ded2c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:44:44 +0100
Subject: [PATCH 0878/4023] Extract and scope down assertions for more granular
 tests

---
 .../framework/tests/Unit/NavGroupItemTest.php | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ec8d878c965..eecbf3fee0e 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -26,11 +26,7 @@ public static function setUpBeforeClass(): void
 
     public function testCanConstruct()
     {
-        $item = new NavGroupItem('Test');
-
-        $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getRoute());
-        $this->assertSame(999, $item->getPriority());
+        $this->assertSame('Test', (new NavGroupItem('Test'))->getLabel());
     }
 
     public function testCanConstructWithPriority()
@@ -38,6 +34,16 @@ public function testCanConstructWithPriority()
         $this->assertSame(500, (new NavGroupItem('Test', priority: 500))->getPriority());
     }
 
+    public function testDefaultPriorityValueIsLast()
+    {
+        $this->assertSame(999, (new NavGroupItem('Test'))->getPriority());
+    }
+
+    public function testDestinationIsAlwaysNull()
+    {
+        $this->assertNull((new NavGroupItem('Test'))->getRoute());
+    }
+
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavItems();
@@ -52,9 +58,6 @@ public function testCanConstructWithChildrenWithoutRoute()
         $children = $this->createNavItems();
         $item = new NavGroupItem('Test', $children);
 
-        $this->assertSame('Test', $item->getLabel());
-        $this->assertNull($item->getRoute());
-
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());
     }

From f6f32e426a9d4eb67a09d40b11acb0397df8eb65 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:44:55 +0100
Subject: [PATCH 0879/4023] Inline variable

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index eecbf3fee0e..3aa944e0fd4 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -82,8 +82,7 @@ public function testHasChildren()
 
     public function testHasChildrenWithChildren()
     {
-        $item = new NavGroupItem('Parent', $this->createNavItems());
-        $this->assertTrue($item->hasChildren());
+        $this->assertTrue((new NavGroupItem('Parent', $this->createNavItems()))->hasChildren());
     }
 
     public function testCanAddMultipleItemsToDropdown()

From 7fa70c2614b10f2ae52525b20f3ae535d5b229f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:46:10 +0100
Subject: [PATCH 0880/4023] Normalize test data strings

---
 .../framework/tests/Unit/NavGroupItemTest.php | 54 +++++++++----------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 3aa944e0fd4..1f7ce0b1122 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -26,28 +26,28 @@ public static function setUpBeforeClass(): void
 
     public function testCanConstruct()
     {
-        $this->assertSame('Test', (new NavGroupItem('Test'))->getLabel());
+        $this->assertSame('Foo', (new NavGroupItem('Foo'))->getLabel());
     }
 
     public function testCanConstructWithPriority()
     {
-        $this->assertSame(500, (new NavGroupItem('Test', priority: 500))->getPriority());
+        $this->assertSame(500, (new NavGroupItem('Foo', priority: 500))->getPriority());
     }
 
     public function testDefaultPriorityValueIsLast()
     {
-        $this->assertSame(999, (new NavGroupItem('Test'))->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
     }
 
     public function testDestinationIsAlwaysNull()
     {
-        $this->assertNull((new NavGroupItem('Test'))->getRoute());
+        $this->assertNull((new NavGroupItem('Foo'))->getRoute());
     }
 
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', $children);
+        $item = new NavGroupItem('Foo', $children);
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());
@@ -56,7 +56,7 @@ public function testCanConstructWithChildren()
     public function testCanConstructWithChildrenWithoutRoute()
     {
         $children = $this->createNavItems();
-        $item = new NavGroupItem('Test', $children);
+        $item = new NavGroupItem('Foo', $children);
 
         $this->assertCount(2, $item->getChildren());
         $this->assertSame($children, $item->getChildren());
@@ -66,28 +66,28 @@ public function testGetChildren()
     {
         $children = $this->createNavItems();
 
-        $navItem = new NavGroupItem('Parent', $children);
+        $navItem = new NavGroupItem('Foo', $children);
         $this->assertSame($children, $navItem->getChildren());
     }
 
     public function testGetChildrenWithNoChildren()
     {
-        $this->assertEmpty((new NavGroupItem('Parent'))->getChildren());
+        $this->assertEmpty((new NavGroupItem('Foo'))->getChildren());
     }
 
     public function testHasChildren()
     {
-        $this->assertFalse((new NavGroupItem('Parent'))->hasChildren());
+        $this->assertFalse((new NavGroupItem('Foo'))->hasChildren());
     }
 
     public function testHasChildrenWithChildren()
     {
-        $this->assertTrue((new NavGroupItem('Parent', $this->createNavItems()))->hasChildren());
+        $this->assertTrue((new NavGroupItem('Foo', $this->createNavItems()))->hasChildren());
     }
 
     public function testCanAddMultipleItemsToDropdown()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
@@ -100,7 +100,7 @@ public function testCanAddMultipleItemsToDropdown()
 
     public function testAddChildrenMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
@@ -109,29 +109,29 @@ public function testAddChildrenMethodReturnsSelf()
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
         $parent->addChild($child);
 
-        $this->assertSame('parent', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $parent->getGroupIdentifier());
         $this->assertSame('bar', $child->getGroupIdentifier());
     }
 
-    public function testAddingAnItemWithNoGroupKeyUsesParentIdentifier()
+    public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     {
-        $parent = new NavGroupItem('Parent');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child');
+        $parent = new NavGroupItem('Foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
         $parent->addChild($child);
 
-        $this->assertSame('parent', $parent->getGroupIdentifier());
-        $this->assertSame('parent', $child->getGroupIdentifier());
+        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $child->getGroupIdentifier());
     }
 
     public function testCanAddItemToDropdown()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
 
         $this->assertSame([], $parent->getChildren());
@@ -143,7 +143,7 @@ public function testCanAddItemToDropdown()
 
     public function testAddChildMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
 
         $this->assertSame($parent, $parent->addChild($child));
@@ -151,17 +151,17 @@ public function testAddChildMethodReturnsSelf()
 
     public function testGetPriorityUsesDefaultPriority()
     {
-        $this->assertSame(999, (new NavGroupItem('Parent'))->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
     }
 
     public function testGetPriorityWithNoChildrenUsesGroupPriority()
     {
-        $this->assertSame(999, (new NavGroupItem('Parent'))->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
     }
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', 400, 'foo');
         $parent->addChild($child);
         $this->assertSame(999, $parent->getPriority());
@@ -169,7 +169,7 @@ public function testGetPriorityWithChildrenUsesGroupPriority()
 
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 400);
         $parent->addChild($child);
         $this->assertSame(400, $parent->getPriority());
@@ -177,7 +177,7 @@ public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
 
     public function testGetPriorityHandlesMixedChildTypes()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavItem(new Route(new $type()), 'Child', 100);
@@ -189,7 +189,7 @@ public function testGetPriorityHandlesMixedChildTypes()
 
     public function testGetPriorityHandlesExternalUrlChild()
     {
-        $parent = new NavGroupItem('Parent');
+        $parent = new NavGroupItem('Foo');
 
         $child = new NavItem('foo', 'Child', 400);
         $parent->addChild($child);

From 1d34e75031058d40e20efdbe7cd8d1b743bf5b4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:50:08 +0100
Subject: [PATCH 0881/4023] Remove unnecessary test data

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 1f7ce0b1122..5b045c224e8 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -132,7 +132,7 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     public function testCanAddItemToDropdown()
     {
         $parent = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame([], $parent->getChildren());
 
@@ -144,7 +144,7 @@ public function testCanAddItemToDropdown()
     public function testAddChildMethodReturnsSelf()
     {
         $parent = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame($parent, $parent->addChild($child));
     }
@@ -162,7 +162,7 @@ public function testGetPriorityWithNoChildrenUsesGroupPriority()
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
         $parent = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', 400, 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
         $parent->addChild($child);
         $this->assertSame(999, $parent->getPriority());
     }

From a356a179db122428d473a7e4b0ba116e723c5f1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:50:37 +0100
Subject: [PATCH 0882/4023] Clarify test method naming

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 5b045c224e8..b4cf5940bd0 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -175,7 +175,7 @@ public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
         $this->assertSame(400, $parent->getPriority());
     }
 
-    public function testGetPriorityHandlesMixedChildTypes()
+    public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
     {
         $parent = new NavGroupItem('Foo');
 

From b22a68567bc22d3d7e21651997ffc8fe040a7d9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:50:51 +0100
Subject: [PATCH 0883/4023] Clarify test method naming

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index b4cf5940bd0..29e2e4085e2 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -187,7 +187,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
         $this->assertSame(999, $parent->getPriority());
     }
 
-    public function testGetPriorityHandlesExternalUrlChild()
+    public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
         $parent = new NavGroupItem('Foo');
 

From 9f4ef9c0a216a973a3ac2e3f60b13eb621a8b7cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:51:06 +0100
Subject: [PATCH 0884/4023] Normalize test value

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 29e2e4085e2..86a87d13850 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -170,9 +170,9 @@ public function testGetPriorityWithChildrenUsesGroupPriority()
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
         $parent = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 400);
+        $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 100);
         $parent->addChild($child);
-        $this->assertSame(400, $parent->getPriority());
+        $this->assertSame(100, $parent->getPriority());
     }
 
     public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
@@ -191,7 +191,7 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
         $parent = new NavGroupItem('Foo');
 
-        $child = new NavItem('foo', 'Child', 400);
+        $child = new NavItem('foo', 'Child', 100);
         $parent->addChild($child);
 
         $this->assertSame(999, $parent->getPriority());

From b74040f550c5592736dfa274dc7c4c380ee90fc6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:51:51 +0100
Subject: [PATCH 0885/4023] Simplify test assembly

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 86a87d13850..17a87a41da9 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -189,10 +189,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $parent = new NavGroupItem('Foo');
-
-        $child = new NavItem('foo', 'Child', 100);
-        $parent->addChild($child);
+        $parent = new NavGroupItem('Foo', [new NavItem('foo', 'Child', 100)]);
 
         $this->assertSame(999, $parent->getPriority());
     }

From 846ac42e41b83bede6ad1a820c76176add822c91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:52:13 +0100
Subject: [PATCH 0886/4023] Normalize test data

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 17a87a41da9..6cd2cedc0ab 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -180,7 +180,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
         $parent = new NavGroupItem('Foo');
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
-            $child = new NavItem(new Route(new $type()), 'Child', 100);
+            $child = new NavItem(new Route(new $type()), 'Bar', 100);
             $parent->addChild($child);
         }
 
@@ -189,7 +189,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $parent = new NavGroupItem('Foo', [new NavItem('foo', 'Child', 100)]);
+        $parent = new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]);
 
         $this->assertSame(999, $parent->getPriority());
     }

From 87e3ad62efb45b221853731a77e1be912fbf81bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:52:30 +0100
Subject: [PATCH 0887/4023] Normalize local test variable naming

---
 .../framework/tests/Unit/NavGroupItemTest.php | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 6cd2cedc0ab..6e8730df8e5 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -87,66 +87,66 @@ public function testHasChildrenWithChildren()
 
     public function testCanAddMultipleItemsToDropdown()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $this->assertSame([], $parent->getChildren());
+        $this->assertSame([], $group->getChildren());
 
-        $parent->addChildren([$child1, $child2]);
+        $group->addChildren([$child1, $child2]);
 
-        $this->assertSame([$child1, $child2], $parent->getChildren());
+        $this->assertSame([$child1, $child2], $group->getChildren());
     }
 
     public function testAddChildrenMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $this->assertSame($parent, $parent->addChildren([$child1, $child2]));
+        $this->assertSame($group, $group->addChildren([$child1, $child2]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
-        $parent->addChild($child);
+        $group->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $group->getGroupIdentifier());
         $this->assertSame('bar', $child->getGroupIdentifier());
     }
 
     public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $parent->addChild($child);
+        $group->addChild($child);
 
-        $this->assertSame('foo', $parent->getGroupIdentifier());
+        $this->assertSame('foo', $group->getGroupIdentifier());
         $this->assertSame('foo', $child->getGroupIdentifier());
     }
 
     public function testCanAddItemToDropdown()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame([], $parent->getChildren());
+        $this->assertSame([], $group->getChildren());
 
-        $parent->addChild($child);
+        $group->addChild($child);
 
-        $this->assertSame([$child], $parent->getChildren());
+        $this->assertSame([$child], $group->getChildren());
     }
 
     public function testAddChildMethodReturnsSelf()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame($parent, $parent->addChild($child));
+        $this->assertSame($group, $group->addChild($child));
     }
 
     public function testGetPriorityUsesDefaultPriority()
@@ -161,37 +161,37 @@ public function testGetPriorityWithNoChildrenUsesGroupPriority()
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
-        $parent->addChild($child);
-        $this->assertSame(999, $parent->getPriority());
+        $group->addChild($child);
+        $this->assertSame(999, $group->getPriority());
     }
 
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 100);
-        $parent->addChild($child);
-        $this->assertSame(100, $parent->getPriority());
+        $group->addChild($child);
+        $this->assertSame(100, $group->getPriority());
     }
 
     public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
     {
-        $parent = new NavGroupItem('Foo');
+        $group = new NavGroupItem('Foo');
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavItem(new Route(new $type()), 'Bar', 100);
-            $parent->addChild($child);
+            $group->addChild($child);
         }
 
-        $this->assertSame(999, $parent->getPriority());
+        $this->assertSame(999, $group->getPriority());
     }
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $parent = new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]);
+        $group = new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]);
 
-        $this->assertSame(999, $parent->getPriority());
+        $this->assertSame(999, $group->getPriority());
     }
 
     private function createNavItems(): array

From 8b07dacead872f25f0f074612dd9ebbb26f4850c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:53:09 +0100
Subject: [PATCH 0888/4023] Split out test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 6e8730df8e5..b8dcda595fb 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -187,13 +187,20 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
         $this->assertSame(999, $group->getPriority());
     }
 
-    public function testGetPriorityHandlesExternalUrlChildGracefully()
+    public function testGetPriorityHandlesStringUrlChildGracefully()
     {
         $group = new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]);
 
         $this->assertSame(999, $group->getPriority());
     }
 
+    public function testGetPriorityHandlesExternalUrlChildGracefully()
+    {
+        $group = new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]);
+
+        $this->assertSame(999, $group->getPriority());
+    }
+
     private function createNavItems(): array
     {
         return [

From 2b746d0f1fb967dc08e7884e14c858d9bb3b951e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:53:30 +0100
Subject: [PATCH 0889/4023] Inline variables

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index b8dcda595fb..18bb62548aa 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -189,16 +189,12 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
     public function testGetPriorityHandlesStringUrlChildGracefully()
     {
-        $group = new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]);
-
-        $this->assertSame(999, $group->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]))->getPriority());
     }
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $group = new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]);
-
-        $this->assertSame(999, $group->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
     private function createNavItems(): array

From 64c02e313b6c339719b9347e7d4cdbaee7aa11cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:53:47 +0100
Subject: [PATCH 0890/4023] Evaluate function call

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 18bb62548aa..4128067c315 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -200,8 +200,8 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
     private function createNavItems(): array
     {
         return [
-            new NavItem(new Route(new InMemoryPage('foo')), ucfirst('foo')),
-            new NavItem(new Route(new InMemoryPage('bar')), ucfirst('bar')),
+            new NavItem(new Route(new InMemoryPage('foo')), 'Foo'),
+            new NavItem(new Route(new InMemoryPage('bar')), 'Bar'),
         ];
     }
 }

From 725d7c95dc468908b5d7a2643a8af3fa220d7547 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:56:48 +0100
Subject: [PATCH 0891/4023] Formatting

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 4128067c315..de08b8d6242 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -65,8 +65,8 @@ public function testCanConstructWithChildrenWithoutRoute()
     public function testGetChildren()
     {
         $children = $this->createNavItems();
-
         $navItem = new NavGroupItem('Foo', $children);
+
         $this->assertSame($children, $navItem->getChildren());
     }
 

From d956811b08ceeddbb51f488b73df1acc3463c89e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:57:58 +0100
Subject: [PATCH 0892/4023] Normalize variable name

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index de08b8d6242..d890504f1ab 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -65,9 +65,9 @@ public function testCanConstructWithChildrenWithoutRoute()
     public function testGetChildren()
     {
         $children = $this->createNavItems();
-        $navItem = new NavGroupItem('Foo', $children);
+        $item = new NavGroupItem('Foo', $children);
 
-        $this->assertSame($children, $navItem->getChildren());
+        $this->assertSame($children, $item->getChildren());
     }
 
     public function testGetChildrenWithNoChildren()

From a6d66488d8f8ed33cc4f5bcccb54a3d03769ae69 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:58:35 +0100
Subject: [PATCH 0893/4023] Remove unnecessary operations from test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index d890504f1ab..31c3c64d8aa 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -101,10 +101,8 @@ public function testCanAddMultipleItemsToDropdown()
     public function testAddChildrenMethodReturnsSelf()
     {
         $group = new NavGroupItem('Foo');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $this->assertSame($group, $group->addChildren([$child1, $child2]));
+        $this->assertSame($group, $group->addChildren([]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()

From fe5e598a9736e57d8866be9e56e210b5141ce1ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:59:14 +0100
Subject: [PATCH 0894/4023] Remove unnecessary assertion

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 31c3c64d8aa..c54cef5fe03 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -91,8 +91,6 @@ public function testCanAddMultipleItemsToDropdown()
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $this->assertSame([], $group->getChildren());
-
         $group->addChildren([$child1, $child2]);
 
         $this->assertSame([$child1, $child2], $group->getChildren());

From ff5d8df12b6cff8baf09091a5c61bc35cdc58c3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 14:59:55 +0100
Subject: [PATCH 0895/4023] Simplify test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index c54cef5fe03..a84a8ec0286 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -91,9 +91,7 @@ public function testCanAddMultipleItemsToDropdown()
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $group->addChildren([$child1, $child2]);
-
-        $this->assertSame([$child1, $child2], $group->getChildren());
+        $this->assertSame([$child1, $child2], $group->addChildren([$child1, $child2])->getChildren());
     }
 
     public function testAddChildrenMethodReturnsSelf()

From df730b609ae123b1f5c4d53314beebcab60abcfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:00:50 +0100
Subject: [PATCH 0896/4023] Add missing unit test

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index a84a8ec0286..c7be4220dae 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -85,6 +85,14 @@ public function testHasChildrenWithChildren()
         $this->assertTrue((new NavGroupItem('Foo', $this->createNavItems()))->hasChildren());
     }
 
+    public function testCanAddItemsToDropdown()
+    {
+        $group = new NavGroupItem('Foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
+
+        $this->assertSame([$child], $group->addChild($child)->getChildren());
+    }
+
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');

From 6aee109111f3af3997d8c4b78b1693757c0d58ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:01:14 +0100
Subject: [PATCH 0897/4023] Introduce local variable

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index c7be4220dae..23fb904c6f1 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -99,7 +99,9 @@ public function testCanAddMultipleItemsToDropdown()
         $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
         $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
 
-        $this->assertSame([$child1, $child2], $group->addChildren([$child1, $child2])->getChildren());
+        $items = [$child1, $child2];
+        
+        $this->assertSame($items, $group->addChildren($items)->getChildren());
     }
 
     public function testAddChildrenMethodReturnsSelf()

From b6bc915999d2d54f5fe6a4cf9d9d601e4019a88b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:01:33 +0100
Subject: [PATCH 0898/4023] Inline local variables

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 23fb904c6f1..d5956d56b35 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -96,11 +96,12 @@ public function testCanAddItemsToDropdown()
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        $child1 = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
-        $child2 = new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo');
-
-        $items = [$child1, $child2];
         
+        $items = [
+            new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo'),
+            new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo')
+        ];
+
         $this->assertSame($items, $group->addChildren($items)->getChildren());
     }
 

From 3a7eaf14a2912d31058cf2d382f0ef5f0a15c435 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:02:42 +0100
Subject: [PATCH 0899/4023] Use the helper method

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index d5956d56b35..88f0d3b56f5 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -96,11 +96,7 @@ public function testCanAddItemsToDropdown()
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        
-        $items = [
-            new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo'),
-            new NavItem(new Route(new MarkdownPage()), 'Child 2', group: 'foo')
-        ];
+        $items = $this->createNavItems();
 
         $this->assertSame($items, $group->addChildren($items)->getChildren());
     }

From f28d636a6eac176453322772bdf74413dae234ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:03:53 +0100
Subject: [PATCH 0900/4023] Merge overlapping tests

---
 .../framework/tests/Unit/NavGroupItemTest.php    | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 88f0d3b56f5..ef6c4ae7249 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -85,14 +85,6 @@ public function testHasChildrenWithChildren()
         $this->assertTrue((new NavGroupItem('Foo', $this->createNavItems()))->hasChildren());
     }
 
-    public function testCanAddItemsToDropdown()
-    {
-        $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
-
-        $this->assertSame([$child], $group->addChild($child)->getChildren());
-    }
-
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');
@@ -133,13 +125,9 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     public function testCanAddItemToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
-
-        $this->assertSame([], $group->getChildren());
-
-        $group->addChild($child);
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
 
-        $this->assertSame([$child], $group->getChildren());
+        $this->assertSame([$child], $group->addChild($child)->getChildren());
     }
 
     public function testAddChildMethodReturnsSelf()

From d9a9e213cc74db61b09fbaadb16767ae41e0fde3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:04:14 +0100
Subject: [PATCH 0901/4023] Reorder tests

---
 .../framework/tests/Unit/NavGroupItemTest.php | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ef6c4ae7249..16e78cd5910 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -85,6 +85,22 @@ public function testHasChildrenWithChildren()
         $this->assertTrue((new NavGroupItem('Foo', $this->createNavItems()))->hasChildren());
     }
 
+    public function testCanAddItemToDropdown()
+    {
+        $group = new NavGroupItem('Foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
+
+        $this->assertSame([$child], $group->addChild($child)->getChildren());
+    }
+
+    public function testAddChildMethodReturnsSelf()
+    {
+        $group = new NavGroupItem('Foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
+
+        $this->assertSame($group, $group->addChild($child));
+    }
+
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');
@@ -122,22 +138,6 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
         $this->assertSame('foo', $child->getGroupIdentifier());
     }
 
-    public function testCanAddItemToDropdown()
-    {
-        $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
-
-        $this->assertSame([$child], $group->addChild($child)->getChildren());
-    }
-
-    public function testAddChildMethodReturnsSelf()
-    {
-        $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
-
-        $this->assertSame($group, $group->addChild($child));
-    }
-
     public function testGetPriorityUsesDefaultPriority()
     {
         $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());

From d740acc0f00fcaf359a77ba11a5acf4aec65fd1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:04:43 +0100
Subject: [PATCH 0902/4023] Simplify test object

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 16e78cd5910..524428e48bd 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -88,7 +88,7 @@ public function testHasChildrenWithChildren()
     public function testCanAddItemToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child 1', group: 'foo');
+        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame([$child], $group->addChild($child)->getChildren());
     }

From 75f679f8a88ccb3bc6fe167ed624b0b66eba88a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:06:08 +0100
Subject: [PATCH 0903/4023] Clean up and improve tests

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 524428e48bd..334011af395 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -150,17 +150,19 @@ public function testGetPriorityWithNoChildrenUsesGroupPriority()
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
-        $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
-        $group->addChild($child);
+        $group = new NavGroupItem('Foo', [new NavItem(new Route(new MarkdownPage()), 'Bar', 100)]);
+
         $this->assertSame(999, $group->getPriority());
     }
 
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
-        $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new DocumentationPage()), 'Foo', 100);
-        $group->addChild($child);
+        $group = new NavGroupItem('Foo', [
+            new NavItem(new Route(new DocumentationPage()), 'Foo', 100),
+            new NavItem(new Route(new DocumentationPage()), 'Bar', 200),
+            new NavItem(new Route(new DocumentationPage()), 'Baz', 300),
+        ]);
+
         $this->assertSame(100, $group->getPriority());
     }
 

From 103794a042a954d6284d5b36be3b610255a3d777 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:06:47 +0100
Subject: [PATCH 0904/4023] Add reverse order to improve accuracy

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 334011af395..62fe54152b4 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -157,11 +157,19 @@ public function testGetPriorityWithChildrenUsesGroupPriority()
 
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
-        $group = new NavGroupItem('Foo', [
+        $items = [
             new NavItem(new Route(new DocumentationPage()), 'Foo', 100),
             new NavItem(new Route(new DocumentationPage()), 'Bar', 200),
             new NavItem(new Route(new DocumentationPage()), 'Baz', 300),
-        ]);
+        ];
+
+        $group = new NavGroupItem('Foo', $items);
+
+        $this->assertSame(100, $group->getPriority());
+
+        $items = array_reverse($items);
+
+        $group = new NavGroupItem('Foo', $items);
 
         $this->assertSame(100, $group->getPriority());
     }

From c10ec520937405835102a218c29c32c90a5d3418 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:07:06 +0100
Subject: [PATCH 0905/4023] Inline local variables

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 62fe54152b4..30a6ba3de1c 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -163,15 +163,8 @@ public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
             new NavItem(new Route(new DocumentationPage()), 'Baz', 300),
         ];
 
-        $group = new NavGroupItem('Foo', $items);
-
-        $this->assertSame(100, $group->getPriority());
-
-        $items = array_reverse($items);
-
-        $group = new NavGroupItem('Foo', $items);
-
-        $this->assertSame(100, $group->getPriority());
+        $this->assertSame(100, (new NavGroupItem('Foo', $items))->getPriority());
+        $this->assertSame(100, (new NavGroupItem('Foo', array_reverse($items)))->getPriority());
     }
 
     public function testGetPriorityUsesGroupPriorityForMixedChildTypes()

From 92ed65374c81776a06c8bf9d1ff9ab384b85ce6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:13:52 +0100
Subject: [PATCH 0906/4023] Change visibility

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 30a6ba3de1c..370a42e4a5d 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -189,7 +189,7 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
         $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
-    private function createNavItems(): array
+    protected function createNavItems(): array
     {
         return [
             new NavItem(new Route(new InMemoryPage('foo')), 'Foo'),

From 0479139b2e18aa05d4c3a77b70fefc9282e81f75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:15:14 +0100
Subject: [PATCH 0907/4023] No longer construct children in base class

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8f8aec95e0c..b0a0cdec774 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -59,7 +59,6 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
         $this->identifier = static::makeIdentifier($label);
-        $this->addChildren($children);
     }
 
     /**

From 2b61a147a37b88f5004fb2449665881dd9b4a9ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 15:20:45 +0100
Subject: [PATCH 0908/4023] Remove children parameter from base class

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b0a0cdec774..451a354f1d1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,7 +48,7 @@ class NavItem implements Stringable
      * @param  int  $priority  The priority to determine the order of the navigation item.
      * @param  string|null  $group  The dropdown/group identifier of the navigation item, if any.
      */
-    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null, #[Deprecated] array $children = [])
+    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);

From a5396d65a2fe00e42b39d2b82b6c6fbfd8a33674 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 16:27:45 +0100
Subject: [PATCH 0909/4023] Update static constructors to use self to prevent
 inheritance issues

It does not make sense to create NavGroupItem::forRoute and ::forLink, this serves as a compromise for now.
---
 .../Features/Navigation/NavGroupItem.php       |  1 -
 .../Framework/Features/Navigation/NavItem.php  |  8 ++++----
 .../framework/tests/Unit/NavGroupItemTest.php  | 18 ++++++++++++++++++
 3 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 1f009847e12..c73a67d8900 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -12,7 +12,6 @@
 
 /**
  * @todo Consider extracting trait for shared code with navigation menu class
- * @todo Consider inheritance issues with static constructors from NavItem class
  */
 class NavGroupItem extends NavItem
 {
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 451a354f1d1..0a4857480bc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -69,11 +69,11 @@ public function __construct(Route|string|null $destination, string $label, int $
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.
      */
-    public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
+    public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
         $route = $route instanceof Route ? $route : Routes::getOrFail($route);
 
-        return new static(
+        return new self(
             $route,
             $label ?? $route->getPage()->navigationMenuLabel(),
             $priority ?? $route->getPage()->navigationMenuPriority(),
@@ -84,9 +84,9 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
     /**
      * Create a new navigation menu item leading to an external URI.
      */
-    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): static
+    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): self
     {
-        return new static($href, $label, $priority);
+        return new self($href, $label, $priority);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 370a42e4a5d..8eae025f789 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -189,6 +189,24 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
         $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
+    public function testForRoute()
+    {
+        $item = NavGroupItem::forRoute(new Route(new InMemoryPage('foo')));
+
+        $this->assertInstanceOf(NavItem::class, $item);
+        $this->assertNotInstanceOf(NavGroupItem::class, $item);
+        $this->assertSame(NavItem::class, $item::class);
+    }
+
+    public function testForLink()
+    {
+        $item = NavGroupItem::forLink('foo', 'bar');
+
+        $this->assertInstanceOf(NavItem::class, $item);
+        $this->assertNotInstanceOf(NavGroupItem::class, $item);
+        $this->assertSame(NavItem::class, $item::class);
+    }
+
     protected function createNavItems(): array
     {
         return [

From 8f0232d40bba727f9a61a6b04b1962497d94501f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 16:30:32 +0100
Subject: [PATCH 0910/4023] Add spacing

---
 .../framework/src/Framework/Features/Navigation/NavGroupItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index c73a67d8900..92ffb49b7f9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -25,6 +25,7 @@ class NavGroupItem extends NavItem
     public function __construct(string $label, array $children = [], int $priority = NavigationMenu::LAST)
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
+
         $this->addChildren($children);
     }
 

From f7eaa13548cad16c0bba8e37b64f5de75d8304d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 16:30:42 +0100
Subject: [PATCH 0911/4023] Remove unused import

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0a4857480bc..0e9339467f9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use JetBrains\PhpStorm\Deprecated;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;

From 8ffb4539e2561d4a0052e5a7e4be9c6a0834f450 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 2 Mar 2024 16:32:59 +0100
Subject: [PATCH 0912/4023] Rename children property and accessors to items

---
 .../components/docs/sidebar-items.blade.php   |  2 +-
 .../Features/Navigation/NavGroupItem.php      | 16 +++++++--------
 .../Framework/Features/Navigation/NavItem.php | 10 +++++-----
 .../AutomaticNavigationConfigurationsTest.php |  2 +-
 .../Services/DocumentationSidebarTest.php     |  2 +-
 .../framework/tests/Unit/NavGroupItemTest.php | 20 +++++++++----------
 packages/framework/tests/Unit/NavItemTest.php |  4 ++--
 7 files changed, 27 insertions(+), 29 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 2485420d786..b160e95ff09 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -15,7 +15,7 @@
                     @endif
                 </header>
                 <ul class="sidebar-group-items ml-4 px-2 mb-2" role="list" @if($sidebar->isCollapsible()) x-show="groupOpen" @endif>
-                    @foreach ($group->getChildren() as $item)
+                    @foreach ($group->getItems() as $item)
                         @include('hyde::components.docs.sidebar-item', ['grouped' => true])
                     @endforeach
                 </ul>
diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 92ffb49b7f9..1e4e52de7e5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -16,11 +16,9 @@
 class NavGroupItem extends NavItem
 {
     /**
-     * @deprecated Rename to $items
-     *
      * @var array<\Hyde\Framework\Features\Navigation\NavItem>
      */
-    protected array $children = [];
+    protected array $items = [];
 
     public function __construct(string $label, array $children = [], int $priority = NavigationMenu::LAST)
     {
@@ -36,9 +34,9 @@ public function __construct(string $label, array $children = [], int $priority =
      *
      * @return array<\Hyde\Framework\Features\Navigation\NavItem>
      */
-    public function getChildren(): array
+    public function getItems(): array
     {
-        return $this->children;
+        return $this->items;
     }
 
     /**
@@ -46,7 +44,7 @@ public function getChildren(): array
      */
     public function hasChildren(): bool
     {
-        return count($this->children) > 0;
+        return count($this->items) > 0;
     }
 
     /**
@@ -58,7 +56,7 @@ public function addChild(NavItem $item): static
     {
         $item->group ??= $this->group;
 
-        $this->children[] = $item;
+        $this->items[] = $item;
         $this->route = null;
 
         return $this;
@@ -86,7 +84,7 @@ public function addChildren(array $items): static
     public function getPriority(): int
     {
         if ($this->hasChildren() && $this->containsOnlyDocumentationPages()) {
-            return min($this->priority, collect($this->getChildren())->min(fn (NavItem $child): int => $child->getPriority()));
+            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 
         return parent::getPriority();
@@ -94,7 +92,7 @@ public function getPriority(): int
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return collect($this->getChildren())->every(function (NavItem $child): bool {
+        return collect($this->getItems())->every(function (NavItem $child): bool {
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 0e9339467f9..40e278bda7c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -37,7 +37,7 @@ class NavItem implements Stringable
     protected string $identifier;
 
     /** @deprecated Use NavGroupItem::$items instead */
-    protected array $children = [];
+    protected array $items = [];
 
     /**
      * Create a new navigation menu item.
@@ -161,9 +161,9 @@ public function getIdentifier(): string
     /**
      * @deprecated Should not be called on this class
      */
-    public function getChildren(): array
+    public function getItems(): array
     {
-        return $this->children;
+        return $this->items;
     }
 
     /**
@@ -171,7 +171,7 @@ public function getChildren(): array
      */
     public function hasChildren(): bool
     {
-        return count($this->children) > 0;
+        return count($this->items) > 0;
     }
 
     /**
@@ -189,7 +189,7 @@ public function addChild(NavItem $item): static
     {
         $item->group ??= $this->group;
 
-        $this->children[] = $item;
+        $this->items[] = $item;
         $this->route = null;
 
         return $this;
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8c20c50acda..310bb492d0b 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1317,7 +1317,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavItem $item): TestNavItem {
-            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item->getChildren());
+            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item->getItems());
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 89c4d055e7d..1fa84d1155d 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -157,7 +157,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getChildren())->first()->getGroupIdentifier());
+        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first()->getGroupIdentifier());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 8eae025f789..28fa612f644 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -49,8 +49,8 @@ public function testCanConstructWithChildren()
         $children = $this->createNavItems();
         $item = new NavGroupItem('Foo', $children);
 
-        $this->assertCount(2, $item->getChildren());
-        $this->assertSame($children, $item->getChildren());
+        $this->assertCount(2, $item->getItems());
+        $this->assertSame($children, $item->getItems());
     }
 
     public function testCanConstructWithChildrenWithoutRoute()
@@ -58,21 +58,21 @@ public function testCanConstructWithChildrenWithoutRoute()
         $children = $this->createNavItems();
         $item = new NavGroupItem('Foo', $children);
 
-        $this->assertCount(2, $item->getChildren());
-        $this->assertSame($children, $item->getChildren());
+        $this->assertCount(2, $item->getItems());
+        $this->assertSame($children, $item->getItems());
     }
 
-    public function testGetChildren()
+    public function testGetItems()
     {
         $children = $this->createNavItems();
         $item = new NavGroupItem('Foo', $children);
 
-        $this->assertSame($children, $item->getChildren());
+        $this->assertSame($children, $item->getItems());
     }
 
-    public function testGetChildrenWithNoChildren()
+    public function testGetItemsWithNoItems()
     {
-        $this->assertEmpty((new NavGroupItem('Foo'))->getChildren());
+        $this->assertEmpty((new NavGroupItem('Foo'))->getItems());
     }
 
     public function testHasChildren()
@@ -90,7 +90,7 @@ public function testCanAddItemToDropdown()
         $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame([$child], $group->addChild($child)->getChildren());
+        $this->assertSame([$child], $group->addChild($child)->getItems());
     }
 
     public function testAddChildMethodReturnsSelf()
@@ -106,7 +106,7 @@ public function testCanAddMultipleItemsToDropdown()
         $group = new NavGroupItem('Foo');
         $items = $this->createNavItems();
 
-        $this->assertSame($items, $group->addChildren($items)->getChildren());
+        $this->assertSame($items, $group->addChildren($items)->getItems());
     }
 
     public function testAddChildrenMethodReturnsSelf()
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index a56e057365b..aeff0c59a51 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -208,7 +208,7 @@ public function testDropdownFacade()
         $item = NavItem::forGroup('foo', []);
 
         $this->assertSame('foo', $item->getLabel());
-        $this->assertSame([], $item->getChildren());
+        $this->assertSame([], $item->getItems());
         $this->assertSame(999, $item->getPriority());
     }
 
@@ -219,7 +219,7 @@ public function testDropdownFacadeWithChildren()
         ];
 
         $item = NavItem::forGroup('foo', $children);
-        $this->assertSame($children, $item->getChildren());
+        $this->assertSame($children, $item->getItems());
         $this->assertSame(999, $item->getPriority());
     }
 

From 4805c8e0744398efe41d2ebf03cfc9534465a38e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 3 Mar 2024 12:23:09 +0100
Subject: [PATCH 0913/4023] Collapse PHPDoc

---
 .../src/Framework/Features/Navigation/NavGroupItem.php        | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 1e4e52de7e5..1ec4ff87b86 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -15,9 +15,7 @@
  */
 class NavGroupItem extends NavItem
 {
-    /**
-     * @var array<\Hyde\Framework\Features\Navigation\NavItem>
-     */
+    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
     protected array $items = [];
 
     public function __construct(string $label, array $children = [], int $priority = NavigationMenu::LAST)

From 08b7936fe850ea3159288e25e17e5682be6a1088 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 3 Mar 2024 12:26:43 +0100
Subject: [PATCH 0914/4023] Deprecate `NavGroupItem::hasChildren` method

This is no longer needed, as it does not make sense to check if a group has children. Compare the instance type instead.
---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 1ec4ff87b86..0b1206f3be4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -39,6 +39,8 @@ public function getItems(): array
 
     /**
      * Check if the NavItem instance has children.
+     *
+     * @deprecated This is no longer needed, as it does not make sense to check if a group has children. Compare the instance type instead.
      */
     public function hasChildren(): bool
     {

From a68bb5b80eef40f15caf718093deec316b00a47d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 20:03:32 +0100
Subject: [PATCH 0915/4023] Remove tests for deprecated method

---
 packages/framework/tests/Unit/NavGroupItemTest.php | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 28fa612f644..1f37834c191 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -75,16 +75,6 @@ public function testGetItemsWithNoItems()
         $this->assertEmpty((new NavGroupItem('Foo'))->getItems());
     }
 
-    public function testHasChildren()
-    {
-        $this->assertFalse((new NavGroupItem('Foo'))->hasChildren());
-    }
-
-    public function testHasChildrenWithChildren()
-    {
-        $this->assertTrue((new NavGroupItem('Foo', $this->createNavItems()))->hasChildren());
-    }
-
     public function testCanAddItemToDropdown()
     {
         $group = new NavGroupItem('Foo');

From 1506ac8a968e8d681fc603aee34c8cf832aa7258 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 20:13:23 +0100
Subject: [PATCH 0916/4023] Fall back to parent class priority

For example if there are no pages
---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 0b1206f3be4..ff8b9c725cf 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -84,7 +84,7 @@ public function addChildren(array $items): static
     public function getPriority(): int
     {
         if ($this->hasChildren() && $this->containsOnlyDocumentationPages()) {
-            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority()));
+            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority())) ?? parent::getPriority();
         }
 
         return parent::getPriority();

From f1b40c80916caa712bbdb542e2159f568eda8b4e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 20:13:37 +0100
Subject: [PATCH 0917/4023] Revert "Fall back to parent class priority"

This reverts commit 1506ac8a968e8d681fc603aee34c8cf832aa7258.
---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index ff8b9c725cf..0b1206f3be4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -84,7 +84,7 @@ public function addChildren(array $items): static
     public function getPriority(): int
     {
         if ($this->hasChildren() && $this->containsOnlyDocumentationPages()) {
-            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority())) ?? parent::getPriority();
+            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 
         return parent::getPriority();

From 027952690e3c2dbc0494a840b316874565891a99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 20:14:10 +0100
Subject: [PATCH 0918/4023] Return false if items are empty

---
 .../src/Framework/Features/Navigation/NavGroupItem.php        | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 0b1206f3be4..82305efe884 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -92,6 +92,10 @@ public function getPriority(): int
 
     protected function containsOnlyDocumentationPages(): bool
     {
+        if (empty($this->getItems())) {
+            return false;
+        }
+
         return collect($this->getItems())->every(function (NavItem $child): bool {
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });

From 95654afffa1189a4d4db0b79a4635f553cdc9a43 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 20:14:27 +0100
Subject: [PATCH 0919/4023] Remove state logic that is now unnecessary

---
 .../src/Framework/Features/Navigation/NavGroupItem.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 82305efe884..8470f5f07ca 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -83,7 +83,7 @@ public function addChildren(array $items): static
      */
     public function getPriority(): int
     {
-        if ($this->hasChildren() && $this->containsOnlyDocumentationPages()) {
+        if ($this->containsOnlyDocumentationPages()) {
             return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority()));
         }
 

From 91ea31f5b17c4d7cfbb5bee947663a96e31a8860 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 21:18:00 +0100
Subject: [PATCH 0920/4023] Use instanceof check to determine child state

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 11cb904cc7c..c931dd1a34c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -88,7 +88,7 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
-        $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item->hasChildren());
+        $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item instanceof NavGroupItem);
 
         $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getIdentifier();
 

From 92bebfa833ec46a3f62a89580e4f4458043f2315 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 21:32:05 +0100
Subject: [PATCH 0921/4023] Use instanceof check to determine child state

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c931dd1a34c..853d84606cb 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -61,7 +61,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavItem $item): bool => $item->hasChildren());
+        return $this->getItems()->contains(fn (NavItem $item): bool => $item instanceof NavGroupItem);
     }
 
     /**

From 4c8780ee77e1c5c1f9a9cb477a2305af905b0e55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 21:58:08 +0100
Subject: [PATCH 0922/4023] Update test for new system

---
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index ee75d74d943..8e1a5d3457e 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -5,10 +5,10 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
-use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavGroupItem;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 /**
@@ -218,15 +218,13 @@ public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
         $this->assertFalse((new DocumentationSidebar())->hasGroups());
     }
 
-    public function testHasGroupsReturnsTrueWhenAtLeastOneItemHasChildren()
+    public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsNavGroupItemInstance()
     {
         self::mockConfig();
         self::setupKernel();
 
-        $page = new DocumentationPage('foo');
-        $child = new DocumentationPage('bar');
         $menu = new DocumentationSidebar([
-            NavItem::forRoute($page->getRoute())->addChild(NavItem::forRoute($child->getRoute())),
+            new NavGroupItem('foo', []),
         ]);
 
         $this->assertTrue($menu->hasGroups());

From e67382344f8dcde04957785c4a3b9e19a45ff7f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 9 Mar 2024 22:03:07 +0100
Subject: [PATCH 0923/4023] Remove `NavGroupItem::hasChildren` method

This is no longer needed, as it does not make sense to check if a group has children. Compare the instance type instead.
---
 .../src/Framework/Features/Navigation/NavGroupItem.php | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 8470f5f07ca..371e1b5fc6f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -37,16 +37,6 @@ public function getItems(): array
         return $this->items;
     }
 
-    /**
-     * Check if the NavItem instance has children.
-     *
-     * @deprecated This is no longer needed, as it does not make sense to check if a group has children. Compare the instance type instead.
-     */
-    public function hasChildren(): bool
-    {
-        return count($this->items) > 0;
-    }
-
     /**
      * Add a navigation item to the children of the navigation item.
      *

From 7f8c773eb3053a9197cdbfcf40e939f37046ee1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 13:01:17 +0100
Subject: [PATCH 0924/4023] Remove `NavItem::addChildren` method from base
 class

Moved to the new NavGroupItem class
---
 .../src/Framework/Features/Navigation/NavItem.php    | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 40e278bda7c..4d2697f270c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -195,18 +195,6 @@ public function addChild(NavItem $item): static
         return $this;
     }
 
-    /**
-     * @deprecated Should not be called on this class
-     */
-    public function addChildren(array $items): static
-    {
-        foreach ($items as $item) {
-            $this->addChild($item);
-        }
-
-        return $this;
-    }
-
     protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;

From ad021c58258d8791e0fd4e1be9fa51c41a6281b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 13:33:53 +0100
Subject: [PATCH 0925/4023] Remove `NavItem::addChild` method from base class

Moved to the new NavGroupItem class
---
 .../src/Framework/Features/Navigation/NavItem.php   | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 4d2697f270c..8d776013aea 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -182,19 +182,6 @@ public function isActive(): bool
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
-    /**
-     * @deprecated Should not be called on this class
-     */
-    public function addChild(NavItem $item): static
-    {
-        $item->group ??= $this->group;
-
-        $this->items[] = $item;
-        $this->route = null;
-
-        return $this;
-    }
-
     protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;

From c35cb8043a93606a9a815bf452400eaf183878a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 17:23:06 +0100
Subject: [PATCH 0926/4023] Remove `NavItem::hasChildren` method

Instead, compare if the NavItem in an instance of the NavGroupItem class
---
 .../resources/views/layouts/navigation.blade.php          | 2 +-
 .../src/Framework/Features/Navigation/NavItem.php         | 8 --------
 2 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 060e228eb0b..fc7aad53803 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -35,7 +35,7 @@
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
-                    @if($item->hasChildren())
+                    @if($item instanceof \Hyde\Framework\Features\Navigation\NavGroupItem)
                         <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getChildren()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 8d776013aea..d503a9d4f5c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -166,14 +166,6 @@ public function getItems(): array
         return $this->items;
     }
 
-    /**
-     * @deprecated Should not be called on this class
-     */
-    public function hasChildren(): bool
-    {
-        return count($this->items) > 0;
-    }
-
     /**
      * Check if the NavItem instance is the current page being rendered.
      */

From 86306bfce495c669117e97af15d5dff418a3906e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 17:23:38 +0100
Subject: [PATCH 0927/4023] Get items using new method

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index fc7aad53803..600d310fbd6 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -36,7 +36,7 @@
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item instanceof \Hyde\Framework\Features\Navigation\NavGroupItem)
-                        <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getChildren()"/>
+                        <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getItems()"/>
                     @else
                         @include('hyde::components.navigation.navigation-link')
                     @endif

From d5febfd0c2fdd2929e0a98ba05dfe9ed0a9cafce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 17:26:21 +0100
Subject: [PATCH 0928/4023] Narrow down return types to child class

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 2 +-
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d503a9d4f5c..d73b015d8db 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -95,7 +95,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      * @param  array<NavItem>  $items  The items to be included in the dropdown.
      * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): static
+    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavGroupItem
     {
         return new NavGroupItem($label, $items, $priority);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index fdc5cf33415..842e8e75263 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -146,7 +146,7 @@ protected function addRouteToGroup(Route $route): void
         }
     }
 
-    protected function getOrCreateGroupItem(string $groupName): NavItem
+    protected function getOrCreateGroupItem(string $groupName): NavGroupItem
     {
         $groupKey = Str::slug($groupName);
         $group = $this->items->get($groupKey);
@@ -154,7 +154,7 @@ protected function getOrCreateGroupItem(string $groupName): NavItem
         return $group ?? $this->createGroupItem($groupKey, $groupName);
     }
 
-    protected function createGroupItem(string $groupKey, string $groupName): NavItem
+    protected function createGroupItem(string $groupKey, string $groupName): NavGroupItem
     {
         $label = $this->searchForGroupLabelInConfig($groupKey) ?? $groupName;
 

From 6404ddc65d03be26fb1a4f2305df9120aead33ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 17:30:21 +0100
Subject: [PATCH 0929/4023] Return instance only if it is for a group

This means that items that have the same route key as a group identifier is ignored here
---
 .../Features/Navigation/NavigationMenuGenerator.php         | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 842e8e75263..4c78f119be9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -151,7 +151,11 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
         $groupKey = Str::slug($groupName);
         $group = $this->items->get($groupKey);
 
-        return $group ?? $this->createGroupItem($groupKey, $groupName);
+        if ($group instanceof NavGroupItem) {
+            return $group;
+        }
+
+        return $this->createGroupItem($groupKey, $groupName);
     }
 
     protected function createGroupItem(string $groupKey, string $groupName): NavGroupItem

From be43166ed6b8b4f3e8e292653b625b0ac68bcde0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 17:34:09 +0100
Subject: [PATCH 0930/4023] Replace conflicting navigation items with grouped
 version

---
 .../Features/Navigation/NavigationMenuGenerator.php    | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 4c78f119be9..0ac947cc0bd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -153,6 +153,16 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
 
         if ($group instanceof NavGroupItem) {
             return $group;
+        } elseif ($group instanceof NavItem) {
+            // We are trying to add children to an existing navigation menu item,
+            // so here we create a new instance to replace the base one, this
+            // does mean we lose the destination as we can't link to them.
+
+            $item = new NavGroupItem($group->getLabel(), [], $group->getPriority());
+
+            $this->items->put($groupKey, $item);
+
+            return $item;
         }
 
         return $this->createGroupItem($groupKey, $groupName);

From fddae2c652131b66a824a8b0dc6dec6ffcfd4eee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 20:27:14 +0100
Subject: [PATCH 0931/4023] Add marker for needed documentation

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 0ac947cc0bd..f41fa696e26 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -158,6 +158,9 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
             // so here we create a new instance to replace the base one, this
             // does mean we lose the destination as we can't link to them.
 
+            // Todo: Add note in documentation about this behavior
+            // Example file structure: _pages/foo.md, _pages/foo/bar.md, _pages/foo/baz.md, here the link to foo will be lost.
+
             $item = new NavGroupItem($group->getLabel(), [], $group->getPriority());
 
             $this->items->put($groupKey, $item);

From 201ca2d10e66874a52f8fb892c7de7f53ade610d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Mar 2024 20:35:35 +0100
Subject: [PATCH 0932/4023] Remove `NavItem::getItems` method from base class

Moved to the new NavGroupItem class
---
 .../src/Framework/Features/Navigation/NavItem.php         | 8 --------
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 3 ++-
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d73b015d8db..d7acc2016f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -158,14 +158,6 @@ public function getIdentifier(): string
         return $this->identifier;
     }
 
-    /**
-     * @deprecated Should not be called on this class
-     */
-    public function getItems(): array
-    {
-        return $this->items;
-    }
-
     /**
      * Check if the NavItem instance is the current page being rendered.
      */
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 310bb492d0b..7ce6a2dcb75 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,6 +18,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavGroupItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -1317,7 +1318,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavItem $item): TestNavItem {
-            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item->getItems());
+            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
         })->toArray();
     }
 

From eb55ce31eb1b3b326be3c897c723d9e51e608471 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 11:03:41 +0100
Subject: [PATCH 0933/4023] Deprecate group parameter

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 853d84606cb..c2e83fd0f8e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
+use JetBrains\PhpStorm\Deprecated;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Support\Str;
 
@@ -69,7 +70,7 @@ public function hasGroups(): bool
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */
-    public function isGroupActive(string $group): bool
+    public function isGroupActive(#[Deprecated('We should be able to get all the needed data from the instance and render data')]string $group): bool
     {
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isCurrentPageIndexPage() && $this->shouldIndexPageBeActive($group);

From 4ca2b69d0965d26488e56f797f9990b033219928 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 11:27:24 +0100
Subject: [PATCH 0934/4023] Deprecate `isGroupActive` method

This makes more sense as a method on the NavGroupItem class.
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c2e83fd0f8e..3a77e90031e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -69,6 +69,8 @@ public function hasGroups(): bool
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
+     *
+     * @deprecated This makes more sense as a method on the NavGroupItem class.
      */
     public function isGroupActive(#[Deprecated('We should be able to get all the needed data from the instance and render data')]string $group): bool
     {

From f04a630abe3c408ecfa30357bb3d3e1b1c267222 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 11:42:29 +0100
Subject: [PATCH 0935/4023] Revert "Deprecate `isGroupActive` method"

This reverts commit 4ca2b69d0965d26488e56f797f9990b033219928.
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3a77e90031e..c2e83fd0f8e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -69,8 +69,6 @@ public function hasGroups(): bool
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
-     *
-     * @deprecated This makes more sense as a method on the NavGroupItem class.
      */
     public function isGroupActive(#[Deprecated('We should be able to get all the needed data from the instance and render data')]string $group): bool
     {

From a480e4e3e5b6807eed4625ef8c559e0f8dd46eb0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 11:42:44 +0100
Subject: [PATCH 0936/4023] Revert "Deprecate group parameter"

This reverts commit eb55ce31eb1b3b326be3c897c723d9e51e608471.
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c2e83fd0f8e..853d84606cb 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -7,7 +7,6 @@
 use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
-use JetBrains\PhpStorm\Deprecated;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Support\Str;
 
@@ -70,7 +69,7 @@ public function hasGroups(): bool
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      */
-    public function isGroupActive(#[Deprecated('We should be able to get all the needed data from the instance and render data')]string $group): bool
+    public function isGroupActive(string $group): bool
     {
         $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isCurrentPageIndexPage() && $this->shouldIndexPageBeActive($group);

From a2df70f636696d5f66f7ffd0150299589069e099 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 11:47:31 +0100
Subject: [PATCH 0937/4023] Document why code location is weird

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 853d84606cb..8dabcbf5254 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -68,6 +68,8 @@ public function hasGroups(): bool
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
+     *
+     * We have this logic here because not all NavItem instances belong to sidebars, and we need data from both.
      */
     public function isGroupActive(string $group): bool
     {

From 8f6ba5ff49131a3d84f9771b3f6399de76710af5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 12:44:53 +0100
Subject: [PATCH 0938/4023] Deprecate the NavItem identifier property

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d7acc2016f6..9b39c5fda9b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -33,7 +33,7 @@ class NavItem implements Stringable
     protected int $priority;
     protected ?string $group;
 
-    /** The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
+    /** @deprecated The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
     protected string $identifier;
 
     /** @deprecated Use NavGroupItem::$items instead */
@@ -152,6 +152,8 @@ public function getGroupIdentifier(): ?string
 
     /**
      * Get the identifier of the navigation item.
+     *
+     * @deprecated This only seems to be used by groups so might want to move it there and rename it to getGroupKey to match usages
      */
     public function getIdentifier(): string
     {

From d415e910cf472f6dcc186dc5313dde9fec5ba6ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 12:47:43 +0100
Subject: [PATCH 0939/4023] Use group identifier for comparison

---
 .../resources/views/components/docs/sidebar-items.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index b160e95ff09..92326932f83 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -7,7 +7,7 @@
 @else
     <ul id="sidebar-items" role="list">
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getIdentifier()) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupIdentifier()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
                     <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
                     @if($sidebar->isCollapsible())

From b3d12375a660d0647a086c77042b683ce036f05b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 12:55:24 +0100
Subject: [PATCH 0940/4023] Use group identifier instead of deprecated base
 identifier

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index f41fa696e26..b2860bd4345 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -141,8 +141,8 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem->addChild($item);
 
-        if (! $this->items->has($groupItem->getIdentifier())) {
-            $this->items->put($groupItem->getIdentifier(), $groupItem);
+        if (! $this->items->has($groupItem->getGroupIdentifier())) {
+            $this->items->put($groupItem->getGroupIdentifier(), $groupItem);
         }
     }
 

From e830cdaca6b1550b518130a9ccae73a76e65b149 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 13:18:13 +0100
Subject: [PATCH 0941/4023] Rename NavItem method `getGroupIdentifier` to
 `getGroupKey`

Matches the documented usage better
---
 .../views/components/docs/sidebar-items.blade.php    |  2 +-
 .../src/Framework/Features/Navigation/NavItem.php    |  4 ++--
 .../Features/Navigation/NavigationMenuGenerator.php  |  6 +++---
 .../AutomaticNavigationConfigurationsTest.php        |  2 +-
 .../Feature/Services/DocumentationSidebarTest.php    |  2 +-
 packages/framework/tests/Unit/NavGroupItemTest.php   |  8 ++++----
 packages/framework/tests/Unit/NavItemTest.php        | 12 ++++++------
 7 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 92326932f83..e06a90e94c5 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -7,7 +7,7 @@
 @else
     <ul id="sidebar-items" role="list">
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupIdentifier()) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
                     <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
                     @if($sidebar->isCollapsible())
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 9b39c5fda9b..457341a5910 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -141,11 +141,11 @@ public function getPriority(): int
     }
 
     /**
-     * Get the group identifier of the navigation item, if any.
+     * Get the group identifier key of the navigation item, if any.
      *
      * For sidebars this is the category key, for navigation menus this is the dropdown key.
      */
-    public function getGroupIdentifier(): ?string
+    public function getGroupKey(): ?string
     {
         return $this->group;
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b2860bd4345..4bbc163efc0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -135,14 +135,14 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavItem::forRoute($route);
 
-        $groupName = $this->generatesSidebar ? ($item->getGroupIdentifier() ?? 'Other') : $item->getGroupIdentifier();
+        $groupName = $this->generatesSidebar ? ($item->getGroupKey() ?? 'Other') : $item->getGroupKey();
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 
         $groupItem->addChild($item);
 
-        if (! $this->items->has($groupItem->getGroupIdentifier())) {
-            $this->items->put($groupItem->getGroupIdentifier(), $groupItem);
+        if (! $this->items->has($groupItem->getGroupKey())) {
+            $this->items->put($groupItem->getGroupKey(), $groupItem);
         }
     }
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 7ce6a2dcb75..0de6e2ee60a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1318,7 +1318,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavItem $item): TestNavItem {
-            return new TestNavItem($item->getLabel(), $item->getGroupIdentifier(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
+            return new TestNavItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 1fa84d1155d..01aa15b3430 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -157,7 +157,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first()->getGroupIdentifier());
+        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first()->getGroupKey());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index 1f37834c191..b8bc2caad15 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -113,8 +113,8 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
 
         $group->addChild($child);
 
-        $this->assertSame('foo', $group->getGroupIdentifier());
-        $this->assertSame('bar', $child->getGroupIdentifier());
+        $this->assertSame('foo', $group->getGroupKey());
+        $this->assertSame('bar', $child->getGroupKey());
     }
 
     public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
@@ -124,8 +124,8 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
 
         $group->addChild($child);
 
-        $this->assertSame('foo', $group->getGroupIdentifier());
-        $this->assertSame('foo', $child->getGroupIdentifier());
+        $this->assertSame('foo', $group->getGroupKey());
+        $this->assertSame('foo', $child->getGroupKey());
     }
 
     public function testGetPriorityUsesDefaultPriority()
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index aeff0c59a51..d6362b5579d 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -105,7 +105,7 @@ public function testGetPriority()
     public function testGetGroup()
     {
         $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertNull($navItem->getGroupIdentifier());
+        $this->assertNull($navItem->getGroupKey());
     }
 
     public function testFromRoute()
@@ -252,28 +252,28 @@ public function testIsCurrentWithExternalRoute()
 
     public function testGetGroupWithNoGroup()
     {
-        $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupIdentifier());
+        $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupKey());
     }
 
     public function testGetGroupWithGroup()
     {
-        $this->assertSame('foo', (new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupIdentifier());
+        $this->assertSame('foo', (new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupKey());
     }
 
     public function testGetGroupFromRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupIdentifier());
+        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
     }
 
     public function testGetGroupForRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupIdentifier());
+        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
     }
 
     public function testGroupKeysAreNormalized()
     {
         $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
-        $this->assertSame('foo-bar', $item->getGroupIdentifier());
+        $this->assertSame('foo-bar', $item->getGroupKey());
     }
 
     public function testIdentifier()

From 711ef0305b25711c2344ee091d7dee50c5bd7c39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 13:22:20 +0100
Subject: [PATCH 0942/4023] Improve code documentation

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 457341a5910..3a994ecf6f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -144,6 +144,7 @@ public function getPriority(): int
      * Get the group identifier key of the navigation item, if any.
      *
      * For sidebars this is the category key, for navigation menus this is the dropdown key.
+     * It's based on the "slugified" group label, or the subdirectory name if that is how.
      */
     public function getGroupKey(): ?string
     {

From d15b710aa6fc9a47359c920cb978c578a3590fbe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 13:24:33 +0100
Subject: [PATCH 0943/4023] Improve code documentation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 3a994ecf6f6..3ace9af6ab4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -143,8 +143,10 @@ public function getPriority(): int
     /**
      * Get the group identifier key of the navigation item, if any.
      *
+     * When using automatic subdirectory based groups, the subdirectory name is the group key.
+     * Otherwise, the group key is a "slugified" version of the group's label.
+     *
      * For sidebars this is the category key, for navigation menus this is the dropdown key.
-     * It's based on the "slugified" group label, or the subdirectory name if that is how.
      */
     public function getGroupKey(): ?string
     {

From 029b01db18be6e044a561e595cda2f7482dacee7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 13:26:51 +0100
Subject: [PATCH 0944/4023] Use group key for comparison

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8dabcbf5254..8d1d2567c29 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -92,7 +92,7 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item instanceof NavGroupItem);
 
-        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getIdentifier();
+        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getGroupKey();
 
         return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
     }

From 2352dced085ba60335a705876a598fecb307c912 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 13:28:01 +0100
Subject: [PATCH 0945/4023] Remove unnecessary NavItem identifier feature

---
 .../Framework/Features/Navigation/NavItem.php | 14 --------
 packages/framework/tests/Unit/NavItemTest.php | 36 -------------------
 2 files changed, 50 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 3ace9af6ab4..a787d4ea25f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -33,9 +33,6 @@ class NavItem implements Stringable
     protected int $priority;
     protected ?string $group;
 
-    /** @deprecated The "slugified" version of the label used to uniquely identify the item for things like active state comparisons. */
-    protected string $identifier;
-
     /** @deprecated Use NavGroupItem::$items instead */
     protected array $items = [];
 
@@ -57,7 +54,6 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->label = $label;
         $this->priority = $priority;
         $this->group = static::normalizeGroupKey($group);
-        $this->identifier = static::makeIdentifier($label);
     }
 
     /**
@@ -153,16 +149,6 @@ public function getGroupKey(): ?string
         return $this->group;
     }
 
-    /**
-     * Get the identifier of the navigation item.
-     *
-     * @deprecated This only seems to be used by groups so might want to move it there and rename it to getGroupKey to match usages
-     */
-    public function getIdentifier(): string
-    {
-        return $this->identifier;
-    }
-
     /**
      * Check if the NavItem instance is the current page being rendered.
      */
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index d6362b5579d..98093b7628e 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -275,40 +275,4 @@ public function testGroupKeysAreNormalized()
         $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
         $this->assertSame('foo-bar', $item->getGroupKey());
     }
-
-    public function testIdentifier()
-    {
-        $route = new Route(new MarkdownPage());
-        $item = new NavItem($route, 'Test', 500);
-
-        $this->assertSame('test', $item->getIdentifier());
-    }
-
-    public function testIdentifierWithCustomLabel()
-    {
-        $route = new Route(new MarkdownPage());
-        $item = new NavItem($route, 'Foo Bar', 500);
-
-        $this->assertSame('foo-bar', $item->getIdentifier());
-    }
-
-    public function testIdentifierFromRouteKey()
-    {
-        $item = NavItem::forRoute(Routes::get('index'));
-        $this->assertSame('home', $item->getIdentifier());
-    }
-
-    public function testIdentifierUsesLabelWhenRouteKeyIsFalsy()
-    {
-        $route = new Route(new MarkdownPage());
-        $item = new NavItem($route, 'Foo Bar', 500);
-
-        $this->assertSame('foo-bar', $item->getIdentifier());
-    }
-
-    public function testIdentifierUsesLabelForExternalRoute()
-    {
-        $item = NavItem::forLink('https://example.com', 'Foo Bar');
-        $this->assertSame('foo-bar', $item->getIdentifier());
-    }
 }

From cc5bad4133dad8782d1b0fe3129caa37bd2067d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 16:16:34 +0100
Subject: [PATCH 0946/4023] Add todo

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8d1d2567c29..64ed8edd555 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -88,6 +88,8 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be active.
 
+        // Todo: It may make more sense to handle this logic in the view, as it's a UI concern and this is a data model.
+
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
         $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item instanceof NavGroupItem);

From c549371c057a9de367e4c526b6b86bc63cfcc8ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 16:19:22 +0100
Subject: [PATCH 0947/4023] Rename `addChild` method to `addItem`

---
 .../src/Framework/Features/Navigation/NavGroupItem.php |  4 ++--
 .../Features/Navigation/NavigationMenuGenerator.php    |  2 +-
 packages/framework/tests/Unit/NavGroupItemTest.php     | 10 +++++-----
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 371e1b5fc6f..6b61bfcf297 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -42,7 +42,7 @@ public function getItems(): array
      *
      * This will turn the parent item into a dropdown. Its destination will be set to null.
      */
-    public function addChild(NavItem $item): static
+    public function addItem(NavItem $item): static
     {
         $item->group ??= $this->group;
 
@@ -60,7 +60,7 @@ public function addChild(NavItem $item): static
     public function addChildren(array $items): static
     {
         foreach ($items as $item) {
-            $this->addChild($item);
+            $this->addItem($item);
         }
 
         return $this;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 4bbc163efc0..5aacd70441e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -139,7 +139,7 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 
-        $groupItem->addChild($item);
+        $groupItem->addItem($item);
 
         if (! $this->items->has($groupItem->getGroupKey())) {
             $this->items->put($groupItem->getGroupKey(), $groupItem);
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index b8bc2caad15..ea5513813e2 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -80,7 +80,7 @@ public function testCanAddItemToDropdown()
         $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame([$child], $group->addChild($child)->getItems());
+        $this->assertSame([$child], $group->addItem($child)->getItems());
     }
 
     public function testAddChildMethodReturnsSelf()
@@ -88,7 +88,7 @@ public function testAddChildMethodReturnsSelf()
         $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame($group, $group->addChild($child));
+        $this->assertSame($group, $group->addItem($child));
     }
 
     public function testCanAddMultipleItemsToDropdown()
@@ -111,7 +111,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
         $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
-        $group->addChild($child);
+        $group->addItem($child);
 
         $this->assertSame('foo', $group->getGroupKey());
         $this->assertSame('bar', $child->getGroupKey());
@@ -122,7 +122,7 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
         $group = new NavGroupItem('Foo');
         $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
 
-        $group->addChild($child);
+        $group->addItem($child);
 
         $this->assertSame('foo', $group->getGroupKey());
         $this->assertSame('foo', $child->getGroupKey());
@@ -163,7 +163,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavItem(new Route(new $type()), 'Bar', 100);
-            $group->addChild($child);
+            $group->addItem($child);
         }
 
         $this->assertSame(999, $group->getPriority());

From 76a50691d5a114b51d37e6930575eb16416ac8c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 16:19:40 +0100
Subject: [PATCH 0948/4023] Rename `addChildren` method to `addItems`

---
 .../src/Framework/Features/Navigation/NavGroupItem.php        | 4 ++--
 packages/framework/tests/Unit/NavGroupItemTest.php            | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 6b61bfcf297..6b090f4750f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -22,7 +22,7 @@ public function __construct(string $label, array $children = [], int $priority =
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
 
-        $this->addChildren($children);
+        $this->addItems($children);
     }
 
     /**
@@ -57,7 +57,7 @@ public function addItem(NavItem $item): static
      *
      * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
      */
-    public function addChildren(array $items): static
+    public function addItems(array $items): static
     {
         foreach ($items as $item) {
             $this->addItem($item);
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index ea5513813e2..c76f37aa346 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -96,14 +96,14 @@ public function testCanAddMultipleItemsToDropdown()
         $group = new NavGroupItem('Foo');
         $items = $this->createNavItems();
 
-        $this->assertSame($items, $group->addChildren($items)->getItems());
+        $this->assertSame($items, $group->addItems($items)->getItems());
     }
 
     public function testAddChildrenMethodReturnsSelf()
     {
         $group = new NavGroupItem('Foo');
 
-        $this->assertSame($group, $group->addChildren([]));
+        $this->assertSame($group, $group->addItems([]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()

From 1ba5848654ef2e01ebc1ef30a27be12fb8d546c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 16:21:17 +0100
Subject: [PATCH 0949/4023] Change named `$children` parameter to `$items`

---
 .../src/Framework/Features/Navigation/NavGroupItem.php        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 6b090f4750f..792386b033e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -18,11 +18,11 @@ class NavGroupItem extends NavItem
     /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
     protected array $items = [];
 
-    public function __construct(string $label, array $children = [], int $priority = NavigationMenu::LAST)
+    public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
     {
         parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
 
-        $this->addItems($children);
+        $this->addItems($items);
     }
 
     /**

From d8ece8fdd3c317468047b14aaf0f4b396de7072c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 16:29:29 +0100
Subject: [PATCH 0950/4023] Remove route null writing not needed for standalone
 class

Since splitting out the class this is already null from the start
---
 .../framework/src/Framework/Features/Navigation/NavGroupItem.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 792386b033e..4f3cb6fb1aa 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -47,7 +47,6 @@ public function addItem(NavItem $item): static
         $item->group ??= $this->group;
 
         $this->items[] = $item;
-        $this->route = null;
 
         return $this;
     }

From a1b82f0da486b9ea79821f6758b8d346a55f6c0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:06:05 +0100
Subject: [PATCH 0951/4023] Update class documentation

---
 .../Framework/Features/Navigation/NavGroupItem.php   | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 4f3cb6fb1aa..72bd92a3ac8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -11,6 +11,8 @@
 use function collect;
 
 /**
+ * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
+ *
  * @todo Consider extracting trait for shared code with navigation menu class
  */
 class NavGroupItem extends NavItem
@@ -26,7 +28,7 @@ public function __construct(string $label, array $items = [], int $priority = Na
     }
 
     /**
-     * Get the children of the navigation item.
+     * Get the items of the grouped navigation item.
      *
      * For the main navigation menu, this stores any dropdown items.
      *
@@ -38,9 +40,7 @@ public function getItems(): array
     }
 
     /**
-     * Add a navigation item to the children of the navigation item.
-     *
-     * This will turn the parent item into a dropdown. Its destination will be set to null.
+     * Add a navigation item to the grouped navigation item.
      */
     public function addItem(NavItem $item): static
     {
@@ -52,7 +52,7 @@ public function addItem(NavItem $item): static
     }
 
     /**
-     * Add multiple navigation items to the children of the navigation item.
+     * Add multiple navigation items to the grouped navigation item.
      *
      * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
      */
@@ -66,7 +66,7 @@ public function addItems(array $items): static
     }
 
     /**
-     * Get the priority to determine the order of the navigation item.
+     * Get the priority to determine the order of the grouped navigation item.
      *
      * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
      */

From a4d9207e1f714c8c2ea780f1055a1987fe19b52e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:18:45 +0100
Subject: [PATCH 0952/4023] Remove unused helper method

---
 .../framework/src/Framework/Features/Navigation/NavItem.php  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a787d4ea25f..5f2ffe3a200 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -161,9 +161,4 @@ protected static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
-
-    protected static function makeIdentifier(string $label): string
-    {
-        return Str::slug($label);
-    }
 }

From 563444e11d4af9af4bb64dfe038981975a6a5f1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:18:53 +0100
Subject: [PATCH 0953/4023] Normalize documentation terms

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5f2ffe3a200..5921d6af9a6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -42,7 +42,7 @@ class NavItem implements Stringable
      * @param  \Hyde\Support\Models\Route|string|null  $destination  Route instance, route key, or external URI. For dropdowns/groups, this should be null.
      * @param  string  $label  The label of the navigation item.
      * @param  int  $priority  The priority to determine the order of the navigation item.
-     * @param  string|null  $group  The dropdown/group identifier of the navigation item, if any.
+     * @param  string|null  $group  The dropdown/group key of the navigation item, if any.
      */
     public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
     {

From ff4e949556c0ae49b80d947b707fb63663362efc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:19:00 +0100
Subject: [PATCH 0954/4023] Remove outdated documentation

---
 .../framework/src/Framework/Features/Navigation/NavItem.php  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 5921d6af9a6..d18c5b451e3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -20,11 +20,6 @@
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavItem::fromRoute() to use data from the route
  *   3. You can use NavItem::forLink() for an external or un-routed link
- *
- * Navigation items can be turned into dropdowns or sidebar groups by adding children.
- * Note that doing so will mean that any link on the parent will no longer be clickable,
- * as clicking the parent label will open the dropdown instead of leading to the destination.
- * For this reason, dropdown items will have their destination set to null.
  */
 class NavItem implements Stringable
 {

From 6e7835e7614b316493d080a4c0b8b295cc0be7fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:35:31 +0100
Subject: [PATCH 0955/4023] Update documentation order

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index d18c5b451e3..a9cd1a6ca48 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -134,10 +134,10 @@ public function getPriority(): int
     /**
      * Get the group identifier key of the navigation item, if any.
      *
+     * For sidebars this is the category key, for navigation menus this is the dropdown key.
+     *
      * When using automatic subdirectory based groups, the subdirectory name is the group key.
      * Otherwise, the group key is a "slugified" version of the group's label.
-     *
-     * For sidebars this is the category key, for navigation menus this is the dropdown key.
      */
     public function getGroupKey(): ?string
     {

From 8b52836b6043a81485a9b79e94f71c7aa30834c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:42:14 +0100
Subject: [PATCH 0956/4023] Create NavigationHtmlLayoutsTest.php

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php      | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
new file mode 100644
index 00000000000..eeef142f3d9
--- /dev/null
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Views;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * Very high level tests for navigation menu and sidebar view layouts.
+ */
+class NavigationHtmlLayoutsTest extends TestCase
+{
+    //
+}

From 50ee2c29f9d8ae9a18d8d2adb1a18752a0b0168d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:43:13 +0100
Subject: [PATCH 0957/4023] Add crosslinks between similarly functioning tests

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php     | 2 ++
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0de6e2ee60a..fa018501b9e 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -26,6 +26,8 @@
 /**
  * High-level broad-spectrum tests for the automatic navigation configurations, testing various setups.
  *
+ * @see \Hyde\Framework\Testing\Unit\Views\NavigationHtmlLayoutsTest
+ *
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index eeef142f3d9..25c265ac3e2 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -8,6 +8,8 @@
 
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
+ *
+ * @see \Hyde\Framework\Testing\Feature\AutomaticNavigationConfigurationsTest
  */
 class NavigationHtmlLayoutsTest extends TestCase
 {

From a4653545c4fe0128f7ed80c3052897d109c382ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:44:54 +0100
Subject: [PATCH 0958/4023] Copy over base helpers from similar test

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php   | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 25c265ac3e2..01886830afb 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -5,6 +5,9 @@
 namespace Hyde\Framework\Testing\Unit\Views;
 
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\HydeKernel;
+use Hyde\Pages\Concerns\HydePage;
+use Hyde\Framework\Testing\Feature\TestKernel;
 
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
@@ -13,5 +16,18 @@
  */
 class NavigationHtmlLayoutsTest extends TestCase
 {
-    //
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->kernel = new TestKernel();
+        HydeKernel::setInstance($this->kernel);
+    }
+
+    protected function withPages(array $pages): static
+    {
+        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
+
+        return $this;
+    }
 }

From 783543f4133746ce8d949d50a689b6ffbfcff1e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:57:08 +0100
Subject: [PATCH 0959/4023] Move container access back to view

---
 .../resources/views/components/docs/sidebar.blade.php         | 4 ++++
 packages/framework/resources/views/layouts/docs.blade.php     | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar.blade.php b/packages/framework/resources/views/components/docs/sidebar.blade.php
index 0196551d310..e6698715522 100644
--- a/packages/framework/resources/views/components/docs/sidebar.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar.blade.php
@@ -1,3 +1,7 @@
+@php
+    $sidebar = app('navigation.sidebar');
+@endphp
+
 <aside id="sidebar" x-cloak :class="sidebarOpen ? 'visible left-0' : 'invisible -left-64 md:visible md:left-0'" class="bg-gray-100 dark:bg-gray-800 dark:text-gray-200 h-screen w-64 fixed z-30 md:flex flex-col shadow-lg md:shadow-none transition-all duration-300">
     <header id="sidebar-header" class="h-16">
         @include('hyde::components.docs.sidebar-brand')
diff --git a/packages/framework/resources/views/layouts/docs.blade.php b/packages/framework/resources/views/layouts/docs.blade.php
index e6bdb4886cf..3f66d821517 100644
--- a/packages/framework/resources/views/layouts/docs.blade.php
+++ b/packages/framework/resources/views/layouts/docs.blade.php
@@ -8,7 +8,7 @@
 
     @include('hyde::components.skip-to-content-button')
     @include('hyde::components.docs.mobile-navigation')
-    @include('hyde::components.docs.sidebar', ['sidebar' => app('navigation.sidebar')])
+    @include('hyde::components.docs.sidebar')
 
     <main id="content" class="dark:bg-gray-900 min-h-screen bg-gray-50 md:bg-white absolute top-16 md:top-0 w-screen md:left-64 md:w-[calc(100vw_-_16rem)]">
         @include('hyde::components.docs.documentation-article')

From c95b3e333d4ac16a713f57ba598b8c4e93becb84 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 17:47:29 +0100
Subject: [PATCH 0960/4023] Copy over test kernel

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php    | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 01886830afb..4902212f78c 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -7,7 +7,6 @@
 use Hyde\Testing\TestCase;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
-use Hyde\Framework\Testing\Feature\TestKernel;
 
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
@@ -31,3 +30,19 @@ protected function withPages(array $pages): static
         return $this;
     }
 }
+
+class TestKernel extends HydeKernel
+{
+    protected ?RouteCollection $mockRoutes = null;
+
+    public function setRoutes(Collection $routes): void
+    {
+        $this->mockRoutes = RouteCollection::make($routes);
+    }
+
+    /** @return \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
+    public function routes(): RouteCollection
+    {
+        return $this->mockRoutes ?? parent::routes();
+    }
+}

From 43107a652b20c402362e82c340cef3af64965347 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:02:28 +0100
Subject: [PATCH 0961/4023] Set up base testing API scaffolding

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 4902212f78c..328bf7fdeec 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -7,6 +7,11 @@
 use Hyde\Testing\TestCase;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\Concerns\HydePage;
+use Illuminate\Support\Collection;
+use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
@@ -21,6 +26,22 @@ protected function setUp(): void
 
         $this->kernel = new TestKernel();
         HydeKernel::setInstance($this->kernel);
+
+        app()->instance('navigation.main', null);
+        app()->instance('navigation.sidebar', null);
+
+        $this->mockPage();
+        $this->mockRoute();
+    }
+
+    public function testMainNavigationMenu()
+    {
+        $this->menu()->assertTrue();
+    }
+
+    public function testDocumentationSidebarMenu()
+    {
+        $this->sidebar()->assertTrue();
     }
 
     protected function withPages(array $pages): static
@@ -29,6 +50,52 @@ protected function withPages(array $pages): static
 
         return $this;
     }
+
+    protected function menu(?array $withPages = null): RenderedNavigationMenu
+    {
+        if ($withPages) {
+            $this->withPages($withPages);
+        }
+
+        $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
+        app()->instance('navigation.main', $menu);
+
+        return new RenderedNavigationMenu($this, $this->render('hyde::layouts.navigation'));
+    }
+
+    protected function sidebar(?array $withPages = null): RenderedNavigationMenu
+    {
+        if ($withPages) {
+            $this->withPages($withPages);
+        }
+
+        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        app()->instance('navigation.sidebar', $menu);
+
+        return new RenderedNavigationMenu($this, $this->render('hyde::components.docs.sidebar'));
+    }
+
+    protected function render(string $view): string
+    {
+        return view($view)->render();
+    }
+}
+
+class RenderedNavigationMenu
+{
+    protected NavigationHtmlLayoutsTest $test;
+    protected string $html;
+
+    public function __construct(NavigationHtmlLayoutsTest $test, string $html)
+    {
+        $this->test = $test;
+        $this->html = $html;
+    }
+
+    public function assertTrue(): void
+    {
+        $this->test->assertTrue(true);
+    }
 }
 
 class TestKernel extends HydeKernel

From 173039ab9184b046874fb446f286f6314c124baa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:06:25 +0100
Subject: [PATCH 0962/4023] Add type parameter to test helper

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 328bf7fdeec..2eb333c73ac 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -60,7 +60,7 @@ protected function menu(?array $withPages = null): RenderedNavigationMenu
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
         app()->instance('navigation.main', $menu);
 
-        return new RenderedNavigationMenu($this, $this->render('hyde::layouts.navigation'));
+        return new RenderedNavigationMenu($this, $this->render('hyde::layouts.navigation'), MainNavigationMenu::class);
     }
 
     protected function sidebar(?array $withPages = null): RenderedNavigationMenu
@@ -72,7 +72,7 @@ protected function sidebar(?array $withPages = null): RenderedNavigationMenu
         $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         app()->instance('navigation.sidebar', $menu);
 
-        return new RenderedNavigationMenu($this, $this->render('hyde::components.docs.sidebar'));
+        return new RenderedNavigationMenu($this, $this->render('hyde::components.docs.sidebar'), DocumentationSidebar::class);
     }
 
     protected function render(string $view): string
@@ -85,11 +85,13 @@ class RenderedNavigationMenu
 {
     protected NavigationHtmlLayoutsTest $test;
     protected string $html;
+    protected string $type;
 
-    public function __construct(NavigationHtmlLayoutsTest $test, string $html)
+    public function __construct(NavigationHtmlLayoutsTest $test, string $html, string $type)
     {
         $this->test = $test;
         $this->html = $html;
+        $this->type = $type;
     }
 
     public function assertTrue(): void

From 59b654790f7833f1a12b2899d00dd3d648e5f7e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:11:03 +0100
Subject: [PATCH 0963/4023] Add testing helper to die with HTML contents

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 2eb333c73ac..7483c2d3717 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -4,8 +4,11 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
 use Hyde\Foundation\HydeKernel;
+use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
@@ -98,6 +101,15 @@ public function assertTrue(): void
     {
         $this->test->assertTrue(true);
     }
+
+    #[NoReturn]
+    public function dd(bool $writeHtml = true): void
+    {
+        if ($writeHtml) {
+            file_put_contents(Hyde::path(Str::kebab(class_basename($this->type)).'.html'), $this->html);
+        }
+        exit(trim($this->html)."\n\n");
+    }
 }
 
 class TestKernel extends HydeKernel

From 9fdeb6716fcf5754cb2b6a90813bf6c06baa9a34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:12:23 +0100
Subject: [PATCH 0964/4023] Add newline

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 7483c2d3717..f0e150c2c75 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -108,6 +108,7 @@ public function dd(bool $writeHtml = true): void
         if ($writeHtml) {
             file_put_contents(Hyde::path(Str::kebab(class_basename($this->type)).'.html'), $this->html);
         }
+
         exit(trim($this->html)."\n\n");
     }
 }

From c68853c5cd55221db3055b27ab134997144b9bdc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:29:33 +0100
Subject: [PATCH 0965/4023] Experimental HTML parser setup

See quirks at https://stackoverflow.com/a/70303134/5700388
---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f0e150c2c75..1ef83a9a8b5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -111,6 +111,36 @@ public function dd(bool $writeHtml = true): void
 
         exit(trim($this->html)."\n\n");
     }
+
+    protected function parseHtml(): DOMDocument
+    {
+        $dom = new DOMDocument();
+        $document = $this->html;
+
+        $html = <<<HTML
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Test Document</title>
+</head>
+<body>
+    <main id="test-content">
+        $document
+    </main>
+</body>
+</html>
+HTML;
+
+        try {
+            $dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING | LIBXML_NOERROR | LIBXML_PARSEHUGE);
+        } catch (Throwable $exception) {
+            throw $exception;
+        }
+
+        return $dom;
+    }
 }
 
 class TestKernel extends HydeKernel

From e407f2fedfcd96516a7b25c1ec802de434aa2103 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:30:17 +0100
Subject: [PATCH 0966/4023] Unwrap try

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1ef83a9a8b5..276b7092eb8 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -133,11 +133,7 @@ protected function parseHtml(): DOMDocument
 </html>
 HTML;
 
-        try {
-            $dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING | LIBXML_NOERROR | LIBXML_PARSEHUGE);
-        } catch (Throwable $exception) {
-            throw $exception;
-        }
+        $dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING | LIBXML_NOERROR | LIBXML_PARSEHUGE);
 
         return $dom;
     }

From 374467d04b7d76b4e8ec1332c77595671f3c56b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:30:49 +0100
Subject: [PATCH 0967/4023] Remove wrapper document

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 21 ++-----------------
 1 file changed, 2 insertions(+), 19 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 276b7092eb8..edcc32a9f1f 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -115,25 +115,8 @@ public function dd(bool $writeHtml = true): void
     protected function parseHtml(): DOMDocument
     {
         $dom = new DOMDocument();
-        $document = $this->html;
-
-        $html = <<<HTML
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Test Document</title>
-</head>
-<body>
-    <main id="test-content">
-        $document
-    </main>
-</body>
-</html>
-HTML;
-
-        $dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING | LIBXML_NOERROR | LIBXML_PARSEHUGE);
+
+        $dom->loadHTML($this->html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING | LIBXML_NOERROR | LIBXML_PARSEHUGE);
 
         return $dom;
     }

From 94248683b72727fadb5048c6e3c77d0feef50612 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:31:01 +0100
Subject: [PATCH 0968/4023] Parse HTML into test AST

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index edcc32a9f1f..37b35988f0a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -89,12 +89,15 @@ class RenderedNavigationMenu
     protected NavigationHtmlLayoutsTest $test;
     protected string $html;
     protected string $type;
+    protected DOMDocument $ast;
 
     public function __construct(NavigationHtmlLayoutsTest $test, string $html, string $type)
     {
         $this->test = $test;
         $this->html = $html;
         $this->type = $type;
+
+        $this->ast = $this->parseHtml();
     }
 
     public function assertTrue(): void

From 23b65d4dcf322defb8b887c26081935dd57f1c7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:31:13 +0100
Subject: [PATCH 0969/4023] Add noinspection tag

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 37b35988f0a..f1a38e7962e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -1,5 +1,7 @@
 <?php
 
+/** @noinspection PhpComposerExtensionStubsInspection */
+
 declare(strict_types=1);
 
 namespace Hyde\Framework\Testing\Unit\Views;

From 473654169b23f1ebea5ae2e9374b3e90659aee8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:31:32 +0100
Subject: [PATCH 0970/4023] Import class

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f1a38e7962e..17562e68a0a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -7,6 +7,7 @@
 namespace Hyde\Framework\Testing\Unit\Views;
 
 use Hyde\Hyde;
+use DOMDocument;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Str;
 use Hyde\Foundation\HydeKernel;

From 5f425a0997847615bc72ce47b91ac0c1fe52e38f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:37:20 +0100
Subject: [PATCH 0971/4023] Add base assertion

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 17562e68a0a..597f3b44f98 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -101,6 +101,8 @@ public function __construct(NavigationHtmlLayoutsTest $test, string $html, strin
         $this->type = $type;
 
         $this->ast = $this->parseHtml();
+
+        $this->test->assertNotEmpty($this->html);
     }
 
     public function assertTrue(): void

From 8c30a5af4afd1dee948359804d6a3310fd1be8a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:38:43 +0100
Subject: [PATCH 0972/4023] Readonly test data

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 597f3b44f98..55390620f2b 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -89,10 +89,10 @@ protected function render(string $view): string
 
 class RenderedNavigationMenu
 {
-    protected NavigationHtmlLayoutsTest $test;
-    protected string $html;
-    protected string $type;
-    protected DOMDocument $ast;
+    protected readonly NavigationHtmlLayoutsTest $test;
+    protected readonly string $html;
+    protected readonly string $type;
+    protected readonly DOMDocument $ast;
 
     public function __construct(NavigationHtmlLayoutsTest $test, string $html, string $type)
     {

From 93cc298f357b3a68d780eaaba63ecee71bd5b61c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:40:53 +0100
Subject: [PATCH 0973/4023] Refactor to split out child testing helper classes

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 28 +++++++++++++------
 1 file changed, 19 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 55390620f2b..59634351a97 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -57,7 +57,7 @@ protected function withPages(array $pages): static
         return $this;
     }
 
-    protected function menu(?array $withPages = null): RenderedNavigationMenu
+    protected function menu(?array $withPages = null): RenderedMainNavigationMenu
     {
         if ($withPages) {
             $this->withPages($withPages);
@@ -66,10 +66,10 @@ protected function menu(?array $withPages = null): RenderedNavigationMenu
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
         app()->instance('navigation.main', $menu);
 
-        return new RenderedNavigationMenu($this, $this->render('hyde::layouts.navigation'), MainNavigationMenu::class);
+        return new RenderedMainNavigationMenu($this, $this->render('hyde::layouts.navigation'));
     }
 
-    protected function sidebar(?array $withPages = null): RenderedNavigationMenu
+    protected function sidebar(?array $withPages = null): RenderedDocumentationSidebarMenu
     {
         if ($withPages) {
             $this->withPages($withPages);
@@ -78,7 +78,7 @@ protected function sidebar(?array $withPages = null): RenderedNavigationMenu
         $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         app()->instance('navigation.sidebar', $menu);
 
-        return new RenderedNavigationMenu($this, $this->render('hyde::components.docs.sidebar'), DocumentationSidebar::class);
+        return new RenderedDocumentationSidebarMenu($this, $this->render('hyde::components.docs.sidebar'));
     }
 
     protected function render(string $view): string
@@ -87,18 +87,18 @@ protected function render(string $view): string
     }
 }
 
-class RenderedNavigationMenu
+abstract class RenderedNavigationMenu
 {
     protected readonly NavigationHtmlLayoutsTest $test;
     protected readonly string $html;
-    protected readonly string $type;
     protected readonly DOMDocument $ast;
 
-    public function __construct(NavigationHtmlLayoutsTest $test, string $html, string $type)
+    protected const TYPE = null;
+
+    public function __construct(NavigationHtmlLayoutsTest $test, string $html)
     {
         $this->test = $test;
         $this->html = $html;
-        $this->type = $type;
 
         $this->ast = $this->parseHtml();
 
@@ -114,7 +114,7 @@ public function assertTrue(): void
     public function dd(bool $writeHtml = true): void
     {
         if ($writeHtml) {
-            file_put_contents(Hyde::path(Str::kebab(class_basename($this->type)).'.html'), $this->html);
+            file_put_contents(Hyde::path(Str::kebab(class_basename(static::TYPE)).'.html'), $this->html);
         }
 
         exit(trim($this->html)."\n\n");
@@ -130,6 +130,16 @@ protected function parseHtml(): DOMDocument
     }
 }
 
+class RenderedMainNavigationMenu extends RenderedNavigationMenu
+{
+    protected const TYPE = MainNavigationMenu::class;
+}
+
+class RenderedDocumentationSidebarMenu extends RenderedNavigationMenu
+{
+    protected const TYPE = DocumentationSidebar::class;
+}
+
 class TestKernel extends HydeKernel
 {
     protected ?RouteCollection $mockRoutes = null;

From 03e08c37ef5d4d9c36d71ee1396757046b25816d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:55:38 +0100
Subject: [PATCH 0974/4023] Assert has element identifiers

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 59634351a97..a8fdeac5f7e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -42,12 +42,12 @@ protected function setUp(): void
 
     public function testMainNavigationMenu()
     {
-        $this->menu()->assertTrue();
+        $this->menu()->assertHasId('main-navigation');
     }
 
     public function testDocumentationSidebarMenu()
     {
-        $this->sidebar()->assertTrue();
+        $this->sidebar()->assertHasId('sidebar');
     }
 
     protected function withPages(array $pages): static
@@ -110,6 +110,16 @@ public function assertTrue(): void
         $this->test->assertTrue(true);
     }
 
+    public function assertHasId(string $id): static
+    {
+        $node = $this->ast->documentElement;
+
+        $this->test->assertTrue($node->hasAttribute('id'));
+        $this->test->assertSame($id, $node->getAttribute('id'));
+
+        return $this;
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {

From fc7743605fdaf29d5382098435668ebe822817ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:56:33 +0100
Subject: [PATCH 0975/4023] Introduce local variables

Just want cleaner diffs for now
---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index a8fdeac5f7e..f712bd1eae5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -42,12 +42,14 @@ protected function setUp(): void
 
     public function testMainNavigationMenu()
     {
-        $this->menu()->assertHasId('main-navigation');
+        $menu = $this->menu();
+        $menu->assertHasId('main-navigation');
     }
 
     public function testDocumentationSidebarMenu()
     {
-        $this->sidebar()->assertHasId('sidebar');
+        $sidebar = $this->sidebar();
+        $sidebar->assertHasId('sidebar');
     }
 
     protected function withPages(array $pages): static

From 6e48b26edf25665ef58799816fca1cc815151804 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 18:57:36 +0100
Subject: [PATCH 0976/4023] Formatting

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f712bd1eae5..140b1d90e2e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -43,12 +43,14 @@ protected function setUp(): void
     public function testMainNavigationMenu()
     {
         $menu = $this->menu();
+
         $menu->assertHasId('main-navigation');
     }
 
     public function testDocumentationSidebarMenu()
     {
         $sidebar = $this->sidebar();
+
         $sidebar->assertHasId('sidebar');
     }
 

From 9cdce01d825105ae661327729100a1f225667da6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:01:38 +0100
Subject: [PATCH 0977/4023] Remove now unused testing helper

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 140b1d90e2e..16b57d78324 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -109,11 +109,6 @@ public function __construct(NavigationHtmlLayoutsTest $test, string $html)
         $this->test->assertNotEmpty($this->html);
     }
 
-    public function assertTrue(): void
-    {
-        $this->test->assertTrue(true);
-    }
-
     public function assertHasId(string $id): static
     {
         $node = $this->ast->documentElement;

From a28f3d018469b7ea16180591bc089bacefce6be3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:02:41 +0100
Subject: [PATCH 0978/4023] Clean up test semantics

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php    | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 16b57d78324..b8881353401 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -42,16 +42,16 @@ protected function setUp(): void
 
     public function testMainNavigationMenu()
     {
-        $menu = $this->menu();
-
-        $menu->assertHasId('main-navigation');
+        $this->menu()
+            ->assertHasId('main-navigation')
+            ->finish();
     }
 
     public function testDocumentationSidebarMenu()
     {
-        $sidebar = $this->sidebar();
-
-        $sidebar->assertHasId('sidebar');
+        $this->sidebar()
+            ->assertHasId('sidebar')
+            ->finish();
     }
 
     protected function withPages(array $pages): static
@@ -109,6 +109,11 @@ public function __construct(NavigationHtmlLayoutsTest $test, string $html)
         $this->test->assertNotEmpty($this->html);
     }
 
+    public function finish(): void
+    {
+        // Empty method to provide cleaner diffs when using method chaining.
+    }
+
     public function assertHasId(string $id): static
     {
         $node = $this->ast->documentElement;

From 8a5e878bda9778f4bf1272d7e490d2814dbb1736 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:05:24 +0100
Subject: [PATCH 0979/4023] Assert has elements

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index b8881353401..46afbd8c372 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -51,6 +51,9 @@ public function testDocumentationSidebarMenu()
     {
         $this->sidebar()
             ->assertHasId('sidebar')
+            ->assertHasElement('sidebar-header')
+            ->assertHasElement('sidebar-navigation')
+            ->assertHasElement('sidebar-footer')
             ->finish();
     }
 
@@ -124,6 +127,13 @@ public function assertHasId(string $id): static
         return $this;
     }
 
+    public function assertHasElement(string $id): static
+    {
+        $this->test->assertNotNull($this->ast->getElementById($id), 'Element with ID "'.$id.'" not found in the HTML.');
+
+        return $this;
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {

From abcc389ce197c75a90d38ee5aa0d464a9fb4c62e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:09:03 +0100
Subject: [PATCH 0980/4023] Search for the element in the entire HTML

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 46afbd8c372..be9fec3d8b7 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -6,6 +6,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use DOMXPath;
 use Hyde\Hyde;
 use DOMDocument;
 use Hyde\Testing\TestCase;
@@ -129,7 +130,15 @@ public function assertHasId(string $id): static
 
     public function assertHasElement(string $id): static
     {
-        $this->test->assertNotNull($this->ast->getElementById($id), 'Element with ID "'.$id.'" not found in the HTML.');
+        $element = $this->ast->getElementById($id);
+
+        if ($element === null) {
+            // Search for the element in the entire HTML.
+            $xpath = new DOMXPath($this->ast);
+            $element = $xpath->query("//*[@id='$id']")->item(0);
+        }
+
+        $this->test->assertNotNull($element, 'Element with ID "'.$id.'" not found in the HTML.');
 
         return $this;
     }

From b4aed110d56aafc59741635f6a3f1d0cbe36071b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:12:43 +0100
Subject: [PATCH 0981/4023] Search for elements in class usages

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index be9fec3d8b7..1073f699f57 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -136,6 +136,11 @@ public function assertHasElement(string $id): static
             // Search for the element in the entire HTML.
             $xpath = new DOMXPath($this->ast);
             $element = $xpath->query("//*[@id='$id']")->item(0);
+
+            if ($element === null) {
+                // See if there is an element containing the ID as a class.
+                $element = $xpath->query("//*[contains(concat(' ', normalize-space(@class), ' '), ' $id ')]")->item(0);
+            }
         }
 
         $this->test->assertNotNull($element, 'Element with ID "'.$id.'" not found in the HTML.');

From 55074a3c3a9fffbd2d6884ac94492ca7b6c11167 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:13:41 +0100
Subject: [PATCH 0982/4023] Assert has more elements

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1073f699f57..9eea5633e02 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -45,6 +45,9 @@ public function testMainNavigationMenu()
     {
         $this->menu()
             ->assertHasId('main-navigation')
+            ->assertHasElement('theme-toggle-button')
+            ->assertHasElement('navigation-toggle-button')
+            ->assertHasElement('main-navigation-links')
             ->finish();
     }
 

From 1420268f0b134da3f15621639fadf941a12c4b9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:18:03 +0100
Subject: [PATCH 0983/4023] Assert has no pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php     | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 9eea5633e02..f7564cbb26c 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -48,6 +48,7 @@ public function testMainNavigationMenu()
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('navigation-toggle-button')
             ->assertHasElement('main-navigation-links')
+            ->assertHasNoPages()
             ->finish();
     }
 
@@ -58,6 +59,7 @@ public function testDocumentationSidebarMenu()
             ->assertHasElement('sidebar-header')
             ->assertHasElement('sidebar-navigation')
             ->assertHasElement('sidebar-footer')
+            ->assertHasNoPages()
             ->finish();
     }
 
@@ -151,6 +153,13 @@ public function assertHasElement(string $id): static
         return $this;
     }
 
+    public function assertHasNoPages(): static
+    {
+        $this->test->assertEmpty($this->getRenderedPages());
+
+        return $this;
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {
@@ -169,6 +178,13 @@ protected function parseHtml(): DOMDocument
 
         return $dom;
     }
+
+    protected function getRenderedPages(): array
+    {
+        // Todo
+
+        return [];
+    }
 }
 
 class RenderedMainNavigationMenu extends RenderedNavigationMenu

From ea0cbe0aa150fc6cbe154955d30097c4a48c3946 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:18:43 +0100
Subject: [PATCH 0984/4023] Convert concatenation to string interpolation and
 clean up quotes

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f7564cbb26c..4eaea8a57fb 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -148,7 +148,7 @@ public function assertHasElement(string $id): static
             }
         }
 
-        $this->test->assertNotNull($element, 'Element with ID "'.$id.'" not found in the HTML.');
+        $this->test->assertNotNull($element, "Element with ID '$id' not found in the HTML.");
 
         return $this;
     }

From 9af5c230241734f5b3e4fc2a9486d6405e24818c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:19:30 +0100
Subject: [PATCH 0985/4023] Remove possibly misguiding prefix

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 4eaea8a57fb..a555676cfaa 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -148,7 +148,7 @@ public function assertHasElement(string $id): static
             }
         }
 
-        $this->test->assertNotNull($element, "Element with ID '$id' not found in the HTML.");
+        $this->test->assertNotNull($element, "Element with '$id' not found in the HTML.");
 
         return $this;
     }

From 7aa6c89828e9a8f4d7f6577a674defb755230bda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:22:22 +0100
Subject: [PATCH 0986/4023] Assert has more elements

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index a555676cfaa..73b64e8f190 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -57,8 +57,11 @@ public function testDocumentationSidebarMenu()
         $this->sidebar()
             ->assertHasId('sidebar')
             ->assertHasElement('sidebar-header')
+            ->assertHasElement('sidebar-brand')
             ->assertHasElement('sidebar-navigation')
             ->assertHasElement('sidebar-footer')
+            ->assertHasElement('theme-toggle-button')
+            ->assertHasElement('sidebar-items')
             ->assertHasNoPages()
             ->finish();
     }

From 7ea52f4d89f6929499aa793cdfcb762472139ddb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:25:55 +0100
Subject: [PATCH 0987/4023] Get rendered pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php    | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 73b64e8f190..ad0b690814d 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -182,11 +182,24 @@ protected function parseHtml(): DOMDocument
         return $dom;
     }
 
+    /** @return array<string, string> */
     protected function getRenderedPages(): array
     {
-        // Todo
+        $containerNodeId = static::TYPE === MainNavigationMenu::class ? 'main-navigation-links' : 'sidebar-items';
 
-        return [];
+        $this->assertHasElement($containerNodeId);
+
+        $containerNode = $this->ast->getElementById($containerNodeId);
+
+        $links = $containerNode->getElementsByTagName('a');
+
+        $pages = [];
+
+        foreach ($links as $link) {
+            $pages[$link->getAttribute('href')] = $link->textContent;
+        }
+
+        return $pages;
     }
 }
 

From 594dc2b5fd4c8ff92d475872fb22e4edd1f8e41a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:26:48 +0100
Subject: [PATCH 0988/4023] Assert has page

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index ad0b690814d..1d3390dad8f 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -48,7 +48,7 @@ public function testMainNavigationMenu()
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('navigation-toggle-button')
             ->assertHasElement('main-navigation-links')
-            ->assertHasNoPages()
+            ->assertHasPages(['index.html' => 'Home'])
             ->finish();
     }
 
@@ -156,6 +156,15 @@ public function assertHasElement(string $id): static
         return $this;
     }
 
+    public function assertHasPages(array $pages): static
+    {
+        $renderedPages = $this->getRenderedPages();
+
+        $this->test->assertEquals($pages, $renderedPages);
+
+        return $this;
+    }
+
     public function assertHasNoPages(): static
     {
         $this->test->assertEmpty($this->getRenderedPages());

From 55b58d39a1c5c9abd9e83be7fe0dbfb2abcc29e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:28:55 +0100
Subject: [PATCH 0989/4023] Assert same

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1d3390dad8f..cd344cc36b0 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -160,7 +160,7 @@ public function assertHasPages(array $pages): static
     {
         $renderedPages = $this->getRenderedPages();
 
-        $this->test->assertEquals($pages, $renderedPages);
+        $this->test->assertSame($pages, $renderedPages);
 
         return $this;
     }

From 99dc501769d3d16d652a36210169204a87cdc3ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:31:30 +0100
Subject: [PATCH 0990/4023] Use no pages unless set in test

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index cd344cc36b0..86f1e08f074 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -48,7 +48,7 @@ public function testMainNavigationMenu()
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('navigation-toggle-button')
             ->assertHasElement('main-navigation-links')
-            ->assertHasPages(['index.html' => 'Home'])
+            ->assertHasNoPages()
             ->finish();
     }
 
@@ -73,11 +73,9 @@ protected function withPages(array $pages): static
         return $this;
     }
 
-    protected function menu(?array $withPages = null): RenderedMainNavigationMenu
+    protected function menu(array $withPages = []): RenderedMainNavigationMenu
     {
-        if ($withPages) {
-            $this->withPages($withPages);
-        }
+        $this->withPages($withPages);
 
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
         app()->instance('navigation.main', $menu);
@@ -85,11 +83,9 @@ protected function menu(?array $withPages = null): RenderedMainNavigationMenu
         return new RenderedMainNavigationMenu($this, $this->render('hyde::layouts.navigation'));
     }
 
-    protected function sidebar(?array $withPages = null): RenderedDocumentationSidebarMenu
+    protected function sidebar(array $withPages = []): RenderedDocumentationSidebarMenu
     {
-        if ($withPages) {
-            $this->withPages($withPages);
-        }
+        $this->withPages($withPages);
 
         $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
         app()->instance('navigation.sidebar', $menu);

From f7f4c991c6d67e95cb46c174f69f6ab236467dc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 19:36:32 +0100
Subject: [PATCH 0991/4023] Test navigation menu with pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 86f1e08f074..7463fefdec5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -9,8 +9,12 @@
 use DOMXPath;
 use Hyde\Hyde;
 use DOMDocument;
+use Hyde\Pages\HtmlPage;
+use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Str;
+use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Foundation\HydeKernel;
 use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
@@ -66,6 +70,27 @@ public function testDocumentationSidebarMenu()
             ->finish();
     }
 
+    public function testNavigationMenuWithPages()
+    {
+        $pages = [
+            new MarkdownPage('index'),
+            new MarkdownPage('404'),
+            new BladePage('about'),
+            new BladePage('hidden', ['navigation.hidden' => true]),
+            new InMemoryPage('custom', ['navigation.label' => 'Label']),
+            new HtmlPage('first', ['navigation.priority' => 1]),
+        ];
+
+        $this->menu($pages)
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'first.html' => 'First',
+                'about.html' => 'About',
+                'custom.html' => 'Label',
+            ])
+            ->finish();
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From a11d6b9a71e25eed90c586c1b1e6232f3e6ac8ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:00:24 +0100
Subject: [PATCH 0992/4023] Improve failure diff

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 7463fefdec5..72b584d6d7e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -181,7 +181,10 @@ public function assertHasPages(array $pages): static
     {
         $renderedPages = $this->getRenderedPages();
 
-        $this->test->assertSame($pages, $renderedPages);
+        $this->test->assertSame($pages, $renderedPages, sprintf('Rendered pages do not match expected pages: %s', json_encode([
+            'expected' => $pages,
+            'rendered' => $renderedPages,
+        ], JSON_PRETTY_PRINT)));
 
         return $this;
     }

From 2436f93245bbbebbbc6d7d707c4d4c882f3df410 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:04:19 +0100
Subject: [PATCH 0993/4023] Add from page wrapper

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php         | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 72b584d6d7e..a5f91da954e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -98,6 +98,13 @@ protected function withPages(array $pages): static
         return $this;
     }
 
+    protected function fromPage(string $mockedRoute): static
+    {
+        $this->mockCurrentPage($mockedRoute);
+
+        return $this;
+    }
+
     protected function menu(array $withPages = []): RenderedMainNavigationMenu
     {
         $this->withPages($withPages);

From dd52777761bbc7c453d06acf4203f8a94bf1cf2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:04:28 +0100
Subject: [PATCH 0994/4023] Test navigation menu from nested route

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index a5f91da954e..7531e57fd7c 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -91,6 +91,28 @@ public function testNavigationMenuWithPages()
             ->finish();
     }
 
+    public function testNavigationMenuFromNestedRoute()
+    {
+        $pages = [
+            new MarkdownPage('index'),
+            new MarkdownPage('404'),
+            new BladePage('about'),
+            new BladePage('hidden', ['navigation.hidden' => true]),
+            new InMemoryPage('custom', ['navigation.label' => 'Label']),
+            new HtmlPage('first', ['navigation.priority' => 1]),
+        ];
+
+        $this->fromPage('nested/page')
+            ->menu($pages)
+            ->assertHasPages([
+                '../index.html' => 'Home',
+                '../first.html' => 'First',
+                '../about.html' => 'About',
+                '../custom.html' => 'Label',
+            ])
+            ->finish();
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From 209b742cf08862cb8e0a6c5d7d140fbba4f4bb58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:09:04 +0100
Subject: [PATCH 0995/4023] Extract helper for repeated array

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 34 ++++++++-----------
 1 file changed, 14 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 7531e57fd7c..540fbc60767 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -72,16 +72,7 @@ public function testDocumentationSidebarMenu()
 
     public function testNavigationMenuWithPages()
     {
-        $pages = [
-            new MarkdownPage('index'),
-            new MarkdownPage('404'),
-            new BladePage('about'),
-            new BladePage('hidden', ['navigation.hidden' => true]),
-            new InMemoryPage('custom', ['navigation.label' => 'Label']),
-            new HtmlPage('first', ['navigation.priority' => 1]),
-        ];
-
-        $this->menu($pages)
+        $this->menu($this->withExamplePages())
             ->assertHasPages([
                 'index.html' => 'Home',
                 'first.html' => 'First',
@@ -93,17 +84,8 @@ public function testNavigationMenuWithPages()
 
     public function testNavigationMenuFromNestedRoute()
     {
-        $pages = [
-            new MarkdownPage('index'),
-            new MarkdownPage('404'),
-            new BladePage('about'),
-            new BladePage('hidden', ['navigation.hidden' => true]),
-            new InMemoryPage('custom', ['navigation.label' => 'Label']),
-            new HtmlPage('first', ['navigation.priority' => 1]),
-        ];
-
         $this->fromPage('nested/page')
-            ->menu($pages)
+            ->menu($this->withExamplePages())
             ->assertHasPages([
                 '../index.html' => 'Home',
                 '../first.html' => 'First',
@@ -151,6 +133,18 @@ protected function render(string $view): string
     {
         return view($view)->render();
     }
+
+    protected function withExamplePages(): array
+    {
+        return [
+            new MarkdownPage('index'),
+            new MarkdownPage('404'),
+            new BladePage('about'),
+            new BladePage('hidden', ['navigation.hidden' => true]),
+            new InMemoryPage('custom', ['navigation.label' => 'Label']),
+            new HtmlPage('first', ['navigation.priority' => 1]),
+        ];
+    }
 }
 
 abstract class RenderedNavigationMenu

From 2c420ce88bf4e176d3bb7466b373834884a68774 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:10:03 +0100
Subject: [PATCH 0996/4023] Arrow function experiment

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 540fbc60767..c5562887d37 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -97,9 +97,7 @@ public function testNavigationMenuFromNestedRoute()
 
     protected function withPages(array $pages): static
     {
-        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
-
-        return $this;
+        return tap($this, fn () => $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute())));
     }
 
     protected function fromPage(string $mockedRoute): static

From 486ac395d8339ae6024496b44471a618afac6fb1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:10:06 +0100
Subject: [PATCH 0997/4023] Revert "Arrow function experiment"

This reverts commit 2c420ce88bf4e176d3bb7466b373834884a68774.
---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index c5562887d37..540fbc60767 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -97,7 +97,9 @@ public function testNavigationMenuFromNestedRoute()
 
     protected function withPages(array $pages): static
     {
-        return tap($this, fn () => $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute())));
+        $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));
+
+        return $this;
     }
 
     protected function fromPage(string $mockedRoute): static

From 9156dedc1e0e4d0073b4e5b9492244dc4e07f756 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:10:46 +0100
Subject: [PATCH 0998/4023] Inline variables

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 540fbc60767..25e648c85bd 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -113,8 +113,7 @@ protected function menu(array $withPages = []): RenderedMainNavigationMenu
     {
         $this->withPages($withPages);
 
-        $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
-        app()->instance('navigation.main', $menu);
+        app()->instance('navigation.main', NavigationMenuGenerator::handle(MainNavigationMenu::class));
 
         return new RenderedMainNavigationMenu($this, $this->render('hyde::layouts.navigation'));
     }
@@ -123,8 +122,7 @@ protected function sidebar(array $withPages = []): RenderedDocumentationSidebarM
     {
         $this->withPages($withPages);
 
-        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        app()->instance('navigation.sidebar', $menu);
+        app()->instance('navigation.sidebar', NavigationMenuGenerator::handle(DocumentationSidebar::class));
 
         return new RenderedDocumentationSidebarMenu($this, $this->render('hyde::components.docs.sidebar'));
     }

From d2a14cac3b2c03c1b17d91e03bde10f129aae017 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:17:35 +0100
Subject: [PATCH 0999/4023] Add testing helper to use subdirectories as
 dropdowns

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php         | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 25e648c85bd..1cc3319b45e 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -127,6 +127,13 @@ protected function sidebar(array $withPages = []): RenderedDocumentationSidebarM
         return new RenderedDocumentationSidebarMenu($this, $this->render('hyde::components.docs.sidebar'));
     }
 
+    protected function useSubdirectoriesAsDropdowns(): static
+    {
+        config(['hyde.navigation.subdirectories' => 'dropdown']);
+
+        return $this;
+    }
+
     protected function render(string $view): string
     {
         return view($view)->render();

From 37e39bae838ab231db0a83e7baece7b9ddf6af7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:19:50 +0100
Subject: [PATCH 1000/4023] Assert negative element state

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1cc3319b45e..ba1cb62acb5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -52,6 +52,8 @@ public function testMainNavigationMenu()
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('navigation-toggle-button')
             ->assertHasElement('main-navigation-links')
+            ->assertDoesNotHaveElement('dropdown-button')
+            ->assertDoesNotHaveElement('dropdown')
             ->assertHasNoPages()
             ->finish();
     }
@@ -205,6 +207,26 @@ public function assertHasElement(string $id): static
         return $this;
     }
 
+    public function assertDoesNotHaveElement(string $id): static
+    {
+        $element = $this->ast->getElementById($id);
+
+        if ($element === null) {
+            // Search for the element in the entire HTML.
+            $xpath = new DOMXPath($this->ast);
+            $element = $xpath->query("//*[@id='$id']")->item(0);
+
+            if ($element === null) {
+                // See if there is an element containing the ID as a class.
+                $element = $xpath->query("//*[contains(concat(' ', normalize-space(@class), ' '), ' $id ')]")->item(0);
+            }
+        }
+
+        $this->test->assertNull($element, "Element with '$id' found in the HTML.");
+
+        return $this;
+    }
+
     public function assertHasPages(array $pages): static
     {
         $renderedPages = $this->getRenderedPages();

From dc11ccc06221225a900282e5be1ea1eeee03df9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:22:16 +0100
Subject: [PATCH 1001/4023] Update assertions

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index ba1cb62acb5..9611dc2bfe4 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -52,8 +52,9 @@ public function testMainNavigationMenu()
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('navigation-toggle-button')
             ->assertHasElement('main-navigation-links')
-            ->assertDoesNotHaveElement('dropdown-button')
             ->assertDoesNotHaveElement('dropdown')
+            ->assertDoesNotHaveElement('dropdown-items')
+            ->assertDoesNotHaveElement('dropdown-button')
             ->assertHasNoPages()
             ->finish();
     }

From cfb5aa0de5592bcecef171ff98619072de795ae6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Mar 2024 20:22:25 +0100
Subject: [PATCH 1002/4023] Test navigation menu with dropdown pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 9611dc2bfe4..1ecc5467cac 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -98,6 +98,25 @@ public function testNavigationMenuFromNestedRoute()
             ->finish();
     }
 
+    public function testNavigationMenuWithDropdownPages()
+    {
+        $this->useSubdirectoriesAsDropdowns()
+           ->menu([
+               new MarkdownPage('index'),
+               new MarkdownPage('foo/bar'),
+               new MarkdownPage('foo/baz'),
+           ])
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertHasElement('dropdown')
+            ->assertHasElement('dropdown-items')
+            ->assertHasElement('dropdown-button')
+            ->finish();
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From 60bee64f49e2b464ff1c83111b9acec90b66e4dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:17:28 +0100
Subject: [PATCH 1003/4023] Add high level textual visual testing

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 65 +++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1ecc5467cac..8ea227431f0 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -114,6 +114,14 @@ public function testNavigationMenuWithDropdownPages()
             ->assertHasElement('dropdown')
             ->assertHasElement('dropdown-items')
             ->assertHasElement('dropdown-button')
+            ->assertItemsLookLike(<<<'HTML'
+- Home
+- Foo
+    - Bar
+    - Baz
+HTML
+
+            )
             ->finish();
     }
 
@@ -266,6 +274,30 @@ public function assertHasNoPages(): static
         return $this;
     }
 
+    public function assertLooksLike(string $expected, bool $skipHeaderRow = false): static
+    {
+        $actual = $this->makeTextRepresentation();
+
+        if ($skipHeaderRow) {
+            $actual = trim(Str::after($actual, "\n"));
+        }
+        // If expected omitted dashes, remove them from actual
+        if (! str_contains($expected, '- ')) {
+            $actual = str_replace('- ', '', $actual);
+        }
+        // If expected uses 4 spaces, replace with 2 spaces
+        $expected = str_replace('    ', '  ', $expected);
+
+        $this->test->assertSame($expected, $actual, sprintf("Actual HTML does not match expected text:\nExpected:\n%s\nActual:\n%s", $expected, $actual));
+
+        return $this;
+    }
+
+    public function assertItemsLookLike(string $expected): static
+    {
+        return $this->assertLooksLike($expected, true);
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {
@@ -304,6 +336,39 @@ protected function getRenderedPages(): array
 
         return $pages;
     }
+
+    protected function makeTextRepresentation(): string
+    {
+        $html = str_replace(['<title>Open Menu</title>', '<title>Close Menu</title>'], ['Toggle menu', ''], $this->html);
+        $html = str_replace(['<li', '</li>'], ['<li-keep', '</li-keep>'], $html);
+        $html = str_replace(['<ul', '</ul>'], ['<ul-keep', '</ul-keep>'], $html);
+        $html = strip_tags($html, '<li-keep><ul-keep>');
+        $html = str_replace(['<li-keep', '</li-keep>'], ['<li', '</li>'], $html);
+        $html = str_replace(['<ul-keep', '</ul-keep>'], ['<ul', '</ul>'], $html);
+        $html = preg_replace('/<li[^>]*>/', '<li>', $html);
+        $html = preg_replace('/<ul[^>]*>/', '<ul>', $html);
+        $html = str_replace(['</li>'], '<br>', $html);
+        $html = preg_replace('/\s+/', '', $html);
+        $html = str_replace('<br>', "\n", $html);
+        $html = str_replace('<li>', '- ', $html);
+        $html = Str::replaceFirst('<ul>', "\n", $html);
+
+        // Indent each line within remaining uls
+        $innerUlCount = substr_count($html, '<ul>');
+        foreach (range(1, $innerUlCount) as $i) {
+            $html = Str::replaceFirst('</ul>', '</ul-first>', $html);
+            $innerUlContent = Str::between($html, '<ul>', '</ul-first>');
+            $id = md5($innerUlContent.$i);
+            $html = Str::replaceFirst($innerUlContent, $id, $html);
+            $innerUlContent = trim(str_replace("\n", "\n  ", $innerUlContent));
+
+            $html = str_replace('<ul>'.$id.'</ul-first>', "\n  ".$innerUlContent, $html);
+        }
+
+        $html = Str::replaceLast('</ul>', '', $html);
+
+        return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
+    }
 }
 
 class RenderedMainNavigationMenu extends RenderedNavigationMenu

From 0f9daf5763452b7803ea2565f89710cde863ef28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:20:41 +0100
Subject: [PATCH 1004/4023] Nicer formatting

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 8ea227431f0..f4600466b89 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -115,14 +115,12 @@ public function testNavigationMenuWithDropdownPages()
             ->assertHasElement('dropdown-items')
             ->assertHasElement('dropdown-button')
             ->assertItemsLookLike(<<<'HTML'
-- Home
-- Foo
-    - Bar
-    - Baz
-HTML
-
-            )
-            ->finish();
+                - Home
+                - Foo
+                    - Bar
+                    - Baz
+                HTML
+            );
     }
 
     protected function withPages(array $pages): static

From 18c322843489639c639de72f426b84b14d2b6c9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:23:00 +0100
Subject: [PATCH 1005/4023] Formatting

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 29 +++++++++++++++----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f4600466b89..81398b9bec7 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -24,6 +24,25 @@
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
+use function app;
+use function md5;
+use function view;
+use function trim;
+use function range;
+use function config;
+use function collect;
+use function sprintf;
+use function explode;
+use function implode;
+use function array_map;
+use function strip_tags;
+use function json_encode;
+use function str_replace;
+use function preg_replace;
+use function substr_count;
+use function class_basename;
+use function file_put_contents;
+
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
  *
@@ -101,11 +120,11 @@ public function testNavigationMenuFromNestedRoute()
     public function testNavigationMenuWithDropdownPages()
     {
         $this->useSubdirectoriesAsDropdowns()
-           ->menu([
-               new MarkdownPage('index'),
-               new MarkdownPage('foo/bar'),
-               new MarkdownPage('foo/baz'),
-           ])
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
             ->assertHasPages([
                 'index.html' => 'Home',
                 'foo/bar.html' => 'Bar',

From 7bb7f15e51371c2bc62e91dfde91a26849f2aa88 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:25:44 +0100
Subject: [PATCH 1006/4023] Add conditional

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php   | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 81398b9bec7..ea09120fd29 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -372,14 +372,16 @@ protected function makeTextRepresentation(): string
 
         // Indent each line within remaining uls
         $innerUlCount = substr_count($html, '<ul>');
-        foreach (range(1, $innerUlCount) as $i) {
-            $html = Str::replaceFirst('</ul>', '</ul-first>', $html);
-            $innerUlContent = Str::between($html, '<ul>', '</ul-first>');
-            $id = md5($innerUlContent.$i);
-            $html = Str::replaceFirst($innerUlContent, $id, $html);
-            $innerUlContent = trim(str_replace("\n", "\n  ", $innerUlContent));
-
-            $html = str_replace('<ul>'.$id.'</ul-first>', "\n  ".$innerUlContent, $html);
+        if ($innerUlCount >= 1) {
+            foreach (range(1, $innerUlCount) as $i) {
+                $html = Str::replaceFirst('</ul>', '</ul-first>', $html);
+                $innerUlContent = Str::between($html, '<ul>', '</ul-first>');
+                $id = md5($innerUlContent.$i);
+                $html = Str::replaceFirst($innerUlContent, $id, $html);
+                $innerUlContent = trim(str_replace("\n", "\n  ", $innerUlContent));
+
+                $html = str_replace('<ul>'.$id.'</ul-first>', "\n  ".$innerUlContent, $html);
+            }
         }
 
         $html = Str::replaceLast('</ul>', '', $html);

From 8424fc93ea67f60a7942283bf37c1d37de738bd3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:25:53 +0100
Subject: [PATCH 1007/4023] Add visual assertion

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index ea09120fd29..27216ae29c7 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -114,7 +114,13 @@ public function testNavigationMenuFromNestedRoute()
                 '../about.html' => 'About',
                 '../custom.html' => 'Label',
             ])
-            ->finish();
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - First
+                - About
+                - Label
+                HTML
+            );
     }
 
     public function testNavigationMenuWithDropdownPages()

From 5e9bcc22d32c9115b3b18b445f6707c3bd795ecb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:29:23 +0100
Subject: [PATCH 1008/4023] Refactor helper to be more generic

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 27216ae29c7..8d283481221 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -125,7 +125,7 @@ public function testNavigationMenuFromNestedRoute()
 
     public function testNavigationMenuWithDropdownPages()
     {
-        $this->useSubdirectoriesAsDropdowns()
+        $this->useSubdirectoryConfig('dropdown')
             ->menu([
                 new MarkdownPage('index'),
                 new MarkdownPage('foo/bar'),
@@ -180,9 +180,9 @@ protected function sidebar(array $withPages = []): RenderedDocumentationSidebarM
         return new RenderedDocumentationSidebarMenu($this, $this->render('hyde::components.docs.sidebar'));
     }
 
-    protected function useSubdirectoriesAsDropdowns(): static
+    protected function useSubdirectoryConfig(string $option): static
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectories' => $option]);
 
         return $this;
     }

From 9e0d31836ba1fa9694684c2ed8fed6c01edec3c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:31:01 +0100
Subject: [PATCH 1009/4023] Test navigation menu with flat subdirectory pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 8d283481221..5c95c16508d 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -148,6 +148,30 @@ public function testNavigationMenuWithDropdownPages()
             );
     }
 
+    public function testNavigationMenuWithFlatSubdirectoryPages()
+    {
+        $this->useSubdirectoryConfig('flat')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertDoesNotHaveElement('dropdown')
+            ->assertDoesNotHaveElement('dropdown-items')
+            ->assertDoesNotHaveElement('dropdown-button')
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From 6ba350d04462bc56ad0485aca7b3512f18807f24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:33:27 +0100
Subject: [PATCH 1010/4023] Extract fluent assertion helpers

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 5c95c16508d..0b9b2a6ecd5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -136,9 +136,7 @@ public function testNavigationMenuWithDropdownPages()
                 'foo/bar.html' => 'Bar',
                 'foo/baz.html' => 'Baz',
             ])
-            ->assertHasElement('dropdown')
-            ->assertHasElement('dropdown-items')
-            ->assertHasElement('dropdown-button')
+            ->assertHasDropdowns()
             ->assertItemsLookLike(<<<'HTML'
                 - Home
                 - Foo
@@ -161,9 +159,7 @@ public function testNavigationMenuWithFlatSubdirectoryPages()
                 'foo/bar.html' => 'Bar',
                 'foo/baz.html' => 'Baz',
             ])
-            ->assertDoesNotHaveElement('dropdown')
-            ->assertDoesNotHaveElement('dropdown-items')
-            ->assertDoesNotHaveElement('dropdown-button')
+            ->assertDoesNotHaveDropdowns()
             ->assertItemsLookLike(<<<'HTML'
                 - Home
                 - Bar
@@ -345,6 +341,20 @@ public function assertItemsLookLike(string $expected): static
         return $this->assertLooksLike($expected, true);
     }
 
+    public function assertHasDropdowns(): static
+    {
+        return $this->assertHasElement('dropdown')
+            ->assertHasElement('dropdown-items')
+            ->assertHasElement('dropdown-button');
+    }
+
+    public function assertDoesNotHaveDropdowns(): static
+    {
+        return $this->assertDoesNotHaveElement('dropdown')
+            ->assertDoesNotHaveElement('dropdown-items')
+            ->assertDoesNotHaveElement('dropdown-button');
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {

From 67cec4ae5b94b9ef3efd8ab98de30611abafbe0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:36:58 +0100
Subject: [PATCH 1011/4023] Move up assertions

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 0b9b2a6ecd5..6d7bf81477a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -131,12 +131,12 @@ public function testNavigationMenuWithDropdownPages()
                 new MarkdownPage('foo/bar'),
                 new MarkdownPage('foo/baz'),
             ])
+            ->assertHasDropdowns()
             ->assertHasPages([
                 'index.html' => 'Home',
                 'foo/bar.html' => 'Bar',
                 'foo/baz.html' => 'Baz',
             ])
-            ->assertHasDropdowns()
             ->assertItemsLookLike(<<<'HTML'
                 - Home
                 - Foo
@@ -154,12 +154,12 @@ public function testNavigationMenuWithFlatSubdirectoryPages()
                 new MarkdownPage('foo/bar'),
                 new MarkdownPage('foo/baz'),
             ])
+            ->assertDoesNotHaveDropdowns()
             ->assertHasPages([
                 'index.html' => 'Home',
                 'foo/bar.html' => 'Bar',
                 'foo/baz.html' => 'Baz',
             ])
-            ->assertDoesNotHaveDropdowns()
             ->assertItemsLookLike(<<<'HTML'
                 - Home
                 - Bar

From 5c14544e83266352946628e0fff93c4cf3197fe5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:38:06 +0100
Subject: [PATCH 1012/4023] Break out method chains in helper

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php     | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 6d7bf81477a..86359ab01d9 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -343,16 +343,20 @@ public function assertItemsLookLike(string $expected): static
 
     public function assertHasDropdowns(): static
     {
-        return $this->assertHasElement('dropdown')
-            ->assertHasElement('dropdown-items')
-            ->assertHasElement('dropdown-button');
+        $this->assertHasElement('dropdown');
+        $this->assertHasElement('dropdown-items');
+        $this->assertHasElement('dropdown-button');
+
+        return $this;
     }
 
     public function assertDoesNotHaveDropdowns(): static
     {
-        return $this->assertDoesNotHaveElement('dropdown')
-            ->assertDoesNotHaveElement('dropdown-items')
-            ->assertDoesNotHaveElement('dropdown-button');
+        $this->assertDoesNotHaveElement('dropdown');
+        $this->assertDoesNotHaveElement('dropdown-items');
+        $this->assertDoesNotHaveElement('dropdown-button');
+
+        return $this;
     }
 
     #[NoReturn]

From e1f37ee84fe84221908a8eaf7c51aae3e3cd4f25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 10:55:31 +0100
Subject: [PATCH 1013/4023] Add helper to assert the expected dropdown
 structure

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 30 +++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 86359ab01d9..6ae0bff989c 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -131,7 +131,7 @@ public function testNavigationMenuWithDropdownPages()
                 new MarkdownPage('foo/bar'),
                 new MarkdownPage('foo/baz'),
             ])
-            ->assertHasDropdowns()
+            ->assertHasDropdowns(['Foo'])
             ->assertHasPages([
                 'index.html' => 'Home',
                 'foo/bar.html' => 'Bar',
@@ -341,12 +341,38 @@ public function assertItemsLookLike(string $expected): static
         return $this->assertLooksLike($expected, true);
     }
 
-    public function assertHasDropdowns(): static
+    public function assertHasDropdowns(?array $dropdownLabels = null): static
     {
         $this->assertHasElement('dropdown');
         $this->assertHasElement('dropdown-items');
         $this->assertHasElement('dropdown-button');
 
+        if ($dropdownLabels) {
+            // Assert contains only the same count of dropdown labels
+
+            // Get all ul.dropdown-items elements
+            $xpath = new DOMXPath($this->ast);
+            $dropdownItems = $xpath->query('//ul[contains(concat(" ", normalize-space(@class), " "), " dropdown-items ")]');
+
+            $foundLabels = [];
+
+            foreach ($dropdownItems as $dropdownItem) {
+                // Get the preceding sibling button element
+                $button = $xpath->query('../preceding-sibling::button', $dropdownItem)->item(0);
+
+                // Get the text content of the button (label)
+                $label = $button->textContent;
+
+                // Trim and add the label to the array
+                $foundLabels[] = trim($label);
+            }
+
+            $this->test->assertSame($dropdownLabels, $foundLabels, sprintf('Rendered dropdown labels do not match expected labels: %s', json_encode([
+                'expected' => $dropdownLabels,
+                'rendered' => $foundLabels,
+            ], JSON_PRETTY_PRINT)));
+        }
+
         return $this;
     }
 

From 3c7ce81dc5f1131633ac573232518e2c6296c613 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 11:01:59 +0100
Subject: [PATCH 1014/4023] Refactor helper and allow expected values

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 30 +++++++++++++------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 6ae0bff989c..bd4a096fa28 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -36,10 +36,13 @@
 use function implode;
 use function array_map;
 use function strip_tags;
+use function array_keys;
 use function json_encode;
 use function str_replace;
 use function preg_replace;
 use function substr_count;
+use function array_filter;
+use function array_values;
 use function class_basename;
 use function file_put_contents;
 
@@ -131,7 +134,7 @@ public function testNavigationMenuWithDropdownPages()
                 new MarkdownPage('foo/bar'),
                 new MarkdownPage('foo/baz'),
             ])
-            ->assertHasDropdowns(['Foo'])
+            ->assertHasDropdowns(['Foo' => ['Bar', 'Baz']])
             ->assertHasPages([
                 'index.html' => 'Home',
                 'foo/bar.html' => 'Bar',
@@ -341,35 +344,44 @@ public function assertItemsLookLike(string $expected): static
         return $this->assertLooksLike($expected, true);
     }
 
-    public function assertHasDropdowns(?array $dropdownLabels = null): static
+    public function assertHasDropdowns(?array $expected = null): static
     {
         $this->assertHasElement('dropdown');
         $this->assertHasElement('dropdown-items');
         $this->assertHasElement('dropdown-button');
 
-        if ($dropdownLabels) {
+        if ($expected) {
             // Assert contains only the same count of dropdown labels
 
             // Get all ul.dropdown-items elements
             $xpath = new DOMXPath($this->ast);
             $dropdownItems = $xpath->query('//ul[contains(concat(" ", normalize-space(@class), " "), " dropdown-items ")]');
 
-            $foundLabels = [];
+            /** @var array<string, array<string> $actual */
+            $actual = [];
 
             foreach ($dropdownItems as $dropdownItem) {
                 // Get the preceding sibling button element
                 $button = $xpath->query('../preceding-sibling::button', $dropdownItem)->item(0);
 
                 // Get the text content of the button (label)
-                $label = $button->textContent;
+                $label = trim($button->textContent);
+
+                $innerText = $dropdownItem->textContent;
+                $children = array_values(array_filter(array_map('trim', explode("\n", $innerText))));
 
                 // Trim and add the label to the array
-                $foundLabels[] = trim($label);
+                $actual[$label] = $children;
+            }
+
+            // If expected is a list array then remove values from actual
+            if (array_keys($expected) === range(0, count($expected) - 1)) {
+                $actual = array_keys($actual);
             }
 
-            $this->test->assertSame($dropdownLabels, $foundLabels, sprintf('Rendered dropdown labels do not match expected labels: %s', json_encode([
-                'expected' => $dropdownLabels,
-                'rendered' => $foundLabels,
+            $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', json_encode([
+                'expected' => $expected,
+                'rendered' => $actual,
             ], JSON_PRETTY_PRINT)));
         }
 

From 3aaef2dbec6c8e14f40e664adf03bc0456d001f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 11:02:29 +0100
Subject: [PATCH 1015/4023] Use simpler array generics comparison

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index bd4a096fa28..1a0afdc7609 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -375,7 +375,7 @@ public function assertHasDropdowns(?array $expected = null): static
             }
 
             // If expected is a list array then remove values from actual
-            if (array_keys($expected) === range(0, count($expected) - 1)) {
+            if (array_values($expected) === $expected) {
                 $actual = array_keys($actual);
             }
 

From d72efe5908f4d572443f64318a94e812093feb88 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 11:03:44 +0100
Subject: [PATCH 1016/4023] Clean up testing helper code

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1a0afdc7609..3c9236f4a7d 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -351,9 +351,6 @@ public function assertHasDropdowns(?array $expected = null): static
         $this->assertHasElement('dropdown-button');
 
         if ($expected) {
-            // Assert contains only the same count of dropdown labels
-
-            // Get all ul.dropdown-items elements
             $xpath = new DOMXPath($this->ast);
             $dropdownItems = $xpath->query('//ul[contains(concat(" ", normalize-space(@class), " "), " dropdown-items ")]');
 
@@ -361,20 +358,16 @@ public function assertHasDropdowns(?array $expected = null): static
             $actual = [];
 
             foreach ($dropdownItems as $dropdownItem) {
-                // Get the preceding sibling button element
                 $button = $xpath->query('../preceding-sibling::button', $dropdownItem)->item(0);
 
-                // Get the text content of the button (label)
                 $label = trim($button->textContent);
 
-                $innerText = $dropdownItem->textContent;
-                $children = array_values(array_filter(array_map('trim', explode("\n", $innerText))));
+                $children = array_values(array_filter(array_map('trim', explode("\n", $dropdownItem->textContent))));
 
-                // Trim and add the label to the array
                 $actual[$label] = $children;
             }
 
-            // If expected is a list array then remove values from actual
+            // If expected is a list array, then remove values from actual
             if (array_values($expected) === $expected) {
                 $actual = array_keys($actual);
             }

From b5e99c8b05030c4fef76f0212d1d7ef84833809c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 12:02:48 +0100
Subject: [PATCH 1017/4023] Clean up test code

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 3c9236f4a7d..f58692eadc0 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -445,17 +445,17 @@ protected function makeTextRepresentation(): string
         $html = str_replace('<li>', '- ', $html);
         $html = Str::replaceFirst('<ul>', "\n", $html);
 
-        // Indent each line within remaining uls
         $innerUlCount = substr_count($html, '<ul>');
         if ($innerUlCount >= 1) {
-            foreach (range(1, $innerUlCount) as $i) {
+            // Indent each line within the remaining UL elements
+            foreach (range(1, $innerUlCount) as $item) {
                 $html = Str::replaceFirst('</ul>', '</ul-first>', $html);
                 $innerUlContent = Str::between($html, '<ul>', '</ul-first>');
-                $id = md5($innerUlContent.$i);
+                $id = md5("$innerUlContent-$item");
                 $html = Str::replaceFirst($innerUlContent, $id, $html);
                 $innerUlContent = trim(str_replace("\n", "\n  ", $innerUlContent));
 
-                $html = str_replace('<ul>'.$id.'</ul-first>', "\n  ".$innerUlContent, $html);
+                $html = str_replace("<ul>$id</ul-first>", "\n  $innerUlContent", $html);
             }
         }
 

From a9370d605bd59a3c85a2faf328242d07fc258ef6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 12:18:39 +0100
Subject: [PATCH 1018/4023] Test navigation menu with hidden subdirectory pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index f58692eadc0..39b8d4afbff 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -171,6 +171,24 @@ public function testNavigationMenuWithFlatSubdirectoryPages()
             );
     }
 
+    public function testNavigationMenuWithHiddenSubdirectoryPages()
+    {
+        $this->useSubdirectoryConfig('hidden')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertDoesNotHaveDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                HTML
+            );
+    }
+
     protected function withPages(array $pages): static
     {
         $this->kernel->setRoutes(collect($pages)->map(fn (HydePage $page) => $page->getRoute()));

From bd7a583b42fc50eeb4f96487bfdb9eb6a9697875 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 12:19:00 +0100
Subject: [PATCH 1019/4023] Convert to string literal

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 39b8d4afbff..ee8bb704682 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -183,10 +183,7 @@ public function testNavigationMenuWithHiddenSubdirectoryPages()
             ->assertHasPages([
                 'index.html' => 'Home',
             ])
-            ->assertItemsLookLike(<<<'HTML'
-                - Home
-                HTML
-            );
+            ->assertItemsLookLike('- Home');
     }
 
     protected function withPages(array $pages): static

From 8dbd62277ae3cef7d2e966d513ce2e0096af9572 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:38:51 +0100
Subject: [PATCH 1020/4023] Add edge case tests

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 155 ++++++++++++++++++
 1 file changed, 155 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index ee8bb704682..d309c22a84a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -193,6 +193,161 @@ protected function withPages(array $pages): static
         return $this;
     }
 
+    public function testNavigationMenuWithFlatSubdirectoryPagesAndMatchingSubdirectoryPage()
+    {
+        $this->useSubdirectoryConfig('flat')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertDoesNotHaveDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo.html' => 'Foo',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
+    public function testNavigationMenuWithFlatSubdirectoryPagesAndMatchingSubdirectoryIndexPage()
+    {
+        $this->useSubdirectoryConfig('flat')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo/index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertDoesNotHaveDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/index.html' => 'Foo',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
+    public function testNavigationMenuWithFlatSubdirectoryPagesAndMatchingSubdirectoryAndIndexPage()
+    {
+        $this->useSubdirectoryConfig('flat')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo'),
+                new MarkdownPage('foo/index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertDoesNotHaveDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo.html' => 'Foo',
+                'foo/index.html' => 'Foo',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                - Foo
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
+    public function testNavigationMenuWithDropdownSubdirectoryPagesAndMatchingSubdirectoryPage()
+    {
+        $this->useSubdirectoryConfig('dropdown')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertHasDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                    - Bar
+                    - Baz
+                HTML
+            );
+    }
+
+    public function testNavigationMenuWithDropdownSubdirectoryPagesAndMatchingSubdirectoryIndexPage()
+    {
+        $this->useSubdirectoryConfig('dropdown')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo/index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertHasDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/index.html' => 'Foo',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                    - Foo
+                    - Bar
+                    - Baz
+                HTML
+            );
+    }
+
+    public function testNavigationMenuWithDropdownSubdirectoryPagesAndMatchingSubdirectoryAndIndexPage()
+    {
+        $this->useSubdirectoryConfig('dropdown')
+            ->menu([
+                new MarkdownPage('index'),
+                new MarkdownPage('foo'),
+                new MarkdownPage('foo/index'),
+                new MarkdownPage('foo/bar'),
+                new MarkdownPage('foo/baz'),
+            ])
+            ->assertHasDropdowns()
+            ->assertHasPages([
+                'index.html' => 'Home',
+                'foo/index.html' => 'Foo',
+                'foo/bar.html' => 'Bar',
+                'foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Home
+                - Foo
+                    - Foo
+                    - Bar
+                    - Baz
+                HTML
+            );
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);

From f646820b28bd91f4716f35410fdc87f734f1959d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:41:25 +0100
Subject: [PATCH 1021/4023] Clean up test endings

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php       | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index d309c22a84a..ee6cf6ca667 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -77,8 +77,7 @@ public function testMainNavigationMenu()
             ->assertDoesNotHaveElement('dropdown')
             ->assertDoesNotHaveElement('dropdown-items')
             ->assertDoesNotHaveElement('dropdown-button')
-            ->assertHasNoPages()
-            ->finish();
+            ->assertHasNoPages();
     }
 
     public function testDocumentationSidebarMenu()
@@ -91,8 +90,7 @@ public function testDocumentationSidebarMenu()
             ->assertHasElement('sidebar-footer')
             ->assertHasElement('theme-toggle-button')
             ->assertHasElement('sidebar-items')
-            ->assertHasNoPages()
-            ->finish();
+            ->assertHasNoPages();
     }
 
     public function testNavigationMenuWithPages()
@@ -103,8 +101,7 @@ public function testNavigationMenuWithPages()
                 'first.html' => 'First',
                 'about.html' => 'About',
                 'custom.html' => 'Label',
-            ])
-            ->finish();
+            ]);
     }
 
     public function testNavigationMenuFromNestedRoute()

From 06d282abace8e58e8a4339e2f54d017ea933c20b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:46:13 +0100
Subject: [PATCH 1022/4023] Unescape slashes for testing dump

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index ee6cf6ca667..8f7e783754c 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -475,7 +475,7 @@ public function assertHasPages(array $pages): static
         $this->test->assertSame($pages, $renderedPages, sprintf('Rendered pages do not match expected pages: %s', json_encode([
             'expected' => $pages,
             'rendered' => $renderedPages,
-        ], JSON_PRETTY_PRINT)));
+        ], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)));
 
         return $this;
     }
@@ -542,7 +542,7 @@ public function assertHasDropdowns(?array $expected = null): static
             $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', json_encode([
                 'expected' => $expected,
                 'rendered' => $actual,
-            ], JSON_PRETTY_PRINT)));
+            ], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)));
         }
 
         return $this;

From 5c74c657f4d97ff71e6f29709edf371a9aa802d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:47:54 +0100
Subject: [PATCH 1023/4023] Trim text content

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 8f7e783754c..71425de59d9 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -590,7 +590,7 @@ protected function getRenderedPages(): array
         $pages = [];
 
         foreach ($links as $link) {
-            $pages[$link->getAttribute('href')] = $link->textContent;
+            $pages[$link->getAttribute('href')] = trim($link->textContent);
         }
 
         return $pages;

From 293d0ddc0226266a3cf1de31b7e7a0ce0f2c5c79 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:50:15 +0100
Subject: [PATCH 1024/4023] Extract helper to print serialized array

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 71425de59d9..1212fb151e5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -472,10 +472,10 @@ public function assertHasPages(array $pages): static
     {
         $renderedPages = $this->getRenderedPages();
 
-        $this->test->assertSame($pages, $renderedPages, sprintf('Rendered pages do not match expected pages: %s', json_encode([
+        $this->test->assertSame($pages, $renderedPages, sprintf('Rendered pages do not match expected pages: %s', $this->printSerializedArray([
             'expected' => $pages,
             'rendered' => $renderedPages,
-        ], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)));
+        ])));
 
         return $this;
     }
@@ -539,10 +539,10 @@ public function assertHasDropdowns(?array $expected = null): static
                 $actual = array_keys($actual);
             }
 
-            $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', json_encode([
+            $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', $this->printSerializedArray([
                 'expected' => $expected,
                 'rendered' => $actual,
-            ], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES)));
+            ])));
         }
 
         return $this;
@@ -630,6 +630,11 @@ protected function makeTextRepresentation(): string
 
         return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
     }
+
+    protected function printSerializedArray(array $data): string|false
+    {
+        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+    }
 }
 
 class RenderedMainNavigationMenu extends RenderedNavigationMenu

From 22bab9a6d622b90768245320c35bd173679113a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:57:13 +0100
Subject: [PATCH 1025/4023] Convert JSON to PHP array syntax

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1212fb151e5..3bdfece36fe 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -633,7 +633,19 @@ protected function makeTextRepresentation(): string
 
     protected function printSerializedArray(array $data): string|false
     {
-        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+        $string = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+
+        // Convert JSON to PHP array syntax
+
+        $string = str_replace(['{', '}'], ['[', ']'], $string);
+        $string = str_replace('": "', "' => '", $string);
+        $string = str_replace('": [', "' => [", $string);
+        $string = str_replace('"', "'", $string);
+        $string = str_replace("'\n", "',\n", $string);
+        $string = str_replace(']', '],', $string);
+        $string = str_replace(',,', ',', $string);
+
+        return rtrim($string, ',');
     }
 }
 

From 2f6f1c43d378cae1e1c47fd7f2a99ce8ec66e8a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:59:30 +0100
Subject: [PATCH 1026/4023] Fix return type

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 3bdfece36fe..d9c30f34d7a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -631,7 +631,7 @@ protected function makeTextRepresentation(): string
         return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
     }
 
-    protected function printSerializedArray(array $data): string|false
+    protected function printSerializedArray(array $data): string
     {
         $string = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
 

From 62b119f2e2dda6a43919b427b7992a825b5c629f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:59:43 +0100
Subject: [PATCH 1027/4023] Formatting

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index d9c30f34d7a..1e462acbea8 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -636,7 +636,6 @@ protected function printSerializedArray(array $data): string
         $string = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
 
         // Convert JSON to PHP array syntax
-
         $string = str_replace(['{', '}'], ['[', ']'], $string);
         $string = str_replace('": "', "' => '", $string);
         $string = str_replace('": [', "' => [", $string);

From fbe47bb18258312e757402c152d6b8d34326913b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 13:59:51 +0100
Subject: [PATCH 1028/4023] Formatting

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1e462acbea8..49ed52cf589 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -29,6 +29,7 @@
 use function view;
 use function trim;
 use function range;
+use function rtrim;
 use function config;
 use function collect;
 use function sprintf;

From 7553c7cef1c5d6c2e1b413d18309b88fa119b6fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 14:07:53 +0100
Subject: [PATCH 1029/4023] Strip documentation footer with header row

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 49ed52cf589..75f9471fbbf 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -494,6 +494,9 @@ public function assertLooksLike(string $expected, bool $skipHeaderRow = false):
 
         if ($skipHeaderRow) {
             $actual = trim(Str::after($actual, "\n"));
+            if (str_contains($actual, 'Backtohomepage')) {
+                $actual = trim(str_replace('Backtohomepage', '', $actual));
+            }
         }
         // If expected omitted dashes, remove them from actual
         if (! str_contains($expected, '- ')) {

From 21de28ae57161f52c56f44cc7d7f8485324fbbce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 14:40:10 +0100
Subject: [PATCH 1030/4023] Update helper to better handle sidebars

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 75f9471fbbf..424f0c5d576 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -494,8 +494,8 @@ public function assertLooksLike(string $expected, bool $skipHeaderRow = false):
 
         if ($skipHeaderRow) {
             $actual = trim(Str::after($actual, "\n"));
-            if (str_contains($actual, 'Backtohomepage')) {
-                $actual = trim(str_replace('Backtohomepage', '', $actual));
+            if (str_contains($actual, 'Back to home page')) {
+                $actual = trim(str_replace('Back to home page', '', $actual));
             }
         }
         // If expected omitted dashes, remove them from actual
@@ -632,6 +632,8 @@ protected function makeTextRepresentation(): string
 
         $html = Str::replaceLast('</ul>', '', $html);
 
+        $html = str_replace(['HydePHPDocs', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'], ['HydePHP Docs', ' Toggle theme', 'Toggle menu', 'Back to home page'], $html);
+
         return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
     }
 

From dbe1eb99b42bafa6685cc846f381baf27f703ce9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 14:41:43 +0100
Subject: [PATCH 1031/4023] Add more sidebar tests

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 424f0c5d576..b114709b690 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -18,6 +18,7 @@
 use Hyde\Foundation\HydeKernel;
 use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
+use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
@@ -346,6 +347,49 @@ public function testNavigationMenuWithDropdownSubdirectoryPagesAndMatchingSubdir
             );
     }
 
+    public function testSidebarWithPages()
+    {
+        $this->sidebar([
+            new DocumentationPage('index'),
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ])
+        ->assertHasPages([
+            'docs/foo.html' => 'Foo',
+            'docs/bar.html' => 'Bar',
+            'docs/baz.html' => 'Baz',
+        ])
+        ->assertItemsLookLike(<<<'HTML'
+            Foo
+            Bar
+            Baz
+            HTML
+        );
+    }
+
+    public function testSidebarFromNestedRoute()
+    {
+        $this->fromPage('nested/page')
+            ->sidebar([
+                new DocumentationPage('index'),
+                new DocumentationPage('foo'),
+                new DocumentationPage('bar'),
+                new DocumentationPage('baz'),
+            ])
+            ->assertHasPages([
+                '../docs/foo.html' => 'Foo',
+                '../docs/bar.html' => 'Bar',
+                '../docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Foo
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);

From 47d37f039b6ef9cdde86ec710204fdbcb9223d14 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 15:00:17 +0100
Subject: [PATCH 1032/4023] Move specialized assertions to test child class

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 92 +++++++++----------
 1 file changed, 46 insertions(+), 46 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index b114709b690..cc629e468ac 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -559,52 +559,6 @@ public function assertItemsLookLike(string $expected): static
         return $this->assertLooksLike($expected, true);
     }
 
-    public function assertHasDropdowns(?array $expected = null): static
-    {
-        $this->assertHasElement('dropdown');
-        $this->assertHasElement('dropdown-items');
-        $this->assertHasElement('dropdown-button');
-
-        if ($expected) {
-            $xpath = new DOMXPath($this->ast);
-            $dropdownItems = $xpath->query('//ul[contains(concat(" ", normalize-space(@class), " "), " dropdown-items ")]');
-
-            /** @var array<string, array<string> $actual */
-            $actual = [];
-
-            foreach ($dropdownItems as $dropdownItem) {
-                $button = $xpath->query('../preceding-sibling::button', $dropdownItem)->item(0);
-
-                $label = trim($button->textContent);
-
-                $children = array_values(array_filter(array_map('trim', explode("\n", $dropdownItem->textContent))));
-
-                $actual[$label] = $children;
-            }
-
-            // If expected is a list array, then remove values from actual
-            if (array_values($expected) === $expected) {
-                $actual = array_keys($actual);
-            }
-
-            $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', $this->printSerializedArray([
-                'expected' => $expected,
-                'rendered' => $actual,
-            ])));
-        }
-
-        return $this;
-    }
-
-    public function assertDoesNotHaveDropdowns(): static
-    {
-        $this->assertDoesNotHaveElement('dropdown');
-        $this->assertDoesNotHaveElement('dropdown-items');
-        $this->assertDoesNotHaveElement('dropdown-button');
-
-        return $this;
-    }
-
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {
@@ -701,6 +655,52 @@ protected function printSerializedArray(array $data): string
 class RenderedMainNavigationMenu extends RenderedNavigationMenu
 {
     protected const TYPE = MainNavigationMenu::class;
+
+    public function assertHasDropdowns(?array $expected = null): static
+    {
+        $this->assertHasElement('dropdown');
+        $this->assertHasElement('dropdown-items');
+        $this->assertHasElement('dropdown-button');
+
+        if ($expected) {
+            $xpath = new DOMXPath($this->ast);
+            $dropdownItems = $xpath->query('//ul[contains(concat(" ", normalize-space(@class), " "), " dropdown-items ")]');
+
+            /** @var array<string, array<string> $actual */
+            $actual = [];
+
+            foreach ($dropdownItems as $dropdownItem) {
+                $button = $xpath->query('../preceding-sibling::button', $dropdownItem)->item(0);
+
+                $label = trim($button->textContent);
+
+                $children = array_values(array_filter(array_map('trim', explode("\n", $dropdownItem->textContent))));
+
+                $actual[$label] = $children;
+            }
+
+            // If expected is a list array, then remove values from actual
+            if (array_values($expected) === $expected) {
+                $actual = array_keys($actual);
+            }
+
+            $this->test->assertSame($expected, $actual, sprintf('Rendered dropdown does not match expected format: %s', $this->printSerializedArray([
+                'expected' => $expected,
+                'rendered' => $actual,
+            ])));
+        }
+
+        return $this;
+    }
+
+    public function assertDoesNotHaveDropdowns(): static
+    {
+        $this->assertDoesNotHaveElement('dropdown');
+        $this->assertDoesNotHaveElement('dropdown-items');
+        $this->assertDoesNotHaveElement('dropdown-button');
+
+        return $this;
+    }
 }
 
 class RenderedDocumentationSidebarMenu extends RenderedNavigationMenu

From 4427d63dc8ab199b862152b58cb607670ba79d55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 15:05:12 +0100
Subject: [PATCH 1033/4023] Test sidebar with grouped pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 42 +++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index cc629e468ac..bf90b7980bd 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -390,6 +390,26 @@ public function testSidebarFromNestedRoute()
             );
     }
 
+    public function testSidebarWithGroupedPages()
+    {
+        $this->sidebar([
+            new DocumentationPage('index'),
+            new DocumentationPage('foo/bar'),
+            new DocumentationPage('foo/baz'),
+        ])
+            ->assertHasGroups()
+            ->assertHasPages([
+                'docs/bar.html' => 'Bar',
+                'docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Foo
+                    - Bar
+                    - Baz
+                HTML
+            );
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);
@@ -706,6 +726,28 @@ public function assertDoesNotHaveDropdowns(): static
 class RenderedDocumentationSidebarMenu extends RenderedNavigationMenu
 {
     protected const TYPE = DocumentationSidebar::class;
+
+    public function assertHasGroups(): static
+    {
+        $this->assertHasElement('sidebar-group');
+        $this->assertHasElement('sidebar-group-items');
+        $this->assertHasElement('sidebar-group-heading');
+        $this->assertHasElement('sidebar-group-header');
+        $this->assertHasElement('sidebar-group-toggle');
+
+        return $this;
+    }
+
+    public function assertHasNoGroups(): static
+    {
+        $this->assertDoesNotHaveElement('sidebar-group');
+        $this->assertDoesNotHaveElement('sidebar-group-items');
+        $this->assertDoesNotHaveElement('sidebar-group-heading');
+        $this->assertDoesNotHaveElement('sidebar-group-header');
+        $this->assertDoesNotHaveElement('sidebar-group-toggle');
+
+        return $this;
+    }
 }
 
 class TestKernel extends HydeKernel

From fcb0e1481d0439ce4468adf5a0127ccce8abb648 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 15:06:34 +0100
Subject: [PATCH 1034/4023] Formatting

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index bf90b7980bd..d55ace4c6bb 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -397,17 +397,17 @@ public function testSidebarWithGroupedPages()
             new DocumentationPage('foo/bar'),
             new DocumentationPage('foo/baz'),
         ])
-            ->assertHasGroups()
-            ->assertHasPages([
-                'docs/bar.html' => 'Bar',
-                'docs/baz.html' => 'Baz',
-            ])
-            ->assertItemsLookLike(<<<'HTML'
-                - Foo
-                    - Bar
-                    - Baz
-                HTML
-            );
+        ->assertHasGroups()
+        ->assertHasPages([
+            'docs/bar.html' => 'Bar',
+            'docs/baz.html' => 'Baz',
+        ])
+        ->assertItemsLookLike(<<<'HTML'
+            - Foo
+                - Bar
+                - Baz
+            HTML
+        );
     }
 
     protected function fromPage(string $mockedRoute): static

From 69453a64a14695f3aed11fab681de8185364146f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 15:08:02 +0100
Subject: [PATCH 1035/4023] Test sidebar with grouped pages without flattened
 output paths

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index d55ace4c6bb..2eea236c674 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -410,6 +410,27 @@ public function testSidebarWithGroupedPages()
         );
     }
 
+    public function testSidebarWithGroupedPagesWithoutFlattenedOutputPaths()
+    {
+        $this->withoutFlattenedOutputPaths()
+            ->sidebar([
+                new DocumentationPage('index'),
+                new DocumentationPage('foo/bar'),
+                new DocumentationPage('foo/baz'),
+            ])
+            ->assertHasGroups()
+            ->assertHasPages([
+                'docs/foo/bar.html' => 'Bar',
+                'docs/foo/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+            - Foo
+                - Bar
+                - Baz
+            HTML
+            );
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);
@@ -442,6 +463,13 @@ protected function useSubdirectoryConfig(string $option): static
         return $this;
     }
 
+    protected function withoutFlattenedOutputPaths(): static
+    {
+        config(['docs.flattened_output_paths' => false]);
+
+        return $this;
+    }
+
     protected function render(string $view): string
     {
         return view($view)->render();

From 28786ecfab7348420b918079f91dcae6b107020d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 15:34:11 +0100
Subject: [PATCH 1036/4023] Remove extra space from code

---
 .../resources/views/components/docs/sidebar-brand.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-brand.blade.php b/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
index e150f86e133..e56ce6b88b7 100644
--- a/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-brand.blade.php
@@ -2,7 +2,7 @@
     <strong class="px-2">
         @if(DocumentationPage::home())
             <a href="{{ DocumentationPage::home() }}">
-                {{  $sidebar->getHeader() }}
+                {{ $sidebar->getHeader() }}
             </a>
         @else
             {{ $sidebar->getHeader() }}

From 167b4d3def2c8619422b240fd58e22ce38c6d409 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 19:18:09 +0100
Subject: [PATCH 1037/4023] Add helper to assert element text state

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php      | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 2eea236c674..04b1bc495d6 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -8,6 +8,7 @@
 
 use DOMXPath;
 use Hyde\Hyde;
+use DOMElement;
 use DOMDocument;
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
@@ -37,6 +38,7 @@
 use function explode;
 use function implode;
 use function array_map;
+use function is_string;
 use function strip_tags;
 use function array_keys;
 use function json_encode;
@@ -561,6 +563,19 @@ public function assertDoesNotHaveElement(string $id): static
         return $this;
     }
 
+    public function assertElementTextIs(DOMElement|string $element, string $expected): static
+    {
+        if (is_string($element)) {
+            $this->assertHasElement($element);
+
+            $element = $this->ast->getElementById($element);
+        }
+
+        $this->test->assertSame($expected, trim($element->textContent));
+
+        return $this;
+    }
+
     public function assertHasPages(array $pages): static
     {
         $renderedPages = $this->getRenderedPages();

From e539081e874903957136aaa270f5c7d19b66ecd6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 19:28:11 +0100
Subject: [PATCH 1038/4023] Add an element ID for the main navigation menu
 brand

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 600d310fbd6..b04ccc9df87 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -3,7 +3,7 @@
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">
-    <div class="flex flex-grow items-center flex-shrink-0 text-gray-700 dark:text-gray-200">
+    <div id="main-navigation-brand" class="flex flex-grow items-center flex-shrink-0 text-gray-700 dark:text-gray-200">
         @include('hyde::components.navigation.navigation-brand')
 
         <div class="ml-auto">

From 7b3192d6905464a5f743b7a6d851d081b0b52a93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 19:31:40 +0100
Subject: [PATCH 1039/4023] Test header states

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 04b1bc495d6..a04b1ce80e6 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -433,6 +433,16 @@ public function testSidebarWithGroupedPagesWithoutFlattenedOutputPaths()
             );
     }
 
+    public function testMenuHeader()
+    {
+        $this->menu()->assertHeaderIs('HydePHP');
+    }
+
+    public function testSidebarHeader()
+    {
+        $this->sidebar()->assertHeaderIs('HydePHP Docs');
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);
@@ -622,6 +632,27 @@ public function assertItemsLookLike(string $expected): static
         return $this->assertLooksLike($expected, true);
     }
 
+    public function assertHeaderIs(string $expected): static
+    {
+        if (static::TYPE === DocumentationSidebar::class) {
+            $elementId = 'sidebar-brand';
+            $nodeName = 'strong';
+        } else {
+            $elementId = 'main-navigation-brand';
+            $nodeName = 'a';
+        }
+
+        $this->assertHasElement($elementId);
+
+        $element = $this->ast->getElementById($elementId)->getElementsByTagName($nodeName)->item(0);
+
+        $this->test->assertNotNull($element, "No <$nodeName> element found in menu header");
+
+        $this->assertElementTextIs($element, $expected);
+
+        return $this;
+    }
+
     #[NoReturn]
     public function dd(bool $writeHtml = true): void
     {

From 60464546ef4b4f485c7a5d977f43f2e2ca418305 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 20:55:50 +0100
Subject: [PATCH 1040/4023] Test custom brands

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php      | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index a04b1ce80e6..11fdfee12c2 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -11,6 +11,7 @@
 use DOMElement;
 use DOMDocument;
 use Hyde\Pages\HtmlPage;
+use Hyde\Facades\Config;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Str;
@@ -443,6 +444,20 @@ public function testSidebarHeader()
         $this->sidebar()->assertHeaderIs('HydePHP Docs');
     }
 
+    public function testCustomMenuHeader()
+    {
+        Config::set('hyde.name', 'Example');
+
+        $this->menu()->assertHeaderIs('Example');
+    }
+
+    public function testCustomSidebarHeader()
+    {
+        Config::set('docs.sidebar.header', 'Documentation');
+
+        $this->sidebar()->assertHeaderIs('Documentation');
+    }
+
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);

From e07c0d4b03cffa37ea1d1e4d2ede39ec99ac8980 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 20:56:55 +0100
Subject: [PATCH 1041/4023] Extract helper method

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 49 ++++++++++---------
 1 file changed, 25 insertions(+), 24 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 11fdfee12c2..1e360956527 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -358,17 +358,17 @@ public function testSidebarWithPages()
             new DocumentationPage('bar'),
             new DocumentationPage('baz'),
         ])
-        ->assertHasPages([
-            'docs/foo.html' => 'Foo',
-            'docs/bar.html' => 'Bar',
-            'docs/baz.html' => 'Baz',
-        ])
-        ->assertItemsLookLike(<<<'HTML'
+            ->assertHasPages([
+                'docs/foo.html' => 'Foo',
+                'docs/bar.html' => 'Bar',
+                'docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
             Foo
             Bar
             Baz
             HTML
-        );
+            );
     }
 
     public function testSidebarFromNestedRoute()
@@ -395,32 +395,24 @@ public function testSidebarFromNestedRoute()
 
     public function testSidebarWithGroupedPages()
     {
-        $this->sidebar([
-            new DocumentationPage('index'),
-            new DocumentationPage('foo/bar'),
-            new DocumentationPage('foo/baz'),
-        ])
-        ->assertHasGroups()
-        ->assertHasPages([
-            'docs/bar.html' => 'Bar',
-            'docs/baz.html' => 'Baz',
-        ])
-        ->assertItemsLookLike(<<<'HTML'
+        $this->sidebar($this->withSidebarPages())
+            ->assertHasGroups()
+            ->assertHasPages([
+                'docs/bar.html' => 'Bar',
+                'docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
             - Foo
                 - Bar
                 - Baz
             HTML
-        );
+            );
     }
 
     public function testSidebarWithGroupedPagesWithoutFlattenedOutputPaths()
     {
         $this->withoutFlattenedOutputPaths()
-            ->sidebar([
-                new DocumentationPage('index'),
-                new DocumentationPage('foo/bar'),
-                new DocumentationPage('foo/baz'),
-            ])
+            ->sidebar($this->withSidebarPages())
             ->assertHasGroups()
             ->assertHasPages([
                 'docs/foo/bar.html' => 'Bar',
@@ -513,6 +505,15 @@ protected function withExamplePages(): array
             new HtmlPage('first', ['navigation.priority' => 1]),
         ];
     }
+
+    protected function withSidebarPages(): array
+    {
+        return [
+            new DocumentationPage('index'),
+            new DocumentationPage('foo/bar'),
+            new DocumentationPage('foo/baz'),
+        ];
+    }
 }
 
 abstract class RenderedNavigationMenu

From 93ab7ee3a8f0cd016f9c074ed885487f5d87a0d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 20:58:14 +0100
Subject: [PATCH 1042/4023] Reorder tests to move up baseline assertions

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 90 +++++++++----------
 1 file changed, 45 insertions(+), 45 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 1e360956527..e0bf64c9fd5 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -109,6 +109,51 @@ public function testNavigationMenuWithPages()
             ]);
     }
 
+    public function testSidebarWithPages()
+    {
+        $this->sidebar([
+            new DocumentationPage('index'),
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ])
+            ->assertHasPages([
+                'docs/foo.html' => 'Foo',
+                'docs/bar.html' => 'Bar',
+                'docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+            Foo
+            Bar
+            Baz
+            HTML
+            );
+    }
+
+    public function testMenuHeader()
+    {
+        $this->menu()->assertHeaderIs('HydePHP');
+    }
+
+    public function testSidebarHeader()
+    {
+        $this->sidebar()->assertHeaderIs('HydePHP Docs');
+    }
+
+    public function testCustomMenuHeader()
+    {
+        Config::set('hyde.name', 'Example');
+
+        $this->menu()->assertHeaderIs('Example');
+    }
+
+    public function testCustomSidebarHeader()
+    {
+        Config::set('docs.sidebar.header', 'Documentation');
+
+        $this->sidebar()->assertHeaderIs('Documentation');
+    }
+
     public function testNavigationMenuFromNestedRoute()
     {
         $this->fromPage('nested/page')
@@ -350,27 +395,6 @@ public function testNavigationMenuWithDropdownSubdirectoryPagesAndMatchingSubdir
             );
     }
 
-    public function testSidebarWithPages()
-    {
-        $this->sidebar([
-            new DocumentationPage('index'),
-            new DocumentationPage('foo'),
-            new DocumentationPage('bar'),
-            new DocumentationPage('baz'),
-        ])
-            ->assertHasPages([
-                'docs/foo.html' => 'Foo',
-                'docs/bar.html' => 'Bar',
-                'docs/baz.html' => 'Baz',
-            ])
-            ->assertItemsLookLike(<<<'HTML'
-            Foo
-            Bar
-            Baz
-            HTML
-            );
-    }
-
     public function testSidebarFromNestedRoute()
     {
         $this->fromPage('nested/page')
@@ -426,30 +450,6 @@ public function testSidebarWithGroupedPagesWithoutFlattenedOutputPaths()
             );
     }
 
-    public function testMenuHeader()
-    {
-        $this->menu()->assertHeaderIs('HydePHP');
-    }
-
-    public function testSidebarHeader()
-    {
-        $this->sidebar()->assertHeaderIs('HydePHP Docs');
-    }
-
-    public function testCustomMenuHeader()
-    {
-        Config::set('hyde.name', 'Example');
-
-        $this->menu()->assertHeaderIs('Example');
-    }
-
-    public function testCustomSidebarHeader()
-    {
-        Config::set('docs.sidebar.header', 'Documentation');
-
-        $this->sidebar()->assertHeaderIs('Documentation');
-    }
-
     protected function fromPage(string $mockedRoute): static
     {
         $this->mockCurrentPage($mockedRoute);

From f3df5375b1ec1c63392a1c7961a47d0f4c434fd1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 20:59:07 +0100
Subject: [PATCH 1043/4023] Rename testing helper to match usage

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index e0bf64c9fd5..7f514191f0a 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -419,7 +419,7 @@ public function testSidebarFromNestedRoute()
 
     public function testSidebarWithGroupedPages()
     {
-        $this->sidebar($this->withSidebarPages())
+        $this->sidebar($this->withGroupedSidebarPages())
             ->assertHasGroups()
             ->assertHasPages([
                 'docs/bar.html' => 'Bar',
@@ -436,7 +436,7 @@ public function testSidebarWithGroupedPages()
     public function testSidebarWithGroupedPagesWithoutFlattenedOutputPaths()
     {
         $this->withoutFlattenedOutputPaths()
-            ->sidebar($this->withSidebarPages())
+            ->sidebar($this->withGroupedSidebarPages())
             ->assertHasGroups()
             ->assertHasPages([
                 'docs/foo/bar.html' => 'Bar',
@@ -506,7 +506,7 @@ protected function withExamplePages(): array
         ];
     }
 
-    protected function withSidebarPages(): array
+    protected function withGroupedSidebarPages(): array
     {
         return [
             new DocumentationPage('index'),

From 2f0e1ad4a6ff464a60f04444e91dfc768315a6b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 20:59:48 +0100
Subject: [PATCH 1044/4023] Extract new testing helper

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php    | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 7f514191f0a..9d241a3cd3b 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -111,12 +111,7 @@ public function testNavigationMenuWithPages()
 
     public function testSidebarWithPages()
     {
-        $this->sidebar([
-            new DocumentationPage('index'),
-            new DocumentationPage('foo'),
-            new DocumentationPage('bar'),
-            new DocumentationPage('baz'),
-        ])
+        $this->sidebar($this->withSidebarPages())
             ->assertHasPages([
                 'docs/foo.html' => 'Foo',
                 'docs/bar.html' => 'Bar',
@@ -506,6 +501,16 @@ protected function withExamplePages(): array
         ];
     }
 
+    protected function withSidebarPages(): array
+    {
+        return [
+            new DocumentationPage('index'),
+            new DocumentationPage('foo'),
+            new DocumentationPage('bar'),
+            new DocumentationPage('baz'),
+        ];
+    }
+
     protected function withGroupedSidebarPages(): array
     {
         return [

From 7170be2fdaeeb4647fb22788e31d05fa65fb739e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:00:16 +0100
Subject: [PATCH 1045/4023] Format string syntax

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 9d241a3cd3b..c69bb6cfe48 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -118,10 +118,10 @@ public function testSidebarWithPages()
                 'docs/baz.html' => 'Baz',
             ])
             ->assertItemsLookLike(<<<'HTML'
-            Foo
-            Bar
-            Baz
-            HTML
+                Foo
+                Bar
+                Baz
+                HTML
             );
     }
 

From c6c7351de930e2599af48f56cf4d73c98372ef72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:07:49 +0100
Subject: [PATCH 1046/4023] Add replacement for another test quirk

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index c69bb6cfe48..da08e313b53 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -745,7 +745,7 @@ protected function makeTextRepresentation(): string
 
         $html = Str::replaceLast('</ul>', '', $html);
 
-        $html = str_replace(['HydePHPDocs', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'], ['HydePHP Docs', ' Toggle theme', 'Toggle menu', 'Back to home page'], $html);
+        $html = str_replace(['HydePHPDocs', 'themeToggle', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'], ['HydePHP Docs', 'theme Toggle', ' Toggle theme', 'Toggle menu', 'Back to home page'], $html);
 
         return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
     }

From d2956930e4ce1dbeca1160537b0a13725de2fb61 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:08:01 +0100
Subject: [PATCH 1047/4023] Assert on full menu state

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index da08e313b53..c23eaa8474f 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -117,10 +117,12 @@ public function testSidebarWithPages()
                 'docs/bar.html' => 'Bar',
                 'docs/baz.html' => 'Baz',
             ])
-            ->assertItemsLookLike(<<<'HTML'
+            ->assertLooksLike(<<<'HTML'
+                HydePHP Docs Toggle theme
                 Foo
                 Bar
                 Baz
+                Back to home page
                 HTML
             );
     }

From a991d8b26beb27fe2067153370b1070c4df5d141 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:08:07 +0100
Subject: [PATCH 1048/4023] Add menu state assertion

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index c23eaa8474f..34315d4aca8 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -106,7 +106,15 @@ public function testNavigationMenuWithPages()
                 'first.html' => 'First',
                 'about.html' => 'About',
                 'custom.html' => 'Label',
-            ]);
+            ])
+            ->assertLooksLike(<<<'HTML'
+                HydePHP Toggle theme Toggle menu
+                - Home
+                - First
+                - About
+                - Label
+                HTML
+            );
     }
 
     public function testSidebarWithPages()

From a8d8c46f424736c99fb82fdcb30d48306d37b7b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:08:37 +0100
Subject: [PATCH 1049/4023] Split comma-separated values into multiple lines

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php          | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 34315d4aca8..0628d7fa79b 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -755,7 +755,11 @@ protected function makeTextRepresentation(): string
 
         $html = Str::replaceLast('</ul>', '', $html);
 
-        $html = str_replace(['HydePHPDocs', 'themeToggle', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'], ['HydePHP Docs', 'theme Toggle', ' Toggle theme', 'Toggle menu', 'Back to home page'], $html);
+        $html = str_replace(
+            ['HydePHPDocs', 'themeToggle', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'],
+            ['HydePHP Docs', 'theme Toggle', ' Toggle theme', 'Toggle menu', 'Back to home page'],
+            $html
+        );
 
         return trim(implode("\n", array_map('rtrim', explode("\n", $html))));
     }

From 68077c260a19babe09daf84df210f17aef5f5da9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:10:51 +0100
Subject: [PATCH 1050/4023] Supress spell check inspection for statement

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 0628d7fa79b..fe5edf60dd9 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -755,6 +755,7 @@ protected function makeTextRepresentation(): string
 
         $html = Str::replaceLast('</ul>', '', $html);
 
+        /** @noinspection SpellCheckingInspection */
         $html = str_replace(
             ['HydePHPDocs', 'themeToggle', 'Toggledarktheme', 'Togglemenu', 'Backtohomepage'],
             ['HydePHP Docs', 'theme Toggle', ' Toggle theme', 'Toggle menu', 'Back to home page'],

From 3b53a49bd23d9e9426d68ae0263abdf124746c48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Mar 2024 21:12:34 +0100
Subject: [PATCH 1051/4023] Update test class abstract documentation

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index fe5edf60dd9..4025cdf5efa 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -54,6 +54,9 @@
 /**
  * Very high level tests for navigation menu and sidebar view layouts.
  *
+ * These tests provide a sort of structural visual testing that can signal smoke
+ * before end-to-end testing kicks in, as they take a long time to set up and run.
+ *
  * @see \Hyde\Framework\Testing\Feature\AutomaticNavigationConfigurationsTest
  */
 class NavigationHtmlLayoutsTest extends TestCase

From e6049b8a5fedc627ea68756248f33836ab83d0cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 08:54:01 +0100
Subject: [PATCH 1052/4023] Add sidebar header scope hook

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php       | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 4025cdf5efa..b3e56c08e3b 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -840,6 +840,8 @@ class RenderedDocumentationSidebarMenu extends RenderedNavigationMenu
 {
     protected const TYPE = DocumentationSidebar::class;
 
+    protected bool $scopeToHeader = false;
+
     public function assertHasGroups(): static
     {
         $this->assertHasElement('sidebar-group');
@@ -861,6 +863,13 @@ public function assertHasNoGroups(): static
 
         return $this;
     }
+    
+    public function header(): static
+    {
+        $this->scopeToHeader = true;
+
+        return $this;
+    }
 }
 
 class TestKernel extends HydeKernel

From 24d8fd26717aa3ef73261212cc02e041016dc2dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 08:56:37 +0100
Subject: [PATCH 1053/4023] Add helper to get asserted element

---
 .../tests/Unit/Views/NavigationHtmlLayoutsTest.php        | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index b3e56c08e3b..cadca7379f3 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -697,6 +697,14 @@ public function dd(bool $writeHtml = true): void
         exit(trim($this->html)."\n\n");
     }
 
+    /** Get an element node and assert it is not null */
+    protected function getAssertedElement(string $id): DOMElement
+    {
+        $this->assertHasElement($id);
+
+        return $this->ast->getElementById($id);
+    }
+
     protected function parseHtml(): DOMDocument
     {
         $dom = new DOMDocument();

From e76774b615f766d3192ee6c45be3507fff1ea015 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 09:00:54 +0100
Subject: [PATCH 1054/4023] Add helper to assert theme toggle button state

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index cadca7379f3..a3486ee4ce6 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -871,7 +871,24 @@ public function assertHasNoGroups(): static
 
         return $this;
     }
-    
+
+    public function assertHasThemeToggleButton(): static
+    {
+        if (! $this->scopeToHeader) {
+            $this->assertHasElement('theme-toggle-button');
+        } else {
+            $header = $this->getAssertedElement('sidebar-header');
+
+            $xpath = new DOMXPath($this->ast);
+            $header = $xpath->query('.//button[contains(concat(" ", normalize-space(@class), " "), " theme-toggle-button ")]', $header)->item(0);
+
+            $this->test->assertNotNull($header, 'No theme toggle button found in sidebar header');
+            $this->test->assertSame('Toggle dark theme', trim($header->textContent));
+        }
+
+        return $this;
+    }
+
     public function header(): static
     {
         $this->scopeToHeader = true;

From e06d6feb19f8654ae17649aa77d2e3cd4361b0c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 09:01:01 +0100
Subject: [PATCH 1055/4023] Test sidebar header has theme toggle button

---
 .../framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index a3486ee4ce6..915b255619f 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -162,6 +162,11 @@ public function testCustomSidebarHeader()
         $this->sidebar()->assertHeaderIs('Documentation');
     }
 
+    public function testSidebarHeaderHasThemeToggleButton()
+    {
+        $this->sidebar()->header()->assertHasThemeToggleButton();
+    }
+
     public function testNavigationMenuFromNestedRoute()
     {
         $this->fromPage('nested/page')

From 3e7d268391196865fa00f4c353fa44ffd67d79b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 09:03:35 +0100
Subject: [PATCH 1056/4023] Test inverse toggle button state

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php  | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 915b255619f..52ccaa3e8b1 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -14,6 +14,7 @@
 use Hyde\Facades\Config;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
+use Hyde\Facades\Features;
 use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\InMemoryPage;
@@ -167,6 +168,13 @@ public function testSidebarHeaderHasThemeToggleButton()
         $this->sidebar()->header()->assertHasThemeToggleButton();
     }
 
+    public function testSidebarHeaderDoesNotHaveThemeToggleButtonWhenDarkmodeIsDisabled()
+    {
+        Features::mock('darkmode', false);
+
+        $this->sidebar()->header()->assertDoesNotHaveThemeToggleButton();
+    }
+
     public function testNavigationMenuFromNestedRoute()
     {
         $this->fromPage('nested/page')
@@ -894,6 +902,22 @@ public function assertHasThemeToggleButton(): static
         return $this;
     }
 
+    public function assertDoesNotHaveThemeToggleButton(): static
+    {
+        if (! $this->scopeToHeader) {
+            $this->assertDoesNotHaveElement('theme-toggle-button');
+        } else {
+            $header = $this->getAssertedElement('sidebar-header');
+
+            $xpath = new DOMXPath($this->ast);
+            $header = $xpath->query('.//button[contains(concat(" ", normalize-space(@class), " "), " theme-toggle-button ")]', $header)->item(0);
+
+            $this->test->assertNull($header, 'Theme toggle button found in sidebar header');
+        }
+
+        return $this;
+    }
+
     public function header(): static
     {
         $this->scopeToHeader = true;

From 2145e5b8cceeb8654aa8d9b5ba2e6c89b9bcc403 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 17:17:03 +0100
Subject: [PATCH 1057/4023] Test sidebar without grouped pages

---
 .../Unit/Views/NavigationHtmlLayoutsTest.php    | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index 52ccaa3e8b1..b34f0d78af2 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -438,6 +438,23 @@ public function testSidebarFromNestedRoute()
             );
     }
 
+    public function testSidebarWithoutGroupedPages()
+    {
+        $this->sidebar($this->withSidebarPages())
+            ->assertHasNoGroups()
+            ->assertHasPages([
+                'docs/foo.html' => 'Foo',
+                'docs/bar.html' => 'Bar',
+                'docs/baz.html' => 'Baz',
+            ])
+            ->assertItemsLookLike(<<<'HTML'
+                - Foo
+                - Bar
+                - Baz
+                HTML
+            );
+    }
+
     public function testSidebarWithGroupedPages()
     {
         $this->sidebar($this->withGroupedSidebarPages())

From 894a865fa461fcc71ee2ead257ee710cff2e9bea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 17:25:10 +0100
Subject: [PATCH 1058/4023] Include navigation link as Blade component instead
 of include

Looks more consistent with the dropdown include just above, and we can use attributes
---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index b04ccc9df87..663bb8a4567 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -38,7 +38,7 @@
                     @if($item instanceof \Hyde\Framework\Features\Navigation\NavGroupItem)
                         <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getItems()"/>
                     @else
-                        @include('hyde::components.navigation.navigation-link')
+                        <x-hyde::navigation.link :item="$item"/>
                     @endif
                 </li>
             @endforeach

From 52f2d0c39b717205207b37a89ac5b381dbf2ca25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 17:27:35 +0100
Subject: [PATCH 1059/4023] Fix component name

---
 packages/framework/resources/views/layouts/navigation.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 663bb8a4567..a55e64b5ea1 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -38,7 +38,7 @@
                     @if($item instanceof \Hyde\Framework\Features\Navigation\NavGroupItem)
                         <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getItems()"/>
                     @else
-                        <x-hyde::navigation.link :item="$item"/>
+                        <x-hyde::navigation.navigation-link :item="$item"/>
                     @endif
                 </li>
             @endforeach

From 6ba9eaf7006362ddb7b2e3566479725329a212f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 17:43:16 +0100
Subject: [PATCH 1060/4023] Add CSS class hooks for the navigation link states

Adds a styling hook, and makes it more readable and testable
---
 .../navigation/navigation-link.blade.php          |  4 ++--
 .../tests/Unit/Views/NavigationLinkViewTest.php   | 15 +++++++++++++++
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index 048faaa6cba..207172ff4ea 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,4 +1,4 @@
 <a href="{{ $item }}" {!! $item->isActive() ? 'aria-current="page"' : '' !!} @class([
-    'block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
-    'border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
+    'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
+    'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
 ])>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 1018d2ae3c0..53b3a14b553 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -48,4 +48,19 @@ public function testComponentHasAriaCurrentWhenCurrentRouteMatches()
         $this->mockRoute(Routes::get('index'));
         $this->assertStringContainsString('aria-current="page"', $this->render(NavItem::forRoute(Routes::get('index'), 'Home')));
     }
+
+    public function testComponentDoesNotHaveActiveClassWhenNotActive()
+    {
+        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
+        $this->assertStringContainsString('navigation-link ', $render);
+        $this->assertStringNotContainsString('navigation-link-active', $render);
+    }
+
+    public function testComponentHasActiveClassWhenActive()
+    {
+        $this->mockRoute(Routes::get('index'));
+        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
+        $this->assertStringContainsString('navigation-link ', $render);
+        $this->assertStringContainsString('navigation-link-active', $render);
+    }
 }

From c61eef919422b886f75b78aef654da42da7c397f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 21:20:35 +0100
Subject: [PATCH 1061/4023] Include dropdown navigation item as Blade component

Normalizes with https://github.com/hydephp/develop/commit/894a865fa461fcc71ee2ead257ee710cff2e9bea
---
 .../resources/views/components/navigation/dropdown.blade.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/navigation/dropdown.blade.php b/packages/framework/resources/views/components/navigation/dropdown.blade.php
index 52d03fcc9c0..b0c8de89a0d 100644
--- a/packages/framework/resources/views/components/navigation/dropdown.blade.php
+++ b/packages/framework/resources/views/components/navigation/dropdown.blade.php
@@ -9,7 +9,7 @@
             @isset($items)
                 @foreach ($items as $item)
                     <li class="whitespace-nowrap">
-                        @include('hyde::components.navigation.navigation-link')
+                        <x-hyde::navigation.navigation-link :item="$item"/>
                     </li>
                 @endforeach
             @else

From 759c63a9354b6ff3955fb73fea0ad9e700441286 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 21:23:44 +0100
Subject: [PATCH 1062/4023] Refactor component to use attribute merging

Create attribute bag in test setup
Update test to expect cleaner HTML output
---
 .../views/components/navigation/navigation-link.blade.php   | 6 ++++--
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php   | 2 ++
 .../framework/tests/Unit/Views/NavigationMenuViewTest.php   | 2 +-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index 207172ff4ea..0460e6fb38f 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,4 +1,6 @@
-<a href="{{ $item }}" {!! $item->isActive() ? 'aria-current="page"' : '' !!} @class([
+<a href="{{ $item }}" {{ ($attributes->except('item')->class([
     'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
-])>{{ $item->getLabel() }}</a>
\ No newline at end of file
+])->merge([
+    'aria-current' => ($item->isActive() ? 'page' : false),
+])) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 53b3a14b553..14aa79c074a 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit\Views;
 
 use Hyde\Foundation\Facades\Routes;
+use Illuminate\View\ComponentAttributeBag;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Testing\TestCase;
 
@@ -24,6 +25,7 @@ protected function render(?NavItem $item = null): string
     {
         return view('hyde::components.navigation.navigation-link', [
             'item' => $item ?? NavItem::forLink('foo.html', 'Foo'),
+            'attributes' => new ComponentAttributeBag(),
         ])->render();
     }
 
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index a40d6782b33..18d9bfd7cbf 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -73,7 +73,7 @@ public function testNavigationMenuWithRootPages()
         $contents = $foo->compile();
 
         $this->assertStringContainsString('<a href="foo.html" aria-current="page" class="', $contents);
-        $this->assertStringContainsString('<a href="bar.html"  class="', $contents);
+        $this->assertStringContainsString('<a href="bar.html" class="', $contents);
     }
 
     public function testNavigationMenuWithDropdownPages()

From 5710b1ad98e01b96db0b7029e8cbbb9dc1e225d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 21:30:28 +0100
Subject: [PATCH 1063/4023] Test inverse attribute state

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php  | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 14aa79c074a..e33adbdb413 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -39,6 +39,13 @@ public function testComponentUsesTitle()
         $this->assertStringContainsString('Foo', $this->render());
     }
 
+    public function testComponentDoesNotHaveCurrentAttributesWhenCurrentRouteDoesNotMatch()
+    {
+        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
+        $this->assertStringNotContainsString('current', $render);
+        $this->assertStringNotContainsString('aria-current="page"', $render);
+    }
+
     public function testComponentIsCurrentWhenCurrentRouteMatches()
     {
         $this->mockRoute(Routes::get('index'));

From 5ffeac4a96f31528c2b4b82a471367eb23a42fd3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 21:31:45 +0100
Subject: [PATCH 1064/4023] Remove unnecessary parentheses

---
 .../views/components/navigation/navigation-link.blade.php   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index 0460e6fb38f..60ce617081d 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,6 +1,6 @@
-<a href="{{ $item }}" {{ ($attributes->except('item')->class([
+<a href="{{ $item }}" {{ $attributes->except('item')->class([
     'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
 ])->merge([
-    'aria-current' => ($item->isActive() ? 'page' : false),
-])) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
+    'aria-current' => $item->isActive() ? 'page' : false,
+]) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file

From b62cd6bf9fefb5e846c6cb0360ac709b12affa64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 22:42:46 +0100
Subject: [PATCH 1065/4023] Add testing helper to assert HTML attribute state

---
 packages/testing/src/Support/TestView.php | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 8bb446c3ebc..d3581efb59f 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -34,6 +34,18 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
         return $this;
     }
 
+    /**
+     * Assert that the HTML attribute value is contained within the view.
+     *
+     * @return $this
+     */
+    public function assertAttributeIs(string $attributeName, string $expectedValue): static
+    {
+        PHPUnit::assertStringContainsString($attributeName.'="'.$expectedValue.'"', $this->rendered);
+
+        return $this;
+    }
+
     protected function trimNewlinesAndIndentation(string $value): string
     {
         return str_replace(['    ', "\t", "\n", "\r"], '', $value);

From f26f910e66a105733cf260256d23d81d05b8829f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 22:44:23 +0100
Subject: [PATCH 1066/4023] Add testing helper to assert HTML content literals

---
 packages/testing/src/Support/TestView.php | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index d3581efb59f..4e04a247a7d 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -46,6 +46,18 @@ public function assertAttributeIs(string $attributeName, string $expectedValue):
         return $this;
     }
 
+    /**
+     * Assert that the given text is equals the view's text content.
+     *
+     * @return $this
+     */
+    public function assertTextIs(string $value): static
+    {
+        PHPUnit::assertSame($value, strip_tags($this->rendered));
+
+        return $this;
+    }
+
     protected function trimNewlinesAndIndentation(string $value): string
     {
         return str_replace(['    ', "\t", "\n", "\r"], '', $value);

From 90419b2808591ec60f56523ad9c141f79de14dbd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 13 Mar 2024 22:45:47 +0100
Subject: [PATCH 1067/4023] Begin refactoring test to use more fluent assertion
 helpers

---
 .../tests/Unit/Views/NavigationLinkViewTest.php   | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 1018d2ae3c0..6c0a25a6113 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use Hyde\Testing\TestsBladeViews;
+use Hyde\Testing\Support\TestView;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Testing\TestCase;
@@ -13,6 +15,8 @@
  */
 class NavigationLinkViewTest extends TestCase
 {
+    use TestsBladeViews;
+
     protected function setUp(): void
     {
         parent::setUp();
@@ -27,14 +31,21 @@ protected function render(?NavItem $item = null): string
         ])->render();
     }
 
+    protected function testView(?NavItem $item = null): TestView
+    {
+        return $this->test(view('hyde::components.navigation.navigation-link', [
+            'item' => $item ?? NavItem::forLink('foo.html', 'Foo'),
+        ]));
+    }
+
     public function testComponentLinksToRouteDestination()
     {
-        $this->assertStringContainsString('href="foo.html"', $this->render());
+        $this->testView()->assertAttributeIs('href', 'foo.html');
     }
 
     public function testComponentUsesTitle()
     {
-        $this->assertStringContainsString('Foo', $this->render());
+        $this->testView()->assertTextIs('Foo');
     }
 
     public function testComponentIsCurrentWhenCurrentRouteMatches()

From 6a474091b1afd4211cddf97b15138df1e9749a00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 11:39:39 +0100
Subject: [PATCH 1068/4023] Add testing helper to make NavItem for page

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php  | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 93146650502..3d050d2e75a 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use Hyde\Pages\InMemoryPage;
+use Hyde\Support\Models\Route;
 use Hyde\Testing\TestsBladeViews;
 use Hyde\Testing\Support\TestView;
 use Hyde\Foundation\Facades\Routes;
@@ -41,6 +43,11 @@ protected function testView(?NavItem $item = null): TestView
         ]));
     }
 
+    protected function makeNavItemForPage(): NavItem
+    {
+        return NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo');
+    }
+
     public function testComponentLinksToRouteDestination()
     {
         $this->testView()->assertAttributeIs('href', 'foo.html');

From 2cd3da2085c5e34cfb64c176457ddbf833629f5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 11:39:54 +0100
Subject: [PATCH 1069/4023] Add improved assertion output

---
 packages/testing/src/Support/TestView.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 4e04a247a7d..d75cea1a980 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -41,7 +41,7 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
      */
     public function assertAttributeIs(string $attributeName, string $expectedValue): static
     {
-        PHPUnit::assertStringContainsString($attributeName.'="'.$expectedValue.'"', $this->rendered);
+        PHPUnit::assertStringContainsString($attributeName.'="'.$expectedValue.'"', $this->rendered, "The attribute '$attributeName' with value '$expectedValue' was not found.");
 
         return $this;
     }

From d5f33f643e321277d0e883998d2602948f96fc8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 11:40:03 +0100
Subject: [PATCH 1070/4023] Test component resolves relative links for routes

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 3d050d2e75a..6a1bbb0e490 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -53,6 +53,12 @@ public function testComponentLinksToRouteDestination()
         $this->testView()->assertAttributeIs('href', 'foo.html');
     }
 
+    public function testComponentResolvesRelativeLinksForRoutes()
+    {
+        $this->mockCurrentPage('foo/bar');
+        $this->testView($this->makeNavItemForPage())->assertAttributeIs('href', '../foo.html');
+    }
+
     public function testComponentUsesTitle()
     {
         $this->testView()->assertTextIs('Foo');

From a4c0f9ec0e86134259c2869bf926e09b069167f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 17:19:44 +0100
Subject: [PATCH 1071/4023] Simplify test data handling

---
 .../tests/Unit/Views/NavigationLinkViewTest.php          | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 6a1bbb0e490..0117567081a 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -38,16 +38,11 @@ protected function render(?NavItem $item = null): string
     protected function testView(?NavItem $item = null): TestView
     {
         return $this->test(view('hyde::components.navigation.navigation-link', [
-            'item' => $item ?? NavItem::forLink('foo.html', 'Foo'),
+            'item' => $item ?? NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
             'attributes' => new ComponentAttributeBag(),
         ]));
     }
 
-    protected function makeNavItemForPage(): NavItem
-    {
-        return NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo');
-    }
-
     public function testComponentLinksToRouteDestination()
     {
         $this->testView()->assertAttributeIs('href', 'foo.html');
@@ -56,7 +51,7 @@ public function testComponentLinksToRouteDestination()
     public function testComponentResolvesRelativeLinksForRoutes()
     {
         $this->mockCurrentPage('foo/bar');
-        $this->testView($this->makeNavItemForPage())->assertAttributeIs('href', '../foo.html');
+        $this->testView()->assertAttributeIs('href', '../foo.html');
     }
 
     public function testComponentUsesTitle()

From c042cf7edcf395930182ba9b85db436f576df2ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 21:06:27 +0100
Subject: [PATCH 1072/4023] Add more attribute assertion helpers

---
 packages/testing/src/Support/TestView.php | 26 +++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index d75cea1a980..c0ac4979328 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -41,11 +41,37 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
      */
     public function assertAttributeIs(string $attributeName, string $expectedValue): static
     {
+        static::assertHasAttribute($attributeName);
+
         PHPUnit::assertStringContainsString($attributeName.'="'.$expectedValue.'"', $this->rendered, "The attribute '$attributeName' with value '$expectedValue' was not found.");
 
         return $this;
     }
 
+    /**
+     * Assert that the HTML attribute is present within the view.
+     *
+     * @return $this
+     */
+    public function assertHasAttribute(string $attributeName): static
+    {
+        PHPUnit::assertStringContainsString($attributeName.'="', $this->rendered, "The attribute '$attributeName' was not found.");
+
+        return $this;
+    }
+
+    /**
+     * Assert that the HTML attribute is not present within the view.
+     *
+     * @return $this
+     */
+    public function assertDoesNotHaveAttribute(string $attributeName): static
+    {
+        PHPUnit::assertStringNotContainsString($attributeName.'="', $this->rendered, "The attribute '$attributeName' was found.");
+
+        return $this;
+    }
+
     /**
      * Assert that the given text is equals the view's text content.
      *

From b7fb433c58b0c86ddda81d1613dc6437fa6daeef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 21:08:38 +0100
Subject: [PATCH 1073/4023] Refactor test to use fluent assertions

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 0117567081a..64914a8934a 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -61,9 +61,9 @@ public function testComponentUsesTitle()
 
     public function testComponentDoesNotHaveCurrentAttributesWhenCurrentRouteDoesNotMatch()
     {
-        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
-        $this->assertStringNotContainsString('current', $render);
-        $this->assertStringNotContainsString('aria-current="page"', $render);
+        $this->testView()
+            ->assertDontSee('current')
+            ->assertDoesNotHaveAttribute('aria-current');
     }
 
     public function testComponentIsCurrentWhenCurrentRouteMatches()

From 7b1868e30c7b2f44f40f00eb0421228061c5c799 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 21:15:04 +0100
Subject: [PATCH 1074/4023] Add testing helper to dump and die with HTML state

---
 packages/testing/src/Support/TestView.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index c0ac4979328..428f85cc0b5 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Testing\Support;
 
+use Hyde\Hyde;
+use Illuminate\Support\Str;
+use JetBrains\PhpStorm\NoReturn;
 use Illuminate\Testing\Assert as PHPUnit;
 
 class TestView extends \Illuminate\Testing\TestView
@@ -84,6 +87,17 @@ public function assertTextIs(string $value): static
         return $this;
     }
 
+    #[NoReturn]
+    public function dd(bool $writeHtml = true): void
+    {
+        if ($writeHtml) {
+            $viewName = Str::after(Str::after(basename(class_basename($this->view->getName())), '.'), '.');
+            file_put_contents(Hyde::path(Str::kebab($viewName.'.html')), $this->rendered);
+        }
+
+        exit(trim($this->rendered)."\n\n");
+    }
+
     protected function trimNewlinesAndIndentation(string $value): string
     {
         return str_replace(['    ', "\t", "\n", "\r"], '', $value);

From 282d1feb4aa648ff3ca58fc5929ca76fdf653268 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 21:37:32 +0100
Subject: [PATCH 1075/4023] Refactor test to use fluent assertions

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 64914a8934a..378075c49e7 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -68,8 +68,10 @@ public function testComponentDoesNotHaveCurrentAttributesWhenCurrentRouteDoesNot
 
     public function testComponentIsCurrentWhenCurrentRouteMatches()
     {
-        $this->mockRoute(Routes::get('index'));
-        $this->assertStringContainsString('current', $this->render(NavItem::forRoute(Routes::get('index'), 'Home')));
+        $this->mockCurrentPage('foo');
+        $this->testView()
+            ->assertSee('current')
+            ->assertAttributeIs('aria-current', 'page');
     }
 
     public function testComponentHasAriaCurrentWhenCurrentRouteMatches()

From add2390407fbbd41e24f9f680c4b88873fc289d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Mar 2024 21:40:24 +0100
Subject: [PATCH 1076/4023] Use helper method fluently

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 378075c49e7..d70e5f78ebd 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -68,8 +68,8 @@ public function testComponentDoesNotHaveCurrentAttributesWhenCurrentRouteDoesNot
 
     public function testComponentIsCurrentWhenCurrentRouteMatches()
     {
-        $this->mockCurrentPage('foo');
-        $this->testView()
+        $this->mockCurrentPage('foo')
+            ->testView()
             ->assertSee('current')
             ->assertAttributeIs('aria-current', 'page');
     }

From 68d46fffab7738e034605773e5ec72ec477523de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:38:06 +0100
Subject: [PATCH 1077/4023] Update testing helper to automatically parse
 attributes

Adds an option to use this with just the full attribute string
---
 packages/testing/src/Support/TestView.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 428f85cc0b5..924db972f3c 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -42,8 +42,15 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
      *
      * @return $this
      */
-    public function assertAttributeIs(string $attributeName, string $expectedValue): static
+    public function assertAttributeIs(string $attribute, ?string $expectedValue = null): static
     {
+        if ($expectedValue === null) {
+            [$attributeName, $expectedValue] = explode('=', $attribute);
+            $expectedValue = trim($expectedValue, '"');
+        } else {
+            $attributeName = $attribute;
+        }
+
         static::assertHasAttribute($attributeName);
 
         PHPUnit::assertStringContainsString($attributeName.'="'.$expectedValue.'"', $this->rendered, "The attribute '$attributeName' with value '$expectedValue' was not found.");

From cd1e567f9208592e21807fce5a3539b6504ec815 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:38:19 +0100
Subject: [PATCH 1078/4023] Use shorthand attribute testing syntax

---
 packages/framework/tests/Unit/Views/NavigationLinkViewTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index d70e5f78ebd..b55552c25f3 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -71,7 +71,7 @@ public function testComponentIsCurrentWhenCurrentRouteMatches()
         $this->mockCurrentPage('foo')
             ->testView()
             ->assertSee('current')
-            ->assertAttributeIs('aria-current', 'page');
+            ->assertAttributeIs('aria-current="page"');
     }
 
     public function testComponentHasAriaCurrentWhenCurrentRouteMatches()

From 2a1c9cc270123f4d605b787a801df2c69aa9bef5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:45:43 +0100
Subject: [PATCH 1079/4023] Add assertion

---
 packages/framework/tests/Unit/Views/NavigationLinkViewTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index b55552c25f3..e7c7a534fe8 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -71,6 +71,7 @@ public function testComponentIsCurrentWhenCurrentRouteMatches()
         $this->mockCurrentPage('foo')
             ->testView()
             ->assertSee('current')
+            ->assertHasAttribute('aria-current')
             ->assertAttributeIs('aria-current="page"');
     }
 

From 322862bb07d10ed18e48b67161204e2909c1bd7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:45:55 +0100
Subject: [PATCH 1080/4023] Remove duplicated test case

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php   | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index e7c7a534fe8..ebe46e90c88 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -75,12 +75,6 @@ public function testComponentIsCurrentWhenCurrentRouteMatches()
             ->assertAttributeIs('aria-current="page"');
     }
 
-    public function testComponentHasAriaCurrentWhenCurrentRouteMatches()
-    {
-        $this->mockRoute(Routes::get('index'));
-        $this->assertStringContainsString('aria-current="page"', $this->render(NavItem::forRoute(Routes::get('index'), 'Home')));
-    }
-
     public function testComponentDoesNotHaveActiveClassWhenNotActive()
     {
         $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));

From cc071eb781b698fde89769078353939a25a9ca97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:49:47 +0100
Subject: [PATCH 1081/4023] Refactor tests to use fluent assertions

---
 .../tests/Unit/Views/NavigationLinkViewTest.php   | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index ebe46e90c88..e0f7be81ba6 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -8,7 +8,6 @@
 use Hyde\Support\Models\Route;
 use Hyde\Testing\TestsBladeViews;
 use Hyde\Testing\Support\TestView;
-use Hyde\Foundation\Facades\Routes;
 use Illuminate\View\ComponentAttributeBag;
 use Hyde\Framework\Features\Navigation\NavItem;
 use Hyde\Testing\TestCase;
@@ -77,16 +76,16 @@ public function testComponentIsCurrentWhenCurrentRouteMatches()
 
     public function testComponentDoesNotHaveActiveClassWhenNotActive()
     {
-        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
-        $this->assertStringContainsString('navigation-link ', $render);
-        $this->assertStringNotContainsString('navigation-link-active', $render);
+        $this->testView()
+            ->assertSee('navigation-link ')
+            ->assertDontSee('navigation-link-active');
     }
 
     public function testComponentHasActiveClassWhenActive()
     {
-        $this->mockRoute(Routes::get('index'));
-        $render = $this->render(NavItem::forRoute(Routes::get('index'), 'Home'));
-        $this->assertStringContainsString('navigation-link ', $render);
-        $this->assertStringContainsString('navigation-link-active', $render);
+        $this->mockCurrentPage('foo')
+            ->testView()
+            ->assertSee('navigation-link ')
+            ->assertSee('navigation-link-active');
     }
 }

From c66c5c89695f6fa8f27d9be470b92dcc0437f39a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:51:11 +0100
Subject: [PATCH 1082/4023] Remove unused testing helper

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index e0f7be81ba6..db942123aa7 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -26,14 +26,6 @@ protected function setUp(): void
         $this->mockPage();
     }
 
-    protected function render(?NavItem $item = null): string
-    {
-        return view('hyde::components.navigation.navigation-link', [
-            'item' => $item ?? NavItem::forLink('foo.html', 'Foo'),
-            'attributes' => new ComponentAttributeBag(),
-        ])->render();
-    }
-
     protected function testView(?NavItem $item = null): TestView
     {
         return $this->test(view('hyde::components.navigation.navigation-link', [

From b451eff6d5e20c188fea772241c1247574e6c4d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:51:58 +0100
Subject: [PATCH 1083/4023] Remove unused parameter from testing helper method

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index db942123aa7..d17ec5bd926 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -26,10 +26,10 @@ protected function setUp(): void
         $this->mockPage();
     }
 
-    protected function testView(?NavItem $item = null): TestView
+    protected function testView(): TestView
     {
         return $this->test(view('hyde::components.navigation.navigation-link', [
-            'item' => $item ?? NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
+            'item' => NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
             'attributes' => new ComponentAttributeBag(),
         ]));
     }

From fbb5bfdbda3d202b734dd7af885553976a29ea5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 13:57:13 +0100
Subject: [PATCH 1084/4023] Add testing helpers to assert CSS class states

---
 packages/testing/src/Support/TestView.php | 32 +++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 924db972f3c..92aa98c331c 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -82,6 +82,30 @@ public function assertDoesNotHaveAttribute(string $attributeName): static
         return $this;
     }
 
+    /**
+     * Assert that the given CSS class is contained within the view.
+     *
+     * @return $this
+     */
+    public function assertHasClass(string $class): static
+    {
+        PHPUnit::assertContains($class, $this->findClasses(), "The class '$class' was not found.");
+
+        return $this;
+    }
+
+    /**
+     * Assert that the given CSS class is not contained within the view.
+     *
+     * @return $this
+     */
+    public function assertDoesNotHaveClass(string $class): static
+    {
+        PHPUnit::assertNotContains($class, $this->findClasses(), "The class '$class' was found.");
+
+        return $this;
+    }
+
     /**
      * Assert that the given text is equals the view's text content.
      *
@@ -109,4 +133,12 @@ protected function trimNewlinesAndIndentation(string $value): string
     {
         return str_replace(['    ', "\t", "\n", "\r"], '', $value);
     }
+
+    /** @return array<string> */
+    protected function findClasses(): array
+    {
+        preg_match_all('/class="([^"]+)"/', $this->rendered, $matches);
+
+        return explode(' ', $matches[1][0]);
+    }
 }

From d5411eb91af90a5bd05f678301e225db96abfe10 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 14:00:46 +0100
Subject: [PATCH 1085/4023] Use new class state helpers

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index d17ec5bd926..b2a2b01c0e5 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -69,15 +69,15 @@ public function testComponentIsCurrentWhenCurrentRouteMatches()
     public function testComponentDoesNotHaveActiveClassWhenNotActive()
     {
         $this->testView()
-            ->assertSee('navigation-link ')
-            ->assertDontSee('navigation-link-active');
+            ->assertHasClass('navigation-link')
+            ->assertDoesNotHaveClass('navigation-link-active');
     }
 
     public function testComponentHasActiveClassWhenActive()
     {
         $this->mockCurrentPage('foo')
             ->testView()
-            ->assertSee('navigation-link ')
-            ->assertSee('navigation-link-active');
+            ->assertHasClass('navigation-link')
+            ->assertHasClass('navigation-link-active');
     }
 }

From fd1c68a5eb5c5a57f829e637542c1aa82fb803a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 14:03:05 +0100
Subject: [PATCH 1086/4023] Clean up and normalize test semantics

---
 .../tests/Unit/Views/NavigationLinkViewTest.php   | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index b2a2b01c0e5..10febbd13cf 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -36,13 +36,14 @@ protected function testView(): TestView
 
     public function testComponentLinksToRouteDestination()
     {
-        $this->testView()->assertAttributeIs('href', 'foo.html');
+        $this->testView()->assertAttributeIs('href="foo.html"');
     }
 
     public function testComponentResolvesRelativeLinksForRoutes()
     {
         $this->mockCurrentPage('foo/bar');
-        $this->testView()->assertAttributeIs('href', '../foo.html');
+
+        $this->testView()->assertAttributeIs('href="../foo.html"');
     }
 
     public function testComponentUsesTitle()
@@ -59,8 +60,9 @@ public function testComponentDoesNotHaveCurrentAttributesWhenCurrentRouteDoesNot
 
     public function testComponentIsCurrentWhenCurrentRouteMatches()
     {
-        $this->mockCurrentPage('foo')
-            ->testView()
+        $this->mockCurrentPage('foo');
+
+        $this->testView()
             ->assertSee('current')
             ->assertHasAttribute('aria-current')
             ->assertAttributeIs('aria-current="page"');
@@ -75,8 +77,9 @@ public function testComponentDoesNotHaveActiveClassWhenNotActive()
 
     public function testComponentHasActiveClassWhenActive()
     {
-        $this->mockCurrentPage('foo')
-            ->testView()
+        $this->mockCurrentPage('foo');
+
+        $this->testView()
             ->assertHasClass('navigation-link')
             ->assertHasClass('navigation-link-active');
     }

From b0d4331f7698228d62a439571fcb5ebcf71402b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 14:09:53 +0100
Subject: [PATCH 1087/4023] Add testing helper to assert element state

---
 packages/testing/src/Support/TestView.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 92aa98c331c..1867c2f0b64 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -37,6 +37,20 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
         return $this;
     }
 
+    /**
+     * Assert that the given HTML element is contained within the view.
+     *
+     * @return $this
+     */
+    public function assertHasElement(string $element): static
+    {
+        $element = trim($element, '</>');
+
+        PHPUnit::assertStringContainsString("<$element", $this->rendered, "The element '$element' was not found.");
+
+        return $this;
+    }
+
     /**
      * Assert that the HTML attribute value is contained within the view.
      *

From 8449237f8ef57bf279e6ff517b5cb34fe9d2e59f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 14:10:01 +0100
Subject: [PATCH 1088/4023] Test component renders

---
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php    | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 10febbd13cf..8609cdb82c7 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -34,6 +34,11 @@ protected function testView(): TestView
         ]));
     }
 
+    public function testComponentRenders()
+    {
+        $this->testView()->assertHasElement('<a>');
+    }
+
     public function testComponentLinksToRouteDestination()
     {
         $this->testView()->assertAttributeIs('href="foo.html"');

From 2439b721776d550c340ca7e2c65aa216330d3dfc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:44:28 +0100
Subject: [PATCH 1089/4023] Create SidebarItemsViewTest.php

---
 .../tests/Unit/Views/SidebarItemsViewTest.php  | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
new file mode 100644
index 00000000000..c2deb985986
--- /dev/null
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Views;
+
+use Hyde\Testing\TestCase;
+use Hyde\Testing\TestsBladeViews;
+
+/**
+ * @see resources/views/components/docs/sidebar-items.blade.php
+ */
+class SidebarItemsViewTest extends TestCase
+{
+    use TestsBladeViews;
+
+    //
+}

From 4f7dd3b5ebe2e58a6f9944ee8c1c9de28b051c7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:49:40 +0100
Subject: [PATCH 1090/4023] Add testing helper to assert if an HTML ID is
 present

---
 packages/testing/src/Support/TestView.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 1867c2f0b64..ed697e6b1fc 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -96,6 +96,20 @@ public function assertDoesNotHaveAttribute(string $attributeName): static
         return $this;
     }
 
+    /**
+     * Assert that the given HTML ID is contained within the view.
+     *
+     * @return $this
+     */
+    public function assertHasId(string $id): static
+    {
+        $id = trim($id, '#');
+
+        PHPUnit::assertStringContainsString("id=\"$id\"", $this->rendered, "The id '$id' was not found.");
+
+        return $this;
+    }
+
     /**
      * Assert that the given CSS class is contained within the view.
      *

From 1d5e1f77a43d8c682366a229362d2492c95ebe13 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:50:06 +0100
Subject: [PATCH 1091/4023] Update testing helper to fluently direct assertions

---
 packages/testing/src/Support/TestView.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index ed697e6b1fc..22f0e4dac2e 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -46,6 +46,10 @@ public function assertHasElement(string $element): static
     {
         $element = trim($element, '</>');
 
+        if (str_starts_with($element, '#')) {
+            return $this->assertHasId($element);
+        }
+
         PHPUnit::assertStringContainsString("<$element", $this->rendered, "The element '$element' was not found.");
 
         return $this;

From 4fa8deab206ee06022acf5b9a842ebb6a15858ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:52:29 +0100
Subject: [PATCH 1092/4023] Set up testing helper

---
 .../tests/Unit/Views/SidebarItemsViewTest.php          | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index c2deb985986..cbbbff820cc 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -6,6 +6,9 @@
 
 use Hyde\Testing\TestCase;
 use Hyde\Testing\TestsBladeViews;
+use Hyde\Testing\Support\TestView;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * @see resources/views/components/docs/sidebar-items.blade.php
@@ -14,5 +17,10 @@ class SidebarItemsViewTest extends TestCase
 {
     use TestsBladeViews;
 
-    //
+    protected function testView(): TestView
+    {
+        return $this->test(view('hyde::components.docs.sidebar-items', [
+            'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
+        ]));
+    }
 }

From 2d9ae2aff3f0deb5b4477b4b2a5197fbe9d470cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:54:07 +0100
Subject: [PATCH 1093/4023] Test component renders

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index cbbbff820cc..f95afd79b97 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -23,4 +23,9 @@ protected function testView(): TestView
             'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
         ]));
     }
+
+    public function testComponentRenders()
+    {
+        $this->testView()->assertHasElement('#sidebar-items');
+    }
 }

From 3ebd20f8260d63f5c10511f6ed61cf583895a4d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:59:00 +0100
Subject: [PATCH 1094/4023] Mock route

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index f95afd79b97..e06fc42cff1 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -19,6 +19,8 @@ class SidebarItemsViewTest extends TestCase
 
     protected function testView(): TestView
     {
+        $this->mockRoute();
+
         return $this->test(view('hyde::components.docs.sidebar-items', [
             'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
         ]));

From 2eeed5f01a279c382920d37792d14ba0126412ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 21:59:39 +0100
Subject: [PATCH 1095/4023] Add a route to populate testing sidebar

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index e06fc42cff1..43978cc5d11 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -4,8 +4,11 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Hyde\Support\Models\Route;
 use Hyde\Testing\TestsBladeViews;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\Support\TestView;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -21,6 +24,8 @@ protected function testView(): TestView
     {
         $this->mockRoute();
 
+        Hyde::routes()->addRoute(new Route(new DocumentationPage('foo')));
+
         return $this->test(view('hyde::components.docs.sidebar-items', [
             'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),
         ]));

From a0c0726c63abfa204a6527a0c3d31fe02befcb94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 22:01:39 +0100
Subject: [PATCH 1096/4023] Add type annotation to view

---
 .../resources/views/components/docs/sidebar-items.blade.php  | 1 +
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index e06a90e94c5..f0d4cb553f0 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -6,6 +6,7 @@
     </ul>
 @else
     <ul id="sidebar-items" role="list">
+        @php /** @var \Hyde\Framework\Features\Navigation\NavGroupItem $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 43978cc5d11..2039f889c2d 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -35,4 +35,9 @@ public function testComponentRenders()
     {
         $this->testView()->assertHasElement('#sidebar-items');
     }
+
+    public function testTypeAnnotationIsNotPresentInHtml()
+    {
+        $this->testView()->assertDontSee('@var')->assertDontSee('$group');
+    }
 }

From 12dfbc4db36d2d5a89d1c583b783f8cc7601c45b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 22:09:40 +0100
Subject: [PATCH 1097/4023] Add more mock pages to test

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 2039f889c2d..08bec5bfdfc 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -25,6 +25,8 @@ protected function testView(): TestView
         $this->mockRoute();
 
         Hyde::routes()->addRoute(new Route(new DocumentationPage('foo')));
+        Hyde::routes()->addRoute(new Route(new DocumentationPage('bar')));
+        Hyde::routes()->addRoute(new Route(new DocumentationPage('baz')));
 
         return $this->test(view('hyde::components.docs.sidebar-items', [
             'sidebar' => NavigationMenuGenerator::handle(DocumentationSidebar::class),

From 361325f93418c1917ffd4875b37f1c2391f51791 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Mar 2024 22:21:21 +0100
Subject: [PATCH 1098/4023] Move mock route call to setup

---
 .../framework/tests/Unit/Views/SidebarItemsViewTest.php    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 08bec5bfdfc..f684d4fea52 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -20,10 +20,15 @@ class SidebarItemsViewTest extends TestCase
 {
     use TestsBladeViews;
 
-    protected function testView(): TestView
+    protected function setUp(): void
     {
+        parent::setUp();
+
         $this->mockRoute();
+    }
 
+    protected function testView(): TestView
+    {
         Hyde::routes()->addRoute(new Route(new DocumentationPage('foo')));
         Hyde::routes()->addRoute(new Route(new DocumentationPage('bar')));
         Hyde::routes()->addRoute(new Route(new DocumentationPage('baz')));

From 5d459401ea151ed23310803f368dc781afe54bfc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 09:53:17 +0100
Subject: [PATCH 1099/4023] Test high level active states

Granular logic belongs in child tests
---
 .../tests/Unit/Views/SidebarItemsViewTest.php | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index f684d4fea52..fe0e3846fa2 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -43,6 +43,26 @@ public function testComponentRenders()
         $this->testView()->assertHasElement('#sidebar-items');
     }
 
+    public function testViewDoesNotContainActiveStateWhenNoPageIsActive()
+    {
+        $this->testView()
+            ->assertDontSee('active')
+            ->assertDontSee('Table of contents')
+            ->assertDoesNotHaveAttribute('aria-current');
+    }
+
+    public function testViewContainsActiveStateWhenPageIsActive()
+    {
+        $this->mockCurrentPage('docs/foo');
+        $this->mockPage(new DocumentationPage('foo'));
+
+        $this->testView()
+            ->assertSee('active')
+            ->assertSee('Table of contents')
+            ->assertHasAttribute('aria-current')
+            ->assertAttributeIs('aria-current="true"');
+    }
+
     public function testTypeAnnotationIsNotPresentInHtml()
     {
         $this->testView()->assertDontSee('@var')->assertDontSee('$group');

From 627a3f261f8b591a848f17e6cc1a87025482ef75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 09:54:13 +0100
Subject: [PATCH 1100/4023] Assert see list item class

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index fe0e3846fa2..7594b96b5e3 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -40,7 +40,7 @@ protected function testView(): TestView
 
     public function testComponentRenders()
     {
-        $this->testView()->assertHasElement('#sidebar-items');
+        $this->testView()->assertHasElement('#sidebar-items')->assertSee('sidebar-item');
     }
 
     public function testViewDoesNotContainActiveStateWhenNoPageIsActive()

From 668961af4a27d28ca322677fc8de9c20713c885c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 09:56:29 +0100
Subject: [PATCH 1101/4023] Add testing helper to assert string occurrence
 count

---
 packages/testing/src/Support/TestView.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 22f0e4dac2e..30085b3c1b4 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -37,6 +37,20 @@ public function assertSeeHtmlIgnoringFormatting(string $value): static
         return $this;
     }
 
+    /**
+     * Assert that the given string is contained exactly `$times` within the view.
+     *
+     * @return $this
+     */
+    public function assertSeeTimes(string $value, int $times = 1): static
+    {
+        $count = substr_count($this->rendered, $value);
+
+        PHPUnit::assertSame($times, $count, "The string '$value' was found $count times, expected $times.");
+
+        return $this;
+    }
+
     /**
      * Assert that the given HTML element is contained within the view.
      *

From f04a46f69fe965d601b971f911e990ee8f10f48d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 09:56:41 +0100
Subject: [PATCH 1102/4023] Assert see times

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 7594b96b5e3..8ed2a1a57aa 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -40,7 +40,7 @@ protected function testView(): TestView
 
     public function testComponentRenders()
     {
-        $this->testView()->assertHasElement('#sidebar-items')->assertSee('sidebar-item');
+        $this->testView()->assertHasElement('#sidebar-items')->assertSeeTimes('sidebar-item ', 3);
     }
 
     public function testViewDoesNotContainActiveStateWhenNoPageIsActive()

From ce51a65dd7b129a5deec8c57430de42e50d4ba51 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 09:58:43 +0100
Subject: [PATCH 1103/4023] Use clearer assertion string

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 8ed2a1a57aa..8b29db4ce08 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -40,7 +40,7 @@ protected function testView(): TestView
 
     public function testComponentRenders()
     {
-        $this->testView()->assertHasElement('#sidebar-items')->assertSeeTimes('sidebar-item ', 3);
+        $this->testView()->assertHasElement('#sidebar-items')->assertSeeTimes('listitem', 3);
     }
 
     public function testViewDoesNotContainActiveStateWhenNoPageIsActive()

From 7a3ca45277d338b2bb7a4a6636cb3fc700209242 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 10:01:10 +0100
Subject: [PATCH 1104/4023] Add fluent assertion shorthand method

---
 packages/testing/src/Support/TestView.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 30085b3c1b4..2a582a45fc5 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -51,6 +51,16 @@ public function assertSeeTimes(string $value, int $times = 1): static
         return $this;
     }
 
+    /**
+     * Assert that the given string is contained exactly once within the view.
+     *
+     * @return $this
+     */
+    public function assertSeeOnce(string $value): static
+    {
+        return $this->assertSeeTimes($value, 1);
+    }
+
     /**
      * Assert that the given HTML element is contained within the view.
      *

From be2bc014c5754df51da1fce334b946ba297b4d86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 10:01:20 +0100
Subject: [PATCH 1105/4023] Remove redundant argument

---
 packages/testing/src/Support/TestView.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/testing/src/Support/TestView.php b/packages/testing/src/Support/TestView.php
index 2a582a45fc5..9ee68e7dac1 100644
--- a/packages/testing/src/Support/TestView.php
+++ b/packages/testing/src/Support/TestView.php
@@ -58,7 +58,7 @@ public function assertSeeTimes(string $value, int $times = 1): static
      */
     public function assertSeeOnce(string $value): static
     {
-        return $this->assertSeeTimes($value, 1);
+        return $this->assertSeeTimes($value);
     }
 
     /**

From 9c27a98007095a77bd845d996c54981be04fe7a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Mar 2024 10:02:16 +0100
Subject: [PATCH 1106/4023] Assert see once

---
 packages/framework/tests/Unit/Views/SidebarItemsViewTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
index 8b29db4ce08..3545491e9ac 100644
--- a/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
+++ b/packages/framework/tests/Unit/Views/SidebarItemsViewTest.php
@@ -57,8 +57,8 @@ public function testViewContainsActiveStateWhenPageIsActive()
         $this->mockPage(new DocumentationPage('foo'));
 
         $this->testView()
-            ->assertSee('active')
-            ->assertSee('Table of contents')
+            ->assertSeeOnce('active')
+            ->assertSeeOnce('Table of contents')
             ->assertHasAttribute('aria-current')
             ->assertAttributeIs('aria-current="true"');
     }

From 147618a9902bc4ec255da7e552cc092079fd6ea1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Mar 2024 19:51:51 +0100
Subject: [PATCH 1107/4023] Breaking: Rename HTML ID `#searchMenu` to
 `#search-menu`

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index b44d81327c0..8badf9517fc 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -26,7 +26,7 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
 
 <div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog"
      class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
-    <aside x-on:click.away="searchWindowOpen = false" id="searchMenu"
+    <aside x-on:click.away="searchWindowOpen = false" id="search-menu"
            class="prose dark:prose-invert bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
         <header class="flex justify-between pb-3 mb-3 border-b dark:border-gray-700 md:hidden">
             <strong>Search the documentation site</strong>

From 5a71241232502a1035eb57aa555dcfb6c67ba794 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Mar 2024 19:55:01 +0100
Subject: [PATCH 1108/4023] Breaking: Rename HTML ID `#searchMenuButton` to
 `#search-menu-button`

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 .../resources/views/pages/documentation-search.blade.php        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 8badf9517fc..6a258d07479 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -1,4 +1,4 @@
-<button id="searchMenuButton" x-on:click="searchWindowOpen = ! searchWindowOpen"
+<button id="search-menu-button" x-on:click="searchWindowOpen = ! searchWindowOpen"
         :title="searchWindowOpen ? 'Close search window' : 'Open search window'; $nextTick(() => { setTimeout(() => { document.getElementById('search-input').focus(); }); });"
         class="absolute right-4 top-4 mr-4 z-10 opacity-75 hover:opacity-100 hidden md:block"
         aria-label="Toggle search window">
diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/documentation-search.blade.php
index d30b4b7da16..c50683276d6 100644
--- a/packages/framework/resources/views/pages/documentation-search.blade.php
+++ b/packages/framework/resources/views/pages/documentation-search.blade.php
@@ -1,7 +1,7 @@
 @extends('hyde::layouts.docs')
 @section('content')
     <h1>Search the documentation site</h1>
-    <style>#searchMenuButton, .edit-page-link {
+    <style>#search-menu-button, .edit-page-link {
             display: none !important;
         }
 

From be0f780dbee28aa51a22a3f32808e0254c35630f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Mar 2024 19:55:53 +0100
Subject: [PATCH 1109/4023] Breaking: Rename HTML ID `#searchMenuButtonMobile`
 to `#search-menu-button-mobile`

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 6a258d07479..43f3ee46928 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -14,7 +14,7 @@ class="absolute right-4 top-4 mr-4 z-10 opacity-75 hover:opacity-100 hidden md:b
         </svg>
     </span>
 </button>
-<button id="searchMenuButtonMobile" x-on:click="searchWindowOpen = ! searchWindowOpen"
+<button id="search-menu-button-mobile" x-on:click="searchWindowOpen = ! searchWindowOpen"
         :title="searchWindowOpen ? 'Close search window' : 'Open search window'; $nextTick(() => { setTimeout(() => { document.getElementById('search-input').focus(); }); });"
         class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 hover:opacity-100 fill-black bg-gray-200 dark:fill-gray-200 dark:bg-gray-700"
         aria-label="Toggle search menu">

From 111fa9cfddf9cfb2b2dfd9cd6a7e8742733f4a43 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Mar 2024 19:57:56 +0100
Subject: [PATCH 1110/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c892160609f..336aaf694bf 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -69,6 +69,17 @@ If you have previously used this method directly and expected a string to be ret
 
 If you want to retain the previous state where a string is always returned, you can use the new `NavItem::getLink()` method instead, which will resolve the route immediately.
 
+### HTML ID changes
+
+Some HTML IDs have been renamed to follow a more consistent naming convention.
+
+If you have used any of the following selectors in custom code you wrote yourself, you will need to update to use the new changed IDs.
+
+- Rename HTML ID `#searchMenu` to `#search-menu`
+- Rename HTML ID `#searchMenuButton` to `#search-menu-button`
+- Rename HTML ID `#searchMenuButtonMobile` to `#search-menu-button-mobile`
+
+
 ### New documentation search implementation
 
 As the new documentation search implementation brings changes to their code API you may need to adapt your code

From c6855f06542da6df9c00960a3d2b040c4ce5d378 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 18 Mar 2024 19:59:29 +0100
Subject: [PATCH 1111/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 336aaf694bf..01955fff841 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -75,6 +75,7 @@ Some HTML IDs have been renamed to follow a more consistent naming convention.
 
 If you have used any of the following selectors in custom code you wrote yourself, you will need to update to use the new changed IDs.
 
+#### https://github.com/hydephp/develop/pull/1622
 - Rename HTML ID `#searchMenu` to `#search-menu`
 - Rename HTML ID `#searchMenuButton` to `#search-menu-button`
 - Rename HTML ID `#searchMenuButtonMobile` to `#search-menu-button-mobile`

From 686d1b9a40ce680a5deef97f004099ff4f7d4505 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 19 Mar 2024 12:12:47 +0100
Subject: [PATCH 1112/4023] Remove low priority todo

This would not reduce complexity, just move it to the view where it is harder to test
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 64ed8edd555..8d1d2567c29 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -88,8 +88,6 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be active.
 
-        // Todo: It may make more sense to handle this logic in the view, as it's a UI concern and this is a data model.
-
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
         $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item instanceof NavGroupItem);

From 965ea5ccefe0b9babad0dda5c2a95ae9fb761c37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 19 Mar 2024 12:13:44 +0100
Subject: [PATCH 1113/4023] Clarify code documentation

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8d1d2567c29..ba3926e83db 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -86,7 +86,7 @@ private function isCurrentPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        // Unless the index page has a specific group set, the first group in the sidebar should be active.
+        // Unless the index page has a specific group set, the first group in the sidebar should be active when on the index page.
 
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 

From 5a36521ce397b0cd4b7085f38b4fa73789c606c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 16:43:49 +0100
Subject: [PATCH 1114/4023] Remove deprecated backwards compatibility

I'd rather ship another breaking change than introduce a deprecation in a new major version
---
 .../Navigation/DocumentationSidebar.php       |  5 ----
 .../Views/SidebarFooterTextViewTest.php       |  9 ------
 .../Unit/DocumentationSidebarUnitTest.php     | 28 -------------------
 3 files changed, 42 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ba3926e83db..0698d8c9790 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -41,11 +41,6 @@ public function getFooter(): ?string
             return $option;
         }
 
-        if ($option === true) {
-            /** @deprecated Backwards compatibility */
-            return '[Back to home page](../)';
-        }
-
         return null;
     }
 
diff --git a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
index 717997f5442..a2347c3ad66 100644
--- a/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarFooterTextViewTest.php
@@ -20,15 +20,6 @@ public function testSidebarFooterTextViewWithDefaultConfig()
         $view->assertSeeHtml('<a href="../">Back to home page</a>');
     }
 
-    public function testSidebarFooterTextViewWhenConfigOptionIsTrue()
-    {
-        Config::set('docs.sidebar.footer', true);
-
-        $view = $this->view(view('hyde::components.docs.sidebar-footer-text', $this->withSidebar()));
-
-        $view->assertSeeHtml('<a href="../">Back to home page</a>');
-    }
-
     public function testSidebarFooterTextViewWhenConfigOptionIsMarkdownString()
     {
         Config::set('docs.sidebar.footer', 'Your Markdown String Here');
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 8e1a5d3457e..968515677bd 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -150,20 +150,6 @@ public function testGetFooterReturnsStringWhenConfigIsString()
         $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooter());
     }
 
-    public function testGetFooterReturnsBackLinkWhenConfigIsTrue()
-    {
-        self::mockConfig(['docs.sidebar.footer' => true]);
-
-        $this->assertSame('[Back to home page](../)', (new DocumentationSidebar())->getFooter());
-    }
-
-    public function testGetFooterReturnsNullWhenConfigIsFalse()
-    {
-        self::mockConfig(['docs.sidebar.footer' => false]);
-
-        $this->assertNull((new DocumentationSidebar())->getFooter());
-    }
-
     public function testIsCollapsibleReturnsTrueByDefault()
     {
         self::mockConfig();
@@ -199,20 +185,6 @@ public function testHasFooterReturnsTrueWhenConfigIsString()
         $this->assertTrue((new DocumentationSidebar())->hasFooter());
     }
 
-    public function testHasFooterReturnsTrueWhenConfigIsTrue()
-    {
-        self::mockConfig(['docs.sidebar.footer' => true]);
-
-        $this->assertTrue((new DocumentationSidebar())->hasFooter());
-    }
-
-    public function testHasFooterReturnsFalseWhenConfigIsFalse()
-    {
-        self::mockConfig(['docs.sidebar.footer' => false]);
-
-        $this->assertFalse((new DocumentationSidebar())->hasFooter());
-    }
-
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());

From 51ccdf9b776a741840dce4b8e80c955b9115bc7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 16:55:12 +0100
Subject: [PATCH 1115/4023] Simplify method return

---
 .../Features/Navigation/DocumentationSidebar.php          | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0698d8c9790..bec3d72f6d5 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -35,13 +35,7 @@ public function getHeader(): string
 
     public function getFooter(): ?string
     {
-        $option = Config::get('docs.sidebar.footer', '[Back to home page](../)');
-
-        if (is_string($option)) {
-            return $option;
-        }
-
-        return null;
+        return Config::getNullableString('docs.sidebar.footer', '[Back to home page](../)');
     }
 
     public function hasFooter(): bool

From ea180812679bb94ae2543d52851709de268438a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 17:02:53 +0100
Subject: [PATCH 1116/4023] Support setting sidebar footer to false to disable
 it

Revert "Simplify method return"

This reverts commit 51ccdf9b776a741840dce4b8e80c955b9115bc7d.

Apply fixes from StyleCI
---
 .../Features/Navigation/DocumentationSidebar.php   |  8 +++++++-
 .../tests/Unit/DocumentationSidebarUnitTest.php    | 14 ++++++++++++++
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index bec3d72f6d5..0698d8c9790 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -35,7 +35,13 @@ public function getHeader(): string
 
     public function getFooter(): ?string
     {
-        return Config::getNullableString('docs.sidebar.footer', '[Back to home page](../)');
+        $option = Config::get('docs.sidebar.footer', '[Back to home page](../)');
+
+        if (is_string($option)) {
+            return $option;
+        }
+
+        return null;
     }
 
     public function hasFooter(): bool
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 968515677bd..c74453e4ba5 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -150,6 +150,13 @@ public function testGetFooterReturnsStringWhenConfigIsString()
         $this->assertSame('Some footer content', (new DocumentationSidebar())->getFooter());
     }
 
+    public function testGetFooterReturnsNullWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.footer' => false]);
+
+        $this->assertNull((new DocumentationSidebar())->getFooter());
+    }
+
     public function testIsCollapsibleReturnsTrueByDefault()
     {
         self::mockConfig();
@@ -185,6 +192,13 @@ public function testHasFooterReturnsTrueWhenConfigIsString()
         $this->assertTrue((new DocumentationSidebar())->hasFooter());
     }
 
+    public function testHasFooterReturnsFalseWhenConfigIsFalse()
+    {
+        self::mockConfig(['docs.sidebar.footer' => false]);
+
+        $this->assertFalse((new DocumentationSidebar())->hasFooter());
+    }
+
     public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
     {
         $this->assertFalse((new DocumentationSidebar())->hasGroups());

From dc6090f1570ce617aace88530deca9aff8f7a2a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 19:53:29 +0100
Subject: [PATCH 1117/4023] Set default group value to null

---
 .../framework/src/Framework/Features/Navigation/NavItem.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index a9cd1a6ca48..b0a04173ca6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -26,7 +26,7 @@ class NavItem implements Stringable
     protected ?Route $route;
     protected string $label;
     protected int $priority;
-    protected ?string $group;
+    protected ?string $group = null;
 
     /** @deprecated Use NavGroupItem::$items instead */
     protected array $items = [];

From 8bb37e61ce9c47cf6274fa1a07758de7dbace23c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 19:50:17 +0100
Subject: [PATCH 1118/4023] Only construct group if it is not null

---
 .../framework/src/Framework/Features/Navigation/NavItem.php  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index b0a04173ca6..69f26975cf0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -48,7 +48,10 @@ public function __construct(Route|string|null $destination, string $label, int $
         $this->route = $destination;
         $this->label = $label;
         $this->priority = $priority;
-        $this->group = static::normalizeGroupKey($group);
+
+        if ($group !== null) {
+            $this->group = static::normalizeGroupKey($group);
+        }
     }
 
     /**

From fdf5b0e498d928f152510f8b4dcaefe71da05c57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 19:50:48 +0100
Subject: [PATCH 1119/4023] Remove null handling from normalization helper

---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 69f26975cf0..884dde190b9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -155,8 +155,8 @@ public function isActive(): bool
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
-    protected static function normalizeGroupKey(?string $group): ?string
+    protected static function normalizeGroupKey(string $group): string
     {
-        return $group ? Str::slug($group) : null;
+        return Str::slug($group);
     }
 }

From 40a1e1f5609e0ee1b98f06869de7ea294f4f9bb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 19:55:43 +0100
Subject: [PATCH 1120/4023] Remove deprecated items array

---
 .../framework/src/Framework/Features/Navigation/NavItem.php    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 884dde190b9..eecd7b6d380 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -28,9 +28,6 @@ class NavItem implements Stringable
     protected int $priority;
     protected ?string $group = null;
 
-    /** @deprecated Use NavGroupItem::$items instead */
-    protected array $items = [];
-
     /**
      * Create a new navigation menu item.
      *

From 4d96b3cbe37e5256a3a83485ad033b7813d50705 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 19:59:58 +0100
Subject: [PATCH 1121/4023] Make normalization helper public

---
 .../src/Framework/Features/Navigation/NavItem.php        | 2 +-
 packages/framework/tests/Unit/NavItemTest.php            | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index eecd7b6d380..665df77770c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -152,7 +152,7 @@ public function isActive(): bool
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
-    protected static function normalizeGroupKey(string $group): string
+    public static function normalizeGroupKey(string $group): string
     {
         return Str::slug($group);
     }
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 98093b7628e..413e4d8c265 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -275,4 +275,13 @@ public function testGroupKeysAreNormalized()
         $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
         $this->assertSame('foo-bar', $item->getGroupKey());
     }
+
+    public function testNormalizeGroupKeyCreatesSlugs()
+    {
+        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('Foo Bar'));
+        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo bar'));
+        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo_bar'));
+        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo-bar'));
+        $this->assertSame('foo-bar', NavItem::normalizeGroupKey(' foo bar '));
+    }
 }

From bc566258efedda25152ea093532ac10e5e9e9f26 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:00:31 +0100
Subject: [PATCH 1122/4023] Use publicized normalization helper

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0698d8c9790..28bb987b15c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -8,7 +8,6 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
 use Illuminate\Contracts\Support\Arrayable;
-use Illuminate\Support\Str;
 
 use function app;
 use function is_string;
@@ -68,7 +67,7 @@ public function hasGroups(): bool
      */
     public function isGroupActive(string $group): bool
     {
-        $groupMatchesCurrentPageGroup = Str::slug(Render::getPage()->navigationMenuGroup()) === $group;
+        $groupMatchesCurrentPageGroup = NavItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
         $currentPageIsIndexPageAndShouldBeActive = $this->isCurrentPageIndexPage() && $this->shouldIndexPageBeActive($group);
 
         return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;

From e81c079936ba5c5187d947af8a06d5b5b0226add Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:02:27 +0100
Subject: [PATCH 1123/4023] Revert "Remove null handling from normalization
 helper"

This reverts commit fdf5b0e498d928f152510f8b4dcaefe71da05c57.
---
 .../framework/src/Framework/Features/Navigation/NavItem.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 665df77770c..7354e76d588 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -152,8 +152,8 @@ public function isActive(): bool
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
-    public static function normalizeGroupKey(string $group): string
+    public static function normalizeGroupKey(?string $group): ?string
     {
-        return Str::slug($group);
+        return $group ? Str::slug($group) : null;
     }
 }

From c6256c1bfa244404b0ea3f9d3202bcd84e76183c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:02:52 +0100
Subject: [PATCH 1124/4023] Test normalize group key returns null for null

---
 packages/framework/tests/Unit/NavItemTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavItemTest.php
index 413e4d8c265..d38214d425e 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavItemTest.php
@@ -284,4 +284,9 @@ public function testNormalizeGroupKeyCreatesSlugs()
         $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo-bar'));
         $this->assertSame('foo-bar', NavItem::normalizeGroupKey(' foo bar '));
     }
+
+    public function testNormalizeGroupKeyReturnsNullForNull()
+    {
+        $this->assertNull(NavItem::normalizeGroupKey(null));
+    }
 }

From bccdb4a9aca1f80682bd92096fca1f3b0fb249fa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:04:20 +0100
Subject: [PATCH 1125/4023] Document conditional return type

---
 packages/framework/src/Framework/Features/Navigation/NavItem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavItem.php
index 7354e76d588..b6e4eec5ffa 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavItem.php
@@ -152,6 +152,7 @@ public function isActive(): bool
         return Hyde::currentRoute()->getLink() === $this->route->getLink();
     }
 
+    /** @return ($group is null ? null : string) */
     public static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;

From c0de62e6b8cbb17ca26c55890165771c11eb7007 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:09:26 +0100
Subject: [PATCH 1126/4023] Refactor complex boolean returns to inline variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 28bb987b15c..28e9f273d85 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -68,9 +68,12 @@ public function hasGroups(): bool
     public function isGroupActive(string $group): bool
     {
         $groupMatchesCurrentPageGroup = NavItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
-        $currentPageIsIndexPageAndShouldBeActive = $this->isCurrentPageIndexPage() && $this->shouldIndexPageBeActive($group);
 
-        return $groupMatchesCurrentPageGroup || $currentPageIsIndexPageAndShouldBeActive;
+        if ($this->isCurrentPageIndexPage()) {
+            return $this->shouldIndexPageBeActive($group) || $groupMatchesCurrentPageGroup;
+        }
+
+        return $groupMatchesCurrentPageGroup;
     }
 
     private function isCurrentPageIndexPage(): bool

From a08e0a09634d3c4359393599c724b2787f037358 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:13:07 +0100
Subject: [PATCH 1127/4023] Remove unnecessary filtering logic

We know that this is only called for sidebars with groups, and we also know all root items are then groups, so we just need the first one
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 28e9f273d85..174626238c4 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -87,7 +87,7 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
-        $firstGroupInSidebar = $this->getItems()->firstWhere(fn (NavItem $item): bool => $item instanceof NavGroupItem);
+        $firstGroupInSidebar = $this->getItems()->first();
 
         $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getGroupKey();
 

From b17ffc964ab91cb1d7cbdb8893a4fd83d3944bef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:20:02 +0100
Subject: [PATCH 1128/4023] Remove null safe operator for evaluated state

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 174626238c4..8a8f58f704f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -89,7 +89,7 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $firstGroupInSidebar = $this->getItems()->first();
 
-        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar?->getGroupKey();
+        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar->getGroupKey();
 
         return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
     }

From 6c1201122d72ac0e0472a806613d45a7db98d15b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:20:36 +0100
Subject: [PATCH 1129/4023] Use first or fail to conform state

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8a8f58f704f..9625bb9ee71 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -87,7 +87,7 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
 
-        $firstGroupInSidebar = $this->getItems()->first();
+        $firstGroupInSidebar = $this->getItems()->firstOrFail();
 
         $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar->getGroupKey();
 

From b8adcf9bd6d4042b53d1c1f5e303646cac8a70ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:24:09 +0100
Subject: [PATCH 1130/4023] Replace return expression with conditional early
 return

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 9625bb9ee71..1ad0ad2c6fc 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -85,12 +85,14 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be active when on the index page.
 
-        $indexPageHasNoSetGroup = Render::getPage()->navigationMenuGroup() === null;
+        if (Render::getPage()->navigationMenuGroup() !== null) {
+            return false;
+        }
 
         $firstGroupInSidebar = $this->getItems()->firstOrFail();
 
         $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar->getGroupKey();
 
-        return $indexPageHasNoSetGroup && $groupIsTheFirstOneInSidebar;
+        return $groupIsTheFirstOneInSidebar;
     }
 }

From 2bcbb5ac3a2dfc653b4a0e3aadda9268d6895e20 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:24:47 +0100
Subject: [PATCH 1131/4023] Inline variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1ad0ad2c6fc..85ea0f434dc 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -91,8 +91,6 @@ private function shouldIndexPageBeActive(string $group): bool
 
         $firstGroupInSidebar = $this->getItems()->firstOrFail();
 
-        $groupIsTheFirstOneInSidebar = $group === $firstGroupInSidebar->getGroupKey();
-
-        return $groupIsTheFirstOneInSidebar;
+        return $group === $firstGroupInSidebar->getGroupKey();
     }
 }

From f92df80179ff39525f2f00f056fc922d729dfd78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:44:24 +0100
Subject: [PATCH 1132/4023] Clarify code comment language

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 85ea0f434dc..578346c6190 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -83,7 +83,7 @@ private function isCurrentPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        // Unless the index page has a specific group set, the first group in the sidebar should be active when on the index page.
+        // Unless the index page has a specific group set, the first group in the sidebar should be active visiting the index page.
 
         if (Render::getPage()->navigationMenuGroup() !== null) {
             return false;

From eaa9ff9a2e817f864e5e642f96a31b3f8194b345 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:44:51 +0100
Subject: [PATCH 1133/4023] Use more fluent boolean logic

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 578346c6190..85c502e5006 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -10,6 +10,7 @@
 use Illuminate\Contracts\Support\Arrayable;
 
 use function app;
+use function filled;
 use function is_string;
 
 class DocumentationSidebar extends NavigationMenu
@@ -85,7 +86,7 @@ private function shouldIndexPageBeActive(string $group): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be active visiting the index page.
 
-        if (Render::getPage()->navigationMenuGroup() !== null) {
+        if (filled(Render::getPage()->navigationMenuGroup())) {
             return false;
         }
 

From 598ff30d2fcfb8f78ff258efd84aff18902ecf80 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:50:10 +0100
Subject: [PATCH 1134/4023] Fix grammar

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 85c502e5006..a788f745e91 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -84,7 +84,7 @@ private function isCurrentPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        // Unless the index page has a specific group set, the first group in the sidebar should be active visiting the index page.
+        // Unless the index page has a specific group set, the first group in the sidebar should be active when visiting the index page.
 
         if (filled(Render::getPage()->navigationMenuGroup())) {
             return false;

From 9c0954e3052f70eeb62b9e54fcb390c930a6c893 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:50:18 +0100
Subject: [PATCH 1135/4023] Inline variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index a788f745e91..1795a691f5c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -90,8 +90,6 @@ private function shouldIndexPageBeActive(string $group): bool
             return false;
         }
 
-        $firstGroupInSidebar = $this->getItems()->firstOrFail();
-
-        return $group === $firstGroupInSidebar->getGroupKey();
+        return $group === $this->getItems()->firstOrFail()->getGroupKey();
     }
 }

From 564be4fffe18c4a440f0bc0a9b0b3265edb372f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:50:33 +0100
Subject: [PATCH 1136/4023] Clearer language

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1795a691f5c..0da7e4a4ed6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -84,7 +84,7 @@ private function isCurrentPageIndexPage(): bool
 
     private function shouldIndexPageBeActive(string $group): bool
     {
-        // Unless the index page has a specific group set, the first group in the sidebar should be active when visiting the index page.
+        // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 
         if (filled(Render::getPage()->navigationMenuGroup())) {
             return false;

From 4aca10cd210fb4fa2184c0d8f09e7dd69fc8fc01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 20:55:48 +0100
Subject: [PATCH 1137/4023] Mark method as internal

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0da7e4a4ed6..c8bc17c9340 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,6 +62,8 @@ public function hasGroups(): bool
     /**
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
+     * @internal This method is used in the sidebar view to determine if a group should be open, and is not intended to be used in other contexts.
+     *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      *
      * We have this logic here because not all NavItem instances belong to sidebars, and we need data from both.

From b3cf0108dab7b73ea8127ea5717cc69c6bb01115 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Mar 2024 21:06:06 +0100
Subject: [PATCH 1138/4023] Breaking: Rename class NavItem to NavigationItem

---
 RELEASE_NOTES.md                              |  10 +-
 config/hyde.php                               |   2 +-
 docs/digging-deeper/navigation.md             |  18 +--
 packages/framework/config/hyde.php            |   2 +-
 .../views/layouts/navigation.blade.php        |   6 +-
 .../Navigation/DocumentationSidebar.php       |   6 +-
 .../Features/Navigation/NavGroupItem.php      |  14 +--
 .../{NavItem.php => NavigationItem.php}       |  10 +-
 .../Features/Navigation/NavigationMenu.php    |   8 +-
 .../Navigation/NavigationMenuGenerator.php    |  14 +--
 .../AutomaticNavigationConfigurationsTest.php |  16 +--
 .../tests/Feature/NavigationMenuTest.php      |  84 ++++++-------
 .../Services/DocumentationSidebarTest.php     |  42 +++----
 .../Unit/DocumentationSidebarUnitTest.php     |   6 +-
 .../framework/tests/Unit/NavGroupItemTest.php |  46 +++----
 ...p => NavigationItemIsActiveHelperTest.php} |  76 ++++++------
 ...NavItemTest.php => NavigationItemTest.php} | 112 +++++++++---------
 .../tests/Unit/NavigationMenuUnitTest.php     |   6 +-
 .../Unit/Views/NavigationLinkViewTest.php     |   4 +-
 19 files changed, 242 insertions(+), 240 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{NavItem.php => NavigationItem.php} (93%)
 rename packages/framework/tests/Unit/{NavItemIsActiveHelperTest.php => NavigationItemIsActiveHelperTest.php} (65%)
 rename packages/framework/tests/Unit/{NavItemTest.php => NavigationItemTest.php} (54%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 01955fff841..1c7e3aa81e5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -12,15 +12,15 @@ This serves two purposes:
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 - Added a new `ExternalRoute` class to represent external routes.
-- Added a new `NavItem::getLink()` method contain the previous `NavItem::getDestination()` logic, to return the link URL.
+- Added a new `NavigationItem::getLink()` method contain the previous `NavigationItem::getDestination()` logic, to return the link URL.
 
 ### Changed
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
 - Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
-- Breaking: The `NavItem` class now always stores the destination as a `Route` instance.
-- Breaking: The `NavItem::getDestination()` method now returns its `Route` instance.
+- Breaking: The `NavigationItem` class now always stores the destination as a `Route` instance.
+- Breaking: The `NavigationItem::getDestination()` method now returns its `Route` instance.
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -63,11 +63,11 @@ For more information, see https://github.com/hydephp/develop/pull/1498.
 
 ### Navigation item changes
 
-The `NavItem::getDestination()` method now returns its `Route` instance. This allows for deferring the route evaluation.
+The `NavigationItem::getDestination()` method now returns its `Route` instance. This allows for deferring the route evaluation.
 
 If you have previously used this method directly and expected a string to be returned, you may need to adapt your code to handle the new return type.
 
-If you want to retain the previous state where a string is always returned, you can use the new `NavItem::getLink()` method instead, which will resolve the route immediately.
+If you want to retain the previous state where a string is always returned, you can use the new `NavigationItem::getLink()` method instead, which will resolve the route immediately.
 
 ### HTML ID changes
 
diff --git a/config/hyde.php b/config/hyde.php
index 9cbbe1cceb3..65fa6d4394f 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -350,7 +350,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index f36a2f9a761..761506488f2 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -230,18 +230,18 @@ To remove items from being automatically added, simply add the page's route key
 
 ### Adding Custom Navigation Menu Links
 
-You can easily add custom navigation menu links similar to how we add Authors. Simply add a `NavItem` model to the `navigation.custom` array.
+You can easily add custom navigation menu links similar to how we add Authors. Simply add a `NavigationItem` model to the `navigation.custom` array.
 
-When linking to an external site, you should use the `NavItem::forLink()` method facade. The first two arguments are the
+When linking to an external site, you should use the `NavigationItem::forLink()` method facade. The first two arguments are the
 destination and label, both required. The third argument is the priority, which is optional, and defaults to `500`.
 
 ```php
 // filepath config/hyde.php
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 
 'navigation' => [
     'custom' => [
-        NavItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+        NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
     ]
 ]
 ```
@@ -314,14 +314,14 @@ use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
 Within the `BaseNavigationMenu` class, you will find the main logic for how the menus are generated,
 while the child implementations contain the extra logic tailored for their specific use cases.
 
-All the navigation menus store the menu items in their `$items` array containing instances of the `NavItem` class.
+All the navigation menus store the menu items in their `$items` array containing instances of the `NavigationItem` class.
 
-The `NavItem` class is a simple class that contains the label and URL of the menu item and is used to represent each item in the menu.
-Dropdowns are represented by `DropdownNavItem` instances, which extend the `NavItem` class and contain an array of additional `NavItem` instances.
+The `NavigationItem` class is a simple class that contains the label and URL of the menu item and is used to represent each item in the menu.
+Dropdowns are represented by `DropdownNavigationItem` instances, which extend the `NavigationItem` class and contain an array of additional `NavigationItem` instances.
 
 ```php
-use Hyde\Framework\Features\Navigation\NavItem;
-use Hyde\Framework\Features\Navigation\DropdownNavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\DropdownNavigationItem;
 ```
 
 ## The Navigation API
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 9cbbe1cceb3..65fa6d4394f 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -350,7 +350,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index a55e64b5ea1..65b50f43bf0 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -17,13 +17,15 @@
             <svg x-show="! navigationOpen" title="Open Navigation Menu" class="dark:fill-gray-200"
                  style="display: block;"
                  id="open-main-navigation-menu-icon" xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24"
-                 width="24"><title>Open Menu</title>
+                 width="24">
+                <title>Open Menu</title>
                 <path d="M0 0h24v24H0z" fill="none"/>
                 <path d="M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z"/>
             </svg>
             <svg x-show="navigationOpen" title="Close Navigation Menu" class="dark:fill-gray-200" style="display: none;"
                  id="close-main-navigation-menu-icon" xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24"
-                 width="24"><title>Close Menu</title>
+                 width="24">
+                <title>Close Menu</title>
                 <path d="M0 0h24v24H0z" fill="none"></path>
                 <path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"></path>
             </svg>
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c8bc17c9340..73a1300e338 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -56,7 +56,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavItem $item): bool => $item instanceof NavGroupItem);
+        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof NavGroupItem);
     }
 
     /**
@@ -66,11 +66,11 @@ public function hasGroups(): bool
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
      *
-     * We have this logic here because not all NavItem instances belong to sidebars, and we need data from both.
+     * We have this logic here because not all NavigationItem instances belong to sidebars, and we need data from both.
      */
     public function isGroupActive(string $group): bool
     {
-        $groupMatchesCurrentPageGroup = NavItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
+        $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
 
         if ($this->isCurrentPageIndexPage()) {
             return $this->shouldIndexPageBeActive($group) || $groupMatchesCurrentPageGroup;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
index 72bd92a3ac8..78f41e30440 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
@@ -15,9 +15,9 @@
  *
  * @todo Consider extracting trait for shared code with navigation menu class
  */
-class NavGroupItem extends NavItem
+class NavGroupItem extends NavigationItem
 {
-    /** @var array<\Hyde\Framework\Features\Navigation\NavItem> */
+    /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
 
     public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
@@ -32,7 +32,7 @@ public function __construct(string $label, array $items = [], int $priority = Na
      *
      * For the main navigation menu, this stores any dropdown items.
      *
-     * @return array<\Hyde\Framework\Features\Navigation\NavItem>
+     * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
      */
     public function getItems(): array
     {
@@ -42,7 +42,7 @@ public function getItems(): array
     /**
      * Add a navigation item to the grouped navigation item.
      */
-    public function addItem(NavItem $item): static
+    public function addItem(NavigationItem $item): static
     {
         $item->group ??= $this->group;
 
@@ -54,7 +54,7 @@ public function addItem(NavItem $item): static
     /**
      * Add multiple navigation items to the grouped navigation item.
      *
-     * @param  array<\Hyde\Framework\Features\Navigation\NavItem>  $items
+     * @param  array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items
      */
     public function addItems(array $items): static
     {
@@ -73,7 +73,7 @@ public function addItems(array $items): static
     public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {
-            return min($this->priority, collect($this->getItems())->min(fn (NavItem $child): int => $child->getPriority()));
+            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
         }
 
         return parent::getPriority();
@@ -85,7 +85,7 @@ protected function containsOnlyDocumentationPages(): bool
             return false;
         }
 
-        return collect($this->getItems())->every(function (NavItem $child): bool {
+        return collect($this->getItems())->every(function (NavigationItem $child): bool {
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
similarity index 93%
rename from packages/framework/src/Framework/Features/Navigation/NavItem.php
rename to packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index b6e4eec5ffa..c5c38c09227 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -18,10 +18,10 @@
  *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
- *   2. You can use NavItem::fromRoute() to use data from the route
- *   3. You can use NavItem::forLink() for an external or un-routed link
+ *   2. You can use NavigationItem::fromRoute() to use data from the route
+ *   3. You can use NavigationItem::forLink() for an external or un-routed link
  */
-class NavItem implements Stringable
+class NavigationItem implements Stringable
 {
     protected ?Route $route;
     protected string $label;
@@ -83,7 +83,7 @@ public static function forLink(string $href, string $label, int $priority = Navi
      * Create a new dropdown navigation menu item.
      *
      * @param  string  $label  The label of the dropdown item.
-     * @param  array<NavItem>  $items  The items to be included in the dropdown.
+     * @param  array<NavigationItem>  $items  The items to be included in the dropdown.
      * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
     public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavGroupItem
@@ -145,7 +145,7 @@ public function getGroupKey(): ?string
     }
 
     /**
-     * Check if the NavItem instance is the current page being rendered.
+     * Check if the NavigationItem instance is the current page being rendered.
      */
     public function isActive(): bool
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 979b952b95c..6876e1c003f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,7 +20,7 @@ abstract class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem> */
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected Collection $items;
 
     public function __construct(Arrayable|array $items = [])
@@ -41,7 +41,7 @@ public function __construct(Arrayable|array $items = [])
      *
      * Items are automatically sorted by their priority, falling back to the order they were added.
      *
-     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavItem>
+     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem>
      */
     public function getItems(): Collection
     {
@@ -49,13 +49,13 @@ public function getItems(): Collection
         // so any sorting we do in generator actions will only be partial. This way, we can ensure
         // that the items are always freshly sorted by their priorities when they are retrieved.
 
-        return $this->items->sortBy(fn (NavItem $item) => $item->getPriority())->values();
+        return $this->items->sortBy(fn (NavigationItem $item) => $item->getPriority())->values();
     }
 
     /**
      * Add a navigation item to the navigation menu.
      */
-    public function add(NavItem $item): void
+    public function add(NavigationItem $item): void
     {
         $this->items->push($item);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 5aacd70441e..fa15161c649 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -24,7 +24,7 @@
  */
 class NavigationMenuGenerator
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavItem> */
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavigationItem> */
     protected Collection $items;
 
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
@@ -71,7 +71,7 @@ protected function generate(): void
                 if ($this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
-                    $this->items->put($route->getRouteKey(), NavItem::forRoute($route));
+                    $this->items->put($route->getRouteKey(), NavigationItem::forRoute($route));
                 }
             }
         });
@@ -79,10 +79,10 @@ protected function generate(): void
         if ($this->generatesSidebar) {
             // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
             if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-                $this->items->push(NavItem::forRoute(DocumentationPage::home()));
+                $this->items->push(NavigationItem::forRoute(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavItem $item): void {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem $item): void {
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);
             });
@@ -133,7 +133,7 @@ protected function canGroupRoute(Route $route): bool
 
     protected function addRouteToGroup(Route $route): void
     {
-        $item = NavItem::forRoute($route);
+        $item = NavigationItem::forRoute($route);
 
         $groupName = $this->generatesSidebar ? ($item->getGroupKey() ?? 'Other') : $item->getGroupKey();
 
@@ -153,7 +153,7 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
 
         if ($group instanceof NavGroupItem) {
             return $group;
-        } elseif ($group instanceof NavItem) {
+        } elseif ($group instanceof NavigationItem) {
             // We are trying to add children to an existing navigation menu item,
             // so here we create a new instance to replace the base one, this
             // does mean we lose the destination as we can't link to them.
@@ -177,7 +177,7 @@ protected function createGroupItem(string $groupKey, string $groupName): NavGrou
 
         $priority = $this->searchForGroupPriorityInConfig($groupKey);
 
-        return NavItem::forGroup($this->normalizeGroupLabel($label), [], $priority ?? NavigationMenu::LAST);
+        return NavigationItem::forGroup($this->normalizeGroupLabel($label), [], $priority ?? NavigationMenu::LAST);
     }
 
     protected function normalizeGroupLabel(string $label): string
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index fa018501b9e..844c05ad9f2 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -17,7 +17,7 @@
 use Hyde\Support\Models\Redirect;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
@@ -33,7 +33,7 @@
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
- * @covers \Hyde\Framework\Features\Navigation\NavItem
+ * @covers \Hyde\Framework\Features\Navigation\NavigationItem
  */
 class AutomaticNavigationConfigurationsTest extends TestCase
 {
@@ -1281,7 +1281,7 @@ protected function sidebar(?array $withPages = null): AssertableNavigationMenu
     }
 }
 
-class TestNavItem
+class TestNavigationItem
 {
     public readonly string $label;
     public readonly ?string $group;
@@ -1293,7 +1293,7 @@ public function __construct(string $label, ?string $group, int $priority, array
         $this->label = $label;
         $this->group = $group;
         $this->priority = $priority;
-        $this->children = collect($children)->map(fn (NavItem $child) => $child->getLabel())->toArray();
+        $this->children = collect($children)->map(fn (NavigationItem $child) => $child->getLabel())->toArray();
     }
 
     public static function properties(): array
@@ -1319,12 +1319,12 @@ public function __construct(TestCase $test, $sidebar = false)
     /** A simplified serialized format for comparisons */
     public function state(): array
     {
-        return $this->items->map(function (NavItem $item): TestNavItem {
-            return new TestNavItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
+        return $this->items->map(function (NavigationItem $item): TestNavigationItem {
+            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
         })->toArray();
     }
 
-    public function getState(int $index): ?TestNavItem
+    public function getState(int $index): ?TestNavigationItem
     {
         return $this->state()[$index] ?? null;
     }
@@ -1345,7 +1345,7 @@ public function assertEquals(array $expected, bool $strict = false): static
                 $item = ['label' => $item];
             }
 
-            foreach (TestNavItem::properties() as $property) {
+            foreach (TestNavigationItem::properties() as $property) {
                 if ($this->getState($index) !== null) {
                     if (isset($item[$property])) {
                         $a = $item[$property];
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 2bd704cc40e..bfe6d4a7435 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -9,7 +9,7 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Collection;
@@ -29,16 +29,16 @@ public function testConstructor()
         $this->assertInstanceOf(MainNavigationMenu::class, $this->createNavigationMenu());
     }
 
-    public function testGenerateMethodCreatesCollectionOfNavItems()
+    public function testGenerateMethodCreatesCollectionOfNavigationItems()
     {
         $this->assertInstanceOf(Collection::class, $this->createNavigationMenu()->getItems());
-        $this->assertContainsOnlyInstancesOf(NavItem::class, $this->createNavigationMenu()->getItems());
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $this->createNavigationMenu()->getItems());
     }
 
     public function testGetItemsReturnsItems()
     {
         $this->assertEquals(collect([
-            NavItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute(Routes::get('index')),
         ]), $this->createNavigationMenu()->getItems());
     }
 
@@ -67,9 +67,9 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forRoute(Routes::get('foo')),
-            NavItem::forRoute(Routes::get('docs/index')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute(Routes::get('foo')),
+            NavigationItem::forRoute(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -83,8 +83,8 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forRoute(Routes::get('foo')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -93,13 +93,13 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
 
     public function testExternalLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavItem::forLink('https://example.com', 'foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::forLink('https://example.com', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forLink('https://example.com', 'foo'),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forLink('https://example.com', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -108,13 +108,13 @@ public function testExternalLinkCanBeAddedInConfig()
 
     public function testPathLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavItem::forLink('foo', 'foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::forLink('foo', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forLink('foo', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -124,16 +124,16 @@ public function testPathLinkCanBeAddedInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     {
         config(['hyde.navigation.custom' => [
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('foo', 'foo'),
+            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::forLink('foo', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('foo', 'foo'),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::forLink('foo', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -143,16 +143,16 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestination()
     {
         config(['hyde.navigation.custom' => [
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('bar', 'foo'),
+            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::forLink('bar', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forLink('foo', 'foo'),
-            NavItem::forLink('bar', 'foo'),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::forLink('bar', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -163,14 +163,14 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
     {
         $this->file('_pages/foo.md');
 
-        config(['hyde.navigation.custom' => [NavItem::forLink('bar', 'Foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::forLink('bar', 'Foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forLink('bar', 'Foo'),
-            NavItem::forRoute(Routes::get('foo')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forLink('bar', 'Foo'),
+            NavigationItem::forRoute(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -185,8 +185,8 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forRoute(Routes::get('docs/index')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -199,7 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
-        $expected = collect([NavItem::forRoute(Routes::get('index'))]);
+        $expected = collect([NavigationItem::forRoute(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
         $this->assertEquals($expected, $menu->getItems());
@@ -213,8 +213,8 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forRoute(Routes::get('foo/bar')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute(Routes::get('foo/bar')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -229,9 +229,9 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forGroup('Foo', [
-                NavItem::forRoute(Routes::get('foo/bar')),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forGroup('Foo', [
+                NavigationItem::forRoute(Routes::get('foo/bar')),
             ]),
         ]);
 
@@ -249,10 +249,10 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
-            NavItem::forRoute(Routes::get('index')),
-            NavItem::forRoute((new MarkdownPage('foo'))->getRoute()),
-            NavItem::forGroup('Bar', [
-                NavItem::forRoute((new MarkdownPage('bar/baz'))->getRoute()),
+            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::forRoute((new MarkdownPage('foo'))->getRoute()),
+            NavigationItem::forGroup('Bar', [
+                NavigationItem::forRoute((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
     }
@@ -267,7 +267,7 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         Hyde::boot();
 
         $navigation = app('navigation.main');
-        $navigation->add(new NavItem(new ExternalRoute('/foo'), 'Foo'));
+        $navigation->add(new NavigationItem(new ExternalRoute('/foo'), 'Foo'));
 
         $this->assertCount(2, $navigation->getItems());
         $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 01aa15b3430..f5bbafa28ef 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -8,7 +8,7 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Actions\ConvertsArrayToFrontMatter;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Hyde;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
@@ -23,7 +23,7 @@
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  * @covers \Hyde\Framework\Factories\Concerns\HasFactory
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
- * @covers \Hyde\Framework\Features\Navigation\NavItem
+ * @covers \Hyde\Framework\Features\Navigation\NavigationItem
  *
  * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarUnitTest
  */
@@ -86,9 +86,9 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::forRoute(Routes::get('docs/a'), priority: 999),
-                NavItem::forRoute(Routes::get('docs/b'), priority: 999),
-                NavItem::forRoute(Routes::get('docs/c'), priority: 999),
+                NavigationItem::forRoute(Routes::get('docs/a'), priority: 999),
+                NavigationItem::forRoute(Routes::get('docs/b'), priority: 999),
+                NavigationItem::forRoute(Routes::get('docs/c'), priority: 999),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -107,9 +107,9 @@ public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::forRoute(Routes::get('docs/c'), priority: 250 + 250),
-                NavItem::forRoute(Routes::get('docs/b'), priority: 250 + 251),
-                NavItem::forRoute(Routes::get('docs/a'), priority: 250 + 252),
+                NavigationItem::forRoute(Routes::get('docs/c'), priority: 250 + 250),
+                NavigationItem::forRoute(Routes::get('docs/b'), priority: 250 + 251),
+                NavigationItem::forRoute(Routes::get('docs/a'), priority: 250 + 252),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -146,9 +146,9 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
 
         $this->assertEquals(
             collect([
-                NavItem::forRoute(Routes::get('docs/first'), priority: 250 + 250),
-                NavItem::forRoute(Routes::get('docs/second'), priority: 250 + 252),
-                NavItem::forRoute(Routes::get('docs/third'), priority: 250 + 300),
+                NavigationItem::forRoute(Routes::get('docs/first'), priority: 250 + 250),
+                NavigationItem::forRoute(Routes::get('docs/second'), priority: 250 + 252),
+                NavigationItem::forRoute(Routes::get('docs/third'), priority: 250 + 300),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -195,7 +195,7 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
         Filesystem::touch('_docs/index.md');
 
         $this->assertEquals(
-            collect([NavItem::forRoute(Routes::get('docs/foo'), priority: 999)]),
+            collect([NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999)]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
@@ -267,11 +267,11 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
 
         $this->assertEquals(
             collect([
-                NavItem::forGroup('Bar', [
-                    NavItem::forRoute(Routes::get('docs/bar'), priority: 999),
+                NavigationItem::forGroup('Bar', [
+                    NavigationItem::forRoute(Routes::get('docs/bar'), priority: 999),
                 ]),
-                NavItem::forGroup('Foo', [
-                    NavItem::forRoute(Routes::get('docs/foo'), priority: 999),
+                NavigationItem::forGroup('Foo', [
+                    NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -288,9 +288,9 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
 
         $this->assertEquals(
             collect([
-                NavItem::forGroup('Foo', [
-                    NavItem::forRoute(Routes::get('docs/bar'), priority: 999),
-                    NavItem::forRoute(Routes::get('docs/foo'), priority: 999),
+                NavigationItem::forGroup('Foo', [
+                    NavigationItem::forRoute(Routes::get('docs/bar'), priority: 999),
+                    NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -312,7 +312,7 @@ public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavItem::forRoute(Routes::get('docs/index'))]),
+            collect([NavigationItem::forRoute(Routes::get('docs/index'))]),
             $sidebar->getItems()
         );
     }
@@ -325,7 +325,7 @@ public function testIndexPageNotAddedToSidebarWhenOtherPagesExist()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavItem::forRoute(Routes::get('docs/test-0'))]),
+            collect([NavigationItem::forRoute(Routes::get('docs/test-0'))]),
             $sidebar->getItems()
         );
     }
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index c74453e4ba5..b4c88dbb64b 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -7,7 +7,7 @@
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
@@ -225,8 +225,8 @@ protected function getItems(): array
         ];
     }
 
-    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    protected function item(string $destination, string $label, int $priority = 500): NavigationItem
     {
-        return new NavItem(new ExternalRoute($destination), $label, $priority);
+        return new NavigationItem(new ExternalRoute($destination), $label, $priority);
     }
 }
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/NavGroupItemTest.php
index c76f37aa346..2f98bb102f9 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/NavGroupItemTest.php
@@ -10,7 +10,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\HydeCoreExtension;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavGroupItem;
 
 /**
@@ -46,7 +46,7 @@ public function testDestinationIsAlwaysNull()
 
     public function testCanConstructWithChildren()
     {
-        $children = $this->createNavItems();
+        $children = $this->createNavigationItems();
         $item = new NavGroupItem('Foo', $children);
 
         $this->assertCount(2, $item->getItems());
@@ -55,7 +55,7 @@ public function testCanConstructWithChildren()
 
     public function testCanConstructWithChildrenWithoutRoute()
     {
-        $children = $this->createNavItems();
+        $children = $this->createNavigationItems();
         $item = new NavGroupItem('Foo', $children);
 
         $this->assertCount(2, $item->getItems());
@@ -64,7 +64,7 @@ public function testCanConstructWithChildrenWithoutRoute()
 
     public function testGetItems()
     {
-        $children = $this->createNavItems();
+        $children = $this->createNavigationItems();
         $item = new NavGroupItem('Foo', $children);
 
         $this->assertSame($children, $item->getItems());
@@ -78,7 +78,7 @@ public function testGetItemsWithNoItems()
     public function testCanAddItemToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame([$child], $group->addItem($child)->getItems());
     }
@@ -86,7 +86,7 @@ public function testCanAddItemToDropdown()
     public function testAddChildMethodReturnsSelf()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame($group, $group->addItem($child));
     }
@@ -94,7 +94,7 @@ public function testAddChildMethodReturnsSelf()
     public function testCanAddMultipleItemsToDropdown()
     {
         $group = new NavGroupItem('Foo');
-        $items = $this->createNavItems();
+        $items = $this->createNavigationItems();
 
         $this->assertSame($items, $group->addItems($items)->getItems());
     }
@@ -109,7 +109,7 @@ public function testAddChildrenMethodReturnsSelf()
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
         $group->addItem($child);
 
@@ -120,7 +120,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     {
         $group = new NavGroupItem('Foo');
-        $child = new NavItem(new Route(new MarkdownPage()), 'Bar');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $group->addItem($child);
 
@@ -140,7 +140,7 @@ public function testGetPriorityWithNoChildrenUsesGroupPriority()
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
-        $group = new NavGroupItem('Foo', [new NavItem(new Route(new MarkdownPage()), 'Bar', 100)]);
+        $group = new NavGroupItem('Foo', [new NavigationItem(new Route(new MarkdownPage()), 'Bar', 100)]);
 
         $this->assertSame(999, $group->getPriority());
     }
@@ -148,9 +148,9 @@ public function testGetPriorityWithChildrenUsesGroupPriority()
     public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
     {
         $items = [
-            new NavItem(new Route(new DocumentationPage()), 'Foo', 100),
-            new NavItem(new Route(new DocumentationPage()), 'Bar', 200),
-            new NavItem(new Route(new DocumentationPage()), 'Baz', 300),
+            new NavigationItem(new Route(new DocumentationPage()), 'Foo', 100),
+            new NavigationItem(new Route(new DocumentationPage()), 'Bar', 200),
+            new NavigationItem(new Route(new DocumentationPage()), 'Baz', 300),
         ];
 
         $this->assertSame(100, (new NavGroupItem('Foo', $items))->getPriority());
@@ -162,7 +162,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
         $group = new NavGroupItem('Foo');
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
-            $child = new NavItem(new Route(new $type()), 'Bar', 100);
+            $child = new NavigationItem(new Route(new $type()), 'Bar', 100);
             $group->addItem($child);
         }
 
@@ -171,37 +171,37 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
     public function testGetPriorityHandlesStringUrlChildGracefully()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('foo', 'Bar', 100)]))->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo', [new NavigationItem('foo', 'Bar', 100)]))->getPriority());
     }
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo', [new NavItem('https://example.com', 'Bar', 100)]))->getPriority());
+        $this->assertSame(999, (new NavGroupItem('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
     public function testForRoute()
     {
         $item = NavGroupItem::forRoute(new Route(new InMemoryPage('foo')));
 
-        $this->assertInstanceOf(NavItem::class, $item);
+        $this->assertInstanceOf(NavigationItem::class, $item);
         $this->assertNotInstanceOf(NavGroupItem::class, $item);
-        $this->assertSame(NavItem::class, $item::class);
+        $this->assertSame(NavigationItem::class, $item::class);
     }
 
     public function testForLink()
     {
         $item = NavGroupItem::forLink('foo', 'bar');
 
-        $this->assertInstanceOf(NavItem::class, $item);
+        $this->assertInstanceOf(NavigationItem::class, $item);
         $this->assertNotInstanceOf(NavGroupItem::class, $item);
-        $this->assertSame(NavItem::class, $item::class);
+        $this->assertSame(NavigationItem::class, $item::class);
     }
 
-    protected function createNavItems(): array
+    protected function createNavigationItems(): array
     {
         return [
-            new NavItem(new Route(new InMemoryPage('foo')), 'Foo'),
-            new NavItem(new Route(new InMemoryPage('bar')), 'Bar'),
+            new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo'),
+            new NavigationItem(new Route(new InMemoryPage('bar')), 'Bar'),
         ];
     }
 }
diff --git a/packages/framework/tests/Unit/NavItemIsActiveHelperTest.php b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
similarity index 65%
rename from packages/framework/tests/Unit/NavItemIsActiveHelperTest.php
rename to packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
index bbd6d82b4d2..9e861f587a9 100644
--- a/packages/framework/tests/Unit/NavItemIsActiveHelperTest.php
+++ b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
@@ -5,7 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
@@ -14,11 +14,11 @@
 use Mockery;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavItem
+ * @covers \Hyde\Framework\Features\Navigation\NavigationItem
  *
- * @see \Hyde\Framework\Testing\Unit\NavItemTest
+ * @see \Hyde\Framework\Testing\Unit\NavigationItemTest
  */
-class NavItemIsActiveHelperTest extends UnitTestCase
+class NavigationItemIsActiveHelperTest extends UnitTestCase
 {
     public static function setUpBeforeClass(): void
     {
@@ -34,205 +34,205 @@ protected function tearDown(): void
     public function testIsCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo'))->isActive());
+        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavItem::forRoute(Routes::get('index'))->isActive());
+        $this->assertTrue(NavigationItem::forRoute(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavItem::forLink('index.html', 'Home')->isActive());
+        $this->assertTrue(NavigationItem::forLink('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute(Routes::get('index'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('index.html', 'Home')->isActive());
+        $this->assertFalse(NavigationItem::forLink('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isActive());
+        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar'))->isActive());
+        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertTrue(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
+        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/baz/bar'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/baz/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNested()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverse()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forRoute($this->makeRoute('foo'))->isActive());
+        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/baz/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/baz/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('foo/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo/baz/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/baz/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('foo', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithAbsoluteLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavItem::forLink('/foo', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('/foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavItem::forLink('/foo/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('/foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavItem::forLink('/foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::forLink('/foo/bar/baz', 'foo')->isActive());
     }
 
     protected function mockRenderData(Route $route): void
diff --git a/packages/framework/tests/Unit/NavItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
similarity index 54%
rename from packages/framework/tests/Unit/NavItemTest.php
rename to packages/framework/tests/Unit/NavigationItemTest.php
index d38214d425e..a76b0c0bbb5 100644
--- a/packages/framework/tests/Unit/NavItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -7,7 +7,7 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Facades\Render;
@@ -17,14 +17,14 @@
 use Mockery;
 
 /**
- * This unit test covers the basics of the NavItem class.
+ * This unit test covers the basics of the NavigationItem class.
  * For the full feature test, see the MainNavigationMenuTest class.
  *
- * @covers \Hyde\Framework\Features\Navigation\NavItem
+ * @covers \Hyde\Framework\Features\Navigation\NavigationItem
  *
- * @see \Hyde\Framework\Testing\Unit\NavItemIsActiveHelperTest
+ * @see \Hyde\Framework\Testing\Unit\NavigationItemIsActiveHelperTest
  */
-class NavItemTest extends UnitTestCase
+class NavigationItemTest extends UnitTestCase
 {
     public static function setUpBeforeClass(): void
     {
@@ -42,7 +42,7 @@ protected function setUp(): void
     public function testConstruct()
     {
         $route = new Route(new MarkdownPage());
-        $item = new NavItem($route, 'Test', 500);
+        $item = new NavigationItem($route, 'Test', 500);
 
         $this->assertSame($route, $item->getRoute());
     }
@@ -50,19 +50,19 @@ public function testConstruct()
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());
-        $this->assertSame($route, (new NavItem($route, 'Home'))->getRoute());
+        $this->assertSame($route, (new NavigationItem($route, 'Home'))->getRoute());
     }
 
     public function testPassingRouteKeyToConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');
 
-        $this->assertSame($route, (new NavItem('index', 'Home'))->getRoute());
+        $this->assertSame($route, (new NavigationItem('index', 'Home'))->getRoute());
     }
 
     public function testPassingUrlToConstructorUsesExternalRoute()
     {
-        $item = new NavItem('https://example.com', 'Home');
+        $item = new NavigationItem('https://example.com', 'Home');
         $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
         $this->assertEquals(new ExternalRoute('https://example.com'), $item->getRoute());
         $this->assertSame('https://example.com', (string) $item->getRoute());
@@ -70,7 +70,7 @@ public function testPassingUrlToConstructorUsesExternalRoute()
 
     public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     {
-        $item = new NavItem('foo', 'Home');
+        $item = new NavigationItem('foo', 'Home');
         $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
         $this->assertSame('foo', (string) $item->getRoute());
@@ -79,39 +79,39 @@ public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     public function testGetDestination()
     {
         $route = new Route(new InMemoryPage('foo'));
-        $navItem = new NavItem($route, 'Page', 500);
+        $NavigationItem = new NavigationItem($route, 'Page', 500);
 
-        $this->assertSame($route, $navItem->getRoute());
+        $this->assertSame($route, $NavigationItem->getRoute());
     }
 
     public function testGetLink()
     {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('foo.html', $navItem->getUrl());
+        $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertSame('foo.html', $NavigationItem->getUrl());
     }
 
     public function testGetLabel()
     {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('Page', $navItem->getLabel());
+        $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertSame('Page', $NavigationItem->getLabel());
     }
 
     public function testGetPriority()
     {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame(500, $navItem->getPriority());
+        $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertSame(500, $NavigationItem->getPriority());
     }
 
     public function testGetGroup()
     {
-        $navItem = new NavItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertNull($navItem->getGroupKey());
+        $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
+        $this->assertNull($NavigationItem->getGroupKey());
     }
 
     public function testFromRoute()
     {
         $route = new Route(new MarkdownPage());
-        $item = NavItem::forRoute($route);
+        $item = NavigationItem::forRoute($route);
 
         $this->assertSame($route, $item->getRoute());
     }
@@ -120,12 +120,12 @@ public function testToString()
     {
         Render::shouldReceive('getRouteKey')->once()->andReturn('index');
 
-        $this->assertSame('index.html', (string) NavItem::forRoute(Routes::get('index')));
+        $this->assertSame('index.html', (string) NavigationItem::forRoute(Routes::get('index')));
     }
 
     public function testForLink()
     {
-        $item = NavItem::forLink('foo', 'bar');
+        $item = NavigationItem::forLink('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
         $this->assertSame('bar', $item->getLabel());
@@ -134,13 +134,13 @@ public function testForLink()
 
     public function testForLinkWithCustomPriority()
     {
-        $this->assertSame(100, NavItem::forLink('foo', 'bar', 100)->getPriority());
+        $this->assertSame(100, NavigationItem::forLink('foo', 'bar', 100)->getPriority());
     }
 
     public function testForRoute()
     {
         $route = Routes::get('404');
-        $item = NavItem::forRoute($route, 'foo');
+        $item = NavigationItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
@@ -150,7 +150,7 @@ public function testForRoute()
     public function testForIndexRoute()
     {
         $route = Routes::get('index');
-        $item = NavItem::forRoute($route, 'foo');
+        $item = NavigationItem::forRoute($route, 'foo');
 
         $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
@@ -160,52 +160,52 @@ public function testForIndexRoute()
     public function testForRouteWithRouteKey()
     {
         $this->assertEquals(
-            NavItem::forRoute(Routes::get('index'), 'foo'),
-            NavItem::forRoute('index', 'foo')
+            NavigationItem::forRoute(Routes::get('index'), 'foo'),
+            NavigationItem::forRoute('index', 'foo')
         );
     }
 
     public function testForRouteWithMissingRouteKey()
     {
         $this->expectException(RouteNotFoundException::class);
-        NavItem::forRoute('foo', 'foo');
+        NavigationItem::forRoute('foo', 'foo');
     }
 
     public function testForRouteWithCustomPriority()
     {
-        $this->assertSame(100, NavItem::forRoute(Routes::get('index'), 'foo', 100)->getPriority());
+        $this->assertSame(100, NavigationItem::forRoute(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
-    public function testRouteBasedNavItemDestinationsAreResolvedRelatively()
+    public function testRouteBasedNavigationItemDestinationsAreResolvedRelatively()
     {
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
 
-        $this->assertSame('foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar')),
             'getRouteKey' => 'foo/bar',
         ]));
 
-        $this->assertSame('../foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar/baz')),
             'getRouteKey' => 'foo/bar/baz',
         ]));
 
-        $this->assertSame('../../foo.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../../foo/bar.html', (string) NavItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../../foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../../foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
     }
 
     public function testDropdownFacade()
     {
-        $item = NavItem::forGroup('foo', []);
+        $item = NavigationItem::forGroup('foo', []);
 
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getItems());
@@ -215,17 +215,17 @@ public function testDropdownFacade()
     public function testDropdownFacadeWithChildren()
     {
         $children = [
-            new NavItem(new Route(new MarkdownPage()), 'bar'),
+            new NavigationItem(new Route(new MarkdownPage()), 'bar'),
         ];
 
-        $item = NavItem::forGroup('foo', $children);
+        $item = NavigationItem::forGroup('foo', $children);
         $this->assertSame($children, $item->getItems());
         $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()
     {
-        $item = NavItem::forGroup('foo', [], 500);
+        $item = NavigationItem::forGroup('foo', [], 500);
 
         $this->assertSame(500, $item->getPriority());
     }
@@ -236,8 +236,8 @@ public function testIsCurrent()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertTrue(NavItem::forRoute(new Route(new InMemoryPage('foo')))->isActive());
-        $this->assertFalse(NavItem::forRoute(new Route(new InMemoryPage('bar')))->isActive());
+        $this->assertTrue(NavigationItem::forRoute(new Route(new InMemoryPage('foo')))->isActive());
+        $this->assertFalse(NavigationItem::forRoute(new Route(new InMemoryPage('bar')))->isActive());
     }
 
     public function testIsCurrentWithExternalRoute()
@@ -246,47 +246,47 @@ public function testIsCurrentWithExternalRoute()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertFalse(NavItem::forLink('foo', 'bar')->isActive());
-        $this->assertFalse(NavItem::forLink('https://example.com', 'bar')->isActive());
+        $this->assertFalse(NavigationItem::forLink('foo', 'bar')->isActive());
+        $this->assertFalse(NavigationItem::forLink('https://example.com', 'bar')->isActive());
     }
 
     public function testGetGroupWithNoGroup()
     {
-        $this->assertNull((new NavItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupKey());
+        $this->assertNull((new NavigationItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupKey());
     }
 
     public function testGetGroupWithGroup()
     {
-        $this->assertSame('foo', (new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupKey());
+        $this->assertSame('foo', (new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupKey());
     }
 
     public function testGetGroupFromRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
+        $this->assertSame('foo', NavigationItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
     }
 
     public function testGetGroupForRouteWithGroup()
     {
-        $this->assertSame('foo', NavItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
+        $this->assertSame('foo', NavigationItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
     }
 
     public function testGroupKeysAreNormalized()
     {
-        $item = new NavItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
+        $item = new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
         $this->assertSame('foo-bar', $item->getGroupKey());
     }
 
     public function testNormalizeGroupKeyCreatesSlugs()
     {
-        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('Foo Bar'));
-        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo bar'));
-        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo_bar'));
-        $this->assertSame('foo-bar', NavItem::normalizeGroupKey('foo-bar'));
-        $this->assertSame('foo-bar', NavItem::normalizeGroupKey(' foo bar '));
+        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('Foo Bar'));
+        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo bar'));
+        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo_bar'));
+        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo-bar'));
+        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey(' foo bar '));
     }
 
     public function testNormalizeGroupKeyReturnsNullForNull()
     {
-        $this->assertNull(NavItem::normalizeGroupKey(null));
+        $this->assertNull(NavigationItem::normalizeGroupKey(null));
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 648bb55a092..0330f4a0916 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -7,7 +7,7 @@
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
 /**
@@ -121,8 +121,8 @@ protected function getItems(): array
         ];
     }
 
-    protected function item(string $destination, string $label, int $priority = 500): NavItem
+    protected function item(string $destination, string $label, int $priority = 500): NavigationItem
     {
-        return new NavItem(new ExternalRoute($destination), $label, $priority);
+        return new NavigationItem(new ExternalRoute($destination), $label, $priority);
     }
 }
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index da60ae2934d..5f6f27eb683 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -9,7 +9,7 @@
 use Hyde\Testing\TestsBladeViews;
 use Hyde\Testing\Support\TestView;
 use Illuminate\View\ComponentAttributeBag;
-use Hyde\Framework\Features\Navigation\NavItem;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Testing\TestCase;
 
 /**
@@ -29,7 +29,7 @@ protected function setUp(): void
     protected function testView(): TestView
     {
         return $this->view(view('hyde::components.navigation.navigation-link', [
-            'item' => NavItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
+            'item' => NavigationItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
             'attributes' => new ComponentAttributeBag(),
         ]));
     }

From e46e6c386f21e590b488b26d4d1ac65984f5196e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 10:16:02 +0100
Subject: [PATCH 1139/4023] Rename class NavGroupItem to GroupedNavigationItem

---
 .../components/docs/sidebar-items.blade.php   |  2 +-
 .../views/layouts/navigation.blade.php        |  2 +-
 .../Navigation/DocumentationSidebar.php       |  2 +-
 ...roupItem.php => GroupedNavigationItem.php} |  2 +-
 .../Features/Navigation/NavigationItem.php    |  4 +-
 .../Navigation/NavigationMenuGenerator.php    |  8 +--
 .../AutomaticNavigationConfigurationsTest.php |  4 +-
 .../Unit/DocumentationSidebarUnitTest.php     |  6 +-
 ...Test.php => GroupedNavigationItemTest.php} | 58 +++++++++----------
 9 files changed, 44 insertions(+), 44 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{NavGroupItem.php => GroupedNavigationItem.php} (98%)
 rename packages/framework/tests/Unit/{NavGroupItemTest.php => GroupedNavigationItemTest.php} (67%)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index f0d4cb553f0..2cd3f7d17ff 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -6,7 +6,7 @@
     </ul>
 @else
     <ul id="sidebar-items" role="list">
-        @php /** @var \Hyde\Framework\Features\Navigation\NavGroupItem $group */ @endphp
+        @php /** @var \Hyde\Framework\Features\Navigation\GroupedNavigationItem $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 65b50f43bf0..5b766e4a77d 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -37,7 +37,7 @@
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
-                    @if($item instanceof \Hyde\Framework\Features\Navigation\NavGroupItem)
+                    @if($item instanceof \Hyde\Framework\Features\Navigation\GroupedNavigationItem)
                         <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getItems()"/>
                     @else
                         <x-hyde::navigation.navigation-link :item="$item"/>
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 73a1300e338..971fe2abf09 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -56,7 +56,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof NavGroupItem);
+        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof GroupedNavigationItem);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
similarity index 98%
rename from packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
rename to packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index 78f41e30440..0d12290e855 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavGroupItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -15,7 +15,7 @@
  *
  * @todo Consider extracting trait for shared code with navigation menu class
  */
-class NavGroupItem extends NavigationItem
+class GroupedNavigationItem extends NavigationItem
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index c5c38c09227..e9b6ef3a9a8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -86,9 +86,9 @@ public static function forLink(string $href, string $label, int $priority = Navi
      * @param  array<NavigationItem>  $items  The items to be included in the dropdown.
      * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavGroupItem
+    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): GroupedNavigationItem
     {
-        return new NavGroupItem($label, $items, $priority);
+        return new GroupedNavigationItem($label, $items, $priority);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index fa15161c649..10d88a5e596 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -146,12 +146,12 @@ protected function addRouteToGroup(Route $route): void
         }
     }
 
-    protected function getOrCreateGroupItem(string $groupName): NavGroupItem
+    protected function getOrCreateGroupItem(string $groupName): GroupedNavigationItem
     {
         $groupKey = Str::slug($groupName);
         $group = $this->items->get($groupKey);
 
-        if ($group instanceof NavGroupItem) {
+        if ($group instanceof GroupedNavigationItem) {
             return $group;
         } elseif ($group instanceof NavigationItem) {
             // We are trying to add children to an existing navigation menu item,
@@ -161,7 +161,7 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
             // Todo: Add note in documentation about this behavior
             // Example file structure: _pages/foo.md, _pages/foo/bar.md, _pages/foo/baz.md, here the link to foo will be lost.
 
-            $item = new NavGroupItem($group->getLabel(), [], $group->getPriority());
+            $item = new GroupedNavigationItem($group->getLabel(), [], $group->getPriority());
 
             $this->items->put($groupKey, $item);
 
@@ -171,7 +171,7 @@ protected function getOrCreateGroupItem(string $groupName): NavGroupItem
         return $this->createGroupItem($groupKey, $groupName);
     }
 
-    protected function createGroupItem(string $groupKey, string $groupName): NavGroupItem
+    protected function createGroupItem(string $groupKey, string $groupName): GroupedNavigationItem
     {
         $label = $this->searchForGroupLabelInConfig($groupKey) ?? $groupName;
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 844c05ad9f2..0230e570374 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,7 +18,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\NavGroupItem;
+use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -1320,7 +1320,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavGroupItem ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof GroupedNavigationItem ? $item->getItems() : []);
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index b4c88dbb64b..dd9af5b4c06 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -8,7 +8,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\NavGroupItem;
+use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 /**
@@ -204,13 +204,13 @@ public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
         $this->assertFalse((new DocumentationSidebar())->hasGroups());
     }
 
-    public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsNavGroupItemInstance()
+    public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsGroupedNavigationItemInstance()
     {
         self::mockConfig();
         self::setupKernel();
 
         $menu = new DocumentationSidebar([
-            new NavGroupItem('foo', []),
+            new GroupedNavigationItem('foo', []),
         ]);
 
         $this->assertTrue($menu->hasGroups());
diff --git a/packages/framework/tests/Unit/NavGroupItemTest.php b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
similarity index 67%
rename from packages/framework/tests/Unit/NavGroupItemTest.php
rename to packages/framework/tests/Unit/GroupedNavigationItemTest.php
index 2f98bb102f9..282c78b5bbe 100644
--- a/packages/framework/tests/Unit/NavGroupItemTest.php
+++ b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
@@ -11,12 +11,12 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\NavGroupItem;
+use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
 
 /**
- * @covers \Hyde\Framework\Features\Navigation\NavGroupItem
+ * @covers \Hyde\Framework\Features\Navigation\GroupedNavigationItem
  */
-class NavGroupItemTest extends UnitTestCase
+class GroupedNavigationItemTest extends UnitTestCase
 {
     public static function setUpBeforeClass(): void
     {
@@ -26,28 +26,28 @@ public static function setUpBeforeClass(): void
 
     public function testCanConstruct()
     {
-        $this->assertSame('Foo', (new NavGroupItem('Foo'))->getLabel());
+        $this->assertSame('Foo', (new GroupedNavigationItem('Foo'))->getLabel());
     }
 
     public function testCanConstructWithPriority()
     {
-        $this->assertSame(500, (new NavGroupItem('Foo', priority: 500))->getPriority());
+        $this->assertSame(500, (new GroupedNavigationItem('Foo', priority: 500))->getPriority());
     }
 
     public function testDefaultPriorityValueIsLast()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
+        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
     }
 
     public function testDestinationIsAlwaysNull()
     {
-        $this->assertNull((new NavGroupItem('Foo'))->getRoute());
+        $this->assertNull((new GroupedNavigationItem('Foo'))->getRoute());
     }
 
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavigationItems();
-        $item = new NavGroupItem('Foo', $children);
+        $item = new GroupedNavigationItem('Foo', $children);
 
         $this->assertCount(2, $item->getItems());
         $this->assertSame($children, $item->getItems());
@@ -56,7 +56,7 @@ public function testCanConstructWithChildren()
     public function testCanConstructWithChildrenWithoutRoute()
     {
         $children = $this->createNavigationItems();
-        $item = new NavGroupItem('Foo', $children);
+        $item = new GroupedNavigationItem('Foo', $children);
 
         $this->assertCount(2, $item->getItems());
         $this->assertSame($children, $item->getItems());
@@ -65,19 +65,19 @@ public function testCanConstructWithChildrenWithoutRoute()
     public function testGetItems()
     {
         $children = $this->createNavigationItems();
-        $item = new NavGroupItem('Foo', $children);
+        $item = new GroupedNavigationItem('Foo', $children);
 
         $this->assertSame($children, $item->getItems());
     }
 
     public function testGetItemsWithNoItems()
     {
-        $this->assertEmpty((new NavGroupItem('Foo'))->getItems());
+        $this->assertEmpty((new GroupedNavigationItem('Foo'))->getItems());
     }
 
     public function testCanAddItemToDropdown()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame([$child], $group->addItem($child)->getItems());
@@ -85,7 +85,7 @@ public function testCanAddItemToDropdown()
 
     public function testAddChildMethodReturnsSelf()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $this->assertSame($group, $group->addItem($child));
@@ -93,7 +93,7 @@ public function testAddChildMethodReturnsSelf()
 
     public function testCanAddMultipleItemsToDropdown()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
         $items = $this->createNavigationItems();
 
         $this->assertSame($items, $group->addItems($items)->getItems());
@@ -101,14 +101,14 @@ public function testCanAddMultipleItemsToDropdown()
 
     public function testAddChildrenMethodReturnsSelf()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
 
         $this->assertSame($group, $group->addItems([]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
         $group->addItem($child);
@@ -119,7 +119,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
 
     public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $group->addItem($child);
@@ -130,17 +130,17 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
 
     public function testGetPriorityUsesDefaultPriority()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
+        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
     }
 
     public function testGetPriorityWithNoChildrenUsesGroupPriority()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo'))->getPriority());
+        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
     }
 
     public function testGetPriorityWithChildrenUsesGroupPriority()
     {
-        $group = new NavGroupItem('Foo', [new NavigationItem(new Route(new MarkdownPage()), 'Bar', 100)]);
+        $group = new GroupedNavigationItem('Foo', [new NavigationItem(new Route(new MarkdownPage()), 'Bar', 100)]);
 
         $this->assertSame(999, $group->getPriority());
     }
@@ -153,13 +153,13 @@ public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
             new NavigationItem(new Route(new DocumentationPage()), 'Baz', 300),
         ];
 
-        $this->assertSame(100, (new NavGroupItem('Foo', $items))->getPriority());
-        $this->assertSame(100, (new NavGroupItem('Foo', array_reverse($items)))->getPriority());
+        $this->assertSame(100, (new GroupedNavigationItem('Foo', $items))->getPriority());
+        $this->assertSame(100, (new GroupedNavigationItem('Foo', array_reverse($items)))->getPriority());
     }
 
     public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
     {
-        $group = new NavGroupItem('Foo');
+        $group = new GroupedNavigationItem('Foo');
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavigationItem(new Route(new $type()), 'Bar', 100);
@@ -171,29 +171,29 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
     public function testGetPriorityHandlesStringUrlChildGracefully()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo', [new NavigationItem('foo', 'Bar', 100)]))->getPriority());
+        $this->assertSame(999, (new GroupedNavigationItem('Foo', [new NavigationItem('foo', 'Bar', 100)]))->getPriority());
     }
 
     public function testGetPriorityHandlesExternalUrlChildGracefully()
     {
-        $this->assertSame(999, (new NavGroupItem('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
+        $this->assertSame(999, (new GroupedNavigationItem('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
     public function testForRoute()
     {
-        $item = NavGroupItem::forRoute(new Route(new InMemoryPage('foo')));
+        $item = GroupedNavigationItem::forRoute(new Route(new InMemoryPage('foo')));
 
         $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(NavGroupItem::class, $item);
+        $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
         $this->assertSame(NavigationItem::class, $item::class);
     }
 
     public function testForLink()
     {
-        $item = NavGroupItem::forLink('foo', 'bar');
+        $item = GroupedNavigationItem::forLink('foo', 'bar');
 
         $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(NavGroupItem::class, $item);
+        $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
         $this->assertSame(NavigationItem::class, $item::class);
     }
 

From d76e78a787c2f908a20ce1f6faf48e6056958e33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 10:55:41 +0100
Subject: [PATCH 1140/4023] Add todos for methods to refactor

---
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index e9b6ef3a9a8..fdc4918c7f5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -54,6 +54,8 @@ public function __construct(Route|string|null $destination, string $label, int $
     /**
      * Create a new navigation menu item leading to a Route instance.
      *
+     * TODO: Merge into a create method
+     *
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
@@ -73,6 +75,8 @@ public static function forRoute(Route|string $route, ?string $label = null, ?int
 
     /**
      * Create a new navigation menu item leading to an external URI.
+     *
+     * TODO: Merge into a create method
      */
     public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): self
     {
@@ -82,6 +86,8 @@ public static function forLink(string $href, string $label, int $priority = Navi
     /**
      * Create a new dropdown navigation menu item.
      *
+     * TODO: Move to GroupedNavigationItem::create()
+     *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavigationItem>  $items  The items to be included in the dropdown.
      * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.

From b629a4aa760070d61ccb5a391e8e74ce9c2bcbce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:00:36 +0100
Subject: [PATCH 1141/4023] Clarify constructor docs

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index fdc4918c7f5..fc3de7bdcb4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -29,7 +29,7 @@ class NavigationItem implements Stringable
     protected ?string $group = null;
 
     /**
-     * Create a new navigation menu item.
+     * Create a new navigation menu item with your own properties.
      *
      * @param  \Hyde\Support\Models\Route|string|null  $destination  Route instance, route key, or external URI. For dropdowns/groups, this should be null.
      * @param  string  $label  The label of the navigation item.

From 1a679f2ae2c94421c540e06add0364dbe39580c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:07:52 +0100
Subject: [PATCH 1142/4023] Sketch out new create method

---
 .../src/Framework/Features/Navigation/NavigationItem.php  | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index fc3de7bdcb4..588cb75bc27 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -51,6 +51,14 @@ public function __construct(Route|string|null $destination, string $label, int $
         }
     }
 
+    /**
+     * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
+     */
+    public static function create(): static
+    {
+        // TODO: Implement create() method.
+    }
+
     /**
      * Create a new navigation menu item leading to a Route instance.
      *

From 4ec587ce12eab0afc6b3c0bbebc393a52f8c42f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:10:52 +0100
Subject: [PATCH 1143/4023] Copy over helper method signature

---
 .../src/Framework/Features/Navigation/NavigationItem.php   | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 588cb75bc27..bc88505f60f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -53,8 +53,13 @@ public function __construct(Route|string|null $destination, string $label, int $
 
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
+     *
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key
+     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
+     * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
+     * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.
      */
-    public static function create(): static
+    public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
         // TODO: Implement create() method.
     }

From 151f6238ffdd87f3a508630ce96e04399058e5cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:12:42 +0100
Subject: [PATCH 1144/4023] Move logic to new method

---
 .../Features/Navigation/NavigationItem.php     | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index bc88505f60f..d7036e51a3c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -61,7 +61,14 @@ public function __construct(Route|string|null $destination, string $label, int $
      */
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
-        // TODO: Implement create() method.
+        $route = $route instanceof Route ? $route : Routes::getOrFail($route);
+
+        return new self(
+            $route,
+            $label ?? $route->getPage()->navigationMenuLabel(),
+            $priority ?? $route->getPage()->navigationMenuPriority(),
+            $group ?? $route->getPage()->navigationMenuGroup(),
+        );
     }
 
     /**
@@ -76,14 +83,7 @@ public static function create(Route|string $route, ?string $label = null, ?int $
      */
     public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        $route = $route instanceof Route ? $route : Routes::getOrFail($route);
-
-        return new self(
-            $route,
-            $label ?? $route->getPage()->navigationMenuLabel(),
-            $priority ?? $route->getPage()->navigationMenuPriority(),
-            $group ?? $route->getPage()->navigationMenuGroup(),
-        );
+        return self::create($route, $label, $priority, $group);
     }
 
     /**

From 98f9ac939bb4cea2fb072d2e9582bdea8e07acdd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:17:32 +0100
Subject: [PATCH 1145/4023] Change static return type to self

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index d7036e51a3c..66219b60a3f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -59,7 +59,7 @@ public function __construct(Route|string|null $destination, string $label, int $
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.
      */
-    public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): static
+    public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
         $route = $route instanceof Route ? $route : Routes::getOrFail($route);
 

From d62e3d344b7a7c77ed64a6540d8ec079c6555a2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:44:49 +0100
Subject: [PATCH 1146/4023] Replace NavigationItem `forRoute` method with
 `create`

---
 .../Features/Navigation/NavigationItem.php    | 15 ------
 .../Navigation/NavigationMenuGenerator.php    |  6 +--
 .../tests/Feature/NavigationMenuTest.php      | 44 +++++++++---------
 .../Services/DocumentationSidebarTest.php     | 32 ++++++-------
 .../tests/Unit/GroupedNavigationItemTest.php  |  4 +-
 .../Unit/NavigationItemIsActiveHelperTest.php | 26 +++++------
 .../tests/Unit/NavigationItemTest.php         | 46 +++++++++----------
 .../Unit/Views/NavigationLinkViewTest.php     |  2 +-
 8 files changed, 80 insertions(+), 95 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 66219b60a3f..61b9ce38eba 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -71,21 +71,6 @@ public static function create(Route|string $route, ?string $label = null, ?int $
         );
     }
 
-    /**
-     * Create a new navigation menu item leading to a Route instance.
-     *
-     * TODO: Merge into a create method
-     *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key
-     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
-     * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
-     * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.
-     */
-    public static function forRoute(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
-    {
-        return self::create($route, $label, $priority, $group);
-    }
-
     /**
      * Create a new navigation menu item leading to an external URI.
      *
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 10d88a5e596..cc31f8d5cff 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -71,7 +71,7 @@ protected function generate(): void
                 if ($this->canGroupRoute($route)) {
                     $this->addRouteToGroup($route);
                 } else {
-                    $this->items->put($route->getRouteKey(), NavigationItem::forRoute($route));
+                    $this->items->put($route->getRouteKey(), NavigationItem::create($route));
                 }
             }
         });
@@ -79,7 +79,7 @@ protected function generate(): void
         if ($this->generatesSidebar) {
             // If there are no pages other than the index page, we add it to the sidebar so that it's not empty
             if ($this->items->count() === 0 && DocumentationPage::home() !== null) {
-                $this->items->push(NavigationItem::forRoute(DocumentationPage::home()));
+                $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem $item): void {
@@ -133,7 +133,7 @@ protected function canGroupRoute(Route $route): bool
 
     protected function addRouteToGroup(Route $route): void
     {
-        $item = NavigationItem::forRoute($route);
+        $item = NavigationItem::create($route);
 
         $groupName = $this->generatesSidebar ? ($item->getGroupKey() ?? 'Other') : $item->getGroupKey();
 
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index bfe6d4a7435..2aa73a6e0ac 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -38,7 +38,7 @@ public function testGenerateMethodCreatesCollectionOfNavigationItems()
     public function testGetItemsReturnsItems()
     {
         $this->assertEquals(collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
         ]), $this->createNavigationMenu()->getItems());
     }
 
@@ -67,9 +67,9 @@ public function testCreatedCollectionIsSortedByNavigationMenuPriority()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
-            NavigationItem::forRoute(Routes::get('foo')),
-            NavigationItem::forRoute(Routes::get('docs/index')),
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create(Routes::get('foo')),
+            NavigationItem::create(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -83,8 +83,8 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
-            NavigationItem::forRoute(Routes::get('foo')),
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -98,7 +98,7 @@ public function testExternalLinkCanBeAddedInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forLink('https://example.com', 'foo'),
         ]);
 
@@ -113,7 +113,7 @@ public function testPathLinkCanBeAddedInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forLink('foo', 'foo'),
         ]);
 
@@ -131,7 +131,7 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfig()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forLink('foo', 'foo'),
             NavigationItem::forLink('foo', 'foo'),
         ]);
@@ -150,7 +150,7 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestina
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forLink('foo', 'foo'),
             NavigationItem::forLink('bar', 'foo'),
         ]);
@@ -168,9 +168,9 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forLink('bar', 'Foo'),
-            NavigationItem::forRoute(Routes::get('foo')),
+            NavigationItem::create(Routes::get('foo')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -185,8 +185,8 @@ public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
-            NavigationItem::forRoute(Routes::get('docs/index')),
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create(Routes::get('docs/index')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -199,7 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
-        $expected = collect([NavigationItem::forRoute(Routes::get('index'))]);
+        $expected = collect([NavigationItem::create(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
         $this->assertEquals($expected, $menu->getItems());
@@ -213,8 +213,8 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
-            NavigationItem::forRoute(Routes::get('foo/bar')),
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create(Routes::get('foo/bar')),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -229,9 +229,9 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
         $menu = $this->createNavigationMenu();
         $expected = collect([
-            NavigationItem::forRoute(Routes::get('index')),
+            NavigationItem::create(Routes::get('index')),
             NavigationItem::forGroup('Foo', [
-                NavigationItem::forRoute(Routes::get('foo/bar')),
+                NavigationItem::create(Routes::get('foo/bar')),
             ]),
         ]);
 
@@ -249,10 +249,10 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         $this->assertCount(3, $menu->getItems());
         $this->assertEquals([
-            NavigationItem::forRoute(Routes::get('index')),
-            NavigationItem::forRoute((new MarkdownPage('foo'))->getRoute()),
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create((new MarkdownPage('foo'))->getRoute()),
             NavigationItem::forGroup('Bar', [
-                NavigationItem::forRoute((new MarkdownPage('bar/baz'))->getRoute()),
+                NavigationItem::create((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
     }
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index f5bbafa28ef..454cf6ecd05 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -86,9 +86,9 @@ public function testSidebarIsOrderedAlphabeticallyWhenNoOrderIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavigationItem::forRoute(Routes::get('docs/a'), priority: 999),
-                NavigationItem::forRoute(Routes::get('docs/b'), priority: 999),
-                NavigationItem::forRoute(Routes::get('docs/c'), priority: 999),
+                NavigationItem::create(Routes::get('docs/a'), priority: 999),
+                NavigationItem::create(Routes::get('docs/b'), priority: 999),
+                NavigationItem::create(Routes::get('docs/c'), priority: 999),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -107,9 +107,9 @@ public function testSidebarIsOrderedByPriorityWhenPriorityIsSetInConfig()
 
         $this->assertEquals(
             collect([
-                NavigationItem::forRoute(Routes::get('docs/c'), priority: 250 + 250),
-                NavigationItem::forRoute(Routes::get('docs/b'), priority: 250 + 251),
-                NavigationItem::forRoute(Routes::get('docs/a'), priority: 250 + 252),
+                NavigationItem::create(Routes::get('docs/c'), priority: 250 + 250),
+                NavigationItem::create(Routes::get('docs/b'), priority: 250 + 251),
+                NavigationItem::create(Routes::get('docs/a'), priority: 250 + 252),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -146,9 +146,9 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
 
         $this->assertEquals(
             collect([
-                NavigationItem::forRoute(Routes::get('docs/first'), priority: 250 + 250),
-                NavigationItem::forRoute(Routes::get('docs/second'), priority: 250 + 252),
-                NavigationItem::forRoute(Routes::get('docs/third'), priority: 250 + 300),
+                NavigationItem::create(Routes::get('docs/first'), priority: 250 + 250),
+                NavigationItem::create(Routes::get('docs/second'), priority: 250 + 252),
+                NavigationItem::create(Routes::get('docs/third'), priority: 250 + 300),
             ]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
@@ -195,7 +195,7 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
         Filesystem::touch('_docs/index.md');
 
         $this->assertEquals(
-            collect([NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999)]),
+            collect([NavigationItem::create(Routes::get('docs/foo'), priority: 999)]),
             NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()
         );
     }
@@ -268,10 +268,10 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
         $this->assertEquals(
             collect([
                 NavigationItem::forGroup('Bar', [
-                    NavigationItem::forRoute(Routes::get('docs/bar'), priority: 999),
+                    NavigationItem::create(Routes::get('docs/bar'), priority: 999),
                 ]),
                 NavigationItem::forGroup('Foo', [
-                    NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999),
+                    NavigationItem::create(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -289,8 +289,8 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
         $this->assertEquals(
             collect([
                 NavigationItem::forGroup('Foo', [
-                    NavigationItem::forRoute(Routes::get('docs/bar'), priority: 999),
-                    NavigationItem::forRoute(Routes::get('docs/foo'), priority: 999),
+                    NavigationItem::create(Routes::get('docs/bar'), priority: 999),
+                    NavigationItem::create(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
             $sidebar->getItems()
@@ -312,7 +312,7 @@ public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavigationItem::forRoute(Routes::get('docs/index'))]),
+            collect([NavigationItem::create(Routes::get('docs/index'))]),
             $sidebar->getItems()
         );
     }
@@ -325,7 +325,7 @@ public function testIndexPageNotAddedToSidebarWhenOtherPagesExist()
 
         $this->assertCount(1, $sidebar->getItems());
         $this->assertEquals(
-            collect([NavigationItem::forRoute(Routes::get('docs/test-0'))]),
+            collect([NavigationItem::create(Routes::get('docs/test-0'))]),
             $sidebar->getItems()
         );
     }
diff --git a/packages/framework/tests/Unit/GroupedNavigationItemTest.php b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
index 282c78b5bbe..fdc9f2b3f2b 100644
--- a/packages/framework/tests/Unit/GroupedNavigationItemTest.php
+++ b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
@@ -179,9 +179,9 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
         $this->assertSame(999, (new GroupedNavigationItem('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
-    public function testForRoute()
+    public function testCreate()
     {
-        $item = GroupedNavigationItem::forRoute(new Route(new InMemoryPage('foo')));
+        $item = GroupedNavigationItem::create(new Route(new InMemoryPage('foo')));
 
         $this->assertInstanceOf(NavigationItem::class, $item);
         $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
diff --git a/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
index 9e861f587a9..b5a089ff0db 100644
--- a/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
+++ b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
@@ -34,19 +34,19 @@ protected function tearDown(): void
     public function testIsCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo'))->isActive());
+        $this->assertTrue(NavigationItem::create($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavigationItem::forRoute(Routes::get('index'))->isActive());
+        $this->assertTrue(NavigationItem::create(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLink()
@@ -58,13 +58,13 @@ public function testIsCurrentUsingCurrentLink()
     public function testIsCurrentWhenNotCurrent()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentRoute()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forRoute(Routes::get('index'))->isActive());
+        $this->assertFalse(NavigationItem::create(Routes::get('index'))->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLink()
@@ -76,49 +76,49 @@ public function testIsCurrentUsingNotCurrentLink()
     public function testIsCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('bar'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar'))->isActive());
+        $this->assertTrue(NavigationItem::create($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar'))->isActive());
+        $this->assertTrue(NavigationItem::create($this->makeRoute('foo/bar'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/baz'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('foo/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertTrue(NavigationItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
+        $this->assertTrue(NavigationItem::create($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNested()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/baz/bar'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('foo/baz/bar'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNested()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo/bar/baz'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('foo/bar/baz'))->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverse()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forRoute($this->makeRoute('foo'))->isActive());
+        $this->assertFalse(NavigationItem::create($this->makeRoute('foo'))->isActive());
     }
 
     public function testIsCurrentUsingCurrentLinkWithNestedCurrentPage()
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index a76b0c0bbb5..fe3f5c35d10 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -111,7 +111,7 @@ public function testGetGroup()
     public function testFromRoute()
     {
         $route = new Route(new MarkdownPage());
-        $item = NavigationItem::forRoute($route);
+        $item = NavigationItem::create($route);
 
         $this->assertSame($route, $item->getRoute());
     }
@@ -120,7 +120,7 @@ public function testToString()
     {
         Render::shouldReceive('getRouteKey')->once()->andReturn('index');
 
-        $this->assertSame('index.html', (string) NavigationItem::forRoute(Routes::get('index')));
+        $this->assertSame('index.html', (string) NavigationItem::create(Routes::get('index')));
     }
 
     public function testForLink()
@@ -137,10 +137,10 @@ public function testForLinkWithCustomPriority()
         $this->assertSame(100, NavigationItem::forLink('foo', 'bar', 100)->getPriority());
     }
 
-    public function testForRoute()
+    public function testCreate()
     {
         $route = Routes::get('404');
-        $item = NavigationItem::forRoute($route, 'foo');
+        $item = NavigationItem::create($route, 'foo');
 
         $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
@@ -150,30 +150,30 @@ public function testForRoute()
     public function testForIndexRoute()
     {
         $route = Routes::get('index');
-        $item = NavigationItem::forRoute($route, 'foo');
+        $item = NavigationItem::create($route, 'foo');
 
         $this->assertSame($route, $item->getRoute());
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
     }
 
-    public function testForRouteWithRouteKey()
+    public function testCreateWithRouteKey()
     {
         $this->assertEquals(
-            NavigationItem::forRoute(Routes::get('index'), 'foo'),
-            NavigationItem::forRoute('index', 'foo')
+            NavigationItem::create(Routes::get('index'), 'foo'),
+            NavigationItem::create('index', 'foo')
         );
     }
 
-    public function testForRouteWithMissingRouteKey()
+    public function testCreateWithMissingRouteKey()
     {
         $this->expectException(RouteNotFoundException::class);
-        NavigationItem::forRoute('foo', 'foo');
+        NavigationItem::create('foo', 'foo');
     }
 
-    public function testForRouteWithCustomPriority()
+    public function testCreateWithCustomPriority()
     {
-        $this->assertSame(100, NavigationItem::forRoute(Routes::get('index'), 'foo', 100)->getPriority());
+        $this->assertSame(100, NavigationItem::create(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
     public function testRouteBasedNavigationItemDestinationsAreResolvedRelatively()
@@ -183,24 +183,24 @@ public function testRouteBasedNavigationItemDestinationsAreResolvedRelatively()
             'getRouteKey' => 'foo',
         ]));
 
-        $this->assertSame('foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('foo.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('foo/bar.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar')),
             'getRouteKey' => 'foo/bar',
         ]));
 
-        $this->assertSame('../foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../foo.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../foo/bar.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo/bar'))));
 
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo/bar/baz')),
             'getRouteKey' => 'foo/bar/baz',
         ]));
 
-        $this->assertSame('../../foo.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo'))));
-        $this->assertSame('../../foo/bar.html', (string) NavigationItem::forRoute(new Route(new InMemoryPage('foo/bar'))));
+        $this->assertSame('../../foo.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo'))));
+        $this->assertSame('../../foo/bar.html', (string) NavigationItem::create(new Route(new InMemoryPage('foo/bar'))));
     }
 
     public function testDropdownFacade()
@@ -236,8 +236,8 @@ public function testIsCurrent()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertTrue(NavigationItem::forRoute(new Route(new InMemoryPage('foo')))->isActive());
-        $this->assertFalse(NavigationItem::forRoute(new Route(new InMemoryPage('bar')))->isActive());
+        $this->assertTrue(NavigationItem::create(new Route(new InMemoryPage('foo')))->isActive());
+        $this->assertFalse(NavigationItem::create(new Route(new InMemoryPage('bar')))->isActive());
     }
 
     public function testIsCurrentWithExternalRoute()
@@ -262,12 +262,12 @@ public function testGetGroupWithGroup()
 
     public function testGetGroupFromRouteWithGroup()
     {
-        $this->assertSame('foo', NavigationItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
+        $this->assertSame('foo', NavigationItem::create(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
     }
 
-    public function testGetGroupForRouteWithGroup()
+    public function testGetGroupCreateWithGroup()
     {
-        $this->assertSame('foo', NavigationItem::forRoute(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
+        $this->assertSame('foo', NavigationItem::create(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
     }
 
     public function testGroupKeysAreNormalized()
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 5f6f27eb683..de571ed18df 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -29,7 +29,7 @@ protected function setUp(): void
     protected function testView(): TestView
     {
         return $this->view(view('hyde::components.navigation.navigation-link', [
-            'item' => NavigationItem::forRoute(new Route(new InMemoryPage('foo')), 'Foo'),
+            'item' => NavigationItem::create(new Route(new InMemoryPage('foo')), 'Foo'),
             'attributes' => new ComponentAttributeBag(),
         ]));
     }

From a3659dd3cde634bee8f56f2fe0c86bdd62367a91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 11:49:24 +0100
Subject: [PATCH 1147/4023] Resolve route data only for routes

---
 .../Features/Navigation/NavigationItem.php         | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 61b9ce38eba..6449710a636 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -63,12 +63,14 @@ public static function create(Route|string $route, ?string $label = null, ?int $
     {
         $route = $route instanceof Route ? $route : Routes::getOrFail($route);
 
-        return new self(
-            $route,
-            $label ?? $route->getPage()->navigationMenuLabel(),
-            $priority ?? $route->getPage()->navigationMenuPriority(),
-            $group ?? $route->getPage()->navigationMenuGroup(),
-        );
+        if ($route instanceof Route) {
+            return new self(
+                $route,
+                $label ?? $route->getPage()->navigationMenuLabel(),
+                $priority ?? $route->getPage()->navigationMenuPriority(),
+                $group ?? $route->getPage()->navigationMenuGroup(),
+            );
+        }
     }
 
     /**

From 374fba7503be5974e85ac8f9acde6b0253fee30d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:04:30 +0100
Subject: [PATCH 1148/4023] Replace ternary assignment with if else block

---
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 6449710a636..50b6f1734d8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -61,7 +61,11 @@ public function __construct(Route|string|null $destination, string $label, int $
      */
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        $route = $route instanceof Route ? $route : Routes::getOrFail($route);
+        if ($route instanceof Route) {
+            $route = $route;
+        } else {
+            $route = Routes::getOrFail($route);
+        }
 
         if ($route instanceof Route) {
             return new self(

From 13d7d4690f649bc4e2e8f73ec52b4a6d3e64b459 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:07:12 +0100
Subject: [PATCH 1149/4023] Simplify if else block

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 50b6f1734d8..bdb5c0c0d9b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -61,9 +61,7 @@ public function __construct(Route|string|null $destination, string $label, int $
      */
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        if ($route instanceof Route) {
-            $route = $route;
-        } else {
+        if (! $route instanceof Route) {
             $route = Routes::getOrFail($route);
         }
 

From 7369f827e154807f5f3672b65d7595f492580a3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:10:37 +0100
Subject: [PATCH 1150/4023] Use get instead of get or fail

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index bdb5c0c0d9b..31aa5aef289 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -62,7 +62,7 @@ public function __construct(Route|string|null $destination, string $label, int $
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
         if (! $route instanceof Route) {
-            $route = Routes::getOrFail($route);
+            $route = Routes::get($route);
         }
 
         if ($route instanceof Route) {

From 6139fd79209a6dd319557841fac7876532e06876 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:12:03 +0100
Subject: [PATCH 1151/4023] Add auxiliary type check

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 31aa5aef289..3f65865e6d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -65,7 +65,7 @@ public static function create(Route|string $route, ?string $label = null, ?int $
             $route = Routes::get($route);
         }
 
-        if ($route instanceof Route) {
+        if ($route instanceof Route && ! $route instanceof ExternalRoute) {
             return new self(
                 $route,
                 $label ?? $route->getPage()->navigationMenuLabel(),

From 54b6c77f84fcf5c6896ea8823baf5c8a731e7483 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:12:21 +0100
Subject: [PATCH 1152/4023] Null coalesce to external route

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 3f65865e6d2..aa1e97af2c1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -62,7 +62,7 @@ public function __construct(Route|string|null $destination, string $label, int $
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
         if (! $route instanceof Route) {
-            $route = Routes::get($route);
+            $route = Routes::get($route) ?? new ExternalRoute($route);
         }
 
         if ($route instanceof Route && ! $route instanceof ExternalRoute) {

From bece9050181da55f13d3f9d81d565254335bdc1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:12:48 +0100
Subject: [PATCH 1153/4023] Add default branch to return new self

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index aa1e97af2c1..ae590057f25 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -73,6 +73,8 @@ public static function create(Route|string $route, ?string $label = null, ?int $
                 $group ?? $route->getPage()->navigationMenuGroup(),
             );
         }
+
+        return new self($route, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**

From 62a01c754159c2761af6e741b3a1e84a144ac812 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:13:51 +0100
Subject: [PATCH 1154/4023] Expect external route instead of exception

---
 packages/framework/tests/Unit/NavigationItemTest.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index fe3f5c35d10..1c48e6cf307 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -6,7 +6,6 @@
 
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\MarkdownPage;
@@ -167,8 +166,7 @@ public function testCreateWithRouteKey()
 
     public function testCreateWithMissingRouteKey()
     {
-        $this->expectException(RouteNotFoundException::class);
-        NavigationItem::create('foo', 'foo');
+        $this->assertInstanceOf(ExternalRoute::class, NavigationItem::create('foo', 'foo')->getRoute());
     }
 
     public function testCreateWithCustomPriority()

From d521a1360ab0c716498bd69f43650d276de25f15 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:37:20 +0100
Subject: [PATCH 1155/4023] Update helper to defer to new create method

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ae590057f25..f4fa5a7eed9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -84,7 +84,7 @@ public static function create(Route|string $route, ?string $label = null, ?int $
      */
     public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): self
     {
-        return new self($href, $label, $priority);
+        return self::create($href, $label, $priority);
     }
 
     /**

From c9088b37f24bf855698eed91f73c76934363d54e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:44:30 +0100
Subject: [PATCH 1156/4023] Update test names

---
 packages/framework/tests/Unit/GroupedNavigationItemTest.php | 2 +-
 packages/framework/tests/Unit/NavigationItemTest.php        | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/GroupedNavigationItemTest.php b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
index fdc9f2b3f2b..7647f536819 100644
--- a/packages/framework/tests/Unit/GroupedNavigationItemTest.php
+++ b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
@@ -188,7 +188,7 @@ public function testCreate()
         $this->assertSame(NavigationItem::class, $item::class);
     }
 
-    public function testForLink()
+    public function testCreateWithLink()
     {
         $item = GroupedNavigationItem::forLink('foo', 'bar');
 
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 1c48e6cf307..9825faba539 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -122,7 +122,7 @@ public function testToString()
         $this->assertSame('index.html', (string) NavigationItem::create(Routes::get('index')));
     }
 
-    public function testForLink()
+    public function testCreateWithLink()
     {
         $item = NavigationItem::forLink('foo', 'bar');
 
@@ -131,7 +131,7 @@ public function testForLink()
         $this->assertSame(500, $item->getPriority());
     }
 
-    public function testForLinkWithCustomPriority()
+    public function testCreateWithLinkWithCustomPriority()
     {
         $this->assertSame(100, NavigationItem::forLink('foo', 'bar', 100)->getPriority());
     }

From 83c57f076a914ae1f878ea8cf62d33fe50100d7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:45:52 +0100
Subject: [PATCH 1157/4023] Replace NavigationItem `forLink` method with
 `create`

---
 config/hyde.php                               |  2 +-
 docs/digging-deeper/navigation.md             |  4 +-
 packages/framework/config/hyde.php            |  2 +-
 .../Features/Navigation/NavigationItem.php    | 12 +-----
 .../tests/Feature/NavigationMenuTest.php      | 28 ++++++-------
 .../tests/Unit/GroupedNavigationItemTest.php  |  2 +-
 .../Unit/NavigationItemIsActiveHelperTest.php | 42 +++++++++----------
 .../tests/Unit/NavigationItemTest.php         |  8 ++--
 8 files changed, 45 insertions(+), 55 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 65fa6d4394f..c91370adce7 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -350,7 +350,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 761506488f2..b904b37bbbd 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -232,7 +232,7 @@ To remove items from being automatically added, simply add the page's route key
 
 You can easily add custom navigation menu links similar to how we add Authors. Simply add a `NavigationItem` model to the `navigation.custom` array.
 
-When linking to an external site, you should use the `NavigationItem::forLink()` method facade. The first two arguments are the
+When linking to an external site, you should use the `NavigationItem::create()` method facade. The first two arguments are the
 destination and label, both required. The third argument is the priority, which is optional, and defaults to `500`.
 
 ```php
@@ -241,7 +241,7 @@ use Hyde\Framework\Features\Navigation\NavigationItem;
 
 'navigation' => [
     'custom' => [
-        NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+        NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
     ]
 ]
 ```
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 65fa6d4394f..c91370adce7 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -350,7 +350,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavigationItem::forLink('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f4fa5a7eed9..1d4105be39d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -19,7 +19,7 @@
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavigationItem::fromRoute() to use data from the route
- *   3. You can use NavigationItem::forLink() for an external or un-routed link
+ *   3. You can use NavigationItem::create() for an external or un-routed link
  */
 class NavigationItem implements Stringable
 {
@@ -77,16 +77,6 @@ public static function create(Route|string $route, ?string $label = null, ?int $
         return new self($route, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
-    /**
-     * Create a new navigation menu item leading to an external URI.
-     *
-     * TODO: Merge into a create method
-     */
-    public static function forLink(string $href, string $label, int $priority = NavigationMenu::DEFAULT): self
-    {
-        return self::create($href, $label, $priority);
-    }
-
     /**
      * Create a new dropdown navigation menu item.
      *
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 2aa73a6e0ac..2c81be2ea36 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -93,13 +93,13 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
 
     public function testExternalLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavigationItem::forLink('https://example.com', 'foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::create('https://example.com', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forLink('https://example.com', 'foo'),
+            NavigationItem::create('https://example.com', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -108,13 +108,13 @@ public function testExternalLinkCanBeAddedInConfig()
 
     public function testPathLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavigationItem::forLink('foo', 'foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::create('foo', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::create('foo', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -124,16 +124,16 @@ public function testPathLinkCanBeAddedInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     {
         config(['hyde.navigation.custom' => [
-            NavigationItem::forLink('foo', 'foo'),
-            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::create('foo', 'foo'),
+            NavigationItem::create('foo', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forLink('foo', 'foo'),
-            NavigationItem::forLink('foo', 'foo'),
+            NavigationItem::create('foo', 'foo'),
+            NavigationItem::create('foo', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -143,16 +143,16 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestination()
     {
         config(['hyde.navigation.custom' => [
-            NavigationItem::forLink('foo', 'foo'),
-            NavigationItem::forLink('bar', 'foo'),
+            NavigationItem::create('foo', 'foo'),
+            NavigationItem::create('bar', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forLink('foo', 'foo'),
-            NavigationItem::forLink('bar', 'foo'),
+            NavigationItem::create('foo', 'foo'),
+            NavigationItem::create('bar', 'foo'),
         ]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -163,13 +163,13 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
     {
         $this->file('_pages/foo.md');
 
-        config(['hyde.navigation.custom' => [NavigationItem::forLink('bar', 'Foo')]]);
+        config(['hyde.navigation.custom' => [NavigationItem::create('bar', 'Foo')]]);
 
         $menu = $this->createNavigationMenu();
 
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forLink('bar', 'Foo'),
+            NavigationItem::create('bar', 'Foo'),
             NavigationItem::create(Routes::get('foo')),
         ]);
 
diff --git a/packages/framework/tests/Unit/GroupedNavigationItemTest.php b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
index 7647f536819..d08dfc1a740 100644
--- a/packages/framework/tests/Unit/GroupedNavigationItemTest.php
+++ b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
@@ -190,7 +190,7 @@ public function testCreate()
 
     public function testCreateWithLink()
     {
-        $item = GroupedNavigationItem::forLink('foo', 'bar');
+        $item = GroupedNavigationItem::create('foo', 'bar');
 
         $this->assertInstanceOf(NavigationItem::class, $item);
         $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
diff --git a/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
index b5a089ff0db..e747d0b9f0f 100644
--- a/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
+++ b/packages/framework/tests/Unit/NavigationItemIsActiveHelperTest.php
@@ -52,7 +52,7 @@ public function testIsCurrentUsingCurrentRoute()
     public function testIsCurrentUsingCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('index'));
-        $this->assertTrue(NavigationItem::forLink('index.html', 'Home')->isActive());
+        $this->assertTrue(NavigationItem::create('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrent()
@@ -70,7 +70,7 @@ public function testIsCurrentUsingNotCurrentRoute()
     public function testIsCurrentUsingNotCurrentLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forLink('index.html', 'Home')->isActive());
+        $this->assertFalse(NavigationItem::create('index.html', 'Home')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPage()
@@ -124,115 +124,115 @@ public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverse
     public function testIsCurrentUsingCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentUsingNotCurrentLinkWithNestedCurrentPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenNotCurrentWithNestedCurrentPageAndSubjectPage()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo/baz/bar.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/baz/bar.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar/baz.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar/baz.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo.html', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo.html', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('foo/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenVeryNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo/baz/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/baz/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forLink('foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo/bar/baz', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenVeryDifferingNestedInverseUsingPrettyLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('foo', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithAbsoluteLink()
     {
         $this->mockRenderData($this->makeRoute('foo'));
-        $this->assertFalse(NavigationItem::forLink('/foo', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('/foo', 'foo')->isActive());
     }
 
     public function testIsCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar'));
-        $this->assertFalse(NavigationItem::forLink('/foo/bar', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('/foo/bar', 'foo')->isActive());
     }
 
     public function testIsCurrentWhenCurrentWithNestedCurrentPageWhenNestedUsingAbsoluteLinkItem()
     {
         $this->mockRenderData($this->makeRoute('foo/bar/baz'));
-        $this->assertFalse(NavigationItem::forLink('/foo/bar/baz', 'foo')->isActive());
+        $this->assertFalse(NavigationItem::create('/foo/bar/baz', 'foo')->isActive());
     }
 
     protected function mockRenderData(Route $route): void
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 9825faba539..4f6894c93c5 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -124,7 +124,7 @@ public function testToString()
 
     public function testCreateWithLink()
     {
-        $item = NavigationItem::forLink('foo', 'bar');
+        $item = NavigationItem::create('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
         $this->assertSame('bar', $item->getLabel());
@@ -133,7 +133,7 @@ public function testCreateWithLink()
 
     public function testCreateWithLinkWithCustomPriority()
     {
-        $this->assertSame(100, NavigationItem::forLink('foo', 'bar', 100)->getPriority());
+        $this->assertSame(100, NavigationItem::create('foo', 'bar', 100)->getPriority());
     }
 
     public function testCreate()
@@ -244,8 +244,8 @@ public function testIsCurrentWithExternalRoute()
             'getRoute' => new Route(new InMemoryPage('foo')),
             'getRouteKey' => 'foo',
         ]));
-        $this->assertFalse(NavigationItem::forLink('foo', 'bar')->isActive());
-        $this->assertFalse(NavigationItem::forLink('https://example.com', 'bar')->isActive());
+        $this->assertFalse(NavigationItem::create('foo', 'bar')->isActive());
+        $this->assertFalse(NavigationItem::create('https://example.com', 'bar')->isActive());
     }
 
     public function testGetGroupWithNoGroup()

From 495ee7dc0438ee8eb4071547aaee37b85efe5859 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:49:33 +0100
Subject: [PATCH 1158/4023] Normalize comparison with constructor

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 1d4105be39d..62a4610117b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -61,7 +61,7 @@ public function __construct(Route|string|null $destination, string $label, int $
      */
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        if (! $route instanceof Route) {
+        if (is_string($route)) {
             $route = Routes::get($route) ?? new ExternalRoute($route);
         }
 

From bd773c04635bae14d4c15cc5d9b7d9317d94b712 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:49:51 +0100
Subject: [PATCH 1159/4023] Update parameter docs

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 62a4610117b..840c528feb0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -54,7 +54,7 @@ public function __construct(Route|string|null $destination, string $label, int $
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key, or external URI.
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.

From fd65310f39764f33115f74178273ee171c196855 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:50:24 +0100
Subject: [PATCH 1160/4023] Update parameter docs

---
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 840c528feb0..00e72c03c76 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -55,9 +55,9 @@ public function __construct(Route|string|null $destination, string $label, int $
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key, or external URI.
-     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page.
-     * @param  string|null  $label  Leave blank to use the label of the route's corresponding page.
-     * @param  string|null  $group  Leave blank to use the group of the route's corresponding page.
+     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
+     * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
+     * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.
      */
     public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {

From 41416cd1960fd40f573539cd6a202857a7edc423 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:51:25 +0100
Subject: [PATCH 1161/4023] Update named parameter to destination

---
 .../Features/Navigation/NavigationItem.php    | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 00e72c03c76..f801dd75b80 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -54,27 +54,27 @@ public function __construct(Route|string|null $destination, string $label, int $
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $route  Route instance or route key, or external URI.
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $destination  Route instance or route key, or external URI.
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.
      */
-    public static function create(Route|string $route, ?string $label = null, ?int $priority = null, ?string $group = null): self
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        if (is_string($route)) {
-            $route = Routes::get($route) ?? new ExternalRoute($route);
+        if (is_string($destination)) {
+            $destination = Routes::get($destination) ?? new ExternalRoute($destination);
         }
 
-        if ($route instanceof Route && ! $route instanceof ExternalRoute) {
+        if ($destination instanceof Route && ! $destination instanceof ExternalRoute) {
             return new self(
-                $route,
-                $label ?? $route->getPage()->navigationMenuLabel(),
-                $priority ?? $route->getPage()->navigationMenuPriority(),
-                $group ?? $route->getPage()->navigationMenuGroup(),
+                $destination,
+                $label ?? $destination->getPage()->navigationMenuLabel(),
+                $priority ?? $destination->getPage()->navigationMenuPriority(),
+                $group ?? $destination->getPage()->navigationMenuGroup(),
             );
         }
 
-        return new self($route, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
+        return new self($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**

From 76fc723d00a8a2b91526cb6622f9817d89a1db58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:51:40 +0100
Subject: [PATCH 1162/4023] Union annotate plain string type

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f801dd75b80..9a8b9cdf445 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -54,7 +54,7 @@ public function __construct(Route|string|null $destination, string $label, int $
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>  $destination  Route instance or route key, or external URI.
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or external URI.
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.

From c882f7936c00bc11caa9a1615491eb2ce399c07b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:53:33 +0100
Subject: [PATCH 1163/4023] Update todo

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 9a8b9cdf445..7888d3441ea 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -80,7 +80,7 @@ public static function create(Route|string $destination, ?string $label = null,
     /**
      * Create a new dropdown navigation menu item.
      *
-     * TODO: Move to GroupedNavigationItem::create()
+     * TODO: Move to GroupedNavigationItem::create() as this solves the naming issue, and because it makes little sense for it to be here. It also resolves the self/static issue.
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavigationItem>  $items  The items to be included in the dropdown.

From 215240d50d26f07e1940a1818e8e7020465a69cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 19:54:22 +0100
Subject: [PATCH 1164/4023] Override parent method

---
 .../Framework/Features/Navigation/GroupedNavigationItem.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index 0d12290e855..6f980312ad2 100644
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\ExternalRoute;
 
@@ -27,6 +28,11 @@ public function __construct(string $label, array $items = [], int $priority = Na
         $this->addItems($items);
     }
 
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): NavigationItem
+    {
+        return parent::create($destination, $label, $priority, $group);
+    }
+
     /**
      * Get the items of the grouped navigation item.
      *

From 37ee6e355a84110862b3c486b362dfd4905c429c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:04:12 +0100
Subject: [PATCH 1165/4023] Deprecate GroupedNavigationItem

---
 .../src/Framework/Features/Navigation/GroupedNavigationItem.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index 6f980312ad2..ec25d844126 100644
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -15,6 +15,8 @@
  * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
  *
  * @todo Consider extracting trait for shared code with navigation menu class
+ *
+ * @deprecated Use NavigationGroup instead
  */
 class GroupedNavigationItem extends NavigationItem
 {

From be3510d306ef70302b17feb0593b8093d996ca09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:04:57 +0100
Subject: [PATCH 1166/4023] Deprecate forGroup method

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7888d3441ea..16a3b689d22 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -80,6 +80,8 @@ public static function create(Route|string $destination, ?string $label = null,
     /**
      * Create a new dropdown navigation menu item.
      *
+     * @deprecated Use NavigationGroup::create() instead.
+     *
      * TODO: Move to GroupedNavigationItem::create() as this solves the naming issue, and because it makes little sense for it to be here. It also resolves the self/static issue.
      *
      * @param  string  $label  The label of the dropdown item.

From 5c0ed74ced2ac1919a682aee98432f4196bd6ff4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:05:50 +0100
Subject: [PATCH 1167/4023] Create NavigationGroup.php

---
 .../Framework/Features/Navigation/NavigationGroup.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationGroup.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
new file mode 100644
index 00000000000..92ba7abe4d5
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationGroup
+{
+    //
+}

From d23f57473c73c05a48882ed6f23a9c28408f6f64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:14:09 +0100
Subject: [PATCH 1168/4023] Add todo

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 16a3b689d22..39bb0d3d724 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -16,6 +16,8 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
+ * @todo Consider adding a NavigationElement contract to this class and new NavigationGroup class for shared methods and to allow easier type hinting.
+ *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavigationItem::fromRoute() to use data from the route

From a3fc9ddee4bab7c3cc308fcfb25ac6d86910755d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:17:25 +0100
Subject: [PATCH 1169/4023] Add items array

---
 .../src/Framework/Features/Navigation/NavigationGroup.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 92ba7abe4d5..f78ae1a277a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -6,5 +6,6 @@
 
 class NavigationGroup
 {
-    //
+    /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
+    protected array $items = [];
 }

From 77cf42839d0ad45addd76a8d23817366deaad2df Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:18:09 +0100
Subject: [PATCH 1170/4023] Add label and priority properties

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index f78ae1a277a..8b062a7d19a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -8,4 +8,6 @@ class NavigationGroup
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
+    protected string $label;
+    protected int $priority;
 }

From 8e284b038f8312e03ea022bd89e5793737f5ff33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:18:34 +0100
Subject: [PATCH 1171/4023] Create base constructor

---
 .../src/Framework/Features/Navigation/NavigationGroup.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 8b062a7d19a..7ae32b8e49d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -10,4 +10,12 @@ class NavigationGroup
     protected array $items = [];
     protected string $label;
     protected int $priority;
+
+    public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
+    {
+        $this->label = $label;
+        $this->priority = $priority;
+
+        $this->addItems($items);
+    }
 }

From 3598621c7e55237e32695cd08aae9b5f020be51c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:20:25 +0100
Subject: [PATCH 1172/4023] Add base create method

---
 .../src/Framework/Features/Navigation/NavigationGroup.php    | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 7ae32b8e49d..0da083dcdca 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -18,4 +18,9 @@ public function __construct(string $label, array $items = [], int $priority = Na
 
         $this->addItems($items);
     }
+
+    public static function create(string $label, array $items = [], int $priority = NavigationMenu::LAST): static
+    {
+        return new static($label, $items, $priority);
+    }
 }

From fd34e6afbc70c7a7d34501d14ce03bb58afc5c36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:20:52 +0100
Subject: [PATCH 1173/4023] Add items getter

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 0da083dcdca..c07d0198fa2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -23,4 +23,10 @@ public static function create(string $label, array $items = [], int $priority =
     {
         return new static($label, $items, $priority);
     }
+
+    /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
+    public function getItems(): array
+    {
+        return $this->items;
+    }
 }

From a2dc2f3b9ac41485b834ee791eae89904b36201b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:21:44 +0100
Subject: [PATCH 1174/4023] Copy over base items adder methods

---
 .../Features/Navigation/NavigationGroup.php   | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index c07d0198fa2..b1a8ecb4522 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -29,4 +29,23 @@ public function getItems(): array
     {
         return $this->items;
     }
+
+    public function addItem(NavigationItem $item): static
+    {
+        $item->group ??= $this->group;
+
+        $this->items[] = $item;
+
+        return $this;
+    }
+
+    /** @param  array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
+    public function addItems(array $items): static
+    {
+        foreach ($items as $item) {
+            $this->addItem($item);
+        }
+
+        return $this;
+    }
 }

From 9f5c1ab3ff012b13c7ed59ee9936b02dde01d24f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:22:46 +0100
Subject: [PATCH 1175/4023] Deprecate operation

---
 .../src/Framework/Features/Navigation/NavigationGroup.php        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index b1a8ecb4522..0a3bd1b71c2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -32,6 +32,7 @@ public function getItems(): array
 
     public function addItem(NavigationItem $item): static
     {
+        /** @deprecated I don't think we necessarily need to care about this */
         $item->group ??= $this->group;
 
         $this->items[] = $item;

From c67fc320cfc0cb8eaca8982f415622fa52d612b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:23:46 +0100
Subject: [PATCH 1176/4023] Copy over priority accessor

---
 .../Features/Navigation/NavigationGroup.php   | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 0a3bd1b71c2..6baf501bc52 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -4,6 +4,12 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Pages\DocumentationPage;
+use Hyde\Support\Models\ExternalRoute;
+
+use function min;
+use function collect;
+
 class NavigationGroup
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
@@ -49,4 +55,29 @@ public function addItems(array $items): static
 
         return $this;
     }
+
+    /**
+     * Get the priority to determine the order of the grouped navigation item.
+     *
+     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown itself has a lower priority.
+     */
+    public function getPriority(): int
+    {
+        if ($this->containsOnlyDocumentationPages()) {
+            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
+        }
+
+        return $this->priority;
+    }
+
+    protected function containsOnlyDocumentationPages(): bool
+    {
+        if (empty($this->getItems())) {
+            return false;
+        }
+
+        return collect($this->getItems())->every(function (NavigationItem $child): bool {
+            return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
+        });
+    }
 }

From 0f3be7ff01eb8fcb3a1df8d596ccb6fb3474fb03 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:27:14 +0100
Subject: [PATCH 1177/4023] Create temporary deprecated helper to aid in
 refactor

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 3 ++-
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 6baf501bc52..f0e3cb58ba4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Str;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\ExternalRoute;
 
@@ -39,7 +40,7 @@ public function getItems(): array
     public function addItem(NavigationItem $item): static
     {
         /** @deprecated I don't think we necessarily need to care about this */
-        $item->group ??= $this->group;
+        $item->setGroup($item->getGroupKey() ?? Str::slug($this->label));
 
         $this->items[] = $item;
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 39bb0d3d724..032b4905823 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -161,4 +161,10 @@ public static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
+
+    /** @deprecated Temporary to reduce issues during refactoring */
+    public function setGroup(string $group): void
+    {
+        $this->group = $group;
+    }
 }

From 24cc0885a694807b7b1942f72b2c4d28cb66a6c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:33:07 +0100
Subject: [PATCH 1178/4023] Revert "Override parent method"

This reverts commit 215240d50d26f07e1940a1818e8e7020465a69cb.
---
 .../Framework/Features/Navigation/GroupedNavigationItem.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index ec25d844126..0edf19b15e1 100644
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\ExternalRoute;
 
@@ -30,11 +29,6 @@ public function __construct(string $label, array $items = [], int $priority = Na
         $this->addItems($items);
     }
 
-    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): NavigationItem
-    {
-        return parent::create($destination, $label, $priority, $group);
-    }
-
     /**
      * Get the items of the grouped navigation item.
      *

From 44eca8f11a85fbafc4afeb2561432a54a8e344a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:33:54 +0100
Subject: [PATCH 1179/4023] Shift class description to new class

---
 .../Framework/Features/Navigation/GroupedNavigationItem.php  | 4 ----
 .../src/Framework/Features/Navigation/NavigationGroup.php    | 5 +++++
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index 0edf19b15e1..b5b02dfd8e5 100644
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -11,10 +11,6 @@
 use function collect;
 
 /**
- * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
- *
- * @todo Consider extracting trait for shared code with navigation menu class
- *
  * @deprecated Use NavigationGroup instead
  */
 class GroupedNavigationItem extends NavigationItem
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index f0e3cb58ba4..bfadeab01b0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -11,6 +11,11 @@
 use function min;
 use function collect;
 
+/**
+ * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
+ *
+ * @todo Consider extracting trait for shared code with navigation menu class
+ */
 class NavigationGroup
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */

From 8b29e17f7c3cd62ecc7eea4c2c335e58d9f62f1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:34:16 +0100
Subject: [PATCH 1180/4023] Remove non vital lines from class being removed

---
 .../Navigation/GroupedNavigationItem.php      | 24 -------------------
 1 file changed, 24 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
index b5b02dfd8e5..de98b73ed38 100644
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
@@ -7,15 +7,11 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\ExternalRoute;
 
-use function min;
-use function collect;
-
 /**
  * @deprecated Use NavigationGroup instead
  */
 class GroupedNavigationItem extends NavigationItem
 {
-    /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
 
     public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
@@ -25,21 +21,11 @@ public function __construct(string $label, array $items = [], int $priority = Na
         $this->addItems($items);
     }
 
-    /**
-     * Get the items of the grouped navigation item.
-     *
-     * For the main navigation menu, this stores any dropdown items.
-     *
-     * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
-     */
     public function getItems(): array
     {
         return $this->items;
     }
 
-    /**
-     * Add a navigation item to the grouped navigation item.
-     */
     public function addItem(NavigationItem $item): static
     {
         $item->group ??= $this->group;
@@ -49,11 +35,6 @@ public function addItem(NavigationItem $item): static
         return $this;
     }
 
-    /**
-     * Add multiple navigation items to the grouped navigation item.
-     *
-     * @param  array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items
-     */
     public function addItems(array $items): static
     {
         foreach ($items as $item) {
@@ -63,11 +44,6 @@ public function addItems(array $items): static
         return $this;
     }
 
-    /**
-     * Get the priority to determine the order of the grouped navigation item.
-     *
-     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown has a lower priority.
-     */
     public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {

From ad24ae91a51b933a85a7420d4df5c41f26e2ea21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:37:24 +0100
Subject: [PATCH 1181/4023] Create NavigationGroupTest.php

---
 .../framework/tests/Unit/NavigationGroupTest.php  | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/NavigationGroupTest.php

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
new file mode 100644
index 00000000000..5ef3fd18f8c
--- /dev/null
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationGroup
+ */
+class NavigationGroupTest extends UnitTestCase
+{
+    //
+}

From 7e90b392dee38fd5bbf253060c1e70513a03d4cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:37:52 +0100
Subject: [PATCH 1182/4023] Copy over tests from replaced class

---
 .../tests/Unit/NavigationGroupTest.php        | 198 +++++++++++++++++-
 1 file changed, 197 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 5ef3fd18f8c..7430eba44e1 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -4,12 +4,208 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Models\Route;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Foundation\HydeCoreExtension;
+use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationGroup
  */
 class NavigationGroupTest extends UnitTestCase
 {
-    //
+    public static function setUpBeforeClass(): void
+    {
+        self::needsKernel();
+        self::mockConfig();
+    }
+
+    public function testCanConstruct()
+    {
+        $this->assertSame('Foo', (new NavigationGroup('Foo'))->getLabel());
+    }
+
+    public function testCanConstructWithPriority()
+    {
+        $this->assertSame(500, (new NavigationGroup('Foo', priority: 500))->getPriority());
+    }
+
+    public function testDefaultPriorityValueIsLast()
+    {
+        $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());
+    }
+
+    public function testDestinationIsAlwaysNull()
+    {
+        $this->assertNull((new NavigationGroup('Foo'))->getRoute());
+    }
+
+    public function testCanConstructWithChildren()
+    {
+        $children = $this->createNavigationItems();
+        $item = new NavigationGroup('Foo', $children);
+
+        $this->assertCount(2, $item->getItems());
+        $this->assertSame($children, $item->getItems());
+    }
+
+    public function testCanConstructWithChildrenWithoutRoute()
+    {
+        $children = $this->createNavigationItems();
+        $item = new NavigationGroup('Foo', $children);
+
+        $this->assertCount(2, $item->getItems());
+        $this->assertSame($children, $item->getItems());
+    }
+
+    public function testGetItems()
+    {
+        $children = $this->createNavigationItems();
+        $item = new NavigationGroup('Foo', $children);
+
+        $this->assertSame($children, $item->getItems());
+    }
+
+    public function testGetItemsWithNoItems()
+    {
+        $this->assertEmpty((new NavigationGroup('Foo'))->getItems());
+    }
+
+    public function testCanAddItemToDropdown()
+    {
+        $group = new NavigationGroup('Foo');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
+
+        $this->assertSame([$child], $group->addItem($child)->getItems());
+    }
+
+    public function testAddChildMethodReturnsSelf()
+    {
+        $group = new NavigationGroup('Foo');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
+
+        $this->assertSame($group, $group->addItem($child));
+    }
+
+    public function testCanAddMultipleItemsToDropdown()
+    {
+        $group = new NavigationGroup('Foo');
+        $items = $this->createNavigationItems();
+
+        $this->assertSame($items, $group->addItems($items)->getItems());
+    }
+
+    public function testAddChildrenMethodReturnsSelf()
+    {
+        $group = new NavigationGroup('Foo');
+
+        $this->assertSame($group, $group->addItems([]));
+    }
+
+    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
+    {
+        $group = new NavigationGroup('Foo');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
+
+        $group->addItem($child);
+
+        $this->assertSame('foo', $group->getGroupKey());
+        $this->assertSame('bar', $child->getGroupKey());
+    }
+
+    public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
+    {
+        $group = new NavigationGroup('Foo');
+        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
+
+        $group->addItem($child);
+
+        $this->assertSame('foo', $group->getGroupKey());
+        $this->assertSame('foo', $child->getGroupKey());
+    }
+
+    public function testGetPriorityUsesDefaultPriority()
+    {
+        $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());
+    }
+
+    public function testGetPriorityWithNoChildrenUsesGroupPriority()
+    {
+        $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());
+    }
+
+    public function testGetPriorityWithChildrenUsesGroupPriority()
+    {
+        $group = new NavigationGroup('Foo', [new NavigationItem(new Route(new MarkdownPage()), 'Bar', 100)]);
+
+        $this->assertSame(999, $group->getPriority());
+    }
+
+    public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
+    {
+        $items = [
+            new NavigationItem(new Route(new DocumentationPage()), 'Foo', 100),
+            new NavigationItem(new Route(new DocumentationPage()), 'Bar', 200),
+            new NavigationItem(new Route(new DocumentationPage()), 'Baz', 300),
+        ];
+
+        $this->assertSame(100, (new NavigationGroup('Foo', $items))->getPriority());
+        $this->assertSame(100, (new NavigationGroup('Foo', array_reverse($items)))->getPriority());
+    }
+
+    public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
+    {
+        $group = new NavigationGroup('Foo');
+
+        foreach (HydeCoreExtension::getPageClasses() as $type) {
+            $child = new NavigationItem(new Route(new $type()), 'Bar', 100);
+            $group->addItem($child);
+        }
+
+        $this->assertSame(999, $group->getPriority());
+    }
+
+    public function testGetPriorityHandlesStringUrlChildGracefully()
+    {
+        $this->assertSame(999, (new NavigationGroup('Foo', [new NavigationItem('foo', 'Bar', 100)]))->getPriority());
+    }
+
+    public function testGetPriorityHandlesExternalUrlChildGracefully()
+    {
+        $this->assertSame(999, (new NavigationGroup('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
+    }
+
+    public function testCreate()
+    {
+        $this->markTestSkipped('TODO: Reimplement this test');
+
+        $item = NavigationGroup::create(new Route(new InMemoryPage('foo')));
+
+        $this->assertInstanceOf(NavigationItem::class, $item);
+        $this->assertNotInstanceOf(NavigationGroup::class, $item);
+        $this->assertSame(NavigationItem::class, $item::class);
+    }
+
+    public function testCreateWithLink()
+    {
+        $this->markTestSkipped('TODO: Reimplement this test');
+
+        $item = NavigationGroup::create('foo', 'bar');
+
+        $this->assertInstanceOf(NavigationItem::class, $item);
+        $this->assertNotInstanceOf(NavigationGroup::class, $item);
+        $this->assertSame(NavigationItem::class, $item::class);
+    }
+
+    protected function createNavigationItems(): array
+    {
+        return [
+            new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo'),
+            new NavigationItem(new Route(new InMemoryPage('bar')), 'Bar'),
+        ];
+    }
 }

From 83f01f36a5547bfce14b6c1924e4cc9e98d6c291 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:39:06 +0100
Subject: [PATCH 1183/4023] Copy over shared accessors from navigation item
 class

---
 .../Features/Navigation/NavigationGroup.php   | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index bfadeab01b0..9b944447715 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -36,6 +36,26 @@ public static function create(string $label, array $items = [], int $priority =
         return new static($label, $items, $priority);
     }
 
+    /**
+     * @todo Put into contract shared with NavigationItem class
+     *
+     * Get the label of the navigation item.
+     */
+    public function getLabel(): string
+    {
+        return $this->label;
+    }
+
+    /**
+     * @todo Put into contract shared with NavigationItem class
+     *
+     * Get the priority to determine the order of the navigation item.
+     */
+    public function getPriority(): int
+    {
+        return $this->priority;
+    }
+
     /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     public function getItems(): array
     {

From 1c57d0e483d5576de6415a6e3950ee553d389d86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:39:38 +0100
Subject: [PATCH 1184/4023] Merge duplicated accessor

---
 .../Features/Navigation/NavigationGroup.php          | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 9b944447715..747321c0e57 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -46,16 +46,6 @@ public function getLabel(): string
         return $this->label;
     }
 
-    /**
-     * @todo Put into contract shared with NavigationItem class
-     *
-     * Get the priority to determine the order of the navigation item.
-     */
-    public function getPriority(): int
-    {
-        return $this->priority;
-    }
-
     /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     public function getItems(): array
     {
@@ -85,6 +75,8 @@ public function addItems(array $items): static
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
+     * @todo Put into contract shared with NavigationItem class
+     *
      * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown itself has a lower priority.
      */
     public function getPriority(): int

From 9f78ce5e251135891c4f1ecdaae19353d18d96fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:40:11 +0100
Subject: [PATCH 1185/4023] Navigation groups do not need route accessor

---
 packages/framework/tests/Unit/NavigationGroupTest.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 7430eba44e1..654255df95e 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -39,11 +39,6 @@ public function testDefaultPriorityValueIsLast()
         $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());
     }
 
-    public function testDestinationIsAlwaysNull()
-    {
-        $this->assertNull((new NavigationGroup('Foo'))->getRoute());
-    }
-
     public function testCanConstructWithChildren()
     {
         $children = $this->createNavigationItems();

From 31a0cff8fde912eabac476b68e9c2faa1011ddec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:40:39 +0100
Subject: [PATCH 1186/4023] Navigation groups do not need group key accessor

I don't see why this is needed on this class
---
 packages/framework/tests/Unit/NavigationGroupTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 654255df95e..03151e5feb6 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -108,7 +108,6 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
 
         $group->addItem($child);
 
-        $this->assertSame('foo', $group->getGroupKey());
         $this->assertSame('bar', $child->getGroupKey());
     }
 
@@ -119,7 +118,6 @@ public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
 
         $group->addItem($child);
 
-        $this->assertSame('foo', $group->getGroupKey());
         $this->assertSame('foo', $child->getGroupKey());
     }
 

From d57b204e87f63d4bfe85e2bd63d9e9fde86450b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:42:19 +0100
Subject: [PATCH 1187/4023] Delete GroupedNavigationItemTest.php

Replaced by NavigationGroupTest.php
---
 .../tests/Unit/GroupedNavigationItemTest.php  | 207 ------------------
 1 file changed, 207 deletions(-)
 delete mode 100644 packages/framework/tests/Unit/GroupedNavigationItemTest.php

diff --git a/packages/framework/tests/Unit/GroupedNavigationItemTest.php b/packages/framework/tests/Unit/GroupedNavigationItemTest.php
deleted file mode 100644
index d08dfc1a740..00000000000
--- a/packages/framework/tests/Unit/GroupedNavigationItemTest.php
+++ /dev/null
@@ -1,207 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Pages\MarkdownPage;
-use Hyde\Pages\InMemoryPage;
-use Hyde\Testing\UnitTestCase;
-use Hyde\Support\Models\Route;
-use Hyde\Pages\DocumentationPage;
-use Hyde\Foundation\HydeCoreExtension;
-use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\GroupedNavigationItem
- */
-class GroupedNavigationItemTest extends UnitTestCase
-{
-    public static function setUpBeforeClass(): void
-    {
-        self::needsKernel();
-        self::mockConfig();
-    }
-
-    public function testCanConstruct()
-    {
-        $this->assertSame('Foo', (new GroupedNavigationItem('Foo'))->getLabel());
-    }
-
-    public function testCanConstructWithPriority()
-    {
-        $this->assertSame(500, (new GroupedNavigationItem('Foo', priority: 500))->getPriority());
-    }
-
-    public function testDefaultPriorityValueIsLast()
-    {
-        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
-    }
-
-    public function testDestinationIsAlwaysNull()
-    {
-        $this->assertNull((new GroupedNavigationItem('Foo'))->getRoute());
-    }
-
-    public function testCanConstructWithChildren()
-    {
-        $children = $this->createNavigationItems();
-        $item = new GroupedNavigationItem('Foo', $children);
-
-        $this->assertCount(2, $item->getItems());
-        $this->assertSame($children, $item->getItems());
-    }
-
-    public function testCanConstructWithChildrenWithoutRoute()
-    {
-        $children = $this->createNavigationItems();
-        $item = new GroupedNavigationItem('Foo', $children);
-
-        $this->assertCount(2, $item->getItems());
-        $this->assertSame($children, $item->getItems());
-    }
-
-    public function testGetItems()
-    {
-        $children = $this->createNavigationItems();
-        $item = new GroupedNavigationItem('Foo', $children);
-
-        $this->assertSame($children, $item->getItems());
-    }
-
-    public function testGetItemsWithNoItems()
-    {
-        $this->assertEmpty((new GroupedNavigationItem('Foo'))->getItems());
-    }
-
-    public function testCanAddItemToDropdown()
-    {
-        $group = new GroupedNavigationItem('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
-
-        $this->assertSame([$child], $group->addItem($child)->getItems());
-    }
-
-    public function testAddChildMethodReturnsSelf()
-    {
-        $group = new GroupedNavigationItem('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
-
-        $this->assertSame($group, $group->addItem($child));
-    }
-
-    public function testCanAddMultipleItemsToDropdown()
-    {
-        $group = new GroupedNavigationItem('Foo');
-        $items = $this->createNavigationItems();
-
-        $this->assertSame($items, $group->addItems($items)->getItems());
-    }
-
-    public function testAddChildrenMethodReturnsSelf()
-    {
-        $group = new GroupedNavigationItem('Foo');
-
-        $this->assertSame($group, $group->addItems([]));
-    }
-
-    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
-    {
-        $group = new GroupedNavigationItem('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
-
-        $group->addItem($child);
-
-        $this->assertSame('foo', $group->getGroupKey());
-        $this->assertSame('bar', $child->getGroupKey());
-    }
-
-    public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
-    {
-        $group = new GroupedNavigationItem('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
-
-        $group->addItem($child);
-
-        $this->assertSame('foo', $group->getGroupKey());
-        $this->assertSame('foo', $child->getGroupKey());
-    }
-
-    public function testGetPriorityUsesDefaultPriority()
-    {
-        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
-    }
-
-    public function testGetPriorityWithNoChildrenUsesGroupPriority()
-    {
-        $this->assertSame(999, (new GroupedNavigationItem('Foo'))->getPriority());
-    }
-
-    public function testGetPriorityWithChildrenUsesGroupPriority()
-    {
-        $group = new GroupedNavigationItem('Foo', [new NavigationItem(new Route(new MarkdownPage()), 'Bar', 100)]);
-
-        $this->assertSame(999, $group->getPriority());
-    }
-
-    public function testGetPriorityWithDocumentationPageChildrenUsesLowestPriority()
-    {
-        $items = [
-            new NavigationItem(new Route(new DocumentationPage()), 'Foo', 100),
-            new NavigationItem(new Route(new DocumentationPage()), 'Bar', 200),
-            new NavigationItem(new Route(new DocumentationPage()), 'Baz', 300),
-        ];
-
-        $this->assertSame(100, (new GroupedNavigationItem('Foo', $items))->getPriority());
-        $this->assertSame(100, (new GroupedNavigationItem('Foo', array_reverse($items)))->getPriority());
-    }
-
-    public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
-    {
-        $group = new GroupedNavigationItem('Foo');
-
-        foreach (HydeCoreExtension::getPageClasses() as $type) {
-            $child = new NavigationItem(new Route(new $type()), 'Bar', 100);
-            $group->addItem($child);
-        }
-
-        $this->assertSame(999, $group->getPriority());
-    }
-
-    public function testGetPriorityHandlesStringUrlChildGracefully()
-    {
-        $this->assertSame(999, (new GroupedNavigationItem('Foo', [new NavigationItem('foo', 'Bar', 100)]))->getPriority());
-    }
-
-    public function testGetPriorityHandlesExternalUrlChildGracefully()
-    {
-        $this->assertSame(999, (new GroupedNavigationItem('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
-    }
-
-    public function testCreate()
-    {
-        $item = GroupedNavigationItem::create(new Route(new InMemoryPage('foo')));
-
-        $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
-        $this->assertSame(NavigationItem::class, $item::class);
-    }
-
-    public function testCreateWithLink()
-    {
-        $item = GroupedNavigationItem::create('foo', 'bar');
-
-        $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(GroupedNavigationItem::class, $item);
-        $this->assertSame(NavigationItem::class, $item::class);
-    }
-
-    protected function createNavigationItems(): array
-    {
-        return [
-            new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo'),
-            new NavigationItem(new Route(new InMemoryPage('bar')), 'Bar'),
-        ];
-    }
-}

From e3ae2c73078b2c57d52fccc692ebb315d164e15a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:54:47 +0100
Subject: [PATCH 1188/4023] Add experimental method for compatibility during
 refactor

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 747321c0e57..2aed9477672 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -98,4 +98,10 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
+
+    /** @experimental This may not be needed. */
+    public function getGroupKey(): string
+    {
+        return Str::slug($this->label);
+    }
 }

From 6faed17a62f0d2abab4298a56daeb7ec20530d72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:49:20 +0100
Subject: [PATCH 1189/4023] Use new NavigationGroup class instead of the old
 one

---
 .../views/components/docs/sidebar-items.blade.php         | 2 +-
 .../resources/views/layouts/navigation.blade.php          | 2 +-
 .../Features/Navigation/DocumentationSidebar.php          | 2 +-
 .../src/Framework/Features/Navigation/NavigationItem.php  | 6 +++---
 .../Features/Navigation/NavigationMenuGenerator.php       | 8 ++++----
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 4 ++--
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php | 6 +++---
 7 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index 2cd3f7d17ff..aef909869ad 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -6,7 +6,7 @@
     </ul>
 @else
     <ul id="sidebar-items" role="list">
-        @php /** @var \Hyde\Framework\Features\Navigation\GroupedNavigationItem $group */ @endphp
+        @php /** @var \Hyde\Framework\Features\Navigation\NavigationGroup $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
             <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 5b766e4a77d..452e53d62fb 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -37,7 +37,7 @@
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
-                    @if($item instanceof \Hyde\Framework\Features\Navigation\GroupedNavigationItem)
+                    @if($item instanceof \Hyde\Framework\Features\Navigation\NavigationGroup)
                         <x-hyde::navigation.dropdown :label="$item->getLabel()" :items="$item->getItems()"/>
                     @else
                         <x-hyde::navigation.navigation-link :item="$item"/>
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 971fe2abf09..31cf72ec1ff 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -56,7 +56,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof GroupedNavigationItem);
+        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof NavigationGroup);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 032b4905823..b299a36b461 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -84,15 +84,15 @@ public static function create(Route|string $destination, ?string $label = null,
      *
      * @deprecated Use NavigationGroup::create() instead.
      *
-     * TODO: Move to GroupedNavigationItem::create() as this solves the naming issue, and because it makes little sense for it to be here. It also resolves the self/static issue.
+     * TODO: Move to NavigationGroup::create() as this solves the naming issue, and because it makes little sense for it to be here. It also resolves the self/static issue.
      *
      * @param  string  $label  The label of the dropdown item.
      * @param  array<NavigationItem>  $items  The items to be included in the dropdown.
      * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
      */
-    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): GroupedNavigationItem
+    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavigationGroup
     {
-        return new GroupedNavigationItem($label, $items, $priority);
+        return new NavigationGroup($label, $items, $priority);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index cc31f8d5cff..12c6e225a16 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -146,12 +146,12 @@ protected function addRouteToGroup(Route $route): void
         }
     }
 
-    protected function getOrCreateGroupItem(string $groupName): GroupedNavigationItem
+    protected function getOrCreateGroupItem(string $groupName): NavigationGroup
     {
         $groupKey = Str::slug($groupName);
         $group = $this->items->get($groupKey);
 
-        if ($group instanceof GroupedNavigationItem) {
+        if ($group instanceof NavigationGroup) {
             return $group;
         } elseif ($group instanceof NavigationItem) {
             // We are trying to add children to an existing navigation menu item,
@@ -161,7 +161,7 @@ protected function getOrCreateGroupItem(string $groupName): GroupedNavigationIte
             // Todo: Add note in documentation about this behavior
             // Example file structure: _pages/foo.md, _pages/foo/bar.md, _pages/foo/baz.md, here the link to foo will be lost.
 
-            $item = new GroupedNavigationItem($group->getLabel(), [], $group->getPriority());
+            $item = new NavigationGroup($group->getLabel(), [], $group->getPriority());
 
             $this->items->put($groupKey, $item);
 
@@ -171,7 +171,7 @@ protected function getOrCreateGroupItem(string $groupName): GroupedNavigationIte
         return $this->createGroupItem($groupKey, $groupName);
     }
 
-    protected function createGroupItem(string $groupKey, string $groupName): GroupedNavigationItem
+    protected function createGroupItem(string $groupKey, string $groupName): NavigationGroup
     {
         $label = $this->searchForGroupLabelInConfig($groupKey) ?? $groupName;
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0230e570374..81501174b94 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -18,7 +18,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -1320,7 +1320,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof GroupedNavigationItem ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index dd9af5b4c06..036350064ae 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -8,7 +8,7 @@
 use Illuminate\Support\Collection;
 use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\GroupedNavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 /**
@@ -204,13 +204,13 @@ public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
         $this->assertFalse((new DocumentationSidebar())->hasGroups());
     }
 
-    public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsGroupedNavigationItemInstance()
+    public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsNavigationGroupInstance()
     {
         self::mockConfig();
         self::setupKernel();
 
         $menu = new DocumentationSidebar([
-            new GroupedNavigationItem('foo', []),
+            new NavigationGroup('foo', []),
         ]);
 
         $this->assertTrue($menu->hasGroups());

From eff193b2e8f469f29164399c96a59d99c044935d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 20:57:24 +0100
Subject: [PATCH 1190/4023] Union type navigation group class

---
 .../Features/Navigation/DocumentationSidebar.php          | 2 +-
 .../src/Framework/Features/Navigation/NavigationMenu.php  | 8 ++++----
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 31cf72ec1ff..b50e38682c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -56,7 +56,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavigationItem $item): bool => $item instanceof NavigationGroup);
+        return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
     }
 
     /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 6876e1c003f..0edef08d48a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,7 +20,7 @@ abstract class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
     public function __construct(Arrayable|array $items = [])
@@ -41,7 +41,7 @@ public function __construct(Arrayable|array $items = [])
      *
      * Items are automatically sorted by their priority, falling back to the order they were added.
      *
-     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem>
+     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
      */
     public function getItems(): Collection
     {
@@ -49,13 +49,13 @@ public function getItems(): Collection
         // so any sorting we do in generator actions will only be partial. This way, we can ensure
         // that the items are always freshly sorted by their priorities when they are retrieved.
 
-        return $this->items->sortBy(fn (NavigationItem $item) => $item->getPriority())->values();
+        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
     }
 
     /**
      * Add a navigation item to the navigation menu.
      */
-    public function add(NavigationItem $item): void
+    public function add(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);
     }
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 81501174b94..4277e67ef84 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1293,7 +1293,7 @@ public function __construct(string $label, ?string $group, int $priority, array
         $this->label = $label;
         $this->group = $group;
         $this->priority = $priority;
-        $this->children = collect($children)->map(fn (NavigationItem $child) => $child->getLabel())->toArray();
+        $this->children = collect($children)->map(fn (NavigationItem|NavigationGroup $child) => $child->getLabel())->toArray();
     }
 
     public static function properties(): array
@@ -1319,7 +1319,7 @@ public function __construct(TestCase $test, $sidebar = false)
     /** A simplified serialized format for comparisons */
     public function state(): array
     {
-        return $this->items->map(function (NavigationItem $item): TestNavigationItem {
+        return $this->items->map(function (NavigationItem|NavigationGroup $item): TestNavigationItem {
             return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
         })->toArray();
     }

From 6d8eb4630f144a222af7647b8076b6a9b122700c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:05:05 +0100
Subject: [PATCH 1191/4023] Delete GroupedNavigationItem.php

---
 .../Navigation/GroupedNavigationItem.php      | 66 -------------------
 1 file changed, 66 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php

diff --git a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php b/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
deleted file mode 100644
index de98b73ed38..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/GroupedNavigationItem.php
+++ /dev/null
@@ -1,66 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-use Hyde\Pages\DocumentationPage;
-use Hyde\Support\Models\ExternalRoute;
-
-/**
- * @deprecated Use NavigationGroup instead
- */
-class GroupedNavigationItem extends NavigationItem
-{
-    protected array $items = [];
-
-    public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
-    {
-        parent::__construct(null, $label, $priority, static::normalizeGroupKey($label));
-
-        $this->addItems($items);
-    }
-
-    public function getItems(): array
-    {
-        return $this->items;
-    }
-
-    public function addItem(NavigationItem $item): static
-    {
-        $item->group ??= $this->group;
-
-        $this->items[] = $item;
-
-        return $this;
-    }
-
-    public function addItems(array $items): static
-    {
-        foreach ($items as $item) {
-            $this->addItem($item);
-        }
-
-        return $this;
-    }
-
-    public function getPriority(): int
-    {
-        if ($this->containsOnlyDocumentationPages()) {
-            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
-        }
-
-        return parent::getPriority();
-    }
-
-    protected function containsOnlyDocumentationPages(): bool
-    {
-        if (empty($this->getItems())) {
-            return false;
-        }
-
-        return collect($this->getItems())->every(function (NavigationItem $child): bool {
-            return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
-        });
-    }
-}

From ebc687fb9f866123cce328b52e7fcbca89a1de44 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:11:28 +0100
Subject: [PATCH 1192/4023] Remove redundant infix from method name

---
 .../resources/views/components/docs/sidebar-items.blade.php   | 2 +-
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 2 +-
 .../src/Framework/Features/Navigation/NavigationGroup.php     | 4 ++--
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 ++--
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index aef909869ad..ed05cf10961 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -8,7 +8,7 @@
     <ul id="sidebar-items" role="list">
         @php /** @var \Hyde\Framework\Features\Navigation\NavigationGroup $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
                     <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
                     @if($sidebar->isCollapsible())
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b50e38682c3..50f40bb15bd 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -92,6 +92,6 @@ private function shouldIndexPageBeActive(string $group): bool
             return false;
         }
 
-        return $group === $this->getItems()->firstOrFail()->getGroupKey();
+        return $group === $this->getItems()->firstOrFail()->getKey();
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 2aed9477672..91a3928e472 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -99,8 +99,8 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
-    /** @experimental This may not be needed. */
-    public function getGroupKey(): string
+    /** Get the key that identifies the group */
+    public function getKey(): string
     {
         return Str::slug($this->label);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 12c6e225a16..4c684d01b95 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -141,8 +141,8 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem->addItem($item);
 
-        if (! $this->items->has($groupItem->getGroupKey())) {
-            $this->items->put($groupItem->getGroupKey(), $groupItem);
+        if (! $this->items->has($groupItem->getKey())) {
+            $this->items->put($groupItem->getKey(), $groupItem);
         }
     }
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 4277e67ef84..70216261795 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1320,7 +1320,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem|NavigationGroup $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
         })->toArray();
     }
 

From 9c8ab4e79b9ccdac3f0caddb0e4d8ac67d854f10 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:11:45 +0100
Subject: [PATCH 1193/4023] Move up method in class source

---
 .../Features/Navigation/NavigationGroup.php          | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 91a3928e472..c38ee34ae7e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -72,6 +72,12 @@ public function addItems(array $items): static
         return $this;
     }
 
+    /** Get the key that identifies the group */
+    public function getKey(): string
+    {
+        return Str::slug($this->label);
+    }
+
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
@@ -98,10 +104,4 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
-
-    /** Get the key that identifies the group */
-    public function getKey(): string
-    {
-        return Str::slug($this->label);
-    }
 }

From 45c217c65e0bdcc3305a242b0503e9a28979e6a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:15:46 +0100
Subject: [PATCH 1194/4023] Revert "Move up method in class source"

This reverts commit 9c8ab4e79b9ccdac3f0caddb0e4d8ac67d854f10.
---
 .../Features/Navigation/NavigationGroup.php          | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index c38ee34ae7e..91a3928e472 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -72,12 +72,6 @@ public function addItems(array $items): static
         return $this;
     }
 
-    /** Get the key that identifies the group */
-    public function getKey(): string
-    {
-        return Str::slug($this->label);
-    }
-
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
@@ -104,4 +98,10 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
+
+    /** Get the key that identifies the group */
+    public function getKey(): string
+    {
+        return Str::slug($this->label);
+    }
 }

From 292ef099e04fdcdcb0579bf1f07386e108ca0dfd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:15:48 +0100
Subject: [PATCH 1195/4023] Revert "Remove redundant infix from method name"

This reverts commit ebc687fb9f866123cce328b52e7fcbca89a1de44.
---
 .../resources/views/components/docs/sidebar-items.blade.php   | 2 +-
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 2 +-
 .../src/Framework/Features/Navigation/NavigationGroup.php     | 4 ++--
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 ++--
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 2 +-
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index ed05cf10961..aef909869ad 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -8,7 +8,7 @@
     <ul id="sidebar-items" role="list">
         @php /** @var \Hyde\Framework\Features\Navigation\NavigationGroup $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getKey()) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
                     <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
                     @if($sidebar->isCollapsible())
diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 50f40bb15bd..b50e38682c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -92,6 +92,6 @@ private function shouldIndexPageBeActive(string $group): bool
             return false;
         }
 
-        return $group === $this->getItems()->firstOrFail()->getKey();
+        return $group === $this->getItems()->firstOrFail()->getGroupKey();
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 91a3928e472..2aed9477672 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -99,8 +99,8 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
-    /** Get the key that identifies the group */
-    public function getKey(): string
+    /** @experimental This may not be needed. */
+    public function getGroupKey(): string
     {
         return Str::slug($this->label);
     }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 4c684d01b95..12c6e225a16 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -141,8 +141,8 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem->addItem($item);
 
-        if (! $this->items->has($groupItem->getKey())) {
-            $this->items->put($groupItem->getKey(), $groupItem);
+        if (! $this->items->has($groupItem->getGroupKey())) {
+            $this->items->put($groupItem->getGroupKey(), $groupItem);
         }
     }
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 70216261795..4277e67ef84 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1320,7 +1320,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem|NavigationGroup $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
         })->toArray();
     }
 

From 5cc73a8add6e77852599f4b5007ca5e5916b3f49 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:16:36 +0100
Subject: [PATCH 1196/4023] Replace experimental marker with design note

Seems like this is needed to simplify the API between the navigation element classes
---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 2aed9477672..e428b90cdf5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -99,7 +99,7 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
-    /** @experimental This may not be needed. */
+    /** @todo Put into contract shared with NavigationItem class */
     public function getGroupKey(): string
     {
         return Str::slug($this->label);

From 34ab7fab56a0edc75d40e06055f6df2f7ff645b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 21 Mar 2024 21:17:02 +0100
Subject: [PATCH 1197/4023] Revert "Revert "Move up method in class source""

This reverts commit 45c217c65e0bdcc3305a242b0503e9a28979e6a7.
---
 .../Features/Navigation/NavigationGroup.php          | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index e428b90cdf5..d7b311a4d61 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -72,6 +72,12 @@ public function addItems(array $items): static
         return $this;
     }
 
+    /** @todo Put into contract shared with NavigationItem class */
+    public function getGroupKey(): string
+    {
+        return Str::slug($this->label);
+    }
+
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
@@ -98,10 +104,4 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
-
-    /** @todo Put into contract shared with NavigationItem class */
-    public function getGroupKey(): string
-    {
-        return Str::slug($this->label);
-    }
 }

From 255bd863c02d346024fbbc29c2e6b20c19fba331 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 10:13:31 +0100
Subject: [PATCH 1198/4023] Remove group key assignment when adding item

Like this is cool, and it makes the state make more sense when dumped, but it doesn't actually matter. Duck typing works fine here, and I don't think it's worth exposing a public method just for this.
---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 3 ---
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 ------
 packages/framework/tests/Unit/NavigationGroupTest.php       | 4 ++--
 3 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index d7b311a4d61..1ab5dfd6989 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -54,9 +54,6 @@ public function getItems(): array
 
     public function addItem(NavigationItem $item): static
     {
-        /** @deprecated I don't think we necessarily need to care about this */
-        $item->setGroup($item->getGroupKey() ?? Str::slug($this->label));
-
         $this->items[] = $item;
 
         return $this;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index b299a36b461..b5b4566dab8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -161,10 +161,4 @@ public static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
-
-    /** @deprecated Temporary to reduce issues during refactoring */
-    public function setGroup(string $group): void
-    {
-        $this->group = $group;
-    }
 }
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 03151e5feb6..dffa66d7033 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -111,14 +111,14 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
         $this->assertSame('bar', $child->getGroupKey());
     }
 
-    public function testAddingAnItemWithNoGroupKeyUsesGroupIdentifier()
+    public function testAddingAnItemWithNoGroupKeyDoesNotModifyGroupIdentifier()
     {
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
         $group->addItem($child);
 
-        $this->assertSame('foo', $child->getGroupKey());
+        $this->assertNull($child->getGroupKey());
     }
 
     public function testGetPriorityUsesDefaultPriority()

From e6a026c996fa12801d92ce77f05e97512281142c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:06:56 +0100
Subject: [PATCH 1199/4023] Create NavigationElement.php

---
 .../Features/Navigation/NavigationElement.php          | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationElement.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
new file mode 100644
index 00000000000..655031ed680
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+interface NavigationElement
+{
+    //
+}

From 4edadc626f1bb5cf89b79c65384ba61f33789e76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:14:51 +0100
Subject: [PATCH 1200/4023] Implement NavigationElement contract

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 2 +-
 .../src/Framework/Features/Navigation/NavigationItem.php    | 2 +-
 packages/framework/tests/Unit/NavigationGroupTest.php       | 5 +++++
 packages/framework/tests/Unit/NavigationItemTest.php        | 6 ++++++
 4 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 1ab5dfd6989..a328593b81e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -16,7 +16,7 @@
  *
  * @todo Consider extracting trait for shared code with navigation menu class
  */
-class NavigationGroup
+class NavigationGroup implements NavigationElement
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index b5b4566dab8..42405a2f387 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,7 +23,7 @@
  *   2. You can use NavigationItem::fromRoute() to use data from the route
  *   3. You can use NavigationItem::create() for an external or un-routed link
  */
-class NavigationItem implements Stringable
+class NavigationItem implements NavigationElement, Stringable
 {
     protected ?Route $route;
     protected string $label;
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index dffa66d7033..c8541d3b374 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -57,6 +57,11 @@ public function testCanConstructWithChildrenWithoutRoute()
         $this->assertSame($children, $item->getItems());
     }
 
+    public function testIsInstanceOfNavigationElement()
+    {
+        $this->assertInstanceOf(NavigationGroup::class, new NavigationGroup('Foo'));
+    }
+
     public function testGetItems()
     {
         $children = $this->createNavigationItems();
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 4f6894c93c5..51510b06de0 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -14,6 +14,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Testing\UnitTestCase;
 use Mockery;
+use Hyde\Framework\Features\Navigation\NavigationElement;
 
 /**
  * This unit test covers the basics of the NavigationItem class.
@@ -46,6 +47,11 @@ public function testConstruct()
         $this->assertSame($route, $item->getRoute());
     }
 
+    public function testIsInstanceOfNavigationElement()
+    {
+        $this->assertInstanceOf(NavigationElement::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500));
+    }
+
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());

From e2fcfaf0fa51fb38eb95032c567d669ada1808c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:21:01 +0100
Subject: [PATCH 1201/4023] Contract shared methods

---
 .../Features/Navigation/NavigationElement.php | 20 ++++++++++++++++++-
 .../Features/Navigation/NavigationGroup.php   |  8 --------
 .../Features/Navigation/NavigationItem.php    |  7 -------
 3 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
index 655031ed680..985517a7cf3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
@@ -6,5 +6,23 @@
 
 interface NavigationElement
 {
-    //
+    /**
+     * Get the label of the navigation item.
+     */
+    public function getLabel(): string;
+
+    /**
+     * Get the priority to determine the order of the navigation item.
+     */
+    public function getPriority(): int;
+
+    /**
+     * Get the group identifier key of the navigation item, if any.
+     *
+     * For sidebars this is the category key, for navigation menus this is the dropdown key.
+     *
+     * When using automatic subdirectory based groups, the subdirectory name is the group key.
+     * Otherwise, the group key is a "slugified" version of the group's label.
+     */
+    public function getGroupKey(): ?string;
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index a328593b81e..016134e76a8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -36,11 +36,6 @@ public static function create(string $label, array $items = [], int $priority =
         return new static($label, $items, $priority);
     }
 
-    /**
-     * @todo Put into contract shared with NavigationItem class
-     *
-     * Get the label of the navigation item.
-     */
     public function getLabel(): string
     {
         return $this->label;
@@ -69,7 +64,6 @@ public function addItems(array $items): static
         return $this;
     }
 
-    /** @todo Put into contract shared with NavigationItem class */
     public function getGroupKey(): string
     {
         return Str::slug($this->label);
@@ -78,8 +72,6 @@ public function getGroupKey(): string
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
-     * @todo Put into contract shared with NavigationItem class
-     *
      * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown itself has a lower priority.
      */
     public function getPriority(): int
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 42405a2f387..e2aa669c552 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -16,8 +16,6 @@
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
  *
- * @todo Consider adding a NavigationElement contract to this class and new NavigationGroup class for shared methods and to allow easier type hinting.
- *
  * You have a few options to construct a navigation menu item:
  *   1. You can supply a Route directly and explicit properties to the constructor
  *   2. You can use NavigationItem::fromRoute() to use data from the route
@@ -137,11 +135,6 @@ public function getPriority(): int
 
     /**
      * Get the group identifier key of the navigation item, if any.
-     *
-     * For sidebars this is the category key, for navigation menus this is the dropdown key.
-     *
-     * When using automatic subdirectory based groups, the subdirectory name is the group key.
-     * Otherwise, the group key is a "slugified" version of the group's label.
      */
     public function getGroupKey(): ?string
     {

From f3f3ecc76ab6f51c3dfaf5ec97663fcf6a0fa57b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:25:36 +0100
Subject: [PATCH 1202/4023] Reimplement test

---
 .../tests/Unit/NavigationGroupTest.php        | 22 ++++---------------
 1 file changed, 4 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index c8541d3b374..ddcb108a121 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -179,24 +179,10 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
 
     public function testCreate()
     {
-        $this->markTestSkipped('TODO: Reimplement this test');
-
-        $item = NavigationGroup::create(new Route(new InMemoryPage('foo')));
-
-        $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(NavigationGroup::class, $item);
-        $this->assertSame(NavigationItem::class, $item::class);
-    }
-
-    public function testCreateWithLink()
-    {
-        $this->markTestSkipped('TODO: Reimplement this test');
-
-        $item = NavigationGroup::create('foo', 'bar');
-
-        $this->assertInstanceOf(NavigationItem::class, $item);
-        $this->assertNotInstanceOf(NavigationGroup::class, $item);
-        $this->assertSame(NavigationItem::class, $item::class);
+        $this->assertEquals(
+            new NavigationGroup('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100),
+            NavigationGroup::create('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100)
+        );
     }
 
     protected function createNavigationItems(): array

From 63ee2047bdac52a7a94f6d7fa2db95bd61359f10 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:25:48 +0100
Subject: [PATCH 1203/4023] Move up test

---
 .../framework/tests/Unit/NavigationGroupTest.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index ddcb108a121..24645519810 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -62,6 +62,14 @@ public function testIsInstanceOfNavigationElement()
         $this->assertInstanceOf(NavigationGroup::class, new NavigationGroup('Foo'));
     }
 
+    public function testCreate()
+    {
+        $this->assertEquals(
+            new NavigationGroup('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100),
+            NavigationGroup::create('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100)
+        );
+    }
+
     public function testGetItems()
     {
         $children = $this->createNavigationItems();
@@ -177,14 +185,6 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
         $this->assertSame(999, (new NavigationGroup('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
-    public function testCreate()
-    {
-        $this->assertEquals(
-            new NavigationGroup('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100),
-            NavigationGroup::create('Foo', [new NavigationItem(new Route(new InMemoryPage('foo')), 'Foo')], 100)
-        );
-    }
-
     protected function createNavigationItems(): array
     {
         return [

From 1709763df6e1a6f6caaf8d7dce31bccaa3566381 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:25:56 +0100
Subject: [PATCH 1204/4023] Clarify documentation

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 016134e76a8..bd1aef93beb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -72,7 +72,7 @@ public function getGroupKey(): string
     /**
      * Get the priority to determine the order of the grouped navigation item.
      *
-     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown itself has a lower priority.
+     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
      */
     public function getPriority(): int
     {

From 9f133ce658b0bccd0f7f7b02613f31174defcdab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:48:30 +0100
Subject: [PATCH 1205/4023] Remove todo for closed PR
 https://github.com/hydephp/develop/pull/1630

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index bd1aef93beb..d65dc297691 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -13,8 +13,6 @@
 
 /**
  * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
- *
- * @todo Consider extracting trait for shared code with navigation menu class
  */
 class NavigationGroup implements NavigationElement
 {

From 0e8e6116c64e65f543d828bed15bbd69b5849f9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:52:52 +0100
Subject: [PATCH 1206/4023] Extract helper method

---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 0edef08d48a..58371a0022a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -56,6 +56,12 @@ public function getItems(): Collection
      * Add a navigation item to the navigation menu.
      */
     public function add(NavigationItem|NavigationGroup $item): void
+    {
+        $this->items->add($item);
+    }
+
+    /** Type safe helper to add a navigation item to the menu. */
+    protected function addItem(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);
     }

From 3c3febdc1f0db53d2e8aa1fc8229fff2666b27fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:53:21 +0100
Subject: [PATCH 1207/4023] Add additional test

---
 .../tests/Unit/NavigationMenuUnitTest.php          | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 0330f4a0916..11e1c5087d7 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -82,6 +82,20 @@ public function testCanAddItems()
         $this->assertSame($item, $menu->getItems()->first());
     }
 
+    public function testCanAddMultipleItems()
+    {
+        $menu = new MainNavigationMenu();
+
+        $item1 = $this->item('/', 'Home');
+        $item2 = $this->item('/about', 'About');
+
+        $menu->add($item1);
+        $menu->add($item2);
+
+        $this->assertCount(2, $menu->getItems());
+        $this->assertSame([$item1, $item2], $menu->getItems()->all());
+    }
+
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new MainNavigationMenu();

From 0a7a6b25ef1a169618049da4b9ef227ec0c10e09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:54:41 +0100
Subject: [PATCH 1208/4023] Support adding multiple items at once

---
 .../Features/Navigation/NavigationMenu.php       | 16 +++++++++++++---
 .../tests/Unit/NavigationMenuUnitTest.php        | 13 +++++++++++++
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 58371a0022a..e9303a1ee16 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -53,11 +53,21 @@ public function getItems(): Collection
     }
 
     /**
-     * Add a navigation item to the navigation menu.
+     * Add one or more navigation items to the navigation menu.
+     *
+     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
      */
-    public function add(NavigationItem|NavigationGroup $item): void
+    public function add(NavigationItem|NavigationGroup|array $items): void
     {
-        $this->items->add($item);
+        if (is_array($items)) {
+            foreach ($items as $item) {
+                $this->addItem($item);
+            }
+
+            return;
+        }
+
+        $this->addItem($items);
     }
 
     /** Type safe helper to add a navigation item to the menu. */
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index 11e1c5087d7..d60aa5e0c6f 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -96,6 +96,19 @@ public function testCanAddMultipleItems()
         $this->assertSame([$item1, $item2], $menu->getItems()->all());
     }
 
+    public function testCanAddMultipleItemsAtOnce()
+    {
+        $menu = new MainNavigationMenu();
+
+        $item1 = $this->item('/', 'Home');
+        $item2 = $this->item('/about', 'About');
+
+        $menu->add([$item1, $item2]);
+
+        $this->assertCount(2, $menu->getItems());
+        $this->assertSame([$item1, $item2], $menu->getItems()->all());
+    }
+
     public function testItemsAreInTheOrderTheyWereAddedWhenThereAreNoCustomPriorities()
     {
         $menu = new MainNavigationMenu();

From 88a1bc5c2b64659faaca05f0e941b81a85505478 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:56:03 +0100
Subject: [PATCH 1209/4023] Wrap array to simplify method implementation

---
 .../Framework/Features/Navigation/NavigationMenu.php  | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index e9303a1ee16..a2e13228173 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -59,15 +60,9 @@ public function getItems(): Collection
      */
     public function add(NavigationItem|NavigationGroup|array $items): void
     {
-        if (is_array($items)) {
-            foreach ($items as $item) {
-                $this->addItem($item);
-            }
-
-            return;
+        foreach (Arr::wrap($items) as $item) {
+            $this->addItem($item);
         }
-
-        $this->addItem($items);
     }
 
     /** Type safe helper to add a navigation item to the menu. */

From 8be45e644cb00b0cecf4050cbb043639ab7bcfa6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 13:58:22 +0100
Subject: [PATCH 1210/4023] Test modifier methods are fluently chainable

---
 packages/framework/tests/Unit/NavigationGroupTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 24645519810..cbb0cd64bc7 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -185,6 +185,14 @@ public function testGetPriorityHandlesExternalUrlChildGracefully()
         $this->assertSame(999, (new NavigationGroup('Foo', [new NavigationItem('https://example.com', 'Bar', 100)]))->getPriority());
     }
 
+    public function testModifierMethodsAreFluentlyChainable()
+    {
+        $group = new NavigationGroup('Foo');
+
+        $this->assertSame($group, $group->addItem(new NavigationItem(new Route(new MarkdownPage()), 'Bar')));
+        $this->assertSame($group, $group->addItems([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
+    }
+
     protected function createNavigationItems(): array
     {
         return [

From 8a063c2c42c92c8de85e6de81852048df2f9717b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:00:45 +0100
Subject: [PATCH 1211/4023] Update setter to be fluently chainable

---
 .../src/Framework/Features/Navigation/NavigationMenu.php | 4 +++-
 packages/framework/tests/Unit/NavigationMenuUnitTest.php | 9 +++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index a2e13228173..cd3b22e08eb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -58,11 +58,13 @@ public function getItems(): Collection
      *
      * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
      */
-    public function add(NavigationItem|NavigationGroup|array $items): void
+    public function add(NavigationItem|NavigationGroup|array $items): static
     {
         foreach (Arr::wrap($items) as $item) {
             $this->addItem($item);
         }
+
+        return $this;
     }
 
     /** Type safe helper to add a navigation item to the menu. */
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index d60aa5e0c6f..e90b159624f 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -139,6 +139,15 @@ public function testItemsAreSortedByPriority()
         $this->assertSame([$item1, $item2, $item3], $menu->getItems()->all());
     }
 
+    public function testModifierMethodsAreFluentlyChainable()
+    {
+        $menu = new MainNavigationMenu();
+
+        $item = $this->item('/', 'Home');
+
+        $this->assertSame($menu, $menu->add($item));
+    }
+
     protected function getItems(): array
     {
         return [

From ea23d59721141da0d52b5c874082fd19f38ce191 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:17:14 +0100
Subject: [PATCH 1212/4023] Add items using dynamic helper

---
 .../src/Framework/Features/Navigation/NavigationMenu.php  | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index cd3b22e08eb..7b6a18b1f70 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -28,13 +28,7 @@ public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
-        foreach ($items as $item) {
-            // Instead of adding the items directly, we iterate through them and
-            // add them through the helper. This ensures that all the items are
-            // of the correct type, bringing type safety to the menu's items.
-
-            $this->add($item);
-        }
+        $this->add($items instanceof Arrayable ? $items->toArray() : $items);
     }
 
     /**

From 7332c237845b50bb1fab4acbd7af9385f60a6009 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:17:39 +0100
Subject: [PATCH 1213/4023] Evaluate arrayable using helper function

---
 .../src/Framework/Features/Navigation/NavigationMenu.php      | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 7b6a18b1f70..d066d09bada 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -8,6 +8,8 @@
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
+use function Hyde\evaluate_arrayable;
+
 /**
  * Represents a site navigation menu, and contains all of its navigation items.
  *
@@ -28,7 +30,7 @@ public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
-        $this->add($items instanceof Arrayable ? $items->toArray() : $items);
+        $this->add(evaluate_arrayable($items));
     }
 
     /**

From 1677b818f51a7f21cc37f8bc4a6088327aa7a74b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:30:06 +0100
Subject: [PATCH 1214/4023] Merge adder methods to simplify API

---
 .../Features/Navigation/NavigationGroup.php   | 24 +++++++++----------
 .../tests/Unit/NavigationGroupTest.php        |  6 ++---
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index d65dc297691..e5b8c3aa8c2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Illuminate\Support\Str;
+use Illuminate\Support\Arr;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\ExternalRoute;
 
@@ -26,7 +27,7 @@ public function __construct(string $label, array $items = [], int $priority = Na
         $this->label = $label;
         $this->priority = $priority;
 
-        $this->addItems($items);
+        $this->addItem($items);
     }
 
     public static function create(string $label, array $items = [], int $priority = NavigationMenu::LAST): static
@@ -45,18 +46,11 @@ public function getItems(): array
         return $this->items;
     }
 
-    public function addItem(NavigationItem $item): static
+    /** @param  \Hyde\Framework\Features\Navigation\NavigationItem|array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
+    public function addItem(NavigationItem|array $items): static
     {
-        $this->items[] = $item;
-
-        return $this;
-    }
-
-    /** @param  array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
-    public function addItems(array $items): static
-    {
-        foreach ($items as $item) {
-            $this->addItem($item);
+        foreach (Arr::wrap($items) as $item) {
+            $this->pushItem($item);
         }
 
         return $this;
@@ -91,4 +85,10 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
+
+    /** Type safe helper to add a navigation item to the group. */
+    protected function pushItem(NavigationItem $item): void
+    {
+        $this->items[] = $item;
+    }
 }
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index cbb0cd64bc7..d17e3020736 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -104,14 +104,14 @@ public function testCanAddMultipleItemsToDropdown()
         $group = new NavigationGroup('Foo');
         $items = $this->createNavigationItems();
 
-        $this->assertSame($items, $group->addItems($items)->getItems());
+        $this->assertSame($items, $group->addItem($items)->getItems());
     }
 
     public function testAddChildrenMethodReturnsSelf()
     {
         $group = new NavigationGroup('Foo');
 
-        $this->assertSame($group, $group->addItems([]));
+        $this->assertSame($group, $group->addItem([]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
@@ -190,7 +190,7 @@ public function testModifierMethodsAreFluentlyChainable()
         $group = new NavigationGroup('Foo');
 
         $this->assertSame($group, $group->addItem(new NavigationItem(new Route(new MarkdownPage()), 'Bar')));
-        $this->assertSame($group, $group->addItems([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
+        $this->assertSame($group, $group->addItem([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
     }
 
     protected function createNavigationItems(): array

From b632b88a1e1f7ddd602f629268ee5cfad15668b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:36:18 +0100
Subject: [PATCH 1215/4023] Rename helper method to make it more fluent

I thought $group->addItem benefited from having the item suffix to make it clear what is added, but considering an entire operation looks like $group->add($items) it's redundant to have it twice.
---
 .../Features/Navigation/NavigationGroup.php    |  4 ++--
 .../Navigation/NavigationMenuGenerator.php     |  2 +-
 .../tests/Unit/NavigationGroupTest.php         | 18 +++++++++---------
 3 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index e5b8c3aa8c2..0aa9664d34d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -27,7 +27,7 @@ public function __construct(string $label, array $items = [], int $priority = Na
         $this->label = $label;
         $this->priority = $priority;
 
-        $this->addItem($items);
+        $this->add($items);
     }
 
     public static function create(string $label, array $items = [], int $priority = NavigationMenu::LAST): static
@@ -47,7 +47,7 @@ public function getItems(): array
     }
 
     /** @param  \Hyde\Framework\Features\Navigation\NavigationItem|array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
-    public function addItem(NavigationItem|array $items): static
+    public function add(NavigationItem|array $items): static
     {
         foreach (Arr::wrap($items) as $item) {
             $this->pushItem($item);
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 12c6e225a16..995ce8b81d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -139,7 +139,7 @@ protected function addRouteToGroup(Route $route): void
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 
-        $groupItem->addItem($item);
+        $groupItem->add($item);
 
         if (! $this->items->has($groupItem->getGroupKey())) {
             $this->items->put($groupItem->getGroupKey(), $groupItem);
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index d17e3020736..9b51ed0c122 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -88,7 +88,7 @@ public function testCanAddItemToDropdown()
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame([$child], $group->addItem($child)->getItems());
+        $this->assertSame([$child], $group->add($child)->getItems());
     }
 
     public function testAddChildMethodReturnsSelf()
@@ -96,7 +96,7 @@ public function testAddChildMethodReturnsSelf()
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame($group, $group->addItem($child));
+        $this->assertSame($group, $group->add($child));
     }
 
     public function testCanAddMultipleItemsToDropdown()
@@ -104,14 +104,14 @@ public function testCanAddMultipleItemsToDropdown()
         $group = new NavigationGroup('Foo');
         $items = $this->createNavigationItems();
 
-        $this->assertSame($items, $group->addItem($items)->getItems());
+        $this->assertSame($items, $group->add($items)->getItems());
     }
 
     public function testAddChildrenMethodReturnsSelf()
     {
         $group = new NavigationGroup('Foo');
 
-        $this->assertSame($group, $group->addItem([]));
+        $this->assertSame($group, $group->add([]));
     }
 
     public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
@@ -119,7 +119,7 @@ public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
 
-        $group->addItem($child);
+        $group->add($child);
 
         $this->assertSame('bar', $child->getGroupKey());
     }
@@ -129,7 +129,7 @@ public function testAddingAnItemWithNoGroupKeyDoesNotModifyGroupIdentifier()
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
-        $group->addItem($child);
+        $group->add($child);
 
         $this->assertNull($child->getGroupKey());
     }
@@ -169,7 +169,7 @@ public function testGetPriorityUsesGroupPriorityForMixedChildTypes()
 
         foreach (HydeCoreExtension::getPageClasses() as $type) {
             $child = new NavigationItem(new Route(new $type()), 'Bar', 100);
-            $group->addItem($child);
+            $group->add($child);
         }
 
         $this->assertSame(999, $group->getPriority());
@@ -189,8 +189,8 @@ public function testModifierMethodsAreFluentlyChainable()
     {
         $group = new NavigationGroup('Foo');
 
-        $this->assertSame($group, $group->addItem(new NavigationItem(new Route(new MarkdownPage()), 'Bar')));
-        $this->assertSame($group, $group->addItem([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
+        $this->assertSame($group, $group->add(new NavigationItem(new Route(new MarkdownPage()), 'Bar')));
+        $this->assertSame($group, $group->add([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
     }
 
     protected function createNavigationItems(): array

From 80c97e45d3b03c2b049002a50a20083e1dca19b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:36:33 +0100
Subject: [PATCH 1216/4023] Normalize helper method name

---
 .../src/Framework/Features/Navigation/NavigationGroup.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 0aa9664d34d..ab529816035 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -50,7 +50,7 @@ public function getItems(): array
     public function add(NavigationItem|array $items): static
     {
         foreach (Arr::wrap($items) as $item) {
-            $this->pushItem($item);
+            $this->addItem($item);
         }
 
         return $this;
@@ -87,7 +87,7 @@ protected function containsOnlyDocumentationPages(): bool
     }
 
     /** Type safe helper to add a navigation item to the group. */
-    protected function pushItem(NavigationItem $item): void
+    protected function addItem(NavigationItem $item): void
     {
         $this->items[] = $item;
     }

From 9b754da09b48b391c78f0002d3debbeaf24ee92e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:56:07 +0100
Subject: [PATCH 1217/4023] Remove relatively unnecessary PHPDoc comments

---
 .../src/Framework/Features/Navigation/NavigationGroup.php        | 1 -
 .../src/Framework/Features/Navigation/NavigationMenu.php         | 1 -
 2 files changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index ab529816035..949482618f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -86,7 +86,6 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
-    /** Type safe helper to add a navigation item to the group. */
     protected function addItem(NavigationItem $item): void
     {
         $this->items[] = $item;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index d066d09bada..46e904cde29 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -63,7 +63,6 @@ public function add(NavigationItem|NavigationGroup|array $items): static
         return $this;
     }
 
-    /** Type safe helper to add a navigation item to the menu. */
     protected function addItem(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);

From f4750752d631d36a345d25381afb2d62561a4e1b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:56:45 +0100
Subject: [PATCH 1218/4023] Shift comment from method description to body

This is not relevant for users wanting to learn about the method usage, it's just desired to explain why we have the complex sorting, so it's better to have it within the body.
---
 .../src/Framework/Features/Navigation/NavigationGroup.php      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 949482618f7..e12859c6a7c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -63,12 +63,11 @@ public function getGroupKey(): string
 
     /**
      * Get the priority to determine the order of the grouped navigation item.
-     *
-     * For sidebar groups, this is the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
      */
     public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {
+            // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
             return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
         }
 

From 868ec55d42ce7b9caf6f77122d5efb9f5bff8fcc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:57:31 +0100
Subject: [PATCH 1219/4023] Remove unnecessary PHPDoc comment

---
 .../src/Framework/Features/Navigation/NavigationGroup.php      | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index e12859c6a7c..30a2016d22a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -61,9 +61,6 @@ public function getGroupKey(): string
         return Str::slug($this->label);
     }
 
-    /**
-     * Get the priority to determine the order of the grouped navigation item.
-     */
     public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {

From 06a97398dfba1632b475470c3e18d3d2604b75c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:57:39 +0100
Subject: [PATCH 1220/4023] Simplify class description

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 30a2016d22a..8fd22055a16 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -13,7 +13,7 @@
 use function collect;
 
 /**
- * Abstraction for a grouped navigation menu item. For main navigation menus, this is a dropdown.
+ * Abstraction for a grouped navigation menu item, like a dropdown or a sidebar group.
  */
 class NavigationGroup implements NavigationElement
 {

From fcefc89a0fe92def5b92099684efc4a7d7dcc7e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 14:59:00 +0100
Subject: [PATCH 1221/4023] Reorder methods to move up contracted ones

---
 .../Features/Navigation/NavigationGroup.php   | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 8fd22055a16..96525a5db19 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -40,6 +40,21 @@ public function getLabel(): string
         return $this->label;
     }
 
+    public function getGroupKey(): string
+    {
+        return Str::slug($this->label);
+    }
+
+    public function getPriority(): int
+    {
+        if ($this->containsOnlyDocumentationPages()) {
+            // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
+            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
+        }
+
+        return $this->priority;
+    }
+
     /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     public function getItems(): array
     {
@@ -56,19 +71,9 @@ public function add(NavigationItem|array $items): static
         return $this;
     }
 
-    public function getGroupKey(): string
-    {
-        return Str::slug($this->label);
-    }
-
-    public function getPriority(): int
+    protected function addItem(NavigationItem $item): void
     {
-        if ($this->containsOnlyDocumentationPages()) {
-            // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
-            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
-        }
-
-        return $this->priority;
+        $this->items[] = $item;
     }
 
     protected function containsOnlyDocumentationPages(): bool
@@ -81,9 +86,4 @@ protected function containsOnlyDocumentationPages(): bool
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
-
-    protected function addItem(NavigationItem $item): void
-    {
-        $this->items[] = $item;
-    }
 }

From cbab526f1a977dd35c6b1870422ac42da8c671da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 16:47:00 +0100
Subject: [PATCH 1222/4023] Merge conditional early return into return
 expression

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 96525a5db19..0ef773f944f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -78,11 +78,7 @@ protected function addItem(NavigationItem $item): void
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        if (empty($this->getItems())) {
-            return false;
-        }
-
-        return collect($this->getItems())->every(function (NavigationItem $child): bool {
+        return $this->getItems() && collect($this->getItems())->every(function (NavigationItem $child): bool {
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }

From 4f3a66a5f4adb75eca207baa47fbf5d778e0445d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:07:11 +0100
Subject: [PATCH 1223/4023] Use clearer expression

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 0ef773f944f..ebd076aa9af 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -78,7 +78,7 @@ protected function addItem(NavigationItem $item): void
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return $this->getItems() && collect($this->getItems())->every(function (NavigationItem $child): bool {
+        return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $child): bool {
             return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }

From 61dfa89869317f2c35e9cc7b046c2440cfcb4b0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:09:03 +0100
Subject: [PATCH 1224/4023] Move specific method docs from interface to
 implementation

---
 .../src/Framework/Features/Navigation/NavigationElement.php  | 5 -----
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 +++++
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
index 985517a7cf3..6084549e48b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
@@ -18,11 +18,6 @@ public function getPriority(): int;
 
     /**
      * Get the group identifier key of the navigation item, if any.
-     *
-     * For sidebars this is the category key, for navigation menus this is the dropdown key.
-     *
-     * When using automatic subdirectory based groups, the subdirectory name is the group key.
-     * Otherwise, the group key is a "slugified" version of the group's label.
      */
     public function getGroupKey(): ?string;
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index e2aa669c552..9a6917ec8fe 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -135,6 +135,11 @@ public function getPriority(): int
 
     /**
      * Get the group identifier key of the navigation item, if any.
+     *
+     *  For sidebars this is the category key, for navigation menus this is the dropdown key.
+     *
+     *  When using automatic subdirectory based groups, the subdirectory name is the group key.
+     *  Otherwise, the group key is a 'slugified' version of the group's label.
      */
     public function getGroupKey(): ?string
     {

From e1121b11dac5e075b902daa764929ae5d38a58e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:24:29 +0100
Subject: [PATCH 1225/4023] Use the new create method

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 9a6917ec8fe..ff93747abc0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -90,7 +90,7 @@ public static function create(Route|string $destination, ?string $label = null,
      */
     public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavigationGroup
     {
-        return new NavigationGroup($label, $items, $priority);
+        return NavigationGroup::create($label, $items, $priority);
     }
 
     /**

From 2c643945d08f9e49fffeb57551b6920c864b9db5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:29:49 +0100
Subject: [PATCH 1226/4023] Inline and remove the `NavigationItem::forGroup`
 method

---
 .../Features/Navigation/NavigationItem.php       | 16 ----------------
 .../Navigation/NavigationMenuGenerator.php       |  2 +-
 .../tests/Feature/NavigationMenuTest.php         |  5 +++--
 .../Services/DocumentationSidebarTest.php        |  7 ++++---
 .../framework/tests/Unit/NavigationItemTest.php  |  7 ++++---
 5 files changed, 12 insertions(+), 25 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ff93747abc0..ba93936fa98 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -77,22 +77,6 @@ public static function create(Route|string $destination, ?string $label = null,
         return new self($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
-    /**
-     * Create a new dropdown navigation menu item.
-     *
-     * @deprecated Use NavigationGroup::create() instead.
-     *
-     * TODO: Move to NavigationGroup::create() as this solves the naming issue, and because it makes little sense for it to be here. It also resolves the self/static issue.
-     *
-     * @param  string  $label  The label of the dropdown item.
-     * @param  array<NavigationItem>  $items  The items to be included in the dropdown.
-     * @param  int  $priority  The priority of the dropdown item. Leave blank to use the default priority, which is last in the menu.
-     */
-    public static function forGroup(string $label, array $items, int $priority = NavigationMenu::LAST): NavigationGroup
-    {
-        return NavigationGroup::create($label, $items, $priority);
-    }
-
     /**
      * Resolve a link to the navigation item.
      */
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 995ce8b81d2..0c2b05cb223 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -177,7 +177,7 @@ protected function createGroupItem(string $groupKey, string $groupName): Navigat
 
         $priority = $this->searchForGroupPriorityInConfig($groupKey);
 
-        return NavigationItem::forGroup($this->normalizeGroupLabel($label), [], $priority ?? NavigationMenu::LAST);
+        return NavigationGroup::create($this->normalizeGroupLabel($label), [], $priority ?? NavigationMenu::LAST);
     }
 
     protected function normalizeGroupLabel(string $label): string
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 2c81be2ea36..d0ede48df22 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -8,6 +8,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\ExternalRoute;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\MarkdownPage;
@@ -230,7 +231,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $menu = $this->createNavigationMenu();
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
-            NavigationItem::forGroup('Foo', [
+            NavigationGroup::create('Foo', [
                 NavigationItem::create(Routes::get('foo/bar')),
             ]),
         ]);
@@ -251,7 +252,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
         $this->assertEquals([
             NavigationItem::create(Routes::get('index')),
             NavigationItem::create((new MarkdownPage('foo'))->getRoute()),
-            NavigationItem::forGroup('Bar', [
+            NavigationGroup::create('Bar', [
                 NavigationItem::create((new MarkdownPage('bar/baz'))->getRoute()),
             ]),
         ], $menu->getItems()->all());
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 454cf6ecd05..f6a19307a61 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Filesystem;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Actions\ConvertsArrayToFrontMatter;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Hyde;
@@ -267,10 +268,10 @@ public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
 
         $this->assertEquals(
             collect([
-                NavigationItem::forGroup('Bar', [
+                NavigationGroup::create('Bar', [
                     NavigationItem::create(Routes::get('docs/bar'), priority: 999),
                 ]),
-                NavigationItem::forGroup('Foo', [
+                NavigationGroup::create('Foo', [
                     NavigationItem::create(Routes::get('docs/foo'), priority: 999),
                 ]),
             ]),
@@ -288,7 +289,7 @@ public function testDuplicateLabelsWithinTheSameGroupAreNotRemoved()
 
         $this->assertEquals(
             collect([
-                NavigationItem::forGroup('Foo', [
+                NavigationGroup::create('Foo', [
                     NavigationItem::create(Routes::get('docs/bar'), priority: 999),
                     NavigationItem::create(Routes::get('docs/foo'), priority: 999),
                 ]),
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 51510b06de0..b613557ac9b 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -14,6 +14,7 @@
 use Hyde\Support\Models\Route;
 use Hyde\Testing\UnitTestCase;
 use Mockery;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\NavigationElement;
 
 /**
@@ -209,7 +210,7 @@ public function testRouteBasedNavigationItemDestinationsAreResolvedRelatively()
 
     public function testDropdownFacade()
     {
-        $item = NavigationItem::forGroup('foo', []);
+        $item = NavigationGroup::create('foo');
 
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame([], $item->getItems());
@@ -222,14 +223,14 @@ public function testDropdownFacadeWithChildren()
             new NavigationItem(new Route(new MarkdownPage()), 'bar'),
         ];
 
-        $item = NavigationItem::forGroup('foo', $children);
+        $item = NavigationGroup::create('foo', $children);
         $this->assertSame($children, $item->getItems());
         $this->assertSame(999, $item->getPriority());
     }
 
     public function testDropdownFacadeWithCustomPriority()
     {
-        $item = NavigationItem::forGroup('foo', [], 500);
+        $item = NavigationGroup::create('foo', [], 500);
 
         $this->assertSame(500, $item->getPriority());
     }

From b4cf19ad30bd6fdbd2b8424dcfb3fe89504ce68b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:36:41 +0100
Subject: [PATCH 1227/4023] Add new todo markers

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b50e38682c3..cbd281afd81 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,6 +62,8 @@ public function hasGroups(): bool
     /**
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *
+     * @todo See if we can make this deterministic, so we pre-discover which group will be active, without having to weirdly check this in the view.
+     *
      * @internal This method is used in the sidebar view to determine if a group should be open, and is not intended to be used in other contexts.
      *
      * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ba93936fa98..53df7171678 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -26,6 +26,8 @@ class NavigationItem implements NavigationElement, Stringable
     protected ?Route $route;
     protected string $label;
     protected int $priority;
+
+    // TODO: Do we actually need this? We should just care if it's physically stored in a group.
     protected ?string $group = null;
 
     /**

From f2295da2be5fe3f1ab6197d96e22cd58ea51f278 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:40:07 +0100
Subject: [PATCH 1228/4023] Draft new method to get active group

---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index cbd281afd81..1700fc35f62 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -59,6 +59,11 @@ public function hasGroups(): bool
         return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
     }
 
+    public function getActiveGroup(): ?string
+    {
+        return Render::getPage()->navigationMenuGroup();
+    }
+
     /**
      * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
      *

From 62b71fd26cc5704450dc4efe296462b836396f7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:43:13 +0100
Subject: [PATCH 1229/4023] Get active group using current logic

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1700fc35f62..dd5f8c9d766 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -61,7 +61,9 @@ public function hasGroups(): bool
 
     public function getActiveGroup(): ?string
     {
-        return Render::getPage()->navigationMenuGroup();
+        return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
+            return $this->isGroupActive($item->getGroupKey());
+        })?->getGroupKey();
     }
 
     /**

From bce8386ceccc65f012e72604599872c9d5262162 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:43:48 +0100
Subject: [PATCH 1230/4023] Return the actual group instance

Want to move away from depending so much on the keys
---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index dd5f8c9d766..ae3fae6ffd9 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -59,11 +59,11 @@ public function hasGroups(): bool
         return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
     }
 
-    public function getActiveGroup(): ?string
+    public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
             return $this->isGroupActive($item->getGroupKey());
-        })?->getGroupKey();
+        });
     }
 
     /**

From ee47718baf3a65873794f847dd4aae2dda7cda3c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:45:22 +0100
Subject: [PATCH 1231/4023] Move old logic to temporary method for refactor

---
 .../Features/Navigation/DocumentationSidebar.php          | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ae3fae6ffd9..b623e7dcfae 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,7 +62,7 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
-            return $this->isGroupActive($item->getGroupKey());
+            return $this->legacy_isGroupActive($item->getGroupKey());
         });
     }
 
@@ -78,6 +78,12 @@ public function getActiveGroup(): ?NavigationGroup
      * We have this logic here because not all NavigationItem instances belong to sidebars, and we need data from both.
      */
     public function isGroupActive(string $group): bool
+    {
+        return $this->legacy_isGroupActive($group);
+    }
+
+    /** @deprecated Temporary method to aid in refactoring. */
+    public function legacy_isGroupActive(string $group): bool
     {
         $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
 

From 5708c2c6e9e6bd2aa0fbe834e6c80d68a2b8c45a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:46:34 +0100
Subject: [PATCH 1232/4023] Get state using new method

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b623e7dcfae..923880f054f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -79,7 +79,7 @@ public function getActiveGroup(): ?NavigationGroup
      */
     public function isGroupActive(string $group): bool
     {
-        return $this->legacy_isGroupActive($group);
+        return $group === $this->getActiveGroup()?->getGroupKey();
     }
 
     /** @deprecated Temporary method to aid in refactoring. */

From 44c2302ced31db07eae6574a125cc00130d6b750 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:50:23 +0100
Subject: [PATCH 1233/4023] Add todo

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 923880f054f..ef343fefb87 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -64,6 +64,8 @@ public function getActiveGroup(): ?NavigationGroup
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
             return $this->legacy_isGroupActive($item->getGroupKey());
         });
+
+        // TODO:  ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other')
     }
 
     /**

From 79a2124185752748620e4d06833f1747676b9fec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:50:49 +0100
Subject: [PATCH 1234/4023] Implement todo to support opening other groups

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index ef343fefb87..1c77bd21373 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,9 +63,7 @@ public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
             return $this->legacy_isGroupActive($item->getGroupKey());
-        });
-
-        // TODO:  ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other')
+        }) ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
     /**

From 0e198a4349baae7f198781e73aa77360237b93ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:51:46 +0100
Subject: [PATCH 1235/4023] Replace fallback to earlier null coalesce

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1c77bd21373..e3519bb2cdf 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,8 +62,8 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
-            return $this->legacy_isGroupActive($item->getGroupKey());
-        }) ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other');
+            return $this->legacy_isGroupActive($item->getGroupKey() ?? 'other');
+        });
     }
 
     /**

From 7f908d3ea9a836cb3d71978d23bd61e781a76377 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:51:49 +0100
Subject: [PATCH 1236/4023] Revert "Replace fallback to earlier null coalesce"

This reverts commit 0e198a4349baae7f198781e73aa77360237b93ea.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index e3519bb2cdf..1c77bd21373 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,8 +62,8 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
-            return $this->legacy_isGroupActive($item->getGroupKey() ?? 'other');
-        });
+            return $this->legacy_isGroupActive($item->getGroupKey());
+        }) ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
     /**

From 869283e95b9ed06d18831a16cbb8105fa6bd7242 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:52:18 +0100
Subject: [PATCH 1237/4023] Handle type error

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1c77bd21373..aeb20af17bc 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -62,7 +62,7 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
-            return $this->legacy_isGroupActive($item->getGroupKey());
+            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey());
         }) ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 

From dc4a5399a1f8637ae487523ea83f05d5b4e1d25a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 17:54:20 +0100
Subject: [PATCH 1238/4023] Update mocks

See https://github.com/hydephp/develop/pull/1632#issuecomment-2015506136
---
 .../tests/Feature/Services/DocumentationSidebarTest.php         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index f6a19307a61..cc057064539 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -209,12 +209,14 @@ public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
 
     public function testIsGroupActiveReturnsTrueWhenSuppliedGroupIsActive()
     {
+        $this->makePage('foo', ['navigation.group' => 'foo']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
         $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
     }
 
     public function testIsGroupActiveReturnsTrueForDifferingCasing()
     {
+        $this->makePage('foo', ['navigation.group' => 'Foo Bar']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'Foo Bar']));
         $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo-bar'));
     }

From 7161f0b32da591041173f2d4da4568af2339719e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:01:45 +0100
Subject: [PATCH 1239/4023] Evaluate types before loop

---
 .../Features/Navigation/DocumentationSidebar.php       |  8 ++++++--
 .../Feature/Services/DocumentationSidebarTest.php      | 10 ++++++++++
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index aeb20af17bc..f5478f3d07d 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -61,9 +61,13 @@ public function hasGroups(): bool
 
     public function getActiveGroup(): ?NavigationGroup
     {
-        return $this->items->first(function (NavigationItem|NavigationGroup $item): bool {
+        if (! $this->hasGroups()) {
+            return null;
+        }
+
+        return $this->items->first(function (NavigationGroup $item): bool {
             return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey());
-        }) ?? $this->items->first(fn (NavigationItem|NavigationGroup $item): bool => $item->getLabel() === 'Other');
+        }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index cc057064539..c8b9db2df3d 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -201,6 +201,16 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
         );
     }
 
+//    public function testGetActiveGroup()
+//    {
+//        $this->makePage('foo', ['navigation.group' => 'foo']);
+//        $this->makePage('bar', ['navigation.group' => 'bar']);
+//        $this->makePage('baz');
+//
+//        Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
+//        dd(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getActiveGroup());
+//    }
+
     public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));

From ee3aa690d284f4cb3e2ee7dacee786759973abcb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:06:33 +0100
Subject: [PATCH 1240/4023] Protect legacy method being removed

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index f5478f3d07d..008af3d845b 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -87,7 +87,7 @@ public function isGroupActive(string $group): bool
     }
 
     /** @deprecated Temporary method to aid in refactoring. */
-    public function legacy_isGroupActive(string $group): bool
+    protected function legacy_isGroupActive(string $group): bool
     {
         $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
 

From 1ac4204de961957eb8551642604a3a3ad92a0f82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:09:04 +0100
Subject: [PATCH 1241/4023] Create parameter for internal data hopping

This is temporary as I want to visualise how the data is passed here for the refactor
---
 .../Navigation/DocumentationSidebar.php        | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 008af3d845b..3367feff1cf 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -66,7 +66,7 @@ public function getActiveGroup(): ?NavigationGroup
         }
 
         return $this->items->first(function (NavigationGroup $item): bool {
-            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey());
+            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey(), Render::getPage());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
@@ -87,27 +87,27 @@ public function isGroupActive(string $group): bool
     }
 
     /** @deprecated Temporary method to aid in refactoring. */
-    protected function legacy_isGroupActive(string $group): bool
+    protected function legacy_isGroupActive(string $group, DocumentationPage $currentPage): bool
     {
-        $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey(Render::getPage()->navigationMenuGroup()) === $group;
+        $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup()) === $group;
 
-        if ($this->isCurrentPageIndexPage()) {
-            return $this->shouldIndexPageBeActive($group) || $groupMatchesCurrentPageGroup;
+        if ($this->isCurrentPageIndexPage($currentPage)) {
+            return $this->shouldIndexPageBeActive($group, $currentPage) || $groupMatchesCurrentPageGroup;
         }
 
         return $groupMatchesCurrentPageGroup;
     }
 
-    private function isCurrentPageIndexPage(): bool
+    private function isCurrentPageIndexPage(DocumentationPage $currentPage): bool
     {
-        return Render::getPage()->getRoute()->is(DocumentationPage::homeRouteName());
+        return $currentPage->getRoute()->is(DocumentationPage::homeRouteName());
     }
 
-    private function shouldIndexPageBeActive(string $group): bool
+    private function shouldIndexPageBeActive(string $group, DocumentationPage $currentPage): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 
-        if (filled(Render::getPage()->navigationMenuGroup())) {
+        if (filled($currentPage->navigationMenuGroup())) {
             return false;
         }
 

From c1ef8c86a6cbdf351a910197101978ece637f8a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:10:48 +0100
Subject: [PATCH 1242/4023] Introduce local variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 3367feff1cf..4213c2eccc8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -65,8 +65,10 @@ public function getActiveGroup(): ?NavigationGroup
             return null;
         }
 
-        return $this->items->first(function (NavigationGroup $item): bool {
-            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey(), Render::getPage());
+        $currentPage = Render::getPage();
+
+        return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
+            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey(), $currentPage);
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 

From 393820191aac4ead8a5cd606603efb68724b5586 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:10:59 +0100
Subject: [PATCH 1243/4023] Annotate type which should be constant

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4213c2eccc8..07a4dfd704e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -65,6 +65,7 @@ public function getActiveGroup(): ?NavigationGroup
             return null;
         }
 
+        /** @var DocumentationPage $currentPage */
         $currentPage = Render::getPage();
 
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {

From 136f1253cdf6aadf4a3a1f6f6a1a6fd11517d6a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:11:03 +0100
Subject: [PATCH 1244/4023] Revert "Annotate type which should be constant"

This reverts commit 393820191aac4ead8a5cd606603efb68724b5586.
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 07a4dfd704e..4213c2eccc8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -65,7 +65,6 @@ public function getActiveGroup(): ?NavigationGroup
             return null;
         }
 
-        /** @var DocumentationPage $currentPage */
         $currentPage = Render::getPage();
 
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {

From 30f3424ed8884960007de1ca96d62f9f6fe0a170 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:11:40 +0100
Subject: [PATCH 1245/4023] Use more generic type

Apparently some tests use other pages, and I think that's fine for now
---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4213c2eccc8..63df79b7398 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
+use Hyde\Pages\Concerns\HydePage;
 use Illuminate\Contracts\Support\Arrayable;
 
 use function app;
@@ -89,7 +90,7 @@ public function isGroupActive(string $group): bool
     }
 
     /** @deprecated Temporary method to aid in refactoring. */
-    protected function legacy_isGroupActive(string $group, DocumentationPage $currentPage): bool
+    protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
     {
         $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup()) === $group;
 
@@ -100,12 +101,12 @@ protected function legacy_isGroupActive(string $group, DocumentationPage $curren
         return $groupMatchesCurrentPageGroup;
     }
 
-    private function isCurrentPageIndexPage(DocumentationPage $currentPage): bool
+    private function isCurrentPageIndexPage(HydePage $currentPage): bool
     {
         return $currentPage->getRoute()->is(DocumentationPage::homeRouteName());
     }
 
-    private function shouldIndexPageBeActive(string $group, DocumentationPage $currentPage): bool
+    private function shouldIndexPageBeActive(string $group, HydePage $currentPage): bool
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 

From 9255856825b5fdc676aaed679e4191dd3d54be3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:13:14 +0100
Subject: [PATCH 1246/4023] Extract helper

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 63df79b7398..c3bd971c8f4 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -92,7 +92,7 @@ public function isGroupActive(string $group): bool
     /** @deprecated Temporary method to aid in refactoring. */
     protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
     {
-        $groupMatchesCurrentPageGroup = NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup()) === $group;
+        $groupMatchesCurrentPageGroup = $this->groupMatchesCurrentPageGroup($currentPage, $group);
 
         if ($this->isCurrentPageIndexPage($currentPage)) {
             return $this->shouldIndexPageBeActive($group, $currentPage) || $groupMatchesCurrentPageGroup;
@@ -116,4 +116,9 @@ private function shouldIndexPageBeActive(string $group, HydePage $currentPage):
 
         return $group === $this->getItems()->firstOrFail()->getGroupKey();
     }
+
+    protected function groupMatchesCurrentPageGroup(HydePage $currentPage, string $group): bool
+    {
+        return NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup()) === $group;
+    }
 }

From ff21524fa247a42532b352eb2b90a0c67ecd9a34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:13:23 +0100
Subject: [PATCH 1247/4023] Inline variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c3bd971c8f4..a2e479f5d35 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -92,13 +92,11 @@ public function isGroupActive(string $group): bool
     /** @deprecated Temporary method to aid in refactoring. */
     protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
     {
-        $groupMatchesCurrentPageGroup = $this->groupMatchesCurrentPageGroup($currentPage, $group);
-
         if ($this->isCurrentPageIndexPage($currentPage)) {
-            return $this->shouldIndexPageBeActive($group, $currentPage) || $groupMatchesCurrentPageGroup;
+            return $this->shouldIndexPageBeActive($group, $currentPage) || $this->groupMatchesCurrentPageGroup($currentPage, $group);
         }
 
-        return $groupMatchesCurrentPageGroup;
+        return $this->groupMatchesCurrentPageGroup($currentPage, $group);
     }
 
     private function isCurrentPageIndexPage(HydePage $currentPage): bool

From 44b901e2790eb3d42d6f472bdda59df5d4a07868 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:15:15 +0100
Subject: [PATCH 1248/4023] Shift auxiliary return path to helper method

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index a2e479f5d35..1a050fef99c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -93,7 +93,7 @@ public function isGroupActive(string $group): bool
     protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
     {
         if ($this->isCurrentPageIndexPage($currentPage)) {
-            return $this->shouldIndexPageBeActive($group, $currentPage) || $this->groupMatchesCurrentPageGroup($currentPage, $group);
+            return $this->shouldIndexPageBeActive($group, $currentPage);
         }
 
         return $this->groupMatchesCurrentPageGroup($currentPage, $group);
@@ -112,7 +112,7 @@ private function shouldIndexPageBeActive(string $group, HydePage $currentPage):
             return false;
         }
 
-        return $group === $this->getItems()->firstOrFail()->getGroupKey();
+        return ($group === $this->getItems()->firstOrFail()->getGroupKey()) || $this->groupMatchesCurrentPageGroup($currentPage, $group);
     }
 
     protected function groupMatchesCurrentPageGroup(HydePage $currentPage, string $group): bool

From 2f8b7cc66109e3f07fa4daf908f8ed81aca11c5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:17:06 +0100
Subject: [PATCH 1249/4023] Evaluate condition earlier

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1a050fef99c..a4bfb4fe3c6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -108,11 +108,15 @@ private function shouldIndexPageBeActive(string $group, HydePage $currentPage):
     {
         // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 
+        if ($this->groupMatchesCurrentPageGroup($currentPage, $group)) {
+            return true;
+        }
+
         if (filled($currentPage->navigationMenuGroup())) {
             return false;
         }
 
-        return ($group === $this->getItems()->firstOrFail()->getGroupKey()) || $this->groupMatchesCurrentPageGroup($currentPage, $group);
+        return $group === $this->getItems()->firstOrFail()->getGroupKey();
     }
 
     protected function groupMatchesCurrentPageGroup(HydePage $currentPage, string $group): bool

From 2efed29d02d17be7f56605675e63db2dc7ae22a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:24:04 +0100
Subject: [PATCH 1250/4023] Update active group check to compare against
 determined state

---
 .../resources/views/components/docs/sidebar-items.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-items.blade.php b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
index aef909869ad..6efff702add 100644
--- a/packages/framework/resources/views/components/docs/sidebar-items.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-items.blade.php
@@ -8,7 +8,7 @@
     <ul id="sidebar-items" role="list">
         @php /** @var \Hyde\Framework\Features\Navigation\NavigationGroup $group */ @endphp
         @foreach ($sidebar->getItems() as $group)
-            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ $sidebar->isGroupActive($group->getGroupKey()) ? 'true' : 'false' }} }" @endif>
+            <li class="sidebar-group" role="listitem" @if($sidebar->isCollapsible()) x-data="{ groupOpen: {{ ($sidebar->getActiveGroup() === $group) ? 'true' : 'false' }} }" @endif>
                 <header @class(['sidebar-group-header p-2 px-4 -ml-2 flex justify-between items-center', 'group hover:bg-black/10' => $sidebar->isCollapsible()]) @if($sidebar->isCollapsible()) @click="groupOpen = ! groupOpen" @endif>
                     <h4 @class(['sidebar-group-heading text-base font-semibold', 'cursor-pointer dark:group-hover:text-white' => $sidebar->isCollapsible()])>{{ $group->getLabel() }}</h4>
                     @if($sidebar->isCollapsible())

From a4a38f5e18efafb58ba3e7928b16b6fdd3c261c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 18:25:21 +0100
Subject: [PATCH 1251/4023] Add todo

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index a4bfb4fe3c6..d106cbfdc88 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,6 +63,7 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         if (! $this->hasGroups()) {
+            // Todo we should also consider checking if the sidebar is collapsible, because if it isn't all groups are always active.
             return null;
         }
 

From eb67f0816b8023ba2f16534cb547ceb9e1f7722f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 22 Mar 2024 19:50:33 +0100
Subject: [PATCH 1252/4023] Return null when current page is null

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index d106cbfdc88..b6f04f4b01c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -69,6 +69,10 @@ public function getActiveGroup(): ?NavigationGroup
 
         $currentPage = Render::getPage();
 
+        if ($currentPage === null) {
+            return null;
+        }
+
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
             return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey(), $currentPage);
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');

From 9387233254bdb3cdfcac90b5bfc268f6a56f9430 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 10:31:50 +0100
Subject: [PATCH 1253/4023] Create
 DocumentationSidebarGetActiveGroupUnitTest.php

---
 ...DocumentationSidebarGetActiveGroupUnitTest.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
new file mode 100644
index 00000000000..a0e0e627ef4
--- /dev/null
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ */
+class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
+{
+    //
+}

From a5df7c6e08a9d57325e2df507252b677c6241ae8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 10:32:02 +0100
Subject: [PATCH 1254/4023] Annotate test crosslinks

---
 .../tests/Feature/Services/DocumentationSidebarTest.php        | 1 +
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 3 +++
 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php | 1 +
 3 files changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index c8b9db2df3d..90f57c2b39c 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -27,6 +27,7 @@
  * @covers \Hyde\Framework\Features\Navigation\NavigationItem
  *
  * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarUnitTest
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarGetActiveGroupUnitTest
  */
 class DocumentationSidebarTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index a0e0e627ef4..5c009047574 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -8,6 +8,9 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarGetActiveGroupUnitTest
  */
 class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
 {
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 036350064ae..9b9c4b7bb6a 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -16,6 +16,7 @@
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
  *
  * @see \Hyde\Framework\Testing\Feature\Services\DocumentationSidebarTest
+ * @see \Hyde\Framework\Testing\Unit\DocumentationSidebarGetActiveGroupUnitTest
  * @see \Hyde\Framework\Testing\Unit\NavigationMenuUnitTest
  */
 class DocumentationSidebarUnitTest extends UnitTestCase

From 5203626b8032d7583ff7a18ab201f9c391098a4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 10:33:28 +0100
Subject: [PATCH 1255/4023] Implement the main test method

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 55 ++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 5c009047574..d28f8b1be56 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -4,7 +4,17 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Mockery;
+use Illuminate\View\Factory;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Facades\Render;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Support\Models\RenderData;
+use Hyde\Foundation\Facades\Routes;
+use Illuminate\Support\Facades\View;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
@@ -14,5 +24,48 @@
  */
 class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
 {
-    //
+    protected static bool $needsConfig = true;
+    protected static bool $needsKernel = true;
+
+    public function testGetActiveGroup()
+    {
+        View::swap(Mockery::mock(Factory::class)->makePartial());
+        $renderData = new RenderData();
+        Render::swap($renderData);
+
+        $pages = [
+            'foo' => 'one',
+            'bar' => 'two',
+            'baz' => 'three',
+        ];
+
+        foreach ($pages as $page => $group) {
+            $page = new DocumentationPage($page, ['navigation.group' => $group]);
+            Routes::addRoute($page->getRoute());
+        }
+
+        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+
+        $this->assertNull($menu->getActiveGroup());
+
+        $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
+
+        $this->assertInstanceOf(NavigationGroup::class, $menu->getActiveGroup());
+        $this->assertSame('one', $menu->getActiveGroup()->getGroupKey());
+
+        foreach ($pages as $page => $group) {
+            $renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
+            $this->assertSame($group, $menu->getActiveGroup()->getGroupKey());
+        }
+
+        $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
+
+        $this->assertSame([
+            'one' => true,
+            'two' => false,
+            'three' => false,
+        ], $menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
+            $item->getGroupKey() => $item === $menu->getActiveGroup(),
+        ])->all());
+    }
 }

From 4c868f242a16984b811b1e4617aa9d9d80ef091a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 10:41:20 +0100
Subject: [PATCH 1256/4023] Refactor test using ChatGPT

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 41 ++++++++++++++++---
 1 file changed, 36 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index d28f8b1be56..ddbe41363ba 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -27,8 +27,10 @@ class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
     protected static bool $needsConfig = true;
     protected static bool $needsKernel = true;
 
-    public function testGetActiveGroup()
+    protected function setUp(): void
     {
+        parent::setUp();
+
         View::swap(Mockery::mock(Factory::class)->makePartial());
         $renderData = new RenderData();
         Render::swap($renderData);
@@ -43,29 +45,58 @@ public function testGetActiveGroup()
             $page = new DocumentationPage($page, ['navigation.group' => $group]);
             Routes::addRoute($page->getRoute());
         }
+    }
 
+    public function testActiveGroupIsNullInitially()
+    {
         $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-
         $this->assertNull($menu->getActiveGroup());
+    }
+
+    public function testSetActiveGroup()
+    {
+        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
 
+        $renderData = Render::getFacadeRoot();
         $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 
         $this->assertInstanceOf(NavigationGroup::class, $menu->getActiveGroup());
         $this->assertSame('one', $menu->getActiveGroup()->getGroupKey());
+    }
+
+    public function testActiveGroupUpdatesWithPageChanges()
+    {
+        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $renderData = Render::getFacadeRoot();
+
+        $pages = [
+            'foo' => 'one',
+            'bar' => 'two',
+            'baz' => 'three',
+        ];
 
         foreach ($pages as $page => $group) {
             $renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
             $this->assertSame($group, $menu->getActiveGroup()->getGroupKey());
         }
+    }
 
+    public function testActiveGroupItems()
+    {
+        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $renderData = Render::getFacadeRoot();
         $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 
-        $this->assertSame([
+        $expectedItems = [
             'one' => true,
             'two' => false,
             'three' => false,
-        ], $menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
+        ];
+
+        $actualItems = $menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
             $item->getGroupKey() => $item === $menu->getActiveGroup(),
-        ])->all());
+        ])->all();
+
+        $this->assertSame($expectedItems, $actualItems);
     }
 }

From b8504ca155c63f818e08e3af1c6e161d4fcc2a83 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 10:46:19 +0100
Subject: [PATCH 1257/4023] Cleanup generated test

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 36 +++++++++----------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index ddbe41363ba..10a79e0ba32 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -27,13 +27,16 @@ class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
     protected static bool $needsConfig = true;
     protected static bool $needsKernel = true;
 
+    protected RenderData $renderData;
+    protected DocumentationSidebar $menu;
+
     protected function setUp(): void
     {
         parent::setUp();
 
         View::swap(Mockery::mock(Factory::class)->makePartial());
-        $renderData = new RenderData();
-        Render::swap($renderData);
+        $this->renderData = new RenderData();
+        Render::swap($this->renderData);
 
         $pages = [
             'foo' => 'one',
@@ -45,30 +48,25 @@ protected function setUp(): void
             $page = new DocumentationPage($page, ['navigation.group' => $group]);
             Routes::addRoute($page->getRoute());
         }
+
+        $this->menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
 
     public function testActiveGroupIsNullInitially()
     {
-        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertNull($menu->getActiveGroup());
+        $this->assertNull($this->menu->getActiveGroup());
     }
 
     public function testSetActiveGroup()
     {
-        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 
-        $renderData = Render::getFacadeRoot();
-        $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
-
-        $this->assertInstanceOf(NavigationGroup::class, $menu->getActiveGroup());
-        $this->assertSame('one', $menu->getActiveGroup()->getGroupKey());
+        $this->assertInstanceOf(NavigationGroup::class, $this->menu->getActiveGroup());
+        $this->assertSame('one', $this->menu->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupUpdatesWithPageChanges()
     {
-        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $renderData = Render::getFacadeRoot();
-
         $pages = [
             'foo' => 'one',
             'bar' => 'two',
@@ -76,16 +74,14 @@ public function testActiveGroupUpdatesWithPageChanges()
         ];
 
         foreach ($pages as $page => $group) {
-            $renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
-            $this->assertSame($group, $menu->getActiveGroup()->getGroupKey());
+            $this->renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
+            $this->assertSame($group, $this->menu->getActiveGroup()->getGroupKey());
         }
     }
 
     public function testActiveGroupItems()
     {
-        $menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $renderData = Render::getFacadeRoot();
-        $renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
+        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 
         $expectedItems = [
             'one' => true,
@@ -93,8 +89,8 @@ public function testActiveGroupItems()
             'three' => false,
         ];
 
-        $actualItems = $menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
-            $item->getGroupKey() => $item === $menu->getActiveGroup(),
+        $actualItems = $this->menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
+            $item->getGroupKey() => $item === $this->menu->getActiveGroup(),
         ])->all();
 
         $this->assertSame($expectedItems, $actualItems);

From 0376cb37494cb0f8063a567beae5aef95ed9fd18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:29:36 +0100
Subject: [PATCH 1258/4023] Split out unit test method

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php     | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 10a79e0ba32..3e3606549a7 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -53,6 +53,12 @@ protected function setUp(): void
     }
 
     public function testActiveGroupIsNullInitially()
+    {
+        $menu = new DocumentationSidebar();
+        $this->assertNull($menu->getActiveGroup());
+    }
+
+    public function testActiveGroupIsNullWhenNoGroupIsActive()
     {
         $this->assertNull($this->menu->getActiveGroup());
     }

From c2c0716da71cf6de8cd9dd0c5e233c75111eeead Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:36:58 +0100
Subject: [PATCH 1259/4023] Return null if sidebar is not collapsible

---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b6f04f4b01c..22678febb17 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,7 +63,10 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         if (! $this->hasGroups()) {
-            // Todo we should also consider checking if the sidebar is collapsible, because if it isn't all groups are always active.
+            return null;
+        }
+
+        if (! $this->isCollapsible()) {
             return null;
         }
 

From d39a6e1e8a99b2c165d44af8026fd9f94d1192f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:37:53 +0100
Subject: [PATCH 1260/4023] Add todos

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 22678febb17..78271f4d5df 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,10 +63,12 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         if (! $this->hasGroups()) {
+            // Todo: Would it make more sense to throw an exception here?
             return null;
         }
 
         if (! $this->isCollapsible()) {
+            // Todo: Would it make more sense to throw an exception here?
             return null;
         }
 

From e43260bc58501c3aa5765edc7c5fdf8f9bb85562 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:46:25 +0100
Subject: [PATCH 1261/4023] Refactor test to make data flow clearer

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 44 ++++++++++---------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 3e3606549a7..69befc453a3 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -28,7 +28,6 @@ class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
     protected static bool $needsKernel = true;
 
     protected RenderData $renderData;
-    protected DocumentationSidebar $menu;
 
     protected function setUp(): void
     {
@@ -37,19 +36,6 @@ protected function setUp(): void
         View::swap(Mockery::mock(Factory::class)->makePartial());
         $this->renderData = new RenderData();
         Render::swap($this->renderData);
-
-        $pages = [
-            'foo' => 'one',
-            'bar' => 'two',
-            'baz' => 'three',
-        ];
-
-        foreach ($pages as $page => $group) {
-            $page = new DocumentationPage($page, ['navigation.group' => $group]);
-            Routes::addRoute($page->getRoute());
-        }
-
-        $this->menu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
 
     public function testActiveGroupIsNullInitially()
@@ -60,15 +46,17 @@ public function testActiveGroupIsNullInitially()
 
     public function testActiveGroupIsNullWhenNoGroupIsActive()
     {
-        $this->assertNull($this->menu->getActiveGroup());
+        $this->assertNull($this->sidebar()->getActiveGroup());
     }
 
     public function testSetActiveGroup()
     {
         $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 
-        $this->assertInstanceOf(NavigationGroup::class, $this->menu->getActiveGroup());
-        $this->assertSame('one', $this->menu->getActiveGroup()->getGroupKey());
+        $sidebar = $this->sidebar();
+
+        $this->assertInstanceOf(NavigationGroup::class, $sidebar->getActiveGroup());
+        $this->assertSame('one', $sidebar->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupUpdatesWithPageChanges()
@@ -81,7 +69,7 @@ public function testActiveGroupUpdatesWithPageChanges()
 
         foreach ($pages as $page => $group) {
             $this->renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
-            $this->assertSame($group, $this->menu->getActiveGroup()->getGroupKey());
+            $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
         }
     }
 
@@ -95,10 +83,26 @@ public function testActiveGroupItems()
             'three' => false,
         ];
 
-        $actualItems = $this->menu->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
-            $item->getGroupKey() => $item === $this->menu->getActiveGroup(),
+        $sidebar = $this->sidebar();
+
+        $actualItems = $sidebar->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
+            $item->getGroupKey() => $item === $sidebar->getActiveGroup(),
         ])->all();
 
         $this->assertSame($expectedItems, $actualItems);
     }
+
+    protected function sidebar(array $pages = [
+        'foo' => 'one',
+        'bar' => 'two',
+        'baz' => 'three',
+    ]): DocumentationSidebar
+    {
+        foreach ($pages as $page => $group) {
+            $page = new DocumentationPage($page, ['navigation.group' => $group]);
+            Routes::addRoute($page->getRoute());
+        }
+
+        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
+    }
 }

From a0b0d22b6eee36d0480634090589a67f4e77494b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:42:16 +0100
Subject: [PATCH 1262/4023] Test active group is null when there are no groups

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php     | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 69befc453a3..b0bc5d6b8bf 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -44,6 +44,12 @@ public function testActiveGroupIsNullInitially()
         $this->assertNull($menu->getActiveGroup());
     }
 
+    public function testActiveGroupIsNullWhenThereAreNoGroups()
+    {
+        $menu = new DocumentationSidebar();
+        $this->assertNull($menu->getActiveGroup());
+    }
+
     public function testActiveGroupIsNullWhenNoGroupIsActive()
     {
         $this->assertNull($this->sidebar()->getActiveGroup());

From 70dccebfc9f3d52056e44cde200415790c6f12e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:40:52 +0100
Subject: [PATCH 1263/4023] Throw exceptions when trying to get group data for
 non grouped menu

I think trying to do this means something is wrong in the application, as you should not care about these methods if you are not using groups, so if you are, something is wrong, and it's helpful to have an exception explain exactly what is wrong than making the user trying to debug which part returns null.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 78271f4d5df..30fcbf5063d 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
+use BadMethodCallException;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
 use Hyde\Pages\Concerns\HydePage;
@@ -63,13 +64,11 @@ public function hasGroups(): bool
     public function getActiveGroup(): ?NavigationGroup
     {
         if (! $this->hasGroups()) {
-            // Todo: Would it make more sense to throw an exception here?
-            return null;
+            throw new BadMethodCallException('Cannot get the active group when there are no groups.');
         }
 
         if (! $this->isCollapsible()) {
-            // Todo: Would it make more sense to throw an exception here?
-            return null;
+            throw new BadMethodCallException('Cannot get the active group when the sidebar is not collapsible.');
         }
 
         $currentPage = Render::getPage();

From 68118a4674019d64f03bbbd5364a0c451143a20c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 11:41:37 +0100
Subject: [PATCH 1264/4023] Add early throw if there are no items

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 30fcbf5063d..711631cad13 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,6 +63,10 @@ public function hasGroups(): bool
 
     public function getActiveGroup(): ?NavigationGroup
     {
+        if ($this->items->isEmpty()) {
+            throw new BadMethodCallException('Cannot get the active group when there are no items.');
+        }
+
         if (! $this->hasGroups()) {
             throw new BadMethodCallException('Cannot get the active group when there are no groups.');
         }

From 96f16bf956fff3120d5da640e415be0f1ce79f2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 12:42:18 +0100
Subject: [PATCH 1265/4023] Tests that exceptions are now thrown

---
 ...umentationSidebarGetActiveGroupUnitTest.php | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index b0bc5d6b8bf..49147d21a03 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Mockery;
+use BadMethodCallException;
 use Illuminate\View\Factory;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Facades\Render;
@@ -12,6 +13,7 @@
 use Hyde\Support\Models\RenderData;
 use Hyde\Foundation\Facades\Routes;
 use Illuminate\Support\Facades\View;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
@@ -38,16 +40,20 @@ protected function setUp(): void
         Render::swap($this->renderData);
     }
 
-    public function testActiveGroupIsNullInitially()
+    public function testCannotGetActiveGroupWhenNoItemsExist()
     {
-        $menu = new DocumentationSidebar();
-        $this->assertNull($menu->getActiveGroup());
+        $this->expectException(BadMethodCallException::class);
+        $this->expectExceptionMessage('Cannot get the active group when there are no items.');
+
+        (new DocumentationSidebar())->getActiveGroup();
     }
 
-    public function testActiveGroupIsNullWhenThereAreNoGroups()
+    public function testCannotGetActiveGroupWhenNoGroupsExist()
     {
-        $menu = new DocumentationSidebar();
-        $this->assertNull($menu->getActiveGroup());
+        $this->expectException(BadMethodCallException::class);
+        $this->expectExceptionMessage('Cannot get the active group when there are no groups.');
+
+        (new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup();
     }
 
     public function testActiveGroupIsNullWhenNoGroupIsActive()

From 683d988419d5cd5a28a9c2218acc29d6d33f2730 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 12:45:17 +0100
Subject: [PATCH 1266/4023] Manually mock config for each test to reset it

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 49147d21a03..d701672ecfe 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -26,7 +26,6 @@
  */
 class DocumentationSidebarGetActiveGroupUnitTest extends UnitTestCase
 {
-    protected static bool $needsConfig = true;
     protected static bool $needsKernel = true;
 
     protected RenderData $renderData;
@@ -38,6 +37,8 @@ protected function setUp(): void
         View::swap(Mockery::mock(Factory::class)->makePartial());
         $this->renderData = new RenderData();
         Render::swap($this->renderData);
+
+        self::mockConfig();
     }
 
     public function testCannotGetActiveGroupWhenNoItemsExist()

From fa5876d3b15f5dc5011ed123f5848cf2548a1f28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 12:46:52 +0100
Subject: [PATCH 1267/4023] Test cannot get active group when sidebars are not
 collapsible

---
 .../DocumentationSidebarGetActiveGroupUnitTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index d701672ecfe..b1295cece1a 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -57,6 +57,16 @@ public function testCannotGetActiveGroupWhenNoGroupsExist()
         (new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup();
     }
 
+    public function testCannotGetActiveGroupWhenSidebarsAreNotCollapsible()
+    {
+        self::mockConfig(['docs.sidebar.collapsible' => false]);
+
+        $this->expectException(BadMethodCallException::class);
+        $this->expectExceptionMessage('Cannot get the active group when the sidebar is not collapsible.');
+
+        (new DocumentationSidebar([new NavigationGroup('foo')]))->getActiveGroup();
+    }
+
     public function testActiveGroupIsNullWhenNoGroupIsActive()
     {
         $this->assertNull($this->sidebar()->getActiveGroup());

From d05c77a1d8cf51dcbf0fbbc7453c864ad2ccdeb2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 12:55:43 +0100
Subject: [PATCH 1268/4023] Catch exception to return false

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 711631cad13..b932a682daa 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -99,7 +99,11 @@ public function getActiveGroup(): ?NavigationGroup
      */
     public function isGroupActive(string $group): bool
     {
-        return $group === $this->getActiveGroup()?->getGroupKey();
+        try {
+            return $group === $this->getActiveGroup()?->getGroupKey();
+        } catch (BadMethodCallException) {
+            return false;
+        }
     }
 
     /** @deprecated Temporary method to aid in refactoring. */

From 48f0d32dddf92a3d3a125af11472893601555afd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:10:30 +0100
Subject: [PATCH 1269/4023] Add method description

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index b932a682daa..1c519169727 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -61,6 +61,9 @@ public function hasGroups(): bool
         return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
     }
 
+    /**
+     * Get the group that should be open when the sidebar is loaded.
+     */
     public function getActiveGroup(): ?NavigationGroup
     {
         if ($this->items->isEmpty()) {

From 1a34ce4dbd64a24e748fb2cae22cc8797e32255d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:11:37 +0100
Subject: [PATCH 1270/4023] Mark method as experimental

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 1c519169727..4c7583cb535 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -63,6 +63,8 @@ public function hasGroups(): bool
 
     /**
      * Get the group that should be open when the sidebar is loaded.
+     *
+     * @experimental This method is experimental and may be changed or made internal in the future. If internal, we will not need the validation checks.
      */
     public function getActiveGroup(): ?NavigationGroup
     {

From 48ac6d080a1a13fa0eaf7fd9a379523084c81a92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:18:47 +0100
Subject: [PATCH 1271/4023] Mark method as internal and remove validation

I don't see that this will be used that much outside our view, so we don't need complexity to improve the DX of this.
---
 .../Navigation/DocumentationSidebar.php       | 14 +++---------
 ...mentationSidebarGetActiveGroupUnitTest.php | 22 +++++--------------
 2 files changed, 9 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 4c7583cb535..c865580b629 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -64,20 +64,12 @@ public function hasGroups(): bool
     /**
      * Get the group that should be open when the sidebar is loaded.
      *
-     * @experimental This method is experimental and may be changed or made internal in the future. If internal, we will not need the validation checks.
+     * @internal This method offloads logic for the sidebar view, and is not intended to be used in other contexts.
      */
     public function getActiveGroup(): ?NavigationGroup
     {
-        if ($this->items->isEmpty()) {
-            throw new BadMethodCallException('Cannot get the active group when there are no items.');
-        }
-
-        if (! $this->hasGroups()) {
-            throw new BadMethodCallException('Cannot get the active group when there are no groups.');
-        }
-
-        if (! $this->isCollapsible()) {
-            throw new BadMethodCallException('Cannot get the active group when the sidebar is not collapsible.');
+        if ($this->items->isEmpty() || (! $this->hasGroups()) || (! $this->isCollapsible())) {
+            return null;
         }
 
         $currentPage = Render::getPage();
diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index b1295cece1a..60d7ed925a2 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Mockery;
-use BadMethodCallException;
 use Illuminate\View\Factory;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Facades\Render;
@@ -41,30 +40,21 @@ protected function setUp(): void
         self::mockConfig();
     }
 
-    public function testCannotGetActiveGroupWhenNoItemsExist()
+    public function testGetActiveGroupIsNullWhenNoItemsExist()
     {
-        $this->expectException(BadMethodCallException::class);
-        $this->expectExceptionMessage('Cannot get the active group when there are no items.');
-
-        (new DocumentationSidebar())->getActiveGroup();
+        $this->assertNull((new DocumentationSidebar())->getActiveGroup());
     }
 
-    public function testCannotGetActiveGroupWhenNoGroupsExist()
+    public function testGetActiveGroupIsNullWhenNoGroupsExist()
     {
-        $this->expectException(BadMethodCallException::class);
-        $this->expectExceptionMessage('Cannot get the active group when there are no groups.');
-
-        (new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup();
+        $this->assertNull((new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup());
     }
 
-    public function testCannotGetActiveGroupWhenSidebarsAreNotCollapsible()
+    public function testGetActiveGroupIsNullWhenSidebarsAreNotCollapsible()
     {
         self::mockConfig(['docs.sidebar.collapsible' => false]);
 
-        $this->expectException(BadMethodCallException::class);
-        $this->expectExceptionMessage('Cannot get the active group when the sidebar is not collapsible.');
-
-        (new DocumentationSidebar([new NavigationGroup('foo')]))->getActiveGroup();
+        $this->assertNull((new DocumentationSidebar([new NavigationGroup('foo')]))->getActiveGroup());
     }
 
     public function testActiveGroupIsNullWhenNoGroupIsActive()

From a6942b13bc158a29cdd9f82cc8958dadd9581320 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:21:45 +0100
Subject: [PATCH 1272/4023] Test get active group

---
 .../Services/DocumentationSidebarTest.php     | 24 ++++++++++++-------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 90f57c2b39c..6c361083693 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -202,15 +202,21 @@ public function testGetItemsInGroupDoesNotIncludeDocsIndex()
         );
     }
 
-//    public function testGetActiveGroup()
-//    {
-//        $this->makePage('foo', ['navigation.group' => 'foo']);
-//        $this->makePage('bar', ['navigation.group' => 'bar']);
-//        $this->makePage('baz');
-//
-//        Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
-//        dd(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getActiveGroup());
-//    }
+    public function testGetActiveGroup()
+    {
+        $this->makePage('foo', ['navigation.group' => 'foo']);
+        $this->makePage('bar', ['navigation.group' => 'bar']);
+        $this->makePage('baz');
+
+        Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
+
+        $this->assertEquals(
+            NavigationGroup::create('Foo', [
+                NavigationItem::create(Routes::get('docs/foo'), priority: 999),
+            ]),
+            NavigationMenuGenerator::handle(DocumentationSidebar::class)->getActiveGroup()
+        );
+    }
 
     public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
     {

From 91e64ce5b40dd1e5271a238d91117df01856911e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:22:03 +0100
Subject: [PATCH 1273/4023] Revert "Catch exception to return false"

This reverts commit d05c77a1d8cf51dcbf0fbbc7453c864ad2ccdeb2.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c865580b629..c7abd1d0cf3 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use BadMethodCallException;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
 use Hyde\Pages\Concerns\HydePage;
@@ -96,11 +95,7 @@ public function getActiveGroup(): ?NavigationGroup
      */
     public function isGroupActive(string $group): bool
     {
-        try {
-            return $group === $this->getActiveGroup()?->getGroupKey();
-        } catch (BadMethodCallException) {
-            return false;
-        }
+        return $group === $this->getActiveGroup()?->getGroupKey();
     }
 
     /** @deprecated Temporary method to aid in refactoring. */

From be0b049ca76ffc4d3d7c8704e607a691d63a93ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:23:25 +0100
Subject: [PATCH 1274/4023] Inline old method now only used in tests

---
 .../Navigation/DocumentationSidebar.php       | 16 --------
 .../Services/DocumentationSidebarTest.php     | 39 ++++++++++++-------
 2 files changed, 26 insertions(+), 29 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index c7abd1d0cf3..f7a88e4cf2f 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -82,22 +82,6 @@ public function getActiveGroup(): ?NavigationGroup
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
-    /**
-     * Is a page within the group the current page? This is used to determine if the sidebar group should be open when loading the page.
-     *
-     * @todo See if we can make this deterministic, so we pre-discover which group will be active, without having to weirdly check this in the view.
-     *
-     * @internal This method is used in the sidebar view to determine if a group should be open, and is not intended to be used in other contexts.
-     *
-     * For index pages, this will also return true for the first group in the menu, unless the index page has a specific group set.
-     *
-     * We have this logic here because not all NavigationItem instances belong to sidebars, and we need data from both.
-     */
-    public function isGroupActive(string $group): bool
-    {
-        return $group === $this->getActiveGroup()?->getGroupKey();
-    }
-
     /** @deprecated Temporary method to aid in refactoring. */
     protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
     {
diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 6c361083693..11b578cd405 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -221,21 +221,24 @@ public function testGetActiveGroup()
     public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('bar' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testIsGroupActiveReturnsTrueWhenSuppliedGroupIsActive()
     {
         $this->makePage('foo', ['navigation.group' => 'foo']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
-        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertTrue('foo' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testIsGroupActiveReturnsTrueForDifferingCasing()
     {
         $this->makePage('foo', ['navigation.group' => 'Foo Bar']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'Foo Bar']));
-        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo-bar'));
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertTrue('foo-bar' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
@@ -246,9 +249,12 @@ public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
         $this->makePage('baz', ['navigation.group' => 'baz']);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
+        $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertTrue('bar' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('foo' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
@@ -259,9 +265,12 @@ public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
         $this->makePage('baz', ['navigation.group' => 'baz', 'navigation.priority' => 3]);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
+        $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertTrue('foo' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('bar' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenuSettings()
@@ -272,9 +281,12 @@ public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenu
         $this->makePage('baz', ['navigation.group' => 'baz', 'navigation.priority' => 3]);
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('bar'));
-        $this->assertTrue(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('baz'));
+        $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('foo' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('bar' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertTrue('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
@@ -322,7 +334,8 @@ public function testIsGroupActiveForIndexPageWithNoGroups()
         $this->makePage('index');
 
         Render::setPage(DocumentationPage::get('index'));
-        $this->assertFalse(NavigationMenuGenerator::handle(DocumentationSidebar::class)->isGroupActive('foo'));
+        $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
+        $this->assertFalse('foo' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
     }
 
     public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()

From d462ff7c93886017f45b0b6b1549e27cfa6dc384 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:34:44 +0100
Subject: [PATCH 1275/4023] Fix test method name

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 60d7ed925a2..442e901c2b6 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -62,7 +62,7 @@ public function testActiveGroupIsNullWhenNoGroupIsActive()
         $this->assertNull($this->sidebar()->getActiveGroup());
     }
 
-    public function testSetActiveGroup()
+    public function testWithActiveGroup()
     {
         $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
 

From cf52c68d3a8661cea5af1d4b2d5730a292931220 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 18:39:28 +0100
Subject: [PATCH 1276/4023] Create new test method with more realistic sample

Makes it easier to visualise when the structure looks like real data
---
 ...mentationSidebarGetActiveGroupUnitTest.php | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 442e901c2b6..34851dc3048 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -40,6 +40,36 @@ protected function setUp(): void
         self::mockConfig();
     }
 
+    public function testGetActiveGroup()
+    {
+        // The sidebar structure
+        $items = [
+            // Group keys
+            'getting-started' => [
+                // Group items
+                'Introduction',
+                'Installation',
+            ],
+            'configuration' => [
+                'Configuration',
+                'Environment Variables',
+            ],
+            'usage' => [
+                'Routing',
+                'Middleware',
+            ],
+        ];
+
+        // Create the sidebar
+        foreach ($items as $group => $groupItems) {
+            $groupItems = array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems);
+            $group = new NavigationGroup($group, $groupItems);
+            $items[$group->getGroupKey()] = $group;
+        }
+
+        $sidebar = new DocumentationSidebar($items);
+    }
+
     public function testGetActiveGroupIsNullWhenNoItemsExist()
     {
         $this->assertNull((new DocumentationSidebar())->getActiveGroup());

From 180e8f0ff7ee680c550fdd1bd3159b69a2e166b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:04:24 +0100
Subject: [PATCH 1277/4023] Inline variable

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 34851dc3048..5f5c624fe24 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -63,8 +63,7 @@ public function testGetActiveGroup()
         // Create the sidebar
         foreach ($items as $group => $groupItems) {
             $groupItems = array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems);
-            $group = new NavigationGroup($group, $groupItems);
-            $items[$group->getGroupKey()] = $group;
+            $items[$group] = new NavigationGroup($group, $groupItems);
         }
 
         $sidebar = new DocumentationSidebar($items);

From ae51390f19c0ada3f334a893c36fb95bb064c31f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:04:32 +0100
Subject: [PATCH 1278/4023] Inline variable

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 5f5c624fe24..4ce76579b7e 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -62,8 +62,7 @@ public function testGetActiveGroup()
 
         // Create the sidebar
         foreach ($items as $group => $groupItems) {
-            $groupItems = array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems);
-            $items[$group] = new NavigationGroup($group, $groupItems);
+            $items[$group] = new NavigationGroup($group, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
         }
 
         $sidebar = new DocumentationSidebar($items);

From 71aa97d90f1036f7cb0c55561421305e84382cc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:06:13 +0100
Subject: [PATCH 1279/4023] Rename variables

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 4ce76579b7e..e60eef88aeb 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -61,8 +61,8 @@ public function testGetActiveGroup()
         ];
 
         // Create the sidebar
-        foreach ($items as $group => $groupItems) {
-            $items[$group] = new NavigationGroup($group, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
+        foreach ($items as $groupKey => $groupItems) {
+            $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
         }
 
         $sidebar = new DocumentationSidebar($items);

From 22cf763d3eaf777a8e4b60ce8475bf4fe38e2bcd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:07:19 +0100
Subject: [PATCH 1280/4023] Assert null

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index e60eef88aeb..b7acd4eef8a 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -66,6 +66,8 @@ public function testGetActiveGroup()
         }
 
         $sidebar = new DocumentationSidebar($items);
+
+        $this->assertNull($sidebar->getActiveGroup());
     }
 
     public function testGetActiveGroupIsNullWhenNoItemsExist()

From 8a89a37df52c1d7244a6365905edd4a08d4870b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:10:28 +0100
Subject: [PATCH 1281/4023] Extract helper method

---
 .../DocumentationSidebarGetActiveGroupUnitTest.php    | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index b7acd4eef8a..45048d3f101 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -94,7 +94,7 @@ public function testActiveGroupIsNullWhenNoGroupIsActive()
 
     public function testWithActiveGroup()
     {
-        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
+        $this->mockCurrentPageForActiveGroup('one');
 
         $sidebar = $this->sidebar();
 
@@ -111,14 +111,14 @@ public function testActiveGroupUpdatesWithPageChanges()
         ];
 
         foreach ($pages as $page => $group) {
-            $this->renderData->setPage(new DocumentationPage($page, ['navigation.group' => $group]));
+            $this->mockCurrentPageForActiveGroup($group);
             $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
         }
     }
 
     public function testActiveGroupItems()
     {
-        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'one']));
+        $this->mockCurrentPageForActiveGroup('one');
 
         $expectedItems = [
             'one' => true,
@@ -148,4 +148,9 @@ protected function sidebar(array $pages = [
 
         return NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
+
+    protected function mockCurrentPageForActiveGroup(string $group): void
+    {
+        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => $group]));
+    }
 }

From c4d7884876ae026285e4f812785480c70519643f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:10:36 +0100
Subject: [PATCH 1282/4023] Remove variable

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 45048d3f101..18ab2d032b5 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -110,7 +110,7 @@ public function testActiveGroupUpdatesWithPageChanges()
             'baz' => 'three',
         ];
 
-        foreach ($pages as $page => $group) {
+        foreach ($pages as $group) {
             $this->mockCurrentPageForActiveGroup($group);
             $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
         }

From e93a0c5b5137232b9e5d5fd34bd4f50fe7132d7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:11:10 +0100
Subject: [PATCH 1283/4023] Section code

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 18ab2d032b5..2ca1f734278 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -60,11 +60,12 @@ public function testGetActiveGroup()
             ],
         ];
 
-        // Create the sidebar
+        // Create the sidebar items
         foreach ($items as $groupKey => $groupItems) {
             $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
         }
 
+        // Create the sidebar
         $sidebar = new DocumentationSidebar($items);
 
         $this->assertNull($sidebar->getActiveGroup());

From 89debff7926ec93291a7c5f6ec7db94298efc080 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:15:57 +0100
Subject: [PATCH 1284/4023] Add comment

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 2ca1f734278..2cfd7db7367 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -68,6 +68,7 @@ public function testGetActiveGroup()
         // Create the sidebar
         $sidebar = new DocumentationSidebar($items);
 
+        // Assert is null when there is no active group
         $this->assertNull($sidebar->getActiveGroup());
     }
 

From c7399432f9bb9f1828c6e7fc5b0a1f7174779383 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:17:40 +0100
Subject: [PATCH 1285/4023] Revert "Remove variable"

This reverts commit c4d7884876ae026285e4f812785480c70519643f.
---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 2cfd7db7367..79398acc75d 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -112,7 +112,7 @@ public function testActiveGroupUpdatesWithPageChanges()
             'baz' => 'three',
         ];
 
-        foreach ($pages as $group) {
+        foreach ($pages as $page => $group) {
             $this->mockCurrentPageForActiveGroup($group);
             $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
         }

From 066a804795707b9b41366887d5eeb38a8fcf9381 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:18:23 +0100
Subject: [PATCH 1286/4023] Allow setting the identifier in the testing helper
 method

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 79398acc75d..19a457608be 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -113,7 +113,7 @@ public function testActiveGroupUpdatesWithPageChanges()
         ];
 
         foreach ($pages as $page => $group) {
-            $this->mockCurrentPageForActiveGroup($group);
+            $this->mockCurrentPageForActiveGroup($group, $page);
             $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
         }
     }
@@ -151,8 +151,8 @@ protected function sidebar(array $pages = [
         return NavigationMenuGenerator::handle(DocumentationSidebar::class);
     }
 
-    protected function mockCurrentPageForActiveGroup(string $group): void
+    protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void
     {
-        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => $group]));
+        $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));
     }
 }

From d70fccf5791968451348ac34c3e02193514a7258 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:21:18 +0100
Subject: [PATCH 1287/4023] Add more assertions

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 19a457608be..e02768c674e 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -70,6 +70,52 @@ public function testGetActiveGroup()
 
         // Assert is null when there is no active group
         $this->assertNull($sidebar->getActiveGroup());
+
+        // Assert is null when active group is outside the sidebar
+        $this->mockCurrentPageForActiveGroup('foo');
+        $this->assertNull($sidebar->getActiveGroup());
+
+        // Assert is null when sidebar is not collapsible
+        self::mockConfig(['docs.sidebar.collapsible' => false]);
+        $this->mockCurrentPageForActiveGroup('getting-started');
+        $this->assertNull($sidebar->getActiveGroup());
+        self::mockConfig(['docs.sidebar.collapsible' => true]);
+
+        // Assert the active group
+        $this->mockCurrentPageForActiveGroup('getting-started');
+        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group
+        $this->mockCurrentPageForActiveGroup('configuration');
+        $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group
+        $this->mockCurrentPageForActiveGroup('usage');
+        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for identifier within the group
+        $this->mockCurrentPageForActiveGroup('getting-started', 'Introduction');
+        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for identifier within the group
+        $this->mockCurrentPageForActiveGroup('configuration', 'Configuration');
+        $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for identifier within the group
+        $this->mockCurrentPageForActiveGroup('usage', 'Routing');
+        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for with group key having different casing
+        $this->mockCurrentPageForActiveGroup('GETTING-STARTED');
+        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for with group key having different casing
+        $this->mockCurrentPageForActiveGroup('Getting-Started');
+        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+
+        // Assert the active group for with group key having different casing
+        $this->mockCurrentPageForActiveGroup('getting-started');
+        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
     }
 
     public function testGetActiveGroupIsNullWhenNoItemsExist()

From 65352b86f8dbb1e6392680d890b16ab025912907 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:22:16 +0100
Subject: [PATCH 1288/4023] Remove overlapping tests

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 71 -------------------
 1 file changed, 71 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index e02768c674e..08cfbd0dc7a 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -10,12 +10,10 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Models\RenderData;
-use Hyde\Foundation\Facades\Routes;
 use Illuminate\Support\Facades\View;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
@@ -128,75 +126,6 @@ public function testGetActiveGroupIsNullWhenNoGroupsExist()
         $this->assertNull((new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup());
     }
 
-    public function testGetActiveGroupIsNullWhenSidebarsAreNotCollapsible()
-    {
-        self::mockConfig(['docs.sidebar.collapsible' => false]);
-
-        $this->assertNull((new DocumentationSidebar([new NavigationGroup('foo')]))->getActiveGroup());
-    }
-
-    public function testActiveGroupIsNullWhenNoGroupIsActive()
-    {
-        $this->assertNull($this->sidebar()->getActiveGroup());
-    }
-
-    public function testWithActiveGroup()
-    {
-        $this->mockCurrentPageForActiveGroup('one');
-
-        $sidebar = $this->sidebar();
-
-        $this->assertInstanceOf(NavigationGroup::class, $sidebar->getActiveGroup());
-        $this->assertSame('one', $sidebar->getActiveGroup()->getGroupKey());
-    }
-
-    public function testActiveGroupUpdatesWithPageChanges()
-    {
-        $pages = [
-            'foo' => 'one',
-            'bar' => 'two',
-            'baz' => 'three',
-        ];
-
-        foreach ($pages as $page => $group) {
-            $this->mockCurrentPageForActiveGroup($group, $page);
-            $this->assertSame($group, $this->sidebar()->getActiveGroup()->getGroupKey());
-        }
-    }
-
-    public function testActiveGroupItems()
-    {
-        $this->mockCurrentPageForActiveGroup('one');
-
-        $expectedItems = [
-            'one' => true,
-            'two' => false,
-            'three' => false,
-        ];
-
-        $sidebar = $this->sidebar();
-
-        $actualItems = $sidebar->getItems()->mapWithKeys(fn (NavigationGroup $item): array => [
-            $item->getGroupKey() => $item === $sidebar->getActiveGroup(),
-        ])->all();
-
-        $this->assertSame($expectedItems, $actualItems);
-    }
-
-    protected function sidebar(array $pages = [
-        'foo' => 'one',
-        'bar' => 'two',
-        'baz' => 'three',
-    ]): DocumentationSidebar
-    {
-        foreach ($pages as $page => $group) {
-            $page = new DocumentationPage($page, ['navigation.group' => $group]);
-            Routes::addRoute($page->getRoute());
-        }
-
-        return NavigationMenuGenerator::handle(DocumentationSidebar::class);
-    }
-
     protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));

From 2baf0d0991be3a63246332a0bed7121c7f6c55e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:23:38 +0100
Subject: [PATCH 1289/4023] Extract helper method

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 55 ++++++++++---------
 1 file changed, 30 insertions(+), 25 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 08cfbd0dc7a..dd7656817c2 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -40,31 +40,7 @@ protected function setUp(): void
 
     public function testGetActiveGroup()
     {
-        // The sidebar structure
-        $items = [
-            // Group keys
-            'getting-started' => [
-                // Group items
-                'Introduction',
-                'Installation',
-            ],
-            'configuration' => [
-                'Configuration',
-                'Environment Variables',
-            ],
-            'usage' => [
-                'Routing',
-                'Middleware',
-            ],
-        ];
-
-        // Create the sidebar items
-        foreach ($items as $groupKey => $groupItems) {
-            $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
-        }
-
-        // Create the sidebar
-        $sidebar = new DocumentationSidebar($items);
+        $sidebar = $this->createSidebar();
 
         // Assert is null when there is no active group
         $this->assertNull($sidebar->getActiveGroup());
@@ -130,4 +106,33 @@ protected function mockCurrentPageForActiveGroup(string $group, string $identifi
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));
     }
+
+    protected function createSidebar(): DocumentationSidebar
+    {
+        // The sidebar structure
+        $items = [
+            // Group keys
+            'getting-started' => [
+                // Group items
+                'Introduction',
+                'Installation',
+            ],
+            'configuration' => [
+                'Configuration',
+                'Environment Variables',
+            ],
+            'usage' => [
+                'Routing',
+                'Middleware',
+            ],
+        ];
+
+        // Create the sidebar items
+        foreach ($items as $groupKey => $groupItems) {
+            $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
+        }
+
+        // Create the sidebar
+        return new DocumentationSidebar($items);
+    }
 }

From 73e60d4977f950d2023a57c6d917534ed47f60e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:23:50 +0100
Subject: [PATCH 1290/4023] Move up helper method in class

Makes it easier to understand the test
---
 ...mentationSidebarGetActiveGroupUnitTest.php | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index dd7656817c2..86b6a637f26 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -38,6 +38,35 @@ protected function setUp(): void
         self::mockConfig();
     }
 
+    protected function createSidebar(): DocumentationSidebar
+    {
+        // The sidebar structure
+        $items = [
+            // Group keys
+            'getting-started' => [
+                // Group items
+                'Introduction',
+                'Installation',
+            ],
+            'configuration' => [
+                'Configuration',
+                'Environment Variables',
+            ],
+            'usage' => [
+                'Routing',
+                'Middleware',
+            ],
+        ];
+
+        // Create the sidebar items
+        foreach ($items as $groupKey => $groupItems) {
+            $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
+        }
+
+        // Create the sidebar
+        return new DocumentationSidebar($items);
+    }
+
     public function testGetActiveGroup()
     {
         $sidebar = $this->createSidebar();
@@ -106,33 +135,4 @@ protected function mockCurrentPageForActiveGroup(string $group, string $identifi
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));
     }
-
-    protected function createSidebar(): DocumentationSidebar
-    {
-        // The sidebar structure
-        $items = [
-            // Group keys
-            'getting-started' => [
-                // Group items
-                'Introduction',
-                'Installation',
-            ],
-            'configuration' => [
-                'Configuration',
-                'Environment Variables',
-            ],
-            'usage' => [
-                'Routing',
-                'Middleware',
-            ],
-        ];
-
-        // Create the sidebar items
-        foreach ($items as $groupKey => $groupItems) {
-            $items[$groupKey] = new NavigationGroup($groupKey, array_map(fn (string $item): NavigationItem => new NavigationItem($item, $item), $groupItems));
-        }
-
-        // Create the sidebar
-        return new DocumentationSidebar($items);
-    }
 }

From 655598c1986f306bdaa6d86683e6c7aff53e8f71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:24:43 +0100
Subject: [PATCH 1291/4023] Use ChatGPT to split out assertions into new tests

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 60 ++++++++++++++-----
 1 file changed, 45 insertions(+), 15 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 86b6a637f26..ed990ac146b 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -66,57 +66,87 @@ protected function createSidebar(): DocumentationSidebar
         // Create the sidebar
         return new DocumentationSidebar($items);
     }
-
-    public function testGetActiveGroup()
+    public function testNoActiveGroupWhenNoneExists()
     {
         $sidebar = $this->createSidebar();
-
-        // Assert is null when there is no active group
         $this->assertNull($sidebar->getActiveGroup());
+    }
 
-        // Assert is null when active group is outside the sidebar
+    public function testNoActiveGroupWhenOutsideSidebar()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('foo');
         $this->assertNull($sidebar->getActiveGroup());
+    }
 
-        // Assert is null when sidebar is not collapsible
+    public function testNoActiveGroupWhenSidebarNotCollapsible()
+    {
+        $sidebar = $this->createSidebar();
         self::mockConfig(['docs.sidebar.collapsible' => false]);
         $this->mockCurrentPageForActiveGroup('getting-started');
         $this->assertNull($sidebar->getActiveGroup());
         self::mockConfig(['docs.sidebar.collapsible' => true]);
+    }
 
-        // Assert the active group
+    public function testActiveGroupGettingStarted()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started');
         $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group
+    public function testActiveGroupConfiguration()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('configuration');
         $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group
+    public function testActiveGroupUsage()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('usage');
         $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for identifier within the group
+    public function testActiveGroupWithIdentifierGettingStarted()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started', 'Introduction');
         $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for identifier within the group
+    public function testActiveGroupWithIdentifierConfiguration()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('configuration', 'Configuration');
         $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for identifier within the group
+    public function testActiveGroupWithIdentifierUsage()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('usage', 'Routing');
         $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for with group key having different casing
+    public function testActiveGroupDifferentCasingGettingStarted()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('GETTING-STARTED');
         $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for with group key having different casing
+    public function testActiveGroupDifferentCasingGettingStarted2()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('Getting-Started');
         $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+    }
 
-        // Assert the active group for with group key having different casing
+    public function testActiveGroupDifferentCasingGettingStarted3()
+    {
+        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started');
         $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
     }

From a4cd4af7d706622ab0e281717c866baa4f0d85cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:25:19 +0100
Subject: [PATCH 1292/4023] Inline local variables

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 36 +++++++------------
 1 file changed, 12 insertions(+), 24 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index ed990ac146b..a11f294c7db 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -68,87 +68,75 @@ protected function createSidebar(): DocumentationSidebar
     }
     public function testNoActiveGroupWhenNoneExists()
     {
-        $sidebar = $this->createSidebar();
-        $this->assertNull($sidebar->getActiveGroup());
+        $this->assertNull($this->createSidebar()->getActiveGroup());
     }
 
     public function testNoActiveGroupWhenOutsideSidebar()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('foo');
-        $this->assertNull($sidebar->getActiveGroup());
+        $this->assertNull($this->createSidebar()->getActiveGroup());
     }
 
     public function testNoActiveGroupWhenSidebarNotCollapsible()
     {
-        $sidebar = $this->createSidebar();
         self::mockConfig(['docs.sidebar.collapsible' => false]);
         $this->mockCurrentPageForActiveGroup('getting-started');
-        $this->assertNull($sidebar->getActiveGroup());
+        $this->assertNull($this->createSidebar()->getActiveGroup());
         self::mockConfig(['docs.sidebar.collapsible' => true]);
     }
 
     public function testActiveGroupGettingStarted()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started');
-        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupConfiguration()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('configuration');
-        $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('configuration', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupUsage()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('usage');
-        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupWithIdentifierGettingStarted()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started', 'Introduction');
-        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupWithIdentifierConfiguration()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('configuration', 'Configuration');
-        $this->assertSame('configuration', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('configuration', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupWithIdentifierUsage()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('usage', 'Routing');
-        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('GETTING-STARTED');
-        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted2()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('Getting-Started');
-        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted3()
     {
-        $sidebar = $this->createSidebar();
         $this->mockCurrentPageForActiveGroup('getting-started');
-        $this->assertSame('getting-started', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testGetActiveGroupIsNullWhenNoItemsExist()

From 5b510896440b063f666312a087424977ebb3d281 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:26:00 +0100
Subject: [PATCH 1293/4023] Add missing newline

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index a11f294c7db..fd7fd4482a5 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -66,6 +66,7 @@ protected function createSidebar(): DocumentationSidebar
         // Create the sidebar
         return new DocumentationSidebar($items);
     }
+
     public function testNoActiveGroupWhenNoneExists()
     {
         $this->assertNull($this->createSidebar()->getActiveGroup());

From 7e86d30f82d1c023b1f900f39744ed866f474a9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:27:12 +0100
Subject: [PATCH 1294/4023] Comment logic abstract

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index f7a88e4cf2f..6567c24c95c 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -67,6 +67,8 @@ public function hasGroups(): bool
      */
     public function getActiveGroup(): ?NavigationGroup
     {
+        // A group is active when it contains the current page being rendered
+
         if ($this->items->isEmpty() || (! $this->hasGroups()) || (! $this->isCollapsible())) {
             return null;
         }

From 1495094980fedd0182d6f081159eff7555ba2031 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:36:54 +0100
Subject: [PATCH 1295/4023] Draft new unit tests

---
 ...DocumentationSidebarGetActiveGroupUnitTest.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index fd7fd4482a5..c17f1059238 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -150,6 +150,21 @@ public function testGetActiveGroupIsNullWhenNoGroupsExist()
         $this->assertNull((new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup());
     }
 
+    public function testGetActiveGroupReturnsFirstGroupWhenRenderingIndexPage()
+    {
+
+    }
+
+    public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRenderingIndexPage()
+    {
+
+    }
+
+    public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
+    {
+
+    }
+
     protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));

From 528d9f4bcd423fe6c132f48a644ac992d86907dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:39:33 +0100
Subject: [PATCH 1296/4023] Implement the tests

---
 .../DocumentationSidebarGetActiveGroupUnitTest.php     | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index c17f1059238..f82ffc1a14e 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -152,17 +152,25 @@ public function testGetActiveGroupIsNullWhenNoGroupsExist()
 
     public function testGetActiveGroupReturnsFirstGroupWhenRenderingIndexPage()
     {
-
+        $this->renderData->setPage(new DocumentationPage('index'));
+        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
     }
 
     public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRenderingIndexPage()
     {
+        $sidebar = $this->createSidebar();
+        $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
 
+        $this->renderData->setPage(new DocumentationPage('index'));
+        $this->assertSame('other', $sidebar->getActiveGroup()->getGroupKey());
     }
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
     {
+        $sidebar = $this->createSidebar();
 
+        $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
+        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
     }
 
     protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void

From 04aa0f6433ed891417b9cc896911d2b1cfac53d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:39:45 +0100
Subject: [PATCH 1297/4023] Add additional unit test

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php  | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index f82ffc1a14e..2b196ef5775 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -173,6 +173,15 @@ public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderin
         $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
     }
 
+    public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPageRegardlessOfPriorities()
+    {
+        $sidebar = $this->createSidebar();
+        $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
+
+        $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
+        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+    }
+
     protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));

From d0ef0052a263f12b30a20077332aca13a0873b9c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:43:56 +0100
Subject: [PATCH 1298/4023] Add additional unit test

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php     | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 2b196ef5775..79286a5bfc9 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -150,6 +150,12 @@ public function testGetActiveGroupIsNullWhenNoGroupsExist()
         $this->assertNull((new DocumentationSidebar([new NavigationItem('foo', 'Foo')]))->getActiveGroup());
     }
 
+    public function testGetActiveGroupIsNullIfTheSetGroupIsNotPresentInTheSidebarItems()
+    {
+        $this->renderData->setPage(new DocumentationPage('foo', ['navigation.group' => 'foo']));
+        $this->assertNull($this->createSidebar()->getActiveGroup());
+    }
+
     public function testGetActiveGroupReturnsFirstGroupWhenRenderingIndexPage()
     {
         $this->renderData->setPage(new DocumentationPage('index'));

From 35446053ba7c11cc7874098e20ecc7cca1a18a56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:44:44 +0100
Subject: [PATCH 1299/4023] Compare using deterministic logic instead of legacy
 loop

Performance consideration is negligible (new is 0.038ms instead of 0.085ms) but it makes it more understandable and reduces the need of a complex loop
---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 6567c24c95c..5286c48c005 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -80,7 +80,7 @@ public function getActiveGroup(): ?NavigationGroup
         }
 
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
-            return $item->getGroupKey() && $this->legacy_isGroupActive($item->getGroupKey(), $currentPage);
+            return $item->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 

From 2e96c0212117c64c1fcb15831f960f324de4989d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:48:08 +0100
Subject: [PATCH 1300/4023] Add early check for index page handling

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5286c48c005..80c075c976e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -79,6 +79,10 @@ public function getActiveGroup(): ?NavigationGroup
             return null;
         }
 
+        if ($this->isCurrentPageIndexPage($currentPage) && blank($currentPage->navigationMenuGroup())) {
+            return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
+        }
+
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
             return $item->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');

From d167719d86d77024535db81e3b49ae19f0ceb6a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:49:26 +0100
Subject: [PATCH 1301/4023] Remove legacy code that is now no longer needed

---
 .../Navigation/DocumentationSidebar.php       | 32 -------------------
 1 file changed, 32 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 80c075c976e..5b58dd70bbd 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -7,11 +7,9 @@
 use Hyde\Facades\Config;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Facades\Render;
-use Hyde\Pages\Concerns\HydePage;
 use Illuminate\Contracts\Support\Arrayable;
 
 use function app;
-use function filled;
 use function is_string;
 
 class DocumentationSidebar extends NavigationMenu
@@ -88,38 +86,8 @@ public function getActiveGroup(): ?NavigationGroup
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 
-    /** @deprecated Temporary method to aid in refactoring. */
-    protected function legacy_isGroupActive(string $group, HydePage $currentPage): bool
-    {
-        if ($this->isCurrentPageIndexPage($currentPage)) {
-            return $this->shouldIndexPageBeActive($group, $currentPage);
-        }
-
-        return $this->groupMatchesCurrentPageGroup($currentPage, $group);
-    }
-
     private function isCurrentPageIndexPage(HydePage $currentPage): bool
     {
         return $currentPage->getRoute()->is(DocumentationPage::homeRouteName());
     }
-
-    private function shouldIndexPageBeActive(string $group, HydePage $currentPage): bool
-    {
-        // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
-
-        if ($this->groupMatchesCurrentPageGroup($currentPage, $group)) {
-            return true;
-        }
-
-        if (filled($currentPage->navigationMenuGroup())) {
-            return false;
-        }
-
-        return $group === $this->getItems()->firstOrFail()->getGroupKey();
-    }
-
-    protected function groupMatchesCurrentPageGroup(HydePage $currentPage, string $group): bool
-    {
-        return NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup()) === $group;
-    }
 }

From 1c1080f3c59cb1ace3096616db1f4cca2e1e72a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:49:54 +0100
Subject: [PATCH 1302/4023] Add back code comment

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5b58dd70bbd..bc45b8a6c33 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -78,6 +78,8 @@ public function getActiveGroup(): ?NavigationGroup
         }
 
         if ($this->isCurrentPageIndexPage($currentPage) && blank($currentPage->navigationMenuGroup())) {
+            // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
+
             return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
         }
 

From c860213004c8d685e519ed79757f0046b8daefb6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:50:09 +0100
Subject: [PATCH 1303/4023] Inline method

---
 .../Framework/Features/Navigation/DocumentationSidebar.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index bc45b8a6c33..8957ba16936 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -77,7 +77,7 @@ public function getActiveGroup(): ?NavigationGroup
             return null;
         }
 
-        if ($this->isCurrentPageIndexPage($currentPage) && blank($currentPage->navigationMenuGroup())) {
+        if ($currentPage->getRoute()->is(DocumentationPage::homeRouteName()) && blank($currentPage->navigationMenuGroup())) {
             // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 
             return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
@@ -87,9 +87,4 @@ public function getActiveGroup(): ?NavigationGroup
             return $item->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
-
-    private function isCurrentPageIndexPage(HydePage $currentPage): bool
-    {
-        return $currentPage->getRoute()->is(DocumentationPage::homeRouteName());
-    }
 }

From f9886f201c6ea4f53fdd9736b9becc1a7de74ece Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:52:28 +0100
Subject: [PATCH 1304/4023] Merge up conditional into null return block

---
 .../Framework/Features/Navigation/DocumentationSidebar.php  | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 8957ba16936..0895c5787f5 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -67,16 +67,12 @@ public function getActiveGroup(): ?NavigationGroup
     {
         // A group is active when it contains the current page being rendered
 
-        if ($this->items->isEmpty() || (! $this->hasGroups()) || (! $this->isCollapsible())) {
+        if ($this->items->isEmpty() || (! $this->hasGroups()) || (! $this->isCollapsible()) || Render::getPage() === null) {
             return null;
         }
 
         $currentPage = Render::getPage();
 
-        if ($currentPage === null) {
-            return null;
-        }
-
         if ($currentPage->getRoute()->is(DocumentationPage::homeRouteName()) && blank($currentPage->navigationMenuGroup())) {
             // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
 

From ddcb510439fefd0c8ea2e494efaafcdacf3a855e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:53:09 +0100
Subject: [PATCH 1305/4023] Shift down code comment

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 0895c5787f5..aca4aef029d 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -65,8 +65,6 @@ public function hasGroups(): bool
      */
     public function getActiveGroup(): ?NavigationGroup
     {
-        // A group is active when it contains the current page being rendered
-
         if ($this->items->isEmpty() || (! $this->hasGroups()) || (! $this->isCollapsible()) || Render::getPage() === null) {
             return null;
         }
@@ -75,11 +73,11 @@ public function getActiveGroup(): ?NavigationGroup
 
         if ($currentPage->getRoute()->is(DocumentationPage::homeRouteName()) && blank($currentPage->navigationMenuGroup())) {
             // Unless the index page has a specific group set, the first group in the sidebar should be open when visiting the index page.
-
             return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
         }
 
         return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
+            // A group is active when it contains the current page being rendered
             return $item->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }

From ec6139beb224166d93b3cb56c668255282e07b7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:53:30 +0100
Subject: [PATCH 1306/4023] Rename loop variable to better match type

---
 .../Framework/Features/Navigation/DocumentationSidebar.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index aca4aef029d..9787e425f57 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -76,9 +76,9 @@ public function getActiveGroup(): ?NavigationGroup
             return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
         }
 
-        return $this->items->first(function (NavigationGroup $item) use ($currentPage): bool {
+        return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
             // A group is active when it contains the current page being rendered
-            return $item->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
+            return $group->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
     }
 }

From 8ef1198d724b44287b0221a2180d47a2bb2f5328 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 19:53:58 +0100
Subject: [PATCH 1307/4023] Remove unused null coalesce to other group

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 9787e425f57..a36ddc4f2eb 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -79,6 +79,6 @@ public function getActiveGroup(): ?NavigationGroup
         return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
             // A group is active when it contains the current page being rendered
             return $group->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
-        }) ?? $this->items->first(fn (NavigationGroup $item): bool => $item->getLabel() === 'Other');
+        });
     }
 }

From 63ca58a14091407a1e005a34231ea649e2d9d148 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 20:01:16 +0100
Subject: [PATCH 1308/4023] Style comment formatting

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index a36ddc4f2eb..5a6e6a380a0 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -77,7 +77,7 @@ public function getActiveGroup(): ?NavigationGroup
         }
 
         return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
-            // A group is active when it contains the current page being rendered
+            // A group is active when it contains the current page being rendered.
             return $group->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
         });
     }

From a2baea5088223bd7781b1357698f8f2cfc892b04 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 23 Mar 2024 20:09:47 +0100
Subject: [PATCH 1309/4023] Type hint against the shared contract

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 5a6e6a380a0..f2a5d485fa6 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -55,7 +55,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
+        return $this->getItems()->contains(fn (NavigationElement $item): bool => $item instanceof NavigationGroup);
     }
 
     /**

From 58be9bbfb2b88a9ae3bace3c71ae85c2bc036c40 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:23:57 +0100
Subject: [PATCH 1310/4023] Deprecate ExternalRoute class

See https://github.com/hydephp/develop/pull/1635
---
 packages/framework/src/Support/Models/ExternalRoute.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index f6ad450b071..f39ce405dae 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -8,6 +8,7 @@
  * A route that leads to an external URI.
  *
  * @experimental Take caution when using this class, as it may be subject to change.
+ * @deprecated This class may be removed before release.
  */
 class ExternalRoute extends Route
 {

From 3bc2b90735ca6e5847bc01b741258c907ee16b4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:24:55 +0100
Subject: [PATCH 1311/4023] Create NavigationDestination.php

---
 .../Features/Navigation/NavigationDestination.php      | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationDestination.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
new file mode 100644
index 00000000000..875e9c7ebb7
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationDestination
+{
+    //
+}

From 9e734e0342abc3eb007134433d11aee17231afc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:25:09 +0100
Subject: [PATCH 1312/4023] Class `NavigationDestination` implements
 `Stringable`

---
 .../Framework/Features/Navigation/NavigationDestination.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index 875e9c7ebb7..87849d69473 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-class NavigationDestination
+use Stringable;
+
+class NavigationDestination implements Stringable
 {
     //
 }

From 50180ce593e751ced7f3100e6166f6441d81de86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:23:57 +0100
Subject: [PATCH 1313/4023] Deprecate ExternalRoute class

See https://github.com/hydephp/develop/pull/1635
---
 packages/framework/src/Support/Models/ExternalRoute.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
index f6ad450b071..721b89a7c13 100644
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ b/packages/framework/src/Support/Models/ExternalRoute.php
@@ -8,6 +8,8 @@
  * A route that leads to an external URI.
  *
  * @experimental Take caution when using this class, as it may be subject to change.
+ *
+ * @deprecated This class may be removed before release.
  */
 class ExternalRoute extends Route
 {

From e2ec80d675497c710ba24fd6cdff0c5459357a19 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:28:00 +0100
Subject: [PATCH 1314/4023] Remove nullable type from route property

I don't think this is used anymore
---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 53df7171678..1bc5001decb 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,7 +23,7 @@
  */
 class NavigationItem implements NavigationElement, Stringable
 {
-    protected ?Route $route;
+    protected Route $route;
     protected string $label;
     protected int $priority;
 

From 9353eef2c4b9f290a024738bae47dbc775f4b004 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 11:29:56 +0100
Subject: [PATCH 1315/4023] Remove nullable destination parameter type

Also no longer needed since decoupling the navigation classes
---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 1bc5001decb..7d67811207a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -33,12 +33,12 @@ class NavigationItem implements NavigationElement, Stringable
     /**
      * Create a new navigation menu item with your own properties.
      *
-     * @param  \Hyde\Support\Models\Route|string|null  $destination  Route instance, route key, or external URI. For dropdowns/groups, this should be null.
+     * @param  \Hyde\Support\Models\Route|string  $destination  Route instance, route key, or external URI.
      * @param  string  $label  The label of the navigation item.
      * @param  int  $priority  The priority to determine the order of the navigation item.
      * @param  string|null  $group  The dropdown/group key of the navigation item, if any.
      */
-    public function __construct(Route|string|null $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
+    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
     {
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);

From 6f482348067dcf487642af97eb4ec5207cbd806a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:33:18 +0100
Subject: [PATCH 1316/4023] Add destination property

---
 .../Framework/Features/Navigation/NavigationDestination.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index 87849d69473..ab873893c8f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -5,8 +5,9 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Stringable;
+use Hyde\Support\Models\Route;
 
 class NavigationDestination implements Stringable
 {
-    //
+    protected Route|string $destination;
 }

From c6f7a595a7ae32362093756d203f9502364b089d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:33:27 +0100
Subject: [PATCH 1317/4023] Add constructor

---
 .../Framework/Features/Navigation/NavigationDestination.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index ab873893c8f..dfc1693712f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -10,4 +10,9 @@
 class NavigationDestination implements Stringable
 {
     protected Route|string $destination;
+
+    public function __construct(Route|string $destination)
+    {
+        $this->destination = $destination;
+    }
 }

From 84861054315805ac8829f69313c06b5d44766f1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:33:40 +0100
Subject: [PATCH 1318/4023] Implement stringable method

---
 .../Framework/Features/Navigation/NavigationDestination.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index dfc1693712f..48cedb49a28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -15,4 +15,9 @@ public function __construct(Route|string $destination)
     {
         $this->destination = $destination;
     }
+
+    public function __toString(): string
+    {
+        return (string) $this->destination;
+    }
 }

From 954ccc78f175bcf43604520252fb2caf2e748272 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:34:49 +0100
Subject: [PATCH 1319/4023] Get route instance for route keys

---
 .../Features/Navigation/NavigationDestination.php          | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index 48cedb49a28..b78a5d04ae1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -6,6 +6,9 @@
 
 use Stringable;
 use Hyde\Support\Models\Route;
+use Hyde\Foundation\Facades\Routes;
+
+use function is_string;
 
 class NavigationDestination implements Stringable
 {
@@ -13,6 +16,10 @@ class NavigationDestination implements Stringable
 
     public function __construct(Route|string $destination)
     {
+        if (is_string($destination) && Routes::has($destination)) {
+            $destination = Routes::get($destination);
+        }
+
         $this->destination = $destination;
     }
 

From 8da04dbbc0df1273bd05ca53d8f532f2950a85d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:35:15 +0100
Subject: [PATCH 1320/4023] Add get link method

---
 .../Framework/Features/Navigation/NavigationDestination.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index b78a5d04ae1..04b7d2f091a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -24,6 +24,11 @@ public function __construct(Route|string $destination)
     }
 
     public function __toString(): string
+    {
+        return $this->getLink();
+    }
+
+    public function getLink(): string
     {
         return (string) $this->destination;
     }

From fff2088833a97a9caeca9f05edf3f112e39df3d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:36:10 +0100
Subject: [PATCH 1321/4023] Deprecate route property

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7d67811207a..8d7a2766640 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,6 +23,7 @@
  */
 class NavigationItem implements NavigationElement, Stringable
 {
+    /** @deprecated */
     protected Route $route;
     protected string $label;
     protected int $priority;

From 74a98f52754b96e09a8be2d48894af0b93edfee6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:36:31 +0100
Subject: [PATCH 1322/4023] Add new destination property

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 8d7a2766640..7e4c1647f79 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -25,6 +25,7 @@ class NavigationItem implements NavigationElement, Stringable
 {
     /** @deprecated */
     protected Route $route;
+    protected NavigationDestination $destination;
     protected string $label;
     protected int $priority;
 

From a56db505bbb0ead19916d37ff27c3c9a723e2ee7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:37:20 +0100
Subject: [PATCH 1323/4023] Construct destination

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7e4c1647f79..339f018a473 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -42,6 +42,8 @@ class NavigationItem implements NavigationElement, Stringable
      */
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
     {
+        $this->destination = new NavigationDestination($destination);
+
         if (is_string($destination)) {
             $destination = Routes::get($destination) ?? new ExternalRoute($destination);
         }

From b28c520afd8074461ea9b06d50fe42d39cf19a73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:41:33 +0100
Subject: [PATCH 1324/4023] Get link using new destination class

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 339f018a473..f2064bf86d0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -104,7 +104,7 @@ public function getRoute(): ?Route
      */
     public function getUrl(): string
     {
-        return (string) $this->route;
+        return $this->destination->getLink();
     }
 
     /**

From e8c1f2f79cbbdc5d8ae3e0808acaa258d21ced3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:44:41 +0100
Subject: [PATCH 1325/4023] Add experimental route getter

---
 .../Framework/Features/Navigation/NavigationDestination.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
index 04b7d2f091a..bcf07e11763 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
@@ -32,4 +32,10 @@ public function getLink(): string
     {
         return (string) $this->destination;
     }
+
+    /** @experimental */
+    public function getRoute(): ?Route
+    {
+        return $this->destination instanceof Route ? $this->destination : null;
+    }
 }

From 5cc2163e2a2ddc6bee55bb20ea7e35d6ed4f48fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:45:00 +0100
Subject: [PATCH 1326/4023] Get route using destination

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f2064bf86d0..b7b2ee9f0aa 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -96,7 +96,7 @@ public function __toString(): string
      */
     public function getRoute(): ?Route
     {
-        return $this->route;
+        return $this->destination->getRoute();
     }
 
     /**

From 6efd8b909212d88e2768a488403e83528e220d7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:48:01 +0100
Subject: [PATCH 1327/4023] Skip tests needing to be reimplemented for
 https://github.com/hydephp/develop/pull/1636

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index b613557ac9b..6daf921bb83 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -68,6 +68,7 @@ public function testPassingRouteKeyToConstructorUsesRouteInstance()
 
     public function testPassingUrlToConstructorUsesExternalRoute()
     {
+        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = new NavigationItem('https://example.com', 'Home');
         $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
         $this->assertEquals(new ExternalRoute('https://example.com'), $item->getRoute());
@@ -76,6 +77,7 @@ public function testPassingUrlToConstructorUsesExternalRoute()
 
     public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
     {
+        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = new NavigationItem('foo', 'Home');
         $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());

From c5203902c6ad55a8ae3e5531894aad1526da37c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:55:14 +0100
Subject: [PATCH 1328/4023] Use null check instead of instanceof on deprecated
 class

---
 .../src/Framework/Features/Navigation/NavigationGroup.php      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index ebd076aa9af..5b9c0ea8896 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -7,7 +7,6 @@
 use Illuminate\Support\Str;
 use Illuminate\Support\Arr;
 use Hyde\Pages\DocumentationPage;
-use Hyde\Support\Models\ExternalRoute;
 
 use function min;
 use function collect;
@@ -79,7 +78,7 @@ protected function addItem(NavigationItem $item): void
     protected function containsOnlyDocumentationPages(): bool
     {
         return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $child): bool {
-            return (! $child->getRoute() instanceof ExternalRoute) && $child->getRoute()->getPage() instanceof DocumentationPage;
+            return ($child->getRoute() !== null) && $child->getRoute()->getPage() instanceof DocumentationPage;
         });
     }
 }

From faea07b04747ed3ec1b616dc6b28f86696030800 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 12:56:59 +0100
Subject: [PATCH 1329/4023] Reimplement tests for changed types

---
 .../framework/tests/Unit/NavigationItemTest.php  | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 6daf921bb83..3cb99793a9c 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -66,22 +66,18 @@ public function testPassingRouteKeyToConstructorUsesRouteInstance()
         $this->assertSame($route, (new NavigationItem('index', 'Home'))->getRoute());
     }
 
-    public function testPassingUrlToConstructorUsesExternalRoute()
+    public function testPassingUrlToConstructorSetsRouteToNull()
     {
-        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = new NavigationItem('https://example.com', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
-        $this->assertEquals(new ExternalRoute('https://example.com'), $item->getRoute());
-        $this->assertSame('https://example.com', (string) $item->getRoute());
+        $this->assertNull($item->getRoute());
+        $this->assertSame('https://example.com', $item->getUrl());
     }
 
-    public function testPassingUnknownRouteKeyToConstructorUsesExternalRoute()
+    public function testPassingUnknownRouteKeyToConstructorSetsRouteToNull()
     {
-        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = new NavigationItem('foo', 'Home');
-        $this->assertInstanceOf(ExternalRoute::class, $item->getRoute());
-        $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
-        $this->assertSame('foo', (string) $item->getRoute());
+        $this->assertNull($item->getRoute());
+        $this->assertSame('foo', $item->getUrl());
     }
 
     public function testGetDestination()

From f5a356736b6fe7152dda673c3cd08fb4bb401ec8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 13:06:03 +0100
Subject: [PATCH 1330/4023] Compare state using destination

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index b7b2ee9f0aa..db5b1526127 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -141,7 +141,7 @@ public function getGroupKey(): ?string
      */
     public function isActive(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->route->getLink();
+        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
     }
 
     /** @return ($group is null ? null : string) */

From 39108997d1d707bc9f948e267795b3a518ce99c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 13:06:59 +0100
Subject: [PATCH 1331/4023] Use accessor with same logic

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index db5b1526127..9d89484bdf9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -141,7 +141,7 @@ public function getGroupKey(): ?string
      */
     public function isActive(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->destination->getLink();
+        return Hyde::currentRoute()->getLink() === $this->getUrl();
     }
 
     /** @return ($group is null ? null : string) */

From cdceed7f81f011f347c8ba079a84a535a59a3b4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 13:07:51 +0100
Subject: [PATCH 1332/4023] Remove deprecated route property

---
 .../src/Framework/Features/Navigation/NavigationItem.php   | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 9d89484bdf9..1cf373a5081 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,8 +23,6 @@
  */
 class NavigationItem implements NavigationElement, Stringable
 {
-    /** @deprecated */
-    protected Route $route;
     protected NavigationDestination $destination;
     protected string $label;
     protected int $priority;
@@ -44,11 +42,6 @@ public function __construct(Route|string $destination, string $label, int $prior
     {
         $this->destination = new NavigationDestination($destination);
 
-        if (is_string($destination)) {
-            $destination = Routes::get($destination) ?? new ExternalRoute($destination);
-        }
-
-        $this->route = $destination;
         $this->label = $label;
         $this->priority = $priority;
 

From d16368c378772d6bb8accabda2f6c7be20f793f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:30:35 +0100
Subject: [PATCH 1333/4023] Deprecate methods we probably don't actually need

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 1cf373a5081..6fec030a9f6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -86,6 +86,8 @@ public function __toString(): string
 
     /**
      * Get the destination route of the navigation item. For dropdowns, this will return null.
+     *
+     * @deprecated To simplify the class, we may remove this as we probably don't need it.
      */
     public function getRoute(): ?Route
     {
@@ -94,6 +96,8 @@ public function getRoute(): ?Route
 
     /**
      * Resolve the destination link of the navigation item.
+     *
+     * @deprecated May be renamed to getLink() in the future.
      */
     public function getUrl(): string
     {

From eb81668e91594e9944a5d72cffb5f7d29246f2f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:31:28 +0100
Subject: [PATCH 1334/4023] Skip tests needing to be reimplemented for #1636

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 3cb99793a9c..002270845b2 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -129,6 +129,7 @@ public function testToString()
 
     public function testCreateWithLink()
     {
+        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = NavigationItem::create('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
@@ -171,6 +172,7 @@ public function testCreateWithRouteKey()
 
     public function testCreateWithMissingRouteKey()
     {
+        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $this->assertInstanceOf(ExternalRoute::class, NavigationItem::create('foo', 'foo')->getRoute());
     }
 

From 798acda5546fd8d09ca9ee25d3b5693fb22915a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:34:58 +0100
Subject: [PATCH 1335/4023] Normalize logic with new destination constructor

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 6fec030a9f6..4615fdbbdf2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -60,8 +60,8 @@ public function __construct(Route|string $destination, string $label, int $prior
      */
     public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): self
     {
-        if (is_string($destination)) {
-            $destination = Routes::get($destination) ?? new ExternalRoute($destination);
+        if (is_string($destination) && Routes::has($destination)) {
+            $destination = Routes::get($destination);
         }
 
         if ($destination instanceof Route && ! $destination instanceof ExternalRoute) {

From 6a64d131765e101171c9ef2a1694ed5f1207eb54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:36:27 +0100
Subject: [PATCH 1336/4023] Remove type check for old class

---
 .../src/Framework/Features/Navigation/NavigationItem.php       | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 4615fdbbdf2..c3fa4d1973d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -9,7 +9,6 @@
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Str;
 use Stringable;
-use Hyde\Support\Models\ExternalRoute;
 
 use function is_string;
 
@@ -64,7 +63,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $destination = Routes::get($destination);
         }
 
-        if ($destination instanceof Route && ! $destination instanceof ExternalRoute) {
+        if ($destination instanceof Route) {
             return new self(
                 $destination,
                 $label ?? $destination->getPage()->navigationMenuLabel(),

From 1eea4dead92bd0c80208eac6b6fe160760e082a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:38:28 +0100
Subject: [PATCH 1337/4023] Update deprecation notice

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index c3fa4d1973d..867684ea5f5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -96,7 +96,7 @@ public function getRoute(): ?Route
     /**
      * Resolve the destination link of the navigation item.
      *
-     * @deprecated May be renamed to getLink() in the future.
+     * @deprecated May be renamed to getLink() in the future to better match its usage, and to match the Route class.
      */
     public function getUrl(): string
     {

From 218590dcc9f41daf390d209f1c299c7e5de3a28d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:42:28 +0100
Subject: [PATCH 1338/4023] Replace dependences on deprecated class with
 inlined strings

We need the kernel and config so we can check if the routes exist
---
 packages/framework/tests/Feature/NavigationMenuTest.php     | 3 +--
 .../framework/tests/Unit/DocumentationSidebarUnitTest.php   | 6 ++++--
 packages/framework/tests/Unit/NavigationMenuUnitTest.php    | 6 ++++--
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index d0ede48df22..a98931a6e41 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationItem;
@@ -268,7 +267,7 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         Hyde::boot();
 
         $navigation = app('navigation.main');
-        $navigation->add(new NavigationItem(new ExternalRoute('/foo'), 'Foo'));
+        $navigation->add(new NavigationItem('/foo', 'Foo'));
 
         $this->assertCount(2, $navigation->getItems());
         $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 9b9c4b7bb6a..4c009f9382d 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -6,7 +6,6 @@
 
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
-use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
@@ -21,6 +20,9 @@
  */
 class DocumentationSidebarUnitTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
     // Base menu tests
 
     public function testCanConstruct()
@@ -228,6 +230,6 @@ protected function getItems(): array
 
     protected function item(string $destination, string $label, int $priority = 500): NavigationItem
     {
-        return new NavigationItem(new ExternalRoute($destination), $label, $priority);
+        return new NavigationItem($destination, $label, $priority);
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuUnitTest.php b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
index e90b159624f..8de2aba9229 100644
--- a/packages/framework/tests/Unit/NavigationMenuUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuUnitTest.php
@@ -6,7 +6,6 @@
 
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
-use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
@@ -19,6 +18,9 @@
  */
 class NavigationMenuUnitTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
     // Base menu tests
 
     public function testCanConstruct()
@@ -159,6 +161,6 @@ protected function getItems(): array
 
     protected function item(string $destination, string $label, int $priority = 500): NavigationItem
     {
-        return new NavigationItem(new ExternalRoute($destination), $label, $priority);
+        return new NavigationItem($destination, $label, $priority);
     }
 }

From 67941949381dd87fea22fbe69131b5a23d17ffbb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:44:43 +0100
Subject: [PATCH 1339/4023] Remove logic added to base of test

---
 packages/framework/tests/Unit/DocumentationSidebarUnitTest.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
index 4c009f9382d..27e1e3826e3 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarUnitTest.php
@@ -209,9 +209,6 @@ public function testHasGroupsReturnsFalseWhenNoItemsHaveChildren()
 
     public function testHasGroupsReturnsTrueWhenAtLeastOneItemIsNavigationGroupInstance()
     {
-        self::mockConfig();
-        self::setupKernel();
-
         $menu = new DocumentationSidebar([
             new NavigationGroup('foo', []),
         ]);

From ba65f1c5d38c9cd786065fb9b424cb181e288b0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:48:30 +0100
Subject: [PATCH 1340/4023] Delete ExternalRoute.php

---
 .../src/Support/Models/ExternalRoute.php      | 28 -------------------
 1 file changed, 28 deletions(-)
 delete mode 100644 packages/framework/src/Support/Models/ExternalRoute.php

diff --git a/packages/framework/src/Support/Models/ExternalRoute.php b/packages/framework/src/Support/Models/ExternalRoute.php
deleted file mode 100644
index 721b89a7c13..00000000000
--- a/packages/framework/src/Support/Models/ExternalRoute.php
+++ /dev/null
@@ -1,28 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Support\Models;
-
-/**
- * A route that leads to an external URI.
- *
- * @experimental Take caution when using this class, as it may be subject to change.
- *
- * @deprecated This class may be removed before release.
- */
-class ExternalRoute extends Route
-{
-    protected string $destination;
-
-    /** @noinspection PhpMissingParentConstructorInspection */
-    public function __construct(string $destination)
-    {
-        $this->destination = $destination;
-    }
-
-    public function getLink(): string
-    {
-        return $this->destination;
-    }
-}

From 72fce42a51c6730a8588dbf0b7d4663e14723c86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:51:13 +0100
Subject: [PATCH 1341/4023] Revert "Skip tests needing to be reimplemented for
 #1636"

This reverts commit eb81668e91594e9944a5d72cffb5f7d29246f2f9.
---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 002270845b2..3cb99793a9c 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -129,7 +129,6 @@ public function testToString()
 
     public function testCreateWithLink()
     {
-        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $item = NavigationItem::create('foo', 'bar');
 
         $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
@@ -172,7 +171,6 @@ public function testCreateWithRouteKey()
 
     public function testCreateWithMissingRouteKey()
     {
-        $this->markTestSkipped('Todo: Reimplement this test for https://github.com/hydephp/develop/pull/1636');
         $this->assertInstanceOf(ExternalRoute::class, NavigationItem::create('foo', 'foo')->getRoute());
     }
 

From cab21b70721c0a3d20c37334ab0252d5aab78c43 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:53:31 +0100
Subject: [PATCH 1342/4023] Reimplement tests for changed types

---
 packages/framework/tests/Unit/NavigationItemTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 3cb99793a9c..a74e1d94d76 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Support\Models\ExternalRoute;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
 use Hyde\Pages\MarkdownPage;
@@ -131,7 +130,8 @@ public function testCreateWithLink()
     {
         $item = NavigationItem::create('foo', 'bar');
 
-        $this->assertEquals(new ExternalRoute('foo'), $item->getRoute());
+        $this->assertNull($item->getRoute());
+        $this->assertSame('foo', $item->getUrl());
         $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
     }
@@ -171,7 +171,7 @@ public function testCreateWithRouteKey()
 
     public function testCreateWithMissingRouteKey()
     {
-        $this->assertInstanceOf(ExternalRoute::class, NavigationItem::create('foo', 'foo')->getRoute());
+        $this->assertNull(NavigationItem::create('foo', 'foo')->getRoute());
     }
 
     public function testCreateWithCustomPriority()

From 0dec761e7ba554dcee8ebff754f31d934a882ced Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:54:01 +0100
Subject: [PATCH 1343/4023] Rename test for removed class

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index a74e1d94d76..209727ea153 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -243,7 +243,7 @@ public function testIsCurrent()
         $this->assertFalse(NavigationItem::create(new Route(new InMemoryPage('bar')))->isActive());
     }
 
-    public function testIsCurrentWithExternalRoute()
+    public function testIsCurrentWithLink()
     {
         Render::swap(Mockery::mock(RenderData::class, [
             'getRoute' => new Route(new InMemoryPage('foo')),

From 976d7ff5dd46fa6d10118ee4c2a1084ee585c6c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:54:12 +0100
Subject: [PATCH 1344/4023] Remove removed new class from release notes

---
 RELEASE_NOTES.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1c7e3aa81e5..3c8def52a9b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,7 +11,6 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
-- Added a new `ExternalRoute` class to represent external routes.
 - Added a new `NavigationItem::getLink()` method contain the previous `NavigationItem::getDestination()` logic, to return the link URL.
 
 ### Changed

From 45332ecf91178c4083eeddf44f75f2ba1df41581 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:57:08 +0100
Subject: [PATCH 1345/4023] Add a new page accessor

---
 .../src/Framework/Features/Navigation/NavigationItem.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 867684ea5f5..ea8febd647a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Pages\Concerns\HydePage;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -83,6 +84,14 @@ public function __toString(): string
         return $this->getUrl();
     }
 
+    /**
+     * If the navigation item is a link to a routed page, get the corresponding page instance.
+     */
+    public function getPage(): ?HydePage
+    {
+        return $this->destination->getRoute()?->getPage();
+    }
+
     /**
      * Get the destination route of the navigation item. For dropdowns, this will return null.
      *

From 2f963c617e0432e957ba780439479989b0274bcc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 15:58:38 +0100
Subject: [PATCH 1346/4023] Simplify search logic to access page directly

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 5b9c0ea8896..937d1647ddd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -78,7 +78,7 @@ protected function addItem(NavigationItem $item): void
     protected function containsOnlyDocumentationPages(): bool
     {
         return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $child): bool {
-            return ($child->getRoute() !== null) && $child->getRoute()->getPage() instanceof DocumentationPage;
+            return $child->getPage() instanceof DocumentationPage;
         });
     }
 }

From 6aa82b7257f2696e5a180fad9a7a771a3a38225c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:03:40 +0100
Subject: [PATCH 1347/4023] Restructure test to improve assertions

And to care less about the route state
---
 .../tests/Unit/NavigationItemTest.php         | 68 +++++++++++++------
 1 file changed, 49 insertions(+), 19 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 209727ea153..b97a192056c 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -41,10 +41,10 @@ protected function setUp(): void
 
     public function testConstruct()
     {
-        $route = new Route(new MarkdownPage());
-        $item = new NavigationItem($route, 'Test', 500);
-
-        $this->assertSame($route, $item->getRoute());
+        $this->assertInstanceOf(NavigationItem::class, new NavigationItem('foo', 'Test'));
+        $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test'));
+        $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500));
+        $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'));
     }
 
     public function testIsInstanceOfNavigationElement()
@@ -55,36 +55,45 @@ public function testIsInstanceOfNavigationElement()
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());
-        $this->assertSame($route, (new NavigationItem($route, 'Home'))->getRoute());
+        $this->assertEquals($route, (new NavigationItem($route, 'Home'))->getPage()->getRoute());
     }
 
     public function testPassingRouteKeyToConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');
-
-        $this->assertSame($route, (new NavigationItem('index', 'Home'))->getRoute());
+        $item = new NavigationItem('index', 'Home');
+        $this->assertNotNull($item->getPage());
+        $this->assertSame($route->getPage(), $item->getPage());
     }
 
     public function testPassingUrlToConstructorSetsRouteToNull()
     {
         $item = new NavigationItem('https://example.com', 'Home');
-        $this->assertNull($item->getRoute());
+        $this->assertNull($item->getPage());
         $this->assertSame('https://example.com', $item->getUrl());
     }
 
     public function testPassingUnknownRouteKeyToConstructorSetsRouteToNull()
     {
         $item = new NavigationItem('foo', 'Home');
-        $this->assertNull($item->getRoute());
+        $this->assertNull($item->getPage());
         $this->assertSame('foo', $item->getUrl());
     }
 
-    public function testGetDestination()
+    public function testCanGetPage()
+    {
+        $page = new MarkdownPage();
+        $item = new NavigationItem(new Route($page), 'Test', 500);
+
+        $this->assertSame($page, $item->getPage());
+    }
+
+    public function testGetPageRoute()
     {
         $route = new Route(new InMemoryPage('foo'));
         $NavigationItem = new NavigationItem($route, 'Page', 500);
 
-        $this->assertSame($route, $NavigationItem->getRoute());
+        $this->assertEquals($route, $NavigationItem->getPage()->getRoute());
     }
 
     public function testGetLink()
@@ -113,10 +122,12 @@ public function testGetGroup()
 
     public function testFromRoute()
     {
-        $route = new Route(new MarkdownPage());
+        $page = new MarkdownPage();
+        $route = new Route($page);
         $item = NavigationItem::create($route);
 
-        $this->assertSame($route, $item->getRoute());
+        $this->assertSame($page, $item->getPage());
+        $this->assertEquals($route, $item->getPage()->getRoute());
     }
 
     public function testToString()
@@ -130,7 +141,7 @@ public function testCreateWithLink()
     {
         $item = NavigationItem::create('foo', 'bar');
 
-        $this->assertNull($item->getRoute());
+        $this->assertNull($item->getPage());
         $this->assertSame('foo', $item->getUrl());
         $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
@@ -146,19 +157,38 @@ public function testCreate()
         $route = Routes::get('404');
         $item = NavigationItem::create($route, 'foo');
 
-        $this->assertSame($route, $item->getRoute());
+        $this->assertSame($route->getPage(), $item->getPage());
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame(999, $item->getPriority());
+        $this->assertEquals($route, $item->getPage()->getRoute());
+        $this->assertSame('404.html', $item->getUrl());
+        $this->assertSame('404.html', (string) $item);
+        $this->assertNull($item->getGroupKey());
     }
 
     public function testForIndexRoute()
     {
         $route = Routes::get('index');
-        $item = NavigationItem::create($route, 'foo');
+        $item = NavigationItem::create($route);
 
-        $this->assertSame($route, $item->getRoute());
-        $this->assertSame('foo', $item->getLabel());
+        $this->assertSame($route->getPage(), $item->getPage());
+        $this->assertSame('Home', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
+        $this->assertEquals($route, $item->getPage()->getRoute());
+        $this->assertSame('index.html', $item->getUrl());
+        $this->assertSame('index.html', (string) $item);
+        $this->assertNull($item->getGroupKey());
+    }
+
+    public function testCreateWithLabels()
+    {
+        $route = Routes::get('404');
+        $item = NavigationItem::create($route, 'foo');
+        $this->assertSame('foo', $item->getLabel());
+
+        $route = Routes::get('index');
+        $item = NavigationItem::create($route);
+        $this->assertSame('Home', $item->getLabel());
     }
 
     public function testCreateWithRouteKey()
@@ -171,7 +201,7 @@ public function testCreateWithRouteKey()
 
     public function testCreateWithMissingRouteKey()
     {
-        $this->assertNull(NavigationItem::create('foo', 'foo')->getRoute());
+        $this->assertNull(NavigationItem::create('foo', 'foo')->getPage());
     }
 
     public function testCreateWithCustomPriority()

From b4011e124fcd9cd7b80d23f2e5aeb7f6631859f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:26:31 +0100
Subject: [PATCH 1348/4023] Use the resolved link instead of implicit route
 resolve

---
 .../resources/views/components/docs/sidebar-item.blade.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index cab03d7c3f3..d57c5d468a5 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -4,7 +4,7 @@
         : 'active bg-black/5 dark:bg-black/10' => $item->isActive()
     ]) role="listitem">
     @if($item->isActive())
-        <a href="{{ $item->getRoute() }}" aria-current="true" @class([$grouped
+        <a href="{{ $item->getUrl() }}" aria-current="true" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
         ])>
@@ -16,7 +16,7 @@
             {!! $page->getTableOfContents() !!}
         @endif
     @else
-        <a href="{{ $item->getRoute() }}" @class([$grouped
+        <a href="{{ $item->getUrl() }}" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block border-l-[0.325rem] border-transparent transition-colors duration-300 ease-in-out hover:bg-black/10'
             : 'block -ml-4 p-2 border-l-[0.325rem] border-transparent hover:bg-black/5 dark:hover:bg-black/10'
         ])>

From 1b94a90fa45f286967a6efa3c8499aaa1f176f7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:30:07 +0100
Subject: [PATCH 1349/4023] Remove `NavigationItem::getRoute` method

Use `$item->getPage()->getRoute()` instead
---
 .../Framework/Features/Navigation/NavigationItem.php   | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ea8febd647a..ff72167d305 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -92,16 +92,6 @@ public function getPage(): ?HydePage
         return $this->destination->getRoute()?->getPage();
     }
 
-    /**
-     * Get the destination route of the navigation item. For dropdowns, this will return null.
-     *
-     * @deprecated To simplify the class, we may remove this as we probably don't need it.
-     */
-    public function getRoute(): ?Route
-    {
-        return $this->destination->getRoute();
-    }
-
     /**
      * Resolve the destination link of the navigation item.
      *

From 37c51c2f0f47a1e14d41a66631bad27ad0ae236e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:37:21 +0100
Subject: [PATCH 1350/4023] Rename `NavigationItem` method `getUrl` to
 `getLink`

---
 .../views/components/docs/sidebar-item.blade.php     |  4 ++--
 .../Framework/Features/Navigation/NavigationItem.php |  8 +++-----
 packages/framework/tests/Unit/NavigationItemTest.php | 12 ++++++------
 3 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index d57c5d468a5..c22f14182e8 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -4,7 +4,7 @@
         : 'active bg-black/5 dark:bg-black/10' => $item->isActive()
     ]) role="listitem">
     @if($item->isActive())
-        <a href="{{ $item->getUrl() }}" aria-current="true" @class([$grouped
+        <a href="{{ $item->getLink() }}" aria-current="true" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out hover:bg-black/10'
             : '-ml-4 p-2 block hover:bg-black/5 dark:hover:bg-black/10 text-indigo-600 dark:text-indigo-400 dark:font-medium border-l-[0.325rem] border-indigo-500 transition-colors duration-300 ease-in-out'
         ])>
@@ -16,7 +16,7 @@
             {!! $page->getTableOfContents() !!}
         @endif
     @else
-        <a href="{{ $item->getUrl() }}" @class([$grouped
+        <a href="{{ $item->getLink() }}" @class([$grouped
             ? '-ml-8 pl-4 py-1 px-2 block border-l-[0.325rem] border-transparent transition-colors duration-300 ease-in-out hover:bg-black/10'
             : 'block -ml-4 p-2 border-l-[0.325rem] border-transparent hover:bg-black/5 dark:hover:bg-black/10'
         ])>
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ff72167d305..5e6b12da234 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -81,7 +81,7 @@ public static function create(Route|string $destination, ?string $label = null,
      */
     public function __toString(): string
     {
-        return $this->getUrl();
+        return $this->getLink();
     }
 
     /**
@@ -94,10 +94,8 @@ public function getPage(): ?HydePage
 
     /**
      * Resolve the destination link of the navigation item.
-     *
-     * @deprecated May be renamed to getLink() in the future to better match its usage, and to match the Route class.
      */
-    public function getUrl(): string
+    public function getLink(): string
     {
         return $this->destination->getLink();
     }
@@ -136,7 +134,7 @@ public function getGroupKey(): ?string
      */
     public function isActive(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->getUrl();
+        return Hyde::currentRoute()->getLink() === $this->getLink();
     }
 
     /** @return ($group is null ? null : string) */
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index b97a192056c..10a76006f56 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -70,14 +70,14 @@ public function testPassingUrlToConstructorSetsRouteToNull()
     {
         $item = new NavigationItem('https://example.com', 'Home');
         $this->assertNull($item->getPage());
-        $this->assertSame('https://example.com', $item->getUrl());
+        $this->assertSame('https://example.com', $item->getLink());
     }
 
     public function testPassingUnknownRouteKeyToConstructorSetsRouteToNull()
     {
         $item = new NavigationItem('foo', 'Home');
         $this->assertNull($item->getPage());
-        $this->assertSame('foo', $item->getUrl());
+        $this->assertSame('foo', $item->getLink());
     }
 
     public function testCanGetPage()
@@ -99,7 +99,7 @@ public function testGetPageRoute()
     public function testGetLink()
     {
         $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertSame('foo.html', $NavigationItem->getUrl());
+        $this->assertSame('foo.html', $NavigationItem->getLink());
     }
 
     public function testGetLabel()
@@ -142,7 +142,7 @@ public function testCreateWithLink()
         $item = NavigationItem::create('foo', 'bar');
 
         $this->assertNull($item->getPage());
-        $this->assertSame('foo', $item->getUrl());
+        $this->assertSame('foo', $item->getLink());
         $this->assertSame('bar', $item->getLabel());
         $this->assertSame(500, $item->getPriority());
     }
@@ -161,7 +161,7 @@ public function testCreate()
         $this->assertSame('foo', $item->getLabel());
         $this->assertSame(999, $item->getPriority());
         $this->assertEquals($route, $item->getPage()->getRoute());
-        $this->assertSame('404.html', $item->getUrl());
+        $this->assertSame('404.html', $item->getLink());
         $this->assertSame('404.html', (string) $item);
         $this->assertNull($item->getGroupKey());
     }
@@ -175,7 +175,7 @@ public function testForIndexRoute()
         $this->assertSame('Home', $item->getLabel());
         $this->assertSame(0, $item->getPriority());
         $this->assertEquals($route, $item->getPage()->getRoute());
-        $this->assertSame('index.html', $item->getUrl());
+        $this->assertSame('index.html', $item->getLink());
         $this->assertSame('index.html', (string) $item);
         $this->assertNull($item->getGroupKey());
     }

From 53a8b08e03e987d6681b28b56535c03c3804ac9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:40:46 +0100
Subject: [PATCH 1351/4023] Add type annotation

---
 .../resources/views/components/docs/sidebar-item.blade.php       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index c22f14182e8..fe320513408 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -1,4 +1,5 @@
 @props(['grouped' => false])
+@php /** @var \Hyde\Framework\Features\Navigation\NavigationItem $item */ @endphp
 <li @class(['sidebar-item -ml-4 pl-4', $grouped
         ? 'active -ml-8 pl-8 bg-black/5 dark:bg-black/10'
         : 'active bg-black/5 dark:bg-black/10' => $item->isActive()

From 1b8cd1bbd008da76befbfe83c2fc4ac20ca24d73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 16:53:46 +0100
Subject: [PATCH 1352/4023] Unwrap unnecessary null check

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 5e6b12da234..00e1c2bba4c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -45,9 +45,7 @@ public function __construct(Route|string $destination, string $label, int $prior
         $this->label = $label;
         $this->priority = $priority;
 
-        if ($group !== null) {
-            $this->group = static::normalizeGroupKey($group);
-        }
+        $this->group = static::normalizeGroupKey($group);
     }
 
     /**

From d3b2044b087b41335a3191fa4834dbb0d73077f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:00:54 +0100
Subject: [PATCH 1353/4023] Inline the navigation destination class

Turns out we really didn't need this. It does add one test for the new side effect of constructor now being less magic (desirable as it's the scope of the create method)
---
 .../Navigation/NavigationDestination.php      | 41 -------------------
 .../Features/Navigation/NavigationItem.php    |  8 ++--
 .../tests/Unit/NavigationItemTest.php         | 15 +++++--
 3 files changed, 15 insertions(+), 49 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationDestination.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php b/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
deleted file mode 100644
index bcf07e11763..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/NavigationDestination.php
+++ /dev/null
@@ -1,41 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-use Stringable;
-use Hyde\Support\Models\Route;
-use Hyde\Foundation\Facades\Routes;
-
-use function is_string;
-
-class NavigationDestination implements Stringable
-{
-    protected Route|string $destination;
-
-    public function __construct(Route|string $destination)
-    {
-        if (is_string($destination) && Routes::has($destination)) {
-            $destination = Routes::get($destination);
-        }
-
-        $this->destination = $destination;
-    }
-
-    public function __toString(): string
-    {
-        return $this->getLink();
-    }
-
-    public function getLink(): string
-    {
-        return (string) $this->destination;
-    }
-
-    /** @experimental */
-    public function getRoute(): ?Route
-    {
-        return $this->destination instanceof Route ? $this->destination : null;
-    }
-}
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 00e1c2bba4c..6c8d73ad3f5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,7 +23,7 @@
  */
 class NavigationItem implements NavigationElement, Stringable
 {
-    protected NavigationDestination $destination;
+    protected string|Route $destination;
     protected string $label;
     protected int $priority;
 
@@ -40,7 +40,7 @@ class NavigationItem implements NavigationElement, Stringable
      */
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
     {
-        $this->destination = new NavigationDestination($destination);
+        $this->destination = $destination;
 
         $this->label = $label;
         $this->priority = $priority;
@@ -87,7 +87,7 @@ public function __toString(): string
      */
     public function getPage(): ?HydePage
     {
-        return $this->destination->getRoute()?->getPage();
+        return $this->destination instanceof Route ? $this->destination->getPage() : null;
     }
 
     /**
@@ -95,7 +95,7 @@ public function getPage(): ?HydePage
      */
     public function getLink(): string
     {
-        return $this->destination->getLink();
+        return (string) $this->destination;
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 10a76006f56..f003b3400b0 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -58,12 +58,11 @@ public function testPassingRouteInstanceToConstructorUsesRouteInstance()
         $this->assertEquals($route, (new NavigationItem($route, 'Home'))->getPage()->getRoute());
     }
 
-    public function testPassingRouteKeyToConstructorUsesRouteInstance()
+    public function testPassingRouteKeyToConstructorUsesDestinationAsLink()
     {
-        $route = Routes::get('index');
         $item = new NavigationItem('index', 'Home');
-        $this->assertNotNull($item->getPage());
-        $this->assertSame($route->getPage(), $item->getPage());
+        $this->assertNull($item->getPage());
+        $this->assertSame('index', $item->getLink());
     }
 
     public function testPassingUrlToConstructorSetsRouteToNull()
@@ -209,6 +208,14 @@ public function testCreateWithCustomPriority()
         $this->assertSame(100, NavigationItem::create(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
+    public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()
+    {
+        $route = Routes::get('index');
+        $item = NavigationItem::create('index', 'Home');
+        $this->assertNotNull($item->getPage());
+        $this->assertSame($route->getPage(), $item->getPage());
+    }
+
     public function testRouteBasedNavigationItemDestinationsAreResolvedRelatively()
     {
         Render::swap(Mockery::mock(RenderData::class, [

From 1ed674b7f55c77b5d4591ab1f0a094688c566f96 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:02:58 +0100
Subject: [PATCH 1354/4023] Reorder methods in class

---
 .../Features/Navigation/NavigationItem.php       | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 6c8d73ad3f5..c0d65bd58df 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -82,14 +82,6 @@ public function __toString(): string
         return $this->getLink();
     }
 
-    /**
-     * If the navigation item is a link to a routed page, get the corresponding page instance.
-     */
-    public function getPage(): ?HydePage
-    {
-        return $this->destination instanceof Route ? $this->destination->getPage() : null;
-    }
-
     /**
      * Resolve the destination link of the navigation item.
      */
@@ -127,6 +119,14 @@ public function getGroupKey(): ?string
         return $this->group;
     }
 
+    /**
+     * If the navigation item is a link to a routed page, get the corresponding page instance.
+     */
+    public function getPage(): ?HydePage
+    {
+        return $this->destination instanceof Route ? $this->destination->getPage() : null;
+    }
+
     /**
      * Check if the NavigationItem instance is the current page being rendered.
      */

From 4ea66c6d938952aeefd262b1b247e07bd93b4007 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:04:35 +0100
Subject: [PATCH 1355/4023] Replace early construct call with property coalesce
 assignments

---
 .../src/Framework/Features/Navigation/NavigationItem.php | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index c0d65bd58df..099e539cd48 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -63,12 +63,9 @@ public static function create(Route|string $destination, ?string $label = null,
         }
 
         if ($destination instanceof Route) {
-            return new self(
-                $destination,
-                $label ?? $destination->getPage()->navigationMenuLabel(),
-                $priority ?? $destination->getPage()->navigationMenuPriority(),
-                $group ?? $destination->getPage()->navigationMenuGroup(),
-            );
+            $label ??= $destination->getPage()->navigationMenuLabel();
+            $priority ??= $destination->getPage()->navigationMenuPriority();
+            $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
         return new self($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);

From 3e4901bee4d4f1313bea62170e52bbb55c91a45d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:05:18 +0100
Subject: [PATCH 1356/4023] Return new static instead of self

Now longer needed as we decoupled the navigation group class
---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 099e539cd48..0649c7e44e9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -56,7 +56,7 @@ public function __construct(Route|string $destination, string $label, int $prior
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.
      */
-    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): self
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): static
     {
         if (is_string($destination) && Routes::has($destination)) {
             $destination = Routes::get($destination);
@@ -68,7 +68,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
-        return new self($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
+        return new static($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**

From 4909d15d8fa73d57589630d64c58e2cfdef373d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:12:53 +0100
Subject: [PATCH 1357/4023] Test create with null label

---
 packages/framework/tests/Unit/NavigationItemTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index f003b3400b0..6857189254f 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -208,6 +208,11 @@ public function testCreateWithCustomPriority()
         $this->assertSame(100, NavigationItem::create(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
+    public function testCreateWithNullLabel()
+    {
+        $this->assertSame('', NavigationItem::create('foo')->getLabel());
+    }
+
     public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');

From 41db3d1c7772439de56abf46449463e71c6591a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:29:16 +0100
Subject: [PATCH 1358/4023] Test create with null label for route

---
 packages/framework/tests/Unit/NavigationItemTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 6857189254f..fe66e9c57d4 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -208,6 +208,11 @@ public function testCreateWithCustomPriority()
         $this->assertSame(100, NavigationItem::create(Routes::get('index'), 'foo', 100)->getPriority());
     }
 
+    public function testCreateWithNullLabelForRoute()
+    {
+        $this->assertSame('Home', NavigationItem::create('index')->getLabel());
+    }
+
     public function testCreateWithNullLabel()
     {
         $this->assertSame('', NavigationItem::create('foo')->getLabel());

From 0c0a87c95098f3e6fd97813bf49e10097338dfbd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:37:37 +0100
Subject: [PATCH 1359/4023] Update label to fall back to the supplied link

---
 .../Features/Navigation/NavigationItem.php      |  2 +-
 .../framework/tests/Unit/NavigationItemTest.php | 17 ++++++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 0649c7e44e9..22ac69f8e28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -68,7 +68,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
-        return new static($destination, $label ?? '', $priority ?? NavigationMenu::DEFAULT, $group);
+        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index fe66e9c57d4..a92b27e25d5 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -215,7 +215,22 @@ public function testCreateWithNullLabelForRoute()
 
     public function testCreateWithNullLabel()
     {
-        $this->assertSame('', NavigationItem::create('foo')->getLabel());
+        $this->assertSame('foo', NavigationItem::create('foo')->getLabel());
+
+        $links = [
+            'www.example.com',
+            'https://example.com',
+            'https://example.com/',
+            'https://example.com/foo',
+            'https://example.com/foo/',
+            'https://example.com/foo/bar',
+            'https://example.com/foo/bar.html',
+            'https://example.com/foo/bar.png',
+        ];
+
+        foreach ($links as $link) {
+            $this->assertSame($link, NavigationItem::create($link)->getLink());
+        }
     }
 
     public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()

From 180e0dfadec01d844eeba0f4d22340257145cc9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:46:30 +0100
Subject: [PATCH 1360/4023] Fix method being asserted

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index a92b27e25d5..4b7fa9cff2a 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -229,7 +229,7 @@ public function testCreateWithNullLabel()
         ];
 
         foreach ($links as $link) {
-            $this->assertSame($link, NavigationItem::create($link)->getLink());
+            $this->assertSame($link, NavigationItem::create($link)->getLabel());
         }
     }
 

From 99ef0ed92c2c3b3dfbdcfcf678fe30108e447108 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:46:43 +0100
Subject: [PATCH 1361/4023] Extract helper method

---
 .../src/Framework/Features/Navigation/NavigationItem.php   | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 22ac69f8e28..ac93f435a14 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -68,7 +68,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
-        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT, $group);
+        return new static($destination, $label ?? static::makeTitleFromUrl($destination), $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**
@@ -137,4 +137,9 @@ public static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
+
+    protected static function makeTitleFromUrl(string $url): string
+    {
+        return $url;
+    }
 }

From ea50e0f38245ac9ce553cc5851f5cdcc6e85bc2f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:50:49 +0100
Subject: [PATCH 1362/4023] Dynamically generate titles from input links

---
 .../Features/Navigation/NavigationItem.php    |  7 ++-
 .../tests/Unit/NavigationItemTest.php         | 48 +++++++++++++------
 2 files changed, 39 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ac93f435a14..ed4132e3bc6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -138,8 +138,13 @@ public static function normalizeGroupKey(?string $group): ?string
         return $group ? Str::slug($group) : null;
     }
 
+    /** @experimental This feature may be removed before release, and the label will just fall back to the input $url */
     protected static function makeTitleFromUrl(string $url): string
     {
-        return $url;
+        $basename = basename($url);
+        $basename = Str::replaceFirst('www.', '', $basename);
+        $basename = Str::replaceLast('.html', '', $basename);
+
+        return Hyde::makeTitle($basename);
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 4b7fa9cff2a..cee578da044 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -215,22 +215,40 @@ public function testCreateWithNullLabelForRoute()
 
     public function testCreateWithNullLabel()
     {
-        $this->assertSame('foo', NavigationItem::create('foo')->getLabel());
-
-        $links = [
-            'www.example.com',
-            'https://example.com',
-            'https://example.com/',
-            'https://example.com/foo',
-            'https://example.com/foo/',
-            'https://example.com/foo/bar',
-            'https://example.com/foo/bar.html',
-            'https://example.com/foo/bar.png',
-        ];
+        $this->assertSame('Foo', NavigationItem::create('foo')->getLabel());
+    }
+
+    public function testCreateWithNullLabelForLinks()
+    {
+        $this->assertSame('Example.com', NavigationItem::create('example.com')->getLabel());
+        $this->assertSame('Example.com', NavigationItem::create('example.com/')->getLabel());
+        $this->assertSame('Example.com', NavigationItem::create('https://example.com/')->getLabel());
+    }
+
+    public function testCreateWithNullLabelForLinksWithSubdomain()
+    {
+        $this->assertSame('Example.com', NavigationItem::create('www.example.com')->getLabel());
+        $this->assertSame('Example.com', NavigationItem::create('www.example.com/')->getLabel());
+        $this->assertSame('Example.com', NavigationItem::create('https://www.example.com')->getLabel());
+        $this->assertSame('Example.com', NavigationItem::create('https://www.example.com/')->getLabel());
+    }
 
-        foreach ($links as $link) {
-            $this->assertSame($link, NavigationItem::create($link)->getLabel());
-        }
+    public function testCreateWithNullLabelForLinksWithPages()
+    {
+        $this->assertSame('Foo', NavigationItem::create('https://example.com/foo')->getLabel());
+        $this->assertSame('Foo', NavigationItem::create('https://example.com/foo/')->getLabel());
+        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar')->getLabel());
+        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar/')->getLabel());
+    }
+
+    public function testCreateWithNullLabelForLinkWithPageWithHtmlExtension()
+    {
+        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar.html')->getLabel());
+    }
+
+    public function testCreateWithNullLabelForLinkWithPageWithOtherExtension()
+    {
+        $this->assertSame('Bar.png', NavigationItem::create('https://example.com/foo/bar.png')->getLabel());
     }
 
     public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()

From 8f2bd586a87f3e29a2c24978d53996b50d7655bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:51:37 +0100
Subject: [PATCH 1363/4023] Revert "Dynamically generate titles from input
 links"

This reverts commit ea50e0f38245ac9ce553cc5851f5cdcc6e85bc2f. See https://github.com/hydephp/develop/pull/1638/files#r1536861523

Revert "Extract helper method"

This reverts commit 99ef0ed92c2c3b3dfbdcfcf678fe30108e447108.
---
 .../Features/Navigation/NavigationItem.php    | 12 +----
 .../tests/Unit/NavigationItemTest.php         | 48 ++++++-------------
 2 files changed, 16 insertions(+), 44 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index ed4132e3bc6..22ac69f8e28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -68,7 +68,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
-        return new static($destination, $label ?? static::makeTitleFromUrl($destination), $priority ?? NavigationMenu::DEFAULT, $group);
+        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT, $group);
     }
 
     /**
@@ -137,14 +137,4 @@ public static function normalizeGroupKey(?string $group): ?string
     {
         return $group ? Str::slug($group) : null;
     }
-
-    /** @experimental This feature may be removed before release, and the label will just fall back to the input $url */
-    protected static function makeTitleFromUrl(string $url): string
-    {
-        $basename = basename($url);
-        $basename = Str::replaceFirst('www.', '', $basename);
-        $basename = Str::replaceLast('.html', '', $basename);
-
-        return Hyde::makeTitle($basename);
-    }
 }
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index cee578da044..4b7fa9cff2a 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -215,40 +215,22 @@ public function testCreateWithNullLabelForRoute()
 
     public function testCreateWithNullLabel()
     {
-        $this->assertSame('Foo', NavigationItem::create('foo')->getLabel());
-    }
-
-    public function testCreateWithNullLabelForLinks()
-    {
-        $this->assertSame('Example.com', NavigationItem::create('example.com')->getLabel());
-        $this->assertSame('Example.com', NavigationItem::create('example.com/')->getLabel());
-        $this->assertSame('Example.com', NavigationItem::create('https://example.com/')->getLabel());
-    }
-
-    public function testCreateWithNullLabelForLinksWithSubdomain()
-    {
-        $this->assertSame('Example.com', NavigationItem::create('www.example.com')->getLabel());
-        $this->assertSame('Example.com', NavigationItem::create('www.example.com/')->getLabel());
-        $this->assertSame('Example.com', NavigationItem::create('https://www.example.com')->getLabel());
-        $this->assertSame('Example.com', NavigationItem::create('https://www.example.com/')->getLabel());
-    }
-
-    public function testCreateWithNullLabelForLinksWithPages()
-    {
-        $this->assertSame('Foo', NavigationItem::create('https://example.com/foo')->getLabel());
-        $this->assertSame('Foo', NavigationItem::create('https://example.com/foo/')->getLabel());
-        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar')->getLabel());
-        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar/')->getLabel());
-    }
-
-    public function testCreateWithNullLabelForLinkWithPageWithHtmlExtension()
-    {
-        $this->assertSame('Bar', NavigationItem::create('https://example.com/foo/bar.html')->getLabel());
-    }
+        $this->assertSame('foo', NavigationItem::create('foo')->getLabel());
+
+        $links = [
+            'www.example.com',
+            'https://example.com',
+            'https://example.com/',
+            'https://example.com/foo',
+            'https://example.com/foo/',
+            'https://example.com/foo/bar',
+            'https://example.com/foo/bar.html',
+            'https://example.com/foo/bar.png',
+        ];
 
-    public function testCreateWithNullLabelForLinkWithPageWithOtherExtension()
-    {
-        $this->assertSame('Bar.png', NavigationItem::create('https://example.com/foo/bar.png')->getLabel());
+        foreach ($links as $link) {
+            $this->assertSame($link, NavigationItem::create($link)->getLabel());
+        }
     }
 
     public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()

From 71c068ce5419a50393782d21e08f1565c8463537 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:56:39 +0100
Subject: [PATCH 1364/4023] Update todo abstract

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 22ac69f8e28..f56f370b831 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -27,7 +27,7 @@ class NavigationItem implements NavigationElement, Stringable
     protected string $label;
     protected int $priority;
 
-    // TODO: Do we actually need this? We should just care if it's physically stored in a group.
+    // TODO: Do we actually need this? We should just care if it's physically stored in a group. Adding the group key here doesn't magically make it appear in the group, it needs to be added to the group's items array, so why should we care about the key here?
     protected ?string $group = null;
 
     /**

From cd791af70839ef6bbfdee1c347dd43e356319765 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:57:03 +0100
Subject: [PATCH 1365/4023] Convert todo into deprecation

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f56f370b831..345576b38b3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -27,7 +27,7 @@ class NavigationItem implements NavigationElement, Stringable
     protected string $label;
     protected int $priority;
 
-    // TODO: Do we actually need this? We should just care if it's physically stored in a group. Adding the group key here doesn't magically make it appear in the group, it needs to be added to the group's items array, so why should we care about the key here?
+    /** @deprecated Do we actually need this? We should just care if it's physically stored in a group. Adding the group key here doesn't magically make it appear in the group, it needs to be added to the group's items array, so why should we care about the key here? */
     protected ?string $group = null;
 
     /**

From f45eb19814c9b6f972dbad01344104f7ddf4b279 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 17:58:10 +0100
Subject: [PATCH 1366/4023] Deprecate accessor for deprecated property

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 345576b38b3..694db93176d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -106,6 +106,8 @@ public function getPriority(): int
     /**
      * Get the group identifier key of the navigation item, if any.
      *
+     * @deprecated as the property is deprecated.
+     *
      *  For sidebars this is the category key, for navigation menus this is the dropdown key.
      *
      *  When using automatic subdirectory based groups, the subdirectory name is the group key.

From 48d945d6fd1a2674eab7826a86482a5d621ac858 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:01:00 +0100
Subject: [PATCH 1367/4023] Deprecate the group paramters

---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 694db93176d..764a758a62f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Pages\Concerns\HydePage;
+use JetBrains\PhpStorm\Deprecated;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -38,7 +39,7 @@ class NavigationItem implements NavigationElement, Stringable
      * @param  int  $priority  The priority to determine the order of the navigation item.
      * @param  string|null  $group  The dropdown/group key of the navigation item, if any.
      */
-    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, ?string $group = null)
+    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, #[Deprecated] ?string $group = null)
     {
         $this->destination = $destination;
 
@@ -56,7 +57,7 @@ public function __construct(Route|string $destination, string $label, int $prior
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.
      */
-    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, ?string $group = null): static
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, #[Deprecated] ?string $group = null): static
     {
         if (is_string($destination) && Routes::has($destination)) {
             $destination = Routes::get($destination);

From 51f562023bd8239b68cb4814b267a2c259622c47 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:06:03 +0100
Subject: [PATCH 1368/4023] Remove tests for deprecated group accessor

May be radical at this point, but I want to remove usages so I can see better how this is used
---
 .../AutomaticNavigationConfigurationsTest.php |  8 ++---
 .../tests/Unit/NavigationGroupTest.php        | 20 -----------
 .../tests/Unit/NavigationItemTest.php         | 34 -------------------
 3 files changed, 3 insertions(+), 59 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 4277e67ef84..0f5404ee4ef 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1284,21 +1284,19 @@ protected function sidebar(?array $withPages = null): AssertableNavigationMenu
 class TestNavigationItem
 {
     public readonly string $label;
-    public readonly ?string $group;
     public readonly int $priority;
     public readonly array $children;
 
-    public function __construct(string $label, ?string $group, int $priority, array $children)
+    public function __construct(string $label, int $priority, array $children)
     {
         $this->label = $label;
-        $this->group = $group;
         $this->priority = $priority;
         $this->children = collect($children)->map(fn (NavigationItem|NavigationGroup $child) => $child->getLabel())->toArray();
     }
 
     public static function properties(): array
     {
-        return ['label', 'group', 'priority', 'children'];
+        return ['label', 'priority', 'children'];
     }
 }
 
@@ -1320,7 +1318,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem|NavigationGroup $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getGroupKey(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 9b51ed0c122..2baaf30d2fc 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -114,26 +114,6 @@ public function testAddChildrenMethodReturnsSelf()
         $this->assertSame($group, $group->add([]));
     }
 
-    public function testAddingAnItemWithAGroupKeyKeepsTheSetGroupKey()
-    {
-        $group = new NavigationGroup('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Child', group: 'bar');
-
-        $group->add($child);
-
-        $this->assertSame('bar', $child->getGroupKey());
-    }
-
-    public function testAddingAnItemWithNoGroupKeyDoesNotModifyGroupIdentifier()
-    {
-        $group = new NavigationGroup('Foo');
-        $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
-
-        $group->add($child);
-
-        $this->assertNull($child->getGroupKey());
-    }
-
     public function testGetPriorityUsesDefaultPriority()
     {
         $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 4b7fa9cff2a..bb35faac14a 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -113,12 +113,6 @@ public function testGetPriority()
         $this->assertSame(500, $NavigationItem->getPriority());
     }
 
-    public function testGetGroup()
-    {
-        $NavigationItem = new NavigationItem(new Route(new InMemoryPage('foo')), 'Page', 500);
-        $this->assertNull($NavigationItem->getGroupKey());
-    }
-
     public function testFromRoute()
     {
         $page = new MarkdownPage();
@@ -162,7 +156,6 @@ public function testCreate()
         $this->assertEquals($route, $item->getPage()->getRoute());
         $this->assertSame('404.html', $item->getLink());
         $this->assertSame('404.html', (string) $item);
-        $this->assertNull($item->getGroupKey());
     }
 
     public function testForIndexRoute()
@@ -176,7 +169,6 @@ public function testForIndexRoute()
         $this->assertEquals($route, $item->getPage()->getRoute());
         $this->assertSame('index.html', $item->getLink());
         $this->assertSame('index.html', (string) $item);
-        $this->assertNull($item->getGroupKey());
     }
 
     public function testCreateWithLabels()
@@ -315,32 +307,6 @@ public function testIsCurrentWithLink()
         $this->assertFalse(NavigationItem::create('https://example.com', 'bar')->isActive());
     }
 
-    public function testGetGroupWithNoGroup()
-    {
-        $this->assertNull((new NavigationItem(new Route(new MarkdownPage()), 'Test', 500))->getGroupKey());
-    }
-
-    public function testGetGroupWithGroup()
-    {
-        $this->assertSame('foo', (new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'))->getGroupKey());
-    }
-
-    public function testGetGroupFromRouteWithGroup()
-    {
-        $this->assertSame('foo', NavigationItem::create(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])))->getGroupKey());
-    }
-
-    public function testGetGroupCreateWithGroup()
-    {
-        $this->assertSame('foo', NavigationItem::create(new Route(new MarkdownPage(matter: ['navigation.group' => 'foo'])), 'foo')->getGroupKey());
-    }
-
-    public function testGroupKeysAreNormalized()
-    {
-        $item = new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'Foo Bar');
-        $this->assertSame('foo-bar', $item->getGroupKey());
-    }
-
     public function testNormalizeGroupKeyCreatesSlugs()
     {
         $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('Foo Bar'));

From 9a893d11b798ca91f2ee568cca80b2500e8c07af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:13:14 +0100
Subject: [PATCH 1369/4023] Replace ternary expression with if/else block

---
 .../Features/Navigation/NavigationMenuGenerator.php         | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 0c2b05cb223..deb58efc204 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -135,7 +135,11 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavigationItem::create($route);
 
-        $groupName = $this->generatesSidebar ? ($item->getGroupKey() ?? 'Other') : $item->getGroupKey();
+        if ($this->generatesSidebar) {
+            $groupName = ($item->getGroupKey() ?? 'Other');
+        } else {
+            $groupName = $item->getGroupKey();
+        }
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 

From 769744fea76e0690cabe87f98dc2ba6ace3aebf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:14:15 +0100
Subject: [PATCH 1370/4023] Introduce local variable

---
 .../Features/Navigation/NavigationMenuGenerator.php          | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index deb58efc204..1f8d17d549a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -135,10 +135,11 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavigationItem::create($route);
 
+        $groupKey = $item->getGroupKey();
         if ($this->generatesSidebar) {
-            $groupName = ($item->getGroupKey() ?? 'Other');
+            $groupName = ($groupKey ?? 'Other');
         } else {
-            $groupName = $item->getGroupKey();
+            $groupName = $groupKey;
         }
 
         $groupItem = $this->getOrCreateGroupItem($groupName);

From 2fafd0f7f419dc904edd293e1fe349c20eea24ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:16:51 +0100
Subject: [PATCH 1371/4023] Get group key through page instance

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 1f8d17d549a..7790152efc2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -135,7 +135,7 @@ protected function addRouteToGroup(Route $route): void
     {
         $item = NavigationItem::create($route);
 
-        $groupKey = $item->getGroupKey();
+        $groupKey = $item->getPage()->navigationMenuGroup();
         if ($this->generatesSidebar) {
             $groupName = ($groupKey ?? 'Other');
         } else {

From ba03fb8573ca3b5339365af05cc3ee8eeaa3fe0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:24:04 +0100
Subject: [PATCH 1372/4023] Replace conditional with ternary expression

---
 .../Features/Navigation/NavigationMenuGenerator.php         | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 7790152efc2..c0942e77bfa 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -136,11 +136,7 @@ protected function addRouteToGroup(Route $route): void
         $item = NavigationItem::create($route);
 
         $groupKey = $item->getPage()->navigationMenuGroup();
-        if ($this->generatesSidebar) {
-            $groupName = ($groupKey ?? 'Other');
-        } else {
-            $groupName = $groupKey;
-        }
+        $groupName = $this->generatesSidebar ? $groupKey ?? 'Other' : $groupKey;
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 

From 252764819fd6ee759ca8acad63072276936fa6aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:24:31 +0100
Subject: [PATCH 1373/4023] Add clarifying parentheses

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index c0942e77bfa..2d79194d299 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -136,7 +136,7 @@ protected function addRouteToGroup(Route $route): void
         $item = NavigationItem::create($route);
 
         $groupKey = $item->getPage()->navigationMenuGroup();
-        $groupName = $this->generatesSidebar ? $groupKey ?? 'Other' : $groupKey;
+        $groupName = $this->generatesSidebar ? ($groupKey ?? 'Other') : $groupKey;
 
         $groupItem = $this->getOrCreateGroupItem($groupName);
 

From 0eda65fe12c676fd405a9fe1dd8ba187ead848ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:26:09 +0100
Subject: [PATCH 1374/4023] Use helper method with essentially the same
 semantics

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 2d79194d299..d43c0638185 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Illuminate\Support\Str;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
@@ -149,7 +148,7 @@ protected function addRouteToGroup(Route $route): void
 
     protected function getOrCreateGroupItem(string $groupName): NavigationGroup
     {
-        $groupKey = Str::slug($groupName);
+        $groupKey = NavigationItem::normalizeGroupKey($groupName);
         $group = $this->items->get($groupKey);
 
         if ($group instanceof NavigationGroup) {

From 13435431e8e9e3795a21b242477795b2f70a394a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:27:25 +0100
Subject: [PATCH 1375/4023] Get group through the connected page

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 764a758a62f..7b36daf841e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -116,7 +116,7 @@ public function getPriority(): int
      */
     public function getGroupKey(): ?string
     {
-        return $this->group;
+        return $this->getPage()?->navigationMenuGroup();
     }
 
     /**

From d362701cac27054d93e0ab84fefff3f41ce5fefd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:45:54 +0100
Subject: [PATCH 1376/4023] Remove the group property

---
 .../src/Framework/Features/Navigation/NavigationItem.php       | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7b36daf841e..105e432205d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -28,9 +28,6 @@ class NavigationItem implements NavigationElement, Stringable
     protected string $label;
     protected int $priority;
 
-    /** @deprecated Do we actually need this? We should just care if it's physically stored in a group. Adding the group key here doesn't magically make it appear in the group, it needs to be added to the group's items array, so why should we care about the key here? */
-    protected ?string $group = null;
-
     /**
      * Create a new navigation menu item with your own properties.
      *

From 35c2cd828559191a8eedbabcdeb788f7bd7fcb7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:48:11 +0100
Subject: [PATCH 1377/4023] Remove group parameter documentation

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 105e432205d..49c5205a3c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -34,7 +34,6 @@ class NavigationItem implements NavigationElement, Stringable
      * @param  \Hyde\Support\Models\Route|string  $destination  Route instance, route key, or external URI.
      * @param  string  $label  The label of the navigation item.
      * @param  int  $priority  The priority to determine the order of the navigation item.
-     * @param  string|null  $group  The dropdown/group key of the navigation item, if any.
      */
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, #[Deprecated] ?string $group = null)
     {
@@ -52,7 +51,6 @@ public function __construct(Route|string $destination, string $label, int $prior
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or external URI.
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
-     * @param  string|null  $group  Leave blank to use the group of the route's corresponding page, if there is one tied to the route.
      */
     public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, #[Deprecated] ?string $group = null): static
     {

From fbb7b3bbf8d0b537f50ba6fd0631f46ecd16719d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:48:20 +0100
Subject: [PATCH 1378/4023] No longer construct the group

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 49c5205a3c3..f1d4940a78f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -41,8 +41,6 @@ public function __construct(Route|string $destination, string $label, int $prior
 
         $this->label = $label;
         $this->priority = $priority;
-
-        $this->group = static::normalizeGroupKey($group);
     }
 
     /**

From daef8281436555f355e873f051477e37261c8f20 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:49:30 +0100
Subject: [PATCH 1379/4023] Remove the group parameter from item constructor

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 ++--
 packages/framework/tests/Unit/NavigationItemTest.php          | 1 -
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f1d4940a78f..7a1c0d0a10e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -35,7 +35,7 @@ class NavigationItem implements NavigationElement, Stringable
      * @param  string  $label  The label of the navigation item.
      * @param  int  $priority  The priority to determine the order of the navigation item.
      */
-    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT, #[Deprecated] ?string $group = null)
+    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT)
     {
         $this->destination = $destination;
 
@@ -62,7 +62,7 @@ public static function create(Route|string $destination, ?string $label = null,
             $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
-        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT, $group);
+        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index bb35faac14a..b39e7f83506 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -44,7 +44,6 @@ public function testConstruct()
         $this->assertInstanceOf(NavigationItem::class, new NavigationItem('foo', 'Test'));
         $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test'));
         $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500));
-        $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500, 'foo'));
     }
 
     public function testIsInstanceOfNavigationElement()

From 91d9cac1010d5c92963561860884fbeb1448a0f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:51:18 +0100
Subject: [PATCH 1380/4023] Remove coalesce assignment for the removed group

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7a1c0d0a10e..bcf35a9b304 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -59,7 +59,6 @@ public static function create(Route|string $destination, ?string $label = null,
         if ($destination instanceof Route) {
             $label ??= $destination->getPage()->navigationMenuLabel();
             $priority ??= $destination->getPage()->navigationMenuPriority();
-            $group ??= $destination->getPage()->navigationMenuGroup();
         }
 
         return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT);

From 8cad7f21877770ccc486e9f540813ad57cbceb7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:52:52 +0100
Subject: [PATCH 1381/4023] Remove the group parameter from item create method

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index bcf35a9b304..caaa73d74e2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -50,7 +50,7 @@ public function __construct(Route|string $destination, string $label, int $prior
      * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
      */
-    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, #[Deprecated] ?string $group = null): static
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null): static
     {
         if (is_string($destination) && Routes::has($destination)) {
             $destination = Routes::get($destination);

From 8c37e9443c5d894887c7d1c13f297e32347a4edd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:53:39 +0100
Subject: [PATCH 1382/4023] Fix wrong order of parameter annotations

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index caaa73d74e2..f19a63ee96c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -47,8 +47,8 @@ public function __construct(Route|string $destination, string $label, int $prior
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or external URI.
-     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
+     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
      */
     public static function create(Route|string $destination, ?string $label = null, ?int $priority = null): static
     {

From 13298c4c5b90d0190565f51623790d774de36403 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:53:43 +0100
Subject: [PATCH 1383/4023] Introduce local variable

---
 .../tests/Feature/Services/DocumentationSidebarTest.php        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 11b578cd405..9c3601ab46d 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -159,7 +159,8 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        $this->assertEquals('bar', collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first()->getGroupKey());
+        $firstItem = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
+        $this->assertEquals('bar', $firstItem->getGroupKey());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()

From 81f2e03b74e046571ccaf5572d2f4acd64620428 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:54:36 +0100
Subject: [PATCH 1384/4023] Add type annotation

---
 .../tests/Feature/Services/DocumentationSidebarTest.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 9c3601ab46d..0dd3ae74393 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -159,6 +159,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
+        /** @var NavigationItem $firstItem */
         $firstItem = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
         $this->assertEquals('bar', $firstItem->getGroupKey());
     }

From 8ecc783d6bbab4edc68200f3092d10df6ac75f20 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:55:13 +0100
Subject: [PATCH 1385/4023] Simplify local variable name

---
 .../tests/Feature/Services/DocumentationSidebarTest.php     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 0dd3ae74393..f622e08dcb5 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -159,9 +159,9 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
-        /** @var NavigationItem $firstItem */
-        $firstItem = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
-        $this->assertEquals('bar', $firstItem->getGroupKey());
+        /** @var NavigationItem $item */
+        $item = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
+        $this->assertEquals('bar', $item->getGroupKey());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()

From 4f3ba21408678fefe5782bb63b9c2776d35aaf66 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:55:26 +0100
Subject: [PATCH 1386/4023] Add some spacing

---
 .../tests/Feature/Services/DocumentationSidebarTest.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index f622e08dcb5..6a7ac43bd42 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -159,6 +159,7 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
     public function testGroupCanBeSetInFrontMatter()
     {
         $this->makePage('foo', ['navigation.group' => 'bar']);
+
         /** @var NavigationItem $item */
         $item = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
         $this->assertEquals('bar', $item->getGroupKey());

From be0820e1ca8682df3f0e10e988191f3255eaafc9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 18:55:51 +0100
Subject: [PATCH 1387/4023] Use assert same

---
 .../tests/Feature/Services/DocumentationSidebarTest.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 6a7ac43bd42..562fb83fd4a 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -162,7 +162,7 @@ public function testGroupCanBeSetInFrontMatter()
 
         /** @var NavigationItem $item */
         $item = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
-        $this->assertEquals('bar', $item->getGroupKey());
+        $this->assertSame('bar', $item->getGroupKey());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()

From 80f9a5c1d06bce0b7a5593dc92bedf1614a83fa4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:00:08 +0100
Subject: [PATCH 1388/4023] Inline method usage

---
 .../tests/Feature/Services/DocumentationSidebarTest.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 562fb83fd4a..3fe5722e880 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -162,7 +162,7 @@ public function testGroupCanBeSetInFrontMatter()
 
         /** @var NavigationItem $item */
         $item = collect(NavigationMenuGenerator::handle(DocumentationSidebar::class)->getItems()->first()->getItems())->first();
-        $this->assertSame('bar', $item->getGroupKey());
+        $this->assertSame('bar', $item->getPage()->navigationMenuGroup());
     }
 
     public function testHasGroupsReturnsFalseWhenThereAreNoGroups()

From 660edfccdedfb524b6889b24039e7bea9885cbbf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:00:27 +0100
Subject: [PATCH 1389/4023] Extract testing helper method for data access

---
 .../Services/DocumentationSidebarTest.php     | 31 +++++++++++--------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 3fe5722e880..a1971486787 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -225,7 +225,7 @@ public function testIsGroupActiveReturnsFalseWhenSuppliedGroupIsNotActive()
     {
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('bar' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('bar' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testIsGroupActiveReturnsTrueWhenSuppliedGroupIsActive()
@@ -233,7 +233,7 @@ public function testIsGroupActiveReturnsTrueWhenSuppliedGroupIsActive()
         $this->makePage('foo', ['navigation.group' => 'foo']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'foo']));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertTrue('foo' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertTrue('foo' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testIsGroupActiveReturnsTrueForDifferingCasing()
@@ -241,7 +241,7 @@ public function testIsGroupActiveReturnsTrueForDifferingCasing()
         $this->makePage('foo', ['navigation.group' => 'Foo Bar']);
         Render::setPage(new DocumentationPage(matter: ['navigation.group' => 'Foo Bar']));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertTrue('foo-bar' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertTrue('foo-bar' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
@@ -253,11 +253,11 @@ public function testIsGroupActiveReturnsTrueFirstGroupOfIndexPage()
 
         Render::setPage(DocumentationPage::get('index'));
         $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertTrue('bar' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $this->assertTrue('bar' === $this->getGroupKey($mainNavigationMenu2));
         $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('foo' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('foo' === $this->getGroupKey($mainNavigationMenu1));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('baz' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
@@ -269,11 +269,11 @@ public function testIsGroupActiveReturnsTrueFirstSortedGroupOfIndexPage()
 
         Render::setPage(DocumentationPage::get('index'));
         $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertTrue('foo' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $this->assertTrue('foo' === $this->getGroupKey($mainNavigationMenu2));
         $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('bar' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('bar' === $this->getGroupKey($mainNavigationMenu1));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('baz' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenuSettings()
@@ -285,11 +285,11 @@ public function testAutomaticIndexPageGroupExpansionRespectsCustomNavigationMenu
 
         Render::setPage(DocumentationPage::get('index'));
         $mainNavigationMenu2 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('foo' === $mainNavigationMenu2->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('foo' === $this->getGroupKey($mainNavigationMenu2));
         $mainNavigationMenu1 = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('bar' === $mainNavigationMenu1->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('bar' === $this->getGroupKey($mainNavigationMenu1));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertTrue('baz' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertTrue('baz' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testCanHaveMultipleGroupedPagesWithTheSameNameLabels()
@@ -338,7 +338,7 @@ public function testIsGroupActiveForIndexPageWithNoGroups()
 
         Render::setPage(DocumentationPage::get('index'));
         $mainNavigationMenu = NavigationMenuGenerator::handle(DocumentationSidebar::class);
-        $this->assertFalse('foo' === $mainNavigationMenu->getActiveGroup()?->getGroupKey());
+        $this->assertFalse('foo' === $this->getGroupKey($mainNavigationMenu));
     }
 
     public function testIndexPageAddedToSidebarWhenItIsTheOnlyPage()
@@ -380,4 +380,9 @@ protected function makePage(string $name, ?array $matter = null): void
             (new ConvertsArrayToFrontMatter)->execute($matter ?? [])
         );
     }
+
+    protected function getGroupKey(DocumentationSidebar $menu): ?string
+    {
+        return $menu->getActiveGroup()?->getGroupKey();
+    }
 }

From c2254b02d79c586bdae099483a7341dc13589c3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:04:09 +0100
Subject: [PATCH 1390/4023] Extract testing helper method for data access

---
 ...mentationSidebarGetActiveGroupUnitTest.php | 33 +++++++++++--------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 79286a5bfc9..08dd6279872 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -89,55 +89,55 @@ public function testNoActiveGroupWhenSidebarNotCollapsible()
     public function testActiveGroupGettingStarted()
     {
         $this->mockCurrentPageForActiveGroup('getting-started');
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupConfiguration()
     {
         $this->mockCurrentPageForActiveGroup('configuration');
-        $this->assertSame('configuration', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('configuration', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupUsage()
     {
         $this->mockCurrentPageForActiveGroup('usage');
-        $this->assertSame('usage', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupWithIdentifierGettingStarted()
     {
         $this->mockCurrentPageForActiveGroup('getting-started', 'Introduction');
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupWithIdentifierConfiguration()
     {
         $this->mockCurrentPageForActiveGroup('configuration', 'Configuration');
-        $this->assertSame('configuration', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('configuration', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupWithIdentifierUsage()
     {
         $this->mockCurrentPageForActiveGroup('usage', 'Routing');
-        $this->assertSame('usage', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted()
     {
         $this->mockCurrentPageForActiveGroup('GETTING-STARTED');
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted2()
     {
         $this->mockCurrentPageForActiveGroup('Getting-Started');
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testActiveGroupDifferentCasingGettingStarted3()
     {
         $this->mockCurrentPageForActiveGroup('getting-started');
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testGetActiveGroupIsNullWhenNoItemsExist()
@@ -159,7 +159,7 @@ public function testGetActiveGroupIsNullIfTheSetGroupIsNotPresentInTheSidebarIte
     public function testGetActiveGroupReturnsFirstGroupWhenRenderingIndexPage()
     {
         $this->renderData->setPage(new DocumentationPage('index'));
-        $this->assertSame('getting-started', $this->createSidebar()->getActiveGroup()->getGroupKey());
+        $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
     public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRenderingIndexPage()
@@ -168,7 +168,7 @@ public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRendering
         $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
 
         $this->renderData->setPage(new DocumentationPage('index'));
-        $this->assertSame('other', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('other', $this->getActiveGroupKey($sidebar));
     }
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
@@ -176,7 +176,7 @@ public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderin
         $sidebar = $this->createSidebar();
 
         $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
-        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->getActiveGroupKey($sidebar));
     }
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPageRegardlessOfPriorities()
@@ -185,11 +185,18 @@ public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderin
         $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
 
         $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
-        $this->assertSame('usage', $sidebar->getActiveGroup()->getGroupKey());
+        $this->assertSame('usage', $this->getActiveGroupKey($sidebar));
     }
 
     protected function mockCurrentPageForActiveGroup(string $group, string $identifier = 'foo'): void
     {
         $this->renderData->setPage(new DocumentationPage($identifier, ['navigation.group' => $group]));
     }
+
+    protected function getActiveGroupKey(?DocumentationSidebar $sidebar = null): string
+    {
+        $sidebar ??= $this->createSidebar();
+
+        return $sidebar->getActiveGroup()->getGroupKey();
+    }
 }

From 524e1ea8e4f13cb3b085242fcfc1eada8bcfb9b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:04:46 +0100
Subject: [PATCH 1391/4023] Update
 DocumentationSidebarGetActiveGroupUnitTest.php

---
 .../tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 08dd6279872..91ca9487966 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -173,10 +173,8 @@ public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRendering
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
     {
-        $sidebar = $this->createSidebar();
-
         $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
-        $this->assertSame('usage', $this->getActiveGroupKey($sidebar));
+        $this->assertSame('usage', $this->getActiveGroupKey($this->createSidebar()));
     }
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPageRegardlessOfPriorities()

From c52a912366314b1419f4852f1becb385475d5a92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:05:01 +0100
Subject: [PATCH 1392/4023] Move up test in source

---
 .../DocumentationSidebarGetActiveGroupUnitTest.php   | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 91ca9487966..34a266fbc59 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -162,6 +162,12 @@ public function testGetActiveGroupReturnsFirstGroupWhenRenderingIndexPage()
         $this->assertSame('getting-started', $this->getActiveGroupKey());
     }
 
+    public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
+    {
+        $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
+        $this->assertSame('usage', $this->getActiveGroupKey($this->createSidebar()));
+    }
+
     public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRenderingIndexPage()
     {
         $sidebar = $this->createSidebar();
@@ -171,12 +177,6 @@ public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRendering
         $this->assertSame('other', $this->getActiveGroupKey($sidebar));
     }
 
-    public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPage()
-    {
-        $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
-        $this->assertSame('usage', $this->getActiveGroupKey($this->createSidebar()));
-    }
-
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPageRegardlessOfPriorities()
     {
         $sidebar = $this->createSidebar();

From 09b909f45a95d7419732641c3bd9df79ff8ca559 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:06:01 +0100
Subject: [PATCH 1393/4023] Use fluent method call

---
 .../Unit/DocumentationSidebarGetActiveGroupUnitTest.php     | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
index 34a266fbc59..85cfca99569 100644
--- a/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
+++ b/packages/framework/tests/Unit/DocumentationSidebarGetActiveGroupUnitTest.php
@@ -170,8 +170,7 @@ public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderin
 
     public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRenderingIndexPage()
     {
-        $sidebar = $this->createSidebar();
-        $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
+        $sidebar = $this->createSidebar()->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
 
         $this->renderData->setPage(new DocumentationPage('index'));
         $this->assertSame('other', $this->getActiveGroupKey($sidebar));
@@ -179,8 +178,7 @@ public function testGetActiveGroupReturnsFirstGroupByLowestPriorityWhenRendering
 
     public function testGetActiveGroupReturnsExplicitlySetIndexPageGroupWhenRenderingIndexPageRegardlessOfPriorities()
     {
-        $sidebar = $this->createSidebar();
-        $sidebar->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
+        $sidebar = $this->createSidebar()->add(new NavigationGroup('other', [new NavigationItem('Other', 'Other')], 0));
 
         $this->renderData->setPage(new DocumentationPage('index', ['navigation.group' => 'usage']));
         $this->assertSame('usage', $this->getActiveGroupKey($sidebar));

From 749d41c34fab2e745dfd1fa22f4704043e79f610 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:08:24 +0100
Subject: [PATCH 1394/4023] Remove `getGroupKey` method from
 `NavigationElement` contract

---
 .../src/Framework/Features/Navigation/NavigationElement.php  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
index 6084549e48b..10152254c5c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
@@ -15,9 +15,4 @@ public function getLabel(): string;
      * Get the priority to determine the order of the navigation item.
      */
     public function getPriority(): int;
-
-    /**
-     * Get the group identifier key of the navigation item, if any.
-     */
-    public function getGroupKey(): ?string;
 }

From 6b675523b6ad964075c08e38f195e76dd10452bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:09:30 +0100
Subject: [PATCH 1395/4023] Remove `getGroupKey` method from `NavigationItem`
 class

---
 .../Features/Navigation/NavigationItem.php       | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index f19a63ee96c..c67485e6406 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Pages\Concerns\HydePage;
-use JetBrains\PhpStorm\Deprecated;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
@@ -96,21 +95,6 @@ public function getPriority(): int
         return $this->priority;
     }
 
-    /**
-     * Get the group identifier key of the navigation item, if any.
-     *
-     * @deprecated as the property is deprecated.
-     *
-     *  For sidebars this is the category key, for navigation menus this is the dropdown key.
-     *
-     *  When using automatic subdirectory based groups, the subdirectory name is the group key.
-     *  Otherwise, the group key is a 'slugified' version of the group's label.
-     */
-    public function getGroupKey(): ?string
-    {
-        return $this->getPage()?->navigationMenuGroup();
-    }
-
     /**
      * If the navigation item is a link to a routed page, get the corresponding page instance.
      */

From c359bcaac4260add8348bbfb5f21a84a05297e67 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:22:55 +0100
Subject: [PATCH 1396/4023] Move group key normalization method to navigation
 group class

---
 .../Features/Navigation/DocumentationSidebar.php   |  2 +-
 .../Features/Navigation/NavigationGroup.php        |  6 ++++++
 .../Features/Navigation/NavigationItem.php         |  7 -------
 .../Navigation/NavigationMenuGenerator.php         |  2 +-
 .../framework/tests/Unit/NavigationGroupTest.php   | 14 ++++++++++++++
 .../framework/tests/Unit/NavigationItemTest.php    | 14 --------------
 6 files changed, 22 insertions(+), 23 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index f2a5d485fa6..195d90263a8 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -78,7 +78,7 @@ public function getActiveGroup(): ?NavigationGroup
 
         return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
             // A group is active when it contains the current page being rendered.
-            return $group->getGroupKey() === NavigationItem::normalizeGroupKey($currentPage->navigationMenuGroup());
+            return $group->getGroupKey() === NavigationGroup::normalizeGroupKey($currentPage->navigationMenuGroup());
         });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 937d1647ddd..516e6d7736d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -81,4 +81,10 @@ protected function containsOnlyDocumentationPages(): bool
             return $child->getPage() instanceof DocumentationPage;
         });
     }
+
+    /** @return ($group is null ? null : string) */
+    public static function normalizeGroupKey(?string $group): ?string
+    {
+        return $group ? Str::slug($group) : null;
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index c67485e6406..8e406303dd3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -8,7 +8,6 @@
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
-use Illuminate\Support\Str;
 use Stringable;
 
 use function is_string;
@@ -110,10 +109,4 @@ public function isActive(): bool
     {
         return Hyde::currentRoute()->getLink() === $this->getLink();
     }
-
-    /** @return ($group is null ? null : string) */
-    public static function normalizeGroupKey(?string $group): ?string
-    {
-        return $group ? Str::slug($group) : null;
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d43c0638185..c0e11aa5a75 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -148,7 +148,7 @@ protected function addRouteToGroup(Route $route): void
 
     protected function getOrCreateGroupItem(string $groupName): NavigationGroup
     {
-        $groupKey = NavigationItem::normalizeGroupKey($groupName);
+        $groupKey = NavigationGroup::normalizeGroupKey($groupName);
         $group = $this->items->get($groupKey);
 
         if ($group instanceof NavigationGroup) {
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 2baaf30d2fc..ca7170207bb 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -173,6 +173,20 @@ public function testModifierMethodsAreFluentlyChainable()
         $this->assertSame($group, $group->add([new NavigationItem(new Route(new MarkdownPage()), 'Bar')]));
     }
 
+    public function testNormalizeGroupKeyCreatesSlugs()
+    {
+        $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey('Foo Bar'));
+        $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey('foo bar'));
+        $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey('foo_bar'));
+        $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey('foo-bar'));
+        $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey(' foo bar '));
+    }
+
+    public function testNormalizeGroupKeyReturnsNullForNull()
+    {
+        $this->assertNull(NavigationGroup::normalizeGroupKey(null));
+    }
+
     protected function createNavigationItems(): array
     {
         return [
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index b39e7f83506..02152f8a182 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -305,18 +305,4 @@ public function testIsCurrentWithLink()
         $this->assertFalse(NavigationItem::create('foo', 'bar')->isActive());
         $this->assertFalse(NavigationItem::create('https://example.com', 'bar')->isActive());
     }
-
-    public function testNormalizeGroupKeyCreatesSlugs()
-    {
-        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('Foo Bar'));
-        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo bar'));
-        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo_bar'));
-        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey('foo-bar'));
-        $this->assertSame('foo-bar', NavigationItem::normalizeGroupKey(' foo bar '));
-    }
-
-    public function testNormalizeGroupKeyReturnsNullForNull()
-    {
-        $this->assertNull(NavigationItem::normalizeGroupKey(null));
-    }
 }

From 74933b8bb0626788d24e6a039859476a521862be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:24:11 +0100
Subject: [PATCH 1397/4023] Remove null support from group key normalization
 method

This is no longer needed
---
 .../src/Framework/Features/Navigation/NavigationGroup.php    | 5 ++---
 packages/framework/tests/Unit/NavigationGroupTest.php        | 5 -----
 2 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 516e6d7736d..7515620cc2c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -82,9 +82,8 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
-    /** @return ($group is null ? null : string) */
-    public static function normalizeGroupKey(?string $group): ?string
+    public static function normalizeGroupKey(string $group): string
     {
-        return $group ? Str::slug($group) : null;
+        return Str::slug($group);
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index ca7170207bb..077659cdb9f 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -182,11 +182,6 @@ public function testNormalizeGroupKeyCreatesSlugs()
         $this->assertSame('foo-bar', NavigationGroup::normalizeGroupKey(' foo bar '));
     }
 
-    public function testNormalizeGroupKeyReturnsNullForNull()
-    {
-        $this->assertNull(NavigationGroup::normalizeGroupKey(null));
-    }
-
     protected function createNavigationItems(): array
     {
         return [

From eb346e9c526eb259810801382377ce29a1eb71cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:48:23 +0100
Subject: [PATCH 1398/4023] Add null type check

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 195d90263a8..097174d38c7 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -78,7 +78,7 @@ public function getActiveGroup(): ?NavigationGroup
 
         return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
             // A group is active when it contains the current page being rendered.
-            return $group->getGroupKey() === NavigationGroup::normalizeGroupKey($currentPage->navigationMenuGroup());
+            return $currentPage->navigationMenuGroup() && $group->getGroupKey() === NavigationGroup::normalizeGroupKey($currentPage->navigationMenuGroup());
         });
     }
 }

From de6993bac15fe29da924515a5e4eae8f5e7cd45e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 24 Mar 2024 19:48:51 +0100
Subject: [PATCH 1399/4023] Mark group key normalization method as experimental

---
 .../src/Framework/Features/Navigation/NavigationGroup.php        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 7515620cc2c..b0b127ddc27 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -82,6 +82,7 @@ protected function containsOnlyDocumentationPages(): bool
         });
     }
 
+    /** @experimental This method is subject to change before its release. */
     public static function normalizeGroupKey(string $group): string
     {
         return Str::slug($group);

From 67c5d1da22dc5ef659bb406a979abe6c62aef684 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:01:33 +0100
Subject: [PATCH 1400/4023] Rename local closure variables

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index b0b127ddc27..0d619dce874 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -48,7 +48,7 @@ public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {
             // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
-            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $child): int => $child->getPriority()));
+            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $item): int => $item->getPriority()));
         }
 
         return $this->priority;
@@ -77,8 +77,8 @@ protected function addItem(NavigationItem $item): void
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $child): bool {
-            return $child->getPage() instanceof DocumentationPage;
+        return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $item): bool {
+            return $item->getPage() instanceof DocumentationPage;
         });
     }
 

From 34f2569cb635e88351e58fbf982b363b12504a60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:04:03 +0100
Subject: [PATCH 1401/4023] Deprecate the navigation element contract

---
 .../src/Framework/Features/Navigation/NavigationElement.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
index 10152254c5c..ddc1159ffa8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * @deprecated
+ */
 interface NavigationElement
 {
     /**

From 3175f91fe113721677d7cc8834d8924259e59ca4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:09:36 +0100
Subject: [PATCH 1402/4023] Replace interface type hint with union type

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 097174d38c7..6e8332b8ad2 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -55,7 +55,7 @@ public function isCollapsible(): bool
 
     public function hasGroups(): bool
     {
-        return $this->getItems()->contains(fn (NavigationElement $item): bool => $item instanceof NavigationGroup);
+        return $this->getItems()->contains(fn (NavigationItem|NavigationGroup $item): bool => $item instanceof NavigationGroup);
     }
 
     /**

From 9b1a1d0d5fc6a82c11bdaffd88c7c30a9590e9d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:13:40 +0100
Subject: [PATCH 1403/4023] No longer implement navigation element contract

---
 .../src/Framework/Features/Navigation/NavigationGroup.php   | 2 +-
 .../src/Framework/Features/Navigation/NavigationItem.php    | 2 +-
 packages/framework/tests/Unit/NavigationGroupTest.php       | 6 +-----
 packages/framework/tests/Unit/NavigationItemTest.php        | 6 ------
 4 files changed, 3 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 0d619dce874..ca6e696da2b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -14,7 +14,7 @@
 /**
  * Abstraction for a grouped navigation menu item, like a dropdown or a sidebar group.
  */
-class NavigationGroup implements NavigationElement
+class NavigationGroup
 {
     /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected array $items = [];
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 8e406303dd3..3847bc79b18 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -20,7 +20,7 @@
  *   2. You can use NavigationItem::fromRoute() to use data from the route
  *   3. You can use NavigationItem::create() for an external or un-routed link
  */
-class NavigationItem implements NavigationElement, Stringable
+class NavigationItem implements Stringable
 {
     protected string|Route $destination;
     protected string $label;
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 077659cdb9f..378a1d7fe52 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -26,6 +26,7 @@ public static function setUpBeforeClass(): void
 
     public function testCanConstruct()
     {
+        $this->assertInstanceOf(NavigationGroup::class, new NavigationGroup('Foo'));
         $this->assertSame('Foo', (new NavigationGroup('Foo'))->getLabel());
     }
 
@@ -57,11 +58,6 @@ public function testCanConstructWithChildrenWithoutRoute()
         $this->assertSame($children, $item->getItems());
     }
 
-    public function testIsInstanceOfNavigationElement()
-    {
-        $this->assertInstanceOf(NavigationGroup::class, new NavigationGroup('Foo'));
-    }
-
     public function testCreate()
     {
         $this->assertEquals(
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 02152f8a182..0e1da8957b6 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -14,7 +14,6 @@
 use Hyde\Testing\UnitTestCase;
 use Mockery;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
-use Hyde\Framework\Features\Navigation\NavigationElement;
 
 /**
  * This unit test covers the basics of the NavigationItem class.
@@ -46,11 +45,6 @@ public function testConstruct()
         $this->assertInstanceOf(NavigationItem::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500));
     }
 
-    public function testIsInstanceOfNavigationElement()
-    {
-        $this->assertInstanceOf(NavigationElement::class, new NavigationItem(new Route(new MarkdownPage()), 'Test', 500));
-    }
-
     public function testPassingRouteInstanceToConstructorUsesRouteInstance()
     {
         $route = new Route(new MarkdownPage());

From 4385cc79a658e361ce9d2a76c1ebac7a4e200bb7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:17:10 +0100
Subject: [PATCH 1404/4023] Delete NavigationElement.php

---
 .../Features/Navigation/NavigationElement.php | 21 -------------------
 1 file changed, 21 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationElement.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php b/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
deleted file mode 100644
index ddc1159ffa8..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/NavigationElement.php
+++ /dev/null
@@ -1,21 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/**
- * @deprecated
- */
-interface NavigationElement
-{
-    /**
-     * Get the label of the navigation item.
-     */
-    public function getLabel(): string;
-
-    /**
-     * Get the priority to determine the order of the navigation item.
-     */
-    public function getPriority(): int;
-}

From c870acb51fbe9c65907e5bae2d73c7490d78d8cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:30:25 +0100
Subject: [PATCH 1405/4023] Clean up test

---
 .../tests/Feature/SidebarViewTest.php          | 18 +-----------------
 1 file changed, 1 insertion(+), 17 deletions(-)

diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index 522d25de033..03800562e2a 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -7,10 +7,8 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Contracts\View\View;
-use Throwable;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
@@ -189,21 +187,7 @@ protected function renderComponent(View $view): self
         app()->instance('navigation.sidebar', $sidebar);
         view()->share('sidebar', $sidebar);
 
-        try {
-            $this->html = $view->render();
-            /** @noinspection LaravelFunctionsInspection */
-            if (env('TEST_HTML_DEBUG', false)) {
-                file_put_contents(Hyde::path('_site/test.html'), $this->html);
-                echo "\e[0;32mCreated file: \e[0m".realpath(Hyde::path('_site/test.html'));
-            }
-        } catch (Throwable $exception) {
-            /** @noinspection LaravelFunctionsInspection */
-            if (env('TEST_HTML_DEBUG', false)) {
-                throw $exception;
-            }
-            $this->fail($exception->getMessage());
-        }
-
+        $this->html = $view->render();
         $this->assertIsString($this->html);
 
         return $this;

From ea15074a0c08d9129873497c5becdc193dc4759d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:30:51 +0100
Subject: [PATCH 1406/4023] Clean up test

---
 .../tests/Feature/SidebarViewTest.php         | 31 +++++--------------
 1 file changed, 8 insertions(+), 23 deletions(-)

diff --git a/packages/framework/tests/Feature/SidebarViewTest.php b/packages/framework/tests/Feature/SidebarViewTest.php
index 03800562e2a..1f76307068b 100644
--- a/packages/framework/tests/Feature/SidebarViewTest.php
+++ b/packages/framework/tests/Feature/SidebarViewTest.php
@@ -38,8 +38,7 @@ public function testBaseSidebar()
             ->assertSeeHtml('<a href="../">Back to home page</a>')
             ->assertSeeHtml('<span class="sr-only">Toggle dark theme</span>')
             ->assertDontSee('<a href="docs/index.html">')
-            ->assertDontSee('<li class="sidebar-item')
-            ->allGood();
+            ->assertDontSee('<li class="sidebar-item');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items'));
 
@@ -53,8 +52,7 @@ public function testBaseSidebarWithoutFooter()
 
         $this->renderComponent(view('hyde::components.docs.sidebar'))
             ->assertDontSee('<footer id="sidebar-footer"')
-            ->assertDontSee('Back to home page')
-            ->allGood();
+            ->assertDontSee('Back to home page');
     }
 
     public function testBaseSidebarWithCustomFooterText()
@@ -64,8 +62,7 @@ public function testBaseSidebarWithCustomFooterText()
         $this->renderComponent(view('hyde::components.docs.sidebar'))
             ->assertSeeHtml('<footer id="sidebar-footer"')
             ->assertSeeHtml('<p>My <strong>Markdown</strong> Footer Text</p>')
-            ->assertDontSee('Back to home page')
-            ->allGood();
+            ->assertDontSee('Back to home page');
     }
 
     public function testBaseSidebarCustomHeaderBrand()
@@ -74,8 +71,7 @@ public function testBaseSidebarCustomHeaderBrand()
 
         $this->renderComponent(view('hyde::components.docs.sidebar'))
             ->assertSeeText('My Custom Header')
-            ->assertDontSee('HydePHP Docs')
-            ->allGood();
+            ->assertDontSee('HydePHP Docs');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-brand'));
     }
@@ -90,8 +86,7 @@ public function testBaseSidebarWithItems()
             ->assertSeeHtml('<a href="docs/index.html">')
             ->assertSeeHtml('<nav id="sidebar-navigation"')
             ->assertSeeHtml('<ul id="sidebar-items" role="list" class="pl-2">')
-            ->assertSeeHtml('<li class="sidebar-item')
-            ->allGood();
+            ->assertSeeHtml('<li class="sidebar-item');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items'));
     }
@@ -116,8 +111,7 @@ public function testSidebarWithGroupedItems()
             ->assertSeeHtml('class="sidebar-group-toggle')
             ->assertSeeHtml('class="sidebar-group-toggle-icon')
             ->assertSeeHtml('class="sidebar-group-items')
-            ->assertSee('groupOpen')
-            ->allGood();
+            ->assertSee('groupOpen');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
             'grouped' => true,
@@ -147,8 +141,7 @@ public function testSidebarWithNonCollapsibleGroupedItems()
             ->assertSeeHtml('class="sidebar-group-items')
             ->assertDontSee('sidebar-group-toggle')
             ->assertDontSee('sidebar-group-toggle-icon')
-            ->assertDontSee('groupOpen')
-            ->allGood();
+            ->assertDontSee('groupOpen');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
             'grouped' => true,
@@ -171,8 +164,7 @@ public function testSidebarWithMixedGroupedAndUngroupedItems()
             ->assertSeeText('Other')
             ->assertSeeText('Second')
             ->assertSeeHtml('href="docs/first.html"')
-            ->assertSeeHtml('href="docs/second.html"')
-            ->allGood();
+            ->assertSeeHtml('href="docs/second.html"');
 
         $this->assertViewWasRendered(view('hyde::components.docs.sidebar-items', [
             'grouped' => true,
@@ -234,11 +226,4 @@ protected function assertDontSee(string $text): self
 
         return $this;
     }
-
-    protected function allGood(): self
-    {
-        // Just an empty helper so we get easier Git diffs when adding new assertions.
-
-        return $this;
-    }
 }

From c5d04170352c4f10a2349fe4ee18094f12f65a8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:56:49 +0100
Subject: [PATCH 1407/4023] Remove abstract modifier from navigation menu class

I see no reason why we can't allow users to create custom menus by instantiating this class
---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 46e904cde29..7329b6bfbe9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -18,7 +18,7 @@
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
-abstract class NavigationMenu
+class NavigationMenu
 {
     public const DEFAULT = 500;
     public const LAST = 999;

From 2beb314dbc338053cfe0f3677b5f99fc28c29835 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 10:57:47 +0100
Subject: [PATCH 1408/4023] Create NavigationAPITest.php

---
 .../framework/tests/Feature/NavigationAPITest.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Feature/NavigationAPITest.php

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
new file mode 100644
index 00000000000..49e7eae0e4e
--- /dev/null
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * High level tests for the Navigation API.
+ */
+class NavigationAPITest extends TestCase
+{
+    //
+}

From 102df43e6619b1907d67426caa54bf4ebd47c34d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 11:02:12 +0100
Subject: [PATCH 1409/4023] Set up test kernel

---
 .../tests/Feature/NavigationAPITest.php       | 27 ++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 49e7eae0e4e..5cec9b75b4c 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -5,11 +5,36 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\HydeKernel;
+use Illuminate\Support\Collection;
+use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * High level tests for the Navigation API.
  */
 class NavigationAPITest extends TestCase
 {
-    //
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->kernel = new TestKernel();
+        HydeKernel::setInstance($this->kernel);
+    }
+}
+
+class TestKernel extends HydeKernel
+{
+    protected ?RouteCollection $mockRoutes = null;
+
+    public function setRoutes(Collection $routes): void
+    {
+        $this->mockRoutes = RouteCollection::make($routes);
+    }
+
+    /** @return \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
+    public function routes(): RouteCollection
+    {
+        return $this->mockRoutes ?? parent::routes();
+    }
 }

From c462c62f695c44baedab5bf5650421c0994a3d8d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:02:44 +0100
Subject: [PATCH 1410/4023] Revert "Set up test kernel"

This reverts commit 102df43e6619b1907d67426caa54bf4ebd47c34d.
---
 .../tests/Feature/NavigationAPITest.php       | 27 +------------------
 1 file changed, 1 insertion(+), 26 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 5cec9b75b4c..49e7eae0e4e 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -5,36 +5,11 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
-use Hyde\Foundation\HydeKernel;
-use Illuminate\Support\Collection;
-use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * High level tests for the Navigation API.
  */
 class NavigationAPITest extends TestCase
 {
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        $this->kernel = new TestKernel();
-        HydeKernel::setInstance($this->kernel);
-    }
-}
-
-class TestKernel extends HydeKernel
-{
-    protected ?RouteCollection $mockRoutes = null;
-
-    public function setRoutes(Collection $routes): void
-    {
-        $this->mockRoutes = RouteCollection::make($routes);
-    }
-
-    /** @return \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */
-    public function routes(): RouteCollection
-    {
-        return $this->mockRoutes ?? parent::routes();
-    }
+    //
 }

From 85f8aa238c45e550bda2ea37e04818104633f123 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:06:31 +0100
Subject: [PATCH 1411/4023] Update NavigationMenu to implement Arrayable

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 7329b6bfbe9..14904103ea6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -18,7 +18,7 @@
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
-class NavigationMenu
+class NavigationMenu implements Arrayable
 {
     public const DEFAULT = 500;
     public const LAST = 999;

From 72b74173b8a05a57031f3a394795146b634cb104 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:06:53 +0100
Subject: [PATCH 1412/4023] Draft to array method

---
 .../Framework/Features/Navigation/NavigationMenu.php   | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 14904103ea6..770e823373b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -63,6 +63,16 @@ public function add(NavigationItem|NavigationGroup|array $items): static
         return $this;
     }
 
+    /**
+     * Get the navigation items in the menu as an array.
+     *
+     * @return array<array<string, mixed>>
+     */
+    public function toArray(): array
+    {
+        //
+    }
+
     protected function addItem(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);

From 7e8aee5a82b0fca3bc28ad962855610ceba151b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:07:03 +0100
Subject: [PATCH 1413/4023] Mark method as experimental

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 770e823373b..5abedcd74d4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -66,6 +66,8 @@ public function add(NavigationItem|NavigationGroup|array $items): static
     /**
      * Get the navigation items in the menu as an array.
      *
+     * @experimental This method is experimental and may be changed before release.
+     *
      * @return array<array<string, mixed>>
      */
     public function toArray(): array

From fe76c48f3f5f4e0fb9da9548610f930031ccd845 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:08:34 +0100
Subject: [PATCH 1414/4023] Annotate full array generics

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 5abedcd74d4..8de2abe758c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -68,7 +68,7 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      *
      * @experimental This method is experimental and may be changed before release.
      *
-     * @return array<array<string, mixed>>
+     * @return array<int, array{url: string, title: string, active: bool}>
      */
     public function toArray(): array
     {

From 493aee87d458737ff11a339b0b1d866f97bd927f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:11:44 +0100
Subject: [PATCH 1415/4023] Add null safety to active state check

---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 2 +-
 packages/framework/tests/Unit/NavigationItemTest.php         | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 3847bc79b18..dd4ab94709a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -107,6 +107,6 @@ public function getPage(): ?HydePage
      */
     public function isActive(): bool
     {
-        return Hyde::currentRoute()->getLink() === $this->getLink();
+        return Hyde::currentRoute()?->getLink() === $this->getLink();
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 0e1da8957b6..cb45bd6c9a9 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -299,4 +299,9 @@ public function testIsCurrentWithLink()
         $this->assertFalse(NavigationItem::create('foo', 'bar')->isActive());
         $this->assertFalse(NavigationItem::create('https://example.com', 'bar')->isActive());
     }
+
+    public function testIsCurrentIsNullSafe()
+    {
+        $this->assertFalse(NavigationItem::create('foo', 'bar')->isActive());
+    }
 }

From 473ac2056b49b5ffda20f1b985db3f3c66ceaaf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:12:27 +0100
Subject: [PATCH 1416/4023] Draft test setup

---
 .../tests/Feature/NavigationAPITest.php       | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 49e7eae0e4e..64208fe8b10 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -5,11 +5,28 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\Facades\Routes;
+use Hyde\Testing\MocksKernelFeatures;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 
 /**
  * High level tests for the Navigation API.
  */
 class NavigationAPITest extends TestCase
 {
-    //
+    use MocksKernelFeatures;
+
+    public function testNavigationMenus()
+    {
+        $this->withPages(['index', 'about', 'contact']);
+
+        $menu = new NavigationMenu([
+            new NavigationItem(Routes::get('index'), 'Home'),
+            new NavigationItem(Routes::get('about'), 'About'),
+            new NavigationItem(Routes::get('contact'), 'Contact'),
+        ]);
+
+        $this->assertCount(3, $menu->getItems());
+    }
 }

From d8630e731e6c4c7e59dd6650070476f1a87b3f9c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:29:49 +0100
Subject: [PATCH 1417/4023] Create initial array representation

---
 .../src/Framework/Features/Navigation/NavigationMenu.php  | 8 +++++++-
 packages/framework/tests/Feature/NavigationAPITest.php    | 6 +++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 8de2abe758c..f1a64e45be6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -72,7 +72,13 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      */
     public function toArray(): array
     {
-        //
+        return $this->getItems()->map(function (NavigationItem|NavigationGroup $item): array {
+            return [
+                'url' => $item->getLink(),
+                'title' => $item->getLabel(),
+                'active' => $item->isActive(),
+            ];
+        })->all();
     }
 
     protected function addItem(NavigationItem|NavigationGroup $item): void
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 64208fe8b10..e0db6750d8e 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -27,6 +27,10 @@ public function testNavigationMenus()
             new NavigationItem(Routes::get('contact'), 'Contact'),
         ]);
 
-        $this->assertCount(3, $menu->getItems());
+        $this->assertSame([
+            ['url' => 'index.html', 'title' => 'Home', 'active' => false],
+            ['url' => 'about.html', 'title' => 'About', 'active' => false],
+            ['url' => 'contact.html', 'title' => 'Contact', 'active' => false],
+        ], $menu->toArray());
     }
 }

From c188e01beb2a0601c242aa23b0dfd82a907f7739 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:31:29 +0100
Subject: [PATCH 1418/4023] Update array keys to match data structure

---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 +++---
 packages/framework/tests/Feature/NavigationAPITest.php      | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index f1a64e45be6..e0b7203f393 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -68,14 +68,14 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      *
      * @experimental This method is experimental and may be changed before release.
      *
-     * @return array<int, array{url: string, title: string, active: bool}>
+     * @return array<int, array{link: string, label: string, active: bool}>
      */
     public function toArray(): array
     {
         return $this->getItems()->map(function (NavigationItem|NavigationGroup $item): array {
             return [
-                'url' => $item->getLink(),
-                'title' => $item->getLabel(),
+                'link' => $item->getLink(),
+                'label' => $item->getLabel(),
                 'active' => $item->isActive(),
             ];
         })->all();
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index e0db6750d8e..169c60beb53 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -28,9 +28,9 @@ public function testNavigationMenus()
         ]);
 
         $this->assertSame([
-            ['url' => 'index.html', 'title' => 'Home', 'active' => false],
-            ['url' => 'about.html', 'title' => 'About', 'active' => false],
-            ['url' => 'contact.html', 'title' => 'Contact', 'active' => false],
+            ['link' => 'index.html', 'label' => 'Home', 'active' => false],
+            ['link' => 'about.html', 'label' => 'About', 'active' => false],
+            ['link' => 'contact.html', 'label' => 'Contact', 'active' => false],
         ], $menu->toArray());
     }
 }

From 091c93725fb27d3d6af396d375b5f085585cd2b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:32:19 +0100
Subject: [PATCH 1419/4023] Remove active state from array

I think this helper makes most sense when it's portable, so we don't want render state specific data here
---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 3 +--
 packages/framework/tests/Feature/NavigationAPITest.php      | 6 +++---
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index e0b7203f393..cbb8b24cb23 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -68,7 +68,7 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      *
      * @experimental This method is experimental and may be changed before release.
      *
-     * @return array<int, array{link: string, label: string, active: bool}>
+     * @return array<int, array{link: string, label: string}>
      */
     public function toArray(): array
     {
@@ -76,7 +76,6 @@ public function toArray(): array
             return [
                 'link' => $item->getLink(),
                 'label' => $item->getLabel(),
-                'active' => $item->isActive(),
             ];
         })->all();
     }
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 169c60beb53..c44b5a9e0e4 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -28,9 +28,9 @@ public function testNavigationMenus()
         ]);
 
         $this->assertSame([
-            ['link' => 'index.html', 'label' => 'Home', 'active' => false],
-            ['link' => 'about.html', 'label' => 'About', 'active' => false],
-            ['link' => 'contact.html', 'label' => 'Contact', 'active' => false],
+            ['link' => 'index.html', 'label' => 'Home'],
+            ['link' => 'about.html', 'label' => 'About'],
+            ['link' => 'contact.html', 'label' => 'Contact'],
         ], $menu->toArray());
     }
 }

From 38050af04e6a1429f4fbc77d2e5bd0cbfa7d548f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:35:54 +0100
Subject: [PATCH 1420/4023] Array serialize navigation groups

---
 .../Features/Navigation/NavigationMenu.php    | 12 +++++++++-
 .../tests/Feature/NavigationAPITest.php       | 22 +++++++++++++++++++
 2 files changed, 33 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index cbb8b24cb23..873ce83b4b6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -68,11 +68,21 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      *
      * @experimental This method is experimental and may be changed before release.
      *
-     * @return array<int, array{link: string, label: string}>
+     * @return array<int, array{link?: string, label: string, items?: array<int, array{link: string, label: string}>}>
      */
     public function toArray(): array
     {
         return $this->getItems()->map(function (NavigationItem|NavigationGroup $item): array {
+            if ($item instanceof NavigationGroup) {
+                return [
+                    'label' => $item->getLabel(),
+                    'items' => array_map(fn (NavigationItem $item): array => [
+                        'link' => $item->getLink(),
+                        'label' => $item->getLabel(),
+                    ], $item->getItems()),
+                ];
+            }
+
             return [
                 'link' => $item->getLink(),
                 'label' => $item->getLabel(),
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index c44b5a9e0e4..54f4ab06f1f 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -9,6 +9,7 @@
 use Hyde\Testing\MocksKernelFeatures;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 
 /**
  * High level tests for the Navigation API.
@@ -33,4 +34,25 @@ public function testNavigationMenus()
             ['link' => 'contact.html', 'label' => 'Contact'],
         ], $menu->toArray());
     }
+
+    public function testNavigationMenusWithGroups()
+    {
+        $this->withPages(['index', 'about', 'contact']);
+
+        $menu = new NavigationMenu([
+            new NavigationItem(Routes::get('index'), 'Home'),
+            new NavigationGroup('About', [
+                new NavigationItem(Routes::get('about'), 'About Us'),
+                new NavigationItem(Routes::get('contact'), 'Contact Us'),
+            ]),
+        ]);
+
+        $this->assertSame([
+            ['link' => 'index.html', 'label' => 'Home'],
+            ['label' => 'About', 'items' => [
+                ['link' => 'about.html', 'label' => 'About Us'],
+                ['link' => 'contact.html', 'label' => 'Contact Us'],
+            ]],
+        ], $menu->toArray());
+    }
 }

From b1d62bfae5a58cd8d118debf18328ae4383e331b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:39:24 +0100
Subject: [PATCH 1421/4023] Make navigation menu serializable

---
 .../Features/Navigation/NavigationMenu.php      |  6 +++++-
 .../tests/Feature/NavigationAPITest.php         | 17 +++++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 873ce83b4b6..2c4d8d063f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -6,6 +6,8 @@
 
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
+use Hyde\Support\Concerns\Serializable;
+use Hyde\Support\Contracts\SerializableContract;
 use Illuminate\Contracts\Support\Arrayable;
 
 use function Hyde\evaluate_arrayable;
@@ -18,8 +20,10 @@
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
-class NavigationMenu implements Arrayable
+class NavigationMenu implements SerializableContract
 {
+    use Serializable;
+
     public const DEFAULT = 500;
     public const LAST = 999;
 
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 54f4ab06f1f..657110fda4d 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -33,6 +33,23 @@ public function testNavigationMenus()
             ['link' => 'about.html', 'label' => 'About'],
             ['link' => 'contact.html', 'label' => 'Contact'],
         ], $menu->toArray());
+
+        $this->assertSame(<<<JSON
+        [
+            {
+                "link": "index.html",
+                "label": "Home"
+            },
+            {
+                "link": "about.html",
+                "label": "About"
+            },
+            {
+                "link": "contact.html",
+                "label": "Contact"
+            }
+        ]
+        JSON, $menu->toJson(JSON_PRETTY_PRINT));
     }
 
     public function testNavigationMenusWithGroups()

From 86cdc95c21e6a4a16c71d26bc073ad826e3dc660 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:39:27 +0100
Subject: [PATCH 1422/4023] Revert "Make navigation menu serializable"

This reverts commit 072c98a8f302ebeb4458d4815f62d2b58aa71efb. Probably overengineering.
---
 .../Features/Navigation/NavigationMenu.php      |  6 +-----
 .../tests/Feature/NavigationAPITest.php         | 17 -----------------
 2 files changed, 1 insertion(+), 22 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 2c4d8d063f7..873ce83b4b6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -6,8 +6,6 @@
 
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
-use Hyde\Support\Concerns\Serializable;
-use Hyde\Support\Contracts\SerializableContract;
 use Illuminate\Contracts\Support\Arrayable;
 
 use function Hyde\evaluate_arrayable;
@@ -20,10 +18,8 @@
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
-class NavigationMenu implements SerializableContract
+class NavigationMenu implements Arrayable
 {
-    use Serializable;
-
     public const DEFAULT = 500;
     public const LAST = 999;
 
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 657110fda4d..54f4ab06f1f 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -33,23 +33,6 @@ public function testNavigationMenus()
             ['link' => 'about.html', 'label' => 'About'],
             ['link' => 'contact.html', 'label' => 'Contact'],
         ], $menu->toArray());
-
-        $this->assertSame(<<<JSON
-        [
-            {
-                "link": "index.html",
-                "label": "Home"
-            },
-            {
-                "link": "about.html",
-                "label": "About"
-            },
-            {
-                "link": "contact.html",
-                "label": "Contact"
-            }
-        ]
-        JSON, $menu->toJson(JSON_PRETTY_PRINT));
     }
 
     public function testNavigationMenusWithGroups()

From ecbe2fb05695eff5e39b5fbce661f9f83053d957 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:49:06 +0100
Subject: [PATCH 1423/4023] Simplify array data structure

---
 .../Framework/Features/Navigation/NavigationMenu.php |  6 ++----
 .../framework/tests/Feature/NavigationAPITest.php    | 12 ++++++------
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 873ce83b4b6..c4a2f1e5eb3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -77,15 +77,13 @@ public function toArray(): array
                 return [
                     'label' => $item->getLabel(),
                     'items' => array_map(fn (NavigationItem $item): array => [
-                        'link' => $item->getLink(),
-                        'label' => $item->getLabel(),
+                        $item->getLink() => $item->getLabel(),
                     ], $item->getItems()),
                 ];
             }
 
             return [
-                'link' => $item->getLink(),
-                'label' => $item->getLabel(),
+                $item->getLink() => $item->getLabel(),
             ];
         })->all();
     }
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 54f4ab06f1f..1325939c64d 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -29,9 +29,9 @@ public function testNavigationMenus()
         ]);
 
         $this->assertSame([
-            ['link' => 'index.html', 'label' => 'Home'],
-            ['link' => 'about.html', 'label' => 'About'],
-            ['link' => 'contact.html', 'label' => 'Contact'],
+            ['index.html' => 'Home'],
+            ['about.html' => 'About'],
+            ['contact.html' => 'Contact'],
         ], $menu->toArray());
     }
 
@@ -48,10 +48,10 @@ public function testNavigationMenusWithGroups()
         ]);
 
         $this->assertSame([
-            ['link' => 'index.html', 'label' => 'Home'],
+            ['index.html' => 'Home'],
             ['label' => 'About', 'items' => [
-                ['link' => 'about.html', 'label' => 'About Us'],
-                ['link' => 'contact.html', 'label' => 'Contact Us'],
+                ['about.html' => 'About Us'],
+                ['contact.html' => 'Contact Us'],
             ]],
         ], $menu->toArray());
     }

From cb08b9f4ccb91e746e1dae7b74ed7c7edd848af5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:52:45 +0100
Subject: [PATCH 1424/4023] Flatten array keys

---
 .../Features/Navigation/NavigationMenu.php    | 10 +++++-----
 .../tests/Feature/NavigationAPITest.php       | 19 +++++++++++--------
 2 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index c4a2f1e5eb3..c3425859737 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -72,14 +72,14 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      */
     public function toArray(): array
     {
-        return $this->getItems()->map(function (NavigationItem|NavigationGroup $item): array {
+        return $this->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item): array {
             if ($item instanceof NavigationGroup) {
-                return [
+                return [[
                     'label' => $item->getLabel(),
-                    'items' => array_map(fn (NavigationItem $item): array => [
+                    'items' => Arr::mapWithKeys($item->getItems(), fn (NavigationItem $item): array => [
                         $item->getLink() => $item->getLabel(),
-                    ], $item->getItems()),
-                ];
+                    ]),
+                ]];
             }
 
             return [
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 1325939c64d..a26363978f8 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -29,9 +29,9 @@ public function testNavigationMenus()
         ]);
 
         $this->assertSame([
-            ['index.html' => 'Home'],
-            ['about.html' => 'About'],
-            ['contact.html' => 'Contact'],
+            'index.html' => 'Home',
+            'about.html' => 'About',
+            'contact.html' => 'Contact',
         ], $menu->toArray());
     }
 
@@ -48,11 +48,14 @@ public function testNavigationMenusWithGroups()
         ]);
 
         $this->assertSame([
-            ['index.html' => 'Home'],
-            ['label' => 'About', 'items' => [
-                ['about.html' => 'About Us'],
-                ['contact.html' => 'Contact Us'],
-            ]],
+            'index.html' => 'Home',
+            [
+                'label' => 'About',
+                'items' => [
+                    'about.html' => 'About Us',
+                    'contact.html' => 'Contact Us',
+                ],
+            ],
         ], $menu->toArray());
     }
 }

From 151992d79b8552205cda2176812f5f0ce6022ae7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:55:52 +0100
Subject: [PATCH 1425/4023] Put labels first in array representation

Considering we use a label-first approach for filtering, we are placing the highest importance on the labels, so we should put them first. It also makes it more semantic that $label leads to a $link
---
 .../Features/Navigation/NavigationMenu.php        | 15 ++++++++-------
 .../framework/tests/Feature/NavigationAPITest.php | 15 +++++++--------
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index c3425859737..30892e915ce 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -74,16 +74,17 @@ public function toArray(): array
     {
         return $this->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item): array {
             if ($item instanceof NavigationGroup) {
-                return [[
-                    'label' => $item->getLabel(),
-                    'items' => Arr::mapWithKeys($item->getItems(), fn (NavigationItem $item): array => [
-                        $item->getLink() => $item->getLabel(),
-                    ]),
-                ]];
+                return [
+                    $item->getLabel() => [
+                        'items' => Arr::mapWithKeys($item->getItems(), fn (NavigationItem $item): array => [
+                            $item->getLabel() => $item->getLink(),
+                        ]),
+                    ]
+                ];
             }
 
             return [
-                $item->getLink() => $item->getLabel(),
+                $item->getLabel() => $item->getLink(),
             ];
         })->all();
     }
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index a26363978f8..390ce17c843 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -29,9 +29,9 @@ public function testNavigationMenus()
         ]);
 
         $this->assertSame([
-            'index.html' => 'Home',
-            'about.html' => 'About',
-            'contact.html' => 'Contact',
+            'Home' => 'index.html',
+            'About' => 'about.html',
+            'Contact' => 'contact.html',
         ], $menu->toArray());
     }
 
@@ -48,12 +48,11 @@ public function testNavigationMenusWithGroups()
         ]);
 
         $this->assertSame([
-            'index.html' => 'Home',
-            [
-                'label' => 'About',
+            'Home' => 'index.html',
+            'About' => [
                 'items' => [
-                    'about.html' => 'About Us',
-                    'contact.html' => 'Contact Us',
+                    'About Us' => 'about.html',
+                    'Contact Us' => 'contact.html',
                 ],
             ],
         ], $menu->toArray());

From 612df231cbc3d1ade7092a04b40e3785ea7183d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:57:47 +0100
Subject: [PATCH 1426/4023] Cleanup and normalize formatting

---
 .../Framework/Features/Navigation/NavigationMenu.php | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 30892e915ce..e76cf5e5b46 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -76,16 +76,14 @@ public function toArray(): array
             if ($item instanceof NavigationGroup) {
                 return [
                     $item->getLabel() => [
-                        'items' => Arr::mapWithKeys($item->getItems(), fn (NavigationItem $item): array => [
-                            $item->getLabel() => $item->getLink(),
-                        ]),
-                    ]
+                        'items' => Arr::mapWithKeys($item->getItems(), function (NavigationItem $item): array {
+                            return [$item->getLabel() => $item->getLink()];
+                        }),
+                    ],
                 ];
             }
 
-            return [
-                $item->getLabel() => $item->getLink(),
-            ];
+            return [$item->getLabel() => $item->getLink()];
         })->all();
     }
 

From 8a316b3e1000d00342f32bb6662e139e18242398 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 12:59:39 +0100
Subject: [PATCH 1427/4023] Update array generics for updated structure

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index e76cf5e5b46..35e90d30013 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -68,7 +68,7 @@ public function add(NavigationItem|NavigationGroup|array $items): static
      *
      * @experimental This method is experimental and may be changed before release.
      *
-     * @return array<int, array{link?: string, label: string, items?: array<int, array{link: string, label: string}>}>
+     * @return array<string, string|array{items: array<string, string>}>
      */
     public function toArray(): array
     {

From 3af4c3b18ff016963275b16079dc19059fe84acc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:29:04 +0100
Subject: [PATCH 1428/4023] Move experimental helper to test

Don't think we need this in the public API for now
---
 .../Features/Navigation/NavigationMenu.php    | 26 +------------------
 .../tests/Feature/NavigationAPITest.php       | 22 ++++++++++++++--
 2 files changed, 21 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 35e90d30013..7329b6bfbe9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -18,7 +18,7 @@
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
  */
-class NavigationMenu implements Arrayable
+class NavigationMenu
 {
     public const DEFAULT = 500;
     public const LAST = 999;
@@ -63,30 +63,6 @@ public function add(NavigationItem|NavigationGroup|array $items): static
         return $this;
     }
 
-    /**
-     * Get the navigation items in the menu as an array.
-     *
-     * @experimental This method is experimental and may be changed before release.
-     *
-     * @return array<string, string|array{items: array<string, string>}>
-     */
-    public function toArray(): array
-    {
-        return $this->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item): array {
-            if ($item instanceof NavigationGroup) {
-                return [
-                    $item->getLabel() => [
-                        'items' => Arr::mapWithKeys($item->getItems(), function (NavigationItem $item): array {
-                            return [$item->getLabel() => $item->getLink()];
-                        }),
-                    ],
-                ];
-            }
-
-            return [$item->getLabel() => $item->getLink()];
-        })->all();
-    }
-
     protected function addItem(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 390ce17c843..eb2545efaca 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Arr;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Testing\MocksKernelFeatures;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
@@ -32,7 +33,7 @@ public function testNavigationMenus()
             'Home' => 'index.html',
             'About' => 'about.html',
             'Contact' => 'contact.html',
-        ], $menu->toArray());
+        ], $this->toArray($menu));
     }
 
     public function testNavigationMenusWithGroups()
@@ -55,6 +56,23 @@ public function testNavigationMenusWithGroups()
                     'Contact Us' => 'contact.html',
                 ],
             ],
-        ], $menu->toArray());
+        ], $this->toArray($menu));
+    }
+
+    protected function toArray(NavigationMenu $menu): array
+    {
+        return $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item): array {
+            if ($item instanceof NavigationGroup) {
+                return [
+                    $item->getLabel() => [
+                        'items' => Arr::mapWithKeys($item->getItems(), function (NavigationItem $item): array {
+                            return [$item->getLabel() => $item->getLink()];
+                        }),
+                    ],
+                ];
+            }
+
+            return [$item->getLabel() => $item->getLink()];
+        })->all();
     }
 }

From 1332d658a2b8ec51bca60bb351cb1bdee94de18a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:33:29 +0100
Subject: [PATCH 1429/4023] Update test abstract

---
 packages/framework/tests/Feature/NavigationAPITest.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index eb2545efaca..379b4c970c6 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -13,7 +13,7 @@
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 
 /**
- * High level tests for the Navigation API.
+ * High level tests for the Navigation API to go along with the documentation.
  */
 class NavigationAPITest extends TestCase
 {
@@ -34,6 +34,13 @@ public function testNavigationMenus()
             'About' => 'about.html',
             'Contact' => 'contact.html',
         ], $this->toArray($menu));
+
+        foreach ($menu->getItems() as $item) {
+            $this->assertInstanceOf(NavigationItem::class, $item);
+
+            $this->assertIsString($item->getLabel());
+            $this->assertIsString($item->getLink());
+        }
     }
 
     public function testNavigationMenusWithGroups()

From 974a77d83a2ca6adfc944ca07e785199c3519945 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:47:28 +0100
Subject: [PATCH 1430/4023] Begin adding code driven documentation

---
 .../tests/Feature/NavigationAPITest.php       | 71 ++++++++++++++++++-
 1 file changed, 70 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 379b4c970c6..9458bff9e13 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Facades\Routes;
@@ -13,16 +14,82 @@
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 
 /**
- * High level tests for the Navigation API to go along with the documentation.
+ * High level tests for the Navigation API to go along with the code-driven documentation.
  */
 class NavigationAPITest extends TestCase
 {
     use MocksKernelFeatures;
 
+    public function testNavigationItems()
+    {
+        // Each navigation item is represented by a NavigationItem instance containing the needed information.
+
+        // ## Creating Navigation Items
+
+        // There are a few ways to create navigation items, depending on your needs.
+
+        // You can create instances directly by passing either a URL or Route instance to the constructor.
+        $item = new NavigationItem(Routes::get('index'), 'Home');
+        $this->assertInstanceOf(NavigationItem::class, $item);
+        $item = new NavigationItem('https://example.com', 'External Link');
+        $this->assertInstanceOf(NavigationItem::class, $item);
+
+        // You can also set the priority of the item, which determines its position in the menu.
+        $item = new NavigationItem(Routes::get('index'), 'Home', 25);
+        $this->assertSame(25, $item->getPriority());
+
+        // You can also create instances using the static create method, which can automatically fill in the label and priority from a Route.
+        $item = NavigationItem::create(Routes::get('index'));
+        $this->assertSame('Home', $item->getLabel());
+        $this->assertSame(0, $item->getPriority());
+
+        // You can also pass a custom label and priority to the create method to override the defaults.
+        $item = NavigationItem::create(Routes::get('index'), 'Custom Label', 50);
+        $this->assertSame('Custom Label', $item->getLabel());
+        $this->assertSame(50, $item->getPriority());
+
+        // The create method also works with route keys.
+        $item = NavigationItem::create('index');
+        $this->assertSame('Home', $item->getLabel());
+        $this->assertEquals(NavigationItem::create('index'), NavigationItem::create(Routes::get('index')));
+
+        // You can also pass a URL to the create method.
+        $item = NavigationItem::create('https://example.com');
+        $this->assertSame('https://example.com', $item->getLink());
+
+        // Unless you pass a custom label to URL items, the label will be the URL itself.
+        $item = NavigationItem::create('https://example.com');
+        $this->assertSame('https://example.com', $item->getLabel());
+
+        // ## Navigation Item Methods
+
+        // There are a few helper methods available on NavigationItem instances.
+        $item = NavigationItem::create('index'); // Documentation ignores this line.
+
+        // Get the label of the item.
+        $this->assertSame('Home', $item->getLabel());
+
+        // Get the link of the item.
+        $this->assertSame('index.html', $item->getLink());
+
+        // You can also get the link by casting the item to a string.
+        $this->assertSame('index.html', (string) $item);
+
+        // Get the priority of the item.
+        $this->assertSame(0, $item->getPriority());
+
+        // Get the underlying Page instance of the item, if it exists. If the item is not a routed page (like direct URLs), this will return null.
+        $this->assertInstanceOf(BladePage::class, $item->getPage());
+
+        // Check if the item is active (the current page being rendered).
+        $this->assertFalse($item->isActive());
+    }
+
     public function testNavigationMenus()
     {
         $this->withPages(['index', 'about', 'contact']);
 
+        // Navigation menus are created with an array of NavigationItem instances.
         $menu = new NavigationMenu([
             new NavigationItem(Routes::get('index'), 'Home'),
             new NavigationItem(Routes::get('about'), 'About'),
@@ -35,6 +102,7 @@ public function testNavigationMenus()
             'Contact' => 'contact.html',
         ], $this->toArray($menu));
 
+        // You can get the items in the menu, which are automatically sorted by their priority.
         foreach ($menu->getItems() as $item) {
             $this->assertInstanceOf(NavigationItem::class, $item);
 
@@ -47,6 +115,7 @@ public function testNavigationMenusWithGroups()
     {
         $this->withPages(['index', 'about', 'contact']);
 
+        // You can also add navigation groups to the menu, which can contain more items.
         $menu = new NavigationMenu([
             new NavigationItem(Routes::get('index'), 'Home'),
             new NavigationGroup('About', [

From 3d9e7125d3eec0b3e6347d0f9c3619945ae3ed1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:48:54 +0100
Subject: [PATCH 1431/4023] Create navigation-api.md

---
 docs/advanced-features/navigation-api.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 docs/advanced-features/navigation-api.md

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
new file mode 100644
index 00000000000..10dc1cfda42
--- /dev/null
+++ b/docs/advanced-features/navigation-api.md
@@ -0,0 +1,7 @@
+---
+navigation:
+    label: "Navigation API"
+---
+
+# Navigation API
+

From 45c62523b4c8e25a8662e284dcc89e967d43ccc4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:50:38 +0100
Subject: [PATCH 1432/4023] Add warning

---
 docs/advanced-features/navigation-api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 10dc1cfda42..4f7c75ef215 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -5,3 +5,4 @@ navigation:
 
 # Navigation API
 
+>warning This article covers advanced information that is only relevant if you want to create custom navigation menus. Instead, you may want to read the [Navigation](navigation) article for a general overview.

From d930787a739d0b3029325cc4aeb8d04b41d40818 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:51:47 +0100
Subject: [PATCH 1433/4023] Add abstract

---
 docs/advanced-features/navigation-api.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 4f7c75ef215..f71365d3c19 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -6,3 +6,8 @@ navigation:
 # Navigation API
 
 >warning This article covers advanced information that is only relevant if you want to create custom navigation menus. Instead, you may want to read the [Navigation](navigation) article for a general overview.
+
+## Abstract
+
+This article describes the Navigation API introduced in HydePHP v2. Both the main navigation menu and the documentation sidebar bundled with HydePHP are built with this API.
+However, if you are interested in creating your own custom navigation menus, you can also utilize this API - and this article will show you how.

From 356202467ff3cd05b1c23a2d3f7e625a4c936d2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 13:52:28 +0100
Subject: [PATCH 1434/4023] Document target reader

---
 docs/advanced-features/navigation-api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index f71365d3c19..a767173f3cb 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -11,3 +11,6 @@ navigation:
 
 This article describes the Navigation API introduced in HydePHP v2. Both the main navigation menu and the documentation sidebar bundled with HydePHP are built with this API.
 However, if you are interested in creating your own custom navigation menus, you can also utilize this API - and this article will show you how.
+
+This article is intended for advanced users, as most users will not need to create custom navigation menus.
+For this reason, the documentation is very code-driven due to the technical nature of the API.

From adb51bf58fdbae618f6ef34e9adabe8be7c98819 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 14:16:54 +0100
Subject: [PATCH 1435/4023] Document overview

---
 docs/advanced-features/navigation-api.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index a767173f3cb..ef54dc15746 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -14,3 +14,13 @@ However, if you are interested in creating your own custom navigation menus, you
 
 This article is intended for advanced users, as most users will not need to create custom navigation menus.
 For this reason, the documentation is very code-driven due to the technical nature of the API.
+
+## Overview
+
+The Navigation API consists of a set of classes within the `Hyde\Framework\Features\Navigation` namespace.
+
+Together, these form an object-oriented way to create and interact with navigation menus and their items.
+
+In short, a navigation menu is an instance of the `NavigationMenu` class. Each menu contains a collection of `NavigationItem` or `NavigationGroup` classes.
+The former represents a single item in the menu, while the latter represents a group of items.
+

From c6a5cbd2c5e452aef131a85f458b4b129a719380 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 14:17:05 +0100
Subject: [PATCH 1436/4023] Document visualisation

---
 docs/advanced-features/navigation-api.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index ef54dc15746..ca23fb81218 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -24,3 +24,22 @@ Together, these form an object-oriented way to create and interact with navigati
 In short, a navigation menu is an instance of the `NavigationMenu` class. Each menu contains a collection of `NavigationItem` or `NavigationGroup` classes.
 The former represents a single item in the menu, while the latter represents a group of items.
 
+### Visualisation
+
+Here is a visual representation of the structure of a navigation menu:
+
+```php
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationMenu {
+    protected Collection $items = [
+        new NavigationItem(destination: 'index.html', label: 'Home'),
+        new NavigationItem(destination: 'posts.html', label: 'Blog'),
+        new NavigationGroup(label: 'About', items: [
+            new NavigationItem(destination: 'about.html', label: 'About Us'),
+            new NavigationItem(destination: 'team.html', label: 'Our Team'),
+        ]),
+    ];
+}
+```
+

From 765c1df70cec9d0222049bad82debc05c9354b85 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 14:17:13 +0100
Subject: [PATCH 1437/4023] Document built in menus

---
 docs/advanced-features/navigation-api.md | 28 ++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index ca23fb81218..6799b4bb04b 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -43,3 +43,31 @@ class NavigationMenu {
 }
 ```
 
+### Built-in Menus
+
+HydePHP comes with two built-in menus: the main navigation menu and the documentation sidebar.
+
+These are bound into the service container as singletons and can be accessed through dependency injection.
+
+```php
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+
+/** @var \Hyde\Framework\Features\Navigation\MainNavigationMenu $menu */
+$menu = app('navigation.main')
+
+/** @var DocumentationSidebar $sidebar */
+$sidebar= app('navigation.sidebar')
+```
+
+You can also get them through the static `get` helpers on the menu classes themselves.
+
+```php
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+
+$menu = MainNavigationMenu::get();
+$sidebar = DocumentationSidebar::get();
+```
+
+>info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.) 

From e4e7b3a45f2dce7e845e257befb8ae58a0dc1cdc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 25 Mar 2024 14:17:50 +0100
Subject: [PATCH 1438/4023] Test service container menus

---
 .../tests/Feature/NavigationAPITest.php       | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 9458bff9e13..5446e192e02 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Arr;
@@ -12,6 +13,8 @@
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 
 /**
  * High level tests for the Navigation API to go along with the code-driven documentation.
@@ -20,6 +23,23 @@ class NavigationAPITest extends TestCase
 {
     use MocksKernelFeatures;
 
+    public function testServiceContainerMenus()
+    {
+        // The NavigationServiceProvider binds the main and sidebar navigation menus into the service container.
+
+        Hyde::boot();
+
+        // You can access the menus from the service container.
+
+        $this->assertInstanceOf(MainNavigationMenu::class, app('navigation.main'));
+        $this->assertInstanceOf(DocumentationSidebar::class, app('navigation.sidebar'));
+
+        // You can also use the facade to access the menus.
+
+        $this->assertSame(app('navigation.main'), MainNavigationMenu::get());
+        $this->assertSame(app('navigation.sidebar'), DocumentationSidebar::get());
+    }
+
     public function testNavigationItems()
     {
         // Each navigation item is represented by a NavigationItem instance containing the needed information.

From 77ca13070837f6294de253519d886129b8f2249c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 13:06:16 +0100
Subject: [PATCH 1439/4023] Improve section introduction

---
 docs/advanced-features/navigation-api.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 6799b4bb04b..397d6b466de 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -45,9 +45,8 @@ class NavigationMenu {
 
 ### Built-in Menus
 
-HydePHP comes with two built-in menus: the main navigation menu and the documentation sidebar.
-
-These are bound into the service container as singletons and can be accessed through dependency injection.
+HydePHP comes with two built-in menus: the main navigation menu and the documentation sidebar, both represented as child classes of the `NavigationMenu` class.
+They are bound into the service container as singletons and can be accessed through dependency injection.
 
 ```php
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;

From cffbdb694d71f9420daedb2cbccd141f6b1f6100 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 14:29:06 +0100
Subject: [PATCH 1440/4023] Create new custom menu section

---
 docs/advanced-features/navigation-api.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 397d6b466de..79bb7b9a736 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -70,3 +70,16 @@ $sidebar = DocumentationSidebar::get();
 ```
 
 >info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.) 
+
+## Creating Custom Menus
+
+### Overview
+
+When creating a custom menu, there are two ways to go about it:
+
+1. You can construct a NavigationMenu instance directly and add items to it. This works great for smaller menus that don't need any special logic, for example a footer menu or social media links.
+2. You can create a custom class that extends the NavigationMenu class. This is useful for larger menus that require more complex logic, or that you want to reuse in multiple places in your application or in a package.
+
+In both cases, the underlying API is the same, and you can use the helper methods and features provided by the APIs.
+
+In this section, you will first see some high level overviews of how the API can be used, then we'll dive in deeper and take a look at each class and method in detail.

From f567fcb0a64615eaaa3ae33373a5a022281849e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 14:44:04 +0100
Subject: [PATCH 1441/4023] Update heading

---
 docs/advanced-features/navigation-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 79bb7b9a736..65d39675759 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -73,7 +73,7 @@ $sidebar = DocumentationSidebar::get();
 
 ## Creating Custom Menus
 
-### Overview
+### Introduction Overview
 
 When creating a custom menu, there are two ways to go about it:
 

From 504373c08267e1eb0a4e9787dd96b1f85aa1c9eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 14:53:17 +0100
Subject: [PATCH 1442/4023] Begin adding high level example

---
 docs/advanced-features/navigation-api.md      | 27 +++++++++++++++++++
 .../tests/Feature/NavigationAPITest.php       | 15 +++++++++++
 2 files changed, 42 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 65d39675759..31421354ea0 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -83,3 +83,30 @@ When creating a custom menu, there are two ways to go about it:
 In both cases, the underlying API is the same, and you can use the helper methods and features provided by the APIs.
 
 In this section, you will first see some high level overviews of how the API can be used, then we'll dive in deeper and take a look at each class and method in detail.
+
+### High Level Example
+
+Here is a high level example of how you can create a custom menu, and how to actually utilize it into something useful: A menu with social media links for a site footer.
+
+#### Step 1: Create the Menu
+
+```php
+// To create our menu, we start by constructing a new NavigationMenu instance
+$menu = new NavigationMenu();
+
+// We can then add our social media links to the menu.
+// We do this by adding NavigationItem instances to the menu.
+$menu->add([
+    // The first parameter is the URL, and the second is the label.
+    NavigationItem::create('https://twitter.com/hydephp', 'Twitter'),
+    NavigationItem::create('https://github.com/hydephp', 'GitHub'),
+    NavigationItem::create('https://hydephp.com', 'Website'),
+]);
+```
+
+#### Tips:
+ 
+- You can use the `add` method to add single items or arrays of items. You can also pass an array of items directly to the menu constructor.
+- The navigation menu items is stored in a Laravel Collection, and is type safe to support both `NavigationItem` and `NavigationGroup` instances. 
+- You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
+- It's also possible to set an item's priority as the third parameter, but here we don't need it, as they default to the order they are added.
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 5446e192e02..5ddb5bc211a 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -155,6 +155,21 @@ public function testNavigationMenusWithGroups()
         ], $this->toArray($menu));
     }
 
+    public function testSocialMediaFooterLinkExample()
+    {
+        // To create our menu, we start by constructing a new NavigationMenu instance
+        $menu = new NavigationMenu();
+
+        // We can then add our social media links to the menu.
+        // We do this by adding NavigationItem instances to the menu.
+        $menu->add([
+            // The first parameter is the URL, and the second is the label.
+            NavigationItem::create('https://twitter.com/hydephp', 'Twitter'),
+            NavigationItem::create('https://github.com/hydephp', 'GitHub'),
+            NavigationItem::create('https://hydephp.com', 'Website'),
+        ]);
+    }
+
     protected function toArray(NavigationMenu $menu): array
     {
         return $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item): array {

From 89ae76f22fe2eccbbf60e63fb58e0939025efa39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 15:13:26 +0100
Subject: [PATCH 1443/4023] Add more complete documentation examples

---
 docs/advanced-features/navigation-api.md      | 45 ++++++++++++++++---
 .../tests/Feature/NavigationAPITest.php       | 35 +++++++++++++++
 2 files changed, 74 insertions(+), 6 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 31421354ea0..d1cc4e87ee2 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -86,16 +86,16 @@ In this section, you will first see some high level overviews of how the API can
 
 ### High Level Example
 
-Here is a high level example of how you can create a custom menu, and how to actually utilize it into something useful: A menu with social media links for a site footer.
+To illustrate how you can create a custom menu, let's make something useful: A footer menu with social media links.
 
 #### Step 1: Create the Menu
 
+To create our menu, we start by constructing a new NavigationMenu instance.
+We can then add our social media links as NavigationItem instances to the menu.
+
 ```php
-// To create our menu, we start by constructing a new NavigationMenu instance
 $menu = new NavigationMenu();
 
-// We can then add our social media links to the menu.
-// We do this by adding NavigationItem instances to the menu.
 $menu->add([
     // The first parameter is the URL, and the second is the label.
     NavigationItem::create('https://twitter.com/hydephp', 'Twitter'),
@@ -104,8 +104,41 @@ $menu->add([
 ]);
 ```
 
-#### Tips:
- 
+#### Step 2: Display the Menu
+
+We can now iterate over the menu items to render them in our footer.
+
+```blade
+<footer>
+    <ul>
+        @foreach ($menu->getItems() as $item)
+            <li><a href="{{ $item->getLink() }}">{{ $item->getLabel() }}</a></li>
+        @endforeach
+    </ul>
+</footer>
+```
+
+This will result in the following HTML:
+
+```html
+<footer>
+    <ul>
+        <li><a href="https://twitter.com/hydephp">Twitter</a></li>
+        <li><a href="https://github.com/hydephp">GitHub</a></li>
+        <li><a href="https://hydephp.com">Website</a></li>
+    </ul>
+</footer>
+```
+
+#### Next Steps & Tips
+
+Of course, this is an incredibly simplistic example to illustrate the core concepts.
+Where the Navigation API really shines is in more complex scenarios where you want to utilize things like
+HydePHP Routes to resolve dynamic relative urls, and to use features like groups, priorities, and active states helpers to check if a menu item is the current page being viewed.
+
+The object-oriented nature of the API also makes this perfect for package developers wanting to create dynamic and reusable navigation menus that even can be further extended and customized by the end user.
+
+Here are some general tips to keep in mind when working with the Navigation API:
 - You can use the `add` method to add single items or arrays of items. You can also pass an array of items directly to the menu constructor.
 - The navigation menu items is stored in a Laravel Collection, and is type safe to support both `NavigationItem` and `NavigationGroup` instances. 
 - You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 5ddb5bc211a..5bb966a87a3 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -10,6 +10,7 @@
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Testing\MocksKernelFeatures;
+use Illuminate\Support\Facades\Blade;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
@@ -168,6 +169,27 @@ public function testSocialMediaFooterLinkExample()
             NavigationItem::create('https://github.com/hydephp', 'GitHub'),
             NavigationItem::create('https://hydephp.com', 'Website'),
         ]);
+
+        $rendered = Blade::render(/** @lang Blade */ <<<'BLADE'
+        {{-- We can now iterate over the menu items to render them in our footer. --}}
+        <footer>
+            <ul>
+                @foreach ($menu->getItems() as $item)
+                    <li><a href="{{ $item->getLink() }}">{{ $item->getLabel() }}</a></li>
+                @endforeach
+            </ul>
+        </footer>
+        BLADE, ['menu' => $menu]);
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+        <footer>
+            <ul>
+                <li><a href="https://twitter.com/hydephp">Twitter</a></li>
+                <li><a href="https://github.com/hydephp">GitHub</a></li>
+                <li><a href="https://hydephp.com">Website</a></li>
+            </ul>
+        </footer>
+        HTML, $rendered);
     }
 
     protected function toArray(NavigationMenu $menu): array
@@ -186,4 +208,17 @@ protected function toArray(NavigationMenu $menu): array
             return [$item->getLabel() => $item->getLink()];
         })->all();
     }
+
+    protected function assertSameIgnoringIndentation(string $expected, string $actual): void
+    {
+        $this->assertSame(
+            $this->removeIndentation(trim($expected)),
+            $this->removeIndentation(trim($actual))
+        );
+    }
+
+    protected function removeIndentation(string $actual): string
+    {
+        return implode("\n", array_map('trim', explode("\n", $actual)));
+    }
 }

From cc055330f569db223e43e1ab043738281edac030 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 15:14:33 +0100
Subject: [PATCH 1444/4023] Update abstract

---
 docs/advanced-features/navigation-api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index d1cc4e87ee2..250137f1da1 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -14,6 +14,7 @@ However, if you are interested in creating your own custom navigation menus, you
 
 This article is intended for advanced users, as most users will not need to create custom navigation menus.
 For this reason, the documentation is very code-driven due to the technical nature of the API.
+We'll also be mixing in some practical examples of Blade and PHP code to illustrate how you can use the API in your own projects.
 
 ## Overview
 

From 0b9c84d2179397969466caf757e063a40e948ae7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 15:31:17 +0100
Subject: [PATCH 1445/4023] Update section to lead to the new documentation
 page

---
 docs/digging-deeper/navigation.md | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index b904b37bbbd..65bac03a553 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -326,14 +326,7 @@ use Hyde\Framework\Features\Navigation\DropdownNavigationItem;
 
 ## The Navigation API
 
-If you want to interact with the site navigation programmatically, you can do so through the new Navigation API.
-
+If you want to interact with the site navigation programmatically, or if you want to create complex custom, you can do so through the new Navigation API.
 For most cases you don't need this, as Hyde creates the navigation for you. But it can be useful for advanced users and package developers.
 
-### Overview
-
-The Navigation API consists of the following classes, allowing you to fluently interact with the navigation menus:
-
-```php
-use Hyde\Framework\Features\Navigation\NavigationMenu;
-```
+The Navigation API consists of a set of PHP classes, allowing you to fluently interact with the navigation menus. You can learn more about the API in the [Navigation API](navigation-api) documentation.

From d0e494890e10ff827dd1a221c31033ebb7d2d224 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 15:34:42 +0100
Subject: [PATCH 1446/4023] Set up documentation coverage

---
 packages/framework/tests/Feature/NavigationAPITest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 5bb966a87a3..26b444577ac 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -19,6 +19,14 @@
 
 /**
  * High level tests for the Navigation API to go along with the code-driven documentation.
+ *
+ * @see \Hyde\Framework\Features\Navigation\
+ *
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\NavigationItem
+ * @covers \Hyde\Framework\Features\Navigation\NavigationGroup
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  */
 class NavigationAPITest extends TestCase
 {

From 5d5b0df75f51cf56f407695f4df6b4388276b3b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 16:49:38 +0100
Subject: [PATCH 1447/4023] Begin class reference section

---
 docs/advanced-features/navigation-api.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 250137f1da1..9d5921bd426 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -144,3 +144,13 @@ Here are some general tips to keep in mind when working with the Navigation API:
 - The navigation menu items is stored in a Laravel Collection, and is type safe to support both `NavigationItem` and `NavigationGroup` instances. 
 - You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
 - It's also possible to set an item's priority as the third parameter, but here we don't need it, as they default to the order they are added.
+
+## Class Reference
+
+Below is a reference of the classes and methods available in the Navigation API.
+
+### NavigationMenu
+
+### NavigationItem
+
+### NavigationGroup

From babd111aa406460cff29f646165b02358197463f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:03:22 +0100
Subject: [PATCH 1448/4023] Add section introductions

---
 docs/advanced-features/navigation-api.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 9d5921bd426..9a17702d534 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -151,6 +151,12 @@ Below is a reference of the classes and methods available in the Navigation API.
 
 ### NavigationMenu
 
+The `NavigationMenu` class represents a navigation menu. It contains a collection of items, which can be either `NavigationItem` or `NavigationGroup` instances.
+
 ### NavigationItem
 
+The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link, label, and priority for ordering in the menu.
+
 ### NavigationGroup
+
+The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label and a collection of items. This class is often used to create submenus or dropdowns in a navigation menu.

From ad47c5acc5d18280f84f4fc3c619659095ae03a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:04:00 +0100
Subject: [PATCH 1449/4023] Clarifications and formatting

---
 docs/advanced-features/navigation-api.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 9a17702d534..9c0381e4852 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -155,8 +155,9 @@ The `NavigationMenu` class represents a navigation menu. It contains a collectio
 
 ### NavigationItem
 
-The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link, label, and priority for ordering in the menu.
+The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link or route, a label, and priority for ordering in the menu.
 
 ### NavigationGroup
 
-The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label and a collection of items. This class is often used to create submenus or dropdowns in a navigation menu.
+The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
+This class is often used to create submenus or dropdowns in a navigation menu.

From 9a2c03e17b30da566f239e391f2b414ce6fbb590 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:05:26 +0100
Subject: [PATCH 1450/4023] Lower heading groups

Might be less semantic, but will make formatting easier
---
 docs/advanced-features/navigation-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 9c0381e4852..8b85976d161 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -149,15 +149,15 @@ Here are some general tips to keep in mind when working with the Navigation API:
 
 Below is a reference of the classes and methods available in the Navigation API.
 
-### NavigationMenu
+## NavigationMenu
 
 The `NavigationMenu` class represents a navigation menu. It contains a collection of items, which can be either `NavigationItem` or `NavigationGroup` instances.
 
-### NavigationItem
+## NavigationItem
 
 The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link or route, a label, and priority for ordering in the menu.
 
-### NavigationGroup
+## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
 This class is often used to create submenus or dropdowns in a navigation menu.

From f7ae4e1aee514481422e0f7e58c6420fbda01ee7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:14:54 +0100
Subject: [PATCH 1451/4023] Start sketching out item docs

---
 docs/advanced-features/navigation-api.md | 112 +++++++++++++++++++++++
 1 file changed, 112 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 8b85976d161..6cdd2eb790e 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -157,6 +157,118 @@ The `NavigationMenu` class represents a navigation menu. It contains a collectio
 
 The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link or route, a label, and priority for ordering in the menu.
 
+Here is the constructor signature and a quick reference of the methods available on the `NavigationItem` class, and their types. Keep on reading to see more detailed examples and explanations.
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationItem;
+
+$item = new NavigationItem(Route|string $destination, string $label, int $priority = 500);
+
+$item->getLink():  string; // Returns the resolved link route or destination URL.
+$item->getLabel(): string; // Returns the label of the item.
+$item->isActive(): bool;   // Returns true if the item is the page being rendered.
+$item->getPriority(): int; // Returns the priority of the item.
+$item->getPage(): ?HydePage; // Returns the underlying Page instance, if there is one.
+```
+
+### Creating Navigation Items
+
+There are several ways to create navigation items using the `NavigationItem` class.
+
+#### Direct instantiation
+
+You can create instances directly by passing either a URL or a Route instance to the constructor. 
+
+The first parameter is the destination, the second is the label, and the third optional parameter is the priority.
+
+```php
+$item = new NavigationItem('index', 'Home');
+$item = new NavigationItem(Routes::get('index'), 'Home');
+$item = new NavigationItem('https://example.com', 'External Link');
+```
+
+#### Setting Priority
+
+You can set the priority of the item, which determines its position in the menu.
+
+```php
+$item = new NavigationItem(Routes::get('index'), 'Home', 25);
+```
+
+#### Static Creation Method
+
+You can use the static `create` method, which can automatically fill in the label and priority from a Route.
+
+```php
+$item = NavigationItem::create(Routes::get('index'));
+```
+
+You can also pass a custom label and priority to the `create` method to override the defaults.
+
+```php
+$item = NavigationItem::create(Routes::get('index'), 'Custom Label', 50);
+```
+
+#### Using Route Keys and URLs
+
+The `create` method works with route keys and URLs.
+
+```php
+$item = NavigationItem::create('index');
+$item = NavigationItem::create('https://example.com');
+```
+
+Unless you pass a custom label to URL items, the label will be the URL itself.
+
+```php
+$item = NavigationItem::create('https://example.com');
+```
+
+### Navigation Item Methods
+
+### Getting Label and Link
+
+```php
+$item = NavigationItem::create('index');
+
+// Get the label of the item.
+$item->getLabel(); // Returns 'Home'
+
+// Get the link of the item.
+$item->getLink(); // Returns 'index.html'
+```
+
+You can also get the link by casting the item to a string.
+
+```php
+(string) $item; // Returns 'index.html'
+```
+
+### Getting Priority
+
+```php
+$item->getPriority(); // Returns 0
+```
+
+### Getting Page Instance
+
+You can get the underlying Page instance of the item, if it exists.
+
+```php
+$item->getPage(); // Returns instance of BladePage or null
+```
+
+### Checking Active State
+
+You can check if the item is active (i.e., the current page being rendered).
+
+```php
+$item->isActive(); // Returns false
+```
+
+This concludes the documentation for the `NavigationItem` class.
+
+
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.

From 13b00bce285701eaad271500195af40427f4432c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:23:01 +0100
Subject: [PATCH 1452/4023] Remove PHPDocs from constructor

---
 .../src/Framework/Features/Navigation/NavigationItem.php   | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index dd4ab94709a..7b202c7c5ea 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -26,13 +26,6 @@ class NavigationItem implements Stringable
     protected string $label;
     protected int $priority;
 
-    /**
-     * Create a new navigation menu item with your own properties.
-     *
-     * @param  \Hyde\Support\Models\Route|string  $destination  Route instance, route key, or external URI.
-     * @param  string  $label  The label of the navigation item.
-     * @param  int  $priority  The priority to determine the order of the navigation item.
-     */
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT)
     {
         $this->destination = $destination;

From f8476918644d3244371b023d35f658c2fe479881 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:23:18 +0100
Subject: [PATCH 1453/4023] Remove outdated class documentation

---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 7b202c7c5ea..0d0a53347ff 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -14,11 +14,6 @@
 
 /**
  * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
- *
- * You have a few options to construct a navigation menu item:
- *   1. You can supply a Route directly and explicit properties to the constructor
- *   2. You can use NavigationItem::fromRoute() to use data from the route
- *   3. You can use NavigationItem::create() for an external or un-routed link
  */
 class NavigationItem implements Stringable
 {

From 4a36e293ae8be06626e3e5ad6ec5b3e7743145be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:25:55 +0100
Subject: [PATCH 1454/4023] Sort property constructors

---
 .../src/Framework/Features/Navigation/NavigationItem.php       | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 0d0a53347ff..1d116e42c90 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,10 +23,9 @@ class NavigationItem implements Stringable
 
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT)
     {
-        $this->destination = $destination;
-
         $this->label = $label;
         $this->priority = $priority;
+        $this->destination = $destination;
     }
 
     /**

From 3bcafebb468d446da53c8613e7bb64680418e2e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:32:22 +0100
Subject: [PATCH 1455/4023] Extract helper method

---
 .../Features/Navigation/NavigationItem.php    | 25 +++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 1d116e42c90..8953f007835 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -37,16 +37,7 @@ public function __construct(Route|string $destination, string $label, int $prior
      */
     public static function create(Route|string $destination, ?string $label = null, ?int $priority = null): static
     {
-        if (is_string($destination) && Routes::has($destination)) {
-            $destination = Routes::get($destination);
-        }
-
-        if ($destination instanceof Route) {
-            $label ??= $destination->getPage()->navigationMenuLabel();
-            $priority ??= $destination->getPage()->navigationMenuPriority();
-        }
-
-        return new static($destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT);
+        return new static(...self::make($destination, $label, $priority));
     }
 
     /**
@@ -96,4 +87,18 @@ public function isActive(): bool
     {
         return Hyde::currentRoute()?->getLink() === $this->getLink();
     }
+
+    protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null): array
+    {
+        if (is_string($destination) && Routes::has($destination)) {
+            $destination = Routes::get($destination);
+        }
+
+        if ($destination instanceof Route) {
+            $label ??= $destination->getPage()->navigationMenuLabel();
+            $priority ??= $destination->getPage()->navigationMenuPriority();
+        }
+
+        return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
+    }
 }

From 1b35793fdfa9b10e176b3bf54b4dc75212c7aeb1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 17:41:29 +0100
Subject: [PATCH 1456/4023] Update constructor to use the same logic as the
 static create method

---
 .../src/Framework/Features/Navigation/NavigationItem.php   | 4 +---
 packages/framework/tests/Unit/NavigationItemTest.php       | 7 ++++---
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 8953f007835..d3587644624 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,9 +23,7 @@ class NavigationItem implements Stringable
 
     public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT)
     {
-        $this->label = $label;
-        $this->priority = $priority;
-        $this->destination = $destination;
+        [$this->destination, $this->label, $this->priority] = self::make($destination, $label, $priority);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index cb45bd6c9a9..0d5acc1bb2e 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -51,11 +51,12 @@ public function testPassingRouteInstanceToConstructorUsesRouteInstance()
         $this->assertEquals($route, (new NavigationItem($route, 'Home'))->getPage()->getRoute());
     }
 
-    public function testPassingRouteKeyToConstructorUsesDestinationAsLink()
+    public function testPassingRouteKeyToConstructorUsesDestinationAsRoute()
     {
         $item = new NavigationItem('index', 'Home');
-        $this->assertNull($item->getPage());
-        $this->assertSame('index', $item->getLink());
+        $this->assertSame(Routes::get('index')->getPage(), $item->getPage());
+        $this->assertSame('index', $item->getPage()->getRouteKey());
+        $this->assertSame('index.html', $item->getLink());
     }
 
     public function testPassingUrlToConstructorSetsRouteToNull()

From b3c87c2a3a719ed9be82c407cb7b9fc7a735c464 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 18:14:08 +0100
Subject: [PATCH 1457/4023] Update and normalize class documentation and
 constructors

---
 .../Features/Navigation/NavigationItem.php    | 28 ++++++++++++++-----
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index d3587644624..786011c8420 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -13,7 +13,9 @@
 use function is_string;
 
 /**
- * Abstraction for a navigation menu item. Used by the MainNavigationMenu and DocumentationSidebar classes.
+ * Abstraction for a navigation menu item containing useful information like the destination, label, and priority.
+ *
+ * It is used by the MainNavigationMenu and DocumentationSidebar classes.
  */
 class NavigationItem implements Stringable
 {
@@ -21,7 +23,14 @@ class NavigationItem implements Stringable
     protected string $label;
     protected int $priority;
 
-    public function __construct(Route|string $destination, string $label, int $priority = NavigationMenu::DEFAULT)
+    /**
+     * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
+     *
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or an external URI.
+     * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
+     * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     */
+    public function __construct(Route|string $destination, ?string $label = null, ?int $priority = null)
     {
         [$this->destination, $this->label, $this->priority] = self::make($destination, $label, $priority);
     }
@@ -29,9 +38,9 @@ public function __construct(Route|string $destination, string $label, int $prior
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *
-     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or external URI.
-     * @param  string|null  $label  Leave blank to use the label of the route's corresponding page, if there is one tied to the route.
-     * @param  int|null  $priority  Leave blank to use the priority of the route's corresponding page, if there is one tied to the route.
+     * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or an external URI.
+     * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
+     * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
      */
     public static function create(Route|string $destination, ?string $label = null, ?int $priority = null): static
     {
@@ -39,7 +48,7 @@ public static function create(Route|string $destination, ?string $label = null,
     }
 
     /**
-     * Resolve a link to the navigation item.
+     * Resolve a link to the navigation item. See `getLink()` for more information.
      */
     public function __toString(): string
     {
@@ -47,7 +56,10 @@ public function __toString(): string
     }
 
     /**
-     * Resolve the destination link of the navigation item.
+     * Resolve the destination link of the navigation item. This can then be used in the `href` attribute of an anchor tag.
+     *
+     * If the destination is a Route, it will be resolved using the Route's link.
+     * Otherwise, it will be returned as is for external links using URLs.
      */
     public function getLink(): string
     {
@@ -88,11 +100,13 @@ public function isActive(): bool
 
     protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null): array
     {
+        // Automatically resolve the destination if it's a route key.
         if (is_string($destination) && Routes::has($destination)) {
             $destination = Routes::get($destination);
         }
 
         if ($destination instanceof Route) {
+            // Try to fill in missing properties from the route's connected page.
             $label ??= $destination->getPage()->navigationMenuLabel();
             $priority ??= $destination->getPage()->navigationMenuPriority();
         }

From 78ff7d2a7e7c84355be266a2ab16c6f99d90d848 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 18:16:55 +0100
Subject: [PATCH 1458/4023] Annotate array return generics

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 786011c8420..c7d01de2d15 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -98,6 +98,7 @@ public function isActive(): bool
         return Hyde::currentRoute()?->getLink() === $this->getLink();
     }
 
+    /** @return array{Route|string, string, int} */
     protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null): array
     {
         // Automatically resolve the destination if it's a route key.

From 26cd0bfff66ff2e8253b026f4961a95088926c70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 18:17:14 +0100
Subject: [PATCH 1459/4023] Use fully qualified class name in type annotation

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index c7d01de2d15..befda4b80e9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -98,7 +98,7 @@ public function isActive(): bool
         return Hyde::currentRoute()?->getLink() === $this->getLink();
     }
 
-    /** @return array{Route|string, string, int} */
+    /** @return array{\Hyde\Support\Models\Route|string, string, int} */
     protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null): array
     {
         // Automatically resolve the destination if it's a route key.

From 15b8b65890301b89024b216c18be1bdf2fffcb9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 18:22:46 +0100
Subject: [PATCH 1460/4023] Test construct with null label

---
 .../tests/Unit/NavigationItemTest.php         | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 0d5acc1bb2e..19f4f22f0c1 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -219,6 +219,26 @@ public function testCreateWithNullLabel()
         }
     }
 
+    public function testConstructWithNullLabel()
+    {
+        $this->assertSame('foo', (new NavigationItem('foo'))->getLabel());
+
+        $links = [
+            'www.example.com',
+            'https://example.com',
+            'https://example.com/',
+            'https://example.com/foo',
+            'https://example.com/foo/',
+            'https://example.com/foo/bar',
+            'https://example.com/foo/bar.html',
+            'https://example.com/foo/bar.png',
+        ];
+
+        foreach ($links as $link) {
+            $this->assertSame($link, (new NavigationItem($link))->getLabel());
+        }
+    }
+
     public function testPassingRouteKeyToStaticConstructorUsesRouteInstance()
     {
         $route = Routes::get('index');

From 377a2ba0f4ebdd046bdb42b4f441105833ff78b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:17:44 +0100
Subject: [PATCH 1461/4023] Create new documentation for simplified API

---
 docs/advanced-features/navigation-api.md      | 119 ++++--------------
 .../tests/Feature/NavigationAPITest.php       |  62 ++++-----
 2 files changed, 55 insertions(+), 126 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 6cdd2eb790e..7f6d3e0c008 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -155,120 +155,45 @@ The `NavigationMenu` class represents a navigation menu. It contains a collectio
 
 ## NavigationItem
 
-The `NavigationItem` class represents a single item in a navigation menu. It contains information such as the destination link or route, a label, and priority for ordering in the menu.
-
-Here is the constructor signature and a quick reference of the methods available on the `NavigationItem` class, and their types. Keep on reading to see more detailed examples and explanations.
-
-```php
-use Hyde\Framework\Features\Navigation\NavigationItem;
-
-$item = new NavigationItem(Route|string $destination, string $label, int $priority = 500);
-
-$item->getLink():  string; // Returns the resolved link route or destination URL.
-$item->getLabel(): string; // Returns the label of the item.
-$item->isActive(): bool;   // Returns true if the item is the page being rendered.
-$item->getPriority(): int; // Returns the priority of the item.
-$item->getPage(): ?HydePage; // Returns the underlying Page instance, if there is one.
-```
+The `NavigationItem` class is an abstraction for a navigation menu item containing useful information like the destination, label, and priority.
 
 ### Creating Navigation Items
 
-There are several ways to create navigation items using the `NavigationItem` class.
-
-#### Direct instantiation
-
-You can create instances directly by passing either a URL or a Route instance to the constructor. 
-
-The first parameter is the destination, the second is the label, and the third optional parameter is the priority.
-
-```php
-$item = new NavigationItem('index', 'Home');
-$item = new NavigationItem(Routes::get('index'), 'Home');
-$item = new NavigationItem('https://example.com', 'External Link');
-```
-
-#### Setting Priority
+There are two syntaxes for creating NavigationItem instances, you can use a standard constructor or the static create method.
+Both options provide the exact same signature and functionality, so it's just a matter of preference which one you use.
 
-You can set the priority of the item, which determines its position in the menu.
+The constructors take three parameters: the destination, the label, and the optional priority.
+The destination can be a `Route` instance, a route key string, or an external URL.
 
 ```php
-$item = new NavigationItem(Routes::get('index'), 'Home', 25);
-```
-
-#### Static Creation Method
-
-You can use the static `create` method, which can automatically fill in the label and priority from a Route.
-
-```php
-$item = NavigationItem::create(Routes::get('index'));
-```
-
-You can also pass a custom label and priority to the `create` method to override the defaults.
-
-```php
-$item = NavigationItem::create(Routes::get('index'), 'Custom Label', 50);
-```
-
-#### Using Route Keys and URLs
-
-The `create` method works with route keys and URLs.
-
-```php
-$item = NavigationItem::create('index');
-$item = NavigationItem::create('https://example.com');
-```
-
-Unless you pass a custom label to URL items, the label will be the URL itself.
-
-```php
-$item = NavigationItem::create('https://example.com');
-```
-
-### Navigation Item Methods
-
-### Getting Label and Link
-
-```php
-$item = NavigationItem::create('index');
-
-// Get the label of the item.
-$item->getLabel(); // Returns 'Home'
-
-// Get the link of the item.
-$item->getLink(); // Returns 'index.html'
-```
-
-You can also get the link by casting the item to a string.
+use Hyde\Framework\Features\Navigation\NavigationItem;
 
-```php
-(string) $item; // Returns 'index.html'
+$item = new NavigationItem($destination, $label, $priority);
+$item = NavigationItem::create($destination, $label, $priority);
 ```
 
-### Getting Priority
-
-```php
-$item->getPriority(); // Returns 0
-```
+#### Using Routes
 
-### Getting Page Instance
+Using the HydePHP routing system is the recommended way to create navigation items leading to pages within your project,
+as they will automatically have links resolved to the correct URL, and Hyde can check if the items are active.
+Additionally, Hyde will use the page data as the label and priority defaults unless you override them.
 
-You can get the underlying Page instance of the item, if it exists.
+Create routed navigation items by providing either a `Route` instance or a route key string as the destination.
 
 ```php
-$item->getPage(); // Returns instance of BladePage or null
-```
-
-### Checking Active State
+// Using a Route instance will automatically fill in the label and priority from the route's connected page.
+$item = new NavigationItem(Routes::get('index'));
+// ['destination' => 'index.html', 'label' => 'Home', 'priority' => 0]
 
-You can check if the item is active (i.e., the current page being rendered).
+// Using a route key provides the same functionality as using a Route instance.
+// Make sure the route exists otherwise it will be treated as a link.
+$item = new NavigationItem('index'); // Exactly the same as above, but without type safety.
 
-```php
-$item->isActive(); // Returns false
+// Setting the label and/or priorities will override the page's data.
+$item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
+// ['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10]
 ```
 
-This concludes the documentation for the `NavigationItem` class.
-
-
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 26b444577ac..31f866b3c43 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -51,44 +51,37 @@ public function testServiceContainerMenus()
 
     public function testNavigationItems()
     {
-        // Each navigation item is represented by a NavigationItem instance containing the needed information.
+        // The NavigationItem class is an abstraction for a navigation menu item containing useful information like the destination, label, and priority.
 
         // ## Creating Navigation Items
 
-        // There are a few ways to create navigation items, depending on your needs.
+        // There are two syntaxes for creating NavigationItem instances, you can use a standard constructor or the static create method.
+        // Both options provide the exact same signature and functionality, so it's just a matter of preference which one you use.
 
-        // You can create instances directly by passing either a URL or Route instance to the constructor.
-        $item = new NavigationItem(Routes::get('index'), 'Home');
-        $this->assertInstanceOf(NavigationItem::class, $item);
-        $item = new NavigationItem('https://example.com', 'External Link');
-        $this->assertInstanceOf(NavigationItem::class, $item);
+        // The constructors take three parameters: the destination, the label, and the optional priority.
+        // The destination can be a Route instance, a route key string, or an external URL.
 
-        // You can also set the priority of the item, which determines its position in the menu.
-        $item = new NavigationItem(Routes::get('index'), 'Home', 25);
-        $this->assertSame(25, $item->getPriority());
+        // Using a Route instance will automatically fill in the label and priority from the route's connected page.
+        $item = new NavigationItem(Routes::get('index'));
+        $this->assertData(['destination' => 'index.html', 'label' => 'Home', 'priority' => 0], $item);
 
-        // You can also create instances using the static create method, which can automatically fill in the label and priority from a Route.
-        $item = NavigationItem::create(Routes::get('index'));
-        $this->assertSame('Home', $item->getLabel());
-        $this->assertSame(0, $item->getPriority());
+        // Using a route key provides the same functionality as using a Route instance.
+        // Make sure the route exists otherwise it will be treated as a link.
+        $item = new NavigationItem('index');
+        $this->assertEquals(new NavigationItem(Routes::get('index')), $item);
 
-        // You can also pass a custom label and priority to the create method to override the defaults.
-        $item = NavigationItem::create(Routes::get('index'), 'Custom Label', 50);
-        $this->assertSame('Custom Label', $item->getLabel());
-        $this->assertSame(50, $item->getPriority());
-
-        // The create method also works with route keys.
-        $item = NavigationItem::create('index');
-        $this->assertSame('Home', $item->getLabel());
-        $this->assertEquals(NavigationItem::create('index'), NavigationItem::create(Routes::get('index')));
+        // Setting the label and/or priorities will override the page's data.
+        $item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
+        $this->assertData(['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10], $item);
 
-        // You can also pass a URL to the create method.
-        $item = NavigationItem::create('https://example.com');
-        $this->assertSame('https://example.com', $item->getLink());
+        // You can also pass an external URL as the destination.
+        $item = new NavigationItem('https://example.com', 'External Link', 10);
+        $this->assertData(['destination' => 'https://example.com', 'label' => 'External Link', 'priority' => 10], $item);
 
-        // Unless you pass a custom label to URL items, the label will be the URL itself.
-        $item = NavigationItem::create('https://example.com');
-        $this->assertSame('https://example.com', $item->getLabel());
+        // If you do not set a label for links, the label will default to the URL.
+        // And if uf you do not set a priority, it will default to 500.
+        $item = new NavigationItem('https://example.com');
+        $this->assertData(['destination' => 'https://example.com', 'label' => 'https://example.com', 'priority' => 500], $item);
 
         // ## Navigation Item Methods
 
@@ -229,4 +222,15 @@ protected function removeIndentation(string $actual): string
     {
         return implode("\n", array_map('trim', explode("\n", $actual)));
     }
+
+    protected function assertData(array $expected, NavigationItem $item): void
+    {
+        $actual = [
+            'destination' => $item->getLink(),
+            'label' => $item->getLabel(),
+            'priority' => $item->getPriority(),
+        ];
+
+        $this->assertSame($expected, $actual);
+    }
 }

From 2c11b05761a4d2b5c8ef252d402a26cdd0c8264a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:20:35 +0100
Subject: [PATCH 1462/4023] Swap order of examples

---
 docs/advanced-features/navigation-api.md            | 13 ++++++-------
 .../framework/tests/Feature/NavigationAPITest.php   |  8 ++++----
 2 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 7f6d3e0c008..fc6fe2aea61 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -182,16 +182,15 @@ Create routed navigation items by providing either a `Route` instance or a route
 
 ```php
 // Using a Route instance will automatically fill in the label and priority from the route's connected page.
-$item = new NavigationItem(Routes::get('index'));
-// ['destination' => 'index.html', 'label' => 'Home', 'priority' => 0]
-
-// Using a route key provides the same functionality as using a Route instance.
+// Using a route key provides the same functionality as using a Route instance, trading a bit of type safety for convenience.
 // Make sure the route exists otherwise it will be treated as a link.
-$item = new NavigationItem('index'); // Exactly the same as above, but without type safety.
+$item = new NavigationItem('index');
+
+//
+$item = new NavigationItem(Routes::get('index'));
 
 // Setting the label and/or priorities will override the page's data.
-$item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
-// ['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10]
+$item = new NavigationItem(Routes::get('index'), 'Custom Label', 100);
 ```
 
 ## NavigationGroup
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 31f866b3c43..191a9c2156e 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -61,15 +61,15 @@ public function testNavigationItems()
         // The constructors take three parameters: the destination, the label, and the optional priority.
         // The destination can be a Route instance, a route key string, or an external URL.
 
-        // Using a Route instance will automatically fill in the label and priority from the route's connected page.
-        $item = new NavigationItem(Routes::get('index'));
-        $this->assertData(['destination' => 'index.html', 'label' => 'Home', 'priority' => 0], $item);
-
         // Using a route key provides the same functionality as using a Route instance.
         // Make sure the route exists otherwise it will be treated as a link.
         $item = new NavigationItem('index');
         $this->assertEquals(new NavigationItem(Routes::get('index')), $item);
 
+        // Using a Route instance will automatically fill in the label and priority from the route's connected page.
+        $item = new NavigationItem(Routes::get('index'));
+        $this->assertData(['destination' => 'index.html', 'label' => 'Home', 'priority' => 0], $item);
+
         // Setting the label and/or priorities will override the page's data.
         $item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
         $this->assertData(['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10], $item);

From 26baea19a4ad60ab6b992dc0c881e3b2edf0864a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:20:38 +0100
Subject: [PATCH 1463/4023] Revert "Swap order of examples"

This reverts commit 2c11b05761a4d2b5c8ef252d402a26cdd0c8264a.
---
 docs/advanced-features/navigation-api.md            | 13 +++++++------
 .../framework/tests/Feature/NavigationAPITest.php   |  8 ++++----
 2 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index fc6fe2aea61..7f6d3e0c008 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -182,15 +182,16 @@ Create routed navigation items by providing either a `Route` instance or a route
 
 ```php
 // Using a Route instance will automatically fill in the label and priority from the route's connected page.
-// Using a route key provides the same functionality as using a Route instance, trading a bit of type safety for convenience.
-// Make sure the route exists otherwise it will be treated as a link.
-$item = new NavigationItem('index');
-
-//
 $item = new NavigationItem(Routes::get('index'));
+// ['destination' => 'index.html', 'label' => 'Home', 'priority' => 0]
+
+// Using a route key provides the same functionality as using a Route instance.
+// Make sure the route exists otherwise it will be treated as a link.
+$item = new NavigationItem('index'); // Exactly the same as above, but without type safety.
 
 // Setting the label and/or priorities will override the page's data.
-$item = new NavigationItem(Routes::get('index'), 'Custom Label', 100);
+$item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
+// ['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10]
 ```
 
 ## NavigationGroup
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 191a9c2156e..31f866b3c43 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -61,15 +61,15 @@ public function testNavigationItems()
         // The constructors take three parameters: the destination, the label, and the optional priority.
         // The destination can be a Route instance, a route key string, or an external URL.
 
+        // Using a Route instance will automatically fill in the label and priority from the route's connected page.
+        $item = new NavigationItem(Routes::get('index'));
+        $this->assertData(['destination' => 'index.html', 'label' => 'Home', 'priority' => 0], $item);
+
         // Using a route key provides the same functionality as using a Route instance.
         // Make sure the route exists otherwise it will be treated as a link.
         $item = new NavigationItem('index');
         $this->assertEquals(new NavigationItem(Routes::get('index')), $item);
 
-        // Using a Route instance will automatically fill in the label and priority from the route's connected page.
-        $item = new NavigationItem(Routes::get('index'));
-        $this->assertData(['destination' => 'index.html', 'label' => 'Home', 'priority' => 0], $item);
-
         // Setting the label and/or priorities will override the page's data.
         $item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
         $this->assertData(['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10], $item);

From 39ea38d5453683fe099ebdaa607d44c83faf1e0d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:24:14 +0100
Subject: [PATCH 1464/4023] Clean up examples

---
 docs/advanced-features/navigation-api.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 7f6d3e0c008..e7bcd67740c 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -178,22 +178,22 @@ Using the HydePHP routing system is the recommended way to create navigation ite
 as they will automatically have links resolved to the correct URL, and Hyde can check if the items are active.
 Additionally, Hyde will use the page data as the label and priority defaults unless you override them.
 
-Create routed navigation items by providing either a `Route` instance or a route key string as the destination.
+You can create routed navigation items by providing either a `Route` instance or a route key string as the destination.
 
 ```php
-// Using a Route instance will automatically fill in the label and priority from the route's connected page.
-$item = new NavigationItem(Routes::get('index'));
-// ['destination' => 'index.html', 'label' => 'Home', 'priority' => 0]
+// Using a route key string.
+$item = new NavigationItem('index');
 
-// Using a route key provides the same functionality as using a Route instance.
-// Make sure the route exists otherwise it will be treated as a link.
-$item = new NavigationItem('index'); // Exactly the same as above, but without type safety.
+// Using the Routes facade to get a Route instance.
+$item = new NavigationItem(Routes::get('index'));
 
-// Setting the label and/or priorities will override the page's data.
+// Setting the label and/or priorities will override inferred data.
 $item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
-// ['destination' => 'index.html', 'label' => 'Custom Label', 'priority' => 10]
 ```
 
+Using a route key is more concise, but will not provide type safety as it will be treated as a link if the route does not exist,
+whereas providing an invalid route key to the `Routes` facade will throw an exception. It's up to you which one you prefer.
+
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.

From 4df7c701848bf11c83b41b36a9400d610aeb6a6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:25:12 +0100
Subject: [PATCH 1465/4023] Fix typo in code comment

---
 packages/framework/tests/Feature/NavigationAPITest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 31f866b3c43..0f087bf8b82 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -79,7 +79,7 @@ public function testNavigationItems()
         $this->assertData(['destination' => 'https://example.com', 'label' => 'External Link', 'priority' => 10], $item);
 
         // If you do not set a label for links, the label will default to the URL.
-        // And if uf you do not set a priority, it will default to 500.
+        // And if you do not set a priority, it will default to 500.
         $item = new NavigationItem('https://example.com');
         $this->assertData(['destination' => 'https://example.com', 'label' => 'https://example.com', 'priority' => 500], $item);
 

From 0c29b9aedcf5837147e7888c8980058aae260272 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:30:58 +0100
Subject: [PATCH 1466/4023] Document using external URLs

---
 docs/advanced-features/navigation-api.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index e7bcd67740c..ac6137c51ea 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -194,6 +194,22 @@ $item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
 Using a route key is more concise, but will not provide type safety as it will be treated as a link if the route does not exist,
 whereas providing an invalid route key to the `Routes` facade will throw an exception. It's up to you which one you prefer.
 
+#### Using External URLs
+
+You can also create navigation items that link to external URLs by providing a full URL as the destination.
+
+If you do not set a label for links, the label will default to the URL, and if you do not set a priority, it will default to `500`.
+
+```php
+$item = new NavigationItem('https://example.com');
+$item = new NavigationItem('https://example.com', 'External Link', 10);
+```
+
+While it is discouraged to use external URLs for internal pages, as Hyde won't be able to resolve relative links or check active states,
+they are excellent for any time you want an absolute link to an external site or resource.
+
+Note that Hyde will not validate or modify the URL, so you are responsible for ensuring it's correct.
+
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.

From aea7e3aa3715bcf183a542c308616990d4c149a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:40:35 +0100
Subject: [PATCH 1467/4023] Document examples more

---
 docs/advanced-features/navigation-api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index ac6137c51ea..2893d6d2f6d 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -201,7 +201,10 @@ You can also create navigation items that link to external URLs by providing a f
 If you do not set a label for links, the label will default to the URL, and if you do not set a priority, it will default to `500`.
 
 ```php
+// This will lead directly to the link, and use it as the label with a priority of 500.
 $item = new NavigationItem('https://example.com');
+
+// You can also set a custom label and priority to override the defaults.
 $item = new NavigationItem('https://example.com', 'External Link', 10);
 ```
 

From 80b2b97f7b441a470339ecf3a2144e15a975c440 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:43:01 +0100
Subject: [PATCH 1468/4023] Test item sorting

---
 .../tests/Feature/NavigationAPITest.php       | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index 0f087bf8b82..ec5e9e7aa07 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -157,6 +157,37 @@ public function testNavigationMenusWithGroups()
         ], $this->toArray($menu));
     }
 
+    public function testItemSorting()
+    {
+        // Test items without priorities are returned in the order they were added.
+
+        $menu = new NavigationMenu([
+            new NavigationItem('foo', 'foo'),
+            new NavigationItem('bar', 'bar'),
+            new NavigationItem('baz', 'baz'),
+        ]);
+
+        $this->assertSame([
+            'foo' => 'foo',
+            'bar' => 'bar',
+            'baz' => 'baz',
+        ], $this->toArray($menu));
+
+        // Test items with priorities are sorted by priority.
+
+        $menu = new NavigationMenu([
+            new NavigationItem('foo', 'foo', 10),
+            new NavigationItem('bar', 'bar', 5),
+            new NavigationItem('baz', 'baz', 15),
+        ]);
+
+        $this->assertSame([
+            'bar' => 'bar',
+            'foo' => 'foo',
+            'baz' => 'baz',
+        ], $this->toArray($menu));
+    }
+
     public function testSocialMediaFooterLinkExample()
     {
         // To create our menu, we start by constructing a new NavigationMenu instance

From b542d4b15f9b498200b8e4801578fb8f24b69802 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:50:12 +0100
Subject: [PATCH 1469/4023] Style array key order

---
 packages/framework/tests/Feature/NavigationAPITest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index ec5e9e7aa07..b51483e03f1 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -177,8 +177,8 @@ public function testItemSorting()
 
         $menu = new NavigationMenu([
             new NavigationItem('foo', 'foo', 10),
-            new NavigationItem('bar', 'bar', 5),
             new NavigationItem('baz', 'baz', 15),
+            new NavigationItem('bar', 'bar', 5),
         ]);
 
         $this->assertSame([

From 790c975e7f725b56f8af6179ab11c2a94e44f6ac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 19:51:27 +0100
Subject: [PATCH 1470/4023] Clean up examples

---
 docs/advanced-features/navigation-api.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 2893d6d2f6d..941a0738808 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -182,13 +182,13 @@ You can create routed navigation items by providing either a `Route` instance or
 
 ```php
 // Using a route key string.
-$item = new NavigationItem('index');
+new NavigationItem('index');
 
 // Using the Routes facade to get a Route instance.
-$item = new NavigationItem(Routes::get('index'));
+new NavigationItem(Routes::get('index'));
 
 // Setting the label and/or priorities will override inferred data.
-$item = new NavigationItem(Routes::get('index'), 'Custom Label', 10);
+new NavigationItem(Routes::get('index'), 'Custom Label', 10);
 ```
 
 Using a route key is more concise, but will not provide type safety as it will be treated as a link if the route does not exist,
@@ -202,10 +202,10 @@ If you do not set a label for links, the label will default to the URL, and if y
 
 ```php
 // This will lead directly to the link, and use it as the label with a priority of 500.
-$item = new NavigationItem('https://example.com');
+new NavigationItem('https://example.com');
 
 // You can also set a custom label and priority to override the defaults.
-$item = new NavigationItem('https://example.com', 'External Link', 10);
+new NavigationItem('https://example.com', 'External Link', 10);
 ```
 
 While it is discouraged to use external URLs for internal pages, as Hyde won't be able to resolve relative links or check active states,

From 894425bb71ff1d21b268da7059b0fb26e6856cbd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:00:38 +0100
Subject: [PATCH 1471/4023] Style examples

---
 docs/advanced-features/navigation-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 941a0738808..087a0a970ae 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -188,7 +188,7 @@ new NavigationItem('index');
 new NavigationItem(Routes::get('index'));
 
 // Setting the label and/or priorities will override inferred data.
-new NavigationItem(Routes::get('index'), 'Custom Label', 10);
+new NavigationItem(Routes::get('index'), 'Custom Label', 25);
 ```
 
 Using a route key is more concise, but will not provide type safety as it will be treated as a link if the route does not exist,
@@ -205,7 +205,7 @@ If you do not set a label for links, the label will default to the URL, and if y
 new NavigationItem('https://example.com');
 
 // You can also set a custom label and priority to override the defaults.
-new NavigationItem('https://example.com', 'External Link', 10);
+new NavigationItem('https://example.com', 'External Link', 25);
 ```
 
 While it is discouraged to use external URLs for internal pages, as Hyde won't be able to resolve relative links or check active states,

From 57e660880041d98f627a9a59e79864682ae4ccf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:01:03 +0100
Subject: [PATCH 1472/4023] Format Markdown

---
 docs/advanced-features/navigation-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 087a0a970ae..c48a7bf968d 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -70,7 +70,7 @@ $menu = MainNavigationMenu::get();
 $sidebar = DocumentationSidebar::get();
 ```
 
->info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.) 
+>info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.)
 
 ## Creating Custom Menus
 
@@ -141,7 +141,7 @@ The object-oriented nature of the API also makes this perfect for package develo
 
 Here are some general tips to keep in mind when working with the Navigation API:
 - You can use the `add` method to add single items or arrays of items. You can also pass an array of items directly to the menu constructor.
-- The navigation menu items is stored in a Laravel Collection, and is type safe to support both `NavigationItem` and `NavigationGroup` instances. 
+- The navigation menu items is stored in a Laravel Collection, and is type safe to support both `NavigationItem` and `NavigationGroup` instances.
 - You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
 - It's also possible to set an item's priority as the third parameter, but here we don't need it, as they default to the order they are added.
 

From 49f5b1f96a742f265721960a786d7343ed87c147 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:02:01 +0100
Subject: [PATCH 1473/4023] Normalize Markdown

---
 docs/advanced-features/navigation-api.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index c48a7bf968d..ff0d504393a 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -7,6 +7,7 @@ navigation:
 
 >warning This article covers advanced information that is only relevant if you want to create custom navigation menus. Instead, you may want to read the [Navigation](navigation) article for a general overview.
 
+
 ## Abstract
 
 This article describes the Navigation API introduced in HydePHP v2. Both the main navigation menu and the documentation sidebar bundled with HydePHP are built with this API.
@@ -16,6 +17,7 @@ This article is intended for advanced users, as most users will not need to crea
 For this reason, the documentation is very code-driven due to the technical nature of the API.
 We'll also be mixing in some practical examples of Blade and PHP code to illustrate how you can use the API in your own projects.
 
+
 ## Overview
 
 The Navigation API consists of a set of classes within the `Hyde\Framework\Features\Navigation` namespace.
@@ -72,6 +74,7 @@ $sidebar = DocumentationSidebar::get();
 
 >info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.)
 
+
 ## Creating Custom Menus
 
 ### Introduction Overview
@@ -145,14 +148,17 @@ Here are some general tips to keep in mind when working with the Navigation API:
 - You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
 - It's also possible to set an item's priority as the third parameter, but here we don't need it, as they default to the order they are added.
 
+
 ## Class Reference
 
 Below is a reference of the classes and methods available in the Navigation API.
 
+
 ## NavigationMenu
 
 The `NavigationMenu` class represents a navigation menu. It contains a collection of items, which can be either `NavigationItem` or `NavigationGroup` instances.
 
+
 ## NavigationItem
 
 The `NavigationItem` class is an abstraction for a navigation menu item containing useful information like the destination, label, and priority.
@@ -213,6 +219,7 @@ they are excellent for any time you want an absolute link to an external site or
 
 Note that Hyde will not validate or modify the URL, so you are responsible for ensuring it's correct.
 
+
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.

From 36eba078d710ebbfd23ec85de9e0a94e18a6e564 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:31:14 +0100
Subject: [PATCH 1474/4023] Add quick references

---
 docs/advanced-features/navigation-api.md | 31 ++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index ff0d504393a..af7be74fa05 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -163,6 +163,37 @@ The `NavigationMenu` class represents a navigation menu. It contains a collectio
 
 The `NavigationItem` class is an abstraction for a navigation menu item containing useful information like the destination, label, and priority.
 
+### Quick Reference
+
+Here is a quick reference of the methods available on the NavigationItem class:
+
+```php
+// Create a new NavigationItem instance.
+$item = NavigationItem::create($destination, $label, $priority): NavigationItem;
+
+// Get the link of the item.
+$item->getLink(): string;
+
+// Get the label of the item.
+$item->getLabel(): string;
+
+// Get the priority of the item.
+$item->getPriority(): int;
+
+// Check if the item is active. (Only works when the destination is a route)
+$item->isActive(): bool; 
+```
+
+### Blade Example
+
+Here is an example of how you can put it all together in a Blade template:
+
+```blade
+<a href="{{ $item->getLink() }}" @class(['active' => $item->isActive()])>
+    {{ $item->getLabel() }}
+</a>
+```
+
 ### Creating Navigation Items
 
 There are two syntaxes for creating NavigationItem instances, you can use a standard constructor or the static create method.

From a5b3e86ab2858a9e65d104b5151dd04f2b37b243 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:32:24 +0100
Subject: [PATCH 1475/4023] Add example context

---
 docs/advanced-features/navigation-api.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index af7be74fa05..db274feafbe 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -194,6 +194,8 @@ Here is an example of how you can put it all together in a Blade template:
 </a>
 ```
 
+This will output an anchor tag with the correct link and label, and if the item is active, it will add an `active` class to the tag.
+
 ### Creating Navigation Items
 
 There are two syntaxes for creating NavigationItem instances, you can use a standard constructor or the static create method.

From 7204ba9e67848db59abb8d1c36400326e280fba8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 26 Mar 2024 20:33:22 +0100
Subject: [PATCH 1476/4023] Format method documentation

---
 .../src/Framework/Features/Navigation/NavigationItem.php      | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index befda4b80e9..43d2cf5312b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -56,7 +56,9 @@ public function __toString(): string
     }
 
     /**
-     * Resolve the destination link of the navigation item. This can then be used in the `href` attribute of an anchor tag.
+     * Resolve the destination link of the navigation item.
+     *
+     * This can then be used in the `href` attribute of an anchor tag.
      *
      * If the destination is a Route, it will be resolved using the Route's link.
      * Otherwise, it will be returned as is for external links using URLs.

From c9824a9844f8e97c2215402e80d7c388219a510b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 10:45:48 +0100
Subject: [PATCH 1477/4023] Add method documentation

---
 docs/advanced-features/navigation-api.md | 48 ++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index db274feafbe..0e269e9ae07 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -252,6 +252,54 @@ they are excellent for any time you want an absolute link to an external site or
 
 Note that Hyde will not validate or modify the URL, so you are responsible for ensuring it's correct.
 
+### Method Reference
+
+#### Accessing the resolved links `getLink`
+
+The `getLink` method is designed to return a link that can be used in the `href` attribute of an anchor tag.
+
+If the destination is a route, the link will be resolved to the correct URL, using relative paths if possible. It will also respect the pretty URL setting.
+
+```php
+$item = new NavigationItem(Routes::get('index'));
+$item->getLink(); // Outputs 'index.html' 
+
+$item = new NavigationItem('https://example.com');
+$item->getLink(); // Outputs 'https://example.com'
+```
+
+**Tip:** The item instances automatically turns into the resolved link when cast to a string. Perfect for your Blade templates!
+
+```blade
+<a href="{{ $item }}">{{ $item->getLabel() }}</a>
+```
+
+#### Accessing the label `getLabel`
+
+The `getLabel` method returns the label of the item. This is the text that will be displayed in the navigation menu.
+
+```php
+$item = new NavigationItem('index', 'Home');
+$item->getLabel(); // Outputs 'Home'
+```
+
+#### Accessing the priority `getPriority`
+
+The `getPriority` method returns the priority of the item. This is a number that determines the order in which the items are displayed in the menu, where lower numbers come first.
+
+```php
+$item = new NavigationItem('index', 'Home', 25);
+$item->getPriority(); // Outputs 25
+```
+
+#### Checking if the item is active `isActive`
+
+The `isActive` method checks if the item is active (by comparing it to the Hyde page being compiled at the moment). This is useful for highlighting the current page in the navigation menu.
+
+```php
+$item = new NavigationItem('index');
+$item->isActive(); // Outputs true if the item is the current page, otherwise false.
+```
 
 ## NavigationGroup
 

From cbd584976473c0926162f6a334774ee3aa9980c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 10:46:47 +0100
Subject: [PATCH 1478/4023] Add commented Copilot idea

---
 docs/advanced-features/navigation-api.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 0e269e9ae07..f7a2079e4af 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -301,6 +301,27 @@ $item = new NavigationItem('index');
 $item->isActive(); // Outputs true if the item is the current page, otherwise false.
 ```
 
+<!--
+
+Generated by Copilot, kinda cool, maybe something to implement?
+
+### Advanced Usage
+
+#### Customizing the Active State
+
+By default, the `isActive` method will check if the item's destination matches the current page being compiled.
+
+However, you can also provide a custom callback to the method to determine if the item is active.
+
+```php
+$item = new NavigationItem('index');
+$item->isActive(fn($item) => $item->getLink() === 'index.html');
+```
+
+This is useful if you want to check for a specific query parameter, or if you want to check if the item is active based on a more complex condition.
+-->
+
+
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.

From 44cb27192b113a5de5a3aadfe9adca4b69d4d8d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 10:46:54 +0100
Subject: [PATCH 1479/4023] Formatting

---
 docs/advanced-features/navigation-api.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index f7a2079e4af..48b4e4a6ae1 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -302,7 +302,6 @@ $item->isActive(); // Outputs true if the item is the current page, otherwise fa
 ```
 
 <!--
-
 Generated by Copilot, kinda cool, maybe something to implement?
 
 ### Advanced Usage

From 0191d4493837c6b2c9f379c3b08229551706d278 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:08:37 +0100
Subject: [PATCH 1480/4023] Document alternate syntax

---
 docs/advanced-features/navigation-api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 48b4e4a6ae1..68b6dac9615 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -170,6 +170,7 @@ Here is a quick reference of the methods available on the NavigationItem class:
 ```php
 // Create a new NavigationItem instance.
 $item = NavigationItem::create($destination, $label, $priority): NavigationItem;
+$item = new NavigationItem($destination, $label, $priority); // Same as above.
 
 // Get the link of the item.
 $item->getLink(): string;

From 7149976af24ff3c17d1f1aa3c7305ecf35548e77 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:12:51 +0100
Subject: [PATCH 1481/4023] Document import

---
 docs/advanced-features/navigation-api.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 68b6dac9615..0a6c12eae1d 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -168,6 +168,8 @@ The `NavigationItem` class is an abstraction for a navigation menu item containi
 Here is a quick reference of the methods available on the NavigationItem class:
 
 ```php
+use Hyde\Framework\Features\Navigation\NavigationItem;
+
 // Create a new NavigationItem instance.
 $item = NavigationItem::create($destination, $label, $priority): NavigationItem;
 $item = new NavigationItem($destination, $label, $priority); // Same as above.

From 892b89083f68a7174488d26b8e12ab3dfbaf376e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:12:57 +0100
Subject: [PATCH 1482/4023] Document setup

---
 docs/advanced-features/navigation-api.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 0a6c12eae1d..f93970d7186 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -192,6 +192,10 @@ $item->isActive(): bool;
 Here is an example of how you can put it all together in a Blade template:
 
 ```blade
+@php
+    $item = new NavigationItem('index.html', 'Home');
+@endphp
+
 <a href="{{ $item->getLink() }}" @class(['active' => $item->isActive()])>
     {{ $item->getLabel() }}
 </a>

From 3948eb8a63d32fd6cc3c3ce374454143d929b4ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:17:31 +0100
Subject: [PATCH 1483/4023] Add initial menu documentation

---
 docs/advanced-features/navigation-api.md | 80 ++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index f93970d7186..a91eb14784c 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -158,6 +158,86 @@ Below is a reference of the classes and methods available in the Navigation API.
 
 The `NavigationMenu` class represents a navigation menu. It contains a collection of items, which can be either `NavigationItem` or `NavigationGroup` instances.
 
+### Quick Reference
+
+Here is a quick reference of the methods available on the NavigationMenu class:
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+
+// Create a new NavigationMenu instance, optionally providing an array of items.
+$menu = new NavigationMenu($items = []);
+
+// Add a single item or an array of items to the menu.
+$menu->add(new NavigationItem()): $this;
+$menu->add([new NavigationItem()]): $this;
+
+// Get all items in the menu as a sorted Collection.
+$menu->getItems(): Collection;
+```
+
+### Blade Example
+
+Here is an example of how you can put it all together in a Blade template:
+
+```blade
+@php
+    $menu = new NavigationMenu([
+        new NavigationItem('index.html', 'Home'),
+        new NavigationItem('posts.html', 'Blog'),
+    ]);
+@endphp
+
+<ul>
+    @foreach ($menu->getItems() as $item)
+        <li><a href="{{ $item->getLink() }}">{{ $item->getLabel() }}</a></li>
+    @endforeach
+</ul>
+```
+
+This will output an unordered list with the correct links and labels for each item in the menu.
+
+### Creating Navigation Menus
+
+You can create a new NavigationMenu instance by calling the constructor and optionally providing an array or Collection of NavigationItem and/or NavigationGroup instances.
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
+
+$menu = new NavigationMenu([
+    new NavigationItem('index.html', 'Home'),
+    new NavigationItem('posts.html', 'Blog'),
+    new NavigationGroup('About', [
+        new NavigationItem('about.html', 'About Us'),
+        new NavigationItem('team.html', 'Our Team'),
+    ]),
+]);
+```
+
+### Adding Items to the Menu
+
+You can also add items to the menu after it has been created by using the `add` method.
+
+The `add` method can take a single item or an array of items, and will return the menu instance to allow for method chaining.
+
+```php
+$menu->add([
+    new NavigationItem('privacy.html', 'Privacy Policy'),
+    new NavigationItem('terms.html', 'Terms of Service'),
+])->add(new NavigationItem('contact.html', 'Contact Us'));
+```
+
+### Accessing Items in the Menu
+
+You can access all items in the menu by calling the `getItems` method, which will return a Collection of all items in the menu.
+
+```php
+$items = $menu->getItems();
+```
+
+The items will automatically be sorted by their priority, with lower numbers coming first, defaulting go the order they were added if no priority is set.
 
 ## NavigationItem
 

From a822c42e8d2b2f44a4c9dcee40df013a0bf39e97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:17:47 +0100
Subject: [PATCH 1484/4023] Revert "Document setup"

This reverts commit 892b89083f68a7174488d26b8e12ab3dfbaf376e.
---
 docs/advanced-features/navigation-api.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index a91eb14784c..84a8427a575 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -272,10 +272,6 @@ $item->isActive(): bool;
 Here is an example of how you can put it all together in a Blade template:
 
 ```blade
-@php
-    $item = new NavigationItem('index.html', 'Home');
-@endphp
-
 <a href="{{ $item->getLink() }}" @class(['active' => $item->isActive()])>
     {{ $item->getLabel() }}
 </a>

From 13cb289869794a79788df06b2981aa3347cb8f30 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:21:45 +0100
Subject: [PATCH 1485/4023] Clean up documentation

---
 docs/advanced-features/navigation-api.md | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 84a8427a575..4b194e5f624 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -169,11 +169,11 @@ use Hyde\Framework\Features\Navigation\NavigationMenu;
 $menu = new NavigationMenu($items = []);
 
 // Add a single item or an array of items to the menu.
-$menu->add(new NavigationItem()): $this;
-$menu->add([new NavigationItem()]): $this;
+$menu->add(new NavigationItem());
+$menu->add([new NavigationItem()]);
 
 // Get all items in the menu as a sorted Collection.
-$menu->getItems(): Collection;
+$menu->getItems(): Collection<NavigationItem|NavigationGroup>
 ```
 
 ### Blade Example
@@ -181,13 +181,6 @@ $menu->getItems(): Collection;
 Here is an example of how you can put it all together in a Blade template:
 
 ```blade
-@php
-    $menu = new NavigationMenu([
-        new NavigationItem('index.html', 'Home'),
-        new NavigationItem('posts.html', 'Blog'),
-    ]);
-@endphp
-
 <ul>
     @foreach ($menu->getItems() as $item)
         <li><a href="{{ $item->getLink() }}">{{ $item->getLabel() }}</a></li>

From 8a5ceb34908db31be9b1b704b43d0dc8dac6b4c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:21:50 +0100
Subject: [PATCH 1486/4023] Remove redundant example

---
 docs/advanced-features/navigation-api.md | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 4b194e5f624..713413617cf 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -176,20 +176,6 @@ $menu->add([new NavigationItem()]);
 $menu->getItems(): Collection<NavigationItem|NavigationGroup>
 ```
 
-### Blade Example
-
-Here is an example of how you can put it all together in a Blade template:
-
-```blade
-<ul>
-    @foreach ($menu->getItems() as $item)
-        <li><a href="{{ $item->getLink() }}">{{ $item->getLabel() }}</a></li>
-    @endforeach
-</ul>
-```
-
-This will output an unordered list with the correct links and labels for each item in the menu.
-
 ### Creating Navigation Menus
 
 You can create a new NavigationMenu instance by calling the constructor and optionally providing an array or Collection of NavigationItem and/or NavigationGroup instances.

From f46b2de2b992b648280f97bdd4641070693058ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:26:46 +0100
Subject: [PATCH 1487/4023] Split out examples

---
 docs/advanced-features/navigation-api.md | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 713413617cf..e2b824226c6 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -178,7 +178,15 @@ $menu->getItems(): Collection<NavigationItem|NavigationGroup>
 
 ### Creating Navigation Menus
 
-You can create a new NavigationMenu instance by calling the constructor and optionally providing an array or Collection of NavigationItem and/or NavigationGroup instances.
+You can create a new NavigationMenu instance by simply calling the constructor, optionally providing an array of items.
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+
+$menu = new NavigationMenu($items = []);
+```
+
+Here is how to provide an array or Collection of NavigationItem and/or NavigationGroup instances directly to the constructor.
 
 ```php
 use Hyde\Framework\Features\Navigation\NavigationMenu;
@@ -202,10 +210,12 @@ You can also add items to the menu after it has been created by using the `add`
 The `add` method can take a single item or an array of items, and will return the menu instance to allow for method chaining.
 
 ```php
-$menu->add([
-    new NavigationItem('privacy.html', 'Privacy Policy'),
-    new NavigationItem('terms.html', 'Terms of Service'),
-])->add(new NavigationItem('contact.html', 'Contact Us'));
+$menu = (new NavigationMenu())
+    ->add(new NavigationItem('contact.html', 'Contact Us'))
+    ->add([
+        new NavigationItem('privacy.html', 'Privacy Policy'),
+        new NavigationItem('terms.html', 'Terms of Service'),
+    ]);
 ```
 
 ### Accessing Items in the Menu

From 619d7ee0c5bc77d9645cd278d2f9141851cc5990 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:47:22 +0100
Subject: [PATCH 1488/4023] Merge lines

---
 docs/advanced-features/navigation-api.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index e2b824226c6..81dbc8f1f33 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -205,9 +205,7 @@ $menu = new NavigationMenu([
 
 ### Adding Items to the Menu
 
-You can also add items to the menu after it has been created by using the `add` method.
-
-The `add` method can take a single item or an array of items, and will return the menu instance to allow for method chaining.
+You can also add items to the menu after it has been created by using the `add` method which can take a single item or an array of items, and can be fluently chained.
 
 ```php
 $menu = (new NavigationMenu())

From d696a1b40764fe363b3931a356a6cdf39a2f7197 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:50:35 +0100
Subject: [PATCH 1489/4023] Clean up heading levels

---
 docs/advanced-features/navigation-api.md | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 81dbc8f1f33..44b7c3bee24 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -322,9 +322,7 @@ they are excellent for any time you want an absolute link to an external site or
 
 Note that Hyde will not validate or modify the URL, so you are responsible for ensuring it's correct.
 
-### Method Reference
-
-#### Accessing the resolved links `getLink`
+### Accessing the resolved links
 
 The `getLink` method is designed to return a link that can be used in the `href` attribute of an anchor tag.
 
@@ -344,7 +342,7 @@ $item->getLink(); // Outputs 'https://example.com'
 <a href="{{ $item }}">{{ $item->getLabel() }}</a>
 ```
 
-#### Accessing the label `getLabel`
+### Accessing the label
 
 The `getLabel` method returns the label of the item. This is the text that will be displayed in the navigation menu.
 
@@ -353,7 +351,7 @@ $item = new NavigationItem('index', 'Home');
 $item->getLabel(); // Outputs 'Home'
 ```
 
-#### Accessing the priority `getPriority`
+### Accessing the priority
 
 The `getPriority` method returns the priority of the item. This is a number that determines the order in which the items are displayed in the menu, where lower numbers come first.
 
@@ -362,7 +360,7 @@ $item = new NavigationItem('index', 'Home', 25);
 $item->getPriority(); // Outputs 25
 ```
 
-#### Checking if the item is active `isActive`
+### Checking if the item is active
 
 The `isActive` method checks if the item is active (by comparing it to the Hyde page being compiled at the moment). This is useful for highlighting the current page in the navigation menu.
 

From 6021f7b1c61010a79fa51778a671d7983f0fbe81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:58:54 +0100
Subject: [PATCH 1490/4023] Fix typo

---
 docs/advanced-features/navigation-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 44b7c3bee24..d7b24103a56 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -224,7 +224,7 @@ You can access all items in the menu by calling the `getItems` method, which wil
 $items = $menu->getItems();
 ```
 
-The items will automatically be sorted by their priority, with lower numbers coming first, defaulting go the order they were added if no priority is set.
+The items will automatically be sorted by their priority, with lower numbers coming first, defaulting to the order they were added if no priority is set.
 
 ## NavigationItem
 

From 83b1fbc008ab021493c40ef822248c522a2b0273 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 11:59:51 +0100
Subject: [PATCH 1491/4023] Format class names

---
 docs/advanced-features/navigation-api.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index d7b24103a56..b3aedd5f7f4 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -186,7 +186,7 @@ use Hyde\Framework\Features\Navigation\NavigationMenu;
 $menu = new NavigationMenu($items = []);
 ```
 
-Here is how to provide an array or Collection of NavigationItem and/or NavigationGroup instances directly to the constructor.
+Here is how to provide an array or Collection of `NavigationItem` and/or `NavigationGroup` instances directly to the constructor.
 
 ```php
 use Hyde\Framework\Features\Navigation\NavigationMenu;
@@ -218,7 +218,7 @@ $menu = (new NavigationMenu())
 
 ### Accessing Items in the Menu
 
-You can access all items in the menu by calling the `getItems` method, which will return a Collection of all items in the menu.
+You can access all items in the menu by calling the `getItems` method, which will return a `Collection` of all items in the menu.
 
 ```php
 $items = $menu->getItems();
@@ -232,7 +232,7 @@ The `NavigationItem` class is an abstraction for a navigation menu item containi
 
 ### Quick Reference
 
-Here is a quick reference of the methods available on the NavigationItem class:
+Here is a quick reference of the methods available on the `NavigationItem` class:
 
 ```php
 use Hyde\Framework\Features\Navigation\NavigationItem;
@@ -268,7 +268,7 @@ This will output an anchor tag with the correct link and label, and if the item
 
 ### Creating Navigation Items
 
-There are two syntaxes for creating NavigationItem instances, you can use a standard constructor or the static create method.
+There are two syntaxes for creating `NavigationItem` instances, you can use a standard constructor or the static create method.
 Both options provide the exact same signature and functionality, so it's just a matter of preference which one you use.
 
 The constructors take three parameters: the destination, the label, and the optional priority.

From 7d616033fc14369a54427705ef61e0797cfd9581 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 17:21:39 +0100
Subject: [PATCH 1492/4023] Begin new section

---
 docs/advanced-features/navigation-api.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index b3aedd5f7f4..5f6360dd2cf 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -393,3 +393,20 @@ This is useful if you want to check for a specific query parameter, or if you wa
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
 This class is often used to create submenus or dropdowns in a navigation menu.
+
+### Quick Reference
+
+Here is a quick reference of the methods available on the `NavigationGroup` class:
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationGroup;
+
+// Create a new NavigationGroup instance.
+$group = new NavigationGroup($label, $items = [], $priority = 500);
+
+// Add a single item or an array of items to the group.
+$group->add(new NavigationItem());
+
+// Get the label of the group.
+$group->getLabel(): string;
+```

From 41fb7cca9f8bf12fbeeeaff01753f1999d557313 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 18:50:11 +0100
Subject: [PATCH 1493/4023] Change internal group items to be collection

To normalize with the navigation menu types
---
 .../Framework/Features/Navigation/NavigationGroup.php  | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index ca6e696da2b..a915eb28bf5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -6,6 +6,7 @@
 
 use Illuminate\Support\Str;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Collection;
 use Hyde\Pages\DocumentationPage;
 
 use function min;
@@ -16,13 +17,14 @@
  */
 class NavigationGroup
 {
-    /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem> */
-    protected array $items = [];
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
+    protected Collection $items;
     protected string $label;
     protected int $priority;
 
     public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
     {
+        $this->items = new Collection();
         $this->label = $label;
         $this->priority = $priority;
 
@@ -57,7 +59,7 @@ public function getPriority(): int
     /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
     public function getItems(): array
     {
-        return $this->items;
+        return $this->items->all();
     }
 
     /** @param  \Hyde\Framework\Features\Navigation\NavigationItem|array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
@@ -72,7 +74,7 @@ public function add(NavigationItem|array $items): static
 
     protected function addItem(NavigationItem $item): void
     {
-        $this->items[] = $item;
+        $this->items->push($item);
     }
 
     protected function containsOnlyDocumentationPages(): bool

From bfa64bfc13af66b5b672efee36683fe5683cbf30 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 27 Mar 2024 19:38:32 +0100
Subject: [PATCH 1494/4023] Return the items as the collection

---
 .../Features/Navigation/NavigationGroup.php     |  6 +++---
 .../AutomaticNavigationConfigurationsTest.php   |  2 +-
 .../tests/Feature/NavigationAPITest.php         |  2 +-
 .../tests/Unit/NavigationGroupTest.php          | 17 +++++++++--------
 .../framework/tests/Unit/NavigationItemTest.php |  4 ++--
 5 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index a915eb28bf5..74eefde767a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -56,10 +56,10 @@ public function getPriority(): int
         return $this->priority;
     }
 
-    /** @return array<\Hyde\Framework\Features\Navigation\NavigationItem> */
-    public function getItems(): array
+    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
+    public function getItems(): Collection
     {
-        return $this->items->all();
+        return $this->items;
     }
 
     /** @param  \Hyde\Framework\Features\Navigation\NavigationItem|array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 0f5404ee4ef..5ae702cfad8 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1318,7 +1318,7 @@ public function __construct(TestCase $test, $sidebar = false)
     public function state(): array
     {
         return $this->items->map(function (NavigationItem|NavigationGroup $item): TestNavigationItem {
-            return new TestNavigationItem($item->getLabel(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems() : []);
+            return new TestNavigationItem($item->getLabel(), $item->getPriority(), $item instanceof NavigationGroup ? $item->getItems()->all() : []);
         })->toArray();
     }
 
diff --git a/packages/framework/tests/Feature/NavigationAPITest.php b/packages/framework/tests/Feature/NavigationAPITest.php
index b51483e03f1..f396837b0e9 100644
--- a/packages/framework/tests/Feature/NavigationAPITest.php
+++ b/packages/framework/tests/Feature/NavigationAPITest.php
@@ -230,7 +230,7 @@ protected function toArray(NavigationMenu $menu): array
             if ($item instanceof NavigationGroup) {
                 return [
                     $item->getLabel() => [
-                        'items' => Arr::mapWithKeys($item->getItems(), function (NavigationItem $item): array {
+                        'items' => Arr::mapWithKeys($item->getItems()->all(), function (NavigationItem $item): array {
                             return [$item->getLabel() => $item->getLink()];
                         }),
                     ],
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 378a1d7fe52..ad2bf74aebf 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -45,8 +45,8 @@ public function testCanConstructWithChildren()
         $children = $this->createNavigationItems();
         $item = new NavigationGroup('Foo', $children);
 
-        $this->assertCount(2, $item->getItems());
-        $this->assertSame($children, $item->getItems());
+        $this->assertCount(2, $item->getItems()->all());
+        $this->assertSame($children, $item->getItems()->all());
     }
 
     public function testCanConstructWithChildrenWithoutRoute()
@@ -54,8 +54,8 @@ public function testCanConstructWithChildrenWithoutRoute()
         $children = $this->createNavigationItems();
         $item = new NavigationGroup('Foo', $children);
 
-        $this->assertCount(2, $item->getItems());
-        $this->assertSame($children, $item->getItems());
+        $this->assertCount(2, $item->getItems()->all());
+        $this->assertSame($children, $item->getItems()->all());
     }
 
     public function testCreate()
@@ -71,12 +71,13 @@ public function testGetItems()
         $children = $this->createNavigationItems();
         $item = new NavigationGroup('Foo', $children);
 
-        $this->assertSame($children, $item->getItems());
+        $this->assertSame($children, $item->getItems()->all());
+        $this->assertEquals(collect($children), $item->getItems());
     }
 
     public function testGetItemsWithNoItems()
     {
-        $this->assertEmpty((new NavigationGroup('Foo'))->getItems());
+        $this->assertEmpty((new NavigationGroup('Foo'))->getItems()->all());
     }
 
     public function testCanAddItemToDropdown()
@@ -84,7 +85,7 @@ public function testCanAddItemToDropdown()
         $group = new NavigationGroup('Foo');
         $child = new NavigationItem(new Route(new MarkdownPage()), 'Bar');
 
-        $this->assertSame([$child], $group->add($child)->getItems());
+        $this->assertSame([$child], $group->add($child)->getItems()->all());
     }
 
     public function testAddChildMethodReturnsSelf()
@@ -100,7 +101,7 @@ public function testCanAddMultipleItemsToDropdown()
         $group = new NavigationGroup('Foo');
         $items = $this->createNavigationItems();
 
-        $this->assertSame($items, $group->add($items)->getItems());
+        $this->assertSame($items, $group->add($items)->getItems()->all());
     }
 
     public function testAddChildrenMethodReturnsSelf()
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 19f4f22f0c1..e0a669adf9a 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -279,7 +279,7 @@ public function testDropdownFacade()
         $item = NavigationGroup::create('foo');
 
         $this->assertSame('foo', $item->getLabel());
-        $this->assertSame([], $item->getItems());
+        $this->assertSame([], $item->getItems()->all());
         $this->assertSame(999, $item->getPriority());
     }
 
@@ -290,7 +290,7 @@ public function testDropdownFacadeWithChildren()
         ];
 
         $item = NavigationGroup::create('foo', $children);
-        $this->assertSame($children, $item->getItems());
+        $this->assertSame($children, $item->getItems()->all());
         $this->assertSame(999, $item->getPriority());
     }
 

From 8b2daf0531c2a0738f4a95bf8508e89783b7a704 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 10:54:39 +0100
Subject: [PATCH 1495/4023] Support nesting navigation groups

While the built-in views does not support it (and the generators won't use it), the group class itself now supports containing groups as it's children, allowing developers to utilise the system to create more complex navigation menus.
---
 .../src/Framework/Features/Navigation/NavigationGroup.php | 6 +++---
 packages/framework/tests/Unit/NavigationGroupTest.php     | 8 ++++++++
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 74eefde767a..2f811b17835 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -62,8 +62,8 @@ public function getItems(): Collection
         return $this->items;
     }
 
-    /** @param  \Hyde\Framework\Features\Navigation\NavigationItem|array<\Hyde\Framework\Features\Navigation\NavigationItem>  $items */
-    public function add(NavigationItem|array $items): static
+    /** @param \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> $items */
+    public function add(NavigationItem|NavigationGroup|array $items): static
     {
         foreach (Arr::wrap($items) as $item) {
             $this->addItem($item);
@@ -72,7 +72,7 @@ public function add(NavigationItem|array $items): static
         return $this;
     }
 
-    protected function addItem(NavigationItem $item): void
+    protected function addItem(NavigationItem|NavigationGroup $item): void
     {
         $this->items->push($item);
     }
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index ad2bf74aebf..3df154561c4 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -104,6 +104,14 @@ public function testCanAddMultipleItemsToDropdown()
         $this->assertSame($items, $group->add($items)->getItems()->all());
     }
 
+    public function testCanAddGroupsToDropdown()
+    {
+        $group = new NavigationGroup('Foo');
+        $child = new NavigationGroup('Bar');
+
+        $this->assertSame([$child], $group->add($child)->getItems()->all());
+    }
+
     public function testAddChildrenMethodReturnsSelf()
     {
         $group = new NavigationGroup('Foo');

From 62d6930ab3e87d43245efc735c3eba413e5c51c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 14:49:41 +0100
Subject: [PATCH 1496/4023] Sort grouped navigation items on retrieval

---
 .../Features/Navigation/NavigationGroup.php   |  2 +-
 .../tests/Unit/NavigationGroupTest.php        | 22 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 2f811b17835..7f537768899 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -59,7 +59,7 @@ public function getPriority(): int
     /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
     public function getItems(): Collection
     {
-        return $this->items;
+        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
     }
 
     /** @param \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> $items */
diff --git a/packages/framework/tests/Unit/NavigationGroupTest.php b/packages/framework/tests/Unit/NavigationGroupTest.php
index 3df154561c4..a9ad9646633 100644
--- a/packages/framework/tests/Unit/NavigationGroupTest.php
+++ b/packages/framework/tests/Unit/NavigationGroupTest.php
@@ -119,6 +119,28 @@ public function testAddChildrenMethodReturnsSelf()
         $this->assertSame($group, $group->add([]));
     }
 
+    public function testItemsOrderingDefaultsToAddOrder()
+    {
+        $group = new NavigationGroup('Group', [
+            new NavigationItem(new Route(new MarkdownPage()), 'Foo'),
+            new NavigationItem(new Route(new MarkdownPage()), 'Bar'),
+            new NavigationItem(new Route(new MarkdownPage()), 'Baz'),
+        ]);
+
+        $this->assertSame(['Foo', 'Bar', 'Baz'], $group->getItems()->map(fn (NavigationItem $item) => $item->getLabel())->all());
+    }
+
+    public function testItemsAreSortedByPriority()
+    {
+        $group = new NavigationGroup('Group', [
+            new NavigationItem(new Route(new MarkdownPage()), 'Foo', 3),
+            new NavigationItem(new Route(new MarkdownPage()), 'Bar', 2),
+            new NavigationItem(new Route(new MarkdownPage()), 'Baz', 1),
+        ]);
+
+        $this->assertSame(['Baz', 'Bar', 'Foo'], $group->getItems()->map(fn (NavigationItem $item) => $item->getLabel())->all());
+    }
+
     public function testGetPriorityUsesDefaultPriority()
     {
         $this->assertSame(999, (new NavigationGroup('Foo'))->getPriority());

From fa70254b5663330848a25f9ed535ce2558c054c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 17:54:03 +0100
Subject: [PATCH 1497/4023] Create HasNavigationItems.php

---
 .../Features/Navigation/HasNavigationItems.php         | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php

diff --git a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
new file mode 100644
index 00000000000..20881ed54ef
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+trait HasNavigationItems
+{
+    //
+}

From 6b7cc4a8c5fb54e7b867269daddc948f744f32bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 17:54:19 +0100
Subject: [PATCH 1498/4023] Use HasNavigationItems

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 ++
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 7f537768899..5e36a061682 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -17,6 +17,8 @@
  */
 class NavigationGroup
 {
+    use HasNavigationItems;
+
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
     protected Collection $items;
     protected string $label;
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 7329b6bfbe9..787fb765cdf 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,6 +20,8 @@
  */
 class NavigationMenu
 {
+    use HasNavigationItems;
+
     public const DEFAULT = 500;
     public const LAST = 999;
 

From e91503b701cc23bfe51e2c4ce9328a7a40d70ef0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 17:54:49 +0100
Subject: [PATCH 1499/4023] Document trait abstract

---
 .../Framework/Features/Navigation/HasNavigationItems.php    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
index 20881ed54ef..5b06e925196 100644
--- a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
+++ b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
@@ -4,6 +4,12 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * Contains shared logic for classes that have navigation items.
+ *
+ * @see \Hyde\Framework\Features\Navigation\NavigationMenu
+ * @see \Hyde\Framework\Features\Navigation\NavigationGroup
+ */
 trait HasNavigationItems
 {
     //

From bccde3de5116f316904cf9422246131339676bf4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 17:56:23 +0100
Subject: [PATCH 1500/4023] Move shared logic to trait

---
 .../Navigation/HasNavigationItems.php         | 41 ++++++++++++++++++-
 .../Features/Navigation/NavigationGroup.php   | 24 -----------
 .../Features/Navigation/NavigationMenu.php    | 39 ------------------
 3 files changed, 40 insertions(+), 64 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
index 5b06e925196..74baffa70ab 100644
--- a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
+++ b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Arr;
+use Illuminate\Support\Collection;
+
 /**
  * Contains shared logic for classes that have navigation items.
  *
@@ -12,5 +15,41 @@
  */
 trait HasNavigationItems
 {
-    //
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
+    protected Collection $items;
+
+    /**
+     * Get the navigation items in the menu.
+     *
+     * Items are automatically sorted by their priority, falling back to the order they were added.
+     *
+     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
+     */
+    public function getItems(): Collection
+    {
+        // The reason we sort them here is that navigation items can be added from different sources,
+        // so any sorting we do in generator actions will only be partial. This way, we can ensure
+        // that the items are always freshly sorted by their priorities when they are retrieved.
+
+        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
+    }
+
+    /**
+     * Add one or more navigation items to the navigation menu.
+     *
+     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
+     */
+    public function add(NavigationItem|NavigationGroup|array $items): static
+    {
+        foreach (Arr::wrap($items) as $item) {
+            $this->addItem($item);
+        }
+
+        return $this;
+    }
+
+    protected function addItem(NavigationItem|NavigationGroup $item): void
+    {
+        $this->items->push($item);
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 5e36a061682..4017e44d0c4 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Illuminate\Support\Str;
-use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Hyde\Pages\DocumentationPage;
 
@@ -19,8 +18,6 @@ class NavigationGroup
 {
     use HasNavigationItems;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
-    protected Collection $items;
     protected string $label;
     protected int $priority;
 
@@ -58,27 +55,6 @@ public function getPriority(): int
         return $this->priority;
     }
 
-    /** @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem> */
-    public function getItems(): Collection
-    {
-        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
-    }
-
-    /** @param \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> $items */
-    public function add(NavigationItem|NavigationGroup|array $items): static
-    {
-        foreach (Arr::wrap($items) as $item) {
-            $this->addItem($item);
-        }
-
-        return $this;
-    }
-
-    protected function addItem(NavigationItem|NavigationGroup $item): void
-    {
-        $this->items->push($item);
-    }
-
     protected function containsOnlyDocumentationPages(): bool
     {
         return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $item): bool {
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 787fb765cdf..08f194a502a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -25,48 +24,10 @@ class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
-    protected Collection $items;
-
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
         $this->add(evaluate_arrayable($items));
     }
-
-    /**
-     * Get the navigation items in the menu.
-     *
-     * Items are automatically sorted by their priority, falling back to the order they were added.
-     *
-     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
-     */
-    public function getItems(): Collection
-    {
-        // The reason we sort them here is that navigation items can be added from different sources,
-        // so any sorting we do in generator actions will only be partial. This way, we can ensure
-        // that the items are always freshly sorted by their priorities when they are retrieved.
-
-        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
-    }
-
-    /**
-     * Add one or more navigation items to the navigation menu.
-     *
-     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
-     */
-    public function add(NavigationItem|NavigationGroup|array $items): static
-    {
-        foreach (Arr::wrap($items) as $item) {
-            $this->addItem($item);
-        }
-
-        return $this;
-    }
-
-    protected function addItem(NavigationItem|NavigationGroup $item): void
-    {
-        $this->items->push($item);
-    }
 }

From dbc237962e94fa310bc558986bd11dcc744b8076 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 19:53:32 +0100
Subject: [PATCH 1501/4023] Revert "Use HasNavigationItems"

This reverts commit 6b7cc4a8c5fb54e7b867269daddc948f744f32bc.
---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 --
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 --
 2 files changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 4017e44d0c4..29a9012db67 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -16,8 +16,6 @@
  */
 class NavigationGroup
 {
-    use HasNavigationItems;
-
     protected string $label;
     protected int $priority;
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 08f194a502a..9b15d74c950 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -19,8 +19,6 @@
  */
 class NavigationMenu
 {
-    use HasNavigationItems;
-
     public const DEFAULT = 500;
     public const LAST = 999;
 

From cfe97849e5682e9bf06f536e250bfafc0c4b73a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 19:54:11 +0100
Subject: [PATCH 1502/4023] Merge trait back into menu class

This partially reverts commit bccde3de5116f316904cf9422246131339676bf4.
---
 .../Navigation/HasNavigationItems.php         | 41 +------------------
 .../Features/Navigation/NavigationMenu.php    | 39 ++++++++++++++++++
 2 files changed, 40 insertions(+), 40 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
index 74baffa70ab..5b06e925196 100644
--- a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
+++ b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
@@ -4,9 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Illuminate\Support\Arr;
-use Illuminate\Support\Collection;
-
 /**
  * Contains shared logic for classes that have navigation items.
  *
@@ -15,41 +12,5 @@
  */
 trait HasNavigationItems
 {
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
-    protected Collection $items;
-
-    /**
-     * Get the navigation items in the menu.
-     *
-     * Items are automatically sorted by their priority, falling back to the order they were added.
-     *
-     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
-     */
-    public function getItems(): Collection
-    {
-        // The reason we sort them here is that navigation items can be added from different sources,
-        // so any sorting we do in generator actions will only be partial. This way, we can ensure
-        // that the items are always freshly sorted by their priorities when they are retrieved.
-
-        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
-    }
-
-    /**
-     * Add one or more navigation items to the navigation menu.
-     *
-     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
-     */
-    public function add(NavigationItem|NavigationGroup|array $items): static
-    {
-        foreach (Arr::wrap($items) as $item) {
-            $this->addItem($item);
-        }
-
-        return $this;
-    }
-
-    protected function addItem(NavigationItem|NavigationGroup $item): void
-    {
-        $this->items->push($item);
-    }
+    //
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 9b15d74c950..7329b6bfbe9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -22,10 +23,48 @@ class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
+    protected Collection $items;
+
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
         $this->add(evaluate_arrayable($items));
     }
+
+    /**
+     * Get the navigation items in the menu.
+     *
+     * Items are automatically sorted by their priority, falling back to the order they were added.
+     *
+     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
+     */
+    public function getItems(): Collection
+    {
+        // The reason we sort them here is that navigation items can be added from different sources,
+        // so any sorting we do in generator actions will only be partial. This way, we can ensure
+        // that the items are always freshly sorted by their priorities when they are retrieved.
+
+        return $this->items->sortBy(fn (NavigationItem|NavigationGroup $item) => $item->getPriority())->values();
+    }
+
+    /**
+     * Add one or more navigation items to the navigation menu.
+     *
+     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
+     */
+    public function add(NavigationItem|NavigationGroup|array $items): static
+    {
+        foreach (Arr::wrap($items) as $item) {
+            $this->addItem($item);
+        }
+
+        return $this;
+    }
+
+    protected function addItem(NavigationItem|NavigationGroup $item): void
+    {
+        $this->items->push($item);
+    }
 }

From 841d1bfaae9366e1f77b2443733a25972f448f6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 19:54:58 +0100
Subject: [PATCH 1503/4023] Revert "Create HasNavigationItems.php"

This reverts commit fa70254b5663330848a25f9ed535ce2558c054c2.
---
 .../Features/Navigation/HasNavigationItems.php   | 16 ----------------
 1 file changed, 16 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php

diff --git a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php b/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
deleted file mode 100644
index 5b06e925196..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/HasNavigationItems.php
+++ /dev/null
@@ -1,16 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-/**
- * Contains shared logic for classes that have navigation items.
- *
- * @see \Hyde\Framework\Features\Navigation\NavigationMenu
- * @see \Hyde\Framework\Features\Navigation\NavigationGroup
- */
-trait HasNavigationItems
-{
-    //
-}

From b412f3429857900b02f3e558bb8ea2d12372726d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 19:55:38 +0100
Subject: [PATCH 1504/4023] Update navigation group to extend menu class

---
 .../src/Framework/Features/Navigation/NavigationGroup.php    | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 29a9012db67..b17ecdb0404 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -14,18 +14,17 @@
 /**
  * Abstraction for a grouped navigation menu item, like a dropdown or a sidebar group.
  */
-class NavigationGroup
+class NavigationGroup extends NavigationMenu
 {
     protected string $label;
     protected int $priority;
 
     public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
     {
-        $this->items = new Collection();
         $this->label = $label;
         $this->priority = $priority;
 
-        $this->add($items);
+        parent::__construct($items);
     }
 
     public static function create(string $label, array $items = [], int $priority = NavigationMenu::LAST): static

From 8461e60d247b8ad28ba4003f12d6a81754cc422f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 28 Mar 2024 19:55:52 +0100
Subject: [PATCH 1505/4023] Move up parent constructor call

---
 .../src/Framework/Features/Navigation/NavigationGroup.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index b17ecdb0404..c32afc519ae 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -21,10 +21,10 @@ class NavigationGroup extends NavigationMenu
 
     public function __construct(string $label, array $items = [], int $priority = NavigationMenu::LAST)
     {
+        parent::__construct($items);
+
         $this->label = $label;
         $this->priority = $priority;
-
-        parent::__construct($items);
     }
 
     public static function create(string $label, array $items = [], int $priority = NavigationMenu::LAST): static

From cc803baaec4a1c1963aa2e132ce80b6de3580879 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Thu, 28 Mar 2024 18:56:03 +0000
Subject: [PATCH 1506/4023] Remove unused import

---
 .../src/Framework/Features/Navigation/NavigationGroup.php        | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index c32afc519ae..aacbd30b952 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Illuminate\Support\Str;
-use Illuminate\Support\Collection;
 use Hyde\Pages\DocumentationPage;
 
 use function min;

From b1f5867d3de4ca59e3749d3bfb1367176799e8e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 29 Mar 2024 15:32:51 +0100
Subject: [PATCH 1507/4023] Document the navigation group class

---
 docs/advanced-features/navigation-api.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 5f6360dd2cf..9dcc815ce78 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -392,7 +392,10 @@ This is useful if you want to check for a specific query parameter, or if you wa
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
-This class is often used to create submenus or dropdowns in a navigation menu.
+This class is often used to create submenus or dropdowns in a navigation menu. 
+
+The `NavigationGroup` class extends the `NavigationMenu` class, and thus inherits the same base methods and functionality, 
+while also having shared methods with the `NavigationItem` class to render the groups in a Blade view.
 
 ### Quick Reference
 
@@ -406,7 +409,25 @@ $group = new NavigationGroup($label, $items = [], $priority = 500);
 
 // Add a single item or an array of items to the group.
 $group->add(new NavigationItem());
+$group->add([new NavigationItem()]);
+
+// Get all items in the group as a Collection sorted by priority.
+$group->getItems(): Collection<NavigationItem|NavigationGroup>
 
 // Get the label of the group.
 $group->getLabel(): string;
+
+// Get the priority of the group.
+$group->getPriority(): int;
+
+// Get the group key, which is a normalized kebab-case version of the label.
+$group->getGroupKey(): string;
 ```
+
+As the `NavigationGroup` class extends the `NavigationMenu` class, please see the `NavigationMenu` section for detailed information of the methods available.
+
+### Usage Scenarios
+
+HydePHP uses the `NavigationGroup` class to create dropdowns in the main navigation menu and the category groups in the documentation sidebar.
+
+In your own custom menus, you can use this class for the same types of functionality, and you can even nest groups within groups to create complex navigation structures.

From 604264203b5f369e88e8b96b3ed8669aac6d3aa2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 29 Mar 2024 16:35:11 +0100
Subject: [PATCH 1508/4023] Unwrap collect calls for already collected items

---
 .../src/Framework/Features/Navigation/NavigationGroup.php    | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index aacbd30b952..9c472b9366a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -8,7 +8,6 @@
 use Hyde\Pages\DocumentationPage;
 
 use function min;
-use function collect;
 
 /**
  * Abstraction for a grouped navigation menu item, like a dropdown or a sidebar group.
@@ -45,7 +44,7 @@ public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {
             // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
-            return min($this->priority, collect($this->getItems())->min(fn (NavigationItem $item): int => $item->getPriority()));
+            return min($this->priority, $this->getItems()->min(fn (NavigationItem $item): int => $item->getPriority()));
         }
 
         return $this->priority;
@@ -53,7 +52,7 @@ public function getPriority(): int
 
     protected function containsOnlyDocumentationPages(): bool
     {
-        return count($this->getItems()) && collect($this->getItems())->every(function (NavigationItem $item): bool {
+        return count($this->getItems()) && $this->getItems()->every(function (NavigationItem $item): bool {
             return $item->getPage() instanceof DocumentationPage;
         });
     }

From 89c48900a9b3d2d5b68e715ded6d0783d339a8a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 29 Mar 2024 19:23:33 +0100
Subject: [PATCH 1509/4023] Fix formatting

---
 docs/advanced-features/navigation-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 9dcc815ce78..9c5fcad14d2 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -392,9 +392,9 @@ This is useful if you want to check for a specific query parameter, or if you wa
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
-This class is often used to create submenus or dropdowns in a navigation menu. 
+This class is often used to create submenus or dropdowns in a navigation menu.
 
-The `NavigationGroup` class extends the `NavigationMenu` class, and thus inherits the same base methods and functionality, 
+The `NavigationGroup` class extends the `NavigationMenu` class, and thus inherits the same base methods and functionality,
 while also having shared methods with the `NavigationItem` class to render the groups in a Blade view.
 
 ### Quick Reference

From 75de73070e65bc780db7f49d4a623c193efedcc4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 31 Mar 2024 16:34:33 +0200
Subject: [PATCH 1510/4023] Update navigation documentation for v2 rewrite

---
 docs/digging-deeper/navigation.md | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 65bac03a553..155b07b9cab 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -297,36 +297,33 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 ## Digging Deeper into the internals
 
-While not required to know, you may find it interesting to learn more about how the navigation is handled internally.
-The best way to learn about this is to look at the source code, so here is a high-level overview with details on where to look in the source code.
+While not required to know, you may find it interesting to learn more about how the navigation is handled internally. Here is a high level overview,
+but you can find more detailed information in the [Navigation API](navigation-api) documentation.
 
-The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class.
-Both extend the same `BaseNavigationMenu` class:
+The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class. Both extend the same base `NavigationMenu` class.
 
 ```php
-// TODO: Update these examples
-
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Framework\Features\Navigation\BaseNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
 ```
 
-Within the `BaseNavigationMenu` class, you will find the main logic for how the menus are generated,
+Within the base `NavigationMenu` class, you will find the main logic for how the menus are generated,
 while the child implementations contain the extra logic tailored for their specific use cases.
 
-All the navigation menus store the menu items in their `$items` array containing instances of the `NavigationItem` class.
+All the navigation menus store the menu items in their `$items` collection containing instances of the `NavigationItem` class.
 
 The `NavigationItem` class is a simple class that contains the label and URL of the menu item and is used to represent each item in the menu.
-Dropdowns are represented by `DropdownNavigationItem` instances, which extend the `NavigationItem` class and contain an array of additional `NavigationItem` instances.
+Dropdowns are represented by `NavigationGroup` instances, which extend the `NavigationMenu` class and contain a collection of additional `NavigationItem` instances.
 
 ```php
 use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\DropdownNavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 ```
 
 ## The Navigation API
 
-If you want to interact with the site navigation programmatically, or if you want to create complex custom, you can do so through the new Navigation API.
+If you want to interact with the site navigation programmatically, or if you want to create complex custom menus, you can do so through the new Navigation API.
 For most cases you don't need this, as Hyde creates the navigation for you. But it can be useful for advanced users and package developers.
 
 The Navigation API consists of a set of PHP classes, allowing you to fluently interact with the navigation menus. You can learn more about the API in the [Navigation API](navigation-api) documentation.

From 01291420df325c987ac9732d902b5df112e02833 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 31 Mar 2024 17:12:18 +0200
Subject: [PATCH 1511/4023] Create documentation note

---
 docs/digging-deeper/navigation.md                            | 5 +++++
 .../Features/Navigation/NavigationMenuGenerator.php          | 3 ---
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 155b07b9cab..ff515caf30b 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -294,6 +294,11 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 >info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
 
+#### Dropdown menu notes
+
+Here are some things to keep in mind when using dropdown menus, regardless of the configuration:
+- Dropdowns take priority over standard items. So if you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
+  - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
 
 ## Digging Deeper into the internals
 
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index c0e11aa5a75..d1476b87ac3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -158,9 +158,6 @@ protected function getOrCreateGroupItem(string $groupName): NavigationGroup
             // so here we create a new instance to replace the base one, this
             // does mean we lose the destination as we can't link to them.
 
-            // Todo: Add note in documentation about this behavior
-            // Example file structure: _pages/foo.md, _pages/foo/bar.md, _pages/foo/baz.md, here the link to foo will be lost.
-
             $item = new NavigationGroup($group->getLabel(), [], $group->getPriority());
 
             $this->items->put($groupKey, $item);

From cc2756e9c4a2c1dbb38be8bdbd696dff335152e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 31 Mar 2024 16:00:57 +0200
Subject: [PATCH 1512/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 60 +++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 47 insertions(+), 13 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3c8def52a9b..90bac911835 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,15 +11,14 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
-- Added a new `NavigationItem::getLink()` method contain the previous `NavigationItem::getDestination()` logic, to return the link URL.
 
 ### Changed
+- **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
+- Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
+- Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
+- Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
-- Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
-- Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
-- Breaking: The `NavigationItem` class now always stores the destination as a `Route` instance.
-- Breaking: The `NavigationItem::getDestination()` method now returns its `Route` instance.
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -45,6 +44,32 @@ Please see the "Breaking changes & upgrade guide" section below for more informa
 
 Please read through this section to ensure your site upgrades smoothly.
 
+## High impact
+
+### Navigation system rewrite
+
+The navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations, see more down below.
+
+For most users, the only impact will be that configuration files need to be updated to use the new configuration format. Due to the internal changes,
+it's also possible that menu items will be in a slightly different order than before, depending on your setup. Please verify that your site's menus
+look as expected after upgrading, and adjust the configuration files if necessary, before deploying to production.
+
+### Navigation and sidebar configuration changes
+
+The navigation and sidebar configuration files have been updated to use the new Navigation API.
+This means that you will need to update your configuration files to use the new format.
+
+The easiest way to upgrade is to publish updated configuration files (`hyde.php` and `docs.php`) and copy over your customizations.
+
+The following configuration entries have been updated:
+
+-  Changed configuration option `docs.sidebar_order` to `docs.sidebar.order` in https://github.com/hydephp/develop/pull/1583
+-  Upgrade path: Move the `sidebar_order` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
+
+-  Changed configuration option `docs.table_of_contents` to `docs.sidebar.table_of_contents` in https://github.com/hydephp/develop/pull/1584
+-  Upgrade path: Move the `table_of_contents` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
+
+
 ## General impact
 
 ### Documentation search page changes
@@ -53,20 +78,29 @@ The documentation search page and search index have been changed to be generated
 
 The main impact noticeable to most users by this is the implicit changes, like the pages showing up in the dashboard and route list command.
 
-In case you have customized the `GenerateSearch` post-build task you may, depending on what you were trying to do, 
+In case you have customized the `GenerateSearch` post-build task you may, depending on what you were trying to do,
 want to adapt your code to interact with the new `InMemoryPage`, which is generated in the `HydeCoreExtension` class.
 
 For more information, see https://github.com/hydephp/develop/pull/1498.
 
 ## Low impact
 
-### Navigation item changes
+### Navigation internal changes
 
-The `NavigationItem::getDestination()` method now returns its `Route` instance. This allows for deferring the route evaluation.
+The navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations.
 
-If you have previously used this method directly and expected a string to be returned, you may need to adapt your code to handle the new return type.
+If you have previously in your custom code done any of the following, or similar, you will need to adapt your code to use the new Navigation API:
+- Created custom navigation menus or Blade components
+- Extended or called the navigation related classes directly
+- Customized the navigation system in any way beyond the standard configuration
 
-If you want to retain the previous state where a string is always returned, you can use the new `NavigationItem::getLink()` method instead, which will resolve the route immediately.
+
+#### Upgrade guide
+
+Due to the scope of the rewrite, the easiest and fastest way to upgrade your code is to recreate it using the new Navigation API.
+
+- For a full comparison of the changes, you may see the PR that introduced the new API: https://github.com/hydephp/develop/pull/1568/files
+- For information on how to use the new Navigation API, see the documentation: https://hydephp.com/docs/2.x/navigation-api
 
 ### HTML ID changes
 
@@ -85,14 +119,14 @@ If you have used any of the following selectors in custom code you wrote yoursel
 As the new documentation search implementation brings changes to their code API you may need to adapt your code
 according to the information below in case you wrote custom code that interacted with these parts of the codebase.
 
-- The `GenerateSearch` post-build task has been removed. If you have previously extended or customized this class, 
+- The `GenerateSearch` post-build task has been removed. If you have previously extended or customized this class,
   you will need to adapt your code, as the search index files are now handled implicitly during the standard build process,
   as the search pages are now added to the kernel page and route collection. (https://github.com/hydephp/develop/pull/1498)
 
 - If your site has a custom documentation search page, for example `_docs/search.md` or `_pages/docs/search.blade.php`,
-  that page will no longer be built when using the specific `build:search` command. It will, of course, 
+  that page will no longer be built when using the specific `build:search` command. It will, of course,
   be built using the standard `build` command. https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced
- 
+
 - In the highly unlikely event your site customizes any of the search pages by replacing them in the kernel route collection,
   you would now need to do that in the kernel page collection due to the search pages being generated earlier in the lifecycle.
   https://github.com/hydephp/develop/commit/82dc71f4a0e7b6be7a9f8d822fbebe39d2289ced

From 1985260adbd32683e7a8d9cc31f5d4bdd2368327 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 1 Apr 2024 15:13:44 +0200
Subject: [PATCH 1513/4023] Add features property to the kernel

---
 packages/framework/src/Foundation/HydeKernel.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 8d5195b2de7..a2ff17497da 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -58,6 +58,7 @@ class HydeKernel implements SerializableContract
     protected string $outputDirectory = '_site';
     protected string $mediaDirectory = '_media';
 
+    protected Features $features;
     protected Filesystem $filesystem;
     protected Hyperlinks $hyperlinks;
 

From 374dfb15631315227a9b757a1c1655867ea683f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 1 Apr 2024 15:16:40 +0200
Subject: [PATCH 1514/4023] Construct features on kernel construct

---
 packages/framework/src/Foundation/HydeKernel.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index a2ff17497da..4039ca5b9d3 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -74,6 +74,7 @@ class HydeKernel implements SerializableContract
     public function __construct(?string $basePath = null)
     {
         $this->setBasePath($basePath ?? getcwd());
+        $this->features = new Features;
         $this->filesystem = new Filesystem($this);
         $this->hyperlinks = new Hyperlinks($this);
 

From 30f30c6c0a265f44e7d6066645b087fcd7e29432 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 15:39:31 +0200
Subject: [PATCH 1515/4023] Update features accessor to return kernel instance

---
 packages/framework/src/Foundation/HydeKernel.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 4039ca5b9d3..2bd92358664 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -88,7 +88,7 @@ public static function version(): string
 
     public function features(): Features
     {
-        return new Features;
+        return $this->features;
     }
 
     public function hasFeature(string $feature): bool

From 9bf80c63f5a076012681b9bf278c82a9ce465fae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 17:26:13 +0200
Subject: [PATCH 1516/4023] Test features class is bound as singleton

---
 packages/framework/tests/Feature/HydeKernelTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index d692b601273..3de43152541 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -542,6 +542,13 @@ public function testIsBootedMethodOnTheFacade()
         Hyde::kernel()->boot();
         $this->assertTrue(Hyde::isBooted());
     }
+
+    public function testFeaturesClassIsBoundAsSingleton()
+    {
+        $kernel = new HydeKernel();
+
+        $this->assertSame($kernel->features(), $kernel->features());
+    }
 }
 
 class CallableClass

From 937e4dbeab6da4dfe81ca77279f50e8d3e7ba820 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 17:32:13 +0200
Subject: [PATCH 1517/4023] Add array for the features that are enabled

---
 packages/framework/src/Facades/Features.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 0a201cf8b22..4b707178cc3 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -36,6 +36,13 @@ class Features implements SerializableContract
     use Serializable;
     use MockableFeatures;
 
+    /**
+     * The features that are enabled.
+     *
+     * @var array<string>
+     */
+    protected array $enabled = [];
+
     /**
      * Determine if the given specified is enabled.
      */

From 70392b9185cc8936c86ee0bde22107ea6ff4e178 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 17:46:12 +0200
Subject: [PATCH 1518/4023] Sketch out features construct to boot method

---
 packages/framework/src/Facades/Features.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 4b707178cc3..3aeb29370dc 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,6 +43,11 @@ class Features implements SerializableContract
      */
     protected array $enabled = [];
 
+    public function __construct()
+    {
+        $this->enabled = $this->boot();
+    }
+
     /**
      * Determine if the given specified is enabled.
      */
@@ -206,4 +211,9 @@ protected static function getDefaultOptions(): array
             static::torchlight(),
         ];
     }
+
+    protected function boot(): array
+    {
+        return []; // @todo Implement boot method
+    }
 }

From 9365d12ba64122877c731bfb2b49061242459424 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 17:54:56 +0200
Subject: [PATCH 1519/4023] Construct features on kernel boot

We need to do this later in the process, and not each time we create a kernel, as that is done way before the configuration is loaded. And a later construct adds less complexity than exposing a boot method on an initially empty features instance.
---
 .../framework/src/Foundation/Concerns/BootsHydeKernel.php    | 2 ++
 packages/framework/src/Foundation/HydeKernel.php             | 5 ++++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
index c680133cc9f..5ab718a1fd8 100644
--- a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
+++ b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Hyde\Facades\Features;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
@@ -42,6 +43,7 @@ public function boot(): void
 
         $this->booting = true;
 
+        $this->features = new Features;
         $this->files = FileCollection::init($this);
         $this->pages = PageCollection::init($this);
         $this->routes = RouteCollection::init($this);
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 2bd92358664..5fb29d83770 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -74,7 +74,7 @@ class HydeKernel implements SerializableContract
     public function __construct(?string $basePath = null)
     {
         $this->setBasePath($basePath ?? getcwd());
-        $this->features = new Features;
+
         $this->filesystem = new Filesystem($this);
         $this->hyperlinks = new Hyperlinks($this);
 
@@ -88,6 +88,9 @@ public static function version(): string
 
     public function features(): Features
     {
+        /** @experimental May cause side effects */
+        $this->needsToBeBooted();
+
         return $this->features;
     }
 

From a5080cdc3b351d157b809015af2f33c316902a2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 17:58:14 +0200
Subject: [PATCH 1520/4023] Implement features boot method

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 3aeb29370dc..94739d73a58 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -214,6 +214,6 @@ protected static function getDefaultOptions(): array
 
     protected function boot(): array
     {
-        return []; // @todo Implement boot method
+        return Config::getArray('hyde.features', static::getDefaultOptions());
     }
 }

From 1f661e900bbf4145b8296ef60cb3459ae9f89934 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 18:49:32 +0200
Subject: [PATCH 1521/4023] Use only user's explicitly added features in array

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 94739d73a58..b9b8aa3637b 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -214,6 +214,6 @@ protected static function getDefaultOptions(): array
 
     protected function boot(): array
     {
-        return Config::getArray('hyde.features', static::getDefaultOptions());
+        return Config::getArray('hyde.features', []);
     }
 }

From 18395b1da6d7f629f480e835002aa75e06546ef0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 18:49:44 +0200
Subject: [PATCH 1522/4023] Revert "Use only user's explicitly added features
 in array"

This reverts commit 1f661e900bbf4145b8296ef60cb3459ae9f89934.
---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b9b8aa3637b..94739d73a58 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -214,6 +214,6 @@ protected static function getDefaultOptions(): array
 
     protected function boot(): array
     {
-        return Config::getArray('hyde.features', []);
+        return Config::getArray('hyde.features', static::getDefaultOptions());
     }
 }

From e50e3b154af95ee72c671f5a379697b4af2fa113 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 21:40:49 +0200
Subject: [PATCH 1523/4023] Add enabled array getter

---
 packages/framework/src/Facades/Features.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 94739d73a58..39c77fb908f 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -48,6 +48,11 @@ public function __construct()
         $this->enabled = $this->boot();
     }
 
+    public function getEnabled(): array
+    {
+        return $this->enabled;
+    }
+
     /**
      * Determine if the given specified is enabled.
      */

From 2b3154311afde5097b1c7a16b14d710b9a0d152a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 2 Apr 2024 21:40:56 +0200
Subject: [PATCH 1524/4023] Mark new getter as experimental

---
 packages/framework/src/Facades/Features.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 39c77fb908f..39fd747ce6b 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -48,6 +48,7 @@ public function __construct()
         $this->enabled = $this->boot();
     }
 
+    /** @experimental This method may change before its release. */
     public function getEnabled(): array
     {
         return $this->enabled;

From 5e56db83f30bbfdf143751d2bada88410e296984 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 10:45:57 +0200
Subject: [PATCH 1525/4023] Test the features settings

---
 .../Feature/ConfigurableFeaturesTest.php      | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 897236a50da..d81d1b46c9a 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -124,4 +124,74 @@ public function testMultipleFeaturesCanBeMocked()
         $this->assertFalse(Features::rss());
         $this->assertFalse(Features::hasDarkmode());
     }
+
+    public function testGetEnabledUsesDefaultOptionsByDefault()
+    {
+        $features = new Features();
+
+        $default = $this->defaultOptions();
+
+        $this->assertSame($default, $features->getEnabled());
+    }
+
+    public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
+    {
+        config(['hyde' => []]);
+
+        $features = new Features();
+
+        $default = $this->defaultOptions();
+
+        $this->assertSame($default, $features->getEnabled());
+    }
+
+    public function testGetEnabledUsesConfiguredOptions()
+    {
+        $config = [
+            Features::htmlPages(),
+            Features::markdownPosts(),
+            Features::bladePages(),
+        ];
+
+        config(['hyde.features' => $config]);
+
+        $features = new Features();
+        $this->assertSame($config, $features->getEnabled());
+    }
+
+    public function testCannotUseArbitraryValuesInEnabledOptions()
+    {
+        $this->markTestSkipped('Todo: Implement if it is worth the complexity.');
+
+        $config = [
+            Features::htmlPages(),
+            Features::markdownPosts(),
+            Features::bladePages(),
+            'foo',
+        ];
+
+        config(['hyde.features' => $config]);
+
+        $features = new Features();
+        $this->assertSame(array_slice($config, 0, 3), $features->getEnabled());
+    }
+
+    protected function defaultOptions(): array
+    {
+        return [
+            // Page Modules
+            Features::htmlPages(),
+            Features::markdownPosts(),
+            Features::bladePages(),
+            Features::markdownPages(),
+            Features::documentationPages(),
+
+            // Frontend Features
+            Features::darkmode(),
+            Features::documentationSearch(),
+
+            // Integrations
+            Features::torchlight(),
+        ];
+    }
 }

From 419b23714a03918a81607602ca40fcfa25adc74a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:35:32 +0200
Subject: [PATCH 1526/4023] Expose boot method as public internal

---
 packages/framework/src/Facades/Features.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 39fd747ce6b..5889f0a2385 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -218,7 +218,8 @@ protected static function getDefaultOptions(): array
         ];
     }
 
-    protected function boot(): array
+    /** @internal Reboot the features from configuration. */
+    public function boot(): array
     {
         return Config::getArray('hyde.features', static::getDefaultOptions());
     }

From bfa9f49bad424ad5452464e99da0f5ae306c1998 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:36:41 +0200
Subject: [PATCH 1527/4023] Change boot method to write property from method

---
 packages/framework/src/Facades/Features.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 5889f0a2385..0cc421c3042 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -45,7 +45,7 @@ class Features implements SerializableContract
 
     public function __construct()
     {
-        $this->enabled = $this->boot();
+        $this->boot();
     }
 
     /** @experimental This method may change before its release. */
@@ -219,8 +219,8 @@ protected static function getDefaultOptions(): array
     }
 
     /** @internal Reboot the features from configuration. */
-    public function boot(): array
+    public function boot(): void
     {
-        return Config::getArray('hyde.features', static::getDefaultOptions());
+        $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
     }
 }

From 33ff559b9b9bdc86bc5cbce98f7e9049649d07e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:37:08 +0200
Subject: [PATCH 1528/4023] Reboot features after changing config

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index bd5168d390e..6114281437f 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,6 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
+        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -34,6 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
+        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -85,6 +87,8 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
+        Hyde::features()->boot();
+
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',

From b8632481524e977bcdba4ea1b7bd25165a3de26d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:37:41 +0200
Subject: [PATCH 1529/4023] Reboot entire kernel instead of just features

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 6114281437f..e8931f3f129 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,7 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
-        Hyde::features()->boot();
+        Hyde::boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -35,7 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
-        Hyde::features()->boot();
+        Hyde::boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -87,7 +87,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::features()->boot();
+        Hyde::boot();
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From d2731b2c721970920f816837a768e8382cb45cb9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:38:07 +0200
Subject: [PATCH 1530/4023] Revert "Expose boot method as public internal"

This reverts commit a72546c5426a3dec3b0b7c4c6f91968986e81665.
---
 packages/framework/src/Facades/Features.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 0cc421c3042..041131c7281 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -218,8 +218,7 @@ protected static function getDefaultOptions(): array
         ];
     }
 
-    /** @internal Reboot the features from configuration. */
-    public function boot(): void
+    protected function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
     }

From dd040663e057d524100121f2b7c16fad91df9385 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 3 Apr 2024 11:31:37 +0200
Subject: [PATCH 1531/4023] Resolve features from kernel container

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 041131c7281..d9262e142f0 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -60,7 +60,7 @@ public function getEnabled(): array
     public static function enabled(string $feature): bool
     {
         return static::resolveMockedInstance($feature) ?? in_array(
-            $feature, Config::getArray('hyde.features', static::getDefaultOptions())
+            $feature, Hyde::features()->getEnabled()
         );
     }
 

From b33fa12bb04f3ca183c52c83ad18791dc46dc8fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 4 Apr 2024 15:33:54 +0200
Subject: [PATCH 1532/4023] Reboot the kernel

---
 packages/framework/tests/Feature/HydeExtensionFeatureTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
index 6ed83dd5793..b7cbfc6e0ba 100644
--- a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
+++ b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
@@ -104,6 +104,7 @@ public function testCustomRegisteredPagesAreDiscoveredByTheFileCollectionClass()
 
         $this->directory('foo');
         $this->file('foo/bar.txt');
+        $this->kernel->boot();
 
         $this->assertArrayHasKey('foo/bar.txt', Files::all());
         $this->assertEquals(new SourceFile('foo/bar.txt', TestPageClass::class), Files::get('foo/bar.txt'));

From dd29e412472f1117a36fe1b033bffe5f034c4b69 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:02:07 +0200
Subject: [PATCH 1533/4023] Remove features autobooting causing side effects

---
 packages/framework/src/Foundation/HydeKernel.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 5fb29d83770..913f5df6e0a 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -88,9 +88,6 @@ public static function version(): string
 
     public function features(): Features
     {
-        /** @experimental May cause side effects */
-        $this->needsToBeBooted();
-
         return $this->features;
     }
 

From 6e97d3bf82b193c75f0f00e12a85f329f3957ff8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:03:40 +0200
Subject: [PATCH 1534/4023] Instantiate features in kernel constructor

---
 packages/framework/src/Foundation/HydeKernel.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 913f5df6e0a..7dbdd31349b 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -77,6 +77,7 @@ public function __construct(?string $basePath = null)
 
         $this->filesystem = new Filesystem($this);
         $this->hyperlinks = new Hyperlinks($this);
+        $this->features = new Features;
 
         $this->registerExtension(HydeCoreExtension::class);
     }

From c29aa76c60bea067ab81cc7ccf56df3f35674df8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:12:53 +0200
Subject: [PATCH 1535/4023] Automatically mock config in unit tests

A config instance is required to construct the kernel
---
 packages/testing/src/UnitTestCase.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index cb0b4a48a43..9e63ed3506c 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -36,6 +36,11 @@ public static function setUpBeforeClass(): void
 
     protected static function setupKernel(): void
     {
+        // If a config is not bound we bind it
+        if (! app()->bound('config')) {
+            self::mockConfig();
+        }
+
         HydeKernel::setInstance(new HydeKernel());
         self::$hasSetUpKernel = true;
     }

From 6e12eee5e03a69c953886fe5f52400f0b77f0226 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:13:45 +0200
Subject: [PATCH 1536/4023] Revert "Automatically mock config in unit tests"

This reverts commit c29aa76c60bea067ab81cc7ccf56df3f35674df8.
---
 packages/testing/src/UnitTestCase.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index 9e63ed3506c..cb0b4a48a43 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -36,11 +36,6 @@ public static function setUpBeforeClass(): void
 
     protected static function setupKernel(): void
     {
-        // If a config is not bound we bind it
-        if (! app()->bound('config')) {
-            self::mockConfig();
-        }
-
         HydeKernel::setInstance(new HydeKernel());
         self::$hasSetUpKernel = true;
     }

From 4c420a5a371ac621c34b3e3d61ae4a4fb101d4bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:14:53 +0200
Subject: [PATCH 1537/4023] Move deferred booting to features class

---
 packages/framework/src/Facades/Features.php | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index d9262e142f0..942c881549a 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,14 +43,13 @@ class Features implements SerializableContract
      */
     protected array $enabled = [];
 
-    public function __construct()
-    {
-        $this->boot();
-    }
-
     /** @experimental This method may change before its release. */
     public function getEnabled(): array
     {
+        if ($this->enabled === []) {
+            $this->boot();
+        }
+
         return $this->enabled;
     }
 

From d752361f6942e7d28030192a6c6dcd7c410d016b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:23:04 +0200
Subject: [PATCH 1538/4023] Create helper method to ensure features is booted
 when accessing it

---
 packages/framework/src/Facades/Features.php      | 14 +++++++++++---
 packages/framework/src/Foundation/HydeKernel.php |  2 +-
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 942c881549a..1d70fd248f0 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -46,9 +46,7 @@ class Features implements SerializableContract
     /** @experimental This method may change before its release. */
     public function getEnabled(): array
     {
-        if ($this->enabled === []) {
-            $this->boot();
-        }
+        $this->booted();
 
         return $this->enabled;
     }
@@ -221,4 +219,14 @@ protected function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
     }
+
+    /** @internal */
+    public function booted(): static
+    {
+        if ($this->enabled === []) {
+            $this->boot();
+        }
+
+        return $this;
+    }
 }
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 7dbdd31349b..ab50bce93fc 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -89,7 +89,7 @@ public static function version(): string
 
     public function features(): Features
     {
-        return $this->features;
+        return $this->features->booted();
     }
 
     public function hasFeature(string $feature): bool

From 92c1b56067fbd5cb15dbb813d02c59cb5c3774fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:26:07 +0200
Subject: [PATCH 1539/4023] Remove old todo

For some reason assert same does still not work but that's fine
---
 packages/framework/tests/Feature/HydeKernelTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 3de43152541..56b9c99e1b4 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -273,7 +273,6 @@ public function testPathToRelativeHelperReturnsRelativePathForGivenPath()
 
     public function testToArrayMethod()
     {
-        // AssertSame cannot be used as features is reinstantiated on each call
         $this->assertEquals([
             'basePath' => Hyde::getBasePath(),
             'sourceRoot' => Hyde::getSourceRoot(),

From 114c0a6b92123905ca0d7fe2975ddf4c605a572a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:28:38 +0200
Subject: [PATCH 1540/4023] Revert "Reboot entire kernel instead of just
 features"

This reverts commit b8632481524e977bcdba4ea1b7bd25165a3de26d.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index e8931f3f129..6114281437f 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,7 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
-        Hyde::boot();
+        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -35,7 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
-        Hyde::boot();
+        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -87,7 +87,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::boot();
+        Hyde::features()->boot();
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From 485edc27df8f0eb543f11ea7c593ecdf78e481da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:28:42 +0200
Subject: [PATCH 1541/4023] Revert "Reboot features after changing config"

This reverts commit 33ff559b9b9bdc86bc5cbce98f7e9049649d07e2.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 6114281437f..bd5168d390e 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,7 +27,6 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
-        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -35,7 +34,6 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
-        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -87,8 +85,6 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::features()->boot();
-
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',

From 2156da126f8f4bd196defc5b98330ebe50c62b5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:30:10 +0200
Subject: [PATCH 1542/4023] Revert "Revert "Reboot features after changing
 config""

This reverts commit 485edc27df8f0eb543f11ea7c593ecdf78e481da.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index bd5168d390e..6114281437f 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,6 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
+        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -34,6 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
+        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -85,6 +87,8 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
+        Hyde::features()->boot();
+
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',

From 7b0b346883c8060c2e2c48f7cb724e89081c9207 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:30:12 +0200
Subject: [PATCH 1543/4023] Revert "Revert "Reboot entire kernel instead of
 just features""

This reverts commit 114c0a6b92123905ca0d7fe2975ddf4c605a572a.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 6114281437f..e8931f3f129 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,7 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
-        Hyde::features()->boot();
+        Hyde::boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -35,7 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
-        Hyde::features()->boot();
+        Hyde::boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -87,7 +87,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::features()->boot();
+        Hyde::boot();
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From 8430d87297a53d71c86e142a1a488aa77103d80b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:30:51 +0200
Subject: [PATCH 1544/4023] Revert "Construct features on kernel boot"

This reverts commit 9365d12ba64122877c731bfb2b49061242459424.
---
 packages/framework/src/Foundation/Concerns/BootsHydeKernel.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
index 5ab718a1fd8..c680133cc9f 100644
--- a/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
+++ b/packages/framework/src/Foundation/Concerns/BootsHydeKernel.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Foundation\Concerns;
 
-use Hyde\Facades\Features;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
@@ -43,7 +42,6 @@ public function boot(): void
 
         $this->booting = true;
 
-        $this->features = new Features;
         $this->files = FileCollection::init($this);
         $this->pages = PageCollection::init($this);
         $this->routes = RouteCollection::init($this);

From 1783cae9a0766113f10d2efc26ec6084768bf449 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:31:22 +0200
Subject: [PATCH 1545/4023] Revert "Remove old todo"

This reverts commit 92c1b56067fbd5cb15dbb813d02c59cb5c3774fd.
---
 packages/framework/tests/Feature/HydeKernelTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 56b9c99e1b4..3de43152541 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -273,6 +273,7 @@ public function testPathToRelativeHelperReturnsRelativePathForGivenPath()
 
     public function testToArrayMethod()
     {
+        // AssertSame cannot be used as features is reinstantiated on each call
         $this->assertEquals([
             'basePath' => Hyde::getBasePath(),
             'sourceRoot' => Hyde::getSourceRoot(),

From ccbd683167cb830d5d9e4ff60f61b275678482e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:31:37 +0200
Subject: [PATCH 1546/4023] Assert same can now be used

---
 packages/framework/tests/Feature/HydeKernelTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 3de43152541..95cfd7fa999 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -273,8 +273,7 @@ public function testPathToRelativeHelperReturnsRelativePathForGivenPath()
 
     public function testToArrayMethod()
     {
-        // AssertSame cannot be used as features is reinstantiated on each call
-        $this->assertEquals([
+        $this->assertSame([
             'basePath' => Hyde::getBasePath(),
             'sourceRoot' => Hyde::getSourceRoot(),
             'outputDirectory' => Hyde::getOutputDirectory(),

From 06151d955e44b9ef0205b602c1ebb58cf80dfe17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:34:29 +0200
Subject: [PATCH 1547/4023] Revert "Revert "Revert "Reboot entire kernel
 instead of just features"""

This reverts commit 7b0b346883c8060c2e2c48f7cb724e89081c9207.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index e8931f3f129..6114281437f 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -27,7 +27,7 @@ protected function setUp(): void
     public function testHasDarkmode()
     {
         Config::set('hyde.features', []);
-        Hyde::boot();
+        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
 
@@ -35,7 +35,7 @@ public function testHasDarkmode()
             Features::darkmode(),
         ]);
 
-        Hyde::boot();
+        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
@@ -87,7 +87,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::boot();
+        Hyde::features()->boot();
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From 9c085be395933e589363de55c2460fbfc22efe8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:34:46 +0200
Subject: [PATCH 1548/4023] Revert "Revert "Expose boot method as public
 internal""

This reverts commit d2731b2c721970920f816837a768e8382cb45cb9.
---
 packages/framework/src/Facades/Features.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 1d70fd248f0..9e7b7a58af8 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -215,7 +215,8 @@ protected static function getDefaultOptions(): array
         ];
     }
 
-    protected function boot(): void
+    /** @internal Reboot the features from configuration. */
+    public function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
     }

From 9bd4ce0488f97df0ef50485c41255acc79316353 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:35:55 +0200
Subject: [PATCH 1549/4023] Deprecate helper methods needing rename

---
 packages/framework/src/Facades/Features.php | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 9e7b7a58af8..e869817b3f5 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -162,7 +162,11 @@ public static function torchlight(): string
     // in the config file, require preconditions to be met.
     // ====================================================
 
-    /** Can a sitemap be generated? */
+    /**
+     * @deprecated Rename to `hasSitemap`?
+     *
+     * Can a sitemap be generated?
+     */
     public static function sitemap(): bool
     {
         return static::resolveMockedInstance('sitemap') ?? Hyde::hasSiteUrl()
@@ -170,7 +174,11 @@ public static function sitemap(): bool
             && extension_loaded('simplexml');
     }
 
-    /** Can an RSS feed be generated? */
+    /**
+     * @deprecated Rename to `hasRss`?
+     *
+     * Can an RSS feed be generated?
+     */
     public static function rss(): bool
     {
         return static::resolveMockedInstance('rss') ?? Hyde::hasSiteUrl()

From 88044983c45f0830f71404515b6bfb8a55803651 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 10:37:29 +0200
Subject: [PATCH 1550/4023] Handle booted state using boolean property

---
 packages/framework/src/Facades/Features.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index e869817b3f5..472a7e069ad 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,6 +43,8 @@ class Features implements SerializableContract
      */
     protected array $enabled = [];
 
+    protected bool $booted = false;
+
     /** @experimental This method may change before its release. */
     public function getEnabled(): array
     {
@@ -227,12 +229,14 @@ protected static function getDefaultOptions(): array
     public function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
+
+        $this->booted = true;
     }
 
     /** @internal */
     public function booted(): static
     {
-        if ($this->enabled === []) {
+        if (! $this->booted) {
             $this->boot();
         }
 

From c320c6d4333f0b8ba14bde13a4c7c580163a6349 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 16:40:11 +0200
Subject: [PATCH 1551/4023] Construct features on demand

---
 packages/framework/src/Facades/Features.php     | 17 +++++------------
 .../framework/src/Foundation/HydeKernel.php     |  3 +--
 2 files changed, 6 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 472a7e069ad..dcda87b4dd1 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -45,11 +45,14 @@ class Features implements SerializableContract
 
     protected bool $booted = false;
 
+    public function __construct()
+    {
+        $this->boot();
+    }
+
     /** @experimental This method may change before its release. */
     public function getEnabled(): array
     {
-        $this->booted();
-
         return $this->enabled;
     }
 
@@ -232,14 +235,4 @@ public function boot(): void
 
         $this->booted = true;
     }
-
-    /** @internal */
-    public function booted(): static
-    {
-        if (! $this->booted) {
-            $this->boot();
-        }
-
-        return $this;
-    }
 }
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index ab50bce93fc..264406561b5 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -77,7 +77,6 @@ public function __construct(?string $basePath = null)
 
         $this->filesystem = new Filesystem($this);
         $this->hyperlinks = new Hyperlinks($this);
-        $this->features = new Features;
 
         $this->registerExtension(HydeCoreExtension::class);
     }
@@ -89,7 +88,7 @@ public static function version(): string
 
     public function features(): Features
     {
-        return $this->features->booted();
+        return $this->features ??= new Features();
     }
 
     public function hasFeature(string $feature): bool

From fa46d40c58a7e06dabde8b0f17de6f82874bf4cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 16:47:04 +0200
Subject: [PATCH 1552/4023] Refactor test to solve the right problems

We don't need to boot features when the real problem is doing it in the wrong order
---
 .../tests/Feature/DarkmodeFeatureTest.php       | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 6114281437f..0e8a72f95bf 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,11 +4,11 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
 /**
  * @covers \Hyde\Facades\Features::darkmode
@@ -24,31 +24,32 @@ protected function setUp(): void
         $this->mockPage();
     }
 
-    public function testHasDarkmode()
+    public function testHasDarkmodeIsFalseWhenNotSet()
     {
         Config::set('hyde.features', []);
-        Hyde::features()->boot();
 
         $this->assertFalse(Features::hasDarkmode());
+    }
 
+    public function testHasDarkmodeIsTrueWhenSet()
+    {
         Config::set('hyde.features', [
             Features::darkmode(),
         ]);
 
-        Hyde::features()->boot();
         $this->assertTrue(Features::hasDarkmode());
     }
 
     public function testLayoutHasToggleButtonAndScriptWhenEnabled()
     {
-        Hyde::boot();
-
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),
             Features::darkmode(),
         ]);
 
+        app()->instance('navigation.main', new MainNavigationMenu());
+
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',
@@ -80,14 +81,12 @@ public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
 
     public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     {
-        Hyde::boot();
-
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),
         ]);
 
-        Hyde::features()->boot();
+        app()->instance('navigation.main', new MainNavigationMenu());
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From 3ec67c60a3dac322ec54bb8b7f01dc7ba9e5cd17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 16:55:33 +0200
Subject: [PATCH 1553/4023] Revert "Revert "Revert "Expose boot method as
 public internal"""

This reverts commit 9c085be395933e589363de55c2460fbfc22efe8f.
---
 packages/framework/src/Facades/Features.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index dcda87b4dd1..c5f9fa03446 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -228,8 +228,7 @@ protected static function getDefaultOptions(): array
         ];
     }
 
-    /** @internal Reboot the features from configuration. */
-    public function boot(): void
+    protected function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
 

From 9a4ccde9aa09a62223e7fa75c2a4402a2a1e1dae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 16:57:05 +0200
Subject: [PATCH 1554/4023] Revert "Handle booted state using boolean property"

This reverts commit 88044983c45f0830f71404515b6bfb8a55803651.
---
 packages/framework/src/Facades/Features.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index c5f9fa03446..42e87e701ef 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,8 +43,6 @@ class Features implements SerializableContract
      */
     protected array $enabled = [];
 
-    protected bool $booted = false;
-
     public function __construct()
     {
         $this->boot();
@@ -231,7 +229,5 @@ protected static function getDefaultOptions(): array
     protected function boot(): void
     {
         $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
-
-        $this->booted = true;
     }
 }

From 3aeab66dddbe6020a10a410cc1a8e1458dde2db3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 16:58:37 +0200
Subject: [PATCH 1555/4023] Deprecate legacy methods in internal trait

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 02cee0f71aa..726c57a17a3 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -30,11 +30,13 @@ public static function mock(string|array $feature, ?bool $enabled = null): void
         static::$mockedInstances[$feature] = $enabled;
     }
 
+    /** @deprecated Will not be needed after refactor */
     public static function resolveMockedInstance(string $feature): ?bool
     {
         return static::$mockedInstances[$feature] ?? null;
     }
 
+    /** @deprecated Will not be needed after refactor */
     public static function clearMockedInstances(): void
     {
         static::$mockedInstances = [];

From 999bdfc7f606b8a8b77125236e6927475b74230f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 17:02:29 +0200
Subject: [PATCH 1556/4023] Protect internal method only used from its own
 scope

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 726c57a17a3..c141d90ec2f 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -31,7 +31,7 @@ public static function mock(string|array $feature, ?bool $enabled = null): void
     }
 
     /** @deprecated Will not be needed after refactor */
-    public static function resolveMockedInstance(string $feature): ?bool
+    protected static function resolveMockedInstance(string $feature): ?bool
     {
         return static::$mockedInstances[$feature] ?? null;
     }

From 79deaf4bf77eabd8a8de2e0042d606a444d431a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 17:45:14 +0200
Subject: [PATCH 1557/4023] Deprecate legacy internal array

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index c141d90ec2f..b933d7c684b 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -15,6 +15,7 @@
  */
 trait MockableFeatures
 {
+    /** @deprecated */
     protected static array $mockedInstances = [];
 
     public static function mock(string|array $feature, ?bool $enabled = null): void

From 64d823f7d62d40756439f27f222cd549de9148fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 18:10:18 +0200
Subject: [PATCH 1558/4023] New object oriented features class handling

---
 packages/framework/src/Facades/Features.php   | 37 ++++++++++---
 .../Concerns/Internal/MockableFeatures.php    | 10 +++-
 .../Feature/ConfigurableFeaturesTest.php      | 53 +++++++++----------
 3 files changed, 63 insertions(+), 37 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 42e87e701ef..6c30df3d91b 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -39,9 +39,9 @@ class Features implements SerializableContract
     /**
      * The features that are enabled.
      *
-     * @var array<string>
+     * @var array<string, bool>
      */
-    protected array $enabled = [];
+    protected array $features = [];
 
     public function __construct()
     {
@@ -49,9 +49,9 @@ public function __construct()
     }
 
     /** @experimental This method may change before its release. */
-    public function getEnabled(): array
+    public function getFeatures(): array
     {
-        return $this->enabled;
+        return $this->features;
     }
 
     /**
@@ -59,9 +59,7 @@ public function getEnabled(): array
      */
     public static function enabled(string $feature): bool
     {
-        return static::resolveMockedInstance($feature) ?? in_array(
-            $feature, Hyde::features()->getEnabled()
-        );
+        return Hyde::features()->getFeatures()[$feature] ?? false;
     }
 
     // ================================================
@@ -207,6 +205,7 @@ public function toArray(): array
             ])->toArray();
     }
 
+    /** @return array<string> */
     protected static function getDefaultOptions(): array
     {
         return [
@@ -228,6 +227,28 @@ protected static function getDefaultOptions(): array
 
     protected function boot(): void
     {
-        $this->enabled = Config::getArray('hyde.features', static::getDefaultOptions());
+        $options = static::getDefaultOptions();
+
+        $enabled = [];
+
+        // Set all default features to false
+        foreach ($options as $feature) {
+            $enabled[$feature] = false;
+        }
+
+        // Set all features to true if they are enabled in the config file
+        foreach ($this->getConfiguredFeatures() as $feature) {
+            if (in_array($feature, $options)) {
+                $enabled[$feature] = true;
+            }
+        }
+
+        $this->features = $enabled;
+    }
+
+    /** @return array<string> */
+    protected function getConfiguredFeatures(): array
+    {
+        return Config::getArray('hyde.features', static::getDefaultOptions());
     }
 }
diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index b933d7c684b..25b8fb74955 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Concerns\Internal;
 
+use Hyde\Hyde;
+
 use function is_array;
 
 /**
@@ -17,6 +19,7 @@ trait MockableFeatures
 {
     /** @deprecated */
     protected static array $mockedInstances = [];
+    protected array $mocks = [];
 
     public static function mock(string|array $feature, ?bool $enabled = null): void
     {
@@ -28,13 +31,18 @@ public static function mock(string|array $feature, ?bool $enabled = null): void
             return;
         }
 
+        $instance = Hyde::features();
+        $instance->features[$feature] = $enabled;
+
         static::$mockedInstances[$feature] = $enabled;
     }
 
     /** @deprecated Will not be needed after refactor */
     protected static function resolveMockedInstance(string $feature): ?bool
     {
-        return static::$mockedInstances[$feature] ?? null;
+        $instance = Hyde::features();
+
+        return $instance->features[$feature] ?? null;
     }
 
     /** @deprecated Will not be needed after refactor */
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index d81d1b46c9a..d56a11150bf 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -16,10 +16,9 @@ class ConfigurableFeaturesTest extends TestCase
     public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
     {
         Config::set('hyde.features', []);
-        // Foreach method in Features class that begins with "has"
+
         foreach (get_class_methods(Features::class) as $method) {
             if (str_starts_with($method, 'has')) {
-                // Call method and assert false
                 $this->assertFalse(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
             }
         }
@@ -27,18 +26,11 @@ public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
 
     public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
     {
-        $features = [];
         foreach (get_class_methods(Features::class) as $method) {
-            if (! str_starts_with($method, 'has') && $method !== 'enabled') {
-                $features[] = '\Hyde\Framework\Helpers\Features::'.$method.'()';
+            if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight') {
+                $this->assertTrue(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
             }
         }
-
-        Config::set('hyde.features', $features);
-
-        foreach ($features as $feature) {
-            $this->assertTrue(Features::enabled($feature), 'Method '.$feature.' should return true when feature is enabled');
-        }
     }
 
     public function testCanGenerateSitemapHelperReturnsTrueIfHydeHasBaseUrl()
@@ -131,7 +123,7 @@ public function testGetEnabledUsesDefaultOptionsByDefault()
 
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, $features->getEnabled());
+        $this->assertSame($default, $features->getFeatures());
     }
 
     public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
@@ -142,7 +134,7 @@ public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
 
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, $features->getEnabled());
+        $this->assertSame($default, $features->getFeatures());
     }
 
     public function testGetEnabledUsesConfiguredOptions()
@@ -152,11 +144,21 @@ public function testGetEnabledUsesConfiguredOptions()
             Features::markdownPosts(),
             Features::bladePages(),
         ];
+        $expected = [
+            Features::htmlPages() => true,
+            Features::markdownPosts() => true,
+            Features::bladePages() => true,
+            'markdown-pages' => false,
+            'documentation-pages' => false,
+            'darkmode' => false,
+            'documentation-search' => false,
+            'torchlight' => false,
+        ];
 
         config(['hyde.features' => $config]);
 
         $features = new Features();
-        $this->assertSame($config, $features->getEnabled());
+        $this->assertSame($expected, $features->getFeatures());
     }
 
     public function testCannotUseArbitraryValuesInEnabledOptions()
@@ -173,25 +175,20 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
         config(['hyde.features' => $config]);
 
         $features = new Features();
-        $this->assertSame(array_slice($config, 0, 3), $features->getEnabled());
+        $this->assertSame(array_slice($config, 0, 3), $features->getFeatures());
     }
 
     protected function defaultOptions(): array
     {
         return [
-            // Page Modules
-            Features::htmlPages(),
-            Features::markdownPosts(),
-            Features::bladePages(),
-            Features::markdownPages(),
-            Features::documentationPages(),
-
-            // Frontend Features
-            Features::darkmode(),
-            Features::documentationSearch(),
-
-            // Integrations
-            Features::torchlight(),
+            'html-pages' => true,
+            'markdown-posts' => true,
+            'blade-pages' => true,
+            'markdown-pages' => true,
+            'documentation-pages' => true,
+            'darkmode' => true,
+            'documentation-search' => true,
+            'torchlight' => true,
         ];
     }
 }

From d8af38c0fecd8a275c756bb16878450e46270cff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:05:35 +0200
Subject: [PATCH 1559/4023] Reenable accidentally implemented test

---
 .../tests/Feature/ConfigurableFeaturesTest.php      | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index d56a11150bf..f46820024da 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -163,8 +163,6 @@ public function testGetEnabledUsesConfiguredOptions()
 
     public function testCannotUseArbitraryValuesInEnabledOptions()
     {
-        $this->markTestSkipped('Todo: Implement if it is worth the complexity.');
-
         $config = [
             Features::htmlPages(),
             Features::markdownPosts(),
@@ -175,7 +173,16 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
         config(['hyde.features' => $config]);
 
         $features = new Features();
-        $this->assertSame(array_slice($config, 0, 3), $features->getFeatures());
+        $this->assertSame([
+            'html-pages' => true,
+            'markdown-posts' => true,
+            'blade-pages' => true,
+            'markdown-pages' => false,
+            'documentation-pages' => false,
+            'darkmode' => false,
+            'documentation-search' => false,
+            'torchlight' => false,
+        ], $features->getFeatures());
     }
 
     protected function defaultOptions(): array

From 9b0f0199c6b206962f9cabef9dc52d67f564d9af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:40:41 +0200
Subject: [PATCH 1560/4023] Remove legacy static mock container

---
 .../Framework/Concerns/Internal/MockableFeatures.php   | 10 ----------
 packages/testing/src/TestCase.php                      |  3 ---
 2 files changed, 13 deletions(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 25b8fb74955..09711254078 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -17,8 +17,6 @@
  */
 trait MockableFeatures
 {
-    /** @deprecated */
-    protected static array $mockedInstances = [];
     protected array $mocks = [];
 
     public static function mock(string|array $feature, ?bool $enabled = null): void
@@ -33,8 +31,6 @@ public static function mock(string|array $feature, ?bool $enabled = null): void
 
         $instance = Hyde::features();
         $instance->features[$feature] = $enabled;
-
-        static::$mockedInstances[$feature] = $enabled;
     }
 
     /** @deprecated Will not be needed after refactor */
@@ -44,10 +40,4 @@ protected static function resolveMockedInstance(string $feature): ?bool
 
         return $instance->features[$feature] ?? null;
     }
-
-    /** @deprecated Will not be needed after refactor */
-    public static function clearMockedInstances(): void
-    {
-        static::$mockedInstances = [];
-    }
 }
diff --git a/packages/testing/src/TestCase.php b/packages/testing/src/TestCase.php
index 9926306fb9d..aede20a5b2d 100644
--- a/packages/testing/src/TestCase.php
+++ b/packages/testing/src/TestCase.php
@@ -7,7 +7,6 @@
 use function config;
 use function file_get_contents;
 
-use Hyde\Facades\Features;
 use Hyde\Hyde;
 
 use function Hyde\normalize_newlines;
@@ -46,8 +45,6 @@ protected function tearDown(): void
             Component::forgetFactory();
         }
 
-        Features::clearMockedInstances();
-
         parent::tearDown();
     }
 

From 096ab032ef366c146b29e74f4c31c0957efdb0bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:41:53 +0200
Subject: [PATCH 1561/4023] Remove unused instance mock container

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php        | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 09711254078..c3d4ef24bcb 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -17,8 +17,6 @@
  */
 trait MockableFeatures
 {
-    protected array $mocks = [];
-
     public static function mock(string|array $feature, ?bool $enabled = null): void
     {
         if (is_array($feature)) {

From bd2ae0fb47c366bfeb9e81477e32a0147064a0c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:43:18 +0200
Subject: [PATCH 1562/4023] Inline local variables

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php   | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index c3d4ef24bcb..3a8abca6499 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -27,15 +27,12 @@ public static function mock(string|array $feature, ?bool $enabled = null): void
             return;
         }
 
-        $instance = Hyde::features();
-        $instance->features[$feature] = $enabled;
+        Hyde::features()->features[$feature] = $enabled;
     }
 
     /** @deprecated Will not be needed after refactor */
     protected static function resolveMockedInstance(string $feature): ?bool
     {
-        $instance = Hyde::features();
-
-        return $instance->features[$feature] ?? null;
+        return Hyde::features()->features[$feature] ?? null;
     }
 }

From f9c8181407ec1091659c43a33a50a7546721250d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:44:07 +0200
Subject: [PATCH 1563/4023] Annotate array generics

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 3a8abca6499..66502ef3995 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -17,6 +17,7 @@
  */
 trait MockableFeatures
 {
+    /** @param string|array<string, bool> $feature */
     public static function mock(string|array $feature, ?bool $enabled = null): void
     {
         if (is_array($feature)) {

From 4b77510843bd8bbff8a93b2fd22b12d147bdaa18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:44:29 +0200
Subject: [PATCH 1564/4023] Simplify mock helper types

---
 .../src/Framework/Concerns/Internal/MockableFeatures.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 66502ef3995..3dabb325ab9 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -18,7 +18,7 @@
 trait MockableFeatures
 {
     /** @param string|array<string, bool> $feature */
-    public static function mock(string|array $feature, ?bool $enabled = null): void
+    public static function mock(string|array $feature, bool $enabled = true): void
     {
         if (is_array($feature)) {
             foreach ($feature as $key => $value) {

From 148758a70f46389923e25b5bc3d89021462b6174 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 19:46:22 +0200
Subject: [PATCH 1565/4023] Replace recursive call with wrapped array loop

---
 .../Framework/Concerns/Internal/MockableFeatures.php   | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index 3dabb325ab9..bbcb892cfe9 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -20,15 +20,11 @@ trait MockableFeatures
     /** @param string|array<string, bool> $feature */
     public static function mock(string|array $feature, bool $enabled = true): void
     {
-        if (is_array($feature)) {
-            foreach ($feature as $key => $value) {
-                static::mock($key, $value);
-            }
+        $features = is_array($feature) ? $feature : [$feature => $enabled];
 
-            return;
+        foreach ($features as $feature => $enabled) {
+            Hyde::features()->features[$feature] = $enabled;
         }
-
-        Hyde::features()->features[$feature] = $enabled;
     }
 
     /** @deprecated Will not be needed after refactor */

From 76a5fb01ccc2a0eaa8d70f08d3c14536bf6220d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 20:00:21 +0200
Subject: [PATCH 1566/4023] Simplify to array method to use features instance

---
 packages/framework/src/Facades/Features.php | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 6c30df3d91b..f43bf03e556 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -10,14 +10,9 @@
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 use Hyde\Framework\Concerns\Internal\MockableFeatures;
-use Illuminate\Support\Str;
 
-use function get_class_methods;
 use function extension_loaded;
-use function str_starts_with;
 use function in_array;
-use function collect;
-use function substr;
 use function count;
 use function app;
 
@@ -198,11 +193,7 @@ public static function rss(): bool
      */
     public function toArray(): array
     {
-        return collect(get_class_methods(static::class))
-            ->filter(fn (string $method): bool => str_starts_with($method, 'has'))
-            ->mapWithKeys(fn (string $method): array => [
-                Str::kebab(substr($method, 3)) => static::{$method}(),
-            ])->toArray();
+        return $this->features;
     }
 
     /** @return array<string> */

From e40e7ae06e42df1df4711a12a760119ff0d00443 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 20:00:53 +0200
Subject: [PATCH 1567/4023] Rename `Features::sitemap()` method to
 `Features::hasSitemap()`

---
 packages/framework/src/Facades/Features.php               | 4 +---
 .../src/Framework/Features/Metadata/GlobalMetadataBag.php | 2 +-
 .../framework/src/Framework/Services/BuildTaskService.php | 2 +-
 .../framework/tests/Feature/ConfigurableFeaturesTest.php  | 8 ++++----
 4 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index f43bf03e556..fd29dbcd209 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -159,11 +159,9 @@ public static function torchlight(): string
     // ====================================================
 
     /**
-     * @deprecated Rename to `hasSitemap`?
-     *
      * Can a sitemap be generated?
      */
-    public static function sitemap(): bool
+    public static function hasSitemap(): bool
     {
         return static::resolveMockedInstance('sitemap') ?? Hyde::hasSiteUrl()
             && Config::getBool('hyde.generate_sitemap', true)
diff --git a/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php b/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
index f96688c2445..7501be2b234 100644
--- a/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
+++ b/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
@@ -28,7 +28,7 @@ public static function make(): static
             $metadata->add($item);
         }
 
-        if (Features::sitemap()) {
+        if (Features::hasSitemap()) {
             $metadata->add(Meta::link('sitemap', Hyde::url('sitemap.xml'), [
                 'type' => 'application/xml', 'title' => 'Sitemap',
             ]));
diff --git a/packages/framework/src/Framework/Services/BuildTaskService.php b/packages/framework/src/Framework/Services/BuildTaskService.php
index 78176329d89..66526db0f06 100644
--- a/packages/framework/src/Framework/Services/BuildTaskService.php
+++ b/packages/framework/src/Framework/Services/BuildTaskService.php
@@ -156,7 +156,7 @@ private function canGenerateManifest(): bool
 
     private function canGenerateSitemap(): bool
     {
-        return Features::sitemap();
+        return Features::hasSitemap();
     }
 
     private function canGenerateFeed(): bool
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index f46820024da..664eb4dc7ba 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -18,7 +18,7 @@ public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
         Config::set('hyde.features', []);
 
         foreach (get_class_methods(Features::class) as $method) {
-            if (str_starts_with($method, 'has')) {
+            if (str_starts_with($method, 'has') && $method !== 'hasSitemap') {
                 $this->assertFalse(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
             }
         }
@@ -36,20 +36,20 @@ public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
     public function testCanGenerateSitemapHelperReturnsTrueIfHydeHasBaseUrl()
     {
         config(['hyde.url' => 'foo']);
-        $this->assertTrue(Features::sitemap());
+        $this->assertTrue(Features::hasSitemap());
     }
 
     public function testCanGenerateSitemapHelperReturnsFalseIfHydeDoesNotHaveBaseUrl()
     {
         config(['hyde.url' => '']);
-        $this->assertFalse(Features::sitemap());
+        $this->assertFalse(Features::hasSitemap());
     }
 
     public function testCanGenerateSitemapHelperReturnsFalseIfSitemapsAreDisabledInConfig()
     {
         config(['hyde.url' => 'foo']);
         config(['hyde.generate_sitemap' => false]);
-        $this->assertFalse(Features::sitemap());
+        $this->assertFalse(Features::hasSitemap());
     }
 
     public function testToArrayMethodReturnsMethodArray()

From ad47207839ea986a21220b49e864eb0ba38a4f5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Apr 2024 21:18:38 +0200
Subject: [PATCH 1568/4023] Rename `Features::rss()` method to
 `Features::hasRss()`

---
 packages/framework/src/Facades/Features.php            |  4 +---
 .../Framework/Features/Metadata/GlobalMetadataBag.php  |  2 +-
 .../src/Framework/Services/BuildTaskService.php        |  2 +-
 .../tests/Feature/ConfigurableFeaturesTest.php         | 10 +++++-----
 .../tests/Feature/Services/RssFeedServiceTest.php      |  6 +++---
 5 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index fd29dbcd209..8bc7c1994b1 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -169,11 +169,9 @@ public static function hasSitemap(): bool
     }
 
     /**
-     * @deprecated Rename to `hasRss`?
-     *
      * Can an RSS feed be generated?
      */
-    public static function rss(): bool
+    public static function hasRss(): bool
     {
         return static::resolveMockedInstance('rss') ?? Hyde::hasSiteUrl()
             && static::hasMarkdownPosts()
diff --git a/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php b/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
index 7501be2b234..b0a2886fbb6 100644
--- a/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
+++ b/packages/framework/src/Framework/Features/Metadata/GlobalMetadataBag.php
@@ -34,7 +34,7 @@ public static function make(): static
             ]));
         }
 
-        if (Features::rss()) {
+        if (Features::hasRss()) {
             $metadata->add(Meta::link('alternate', Hyde::url(RssFeedGenerator::getFilename()), [
                 'type' => 'application/rss+xml', 'title' => RssFeedGenerator::getDescription(),
             ]));
diff --git a/packages/framework/src/Framework/Services/BuildTaskService.php b/packages/framework/src/Framework/Services/BuildTaskService.php
index 66526db0f06..d71d646f7a0 100644
--- a/packages/framework/src/Framework/Services/BuildTaskService.php
+++ b/packages/framework/src/Framework/Services/BuildTaskService.php
@@ -161,6 +161,6 @@ private function canGenerateSitemap(): bool
 
     private function canGenerateFeed(): bool
     {
-        return Features::rss();
+        return Features::hasRss();
     }
 }
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 664eb4dc7ba..20980d5380d 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -27,7 +27,7 @@ public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
     public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
     {
         foreach (get_class_methods(Features::class) as $method) {
-            if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight') {
+            if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight' && $method !== 'hasRss') {
                 $this->assertTrue(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
             }
         }
@@ -92,10 +92,10 @@ public function testFeaturesCanBeMocked()
     public function testDynamicFeaturesCanBeMocked()
     {
         Features::mock('rss', true);
-        $this->assertTrue(Features::rss());
+        $this->assertTrue(Features::hasRss());
 
         Features::mock('rss', false);
-        $this->assertFalse(Features::rss());
+        $this->assertFalse(Features::hasRss());
     }
 
     public function testMultipleFeaturesCanBeMocked()
@@ -105,7 +105,7 @@ public function testMultipleFeaturesCanBeMocked()
             'darkmode' => true,
         ]);
 
-        $this->assertTrue(Features::rss());
+        $this->assertTrue(Features::hasRss());
         $this->assertTrue(Features::hasDarkmode());
 
         Features::mock([
@@ -113,7 +113,7 @@ public function testMultipleFeaturesCanBeMocked()
             'darkmode' => false,
         ]);
 
-        $this->assertFalse(Features::rss());
+        $this->assertFalse(Features::hasRss());
         $this->assertFalse(Features::hasDarkmode());
     }
 
diff --git a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
index 475fb7705d9..94f6bc0698e 100644
--- a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
+++ b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
@@ -136,20 +136,20 @@ public function testCanGenerateFeedHelperReturnsTrueIfHydeHasBaseUrl()
     {
         config(['hyde.url' => 'foo']);
         $this->file('_posts/foo.md');
-        $this->assertTrue(Features::rss());
+        $this->assertTrue(Features::hasRss());
     }
 
     public function testCanGenerateFeedHelperReturnsFalseIfHydeDoesNotHaveBaseUrl()
     {
         config(['hyde.url' => '']);
         $this->file('_posts/foo.md');
-        $this->assertFalse(Features::rss());
+        $this->assertFalse(Features::hasRss());
     }
 
     public function testCanGenerateFeedHelperReturnsFalseIfFeedsAreDisabledInConfig()
     {
         config(['hyde.url' => 'foo']);
         config(['hyde.rss.enabled' => false]);
-        $this->assertFalse(Features::rss());
+        $this->assertFalse(Features::hasRss());
     }
 }

From 5565deff43c1750c0d17d2ce2261eab864fa9638 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:22:18 +0200
Subject: [PATCH 1569/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 90bac911835..6c97a25f26c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -83,6 +83,17 @@ want to adapt your code to interact with the new `InMemoryPage`, which is genera
 
 For more information, see https://github.com/hydephp/develop/pull/1498.
 
+## Medium impact
+
+### Features class method renames
+
+The following methods in the `Features` class have been renamed to follow a more consistent naming convention:
+
+- `Features::sitemap()` has been renamed to `Features::hasSitemap()`
+- `Features::rss()` has been renamed to `Features::hasRss()`
+
+Note that this class was previously marked as internal in v1, but the change is logged here in case it was used in configuration files or custom code.
+
 ## Low impact
 
 ### Navigation internal changes

From 66c84cede52a88b2c50257863fc91b4269321a0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:24:08 +0200
Subject: [PATCH 1570/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 6c97a25f26c..fca93a49971 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,6 +11,7 @@ This serves two purposes:
 
 ### Added
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
+- The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.

From 954b7c54702f5ef9e94b2018e56c35a4a09fae3c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:25:55 +0200
Subject: [PATCH 1571/4023] Remove legacy internal mocking helpers

This means that dynamic features can no longer be mocked, but since we are actually not using this anywhere as far as I can tell we don't need the complexity for it.
---
 packages/framework/src/Facades/Features.php     |  4 ++--
 .../Concerns/Internal/MockableFeatures.php      |  6 ------
 .../tests/Feature/ConfigurableFeaturesTest.php  | 17 ++++-------------
 3 files changed, 6 insertions(+), 21 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 8bc7c1994b1..09d26146330 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -163,7 +163,7 @@ public static function torchlight(): string
      */
     public static function hasSitemap(): bool
     {
-        return static::resolveMockedInstance('sitemap') ?? Hyde::hasSiteUrl()
+        return Hyde::hasSiteUrl()
             && Config::getBool('hyde.generate_sitemap', true)
             && extension_loaded('simplexml');
     }
@@ -173,7 +173,7 @@ public static function hasSitemap(): bool
      */
     public static function hasRss(): bool
     {
-        return static::resolveMockedInstance('rss') ?? Hyde::hasSiteUrl()
+        return Hyde::hasSiteUrl()
             && static::hasMarkdownPosts()
             && Config::getBool('hyde.rss.enabled', true)
             && extension_loaded('simplexml')
diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
index bbcb892cfe9..c41baa11878 100644
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
@@ -26,10 +26,4 @@ public static function mock(string|array $feature, bool $enabled = true): void
             Hyde::features()->features[$feature] = $enabled;
         }
     }
-
-    /** @deprecated Will not be needed after refactor */
-    protected static function resolveMockedInstance(string $feature): ?bool
-    {
-        return Hyde::features()->features[$feature] ?? null;
-    }
 }
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 20980d5380d..86ddc83028c 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -89,31 +89,22 @@ public function testFeaturesCanBeMocked()
         $this->assertFalse(Features::hasDarkmode());
     }
 
-    public function testDynamicFeaturesCanBeMocked()
-    {
-        Features::mock('rss', true);
-        $this->assertTrue(Features::hasRss());
-
-        Features::mock('rss', false);
-        $this->assertFalse(Features::hasRss());
-    }
-
     public function testMultipleFeaturesCanBeMocked()
     {
         Features::mock([
-            'rss' => true,
+            'blade-pages' => true,
             'darkmode' => true,
         ]);
 
-        $this->assertTrue(Features::hasRss());
+        $this->assertTrue(Features::hasBladePages());
         $this->assertTrue(Features::hasDarkmode());
 
         Features::mock([
-            'rss' => false,
+            'blade-pages' => false,
             'darkmode' => false,
         ]);
 
-        $this->assertFalse(Features::hasRss());
+        $this->assertFalse(Features::hasBladePages());
         $this->assertFalse(Features::hasDarkmode());
     }
 

From 863eebf89c388fe71abba670233ddbb1ba2180a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:46:27 +0200
Subject: [PATCH 1572/4023] Add todo

---
 packages/framework/src/Facades/Features.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 09d26146330..9191fbf6c2b 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -51,6 +51,8 @@ public function getFeatures(): array
 
     /**
      * Determine if the given specified is enabled.
+     *
+     * @todo Rename to has() and add new enabled method to get just the enabled options array, and another called options/status/similar to get all options with their status.
      */
     public static function enabled(string $feature): bool
     {

From f93c2071501aad6861b07b4b4020a0e65fe13152 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:47:11 +0200
Subject: [PATCH 1573/4023] Fix wrong assertion message

---
 packages/framework/tests/Feature/ConfigurableFeaturesTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 86ddc83028c..ef35fc06071 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -28,7 +28,7 @@ public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
     {
         foreach (get_class_methods(Features::class) as $method) {
             if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight' && $method !== 'hasRss') {
-                $this->assertTrue(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
+                $this->assertTrue(Features::$method(), 'Method '.$method.' should return true when feature is enabled');
             }
         }
     }

From 97ac539936bafdd229a691e3c98754f992c58638 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:48:12 +0200
Subject: [PATCH 1574/4023] Extract testing helpers

---
 .../tests/Feature/ConfigurableFeaturesTest.php     | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index ef35fc06071..23b519cdddb 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -19,7 +19,7 @@ public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
 
         foreach (get_class_methods(Features::class) as $method) {
             if (str_starts_with($method, 'has') && $method !== 'hasSitemap') {
-                $this->assertFalse(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
+                $this->expectMethodReturnsFalse($method);
             }
         }
     }
@@ -28,7 +28,7 @@ public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
     {
         foreach (get_class_methods(Features::class) as $method) {
             if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight' && $method !== 'hasRss') {
-                $this->assertTrue(Features::$method(), 'Method '.$method.' should return true when feature is enabled');
+                $this->expectMethodReturnsTrue($method);
             }
         }
     }
@@ -189,4 +189,14 @@ protected function defaultOptions(): array
             'torchlight' => true,
         ];
     }
+
+    protected function expectMethodReturnsFalse(string $method): void
+    {
+        $this->assertFalse(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
+    }
+
+    protected function expectMethodReturnsTrue(string $method): void
+    {
+        $this->assertTrue(Features::$method(), 'Method '.$method.' should return true when feature is enabled');
+    }
 }

From c2679319df8da5e6929a5cb861f262616f8dc0b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:49:08 +0200
Subject: [PATCH 1575/4023] Convert concatenation to better formatted string
 interpolation

---
 packages/framework/tests/Feature/ConfigurableFeaturesTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 23b519cdddb..102173b3acc 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -192,11 +192,11 @@ protected function defaultOptions(): array
 
     protected function expectMethodReturnsFalse(string $method): void
     {
-        $this->assertFalse(Features::$method(), 'Method '.$method.' should return false when feature is not enabled');
+        $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
     }
 
     protected function expectMethodReturnsTrue(string $method): void
     {
-        $this->assertTrue(Features::$method(), 'Method '.$method.' should return true when feature is enabled');
+        $this->assertTrue(Features::$method(), "Method '$method' should return true when feature is enabled");
     }
 }

From 6f25606fbb315ce7142aac2b6b37acc5cab8470a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 12:59:14 +0200
Subject: [PATCH 1576/4023] Split out unintuitive loop to standalone tests

---
 .../Feature/ConfigurableFeaturesTest.php      | 88 ++++++++++++++++---
 1 file changed, 75 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 102173b3acc..f61156363b7 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -13,24 +13,84 @@
  */
 class ConfigurableFeaturesTest extends TestCase
 {
-    public function testHasFeatureReturnsFalseWhenFeatureIsNotEnabled()
+    public function testHasHtmlPagesReturnsFalseWhenFeatureIsNotEnabled()
     {
-        Config::set('hyde.features', []);
+        $this->expectMethodReturnsFalse('hasHtmlPages');
+    }
 
-        foreach (get_class_methods(Features::class) as $method) {
-            if (str_starts_with($method, 'has') && $method !== 'hasSitemap') {
-                $this->expectMethodReturnsFalse($method);
-            }
-        }
+    public function testHasBladePagesReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasBladePages');
     }
 
-    public function testHasFeatureReturnsTrueWhenFeatureIsEnabled()
+    public function testHasMarkdownPagesReturnsFalseWhenFeatureIsNotEnabled()
     {
-        foreach (get_class_methods(Features::class) as $method) {
-            if (str_starts_with($method, 'has') && $method !== 'hasDocumentationSearch' && $method !== 'hasTorchlight' && $method !== 'hasRss') {
-                $this->expectMethodReturnsTrue($method);
-            }
-        }
+        $this->expectMethodReturnsFalse('hasMarkdownPages');
+    }
+
+    public function testHasMarkdownPostsReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasMarkdownPosts');
+    }
+
+    public function testHasDocumentationPagesReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasDocumentationPages');
+    }
+
+    public function testHasDocumentationSearchReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasDocumentationSearch');
+    }
+
+    public function testHasDarkmodeReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasDarkmode');
+    }
+
+    public function testHasTorchlightReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasTorchlight');
+    }
+
+    public function testHasRssReturnsFalseWhenFeatureIsNotEnabled()
+    {
+        $this->expectMethodReturnsFalse('hasRss');
+    }
+
+    public function testHasHtmlPagesReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasHtmlPages');
+    }
+
+    public function testHasBladePagesReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasBladePages');
+    }
+
+    public function testHasMarkdownPagesReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasMarkdownPages');
+    }
+
+    public function testHasMarkdownPostsReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasMarkdownPosts');
+    }
+
+    public function testHasDocumentationPagesReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasDocumentationPages');
+    }
+
+    public function testHasDarkmodeReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasDarkmode');
+    }
+
+    public function testHasSitemapReturnsTrueWhenFeatureIsEnabled()
+    {
+        $this->expectMethodReturnsTrue('hasSitemap');
     }
 
     public function testCanGenerateSitemapHelperReturnsTrueIfHydeHasBaseUrl()
@@ -192,6 +252,8 @@ protected function defaultOptions(): array
 
     protected function expectMethodReturnsFalse(string $method): void
     {
+        Config::set('hyde.features', []);
+
         $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
     }
 

From 56850ce660be77707525a4ebd689ad5b28c18c7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 13:15:05 +0200
Subject: [PATCH 1577/4023] Rename `Features::enabled()` method to
 `Features::has()`

---
 RELEASE_NOTES.md                              |  1 +
 packages/framework/src/Facades/Features.php   | 21 +++++++++----------
 .../framework/src/Foundation/HydeKernel.php   |  2 +-
 .../Framework/Services/ValidationService.php  |  2 +-
 .../tests/Feature/HydeKernelTest.php          |  2 +-
 5 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index fca93a49971..9291bf16b26 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -90,6 +90,7 @@ For more information, see https://github.com/hydephp/develop/pull/1498.
 
 The following methods in the `Features` class have been renamed to follow a more consistent naming convention:
 
+- `Features::enabled()` has been renamed to `Features::has()`
 - `Features::sitemap()` has been renamed to `Features::hasSitemap()`
 - `Features::rss()` has been renamed to `Features::hasRss()`
 
diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 9191fbf6c2b..b1ba9f4d705 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -22,6 +22,7 @@
  * @internal Until this class is split into a service/manager class, it should not be used outside of Hyde as the API is subject to change.
  *
  * @todo Split facade logic to service/manager class. (Initial and mock data could be set with boot/set methods)
+ * @todo Add new enabled method to get just the enabled options array, and another called options/status/similar to get all options with their status.
  * Based entirely on Laravel Jetstream (License MIT)
  *
  * @see https://jetstream.laravel.com/
@@ -51,10 +52,8 @@ public function getFeatures(): array
 
     /**
      * Determine if the given specified is enabled.
-     *
-     * @todo Rename to has() and add new enabled method to get just the enabled options array, and another called options/status/similar to get all options with their status.
      */
-    public static function enabled(string $feature): bool
+    public static function has(string $feature): bool
     {
         return Hyde::features()->getFeatures()[$feature] ?? false;
     }
@@ -65,39 +64,39 @@ public static function enabled(string $feature): bool
 
     public static function hasHtmlPages(): bool
     {
-        return static::enabled(static::htmlPages());
+        return static::has(static::htmlPages());
     }
 
     public static function hasBladePages(): bool
     {
-        return static::enabled(static::bladePages());
+        return static::has(static::bladePages());
     }
 
     public static function hasMarkdownPages(): bool
     {
-        return static::enabled(static::markdownPages());
+        return static::has(static::markdownPages());
     }
 
     public static function hasMarkdownPosts(): bool
     {
-        return static::enabled(static::markdownPosts());
+        return static::has(static::markdownPosts());
     }
 
     public static function hasDocumentationPages(): bool
     {
-        return static::enabled(static::documentationPages());
+        return static::has(static::documentationPages());
     }
 
     public static function hasDocumentationSearch(): bool
     {
-        return static::enabled(static::documentationSearch())
+        return static::has(static::documentationSearch())
             && static::hasDocumentationPages()
             && count(DocumentationPage::files()) > 0;
     }
 
     public static function hasDarkmode(): bool
     {
-        return static::enabled(static::darkmode());
+        return static::has(static::darkmode());
     }
 
     /**
@@ -106,7 +105,7 @@ public static function hasDarkmode(): bool
      */
     public static function hasTorchlight(): bool
     {
-        return static::enabled(static::torchlight())
+        return static::has(static::torchlight())
             && (Config::getNullableString('torchlight.token') !== null)
             && (app('env') !== 'testing');
     }
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index 264406561b5..a3494286e10 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -93,7 +93,7 @@ public function features(): Features
 
     public function hasFeature(string $feature): bool
     {
-        return Features::enabled($feature);
+        return Features::has($feature);
     }
 
     /** @inheritDoc */
diff --git a/packages/framework/src/Framework/Services/ValidationService.php b/packages/framework/src/Framework/Services/ValidationService.php
index da7c0fa7db0..fc62734ce59 100644
--- a/packages/framework/src/Framework/Services/ValidationService.php
+++ b/packages/framework/src/Framework/Services/ValidationService.php
@@ -121,7 +121,7 @@ public function check_site_has_a_base_url_set(Result $result): Result
 
     public function check_a_torchlight_api_token_is_set(Result $result): Result
     {
-        if (! Features::enabled(Features::torchlight())) {
+        if (! Features::has(Features::torchlight())) {
             return $result->skip('Check a Torchlight API token is set')
                 ->withTip('Torchlight is an API for code syntax highlighting. You can enable it in the Hyde config.');
         }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 95cfd7fa999..b7beb1b07be 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -76,7 +76,7 @@ public function testFeaturesHelperReturnsNewFeaturesInstance()
 
     public function testHasFeatureHelperCallsMethodOnFeaturesClass()
     {
-        $this->assertSame(Features::enabled('foo'), Hyde::hasFeature('foo'));
+        $this->assertSame(Features::has('foo'), Hyde::hasFeature('foo'));
     }
 
     public function testCurrentPageHelperReturnsCurrentPageName()

From c2148f306f3e18fce9d964f433f60843c9963452 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:01:50 +0200
Subject: [PATCH 1578/4023] Add new enabled method

---
 packages/framework/src/Facades/Features.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b1ba9f4d705..b4b9f5449b4 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -11,6 +11,8 @@
 use Hyde\Support\Contracts\SerializableContract;
 use Hyde\Framework\Concerns\Internal\MockableFeatures;
 
+use function array_keys;
+use function array_filter;
 use function extension_loaded;
 use function in_array;
 use function count;
@@ -58,6 +60,11 @@ public static function has(string $feature): bool
         return Hyde::features()->getFeatures()[$feature] ?? false;
     }
 
+    public static function enabled(): array
+    {
+        return array_keys(array_filter(Hyde::features()->getFeatures()));
+    }
+
     // ================================================
     // Determine if a given feature is enabled.
     // ================================================

From ced81d02cff6a54fc89ea8e903df1402b28b8649 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:02:07 +0200
Subject: [PATCH 1579/4023] Check enabled state using new helper

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b4b9f5449b4..623cacdec8b 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -57,7 +57,7 @@ public function getFeatures(): array
      */
     public static function has(string $feature): bool
     {
-        return Hyde::features()->getFeatures()[$feature] ?? false;
+        return in_array($feature, static::enabled());
     }
 
     public static function enabled(): array

From f83878daf8bcfc424491916afba75dd4fe19a0ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:02:17 +0200
Subject: [PATCH 1580/4023] Assert using simpler helper

---
 .../tests/Feature/ConfigurableFeaturesTest.php      | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index f61156363b7..417268b9f8a 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -225,15 +225,10 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
 
         $features = new Features();
         $this->assertSame([
-            'html-pages' => true,
-            'markdown-posts' => true,
-            'blade-pages' => true,
-            'markdown-pages' => false,
-            'documentation-pages' => false,
-            'darkmode' => false,
-            'documentation-search' => false,
-            'torchlight' => false,
-        ], $features->getFeatures());
+            'html-pages',
+            'markdown-posts',
+            'blade-pages',
+        ], $features->enabled());
     }
 
     protected function defaultOptions(): array

From d3ccec34c397ff23d98e89624a4a1de90188360c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:15:49 +0200
Subject: [PATCH 1581/4023] Annotate method description and generics

---
 packages/framework/src/Facades/Features.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 623cacdec8b..222817aeecd 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -60,6 +60,11 @@ public static function has(string $feature): bool
         return in_array($feature, static::enabled());
     }
 
+    /**
+     * Get all enabled features.
+     *
+     * @return array<string>
+     */
     public static function enabled(): array
     {
         return array_keys(array_filter(Hyde::features()->getFeatures()));

From 3589da1c39da00977e26efcf101aff596358bb73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:17:26 +0200
Subject: [PATCH 1582/4023] Move up method in class

---
 packages/framework/src/Facades/Features.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 222817aeecd..761d9bf132d 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -99,6 +99,11 @@ public static function hasDocumentationPages(): bool
         return static::has(static::documentationPages());
     }
 
+    public static function hasDarkmode(): bool
+    {
+        return static::has(static::darkmode());
+    }
+
     public static function hasDocumentationSearch(): bool
     {
         return static::has(static::documentationSearch())
@@ -106,11 +111,6 @@ public static function hasDocumentationSearch(): bool
             && count(DocumentationPage::files()) > 0;
     }
 
-    public static function hasDarkmode(): bool
-    {
-        return static::has(static::darkmode());
-    }
-
     /**
      * Torchlight is by default enabled automatically when an API token
      * is set in the .env file but is disabled when running tests.

From 6d4097c5e3f4429b8212a09b51fd107f9136623b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:19:21 +0200
Subject: [PATCH 1583/4023] Move down methods in class

---
 packages/framework/src/Facades/Features.php | 36 ++++++++++-----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 761d9bf132d..6fcfe3e8f90 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -104,24 +104,6 @@ public static function hasDarkmode(): bool
         return static::has(static::darkmode());
     }
 
-    public static function hasDocumentationSearch(): bool
-    {
-        return static::has(static::documentationSearch())
-            && static::hasDocumentationPages()
-            && count(DocumentationPage::files()) > 0;
-    }
-
-    /**
-     * Torchlight is by default enabled automatically when an API token
-     * is set in the .env file but is disabled when running tests.
-     */
-    public static function hasTorchlight(): bool
-    {
-        return static::has(static::torchlight())
-            && (Config::getNullableString('torchlight.token') !== null)
-            && (app('env') !== 'testing');
-    }
-
     // =================================================
     // Configure features to be used in the config file.
     // =================================================
@@ -193,6 +175,24 @@ public static function hasRss(): bool
             && count(MarkdownPost::files()) > 0;
     }
 
+    /**
+     * Torchlight is by default enabled automatically when an API token
+     * is set in the .env file but is disabled when running tests.
+     */
+    public static function hasTorchlight(): bool
+    {
+        return static::has(static::torchlight())
+            && (Config::getNullableString('torchlight.token') !== null)
+            && (app('env') !== 'testing');
+    }
+
+    public static function hasDocumentationSearch(): bool
+    {
+        return static::has(static::documentationSearch())
+            && static::hasDocumentationPages()
+            && count(DocumentationPage::files()) > 0;
+    }
+
     /**
      * Get an array representation of the features and their status.
      *

From 35dc20fe9989eaa1f743ab3cabef58bf9e44356c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:21:27 +0200
Subject: [PATCH 1584/4023] Move up method blocks in class

---
 packages/framework/src/Facades/Features.php | 68 ++++++++++-----------
 1 file changed, 34 insertions(+), 34 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 6fcfe3e8f90..305a0b16faa 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -70,40 +70,6 @@ public static function enabled(): array
         return array_keys(array_filter(Hyde::features()->getFeatures()));
     }
 
-    // ================================================
-    // Determine if a given feature is enabled.
-    // ================================================
-
-    public static function hasHtmlPages(): bool
-    {
-        return static::has(static::htmlPages());
-    }
-
-    public static function hasBladePages(): bool
-    {
-        return static::has(static::bladePages());
-    }
-
-    public static function hasMarkdownPages(): bool
-    {
-        return static::has(static::markdownPages());
-    }
-
-    public static function hasMarkdownPosts(): bool
-    {
-        return static::has(static::markdownPosts());
-    }
-
-    public static function hasDocumentationPages(): bool
-    {
-        return static::has(static::documentationPages());
-    }
-
-    public static function hasDarkmode(): bool
-    {
-        return static::has(static::darkmode());
-    }
-
     // =================================================
     // Configure features to be used in the config file.
     // =================================================
@@ -148,6 +114,40 @@ public static function torchlight(): string
         return 'torchlight';
     }
 
+    // ================================================
+    // Determine if a given feature is enabled.
+    // ================================================
+
+    public static function hasHtmlPages(): bool
+    {
+        return static::has(static::htmlPages());
+    }
+
+    public static function hasBladePages(): bool
+    {
+        return static::has(static::bladePages());
+    }
+
+    public static function hasMarkdownPages(): bool
+    {
+        return static::has(static::markdownPages());
+    }
+
+    public static function hasMarkdownPosts(): bool
+    {
+        return static::has(static::markdownPosts());
+    }
+
+    public static function hasDocumentationPages(): bool
+    {
+        return static::has(static::documentationPages());
+    }
+
+    public static function hasDarkmode(): bool
+    {
+        return static::has(static::darkmode());
+    }
+
     // ====================================================
     // Dynamic features that in addition to being enabled
     // in the config file, require preconditions to be met.

From 72d17a0050056f63ae74fb1a7575d9f20c270f7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:22:32 +0200
Subject: [PATCH 1585/4023] Change boot method data flow

---
 packages/framework/src/Facades/Features.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 305a0b16faa..7e0f5e57464 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,7 +43,7 @@ class Features implements SerializableContract
 
     public function __construct()
     {
-        $this->boot();
+        $this->features = $this->boot();
     }
 
     /** @experimental This method may change before its release. */
@@ -225,7 +225,7 @@ protected static function getDefaultOptions(): array
         ];
     }
 
-    protected function boot(): void
+    protected function boot(): array
     {
         $options = static::getDefaultOptions();
 
@@ -243,7 +243,7 @@ protected function boot(): void
             }
         }
 
-        $this->features = $enabled;
+        return $enabled;
     }
 
     /** @return array<string> */

From efba943e572d329d00406f9e57a044d796da072d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:27:28 +0200
Subject: [PATCH 1586/4023] Refactor features getter to be static

---
 packages/framework/src/Facades/Features.php      | 16 ++++++++++------
 .../tests/Feature/ConfigurableFeaturesTest.php   | 11 +++--------
 2 files changed, 13 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 7e0f5e57464..69c1c873007 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -46,12 +46,6 @@ public function __construct()
         $this->features = $this->boot();
     }
 
-    /** @experimental This method may change before its release. */
-    public function getFeatures(): array
-    {
-        return $this->features;
-    }
-
     /**
      * Determine if the given specified is enabled.
      */
@@ -70,6 +64,16 @@ public static function enabled(): array
         return array_keys(array_filter(Hyde::features()->getFeatures()));
     }
 
+    /**
+     * Get all features and their status.
+     *
+     * @return array<string, bool>
+     */
+    public static function getFeatures(): array
+    {
+        return Hyde::features()->toArray();
+    }
+
     // =================================================
     // Configure features to be used in the config file.
     // =================================================
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 417268b9f8a..b3201ae3a6f 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -170,22 +170,18 @@ public function testMultipleFeaturesCanBeMocked()
 
     public function testGetEnabledUsesDefaultOptionsByDefault()
     {
-        $features = new Features();
-
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, $features->getFeatures());
+        $this->assertSame($default, Features::getFeatures());
     }
 
     public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
     {
         config(['hyde' => []]);
 
-        $features = new Features();
-
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, $features->getFeatures());
+        $this->assertSame($default, Features::getFeatures());
     }
 
     public function testGetEnabledUsesConfiguredOptions()
@@ -208,8 +204,7 @@ public function testGetEnabledUsesConfiguredOptions()
 
         config(['hyde.features' => $config]);
 
-        $features = new Features();
-        $this->assertSame($expected, $features->getFeatures());
+        $this->assertSame($expected, Features::getFeatures());
     }
 
     public function testCannotUseArbitraryValuesInEnabledOptions()

From 3ba47273486b1ea1b2b4af502c44c5bc44f6f529 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:41:58 +0200
Subject: [PATCH 1587/4023] Inline internal mockable features class

---
 packages/framework/src/Facades/Features.php   | 17 +++++++++--
 .../Concerns/Internal/MockableFeatures.php    | 29 -------------------
 2 files changed, 15 insertions(+), 31 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 69c1c873007..b24800678b4 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -9,8 +9,8 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
-use Hyde\Framework\Concerns\Internal\MockableFeatures;
 
+use function is_array;
 use function array_keys;
 use function array_filter;
 use function extension_loaded;
@@ -32,7 +32,6 @@
 class Features implements SerializableContract
 {
     use Serializable;
-    use MockableFeatures;
 
     /**
      * The features that are enabled.
@@ -255,4 +254,18 @@ protected function getConfiguredFeatures(): array
     {
         return Config::getArray('hyde.features', static::getDefaultOptions());
     }
+
+    /**
+     * @internal This method is not covered by the backward compatibility promise.
+     *
+     * @param  string|array<string, bool>  $feature
+     */
+    public static function mock(string|array $feature, bool $enabled = true): void
+    {
+        $features = is_array($feature) ? $feature : [$feature => $enabled];
+
+        foreach ($features as $feature => $enabled) {
+            Hyde::features()->features[$feature] = $enabled;
+        }
+    }
 }
diff --git a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php b/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
deleted file mode 100644
index c41baa11878..00000000000
--- a/packages/framework/src/Framework/Concerns/Internal/MockableFeatures.php
+++ /dev/null
@@ -1,29 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Concerns\Internal;
-
-use Hyde\Hyde;
-
-use function is_array;
-
-/**
- * Allows the Features class to be mocked.
- *
- * @internal This trait is not covered by the backward compatibility promise.
- *
- * @see \Hyde\Facades\Features
- */
-trait MockableFeatures
-{
-    /** @param string|array<string, bool> $feature */
-    public static function mock(string|array $feature, bool $enabled = true): void
-    {
-        $features = is_array($feature) ? $feature : [$feature => $enabled];
-
-        foreach ($features as $feature => $enabled) {
-            Hyde::features()->features[$feature] = $enabled;
-        }
-    }
-}

From 57196acddb40c6bb912a573511ea2da9bda025eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:50:38 +0200
Subject: [PATCH 1588/4023] Cleanup test

---
 packages/framework/tests/Feature/HydeExtensionFeatureTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
index b7cbfc6e0ba..6ed83dd5793 100644
--- a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
+++ b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
@@ -104,7 +104,6 @@ public function testCustomRegisteredPagesAreDiscoveredByTheFileCollectionClass()
 
         $this->directory('foo');
         $this->file('foo/bar.txt');
-        $this->kernel->boot();
 
         $this->assertArrayHasKey('foo/bar.txt', Files::all());
         $this->assertEquals(new SourceFile('foo/bar.txt', TestPageClass::class), Files::get('foo/bar.txt'));

From fa42c6bf6eb0cf7de881116382a9a76e5e3c9771 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:52:12 +0200
Subject: [PATCH 1589/4023] Revert out of scope changes in test

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 0e8a72f95bf..35233b1388a 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -81,13 +82,13 @@ public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
 
     public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     {
+        Hyde::boot();
+
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),
         ]);
 
-        app()->instance('navigation.main', new MainNavigationMenu());
-
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',
@@ -100,12 +101,12 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
 
     public function testDarkModeThemeButtonIsHiddenInDocumentationPagesWhenDisabled()
     {
+        Hyde::boot();
+
         Config::set('hyde.features', [
             Features::documentationPages(),
         ]);
 
-        view()->share('page', new DocumentationPage());
-
         $view = view('hyde::layouts/docs')->with([
             'title' => 'foo',
             'content' => 'foo',

From 05d67ccfbdc41d436e18a85ee7605f4d72c8395a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:53:52 +0200
Subject: [PATCH 1590/4023] Fix test boot order

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 35233b1388a..a4607856d0d 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -82,13 +82,13 @@ public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
 
     public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     {
-        Hyde::boot();
-
         Config::set('hyde.features', [
             Features::markdownPages(),
             Features::bladePages(),
         ]);
 
+        Hyde::boot();
+
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',
             'content' => 'foo',

From ccef9d843858c3085928959a5544a241a5ddb2cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:54:01 +0200
Subject: [PATCH 1591/4023] Fix test type issue

---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index a4607856d0d..2ec1ff4aadd 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -101,12 +101,12 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
 
     public function testDarkModeThemeButtonIsHiddenInDocumentationPagesWhenDisabled()
     {
-        Hyde::boot();
-
         Config::set('hyde.features', [
             Features::documentationPages(),
         ]);
 
+        view()->share('page', new DocumentationPage());
+
         $view = view('hyde::layouts/docs')->with([
             'title' => 'foo',
             'content' => 'foo',

From 8dfb7f2f032c90b2b91885d38ae21712726f94d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:48:32 +0200
Subject: [PATCH 1592/4023] Remove old comments and make features class public

---
 packages/framework/src/Facades/Features.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b24800678b4..7de61615424 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -21,12 +21,6 @@
 /**
  * Allows features to be enabled and disabled in a simple object-oriented manner.
  *
- * @internal Until this class is split into a service/manager class, it should not be used outside of Hyde as the API is subject to change.
- *
- * @todo Split facade logic to service/manager class. (Initial and mock data could be set with boot/set methods)
- * @todo Add new enabled method to get just the enabled options array, and another called options/status/similar to get all options with their status.
- * Based entirely on Laravel Jetstream (License MIT)
- *
  * @see https://jetstream.laravel.com/
  */
 class Features implements SerializableContract

From 8d693d5f3c98abb1a47ad3e8819702c42acbbf2f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 14:57:08 +0200
Subject: [PATCH 1593/4023] Revert "Revert out of scope changes in test"

This reverts commit fa42c6bf6eb0cf7de881116382a9a76e5e3c9771.
---
 packages/framework/tests/Feature/DarkmodeFeatureTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 2ec1ff4aadd..0e8a72f95bf 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
@@ -87,7 +86,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
             Features::bladePages(),
         ]);
 
-        Hyde::boot();
+        app()->instance('navigation.main', new MainNavigationMenu());
 
         $view = view('hyde::layouts/page')->with([
             'title' => 'foo',

From 34fff90b8aff5f841b403773207919f233da3e53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 17:13:33 +0200
Subject: [PATCH 1594/4023] Update test to get features statically

---
 packages/framework/tests/Feature/ConfigurableFeaturesTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index b3201ae3a6f..8b5d92f9971 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -218,12 +218,11 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
 
         config(['hyde.features' => $config]);
 
-        $features = new Features();
         $this->assertSame([
             'html-pages',
             'markdown-posts',
             'blade-pages',
-        ], $features->enabled());
+        ], Hyde::features()->enabled());
     }
 
     protected function defaultOptions(): array

From fe4116ea21903ce463c4100721de8a66be2a2511 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 17:15:57 +0200
Subject: [PATCH 1595/4023] Refactor test to extend unit test case

---
 .../Feature/ConfigurableFeaturesTest.php      | 38 ++++++++++++++++---
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 8b5d92f9971..2203a742856 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -4,15 +4,37 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
-use Hyde\Testing\TestCase;
-use Illuminate\Support\Facades\Config;
+use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\HydeKernel;
 
 /**
  * @covers \Hyde\Facades\Features
  */
-class ConfigurableFeaturesTest extends TestCase
+class ConfigurableFeaturesTest extends UnitTestCase
 {
+    protected static array $defaultConfig;
+
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
+    public static function setUpBeforeClass(): void
+    {
+        parent::setUpBeforeClass();
+
+        self::$defaultConfig = require Hyde::path('config/hyde.php');
+    }
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        self::mockConfig();
+
+        HydeKernel::setInstance(new HydeKernel());
+    }
+
     public function testHasHtmlPagesReturnsFalseWhenFeatureIsNotEnabled()
     {
         $this->expectMethodReturnsFalse('hasHtmlPages');
@@ -96,6 +118,7 @@ public function testHasSitemapReturnsTrueWhenFeatureIsEnabled()
     public function testCanGenerateSitemapHelperReturnsTrueIfHydeHasBaseUrl()
     {
         config(['hyde.url' => 'foo']);
+
         $this->assertTrue(Features::hasSitemap());
     }
 
@@ -241,13 +264,18 @@ protected function defaultOptions(): array
 
     protected function expectMethodReturnsFalse(string $method): void
     {
-        Config::set('hyde.features', []);
-
         $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
     }
 
     protected function expectMethodReturnsTrue(string $method): void
     {
+        $this->mockDefaultConfig();
+
         $this->assertTrue(Features::$method(), "Method '$method' should return true when feature is enabled");
     }
+
+    protected function mockDefaultConfig(): void
+    {
+        self::mockConfig(['hyde' => self::$defaultConfig]);
+    }
 }

From 3cb3873179ba33c66a3a202739f4921558d860df Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 17:16:00 +0200
Subject: [PATCH 1596/4023] Revert "Refactor test to extend unit test case"

This reverts commit fe4116ea21903ce463c4100721de8a66be2a2511.
---
 .../Feature/ConfigurableFeaturesTest.php      | 38 +++----------------
 1 file changed, 5 insertions(+), 33 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 2203a742856..8b5d92f9971 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -4,37 +4,15 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Facades\Features;
-use Hyde\Testing\UnitTestCase;
-use Hyde\Foundation\HydeKernel;
+use Hyde\Testing\TestCase;
+use Illuminate\Support\Facades\Config;
 
 /**
  * @covers \Hyde\Facades\Features
  */
-class ConfigurableFeaturesTest extends UnitTestCase
+class ConfigurableFeaturesTest extends TestCase
 {
-    protected static array $defaultConfig;
-
-    protected static bool $needsKernel = true;
-    protected static bool $needsConfig = true;
-
-    public static function setUpBeforeClass(): void
-    {
-        parent::setUpBeforeClass();
-
-        self::$defaultConfig = require Hyde::path('config/hyde.php');
-    }
-
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        self::mockConfig();
-
-        HydeKernel::setInstance(new HydeKernel());
-    }
-
     public function testHasHtmlPagesReturnsFalseWhenFeatureIsNotEnabled()
     {
         $this->expectMethodReturnsFalse('hasHtmlPages');
@@ -118,7 +96,6 @@ public function testHasSitemapReturnsTrueWhenFeatureIsEnabled()
     public function testCanGenerateSitemapHelperReturnsTrueIfHydeHasBaseUrl()
     {
         config(['hyde.url' => 'foo']);
-
         $this->assertTrue(Features::hasSitemap());
     }
 
@@ -264,18 +241,13 @@ protected function defaultOptions(): array
 
     protected function expectMethodReturnsFalse(string $method): void
     {
+        Config::set('hyde.features', []);
+
         $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
     }
 
     protected function expectMethodReturnsTrue(string $method): void
     {
-        $this->mockDefaultConfig();
-
         $this->assertTrue(Features::$method(), "Method '$method' should return true when feature is enabled");
     }
-
-    protected function mockDefaultConfig(): void
-    {
-        self::mockConfig(['hyde' => self::$defaultConfig]);
-    }
 }

From 01fe588db363389244f422aab646714917f0af11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 17:16:27 +0200
Subject: [PATCH 1597/4023] Import class

---
 packages/framework/tests/Feature/ConfigurableFeaturesTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 8b5d92f9971..d263490c042 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;

From 6d3aa0baeaaedfb3fa7abb0026dc1262cf5d67de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 17:51:16 +0200
Subject: [PATCH 1598/4023] Extract Pest unit test

---
 .../Feature/ConfigurableFeaturesTest.php      | 50 -------------------
 .../Unit/ConfigurableFeaturesUnitTest.php     | 37 ++++++++++++++
 2 files changed, 37 insertions(+), 50 deletions(-)
 create mode 100644 packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index d263490c042..1734af8c6a9 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -14,31 +14,6 @@
  */
 class ConfigurableFeaturesTest extends TestCase
 {
-    public function testHasHtmlPagesReturnsFalseWhenFeatureIsNotEnabled()
-    {
-        $this->expectMethodReturnsFalse('hasHtmlPages');
-    }
-
-    public function testHasBladePagesReturnsFalseWhenFeatureIsNotEnabled()
-    {
-        $this->expectMethodReturnsFalse('hasBladePages');
-    }
-
-    public function testHasMarkdownPagesReturnsFalseWhenFeatureIsNotEnabled()
-    {
-        $this->expectMethodReturnsFalse('hasMarkdownPages');
-    }
-
-    public function testHasMarkdownPostsReturnsFalseWhenFeatureIsNotEnabled()
-    {
-        $this->expectMethodReturnsFalse('hasMarkdownPosts');
-    }
-
-    public function testHasDocumentationPagesReturnsFalseWhenFeatureIsNotEnabled()
-    {
-        $this->expectMethodReturnsFalse('hasDocumentationPages');
-    }
-
     public function testHasDocumentationSearchReturnsFalseWhenFeatureIsNotEnabled()
     {
         $this->expectMethodReturnsFalse('hasDocumentationSearch');
@@ -59,31 +34,6 @@ public function testHasRssReturnsFalseWhenFeatureIsNotEnabled()
         $this->expectMethodReturnsFalse('hasRss');
     }
 
-    public function testHasHtmlPagesReturnsTrueWhenFeatureIsEnabled()
-    {
-        $this->expectMethodReturnsTrue('hasHtmlPages');
-    }
-
-    public function testHasBladePagesReturnsTrueWhenFeatureIsEnabled()
-    {
-        $this->expectMethodReturnsTrue('hasBladePages');
-    }
-
-    public function testHasMarkdownPagesReturnsTrueWhenFeatureIsEnabled()
-    {
-        $this->expectMethodReturnsTrue('hasMarkdownPages');
-    }
-
-    public function testHasMarkdownPostsReturnsTrueWhenFeatureIsEnabled()
-    {
-        $this->expectMethodReturnsTrue('hasMarkdownPosts');
-    }
-
-    public function testHasDocumentationPagesReturnsTrueWhenFeatureIsEnabled()
-    {
-        $this->expectMethodReturnsTrue('hasDocumentationPages');
-    }
-
     public function testHasDarkmodeReturnsTrueWhenFeatureIsEnabled()
     {
         $this->expectMethodReturnsTrue('hasDarkmode');
diff --git a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
new file mode 100644
index 00000000000..b24fbb17209
--- /dev/null
+++ b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+use Hyde\Facades\Features;
+use Illuminate\Support\Facades\Config;
+
+beforeEach(function () {
+    $this->mockConfig();
+    $this->needsKernel();
+});
+
+test('expect has method returns false when feature is disabled', function (string $method) {
+    Config::set('hyde.features', []);
+    \Hyde\Foundation\HydeKernel::setInstance(new \Hyde\Foundation\HydeKernel());
+
+    $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
+})->with([
+    'hasHtmlPages',
+    'hasBladePages',
+    'hasMarkdownPages',
+    'hasMarkdownPosts',
+    'hasDocumentationPages',
+])->covers(Hyde\Facades\Features::class);
+
+test('expect has method returns true when feature is enabled', function (string $method) {
+    Config::set('hyde.features', [str($method)->kebab()->replace('has-', '')->toString()]);
+    \Hyde\Foundation\HydeKernel::setInstance(new \Hyde\Foundation\HydeKernel());
+
+    $this->assertTrue(Features::$method(), "Method '$method' should return true when feature is enabled");
+})->with([
+    'hasHtmlPages',
+    'hasBladePages',
+    'hasMarkdownPages',
+    'hasMarkdownPosts',
+    'hasDocumentationPages',
+])->covers(Hyde\Facades\Features::class);

From 559be6c9119993cdf7e8be8846f866c15f79bcf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:21:06 +0200
Subject: [PATCH 1599/4023] Remove old annotation

---
 packages/framework/src/Facades/Features.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 7de61615424..d78a18a3487 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -20,8 +20,6 @@
 
 /**
  * Allows features to be enabled and disabled in a simple object-oriented manner.
- *
- * @see https://jetstream.laravel.com/
  */
 class Features implements SerializableContract
 {

From 337bab00bdbdb27185df5f8d1a3c71d146090e2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:36:48 +0200
Subject: [PATCH 1600/4023] Deprecate added method

---
 packages/framework/src/Facades/Features.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index d78a18a3487..f7a735a757c 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -58,6 +58,8 @@ public static function enabled(): array
     /**
      * Get all features and their status.
      *
+     * @deprecated This method might not actually provide value, as it's not interesting information to have.
+     *
      * @return array<string, bool>
      */
     public static function getFeatures(): array

From 703234b7ba1b4e6a4cb7ed6cae936e8d66817ac6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:20:40 +0200
Subject: [PATCH 1601/4023] Create Feature.php

---
 packages/framework/src/Foundation/Concerns/Feature.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Foundation/Concerns/Feature.php

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
new file mode 100644
index 00000000000..9afe1dbd7f4
--- /dev/null
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Foundation\Concerns;
+
+enum Feature
+{
+    //
+}

From 6e0e79c7807740ed394005c20cf3ce270c7aa1f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:21:54 +0200
Subject: [PATCH 1602/4023] Mark enum as experimental

---
 packages/framework/src/Foundation/Concerns/Feature.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
index 9afe1dbd7f4..3924a082fcf 100644
--- a/packages/framework/src/Foundation/Concerns/Feature.php
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Foundation\Concerns;
 
+/**
+ * @experimental This class may change significantly before its release.
+ */
 enum Feature
 {
     //

From f69217a1a214ae74447de6c3f158094ccf75adc6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:22:24 +0200
Subject: [PATCH 1603/4023] Add enum description

---
 packages/framework/src/Foundation/Concerns/Feature.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
index 3924a082fcf..c30d781dbc0 100644
--- a/packages/framework/src/Foundation/Concerns/Feature.php
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -5,6 +5,8 @@
 namespace Hyde\Foundation\Concerns;
 
 /**
+ * A configurable feature that belongs to the Features class.
+ *
  * @experimental This class may change significantly before its release.
  */
 enum Feature

From 7425d446c9d0ab4a2fa9de9f9fb9b000072a8ef4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:22:30 +0200
Subject: [PATCH 1604/4023] Add link to related class

---
 packages/framework/src/Foundation/Concerns/Feature.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
index c30d781dbc0..d00e4a22f67 100644
--- a/packages/framework/src/Foundation/Concerns/Feature.php
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -7,6 +7,8 @@
 /**
  * A configurable feature that belongs to the Features class.
  *
+ * @see \Hyde\Facades\Features
+ *
  * @experimental This class may change significantly before its release.
  */
 enum Feature

From 0742896b3144eb95a579e2759361160ed0b8d193 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:24:59 +0200
Subject: [PATCH 1605/4023] Add enum cases based on features facade

---
 .../framework/src/Foundation/Concerns/Feature.php  | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
index d00e4a22f67..5f066e19e54 100644
--- a/packages/framework/src/Foundation/Concerns/Feature.php
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -13,5 +13,17 @@
  */
 enum Feature
 {
-    //
+    // Page Modules
+    case HtmlPages;
+    case MarkdownPosts;
+    case BladePages;
+    case MarkdownPages;
+    case DocumentationPages;
+
+    // Frontend Features
+    case Darkmode;
+    case DocumentationSearch;
+
+    // Integrations
+    case Torchlight;
 }

From 89e5f7ae57b7ba229a2c301f7028ed35828243de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:30:06 +0200
Subject: [PATCH 1606/4023] Back enum cases

---
 .../src/Foundation/Concerns/Feature.php        | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/Feature.php b/packages/framework/src/Foundation/Concerns/Feature.php
index 5f066e19e54..812cad8a2b7 100644
--- a/packages/framework/src/Foundation/Concerns/Feature.php
+++ b/packages/framework/src/Foundation/Concerns/Feature.php
@@ -11,19 +11,19 @@
  *
  * @experimental This class may change significantly before its release.
  */
-enum Feature
+enum Feature: string
 {
     // Page Modules
-    case HtmlPages;
-    case MarkdownPosts;
-    case BladePages;
-    case MarkdownPages;
-    case DocumentationPages;
+    case HtmlPages = 'html-pages';
+    case MarkdownPosts = 'markdown-posts';
+    case BladePages = 'blade-pages';
+    case MarkdownPages = 'markdown-pages';
+    case DocumentationPages = 'documentation-pages';
 
     // Frontend Features
-    case Darkmode;
-    case DocumentationSearch;
+    case Darkmode = 'darkmode';
+    case DocumentationSearch = 'documentation-search';
 
     // Integrations
-    case Torchlight;
+    case Torchlight = 'torchlight';
 }

From 4f086da28967e5344b499e5d11d16539cc0d8ef6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:30:48 +0200
Subject: [PATCH 1607/4023] Import feature enum

---
 packages/framework/src/Facades/Features.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index f7a735a757c..f280369d383 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 

From 07faf9c35a898719ab35bb4155b696d0489ddaa6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:31:13 +0200
Subject: [PATCH 1608/4023] Update feature methods to return feature instances

---
 packages/framework/src/Facades/Features.php | 32 ++++++++++-----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index f280369d383..50326a02a48 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -72,44 +72,44 @@ public static function getFeatures(): array
     // Configure features to be used in the config file.
     // =================================================
 
-    public static function htmlPages(): string
+    public static function htmlPages(): Feature
     {
-        return 'html-pages';
+        return Feature::HtmlPages;
     }
 
-    public static function bladePages(): string
+    public static function bladePages(): Feature
     {
-        return 'blade-pages';
+        return Feature::BladePages;
     }
 
-    public static function markdownPages(): string
+    public static function markdownPages(): Feature
     {
-        return 'markdown-pages';
+        return Feature::MarkdownPages;
     }
 
-    public static function markdownPosts(): string
+    public static function markdownPosts(): Feature
     {
-        return 'markdown-posts';
+        return Feature::MarkdownPosts;
     }
 
-    public static function documentationPages(): string
+    public static function documentationPages(): Feature
     {
-        return 'documentation-pages';
+        return Feature::DocumentationPages;
     }
 
-    public static function documentationSearch(): string
+    public static function documentationSearch(): Feature
     {
-        return 'documentation-search';
+        return Feature::DocumentationSearch;
     }
 
-    public static function darkmode(): string
+    public static function darkmode(): Feature
     {
-        return 'darkmode';
+        return Feature::Darkmode;
     }
 
-    public static function torchlight(): string
+    public static function torchlight(): Feature
     {
-        return 'torchlight';
+        return Feature::Torchlight;
     }
 
     // ================================================

From 2b2cec7df1cd372b419d1588ef7c5733337e9093 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:31:30 +0200
Subject: [PATCH 1609/4023] Update state check method to take feature instead
 of string

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 50326a02a48..ae71f320dcd 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -41,7 +41,7 @@ public function __construct()
     /**
      * Determine if the given specified is enabled.
      */
-    public static function has(string $feature): bool
+    public static function has(Feature $feature): bool
     {
         return in_array($feature, static::enabled());
     }

From 295f7ae0c76523ed398345725c1353756c0d717d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:32:00 +0200
Subject: [PATCH 1610/4023] Update array generics

---
 packages/framework/src/Facades/Features.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index ae71f320dcd..ca64449ba20 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -203,7 +203,7 @@ public function toArray(): array
         return $this->features;
     }
 
-    /** @return array<string> */
+    /** @return array<Feature> */
     protected static function getDefaultOptions(): array
     {
         return [
@@ -244,7 +244,7 @@ protected function boot(): array
         return $enabled;
     }
 
-    /** @return array<string> */
+    /** @return array<Feature> */
     protected function getConfiguredFeatures(): array
     {
         return Config::getArray('hyde.features', static::getDefaultOptions());

From 0de3bead7a71800bad5ef1516157f31d96997e9d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:32:54 +0200
Subject: [PATCH 1611/4023] Store internal state using the enum values

---
 packages/framework/src/Facades/Features.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index ca64449ba20..0d64d53749d 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -231,13 +231,13 @@ protected function boot(): array
 
         // Set all default features to false
         foreach ($options as $feature) {
-            $enabled[$feature] = false;
+            $enabled[$feature->value] = false;
         }
 
         // Set all features to true if they are enabled in the config file
         foreach ($this->getConfiguredFeatures() as $feature) {
             if (in_array($feature, $options)) {
-                $enabled[$feature] = true;
+                $enabled[$feature->value] = true;
             }
         }
 

From 93c15c5024c3ee6539b3b0af63b84a0b1078f78c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:34:37 +0200
Subject: [PATCH 1612/4023] Fix illegal offset type

---
 .../framework/tests/Feature/ConfigurableFeaturesTest.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 1734af8c6a9..2172e4246bc 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -143,9 +143,9 @@ public function testGetEnabledUsesConfiguredOptions()
             Features::bladePages(),
         ];
         $expected = [
-            Features::htmlPages() => true,
-            Features::markdownPosts() => true,
-            Features::bladePages() => true,
+            Features::htmlPages()->value => true,
+            Features::markdownPosts()->value => true,
+            Features::bladePages()->value => true,
             'markdown-pages' => false,
             'documentation-pages' => false,
             'darkmode' => false,

From 9a4a5de8e5560ef7e33a1a1da33601f234dcf330 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:38:06 +0200
Subject: [PATCH 1613/4023] Compare against enabled values

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 0d64d53749d..a83bb356ff0 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -43,7 +43,7 @@ public function __construct()
      */
     public static function has(Feature $feature): bool
     {
-        return in_array($feature, static::enabled());
+        return in_array($feature->value, static::enabled());
     }
 
     /**

From 78cadabd85cb02768fc63a531356c59afd9f9805 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:46:05 +0200
Subject: [PATCH 1614/4023] Refactor unit test to use the enum

---
 .../Unit/ConfigurableFeaturesUnitTest.php     | 34 +++++++++----------
 1 file changed, 16 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
index b24fbb17209..a7ba8225f77 100644
--- a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
+++ b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use Hyde\Facades\Features;
+use Hyde\Foundation\Concerns\Feature;
 use Illuminate\Support\Facades\Config;
 
 beforeEach(function () {
@@ -10,28 +11,25 @@
     $this->needsKernel();
 });
 
-test('expect has method returns false when feature is disabled', function (string $method) {
+test('expect has method returns false when feature is disabled', function (Feature $feature) {
+    $method = "has$feature->name";
+
     Config::set('hyde.features', []);
     \Hyde\Foundation\HydeKernel::setInstance(new \Hyde\Foundation\HydeKernel());
 
     $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
-})->with([
-    'hasHtmlPages',
-    'hasBladePages',
-    'hasMarkdownPages',
-    'hasMarkdownPosts',
-    'hasDocumentationPages',
-])->covers(Hyde\Facades\Features::class);
-
-test('expect has method returns true when feature is enabled', function (string $method) {
-    Config::set('hyde.features', [str($method)->kebab()->replace('has-', '')->toString()]);
+})->with(Feature::cases())->covers(Hyde\Facades\Features::class);
+
+test('expect has method returns true when feature is enabled', function (Feature $feature) {
+    $method = "has$feature->name";
+
+    Config::set('hyde.features', [$feature]);
     \Hyde\Foundation\HydeKernel::setInstance(new \Hyde\Foundation\HydeKernel());
 
     $this->assertTrue(Features::$method(), "Method '$method' should return true when feature is enabled");
-})->with([
-    'hasHtmlPages',
-    'hasBladePages',
-    'hasMarkdownPages',
-    'hasMarkdownPosts',
-    'hasDocumentationPages',
-])->covers(Hyde\Facades\Features::class);
+})->with(
+    collect(Feature::cases())->reject(fn (Feature $feature): bool => in_array($feature, [
+        Feature::DocumentationSearch,
+        Feature::Torchlight,
+    ]))
+)->covers(Hyde\Facades\Features::class);

From 4696fddde8a1852573b798b5e03599a47bbaa37a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 18:51:27 +0200
Subject: [PATCH 1615/4023] Update kernel helper to support features enum

---
 packages/framework/src/Foundation/HydeKernel.php    | 5 +++--
 packages/framework/tests/Feature/HydeKernelTest.php | 4 +++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index a3494286e10..148bd125c5f 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation;
 
 use Hyde\Facades\Features;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Foundation\Kernel\FileCollection;
@@ -91,9 +92,9 @@ public function features(): Features
         return $this->features ??= new Features();
     }
 
-    public function hasFeature(string $feature): bool
+    public function hasFeature(Feature|string $feature): bool
     {
-        return Features::has($feature);
+        return Features::has($feature instanceof Feature ? $feature : Feature::from($feature));
     }
 
     /** @inheritDoc */
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index b7beb1b07be..d7f041b24f7 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -10,6 +10,7 @@
 use Hyde\Foundation\Facades\Pages;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\HydeKernel;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Framework\HydeServiceProvider;
 use Hyde\Hyde;
@@ -76,7 +77,8 @@ public function testFeaturesHelperReturnsNewFeaturesInstance()
 
     public function testHasFeatureHelperCallsMethodOnFeaturesClass()
     {
-        $this->assertSame(Features::has('foo'), Hyde::hasFeature('foo'));
+        $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature(Feature::BladePages));
+        $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature('blade-pages'));
     }
 
     public function testCurrentPageHelperReturnsCurrentPageName()

From 66d69c716b88acee200e80a72e471c1176a27eae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 19:01:25 +0200
Subject: [PATCH 1616/4023] Update reset logic to use added enum

---
 packages/testing/src/ResetsApplication.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/testing/src/ResetsApplication.php b/packages/testing/src/ResetsApplication.php
index 96729828402..7b2e10e645c 100644
--- a/packages/testing/src/ResetsApplication.php
+++ b/packages/testing/src/ResetsApplication.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
+use Hyde\Foundation\Concerns\Feature;
 
 trait ResetsApplication
 {
@@ -55,9 +56,7 @@ protected function withoutDocumentationSearch(): void
     {
         $features = config('hyde.features');
 
-        $flipped = array_flip($features);
-        unset($flipped['documentation-search']);
-        $features = array_flip($flipped);
+        $features = array_filter($features, fn (Feature $feature): bool => $feature !== Feature::DocumentationSearch);
 
         config(['hyde.features' => $features]);
     }
@@ -67,7 +66,7 @@ protected function restoreDocumentationSearch(): void
     {
         $features = config('hyde.features');
 
-        $features[] = 'documentation-search';
+        $features[] = Feature::DocumentationSearch;
 
         config(['hyde.features' => $features]);
     }

From 05dc52b93b5b6b724c9209d0e28a8da8572386af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 19:03:42 +0200
Subject: [PATCH 1617/4023] Update method annotation

---
 packages/framework/src/Hyde.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 131db5b0f5b..5745a939992 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Features;
 use Hyde\Foundation\HydeKernel;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\Kernel\PageCollection;
@@ -58,7 +59,7 @@
  * @method static HydeKernel getInstance()
  * @method static Filesystem filesystem()
  * @method static array getRegisteredExtensions()
- * @method static bool hasFeature(string $feature)
+ * @method static bool hasFeature(Feature|string $feature)
  * @method static bool hasSiteUrl()
  * @method static void setInstance(HydeKernel $instance)
  * @method static void setBasePath(string $basePath)

From e6277b4812312569eb164df7a4e7d11821494315 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 19:05:15 +0200
Subject: [PATCH 1618/4023] Update command to use features enum

---
 packages/framework/src/Console/Commands/DebugCommand.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/DebugCommand.php b/packages/framework/src/Console/Commands/DebugCommand.php
index c3f4effc11e..ce8d426fbd9 100644
--- a/packages/framework/src/Console/Commands/DebugCommand.php
+++ b/packages/framework/src/Console/Commands/DebugCommand.php
@@ -70,11 +70,11 @@ protected function printVerbosePathInformation(): void
 
     protected function printEnabledFeatures(): void
     {
-        /** @var array<string, string> $features */
+        /** @var array<\Hyde\Foundation\Concerns\Feature> $features */
         $features = Config::getArray('hyde.features', []);
 
         foreach ($features as $feature) {
-            $this->line(" - $feature");
+            $this->line(" - $feature->name");
         }
     }
 }

From c7efeeedb86381d980d48c096437d1f7181b735a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:15:51 +0200
Subject: [PATCH 1619/4023] Use enum cases as default array

---
 packages/framework/src/Facades/Features.php | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index a83bb356ff0..6f72ccd278c 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -206,21 +206,7 @@ public function toArray(): array
     /** @return array<Feature> */
     protected static function getDefaultOptions(): array
     {
-        return [
-            // Page Modules
-            static::htmlPages(),
-            static::markdownPosts(),
-            static::bladePages(),
-            static::markdownPages(),
-            static::documentationPages(),
-
-            // Frontend Features
-            static::darkmode(),
-            static::documentationSearch(),
-
-            // Integrations
-            static::torchlight(),
-        ];
+        return Feature::cases();
     }
 
     protected function boot(): array

From 98ffaf0eac6ea213e51e752a7967b67174f0c873 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:21:26 +0200
Subject: [PATCH 1620/4023] Remove the features getter

This method might not actually provide value, as it's not interesting information to have. It has also not been released, so this change is not breaking.
---
 packages/framework/src/Facades/Features.php   | 14 +-------
 .../Feature/ConfigurableFeaturesTest.php      | 33 ++++++++-----------
 2 files changed, 15 insertions(+), 32 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 6f72ccd278c..e2774a16769 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -53,19 +53,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return array_keys(array_filter(Hyde::features()->getFeatures()));
-    }
-
-    /**
-     * Get all features and their status.
-     *
-     * @deprecated This method might not actually provide value, as it's not interesting information to have.
-     *
-     * @return array<string, bool>
-     */
-    public static function getFeatures(): array
-    {
-        return Hyde::features()->toArray();
+        return array_keys(array_filter(Hyde::features()->toArray()));
     }
 
     // =================================================
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 2172e4246bc..e69b8283bbf 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -123,7 +123,7 @@ public function testGetEnabledUsesDefaultOptionsByDefault()
     {
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, Features::getFeatures());
+        $this->assertSame($default, Features::enabled());
     }
 
     public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
@@ -132,7 +132,7 @@ public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
 
         $default = $this->defaultOptions();
 
-        $this->assertSame($default, Features::getFeatures());
+        $this->assertSame($default, Features::enabled());
     }
 
     public function testGetEnabledUsesConfiguredOptions()
@@ -143,19 +143,14 @@ public function testGetEnabledUsesConfiguredOptions()
             Features::bladePages(),
         ];
         $expected = [
-            Features::htmlPages()->value => true,
-            Features::markdownPosts()->value => true,
-            Features::bladePages()->value => true,
-            'markdown-pages' => false,
-            'documentation-pages' => false,
-            'darkmode' => false,
-            'documentation-search' => false,
-            'torchlight' => false,
+            'html-pages',
+            'markdown-posts',
+            'blade-pages',
         ];
 
         config(['hyde.features' => $config]);
 
-        $this->assertSame($expected, Features::getFeatures());
+        $this->assertSame($expected, Features::enabled());
     }
 
     public function testCannotUseArbitraryValuesInEnabledOptions()
@@ -179,14 +174,14 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
     protected function defaultOptions(): array
     {
         return [
-            'html-pages' => true,
-            'markdown-posts' => true,
-            'blade-pages' => true,
-            'markdown-pages' => true,
-            'documentation-pages' => true,
-            'darkmode' => true,
-            'documentation-search' => true,
-            'torchlight' => true,
+            'html-pages',
+            'markdown-posts',
+            'blade-pages',
+            'markdown-pages',
+            'documentation-pages',
+            'darkmode',
+            'documentation-search',
+            'torchlight',
         ];
     }
 

From 82e99e6aaf2c8f61053d563c25b6739706a6b8c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:22:05 +0200
Subject: [PATCH 1621/4023] Inline local variables

---
 .../tests/Feature/ConfigurableFeaturesTest.php      | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index e69b8283bbf..48408adb82a 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -137,20 +137,17 @@ public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
 
     public function testGetEnabledUsesConfiguredOptions()
     {
-        $config = [
+        config(['hyde.features' => [
             Features::htmlPages(),
             Features::markdownPosts(),
             Features::bladePages(),
-        ];
-        $expected = [
+        ]]);
+
+        $this->assertSame([
             'html-pages',
             'markdown-posts',
             'blade-pages',
-        ];
-
-        config(['hyde.features' => $config]);
-
-        $this->assertSame($expected, Features::enabled());
+        ], Features::enabled());
     }
 
     public function testCannotUseArbitraryValuesInEnabledOptions()

From 2f5a472fe2cf0c668b0e46d14e920adea080f3f3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:31:00 +0200
Subject: [PATCH 1622/4023] Add todo

---
 packages/framework/src/Facades/Features.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index e2774a16769..79cfa9eb24d 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -29,6 +29,8 @@ class Features implements SerializableContract
     /**
      * The features that are enabled.
      *
+     * @todo Simplify internal state complexity
+     *
      * @var array<string, bool>
      */
     protected array $features = [];

From 4c1db295c7607802dee76ba037c1b3632dddd392 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:32:15 +0200
Subject: [PATCH 1623/4023] Merge multiple array assertions into assert same
 call

No idea why this was the way it was
---
 .../Feature/ConfigurableFeaturesTest.php      | 22 +++++++++----------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 48408adb82a..291c4c79597 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -77,18 +77,16 @@ public function testToArrayMethodReturnsMethodArray()
 
     public function testToArrayMethodContainsAllSettings()
     {
-        $array = (new Features)->toArray();
-
-        $this->assertArrayHasKey('html-pages', $array);
-        $this->assertArrayHasKey('markdown-posts', $array);
-        $this->assertArrayHasKey('blade-pages', $array);
-        $this->assertArrayHasKey('markdown-pages', $array);
-        $this->assertArrayHasKey('documentation-pages', $array);
-        $this->assertArrayHasKey('darkmode', $array);
-        $this->assertArrayHasKey('documentation-search', $array);
-        $this->assertArrayHasKey('torchlight', $array);
-
-        $this->assertCount(8, $array);
+        $this->assertSame([
+            'html-pages',
+            'markdown-posts',
+            'blade-pages',
+            'markdown-pages',
+            'documentation-pages',
+            'darkmode',
+            'documentation-search',
+            'torchlight',
+        ], array_keys((new Features)->toArray()));
     }
 
     public function testFeaturesCanBeMocked()

From f43e0478076382259309f0bb86e7e25ceea572e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:33:28 +0200
Subject: [PATCH 1624/4023] Change internal parameter to null to get prettier
 IDE support

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 79cfa9eb24d..2038ed2f56f 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -231,7 +231,7 @@ protected function getConfiguredFeatures(): array
      *
      * @param  string|array<string, bool>  $feature
      */
-    public static function mock(string|array $feature, bool $enabled = true): void
+    public static function mock(string|array $feature, bool $enabled = null): void
     {
         $features = is_array($feature) ? $feature : [$feature => $enabled];
 

From b1bfd84d1494fbc3eeb365c1dc7066378949f184 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:35:02 +0200
Subject: [PATCH 1625/4023] Merge complex tests into single test with the same
 coverage

---
 .../Feature/ConfigurableFeaturesTest.php      | 30 ++++++-------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 291c4c79597..7d550ba55e9 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -63,30 +63,18 @@ public function testCanGenerateSitemapHelperReturnsFalseIfSitemapsAreDisabledInC
         $this->assertFalse(Features::hasSitemap());
     }
 
-    public function testToArrayMethodReturnsMethodArray()
-    {
-        $array = (new Features)->toArray();
-        $this->assertIsArray($array);
-        $this->assertNotEmpty($array);
-        foreach ($array as $feature => $enabled) {
-            $this->assertIsString($feature);
-            $this->assertIsBool($enabled);
-            $this->assertStringStartsNotWith('has', $feature);
-        }
-    }
-
     public function testToArrayMethodContainsAllSettings()
     {
         $this->assertSame([
-            'html-pages',
-            'markdown-posts',
-            'blade-pages',
-            'markdown-pages',
-            'documentation-pages',
-            'darkmode',
-            'documentation-search',
-            'torchlight',
-        ], array_keys((new Features)->toArray()));
+            'html-pages' => true,
+            'markdown-posts' => true,
+            'blade-pages' => true,
+            'markdown-pages' => true,
+            'documentation-pages' => true,
+            'darkmode' => true,
+            'documentation-search' => true,
+            'torchlight' => true,
+        ], (new Features)->toArray());
     }
 
     public function testFeaturesCanBeMocked()

From 0fddc9405f73ed90fed90886bd6d4b62acb77e36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:35:49 +0200
Subject: [PATCH 1626/4023] Add additional testing case

---
 .../Feature/ConfigurableFeaturesTest.php      | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 7d550ba55e9..df145e38c06 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -77,6 +77,26 @@ public function testToArrayMethodContainsAllSettings()
         ], (new Features)->toArray());
     }
 
+    public function testToArrayMethodContainsAllSettingsIncludingFalseValues()
+    {
+        config(['hyde.features' => [
+            Features::htmlPages(),
+            Features::markdownPosts(),
+            Features::bladePages(),
+        ]]);
+
+        $this->assertSame([
+            'html-pages' => true,
+            'markdown-posts' => true,
+            'blade-pages' => true,
+            'markdown-pages' => false,
+            'documentation-pages' => false,
+            'darkmode' => false,
+            'documentation-search' => false,
+            'torchlight' => false,
+        ], (new Features)->toArray());
+    }
+
     public function testFeaturesCanBeMocked()
     {
         Features::mock('darkmode', true);

From 006bce83039fd1e6f267ab2ca519a29b4b70b11f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:37:55 +0200
Subject: [PATCH 1627/4023] Test serialized class state

---
 .../Feature/ConfigurableFeaturesTest.php      | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index df145e38c06..fcea406456a 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -9,6 +9,8 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
 
+use function config;
+
 /**
  * @covers \Hyde\Facades\Features
  */
@@ -97,6 +99,28 @@ public function testToArrayMethodContainsAllSettingsIncludingFalseValues()
         ], (new Features)->toArray());
     }
 
+    public function testSerializedClassState()
+    {
+        config(['hyde.features' => [
+            Features::htmlPages(),
+            Features::markdownPosts(),
+            Features::bladePages(),
+        ]]);
+
+        $this->assertSame(<<<'JSON'
+        {
+            "html-pages": true,
+            "markdown-posts": true,
+            "blade-pages": true,
+            "markdown-pages": false,
+            "documentation-pages": false,
+            "darkmode": false,
+            "documentation-search": false,
+            "torchlight": false
+        }
+        JSON, (new Features)->toJson(JSON_PRETTY_PRINT));
+    }
+
     public function testFeaturesCanBeMocked()
     {
         Features::mock('darkmode', true);

From 7c505699ef246a55e95797590ebf7835bbfb79fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:48:27 +0200
Subject: [PATCH 1628/4023] Return array representation using case mappings

---
 packages/framework/src/Facades/Features.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 2038ed2f56f..8a9518da84f 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -190,7 +190,10 @@ public static function hasDocumentationSearch(): bool
      */
     public function toArray(): array
     {
-        return $this->features;
+        return collect(Feature::cases())
+            ->mapWithKeys(fn (Feature $case): array => [
+                $case->value => $this->features[$case->value],
+            ])->toArray();
     }
 
     /** @return array<Feature> */

From db485e747f55ae717f8a3fcad6263038ecc607ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:51:00 +0200
Subject: [PATCH 1629/4023] Rename closure parameter

---
 packages/framework/src/Facades/Features.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 8a9518da84f..fb3b5f18e4a 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -191,8 +191,8 @@ public static function hasDocumentationSearch(): bool
     public function toArray(): array
     {
         return collect(Feature::cases())
-            ->mapWithKeys(fn (Feature $case): array => [
-                $case->value => $this->features[$case->value],
+            ->mapWithKeys(fn (Feature $feature): array => [
+                $feature->value => $this->features[$feature->value],
             ])->toArray();
     }
 

From e41e96daa81b79d07fc04e8f04f158c6213d4b29 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:51:12 +0200
Subject: [PATCH 1630/4023] Draft future closure logic

---
 packages/framework/src/Facades/Features.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index fb3b5f18e4a..9157fc07973 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -192,6 +192,7 @@ public function toArray(): array
     {
         return collect(Feature::cases())
             ->mapWithKeys(fn (Feature $feature): array => [
+                // Todo: $feature->value => isset($this->features[$feature->value]),
                 $feature->value => $this->features[$feature->value],
             ])->toArray();
     }

From a032b33478e642a964aab223fddafea908e115b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 20:59:47 +0200
Subject: [PATCH 1631/4023] Enable new logic

---
 packages/framework/src/Facades/Features.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 9157fc07973..d8850563825 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -192,8 +192,7 @@ public function toArray(): array
     {
         return collect(Feature::cases())
             ->mapWithKeys(fn (Feature $feature): array => [
-                // Todo: $feature->value => isset($this->features[$feature->value]),
-                $feature->value => $this->features[$feature->value],
+                 $feature->value => isset($this->features[$feature->value]),
             ])->toArray();
     }
 

From 626ff0f88753178708ee614941bfcd432e41b43a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:08:36 +0200
Subject: [PATCH 1632/4023] Simplify internal state complexity

---
 packages/framework/src/Facades/Features.php   | 35 ++++++-------------
 .../Feature/ConfigurableFeaturesTest.php      |  2 ++
 2 files changed, 13 insertions(+), 24 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index d8850563825..36272bd6019 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -12,7 +12,7 @@
 use Hyde\Support\Contracts\SerializableContract;
 
 use function is_array;
-use function array_keys;
+use function array_map;
 use function array_filter;
 use function extension_loaded;
 use function in_array;
@@ -29,9 +29,7 @@ class Features implements SerializableContract
     /**
      * The features that are enabled.
      *
-     * @todo Simplify internal state complexity
-     *
-     * @var array<string, bool>
+     * @var array<string>
      */
     protected array $features = [];
 
@@ -55,7 +53,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return array_keys(array_filter(Hyde::features()->toArray()));
+        return Hyde::features()->features;
     }
 
     // =================================================
@@ -192,7 +190,7 @@ public function toArray(): array
     {
         return collect(Feature::cases())
             ->mapWithKeys(fn (Feature $feature): array => [
-                 $feature->value => isset($this->features[$feature->value]),
+                $feature->value => in_array($feature->value, $this->features),
             ])->toArray();
     }
 
@@ -204,23 +202,7 @@ protected static function getDefaultOptions(): array
 
     protected function boot(): array
     {
-        $options = static::getDefaultOptions();
-
-        $enabled = [];
-
-        // Set all default features to false
-        foreach ($options as $feature) {
-            $enabled[$feature->value] = false;
-        }
-
-        // Set all features to true if they are enabled in the config file
-        foreach ($this->getConfiguredFeatures() as $feature) {
-            if (in_array($feature, $options)) {
-                $enabled[$feature->value] = true;
-            }
-        }
-
-        return $enabled;
+        return array_map(fn (Feature $feature): string => $feature->value, $this->getConfiguredFeatures());
     }
 
     /** @return array<Feature> */
@@ -239,7 +221,12 @@ public static function mock(string|array $feature, bool $enabled = null): void
         $features = is_array($feature) ? $feature : [$feature => $enabled];
 
         foreach ($features as $feature => $enabled) {
-            Hyde::features()->features[$feature] = $enabled;
+            if ($enabled !== true) {
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
+                continue;
+            }
+
+            Hyde::features()->features[] = $feature;
         }
     }
 }
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index fcea406456a..3a67769abba 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -182,6 +182,8 @@ public function testGetEnabledUsesConfiguredOptions()
 
     public function testCannotUseArbitraryValuesInEnabledOptions()
     {
+        $this->expectException(\TypeError::class); // Todo: Consider if we should handle this again by ignoring it, or throw with a more specific message
+
         $config = [
             Features::htmlPages(),
             Features::markdownPosts(),

From ed86b9a722a1cf5237421098354baa10f6236966 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:38:06 +0200
Subject: [PATCH 1633/4023] Update test names to be clearer

---
 .../framework/tests/Unit/ConfigurableFeaturesUnitTest.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
index a7ba8225f77..affa5198563 100644
--- a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
+++ b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
@@ -11,7 +11,7 @@
     $this->needsKernel();
 });
 
-test('expect has method returns false when feature is disabled', function (Feature $feature) {
+test('has feature method returns false when feature is disabled', function (Feature $feature) {
     $method = "has$feature->name";
 
     Config::set('hyde.features', []);
@@ -20,7 +20,7 @@
     $this->assertFalse(Features::$method(), "Method '$method' should return false when feature is not enabled");
 })->with(Feature::cases())->covers(Hyde\Facades\Features::class);
 
-test('expect has method returns true when feature is enabled', function (Feature $feature) {
+test('has feature method returns true when feature is enabled', function (Feature $feature) {
     $method = "has$feature->name";
 
     Config::set('hyde.features', [$feature]);

From 25f467ca6640ddbbd96531e21d834efa35c04691 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:40:06 +0200
Subject: [PATCH 1634/4023] Update test to use enum cases instead of reflection

---
 packages/framework/tests/Unit/ConfigFileTest.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/ConfigFileTest.php b/packages/framework/tests/Unit/ConfigFileTest.php
index 8ea6dda5e80..d216f6c41f9 100644
--- a/packages/framework/tests/Unit/ConfigFileTest.php
+++ b/packages/framework/tests/Unit/ConfigFileTest.php
@@ -4,7 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Facades\Features;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Hyde;
 use Hyde\Pages\BladePage;
@@ -13,7 +13,6 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\UnitTestCase;
-use ReflectionClass;
 
 /**
  * @see \Hyde\Framework\Testing\Unit\HydeConfigFilesAreMatchingTest
@@ -79,7 +78,7 @@ public function testDefaultOutputDirectoriesValuesCoverAllCoreExtensionClasses()
     public function testDefaultFeaturesArrayMatchesDefaultFeatures()
     {
         expect($this->getConfig('features'))
-            ->toBe((new ReflectionClass(Features::class))->getMethod('getDefaultOptions')->invoke(null));
+            ->toBe(Feature::cases());
     }
 
     protected function getConfig(string $option): mixed

From 2276ecee0f1e4ae6027c0f3975cef2aa84ffc3d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:40:20 +0200
Subject: [PATCH 1635/4023] Inline helper method only used once

---
 packages/framework/src/Facades/Features.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 36272bd6019..32cc28cfff4 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -194,12 +194,6 @@ public function toArray(): array
             ])->toArray();
     }
 
-    /** @return array<Feature> */
-    protected static function getDefaultOptions(): array
-    {
-        return Feature::cases();
-    }
-
     protected function boot(): array
     {
         return array_map(fn (Feature $feature): string => $feature->value, $this->getConfiguredFeatures());
@@ -208,7 +202,7 @@ protected function boot(): array
     /** @return array<Feature> */
     protected function getConfiguredFeatures(): array
     {
-        return Config::getArray('hyde.features', static::getDefaultOptions());
+        return Config::getArray('hyde.features', Feature::cases());
     }
 
     /**

From 33c49b68e738223dcc10facab3414195a3841c34 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:42:17 +0200
Subject: [PATCH 1636/4023] Test all enum cases have a features accessor

---
 .../framework/tests/Unit/ConfigurableFeaturesUnitTest.php   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
index affa5198563..ab9181af0b3 100644
--- a/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
+++ b/packages/framework/tests/Unit/ConfigurableFeaturesUnitTest.php
@@ -33,3 +33,9 @@
         Feature::Torchlight,
     ]))
 )->covers(Hyde\Facades\Features::class);
+
+test('all enum cases have a features accessor', function (Feature $feature) {
+    $method = "has$feature->name";
+
+    $this->assertTrue(method_exists(Features::class, $method), "Method '$method' should exist on Features facade");
+})->with(Feature::cases())->covers(Hyde\Facades\Features::class);

From 3568fe578eb721c6afe05284881d20fd9c6cc724 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 21:57:35 +0200
Subject: [PATCH 1637/4023] Format inline code in comment

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 32cc28cfff4..57a559e8e64 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -163,7 +163,7 @@ public static function hasRss(): bool
 
     /**
      * Torchlight is by default enabled automatically when an API token
-     * is set in the .env file but is disabled when running tests.
+     * is set in the `.env` file but is disabled when running tests.
      */
     public static function hasTorchlight(): bool
     {

From db3d5f81fbc964dd101da0c7d02acbd5ddd812a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Apr 2024 22:06:08 +0200
Subject: [PATCH 1638/4023] Breaking: Replace feature config helper methods
 with enum usages

---
 RELEASE_NOTES.md                              | 50 ++++++++++++++++
 config/hyde.php                               | 19 +++---
 docs/creating-content/documentation-pages.md  |  4 +-
 packages/framework/config/hyde.php            | 19 +++---
 packages/framework/src/Facades/Features.php   | 60 +++----------------
 .../Framework/Services/ValidationService.php  |  3 +-
 .../Feature/ConfigurableFeaturesTest.php      | 25 ++++----
 .../tests/Feature/DarkmodeFeatureTest.php     | 20 +++----
 8 files changed, 103 insertions(+), 97 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9291bf16b26..369a951b155 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -15,6 +15,7 @@ This serves two purposes:
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
+- **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
@@ -70,6 +71,55 @@ The following configuration entries have been updated:
 -  Changed configuration option `docs.table_of_contents` to `docs.sidebar.table_of_contents` in https://github.com/hydephp/develop/pull/1584
 -  Upgrade path: Move the `table_of_contents` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
 
+### Features configuration changes
+
+The `hyde.features` configuration format has changed to use Enums instead of static method calls. This change is breaking as it will require you to update your `config/hyde.php` file.
+
+#### Instead of
+
+```php
+// filepath: config/hyde.php
+
+'features' => [
+    // Page Modules
+    Features::htmlPages(),
+    Features::markdownPosts(),
+    Features::bladePages(),
+    Features::markdownPages(),
+    Features::documentationPages(),
+    
+    // Frontend Features
+    Features::darkmode(),
+    Features::documentationSearch(),
+    
+    // Integrations
+    Features::torchlight(),
+],
+```
+
+#### Use instead
+
+```php
+// filepath: config/hyde.php
+
+'features' => [
+    // Page Modules
+    Feature::HtmlPages,
+    Feature::MarkdownPosts,
+    Feature::BladePages,
+    Feature::MarkdownPages,
+    Feature::DocumentationPages,
+
+    // Frontend Features
+    Feature::Darkmode,
+    Feature::DocumentationSearch,
+
+    // Integrations
+    Feature::Torchlight,
+],
+```
+
+Of course, if you have disabled any of the features, do not include them in the new array.
 
 ## General impact
 
diff --git a/config/hyde.php b/config/hyde.php
index c91370adce7..b343067a44c 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -23,8 +23,8 @@
 */
 
 use Hyde\Facades\Author;
-use Hyde\Facades\Features;
 use Hyde\Facades\Meta;
+use Hyde\Foundation\Concerns\Feature;
 
 return [
 
@@ -248,24 +248,23 @@
     |
     | Some of Hyde's features are optional. Feel free to disable the features
     | you don't need by removing or commenting them out from this array.
-    | This config concept is directly inspired by Laravel Jetstream.
     |
     */
 
     'features' => [
         // Page Modules
-        Features::htmlPages(),
-        Features::markdownPosts(),
-        Features::bladePages(),
-        Features::markdownPages(),
-        Features::documentationPages(),
+        Feature::HtmlPages,
+        Feature::MarkdownPosts,
+        Feature::BladePages,
+        Feature::MarkdownPages,
+        Feature::DocumentationPages,
 
         // Frontend Features
-        Features::darkmode(),
-        Features::documentationSearch(),
+        Feature::Darkmode,
+        Feature::DocumentationSearch,
 
         // Integrations
-        Features::torchlight(),
+        Feature::Torchlight,
     ],
 
     /*
diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 1e9839e8539..aed6f445be6 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -290,12 +290,12 @@ that runs during the build command, and a frontend JavaScript plugin that adds t
 
 >info Tip: The HydeSearch plugin is what powers the search feature on this site! Why not [try it out](search)?
 
-The search feature is enabled by default. You can disable it by removing the `documentationSearch` from the Hyde `Features` config array.
+The search feature is enabled by default. You can disable it by removing the `DocumentationSearch` option from the Hyde `Features` config array.
 
 ```php
 // filepath: config/hyde.php
 'features' => [
-    Features::documentationSearch(), // [tl! --]
+    Feature::DocumentationSearch, // [tl! --]
 ],
 ```
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index c91370adce7..b343067a44c 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -23,8 +23,8 @@
 */
 
 use Hyde\Facades\Author;
-use Hyde\Facades\Features;
 use Hyde\Facades\Meta;
+use Hyde\Foundation\Concerns\Feature;
 
 return [
 
@@ -248,24 +248,23 @@
     |
     | Some of Hyde's features are optional. Feel free to disable the features
     | you don't need by removing or commenting them out from this array.
-    | This config concept is directly inspired by Laravel Jetstream.
     |
     */
 
     'features' => [
         // Page Modules
-        Features::htmlPages(),
-        Features::markdownPosts(),
-        Features::bladePages(),
-        Features::markdownPages(),
-        Features::documentationPages(),
+        Feature::HtmlPages,
+        Feature::MarkdownPosts,
+        Feature::BladePages,
+        Feature::MarkdownPages,
+        Feature::DocumentationPages,
 
         // Frontend Features
-        Features::darkmode(),
-        Features::documentationSearch(),
+        Feature::Darkmode,
+        Feature::DocumentationSearch,
 
         // Integrations
-        Features::torchlight(),
+        Feature::Torchlight,
     ],
 
     /*
diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 57a559e8e64..dd73fc2fc0c 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -56,82 +56,38 @@ public static function enabled(): array
         return Hyde::features()->features;
     }
 
-    // =================================================
-    // Configure features to be used in the config file.
-    // =================================================
-
-    public static function htmlPages(): Feature
-    {
-        return Feature::HtmlPages;
-    }
-
-    public static function bladePages(): Feature
-    {
-        return Feature::BladePages;
-    }
-
-    public static function markdownPages(): Feature
-    {
-        return Feature::MarkdownPages;
-    }
-
-    public static function markdownPosts(): Feature
-    {
-        return Feature::MarkdownPosts;
-    }
-
-    public static function documentationPages(): Feature
-    {
-        return Feature::DocumentationPages;
-    }
-
-    public static function documentationSearch(): Feature
-    {
-        return Feature::DocumentationSearch;
-    }
-
-    public static function darkmode(): Feature
-    {
-        return Feature::Darkmode;
-    }
-
-    public static function torchlight(): Feature
-    {
-        return Feature::Torchlight;
-    }
-
     // ================================================
     // Determine if a given feature is enabled.
     // ================================================
 
     public static function hasHtmlPages(): bool
     {
-        return static::has(static::htmlPages());
+        return static::has(Feature::HtmlPages);
     }
 
     public static function hasBladePages(): bool
     {
-        return static::has(static::bladePages());
+        return static::has(Feature::BladePages);
     }
 
     public static function hasMarkdownPages(): bool
     {
-        return static::has(static::markdownPages());
+        return static::has(Feature::MarkdownPages);
     }
 
     public static function hasMarkdownPosts(): bool
     {
-        return static::has(static::markdownPosts());
+        return static::has(Feature::MarkdownPosts);
     }
 
     public static function hasDocumentationPages(): bool
     {
-        return static::has(static::documentationPages());
+        return static::has(Feature::DocumentationPages);
     }
 
     public static function hasDarkmode(): bool
     {
-        return static::has(static::darkmode());
+        return static::has(Feature::Darkmode);
     }
 
     // ====================================================
@@ -167,14 +123,14 @@ public static function hasRss(): bool
      */
     public static function hasTorchlight(): bool
     {
-        return static::has(static::torchlight())
+        return static::has(Feature::Torchlight)
             && (Config::getNullableString('torchlight.token') !== null)
             && (app('env') !== 'testing');
     }
 
     public static function hasDocumentationSearch(): bool
     {
-        return static::has(static::documentationSearch())
+        return static::has(Feature::DocumentationSearch)
             && static::hasDocumentationPages()
             && count(DocumentationPage::files()) > 0;
     }
diff --git a/packages/framework/src/Framework/Services/ValidationService.php b/packages/framework/src/Framework/Services/ValidationService.php
index fc62734ce59..307e3eb3fa9 100644
--- a/packages/framework/src/Framework/Services/ValidationService.php
+++ b/packages/framework/src/Framework/Services/ValidationService.php
@@ -10,6 +10,7 @@
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Foundation\Concerns\Feature;
 use Hyde\Support\Models\ValidationResult as Result;
 
 use function count;
@@ -121,7 +122,7 @@ public function check_site_has_a_base_url_set(Result $result): Result
 
     public function check_a_torchlight_api_token_is_set(Result $result): Result
     {
-        if (! Features::has(Features::torchlight())) {
+        if (! Features::has(Feature::Torchlight)) {
             return $result->skip('Check a Torchlight API token is set')
                 ->withTip('Torchlight is an API for code syntax highlighting. You can enable it in the Hyde config.');
         }
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index 3a67769abba..8ff74c14457 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Facades\Features;
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\Concerns\Feature;
 use Illuminate\Support\Facades\Config;
 
 use function config;
@@ -82,9 +83,9 @@ public function testToArrayMethodContainsAllSettings()
     public function testToArrayMethodContainsAllSettingsIncludingFalseValues()
     {
         config(['hyde.features' => [
-            Features::htmlPages(),
-            Features::markdownPosts(),
-            Features::bladePages(),
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
         ]]);
 
         $this->assertSame([
@@ -102,9 +103,9 @@ public function testToArrayMethodContainsAllSettingsIncludingFalseValues()
     public function testSerializedClassState()
     {
         config(['hyde.features' => [
-            Features::htmlPages(),
-            Features::markdownPosts(),
-            Features::bladePages(),
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
         ]]);
 
         $this->assertSame(<<<'JSON'
@@ -168,9 +169,9 @@ public function testGetEnabledUsesDefaultOptionsWhenConfigIsEmpty()
     public function testGetEnabledUsesConfiguredOptions()
     {
         config(['hyde.features' => [
-            Features::htmlPages(),
-            Features::markdownPosts(),
-            Features::bladePages(),
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
         ]]);
 
         $this->assertSame([
@@ -185,9 +186,9 @@ public function testCannotUseArbitraryValuesInEnabledOptions()
         $this->expectException(\TypeError::class); // Todo: Consider if we should handle this again by ignoring it, or throw with a more specific message
 
         $config = [
-            Features::htmlPages(),
-            Features::markdownPosts(),
-            Features::bladePages(),
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
             'foo',
         ];
 
diff --git a/packages/framework/tests/Feature/DarkmodeFeatureTest.php b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
index 0e8a72f95bf..2e6fcfb4831 100644
--- a/packages/framework/tests/Feature/DarkmodeFeatureTest.php
+++ b/packages/framework/tests/Feature/DarkmodeFeatureTest.php
@@ -7,11 +7,11 @@
 use Hyde\Facades\Features;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\Concerns\Feature;
 use Illuminate\Support\Facades\Config;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 
 /**
- * @covers \Hyde\Facades\Features::darkmode
  * @covers \Hyde\Facades\Features::hasDarkmode
  */
 class DarkmodeFeatureTest extends TestCase
@@ -34,7 +34,7 @@ public function testHasDarkmodeIsFalseWhenNotSet()
     public function testHasDarkmodeIsTrueWhenSet()
     {
         Config::set('hyde.features', [
-            Features::darkmode(),
+            Feature::Darkmode,
         ]);
 
         $this->assertTrue(Features::hasDarkmode());
@@ -43,9 +43,9 @@ public function testHasDarkmodeIsTrueWhenSet()
     public function testLayoutHasToggleButtonAndScriptWhenEnabled()
     {
         Config::set('hyde.features', [
-            Features::markdownPages(),
-            Features::bladePages(),
-            Features::darkmode(),
+            Feature::MarkdownPages,
+            Feature::BladePages,
+            Feature::Darkmode,
         ]);
 
         app()->instance('navigation.main', new MainNavigationMenu());
@@ -63,8 +63,8 @@ public function testLayoutHasToggleButtonAndScriptWhenEnabled()
     public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
     {
         Config::set('hyde.features', [
-            Features::documentationPages(),
-            Features::darkmode(),
+            Feature::DocumentationPages,
+            Feature::Darkmode,
         ]);
 
         view()->share('page', new DocumentationPage());
@@ -82,8 +82,8 @@ public function testDocumentationPageHasToggleButtonAndScriptWhenEnabled()
     public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     {
         Config::set('hyde.features', [
-            Features::markdownPages(),
-            Features::bladePages(),
+            Feature::MarkdownPages,
+            Feature::BladePages,
         ]);
 
         app()->instance('navigation.main', new MainNavigationMenu());
@@ -101,7 +101,7 @@ public function testDarkModeThemeButtonIsHiddenInLayoutsWhenDisabled()
     public function testDarkModeThemeButtonIsHiddenInDocumentationPagesWhenDisabled()
     {
         Config::set('hyde.features', [
-            Features::documentationPages(),
+            Feature::DocumentationPages,
         ]);
 
         view()->share('page', new DocumentationPage());

From 049e894fdc21787327fa9f2a8ba80d8d5e83d3d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 10:59:25 +0200
Subject: [PATCH 1639/4023] Add method description

---
 packages/framework/src/Facades/Features.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index dd73fc2fc0c..ad98c601280 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -128,6 +128,9 @@ public static function hasTorchlight(): bool
             && (app('env') !== 'testing');
     }
 
+    /**
+     * Should documentation search be enabled?
+     */
     public static function hasDocumentationSearch(): bool
     {
         return static::has(Feature::DocumentationSearch)

From dfb56d58e0f9e0531e4b5e384fdebc316e9a07af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:26:47 +0200
Subject: [PATCH 1640/4023] Move up method in source

---
 packages/framework/src/Facades/Features.php | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index ad98c601280..ef90e5be6e6 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -117,6 +117,16 @@ public static function hasRss(): bool
             && count(MarkdownPost::files()) > 0;
     }
 
+    /**
+     * Should documentation search be enabled?
+     */
+    public static function hasDocumentationSearch(): bool
+    {
+        return static::has(Feature::DocumentationSearch)
+            && static::hasDocumentationPages()
+            && count(DocumentationPage::files()) > 0;
+    }
+
     /**
      * Torchlight is by default enabled automatically when an API token
      * is set in the `.env` file but is disabled when running tests.
@@ -128,16 +138,6 @@ public static function hasTorchlight(): bool
             && (app('env') !== 'testing');
     }
 
-    /**
-     * Should documentation search be enabled?
-     */
-    public static function hasDocumentationSearch(): bool
-    {
-        return static::has(Feature::DocumentationSearch)
-            && static::hasDocumentationPages()
-            && count(DocumentationPage::files()) > 0;
-    }
-
     /**
      * Get an array representation of the features and their status.
      *

From ed72df638b28c55bc6ea6de7f33d98403e380dac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:26:58 +0200
Subject: [PATCH 1641/4023] Remove legacy section comments for simplified class

---
 packages/framework/src/Facades/Features.php | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index ef90e5be6e6..7b4d78855cd 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -56,10 +56,6 @@ public static function enabled(): array
         return Hyde::features()->features;
     }
 
-    // ================================================
-    // Determine if a given feature is enabled.
-    // ================================================
-
     public static function hasHtmlPages(): bool
     {
         return static::has(Feature::HtmlPages);
@@ -90,11 +86,6 @@ public static function hasDarkmode(): bool
         return static::has(Feature::Darkmode);
     }
 
-    // ====================================================
-    // Dynamic features that in addition to being enabled
-    // in the config file, require preconditions to be met.
-    // ====================================================
-
     /**
      * Can a sitemap be generated?
      */

From 89d735d21f45b526a8ec93add18bdd1b386e0fe5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:29:48 +0200
Subject: [PATCH 1642/4023] Replace local collect call with array helper

---
 packages/framework/src/Facades/Features.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 7b4d78855cd..32d365a0bfc 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -10,6 +10,7 @@
 use Hyde\Foundation\Concerns\Feature;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
+use Illuminate\Support\Arr;
 
 use function is_array;
 use function array_map;
@@ -138,10 +139,9 @@ public static function hasTorchlight(): bool
      */
     public function toArray(): array
     {
-        return collect(Feature::cases())
-            ->mapWithKeys(fn (Feature $feature): array => [
-                $feature->value => in_array($feature->value, $this->features),
-            ])->toArray();
+        return Arr::mapWithKeys(Feature::cases(), fn (Feature $feature): array => [
+            $feature->value => in_array($feature->value, $this->features),
+        ]);
     }
 
     protected function boot(): array

From f7f9c37a3ffa8ffab0042e28ea19adb841a91346 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:55:52 +0200
Subject: [PATCH 1643/4023] Use array helper to match code style

---
 packages/framework/src/Facades/Features.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 32d365a0bfc..28271088802 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -13,7 +13,6 @@
 use Illuminate\Support\Arr;
 
 use function is_array;
-use function array_map;
 use function array_filter;
 use function extension_loaded;
 use function in_array;
@@ -146,7 +145,7 @@ public function toArray(): array
 
     protected function boot(): array
     {
-        return array_map(fn (Feature $feature): string => $feature->value, $this->getConfiguredFeatures());
+        return Arr::map($this->getConfiguredFeatures(), fn (Feature $feature): string => $feature->value);
     }
 
     /** @return array<Feature> */

From a22ecba039a40b366716afc7364838e42153acef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:57:02 +0200
Subject: [PATCH 1644/4023] Convert the arrow function to a traditional closure

---
 packages/framework/src/Facades/Features.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 28271088802..b8b4549d0ca 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -145,7 +145,9 @@ public function toArray(): array
 
     protected function boot(): array
     {
-        return Arr::map($this->getConfiguredFeatures(), fn (Feature $feature): string => $feature->value);
+        return Arr::map($this->getConfiguredFeatures(), function (Feature $feature): string {
+            return $feature->value;
+        });
     }
 
     /** @return array<Feature> */

From 15ca74580ed73864559c75adde6263c723848882 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:57:34 +0200
Subject: [PATCH 1645/4023] Replace continue with else branch

---
 packages/framework/src/Facades/Features.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b8b4549d0ca..c1ac25b4a56 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -168,10 +168,9 @@ public static function mock(string|array $feature, bool $enabled = null): void
         foreach ($features as $feature => $enabled) {
             if ($enabled !== true) {
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
-                continue;
+            } else {
+                Hyde::features()->features[] = $feature;
             }
-
-            Hyde::features()->features[] = $feature;
         }
     }
 }

From a1fecf24a3a68fb2ea8c8712bee344bec6948dad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:58:23 +0200
Subject: [PATCH 1646/4023] Inline local variable

---
 packages/framework/src/Facades/Features.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index c1ac25b4a56..512d84df901 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -163,9 +163,7 @@ protected function getConfiguredFeatures(): array
      */
     public static function mock(string|array $feature, bool $enabled = null): void
     {
-        $features = is_array($feature) ? $feature : [$feature => $enabled];
-
-        foreach ($features as $feature => $enabled) {
+        foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
             if ($enabled !== true) {
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
             } else {

From d27a4168c7e8e53fcd69164d92da1e32a15feec8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:58:49 +0200
Subject: [PATCH 1647/4023] Invert 'if' statement

---
 packages/framework/src/Facades/Features.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 512d84df901..b5098197052 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -164,10 +164,10 @@ protected function getConfiguredFeatures(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            if ($enabled !== true) {
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
-            } else {
+            if ($enabled === true) {
                 Hyde::features()->features[] = $feature;
+            } else {
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
             }
         }
     }

From 64f438b5db2c256c485b32763bf5be05e86227c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 11:58:52 +0200
Subject: [PATCH 1648/4023] Revert "Invert 'if' statement"

This reverts commit d27a4168c7e8e53fcd69164d92da1e32a15feec8.
---
 packages/framework/src/Facades/Features.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index b5098197052..512d84df901 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -164,10 +164,10 @@ protected function getConfiguredFeatures(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            if ($enabled === true) {
-                Hyde::features()->features[] = $feature;
-            } else {
+            if ($enabled !== true) {
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
+            } else {
+                Hyde::features()->features[] = $feature;
             }
         }
     }

From 17f0021b3e9843ba47f81700ed61db9d67cc0d91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 12:06:44 +0200
Subject: [PATCH 1649/4023] Simplify internal state to store the enums directly

---
 packages/framework/src/Facades/Features.php | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 512d84df901..d155c0494e7 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -29,7 +29,7 @@ class Features implements SerializableContract
     /**
      * The features that are enabled.
      *
-     * @var array<string>
+     * @var array<Feature>
      */
     protected array $features = [];
 
@@ -43,7 +43,7 @@ public function __construct()
      */
     public static function has(Feature $feature): bool
     {
-        return in_array($feature->value, static::enabled());
+        return in_array($feature, Hyde::features()->features);
     }
 
     /**
@@ -53,7 +53,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return Hyde::features()->features;
+        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => $feature->value);
     }
 
     public static function hasHtmlPages(): bool
@@ -139,15 +139,13 @@ public static function hasTorchlight(): bool
     public function toArray(): array
     {
         return Arr::mapWithKeys(Feature::cases(), fn (Feature $feature): array => [
-            $feature->value => in_array($feature->value, $this->features),
+            $feature->value => static::has($feature),
         ]);
     }
 
     protected function boot(): array
     {
-        return Arr::map($this->getConfiguredFeatures(), function (Feature $feature): string {
-            return $feature->value;
-        });
+        return $this->getConfiguredFeatures();
     }
 
     /** @return array<Feature> */
@@ -165,9 +163,9 @@ public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
             if ($enabled !== true) {
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (string $search): bool => $search !== $feature);
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== Feature::from($feature));
             } else {
-                Hyde::features()->features[] = $feature;
+                Hyde::features()->features[] = Feature::from($feature);
             }
         }
     }

From 36e8e2f28634be14deb3d28a063f3000b9aea0b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 12:08:07 +0200
Subject: [PATCH 1650/4023] Inline simplified helper method

---
 packages/framework/src/Facades/Features.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index d155c0494e7..643c445b870 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -35,7 +35,7 @@ class Features implements SerializableContract
 
     public function __construct()
     {
-        $this->features = $this->boot();
+        $this->features = $this->getConfiguredFeatures();
     }
 
     /**
@@ -143,11 +143,6 @@ public function toArray(): array
         ]);
     }
 
-    protected function boot(): array
-    {
-        return $this->getConfiguredFeatures();
-    }
-
     /** @return array<Feature> */
     protected function getConfiguredFeatures(): array
     {

From b11bc97a784947b9f2a5c90159c259df2bebfe74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 12:08:16 +0200
Subject: [PATCH 1651/4023] Inline simplified helper method

---
 packages/framework/src/Facades/Features.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 643c445b870..0c0ba5efc9d 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -35,7 +35,7 @@ class Features implements SerializableContract
 
     public function __construct()
     {
-        $this->features = $this->getConfiguredFeatures();
+        $this->features = Config::getArray('hyde.features', Feature::cases());
     }
 
     /**
@@ -143,12 +143,6 @@ public function toArray(): array
         ]);
     }
 
-    /** @return array<Feature> */
-    protected function getConfiguredFeatures(): array
-    {
-        return Config::getArray('hyde.features', Feature::cases());
-    }
-
     /**
      * @internal This method is not covered by the backward compatibility promise.
      *

From fd0eaf15bd6d4d7e96e1c66e8046010c6fb8f075 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 12:08:52 +0200
Subject: [PATCH 1652/4023] Use fully qualified class name in generics

---
 packages/framework/src/Facades/Features.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 0c0ba5efc9d..f105b9bb3a7 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -29,7 +29,7 @@ class Features implements SerializableContract
     /**
      * The features that are enabled.
      *
-     * @var array<Feature>
+     * @var array<\Hyde\Foundation\Concerns\Feature>
      */
     protected array $features = [];
 

From 95574d2be57dc5f93e5d4f64200a713f113de53a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:37:07 +0200
Subject: [PATCH 1653/4023] Extract helper to get the enum key

---
 packages/framework/src/Enums/Feature.php    | 5 +++++
 packages/framework/src/Facades/Features.php | 4 ++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 073ef90f2f8..2b0a1125f05 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -24,4 +24,9 @@ enum Feature: string
 
     // Integrations
     case Torchlight = 'torchlight';
+
+    public function key(): string
+    {
+        return $this->value;
+    }
 }
diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 078d40d2375..6c39d10d8ee 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -53,7 +53,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => $feature->value);
+        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => $feature->key());
     }
 
     public static function hasHtmlPages(): bool
@@ -139,7 +139,7 @@ public static function hasTorchlight(): bool
     public function toArray(): array
     {
         return Arr::mapWithKeys(Feature::cases(), fn (Feature $feature): array => [
-            $feature->value => static::has($feature),
+            $feature->key() => static::has($feature),
         ]);
     }
 

From 217b7bafbd110c4079ea24da42c0407fdebe2880 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:37:39 +0200
Subject: [PATCH 1654/4023] Get key using string name transformation

---
 packages/framework/src/Enums/Feature.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 2b0a1125f05..bf4206c5608 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Enums;
 
+use Illuminate\Support\Str;
+
 /**
  * A configurable feature that belongs to the Features class.
  *
@@ -27,6 +29,6 @@ enum Feature: string
 
     public function key(): string
     {
-        return $this->value;
+        return Str::kebab($this->name);
     }
 }

From d2b1ef6e07e2ec834f3f18a9c1ae512e0ef96170 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:39:39 +0200
Subject: [PATCH 1655/4023] Introduce local variable

---
 packages/framework/src/Facades/Features.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 6c39d10d8ee..af9f49a9bca 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -151,10 +151,12 @@ public function toArray(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
+            $feature = Feature::from($feature);
+
             if ($enabled !== true) {
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== Feature::from($feature));
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== $feature);
             } else {
-                Hyde::features()->features[] = Feature::from($feature);
+                Hyde::features()->features[] = $feature;
             }
         }
     }

From edf8e989d9299d56dd0b8ec86d4f6ca565822563 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:42:40 +0200
Subject: [PATCH 1656/4023] Change search logic in preparation for next
 refactor step

---
 packages/framework/src/Facades/Features.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index af9f49a9bca..43d36cffc72 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -5,6 +5,7 @@
 namespace Hyde\Facades;
 
 use Hyde\Hyde;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Enums\Feature;
@@ -12,6 +13,8 @@
 use Hyde\Support\Contracts\SerializableContract;
 use Illuminate\Support\Arr;
 
+use function ucfirst;
+use function collect;
 use function is_array;
 use function array_filter;
 use function extension_loaded;
@@ -151,7 +154,7 @@ public function toArray(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            $feature = Feature::from($feature);
+            $feature = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => $search->name === ucfirst(Str::camel($feature)));
 
             if ($enabled !== true) {
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== $feature);

From 5b050f7764f4dbc1af8a2fa3084b7933d75715f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:44:06 +0200
Subject: [PATCH 1657/4023] Inline the key method

---
 packages/framework/src/Enums/Feature.php    | 7 -------
 packages/framework/src/Facades/Features.php | 4 ++--
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index bf4206c5608..073ef90f2f8 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Enums;
 
-use Illuminate\Support\Str;
-
 /**
  * A configurable feature that belongs to the Features class.
  *
@@ -26,9 +24,4 @@ enum Feature: string
 
     // Integrations
     case Torchlight = 'torchlight';
-
-    public function key(): string
-    {
-        return Str::kebab($this->name);
-    }
 }
diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 43d36cffc72..1b2726ac454 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -56,7 +56,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => $feature->key());
+        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => Str::kebab($feature->name));
     }
 
     public static function hasHtmlPages(): bool
@@ -142,7 +142,7 @@ public static function hasTorchlight(): bool
     public function toArray(): array
     {
         return Arr::mapWithKeys(Feature::cases(), fn (Feature $feature): array => [
-            $feature->key() => static::has($feature),
+            Str::kebab($feature->name) => static::has($feature),
         ]);
     }
 

From cb136f9a296ced4c2a0bae190d6d72cc0f653c56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 18:24:15 +0200
Subject: [PATCH 1658/4023] Add temporary kebab case support helper

---
 packages/framework/src/Enums/Feature.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 073ef90f2f8..8048fb6229d 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -24,4 +24,19 @@ enum Feature: string
 
     // Integrations
     case Torchlight = 'torchlight';
+
+    /** @deprecated Temporary kebab case support */
+    public static function from(string $name): self
+    {
+        return match ($name) {
+            'html-pages' => self::HtmlPages,
+            'markdown-posts' => self::MarkdownPosts,
+            'blade-pages' => self::BladePages,
+            'markdown-pages' => self::MarkdownPages,
+            'documentation-pages' => self::DocumentationPages,
+            'darkmode' => self::Darkmode,
+            'documentation-search' => self::DocumentationSearch,
+            'torchlight' => self::Torchlight,
+        };
+    }
 }

From 649fd9d5ee3e38aaa50b71a32ce34dfce7337dbd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 17:46:17 +0200
Subject: [PATCH 1659/4023] Remove string backing from Feature enum

This information does not add any actual value
---
 packages/framework/src/Enums/Feature.php | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 8048fb6229d..f5d0577edf3 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -9,21 +9,21 @@
  *
  * @see \Hyde\Facades\Features
  */
-enum Feature: string
+enum Feature
 {
     // Page Modules
-    case HtmlPages = 'html-pages';
-    case MarkdownPosts = 'markdown-posts';
-    case BladePages = 'blade-pages';
-    case MarkdownPages = 'markdown-pages';
-    case DocumentationPages = 'documentation-pages';
+    case HtmlPages;
+    case MarkdownPosts;
+    case BladePages;
+    case MarkdownPages;
+    case DocumentationPages;
 
     // Frontend Features
-    case Darkmode = 'darkmode';
-    case DocumentationSearch = 'documentation-search';
+    case Darkmode;
+    case DocumentationSearch;
 
     // Integrations
-    case Torchlight = 'torchlight';
+    case Torchlight;
 
     /** @deprecated Temporary kebab case support */
     public static function from(string $name): self

From 3bf22266207d78a57a5d6af3195c9d78353fb5a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Apr 2024 18:28:37 +0200
Subject: [PATCH 1660/4023] Revert "Change search logic in preparation for next
 refactor step"

This reverts commit edf8e989d9299d56dd0b8ec86d4f6ca565822563.
---
 packages/framework/src/Facades/Features.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 1b2726ac454..ac4b8a3f839 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -13,8 +13,6 @@
 use Hyde\Support\Contracts\SerializableContract;
 use Illuminate\Support\Arr;
 
-use function ucfirst;
-use function collect;
 use function is_array;
 use function array_filter;
 use function extension_loaded;
@@ -154,7 +152,7 @@ public function toArray(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            $feature = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => $search->name === ucfirst(Str::camel($feature)));
+            $feature = Feature::from($feature);
 
             if ($enabled !== true) {
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== $feature);

From 0979b2988c5ce068d4837af5c2f0d53faebfd7ac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Apr 2024 13:57:07 +0200
Subject: [PATCH 1661/4023] Check feature states using the feature enum

---
 .../views/components/navigation/theme-toggle-button.blade.php  | 2 +-
 packages/framework/resources/views/layouts/head.blade.php      | 2 +-
 .../framework/tests/Feature/Views/SidebarBrandViewTest.php     | 3 ++-
 packages/framework/tests/Unit/HydeHelperFacadeTest.php         | 3 ++-
 4 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/theme-toggle-button.blade.php b/packages/framework/resources/views/components/navigation/theme-toggle-button.blade.php
index 28433f21c9b..38fe3eb24fc 100644
--- a/packages/framework/resources/views/components/navigation/theme-toggle-button.blade.php
+++ b/packages/framework/resources/views/components/navigation/theme-toggle-button.blade.php
@@ -1,4 +1,4 @@
-@if(Hyde::hasFeature('darkmode'))
+@if(Hyde::hasFeature(\Hyde\Enums\Feature::Darkmode))
     <button @click="toggleTheme" {{ $attributes->merge(['class' => 'theme-toggle-button flex items-center px-2 py-1 hover:text-gray-700 dark:text-gray-200']) }} title="Toggle theme">
         <span class="sr-only">Toggle dark theme</span>
         <svg width="1.25rem" height="1.25rem" class="w-5 h-5 hidden dark:block" fill="#FFFFFF" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg"><path d="M10 2a1 1 0 011 1v1a1 1 0 11-2 0V3a1 1 0 011-1zm4 8a4 4 0 11-8 0 4 4 0 018 0zm-.464 4.95l.707.707a1 1 0 001.414-1.414l-.707-.707a1 1 0 00-1.414 1.414zm2.12-10.607a1 1 0 010 1.414l-.706.707a1 1 0 11-1.414-1.414l.707-.707a1 1 0 011.414 0zM17 11a1 1 0 100-2h-1a1 1 0 100 2h1zm-7 4a1 1 0 011 1v1a1 1 0 11-2 0v-1a1 1 0 011-1zM5.05 6.464A1 1 0 106.465 5.05l-.708-.707a1 1 0 00-1.414 1.414l.707.707zm1.414 8.486l-.707.707a1 1 0 01-1.414-1.414l.707-.707a1 1 0 011.414 1.414zM4 11a1 1 0 100-2H3a1 1 0 000 2h1z" fill-rule="evenodd" clip-rule="evenodd"></path></svg>
diff --git a/packages/framework/resources/views/layouts/head.blade.php b/packages/framework/resources/views/layouts/head.blade.php
index 20f002ebc62..5c1dc456b08 100644
--- a/packages/framework/resources/views/layouts/head.blade.php
+++ b/packages/framework/resources/views/layouts/head.blade.php
@@ -12,7 +12,7 @@
 {{-- App Stylesheets --}}
 @include('hyde::layouts.styles')
 
-@if(Hyde::hasFeature('darkmode'))
+@if(Hyde::hasFeature(\Hyde\Enums\Feature::Darkmode))
     {{-- Check the local storage for theme preference to avoid FOUC --}}
     <meta id="meta-color-scheme" name="color-scheme" content="{{ config('hyde.default_color_scheme', 'light') }}">
     <script>if (localStorage.getItem('color-theme') === 'dark' || (!('color-theme' in localStorage) && window.matchMedia('(prefers-color-scheme: dark)').matches)) { document.documentElement.classList.add('dark'); document.getElementById('meta-color-scheme').setAttribute('content', 'dark');} else { document.documentElement.classList.remove('dark') } </script>
diff --git a/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php b/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
index bc4e8de71fb..64dbaedd683 100644
--- a/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarBrandViewTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature\Views;
 
 use Hyde\Hyde;
+use Hyde\Enums\Feature;
 use Hyde\Testing\TestCase;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Testing\TestsBladeViews;
@@ -61,7 +62,7 @@ public function testSidebarBrandViewWithDefaultHeaderTextAndHomeRoute()
     public function testSidebarBrandViewWithoutDarkmodeFeature()
     {
         $mock = $this->mock(HydeKernel::class)->makePartial();
-        $mock->shouldReceive('hasFeature')->with('darkmode')->andReturn(false);
+        $mock->shouldReceive('hasFeature')->with(Feature::Darkmode)->andReturn(false);
         HydeKernel::setInstance($mock);
 
         $view = $this->view(view('hyde::components.docs.sidebar-brand'));
diff --git a/packages/framework/tests/Unit/HydeHelperFacadeTest.php b/packages/framework/tests/Unit/HydeHelperFacadeTest.php
index d4780b1f412..d6a3aef3a23 100644
--- a/packages/framework/tests/Unit/HydeHelperFacadeTest.php
+++ b/packages/framework/tests/Unit/HydeHelperFacadeTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Enums\Feature;
 use Hyde\Facades\Features;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
@@ -31,7 +32,7 @@ public function testFeaturesFacadeCanBeUsedToCallStaticMethodsOnFeaturesClass()
     public function testHydeHasFeatureShorthandCallsStaticMethodOnFeaturesClass()
     {
         $this->assertTrue(
-            Hyde::hasFeature('markdown-posts')
+            Hyde::hasFeature(Feature::MarkdownPosts)
         );
     }
 }

From 56110d2ee69f258ae904507ec48814d48bf98a24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Apr 2024 13:46:50 +0200
Subject: [PATCH 1662/4023] Remove support for checking feature state using
 string

---
 packages/framework/src/Foundation/HydeKernel.php    | 4 ++--
 packages/framework/src/Hyde.php                     | 2 +-
 packages/framework/tests/Feature/HydeKernelTest.php | 1 -
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index ffe1290d1fc..0283a4fbc37 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -92,9 +92,9 @@ public function features(): Features
         return $this->features ??= new Features();
     }
 
-    public function hasFeature(Feature|string $feature): bool
+    public function hasFeature(Feature $feature): bool
     {
-        return Features::has($feature instanceof Feature ? $feature : Feature::from($feature));
+        return Features::has($feature);
     }
 
     /** @inheritDoc */
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index c41b4d1415d..a526cb0dd9d 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -59,7 +59,7 @@
  * @method static HydeKernel getInstance()
  * @method static Filesystem filesystem()
  * @method static array getRegisteredExtensions()
- * @method static bool hasFeature(Feature|string $feature)
+ * @method static bool hasFeature(Feature $feature)
  * @method static bool hasSiteUrl()
  * @method static void setInstance(HydeKernel $instance)
  * @method static void setBasePath(string $basePath)
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index e156efa5eff..ddfc83edb60 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -78,7 +78,6 @@ public function testFeaturesHelperReturnsNewFeaturesInstance()
     public function testHasFeatureHelperCallsMethodOnFeaturesClass()
     {
         $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature(Feature::BladePages));
-        $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature('blade-pages'));
     }
 
     public function testCurrentPageHelperReturnsCurrentPageName()

From 6b1c11d892674c12b43598207203b8065c338879 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 12:49:10 +0200
Subject: [PATCH 1663/4023] Properly merge in feature class changes from master

---
 packages/framework/src/Facades/Features.php | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 078d40d2375..3ce7c204e80 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -5,6 +5,7 @@
 namespace Hyde\Facades;
 
 use Hyde\Hyde;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Enums\Feature;
@@ -12,6 +13,7 @@
 use Hyde\Support\Contracts\SerializableContract;
 use Illuminate\Support\Arr;
 
+use function collect;
 use function is_array;
 use function array_filter;
 use function extension_loaded;
@@ -53,7 +55,7 @@ public static function has(Feature $feature): bool
      */
     public static function enabled(): array
     {
-        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => $feature->value);
+        return Arr::map(Hyde::features()->features, fn (Feature $feature): string => Str::kebab($feature->name));
     }
 
     public static function hasHtmlPages(): bool
@@ -139,7 +141,7 @@ public static function hasTorchlight(): bool
     public function toArray(): array
     {
         return Arr::mapWithKeys(Feature::cases(), fn (Feature $feature): array => [
-            $feature->value => static::has($feature),
+            Str::kebab($feature->name) => static::has($feature),
         ]);
     }
 
@@ -152,9 +154,9 @@ public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
             if ($enabled !== true) {
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => $search !== Feature::from($feature));
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
             } else {
-                Hyde::features()->features[] = Feature::from($feature);
+                Hyde::features()->features[] = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => Str::kebab($search->name) === $feature);
             }
         }
     }

From 6ed0e87632b0835d9111e0ee8895858bd3ec4278 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 14:27:10 +0200
Subject: [PATCH 1664/4023] Update kernel feature helper to only support enum
 cases

This was deprecated in HydePHP v1.6
---
 RELEASE_NOTES.md                                    | 1 +
 packages/framework/src/Foundation/HydeKernel.php    | 4 ++--
 packages/framework/tests/Feature/HydeKernelTest.php | 1 -
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 369a951b155..89b99818e25 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -19,6 +19,7 @@ This serves two purposes:
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
+- The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 
diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index ffe1290d1fc..0283a4fbc37 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -92,9 +92,9 @@ public function features(): Features
         return $this->features ??= new Features();
     }
 
-    public function hasFeature(Feature|string $feature): bool
+    public function hasFeature(Feature $feature): bool
     {
-        return Features::has($feature instanceof Feature ? $feature : Feature::from($feature));
+        return Features::has($feature);
     }
 
     /** @inheritDoc */
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index e156efa5eff..ddfc83edb60 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -78,7 +78,6 @@ public function testFeaturesHelperReturnsNewFeaturesInstance()
     public function testHasFeatureHelperCallsMethodOnFeaturesClass()
     {
         $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature(Feature::BladePages));
-        $this->assertSame(Features::has(Feature::BladePages), Hyde::hasFeature('blade-pages'));
     }
 
     public function testCurrentPageHelperReturnsCurrentPageName()

From f83c1df6eacfead7dc1832c9d23802aed9343059 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 12:30:38 +0200
Subject: [PATCH 1665/4023] Change default build task message

---
 .../src/Framework/Features/BuildTasks/BuildTask.php         | 2 +-
 packages/framework/tests/Unit/BuildTaskUnitTest.php         | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php b/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
index 76a50aa382e..7d533436df8 100644
--- a/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
+++ b/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
@@ -20,7 +20,7 @@ abstract class BuildTask
     use TracksExecutionTime;
 
     /** @var string The message that will be displayed when the task is run. */
-    protected static string $message = 'Running generic build task';
+    protected static string $message = 'Running build task';
 
     protected int $exitCode = Command::SUCCESS;
 
diff --git a/packages/framework/tests/Unit/BuildTaskUnitTest.php b/packages/framework/tests/Unit/BuildTaskUnitTest.php
index 1a0d540cb2b..0b2450314aa 100644
--- a/packages/framework/tests/Unit/BuildTaskUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskUnitTest.php
@@ -60,7 +60,7 @@ public function testItPrintsStartMessage()
     {
         $task = tap(new BufferedTestBuildTask(), fn ($task) => $task->run());
 
-        $this->assertStringContainsString('Running generic build task', $task->buffer[0]);
+        $this->assertStringContainsString('Running build task', $task->buffer[0]);
     }
 
     public function testItPrintsFinishMessage()
@@ -95,7 +95,7 @@ public function testRunMethodReturnsExitCode()
 
     public function testCanGetMessage()
     {
-        $this->assertSame('Running generic build task', (new BufferedTestBuildTask())->getMessage());
+        $this->assertSame('Running build task', (new BufferedTestBuildTask())->getMessage());
     }
 
     public function testCanGetCustomMessage()
@@ -109,7 +109,7 @@ public function testCanPrintStartMessage()
     {
         $task = tap(new BufferedTestBuildTask(), fn ($task) => $task->printStartMessage());
 
-        $this->assertSame('<comment>Running generic build task...</comment>', trim($task->buffer[0]));
+        $this->assertSame('<comment>Running build task...</comment>', trim($task->buffer[0]));
     }
 
     public function testCanPrintCustomStartMessage()

From 13f3455653dd168053bd26d7333bd87c076b75c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 12:31:18 +0200
Subject: [PATCH 1666/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 89b99818e25..5b0b17ed1c2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -19,6 +19,7 @@ This serves two purposes:
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
+- Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.

From f79a1caa79ba73193ce8b96cab3f0885ebe590c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 20:15:54 +0200
Subject: [PATCH 1667/4023] Invert 'if' statement

---
 packages/framework/src/Facades/Features.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 3ce7c204e80..59f8261d783 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -153,10 +153,10 @@ public function toArray(): array
     public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            if ($enabled !== true) {
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
-            } else {
+            if ($enabled === true) {
                 Hyde::features()->features[] = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => Str::kebab($search->name) === $feature);
+            } else {
+                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
             }
         }
     }

From 71427d8136c7f6ffdd24c3af04f05781a819cc1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 20:16:05 +0200
Subject: [PATCH 1668/4023] Comment code

---
 packages/framework/src/Facades/Features.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index 59f8261d783..f67f3a69a80 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -154,8 +154,10 @@ public static function mock(string|array $feature, bool $enabled = null): void
     {
         foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
             if ($enabled === true) {
+                // Add the feature if it doesn't already exist.
                 Hyde::features()->features[] = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => Str::kebab($search->name) === $feature);
             } else {
+                // Remove the feature if it exists.
                 Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
             }
         }

From 998ef3d41badefac7d98c76df6fcc05f3d701d0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Apr 2024 20:25:51 +0200
Subject: [PATCH 1669/4023] Simplify internal mocking helper

Lost this when merging https://github.com/hydephp/develop/pull/1651
---
 packages/framework/src/Facades/Features.php   | 23 +++++++------------
 .../Feature/ConfigurableFeaturesTest.php      | 12 ++++------
 2 files changed, 12 insertions(+), 23 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index f67f3a69a80..d1a07cd6c28 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -14,7 +14,6 @@
 use Illuminate\Support\Arr;
 
 use function collect;
-use function is_array;
 use function array_filter;
 use function extension_loaded;
 use function in_array;
@@ -145,21 +144,15 @@ public function toArray(): array
         ]);
     }
 
-    /**
-     * @internal This method is not covered by the backward compatibility promise.
-     *
-     * @param  string|array<string, bool>  $feature
-     */
-    public static function mock(string|array $feature, bool $enabled = null): void
+    /** @internal This method is not covered by the backward compatibility promise. */
+    public static function mock(string $feature, bool $enabled = null): void
     {
-        foreach (is_array($feature) ? $feature : [$feature => $enabled] as $feature => $enabled) {
-            if ($enabled === true) {
-                // Add the feature if it doesn't already exist.
-                Hyde::features()->features[] = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => Str::kebab($search->name) === $feature);
-            } else {
-                // Remove the feature if it exists.
-                Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
-            }
+        if ($enabled === true) {
+            // Add the feature if it doesn't already exist.
+            Hyde::features()->features[] = collect(Feature::cases())->firstOrFail(fn (Feature $search): bool => Str::kebab($search->name) === $feature);
+        } else {
+            // Remove the feature if it exists.
+            Hyde::features()->features = array_filter(Hyde::features()->features, fn (Feature $search): bool => Str::kebab($search->name) !== $feature);
         }
     }
 }
diff --git a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
index d3eeaad9297..7d076d1498f 100644
--- a/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
+++ b/packages/framework/tests/Feature/ConfigurableFeaturesTest.php
@@ -133,18 +133,14 @@ public function testFeaturesCanBeMocked()
 
     public function testMultipleFeaturesCanBeMocked()
     {
-        Features::mock([
-            'blade-pages' => true,
-            'darkmode' => true,
-        ]);
+        Features::mock('blade-pages', true);
+        Features::mock('darkmode', true);
 
         $this->assertTrue(Features::hasBladePages());
         $this->assertTrue(Features::hasDarkmode());
 
-        Features::mock([
-            'blade-pages' => false,
-            'darkmode' => false,
-        ]);
+        Features::mock('blade-pages', false);
+        Features::mock('darkmode', false);
 
         $this->assertFalse(Features::hasBladePages());
         $this->assertFalse(Features::hasDarkmode());

From 6ed117bc0ba73f24a7871921bc05a04e5b138ec9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 16:57:51 +0200
Subject: [PATCH 1670/4023] Run workflow on all branches

---
 .github/workflows/static-analysis.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/static-analysis.yml b/.github/workflows/static-analysis.yml
index f0b34dc94d9..ea95ebd45a8 100644
--- a/.github/workflows/static-analysis.yml
+++ b/.github/workflows/static-analysis.yml
@@ -2,7 +2,6 @@ name: 🔎 Static Analysis
 
 on:
   pull_request:
-    branches: [ "master" ]
 
 jobs:
 

From c660d36fa0123c108a740d6661068877c461ce14 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 16:58:03 +0200
Subject: [PATCH 1671/4023] Add type annotation for wrapped array

---
 .../src/Framework/Features/Navigation/NavigationMenu.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 7329b6bfbe9..2dc4c0e61c5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -56,6 +56,7 @@ public function getItems(): Collection
      */
     public function add(NavigationItem|NavigationGroup|array $items): static
     {
+        /** @var \Hyde\Framework\Features\Navigation\NavigationItem $item */
         foreach (Arr::wrap($items) as $item) {
             $this->addItem($item);
         }

From 9703afb7ac7e6afa47443f2691eead3204a8967b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 17:30:24 +0200
Subject: [PATCH 1672/4023] Type annotate container access

---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 ++++-
 .../src/Framework/Features/Navigation/MainNavigationMenu.php | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 6e8332b8ad2..e8b0aa78c2e 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -19,7 +19,10 @@ class DocumentationSidebar extends NavigationMenu
      */
     public static function get(): static
     {
-        return app('navigation.sidebar');
+        /** @var self::class $menu */
+        $menu = app('navigation.sidebar');
+
+        return $menu;
     }
 
     public function __construct(Arrayable|array $items = [])
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index e6681c42ffd..f735186d29f 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -10,6 +10,9 @@ class MainNavigationMenu extends NavigationMenu
 {
     public static function get(): static
     {
-        return app('navigation.main');
+        /** @var self::class $menu */
+        $menu = app('navigation.main');
+
+        return $menu;
     }
 }

From 2efd122f53beb115e1b8c3480401dcc4369e1d9d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 17:52:12 +0200
Subject: [PATCH 1673/4023] Create .phpstorm.meta.php

---
 .phpstorm.meta.php | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 .phpstorm.meta.php

diff --git a/.phpstorm.meta.php b/.phpstorm.meta.php
new file mode 100644
index 00000000000..f7f7bf84097
--- /dev/null
+++ b/.phpstorm.meta.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace PHPSTORM_META {
+    override(\app(0), map([
+        'navigation.main' => \Hyde\Framework\Features\Navigation\MainNavigationMenu::class,
+        'navigation.sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::class,
+    ]));
+}

From 617142a189dfdfb8a4ec09279f9ab8c6cdf2bede Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:03:55 +0200
Subject: [PATCH 1674/4023] Create sdf.meta.php

---
 .phpstorm.meta.php => .phpstorm.meta.php/sdf.meta.php | 4 ++++
 1 file changed, 4 insertions(+)
 rename .phpstorm.meta.php => .phpstorm.meta.php/sdf.meta.php (73%)

diff --git a/.phpstorm.meta.php b/.phpstorm.meta.php/sdf.meta.php
similarity index 73%
rename from .phpstorm.meta.php
rename to .phpstorm.meta.php/sdf.meta.php
index f7f7bf84097..8ac94568820 100644
--- a/.phpstorm.meta.php
+++ b/.phpstorm.meta.php/sdf.meta.php
@@ -1,8 +1,12 @@
 <?php
 
 namespace PHPSTORM_META {
+
     override(\app(0), map([
+        '' => '@',
         'navigation.main' => \Hyde\Framework\Features\Navigation\MainNavigationMenu::class,
         'navigation.sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::class,
     ]));
+
+    expectedArguments(\app(), 0, 'navigation.main', 'navigation.sidebar');
 }

From 98529993bf72ee975d4d15791a0656cce18d8dc9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:03:58 +0200
Subject: [PATCH 1675/4023] Revert "Create sdf.meta.php"

This reverts commit 617142a189dfdfb8a4ec09279f9ab8c6cdf2bede.
---
 .phpstorm.meta.php/sdf.meta.php => .phpstorm.meta.php | 4 ----
 1 file changed, 4 deletions(-)
 rename .phpstorm.meta.php/sdf.meta.php => .phpstorm.meta.php (73%)

diff --git a/.phpstorm.meta.php/sdf.meta.php b/.phpstorm.meta.php
similarity index 73%
rename from .phpstorm.meta.php/sdf.meta.php
rename to .phpstorm.meta.php
index 8ac94568820..f7f7bf84097 100644
--- a/.phpstorm.meta.php/sdf.meta.php
+++ b/.phpstorm.meta.php
@@ -1,12 +1,8 @@
 <?php
 
 namespace PHPSTORM_META {
-
     override(\app(0), map([
-        '' => '@',
         'navigation.main' => \Hyde\Framework\Features\Navigation\MainNavigationMenu::class,
         'navigation.sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::class,
     ]));
-
-    expectedArguments(\app(), 0, 'navigation.main', 'navigation.sidebar');
 }

From 6a80301690feab53d4e4fb3501807871d0ee05b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:15:33 +0200
Subject: [PATCH 1676/4023] Revert "Type annotate container access"

This reverts commit 9703afb7ac7e6afa47443f2691eead3204a8967b.
---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 +----
 .../src/Framework/Features/Navigation/MainNavigationMenu.php | 5 +----
 2 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index e8b0aa78c2e..6e8332b8ad2 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -19,10 +19,7 @@ class DocumentationSidebar extends NavigationMenu
      */
     public static function get(): static
     {
-        /** @var self::class $menu */
-        $menu = app('navigation.sidebar');
-
-        return $menu;
+        return app('navigation.sidebar');
     }
 
     public function __construct(Arrayable|array $items = [])
diff --git a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
index f735186d29f..e6681c42ffd 100644
--- a/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/MainNavigationMenu.php
@@ -10,9 +10,6 @@ class MainNavigationMenu extends NavigationMenu
 {
     public static function get(): static
     {
-        /** @var self::class $menu */
-        $menu = app('navigation.main');
-
-        return $menu;
+        return app('navigation.main');
     }
 }

From 4188a96fb983860757f0e3952eec6018595ac87f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:23:55 +0200
Subject: [PATCH 1677/4023] Add generics to the evaluate arrayable helper

---
 packages/framework/src/helpers.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index eccc720e66f..26ffc238bb2 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -144,6 +144,13 @@ function trim_slashes(string $string): string
     }
 
     if (! function_exists('\Hyde\evaluate_arrayable')) {
+        /**
+         * Evaluate an arrayable object or an array to an array.
+         *
+         * @template T
+         * @param array<T>|Arrayable<T> $array
+         * @return array<T>
+         */
         function evaluate_arrayable(array|Arrayable $array): array
         {
             return $array instanceof Arrayable ? $array->toArray() : $array;

From 7cc489b519d1034d57790abf61671580358f9156 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:24:51 +0200
Subject: [PATCH 1678/4023] Revert "Add generics to the evaluate arrayable
 helper"

This reverts commit 4188a96fb983860757f0e3952eec6018595ac87f.
---
 packages/framework/src/helpers.php | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 26ffc238bb2..eccc720e66f 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -144,13 +144,6 @@ function trim_slashes(string $string): string
     }
 
     if (! function_exists('\Hyde\evaluate_arrayable')) {
-        /**
-         * Evaluate an arrayable object or an array to an array.
-         *
-         * @template T
-         * @param array<T>|Arrayable<T> $array
-         * @return array<T>
-         */
         function evaluate_arrayable(array|Arrayable $array): array
         {
             return $array instanceof Arrayable ? $array->toArray() : $array;

From b05b5e2a2d92a5b2cd91b7eac6d17d59ccbd2628 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:32:39 +0200
Subject: [PATCH 1679/4023] Add type generics

---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 2dc4c0e61c5..cc74ca46f0c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -23,7 +23,11 @@ class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
+    /**
+     * @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
+     * @template T of NavigationItem|NavigationGroup
+     * @template TValue of T
+     */
     protected Collection $items;
 
     public function __construct(Arrayable|array $items = [])

From c7a7d06b41a36757b8aa59827b8a870826fd0eaa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:34:08 +0200
Subject: [PATCH 1680/4023] Revert "Add type generics"

This reverts commit b05b5e2a2d92a5b2cd91b7eac6d17d59ccbd2628.
---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index cc74ca46f0c..2dc4c0e61c5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -23,11 +23,7 @@ class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /**
-     * @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
-     * @template T of NavigationItem|NavigationGroup
-     * @template TValue of T
-     */
+    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
     public function __construct(Arrayable|array $items = [])

From 439050dc4b88dc5f91c011ef817c960ffed45a7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:35:33 +0200
Subject: [PATCH 1681/4023] Introduce type annotated variable

---
 .../Framework/Features/Navigation/DocumentationSidebar.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 6e8332b8ad2..fb13b0b91bc 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -76,9 +76,12 @@ public function getActiveGroup(): ?NavigationGroup
             return $this->items->sortBy(fn (NavigationGroup $item): int => $item->getPriority())->first();
         }
 
-        return $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
+        /** @var ?NavigationGroup $first */
+        $first = $this->items->first(function (NavigationGroup $group) use ($currentPage): bool {
             // A group is active when it contains the current page being rendered.
             return $currentPage->navigationMenuGroup() && $group->getGroupKey() === NavigationGroup::normalizeGroupKey($currentPage->navigationMenuGroup());
         });
+
+        return $first;
     }
 }

From e1af2cd3fc4dc9293697e468ef0092616eeebd1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:38:46 +0200
Subject: [PATCH 1682/4023] Annotate arrayable generics

---
 .../src/Framework/Features/Navigation/NavigationMenu.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 2dc4c0e61c5..780c07f2ad8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -26,6 +26,7 @@ class NavigationMenu
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
+    /** @param  \Illuminate\Contracts\Support\Arrayable<array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();

From 662915544a8c820869803d1f87aea968b254cd22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:41:23 +0200
Subject: [PATCH 1683/4023] Annotate the constant types

---
 .../src/Framework/Features/Navigation/NavigationMenu.php       | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 780c07f2ad8..560222c320e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,7 +20,10 @@
  */
 class NavigationMenu
 {
+    /** @var int The default priority for navigation items. */
     public const DEFAULT = 500;
+
+    /** @var int Place the item last in the menu. */
     public const LAST = 999;
 
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */

From e3f891aee2b1895fba7c4d75d569e47261c1c845 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:46:07 +0200
Subject: [PATCH 1684/4023] Annotate the evaluated array generics

---
 .../src/Framework/Features/Navigation/NavigationMenu.php     | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 560222c320e..6d59056f277 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -34,7 +34,10 @@ public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
-        $this->add(evaluate_arrayable($items));
+        /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> $items */
+        $items = evaluate_arrayable($items);
+
+        $this->add($items);
     }
 
     /**

From 92d3693ee6d6387bbb1353c8fe69841485c7bc84 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:46:20 +0200
Subject: [PATCH 1685/4023] Revert "Annotate the constant types"

This reverts commit 662915544a8c820869803d1f87aea968b254cd22.
---
 .../src/Framework/Features/Navigation/NavigationMenu.php       | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 6d59056f277..860abd9fc85 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -20,10 +20,7 @@
  */
 class NavigationMenu
 {
-    /** @var int The default priority for navigation items. */
     public const DEFAULT = 500;
-
-    /** @var int Place the item last in the menu. */
     public const LAST = 999;
 
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */

From a512e24219f728ba698bee3d2cdc4a2e7050fe9c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:50:07 +0200
Subject: [PATCH 1686/4023] Fix invalid template parameters

---
 .../src/Framework/Features/Navigation/NavigationMenu.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 860abd9fc85..7acd44d47be 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -26,7 +26,7 @@ class NavigationMenu
     /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
-    /** @param  \Illuminate\Contracts\Support\Arrayable<array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
+    /** @param  \Illuminate\Contracts\Support\Arrayable<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();

From 619c62e6523e979daa5d9af2bde7e35fd5a91af5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:52:38 +0200
Subject: [PATCH 1687/4023] Annotate array key templates

---
 .../src/Framework/Features/Navigation/NavigationMenu.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index 7acd44d47be..facd0c91998 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -23,10 +23,10 @@ class NavigationMenu
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
+    /** @var \Illuminate\Support\Collection<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
-    /** @param  \Illuminate\Contracts\Support\Arrayable<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
+    /** @param  \Illuminate\Contracts\Support\Arrayable<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
@@ -42,7 +42,7 @@ public function __construct(Arrayable|array $items = [])
      *
      * Items are automatically sorted by their priority, falling back to the order they were added.
      *
-     * @return \Illuminate\Support\Collection<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
+     * @return \Illuminate\Support\Collection<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
      */
     public function getItems(): Collection
     {

From 0aa6814a5e02cd851fb820ec9982229b50d9ee00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 18:58:11 +0200
Subject: [PATCH 1688/4023] Use type safe config accessor

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index fb13b0b91bc..89bc9a033c2 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -29,7 +29,7 @@ public function __construct(Arrayable|array $items = [])
 
     public function getHeader(): string
     {
-        return Config::get('docs.sidebar.header', 'Documentation');
+        return Config::getString('docs.sidebar.header', 'Documentation');
     }
 
     public function getFooter(): ?string

From 79436b52d370e747385da655b4bc5df9f4966b68 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:12:48 +0200
Subject: [PATCH 1689/4023] Extract generics template to clean up the class

---
 .../Features/Navigation/NavigationMenu.php         | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
index facd0c91998..35c48ea651e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenu.php
@@ -17,21 +17,23 @@
  *
  * @example `$menu = app('navigation.main');` for the main navigation menu.
  * @example `$menu = app('navigation.sidebar');` for the documentation sidebar.
+ *
+ * @template T of NavigationItem|NavigationGroup
  */
 class NavigationMenu
 {
     public const DEFAULT = 500;
     public const LAST = 999;
 
-    /** @var \Illuminate\Support\Collection<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
+    /** @var \Illuminate\Support\Collection<array-key, T> */
     protected Collection $items;
 
-    /** @param  \Illuminate\Contracts\Support\Arrayable<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items */
+    /** @param  \Illuminate\Contracts\Support\Arrayable<array-key, T>|array<T>  $items */
     public function __construct(Arrayable|array $items = [])
     {
         $this->items = new Collection();
 
-        /** @var array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> $items */
+        /** @var array<T> $items */
         $items = evaluate_arrayable($items);
 
         $this->add($items);
@@ -42,7 +44,7 @@ public function __construct(Arrayable|array $items = [])
      *
      * Items are automatically sorted by their priority, falling back to the order they were added.
      *
-     * @return \Illuminate\Support\Collection<array-key, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>
+     * @return \Illuminate\Support\Collection<array-key, T>
      */
     public function getItems(): Collection
     {
@@ -56,11 +58,11 @@ public function getItems(): Collection
     /**
      * Add one or more navigation items to the navigation menu.
      *
-     * @param  \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup|array<\Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup>  $items
+     * @param  T|array<T>  $items
      */
     public function add(NavigationItem|NavigationGroup|array $items): static
     {
-        /** @var \Hyde\Framework\Features\Navigation\NavigationItem $item */
+        /** @var T $item */
         foreach (Arr::wrap($items) as $item) {
             $this->addItem($item);
         }

From 13b5e19222ef1276c1bf26c675a55c751f5d58b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:16:45 +0200
Subject: [PATCH 1690/4023] Annotate the supported config value types

---
 .../src/Framework/Features/Navigation/DocumentationSidebar.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
index 89bc9a033c2..a5f01904b27 100644
--- a/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
+++ b/packages/framework/src/Framework/Features/Navigation/DocumentationSidebar.php
@@ -34,6 +34,7 @@ public function getHeader(): string
 
     public function getFooter(): ?string
     {
+        /** @var null|string|false $option */
         $option = Config::get('docs.sidebar.footer', '[Back to home page](../)');
 
         if (is_string($option)) {

From 4607bbe2eea65dc57d0c23648a7c5f4c8e6460a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:31:14 +0200
Subject: [PATCH 1691/4023] Extract helper method for repeated code

---
 .../Features/Navigation/NavigationMenuGenerator.php        | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d1476b87ac3..6a9f9f509e0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -191,13 +191,18 @@ protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
 
-        return Config::getArray($key, [])[$groupKey] ?? null;
+        return $this->getConfigArray($key, $groupKey);
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
 
+        return $this->getConfigArray($key, $groupKey);
+    }
+
+    protected function getConfigArray(string $key, string $groupKey): mixed
+    {
         return Config::getArray($key, [])[$groupKey] ?? null;
     }
 }

From 32b91d37e6ee7cd6c4b058f7e5432761dded61be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:33:18 +0200
Subject: [PATCH 1692/4023] Shift array access to scope down helper method

---
 .../Features/Navigation/NavigationMenuGenerator.php       | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 6a9f9f509e0..b51609c4924 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -191,18 +191,18 @@ protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
 
-        return $this->getConfigArray($key, $groupKey);
+        return $this->getConfigArray($key)[$groupKey] ?? null;
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
 
-        return $this->getConfigArray($key, $groupKey);
+        return $this->getConfigArray($key)[$groupKey] ?? null;
     }
 
-    protected function getConfigArray(string $key, string $groupKey): mixed
+    protected function getConfigArray(string $key): array
     {
-        return Config::getArray($key, [])[$groupKey] ?? null;
+        return Config::getArray($key, []);
     }
 }

From fc274745785548026c5f9384652644e83f41a0f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:39:32 +0200
Subject: [PATCH 1693/4023] Annotate the config array types

---
 .../Features/Navigation/NavigationMenuGenerator.php          | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b51609c4924..b2486fa0502 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -203,6 +203,9 @@ protected function searchForGroupPriorityInConfig(string $groupKey): ?int
 
     protected function getConfigArray(string $key): array
     {
-        return Config::getArray($key, []);
+        /** @var array<string, string|int>|array<array-key, string> $array */
+        $array = Config::getArray($key, []);
+
+        return $array;
     }
 }

From db435d7c4d73e09c031add55b45121e89b14b13f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:43:01 +0200
Subject: [PATCH 1694/4023] Inline added helper method

---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b2486fa0502..be480fbfd17 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -191,21 +191,19 @@ protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
 
-        return $this->getConfigArray($key)[$groupKey] ?? null;
+        /** @var array<string, string|int>|array<array-key, string> $array */
+        $array = Config::getArray($key, []);
+
+        return ($array)[$groupKey] ?? null;
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
 
-        return $this->getConfigArray($key)[$groupKey] ?? null;
-    }
-
-    protected function getConfigArray(string $key): array
-    {
         /** @var array<string, string|int>|array<array-key, string> $array */
         $array = Config::getArray($key, []);
 
-        return $array;
+        return ($array)[$groupKey] ?? null;
     }
 }

From 803d1d6a62fc7fb3f627c0a1dea8c7319e227245 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:43:21 +0200
Subject: [PATCH 1695/4023] Revert "Inline added helper method"

This reverts commit db435d7c4d73e09c031add55b45121e89b14b13f.
---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index be480fbfd17..b2486fa0502 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -191,19 +191,21 @@ protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
         $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
 
-        /** @var array<string, string|int>|array<array-key, string> $array */
-        $array = Config::getArray($key, []);
-
-        return ($array)[$groupKey] ?? null;
+        return $this->getConfigArray($key)[$groupKey] ?? null;
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
         $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
 
+        return $this->getConfigArray($key)[$groupKey] ?? null;
+    }
+
+    protected function getConfigArray(string $key): array
+    {
         /** @var array<string, string|int>|array<array-key, string> $array */
         $array = Config::getArray($key, []);
 
-        return ($array)[$groupKey] ?? null;
+        return $array;
     }
 }

From 894536e35b2358f62757740b194c4eb55c969ea4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:43:52 +0200
Subject: [PATCH 1696/4023] Simplify array generics

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b2486fa0502..fab5ffa57c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -203,7 +203,7 @@ protected function searchForGroupPriorityInConfig(string $groupKey): ?int
 
     protected function getConfigArray(string $key): array
     {
-        /** @var array<string, string|int>|array<array-key, string> $array */
+        /** @var array<string|int, string|int> $array */
         $array = Config::getArray($key, []);
 
         return $array;

From 7ebca61349428e044764a6d64d620e7050ebada4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:44:53 +0200
Subject: [PATCH 1697/4023] Annotate array return generics

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index fab5ffa57c3..257afc54bbc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -201,6 +201,7 @@ protected function searchForGroupPriorityInConfig(string $groupKey): ?int
         return $this->getConfigArray($key)[$groupKey] ?? null;
     }
 
+    /** @return array<string|int, string|int> */
     protected function getConfigArray(string $key): array
     {
         /** @var array<string|int, string|int> $array */

From f26e4d6a47126569dfac804521beb3b0c24b61ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:57:14 +0200
Subject: [PATCH 1698/4023] Fix missing union type in type annotation

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 257afc54bbc..42760bb8ba1 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -23,7 +23,7 @@
  */
 class NavigationMenuGenerator
 {
-    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavigationItem> */
+    /** @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Navigation\NavigationItem|\Hyde\Framework\Features\Navigation\NavigationGroup> */
     protected Collection $items;
 
     /** @var \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route> */

From 12e8ab3e9c0d3f757c82af42a83127484e57a4d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 19:58:21 +0200
Subject: [PATCH 1699/4023] Inline local variables

---
 .../Features/Navigation/NavigationMenuGenerator.php       | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 42760bb8ba1..d2bd01921f8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -189,16 +189,12 @@ protected function normalizeGroupLabel(string $label): string
 
     protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
-        $key = $this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels';
-
-        return $this->getConfigArray($key)[$groupKey] ?? null;
+        return $this->getConfigArray($this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels')[$groupKey] ?? null;
     }
 
     protected function searchForGroupPriorityInConfig(string $groupKey): ?int
     {
-        $key = $this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order';
-
-        return $this->getConfigArray($key)[$groupKey] ?? null;
+        return $this->getConfigArray($this->generatesSidebar ? 'docs.sidebar.order' : 'hyde.navigation.order')[$groupKey] ?? null;
     }
 
     /** @return array<string|int, string|int> */

From bbb7238aba2a7276af2e30fb1a04439adabcab21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:10:12 +0200
Subject: [PATCH 1700/4023] Add integer cast for min function call

---
 .../src/Framework/Features/Navigation/NavigationGroup.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
index 9c472b9366a..229960da009 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationGroup.php
@@ -44,7 +44,7 @@ public function getPriority(): int
     {
         if ($this->containsOnlyDocumentationPages()) {
             // For sidebar groups, we use the priority of the lowest priority child, unless the dropdown instance itself has a lower priority.
-            return min($this->priority, $this->getItems()->min(fn (NavigationItem $item): int => $item->getPriority()));
+            return (int) min($this->priority, $this->getItems()->min(fn (NavigationItem $item): int => $item->getPriority()));
         }
 
         return $this->priority;

From 42b188fe7ee91e9640140a970b086317b2ba3af6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:16:00 +0200
Subject: [PATCH 1701/4023] Override kernel binding

---
 .phpstorm.meta.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.phpstorm.meta.php b/.phpstorm.meta.php
index f7f7bf84097..32e63379657 100644
--- a/.phpstorm.meta.php
+++ b/.phpstorm.meta.php
@@ -5,4 +5,7 @@
         'navigation.main' => \Hyde\Framework\Features\Navigation\MainNavigationMenu::class,
         'navigation.sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::class,
     ]));
+    override((new \Illuminate\Contracts\Container\Container())->make(0), map([
+        \Hyde\Foundation\HydeKernel::class => \Hyde\Foundation\HydeKernel::class,
+    ]));
 }

From e12b7dabd71af9626e165cfe4c7d1980f5aa4e1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:28:51 +0200
Subject: [PATCH 1702/4023] Revert "Override kernel binding"

This reverts commit 42b188fe7ee91e9640140a970b086317b2ba3af6.
---
 .phpstorm.meta.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.phpstorm.meta.php b/.phpstorm.meta.php
index 32e63379657..f7f7bf84097 100644
--- a/.phpstorm.meta.php
+++ b/.phpstorm.meta.php
@@ -5,7 +5,4 @@
         'navigation.main' => \Hyde\Framework\Features\Navigation\MainNavigationMenu::class,
         'navigation.sidebar' => \Hyde\Framework\Features\Navigation\DocumentationSidebar::class,
     ]));
-    override((new \Illuminate\Contracts\Container\Container())->make(0), map([
-        \Hyde\Foundation\HydeKernel::class => \Hyde\Foundation\HydeKernel::class,
-    ]));
 }

From 9e68809183f6ed064413c56226cbe6ef5f29792b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:31:19 +0200
Subject: [PATCH 1703/4023] Add code spacing

---
 .../tests/Feature/Services/DocumentationSidebarTest.php         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
index 23954a7c14e..6ce5db7a0b2 100644
--- a/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
+++ b/packages/framework/tests/Feature/Services/DocumentationSidebarTest.php
@@ -140,8 +140,10 @@ public function testSidebarPrioritiesCanBeSetInBothFrontMatterAndConfig()
             'third',
             'second',
         ]);
+
         Filesystem::touch('_docs/first.md');
         Filesystem::touch('_docs/second.md');
+
         file_put_contents(Hyde::path('_docs/third.md'),
             (new ConvertsArrayToFrontMatter)->execute(['navigation.priority' => 250 + 300])
         );

From b04cf8be4147232d8c34ba03de3abcf6dfbe61a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:33:09 +0200
Subject: [PATCH 1704/4023] Revert "Run workflow on all branches"

This reverts commit 6ed117bc0ba73f24a7871921bc05a04e5b138ec9.
---
 .github/workflows/static-analysis.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/static-analysis.yml b/.github/workflows/static-analysis.yml
index b2acd0dd0c5..dba99d85384 100644
--- a/.github/workflows/static-analysis.yml
+++ b/.github/workflows/static-analysis.yml
@@ -2,6 +2,7 @@ name: 🔎 Static Analysis
 
 on:
   pull_request:
+    branches: [ "master" ]
 
 jobs:
 

From 78a9434cdcb40fba25b051bf45b6e0641ab1d155 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:50:14 +0200
Subject: [PATCH 1705/4023] Revert "Update PhpStorm files"

This reverts commit 2c70b02fe4576b288c832b62c7445bf0a5d42032.
---
 .idea/develop.iml | 1 +
 .idea/php.xml     | 1 +
 .idea/phpspec.xml | 3 ---
 3 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/.idea/develop.iml b/.idea/develop.iml
index 8e317382cd6..57b84ebaf07 100644
--- a/.idea/develop.iml
+++ b/.idea/develop.iml
@@ -34,6 +34,7 @@
       <excludeFolder url="file://$MODULE_DIR$/app/storage/framework" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/webmozart/path-util" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/openlss/lib-array2xml" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/vimeo/psalm" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/uri-template" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/process" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/brianium/paratest" />
diff --git a/.idea/php.xml b/.idea/php.xml
index cde778e065a..d4d63270f91 100644
--- a/.idea/php.xml
+++ b/.idea/php.xml
@@ -147,6 +147,7 @@
       <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
       <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-commonmark" />
       <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-laravel" />
+      <path value="$PROJECT_DIR$/vendor/vimeo/psalm" />
       <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
       <path value="$PROJECT_DIR$/vendor/voku/portable-ascii" />
       <path value="$PROJECT_DIR$/vendor/webmozart/assert" />
diff --git a/.idea/phpspec.xml b/.idea/phpspec.xml
index 41f23c4c83d..c7cfbc2c5e6 100644
--- a/.idea/phpspec.xml
+++ b/.idea/phpspec.xml
@@ -11,9 +11,6 @@
       <PhpSpecSuiteConfiguration>
         <option name="myPath" value="$PROJECT_DIR$" />
       </PhpSpecSuiteConfiguration>
-      <PhpSpecSuiteConfiguration>
-        <option name="myPath" value="$PROJECT_DIR$" />
-      </PhpSpecSuiteConfiguration>
     </suites>
   </component>
 </project>
\ No newline at end of file

From fa6c20ad438489f38c82dcac7d33d4456999cdc7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:54:19 +0200
Subject: [PATCH 1706/4023] Clean up test

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index a98931a6e41..7f6cb8b3ac7 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -199,6 +199,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
+
         $expected = collect([NavigationItem::create(Routes::get('index'))]);
 
         $this->assertCount(count($expected), $menu->getItems());
@@ -212,6 +213,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
+
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
             NavigationItem::create(Routes::get('foo/bar')),
@@ -228,6 +230,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
         $this->file('_pages/foo/bar.md');
 
         $menu = $this->createNavigationMenu();
+
         $expected = collect([
             NavigationItem::create(Routes::get('index')),
             NavigationGroup::create('Foo', [
@@ -245,6 +248,7 @@ public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
+
         $menu = $this->createNavigationMenu();
 
         $this->assertCount(3, $menu->getItems());

From 76b69c0d8c72ac8843ea9a0ad819027bd5d0f478 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:54:47 +0200
Subject: [PATCH 1707/4023] Reapply "Update PhpStorm files"

This reverts commit 78a9434cdcb40fba25b051bf45b6e0641ab1d155.
---
 .idea/develop.iml | 1 -
 .idea/php.xml     | 1 -
 .idea/phpspec.xml | 3 +++
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.idea/develop.iml b/.idea/develop.iml
index 57b84ebaf07..8e317382cd6 100644
--- a/.idea/develop.iml
+++ b/.idea/develop.iml
@@ -34,7 +34,6 @@
       <excludeFolder url="file://$MODULE_DIR$/app/storage/framework" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/webmozart/path-util" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/openlss/lib-array2xml" />
-      <excludeFolder url="file://$MODULE_DIR$/vendor/vimeo/psalm" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/guzzlehttp/uri-template" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/illuminate/process" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/brianium/paratest" />
diff --git a/.idea/php.xml b/.idea/php.xml
index d4d63270f91..cde778e065a 100644
--- a/.idea/php.xml
+++ b/.idea/php.xml
@@ -147,7 +147,6 @@
       <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
       <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-commonmark" />
       <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-laravel" />
-      <path value="$PROJECT_DIR$/vendor/vimeo/psalm" />
       <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
       <path value="$PROJECT_DIR$/vendor/voku/portable-ascii" />
       <path value="$PROJECT_DIR$/vendor/webmozart/assert" />
diff --git a/.idea/phpspec.xml b/.idea/phpspec.xml
index c7cfbc2c5e6..41f23c4c83d 100644
--- a/.idea/phpspec.xml
+++ b/.idea/phpspec.xml
@@ -11,6 +11,9 @@
       <PhpSpecSuiteConfiguration>
         <option name="myPath" value="$PROJECT_DIR$" />
       </PhpSpecSuiteConfiguration>
+      <PhpSpecSuiteConfiguration>
+        <option name="myPath" value="$PROJECT_DIR$" />
+      </PhpSpecSuiteConfiguration>
     </suites>
   </component>
 </project>
\ No newline at end of file

From 35ddecefa385cb252c2810703c7f99243fa43598 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 15 Apr 2024 20:55:27 +0200
Subject: [PATCH 1708/4023] Remove unused testing helper method

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 5ae702cfad8..8d3ee0e380d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1327,11 +1327,6 @@ public function getState(int $index): ?TestNavigationItem
         return $this->state()[$index] ?? null;
     }
 
-    public function ddState(): void
-    {
-        dd($this->state());
-    }
-
     /**
      * @param  array  $expected  The expected state format
      * @param  bool  $strict  If false, missing array keys are ignored

From 4542ebfbf6cd77e0393aa9f0c9a2aeb2113d2472 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 17 Apr 2024 14:40:21 +0200
Subject: [PATCH 1709/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 5b0b17ed1c2..889880cae25 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -48,6 +48,10 @@ Please see the "Breaking changes & upgrade guide" section below for more informa
 
 Please read through this section to ensure your site upgrades smoothly.
 
+## Before you start
+
+Before you start, please upgrade your application to at least HydePHP v1.6 as that version contains helpers to make the upgrade process easier.
+
 ## High impact
 
 ### Navigation system rewrite

From 3ec072a566ba532dc53923159ecd010f513e98be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 13:53:25 +0200
Subject: [PATCH 1710/4023] Refactor `Filesystem::touch` to return void instead
 of bool

---
 packages/framework/src/Facades/Filesystem.php              | 6 +++---
 packages/framework/src/Foundation/Kernel/Filesystem.php    | 7 +++----
 .../framework/tests/Feature/Foundation/FilesystemTest.php  | 4 ++--
 3 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Facades/Filesystem.php b/packages/framework/src/Facades/Filesystem.php
index 3229bc584c3..8b6cc6fa4e9 100644
--- a/packages/framework/src/Facades/Filesystem.php
+++ b/packages/framework/src/Facades/Filesystem.php
@@ -73,11 +73,11 @@ public static function smartGlob(string $pattern, int $flags = 0): Collection
      * Touch one or more files in the project's directory.
      *
      * @param  string|array  $path
-     * @return bool
+     * @return void
      */
-    public static function touch(string|array $path): bool
+    public static function touch(string|array $path): void
     {
-        return self::kernel()->filesystem()->touch($path);
+        self::kernel()->filesystem()->touch($path);
     }
 
     /**
diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 97fa11bec30..2d42301d2da 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -151,17 +151,16 @@ public function vendorPath(string $path = '', string $package = 'framework'): st
      *
      * @param  string|array<string>  $path
      */
-    public function touch(string|array $path): bool
+    public function touch(string|array $path): void
     {
         if (is_string($path)) {
-            return touch($this->path($path));
+            touch($this->path($path));
+            return;
         }
 
         foreach ($path as $p) {
             touch($this->path($p));
         }
-
-        return true;
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 6c2c2811cd8..7696fe61b97 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -180,14 +180,14 @@ public function testVendorPathCanRunInPhar()
 
     public function testTouchHelperCreatesFileAtGivenPath()
     {
-        $this->assertTrue($this->filesystem->touch('foo'));
+        $this->assertNull($this->filesystem->touch('foo'));
         $this->assertFileExists(Hyde::path('foo'));
         $this->filesystem->unlink('foo');
     }
 
     public function testTouchHelperCreatesMultipleFilesAtGivenPaths()
     {
-        $this->assertTrue($this->filesystem->touch(['foo', 'bar']));
+        $this->assertNull($this->filesystem->touch(['foo', 'bar']));
         $this->assertFileExists(Hyde::path('foo'));
         $this->assertFileExists(Hyde::path('bar'));
         $this->filesystem->unlink('foo');

From 342824dfa0bde09db37869dc57c7e34a61284270 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:14:15 +0200
Subject: [PATCH 1711/4023] Revert "Refactor `Filesystem::touch` to return void
 instead of bool"

This reverts commit 3ec072a566ba532dc53923159ecd010f513e98be.
---
 packages/framework/src/Facades/Filesystem.php              | 6 +++---
 packages/framework/src/Foundation/Kernel/Filesystem.php    | 7 ++++---
 .../framework/tests/Feature/Foundation/FilesystemTest.php  | 4 ++--
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Facades/Filesystem.php b/packages/framework/src/Facades/Filesystem.php
index 8b6cc6fa4e9..3229bc584c3 100644
--- a/packages/framework/src/Facades/Filesystem.php
+++ b/packages/framework/src/Facades/Filesystem.php
@@ -73,11 +73,11 @@ public static function smartGlob(string $pattern, int $flags = 0): Collection
      * Touch one or more files in the project's directory.
      *
      * @param  string|array  $path
-     * @return void
+     * @return bool
      */
-    public static function touch(string|array $path): void
+    public static function touch(string|array $path): bool
     {
-        self::kernel()->filesystem()->touch($path);
+        return self::kernel()->filesystem()->touch($path);
     }
 
     /**
diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 2d42301d2da..97fa11bec30 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -151,16 +151,17 @@ public function vendorPath(string $path = '', string $package = 'framework'): st
      *
      * @param  string|array<string>  $path
      */
-    public function touch(string|array $path): void
+    public function touch(string|array $path): bool
     {
         if (is_string($path)) {
-            touch($this->path($path));
-            return;
+            return touch($this->path($path));
         }
 
         foreach ($path as $p) {
             touch($this->path($p));
         }
+
+        return true;
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 7696fe61b97..6c2c2811cd8 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -180,14 +180,14 @@ public function testVendorPathCanRunInPhar()
 
     public function testTouchHelperCreatesFileAtGivenPath()
     {
-        $this->assertNull($this->filesystem->touch('foo'));
+        $this->assertTrue($this->filesystem->touch('foo'));
         $this->assertFileExists(Hyde::path('foo'));
         $this->filesystem->unlink('foo');
     }
 
     public function testTouchHelperCreatesMultipleFilesAtGivenPaths()
     {
-        $this->assertNull($this->filesystem->touch(['foo', 'bar']));
+        $this->assertTrue($this->filesystem->touch(['foo', 'bar']));
         $this->assertFileExists(Hyde::path('foo'));
         $this->assertFileExists(Hyde::path('bar'));
         $this->filesystem->unlink('foo');

From e9b275e89ee0e5d7bfeca06e5d070089db1d6fac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:14:34 +0200
Subject: [PATCH 1712/4023] Refactor touch and unlink helpers to use a
 collection loop

---
 .../src/Foundation/Kernel/Filesystem.php      | 22 +++++--------------
 1 file changed, 5 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 97fa11bec30..92de9b3f60e 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -9,12 +9,12 @@
 use Hyde\Foundation\PharSupport;
 use Illuminate\Support\Collection;
 
+use function collect;
 use function Hyde\normalize_slashes;
 use function Hyde\path_join;
 use function file_exists;
 use function str_replace;
 use function array_map;
-use function is_string;
 use function is_array;
 use function str_starts_with;
 use function unslash;
@@ -153,15 +153,9 @@ public function vendorPath(string $path = '', string $package = 'framework'): st
      */
     public function touch(string|array $path): bool
     {
-        if (is_string($path)) {
+        return collect($path)->map(function (string $path): bool {
             return touch($this->path($path));
-        }
-
-        foreach ($path as $p) {
-            touch($this->path($p));
-        }
-
-        return true;
+        })->contains(false) === false;
     }
 
     /**
@@ -171,15 +165,9 @@ public function touch(string|array $path): bool
      */
     public function unlink(string|array $path): bool
     {
-        if (is_string($path)) {
+        return collect($path)->map(function (string $path): bool {
             return unlink($this->path($path));
-        }
-
-        foreach ($path as $p) {
-            unlink($this->path($p));
-        }
-
-        return true;
+        })->contains(false) === false;
     }
 
     /**

From 9b16ffe1400f8341ace518d17a1732643972e22d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:16:51 +0200
Subject: [PATCH 1713/4023] Simplify unlinking helper to use short circuit
 logic

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 92de9b3f60e..00d3ab937cc 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -175,11 +175,7 @@ public function unlink(string|array $path): bool
      */
     public function unlinkIfExists(string $path): bool
     {
-        if (file_exists($this->path($path))) {
-            return unlink($this->path($path));
-        }
-
-        return false;
+        return file_exists($this->path($path)) && unlink($this->path($path));
     }
 
     /** @return \Illuminate\Support\Collection<int, string> */

From 2872b8ea7fc56437874418166ea6e6c2515793c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:19:28 +0200
Subject: [PATCH 1714/4023] Refactor string assembly to use the path join
 function

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 00d3ab937cc..b798b0f13e0 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -99,9 +99,7 @@ public function mediaPath(string $path = ''): string
             return $this->path(Hyde::getMediaDirectory());
         }
 
-        $path = unslash($path);
-
-        return $this->path(Hyde::getMediaDirectory()."/$path");
+        return $this->path(path_join(Hyde::getMediaDirectory(), unslash($path)));
     }
 
     /**
@@ -113,9 +111,7 @@ public function sitePath(string $path = ''): string
             return $this->path(Hyde::getOutputDirectory());
         }
 
-        $path = unslash($path);
-
-        return $this->path(Hyde::getOutputDirectory()."/$path");
+        return $this->path(path_join(Hyde::getOutputDirectory(), unslash($path)));
     }
 
     /**

From 242b3f0d3545a5538ff5f10580ac476794d0785e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:26:10 +0200
Subject: [PATCH 1715/4023] Annotate array return generics

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index b798b0f13e0..345a0f37199 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -70,6 +70,7 @@ public function path(string $path = ''): string
      * Input types are matched, meaning that if the input is a string so will the output be.
      *
      * @param  string|array<string>  $path
+     * @return string|array<string>
      */
     public function pathToAbsolute(string|array $path): string|array
     {

From d520dc0c22f7fb34d0c0b115656f343611a12d5d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Apr 2024 14:27:12 +0200
Subject: [PATCH 1716/4023] Use conditional array return generics

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 345a0f37199..9b3cc6cc24c 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -70,7 +70,7 @@ public function path(string $path = ''): string
      * Input types are matched, meaning that if the input is a string so will the output be.
      *
      * @param  string|array<string>  $path
-     * @return string|array<string>
+     * @return ($path is string ? string : array<string>)
      */
     public function pathToAbsolute(string|array $path): string|array
     {

From da080b8d68718e33b96228365805d94c8b79647e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 11:45:39 +0200
Subject: [PATCH 1717/4023] Fix test method order

---
 .../framework/tests/Feature/NavigationMenuTest.php     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 205104aba1f..f8920b5cebe 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -277,11 +277,6 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
     }
 
-    protected function createNavigationMenu(): MainNavigationMenu
-    {
-        return NavigationMenuGenerator::handle(MainNavigationMenu::class);
-    }
-
     public function testHasDropdownsReturnsTrueWhenGroupIsExplicitlySetInFrontMatter()
     {
         config(['hyde.navigation.subdirectories' => 'hidden']);
@@ -315,4 +310,9 @@ public function testHasDropdownsReturnsFalseWhenGroupIsNotExplicitlySetInFrontMa
         $menu = NavigationMenu::create();
         $this->assertFalse($menu->hasDropdowns());
     }
+
+    protected function createNavigationMenu(): MainNavigationMenu
+    {
+        return NavigationMenuGenerator::handle(MainNavigationMenu::class);
+    }
 }

From b92841e5a6c5b6ae460286f45e3b0cc102f05f11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 11:45:45 +0200
Subject: [PATCH 1718/4023] Use new helper

---
 packages/framework/tests/Feature/NavigationMenuTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index f8920b5cebe..ffeacacca7a 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -283,7 +283,7 @@ public function testHasDropdownsReturnsTrueWhenGroupIsExplicitlySetInFrontMatter
 
         Routes::addRoute((new MarkdownPage('foo', matter: ['navigation.group' => 'test-group']))->getRoute());
 
-        $this->assertTrue(NavigationMenu::create()->hasDropdowns());
+        $this->assertTrue($this->createNavigationMenu()->hasDropdowns());
     }
 
     public function testGetDropdownsReturnsCorrectArrayWhenGroupIsExplicitlySetInFrontMatter()
@@ -292,7 +292,7 @@ public function testGetDropdownsReturnsCorrectArrayWhenGroupIsExplicitlySetInFro
 
         Routes::addRoute((new MarkdownPage('foo', matter: ['navigation.group' => 'test-group']))->getRoute());
 
-        $menu = NavigationMenu::create();
+        $menu = $this->createNavigationMenu();
         $this->assertCount(1, $menu->getDropdowns());
 
         $this->assertEquals([
@@ -307,7 +307,7 @@ public function testHasDropdownsReturnsFalseWhenGroupIsNotExplicitlySetInFrontMa
         config(['hyde.navigation.subdirectories' => 'hidden']);
 
         Routes::addRoute((new MarkdownPage('foo'))->getRoute());
-        $menu = NavigationMenu::create();
+        $menu = $this->createNavigationMenu();
         $this->assertFalse($menu->hasDropdowns());
     }
 

From eb81e6076d3a459e3882bb7d8ce769dd90faffd4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 11:47:31 +0200
Subject: [PATCH 1719/4023] Remove tests for methods not present in v2

---
 .../tests/Feature/NavigationMenuTest.php      | 34 -------------------
 1 file changed, 34 deletions(-)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index ffeacacca7a..7f6cb8b3ac7 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -277,40 +277,6 @@ public function testCanAddItemsToMainNavigationMenuResolvedFromContainer()
         $this->assertSame('Foo', $navigation->getItems()->last()->getLabel());
     }
 
-    public function testHasDropdownsReturnsTrueWhenGroupIsExplicitlySetInFrontMatter()
-    {
-        config(['hyde.navigation.subdirectories' => 'hidden']);
-
-        Routes::addRoute((new MarkdownPage('foo', matter: ['navigation.group' => 'test-group']))->getRoute());
-
-        $this->assertTrue($this->createNavigationMenu()->hasDropdowns());
-    }
-
-    public function testGetDropdownsReturnsCorrectArrayWhenGroupIsExplicitlySetInFrontMatter()
-    {
-        config(['hyde.navigation.subdirectories' => 'hidden']);
-
-        Routes::addRoute((new MarkdownPage('foo', matter: ['navigation.group' => 'test-group']))->getRoute());
-
-        $menu = $this->createNavigationMenu();
-        $this->assertCount(1, $menu->getDropdowns());
-
-        $this->assertEquals([
-            DropdownNavItem::fromArray('test-group', [
-                NavItem::fromRoute((new MarkdownPage('foo'))->getRoute()),
-            ]),
-        ], $menu->getDropdowns());
-    }
-
-    public function testHasDropdownsReturnsFalseWhenGroupIsNotExplicitlySetInFrontMatter()
-    {
-        config(['hyde.navigation.subdirectories' => 'hidden']);
-
-        Routes::addRoute((new MarkdownPage('foo'))->getRoute());
-        $menu = $this->createNavigationMenu();
-        $this->assertFalse($menu->hasDropdowns());
-    }
-
     protected function createNavigationMenu(): MainNavigationMenu
     {
         return NavigationMenuGenerator::handle(MainNavigationMenu::class);

From b330ff516066551f596e7f3ea5e76cf4073742e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 11:59:56 +0200
Subject: [PATCH 1720/4023] Merge helper method into new code location

Merges https://github.com/hydephp/develop/commit/f612126e3743f071dbc8f84a22746710774c90f1
---
 .../Features/Navigation/NavigationMenuGenerator.php      | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d2bd01921f8..4d787584c0c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -96,10 +96,17 @@ protected function usesGroups(): bool
 
             return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;
         } else {
-            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
+            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown' || $this->hasGroupExplicitlySetInFrontMatter();
         }
     }
 
+    private function hasGroupExplicitlySetInFrontMatter(): bool
+    {
+        return $this->routes->contains(function (Route $item): bool {
+            return ($item->getPage()->navigationMenuGroup() !== null) && (! $item->getPage() instanceof DocumentationPage);
+        });
+    }
+
     protected function canAddRoute(Route $route): bool
     {
         if (! $route->getPage()->showInNavigation()) {

From 3ed045316892332a02dd76254ad9cb696d89b011 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 12:00:04 +0200
Subject: [PATCH 1721/4023] Revert "Merge helper method into new code location"

This reverts commit b330ff516066551f596e7f3ea5e76cf4073742e1.
---
 .../Features/Navigation/NavigationMenuGenerator.php      | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 4d787584c0c..d2bd01921f8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -96,17 +96,10 @@ protected function usesGroups(): bool
 
             return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;
         } else {
-            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown' || $this->hasGroupExplicitlySetInFrontMatter();
+            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
         }
     }
 
-    private function hasGroupExplicitlySetInFrontMatter(): bool
-    {
-        return $this->routes->contains(function (Route $item): bool {
-            return ($item->getPage()->navigationMenuGroup() !== null) && (! $item->getPage() instanceof DocumentationPage);
-        });
-    }
-
     protected function canAddRoute(Route $route): bool
     {
         if (! $route->getPage()->showInNavigation()) {

From 8dc4a522f182193db2186f0ecc9f78a77640ced9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 15:04:52 +0200
Subject: [PATCH 1722/4023] Calling the `Include::path()` method will no longer
 create the directory

It feels weird that this creates the directory, and it violates the principle of least astonishment as it's surprising that this creates a directory when you just request the path. Fixes https://github.com/hydephp/develop/issues/1706
---
 RELEASE_NOTES.md                              |  2 ++
 packages/framework/src/Support/Includes.php   |  5 -----
 .../tests/Feature/IncludesFacadeTest.php      | 22 ++++++++++++-------
 3 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 889880cae25..1d99b7472e4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -23,6 +23,8 @@ This serves two purposes:
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
+- Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
+
 
 ### Deprecated
 - for soon-to-be removed features.
diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index c271475103e..21b0eab2620 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
-use Hyde\Framework\Concerns\InteractsWithDirectories;
 
 use function basename;
 use function file_exists;
@@ -20,8 +19,6 @@
  */
 class Includes
 {
-    use InteractsWithDirectories;
-
     /**
      * @var string The directory where includes are stored.
      */
@@ -35,8 +32,6 @@ class Includes
      */
     public static function path(?string $filename = null): string
     {
-        static::needsDirectory(static::$includesDirectory);
-
         return $filename === null
             ? Hyde::path(static::$includesDirectory)
             : Hyde::path(static::$includesDirectory.'/'.$filename);
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 75ada517c31..d29dcee2ec7 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -15,6 +15,20 @@
  */
 class IncludesFacadeTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        File::makeDirectory(Includes::path(), recursive: true);
+    }
+
+    public function tearDown(): void
+    {
+        File::deleteDirectory(Includes::path());
+
+        parent::tearDown();
+    }
+
     public function testPathReturnsTheIncludesDirectory()
     {
         $this->assertSame(
@@ -31,14 +45,6 @@ public function testPathReturnsAPartialWithinTheIncludesDirectory()
         );
     }
 
-    public function testPathCreatesDirectoryIfItDoesNotExist()
-    {
-        $path = Includes::path();
-        File::deleteDirectory($path);
-        $this->assertFalse(File::exists($path));
-        $this->assertTrue(File::exists(Includes::path()));
-    }
-
     public function testGetReturnsPartial()
     {
         $expected = 'foo bar';

From f745555f24f047818c269c171fe67bbc44fee1d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 15:27:19 +0200
Subject: [PATCH 1723/4023] Use testing helper to handle temporary directory
 cleanup

---
 .../framework/tests/Feature/IncludesFacadeTest.php     | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index d29dcee2ec7..e2c95bc7c3d 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -8,7 +8,6 @@
 use Hyde\Support\Includes;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
-use Illuminate\Support\Facades\File;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -19,14 +18,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        File::makeDirectory(Includes::path(), recursive: true);
-    }
-
-    public function tearDown(): void
-    {
-        File::deleteDirectory(Includes::path());
-
-        parent::tearDown();
+        $this->directory('resources/includes');
     }
 
     public function testPathReturnsTheIncludesDirectory()

From 7e5a1c951a5ba70590f7bdf855d12d5dee1ce4bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 16:37:02 +0200
Subject: [PATCH 1724/4023] Create FilenamePrefixNavigationPriorityTest.php

---
 .../FilenamePrefixNavigationPriorityTest.php   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
new file mode 100644
index 00000000000..cd76aa492c4
--- /dev/null
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * High level test for the feature that allows navigation items to be sorted by filename prefix.
+ *
+ * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
+ * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ */
+class FilenamePrefixNavigationPriorityTest extends TestCase
+{
+    //
+}

From 4950f8b86272b7ef4c29cdbaa088969a77566269 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 16:37:58 +0200
Subject: [PATCH 1725/4023] Spec out the test

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index cd76aa492c4..32451e7a4a2 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -9,6 +9,9 @@
 /**
  * High level test for the feature that allows navigation items to be sorted by filename prefix.
  *
+ * The feature can be disabled in the config. It also works within sidebar groups,
+ * so that multiple groups can have the same prefix independent of other groups.
+ *
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  */

From 37e74f9f775e9ce523b640c4870ee6f1a71154cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 16:40:16 +0200
Subject: [PATCH 1726/4023] Draft fixture helpers

---
 .../FilenamePrefixNavigationPriorityTest.php  | 28 ++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 32451e7a4a2..f1a1cd801ea 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -17,5 +17,31 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
-    //
+    protected function fixtureFlatMain(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    protected function fixtureGroupedMain(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    protected function fixtureFlatSidebar(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    protected function fixtureGroupedSidebar(): array
+    {
+        return [
+            //
+        ];
+    }
 }

From 7f733e0ca089450373b73c73f3a14a1ddf381db1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 16:44:41 +0200
Subject: [PATCH 1727/4023] Define fixture data

---
 .../FilenamePrefixNavigationPriorityTest.php  | 31 ++++++++++++++++---
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index f1a1cd801ea..e26eb6bae55 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -20,28 +20,51 @@ class FilenamePrefixNavigationPriorityTest extends TestCase
     protected function fixtureFlatMain(): array
     {
         return [
-            //
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
         ];
     }
 
     protected function fixtureGroupedMain(): array
     {
         return [
-            //
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
+            '04-api' => [
+                '01-readme.md',
+                '02-installation.md',
+                '03-getting-started.md',
+            ],
         ];
     }
 
     protected function fixtureFlatSidebar(): array
     {
         return [
-            //
+            '01-readme.md',
+            '02-installation.md',
+            '03-getting-started.md',
         ];
     }
 
     protected function fixtureGroupedSidebar(): array
     {
         return [
-            //
+            '01-readme.md',
+            '02-installation.md',
+            '03-getting-started.md',
+            '04-introduction' => [
+                '01-features.md',
+                '02-extensions.md',
+                '03-configuration.md',
+            ],
+            '05-advanced' => [
+                '01-features.md',
+                '02-extensions.md',
+                '03-configuration.md',
+            ],
         ];
     }
 }

From d4b3829b8a286890dc8f152db8761874605002cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 16:47:13 +0200
Subject: [PATCH 1728/4023] Add more fixtures

---
 .../FilenamePrefixNavigationPriorityTest.php  | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index e26eb6bae55..a2ec673c6e6 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -67,4 +67,32 @@ protected function fixtureGroupedSidebar(): array
             ],
         ];
     }
+
+    protected function fixturePrefixSyntaxes(): array
+    {
+        return [
+            [
+                '1-foo.md',
+                '2-bar.md',
+                '3-baz.md',
+            ], [
+                '01-foo.md',
+                '02-bar.md',
+                '03-baz.md',
+            ], [
+                '001-foo.md',
+                '002-bar.md',
+                '003-baz.md',
+            ],
+        ];
+    }
+
+    public function fixtureFileExtensions(): array
+    {
+        return [
+            '01-foo.md',
+            '02-bar.html',
+            '03-baz.blade.php',
+        ];
+    }
 }

From 1fa4ab2848c96b1c8d0bf32da854d98fa679ea2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:25:03 +0200
Subject: [PATCH 1729/4023] Draft new tests

---
 .../Feature/FilenamePrefixNavigationPriorityTest.php   | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index a2ec673c6e6..442cd142872 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -17,6 +17,16 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
+    public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromIdentifiers()
+    {
+        //
+    }
+
+    public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromIdentifiersWhenFeatureIsDisabled()
+    {
+        //
+    }
+
     protected function fixtureFlatMain(): array
     {
         return [

From b2ca812d67bfedc4901edb83198130fe5ebe52cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:26:32 +0200
Subject: [PATCH 1730/4023] Create FilenamePrefixNavigationHelper.php

---
 .../Navigation/FilenamePrefixNavigationHelper.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
new file mode 100644
index 00000000000..03c565084a7
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+/**
+ * @internal Helper class for the new Filename Prefix Navigation feature.
+ *
+ * @experimental The code herein may be moved to more appropriate locations in the future.
+ */
+class FilenamePrefixNavigationHelper
+{
+    //
+}

From 7484d5627fd16b8d7c9688eb1330adecefa6412f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:43:38 +0200
Subject: [PATCH 1731/4023] Add helper to check if identifier is numbered

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 03c565084a7..5996b965958 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -11,5 +11,8 @@
  */
 class FilenamePrefixNavigationHelper
 {
-    //
+    public static function isIdentifierNumbered(string $identifier): bool
+    {
+        return preg_match('/^\d+-/', $identifier) === 1;
+    }
 }

From d05ee52031644f2d7b35b9f0fa0a4491771b4cad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:44:09 +0200
Subject: [PATCH 1732/4023] Create a temporary way to declare tests within the
 class

Allows Copilot to better generate tests, we will move these back to the test later
---
 .../FilenamePrefixNavigationHelper.php        | 22 +++++++++++++++++++
 .../FilenamePrefixNavigationPriorityTest.php  | 14 ++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 5996b965958..b219d388060 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Testing\UnitTestCase;
+
 /**
  * @internal Helper class for the new Filename Prefix Navigation feature.
  *
@@ -15,4 +17,24 @@ public static function isIdentifierNumbered(string $identifier): bool
     {
         return preg_match('/^\d+-/', $identifier) === 1;
     }
+
+    public static function getTest(): UnitTestCase
+    {
+        return new class('FilenamePrefixNavigationHelperTest') extends UnitTestCase
+        {
+            public function testIdentifiersWithNumericalPrefixesAreDetected()
+            {
+                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+            }
+
+            public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+            {
+                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+            }
+        };
+    }
 }
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 442cd142872..4b362ad3aff 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -5,6 +5,8 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use PHPUnit\Framework\TestRunner;
+use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
 /**
  * High level test for the feature that allows navigation items to be sorted by filename prefix.
@@ -17,6 +19,18 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
+    public function testFilenamePrefixNavigationHelper()
+    {
+        $case = FilenamePrefixNavigationHelper::getTest();
+
+        // Get methods defined in the test case but not in the parent class.
+        $methods = array_diff(get_class_methods($case), get_class_methods(TestCase::class));
+
+        foreach ($methods as $method) {
+            (new TestRunner)->run(new $case($method));
+        }
+    }
+
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromIdentifiers()
     {
         //

From 3fc5752d3b3223faf43be98ed5e09fb9c50be665 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:44:20 +0200
Subject: [PATCH 1733/4023] Add coverage annotation

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 4b362ad3aff..c05d250d37b 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -14,6 +14,7 @@
  * The feature can be disabled in the config. It also works within sidebar groups,
  * so that multiple groups can have the same prefix independent of other groups.
  *
+ * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  */

From b87eee1e0cc40a5d9c48faa0c936c8df76c71258 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:45:51 +0200
Subject: [PATCH 1734/4023] Skip unimplemented tests

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index c05d250d37b..69f4977e70d 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -34,12 +34,12 @@ public function testFilenamePrefixNavigationHelper()
 
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromIdentifiers()
     {
-        //
+        $this->markTestSkipped('TODO');
     }
 
     public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromIdentifiersWhenFeatureIsDisabled()
     {
-        //
+        $this->markTestSkipped('TODO');
     }
 
     protected function fixtureFlatMain(): array

From 8d167bace0a99d110cee118d564007c3f078f38a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:49:14 +0200
Subject: [PATCH 1735/4023] Add enabled helper

---
 .../Navigation/FilenamePrefixNavigationHelper.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index b219d388060..82ea5752afc 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -13,6 +13,11 @@
  */
 class FilenamePrefixNavigationHelper
 {
+    public static function enabled(): bool
+    {
+        return true;
+    }
+
     public static function isIdentifierNumbered(string $identifier): bool
     {
         return preg_match('/^\d+-/', $identifier) === 1;
@@ -22,6 +27,16 @@ public static function getTest(): UnitTestCase
     {
         return new class('FilenamePrefixNavigationHelperTest') extends UnitTestCase
         {
+            public function testEnabledReturnsTrueWhenEnabled()
+            {
+                $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+            }
+
+            public function testEnabledReturnsFalseWhenDisabled()
+            {
+                $this->markTestSkipped('TODO: Support for disabling the feature.');
+            }
+
             public function testIdentifiersWithNumericalPrefixesAreDetected()
             {
                 $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));

From 3aa4247cb0044c69a7435a0ca51b235dec321235 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:50:42 +0200
Subject: [PATCH 1736/4023] Document methods

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 82ea5752afc..9e40081b6eb 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -13,11 +13,17 @@
  */
 class FilenamePrefixNavigationHelper
 {
+    /**
+     * Determines if the feature is enabled.
+     */
     public static function enabled(): bool
     {
         return true;
     }
 
+    /**
+     * Determines if a given identifier has a numerical prefix.
+     */
     public static function isIdentifierNumbered(string $identifier): bool
     {
         return preg_match('/^\d+-/', $identifier) === 1;

From 178255509a73cb799c9b834e20dce2f149e4434b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:51:31 +0200
Subject: [PATCH 1737/4023] Split number and identifier

---
 .../FilenamePrefixNavigationHelper.php        | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 9e40081b6eb..994377ca380 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -29,6 +29,16 @@ public static function isIdentifierNumbered(string $identifier): bool
         return preg_match('/^\d+-/', $identifier) === 1;
     }
 
+    /**
+     * Splits a numbered identifier into its numerical prefix and the rest of the identifier.
+     *
+     * @return array{numeric-string, string}
+     */
+    public static function splitNumberAndIdentifier(string $identifier): array
+    {
+        return explode('-', $identifier, 2);
+    }
+
     public static function getTest(): UnitTestCase
     {
         return new class('FilenamePrefixNavigationHelperTest') extends UnitTestCase
@@ -56,6 +66,20 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
                 $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
                 $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
             }
+
+            public function testSplitNumberAndIdentifier()
+            {
+                $this->assertSame(['01', 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+                $this->assertSame(['02', 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+                $this->assertSame(['03', 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+            }
+
+            public function testSplitNumberAndIdentifierWithMultipleDigits()
+            {
+                $this->assertSame(['123', 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+                $this->assertSame(['456', 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+                $this->assertSame(['789', 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+            }
         };
     }
 }

From 66fe07cd1b2cc4a05616fa2d7513ed3204ee5b9d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:52:11 +0200
Subject: [PATCH 1738/4023] Introduce local variable

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 994377ca380..ea65f7c54a8 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -36,7 +36,9 @@ public static function isIdentifierNumbered(string $identifier): bool
      */
     public static function splitNumberAndIdentifier(string $identifier): array
     {
-        return explode('-', $identifier, 2);
+        $parts = explode('-', $identifier, 2);
+
+        return $parts;
     }
 
     public static function getTest(): UnitTestCase

From a0c20eade66bbb4241f5e39284a95225362bae75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:53:48 +0200
Subject: [PATCH 1739/4023] Parse the number to an integer

---
 .../FilenamePrefixNavigationHelper.php           | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index ea65f7c54a8..61c325807c8 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -32,12 +32,14 @@ public static function isIdentifierNumbered(string $identifier): bool
     /**
      * Splits a numbered identifier into its numerical prefix and the rest of the identifier.
      *
-     * @return array{numeric-string, string}
+     * @return array{integer, string}
      */
     public static function splitNumberAndIdentifier(string $identifier): array
     {
         $parts = explode('-', $identifier, 2);
 
+        $parts[0] = (int) $parts[0];
+
         return $parts;
     }
 
@@ -71,16 +73,16 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
 
             public function testSplitNumberAndIdentifier()
             {
-                $this->assertSame(['01', 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-                $this->assertSame(['02', 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-                $this->assertSame(['03', 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+                $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+                $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+                $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
             }
 
             public function testSplitNumberAndIdentifierWithMultipleDigits()
             {
-                $this->assertSame(['123', 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-                $this->assertSame(['456', 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-                $this->assertSame(['789', 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+                $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+                $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+                $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
             }
         };
     }

From df35e5a7e110ac9c14766c04a25ed482c4860ae9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 20:54:31 +0200
Subject: [PATCH 1740/4023] Assert type structure

---
 .../Navigation/FilenamePrefixNavigationHelper.php      | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 61c325807c8..c461cafd86d 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -36,6 +36,8 @@ public static function isIdentifierNumbered(string $identifier): bool
      */
     public static function splitNumberAndIdentifier(string $identifier): array
     {
+        assert(self::isIdentifierNumbered($identifier));
+
         $parts = explode('-', $identifier, 2);
 
         $parts[0] = (int) $parts[0];
@@ -84,6 +86,14 @@ public function testSplitNumberAndIdentifierWithMultipleDigits()
                 $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
                 $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
             }
+
+            public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+            {
+                $this->expectException(\AssertionError::class);
+                // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+                FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+            }
         };
     }
 }

From ae17392a42094284abc3aa65c246e289d1848864 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:19:20 +0200
Subject: [PATCH 1741/4023] Annotate method

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php     | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index c461cafd86d..4c9d2011a69 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -45,6 +45,9 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 
+    /**
+     * Returns the test case for the FilenamePrefixNavigationHelper.
+     */
     public static function getTest(): UnitTestCase
     {
         return new class('FilenamePrefixNavigationHelperTest') extends UnitTestCase

From 7a9fd6372f37ce2913706f2c361773dfed1d32bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:23:21 +0200
Subject: [PATCH 1742/4023] Refactor inline test hack to load full class

---
 .../FilenamePrefixNavigationHelper.php        | 100 ++++++++----------
 .../FilenamePrefixNavigationPriorityTest.php  |   6 +-
 2 files changed, 52 insertions(+), 54 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 4c9d2011a69..f5ecd31576a 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -44,59 +44,53 @@ public static function splitNumberAndIdentifier(string $identifier): array
 
         return $parts;
     }
+}
 
-    /**
-     * Returns the test case for the FilenamePrefixNavigationHelper.
-     */
-    public static function getTest(): UnitTestCase
+class FilenamePrefixNavigationHelperTest extends UnitTestCase
+{
+    public function testEnabledReturnsTrueWhenEnabled()
     {
-        return new class('FilenamePrefixNavigationHelperTest') extends UnitTestCase
-        {
-            public function testEnabledReturnsTrueWhenEnabled()
-            {
-                $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-            }
-
-            public function testEnabledReturnsFalseWhenDisabled()
-            {
-                $this->markTestSkipped('TODO: Support for disabling the feature.');
-            }
-
-            public function testIdentifiersWithNumericalPrefixesAreDetected()
-            {
-                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-                $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-            }
-
-            public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-            {
-                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-                $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-            }
-
-            public function testSplitNumberAndIdentifier()
-            {
-                $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-                $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-                $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-            }
-
-            public function testSplitNumberAndIdentifierWithMultipleDigits()
-            {
-                $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-                $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-                $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-            }
-
-            public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-            {
-                $this->expectException(\AssertionError::class);
-                // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-                FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-            }
-        };
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
     }
-}
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        $this->markTestSkipped('TODO: Support for disabling the feature.');
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->expectException(\AssertionError::class);
+        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 69f4977e70d..fbccf1defa4 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -7,6 +7,7 @@
 use Hyde\Testing\TestCase;
 use PHPUnit\Framework\TestRunner;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
+use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelperTest;
 
 /**
  * High level test for the feature that allows navigation items to be sorted by filename prefix.
@@ -22,7 +23,10 @@ class FilenamePrefixNavigationPriorityTest extends TestCase
 {
     public function testFilenamePrefixNavigationHelper()
     {
-        $case = FilenamePrefixNavigationHelper::getTest();
+        // Manually load test as it does not conform to PSR-4 autoloading.
+        require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
+
+        $case = FilenamePrefixNavigationHelperTest::class;
 
         // Get methods defined in the test case but not in the parent class.
         $methods = array_diff(get_class_methods($case), get_class_methods(TestCase::class));

From 9795e0d9172a660a031aae20d1e4ec6549282445 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:23:52 +0200
Subject: [PATCH 1743/4023] Import used functions

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index f5ecd31576a..e3cde2b5234 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -6,6 +6,10 @@
 
 use Hyde\Testing\UnitTestCase;
 
+use function assert;
+use function explode;
+use function preg_match;
+
 /**
  * @internal Helper class for the new Filename Prefix Navigation feature.
  *

From 9c5fa9891f621381e584b5a5ee42b222d081b3f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:25:17 +0200
Subject: [PATCH 1744/4023] Check the config for enabled state

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index e3cde2b5234..09ff5ad6eb9 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use Hyde\Facades\Config;
 use Hyde\Testing\UnitTestCase;
 
 use function assert;
@@ -22,7 +23,7 @@ class FilenamePrefixNavigationHelper
      */
     public static function enabled(): bool
     {
-        return true;
+        return Config::getBool('hyde.filename_page_ordering', true);
     }
 
     /**
@@ -59,7 +60,9 @@ public function testEnabledReturnsTrueWhenEnabled()
 
     public function testEnabledReturnsFalseWhenDisabled()
     {
-        $this->markTestSkipped('TODO: Support for disabling the feature.');
+        self::mockConfig(['hyde.filename_page_ordering' => false]);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
     }
 
     public function testIdentifiersWithNumericalPrefixesAreDetected()

From bfa6642886e7f474080532a0b2eaf51998b8ac5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:30:17 +0200
Subject: [PATCH 1745/4023] Rename tests for new design plan

See https://github.com/hydephp/develop/pull/1709#issuecomment-2086420773 (edit 2 and 3)
---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index fbccf1defa4..c12cc27e41e 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -36,12 +36,12 @@ public function testFilenamePrefixNavigationHelper()
         }
     }
 
-    public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromIdentifiers()
+    public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
         $this->markTestSkipped('TODO');
     }
 
-    public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromIdentifiersWhenFeatureIsDisabled()
+    public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeysWhenFeatureIsDisabled()
     {
         $this->markTestSkipped('TODO');
     }

From c05e72ec937bb35544d5e6bdddf9b0f5a7103634 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:35:23 +0200
Subject: [PATCH 1746/4023] Implement the tests

---
 .../FilenamePrefixNavigationPriorityTest.php  | 56 ++++++++++++++++++-
 1 file changed, 54 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index c12cc27e41e..5369f1ae994 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
+use Hyde\Pages\MarkdownPage;
 use PHPUnit\Framework\TestRunner;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelperTest;
@@ -38,12 +40,62 @@ public function testFilenamePrefixNavigationHelper()
 
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
-        $this->markTestSkipped('TODO');
+        $this->file('_pages/01-home.md');
+
+        $identifier = '01-home';
+
+        // Assert it is discovered.
+        $discovered = MarkdownPage::get($identifier);
+        $this->assertNotNull($discovered, 'The page was not discovered.');
+
+        // Assert it is parsable
+        $parsed = MarkdownPage::parse($identifier);
+        $this->assertNotNull($parsed, 'The page was not parsable.');
+
+        // Sanity check
+        $this->assertEquals($discovered, $parsed);
+
+        $page = $discovered;
+
+        // Assert identifier is the same.
+        $this->assertSame($identifier, $page->getIdentifier());
+
+        // Assert the route key is trimmed.
+        $this->assertSame('home', $page->getRouteKey());
+
+        // Assert route key dependents are trimmed.
+        $this->assertSame('home.html', $page->getOutputPath());
     }
 
     public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeysWhenFeatureIsDisabled()
     {
-        $this->markTestSkipped('TODO');
+        Config::set('hyde.filename_page_ordering', false);
+
+        $this->file('_pages/01-home.md');
+
+        $identifier = '01-home';
+
+        // Assert it is discovered.
+        $discovered = MarkdownPage::get($identifier);
+        $this->assertNotNull($discovered, 'The page was not discovered.');
+
+        // Assert it is parsable
+        $parsed = MarkdownPage::parse($identifier);
+        $this->assertNotNull($parsed, 'The page was not parsable.');
+
+        // Sanity check
+        $this->assertEquals($discovered, $parsed);
+
+        $page = $discovered;
+
+        // Assert identifier is the same.
+        $this->assertSame($identifier, $page->getIdentifier());
+
+        // Assert the route key is trimmed.
+        $this->assertSame($identifier, $page->getRouteKey());
+
+        // Assert route key dependents are trimmed.
+        $this->assertSame("$identifier.html", $page->getOutputPath());
     }
 
     protected function fixtureFlatMain(): array

From 9271e403e884b7adffa87dd0bd751dcc106242de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:40:26 +0200
Subject: [PATCH 1747/4023] Update route key creation to split numbered
 identifiers

---
 packages/framework/src/Support/Models/RouteKey.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 1ec5ae2bc7d..1254aa396fc 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -5,6 +5,7 @@
 namespace Hyde\Support\Models;
 
 use Stringable;
+use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
 use function unslash;
 
@@ -47,6 +48,10 @@ public function get(): string
     /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     public static function fromPage(string $pageClass, string $identifier): self
     {
+        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
+            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
+        }
+
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }
 }

From 777ac9d424ba6ab6998afc3fad3f3928a15f36df Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:41:33 +0200
Subject: [PATCH 1748/4023] Extract experimental helper method

---
 packages/framework/src/Support/Models/RouteKey.php | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 1254aa396fc..f7e7a140023 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -30,6 +30,16 @@ public static function make(string $key): self
         return new self($key);
     }
 
+    /** @experimental */
+    protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
+    {
+        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
+            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
+        }
+
+        return $identifier;
+    }
+
     public function __construct(string $key)
     {
         $this->key = $key;
@@ -48,9 +58,7 @@ public function get(): string
     /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     public static function fromPage(string $pageClass, string $identifier): self
     {
-        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
-            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
-        }
+        $identifier = self::splitNumberedIdentifiersIfNeeded($identifier);
 
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }

From 09a828ef1f908439a330af33f60d04ba34ef04d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:41:46 +0200
Subject: [PATCH 1749/4023] Move down helper method

---
 .../framework/src/Support/Models/RouteKey.php | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index f7e7a140023..ecf98145996 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -30,16 +30,6 @@ public static function make(string $key): self
         return new self($key);
     }
 
-    /** @experimental */
-    protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
-    {
-        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
-            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
-        }
-
-        return $identifier;
-    }
-
     public function __construct(string $key)
     {
         $this->key = $key;
@@ -62,4 +52,14 @@ public static function fromPage(string $pageClass, string $identifier): self
 
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }
+
+    /** @experimental */
+    protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
+    {
+        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
+            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
+        }
+
+        return $identifier;
+    }
 }

From 8b7ce81c1cea333cef864d4a60a5096c6882508d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:43:16 +0200
Subject: [PATCH 1750/4023] Merge inline test into test case

---
 .../FilenamePrefixNavigationHelper.php        | 52 -------------------
 .../FilenamePrefixNavigationPriorityTest.php  | 52 +++++++++++++++++++
 2 files changed, 52 insertions(+), 52 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 09ff5ad6eb9..e9059d2f344 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use Hyde\Testing\UnitTestCase;
 
 use function assert;
 use function explode;
@@ -50,54 +49,3 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 }
-
-class FilenamePrefixNavigationHelperTest extends UnitTestCase
-{
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        self::mockConfig(['hyde.filename_page_ordering' => false]);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->expectException(\AssertionError::class);
-        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-    }
-}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 5369f1ae994..6845afd8ed4 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -25,6 +25,8 @@ class FilenamePrefixNavigationPriorityTest extends TestCase
 {
     public function testFilenamePrefixNavigationHelper()
     {
+        $this->markTestSkipped('Disabled in CI');
+
         // Manually load test as it does not conform to PSR-4 autoloading.
         require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
 
@@ -38,6 +40,56 @@ public function testFilenamePrefixNavigationHelper()
         }
     }
 
+    // Helper test
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        Config::set('hyde.filename_page_ordering', false);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->expectException(\AssertionError::class);
+        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+    // End helper test
+
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
         $this->file('_pages/01-home.md');

From c5e0433b2c206508be0fb0a27743e675fe265e7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:59:23 +0200
Subject: [PATCH 1751/4023] Revert "Merge inline test into test case"

This reverts commit 8b7ce81c1cea333cef864d4a60a5096c6882508d.
---
 .../FilenamePrefixNavigationHelper.php        | 52 +++++++++++++++++++
 .../FilenamePrefixNavigationPriorityTest.php  | 52 -------------------
 2 files changed, 52 insertions(+), 52 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index e9059d2f344..09ff5ad6eb9 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
+use Hyde\Testing\UnitTestCase;
 
 use function assert;
 use function explode;
@@ -49,3 +50,54 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 }
+
+class FilenamePrefixNavigationHelperTest extends UnitTestCase
+{
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        self::mockConfig(['hyde.filename_page_ordering' => false]);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->expectException(\AssertionError::class);
+        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 6845afd8ed4..5369f1ae994 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -25,8 +25,6 @@ class FilenamePrefixNavigationPriorityTest extends TestCase
 {
     public function testFilenamePrefixNavigationHelper()
     {
-        $this->markTestSkipped('Disabled in CI');
-
         // Manually load test as it does not conform to PSR-4 autoloading.
         require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
 
@@ -40,56 +38,6 @@ public function testFilenamePrefixNavigationHelper()
         }
     }
 
-    // Helper test
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        Config::set('hyde.filename_page_ordering', false);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->expectException(\AssertionError::class);
-        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-    }
-    // End helper test
-
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
         $this->file('_pages/01-home.md');

From 2936b349f6fae15bfb7653c372dbdd1d41d6d143 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 21:59:48 +0200
Subject: [PATCH 1752/4023] Change mock syntax

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 09ff5ad6eb9..6f1195518ce 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -60,7 +60,7 @@ public function testEnabledReturnsTrueWhenEnabled()
 
     public function testEnabledReturnsFalseWhenDisabled()
     {
-        self::mockConfig(['hyde.filename_page_ordering' => false]);
+        Config::set('hyde.filename_page_ordering', false);
 
         $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
     }

From fe2c1577d0c1baf1fa7da55cab03db3bfca96e10 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 22:01:15 +0200
Subject: [PATCH 1753/4023] Skip assertion test

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 6f1195518ce..fa6201f521f 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -95,8 +95,10 @@ public function testSplitNumberAndIdentifierWithMultipleDigits()
 
     public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
     {
+        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
         $this->expectException(\AssertionError::class);
-        // $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
 
         FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
     }

From 14757ab3c22eb483e4ebaef11eaf5fdf38f96813 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Apr 2024 22:02:02 +0200
Subject: [PATCH 1754/4023] Reapply "Merge inline test into test case"

This reverts commit c5e0433b2c206508be0fb0a27743e675fe265e7b.
---
 .../FilenamePrefixNavigationHelper.php        | 53 -------------------
 .../FilenamePrefixNavigationPriorityTest.php  | 53 +++++++++++++++----
 2 files changed, 44 insertions(+), 62 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index fa6201f521f..8c94875b950 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -50,56 +50,3 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 }
-
-class FilenamePrefixNavigationHelperTest extends UnitTestCase
-{
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        Config::set('hyde.filename_page_ordering', false);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-    }
-}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 5369f1ae994..2cf7879569e 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -23,19 +23,54 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
-    public function testFilenamePrefixNavigationHelper()
+    public function testEnabledReturnsTrueWhenEnabled()
     {
-        // Manually load test as it does not conform to PSR-4 autoloading.
-        require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        Config::set('hyde.filename_page_ordering', false);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
 
-        $case = FilenamePrefixNavigationHelperTest::class;
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
 
-        // Get methods defined in the test case but not in the parent class.
-        $methods = array_diff(get_class_methods($case), get_class_methods(TestCase::class));
+        $this->expectException(\AssertionError::class);
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
 
-        foreach ($methods as $method) {
-            (new TestRunner)->run(new $case($method));
-        }
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
     }
 
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()

From e947a62f7e12257871e9dc723544c49ed0232eae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 10:00:36 +0200
Subject: [PATCH 1755/4023] Revert "Reapply "Merge inline test into test case""

This reverts commit 14757ab3c22eb483e4ebaef11eaf5fdf38f96813.
---
 .../FilenamePrefixNavigationHelper.php        | 53 +++++++++++++++++++
 .../FilenamePrefixNavigationPriorityTest.php  | 53 ++++---------------
 2 files changed, 62 insertions(+), 44 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 8c94875b950..fa6201f521f 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -50,3 +50,56 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 }
+
+class FilenamePrefixNavigationHelperTest extends UnitTestCase
+{
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        Config::set('hyde.filename_page_ordering', false);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
+        $this->expectException(\AssertionError::class);
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 2cf7879569e..5369f1ae994 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -23,54 +23,19 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
-    public function testEnabledReturnsTrueWhenEnabled()
+    public function testFilenamePrefixNavigationHelper()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        Config::set('hyde.filename_page_ordering', false);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
+        // Manually load test as it does not conform to PSR-4 autoloading.
+        require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
 
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+        $case = FilenamePrefixNavigationHelperTest::class;
 
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+        // Get methods defined in the test case but not in the parent class.
+        $methods = array_diff(get_class_methods($case), get_class_methods(TestCase::class));
 
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+        foreach ($methods as $method) {
+            (new TestRunner)->run(new $case($method));
+        }
     }
 
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()

From 0792b8682e0c85051ceb19d52e35660bfc3b56ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 10:03:40 +0200
Subject: [PATCH 1756/4023] Extract proper test file

---
 .../FilenamePrefixNavigationHelper.php        | 54 ----------------
 .../FilenamePrefixNavigationPriorityTest.php  | 18 ------
 ...lenamePrefixNavigationPriorityUnitTest.php | 63 +++++++++++++++++++
 3 files changed, 63 insertions(+), 72 deletions(-)
 create mode 100644 packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index fa6201f521f..e9059d2f344 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
-use Hyde\Testing\UnitTestCase;
 
 use function assert;
 use function explode;
@@ -50,56 +49,3 @@ public static function splitNumberAndIdentifier(string $identifier): array
         return $parts;
     }
 }
-
-class FilenamePrefixNavigationHelperTest extends UnitTestCase
-{
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        Config::set('hyde.filename_page_ordering', false);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-    }
-}
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 5369f1ae994..380c400f93a 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -7,9 +7,6 @@
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
-use PHPUnit\Framework\TestRunner;
-use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
-use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelperTest;
 
 /**
  * High level test for the feature that allows navigation items to be sorted by filename prefix.
@@ -23,21 +20,6 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
-    public function testFilenamePrefixNavigationHelper()
-    {
-        // Manually load test as it does not conform to PSR-4 autoloading.
-        require_once __DIR__ . '/../../src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php';
-
-        $case = FilenamePrefixNavigationHelperTest::class;
-
-        // Get methods defined in the test case but not in the parent class.
-        $methods = array_diff(get_class_methods($case), get_class_methods(TestCase::class));
-
-        foreach ($methods as $method) {
-            (new TestRunner)->run(new $case($method));
-        }
-    }
-
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
         $this->file('_pages/01-home.md');
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
new file mode 100644
index 00000000000..2e74b51cc9d
--- /dev/null
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
+
+class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
+{
+    protected static bool $needsConfig = true;
+
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        self::mockConfig(['hyde.filename_page_ordering' => false]);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
+        $this->expectException(\AssertionError::class);
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+}

From 59a8a81c059f4c7e4f5d45800f0d3cc8f844df87 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 10:08:16 +0200
Subject: [PATCH 1757/4023] Disable page ordering in unrelated test

---
 .../framework/tests/Feature/Services/SitemapServiceTest.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/SitemapServiceTest.php b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
index d54b9711dfa..f718fe3d223 100644
--- a/packages/framework/tests/Feature/Services/SitemapServiceTest.php
+++ b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
@@ -7,6 +7,7 @@
 namespace Hyde\Framework\Testing\Feature\Services;
 
 use SimpleXMLElement;
+use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Hyde\Framework\Features\XmlGenerators\SitemapGenerator;
 use Hyde\Hyde;
@@ -28,6 +29,8 @@ protected function setUp(): void
 
         copy(Hyde::vendorPath('resources/views/homepages/welcome.blade.php'), Hyde::path('_pages/index.blade.php'));
         copy(Hyde::vendorPath('resources/views/pages/404.blade.php'), Hyde::path('_pages/404.blade.php'));
+
+        Config::set(['hyde.filename_page_ordering' => false]);
     }
 
     public function testServiceInstantiatesXmlElement()

From 9c1507d822c90dd48f23a3735596652683bee1d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 10:14:40 +0200
Subject: [PATCH 1758/4023] Set up coverage

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 1 +
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php    | 3 +++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 380c400f93a..41316de0c13 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -17,6 +17,7 @@
  * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 2e74b51cc9d..d614b73f735 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -7,6 +7,9 @@
 use Hyde\Testing\UnitTestCase;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
+/**
+ * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
+ */
 class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;

From e936b9cade62af9a9230bc968a4f60af18e8f4f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 11:32:00 +0200
Subject: [PATCH 1759/4023] Create initial fixture setup helper

Takes about 7ms for 3 pages so really needs to be optimized to use the VFS
---
 .../Feature/FilenamePrefixNavigationPriorityTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 41316de0c13..1ac93b6e013 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -81,6 +81,15 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
         $this->assertSame("$identifier.html", $page->getOutputPath());
     }
 
+    protected function setUpFixture(array $files): array
+    {
+        foreach ($files as $file) {
+            $this->file("_pages/$file");
+        }
+
+        return MarkdownPage::all()->all();
+    }
+
     protected function fixtureFlatMain(): array
     {
         return [

From e248e6776fc6f6726cb18003f0eaf476003a564e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:37:48 +0200
Subject: [PATCH 1760/4023] Add pages to kernel directly without the filesystem

Much faster to do it this way
---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 1ac93b6e013..fae0a772c7c 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
@@ -84,7 +85,7 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
     protected function setUpFixture(array $files): array
     {
         foreach ($files as $file) {
-            $this->file("_pages/$file");
+            Hyde::pages()->addPage(new MarkdownPage(basename($file, '.md')));
         }
 
         return MarkdownPage::all()->all();

From 4140df178566945ae97b8c044657ea1a64e58c23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:38:09 +0200
Subject: [PATCH 1761/4023] Generate some content for the page

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index fae0a772c7c..d8dad8e90ba 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -85,7 +85,7 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
     protected function setUpFixture(array $files): array
     {
         foreach ($files as $file) {
-            Hyde::pages()->addPage(new MarkdownPage(basename($file, '.md')));
+            Hyde::pages()->addPage(new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n"));
         }
 
         return MarkdownPage::all()->all();

From bfd8cac37cab5492def4685969ac34d3f9bdedeb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:38:19 +0200
Subject: [PATCH 1762/4023] Draft first test

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index d8dad8e90ba..329a6e936cf 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -82,6 +82,11 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
         $this->assertSame("$identifier.html", $page->getOutputPath());
     }
 
+    public function test_fixtureFlatMain_ordering()
+    {
+        $pages = $this->setUpFixture($this->fixtureFlatMain());
+    }
+
     protected function setUpFixture(array $files): array
     {
         foreach ($files as $file) {

From 4b597602dc9cc51b93abfeaf59f86a6b1506d462 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:41:05 +0200
Subject: [PATCH 1763/4023] Add the page to kernel routes

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 329a6e936cf..56e65da3f3a 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -90,7 +90,9 @@ public function test_fixtureFlatMain_ordering()
     protected function setUpFixture(array $files): array
     {
         foreach ($files as $file) {
-            Hyde::pages()->addPage(new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n"));
+            $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+            Hyde::pages()->addPage($page);
+            Hyde::routes()->addRoute($page->getRoute());
         }
 
         return MarkdownPage::all()->all();

From b59f73eabaca9c056c9041fe4d616ff2578f086f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:45:12 +0200
Subject: [PATCH 1764/4023] Run without default pages

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 56e65da3f3a..b39f3b82d42 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -89,6 +89,8 @@ public function test_fixtureFlatMain_ordering()
 
     protected function setUpFixture(array $files): array
     {
+        $this->withoutDefaultPages();
+
         foreach ($files as $file) {
             $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
             Hyde::pages()->addPage($page);

From 61c484ed3976679afec6d04d526117e7ab9cd792 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:45:25 +0200
Subject: [PATCH 1765/4023] Add todo

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index b39f3b82d42..0e57c2d350f 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -89,6 +89,7 @@ public function test_fixtureFlatMain_ordering()
 
     protected function setUpFixture(array $files): array
     {
+        // Todo: Replace kernel with mock class
         $this->withoutDefaultPages();
 
         foreach ($files as $file) {

From 9b01811c637c8e83226fc529eb7dff50550c2dc2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:48:27 +0200
Subject: [PATCH 1766/4023] Set up clean environment in setup

---
 .../FilenamePrefixNavigationPriorityTest.php   | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 0e57c2d350f..ec55a3b856b 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -22,6 +22,21 @@
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // Todo: Replace kernel with mock class
+        $this->withoutDefaultPages();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->restoreDefaultPages();
+
+        parent::tearDown();
+    }
+
     public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
         $this->file('_pages/01-home.md');
@@ -89,9 +104,6 @@ public function test_fixtureFlatMain_ordering()
 
     protected function setUpFixture(array $files): array
     {
-        // Todo: Replace kernel with mock class
-        $this->withoutDefaultPages();
-
         foreach ($files as $file) {
             $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
             Hyde::pages()->addPage($page);

From 3047f96ba5033127da7e45e88b40504d30fbebd0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:48:55 +0200
Subject: [PATCH 1767/4023] Add helper to assert order

---
 .../FilenamePrefixNavigationPriorityTest.php      | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index ec55a3b856b..501ca321e85 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -8,6 +8,9 @@
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
+use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * High level test for the feature that allows navigation items to be sorted by filename prefix.
@@ -113,6 +116,18 @@ protected function setUpFixture(array $files): array
         return MarkdownPage::all()->all();
     }
 
+    /**
+     * @param array<\Hyde\Pages\Concerns\HydePage> $pages
+     * @param array<string> $expected
+     */
+    protected function assertOrder(array $pages, array $expected): void
+    {
+        $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
+        $actual = $menu->getItems()->map(fn (NavigationItem $item) => $item->getPage()->getRouteKey())->all();
+
+        $this->assertSame($expected, $actual);
+    }
+
     protected function fixtureFlatMain(): array
     {
         return [

From f7303d8654df6d599b319a4fe2ee079cfe3b48e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:49:02 +0200
Subject: [PATCH 1768/4023] Assert order

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 501ca321e85..f968981974e 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -103,6 +103,8 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
     public function test_fixtureFlatMain_ordering()
     {
         $pages = $this->setUpFixture($this->fixtureFlatMain());
+
+        $this->assertOrder($pages, ['home', 'about', 'contact']);
     }
 
     protected function setUpFixture(array $files): array

From 31841599970a3190aa3dcbcfd26aea6b6edd2eb1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:49:17 +0200
Subject: [PATCH 1769/4023] Remove unused parameter

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php   | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index f968981974e..8d20432f4d0 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -104,7 +104,7 @@ public function test_fixtureFlatMain_ordering()
     {
         $pages = $this->setUpFixture($this->fixtureFlatMain());
 
-        $this->assertOrder($pages, ['home', 'about', 'contact']);
+        $this->assertOrder(['home', 'about', 'contact']);
     }
 
     protected function setUpFixture(array $files): array
@@ -119,10 +119,9 @@ protected function setUpFixture(array $files): array
     }
 
     /**
-     * @param array<\Hyde\Pages\Concerns\HydePage> $pages
      * @param array<string> $expected
      */
-    protected function assertOrder(array $pages, array $expected): void
+    protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
         $actual = $menu->getItems()->map(fn (NavigationItem $item) => $item->getPage()->getRouteKey())->all();

From 7a8f478cfd8a0335a43027ebc670549d5137ce92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:49:30 +0200
Subject: [PATCH 1770/4023] Fix formatting

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 8d20432f4d0..7b7fc5e2558 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -118,9 +118,7 @@ protected function setUpFixture(array $files): array
         return MarkdownPage::all()->all();
     }
 
-    /**
-     * @param array<string> $expected
-     */
+    /** @param array<string> $expected */
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);

From 0102377e14268830b4cdebd99caa01a593cdbed4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:52:36 +0200
Subject: [PATCH 1771/4023] Remove unused variable

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 7b7fc5e2558..de5a37cfb4f 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -102,7 +102,7 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
 
     public function test_fixtureFlatMain_ordering()
     {
-        $pages = $this->setUpFixture($this->fixtureFlatMain());
+        $this->setUpFixture($this->fixtureFlatMain());
 
         $this->assertOrder(['home', 'about', 'contact']);
     }

From 9ae4ebd367d14d52e1d3787c149ee52b09c5a354 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:53:53 +0200
Subject: [PATCH 1772/4023] Test the reverse order

---
 .../Feature/FilenamePrefixNavigationPriorityTest.php      | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index de5a37cfb4f..58b2a02a45f 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -107,6 +107,14 @@ public function test_fixtureFlatMain_ordering()
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
+    public function test_fixtureFlatMain_reverse_ordering()
+    {
+        // This is just a sanity check to make sure the helper is working, so we only need one of these.
+        $this->setUpFixture(array_reverse($this->fixtureFlatMain()));
+
+        $this->assertOrder(['home', 'about', 'contact']);
+    }
+
     protected function setUpFixture(array $files): array
     {
         foreach ($files as $file) {

From f9290c0f63fb2ae9bdd4288a2e8e0883bd5569f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:54:11 +0200
Subject: [PATCH 1773/4023] Return this instead of array

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 58b2a02a45f..750c5d85106 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -115,7 +115,7 @@ public function test_fixtureFlatMain_reverse_ordering()
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
-    protected function setUpFixture(array $files): array
+    protected function setUpFixture(array $files): self
     {
         foreach ($files as $file) {
             $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
@@ -123,7 +123,7 @@ protected function setUpFixture(array $files): array
             Hyde::routes()->addRoute($page->getRoute());
         }
 
-        return MarkdownPage::all()->all();
+        return $this;
     }
 
     /** @param array<string> $expected */

From b08bc08e34be5851b5e9ced8e57af5fc9d4bfd9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 13:58:32 +0200
Subject: [PATCH 1774/4023] Add todo

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 750c5d85106..a1c10dbf8e5 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -22,6 +22,8 @@
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
+ *
+ * Todo: Add test to ensure explicitly set priority overrides filename prefix.
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
 {

From b61d82175c64415bc1e520d0d1a978dbf977a86c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 16:59:34 +0200
Subject: [PATCH 1775/4023] Draft new helper to check file prefix for priority

---
 .../src/Framework/Factories/NavigationDataFactory.php       | 6 ++++++
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php  | 1 +
 2 files changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index b7d4b905faf..ee1821b1a36 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -97,6 +97,7 @@ protected function makePriority(): int
     {
         return $this->searchForPriorityInFrontMatter()
             ?? $this->searchForPriorityInConfigs()
+            ?? $this->checkFilePrefixForOrder()
             ?? NavigationMenu::LAST;
     }
 
@@ -239,6 +240,11 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
         return $config[$pageKey] ?? null;
     }
 
+    private function checkFilePrefixForOrder(): ?int
+    {
+        return null;
+    }
+
     private function canUseSubdirectoryForGroups(): bool
     {
         return $this->getSubdirectoryConfiguration() === 'dropdown'
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index a1c10dbf8e5..793e600e66d 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -21,6 +21,7 @@
  * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
+ * @covers \Hyde\Framework\Factories\NavigationDataFactory // Todo: Update the unit test for this class.
  * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
  *
  * Todo: Add test to ensure explicitly set priority overrides filename prefix.

From a2fce9285cb23f3c26ac5e926632c51829bf9135 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:00:19 +0200
Subject: [PATCH 1776/4023] Early return to null when not enabled

---
 .../src/Framework/Factories/NavigationDataFactory.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index ee1821b1a36..40a09efe8d2 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -12,6 +12,7 @@
 use Hyde\Framework\Factories\Concerns\CoreDataObject;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\NavigationSchema;
+use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
 use function basename;
 use function array_flip;
@@ -242,6 +243,10 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
 
     private function checkFilePrefixForOrder(): ?int
     {
+        if (! FilenamePrefixNavigationHelper::enabled()) {
+            return null;
+        }
+
         return null;
     }
 

From 78c486f7af7cfe6e56ec18a7a22b8ee01fa90536 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:00:49 +0200
Subject: [PATCH 1777/4023] Early return to null when not numbered

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 40a09efe8d2..f9fadff17ec 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -247,6 +247,10 @@ private function checkFilePrefixForOrder(): ?int
             return null;
         }
 
+        if (! FilenamePrefixNavigationHelper::isIdentifierNumbered($this->identifier)) {
+            return null;
+        }
+
         return null;
     }
 

From 9853fce5e11880ac90c9a271f29854d34d2901a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:01:29 +0200
Subject: [PATCH 1778/4023] Return the parsed number

---
 .../framework/src/Framework/Factories/NavigationDataFactory.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index f9fadff17ec..42679f3d1cc 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -251,7 +251,7 @@ private function checkFilePrefixForOrder(): ?int
             return null;
         }
 
-        return null;
+        return FilenamePrefixNavigationHelper::splitNumberAndIdentifier($this->identifier)[0];
     }
 
     private function canUseSubdirectoryForGroups(): bool

From 5b3a7dd6e8a15eaa174315dccebf339648e4eedd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:38:29 +0200
Subject: [PATCH 1779/4023] Set dropdown config setting for test

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 793e600e66d..c6a7bb8d5e9 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -32,6 +32,8 @@ protected function setUp(): void
     {
         parent::setUp();
 
+        Config::set('hyde.navigation.subdirectories', 'dropdown');
+
         // Todo: Replace kernel with mock class
         $this->withoutDefaultPages();
     }

From 4c1d886dca6f58a3cd1cb84a01c1fff4dbc7c822 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:38:44 +0200
Subject: [PATCH 1780/4023] Create subpages when setting up the fixture

---
 .../FilenamePrefixNavigationPriorityTest.php    | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index c6a7bb8d5e9..fc47b1378a4 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -122,10 +122,19 @@ public function test_fixtureFlatMain_reverse_ordering()
 
     protected function setUpFixture(array $files): self
     {
-        foreach ($files as $file) {
-            $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
-            Hyde::pages()->addPage($page);
-            Hyde::routes()->addRoute($page->getRoute());
+        foreach ($files as $key => $file) {
+            if (is_string($file)) {
+                $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                Hyde::pages()->addPage($page);
+                Hyde::routes()->addRoute($page->getRoute());
+            } else {
+                foreach ($file as $child) {
+                    $group = str($key)->after('-');
+                    $page = new MarkdownPage($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                    Hyde::pages()->addPage($page);
+                    Hyde::routes()->addRoute($page->getRoute());
+                }
+            }
         }
 
         return $this;

From 12d5b7455f8311cb772a9d5384ac4697481dab21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:52:19 +0200
Subject: [PATCH 1781/4023] Convert the arrow function to a traditional closure

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index fc47b1378a4..4eb58132244 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -144,7 +144,9 @@ protected function setUpFixture(array $files): self
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
-        $actual = $menu->getItems()->map(fn (NavigationItem $item) => $item->getPage()->getRouteKey())->all();
+        $actual = $menu->getItems()->map(function (NavigationItem $item) {
+            return $item->getPage()->getRouteKey();
+        })->all();
 
         $this->assertSame($expected, $actual);
     }

From 9c3fd646ad4cb49443ac5879d56a1cadf0912ee9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:53:36 +0200
Subject: [PATCH 1782/4023] Handle groups when creating comparison structure

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 4eb58132244..2ac28e8b36b 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -9,6 +9,7 @@
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
@@ -144,7 +145,10 @@ protected function setUpFixture(array $files): self
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
-        $actual = $menu->getItems()->map(function (NavigationItem $item) {
+        $actual = $menu->getItems()->map(function (NavigationItem|NavigationGroup $item) {
+            if ($item instanceof NavigationGroup) {
+                return $item->getItems()->map(fn ($item) => $item->getPage()->getRouteKey())->all();
+            }
             return $item->getPage()->getRouteKey();
         })->all();
 

From c5aaa2f9824563efb2b45d2a54452696613c7834 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:56:22 +0200
Subject: [PATCH 1783/4023] Add helper to check if identifier is nested

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index e9059d2f344..08e2b3bca48 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -48,4 +48,9 @@ public static function splitNumberAndIdentifier(string $identifier): array
 
         return $parts;
     }
+
+    protected static function isIdentifierNested(string $identifier): bool
+    {
+        return str_contains($identifier, '/');
+    }
 }

From 21e2dc7b9e4be63ba46d388d4feb20b73605fc6e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:57:28 +0200
Subject: [PATCH 1784/4023] Add helper to get core part of identifier

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 08e2b3bca48..df3d1fe34a4 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -53,4 +53,11 @@ protected static function isIdentifierNested(string $identifier): bool
     {
         return str_contains($identifier, '/');
     }
+
+    protected static function getCoreIdentifierPart(string $identifier): string
+    {
+        assert(self::isIdentifierNested($identifier));
+
+        return explode('/', $identifier)[1];
+    }
 }

From 293463054dd7d12a44b5e1a025bd7b4c9ab05d93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:58:09 +0200
Subject: [PATCH 1785/4023] Add helper to get nested identifier prefix

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index df3d1fe34a4..89e19354a69 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -60,4 +60,11 @@ protected static function getCoreIdentifierPart(string $identifier): string
 
         return explode('/', $identifier)[1];
     }
+
+    protected static function getNestedIdentifierPrefix(string $identifier): string
+    {
+        assert(self::isIdentifierNested($identifier));
+
+        return explode('/', $identifier)[0];
+    }
 }

From ef05a5260212327b0db52df86e7ac2ffb7a41123 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:58:25 +0200
Subject: [PATCH 1786/4023] Test parsing for nested identifiers

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index d614b73f735..c0d081441d4 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -63,4 +63,25 @@ public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNu
 
         FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
     }
+
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'));
+    }
+
+    public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForNestedPages()
+    {
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
+    }
 }

From abadc4fbc5686fa1eb1c76b0cc9d4ea5692c0967 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:59:02 +0200
Subject: [PATCH 1787/4023] Test parsing for deeply nested identifiers

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index c0d081441d4..f4b48df55c9 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -84,4 +84,25 @@ public function testSplitNumberAndIdentifierForNestedPages()
         $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'));
         $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
     }
+
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForDeeplyNestedPages()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'));
+    }
 }

From a0d8de5705ec1f48d04af4cb01506eb1de6d4857 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 17:59:51 +0200
Subject: [PATCH 1788/4023] Get core identifier part when nested

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 89e19354a69..d0f5b68b108 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -30,6 +30,10 @@ public static function enabled(): bool
      */
     public static function isIdentifierNumbered(string $identifier): bool
     {
+        if (self::isIdentifierNested($identifier)) {
+            $identifier = self::getCoreIdentifierPart($identifier);
+        }
+
         return preg_match('/^\d+-/', $identifier) === 1;
     }
 

From daf674c20db067d304b6aa05c91ee4a67e9473de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:03:10 +0200
Subject: [PATCH 1789/4023] If identifier is nested then split out its parts

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index d0f5b68b108..9621e6e6034 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -44,6 +44,11 @@ public static function isIdentifierNumbered(string $identifier): bool
      */
     public static function splitNumberAndIdentifier(string $identifier): array
     {
+        if (self::isIdentifierNested($identifier)) {
+            $parentPath = self::getNestedIdentifierPrefix($identifier);
+            $identifier = self::getCoreIdentifierPart($identifier);
+        }
+
         assert(self::isIdentifierNumbered($identifier));
 
         $parts = explode('-', $identifier, 2);

From 414c328d171f5f165f6b7ee74dd3f222c2c62573 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:03:21 +0200
Subject: [PATCH 1790/4023] Reassemble identifier when split

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 9621e6e6034..34fcafa482c 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -55,6 +55,10 @@ public static function splitNumberAndIdentifier(string $identifier): array
 
         $parts[0] = (int) $parts[0];
 
+        if (isset($parentPath)) {
+            $parts[1] = $parentPath . '/' . $parts[1];
+        }
+
         return $parts;
     }
 

From 468caac4ae265adba47ff82e390383069dc344cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:05:56 +0200
Subject: [PATCH 1791/4023] Properly support nested identifiers

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 34fcafa482c..a45b781d001 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Facades\Config;
+use Illuminate\Support\Str;
 
 use function assert;
 use function explode;
@@ -71,13 +72,13 @@ protected static function getCoreIdentifierPart(string $identifier): string
     {
         assert(self::isIdentifierNested($identifier));
 
-        return explode('/', $identifier)[1];
+        return Str::afterLast($identifier, '/');
     }
 
     protected static function getNestedIdentifierPrefix(string $identifier): string
     {
         assert(self::isIdentifierNested($identifier));
 
-        return explode('/', $identifier)[0];
+        return Str::beforeLast($identifier, '/');
     }
 }

From 888902cf2962690b633377d9fe399b302488f4a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:06:21 +0200
Subject: [PATCH 1792/4023] Swap method order for more logical class structure

---
 .../Navigation/FilenamePrefixNavigationHelper.php         | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index a45b781d001..f957ddf6ca1 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -68,17 +68,17 @@ protected static function isIdentifierNested(string $identifier): bool
         return str_contains($identifier, '/');
     }
 
-    protected static function getCoreIdentifierPart(string $identifier): string
+    protected static function getNestedIdentifierPrefix(string $identifier): string
     {
         assert(self::isIdentifierNested($identifier));
 
-        return Str::afterLast($identifier, '/');
+        return Str::beforeLast($identifier, '/');
     }
 
-    protected static function getNestedIdentifierPrefix(string $identifier): string
+    protected static function getCoreIdentifierPart(string $identifier): string
     {
         assert(self::isIdentifierNested($identifier));
 
-        return Str::beforeLast($identifier, '/');
+        return Str::afterLast($identifier, '/');
     }
 }

From 9bcb09f5b8f997aed5e72662304e01062209bdcf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:07:28 +0200
Subject: [PATCH 1793/4023] Add crosslink annotations between related tests

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 ++
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php     | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 2ac28e8b36b..e3d374569fb 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -25,6 +25,8 @@
  * @covers \Hyde\Framework\Factories\NavigationDataFactory // Todo: Update the unit test for this class.
  * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
  *
+ * @see \Hyde\Framework\Testing\Unit\FilenamePrefixNavigationPriorityUnitTest
+ *
  * Todo: Add test to ensure explicitly set priority overrides filename prefix.
  */
 class FilenamePrefixNavigationPriorityTest extends TestCase
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index f4b48df55c9..561c9f00e96 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -9,6 +9,8 @@
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
+ *
+ * @see \Hyde\Framework\Testing\Feature\FilenamePrefixNavigationPriorityTest
  */
 class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
 {

From 8a1bfe945690bca5e78340d08808e5ecf178f925 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Wed, 1 May 2024 16:07:39 +0000
Subject: [PATCH 1794/4023] Apply fixes from StyleCI

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php      | 2 +-
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index f957ddf6ca1..6e7dd12aba2 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -57,7 +57,7 @@ public static function splitNumberAndIdentifier(string $identifier): array
         $parts[0] = (int) $parts[0];
 
         if (isset($parentPath)) {
-            $parts[1] = $parentPath . '/' . $parts[1];
+            $parts[1] = $parentPath.'/'.$parts[1];
         }
 
         return $parts;
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index e3d374569fb..9bb28853fac 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -151,6 +151,7 @@ protected function assertOrder(array $expected): void
             if ($item instanceof NavigationGroup) {
                 return $item->getItems()->map(fn ($item) => $item->getPage()->getRouteKey())->all();
             }
+
             return $item->getPage()->getRouteKey();
         })->all();
 

From 8e929965574a853d0c91a3f744a466579d25b223 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:18:01 +0200
Subject: [PATCH 1795/4023] Map with keys

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 9bb28853fac..3b5bac557d6 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -147,12 +147,12 @@ protected function setUpFixture(array $files): self
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
-        $actual = $menu->getItems()->map(function (NavigationItem|NavigationGroup $item) {
+        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) {
             if ($item instanceof NavigationGroup) {
-                return $item->getItems()->map(fn ($item) => $item->getPage()->getRouteKey())->all();
+                return [$item->getGroupKey() => $item->getItems()->map(fn ($item) => $item->getPage()->getRouteKey())->all()];
             }
 
-            return $item->getPage()->getRouteKey();
+            return [$key => $item->getPage()->getRouteKey()];
         })->all();
 
         $this->assertSame($expected, $actual);

From f25f53bfa638947221db9c55bdf94dc091463c7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:18:34 +0200
Subject: [PATCH 1796/4023] Convert the arrow function to a traditional closure

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 3b5bac557d6..171fac76c63 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -149,7 +149,9 @@ protected function assertOrder(array $expected): void
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
         $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) {
             if ($item instanceof NavigationGroup) {
-                return [$item->getGroupKey() => $item->getItems()->map(fn ($item) => $item->getPage()->getRouteKey())->all()];
+                return [$item->getGroupKey() => $item->getItems()->map(function ($item) {
+                    return $item->getPage()->getRouteKey();
+                })->all()];
             }
 
             return [$key => $item->getPage()->getRouteKey()];

From a326e027754df1e3f433bb4404c3acac0570c1b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:19:29 +0200
Subject: [PATCH 1797/4023] Get only core part for comparison

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 171fac76c63..a6e04a26394 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
@@ -150,7 +151,7 @@ protected function assertOrder(array $expected): void
         $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) {
             if ($item instanceof NavigationGroup) {
                 return [$item->getGroupKey() => $item->getItems()->map(function ($item) {
-                    return $item->getPage()->getRouteKey();
+                    return Str::afterLast($item->getPage()->getRouteKey(), '/');
                 })->all()];
             }
 

From c5ab6b8d2271514d17b45fbeebc0dedfa4f51c09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:19:47 +0200
Subject: [PATCH 1798/4023] Use basename function

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index a6e04a26394..ec76706c7b1 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
-use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
@@ -151,7 +150,7 @@ protected function assertOrder(array $expected): void
         $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) {
             if ($item instanceof NavigationGroup) {
                 return [$item->getGroupKey() => $item->getItems()->map(function ($item) {
-                    return Str::afterLast($item->getPage()->getRouteKey(), '/');
+                    return basename($item->getPage()->getRouteKey());
                 })->all()];
             }
 

From 8c642945dd23f9daa5ea95f72b12c3e157ade328 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:20:33 +0200
Subject: [PATCH 1799/4023] Add closure types

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index ec76706c7b1..26c3fa92db6 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -147,9 +147,9 @@ protected function setUpFixture(array $files): self
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
-        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) {
+        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key): array {
             if ($item instanceof NavigationGroup) {
-                return [$item->getGroupKey() => $item->getItems()->map(function ($item) {
+                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item): string {
                     return basename($item->getPage()->getRouteKey());
                 })->all()];
             }

From 3d09881475852078ff3316201fb5dbd993c146f7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:21:00 +0200
Subject: [PATCH 1800/4023] Add a newline

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 26c3fa92db6..fd6699386a7 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -147,6 +147,7 @@ protected function setUpFixture(array $files): self
     protected function assertOrder(array $expected): void
     {
         $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
+
         $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key): array {
             if ($item instanceof NavigationGroup) {
                 return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item): string {

From 43bc4954c1fcc99a75e7216bc3ea6aeaa139253c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:21:25 +0200
Subject: [PATCH 1801/4023] Test grouped menu ordering

---
 .../Feature/FilenamePrefixNavigationPriorityTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index fd6699386a7..1119a0aa20f 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -123,6 +123,15 @@ public function test_fixtureFlatMain_reverse_ordering()
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
+    public function test_fixtureGroupedMain_ordering()
+    {
+        $this->setUpFixture($this->fixtureGroupedMain());
+
+        $this->assertOrder(['home', 'about', 'contact', 'api' => [
+            'readme', 'installation', 'getting-started',
+        ]]);
+    }
+
     protected function setUpFixture(array $files): self
     {
         foreach ($files as $key => $file) {

From ead9d9584f05a78aeb8fc406be642ad59bb225d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:43:32 +0200
Subject: [PATCH 1802/4023] Fix testing helper visibility

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 1119a0aa20f..f3c4db04688 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -240,7 +240,7 @@ protected function fixturePrefixSyntaxes(): array
         ];
     }
 
-    public function fixtureFileExtensions(): array
+    protected function fixtureFileExtensions(): array
     {
         return [
             '01-foo.md',

From 543cd9fe6ed79dd7fd378e86ac2e26480564b044 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:44:50 +0200
Subject: [PATCH 1803/4023] Add recursive array reverser

---
 .../FilenamePrefixNavigationPriorityTest.php        | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index f3c4db04688..acbd1eebd18 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -248,4 +248,17 @@ protected function fixtureFileExtensions(): array
             '03-baz.blade.php',
         ];
     }
+
+    protected function arrayReverseRecursive(array $array): array
+    {
+        $reversed = array_reverse($array);
+
+        foreach ($reversed as $key => $value) {
+            if (is_array($value)) {
+                $reversed[$key] = $this->arrayReverseRecursive($value);
+            }
+        }
+
+        return $reversed;
+    }
 }

From 16a8c6a2409e2fa9fae5b804d5f22a84f71a7194 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:46:23 +0200
Subject: [PATCH 1804/4023] Test reverse ordering for grouped fixture

---
 .../Feature/FilenamePrefixNavigationPriorityTest.php   | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index acbd1eebd18..1a3cb14fa3a 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -132,6 +132,16 @@ public function test_fixtureGroupedMain_ordering()
         ]]);
     }
 
+    public function test_fixtureGroupedMain_reverse_ordering()
+    {
+        // Also a sanity check but for the inner group as well.
+        $this->setUpFixture($this->arrayReverseRecursive($this->fixtureGroupedMain()));
+
+        $this->assertOrder(['home', 'about', 'contact', 'api' => [
+            'readme', 'installation', 'getting-started',
+        ]]);
+    }
+
     protected function setUpFixture(array $files): self
     {
         foreach ($files as $key => $file) {

From c2e47451ba18ef5ac6d8d164725ec11fb356da10 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:57:39 +0200
Subject: [PATCH 1805/4023] Generate base sidebar tests

---
 .../FilenamePrefixNavigationPriorityTest.php   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 1a3cb14fa3a..0121d1bea5d 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -142,6 +142,24 @@ public function test_fixtureGroupedMain_reverse_ordering()
         ]]);
     }
 
+    public function test_fixtureFlatSidebar_ordering()
+    {
+        $this->setUpFixture($this->fixtureFlatSidebar());
+
+        $this->assertOrder(['readme', 'installation', 'getting-started']);
+    }
+
+    public function test_fixtureGroupedSidebar_ordering()
+    {
+        $this->setUpFixture($this->fixtureGroupedSidebar());
+
+        $this->assertOrder(['readme', 'installation', 'getting-started', 'introduction' => [
+            'features', 'extensions', 'configuration',
+        ], 'advanced' => [
+            'features', 'extensions', 'configuration',
+        ]]);
+    }
+
     protected function setUpFixture(array $files): self
     {
         foreach ($files as $key => $file) {

From b548bf39da16c0bb79434b64075d57d449e325b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 18:59:12 +0200
Subject: [PATCH 1806/4023] Create scaffolding to test sidebar orders

---
 .../FilenamePrefixNavigationPriorityTest.php  | 43 +++++++++++++------
 1 file changed, 30 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 0121d1bea5d..286251964c1 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -7,10 +7,13 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
@@ -144,33 +147,39 @@ public function test_fixtureGroupedMain_reverse_ordering()
 
     public function test_fixtureFlatSidebar_ordering()
     {
-        $this->setUpFixture($this->fixtureFlatSidebar());
+        $this->setUpSidebarFixture($this->fixtureFlatSidebar());
 
-        $this->assertOrder(['readme', 'installation', 'getting-started']);
+        $this->assertSidebarOrder(['readme', 'installation', 'getting-started']);
     }
 
     public function test_fixtureGroupedSidebar_ordering()
     {
-        $this->setUpFixture($this->fixtureGroupedSidebar());
+        $this->setUpSidebarFixture($this->fixtureGroupedSidebar());
 
-        $this->assertOrder(['readme', 'installation', 'getting-started', 'introduction' => [
+        $this->assertSidebarOrder(['readme', 'installation', 'getting-started', 'introduction' => [
             'features', 'extensions', 'configuration',
         ], 'advanced' => [
             'features', 'extensions', 'configuration',
         ]]);
     }
 
-    protected function setUpFixture(array $files): self
+    protected function setUpSidebarFixture(array $files): self
+    {
+        return $this->setUpFixture($files, sidebar: true);
+    }
+
+    protected function setUpFixture(array $files, bool $sidebar = false): self
     {
         foreach ($files as $key => $file) {
+            $class = $sidebar ? DocumentationPage::class : MarkdownPage::class;
             if (is_string($file)) {
-                $page = new MarkdownPage(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                $page = new $class(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
                 Hyde::pages()->addPage($page);
                 Hyde::routes()->addRoute($page->getRoute());
             } else {
                 foreach ($file as $child) {
                     $group = str($key)->after('-');
-                    $page = new MarkdownPage($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                    $page = new $class($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
                     Hyde::pages()->addPage($page);
                     Hyde::routes()->addRoute($page->getRoute());
                 }
@@ -180,19 +189,27 @@ protected function setUpFixture(array $files): self
         return $this;
     }
 
+    protected function assertSidebarOrder(array $expected): void
+    {
+        $this->assertOrder($expected, sidebar: true);
+    }
+
     /** @param array<string> $expected */
-    protected function assertOrder(array $expected): void
+    protected function assertOrder(array $expected, bool $sidebar = false): void
     {
-        $menu = NavigationMenuGenerator::handle(MainNavigationMenu::class);
+        $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;
+        $menu = NavigationMenuGenerator::handle($type);
+
+        $formatRouteKey = fn (string $routeKey): string => $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
 
-        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key): array {
+        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) use ($formatRouteKey): array {
             if ($item instanceof NavigationGroup) {
-                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item): string {
-                    return basename($item->getPage()->getRouteKey());
+                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item) use ($formatRouteKey): string {
+                    return basename($formatRouteKey($item->getPage()->getRouteKey()));
                 })->all()];
             }
 
-            return [$key => $item->getPage()->getRouteKey()];
+            return [$key => $formatRouteKey($item->getPage()->getRouteKey())];
         })->all();
 
         $this->assertSame($expected, $actual);

From 1f5fb15f11616ded6d2384438253c31473a4bcf6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 20:59:51 +0200
Subject: [PATCH 1807/4023] Fix duplicated fixture data

Not allowed when using flattened output paths
---
 .../Feature/FilenamePrefixNavigationPriorityTest.php      | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 286251964c1..6f4a4cdff44 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -157,7 +157,7 @@ public function test_fixtureGroupedSidebar_ordering()
         $this->setUpSidebarFixture($this->fixtureGroupedSidebar());
 
         $this->assertSidebarOrder(['readme', 'installation', 'getting-started', 'introduction' => [
-            'features', 'extensions', 'configuration',
+            'general', 'resources', 'requirements',
         ], 'advanced' => [
             'features', 'extensions', 'configuration',
         ]]);
@@ -254,9 +254,9 @@ protected function fixtureGroupedSidebar(): array
             '02-installation.md',
             '03-getting-started.md',
             '04-introduction' => [
-                '01-features.md',
-                '02-extensions.md',
-                '03-configuration.md',
+                '01-general.md',
+                '02-resources.md',
+                '03-requirements.md',
             ],
             '05-advanced' => [
                 '01-features.md',

From 306b33619f81ba9a19c650b43c1f84a9d068c8b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 21:01:20 +0200
Subject: [PATCH 1808/4023] Expect other pages to be in other group

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 6f4a4cdff44..7531017af89 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -156,7 +156,8 @@ public function test_fixtureGroupedSidebar_ordering()
     {
         $this->setUpSidebarFixture($this->fixtureGroupedSidebar());
 
-        $this->assertSidebarOrder(['readme', 'installation', 'getting-started', 'introduction' => [
+        $this->assertSidebarOrder(['other' => ['readme', 'installation', 'getting-started'],
+        'introduction' => [
             'general', 'resources', 'requirements',
         ], 'advanced' => [
             'features', 'extensions', 'configuration',

From 2f82b49dd4711adff10580a1e44636e772826f9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 21:01:45 +0200
Subject: [PATCH 1809/4023] Reformat array

---
 .../Feature/FilenamePrefixNavigationPriorityTest.php  | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 7531017af89..25898803f61 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -156,12 +156,11 @@ public function test_fixtureGroupedSidebar_ordering()
     {
         $this->setUpSidebarFixture($this->fixtureGroupedSidebar());
 
-        $this->assertSidebarOrder(['other' => ['readme', 'installation', 'getting-started'],
-        'introduction' => [
-            'general', 'resources', 'requirements',
-        ], 'advanced' => [
-            'features', 'extensions', 'configuration',
-        ]]);
+        $this->assertSidebarOrder([
+            'other' => ['readme', 'installation', 'getting-started'],
+            'introduction' => ['general', 'resources', 'requirements'],
+            'advanced' => ['features', 'extensions', 'configuration'],
+        ]);
     }
 
     protected function setUpSidebarFixture(array $files): self

From 8c181f26c8d6aa445fbcf30f2127e76cdddbc98d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 1 May 2024 21:08:29 +0200
Subject: [PATCH 1810/4023] Update documentation page route key formatting to
 use normalized parent

This should generally have the same semantics, however, it allows us to use the numbering prefix normalization provided by https://github.com/hydephp/develop/pull/1709
---
 packages/framework/src/Pages/DocumentationPage.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index 6ca14b5b9b8..db95989e938 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -70,7 +70,7 @@ public function getTableOfContents(): string
     public function getRouteKey(): string
     {
         return Config::getBool('docs.flattened_output_paths', true)
-            ? unslash(static::outputDirectory().'/'.basename($this->identifier))
+            ? unslash(static::outputDirectory().'/'.basename(parent::getRouteKey()))
             : parent::getRouteKey();
     }
 

From 87af9b74afd6508b39ab8fe8f491547cc637a422 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 11:58:44 +0200
Subject: [PATCH 1811/4023] Extract testing helper class for complex testing
 helper methods

---
 .../FilenamePrefixNavigationPriorityTest.php  | 80 ++++++++++++-------
 1 file changed, 51 insertions(+), 29 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 25898803f61..d27d9284cd4 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -38,6 +38,8 @@ protected function setUp(): void
     {
         parent::setUp();
 
+        $this->helper = new FilenamePrefixNavigationPriorityTestingHelper($this);
+
         Config::set('hyde.navigation.subdirectories', 'dropdown');
 
         // Todo: Replace kernel with mock class
@@ -170,21 +172,7 @@ protected function setUpSidebarFixture(array $files): self
 
     protected function setUpFixture(array $files, bool $sidebar = false): self
     {
-        foreach ($files as $key => $file) {
-            $class = $sidebar ? DocumentationPage::class : MarkdownPage::class;
-            if (is_string($file)) {
-                $page = new $class(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
-                Hyde::pages()->addPage($page);
-                Hyde::routes()->addRoute($page->getRoute());
-            } else {
-                foreach ($file as $child) {
-                    $group = str($key)->after('-');
-                    $page = new $class($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
-                    Hyde::pages()->addPage($page);
-                    Hyde::routes()->addRoute($page->getRoute());
-                }
-            }
-        }
+        $this->helper->setUpFixture($files, $sidebar);
 
         return $this;
     }
@@ -197,20 +185,7 @@ protected function assertSidebarOrder(array $expected): void
     /** @param array<string> $expected */
     protected function assertOrder(array $expected, bool $sidebar = false): void
     {
-        $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;
-        $menu = NavigationMenuGenerator::handle($type);
-
-        $formatRouteKey = fn (string $routeKey): string => $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
-
-        $actual = $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) use ($formatRouteKey): array {
-            if ($item instanceof NavigationGroup) {
-                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item) use ($formatRouteKey): string {
-                    return basename($formatRouteKey($item->getPage()->getRouteKey()));
-                })->all()];
-            }
-
-            return [$key => $formatRouteKey($item->getPage()->getRouteKey())];
-        })->all();
+        $actual = $this->helper->createComparisonFormat($sidebar);
 
         $this->assertSame($expected, $actual);
     }
@@ -307,3 +282,50 @@ protected function arrayReverseRecursive(array $array): array
         return $reversed;
     }
 }
+
+class FilenamePrefixNavigationPriorityTestingHelper
+{
+    protected FilenamePrefixNavigationPriorityTest $test;
+
+    public function __construct(FilenamePrefixNavigationPriorityTest $test)
+    {
+        $this->test = $test;
+    }
+
+    public function setUpFixture(array $files, bool $sidebar = false): void
+    {
+        foreach ($files as $key => $file) {
+            $class = $sidebar ? DocumentationPage::class : MarkdownPage::class;
+            if (is_string($file)) {
+                $page = new $class(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                Hyde::pages()->addPage($page);
+                Hyde::routes()->addRoute($page->getRoute());
+            } else {
+                foreach ($file as $child) {
+                    $group = str($key)->after('-');
+                    $page = new $class($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
+                    Hyde::pages()->addPage($page);
+                    Hyde::routes()->addRoute($page->getRoute());
+                }
+            }
+        }
+    }
+
+    public function createComparisonFormat(bool $sidebar): array
+    {
+        $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;
+        $menu = NavigationMenuGenerator::handle($type);
+
+        $formatRouteKey = fn (string $routeKey): string => $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
+
+        return $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) use ($formatRouteKey): array {
+            if ($item instanceof NavigationGroup) {
+                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item) use ($formatRouteKey): string {
+                    return basename($formatRouteKey($item->getPage()->getRouteKey()));
+                })->all()];
+            }
+
+            return [$key => $formatRouteKey($item->getPage()->getRouteKey())];
+        })->all();
+    }
+}

From 401063295fc2fe30b201e164684d0f54cc30421d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 12:07:34 +0200
Subject: [PATCH 1812/4023] Refactor and clean up testing helpers

---
 .../FilenamePrefixNavigationPriorityTest.php  | 26 ++++++++++++-------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index d27d9284cd4..c6a3af1051a 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -182,7 +182,6 @@ protected function assertSidebarOrder(array $expected): void
         $this->assertOrder($expected, sidebar: true);
     }
 
-    /** @param array<string> $expected */
     protected function assertOrder(array $expected, bool $sidebar = false): void
     {
         $actual = $this->helper->createComparisonFormat($sidebar);
@@ -316,16 +315,25 @@ public function createComparisonFormat(bool $sidebar): array
         $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;
         $menu = NavigationMenuGenerator::handle($type);
 
-        $formatRouteKey = fn (string $routeKey): string => $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
+        return $this->mapItemsToStrings($menu, $sidebar)->all();
+    }
 
-        return $menu->getItems()->mapWithKeys(function (NavigationItem|NavigationGroup $item, int $key) use ($formatRouteKey): array {
-            if ($item instanceof NavigationGroup) {
-                return [$item->getGroupKey() => $item->getItems()->map(function (NavigationItem $item) use ($formatRouteKey): string {
-                    return basename($formatRouteKey($item->getPage()->getRouteKey()));
-                })->all()];
-            }
+    protected function mapItemsToStrings(MainNavigationMenu|DocumentationSidebar $menu, bool $sidebar)
+    {
+        return $menu->getItems()->mapWithKeys(fn ($item, $key) => $item instanceof NavigationItem
+            ? [$key => $this->formatRouteKey($item->getPage()->getRouteKey(), $sidebar)]
+            : [$item->getGroupKey() => $this->mapChildItems($item, $sidebar)]);
+    }
 
-            return [$key => $formatRouteKey($item->getPage()->getRouteKey())];
+    protected function mapChildItems(NavigationGroup $item, bool $sidebar)
+    {
+        return $item->getItems()->map(function (NavigationItem $item) use ($sidebar) {
+            return basename($this->formatRouteKey($item->getPage()->getRouteKey(), $sidebar));
         })->all();
     }
+
+    protected function formatRouteKey(string $routeKey, bool $sidebar): string
+    {
+        return $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
+    }
 }

From f00a66e337dfbe4e64a28831afc7fbff741ce08b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 12:15:58 +0200
Subject: [PATCH 1813/4023] Refactor testing helpers

---
 .../FilenamePrefixNavigationPriorityTest.php  | 54 ++++++++++++-------
 1 file changed, 34 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index c6a3af1051a..66147c35fb5 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -115,7 +115,7 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
 
     public function test_fixtureFlatMain_ordering()
     {
-        $this->setUpFixture($this->fixtureFlatMain());
+        $this->setupFixture($this->fixtureFlatMain());
 
         $this->assertOrder(['home', 'about', 'contact']);
     }
@@ -123,14 +123,14 @@ public function test_fixtureFlatMain_ordering()
     public function test_fixtureFlatMain_reverse_ordering()
     {
         // This is just a sanity check to make sure the helper is working, so we only need one of these.
-        $this->setUpFixture(array_reverse($this->fixtureFlatMain()));
+        $this->setupFixture(array_reverse($this->fixtureFlatMain()));
 
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
     public function test_fixtureGroupedMain_ordering()
     {
-        $this->setUpFixture($this->fixtureGroupedMain());
+        $this->setupFixture($this->fixtureGroupedMain());
 
         $this->assertOrder(['home', 'about', 'contact', 'api' => [
             'readme', 'installation', 'getting-started',
@@ -140,7 +140,7 @@ public function test_fixtureGroupedMain_ordering()
     public function test_fixtureGroupedMain_reverse_ordering()
     {
         // Also a sanity check but for the inner group as well.
-        $this->setUpFixture($this->arrayReverseRecursive($this->fixtureGroupedMain()));
+        $this->setupFixture($this->arrayReverseRecursive($this->fixtureGroupedMain()));
 
         $this->assertOrder(['home', 'about', 'contact', 'api' => [
             'readme', 'installation', 'getting-started',
@@ -167,12 +167,12 @@ public function test_fixtureGroupedSidebar_ordering()
 
     protected function setUpSidebarFixture(array $files): self
     {
-        return $this->setUpFixture($files, sidebar: true);
+        return $this->setupFixture($files, sidebar: true);
     }
 
-    protected function setUpFixture(array $files, bool $sidebar = false): self
+    protected function setupFixture(array $files, bool $sidebar = false): self
     {
-        $this->helper->setUpFixture($files, $sidebar);
+        $this->helper->setupFixture($files, $sidebar);
 
         return $this;
     }
@@ -291,25 +291,39 @@ public function __construct(FilenamePrefixNavigationPriorityTest $test)
         $this->test = $test;
     }
 
-    public function setUpFixture(array $files, bool $sidebar = false): void
+    public function setupFixture(array $files, bool $sidebar = false): void
     {
         foreach ($files as $key => $file) {
             $class = $sidebar ? DocumentationPage::class : MarkdownPage::class;
-            if (is_string($file)) {
-                $page = new $class(basename($file, '.md'), markdown: '# '.str($file)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
-                Hyde::pages()->addPage($page);
-                Hyde::routes()->addRoute($page->getRoute());
-            } else {
-                foreach ($file as $child) {
-                    $group = str($key)->after('-');
-                    $page = new $class($group.'/'.basename($child, '.md'), markdown: '# '.str($child)->after('-')->before('.')->ucfirst()."\n\nHello, world!\n");
-                    Hyde::pages()->addPage($page);
-                    Hyde::routes()->addRoute($page->getRoute());
-                }
-            }
+
+            is_string($file)
+                ? $this->setupFixtureItem($class, $file)
+                : $this->setupNestedFixtureItems($file, $key, $class);
+        }
+    }
+
+    protected function setupFixtureItem(string $class, string $file): void
+    {
+        $page = new $class(basename($file, '.md'), [], $this->generateMarkdown($file));
+        Hyde::pages()->addPage($page);
+        Hyde::routes()->addRoute($page->getRoute());
+    }
+
+    protected function setupNestedFixtureItems(array $files, string $key, string $class): void
+    {
+        foreach ($files as $file) {
+            $group = str($key)->after('-');
+            $page = new $class($group.'/'.basename($file, '.md'), [], $this->generateMarkdown($file));
+            Hyde::pages()->addPage($page);
+            Hyde::routes()->addRoute($page->getRoute());
         }
     }
 
+    protected function generateMarkdown(string $file): string
+    {
+        return sprintf("# %s\n\nHello, world!\n", str($file)->after('-')->before('.')->ucfirst());
+    }
+
     public function createComparisonFormat(bool $sidebar): array
     {
         $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;

From f94bd4c992a184d25c2c755c4f2e80e517a32433 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 14:11:59 +0200
Subject: [PATCH 1814/4023] Use extension agnostic basename

---
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 66147c35fb5..c67fc20dbd7 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -304,7 +304,7 @@ public function setupFixture(array $files, bool $sidebar = false): void
 
     protected function setupFixtureItem(string $class, string $file): void
     {
-        $page = new $class(basename($file, '.md'), [], $this->generateMarkdown($file));
+        $page = new $class(Str::before($file, '.'), [], $this->generateMarkdown($file));
         Hyde::pages()->addPage($page);
         Hyde::routes()->addRoute($page->getRoute());
     }
@@ -313,7 +313,7 @@ protected function setupNestedFixtureItems(array $files, string $key, string $cl
     {
         foreach ($files as $file) {
             $group = str($key)->after('-');
-            $page = new $class($group.'/'.basename($file, '.md'), [], $this->generateMarkdown($file));
+            $page = new $class($group.'/'.Str::before($file, '.'), [], $this->generateMarkdown($file));
             Hyde::pages()->addPage($page);
             Hyde::routes()->addRoute($page->getRoute());
         }

From c3503114d24a3485f7a0f362dbc657a357162c68 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 14:23:52 +0200
Subject: [PATCH 1815/4023] Add additional fixture tests

---
 .../FilenamePrefixNavigationPriorityTest.php  | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index c67fc20dbd7..4ece1c0b2fe 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -165,6 +165,28 @@ public function test_fixtureGroupedSidebar_ordering()
         ]);
     }
 
+    public function test_fixturePrefixSyntaxes_ordering()
+    {
+        foreach ($this->fixturePrefixSyntaxes() as $fixture) {
+            $this->setupFixture($fixture);
+
+            $this->assertOrder(['foo', 'bar', 'baz']);
+        }
+
+        foreach ($this->fixturePrefixSyntaxes() as $fixture) {
+            $this->setupFixture(array_reverse($fixture));
+
+            $this->assertOrder(['foo', 'bar', 'baz']);
+        }
+    }
+
+    public function test_fixtureFileExtensions_ordering()
+    {
+        $this->setupFixture($this->fixtureFileExtensions());
+
+        $this->assertOrder(['foo', 'bar', 'baz']);
+    }
+
     protected function setUpSidebarFixture(array $files): self
     {
         return $this->setupFixture($files, sidebar: true);

From 6d979953bb28ebc46d5a3db6861cad912e23f979 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 21:04:37 +0200
Subject: [PATCH 1816/4023] Inline fixtures to make tests clearer

---
 .../FilenamePrefixNavigationPriorityTest.php  | 161 ++++++++----------
 1 file changed, 73 insertions(+), 88 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 4ece1c0b2fe..d0a61e3b674 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -115,7 +115,11 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
 
     public function test_fixtureFlatMain_ordering()
     {
-        $this->setupFixture($this->fixtureFlatMain());
+        $this->setupFixture([
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
+        ]);
 
         $this->assertOrder(['home', 'about', 'contact']);
     }
@@ -123,14 +127,27 @@ public function test_fixtureFlatMain_ordering()
     public function test_fixtureFlatMain_reverse_ordering()
     {
         // This is just a sanity check to make sure the helper is working, so we only need one of these.
-        $this->setupFixture(array_reverse($this->fixtureFlatMain()));
+        $this->setupFixture(array_reverse([
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
+        ]));
 
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
     public function test_fixtureGroupedMain_ordering()
     {
-        $this->setupFixture($this->fixtureGroupedMain());
+        $this->setupFixture([
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
+            '04-api' => [
+                '01-readme.md',
+                '02-installation.md',
+                '03-getting-started.md',
+            ],
+        ]);
 
         $this->assertOrder(['home', 'about', 'contact', 'api' => [
             'readme', 'installation', 'getting-started',
@@ -140,7 +157,16 @@ public function test_fixtureGroupedMain_ordering()
     public function test_fixtureGroupedMain_reverse_ordering()
     {
         // Also a sanity check but for the inner group as well.
-        $this->setupFixture($this->arrayReverseRecursive($this->fixtureGroupedMain()));
+        $this->setupFixture($this->arrayReverseRecursive([
+            '01-home.md',
+            '02-about.md',
+            '03-contact.md',
+            '04-api' => [
+                '01-readme.md',
+                '02-installation.md',
+                '03-getting-started.md',
+            ],
+        ]));
 
         $this->assertOrder(['home', 'about', 'contact', 'api' => [
             'readme', 'installation', 'getting-started',
@@ -149,14 +175,32 @@ public function test_fixtureGroupedMain_reverse_ordering()
 
     public function test_fixtureFlatSidebar_ordering()
     {
-        $this->setUpSidebarFixture($this->fixtureFlatSidebar());
+        $this->setUpSidebarFixture([
+            '01-readme.md',
+            '02-installation.md',
+            '03-getting-started.md',
+        ]);
 
         $this->assertSidebarOrder(['readme', 'installation', 'getting-started']);
     }
 
     public function test_fixtureGroupedSidebar_ordering()
     {
-        $this->setUpSidebarFixture($this->fixtureGroupedSidebar());
+        $this->setUpSidebarFixture([
+            '01-readme.md',
+            '02-installation.md',
+            '03-getting-started.md',
+            '04-introduction' => [
+                '01-general.md',
+                '02-resources.md',
+                '03-requirements.md',
+            ],
+            '05-advanced' => [
+                '01-features.md',
+                '02-extensions.md',
+                '03-configuration.md',
+            ],
+        ]);
 
         $this->assertSidebarOrder([
             'other' => ['readme', 'installation', 'getting-started'],
@@ -167,13 +211,29 @@ public function test_fixtureGroupedSidebar_ordering()
 
     public function test_fixturePrefixSyntaxes_ordering()
     {
-        foreach ($this->fixturePrefixSyntaxes() as $fixture) {
+        $fixtures = [
+            [
+                '1-foo.md',
+                '2-bar.md',
+                '3-baz.md',
+            ], [
+                '01-foo.md',
+                '02-bar.md',
+                '03-baz.md',
+            ], [
+                '001-foo.md',
+                '002-bar.md',
+                '003-baz.md',
+            ],
+        ];
+
+        foreach ($fixtures as $fixture) {
             $this->setupFixture($fixture);
 
             $this->assertOrder(['foo', 'bar', 'baz']);
         }
 
-        foreach ($this->fixturePrefixSyntaxes() as $fixture) {
+        foreach ($fixtures as $fixture) {
             $this->setupFixture(array_reverse($fixture));
 
             $this->assertOrder(['foo', 'bar', 'baz']);
@@ -182,7 +242,11 @@ public function test_fixturePrefixSyntaxes_ordering()
 
     public function test_fixtureFileExtensions_ordering()
     {
-        $this->setupFixture($this->fixtureFileExtensions());
+        $this->setupFixture([
+            '01-foo.md',
+            '02-bar.html',
+            '03-baz.blade.php',
+        ]);
 
         $this->assertOrder(['foo', 'bar', 'baz']);
     }
@@ -211,85 +275,6 @@ protected function assertOrder(array $expected, bool $sidebar = false): void
         $this->assertSame($expected, $actual);
     }
 
-    protected function fixtureFlatMain(): array
-    {
-        return [
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-        ];
-    }
-
-    protected function fixtureGroupedMain(): array
-    {
-        return [
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-            '04-api' => [
-                '01-readme.md',
-                '02-installation.md',
-                '03-getting-started.md',
-            ],
-        ];
-    }
-
-    protected function fixtureFlatSidebar(): array
-    {
-        return [
-            '01-readme.md',
-            '02-installation.md',
-            '03-getting-started.md',
-        ];
-    }
-
-    protected function fixtureGroupedSidebar(): array
-    {
-        return [
-            '01-readme.md',
-            '02-installation.md',
-            '03-getting-started.md',
-            '04-introduction' => [
-                '01-general.md',
-                '02-resources.md',
-                '03-requirements.md',
-            ],
-            '05-advanced' => [
-                '01-features.md',
-                '02-extensions.md',
-                '03-configuration.md',
-            ],
-        ];
-    }
-
-    protected function fixturePrefixSyntaxes(): array
-    {
-        return [
-            [
-                '1-foo.md',
-                '2-bar.md',
-                '3-baz.md',
-            ], [
-                '01-foo.md',
-                '02-bar.md',
-                '03-baz.md',
-            ], [
-                '001-foo.md',
-                '002-bar.md',
-                '003-baz.md',
-            ],
-        ];
-    }
-
-    protected function fixtureFileExtensions(): array
-    {
-        return [
-            '01-foo.md',
-            '02-bar.html',
-            '03-baz.blade.php',
-        ];
-    }
-
     protected function arrayReverseRecursive(array $array): array
     {
         $reversed = array_reverse($array);

From 2a7b3595df1a2e7bff634330d905f58c4ac0e6f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 2 May 2024 21:08:34 +0200
Subject: [PATCH 1817/4023] Rename test methods using ChatGPT to make them
 clearer

---
 .../FilenamePrefixNavigationPriorityTest.php     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index d0a61e3b674..9041f92b751 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -113,7 +113,7 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
         $this->assertSame("$identifier.html", $page->getOutputPath());
     }
 
-    public function test_fixtureFlatMain_ordering()
+    public function testFlatMainNavigationOrdering()
     {
         $this->setupFixture([
             '01-home.md',
@@ -124,7 +124,7 @@ public function test_fixtureFlatMain_ordering()
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
-    public function test_fixtureFlatMain_reverse_ordering()
+    public function testReverseOrderOfFlatMainNavigation()
     {
         // This is just a sanity check to make sure the helper is working, so we only need one of these.
         $this->setupFixture(array_reverse([
@@ -136,7 +136,7 @@ public function test_fixtureFlatMain_reverse_ordering()
         $this->assertOrder(['home', 'about', 'contact']);
     }
 
-    public function test_fixtureGroupedMain_ordering()
+    public function testGroupedMainNavigationOrdering()
     {
         $this->setupFixture([
             '01-home.md',
@@ -154,7 +154,7 @@ public function test_fixtureGroupedMain_ordering()
         ]]);
     }
 
-    public function test_fixtureGroupedMain_reverse_ordering()
+    public function testReverseOrderOfGroupedMainNavigation()
     {
         // Also a sanity check but for the inner group as well.
         $this->setupFixture($this->arrayReverseRecursive([
@@ -173,7 +173,7 @@ public function test_fixtureGroupedMain_reverse_ordering()
         ]]);
     }
 
-    public function test_fixtureFlatSidebar_ordering()
+    public function testFlatSidebarNavigationOrdering()
     {
         $this->setUpSidebarFixture([
             '01-readme.md',
@@ -184,7 +184,7 @@ public function test_fixtureFlatSidebar_ordering()
         $this->assertSidebarOrder(['readme', 'installation', 'getting-started']);
     }
 
-    public function test_fixtureGroupedSidebar_ordering()
+    public function testGroupedSidebarNavigationOrdering()
     {
         $this->setUpSidebarFixture([
             '01-readme.md',
@@ -209,7 +209,7 @@ public function test_fixtureGroupedSidebar_ordering()
         ]);
     }
 
-    public function test_fixturePrefixSyntaxes_ordering()
+    public function testDifferentPrefixSyntaxesOrdering()
     {
         $fixtures = [
             [
@@ -240,7 +240,7 @@ public function test_fixturePrefixSyntaxes_ordering()
         }
     }
 
-    public function test_fixtureFileExtensions_ordering()
+    public function testOrderingWithDifferentFileExtensions()
     {
         $this->setupFixture([
             '01-foo.md',

From 333b139c8237c71463eb0800b94bef23daf24994 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 3 May 2024 20:28:45 +0200
Subject: [PATCH 1818/4023] Document numerical prefix navigation ordering

---
 docs/digging-deeper/navigation.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index ff515caf30b..1d2731235f9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -300,6 +300,37 @@ Here are some things to keep in mind when using dropdown menus, regardless of th
 - Dropdowns take priority over standard items. So if you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
   - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
 
+## Numerical Prefix Navigation Ordering
+
+HydePHP v2 introduces a new feature that allows navigation items to be ordered based on a numerical prefix in the filename.
+This is a great way to control the ordering of pages in both the primary navigation menu and the documentation sidebar, 
+as your file structure will match the order of the pages in the navigation menus.
+
+For example, the following will have the same order in the navigation menu as well as the file structure (assuming you sort files by name):
+
+```
+_pages/
+  01-home.md # Gets priority 1, putting it first
+  02-about.md # Gets priority 2, putting it second
+  03-contact.md # Gets priority 3, putting it third
+```
+
+Hyde will then parse the number from the filename and use it as the priority for the page in the navigation menus.
+
+>info Remember, that while Hyde in general retains the source file names when creating route keys and thus output file names, Hyde will in this case strip the numerical prefix from the route key so your URLs will not contain the numerical prefix.
+
+### Customization
+
+You can disable this feature by setting the `numerical_page_ordering` setting to `false` in the `hyde.php` config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
+
+```php
+// filepath config/hyde.php
+
+'numerical_page_ordering' => false,
+```
+
+While it's not recommended, as you lose out on the convenience of the automatic ordering, any front matter priority settings will override the numerical prefix ordering if you for some reason need to.
+
 ## Digging Deeper into the internals
 
 While not required to know, you may find it interesting to learn more about how the navigation is handled internally. Here is a high level overview,

From 755cbfcef4db70ffbcb6637d8705ca522e5512e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 3 May 2024 21:15:36 +0200
Subject: [PATCH 1819/4023] Improve documentation formatting

---
 docs/digging-deeper/navigation.md | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1d2731235f9..229d665531d 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -306,18 +306,26 @@ HydePHP v2 introduces a new feature that allows navigation items to be ordered b
 This is a great way to control the ordering of pages in both the primary navigation menu and the documentation sidebar, 
 as your file structure will match the order of the pages in the navigation menus.
 
-For example, the following will have the same order in the navigation menu as well as the file structure (assuming you sort files by name):
+For example, the following will have the same order in the navigation menu as in a file explorer:
 
-```
+```shell
 _pages/
-  01-home.md # Gets priority 1, putting it first
-  02-about.md # Gets priority 2, putting it second
-  03-contact.md # Gets priority 3, putting it third
+  01-home.md # Gets priority 1, putting it first (will be saved to _site/index.html)
+  02-about.md # Gets priority 2, putting it second (will be saved to _site/about.html)
+  03-contact.md # Gets priority 3, putting it third (will be saved to _site/contact.html)
 ```
 
 Hyde will then parse the number from the filename and use it as the priority for the page in the navigation menus.
 
->info Remember, that while Hyde in general retains the source file names when creating route keys and thus output file names, Hyde will in this case strip the numerical prefix from the route key so your URLs will not contain the numerical prefix.
+### Keep in mind
+
+Here are some things to keep in mind, especially if you mix numerical prefix ordering with other ordering methods:
+
+1. The numerical prefix will still be part of the page identifier, but it will be stripped from the route key.
+   - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.
+2. You can delimit the numerical prefix with either a dash or an underscore.
+   - For example: `_pages/01-home.md` and `_pages/01_home.md` are both valid.
+3. The leading zeroes are optional, so `_pages/1-home.md` is also valid.
 
 ### Customization
 

From 3787c60d1499efe5e9757714ab1b157ad04c8b87 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 3 May 2024 21:15:45 +0200
Subject: [PATCH 1820/4023] Document using numerical prefix ordering in
 subdirectories

---
 docs/digging-deeper/navigation.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 229d665531d..32074117275 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -327,6 +327,30 @@ Here are some things to keep in mind, especially if you mix numerical prefix ord
    - For example: `_pages/01-home.md` and `_pages/01_home.md` are both valid.
 3. The leading zeroes are optional, so `_pages/1-home.md` is also valid.
 
+### Using numerical prefix ordering in subdirectories
+
+The numerical prefix ordering feature works great when using the automatic subdirectory-based grouping for navigation menu dropdowns and documentation sidebar categories.
+
+This integration has two main features to consider:
+1. You can use numerical prefixes in subdirectories to control the order of dropdowns.
+2. The ordering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
+
+Here is an example structure of how you may want to organize a documentation site:
+
+```shell
+_docs/
+  01-getting-started/
+    01-installation.md
+    02-requirements.md
+    03-configuration.md
+  02-usage/
+    01-quick-start.md
+    02-advanced-usage.md
+  03-features/
+    01-feature-1.md
+    02-feature-2.md
+```
+
 ### Customization
 
 You can disable this feature by setting the `numerical_page_ordering` setting to `false` in the `hyde.php` config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.

From eac372f2376d1c1bc7b2bf0d3f9a3e0d3f48b633 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 3 May 2024 21:16:07 +0200
Subject: [PATCH 1821/4023] Fix formatting

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 32074117275..c85a8677da4 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -298,12 +298,12 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 Here are some things to keep in mind when using dropdown menus, regardless of the configuration:
 - Dropdowns take priority over standard items. So if you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
-  - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
+    - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
 
 ## Numerical Prefix Navigation Ordering
 
 HydePHP v2 introduces a new feature that allows navigation items to be ordered based on a numerical prefix in the filename.
-This is a great way to control the ordering of pages in both the primary navigation menu and the documentation sidebar, 
+This is a great way to control the ordering of pages in both the primary navigation menu and the documentation sidebar,
 as your file structure will match the order of the pages in the navigation menus.
 
 For example, the following will have the same order in the navigation menu as in a file explorer:
@@ -322,9 +322,9 @@ Hyde will then parse the number from the filename and use it as the priority for
 Here are some things to keep in mind, especially if you mix numerical prefix ordering with other ordering methods:
 
 1. The numerical prefix will still be part of the page identifier, but it will be stripped from the route key.
-   - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.
+    - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.
 2. You can delimit the numerical prefix with either a dash or an underscore.
-   - For example: `_pages/01-home.md` and `_pages/01_home.md` are both valid.
+    - For example: `_pages/01-home.md` and `_pages/01_home.md` are both valid.
 3. The leading zeroes are optional, so `_pages/1-home.md` is also valid.
 
 ### Using numerical prefix ordering in subdirectories

From d73e9c404a2427df6dab2a28f832073211b6350b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 10:44:21 +0200
Subject: [PATCH 1822/4023] Rename added config option to match documented
 value

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php      | 2 +-
 .../tests/Feature/FilenamePrefixNavigationPriorityTest.php      | 2 +-
 .../framework/tests/Feature/Services/SitemapServiceTest.php     | 2 +-
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 6e7dd12aba2..69cf6085a01 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -23,7 +23,7 @@ class FilenamePrefixNavigationHelper
      */
     public static function enabled(): bool
     {
-        return Config::getBool('hyde.filename_page_ordering', true);
+        return Config::getBool('hyde.numerical_page_ordering', true);
     }
 
     /**
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
index 9041f92b751..05aa57a5d5f 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
@@ -84,7 +84,7 @@ public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
 
     public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeysWhenFeatureIsDisabled()
     {
-        Config::set('hyde.filename_page_ordering', false);
+        Config::set('hyde.numerical_page_ordering', false);
 
         $this->file('_pages/01-home.md');
 
diff --git a/packages/framework/tests/Feature/Services/SitemapServiceTest.php b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
index f718fe3d223..bfa9e602552 100644
--- a/packages/framework/tests/Feature/Services/SitemapServiceTest.php
+++ b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
@@ -30,7 +30,7 @@ protected function setUp(): void
         copy(Hyde::vendorPath('resources/views/homepages/welcome.blade.php'), Hyde::path('_pages/index.blade.php'));
         copy(Hyde::vendorPath('resources/views/pages/404.blade.php'), Hyde::path('_pages/404.blade.php'));
 
-        Config::set(['hyde.filename_page_ordering' => false]);
+        Config::set(['hyde.numerical_page_ordering' => false]);
     }
 
     public function testServiceInstantiatesXmlElement()
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 561c9f00e96..b46ddae02b6 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -23,7 +23,7 @@ public function testEnabledReturnsTrueWhenEnabled()
 
     public function testEnabledReturnsFalseWhenDisabled()
     {
-        self::mockConfig(['hyde.filename_page_ordering' => false]);
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
 
         $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
     }

From 8a281113ff15473ea785ab7e19d016f518cfe726 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 13:29:56 +0200
Subject: [PATCH 1823/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1d99b7472e4..a099118b402 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,6 +10,7 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
+- You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 - The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
 

From b2a03e08764a56e0085d9137db6b081437381089 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 13:46:39 +0200
Subject: [PATCH 1824/4023] Draft new unit tests

---
 .../tests/Unit/NavigationDataFactoryUnitTest.php  | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 6e544d32232..80d4d9c86ab 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -267,6 +267,21 @@ public function testMakeGroupDefaultsToNullIfFrontMatterGroupNotSetAndSubdirecto
         $this->assertNull($factory->makeGroup());
     }
 
+    public function testItExtractsPriorityFromNumericalFilenamePrefix()
+    {
+        //
+    }
+
+    public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()
+    {
+        //
+    }
+
+    public function testItDoesNotExtractNonNumericalFilenamePrefixes()
+    {
+        //
+    }
+
     protected function makeCoreDataObject(string $identifier = '', string $routeKey = '', string $pageClass = MarkdownPage::class): CoreDataObject
     {
         return new CoreDataObject(new FrontMatter(), new Markdown(), $pageClass, $identifier, '', '', $routeKey);

From 1babeadf13fcda764a83d5ef8477fad49fb49f00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 17:01:14 +0200
Subject: [PATCH 1825/4023] Test it extracts priority from numerical filename
 prefix

---
 .../framework/tests/Unit/NavigationDataFactoryUnitTest.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 80d4d9c86ab..5671b4bb35f 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -269,7 +269,10 @@ public function testMakeGroupDefaultsToNullIfFrontMatterGroupNotSetAndSubdirecto
 
     public function testItExtractsPriorityFromNumericalFilenamePrefix()
     {
-        //
+        $coreDataObject = $this->makeCoreDataObject('01-test.md');
+        $factory = new NavigationConfigTestClass($coreDataObject);
+
+        $this->assertSame(1, $factory->makePriority());
     }
 
     public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()

From 244182f77c5538b3962a0fd94718a20d8a50cad6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 17:06:05 +0200
Subject: [PATCH 1826/4023] Test it extracts various syntaxes

---
 .../Unit/NavigationDataFactoryUnitTest.php    | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 5671b4bb35f..c72ee3c9f1f 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -275,6 +275,38 @@ public function testItExtractsPriorityFromNumericalFilenamePrefix()
         $this->assertSame(1, $factory->makePriority());
     }
 
+    public function testItExtractsPriorityFromNumericalFilenamePrefixWithKebabCaseSyntax()
+    {
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01-foo.md')))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02-bar.md')))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03-baz.md')))->makePriority());
+    }
+
+    public function testItExtractsPriorityFromNumericalFilenamePrefixWithSnakeCaseSyntax()
+    {
+        $this->markTestSkipped('TODO: Support snake_case syntax for priority extraction');
+
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01_foo.md')))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02_bar.md')))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03_baz.md')))->makePriority());
+    }
+
+    public function testItExtractsPriorityFromNumericalFilenamePrefixRegardlessOfLeadingZeroes()
+    {
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('123-foo.md')))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0123-foo.md')))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('00123-foo.md')))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('000123-foo.md')))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0000123-foo.md')))->makePriority());
+    }
+
+    public function testItExtractsPriorityFromNumericalFilenamePrefixForNestedIdentifiers()
+    {
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar.md')))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/bar/02-baz.md')))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar/03-baz.md')))->makePriority());
+    }
+
     public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()
     {
         //

From 13f2a12b97f0ef82679eab800ca32601e5996025 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 4 May 2024 18:48:48 +0200
Subject: [PATCH 1827/4023] Implement the tests

---
 .../tests/Unit/NavigationDataFactoryUnitTest.php         | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index c72ee3c9f1f..8aac2aba7d7 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -309,12 +309,17 @@ public function testItExtractsPriorityFromNumericalFilenamePrefixForNestedIdenti
 
     public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()
     {
-        //
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
+
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-test.md')))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-home.md')))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-404.md')))->makePriority());
     }
 
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
-        //
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('foo-bar.md')))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('abc-bar.md')))->makePriority());
     }
 
     protected function makeCoreDataObject(string $identifier = '', string $routeKey = '', string $pageClass = MarkdownPage::class): CoreDataObject

From 2e33af28455097a82e54cd190b210bb6e0a5b3e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:50:01 +0200
Subject: [PATCH 1828/4023] Support snake case syntax for priority extraction

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php      | 2 +-
 packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php | 2 --
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 69cf6085a01..7e3153186c8 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -35,7 +35,7 @@ public static function isIdentifierNumbered(string $identifier): bool
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        return preg_match('/^\d+-/', $identifier) === 1;
+        return preg_match('/^\d+-/', $identifier) === 1 || preg_match('/^\d+_/', $identifier) === 1;
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 8aac2aba7d7..08824908383 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -284,8 +284,6 @@ public function testItExtractsPriorityFromNumericalFilenamePrefixWithKebabCaseSy
 
     public function testItExtractsPriorityFromNumericalFilenamePrefixWithSnakeCaseSyntax()
     {
-        $this->markTestSkipped('TODO: Support snake_case syntax for priority extraction');
-
         $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01_foo.md')))->makePriority());
         $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02_bar.md')))->makePriority());
         $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03_baz.md')))->makePriority());

From b838bb7c37a10925640c968a2f9a0facc1bee48a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:50:46 +0200
Subject: [PATCH 1829/4023] Merge regex patterns

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 7e3153186c8..510bffb4515 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -35,7 +35,7 @@ public static function isIdentifierNumbered(string $identifier): bool
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        return preg_match('/^\d+-/', $identifier) === 1 || preg_match('/^\d+_/', $identifier) === 1;
+        return preg_match('/^\d+[-_]/', $identifier) === 1;
     }
 
     /**

From 5b4491fb1d3c3be6e4394f59fa43e45866152f56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:52:18 +0200
Subject: [PATCH 1830/4023] Fix grammar in test skip comment

---
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index b46ddae02b6..f0dee342dcd 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -58,7 +58,7 @@ public function testSplitNumberAndIdentifierWithMultipleDigits()
 
     public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
     {
-        $this->markTestSkipped('Since this is an internal class at the moment, we don not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
 
         $this->expectException(\AssertionError::class);
         $this->expectExceptionMessage('Identifier "home.md" is not numbered.');

From d6045177a2851518684202b0149d5b23d4dc060a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:55:42 +0200
Subject: [PATCH 1831/4023] Introduce local variable

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 510bffb4515..fe71db4b910 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -52,7 +52,8 @@ public static function splitNumberAndIdentifier(string $identifier): array
 
         assert(self::isIdentifierNumbered($identifier));
 
-        $parts = explode('-', $identifier, 2);
+        $separator = '-';
+        $parts = explode($separator, $identifier, 2);
 
         $parts[0] = (int) $parts[0];
 

From 25a76808c1eaabc14b85bb9b32f4304b484b26e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:55:57 +0200
Subject: [PATCH 1832/4023] Split out snake cased parts

---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index fe71db4b910..033bd6d9599 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -7,7 +7,9 @@
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 
+use function ltrim;
 use function assert;
+use function substr;
 use function explode;
 use function preg_match;
 
@@ -52,7 +54,7 @@ public static function splitNumberAndIdentifier(string $identifier): array
 
         assert(self::isIdentifierNumbered($identifier));
 
-        $separator = '-';
+        $separator = substr(ltrim($identifier, '0123456789'), 0, 1);
         $parts = explode($separator, $identifier, 2);
 
         $parts[0] = (int) $parts[0];

From 2f8de3fde4cc19e57d6c7ae01757671d5790dc6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 17:57:44 +0200
Subject: [PATCH 1833/4023] Add tests for when using snake case dividers

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index f0dee342dcd..4babe0d4e04 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -42,6 +42,13 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
     }
 
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'));
+    }
+
     public function testSplitNumberAndIdentifier()
     {
         $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
@@ -49,6 +56,13 @@ public function testSplitNumberAndIdentifier()
         $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
     }
 
+    public function testSplitNumberAndIdentifierForSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'));
+    }
+
     public function testSplitNumberAndIdentifierWithMultipleDigits()
     {
         $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
@@ -56,6 +70,13 @@ public function testSplitNumberAndIdentifierWithMultipleDigits()
         $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
     }
 
+    public function testSplitNumberAndIdentifierWithMultipleDigitsAndSnakeCaseDividers()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'));
+    }
+
     public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
     {
         $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
@@ -73,6 +94,13 @@ public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
         $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'));
     }
 
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'));
+    }
+
     public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'));
@@ -87,6 +115,13 @@ public function testSplitNumberAndIdentifierForNestedPages()
         $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
     }
 
+    public function testSplitNumberAndIdentifierForNestedPagesWithSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'));
+    }
+
     public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
     {
         $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'));
@@ -94,6 +129,13 @@ public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetec
         $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'));
     }
 
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'));
+    }
+
     public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'));
@@ -107,4 +149,11 @@ public function testSplitNumberAndIdentifierForDeeplyNestedPages()
         $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'));
         $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'));
     }
+
+    public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'));
+    }
 }

From 88c52ea00407aafdb9d05b6f80d57012876696c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:00:45 +0200
Subject: [PATCH 1834/4023] Test non numerical parts are not detected

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 4babe0d4e04..b5dddb36d57 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -156,4 +156,26 @@ public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDiv
         $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'));
         $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'));
     }
+
+    public function testNonNumericalPartsAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'));
+    }
+
+    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'));
+    }
 }

From 13c29ec3c793b0196a7fc56d5bf151b71cafbef9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:05:58 +0200
Subject: [PATCH 1835/4023] Add tests for various edge cases

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index b5dddb36d57..ae0176244a4 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -178,4 +178,37 @@ public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'));
     }
+
+    public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'));
+    }
+
+    public function testNumericallyPrefixedIdentifiersWithoutDividerAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'));
+    }
+
+    public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'));
+    }
 }

From 0a7e8fb64cba327c030e8caa66a0885a97e1cb3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:13:04 +0200
Subject: [PATCH 1836/4023] Convert test to a Pest test

Want to use dynamic datasets
---
 ...lenamePrefixNavigationPriorityUnitTest.php | 380 ++++++++----------
 1 file changed, 172 insertions(+), 208 deletions(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index ae0176244a4..f2a72fde534 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -2,213 +2,177 @@
 
 declare(strict_types=1);
 
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Testing\UnitTestCase;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
-/**
- * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
- *
- * @see \Hyde\Framework\Testing\Feature\FilenamePrefixNavigationPriorityTest
- */
-class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
-{
-    protected static bool $needsConfig = true;
-
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividers()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifier()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierForSnakeCaseDividers()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierWithMultipleDigitsAndSnakeCaseDividers()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-    }
-
-    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'));
-    }
-
-    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'));
-    }
-
-    public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierForNestedPages()
-    {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierForNestedPagesWithSnakeCaseDividers()
-    {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierForDeeplyNestedPages()
-    {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'));
-    }
-
-    public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDividers()
-    {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'));
-    }
-
-    public function testNonNumericalPartsAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'));
-    }
-
-    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'));
-    }
-
-    public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'));
-    }
-
-    public function testNumericallyPrefixedIdentifiersWithoutDividerAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'));
-    }
-
-    public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'));
-    }
-}
+beforeEach(fn () => $this->mockConfig());
+
+test('enabled returns true when enabled', function () {
+    expect(FilenamePrefixNavigationHelper::enabled())->toBeTrue();
+});
+
+test('enabled returns false when disabled', function () {
+    $this->mockConfig(['hyde.numerical_page_ordering' => false]);
+
+    expect(FilenamePrefixNavigationHelper::enabled())->toBeFalse();
+});
+
+test('identifiers with numerical prefixes are detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'))->toBeTrue();
+});
+
+test('identifiers without numerical prefixes are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'))->toBeFalse();
+});
+
+test('identifiers with numerical prefixes are detected when using snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'))->toBeTrue();
+});
+
+test('split number and identifier', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'))->toBe([1, 'home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'))->toBe([2, 'about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'))->toBe([3, 'contact.md']);
+});
+
+test('split number and identifier for snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'))->toBe([1, 'home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'))->toBe([2, 'about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'))->toBe([3, 'contact.md']);
+});
+
+test('split number and identifier with multiple digits', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'))->toBe([123, 'home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'))->toBe([456, 'about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'))->toBe([789, 'contact.md']);
+});
+
+test('split number and identifier with multiple digits and snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'))->toBe([123, 'home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'))->toBe([456, 'about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'))->toBe([789, 'contact.md']);
+});
+
+test('split number and identifier throws exception when identifier is not numbered', function () {
+    $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
+    $this->expectException(\AssertionError::class);
+    $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+    FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+});
+
+test('identifiers for nested pages with numerical prefixes are detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'))->toBeTrue();
+});
+
+test('identifiers for nested pages with numerical prefixes are detected using snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'))->toBeTrue();
+});
+
+test('identifiers for nested pages without numerical prefixes are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'))->toBeFalse();
+});
+
+test('split number and identifier for nested pages', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'))->toBe([1, 'foo/home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'))->toBe([2, 'foo/about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'))->toBe([3, 'foo/contact.md']);
+});
+
+test('split number and identifier for nested pages with snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'))->toBe([1, 'foo/home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'))->toBe([2, 'foo/about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'))->toBe([3, 'foo/contact.md']);
+});
+
+test('identifiers for deeply nested pages with numerical prefixes are detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'))->toBeTrue();
+});
+
+test('identifiers for deeply nested pages with numerical prefixes are detected using snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'))->toBeTrue();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'))->toBeTrue();
+});
+
+test('identifiers for deeply nested pages without numerical prefixes are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'))->toBeFalse();
+});
+
+test('split number and identifier for deeply nested pages', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'))->toBe([1, 'foo/bar/home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'))->toBe([2, 'foo/bar/about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'))->toBe([3, 'foo/bar/contact.md']);
+});
+
+test('split number and identifier for deeply nested pages with snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'))->toBe([1, 'foo/bar/home.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'))->toBe([2, 'foo/bar/about.md']);
+    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'))->toBe([3, 'foo/bar/contact.md']);
+});
+
+test('non numerical parts are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
+
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'))->toBeFalse();
+});
+
+test('non numerical parts are not detected for snake case dividers', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
+
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'))->toBeFalse();
+});
+
+test('numerically prefixed identifiers with unknown dividers are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'))->toBeFalse();
+
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'))->toBeFalse();
+
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'))->toBeFalse();
+
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'))->toBeFalse();
+});
+
+test('numerically prefixed identifiers without divider are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'))->toBeFalse();
+});
+
+test('numerically string prefixed identifiers without divider are not detected', function () {
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'))->toBeFalse();
+    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'))->toBeFalse();
+});

From 6468511e401cc0e4e1f3c0de936b83bddf8fd17d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:13:57 +0200
Subject: [PATCH 1837/4023] Revert "Convert test to a Pest test"

This reverts commit 0a7e8fb64cba327c030e8caa66a0885a97e1cb3d.
---
 ...lenamePrefixNavigationPriorityUnitTest.php | 380 ++++++++++--------
 1 file changed, 208 insertions(+), 172 deletions(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index f2a72fde534..ae0176244a4 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -2,177 +2,213 @@
 
 declare(strict_types=1);
 
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
-beforeEach(fn () => $this->mockConfig());
-
-test('enabled returns true when enabled', function () {
-    expect(FilenamePrefixNavigationHelper::enabled())->toBeTrue();
-});
-
-test('enabled returns false when disabled', function () {
-    $this->mockConfig(['hyde.numerical_page_ordering' => false]);
-
-    expect(FilenamePrefixNavigationHelper::enabled())->toBeFalse();
-});
-
-test('identifiers with numerical prefixes are detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'))->toBeTrue();
-});
-
-test('identifiers without numerical prefixes are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'))->toBeFalse();
-});
-
-test('identifiers with numerical prefixes are detected when using snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'))->toBeTrue();
-});
-
-test('split number and identifier', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'))->toBe([1, 'home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'))->toBe([2, 'about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'))->toBe([3, 'contact.md']);
-});
-
-test('split number and identifier for snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'))->toBe([1, 'home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'))->toBe([2, 'about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'))->toBe([3, 'contact.md']);
-});
-
-test('split number and identifier with multiple digits', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'))->toBe([123, 'home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'))->toBe([456, 'about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'))->toBe([789, 'contact.md']);
-});
-
-test('split number and identifier with multiple digits and snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'))->toBe([123, 'home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'))->toBe([456, 'about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'))->toBe([789, 'contact.md']);
-});
-
-test('split number and identifier throws exception when identifier is not numbered', function () {
-    $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-    $this->expectException(\AssertionError::class);
-    $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-    FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
-});
-
-test('identifiers for nested pages with numerical prefixes are detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'))->toBeTrue();
-});
-
-test('identifiers for nested pages with numerical prefixes are detected using snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'))->toBeTrue();
-});
-
-test('identifiers for nested pages without numerical prefixes are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'))->toBeFalse();
-});
-
-test('split number and identifier for nested pages', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'))->toBe([1, 'foo/home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'))->toBe([2, 'foo/about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'))->toBe([3, 'foo/contact.md']);
-});
-
-test('split number and identifier for nested pages with snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'))->toBe([1, 'foo/home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'))->toBe([2, 'foo/about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'))->toBe([3, 'foo/contact.md']);
-});
-
-test('identifiers for deeply nested pages with numerical prefixes are detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'))->toBeTrue();
-});
-
-test('identifiers for deeply nested pages with numerical prefixes are detected using snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'))->toBeTrue();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'))->toBeTrue();
-});
-
-test('identifiers for deeply nested pages without numerical prefixes are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'))->toBeFalse();
-});
-
-test('split number and identifier for deeply nested pages', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'))->toBe([1, 'foo/bar/home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'))->toBe([2, 'foo/bar/about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'))->toBe([3, 'foo/bar/contact.md']);
-});
-
-test('split number and identifier for deeply nested pages with snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'))->toBe([1, 'foo/bar/home.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'))->toBe([2, 'foo/bar/about.md']);
-    expect(FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'))->toBe([3, 'foo/bar/contact.md']);
-});
-
-test('non numerical parts are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'))->toBeFalse();
-
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'))->toBeFalse();
-});
-
-test('non numerical parts are not detected for snake case dividers', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'))->toBeFalse();
-
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'))->toBeFalse();
-});
-
-test('numerically prefixed identifiers with unknown dividers are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'))->toBeFalse();
-
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'))->toBeFalse();
-
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'))->toBeFalse();
-
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'))->toBeFalse();
-});
-
-test('numerically prefixed identifiers without divider are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'))->toBeFalse();
-});
-
-test('numerically string prefixed identifiers without divider are not detected', function () {
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'))->toBeFalse();
-    expect(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'))->toBeFalse();
-});
+/**
+ * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
+ *
+ * @see \Hyde\Framework\Testing\Feature\FilenamePrefixNavigationPriorityTest
+ */
+class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
+{
+    protected static bool $needsConfig = true;
+
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifier()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierWithMultipleDigitsAndSnakeCaseDividers()
+    {
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
+        $this->expectException(\AssertionError::class);
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+    }
+
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'));
+    }
+
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'));
+    }
+
+    public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForNestedPages()
+    {
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForNestedPagesWithSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForDeeplyNestedPages()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'));
+    }
+
+    public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDividers()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'));
+    }
+
+    public function testNonNumericalPartsAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'));
+    }
+
+    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'));
+    }
+
+    public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'));
+
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'));
+    }
+
+    public function testNumericallyPrefixedIdentifiersWithoutDividerAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'));
+    }
+
+    public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDetected()
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'));
+    }
+}

From 38ac759f61cc4ae5103bb2ff501ee69cf2931a69 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:19:02 +0200
Subject: [PATCH 1838/4023] Set up PHPUnit data provider

Didn't realize this could also run multiple tests like in Pest
---
 .../Unit/FilenamePrefixNavigationPriorityUnitTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index ae0176244a4..8acef9a5491 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
 
 /**
@@ -211,4 +212,12 @@ public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDete
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'));
     }
+
+    public static function pageTypeProvider(): array
+    {
+        self::needsKernel();
+        self::mockConfig();
+
+        return array_map(fn (string $class): array => [$class], HydeCoreExtension::getPageClasses());
+    }
 }

From e7706398ce4057f2fc21430ac0f2ab91aef19562 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:35:26 +0200
Subject: [PATCH 1839/4023] Add keys to the provider

---
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 8acef9a5491..145bda6fae7 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -218,6 +218,7 @@ public static function pageTypeProvider(): array
         self::needsKernel();
         self::mockConfig();
 
-        return array_map(fn (string $class): array => [$class], HydeCoreExtension::getPageClasses());
+        $arrayMap = array_map(fn (string $class): array => [$class], HydeCoreExtension::getPageClasses());
+        return array_combine(array_map(fn (string $class): string => str($class)->classBasename()->kebab()->replace('-', ' ')->toString(), HydeCoreExtension::getPageClasses()), $arrayMap);
     }
 }

From 828fb8b8af6aba4bd7a860974573b0f125f002d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:37:11 +0200
Subject: [PATCH 1840/4023] Clean up provider syntax

---
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 145bda6fae7..2837f332195 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -218,7 +218,9 @@ public static function pageTypeProvider(): array
         self::needsKernel();
         self::mockConfig();
 
-        $arrayMap = array_map(fn (string $class): array => [$class], HydeCoreExtension::getPageClasses());
-        return array_combine(array_map(fn (string $class): string => str($class)->classBasename()->kebab()->replace('-', ' ')->toString(), HydeCoreExtension::getPageClasses()), $arrayMap);
+        return array_combine(
+            array_map(fn ($class) => str($class)->classBasename()->snake(' ')->plural()->toString(),
+            HydeCoreExtension::getPageClasses()), array_map(fn ($class) => [$class], HydeCoreExtension::getPageClasses())
+        );
     }
 }

From 6aea910d848a13c5b1d562ad9cc3df7a0df47e64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:44:04 +0200
Subject: [PATCH 1841/4023] Fix wrong line wrapping

---
 .../tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 2837f332195..45237ce4c4c 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -219,8 +219,8 @@ public static function pageTypeProvider(): array
         self::mockConfig();
 
         return array_combine(
-            array_map(fn ($class) => str($class)->classBasename()->snake(' ')->plural()->toString(),
-            HydeCoreExtension::getPageClasses()), array_map(fn ($class) => [$class], HydeCoreExtension::getPageClasses())
+            array_map(fn ($class) => str($class)->classBasename()->snake(' ')->plural()->toString(), HydeCoreExtension::getPageClasses()),
+            array_map(fn ($class) => [$class], HydeCoreExtension::getPageClasses())
         );
     }
 }

From 73631344c2e927c786fdb3801eca20c90f9c7ba7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 18:45:22 +0200
Subject: [PATCH 1842/4023] Add matrix tests using data provider

---
 ...lenamePrefixNavigationPriorityUnitTest.php | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 45237ce4c4c..1e07644d1d4 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -144,6 +144,54 @@ public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNo
         $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'));
     }
 
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithNumericalPrefixesAreDetectedForPageType(string $type)
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType(string $type)
+    {
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.'.$type::$fileExtension));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.'.$type::$fileExtension));
+        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividersForPageType(string $type)
+    {
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testSplitNumberAndIdentifierForDeeplyNestedPagesForPageType(string $type)
+    {
+        $this->assertSame([1, 'foo/bar/home.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.'.$type::$fileExtension));
+        $this->assertSame([2, 'foo/bar/about.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.'.$type::$fileExtension));
+        $this->assertSame([3, 'foo/bar/contact.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.'.$type::$fileExtension));
+    }
+
     public function testSplitNumberAndIdentifierForDeeplyNestedPages()
     {
         $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'));

From 85e161d83b55c7d6f4493bd43ca32d8d4f6c80ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 20:45:00 +0200
Subject: [PATCH 1843/4023] Rename helper method to better fit its usage

Renames isIdentifierNumbered to hasNumericalPrefix
---
 .../Factories/NavigationDataFactory.php       |   2 +-
 .../FilenamePrefixNavigationHelper.php        |   4 +-
 .../framework/src/Support/Models/RouteKey.php |   2 +-
 ...lenamePrefixNavigationPriorityUnitTest.php | 132 +++++++++---------
 4 files changed, 70 insertions(+), 70 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 42679f3d1cc..d9cc52590d8 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -247,7 +247,7 @@ private function checkFilePrefixForOrder(): ?int
             return null;
         }
 
-        if (! FilenamePrefixNavigationHelper::isIdentifierNumbered($this->identifier)) {
+        if (! FilenamePrefixNavigationHelper::hasNumericalPrefix($this->identifier)) {
             return null;
         }
 
diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 033bd6d9599..9efcf78e5ce 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -31,7 +31,7 @@ public static function enabled(): bool
     /**
      * Determines if a given identifier has a numerical prefix.
      */
-    public static function isIdentifierNumbered(string $identifier): bool
+    public static function hasNumericalPrefix(string $identifier): bool
     {
         if (self::isIdentifierNested($identifier)) {
             $identifier = self::getCoreIdentifierPart($identifier);
@@ -52,7 +52,7 @@ public static function splitNumberAndIdentifier(string $identifier): array
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        assert(self::isIdentifierNumbered($identifier));
+        assert(self::hasNumericalPrefix($identifier));
 
         $separator = substr(ltrim($identifier, '0123456789'), 0, 1);
         $parts = explode($separator, $identifier, 2);
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index ecf98145996..9353d645cda 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -56,7 +56,7 @@ public static function fromPage(string $pageClass, string $identifier): self
     /** @experimental */
     protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
     {
-        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::isIdentifierNumbered($identifier)) {
+        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::hasNumericalPrefix($identifier)) {
             $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
         }
 
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 1e07644d1d4..862a79db25d 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -31,23 +31,23 @@ public function testEnabledReturnsFalseWhenDisabled()
 
     public function testIdentifiersWithNumericalPrefixesAreDetected()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03-contact.md'));
     }
 
     public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('contact.md'));
     }
 
     public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividers()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03_contact.md'));
     }
 
     public function testSplitNumberAndIdentifier()
@@ -90,23 +90,23 @@ public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNu
 
     public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03-contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/03-contact.md'));
     }
 
     public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/03_contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/03_contact.md'));
     }
 
     public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/contact.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/contact.md'));
     }
 
     public function testSplitNumberAndIdentifierForNestedPages()
@@ -125,23 +125,23 @@ public function testSplitNumberAndIdentifierForNestedPagesWithSnakeCaseDividers(
 
     public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03-contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/01-home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/02-about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/03-contact.md'));
     }
 
     public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/03_contact.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/01_home.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/02_about.md'));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/03_contact.md'));
     }
 
     public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo/bar/contact.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/contact.md'));
     }
 
     /**
@@ -151,9 +151,9 @@ public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNo
      */
     public function testIdentifiersWithNumericalPrefixesAreDetectedForPageType(string $type)
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01-home.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02-about.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03-contact.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01-home.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02-about.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03-contact.'.$type::$fileExtension));
     }
 
     /**
@@ -163,9 +163,9 @@ public function testIdentifiersWithNumericalPrefixesAreDetectedForPageType(strin
      */
     public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType(string $type)
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('home.'.$type::$fileExtension));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('about.'.$type::$fileExtension));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('contact.'.$type::$fileExtension));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('home.'.$type::$fileExtension));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('about.'.$type::$fileExtension));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('contact.'.$type::$fileExtension));
     }
 
     /**
@@ -175,9 +175,9 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType
      */
     public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividersForPageType(string $type)
     {
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('01_home.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('02_about.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::isIdentifierNumbered('03_contact.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.'.$type::$fileExtension));
+        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03_contact.'.$type::$fileExtension));
     }
 
     /**
@@ -208,57 +208,57 @@ public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDiv
 
     public function testNonNumericalPartsAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
 
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo-bar/contact.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/contact.md'));
     }
 
     public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
 
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('foo_bar/contact.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/home.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/about.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/contact.md'));
     }
 
     public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001.foo.md'));
 
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01/foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001/foo.md'));
 
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01—foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001—foo.md'));
 
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01 foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001 foo.md'));
     }
 
     public function testNumericallyPrefixedIdentifiersWithoutDividerAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('1foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('01foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('001foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001foo.md'));
     }
 
     public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDetected()
     {
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one-foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one_foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::isIdentifierNumbered('one.foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one-foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one_foo.md'));
+        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one.foo.md'));
     }
 
     public static function pageTypeProvider(): array

From 6520b7fd8f76dc6829795f8032c1c58207b31272 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 20:48:35 +0200
Subject: [PATCH 1844/4023] Rename helper method to better fit its usage

Renames splitNumberAndIdentifier to splitNumericPrefix
---
 .../Factories/NavigationDataFactory.php       |  2 +-
 .../FilenamePrefixNavigationHelper.php        |  2 +-
 .../framework/src/Support/Models/RouteKey.php |  2 +-
 ...lenamePrefixNavigationPriorityUnitTest.php | 76 +++++++++----------
 4 files changed, 41 insertions(+), 41 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index d9cc52590d8..34118b02ba2 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -251,7 +251,7 @@ private function checkFilePrefixForOrder(): ?int
             return null;
         }
 
-        return FilenamePrefixNavigationHelper::splitNumberAndIdentifier($this->identifier)[0];
+        return FilenamePrefixNavigationHelper::splitNumericPrefix($this->identifier)[0];
     }
 
     private function canUseSubdirectoryForGroups(): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 9efcf78e5ce..858cdece6ba 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -45,7 +45,7 @@ public static function hasNumericalPrefix(string $identifier): bool
      *
      * @return array{integer, string}
      */
-    public static function splitNumberAndIdentifier(string $identifier): array
+    public static function splitNumericPrefix(string $identifier): array
     {
         if (self::isIdentifierNested($identifier)) {
             $parentPath = self::getNestedIdentifierPrefix($identifier);
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 9353d645cda..81b4dc2569e 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -57,7 +57,7 @@ public static function fromPage(string $pageClass, string $identifier): self
     protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
     {
         if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::hasNumericalPrefix($identifier)) {
-            $identifier = FilenamePrefixNavigationHelper::splitNumberAndIdentifier($identifier)[1];
+            $identifier = FilenamePrefixNavigationHelper::splitNumericPrefix($identifier)[1];
         }
 
         return $identifier;
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 862a79db25d..3fe7e159658 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -50,42 +50,42 @@ public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCas
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03_contact.md'));
     }
 
-    public function testSplitNumberAndIdentifier()
+    public function testSplitNumericPrefix()
     {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03-contact.md'));
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('01-home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('02-about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('03-contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierForSnakeCaseDividers()
+    public function testSplitNumericPrefixForSnakeCaseDividers()
     {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('01_home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('02_about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('03_contact.md'));
+        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('01_home.md'));
+        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('02_about.md'));
+        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('03_contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierWithMultipleDigits()
+    public function testSplitNumericPrefixWithMultipleDigits()
     {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789-contact.md'));
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('123-home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('456-about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('789-contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierWithMultipleDigitsAndSnakeCaseDividers()
+    public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDividers()
     {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('123_home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('456_about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('789_contact.md'));
+        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('123_home.md'));
+        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('456_about.md'));
+        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('789_contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierThrowsExceptionWhenIdentifierIsNotNumbered()
+    public function testSplitNumericPrefixThrowsExceptionWhenIdentifierIsNotNumbered()
     {
         $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
 
         $this->expectException(\AssertionError::class);
         $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
 
-        FilenamePrefixNavigationHelper::splitNumberAndIdentifier('home.md');
+        FilenamePrefixNavigationHelper::splitNumericPrefix('home.md');
     }
 
     public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
@@ -109,18 +109,18 @@ public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetec
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierForNestedPages()
+    public function testSplitNumericPrefixForNestedPages()
     {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01-home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02-about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03-contact.md'));
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/01-home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/02-about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/03-contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierForNestedPagesWithSnakeCaseDividers()
+    public function testSplitNumericPrefixForNestedPagesWithSnakeCaseDividers()
     {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/01_home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/02_about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/03_contact.md'));
+        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/01_home.md'));
+        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/02_about.md'));
+        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/03_contact.md'));
     }
 
     public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
@@ -185,25 +185,25 @@ public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCas
      *
      * @dataProvider pageTypeProvider
      */
-    public function testSplitNumberAndIdentifierForDeeplyNestedPagesForPageType(string $type)
+    public function testSplitNumericPrefixForDeeplyNestedPagesForPageType(string $type)
     {
-        $this->assertSame([1, 'foo/bar/home.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.'.$type::$fileExtension));
-        $this->assertSame([2, 'foo/bar/about.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.'.$type::$fileExtension));
-        $this->assertSame([3, 'foo/bar/contact.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.'.$type::$fileExtension));
+        $this->assertSame([1, 'foo/bar/home.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01-home.'.$type::$fileExtension));
+        $this->assertSame([2, 'foo/bar/about.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02-about.'.$type::$fileExtension));
+        $this->assertSame([3, 'foo/bar/contact.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03-contact.'.$type::$fileExtension));
     }
 
-    public function testSplitNumberAndIdentifierForDeeplyNestedPages()
+    public function testSplitNumericPrefixForDeeplyNestedPages()
     {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01-home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02-about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03-contact.md'));
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01-home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02-about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03-contact.md'));
     }
 
-    public function testSplitNumberAndIdentifierForDeeplyNestedPagesWithSnakeCaseDividers()
+    public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDividers()
     {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/01_home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/02_about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumberAndIdentifier('foo/bar/03_contact.md'));
+        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01_home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02_about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03_contact.md'));
     }
 
     public function testNonNumericalPartsAreNotDetected()

From 22a52b2ef91b511ac130ed8d48df3801edc773ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 20:50:19 +0200
Subject: [PATCH 1845/4023] Update test terminology

I think delimiter is better than divider here
---
 ...lenamePrefixNavigationPriorityUnitTest.php | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
index 3fe7e159658..63fa7e10556 100644
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
@@ -43,7 +43,7 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('contact.md'));
     }
 
-    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividers()
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimiters()
     {
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.md'));
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.md'));
@@ -57,7 +57,7 @@ public function testSplitNumericPrefix()
         $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('03-contact.md'));
     }
 
-    public function testSplitNumericPrefixForSnakeCaseDividers()
+    public function testSplitNumericPrefixForSnakeCaseDelimiters()
     {
         $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('01_home.md'));
         $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('02_about.md'));
@@ -71,7 +71,7 @@ public function testSplitNumericPrefixWithMultipleDigits()
         $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('789-contact.md'));
     }
 
-    public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDividers()
+    public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDelimiters()
     {
         $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('123_home.md'));
         $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('456_about.md'));
@@ -95,7 +95,7 @@ public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/03-contact.md'));
     }
 
-    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
     {
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/01_home.md'));
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/02_about.md'));
@@ -116,7 +116,7 @@ public function testSplitNumericPrefixForNestedPages()
         $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/03-contact.md'));
     }
 
-    public function testSplitNumericPrefixForNestedPagesWithSnakeCaseDividers()
+    public function testSplitNumericPrefixForNestedPagesWithSnakeCaseDelimiters()
     {
         $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/01_home.md'));
         $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/02_about.md'));
@@ -130,7 +130,7 @@ public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetec
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/03-contact.md'));
     }
 
-    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDividers()
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
     {
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/01_home.md'));
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/02_about.md'));
@@ -173,7 +173,7 @@ public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType
      *
      * @dataProvider pageTypeProvider
      */
-    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDividersForPageType(string $type)
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimitersForPageType(string $type)
     {
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.'.$type::$fileExtension));
         $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.'.$type::$fileExtension));
@@ -199,7 +199,7 @@ public function testSplitNumericPrefixForDeeplyNestedPages()
         $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03-contact.md'));
     }
 
-    public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDividers()
+    public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDelimiters()
     {
         $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01_home.md'));
         $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02_about.md'));
@@ -217,7 +217,7 @@ public function testNonNumericalPartsAreNotDetected()
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/contact.md'));
     }
 
-    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
+    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDelimiters()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
@@ -228,7 +228,7 @@ public function testNonNumericalPartsAreNotDetectedForSnakeCaseDividers()
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/contact.md'));
     }
 
-    public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetected()
+    public function testNumericallyPrefixedIdentifiersWithUnknownDelimitersAreNotDetected()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1.foo.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01.foo.md'));
@@ -247,14 +247,14 @@ public function testNumericallyPrefixedIdentifiersWithUnknownDividersAreNotDetec
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001 foo.md'));
     }
 
-    public function testNumericallyPrefixedIdentifiersWithoutDividerAreNotDetected()
+    public function testNumericallyPrefixedIdentifiersWithoutDelimiterAreNotDetected()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1foo.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01foo.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001foo.md'));
     }
 
-    public function testNumericallyStringPrefixedIdentifiersWithoutDividerAreNotDetected()
+    public function testNumericallyStringPrefixedIdentifiersWithoutDelimiterAreNotDetected()
     {
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one-foo.md'));
         $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one_foo.md'));

From 4e990e0ec77604dc5200ee11084c5f2c3389c6c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 20:51:02 +0200
Subject: [PATCH 1846/4023] Introduce local variable

In case we want to customize this later it's easier to see here
---
 .../Features/Navigation/FilenamePrefixNavigationHelper.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
index 858cdece6ba..c24ddff61a9 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
@@ -11,6 +11,7 @@
 use function assert;
 use function substr;
 use function explode;
+use function implode;
 use function preg_match;
 
 /**
@@ -37,7 +38,9 @@ public static function hasNumericalPrefix(string $identifier): bool
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        return preg_match('/^\d+[-_]/', $identifier) === 1;
+        $delimiters = implode(['-', '_']);
+
+        return preg_match('/^\d+['.$delimiters.']/', $identifier) === 1;
     }
 
     /**

From 55367c793c94a3402a9b2f737b3444d7712f9c87 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 20:56:50 +0200
Subject: [PATCH 1847/4023] Rename helper class to NumericalPageOrderingHelper

Renames FilenamePrefixNavigationHelper to NumericalPageOrderingHelper
---
 .../Factories/NavigationDataFactory.php       |   8 +-
 ...er.php => NumericalPageOrderingHelper.php} |   2 +-
 .../framework/src/Support/Models/RouteKey.php |   6 +-
 ...hp => NumericalPageOrderingHelperTest.php} |  10 +-
 ...lenamePrefixNavigationPriorityUnitTest.php | 274 ------------------
 .../NumericalPageOrderingHelperUnitTest.php   | 274 ++++++++++++++++++
 6 files changed, 287 insertions(+), 287 deletions(-)
 rename packages/framework/src/Framework/Features/Navigation/{FilenamePrefixNavigationHelper.php => NumericalPageOrderingHelper.php} (98%)
 rename packages/framework/tests/Feature/{FilenamePrefixNavigationPriorityTest.php => NumericalPageOrderingHelperTest.php} (96%)
 delete mode 100644 packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
 create mode 100644 packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 34118b02ba2..e747f27c53e 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -12,7 +12,7 @@
 use Hyde\Framework\Factories\Concerns\CoreDataObject;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\NavigationSchema;
-use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
+use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
 
 use function basename;
 use function array_flip;
@@ -243,15 +243,15 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
 
     private function checkFilePrefixForOrder(): ?int
     {
-        if (! FilenamePrefixNavigationHelper::enabled()) {
+        if (! NumericalPageOrderingHelper::enabled()) {
             return null;
         }
 
-        if (! FilenamePrefixNavigationHelper::hasNumericalPrefix($this->identifier)) {
+        if (! NumericalPageOrderingHelper::hasNumericalPrefix($this->identifier)) {
             return null;
         }
 
-        return FilenamePrefixNavigationHelper::splitNumericPrefix($this->identifier)[0];
+        return NumericalPageOrderingHelper::splitNumericPrefix($this->identifier)[0];
     }
 
     private function canUseSubdirectoryForGroups(): bool
diff --git a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
similarity index 98%
rename from packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
rename to packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index c24ddff61a9..5a7767d053f 100644
--- a/packages/framework/src/Framework/Features/Navigation/FilenamePrefixNavigationHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -19,7 +19,7 @@
  *
  * @experimental The code herein may be moved to more appropriate locations in the future.
  */
-class FilenamePrefixNavigationHelper
+class NumericalPageOrderingHelper
 {
     /**
      * Determines if the feature is enabled.
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 81b4dc2569e..24766e73a11 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -5,7 +5,7 @@
 namespace Hyde\Support\Models;
 
 use Stringable;
-use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
+use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
 
 use function unslash;
 
@@ -56,8 +56,8 @@ public static function fromPage(string $pageClass, string $identifier): self
     /** @experimental */
     protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
     {
-        if (FilenamePrefixNavigationHelper::enabled() && FilenamePrefixNavigationHelper::hasNumericalPrefix($identifier)) {
-            $identifier = FilenamePrefixNavigationHelper::splitNumericPrefix($identifier)[1];
+        if (NumericalPageOrderingHelper::enabled() && NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
+            $identifier = NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
         }
 
         return $identifier;
diff --git a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
similarity index 96%
rename from packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
rename to packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index 05aa57a5d5f..e2a8f09c15e 100644
--- a/packages/framework/tests/Feature/FilenamePrefixNavigationPriorityTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -22,17 +22,17 @@
  * The feature can be disabled in the config. It also works within sidebar groups,
  * so that multiple groups can have the same prefix independent of other groups.
  *
- * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
+ * @covers \Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Factories\NavigationDataFactory // Todo: Update the unit test for this class.
  * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
  *
- * @see \Hyde\Framework\Testing\Unit\FilenamePrefixNavigationPriorityUnitTest
+ * @see \Hyde\Framework\Testing\Unit\NumericalPageOrderingHelperUnitTest
  *
  * Todo: Add test to ensure explicitly set priority overrides filename prefix.
  */
-class FilenamePrefixNavigationPriorityTest extends TestCase
+class NumericalPageOrderingHelperTest extends TestCase
 {
     protected function setUp(): void
     {
@@ -291,9 +291,9 @@ protected function arrayReverseRecursive(array $array): array
 
 class FilenamePrefixNavigationPriorityTestingHelper
 {
-    protected FilenamePrefixNavigationPriorityTest $test;
+    protected NumericalPageOrderingHelperTest $test;
 
-    public function __construct(FilenamePrefixNavigationPriorityTest $test)
+    public function __construct(NumericalPageOrderingHelperTest $test)
     {
         $this->test = $test;
     }
diff --git a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php b/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
deleted file mode 100644
index 63fa7e10556..00000000000
--- a/packages/framework/tests/Unit/FilenamePrefixNavigationPriorityUnitTest.php
+++ /dev/null
@@ -1,274 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Testing\UnitTestCase;
-use Hyde\Foundation\HydeCoreExtension;
-use Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\FilenamePrefixNavigationHelper
- *
- * @see \Hyde\Framework\Testing\Feature\FilenamePrefixNavigationPriorityTest
- */
-class FilenamePrefixNavigationPriorityUnitTest extends UnitTestCase
-{
-    protected static bool $needsConfig = true;
-
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::enabled());
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03-contact.md'));
-    }
-
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('contact.md'));
-    }
-
-    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimiters()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03_contact.md'));
-    }
-
-    public function testSplitNumericPrefix()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('01-home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('02-about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('03-contact.md'));
-    }
-
-    public function testSplitNumericPrefixForSnakeCaseDelimiters()
-    {
-        $this->assertSame([1, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('01_home.md'));
-        $this->assertSame([2, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('02_about.md'));
-        $this->assertSame([3, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('03_contact.md'));
-    }
-
-    public function testSplitNumericPrefixWithMultipleDigits()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('123-home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('456-about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('789-contact.md'));
-    }
-
-    public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDelimiters()
-    {
-        $this->assertSame([123, 'home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('123_home.md'));
-        $this->assertSame([456, 'about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('456_about.md'));
-        $this->assertSame([789, 'contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('789_contact.md'));
-    }
-
-    public function testSplitNumericPrefixThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        FilenamePrefixNavigationHelper::splitNumericPrefix('home.md');
-    }
-
-    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/03-contact.md'));
-    }
-
-    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/03_contact.md'));
-    }
-
-    public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/contact.md'));
-    }
-
-    public function testSplitNumericPrefixForNestedPages()
-    {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/01-home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/02-about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/03-contact.md'));
-    }
-
-    public function testSplitNumericPrefixForNestedPagesWithSnakeCaseDelimiters()
-    {
-        $this->assertSame([1, 'foo/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/01_home.md'));
-        $this->assertSame([2, 'foo/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/02_about.md'));
-        $this->assertSame([3, 'foo/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/03_contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/01-home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/02-about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/03-contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/01_home.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/02_about.md'));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/03_contact.md'));
-    }
-
-    public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo/bar/contact.md'));
-    }
-
-    /**
-     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
-     *
-     * @dataProvider pageTypeProvider
-     */
-    public function testIdentifiersWithNumericalPrefixesAreDetectedForPageType(string $type)
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01-home.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02-about.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03-contact.'.$type::$fileExtension));
-    }
-
-    /**
-     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
-     *
-     * @dataProvider pageTypeProvider
-     */
-    public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType(string $type)
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('home.'.$type::$fileExtension));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('about.'.$type::$fileExtension));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('contact.'.$type::$fileExtension));
-    }
-
-    /**
-     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
-     *
-     * @dataProvider pageTypeProvider
-     */
-    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimitersForPageType(string $type)
-    {
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('01_home.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('02_about.'.$type::$fileExtension));
-        $this->assertTrue(FilenamePrefixNavigationHelper::hasNumericalPrefix('03_contact.'.$type::$fileExtension));
-    }
-
-    /**
-     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
-     *
-     * @dataProvider pageTypeProvider
-     */
-    public function testSplitNumericPrefixForDeeplyNestedPagesForPageType(string $type)
-    {
-        $this->assertSame([1, 'foo/bar/home.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01-home.'.$type::$fileExtension));
-        $this->assertSame([2, 'foo/bar/about.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02-about.'.$type::$fileExtension));
-        $this->assertSame([3, 'foo/bar/contact.'.$type::$fileExtension], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03-contact.'.$type::$fileExtension));
-    }
-
-    public function testSplitNumericPrefixForDeeplyNestedPages()
-    {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01-home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02-about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03-contact.md'));
-    }
-
-    public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDelimiters()
-    {
-        $this->assertSame([1, 'foo/bar/home.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/01_home.md'));
-        $this->assertSame([2, 'foo/bar/about.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/02_about.md'));
-        $this->assertSame([3, 'foo/bar/contact.md'], FilenamePrefixNavigationHelper::splitNumericPrefix('foo/bar/03_contact.md'));
-    }
-
-    public function testNonNumericalPartsAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo-bar/contact.md'));
-    }
-
-    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDelimiters()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/home.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/about.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('foo_bar/contact.md'));
-    }
-
-    public function testNumericallyPrefixedIdentifiersWithUnknownDelimitersAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01.foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001.foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01/foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001/foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01—foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001—foo.md'));
-
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01 foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001 foo.md'));
-    }
-
-    public function testNumericallyPrefixedIdentifiersWithoutDelimiterAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('1foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('01foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('001foo.md'));
-    }
-
-    public function testNumericallyStringPrefixedIdentifiersWithoutDelimiterAreNotDetected()
-    {
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one-foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one_foo.md'));
-        $this->assertFalse(FilenamePrefixNavigationHelper::hasNumericalPrefix('one.foo.md'));
-    }
-
-    public static function pageTypeProvider(): array
-    {
-        self::needsKernel();
-        self::mockConfig();
-
-        return array_combine(
-            array_map(fn ($class) => str($class)->classBasename()->snake(' ')->plural()->toString(), HydeCoreExtension::getPageClasses()),
-            array_map(fn ($class) => [$class], HydeCoreExtension::getPageClasses())
-        );
-    }
-}
diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
new file mode 100644
index 00000000000..57d50717fdd
--- /dev/null
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -0,0 +1,274 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\HydeCoreExtension;
+use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper
+ *
+ * @see \Hyde\Framework\Testing\Feature\NumericalPageOrderingHelperTest
+ */
+class NumericalPageOrderingHelperUnitTest extends UnitTestCase
+{
+    protected static bool $needsConfig = true;
+
+    public function testEnabledReturnsTrueWhenEnabled()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::enabled());
+    }
+
+    public function testEnabledReturnsFalseWhenDisabled()
+    {
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
+
+        $this->assertFalse(NumericalPageOrderingHelper::enabled());
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('02-about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('03-contact.md'));
+    }
+
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('home.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('about.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('contact.md'));
+    }
+
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimiters()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01_home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('02_about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('03_contact.md'));
+    }
+
+    public function testSplitNumericPrefix()
+    {
+        $this->assertSame([1, 'home.md'], NumericalPageOrderingHelper::splitNumericPrefix('01-home.md'));
+        $this->assertSame([2, 'about.md'], NumericalPageOrderingHelper::splitNumericPrefix('02-about.md'));
+        $this->assertSame([3, 'contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('03-contact.md'));
+    }
+
+    public function testSplitNumericPrefixForSnakeCaseDelimiters()
+    {
+        $this->assertSame([1, 'home.md'], NumericalPageOrderingHelper::splitNumericPrefix('01_home.md'));
+        $this->assertSame([2, 'about.md'], NumericalPageOrderingHelper::splitNumericPrefix('02_about.md'));
+        $this->assertSame([3, 'contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('03_contact.md'));
+    }
+
+    public function testSplitNumericPrefixWithMultipleDigits()
+    {
+        $this->assertSame([123, 'home.md'], NumericalPageOrderingHelper::splitNumericPrefix('123-home.md'));
+        $this->assertSame([456, 'about.md'], NumericalPageOrderingHelper::splitNumericPrefix('456-about.md'));
+        $this->assertSame([789, 'contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('789-contact.md'));
+    }
+
+    public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDelimiters()
+    {
+        $this->assertSame([123, 'home.md'], NumericalPageOrderingHelper::splitNumericPrefix('123_home.md'));
+        $this->assertSame([456, 'about.md'], NumericalPageOrderingHelper::splitNumericPrefix('456_about.md'));
+        $this->assertSame([789, 'contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('789_contact.md'));
+    }
+
+    public function testSplitNumericPrefixThrowsExceptionWhenIdentifierIsNotNumbered()
+    {
+        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
+
+        $this->expectException(\AssertionError::class);
+        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
+
+        NumericalPageOrderingHelper::splitNumericPrefix('home.md');
+    }
+
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/01-home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/02-about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/03-contact.md'));
+    }
+
+    public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/01_home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/02_about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/03_contact.md'));
+    }
+
+    public function testIdentifiersForNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/home.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/about.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/contact.md'));
+    }
+
+    public function testSplitNumericPrefixForNestedPages()
+    {
+        $this->assertSame([1, 'foo/home.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/01-home.md'));
+        $this->assertSame([2, 'foo/about.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/02-about.md'));
+        $this->assertSame([3, 'foo/contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/03-contact.md'));
+    }
+
+    public function testSplitNumericPrefixForNestedPagesWithSnakeCaseDelimiters()
+    {
+        $this->assertSame([1, 'foo/home.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/01_home.md'));
+        $this->assertSame([2, 'foo/about.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/02_about.md'));
+        $this->assertSame([3, 'foo/contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/03_contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetected()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/01-home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/02-about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/03-contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithNumericalPrefixesAreDetectedUsingSnakeCaseDelimiters()
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/01_home.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/02_about.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/03_contact.md'));
+    }
+
+    public function testIdentifiersForDeeplyNestedPagesWithoutNumericalPrefixesAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/home.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/about.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo/bar/contact.md'));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithNumericalPrefixesAreDetectedForPageType(string $type)
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-home.'.$type::$fileExtension));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('02-about.'.$type::$fileExtension));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('03-contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithoutNumericalPrefixesAreNotDetectedForPageType(string $type)
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('home.'.$type::$fileExtension));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('about.'.$type::$fileExtension));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testIdentifiersWithNumericalPrefixesAreDetectedWhenUsingSnakeCaseDelimitersForPageType(string $type)
+    {
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01_home.'.$type::$fileExtension));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('02_about.'.$type::$fileExtension));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('03_contact.'.$type::$fileExtension));
+    }
+
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $type
+     *
+     * @dataProvider pageTypeProvider
+     */
+    public function testSplitNumericPrefixForDeeplyNestedPagesForPageType(string $type)
+    {
+        $this->assertSame([1, 'foo/bar/home.'.$type::$fileExtension], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/01-home.'.$type::$fileExtension));
+        $this->assertSame([2, 'foo/bar/about.'.$type::$fileExtension], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/02-about.'.$type::$fileExtension));
+        $this->assertSame([3, 'foo/bar/contact.'.$type::$fileExtension], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/03-contact.'.$type::$fileExtension));
+    }
+
+    public function testSplitNumericPrefixForDeeplyNestedPages()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/01-home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/02-about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/03-contact.md'));
+    }
+
+    public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDelimiters()
+    {
+        $this->assertSame([1, 'foo/bar/home.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/01_home.md'));
+        $this->assertSame([2, 'foo/bar/about.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/02_about.md'));
+        $this->assertSame([3, 'foo/bar/contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/03_contact.md'));
+    }
+
+    public function testNonNumericalPartsAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar.md'));
+
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar/home.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar/about.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar/contact.md'));
+    }
+
+    public function testNonNumericalPartsAreNotDetectedForSnakeCaseDelimiters()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar.md'));
+
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar/home.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar/about.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo_bar/contact.md'));
+    }
+
+    public function testNumericallyPrefixedIdentifiersWithUnknownDelimitersAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('1.foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01.foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('001.foo.md'));
+
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('1/foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01/foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('001/foo.md'));
+
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('1—foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01—foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('001—foo.md'));
+
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('1 foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01 foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('001 foo.md'));
+    }
+
+    public function testNumericallyPrefixedIdentifiersWithoutDelimiterAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('1foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('001foo.md'));
+    }
+
+    public function testNumericallyStringPrefixedIdentifiersWithoutDelimiterAreNotDetected()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('one-foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('one_foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('one.foo.md'));
+    }
+
+    public static function pageTypeProvider(): array
+    {
+        self::needsKernel();
+        self::mockConfig();
+
+        return array_combine(
+            array_map(fn ($class) => str($class)->classBasename()->snake(' ')->plural()->toString(), HydeCoreExtension::getPageClasses()),
+            array_map(fn ($class) => [$class], HydeCoreExtension::getPageClasses())
+        );
+    }
+}

From 5854ad85d915339e1522c23c5f0b4e3d453a42bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:00:52 +0200
Subject: [PATCH 1848/4023] Remove experimental marker, keeping internal marker

I don't see much use for this class outside of the framework internals
---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 5a7767d053f..8fe32a32387 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -16,8 +16,6 @@
 
 /**
  * @internal Helper class for the new Filename Prefix Navigation feature.
- *
- * @experimental The code herein may be moved to more appropriate locations in the future.
  */
 class NumericalPageOrderingHelper
 {

From 7e02a740ee0be9ceba2728a9f13d780135f61b6e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:01:46 +0200
Subject: [PATCH 1849/4023] Update internal marker reasoning

---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 8fe32a32387..71136ba3b94 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -15,7 +15,7 @@
 use function preg_match;
 
 /**
- * @internal Helper class for the new Filename Prefix Navigation feature.
+ * @internal This class contains shared helper code for the framework to provide numerical page ordering. It is not intended to be used outside the framework code internals.
  */
 class NumericalPageOrderingHelper
 {

From d3893e4a728619e08f1fc9b88cb79639c3094961 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:03:19 +0200
Subject: [PATCH 1850/4023] Remove assertions from the code

Since this is an internal class we do not need these sanity checks as we know we provide valid states. If we make the class public we instead want to throw proper exceptions.
---
 .../Navigation/NumericalPageOrderingHelper.php         |  7 -------
 .../tests/Unit/NumericalPageOrderingHelperUnitTest.php | 10 ----------
 2 files changed, 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 71136ba3b94..6d724e60f6f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -8,7 +8,6 @@
 use Illuminate\Support\Str;
 
 use function ltrim;
-use function assert;
 use function substr;
 use function explode;
 use function implode;
@@ -53,8 +52,6 @@ public static function splitNumericPrefix(string $identifier): array
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        assert(self::hasNumericalPrefix($identifier));
-
         $separator = substr(ltrim($identifier, '0123456789'), 0, 1);
         $parts = explode($separator, $identifier, 2);
 
@@ -74,15 +71,11 @@ protected static function isIdentifierNested(string $identifier): bool
 
     protected static function getNestedIdentifierPrefix(string $identifier): string
     {
-        assert(self::isIdentifierNested($identifier));
-
         return Str::beforeLast($identifier, '/');
     }
 
     protected static function getCoreIdentifierPart(string $identifier): string
     {
-        assert(self::isIdentifierNested($identifier));
-
         return Str::afterLast($identifier, '/');
     }
 }
diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
index 57d50717fdd..b715332c15a 100644
--- a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -78,16 +78,6 @@ public function testSplitNumericPrefixWithMultipleDigitsAndSnakeCaseDelimiters()
         $this->assertSame([789, 'contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('789_contact.md'));
     }
 
-    public function testSplitNumericPrefixThrowsExceptionWhenIdentifierIsNotNumbered()
-    {
-        $this->markTestSkipped('Since this is an internal class at the moment, we do not need to test this. If we want this in the public API it should be a badmethodcall exception.');
-
-        $this->expectException(\AssertionError::class);
-        $this->expectExceptionMessage('Identifier "home.md" is not numbered.');
-
-        NumericalPageOrderingHelper::splitNumericPrefix('home.md');
-    }
-
     public function testIdentifiersForNestedPagesWithNumericalPrefixesAreDetected()
     {
         $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('foo/01-home.md'));

From 91db72b1eec380c4bd2bd98a7c58bc68b5df1e44 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:06:09 +0200
Subject: [PATCH 1851/4023] Extract helper method

---
 .../Features/Navigation/NumericalPageOrderingHelper.php    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 6d724e60f6f..098743202c3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -52,7 +52,7 @@ public static function splitNumericPrefix(string $identifier): array
             $identifier = self::getCoreIdentifierPart($identifier);
         }
 
-        $separator = substr(ltrim($identifier, '0123456789'), 0, 1);
+        $separator = self::getFirstCharacterFromIdentifier($identifier);
         $parts = explode($separator, $identifier, 2);
 
         $parts[0] = (int) $parts[0];
@@ -78,4 +78,9 @@ protected static function getCoreIdentifierPart(string $identifier): string
     {
         return Str::afterLast($identifier, '/');
     }
+
+    protected static function getFirstCharacterFromIdentifier(string $identifier): string
+    {
+        return substr(ltrim($identifier, '0123456789'), 0, 1);
+    }
 }

From dfed72dc920451fa698db10627570e2ca9e75073 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:06:26 +0200
Subject: [PATCH 1852/4023] Use static instead of self

---
 .../Navigation/NumericalPageOrderingHelper.php       | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 098743202c3..f44ab1b903f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -31,8 +31,8 @@ public static function enabled(): bool
      */
     public static function hasNumericalPrefix(string $identifier): bool
     {
-        if (self::isIdentifierNested($identifier)) {
-            $identifier = self::getCoreIdentifierPart($identifier);
+        if (static::isIdentifierNested($identifier)) {
+            $identifier = static::getCoreIdentifierPart($identifier);
         }
 
         $delimiters = implode(['-', '_']);
@@ -47,12 +47,12 @@ public static function hasNumericalPrefix(string $identifier): bool
      */
     public static function splitNumericPrefix(string $identifier): array
     {
-        if (self::isIdentifierNested($identifier)) {
-            $parentPath = self::getNestedIdentifierPrefix($identifier);
-            $identifier = self::getCoreIdentifierPart($identifier);
+        if (static::isIdentifierNested($identifier)) {
+            $parentPath = static::getNestedIdentifierPrefix($identifier);
+            $identifier = static::getCoreIdentifierPart($identifier);
         }
 
-        $separator = self::getFirstCharacterFromIdentifier($identifier);
+        $separator = static::getFirstCharacterFromIdentifier($identifier);
         $parts = explode($separator, $identifier, 2);
 
         $parts[0] = (int) $parts[0];

From b5349bd5cf4b4781ee552a75c52cb01896cf27e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:07:33 +0200
Subject: [PATCH 1853/4023] Convert local variable contents to protected class
 constant

---
 .../Navigation/NumericalPageOrderingHelper.php        | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index f44ab1b903f..27c9f58b70e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -18,6 +18,13 @@
  */
 class NumericalPageOrderingHelper
 {
+    /**
+     * The delimiters that are used to separate the numerical prefix from the rest of the identifier.
+     *
+     * @var array<string>
+     */
+    protected const DELIMITERS = ['-', '_'];
+
     /**
      * Determines if the feature is enabled.
      */
@@ -35,9 +42,7 @@ public static function hasNumericalPrefix(string $identifier): bool
             $identifier = static::getCoreIdentifierPart($identifier);
         }
 
-        $delimiters = implode(['-', '_']);
-
-        return preg_match('/^\d+['.$delimiters.']/', $identifier) === 1;
+        return preg_match('/^\d+['.implode(static::DELIMITERS).']/', $identifier) === 1;
     }
 
     /**

From 2c36b6dc5bfcee7e49e7df937cb13b50a9a00ce4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:08:26 +0200
Subject: [PATCH 1854/4023] Convert concatenation to 'sprintf()' call

---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 27c9f58b70e..4fc85c20001 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -42,7 +42,7 @@ public static function hasNumericalPrefix(string $identifier): bool
             $identifier = static::getCoreIdentifierPart($identifier);
         }
 
-        return preg_match('/^\d+['.implode(static::DELIMITERS).']/', $identifier) === 1;
+        return preg_match(sprintf('/^\d+[%s]/', implode(static::DELIMITERS)), $identifier) === 1;
     }
 
     /**

From bae9e7fd8b73908e1d8ce3d954a8c176b6a7065c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:09:05 +0200
Subject: [PATCH 1855/4023] Import used function

---
 .../Features/Navigation/NumericalPageOrderingHelper.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 4fc85c20001..ae95912a5c8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -11,6 +11,7 @@
 use function substr;
 use function explode;
 use function implode;
+use function sprintf;
 use function preg_match;
 
 /**

From d2687560d8a866a3f94da3a1635e014a1eb5b740 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:09:37 +0200
Subject: [PATCH 1856/4023] Convert concatenation to string interpolation

---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index ae95912a5c8..97762144d01 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -64,7 +64,7 @@ public static function splitNumericPrefix(string $identifier): array
         $parts[0] = (int) $parts[0];
 
         if (isset($parentPath)) {
-            $parts[1] = $parentPath.'/'.$parts[1];
+            $parts[1] = "$parentPath/$parts[1]";
         }
 
         return $parts;

From 133d5079ef9fb29d74ec359ca95b985d9dcf2dde Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:10:36 +0200
Subject: [PATCH 1857/4023] Use clearer language in description

---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 97762144d01..e310f64b520 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -27,7 +27,7 @@ class NumericalPageOrderingHelper
     protected const DELIMITERS = ['-', '_'];
 
     /**
-     * Determines if the feature is enabled.
+     * Check if the feature is enabled.
      */
     public static function enabled(): bool
     {

From 2a2780f52c88ce6645ddd818cd461a401a19f835 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:11:36 +0200
Subject: [PATCH 1858/4023] Compress PHPDoc annotations

---
 .../Navigation/NumericalPageOrderingHelper.php  | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index e310f64b520..581d11f085f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -15,28 +15,21 @@
 use function preg_match;
 
 /**
- * @internal This class contains shared helper code for the framework to provide numerical page ordering. It is not intended to be used outside the framework code internals.
+ * @internal This class contains shared helper code for the framework to provide numerical page ordering.
+ *           It is not intended to be used outside the framework code internals.
  */
 class NumericalPageOrderingHelper
 {
-    /**
-     * The delimiters that are used to separate the numerical prefix from the rest of the identifier.
-     *
-     * @var array<string>
-     */
+    /** @var array<string> The delimiters that are used to separate the numerical prefix from the rest of the identifier. */
     protected const DELIMITERS = ['-', '_'];
 
-    /**
-     * Check if the feature is enabled.
-     */
+    /** Check if the feature is enabled. */
     public static function enabled(): bool
     {
         return Config::getBool('hyde.numerical_page_ordering', true);
     }
 
-    /**
-     * Determines if a given identifier has a numerical prefix.
-     */
+    /** Determines if a given identifier has a numerical prefix. */
     public static function hasNumericalPrefix(string $identifier): bool
     {
         if (static::isIdentifierNested($identifier)) {

From d87645c712e4b938fb423ed88d1b333f230516ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:13:03 +0200
Subject: [PATCH 1859/4023] Test feature is enabled by default

---
 .../tests/Unit/NumericalPageOrderingHelperUnitTest.php     | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
index b715332c15a..70c0290ac98 100644
--- a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -29,6 +29,13 @@ public function testEnabledReturnsFalseWhenDisabled()
         $this->assertFalse(NumericalPageOrderingHelper::enabled());
     }
 
+    public function testFeatureIsEnabledByDefault()
+    {
+        self::mockConfig(['hyde' => []]);
+
+        $this->assertTrue(NumericalPageOrderingHelper::enabled());
+    }
+
     public function testIdentifiersWithNumericalPrefixesAreDetected()
     {
         $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-home.md'));

From 9b1dcd0611a57192e3ffb1d4e210048c4b2ff705 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 6 May 2024 21:13:17 +0200
Subject: [PATCH 1860/4023] Swap test method order

---
 .../Unit/NumericalPageOrderingHelperUnitTest.php     | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
index 70c0290ac98..e93302cb52c 100644
--- a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -22,18 +22,18 @@ public function testEnabledReturnsTrueWhenEnabled()
         $this->assertTrue(NumericalPageOrderingHelper::enabled());
     }
 
-    public function testEnabledReturnsFalseWhenDisabled()
+    public function testFeatureIsEnabledByDefault()
     {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
+        self::mockConfig(['hyde' => []]);
 
-        $this->assertFalse(NumericalPageOrderingHelper::enabled());
+        $this->assertTrue(NumericalPageOrderingHelper::enabled());
     }
 
-    public function testFeatureIsEnabledByDefault()
+    public function testEnabledReturnsFalseWhenDisabled()
     {
-        self::mockConfig(['hyde' => []]);
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
 
-        $this->assertTrue(NumericalPageOrderingHelper::enabled());
+        $this->assertFalse(NumericalPageOrderingHelper::enabled());
     }
 
     public function testIdentifiersWithNumericalPrefixesAreDetected()

From 1494cd069b841f0e9869106b4c68e272f9ecd29b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 7 May 2024 09:22:48 +0200
Subject: [PATCH 1861/4023] Update unit test to mock the config

---
 packages/framework/tests/Unit/RouteKeyTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index ce7b50a18ce..4c0ab309f81 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -18,6 +18,8 @@
  */
 class RouteKeyTest extends UnitTestCase
 {
+    protected static bool $needsConfig = true;
+
     public function testMake()
     {
         $this->assertEquals(RouteKey::make('foo'), new RouteKey('foo'));

From 3f9b39d09f3fc4361092c5cb0f62e39738eb77ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 7 May 2024 10:37:37 +0200
Subject: [PATCH 1862/4023] Create route key unit tests for numerical prefix
 extraction

Based on the navigation data factory unit tests, but to test the ancillary extraction
---
 .../framework/tests/Unit/RouteKeyTest.php     | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index 4c0ab309f81..d906bd1ebfa 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -95,6 +95,56 @@ public function testFromPageWithCustomNestedOutputDirectory()
         $this->assertEquals(new RouteKey('foo/bar/baz'), RouteKey::fromPage(MarkdownPage::class, 'baz'));
     }
 
+    public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefix()
+    {
+        $this->assertSame('test', RouteKey::fromPage(InMemoryPage::class, '01-test')->get());
+    }
+
+    public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithKebabCaseSyntax()
+    {
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '01-foo')->get());
+        $this->assertSame('bar', RouteKey::fromPage(InMemoryPage::class, '02-bar')->get());
+        $this->assertSame('baz', RouteKey::fromPage(InMemoryPage::class, '03-baz')->get());
+    }
+
+    public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithSnakeCaseSyntax()
+    {
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '01_foo')->get());
+        $this->assertSame('bar', RouteKey::fromPage(InMemoryPage::class, '02_bar')->get());
+        $this->assertSame('baz', RouteKey::fromPage(InMemoryPage::class, '03_baz')->get());
+    }
+
+    public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixRegardlessOfLeadingZeroes()
+    {
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '0123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '00123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '000123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '0000123-foo')->get());
+    }
+
+    public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixForNestedIdentifiers()
+    {
+        $this->assertSame('foo/bar', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar')->get());
+        $this->assertSame('foo/bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/bar/02-baz')->get());
+        $this->assertSame('foo/01-bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar/03-baz')->get());
+    }
+
+    public function testItDoesNotExtractCoreIdentifierPartFromNumericalFilenamePrefixWhenFeatureIsDisabled()
+    {
+        self::mockConfig(['hyde.numerical_page_ordering' => false]);
+
+        $this->assertSame('01-test', RouteKey::fromPage(InMemoryPage::class, '01-test')->get());
+        $this->assertSame('01-home', RouteKey::fromPage(InMemoryPage::class, '01-home')->get());
+        $this->assertSame('01-404', RouteKey::fromPage(InMemoryPage::class, '01-404')->get());
+    }
+
+    public function testItDoesNotExtractNonNumericalFilenamePrefixes()
+    {
+        $this->assertSame('foo-bar', RouteKey::fromPage(InMemoryPage::class, 'foo-bar')->get());
+        $this->assertSame('abc-bar', RouteKey::fromPage(InMemoryPage::class, 'abc-bar')->get());
+    }
+
     public static function tearDownAfterClass(): void
     {
         MarkdownPage::setOutputDirectory('');

From df063897953e3bfb4f5b94f422dd6fbeb498988d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 7 May 2024 10:42:28 +0200
Subject: [PATCH 1863/4023] Replace assignment with early return

---
 packages/framework/src/Support/Models/RouteKey.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 24766e73a11..75cf142e082 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -57,7 +57,7 @@ public static function fromPage(string $pageClass, string $identifier): self
     protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
     {
         if (NumericalPageOrderingHelper::enabled() && NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
-            $identifier = NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
+            return NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
         }
 
         return $identifier;

From 429931dba8e39a1d540a111d8a104a0ce487957f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 8 May 2024 19:13:15 +0200
Subject: [PATCH 1864/4023] Remove resolved todos

---
 .../tests/Feature/NumericalPageOrderingHelperTest.php         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index e2a8f09c15e..46d4dbe675e 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -25,8 +25,8 @@
  * @covers \Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper
  * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
- * @covers \Hyde\Framework\Factories\NavigationDataFactory // Todo: Update the unit test for this class.
- * @covers \Hyde\Support\Models\RouteKey // Todo: Update the unit test for this class.
+ * @covers \Hyde\Framework\Factories\NavigationDataFactory
+ * @covers \Hyde\Support\Models\RouteKey
  *
  * @see \Hyde\Framework\Testing\Unit\NumericalPageOrderingHelperUnitTest
  *

From 4ec0d8cb76dab6e199e98078ac8255c94ce3db17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 8 May 2024 19:47:41 +0200
Subject: [PATCH 1865/4023] Add test to ensure explicitly set priority
 overrides filename prefix

---
 .../tests/Feature/NumericalPageOrderingHelperTest.php     | 2 --
 .../tests/Unit/NavigationDataFactoryUnitTest.php          | 8 ++++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index 46d4dbe675e..fd63b499c13 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -29,8 +29,6 @@
  * @covers \Hyde\Support\Models\RouteKey
  *
  * @see \Hyde\Framework\Testing\Unit\NumericalPageOrderingHelperUnitTest
- *
- * Todo: Add test to ensure explicitly set priority overrides filename prefix.
  */
 class NumericalPageOrderingHelperTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index 08824908383..eccd5604465 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -320,6 +320,14 @@ public function testItDoesNotExtractNonNumericalFilenamePrefixes()
         $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('abc-bar.md')))->makePriority());
     }
 
+    public function testFrontMatterValueOverridesFilenamePrefixPriority()
+    {
+        $coreDataObject = new CoreDataObject(new FrontMatter(['navigation.priority' => 10]), new Markdown(), markdownPage::class, '05-test', '', '', '');
+        $factory = new NavigationConfigTestClass($coreDataObject);
+
+        $this->assertSame(10, $factory->makePriority());
+    }
+
     protected function makeCoreDataObject(string $identifier = '', string $routeKey = '', string $pageClass = MarkdownPage::class): CoreDataObject
     {
         return new CoreDataObject(new FrontMatter(), new Markdown(), $pageClass, $identifier, '', '', $routeKey);

From d3c0e751f0292146ffd2297b64d52d42698713da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 9 May 2024 14:28:48 +0200
Subject: [PATCH 1866/4023] Draft test sidebar group priorities can be set with
 numerical prefix

---
 .../tests/Feature/NumericalPageOrderingHelperTest.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index fd63b499c13..e0f6a4416e3 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -249,6 +249,15 @@ public function testOrderingWithDifferentFileExtensions()
         $this->assertOrder(['foo', 'bar', 'baz']);
     }
 
+    public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
+    {
+        $this->directory('_docs/03-getting-started');
+        $this->file('_docs/03-getting-started/05-advanced.md');
+
+        $page = DocumentationPage::parse('getting-started/advanced');
+        $this->assertInstanceOf(DocumentationPage::class, $page);
+    }
+
     protected function setUpSidebarFixture(array $files): self
     {
         return $this->setupFixture($files, sidebar: true);

From 2a6ebb8e8f9fceb1eef4eaa357114dc8b298a80f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 9 May 2024 16:38:04 +0200
Subject: [PATCH 1867/4023] Fix identifier syntax still have the prefixes in
 test

---
 .../framework/tests/Feature/NumericalPageOrderingHelperTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index e0f6a4416e3..a5f481320e3 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -254,7 +254,7 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
         $this->directory('_docs/03-getting-started');
         $this->file('_docs/03-getting-started/05-advanced.md');
 
-        $page = DocumentationPage::parse('getting-started/advanced');
+        $page = DocumentationPage::parse('03-getting-started/05-advanced');
         $this->assertInstanceOf(DocumentationPage::class, $page);
     }
 

From d10c541ea509fe689ae993a33d7d1684bbf9cb7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 9 May 2024 16:39:30 +0200
Subject: [PATCH 1868/4023] Add initial assertions

---
 .../tests/Feature/NumericalPageOrderingHelperTest.php          | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index a5f481320e3..cc4661663f5 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -256,6 +256,9 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
 
         $page = DocumentationPage::parse('03-getting-started/05-advanced');
         $this->assertInstanceOf(DocumentationPage::class, $page);
+
+        $this->assertSame('docs/advanced', $page->getRouteKey());
+        $this->assertSame('docs/advanced.html', $page->getOutputPath());
     }
 
     protected function setUpSidebarFixture(array $files): self

From 29455922bfbb78c663fde76e896f8a760dd297cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 9 May 2024 16:42:53 +0200
Subject: [PATCH 1869/4023] Test without flattened output paths

---
 .../Feature/NumericalPageOrderingHelperTest.php   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index cc4661663f5..a40e28f0e0d 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -261,6 +261,21 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
         $this->assertSame('docs/advanced.html', $page->getOutputPath());
     }
 
+
+    public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefixWithoutFlattenedOutputPaths()
+    {
+        config(['docs.flattened_output_paths' => false]);
+
+        $this->directory('_docs/03-getting-started');
+        $this->file('_docs/03-getting-started/05-advanced.md');
+
+        $page = DocumentationPage::parse('03-getting-started/05-advanced');
+        $this->assertInstanceOf(DocumentationPage::class, $page);
+
+        $this->assertSame('docs/getting-started/advanced', $page->getRouteKey());
+        $this->assertSame('docs/getting-started/advanced.html', $page->getOutputPath());
+    }
+
     protected function setUpSidebarFixture(array $files): self
     {
         return $this->setupFixture($files, sidebar: true);

From eb68285ade64e4c5a6026128d8419c64556f83ee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 9 May 2024 17:16:46 +0200
Subject: [PATCH 1870/4023] Assert the subdirectory group is trimmed from
 numerical prefix

---
 .../framework/tests/Feature/NumericalPageOrderingHelperTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index a40e28f0e0d..0341a60b011 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -259,6 +259,7 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
 
         $this->assertSame('docs/advanced', $page->getRouteKey());
         $this->assertSame('docs/advanced.html', $page->getOutputPath());
+        $this->assertSame('getting-started', $page->navigationMenuGroup());
     }
 
 
@@ -274,6 +275,7 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefixWithoutFlat
 
         $this->assertSame('docs/getting-started/advanced', $page->getRouteKey());
         $this->assertSame('docs/getting-started/advanced.html', $page->getOutputPath());
+        $this->assertSame('getting-started', $page->navigationMenuGroup());
     }
 
     protected function setUpSidebarFixture(array $files): self

From 798eedaaf3041cc107790748ae702e3d96db3f26 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 10 May 2024 14:18:27 +0200
Subject: [PATCH 1871/4023] Split numerical prefix when making group identifier

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index e747f27c53e..b7b331e6db6 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -80,7 +80,9 @@ protected function makeLabel(): ?string
     protected function makeGroup(): ?string
     {
         if ($this->pageIsInSubdirectory() && $this->canUseSubdirectoryForGroups()) {
-            return $this->getSubdirectoryName();
+            return NumericalPageOrderingHelper::hasNumericalPrefix($this->getSubdirectoryName())
+                ? NumericalPageOrderingHelper::splitNumericPrefix($this->getSubdirectoryName())[1]
+                : $this->getSubdirectoryName();
         }
 
         return $this->searchForGroupInFrontMatter();

From 1cf11714bb73933c84dce3b2eb3224240ba00e2c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 10 May 2024 14:18:40 +0200
Subject: [PATCH 1872/4023] Split each part of nested path

---
 .../Features/Navigation/NumericalPageOrderingHelper.php    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 581d11f085f..658c779b74f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -12,6 +12,7 @@
 use function explode;
 use function implode;
 use function sprintf;
+use function array_map;
 use function preg_match;
 
 /**
@@ -57,6 +58,12 @@ public static function splitNumericPrefix(string $identifier): array
         $parts[0] = (int) $parts[0];
 
         if (isset($parentPath)) {
+            $parentPaths = explode('/', $parentPath);
+            $parentPaths = array_map(function (string $part): string {
+                return static::hasNumericalPrefix($part) ? static::splitNumericPrefix($part)[1] : $part;
+            }, $parentPaths);
+            $parentPath = implode('/', $parentPaths);
+
             $parts[1] = "$parentPath/$parts[1]";
         }
 

From 562a64313af18d0d1af8656085dc7d7c351c927d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 10 May 2024 14:18:53 +0200
Subject: [PATCH 1873/4023] Test nested numerical prefix handling

---
 .../NumericalPageOrderingHelperUnitTest.php    | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
index e93302cb52c..08c4416bd0d 100644
--- a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -203,6 +203,13 @@ public function testSplitNumericPrefixForDeeplyNestedPagesWithSnakeCaseDelimiter
         $this->assertSame([3, 'foo/bar/contact.md'], NumericalPageOrderingHelper::splitNumericPrefix('foo/bar/03_contact.md'));
     }
 
+    public function testNumericalPrefixesInSubdirectoriesAreTrimmed()
+    {
+        $this->assertSame([1, 'foo.md'], NumericalPageOrderingHelper::splitNumericPrefix('01-foo.md'));
+        $this->assertSame([2, 'nested/foo.md'], NumericalPageOrderingHelper::splitNumericPrefix('01-nested/02-foo.md'));
+        $this->assertSame([3, 'deeply/nested/foo.md'], NumericalPageOrderingHelper::splitNumericPrefix('01-deeply/02-nested/03-foo.md'));
+    }
+
     public function testNonNumericalPartsAreNotDetected()
     {
         $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo-bar.md'));
@@ -258,6 +265,17 @@ public function testNumericallyStringPrefixedIdentifiersWithoutDelimiterAreNotDe
         $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('one.foo.md'));
     }
 
+    public function testHasNumericalPrefixOnlyReturnsTrueIfLastIdentifierPartIsNumerical()
+    {
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01-nested/foo.md'));
+        $this->assertFalse(NumericalPageOrderingHelper::hasNumericalPrefix('01-deeply/02-nested/foo.md'));
+
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-foo.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-nested/02-foo.md'));
+        $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-deeply/02-nested/03-foo.md'));
+    }
+
     public static function pageTypeProvider(): array
     {
         self::needsKernel();

From ba0ead99b3b9e51a4ff6ce36ff571cd6afc0ba2e Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Fri, 10 May 2024 12:19:07 +0000
Subject: [PATCH 1874/4023] Apply fixes from StyleCI

---
 .../framework/tests/Feature/NumericalPageOrderingHelperTest.php  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index 0341a60b011..b5b54025ac0 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -262,7 +262,6 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefix()
         $this->assertSame('getting-started', $page->navigationMenuGroup());
     }
 
-
     public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefixWithoutFlattenedOutputPaths()
     {
         config(['docs.flattened_output_paths' => false]);

From 0bcb133786efff896138ea203188c17caedbabc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 10 May 2024 14:20:32 +0200
Subject: [PATCH 1875/4023] Update test to expect trimmed numerical group part

See https://github.com/hydephp/develop/pull/1710#discussion_r1592040949
---
 packages/framework/tests/Unit/RouteKeyTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index d906bd1ebfa..cc30305afd5 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -127,7 +127,7 @@ public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixForNe
     {
         $this->assertSame('foo/bar', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar')->get());
         $this->assertSame('foo/bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/bar/02-baz')->get());
-        $this->assertSame('foo/01-bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar/03-baz')->get());
+        $this->assertSame('foo/bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar/03-baz')->get());
     }
 
     public function testItDoesNotExtractCoreIdentifierPartFromNumericalFilenamePrefixWhenFeatureIsDisabled()

From a2f4219e4cfdc1bc7c457257f327bc102e7175b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 16:31:53 +0200
Subject: [PATCH 1876/4023] Add additional fixture for test

---
 packages/framework/tests/Feature/DataCollectionTest.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index df35e788f3f..9f5479f4dee 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -34,11 +34,13 @@ public function testYamlCollections()
     {
         $this->directory('resources/collections/foo');
         $this->markdown('resources/collections/foo/foo.yaml', matter: ['title' => 'Foo']);
-        $this->file('resources/collections/foo/bar.yml');
+        $this->file('resources/collections/foo/bar.yml', "---\ntitle: Bar\n---");
+        $this->file('resources/collections/foo/baz.yml');
 
         $this->assertEquals(new DataCollections([
             'foo/foo.yaml' => new FrontMatter(['title' => 'Foo']),
-            'foo/bar.yml' => new FrontMatter([]),
+            'foo/bar.yml' => new FrontMatter(['title' => 'Bar']),
+            'foo/baz.yml' => new FrontMatter([]),
         ]), DataCollections::yaml('foo'));
     }
 

From 71e2212aed530c421680da93f40b05ba344a68a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 16:48:34 +0200
Subject: [PATCH 1877/4023] Test YAML collections without triple dashes

---
 .../framework/tests/Feature/DataCollectionTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index 9f5479f4dee..bea53f0ef6d 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -44,6 +44,16 @@ public function testYamlCollections()
         ]), DataCollections::yaml('foo'));
     }
 
+    public function testYamlCollectionsWithoutTripleDashes()
+    {
+        $this->directory('resources/collections/foo');
+        $this->file('resources/collections/foo/foo.yml', 'title: Foo');
+
+        $this->assertEquals(new DataCollections([
+            'foo/foo.yml' => new FrontMatter(['title' => 'Foo']),
+        ]), DataCollections::yaml('foo'));
+    }
+
     public function testJsonCollections()
     {
         $this->directory('resources/collections/foo');

From ff896418527acb5b8695fb3abc17f766873bb8ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 17:25:04 +0200
Subject: [PATCH 1878/4023] Support parsing Yaml data files with both dashes
 and without

---
 .../framework/src/Support/DataCollections.php     | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollections.php b/packages/framework/src/Support/DataCollections.php
index b5ab786edef..f683801a5ec 100644
--- a/packages/framework/src/Support/DataCollections.php
+++ b/packages/framework/src/Support/DataCollections.php
@@ -5,6 +5,9 @@
 namespace Hyde\Support;
 
 use Hyde\Facades\Filesystem;
+use Symfony\Component\Yaml\Yaml;
+use Hyde\Markdown\Models\FrontMatter;
+use Spatie\YamlFrontMatter\YamlFrontMatter;
 use Hyde\Framework\Actions\MarkdownFileParser;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Illuminate\Support\Collection;
@@ -68,7 +71,17 @@ public static function yaml(string $name): static
         static::needsDirectory(static::$sourceDirectory);
 
         return new static(static::findFiles($name, ['yaml', 'yml'])->mapWithKeys(function (string $file): array {
-            return [static::makeIdentifier($file) => MarkdownFileParser::parse($file)->matter()];
+            $content = Filesystem::get($file);
+
+            if (str_starts_with($content, '---')) {
+                $document = YamlFrontMatter::markdownCompatibleParse($content);
+                $matter = new FrontMatter($document->matter());
+            } else {
+                $parsed = Yaml::parse($content) ?: [];
+                $matter = new FrontMatter($parsed);
+            }
+
+            return [static::makeIdentifier($file) => $matter];
         }));
     }
 

From 30b6365da3cf921a875856e751e0d87520d21611 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 17:33:49 +0200
Subject: [PATCH 1879/4023] Yaml data files no longer need to start with triple
 dashes

---
 docs/digging-deeper/collections.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/digging-deeper/collections.md b/docs/digging-deeper/collections.md
index f0ebb7b79fb..f0224e85f23 100644
--- a/docs/digging-deeper/collections.md
+++ b/docs/digging-deeper/collections.md
@@ -129,14 +129,10 @@ Here is an approximation of the data types contained by the variable created abo
 Assuming the Yaml document looks like this:
 
 ```yaml
----
 name: "John Doe"
 email: "john@example.org"
 ```
 
->warning Note that the Yaml file should start with `---` to be parsed correctly.
-
-
 ## Json Collections
 
 ### Usage

From 5b2af72411c40b926a831bc49f19147fef9bcf3f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 17:37:17 +0200
Subject: [PATCH 1880/4023] Simplify Yaml data file parsing

---
 packages/framework/src/Support/DataCollections.php | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/DataCollections.php b/packages/framework/src/Support/DataCollections.php
index f683801a5ec..ceba103e305 100644
--- a/packages/framework/src/Support/DataCollections.php
+++ b/packages/framework/src/Support/DataCollections.php
@@ -7,7 +7,6 @@
 use Hyde\Facades\Filesystem;
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Markdown\Models\FrontMatter;
-use Spatie\YamlFrontMatter\YamlFrontMatter;
 use Hyde\Framework\Actions\MarkdownFileParser;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Illuminate\Support\Collection;
@@ -74,13 +73,12 @@ public static function yaml(string $name): static
             $content = Filesystem::get($file);
 
             if (str_starts_with($content, '---')) {
-                $document = YamlFrontMatter::markdownCompatibleParse($content);
-                $matter = new FrontMatter($document->matter());
-            } else {
-                $parsed = Yaml::parse($content) ?: [];
-                $matter = new FrontMatter($parsed);
+                $content = Str::between($content, '---', '---');
             }
 
+            $parsed = Yaml::parse($content) ?: [];
+            $matter = new FrontMatter($parsed);
+
             return [static::makeIdentifier($file) => $matter];
         }));
     }

From e4e68086d619f9d541d562dca37a22ef1c8b1b00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 18:53:25 +0200
Subject: [PATCH 1881/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a099118b402..1671f6fceb9 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -173,6 +173,7 @@ Due to the scope of the rewrite, the easiest and fastest way to upgrade your cod
 
 - For a full comparison of the changes, you may see the PR that introduced the new API: https://github.com/hydephp/develop/pull/1568/files
 - For information on how to use the new Navigation API, see the documentation: https://hydephp.com/docs/2.x/navigation-api
+- If you use DataCollections, you should read the upgrade path below as there are breaking changes to the DataCollection API.
 
 ### HTML ID changes
 
@@ -216,3 +217,9 @@ For example, if you triggered the media transfer with a build service method cal
 
 (new TransferMediaAssets())->run();
 ```
+
+### DataCollection API changes
+
+The DataCollections feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
+
+Unfortunately, this means that existing setups may need to be adjusted to work with the new API.

From 5d655cb4a60d96c501a88d6d40f1d0715c0c8ef4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 18:53:34 +0200
Subject: [PATCH 1882/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1671f6fceb9..a23fc612755 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -223,3 +223,7 @@ For example, if you triggered the media transfer with a build service method cal
 The DataCollections feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
 
 Unfortunately, this means that existing setups may need to be adjusted to work with the new API.
+
+#### Issues that may arise
+
+If you get a Yaml `ParseException` stating that "Multiple documents are not supported in", you must remove the `---` separator YAML documents in your data files.

From daa7a3a5cd4a481de098eb556ebdd39a6bc7dce7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 18:53:37 +0200
Subject: [PATCH 1883/4023] Revert "Update RELEASE_NOTES.md"

This reverts commit 5d655cb4a60d96c501a88d6d40f1d0715c0c8ef4.
---
 RELEASE_NOTES.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a23fc612755..1671f6fceb9 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -223,7 +223,3 @@ For example, if you triggered the media transfer with a build service method cal
 The DataCollections feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
 
 Unfortunately, this means that existing setups may need to be adjusted to work with the new API.
-
-#### Issues that may arise
-
-If you get a Yaml `ParseException` stating that "Multiple documents are not supported in", you must remove the `---` separator YAML documents in your data files.

From 6ebc9c9626128940cb581c65aa112693a0e13c9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 20:54:02 +0200
Subject: [PATCH 1884/4023] Unwrap unnecessary condition

---
 packages/framework/src/Support/DataCollections.php | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/DataCollections.php b/packages/framework/src/Support/DataCollections.php
index ceba103e305..79e53dc32d5 100644
--- a/packages/framework/src/Support/DataCollections.php
+++ b/packages/framework/src/Support/DataCollections.php
@@ -71,10 +71,7 @@ public static function yaml(string $name): static
 
         return new static(static::findFiles($name, ['yaml', 'yml'])->mapWithKeys(function (string $file): array {
             $content = Filesystem::get($file);
-
-            if (str_starts_with($content, '---')) {
-                $content = Str::between($content, '---', '---');
-            }
+            $content = Str::between($content, '---', '---');
 
             $parsed = Yaml::parse($content) ?: [];
             $matter = new FrontMatter($parsed);

From d87afdec66d8e7af499c412e40fd774e4702e5d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 21:21:28 +0200
Subject: [PATCH 1885/4023] Remove merge conflicted line

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a099118b402..50d15004f03 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -36,7 +36,7 @@ This serves two purposes:
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed
-- Realtime Compiler: Fixed responsive dashboard table issue in https://github.com/hydephp/develop/pull/1595
+- for any bug fixes.
 
 ### Security
 - in case of vulnerabilities.

From 22c4b667a36c6312d89cacd72147ee7c4ea702cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 21:22:00 +0200
Subject: [PATCH 1886/4023] No longer automatically create the data collections
 directory

Fixes https://github.com/hydephp/develop/issues/1735
---
 RELEASE_NOTES.md                              |  4 ++-
 docs/digging-deeper/collections.md            |  1 -
 .../framework/src/Support/DataCollections.php |  9 ------
 .../tests/Feature/DataCollectionTest.php      | 28 -------------------
 4 files changed, 3 insertions(+), 39 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7bea4c45323..e4c43f306b0 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -25,7 +25,7 @@ This serves two purposes:
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
-
+- Calling the `DataCollections` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -223,3 +223,5 @@ For example, if you triggered the media transfer with a build service method cal
 The DataCollections feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
 
 Unfortunately, this means that existing setups may need to be adjusted to work with the new API.
+
+- Calling the `DataCollections` methods will no longer create the data collections directory automatically
diff --git a/docs/digging-deeper/collections.md b/docs/digging-deeper/collections.md
index 89745bd0c57..b83bef6647f 100644
--- a/docs/digging-deeper/collections.md
+++ b/docs/digging-deeper/collections.md
@@ -32,7 +32,6 @@ Follow these conventions and creating dynamic static sites will be a breeze.
 6. While not enforced, each subdirectory should probably only have the same filetype to prevent developer confusion.
 7. Unlike source files for pages, files starting with underscores are not ignored.
 8. You can customize the source directory for collections through a service provider.
-9. If the base source directory does not exist, it will be created for you.
 
 
 ## Available Collection Types
diff --git a/packages/framework/src/Support/DataCollections.php b/packages/framework/src/Support/DataCollections.php
index 79e53dc32d5..00d54371089 100644
--- a/packages/framework/src/Support/DataCollections.php
+++ b/packages/framework/src/Support/DataCollections.php
@@ -8,7 +8,6 @@
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Framework\Actions\MarkdownFileParser;
-use Hyde\Framework\Concerns\InteractsWithDirectories;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
@@ -35,8 +34,6 @@
  */
 class DataCollections extends Collection
 {
-    use InteractsWithDirectories;
-
     /**
      * The base directory for all data collections. Can be modified using a service provider.
      */
@@ -51,8 +48,6 @@ class DataCollections extends Collection
      */
     public static function markdown(string $name): static
     {
-        static::needsDirectory(static::$sourceDirectory);
-
         return new static(static::findFiles($name, 'md')->mapWithKeys(function (string $file): array {
             return [static::makeIdentifier($file) => MarkdownFileParser::parse($file)];
         }));
@@ -67,8 +62,6 @@ public static function markdown(string $name): static
      */
     public static function yaml(string $name): static
     {
-        static::needsDirectory(static::$sourceDirectory);
-
         return new static(static::findFiles($name, ['yaml', 'yml'])->mapWithKeys(function (string $file): array {
             $content = Filesystem::get($file);
             $content = Str::between($content, '---', '---');
@@ -89,8 +82,6 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        static::needsDirectory(static::$sourceDirectory);
-
         return new static(static::findFiles($name, 'json')->mapWithKeys(function (string $file) use ($asArray): array {
             return [static::makeIdentifier($file) => json_decode(Filesystem::get($file), $asArray)];
         }));
diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index bea53f0ef6d..f144e9fd367 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -4,12 +4,10 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
-use Hyde\Hyde;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Support\DataCollections;
 use Hyde\Testing\TestCase;
-use Illuminate\Support\Facades\File;
 
 /**
  * @covers \Hyde\Support\DataCollections
@@ -170,30 +168,4 @@ public function testSourceDirectoryCanBeChanged()
 
         DataCollections::$sourceDirectory = 'resources/collections';
     }
-
-    public function testSourceDirectoryIsAutomaticallyAddedIfMissing()
-    {
-        $this->directory('resources/collections');
-        File::deleteDirectory(Hyde::path('resources/collections'));
-        $this->assertDirectoryDoesNotExist(Hyde::path('resources/collections'));
-
-        DataCollections::markdown('foo');
-
-        $this->assertDirectoryExists(Hyde::path('resources/collections'));
-    }
-
-    public function testCustomSourceDirectoryIsAutomaticallyAddedIfMissing()
-    {
-        $this->directory('foo');
-        File::deleteDirectory(Hyde::path('foo'));
-
-        $this->assertDirectoryDoesNotExist(Hyde::path('foo'));
-
-        DataCollections::$sourceDirectory = 'foo';
-        DataCollections::markdown('bar');
-
-        $this->assertDirectoryExists(Hyde::path('foo'));
-
-        DataCollections::$sourceDirectory = 'resources/collections';
-    }
 }

From 4245ba5f08eae765225a634d5362bfe08559884d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 23 Jun 2024 21:54:11 +0200
Subject: [PATCH 1887/4023] Breaking: Rename class `DataCollections` to
 `DataCollection`

See https://github.com/hydephp/develop/issues/1712
---
 RELEASE_NOTES.md                              | 13 +++--
 _ide_helper.php                               |  2 +-
 app/config.php                                |  2 +-
 docs/digging-deeper/collections.md            | 32 ++++++------
 docs/digging-deeper/helpers.md                | 10 ++--
 ...DataCollections.php => DataCollection.php} |  8 +--
 .../tests/Feature/DataCollectionTest.php      | 50 +++++++++----------
 .../tests/Unit/DataCollectionUnitTest.php     | 22 ++++----
 8 files changed, 73 insertions(+), 66 deletions(-)
 rename packages/framework/src/Support/{DataCollections.php => DataCollection.php} (93%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index e4c43f306b0..53fc95b9911 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -17,6 +17,7 @@ This serves two purposes:
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
+- **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
@@ -25,7 +26,7 @@ This serves two purposes:
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
-- Calling the `DataCollections` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
+- Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -220,8 +221,14 @@ For example, if you triggered the media transfer with a build service method cal
 
 ### DataCollection API changes
 
-The DataCollections feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
+The DataCollection feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
 
 Unfortunately, this means that existing setups may need to be adjusted to work with the new API.
 
-- Calling the `DataCollections` methods will no longer create the data collections directory automatically
+#### Upgrade guide
+
+- The `DataCollections` class has been renamed to `DataCollection`. If you have used the `DataCollections` class in your code, you will need to update your code to use the new class name.
+
+#### Minor impact
+
+- Calling the `DataCollection` methods will no longer create the data collections directory automatically
diff --git a/_ide_helper.php b/_ide_helper.php
index 8cc231f850f..228893b3169 100644
--- a/_ide_helper.php
+++ b/_ide_helper.php
@@ -40,7 +40,7 @@ class Features extends \Hyde\Facades\Features {}
 class Config extends \Hyde\Facades\Config {}
 /** @mixin \Illuminate\Filesystem\Filesystem */
 class Filesystem extends \Hyde\Facades\Filesystem {}
-class DataCollections extends \Hyde\Support\DataCollections {}
+class DataCollection extends \Hyde\Support\DataCollection {}
 class Includes extends \Hyde\Support\Includes {}
 /** @mixin \Hyde\Foundation\Kernel\RouteCollection */
 class Routes extends \Hyde\Foundation\Facades\Routes {}
diff --git a/app/config.php b/app/config.php
index 22206637aff..ab5db6907b0 100644
--- a/app/config.php
+++ b/app/config.php
@@ -103,7 +103,7 @@
         'MarkdownPage' => \Hyde\Pages\MarkdownPage::class,
         'MarkdownPost' => \Hyde\Pages\MarkdownPost::class,
         'DocumentationPage' => \Hyde\Pages\DocumentationPage::class,
-        'DataCollections' => \Hyde\Support\DataCollections::class,
+        'DataCollection' => \Hyde\Support\DataCollection::class,
         'Includes' => \Hyde\Support\Includes::class,
         'Feature' => \Hyde\Enums\Feature::class,
     ],
diff --git a/docs/digging-deeper/collections.md b/docs/digging-deeper/collections.md
index b83bef6647f..b3040ecb900 100644
--- a/docs/digging-deeper/collections.md
+++ b/docs/digging-deeper/collections.md
@@ -8,7 +8,7 @@ navigation:
 
 ## Introduction to Hyde Data Collections
 
-Hyde provides `DataCollections`, a subset of [Laravel Collections](https://laravel.com/docs/10.x/collections) giving you a similar developer experience to working with Eloquent Collections.
+Hyde provides `DataCollection`, a subset of [Laravel Collections](https://laravel.com/docs/10.x/collections) giving you a similar developer experience to working with Eloquent Collections.
 However, instead of accessing a database, it's all entirely file-based using static data files such as Markdown, Yaml, and JSON files which get
 parsed into objects that you can easily work with.
 
@@ -24,7 +24,7 @@ In short, HydePHP finds files in the specified directory, turns each file into a
 To make collections easy to use and understand, Hyde makes a few assumptions about the structure of your collections.
 Follow these conventions and creating dynamic static sites will be a breeze.
 
-1. Collections are accessed through static methods in the `DataCollections` class.
+1. Collections are accessed through static methods in the `DataCollection` class.
 2. Collections are stored as files in subdirectories of the `resources/collections` directory.
 3. To get a collection, specify name of the subdirectory the files are stored in.
 4. Data will be parsed into differing objects depending on which facade method you use. See the table below.
@@ -41,9 +41,9 @@ Follow these conventions and creating dynamic static sites will be a breeze.
 The following facade methods for creating data collections are available:
 
 ```php
-\Hyde\Support\DataCollections::markdown(string $name);
-\Hyde\Support\DataCollections::yaml(string $name);
-\Hyde\Support\DataCollections::json(string $name, bool $asArray = false);
+\Hyde\Support\DataCollection::markdown(string $name);
+\Hyde\Support\DataCollection::yaml(string $name);
+\Hyde\Support\DataCollection::json(string $name, bool $asArray = false);
 ```
 
 ### Quick Reference Table
@@ -60,7 +60,7 @@ The following facade methods for creating data collections are available:
 ### Usage
 
 ```php
-$collection = \Hyde\Support\DataCollections::markdown('name');
+$collection = \Hyde\Support\DataCollection::markdown('name');
 ```
 
 ### Example returns
@@ -68,7 +68,7 @@ $collection = \Hyde\Support\DataCollections::markdown('name');
 Here is an approximation of the data types contained by the variable created above:
 
 ```php
-\Hyde\Support\DataCollections {
+\Hyde\Support\DataCollection {
     "testimonials/1.md" => Hyde\Markdown\Models\MarkdownDocument
     "testimonials/2.md" => Hyde\Markdown\Models\MarkdownDocument
     "testimonials/3.md" => Hyde\Markdown\Models\MarkdownDocument
@@ -107,7 +107,7 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit...
 ### Usage
 
 ```php
-$collection = \Hyde\Support\DataCollections::yaml('name');
+$collection = \Hyde\Support\DataCollection::yaml('name');
 ```
 
 ### Example returns
@@ -115,7 +115,7 @@ $collection = \Hyde\Support\DataCollections::yaml('name');
 Here is an approximation of the data types contained by the variable created above:
 
 ```php
-\Hyde\Support\DataCollections {
+\Hyde\Support\DataCollection {
   "authors/1.yaml" => Hyde\Markdown\Models\FrontMatter {
     +data: array:1 [
       "name" => "John Doe",
@@ -137,13 +137,13 @@ email: "john@example.org"
 ### Usage
 
 ```php
-$collection = \Hyde\Support\DataCollections::json('name');
+$collection = \Hyde\Support\DataCollection::json('name');
 ```
 
 By default, the entries will be returned as `stdClass` objects. If you want to return an associative array instead, pass `true` as the second parameter:
 
 ```php
-$collection = \Hyde\Support\DataCollections::json('name', true);
+$collection = \Hyde\Support\DataCollection::json('name', true);
 ```
 
 Since both return values use native PHP types, there are no example returns added here, as I'm sure you can imagine what they look like.
@@ -186,18 +186,18 @@ resources/collections
 
 #### Using the Facade to Access the Collections
 
-Now for the fun part! We will use the `DataCollections::markdown()` to access all our files into a convenient object.
+Now for the fun part! We will use the `DataCollection::markdown()` to access all our files into a convenient object.
 The class is registered with an alias, so you don't need to include any namespaces when in a Blade file.
 
 The general syntax to use the facade is as follows:
 
 ```blade
-DataCollections::markdown('subdirectory_name')
+DataCollection::markdown('subdirectory_name')
 ```
 
-This will return a Hyde DataCollections object, containing our Markdown files as MarkdownDocument objects. Here is a quick look at the object the facade returns:
+This will return a Hyde DataCollection object, containing our Markdown files as MarkdownDocument objects. Here is a quick look at the object the facade returns:
 
-<pre style="display: block; white-space: pre-wrap; padding: 1rem 1.5rem; overflow: initial !important; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 400 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; position: relative; z-index: 99999; word-break: break-all; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><span class="sf-dump-default" style="display: inline; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; white-space: pre-wrap; position: relative; z-index: 99999; word-break: break-all;">^</span><span class="sf-dump-default" style="display: inline; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; white-space: pre-wrap; position: relative; z-index: 99999; word-break: break-all;"> </span><span style="display: inline; color: rgb(18, 153, 218);">Hyde\Support\DataCollections</span> {<span style="text-decoration: none; border: 0px; outline: none; color: rgb(160, 160, 160);">#651 <span style="display: inline;">▼</span></span><samp>
+<pre style="display: block; white-space: pre-wrap; padding: 1rem 1.5rem; overflow: initial !important; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 400 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; position: relative; z-index: 99999; word-break: break-all; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><span class="sf-dump-default" style="display: inline; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; white-space: pre-wrap; position: relative; z-index: 99999; word-break: break-all;">^</span><span class="sf-dump-default" style="display: inline; background-color: rgb(24, 23, 27); color: rgb(255, 132, 0); font: 12px Menlo, Monaco, Consolas, monospace; overflow-wrap: break-word; white-space: pre-wrap; position: relative; z-index: 99999; word-break: break-all;"> </span><span style="display: inline; color: rgb(18, 153, 218);">Hyde\Support\DataCollection</span> {<span style="text-decoration: none; border: 0px; outline: none; color: rgb(160, 160, 160);">#651 <span style="display: inline;">▼</span></span><samp>
   #<span style="display: inline; color: rgb(255, 255, 255);">items</span>: <span style="display: inline; color: rgb(18, 153, 218);">array:3</span> [<span style="text-decoration: none; border: 0px; outline: none; color: rgb(160, 160, 160);"><span style="display: inline;">▼</span></span><samp>
     "<span style="display: inline; color: rgb(86, 219, 58);">testimonials/1.md</span>" =&gt; <span style="display: inline; color: rgb(18, 153, 218);"><span>Hyde\Markdown\Models</span><span style="display: inline-block; text-overflow: ellipsis; max-width: none; white-space: nowrap; overflow: hidden; vertical-align: top; color: rgb(18, 153, 218);">\</span>MarkdownDocument</span> {<span style="text-decoration: none; border: 0px; outline: none; color: rgb(160, 160, 160);">#653 <span style="display: inline;">▼</span></span><samp>
       +<span style="display: inline; color: rgb(255, 255, 255);">matter</span>: <span style="display: inline; color: rgb(18, 153, 218);"><span>Hyde\Markdown\Models</span><span style="display: inline-block; text-overflow: ellipsis; max-width: none; white-space: nowrap; overflow: hidden; vertical-align: top; color: rgb(18, 153, 218);">\</span>FrontMatter</span> {<span style="text-decoration: none; border: 0px; outline: none; color: rgb(160, 160, 160);">#652 <span style="display: inline;">▶</span></span>}
@@ -222,7 +222,7 @@ we are able to get the author from the front matter, and the content from the bo
 
 ```blade
 // filepath _pages/testimonials.blade.php
-@foreach(DataCollections::markdown('testimonials') as $testimonial)
+@foreach(DataCollection::markdown('testimonials') as $testimonial)
     <blockquote>
         <p>{{ $testimonial->body }}</p>
         <small>{{ $testimonial->matter['author'] }}</small>
diff --git a/docs/digging-deeper/helpers.md b/docs/digging-deeper/helpers.md
index 62a89033a16..6414fba758a 100644
--- a/docs/digging-deeper/helpers.md
+++ b/docs/digging-deeper/helpers.md
@@ -14,20 +14,20 @@ Note that these helpers targets those who write custom code and Blade templates,
 
 ## File-based Collections
 
-Hyde provides `DataCollections`, a subset of [Laravel Collections](https://laravel.com/docs/10.x/collections) giving you a similar developer experience to working with Eloquent Collections. However, instead of accessing a database,
+Hyde provides `DataCollection`, a subset of [Laravel Collections](https://laravel.com/docs/10.x/collections) giving you a similar developer experience to working with Eloquent Collections. However, instead of accessing a database,
 it's all entirely file-based using static data files such as Markdown, Yaml, and JSON files which get parsed into objects that you can easily work with.
 
 ```php
-use Hyde\Support\DataCollections;
+use Hyde\Support\DataCollection;
 
 // Gets all Markdown files in resources/collections/$name directory
-DataCollections::markdown(string $name);
+DataCollection::markdown(string $name);
 
 // Gets all YAML files in resources/collections/$name directory
-DataCollections::yaml(string $name);
+DataCollection::yaml(string $name);
 
 // Gets all JSON files in resources/collections/$name directory
-DataCollections::json(string $name, bool $asArray = false);
+DataCollection::json(string $name, bool $asArray = false);
 ```
 
 See the [File-based Collections](collections) documentation for the full details.
diff --git a/packages/framework/src/Support/DataCollections.php b/packages/framework/src/Support/DataCollection.php
similarity index 93%
rename from packages/framework/src/Support/DataCollections.php
rename to packages/framework/src/Support/DataCollection.php
index 00d54371089..ffedb51e2cf 100644
--- a/packages/framework/src/Support/DataCollections.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -32,7 +32,7 @@
  * All collections are indexed by their filename, which is relative
  * to the configured data collection source directory.
  */
-class DataCollections extends Collection
+class DataCollection extends Collection
 {
     /**
      * The base directory for all data collections. Can be modified using a service provider.
@@ -44,7 +44,7 @@ class DataCollections extends Collection
      *
      * Each Markdown file will be parsed into a MarkdownDocument with front matter.
      *
-     * @return DataCollections<string, \Hyde\Markdown\Models\MarkdownDocument>
+     * @return DataCollection<string, \Hyde\Markdown\Models\MarkdownDocument>
      */
     public static function markdown(string $name): static
     {
@@ -58,7 +58,7 @@ public static function markdown(string $name): static
      *
      * Each YAML file will be parsed into a FrontMatter object.
      *
-     * @return DataCollections<string, \Hyde\Markdown\Models\FrontMatter>
+     * @return DataCollection<string, \Hyde\Markdown\Models\FrontMatter>
      */
     public static function yaml(string $name): static
     {
@@ -78,7 +78,7 @@ public static function yaml(string $name): static
      *
      * Each JSON file will be parsed into a stdClass object, or an associative array, depending on the second parameter.
      *
-     * @return DataCollections<string, \stdClass|array>
+     * @return DataCollection<string, \stdClass|array>
      */
     public static function json(string $name, bool $asArray = false): static
     {
diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index f144e9fd367..9889472841e 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -6,11 +6,11 @@
 
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
-use Hyde\Support\DataCollections;
+use Hyde\Support\DataCollection;
 use Hyde\Testing\TestCase;
 
 /**
- * @covers \Hyde\Support\DataCollections
+ * @covers \Hyde\Support\DataCollection
  *
  * @see \Hyde\Framework\Testing\Unit\DataCollectionUnitTest
  */
@@ -22,10 +22,10 @@ public function testMarkdownCollections()
         $this->markdown('resources/collections/foo/foo.md', 'Hello World', ['title' => 'Foo']);
         $this->file('resources/collections/foo/bar.md');
 
-        $this->assertEquals(new DataCollections([
+        $this->assertEquals(new DataCollection([
             'foo/foo.md' => new MarkdownDocument(['title' => 'Foo'], 'Hello World'),
             'foo/bar.md' => new MarkdownDocument([], ''),
-        ]), DataCollections::markdown('foo'));
+        ]), DataCollection::markdown('foo'));
     }
 
     public function testYamlCollections()
@@ -35,11 +35,11 @@ public function testYamlCollections()
         $this->file('resources/collections/foo/bar.yml', "---\ntitle: Bar\n---");
         $this->file('resources/collections/foo/baz.yml');
 
-        $this->assertEquals(new DataCollections([
+        $this->assertEquals(new DataCollection([
             'foo/foo.yaml' => new FrontMatter(['title' => 'Foo']),
             'foo/bar.yml' => new FrontMatter(['title' => 'Bar']),
             'foo/baz.yml' => new FrontMatter([]),
-        ]), DataCollections::yaml('foo'));
+        ]), DataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsWithoutTripleDashes()
@@ -47,9 +47,9 @@ public function testYamlCollectionsWithoutTripleDashes()
         $this->directory('resources/collections/foo');
         $this->file('resources/collections/foo/foo.yml', 'title: Foo');
 
-        $this->assertEquals(new DataCollections([
+        $this->assertEquals(new DataCollection([
             'foo/foo.yml' => new FrontMatter(['title' => 'Foo']),
-        ]), DataCollections::yaml('foo'));
+        ]), DataCollection::yaml('foo'));
     }
 
     public function testJsonCollections()
@@ -58,10 +58,10 @@ public function testJsonCollections()
         $this->file('resources/collections/foo/foo.json', json_encode(['foo' => 'bar']));
         $this->file('resources/collections/foo/bar.json');
 
-        $this->assertEquals(new DataCollections([
+        $this->assertEquals(new DataCollection([
             'foo/foo.json' => (object) ['foo' => 'bar'],
             'foo/bar.json' => null,
-        ]), DataCollections::json('foo'));
+        ]), DataCollection::json('foo'));
     }
 
     public function testJsonCollectionsAsArrays()
@@ -70,24 +70,24 @@ public function testJsonCollectionsAsArrays()
         $this->file('resources/collections/foo/foo.json', json_encode(['foo' => 'bar']));
         $this->file('resources/collections/foo/bar.json');
 
-        $this->assertEquals(new DataCollections([
+        $this->assertEquals(new DataCollection([
             'foo/foo.json' => ['foo' => 'bar'],
             'foo/bar.json' => null,
-        ]), DataCollections::json('foo', true));
+        ]), DataCollection::json('foo', true));
     }
 
     public function testFindMarkdownFilesMethodReturnsEmptyArrayIfTheSpecifiedDirectoryDoesNotExist()
     {
-        $this->assertIsArray(DataCollections::markdown('foo')->keys()->toArray());
-        $this->assertEmpty(DataCollections::markdown('foo')->keys()->toArray());
+        $this->assertIsArray(DataCollection::markdown('foo')->keys()->toArray());
+        $this->assertEmpty(DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testFindMarkdownFilesMethodReturnsEmptyArrayIfNoFilesAreFoundInSpecifiedDirectory()
     {
         $this->directory('resources/collections/foo');
 
-        $this->assertIsArray(DataCollections::markdown('foo')->keys()->toArray());
-        $this->assertEmpty(DataCollections::markdown('foo')->keys()->toArray());
+        $this->assertIsArray(DataCollection::markdown('foo')->keys()->toArray());
+        $this->assertEmpty(DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testFindMarkdownFilesMethodReturnsAnArrayOfMarkdownFilesInTheSpecifiedDirectory()
@@ -99,7 +99,7 @@ public function testFindMarkdownFilesMethodReturnsAnArrayOfMarkdownFilesInTheSpe
         $this->assertSame([
             'foo/bar.md',
             'foo/foo.md',
-        ], DataCollections::markdown('foo')->keys()->toArray());
+        ], DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testFindMarkdownFilesMethodDoesNotIncludeFilesInSubdirectories()
@@ -111,7 +111,7 @@ public function testFindMarkdownFilesMethodDoesNotIncludeFilesInSubdirectories()
 
         $this->assertSame([
             'foo/foo.md',
-        ], DataCollections::markdown('foo')->keys()->toArray());
+        ], DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testFindMarkdownFilesMethodDoesNotIncludeFilesWithExtensionsOtherThanMd()
@@ -122,7 +122,7 @@ public function testFindMarkdownFilesMethodDoesNotIncludeFilesWithExtensionsOthe
 
         $this->assertSame([
             'foo/foo.md',
-        ], DataCollections::markdown('foo')->keys()->toArray());
+        ], DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testFindMarkdownFilesMethodDoesNotRemoveFilesStartingWithAnUnderscore()
@@ -132,7 +132,7 @@ public function testFindMarkdownFilesMethodDoesNotRemoveFilesStartingWithAnUnder
 
         $this->assertSame([
             'foo/_foo.md',
-        ], DataCollections::markdown('foo')->keys()->toArray());
+        ], DataCollection::markdown('foo')->keys()->toArray());
     }
 
     public function testStaticMarkdownHelperDiscoversAndParsesMarkdownFilesInTheSpecifiedDirectory()
@@ -144,7 +144,7 @@ public function testStaticMarkdownHelperDiscoversAndParsesMarkdownFilesInTheSpec
         $this->assertEquals([
             'foo/foo.md' => new MarkdownDocument([], ''),
             'foo/bar.md' => new MarkdownDocument([], ''),
-        ], DataCollections::markdown('foo')->toArray());
+        ], DataCollection::markdown('foo')->toArray());
     }
 
     public function testStaticMarkdownHelperDoestNotIgnoreFilesStartingWithAnUnderscore()
@@ -153,19 +153,19 @@ public function testStaticMarkdownHelperDoestNotIgnoreFilesStartingWithAnUndersc
         $this->file('resources/collections/foo/foo.md');
         $this->file('resources/collections/foo/_bar.md');
 
-        $this->assertCount(2, DataCollections::markdown('foo'));
+        $this->assertCount(2, DataCollection::markdown('foo'));
     }
 
     public function testSourceDirectoryCanBeChanged()
     {
-        DataCollections::$sourceDirectory = 'foo';
+        DataCollection::$sourceDirectory = 'foo';
         $this->directory('foo/bar');
         $this->file('foo/bar/foo.md');
 
         $this->assertSame([
             'bar/foo.md',
-        ], DataCollections::markdown('bar')->keys()->toArray());
+        ], DataCollection::markdown('bar')->keys()->toArray());
 
-        DataCollections::$sourceDirectory = 'resources/collections';
+        DataCollection::$sourceDirectory = 'resources/collections';
     }
 }
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index fc4cfdea17b..cfea0468e04 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -5,14 +5,14 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Hyde;
-use Hyde\Support\DataCollections;
+use Hyde\Support\DataCollection;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Support\Collection;
 use Mockery;
 
 /**
- * @covers \Hyde\Support\DataCollections
+ * @covers \Hyde\Support\DataCollection
  *
  * @see \Hyde\Framework\Testing\Feature\DataCollectionTest
  */
@@ -22,27 +22,27 @@ class DataCollectionUnitTest extends UnitTestCase
 
     public function testClassHasStaticSourceDirectoryProperty()
     {
-        $this->assertSame('resources/collections', DataCollections::$sourceDirectory);
+        $this->assertSame('resources/collections', DataCollection::$sourceDirectory);
     }
 
     public function testConstructorCreatesNewDataCollectionInstance()
     {
-        $this->assertInstanceOf(DataCollections::class, new DataCollections());
+        $this->assertInstanceOf(DataCollection::class, new DataCollection());
     }
 
     public function testClassExtendsCollectionClass()
     {
-        $this->assertInstanceOf(Collection::class, new DataCollections());
+        $this->assertInstanceOf(Collection::class, new DataCollection());
     }
 
     public function testCanConvertCollectionToArray()
     {
-        $this->assertSame([], (new DataCollections())->toArray());
+        $this->assertSame([], (new DataCollection())->toArray());
     }
 
     public function testCanConvertCollectionToJson()
     {
-        $this->assertSame('[]', (new DataCollections())->toJson());
+        $this->assertSame('[]', (new DataCollection())->toJson());
     }
 
     public function testFindMarkdownFilesCallsProperGlobPattern()
@@ -54,7 +54,7 @@ public function testFindMarkdownFilesCallsProperGlobPattern()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        DataCollections::markdown('foo')->keys()->toArray();
+        DataCollection::markdown('foo')->keys()->toArray();
 
         $this->addToAssertionCount(Mockery::getContainer()->mockery_getExpectationCount());
         Mockery::close();
@@ -69,7 +69,7 @@ public function testFindMarkdownFilesWithNoFiles()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        $this->assertSame([], DataCollections::markdown('foo')->keys()->toArray());
+        $this->assertSame([], DataCollection::markdown('foo')->keys()->toArray());
 
         Mockery::close();
     }
@@ -84,13 +84,13 @@ public function testFindMarkdownFilesWithFiles()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        $this->assertSame(['bar.md'], DataCollections::markdown('foo')->keys()->toArray());
+        $this->assertSame(['bar.md'], DataCollection::markdown('foo')->keys()->toArray());
 
         Mockery::close();
     }
 
     public function testStaticMarkdownHelperReturnsNewDataCollectionInstance()
     {
-        $this->assertInstanceOf(DataCollections::class, DataCollections::markdown('foo'));
+        $this->assertInstanceOf(DataCollection::class, DataCollection::markdown('foo'));
     }
 }

From a24aa34412226c865fdbb663aa70351300c17797 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:42:56 +0200
Subject: [PATCH 1888/4023] Add mockable data collection test class

---
 .../tests/Unit/DataCollectionUnitTest.php     | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cfea0468e04..4cc703c0676 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -20,6 +20,13 @@ class DataCollectionUnitTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 
+    protected function tearDown(): void
+    {
+        MockableDataCollection::tearDown();
+
+        parent::tearDown();
+    }
+
     public function testClassHasStaticSourceDirectoryProperty()
     {
         $this->assertSame('resources/collections', DataCollection::$sourceDirectory);
@@ -94,3 +101,23 @@ public function testStaticMarkdownHelperReturnsNewDataCollectionInstance()
         $this->assertInstanceOf(DataCollection::class, DataCollection::markdown('foo'));
     }
 }
+
+class MockableDataCollection extends DataCollection
+{
+    protected static array $mockFiles = [];
+
+    protected static function findFiles(string $name, array|string $extensions): Collection
+    {
+        return collect(static::$mockFiles);
+    }
+
+    public static function mockFiles(array $files): void
+    {
+        static::$mockFiles = $files;
+    }
+
+    public static function tearDown(): void
+    {
+        static::$mockFiles = [];
+    }
+}

From 02b8b0663af262f254cac5ded3a1802efdd10848 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:48:44 +0200
Subject: [PATCH 1889/4023] Get by name

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 4cc703c0676..cea8cf15b1a 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -108,7 +108,7 @@ class MockableDataCollection extends DataCollection
 
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
-        return collect(static::$mockFiles);
+        return collect(static::$mockFiles[$name]);
     }
 
     public static function mockFiles(array $files): void

From 6c91c63e5aced05b9820e052bd5acaadc3daf500 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:49:18 +0200
Subject: [PATCH 1890/4023] Normalize file contents syntax

---
 packages/framework/src/Support/DataCollection.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index ffedb51e2cf..a8fd789b4b0 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -63,7 +63,7 @@ public static function markdown(string $name): static
     public static function yaml(string $name): static
     {
         return new static(static::findFiles($name, ['yaml', 'yml'])->mapWithKeys(function (string $file): array {
-            $content = Filesystem::get($file);
+            $content = Filesystem::getContents($file);
             $content = Str::between($content, '---', '---');
 
             $parsed = Yaml::parse($content) ?: [];
@@ -83,7 +83,7 @@ public static function yaml(string $name): static
     public static function json(string $name, bool $asArray = false): static
     {
         return new static(static::findFiles($name, 'json')->mapWithKeys(function (string $file) use ($asArray): array {
-            return [static::makeIdentifier($file) => json_decode(Filesystem::get($file), $asArray)];
+            return [static::makeIdentifier($file) => json_decode(Filesystem::getContents($file), $asArray)];
         }));
     }
 

From dd63ffe1c7a03a591d430b865bf5864805573487 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:55:33 +0200
Subject: [PATCH 1891/4023] Add array based glob helper

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cea8cf15b1a..47d51c23752 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -120,4 +120,11 @@ public static function tearDown(): void
     {
         static::$mockFiles = [];
     }
+
+    protected static function arrayGlob(array $files, string $name, array|string $extensions): array
+    {
+        return array_filter($files, function (string $file) use ($name, $extensions): bool {
+            return str_contains($file, $name) && str_contains($file, $extensions);
+        }, ARRAY_FILTER_USE_KEY);
+    }
 }

From b577a4804207ab1d06826dfa989c205f04ee02f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:55:52 +0200
Subject: [PATCH 1892/4023] Collect using array glob

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 47d51c23752..cdac3cee973 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -108,7 +108,7 @@ class MockableDataCollection extends DataCollection
 
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
-        return collect(static::$mockFiles[$name]);
+        return collect(static::arrayGlob(static::$mockFiles, $name, $extensions));
     }
 
     public static function mockFiles(array $files): void

From db628613ab9d4b7521886cdbc1ac0d6d4bc3166c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:56:00 +0200
Subject: [PATCH 1893/4023] Annotate generics

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cdac3cee973..1ded27cc22c 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -111,6 +111,9 @@ protected static function findFiles(string $name, array|string $extensions): Col
         return collect(static::arrayGlob(static::$mockFiles, $name, $extensions));
     }
 
+    /**
+     * @param  array<string, string>  $files  Filename as key, file contents as value.
+     */
     public static function mockFiles(array $files): void
     {
         static::$mockFiles = $files;

From dd698abe3298e324597d961798dafdad5f0e93a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 09:56:05 +0200
Subject: [PATCH 1894/4023] Assert generics and test mock setup

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 1ded27cc22c..016dd5adc24 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -116,6 +116,13 @@ protected static function findFiles(string $name, array|string $extensions): Col
      */
     public static function mockFiles(array $files): void
     {
+        foreach ($files as $file => $contents) {
+            assert(is_string($file), 'File name must be a string.');
+            assert(is_string($contents), 'File contents must be a string.');
+            assert(str_contains($file, '/'), 'File must be in a directory.');
+            assert(str_contains($file, '.'), 'File must have an extension.');
+        }
+
         static::$mockFiles = $files;
     }
 

From d9bb52adee743da4afda6428685b7bc1773e6fb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 10:04:36 +0200
Subject: [PATCH 1895/4023] Mock the filesystem

---
 .../framework/tests/Unit/DataCollectionUnitTest.php   | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 016dd5adc24..3a78022ee93 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -123,6 +123,17 @@ public static function mockFiles(array $files): void
             assert(str_contains($file, '.'), 'File must have an extension.');
         }
 
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('get')
+            ->andReturnUsing(function (string $file) use ($files) {
+                $file = unslash(str_replace(Hyde::path(), '', $file));
+                $files = static::arrayGlob($files, $file, 'md');
+
+                return array_values($files)[0] ?? '';
+            });
+
+        app()->instance(Filesystem::class, $filesystem);
+
         static::$mockFiles = $files;
     }
 

From e8af560121c4103094ed9f1bb736c15dff16e054 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:14:43 +0200
Subject: [PATCH 1896/4023] Simplify testing helpers

---
 .../tests/Unit/DataCollectionUnitTest.php        | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 3a78022ee93..381e08d95a2 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -5,11 +5,14 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Hyde;
+use Illuminate\Support\Str;
 use Hyde\Support\DataCollection;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Support\Collection;
 use Mockery;
+use Hyde\Markdown\Models\FrontMatter;
+use Hyde\Markdown\Models\MarkdownDocument;
 
 /**
  * @covers \Hyde\Support\DataCollection
@@ -108,7 +111,7 @@ class MockableDataCollection extends DataCollection
 
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
-        return collect(static::arrayGlob(static::$mockFiles, $name, $extensions));
+        return collect(static::$mockFiles)->keys();
     }
 
     /**
@@ -127,9 +130,9 @@ public static function mockFiles(array $files): void
         $filesystem->shouldReceive('get')
             ->andReturnUsing(function (string $file) use ($files) {
                 $file = unslash(str_replace(Hyde::path(), '', $file));
-                $files = static::arrayGlob($files, $file, 'md');
+                $files = collect($files)->mapWithKeys(fn ($contents, $file) => [Str::before(basename($file), '.') => $contents])->all();
 
-                return array_values($files)[0] ?? '';
+                return $files[$file] ?? '';
             });
 
         app()->instance(Filesystem::class, $filesystem);
@@ -141,11 +144,4 @@ public static function tearDown(): void
     {
         static::$mockFiles = [];
     }
-
-    protected static function arrayGlob(array $files, string $name, array|string $extensions): array
-    {
-        return array_filter($files, function (string $file) use ($name, $extensions): bool {
-            return str_contains($file, $name) && str_contains($file, $extensions);
-        }, ARRAY_FILTER_USE_KEY);
-    }
 }

From ba3b72a126abe47696278233a718af747f67bb0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:15:05 +0200
Subject: [PATCH 1897/4023] Test Markdown method returns collection of Markdown
 documents

---
 .../tests/Unit/DataCollectionUnitTest.php       | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 381e08d95a2..de2b58bc6a9 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -103,6 +103,23 @@ public function testStaticMarkdownHelperReturnsNewDataCollectionInstance()
     {
         $this->assertInstanceOf(DataCollection::class, DataCollection::markdown('foo'));
     }
+
+    public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => 'bar',
+            'foo/baz.md' => 'baz',
+        ]);
+
+        $collection = MockableDataCollection::markdown('foo');
+
+        $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
+
+        $this->assertSame([
+            'bar' => 'bar',
+            'baz' => 'baz',
+        ], $collection->map(fn ($value) => (string) $value)->all());
+    }
 }
 
 class MockableDataCollection extends DataCollection

From 8474481fa903caaa2dee5a38f7e5755729700a4e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:15:34 +0200
Subject: [PATCH 1898/4023] Test Yaml method returns collection of front matter
 objects

---
 .../tests/Unit/DataCollectionUnitTest.php       | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index de2b58bc6a9..140b2fdd76c 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -120,6 +120,23 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
             'baz' => 'baz',
         ], $collection->map(fn ($value) => (string) $value)->all());
     }
+
+    public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => '---\nfoo: bar\n---',
+            'foo/baz.yml' => '---\nfoo: baz\n---',
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'bar' => ['foo' => 'bar'],
+            'baz' => ['foo' => 'baz'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
 }
 
 class MockableDataCollection extends DataCollection

From 07e9cc3ba42391da28a06d6e96a78da8d3e26cad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:25:20 +0200
Subject: [PATCH 1899/4023] Update mocks to better match real setup

---
 .../framework/tests/Unit/DataCollectionUnitTest.php  | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 140b2fdd76c..f56d0719652 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -116,8 +116,8 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
         $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
 
         $this->assertSame([
-            'bar' => 'bar',
-            'baz' => 'baz',
+            'foo/bar.md' => 'bar',
+            'foo/baz.md' => 'baz',
         ], $collection->map(fn ($value) => (string) $value)->all());
     }
 
@@ -133,8 +133,8 @@ public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
         $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
 
         $this->assertSame([
-            'bar' => ['foo' => 'bar'],
-            'baz' => ['foo' => 'baz'],
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
         ], $collection->map(fn ($value) => $value->toArray())->all());
     }
 }
@@ -145,7 +145,7 @@ class MockableDataCollection extends DataCollection
 
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
-        return collect(static::$mockFiles)->keys();
+        return collect(static::$mockFiles)->keys()->map(fn ($file) => parent::makeIdentifier($file))->values();
     }
 
     /**
@@ -163,7 +163,7 @@ public static function mockFiles(array $files): void
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('get')
             ->andReturnUsing(function (string $file) use ($files) {
-                $file = unslash(str_replace(Hyde::path(), '', $file));
+                $file = Str::before(basename($file), '.');
                 $files = collect($files)->mapWithKeys(fn ($contents, $file) => [Str::before(basename($file), '.') => $contents])->all();
 
                 return $files[$file] ?? '';

From 330940e3e53c71d17126ee667a362a577c3d15ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:27:13 +0200
Subject: [PATCH 1900/4023] Fix quote usage

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index f56d0719652..69c5f745a05 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -124,8 +124,8 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
     public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
     {
         MockableDataCollection::mockFiles([
-            'foo/bar.yml' => '---\nfoo: bar\n---',
-            'foo/baz.yml' => '---\nfoo: baz\n---',
+            'foo/bar.yml' => "---\nfoo: bar\n---",
+            'foo/baz.yml' => "---\nfoo: baz\n---",
         ]);
 
         $collection = MockableDataCollection::yaml('foo');

From c2ad0e9a4d0dc86c1b4977512e3b95c3b1ce57d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:35:48 +0200
Subject: [PATCH 1901/4023] Test differing Yaml syntaxes

---
 .../tests/Unit/DataCollectionUnitTest.php     | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 69c5f745a05..a89d7d93480 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -137,6 +137,57 @@ public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
             'foo/baz.yml' => ['foo' => 'baz'],
         ], $collection->map(fn ($value) => $value->toArray())->all());
     }
+
+    public function testYamlCollectionsDoNotRequireTripleDashes()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => 'foo: bar',
+            'foo/baz.yml' => 'foo: baz',
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
+
+    public function testYamlCollectionsAcceptTripleDashes()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => "---\nfoo: bar\n---",
+            'foo/baz.yml' => "---\nfoo: baz",
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
+
+    public function testYamlCollectionsSupportYamlAndYmlFileExtensions()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yaml' => "---\nfoo: bar\n---",
+            'foo/baz.yml' => "---\nfoo: baz\n---",
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yaml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
 }
 
 class MockableDataCollection extends DataCollection

From ae8523dcd2522ca5cb5a985ef6903b6410913ad4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:36:28 +0200
Subject: [PATCH 1902/4023] Test Yaml fault tolerance

---
 .../tests/Unit/DataCollectionUnitTest.php     | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index a89d7d93480..65d5185414f 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -188,6 +188,61 @@ public function testYamlCollectionsSupportYamlAndYmlFileExtensions()
             'foo/baz.yml' => ['foo' => 'baz'],
         ], $collection->map(fn ($value) => $value->toArray())->all());
     }
+
+    public function testYamlCollectionsHandleLeadingAndTrailingNewlines()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => "\nfoo: bar\n",
+            'foo/baz.yml' => "\nfoo: baz",
+            'foo/qux.yml' => "foo: qux\n",
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+            'foo/qux.yml' => ['foo' => 'qux'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
+
+    public function testYamlCollectionsHandleTrailingWhitespace()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => 'foo: bar ',
+            'foo/baz.yml' => 'foo: baz  ',
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
+
+    public function testYamlCollectionsHandleLeadingAndTrailingNewlinesAndTrailingWhitespace()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => "\nfoo: bar  \n",
+            'foo/baz.yml' => "\nfoo: baz\n ",
+            'foo/qux.yml' => "foo: qux  \n",
+        ]);
+
+        $collection = MockableDataCollection::yaml('foo');
+
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame([
+            'foo/bar.yml' => ['foo' => 'bar'],
+            'foo/baz.yml' => ['foo' => 'baz'],
+            'foo/qux.yml' => ['foo' => 'qux'],
+        ], $collection->map(fn ($value) => $value->toArray())->all());
+    }
 }
 
 class MockableDataCollection extends DataCollection

From bc8c4fc207595028c0940ffb01417398a683655a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 14:41:46 +0200
Subject: [PATCH 1903/4023] Extract helper to assert front matter collection
 structure

---
 .../tests/Unit/DataCollectionUnitTest.php     | 63 +++++++------------
 1 file changed, 21 insertions(+), 42 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 65d5185414f..14ae99aa8da 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -128,14 +128,10 @@ public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
             'foo/baz.yml' => "---\nfoo: baz\n---",
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsDoNotRequireTripleDashes()
@@ -145,14 +141,10 @@ public function testYamlCollectionsDoNotRequireTripleDashes()
             'foo/baz.yml' => 'foo: baz',
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsAcceptTripleDashes()
@@ -162,14 +154,10 @@ public function testYamlCollectionsAcceptTripleDashes()
             'foo/baz.yml' => "---\nfoo: baz",
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsSupportYamlAndYmlFileExtensions()
@@ -179,14 +167,10 @@ public function testYamlCollectionsSupportYamlAndYmlFileExtensions()
             'foo/baz.yml' => "---\nfoo: baz\n---",
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yaml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsHandleLeadingAndTrailingNewlines()
@@ -197,15 +181,11 @@ public function testYamlCollectionsHandleLeadingAndTrailingNewlines()
             'foo/qux.yml' => "foo: qux\n",
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
             'foo/qux.yml' => ['foo' => 'qux'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsHandleTrailingWhitespace()
@@ -215,14 +195,10 @@ public function testYamlCollectionsHandleTrailingWhitespace()
             'foo/baz.yml' => 'foo: baz  ',
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
     }
 
     public function testYamlCollectionsHandleLeadingAndTrailingNewlinesAndTrailingWhitespace()
@@ -233,15 +209,18 @@ public function testYamlCollectionsHandleLeadingAndTrailingNewlinesAndTrailingWh
             'foo/qux.yml' => "foo: qux  \n",
         ]);
 
-        $collection = MockableDataCollection::yaml('foo');
-
-        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
-
-        $this->assertSame([
+        $this->assertFrontMatterCollectionStructure([
             'foo/bar.yml' => ['foo' => 'bar'],
             'foo/baz.yml' => ['foo' => 'baz'],
             'foo/qux.yml' => ['foo' => 'qux'],
-        ], $collection->map(fn ($value) => $value->toArray())->all());
+        ], MockableDataCollection::yaml('foo'));
+    }
+
+    protected function assertFrontMatterCollectionStructure(array $expected, DataCollection $collection): void
+    {
+        $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);
+
+        $this->assertSame($expected, $collection->map(fn ($value) => $value->toArray())->all());
     }
 }
 

From d36c1a706d949159a5ac9e659f570b6ce91f1934 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 15:08:07 +0200
Subject: [PATCH 1904/4023] Add helper to assert Json collection structure

---
 .../tests/Unit/DataCollectionUnitTest.php          | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 14ae99aa8da..f832c090fe1 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -222,6 +222,20 @@ protected function assertFrontMatterCollectionStructure(array $expected, DataCol
 
         $this->assertSame($expected, $collection->map(fn ($value) => $value->toArray())->all());
     }
+
+    protected function assertJsonCollectionStructure(array $expected, DataCollection $collection, bool $asArray = false): void
+    {
+        if ($asArray) {
+            $this->assertContainsOnly('array', $collection);
+        } else {
+            $this->assertContainsOnly('object', $collection);
+        }
+
+        $this->assertSame(
+            collect($expected)->map(fn ($value) => (array) $value)->all(),
+            $collection->map(fn ($value) => (array) $value)->all()
+        );
+    }
 }
 
 class MockableDataCollection extends DataCollection

From 46a2bb11d2fa436bd21c179c5c54d4d486f9a69a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 15:08:19 +0200
Subject: [PATCH 1905/4023] Simplify assertion handling

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index f832c090fe1..4cff6decc60 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -229,12 +229,12 @@ protected function assertJsonCollectionStructure(array $expected, DataCollection
             $this->assertContainsOnly('array', $collection);
         } else {
             $this->assertContainsOnly('object', $collection);
+
+            $expected = collect($expected)->map(fn ($value) => (array) $value)->all();
+            $collection = $collection->map(fn ($value) => (array) $value);
         }
 
-        $this->assertSame(
-            collect($expected)->map(fn ($value) => (array) $value)->all(),
-            $collection->map(fn ($value) => (array) $value)->all()
-        );
+        $this->assertSame($expected, $collection->all());
     }
 }
 

From 7535cdca2c0d591e260f6d1f09207494e323fa21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 15:08:14 +0200
Subject: [PATCH 1906/4023] Test Json collection handling

---
 .../tests/Unit/DataCollectionUnitTest.php     | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 4cff6decc60..b80b68cbb62 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -216,6 +216,32 @@ public function testYamlCollectionsHandleLeadingAndTrailingNewlinesAndTrailingWh
         ], MockableDataCollection::yaml('foo'));
     }
 
+    public function testJsonMethodReturnsCollectionOfJsonDecodedObjects()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '{"foo": "bar"}',
+            'foo/baz.json' => '{"foo": "baz"}',
+        ]);
+
+        $this->assertJsonCollectionStructure([
+            'foo/bar.json' => (object) ['foo' => 'bar'],
+            'foo/baz.json' => (object) ['foo' => 'baz'],
+        ], MockableDataCollection::json('foo'));
+    }
+
+    public function testJsonMethodReturnsCollectionOfJsonDecodedArrays()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '{"foo": "bar"}',
+            'foo/baz.json' => '{"foo": "baz"}',
+        ]);
+
+        $this->assertJsonCollectionStructure([
+            'foo/bar.json' => ['foo' => 'bar'],
+            'foo/baz.json' => ['foo' => 'baz'],
+        ], MockableDataCollection::json('foo', true), true);
+    }
+
     protected function assertFrontMatterCollectionStructure(array $expected, DataCollection $collection): void
     {
         $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);

From 9ce2c983c65727f831e7b5e5c8502a03dafcb900 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 17:53:52 +0200
Subject: [PATCH 1907/4023] Remove duplicated word from documentation

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index a8fd789b4b0..dcd2938dd34 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -27,7 +27,7 @@
  * they allow you to quickly access the data collections.
  *
  * To use them retrieve a collection, call a facade method with the
- * name of the data collection subdirectory directory.
+ * name of the data collection subdirectory.
  *
  * All collections are indexed by their filename, which is relative
  * to the configured data collection source directory.

From d491da16faab80e430591cdd240ae47820ae143c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:12:33 +0200
Subject: [PATCH 1908/4023] Refactor to extract helper method

---
 .../framework/src/Support/DataCollection.php    | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index dcd2938dd34..181e57d7fc2 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -48,9 +48,9 @@ class DataCollection extends Collection
      */
     public static function markdown(string $name): static
     {
-        return new static(static::findFiles($name, 'md')->mapWithKeys(function (string $file): array {
+        return static::discover($name, 'md', function (string $file): array {
             return [static::makeIdentifier($file) => MarkdownFileParser::parse($file)];
-        }));
+        });
     }
 
     /**
@@ -62,7 +62,7 @@ public static function markdown(string $name): static
      */
     public static function yaml(string $name): static
     {
-        return new static(static::findFiles($name, ['yaml', 'yml'])->mapWithKeys(function (string $file): array {
+        return static::discover($name, ['yaml', 'yml'], function (string $file): array {
             $content = Filesystem::getContents($file);
             $content = Str::between($content, '---', '---');
 
@@ -70,7 +70,7 @@ public static function yaml(string $name): static
             $matter = new FrontMatter($parsed);
 
             return [static::makeIdentifier($file) => $matter];
-        }));
+        });
     }
 
     /**
@@ -82,9 +82,9 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return new static(static::findFiles($name, 'json')->mapWithKeys(function (string $file) use ($asArray): array {
+        return static::discover($name, 'json', function (string $file) use ($asArray): array {
             return [static::makeIdentifier($file) => json_decode(Filesystem::getContents($file), $asArray)];
-        }));
+        });
     }
 
     protected static function findFiles(string $name, array|string $extensions): Collection
@@ -98,4 +98,9 @@ protected static function makeIdentifier(string $path): string
     {
         return unslash(Str::after($path, static::$sourceDirectory));
     }
+
+    protected static function discover(string $name, array|string $extensions, callable $callback): static
+    {
+        return new static(static::findFiles($name, $extensions)->mapWithKeys($callback));
+    }
 }

From aaffe2cbecc2dbf7bd71fa319c95f46dab6c71ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:13:57 +0200
Subject: [PATCH 1909/4023] Move up helper method

---
 packages/framework/src/Support/DataCollection.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 181e57d7fc2..ad9009e5ac5 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -87,6 +87,11 @@ public static function json(string $name, bool $asArray = false): static
         });
     }
 
+    protected static function discover(string $name, array|string $extensions, callable $callback): static
+    {
+        return new static(static::findFiles($name, $extensions)->mapWithKeys($callback));
+    }
+
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
         return Filesystem::smartGlob(sprintf('%s/%s/*.{%s}',
@@ -98,9 +103,4 @@ protected static function makeIdentifier(string $path): string
     {
         return unslash(Str::after($path, static::$sourceDirectory));
     }
-
-    protected static function discover(string $name, array|string $extensions, callable $callback): static
-    {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys($callback));
-    }
 }

From 194899d95ab38100b000731492034a01e90c0bd5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:14:36 +0200
Subject: [PATCH 1910/4023] Rename callback parameter

---
 packages/framework/src/Support/DataCollection.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index ad9009e5ac5..5f4b8a1bdb8 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -87,9 +87,9 @@ public static function json(string $name, bool $asArray = false): static
         });
     }
 
-    protected static function discover(string $name, array|string $extensions, callable $callback): static
+    protected static function discover(string $name, array|string $extensions, callable $mapUsing): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys($callback));
+        return new static(static::findFiles($name, $extensions)->mapWithKeys($mapUsing));
     }
 
     protected static function findFiles(string $name, array|string $extensions): Collection

From f89f40801d55f497f3c061aaff53a9743ddfc539 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:25:27 +0200
Subject: [PATCH 1911/4023] Refactor to further extract shared logic to helper

---
 .../framework/src/Support/DataCollection.php  | 20 +++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 5f4b8a1bdb8..7185e45e16c 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -4,9 +4,11 @@
 
 namespace Hyde\Support;
 
+use stdClass;
 use Hyde\Facades\Filesystem;
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Markdown\Models\FrontMatter;
+use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Framework\Actions\MarkdownFileParser;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
@@ -48,8 +50,8 @@ class DataCollection extends Collection
      */
     public static function markdown(string $name): static
     {
-        return static::discover($name, 'md', function (string $file): array {
-            return [static::makeIdentifier($file) => MarkdownFileParser::parse($file)];
+        return static::discover($name, 'md', function (string $file): MarkdownDocument {
+            return MarkdownFileParser::parse($file);
         });
     }
 
@@ -62,14 +64,14 @@ public static function markdown(string $name): static
      */
     public static function yaml(string $name): static
     {
-        return static::discover($name, ['yaml', 'yml'], function (string $file): array {
+        return static::discover($name, ['yaml', 'yml'], function (string $file): FrontMatter {
             $content = Filesystem::getContents($file);
             $content = Str::between($content, '---', '---');
 
             $parsed = Yaml::parse($content) ?: [];
             $matter = new FrontMatter($parsed);
 
-            return [static::makeIdentifier($file) => $matter];
+            return $matter;
         });
     }
 
@@ -82,14 +84,16 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return static::discover($name, 'json', function (string $file) use ($asArray): array {
-            return [static::makeIdentifier($file) => json_decode(Filesystem::getContents($file), $asArray)];
+        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array {
+            return json_decode(Filesystem::getContents($file), $asArray);
         });
     }
 
-    protected static function discover(string $name, array|string $extensions, callable $mapUsing): static
+    protected static function discover(string $name, array|string $extensions, callable $parseUsing): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys($mapUsing));
+        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing): array {
+            return [static::makeIdentifier($file) => $parseUsing($file)];
+        }));
     }
 
     protected static function findFiles(string $name, array|string $extensions): Collection

From a80b3d41993d3e97c458005265fd140bbe288dae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:25:58 +0200
Subject: [PATCH 1912/4023] Add null return type support pending
 https://github.com/hydephp/develop/issues/1736

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 7185e45e16c..ea1ccb468d2 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -84,7 +84,7 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array {
+        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array|null {
             return json_decode(Filesystem::getContents($file), $asArray);
         });
     }

From ca6f87d74e114ef73678a8db87f1b9d633556f8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:28:11 +0200
Subject: [PATCH 1913/4023] Annotate helper method generics

---
 packages/framework/src/Support/DataCollection.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index ea1ccb468d2..37ba61fafe1 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -89,6 +89,11 @@ public static function json(string $name, bool $asArray = false): static
         });
     }
 
+    /**
+     * @param  array<string>|string  $extensions
+     * @param  callable(string): mixed  $parseUsing  (string $file): mixed
+     * @return static<string, mixed>
+     */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing): static
     {
         return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing): array {

From 0b54e3d42c19cc4c48b7487f7a6e4efc9ad9b87b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:35:12 +0200
Subject: [PATCH 1914/4023] Cleanup PHPDoc comment

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 37ba61fafe1..49d88816951 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -91,7 +91,7 @@ public static function json(string $name, bool $asArray = false): static
 
     /**
      * @param  array<string>|string  $extensions
-     * @param  callable(string): mixed  $parseUsing  (string $file): mixed
+     * @param  callable(string): mixed  $parseUsing
      * @return static<string, mixed>
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing): static

From c232397c8d455d0fa9bafb2912ce9ca43c3f9ddd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:35:54 +0200
Subject: [PATCH 1915/4023] Annotate helper method generics

---
 packages/framework/src/Support/DataCollection.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 49d88816951..daa1ff3a9f0 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -101,6 +101,10 @@ protected static function discover(string $name, array|string $extensions, calla
         }));
     }
 
+    /**
+     * @param  array<string>|string  $extensions
+     * @return Collection<string>
+     */
     protected static function findFiles(string $name, array|string $extensions): Collection
     {
         return Filesystem::smartGlob(sprintf('%s/%s/*.{%s}',

From 1edcc244ee52154469ca6e7f7a4ace098fa4eef2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:36:33 +0200
Subject: [PATCH 1916/4023] Inline local variable

---
 packages/framework/src/Support/DataCollection.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index daa1ff3a9f0..9fe74bbce35 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -69,9 +69,8 @@ public static function yaml(string $name): static
             $content = Str::between($content, '---', '---');
 
             $parsed = Yaml::parse($content) ?: [];
-            $matter = new FrontMatter($parsed);
 
-            return $matter;
+            return new FrontMatter($parsed);
         });
     }
 

From 308a9c11f718a4b9735e50f8da5650dea43550c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:36:58 +0200
Subject: [PATCH 1917/4023] Reorder newlines

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 9fe74bbce35..40d3ec1974c 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -66,8 +66,8 @@ public static function yaml(string $name): static
     {
         return static::discover($name, ['yaml', 'yml'], function (string $file): FrontMatter {
             $content = Filesystem::getContents($file);
-            $content = Str::between($content, '---', '---');
 
+            $content = Str::between($content, '---', '---');
             $parsed = Yaml::parse($content) ?: [];
 
             return new FrontMatter($parsed);

From c2f0faa3d6988e8ff86304225a7a58302f6d6b6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 19:38:54 +0200
Subject: [PATCH 1918/4023] Normalize PHPDoc types

---
 packages/framework/src/Support/DataCollection.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 40d3ec1974c..8804b99f552 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -46,7 +46,7 @@ class DataCollection extends Collection
      *
      * Each Markdown file will be parsed into a MarkdownDocument with front matter.
      *
-     * @return DataCollection<string, \Hyde\Markdown\Models\MarkdownDocument>
+     * @return static<string, \Hyde\Markdown\Models\MarkdownDocument>
      */
     public static function markdown(string $name): static
     {
@@ -60,7 +60,7 @@ public static function markdown(string $name): static
      *
      * Each YAML file will be parsed into a FrontMatter object.
      *
-     * @return DataCollection<string, \Hyde\Markdown\Models\FrontMatter>
+     * @return static<string, \Hyde\Markdown\Models\FrontMatter>
      */
     public static function yaml(string $name): static
     {
@@ -79,7 +79,7 @@ public static function yaml(string $name): static
      *
      * Each JSON file will be parsed into a stdClass object, or an associative array, depending on the second parameter.
      *
-     * @return DataCollection<string, \stdClass|array>
+     * @return static<string, \stdClass|array>
      */
     public static function json(string $name, bool $asArray = false): static
     {

From 24532a1f9fe01135ba84048d618c8992c0000c6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 20:35:02 +0200
Subject: [PATCH 1919/4023] Introduce local variable

---
 packages/framework/src/Support/DataCollection.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 8804b99f552..bc8f534e2e5 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -84,7 +84,9 @@ public static function yaml(string $name): static
     public static function json(string $name, bool $asArray = false): static
     {
         return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array|null {
-            return json_decode(Filesystem::getContents($file), $asArray);
+            $contents = Filesystem::getContents($file);
+
+            return json_decode($contents, $asArray);
         });
     }
 

From 25b4aeb9bba26549e6c9b7716247efd6a31f3b1b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 21:09:17 +0200
Subject: [PATCH 1920/4023] Update Data Collections to validate JSON data files

Fixes https://github.com/hydephp/develop/issues/1736
---
 RELEASE_NOTES.md                              |  7 +++
 .../framework/src/Support/DataCollection.php  |  7 ++-
 .../tests/Feature/DataCollectionTest.php      |  8 +--
 .../tests/Unit/DataCollectionUnitTest.php     | 62 +++++++++++++++++++
 4 files changed, 79 insertions(+), 5 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 53fc95b9911..980fdd8e6dd 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -22,6 +22,7 @@ This serves two purposes:
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
 - Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
+- Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
@@ -232,3 +233,9 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 #### Minor impact
 
 - Calling the `DataCollection` methods will no longer create the data collections directory automatically
+
+#### Issues that may arise
+
+If you start getting `InvalidArgumentException` when using the `DataCollection` class, it may be due to malformed data collection files.
+Starting from this version, we validate the syntax of JSON and YAML files during discovery, to help you catch errors early.
+See https://github.com/hydephp/develop/issues/1736 for more information.
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index bc8f534e2e5..85b0e78cfd1 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -6,6 +6,7 @@
 
 use stdClass;
 use Hyde\Facades\Filesystem;
+use InvalidArgumentException;
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
@@ -83,9 +84,13 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array|null {
+        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array {
             $contents = Filesystem::getContents($file);
 
+            if (! json_validate($contents)) {
+                throw new InvalidArgumentException("Invalid JSON in file: '$file'");
+            }
+
             return json_decode($contents, $asArray);
         });
     }
diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index 9889472841e..70587bdd95d 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -56,11 +56,11 @@ public function testJsonCollections()
     {
         $this->directory('resources/collections/foo');
         $this->file('resources/collections/foo/foo.json', json_encode(['foo' => 'bar']));
-        $this->file('resources/collections/foo/bar.json');
+        $this->file('resources/collections/foo/bar.json', '{"bar": "baz"}');
 
         $this->assertEquals(new DataCollection([
             'foo/foo.json' => (object) ['foo' => 'bar'],
-            'foo/bar.json' => null,
+            'foo/bar.json' => (object) ['bar' => 'baz'],
         ]), DataCollection::json('foo'));
     }
 
@@ -68,11 +68,11 @@ public function testJsonCollectionsAsArrays()
     {
         $this->directory('resources/collections/foo');
         $this->file('resources/collections/foo/foo.json', json_encode(['foo' => 'bar']));
-        $this->file('resources/collections/foo/bar.json');
+        $this->file('resources/collections/foo/bar.json', '{"bar": "baz"}');
 
         $this->assertEquals(new DataCollection([
             'foo/foo.json' => ['foo' => 'bar'],
-            'foo/bar.json' => null,
+            'foo/bar.json' => ['bar' => 'baz'],
         ]), DataCollection::json('foo', true));
     }
 
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index b80b68cbb62..336bb209e12 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
+use InvalidArgumentException;
 use Hyde\Support\DataCollection;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Filesystem\Filesystem;
@@ -242,6 +243,67 @@ public function testJsonMethodReturnsCollectionOfJsonDecodedArrays()
         ], MockableDataCollection::json('foo', true), true);
     }
 
+    public function testJsonMethodThrowsExceptionForInvalidJson()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '{"foo": "bar"',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+
+        MockableDataCollection::json('foo');
+    }
+
+    public function testJsonMethodThrowsExceptionForInvalidJsonWithArray()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '{"foo": "bar"',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+
+        MockableDataCollection::json('foo', true);
+    }
+
+    public function testJsonMethodThrowsExceptionForEmptyJson()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+
+        MockableDataCollection::json('foo');
+    }
+
+    public function testJsonMethodThrowsExceptionForBlankJson()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => ' ',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+
+        MockableDataCollection::json('foo');
+    }
+
+    public function testJsonMethodThrowsExceptionWhenJustOneFileIsInvalid()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.json' => '{"foo": "bar"}',
+            'foo/baz.json' => '{"foo": "baz"',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/baz.json'");
+
+        MockableDataCollection::json('foo');
+    }
+
     protected function assertFrontMatterCollectionStructure(array $expected, DataCollection $collection): void
     {
         $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);

From ebebaa17e670f9fcfbe7db9cad97d469dca1fb66 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 21:11:59 +0200
Subject: [PATCH 1921/4023] Convert string interpolation to a 'sprintf()' call

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 85b0e78cfd1..0065b32981b 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -88,7 +88,7 @@ public static function json(string $name, bool $asArray = false): static
             $contents = Filesystem::getContents($file);
 
             if (! json_validate($contents)) {
-                throw new InvalidArgumentException("Invalid JSON in file: '$file'");
+                throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s'", $file));
             }
 
             return json_decode($contents, $asArray);

From 06dfada5a81b62f7ad61ab0fc7d1ed37f095ccb5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 21:20:23 +0200
Subject: [PATCH 1922/4023] Display the error that caused the JSON decoding to
 fail

---
 .../framework/src/Support/DataCollection.php  |  2 +-
 .../tests/Unit/DataCollectionUnitTest.php     | 34 ++++++++++++++++---
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 0065b32981b..fdea66b8867 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -88,7 +88,7 @@ public static function json(string $name, bool $asArray = false): static
             $contents = Filesystem::getContents($file);
 
             if (! json_validate($contents)) {
-                throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s'", $file));
+                throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s' (%s)", $file, json_last_error_msg()));
             }
 
             return json_decode($contents, $asArray);
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 336bb209e12..7f3eab684f5 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -250,7 +250,7 @@ public function testJsonMethodThrowsExceptionForInvalidJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -262,7 +262,7 @@ public function testJsonMethodThrowsExceptionForInvalidJsonWithArray()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo', true);
     }
@@ -274,7 +274,7 @@ public function testJsonMethodThrowsExceptionForEmptyJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -286,7 +286,7 @@ public function testJsonMethodThrowsExceptionForBlankJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json'");
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -299,7 +299,31 @@ public function testJsonMethodThrowsExceptionWhenJustOneFileIsInvalid()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/baz.json'");
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/baz.json' (Syntax error)");
+
+        MockableDataCollection::json('foo');
+    }
+
+    public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithUtfError()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/utf.json' => "\xB1\x31",
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/utf.json' (Malformed UTF-8 characters, possibly incorrectly encoded)");
+
+        MockableDataCollection::json('foo');
+    }
+
+    public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithControlCharacterError()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/control.json' => "\x19\x31",
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid JSON in file: 'foo/control.json' (Control character error, possibly incorrectly encoded)");
 
         MockableDataCollection::json('foo');
     }

From 9702722e7413ca1e5b61ac7b47a6e447668e45f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 24 Jun 2024 21:22:49 +0200
Subject: [PATCH 1923/4023] Document example to help issue searching lead to
 upgrade path

---
 RELEASE_NOTES.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 980fdd8e6dd..715166a87c5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -239,3 +239,9 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 If you start getting `InvalidArgumentException` when using the `DataCollection` class, it may be due to malformed data collection files.
 Starting from this version, we validate the syntax of JSON and YAML files during discovery, to help you catch errors early.
 See https://github.com/hydephp/develop/issues/1736 for more information.
+
+For example, an empty or malformed JSON file will now throw an exception like this:
+ 
+```php
+InvalidArgumentException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
+```

From b217795239460c06f5157a1cd01924d7e096b2f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 11:53:29 +0200
Subject: [PATCH 1924/4023] Throw a normalized exception for issues parsing
 Yaml

This better matches the JSON exception throwing. See https://github.com/hydephp/develop/issues/1736
---
 RELEASE_NOTES.md                              |  2 ++
 .../framework/src/Support/DataCollection.php  |  8 ++++-
 .../tests/Unit/DataCollectionUnitTest.php     | 36 +++++++++++++++++++
 3 files changed, 45 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 715166a87c5..73109113ac5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -245,3 +245,5 @@ For example, an empty or malformed JSON file will now throw an exception like th
 ```php
 InvalidArgumentException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
+
+In order to normalize the thrown exceptions, we now rethrow Yaml `ParseException` as `InvalidArgumentException` to match the JSON validation.
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index fdea66b8867..21c7a728674 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -11,6 +11,7 @@
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Framework\Actions\MarkdownFileParser;
+use Symfony\Component\Yaml\Exception\ParseException;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
@@ -69,7 +70,12 @@ public static function yaml(string $name): static
             $content = Filesystem::getContents($file);
 
             $content = Str::between($content, '---', '---');
-            $parsed = Yaml::parse($content) ?: [];
+
+            try {
+                $parsed = Yaml::parse($content) ?: [];
+            } catch (ParseException $exception) {
+                throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, $exception->getMessage()), previous: $exception);
+            }
 
             return new FrontMatter($parsed);
         });
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 7f3eab684f5..08b9ffc0404 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -217,6 +217,42 @@ public function testYamlCollectionsHandleLeadingAndTrailingNewlinesAndTrailingWh
         ], MockableDataCollection::yaml('foo'));
     }
 
+    public function testYamlCollectionsThrowExceptionForInvalidYaml()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => "---\nfoo: 'bar",
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\").)");
+
+        MockableDataCollection::yaml('foo');
+    }
+
+    public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorWithUtfError()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/utf.yml' => "foo: \xB1\x31",
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8.)");
+
+        MockableDataCollection::yaml('foo');
+    }
+
+    public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorWithTabsError()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/tabs.yml' => "foo:\n\tbar",
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\").)");
+
+        MockableDataCollection::yaml('foo');
+    }
+
     public function testJsonMethodReturnsCollectionOfJsonDecodedObjects()
     {
         MockableDataCollection::mockFiles([

From d08b1873b0ef0083569073f4a77c9a2af9d71527 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:13:28 +0200
Subject: [PATCH 1925/4023] Throw parse exception for empty Yaml to match
 `json_validate`

See https://github.com/hydephp/develop/issues/1736#issuecomment-2188298689
---
 RELEASE_NOTES.md                              |  1 +
 .../framework/src/Support/DataCollection.php  |  4 ++++
 .../tests/Feature/DataCollectionTest.php      |  2 --
 .../tests/Unit/DataCollectionUnitTest.php     | 24 +++++++++++++++++++
 4 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 73109113ac5..15cd68599a1 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -247,3 +247,4 @@ InvalidArgumentException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
 
 In order to normalize the thrown exceptions, we now rethrow Yaml `ParseException` as `InvalidArgumentException` to match the JSON validation.
+Additionally, an exception will be thrown if a JSON or YAML file is empty, as this is unlikely to be intentional.
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 21c7a728674..a551eb60c37 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -72,6 +72,10 @@ public static function yaml(string $name): static
             $content = Str::between($content, '---', '---');
 
             try {
+                if (blank(trim($content))) {
+                    throw new ParseException('File is empty');
+                }
+
                 $parsed = Yaml::parse($content) ?: [];
             } catch (ParseException $exception) {
                 throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, $exception->getMessage()), previous: $exception);
diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index 70587bdd95d..09ac73dacd0 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -33,12 +33,10 @@ public function testYamlCollections()
         $this->directory('resources/collections/foo');
         $this->markdown('resources/collections/foo/foo.yaml', matter: ['title' => 'Foo']);
         $this->file('resources/collections/foo/bar.yml', "---\ntitle: Bar\n---");
-        $this->file('resources/collections/foo/baz.yml');
 
         $this->assertEquals(new DataCollection([
             'foo/foo.yaml' => new FrontMatter(['title' => 'Foo']),
             'foo/bar.yml' => new FrontMatter(['title' => 'Bar']),
-            'foo/baz.yml' => new FrontMatter([]),
         ]), DataCollection::yaml('foo'));
     }
 
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 08b9ffc0404..cb64171a241 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -229,6 +229,30 @@ public function testYamlCollectionsThrowExceptionForInvalidYaml()
         MockableDataCollection::yaml('foo');
     }
 
+    public function testYamlCollectionsThrowExceptionForEmptyYaml()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => '',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (File is empty)");
+
+        MockableDataCollection::yaml('foo');
+    }
+
+    public function testYamlCollectionsThrowExceptionForBlankYaml()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.yml' => ' ',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (File is empty)");
+
+        MockableDataCollection::yaml('foo');
+    }
+
     public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorWithUtfError()
     {
         MockableDataCollection::mockFiles([

From f93cb0eec23bd2cfb27f1a31221bf23f96573a29 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:19:07 +0200
Subject: [PATCH 1926/4023] Document code reasoning

---
 packages/framework/src/Support/DataCollection.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index a551eb60c37..2559eadd7ed 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -73,6 +73,7 @@ public static function yaml(string $name): static
 
             try {
                 if (blank(trim($content))) {
+                    // We throw an exception here in order to match the behavior of the JSON validation.
                     throw new ParseException('File is empty');
                 }
 

From b0d1e224072791a12e98eeaadf986eaf88e8b2ee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:26:16 +0200
Subject: [PATCH 1927/4023] Remove unreachable null coalesce

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 2559eadd7ed..98b2d3f735f 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -77,7 +77,7 @@ public static function yaml(string $name): static
                     throw new ParseException('File is empty');
                 }
 
-                $parsed = Yaml::parse($content) ?: [];
+                $parsed = Yaml::parse($content);
             } catch (ParseException $exception) {
                 throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, $exception->getMessage()), previous: $exception);
             }

From 65aadb5b6ad20871d292e1b15b232db93a2ef70b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:27:52 +0200
Subject: [PATCH 1928/4023] Trim trailing periods to make message fit in better

---
 packages/framework/src/Support/DataCollection.php        | 2 +-
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 98b2d3f735f..443ce5831b9 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -79,7 +79,7 @@ public static function yaml(string $name): static
 
                 $parsed = Yaml::parse($content);
             } catch (ParseException $exception) {
-                throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, $exception->getMessage()), previous: $exception);
+                throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
             }
 
             return new FrontMatter($parsed);
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cb64171a241..20de280cb73 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -224,7 +224,7 @@ public function testYamlCollectionsThrowExceptionForInvalidYaml()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\").)");
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\"))");
 
         MockableDataCollection::yaml('foo');
     }
@@ -260,7 +260,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8.)");
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8)");
 
         MockableDataCollection::yaml('foo');
     }
@@ -272,7 +272,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\").)");
+        $this->expectExceptionMessage("Invalid YAML in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\"))");
 
         MockableDataCollection::yaml('foo');
     }

From d4c970e947b98cb417fd8e2038e4c85cfcaa7c8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:28:46 +0200
Subject: [PATCH 1929/4023] Import used functions

---
 packages/framework/src/Support/DataCollection.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 443ce5831b9..96549f18d9f 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -15,10 +15,14 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
+use function trim;
+use function blank;
+use function rtrim;
 use function implode;
 use function json_decode;
 use function sprintf;
 use function unslash;
+use function json_last_error_msg;
 
 /**
  * Automatically generates Laravel Collections from static data files,

From 9f52220f8e2db60f297ad27b80987c55583b5a2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:31:49 +0200
Subject: [PATCH 1930/4023] Extract helper methods responsible for parsing each
 file

---
 .../framework/src/Support/DataCollection.php  | 63 ++++++++++++-------
 1 file changed, 39 insertions(+), 24 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 96549f18d9f..375a6f978ad 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -57,7 +57,7 @@ class DataCollection extends Collection
     public static function markdown(string $name): static
     {
         return static::discover($name, 'md', function (string $file): MarkdownDocument {
-            return MarkdownFileParser::parse($file);
+            return static::parseMarkdownFile($file);
         });
     }
 
@@ -71,22 +71,7 @@ public static function markdown(string $name): static
     public static function yaml(string $name): static
     {
         return static::discover($name, ['yaml', 'yml'], function (string $file): FrontMatter {
-            $content = Filesystem::getContents($file);
-
-            $content = Str::between($content, '---', '---');
-
-            try {
-                if (blank(trim($content))) {
-                    // We throw an exception here in order to match the behavior of the JSON validation.
-                    throw new ParseException('File is empty');
-                }
-
-                $parsed = Yaml::parse($content);
-            } catch (ParseException $exception) {
-                throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
-            }
-
-            return new FrontMatter($parsed);
+            return static::parseYamlFile($file);
         });
     }
 
@@ -100,13 +85,7 @@ public static function yaml(string $name): static
     public static function json(string $name, bool $asArray = false): static
     {
         return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array {
-            $contents = Filesystem::getContents($file);
-
-            if (! json_validate($contents)) {
-                throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s' (%s)", $file, json_last_error_msg()));
-            }
-
-            return json_decode($contents, $asArray);
+            return static::parseJsonFile($file, $asArray);
         });
     }
 
@@ -137,4 +116,40 @@ protected static function makeIdentifier(string $path): string
     {
         return unslash(Str::after($path, static::$sourceDirectory));
     }
+
+    protected static function parseMarkdownFile(string $file): MarkdownDocument
+    {
+        return MarkdownFileParser::parse($file);
+    }
+
+    protected static function parseYamlFile(string $file): FrontMatter
+    {
+        $content = Filesystem::getContents($file);
+
+        $content = Str::between($content, '---', '---');
+
+        try {
+            if (blank(trim($content))) {
+                // We throw an exception here in order to match the behavior of the JSON validation.
+                throw new ParseException('File is empty');
+            }
+
+            $parsed = Yaml::parse($content);
+        } catch (ParseException $exception) {
+            throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+        }
+
+        return new FrontMatter($parsed);
+    }
+
+    protected static function parseJsonFile(string $file, bool $asArray): stdClass|array
+    {
+        $contents = Filesystem::getContents($file);
+
+        if (! json_validate($contents)) {
+            throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s' (%s)", $file, json_last_error_msg()));
+        }
+
+        return json_decode($contents, $asArray);
+    }
 }

From 2d2cfe8c42cde32c7d1f2bb373e3a220437080d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:33:04 +0200
Subject: [PATCH 1931/4023] Convert simplified closures to arrow functions

---
 packages/framework/src/Support/DataCollection.php | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 375a6f978ad..b6a405409ea 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -56,9 +56,7 @@ class DataCollection extends Collection
      */
     public static function markdown(string $name): static
     {
-        return static::discover($name, 'md', function (string $file): MarkdownDocument {
-            return static::parseMarkdownFile($file);
-        });
+        return static::discover($name, 'md', fn (string $file): MarkdownDocument => static::parseMarkdownFile($file));
     }
 
     /**
@@ -70,9 +68,7 @@ public static function markdown(string $name): static
      */
     public static function yaml(string $name): static
     {
-        return static::discover($name, ['yaml', 'yml'], function (string $file): FrontMatter {
-            return static::parseYamlFile($file);
-        });
+        return static::discover($name, ['yaml', 'yml'], fn (string $file): FrontMatter => static::parseYamlFile($file));
     }
 
     /**
@@ -84,9 +80,7 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return static::discover($name, 'json', function (string $file) use ($asArray): stdClass|array {
-            return static::parseJsonFile($file, $asArray);
-        });
+        return static::discover($name, 'json', fn (string $file): stdClass|array => static::parseJsonFile($file, $asArray));
     }
 
     /**

From a99947a13b77b7e6d0cecabc9633921d5851ece5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:35:49 +0200
Subject: [PATCH 1932/4023] Document throws

---
 packages/framework/src/Support/DataCollection.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index b6a405409ea..5d5bce3a0f0 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -116,6 +116,7 @@ protected static function parseMarkdownFile(string $file): MarkdownDocument
         return MarkdownFileParser::parse($file);
     }
 
+    /** @throws InvalidArgumentException If the YAML is invalid and cannot be parsed. */
     protected static function parseYamlFile(string $file): FrontMatter
     {
         $content = Filesystem::getContents($file);
@@ -136,6 +137,7 @@ protected static function parseYamlFile(string $file): FrontMatter
         return new FrontMatter($parsed);
     }
 
+    /** @throws InvalidArgumentException If the JSON is invalid and cannot be parsed. */
     protected static function parseJsonFile(string $file, bool $asArray): stdClass|array
     {
         $contents = Filesystem::getContents($file);

From df820efa5af9bd304c6abbc19c7d8a7039c37c09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:37:50 +0200
Subject: [PATCH 1933/4023] Move return into try/catch block

Makes the intended execution flow clearer
---
 packages/framework/src/Support/DataCollection.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 5d5bce3a0f0..4497f0043ee 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -130,11 +130,11 @@ protected static function parseYamlFile(string $file): FrontMatter
             }
 
             $parsed = Yaml::parse($content);
+
+            return new FrontMatter($parsed);
         } catch (ParseException $exception) {
             throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
         }
-
-        return new FrontMatter($parsed);
     }
 
     /** @throws InvalidArgumentException If the JSON is invalid and cannot be parsed. */

From 9b33cfd1ee464d83d775de65c345769926dbf479 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:38:06 +0200
Subject: [PATCH 1934/4023] Inline local variable

---
 packages/framework/src/Support/DataCollection.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 4497f0043ee..afde91abdac 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -129,9 +129,7 @@ protected static function parseYamlFile(string $file): FrontMatter
                 throw new ParseException('File is empty');
             }
 
-            $parsed = Yaml::parse($content);
-
-            return new FrontMatter($parsed);
+            return new FrontMatter(Yaml::parse($content));
         } catch (ParseException $exception) {
             throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
         }

From b933be67e91f275a29f66a775996fdaa62c5073a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:38:18 +0200
Subject: [PATCH 1935/4023] Cleanup formatting

---
 packages/framework/src/Support/DataCollection.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index afde91abdac..8fffc214795 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -120,7 +120,6 @@ protected static function parseMarkdownFile(string $file): MarkdownDocument
     protected static function parseYamlFile(string $file): FrontMatter
     {
         $content = Filesystem::getContents($file);
-
         $content = Str::between($content, '---', '---');
 
         try {

From fc67b1178a364f321b4f028add769d265f2a395e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:41:35 +0200
Subject: [PATCH 1936/4023] Use first class callable syntax where possible

---
 packages/framework/src/Support/DataCollection.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 8fffc214795..e0a5dcef0fc 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -56,7 +56,7 @@ class DataCollection extends Collection
      */
     public static function markdown(string $name): static
     {
-        return static::discover($name, 'md', fn (string $file): MarkdownDocument => static::parseMarkdownFile($file));
+        return static::discover($name, 'md', static::parseMarkdownFile(...));
     }
 
     /**
@@ -68,7 +68,7 @@ public static function markdown(string $name): static
      */
     public static function yaml(string $name): static
     {
-        return static::discover($name, ['yaml', 'yml'], fn (string $file): FrontMatter => static::parseYamlFile($file));
+        return static::discover($name, ['yaml', 'yml'], static::parseYamlFile(...));
     }
 
     /**

From 88a92042295302ce208c00c9c2cdda67e19ff0c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:43:54 +0200
Subject: [PATCH 1937/4023] Support passing extra arguments to discover method

In order to support first class callables
---
 packages/framework/src/Support/DataCollection.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index e0a5dcef0fc..704e48a9c6b 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -80,7 +80,7 @@ public static function yaml(string $name): static
      */
     public static function json(string $name, bool $asArray = false): static
     {
-        return static::discover($name, 'json', fn (string $file): stdClass|array => static::parseJsonFile($file, $asArray));
+        return static::discover($name, 'json', static::parseJsonFile(...), [$asArray]);
     }
 
     /**
@@ -88,10 +88,10 @@ public static function json(string $name, bool $asArray = false): static
      * @param  callable(string): mixed  $parseUsing
      * @return static<string, mixed>
      */
-    protected static function discover(string $name, array|string $extensions, callable $parseUsing): static
+    protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $args = []): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing): array {
-            return [static::makeIdentifier($file) => $parseUsing($file)];
+        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $args): array {
+            return [static::makeIdentifier($file) => $parseUsing($file, ...$args)];
         }));
     }
 

From dc26d8826d26ebda2d38ba46b3e072b4271fc658 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:44:29 +0200
Subject: [PATCH 1938/4023] Clarify parameter name

---
 packages/framework/src/Support/DataCollection.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 704e48a9c6b..9e6ea8c80d2 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -88,10 +88,10 @@ public static function json(string $name, bool $asArray = false): static
      * @param  callable(string): mixed  $parseUsing
      * @return static<string, mixed>
      */
-    protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $args = []): static
+    protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $args): array {
-            return [static::makeIdentifier($file) => $parseUsing($file, ...$args)];
+        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $extraArgs): array {
+            return [static::makeIdentifier($file) => $parseUsing($file, ...$extraArgs)];
         }));
     }
 

From ea04ed1448bb3fa8b1f4a204ce21c4c42515d94d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:45:31 +0200
Subject: [PATCH 1939/4023] Narrow down mixed generic return type to actual
 supported types

---
 packages/framework/src/Support/DataCollection.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 9e6ea8c80d2..a709d76cce8 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -86,7 +86,7 @@ public static function json(string $name, bool $asArray = false): static
     /**
      * @param  array<string>|string  $extensions
      * @param  callable(string): mixed  $parseUsing
-     * @return static<string, mixed>
+     * @return static<string, MarkdownDocument|FrontMatter|stdClass|array>
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {

From 670dd7aeeb4b7482dea96fd0039f16bac5e4212a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:53:24 +0200
Subject: [PATCH 1940/4023] Extract testing helper

---
 .../tests/Unit/DataCollectionUnitTest.php         | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 20de280cb73..313147c5fea 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -112,14 +112,10 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
             'foo/baz.md' => 'baz',
         ]);
 
-        $collection = MockableDataCollection::markdown('foo');
-
-        $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
-
-        $this->assertSame([
+        $this->asserMarkdownCollectionStructure([
             'foo/bar.md' => 'bar',
             'foo/baz.md' => 'baz',
-        ], $collection->map(fn ($value) => (string) $value)->all());
+        ], MockableDataCollection::markdown('foo'));
     }
 
     public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
@@ -388,6 +384,13 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithC
         MockableDataCollection::json('foo');
     }
 
+    protected function asserMarkdownCollectionStructure(array $expected, DataCollection $collection): void
+    {
+        $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
+
+        $this->assertSame($expected, $collection->map(fn ($value) => (string) $value)->all());
+    }
+
     protected function assertFrontMatterCollectionStructure(array $expected, DataCollection $collection): void
     {
         $this->assertContainsOnlyInstancesOf(FrontMatter::class, $collection);

From e32f6f8508cecd6e9fb9f9541011d660a57145d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 12:58:17 +0200
Subject: [PATCH 1941/4023] Update testing helper to compare front matter

---
 .../tests/Unit/DataCollectionUnitTest.php        | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 313147c5fea..204b4713a1b 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -388,7 +388,21 @@ protected function asserMarkdownCollectionStructure(array $expected, DataCollect
     {
         $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
 
-        $this->assertSame($expected, $collection->map(fn ($value) => (string) $value)->all());
+        if ($collection->contains(fn (MarkdownDocument $document) => filled($document->matter()->toArray()))) {
+            $expected = collect($expected)->map(fn ($value) => [
+                'matter' => $value['matter'],
+                'content' => $value['content'],
+            ])->all();
+
+            $collection = $collection->map(fn (MarkdownDocument $document) => [
+                'matter' => $document->matter()->toArray(),
+                'content' => $document->markdown()->body(),
+            ]);
+
+            $this->assertSame($expected, $collection->all());
+        } else {
+            $this->assertSame($expected, $collection->map(fn ($value) => (string) $value)->all());
+        }
     }
 
     protected function assertFrontMatterCollectionStructure(array $expected, DataCollection $collection): void

From 6c1497b321bbadb5f9f3819ceb8fecf623212c78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:00:08 +0200
Subject: [PATCH 1942/4023] Support mixed states

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 204b4713a1b..ca9fe6d3c77 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -389,10 +389,10 @@ protected function asserMarkdownCollectionStructure(array $expected, DataCollect
         $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
 
         if ($collection->contains(fn (MarkdownDocument $document) => filled($document->matter()->toArray()))) {
-            $expected = collect($expected)->map(fn ($value) => [
+            $expected = collect($expected)->map(fn ($value) => is_array($value) ? [
                 'matter' => $value['matter'],
                 'content' => $value['content'],
-            ])->all();
+            ] : (string) $value)->all();
 
             $collection = $collection->map(fn (MarkdownDocument $document) => [
                 'matter' => $document->matter()->toArray(),

From 8be9527a9cd55396c0561c160196bd9e58b8f55e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:00:20 +0200
Subject: [PATCH 1943/4023] Test Markdown collections with front matter

---
 .../tests/Unit/DataCollectionUnitTest.php     | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index ca9fe6d3c77..9666bea8426 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -118,6 +118,44 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
         ], MockableDataCollection::markdown('foo'));
     }
 
+    public function testMarkdownMethodReturnsCollectionOfMarkdownDocumentsWithFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\nfoo: bar\n---\nbar",
+            'foo/baz.md' => "---\nfoo: baz\n---\nbaz",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => [
+                'matter' => ['foo' => 'bar'],
+                'content' => 'bar',
+            ],
+            'foo/baz.md' => [
+                'matter' => ['foo' => 'baz'],
+                'content' => 'baz',
+            ],
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodReturnsCollectionOfMarkdownDocumentsWithOnlyOneHavingFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => 'bar',
+            'foo/baz.md' => "---\nfoo: baz\n---\nbaz",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => [
+                'matter' => [],
+                'content' => 'bar',
+            ],
+            'foo/baz.md' => [
+                'matter' => ['foo' => 'baz'],
+                'content' => 'baz',
+            ],
+        ], MockableDataCollection::markdown('foo'));
+    }
+
     public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
     {
         MockableDataCollection::mockFiles([

From bde59d8c9683de7cb119213015e510fc33dca8ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:07:03 +0200
Subject: [PATCH 1944/4023] Add edge case tests

---
 .../tests/Unit/DataCollectionUnitTest.php     | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 9666bea8426..ee03c4cff40 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -156,6 +156,75 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocumentsWithOnlyOn
         ], MockableDataCollection::markdown('foo'));
     }
 
+    public function testMarkdownMethodWithEmptyFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\n---\nbar",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => 'bar',
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodWithEmptyFrontMatterAndContent()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\n---",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => '',
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodWithEmptyContent()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\nfoo: bar\n---",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => [
+                'matter' => ['foo' => 'bar'],
+                'content' => '',
+            ],
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodWithEmptyFile()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => '',
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => '',
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodWithUnterminatedFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\nfoo: bar\nbar",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => "---\nfoo: bar\nbar",
+        ], MockableDataCollection::markdown('foo'));
+    }
+
+    public function testMarkdownMethodWithUninitializedFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "foo: bar\n---\nbar",
+        ]);
+
+        $this->asserMarkdownCollectionStructure([
+            'foo/bar.md' => "foo: bar\n---\nbar",
+        ], MockableDataCollection::markdown('foo'));
+    }
+
     public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
     {
         MockableDataCollection::mockFiles([

From 11a9205e99b1c6cdf5ad49b62e628bf7639e5448 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:07:33 +0200
Subject: [PATCH 1945/4023] Fix typo in testing helper name

---
 .../tests/Unit/DataCollectionUnitTest.php     | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index ee03c4cff40..5566c291862 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -112,7 +112,7 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocuments()
             'foo/baz.md' => 'baz',
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => 'bar',
             'foo/baz.md' => 'baz',
         ], MockableDataCollection::markdown('foo'));
@@ -125,7 +125,7 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocumentsWithFrontM
             'foo/baz.md' => "---\nfoo: baz\n---\nbaz",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => [
                 'matter' => ['foo' => 'bar'],
                 'content' => 'bar',
@@ -144,7 +144,7 @@ public function testMarkdownMethodReturnsCollectionOfMarkdownDocumentsWithOnlyOn
             'foo/baz.md' => "---\nfoo: baz\n---\nbaz",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => [
                 'matter' => [],
                 'content' => 'bar',
@@ -162,7 +162,7 @@ public function testMarkdownMethodWithEmptyFrontMatter()
             'foo/bar.md' => "---\n---\nbar",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => 'bar',
         ], MockableDataCollection::markdown('foo'));
     }
@@ -173,7 +173,7 @@ public function testMarkdownMethodWithEmptyFrontMatterAndContent()
             'foo/bar.md' => "---\n---",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => '',
         ], MockableDataCollection::markdown('foo'));
     }
@@ -184,7 +184,7 @@ public function testMarkdownMethodWithEmptyContent()
             'foo/bar.md' => "---\nfoo: bar\n---",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => [
                 'matter' => ['foo' => 'bar'],
                 'content' => '',
@@ -198,7 +198,7 @@ public function testMarkdownMethodWithEmptyFile()
             'foo/bar.md' => '',
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => '',
         ], MockableDataCollection::markdown('foo'));
     }
@@ -209,7 +209,7 @@ public function testMarkdownMethodWithUnterminatedFrontMatter()
             'foo/bar.md' => "---\nfoo: bar\nbar",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => "---\nfoo: bar\nbar",
         ], MockableDataCollection::markdown('foo'));
     }
@@ -220,7 +220,7 @@ public function testMarkdownMethodWithUninitializedFrontMatter()
             'foo/bar.md' => "foo: bar\n---\nbar",
         ]);
 
-        $this->asserMarkdownCollectionStructure([
+        $this->assertMarkdownCollectionStructure([
             'foo/bar.md' => "foo: bar\n---\nbar",
         ], MockableDataCollection::markdown('foo'));
     }
@@ -491,7 +491,7 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithC
         MockableDataCollection::json('foo');
     }
 
-    protected function asserMarkdownCollectionStructure(array $expected, DataCollection $collection): void
+    protected function assertMarkdownCollectionStructure(array $expected, DataCollection $collection): void
     {
         $this->assertContainsOnlyInstancesOf(MarkdownDocument::class, $collection);
 

From 30c2a7425332f7b57d3ca77f4454c1aa6dccc0db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:08:07 +0200
Subject: [PATCH 1946/4023] Test Markdown method with invalid front matter

---
 .../framework/tests/Unit/DataCollectionUnitTest.php  | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 5566c291862..07d1a408727 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -14,6 +14,7 @@
 use Mockery;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
+use Symfony\Component\Yaml\Exception\ParseException;
 
 /**
  * @covers \Hyde\Support\DataCollection
@@ -225,6 +226,17 @@ public function testMarkdownMethodWithUninitializedFrontMatter()
         ], MockableDataCollection::markdown('foo'));
     }
 
+    public function testMarkdownMethodWithInvalidFrontMatter()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => "---\nfoo: 'bar\n---\nbar",
+        ]);
+
+        $this->expectException(ParseException::class);
+
+        MockableDataCollection::markdown('foo');
+    }
+
     public function testYamlMethodReturnsCollectionOfFrontMatterObjects()
     {
         MockableDataCollection::mockFiles([

From 9ca7a795f37817d84a35e7e245a30ba7769fcb8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 13:13:18 +0200
Subject: [PATCH 1947/4023] Normalize exception handling for Markdown data
 files

---
 packages/framework/src/Support/DataCollection.php        | 7 ++++++-
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 4 ++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index a709d76cce8..f72f471aa82 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -111,9 +111,14 @@ protected static function makeIdentifier(string $path): string
         return unslash(Str::after($path, static::$sourceDirectory));
     }
 
+    /** @throws InvalidArgumentException If the Markdown is invalid and cannot be parsed. */
     protected static function parseMarkdownFile(string $file): MarkdownDocument
     {
-        return MarkdownFileParser::parse($file);
+        try {
+            return MarkdownFileParser::parse($file);
+        } catch (ParseException $exception) {
+            throw new InvalidArgumentException(sprintf("Invalid Markdown in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+        }
     }
 
     /** @throws InvalidArgumentException If the YAML is invalid and cannot be parsed. */
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 07d1a408727..097712f0490 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -14,7 +14,6 @@
 use Mockery;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
-use Symfony\Component\Yaml\Exception\ParseException;
 
 /**
  * @covers \Hyde\Support\DataCollection
@@ -232,7 +231,8 @@ public function testMarkdownMethodWithInvalidFrontMatter()
             'foo/bar.md' => "---\nfoo: 'bar\n---\nbar",
         ]);
 
-        $this->expectException(ParseException::class);
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (Malformed inline YAML string at line 1 (near \"foo: 'bar\"))");
 
         MockableDataCollection::markdown('foo');
     }

From 4ecabc9a581a439e559a9ebfbb00e7a835cf5b7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 14:14:25 +0200
Subject: [PATCH 1948/4023] Throw an exception when Markdown data file is empty

And no front matter is set
---
 .../framework/src/Support/DataCollection.php  |  8 ++++-
 .../tests/Feature/DataCollectionTest.php      | 32 +++++++++----------
 .../tests/Unit/DataCollectionUnitTest.php     | 20 ++++++------
 3 files changed, 34 insertions(+), 26 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index f72f471aa82..995c44bb174 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -115,7 +115,13 @@ protected static function makeIdentifier(string $path): string
     protected static function parseMarkdownFile(string $file): MarkdownDocument
     {
         try {
-            return MarkdownFileParser::parse($file);
+            $document = MarkdownFileParser::parse($file);
+
+            if (blank(trim($document->markdown()->body())) && $document->matter()->toArray() === []) {
+                throw new ParseException('File is empty');
+            }
+
+            return $document;
         } catch (ParseException $exception) {
             throw new InvalidArgumentException(sprintf("Invalid Markdown in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
         }
diff --git a/packages/framework/tests/Feature/DataCollectionTest.php b/packages/framework/tests/Feature/DataCollectionTest.php
index 09ac73dacd0..7577da7de8a 100644
--- a/packages/framework/tests/Feature/DataCollectionTest.php
+++ b/packages/framework/tests/Feature/DataCollectionTest.php
@@ -20,11 +20,11 @@ public function testMarkdownCollections()
     {
         $this->directory('resources/collections/foo');
         $this->markdown('resources/collections/foo/foo.md', 'Hello World', ['title' => 'Foo']);
-        $this->file('resources/collections/foo/bar.md');
+        $this->file('resources/collections/foo/bar.md', 'Foo');
 
         $this->assertEquals(new DataCollection([
             'foo/foo.md' => new MarkdownDocument(['title' => 'Foo'], 'Hello World'),
-            'foo/bar.md' => new MarkdownDocument([], ''),
+            'foo/bar.md' => new MarkdownDocument([], 'Foo'),
         ]), DataCollection::markdown('foo'));
     }
 
@@ -91,8 +91,8 @@ public function testFindMarkdownFilesMethodReturnsEmptyArrayIfNoFilesAreFoundInS
     public function testFindMarkdownFilesMethodReturnsAnArrayOfMarkdownFilesInTheSpecifiedDirectory()
     {
         $this->directory('resources/collections/foo');
-        $this->file('resources/collections/foo/foo.md');
-        $this->file('resources/collections/foo/bar.md');
+        $this->file('resources/collections/foo/foo.md', 'Foo');
+        $this->file('resources/collections/foo/bar.md', 'Bar');
 
         $this->assertSame([
             'foo/bar.md',
@@ -104,8 +104,8 @@ public function testFindMarkdownFilesMethodDoesNotIncludeFilesInSubdirectories()
     {
         $this->directory('resources/collections/foo');
         $this->directory('resources/collections/foo/bar');
-        $this->file('resources/collections/foo/foo.md');
-        $this->file('resources/collections/foo/bar/bar.md');
+        $this->file('resources/collections/foo/foo.md', 'Foo');
+        $this->file('resources/collections/foo/bar/bar.md', 'Bar');
 
         $this->assertSame([
             'foo/foo.md',
@@ -115,8 +115,8 @@ public function testFindMarkdownFilesMethodDoesNotIncludeFilesInSubdirectories()
     public function testFindMarkdownFilesMethodDoesNotIncludeFilesWithExtensionsOtherThanMd()
     {
         $this->directory('resources/collections/foo');
-        $this->file('resources/collections/foo/foo.md');
-        $this->file('resources/collections/foo/bar.txt');
+        $this->file('resources/collections/foo/foo.md', 'Foo');
+        $this->file('resources/collections/foo/bar.txt', 'Bar');
 
         $this->assertSame([
             'foo/foo.md',
@@ -126,7 +126,7 @@ public function testFindMarkdownFilesMethodDoesNotIncludeFilesWithExtensionsOthe
     public function testFindMarkdownFilesMethodDoesNotRemoveFilesStartingWithAnUnderscore()
     {
         $this->directory('resources/collections/foo');
-        $this->file('resources/collections/foo/_foo.md');
+        $this->file('resources/collections/foo/_foo.md', 'Foo');
 
         $this->assertSame([
             'foo/_foo.md',
@@ -136,20 +136,20 @@ public function testFindMarkdownFilesMethodDoesNotRemoveFilesStartingWithAnUnder
     public function testStaticMarkdownHelperDiscoversAndParsesMarkdownFilesInTheSpecifiedDirectory()
     {
         $this->directory('resources/collections/foo');
-        $this->file('resources/collections/foo/foo.md');
-        $this->file('resources/collections/foo/bar.md');
+        $this->file('resources/collections/foo/foo.md', 'Foo');
+        $this->file('resources/collections/foo/bar.md', 'Bar');
 
         $this->assertEquals([
-            'foo/foo.md' => new MarkdownDocument([], ''),
-            'foo/bar.md' => new MarkdownDocument([], ''),
+            'foo/foo.md' => new MarkdownDocument([], 'Foo'),
+            'foo/bar.md' => new MarkdownDocument([], 'Bar'),
         ], DataCollection::markdown('foo')->toArray());
     }
 
     public function testStaticMarkdownHelperDoestNotIgnoreFilesStartingWithAnUnderscore()
     {
         $this->directory('resources/collections/foo');
-        $this->file('resources/collections/foo/foo.md');
-        $this->file('resources/collections/foo/_bar.md');
+        $this->file('resources/collections/foo/foo.md', 'Foo');
+        $this->file('resources/collections/foo/_bar.md', 'Bar');
 
         $this->assertCount(2, DataCollection::markdown('foo'));
     }
@@ -158,7 +158,7 @@ public function testSourceDirectoryCanBeChanged()
     {
         DataCollection::$sourceDirectory = 'foo';
         $this->directory('foo/bar');
-        $this->file('foo/bar/foo.md');
+        $this->file('foo/bar/foo.md', 'Foo');
 
         $this->assertSame([
             'bar/foo.md',
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 097712f0490..696f6fbfdbf 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -167,18 +167,19 @@ public function testMarkdownMethodWithEmptyFrontMatter()
         ], MockableDataCollection::markdown('foo'));
     }
 
-    public function testMarkdownMethodWithEmptyFrontMatterAndContent()
+    public function testMarkdownMethodWithEmptyFrontMatterAndContentThrowsException()
     {
         MockableDataCollection::mockFiles([
             'foo/bar.md' => "---\n---",
         ]);
 
-        $this->assertMarkdownCollectionStructure([
-            'foo/bar.md' => '',
-        ], MockableDataCollection::markdown('foo'));
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
+
+        MockableDataCollection::markdown('foo');
     }
 
-    public function testMarkdownMethodWithEmptyContent()
+    public function testMarkdownMethodWithEmptyContentIsAcceptableIfFrontMatterIsSet()
     {
         MockableDataCollection::mockFiles([
             'foo/bar.md' => "---\nfoo: bar\n---",
@@ -192,15 +193,16 @@ public function testMarkdownMethodWithEmptyContent()
         ], MockableDataCollection::markdown('foo'));
     }
 
-    public function testMarkdownMethodWithEmptyFile()
+    public function testMarkdownMethodWithEmptyFileThrowsException()
     {
         MockableDataCollection::mockFiles([
             'foo/bar.md' => '',
         ]);
 
-        $this->assertMarkdownCollectionStructure([
-            'foo/bar.md' => '',
-        ], MockableDataCollection::markdown('foo'));
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
+
+        MockableDataCollection::markdown('foo');
     }
 
     public function testMarkdownMethodWithUnterminatedFrontMatter()

From 005dc15f0a1a863505eb97a54fdeb3883f458dad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 14:14:44 +0200
Subject: [PATCH 1949/4023] Reorder test methods

---
 .../tests/Unit/DataCollectionUnitTest.php     | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 696f6fbfdbf..b8bcc94aae8 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -167,6 +167,18 @@ public function testMarkdownMethodWithEmptyFrontMatter()
         ], MockableDataCollection::markdown('foo'));
     }
 
+    public function testMarkdownMethodWithEmptyFileThrowsException()
+    {
+        MockableDataCollection::mockFiles([
+            'foo/bar.md' => '',
+        ]);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
+
+        MockableDataCollection::markdown('foo');
+    }
+
     public function testMarkdownMethodWithEmptyFrontMatterAndContentThrowsException()
     {
         MockableDataCollection::mockFiles([
@@ -193,18 +205,6 @@ public function testMarkdownMethodWithEmptyContentIsAcceptableIfFrontMatterIsSet
         ], MockableDataCollection::markdown('foo'));
     }
 
-    public function testMarkdownMethodWithEmptyFileThrowsException()
-    {
-        MockableDataCollection::mockFiles([
-            'foo/bar.md' => '',
-        ]);
-
-        $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
-
-        MockableDataCollection::markdown('foo');
-    }
-
     public function testMarkdownMethodWithUnterminatedFrontMatter()
     {
         MockableDataCollection::mockFiles([

From ab762b917524d63e98cbb002ff9c32d337d57695 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 14:15:13 +0200
Subject: [PATCH 1950/4023] Remove unnecessary trim already run in blank
 function

---
 packages/framework/src/Support/DataCollection.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 995c44bb174..26f1d064780 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -15,7 +15,6 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
-use function trim;
 use function blank;
 use function rtrim;
 use function implode;
@@ -117,7 +116,7 @@ protected static function parseMarkdownFile(string $file): MarkdownDocument
         try {
             $document = MarkdownFileParser::parse($file);
 
-            if (blank(trim($document->markdown()->body())) && $document->matter()->toArray() === []) {
+            if (blank($document->markdown()->body()) && $document->matter()->toArray() === []) {
                 throw new ParseException('File is empty');
             }
 
@@ -134,7 +133,7 @@ protected static function parseYamlFile(string $file): FrontMatter
         $content = Str::between($content, '---', '---');
 
         try {
-            if (blank(trim($content))) {
+            if (blank($content)) {
                 // We throw an exception here in order to match the behavior of the JSON validation.
                 throw new ParseException('File is empty');
             }

From 6d81d4188db719b2c0b1153d3be151a6c131660d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 15:41:10 +0200
Subject: [PATCH 1951/4023] Cleanup code

---
 packages/framework/src/Support/DataCollection.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 26f1d064780..49677e51a72 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -134,7 +134,6 @@ protected static function parseYamlFile(string $file): FrontMatter
 
         try {
             if (blank($content)) {
-                // We throw an exception here in order to match the behavior of the JSON validation.
                 throw new ParseException('File is empty');
             }
 

From 5cf056db63ca44da5674e6d609eab8ddc1ebc9dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 15:41:53 +0200
Subject: [PATCH 1952/4023] Introduce local variable

---
 packages/framework/src/Support/DataCollection.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 49677e51a72..387a7593f85 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -90,7 +90,9 @@ public static function json(string $name, bool $asArray = false): static
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
         return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $extraArgs): array {
-            return [static::makeIdentifier($file) => $parseUsing($file, ...$extraArgs)];
+            $parsed = $parseUsing($file, ...$extraArgs);
+
+            return [static::makeIdentifier($file) => $parsed];
         }));
     }
 

From 6ffd6f94fa7aa804354d96ca0552d992e977bcef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 15:47:57 +0200
Subject: [PATCH 1953/4023] Refactor to have single try/catch block in loop

---
 .../framework/src/Support/DataCollection.php  | 50 ++++++++++---------
 1 file changed, 27 insertions(+), 23 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 387a7593f85..3e3be1eabb3 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -5,6 +5,7 @@
 namespace Hyde\Support;
 
 use stdClass;
+use Illuminate\Support\Arr;
 use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 use Symfony\Component\Yaml\Yaml;
@@ -86,11 +87,25 @@ public static function json(string $name, bool $asArray = false): static
      * @param  array<string>|string  $extensions
      * @param  callable(string): mixed  $parseUsing
      * @return static<string, MarkdownDocument|FrontMatter|stdClass|array>
+     *
+     * @throws \InvalidArgumentException if the file is empty or cannot be parsed.
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $extraArgs): array {
-            $parsed = $parseUsing($file, ...$extraArgs);
+        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($extensions, $parseUsing, $extraArgs): array {
+            try {
+                $parsed = $parseUsing($file, ...$extraArgs);
+            } catch (ParseException $exception) {
+                $array = Arr::wrap($extensions);
+                $type = match (array_shift($array)) {
+                    'md' => 'Markdown',
+                    'yaml', 'yml' => 'YAML',
+                    'json' => 'JSON',
+                    default => 'Unknown',
+                };
+
+                throw new InvalidArgumentException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+            }
 
             return [static::makeIdentifier($file) => $parsed];
         }));
@@ -112,46 +127,35 @@ protected static function makeIdentifier(string $path): string
         return unslash(Str::after($path, static::$sourceDirectory));
     }
 
-    /** @throws InvalidArgumentException If the Markdown is invalid and cannot be parsed. */
     protected static function parseMarkdownFile(string $file): MarkdownDocument
     {
-        try {
-            $document = MarkdownFileParser::parse($file);
-
-            if (blank($document->markdown()->body()) && $document->matter()->toArray() === []) {
-                throw new ParseException('File is empty');
-            }
+        $document = MarkdownFileParser::parse($file);
 
-            return $document;
-        } catch (ParseException $exception) {
-            throw new InvalidArgumentException(sprintf("Invalid Markdown in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+        if (blank($document->markdown()->body()) && $document->matter()->toArray() === []) {
+            throw new ParseException('File is empty');
         }
+
+        return $document;
     }
 
-    /** @throws InvalidArgumentException If the YAML is invalid and cannot be parsed. */
     protected static function parseYamlFile(string $file): FrontMatter
     {
         $content = Filesystem::getContents($file);
         $content = Str::between($content, '---', '---');
 
-        try {
-            if (blank($content)) {
-                throw new ParseException('File is empty');
-            }
-
-            return new FrontMatter(Yaml::parse($content));
-        } catch (ParseException $exception) {
-            throw new InvalidArgumentException(sprintf("Invalid YAML in file: '%s' (%s)", $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+        if (blank($content)) {
+            throw new ParseException('File is empty');
         }
+
+        return new FrontMatter(Yaml::parse($content));
     }
 
-    /** @throws InvalidArgumentException If the JSON is invalid and cannot be parsed. */
     protected static function parseJsonFile(string $file, bool $asArray): stdClass|array
     {
         $contents = Filesystem::getContents($file);
 
         if (! json_validate($contents)) {
-            throw new InvalidArgumentException(sprintf("Invalid JSON in file: '%s' (%s)", $file, json_last_error_msg()));
+            throw new ParseException(json_last_error_msg());
         }
 
         return json_decode($contents, $asArray);

From 415a32ae102721207a3e2beac855544295b88546 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 15:55:50 +0200
Subject: [PATCH 1954/4023] Simplify and cleanup exception file type label
 handing

---
 .../framework/src/Support/DataCollection.php  |  8 +------
 .../tests/Unit/DataCollectionUnitTest.php     | 24 +++++++++----------
 2 files changed, 13 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 3e3be1eabb3..d37624d34a7 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -96,13 +96,7 @@ protected static function discover(string $name, array|string $extensions, calla
             try {
                 $parsed = $parseUsing($file, ...$extraArgs);
             } catch (ParseException $exception) {
-                $array = Arr::wrap($extensions);
-                $type = match (array_shift($array)) {
-                    'md' => 'Markdown',
-                    'yaml', 'yml' => 'YAML',
-                    'json' => 'JSON',
-                    default => 'Unknown',
-                };
+                $type = $extensions === 'md' ? 'Markdown' : ucfirst(Arr::first(Arr::wrap($extensions)));
 
                 throw new InvalidArgumentException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
             }
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index b8bcc94aae8..cc7a3a92044 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -341,7 +341,7 @@ public function testYamlCollectionsThrowExceptionForInvalidYaml()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\"))");
+        $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\"))");
 
         MockableDataCollection::yaml('foo');
     }
@@ -353,7 +353,7 @@ public function testYamlCollectionsThrowExceptionForEmptyYaml()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (File is empty)");
+        $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (File is empty)");
 
         MockableDataCollection::yaml('foo');
     }
@@ -365,7 +365,7 @@ public function testYamlCollectionsThrowExceptionForBlankYaml()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/bar.yml' (File is empty)");
+        $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (File is empty)");
 
         MockableDataCollection::yaml('foo');
     }
@@ -377,7 +377,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8)");
+        $this->expectExceptionMessage("Invalid Yaml in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8)");
 
         MockableDataCollection::yaml('foo');
     }
@@ -389,7 +389,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid YAML in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\"))");
+        $this->expectExceptionMessage("Invalid Yaml in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\"))");
 
         MockableDataCollection::yaml('foo');
     }
@@ -427,7 +427,7 @@ public function testJsonMethodThrowsExceptionForInvalidJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -439,7 +439,7 @@ public function testJsonMethodThrowsExceptionForInvalidJsonWithArray()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo', true);
     }
@@ -451,7 +451,7 @@ public function testJsonMethodThrowsExceptionForEmptyJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -463,7 +463,7 @@ public function testJsonMethodThrowsExceptionForBlankJson()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/bar.json' (Syntax error)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -476,7 +476,7 @@ public function testJsonMethodThrowsExceptionWhenJustOneFileIsInvalid()
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/baz.json' (Syntax error)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/baz.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
     }
@@ -488,7 +488,7 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithU
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/utf.json' (Malformed UTF-8 characters, possibly incorrectly encoded)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/utf.json' (Malformed UTF-8 characters, possibly incorrectly encoded)");
 
         MockableDataCollection::json('foo');
     }
@@ -500,7 +500,7 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithC
         ]);
 
         $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage("Invalid JSON in file: 'foo/control.json' (Control character error, possibly incorrectly encoded)");
+        $this->expectExceptionMessage("Invalid Json in file: 'foo/control.json' (Control character error, possibly incorrectly encoded)");
 
         MockableDataCollection::json('foo');
     }

From 558f407d9559e2d18c601cb297a8b43aeb65ef1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:03:07 +0200
Subject: [PATCH 1955/4023] Create ParseException.php

---
 .../src/Markdown/Exceptions/ParseException.php       | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 packages/framework/src/Markdown/Exceptions/ParseException.php

diff --git a/packages/framework/src/Markdown/Exceptions/ParseException.php b/packages/framework/src/Markdown/Exceptions/ParseException.php
new file mode 100644
index 00000000000..e2ebc466a16
--- /dev/null
+++ b/packages/framework/src/Markdown/Exceptions/ParseException.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Markdown\Exceptions;
+
+use RuntimeException;
+
+class ParseException extends RunTimeException
+{
+    //
+}

From 86c6147bcd75c14b2d7ee702f3b0b83916ccc46f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:04:26 +0200
Subject: [PATCH 1956/4023] Throw our ParseException instead of
 InvalidArgumentException

Gives us more control, and adds more clarity and makes it easier to debug errors.
---
 RELEASE_NOTES.md                              |  6 ++--
 .../framework/src/Support/DataCollection.php  |  5 ++-
 .../tests/Unit/DataCollectionUnitTest.php     | 32 +++++++++----------
 3 files changed, 21 insertions(+), 22 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 15cd68599a1..567af1b8217 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -236,15 +236,15 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 
 #### Issues that may arise
 
-If you start getting `InvalidArgumentException` when using the `DataCollection` class, it may be due to malformed data collection files.
+If you start getting a `ParseException` when using the `DataCollection` class, it may be due to malformed data collection files.
 Starting from this version, we validate the syntax of JSON and YAML files during discovery, to help you catch errors early.
 See https://github.com/hydephp/develop/issues/1736 for more information.
 
 For example, an empty or malformed JSON file will now throw an exception like this:
  
 ```php
-InvalidArgumentException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
+\Hyde\Markdown\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
 
-In order to normalize the thrown exceptions, we now rethrow Yaml `ParseException` as `InvalidArgumentException` to match the JSON validation.
+In order to normalize the thrown exceptions, we now rethrow `Symfony/Yaml` `ParseException` as our custom `ParseException` to match the JSON validation.
 Additionally, an exception will be thrown if a JSON or YAML file is empty, as this is unlikely to be intentional.
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index d37624d34a7..d884da176b0 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -7,7 +7,6 @@
 use stdClass;
 use Illuminate\Support\Arr;
 use Hyde\Facades\Filesystem;
-use InvalidArgumentException;
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
@@ -88,7 +87,7 @@ public static function json(string $name, bool $asArray = false): static
      * @param  callable(string): mixed  $parseUsing
      * @return static<string, MarkdownDocument|FrontMatter|stdClass|array>
      *
-     * @throws \InvalidArgumentException if the file is empty or cannot be parsed.
+     * @throws \Hyde\Markdown\Exceptions\ParseException If the file is empty or invalid.
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
@@ -98,7 +97,7 @@ protected static function discover(string $name, array|string $extensions, calla
             } catch (ParseException $exception) {
                 $type = $extensions === 'md' ? 'Markdown' : ucfirst(Arr::first(Arr::wrap($extensions)));
 
-                throw new InvalidArgumentException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+                throw new \Hyde\Markdown\Exceptions\ParseException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
             }
 
             return [static::makeIdentifier($file) => $parsed];
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cc7a3a92044..863206af5d9 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -6,7 +6,7 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
-use InvalidArgumentException;
+use Hyde\Markdown\Exceptions\ParseException;
 use Hyde\Support\DataCollection;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Filesystem\Filesystem;
@@ -173,7 +173,7 @@ public function testMarkdownMethodWithEmptyFileThrowsException()
             'foo/bar.md' => '',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
 
         MockableDataCollection::markdown('foo');
@@ -185,7 +185,7 @@ public function testMarkdownMethodWithEmptyFrontMatterAndContentThrowsException(
             'foo/bar.md' => "---\n---",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (File is empty)");
 
         MockableDataCollection::markdown('foo');
@@ -233,7 +233,7 @@ public function testMarkdownMethodWithInvalidFrontMatter()
             'foo/bar.md' => "---\nfoo: 'bar\n---\nbar",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Markdown in file: 'foo/bar.md' (Malformed inline YAML string at line 1 (near \"foo: 'bar\"))");
 
         MockableDataCollection::markdown('foo');
@@ -340,7 +340,7 @@ public function testYamlCollectionsThrowExceptionForInvalidYaml()
             'foo/bar.yml' => "---\nfoo: 'bar",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (Malformed inline YAML string at line 2 (near \"foo: 'bar\"))");
 
         MockableDataCollection::yaml('foo');
@@ -352,7 +352,7 @@ public function testYamlCollectionsThrowExceptionForEmptyYaml()
             'foo/bar.yml' => '',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (File is empty)");
 
         MockableDataCollection::yaml('foo');
@@ -364,7 +364,7 @@ public function testYamlCollectionsThrowExceptionForBlankYaml()
             'foo/bar.yml' => ' ',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Yaml in file: 'foo/bar.yml' (File is empty)");
 
         MockableDataCollection::yaml('foo');
@@ -376,7 +376,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
             'foo/utf.yml' => "foo: \xB1\x31",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Yaml in file: 'foo/utf.yml' (The YAML value does not appear to be valid UTF-8)");
 
         MockableDataCollection::yaml('foo');
@@ -388,7 +388,7 @@ public function testYamlCollectionsThrowExceptionForOtherReasonsThanSyntaxErrorW
             'foo/tabs.yml' => "foo:\n\tbar",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Yaml in file: 'foo/tabs.yml' (A YAML file cannot contain tabs as indentation at line 2 (near \"	bar\"))");
 
         MockableDataCollection::yaml('foo');
@@ -426,7 +426,7 @@ public function testJsonMethodThrowsExceptionForInvalidJson()
             'foo/bar.json' => '{"foo": "bar"',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
@@ -438,7 +438,7 @@ public function testJsonMethodThrowsExceptionForInvalidJsonWithArray()
             'foo/bar.json' => '{"foo": "bar"',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo', true);
@@ -450,7 +450,7 @@ public function testJsonMethodThrowsExceptionForEmptyJson()
             'foo/bar.json' => '',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
@@ -462,7 +462,7 @@ public function testJsonMethodThrowsExceptionForBlankJson()
             'foo/bar.json' => ' ',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/bar.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
@@ -475,7 +475,7 @@ public function testJsonMethodThrowsExceptionWhenJustOneFileIsInvalid()
             'foo/baz.json' => '{"foo": "baz"',
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/baz.json' (Syntax error)");
 
         MockableDataCollection::json('foo');
@@ -487,7 +487,7 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithU
             'foo/utf.json' => "\xB1\x31",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/utf.json' (Malformed UTF-8 characters, possibly incorrectly encoded)");
 
         MockableDataCollection::json('foo');
@@ -499,7 +499,7 @@ public function testJsonMethodThrowsExceptionForOtherReasonsThanSyntaxErrorWithC
             'foo/control.json' => "\x19\x31",
         ]);
 
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(ParseException::class);
         $this->expectExceptionMessage("Invalid Json in file: 'foo/control.json' (Control character error, possibly incorrectly encoded)");
 
         MockableDataCollection::json('foo');

From 1c7114a9e38e7e838976fcb5c647cbffdd81b435 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:05:27 +0200
Subject: [PATCH 1957/4023] Improve wording

---
 RELEASE_NOTES.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 567af1b8217..8d86e490c8b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -246,5 +246,5 @@ For example, an empty or malformed JSON file will now throw an exception like th
 \Hyde\Markdown\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
 
-In order to normalize the thrown exceptions, we now rethrow `Symfony/Yaml` `ParseException` as our custom `ParseException` to match the JSON validation.
-Additionally, an exception will be thrown if a JSON or YAML file is empty, as this is unlikely to be intentional.
+In order to normalize the thrown exceptions, we now rethrow `Symfony/Yaml` `ParseException` as our custom `ParseException` to match the JSON and Markdown validation.
+Additionally, an exception will be thrown if a data file is empty, as this is unlikely to be intentional.

From c5bc3748b1fbbc5b79851bba531f70b981681085 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:11:55 +0200
Subject: [PATCH 1958/4023] Simplify type label generator to use the file
 extension

---
 packages/framework/src/Support/DataCollection.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index d884da176b0..32921d0850d 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -18,9 +18,12 @@
 use function blank;
 use function rtrim;
 use function implode;
+use function explode;
+use function ucfirst;
 use function json_decode;
 use function sprintf;
 use function unslash;
+use function str_replace;
 use function json_last_error_msg;
 
 /**
@@ -91,11 +94,12 @@ public static function json(string $name, bool $asArray = false): static
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
-        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($extensions, $parseUsing, $extraArgs): array {
+        return new static(static::findFiles($name, $extensions)->mapWithKeys(function (string $file) use ($parseUsing, $extraArgs): array {
             try {
                 $parsed = $parseUsing($file, ...$extraArgs);
             } catch (ParseException $exception) {
-                $type = $extensions === 'md' ? 'Markdown' : ucfirst(Arr::first(Arr::wrap($extensions)));
+                $extension = Arr::last(explode('.', $file));
+                $type = ucfirst(str_replace(['md', 'yml'], ['markdown', 'yaml'], $extension));
 
                 throw new \Hyde\Markdown\Exceptions\ParseException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
             }

From 260ce224db57bfd5307ed7f6a927c2923173234f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:13:36 +0200
Subject: [PATCH 1959/4023] Fix parse exception namespace

---
 RELEASE_NOTES.md                                       |  2 +-
 .../Exceptions/ParseException.php                      |  2 +-
 packages/framework/src/Support/DataCollection.php      | 10 +++++-----
 .../framework/tests/Unit/DataCollectionUnitTest.php    |  8 ++++----
 4 files changed, 11 insertions(+), 11 deletions(-)
 rename packages/framework/src/{Markdown => Framework}/Exceptions/ParseException.php (75%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 8d86e490c8b..08dc7771ea2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -243,7 +243,7 @@ See https://github.com/hydephp/develop/issues/1736 for more information.
 For example, an empty or malformed JSON file will now throw an exception like this:
  
 ```php
-\Hyde\Markdown\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
+\Hyde\Framework\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
 
 In order to normalize the thrown exceptions, we now rethrow `Symfony/Yaml` `ParseException` as our custom `ParseException` to match the JSON and Markdown validation.
diff --git a/packages/framework/src/Markdown/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
similarity index 75%
rename from packages/framework/src/Markdown/Exceptions/ParseException.php
rename to packages/framework/src/Framework/Exceptions/ParseException.php
index e2ebc466a16..0c138a58718 100644
--- a/packages/framework/src/Markdown/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Hyde\Markdown\Exceptions;
+namespace Hyde\Framework\Exceptions;
 
 use RuntimeException;
 
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index 32921d0850d..f05f4d032e7 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -6,23 +6,23 @@
 
 use stdClass;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
 use Hyde\Facades\Filesystem;
 use Symfony\Component\Yaml\Yaml;
+use Illuminate\Support\Collection;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Framework\Actions\MarkdownFileParser;
 use Symfony\Component\Yaml\Exception\ParseException;
-use Illuminate\Support\Collection;
-use Illuminate\Support\Str;
 
 use function blank;
 use function rtrim;
 use function implode;
 use function explode;
 use function ucfirst;
-use function json_decode;
 use function sprintf;
 use function unslash;
+use function json_decode;
 use function str_replace;
 use function json_last_error_msg;
 
@@ -90,7 +90,7 @@ public static function json(string $name, bool $asArray = false): static
      * @param  callable(string): mixed  $parseUsing
      * @return static<string, MarkdownDocument|FrontMatter|stdClass|array>
      *
-     * @throws \Hyde\Markdown\Exceptions\ParseException If the file is empty or invalid.
+     * @throws \Hyde\Framework\Exceptions\ParseException If the file is empty or invalid.
      */
     protected static function discover(string $name, array|string $extensions, callable $parseUsing, array $extraArgs = []): static
     {
@@ -101,7 +101,7 @@ protected static function discover(string $name, array|string $extensions, calla
                 $extension = Arr::last(explode('.', $file));
                 $type = ucfirst(str_replace(['md', 'yml'], ['markdown', 'yaml'], $extension));
 
-                throw new \Hyde\Markdown\Exceptions\ParseException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+                throw new \Hyde\Framework\Exceptions\ParseException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
             }
 
             return [static::makeIdentifier($file) => $parsed];
diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 863206af5d9..cf1c8122ffc 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -4,16 +4,16 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Mockery;
 use Hyde\Hyde;
 use Illuminate\Support\Str;
-use Hyde\Markdown\Exceptions\ParseException;
-use Hyde\Support\DataCollection;
 use Hyde\Testing\UnitTestCase;
-use Illuminate\Filesystem\Filesystem;
+use Hyde\Support\DataCollection;
 use Illuminate\Support\Collection;
-use Mockery;
+use Illuminate\Filesystem\Filesystem;
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\MarkdownDocument;
+use Hyde\Framework\Exceptions\ParseException;
 
 /**
  * @covers \Hyde\Support\DataCollection

From cf953e64d54c3da30b99e62bd238317d463eacbb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:15:00 +0200
Subject: [PATCH 1960/4023] Fix class name capitalization

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 0c138a58718..371dc1a77c3 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -6,7 +6,7 @@
 
 use RuntimeException;
 
-class ParseException extends RunTimeException
+class ParseException extends RuntimeException
 {
     //
 }

From 2783e0d4949896014277661f5c859cb5a169e6b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:15:09 +0200
Subject: [PATCH 1961/4023] Document exception scope

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 371dc1a77c3..020a6cd6068 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -6,6 +6,9 @@
 
 use RuntimeException;
 
+/**
+ * Exception class thrown when an error occurs during parsing.
+ */
 class ParseException extends RuntimeException
 {
     //

From 54285af13c9da77b9e618a91763adf9da5374a91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:15:26 +0200
Subject: [PATCH 1962/4023] Revert "Document exception scope"

This reverts commit 2783e0d4949896014277661f5c859cb5a169e6b2 as it should be obvious by the class name already.
---
 packages/framework/src/Framework/Exceptions/ParseException.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 020a6cd6068..371dc1a77c3 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -6,9 +6,6 @@
 
 use RuntimeException;
 
-/**
- * Exception class thrown when an error occurs during parsing.
- */
 class ParseException extends RuntimeException
 {
     //

From 2fba023e1b7f556128d1ab3265007a80f3025198 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:16:27 +0200
Subject: [PATCH 1963/4023] Mark ParseException class as experimental

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 371dc1a77c3..fe1340b7259 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -6,6 +6,7 @@
 
 use RuntimeException;
 
+/** @experimental This class may change significantly before its release. */
 class ParseException extends RuntimeException
 {
     //

From d2829f296c9d12683ea1a4bdb32938e857d6eb49 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:23:32 +0200
Subject: [PATCH 1964/4023] Test covers ParseException

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 684501c3b0c..8cc198dfc88 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -18,6 +18,7 @@
  * @covers \Hyde\Framework\Exceptions\RouteNotFoundException
  * @covers \Hyde\Framework\Exceptions\BaseUrlNotSetException
  * @covers \Hyde\Framework\Exceptions\UnsupportedPageTypeException
+ * @covers \Hyde\Framework\Exceptions\ParseException
  */
 class CustomExceptionsTest extends UnitTestCase
 {

From 7f4d48db4577c3070247f9eda58c44ea3a1fc580 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:17:31 +0200
Subject: [PATCH 1965/4023] Override parent constructor

---
 .../framework/src/Framework/Exceptions/ParseException.php   | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index fe1340b7259..ddad2f37df5 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -4,10 +4,14 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Throwable;
 use RuntimeException;
 
 /** @experimental This class may change significantly before its release. */
 class ParseException extends RuntimeException
 {
-    //
+    public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
+    {
+        parent::__construct($message, $code, $previous);
+    }
 }

From 796035714d39d1af5182b73c2965af0f834f143e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:24:10 +0200
Subject: [PATCH 1966/4023] Unit test covers ParseException

---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index cf1c8122ffc..832612952f1 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -17,6 +17,7 @@
 
 /**
  * @covers \Hyde\Support\DataCollection
+ * @covers \Hyde\Framework\Exceptions\ParseException
  *
  * @see \Hyde\Framework\Testing\Feature\DataCollectionTest
  */

From e5d4c820f5c5726571bfe16283b72a665a62f9bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 16:22:45 +0200
Subject: [PATCH 1967/4023] Refactor to move exception message assembly to
 custom exception

---
 .../src/Framework/Exceptions/ParseException.php    | 14 ++++++++++++--
 packages/framework/src/Support/DataCollection.php  | 10 +---------
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index ddad2f37df5..547050d20ca 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -6,12 +6,22 @@
 
 use Throwable;
 use RuntimeException;
+use Illuminate\Support\Arr;
+
+use function rtrim;
+use function sprintf;
+use function explode;
+use function ucfirst;
+use function str_replace;
 
 /** @experimental This class may change significantly before its release. */
 class ParseException extends RuntimeException
 {
-    public function __construct(string $message = '', int $code = 0, ?Throwable $previous = null)
+    public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        parent::__construct($message, $code, $previous);
+        $extension = Arr::last(explode('.', $file));
+        $type = ucfirst(str_replace(['md', 'yml'], ['markdown', 'yaml'], $extension));
+
+        parent::__construct(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($previous->getMessage(), '.')), previous: $previous);
     }
 }
diff --git a/packages/framework/src/Support/DataCollection.php b/packages/framework/src/Support/DataCollection.php
index f05f4d032e7..af70ff38a3e 100644
--- a/packages/framework/src/Support/DataCollection.php
+++ b/packages/framework/src/Support/DataCollection.php
@@ -5,7 +5,6 @@
 namespace Hyde\Support;
 
 use stdClass;
-use Illuminate\Support\Arr;
 use Illuminate\Support\Str;
 use Hyde\Facades\Filesystem;
 use Symfony\Component\Yaml\Yaml;
@@ -16,14 +15,10 @@
 use Symfony\Component\Yaml\Exception\ParseException;
 
 use function blank;
-use function rtrim;
 use function implode;
-use function explode;
-use function ucfirst;
 use function sprintf;
 use function unslash;
 use function json_decode;
-use function str_replace;
 use function json_last_error_msg;
 
 /**
@@ -98,10 +93,7 @@ protected static function discover(string $name, array|string $extensions, calla
             try {
                 $parsed = $parseUsing($file, ...$extraArgs);
             } catch (ParseException $exception) {
-                $extension = Arr::last(explode('.', $file));
-                $type = ucfirst(str_replace(['md', 'yml'], ['markdown', 'yaml'], $extension));
-
-                throw new \Hyde\Framework\Exceptions\ParseException(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($exception->getMessage(), '.')), previous: $exception);
+                throw new \Hyde\Framework\Exceptions\ParseException($file, $exception);
             }
 
             return [static::makeIdentifier($file) => $parsed];

From f4e18ba75a6ad97e2ea8c2c1a0fb3dbaaed2f0bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:01:37 +0200
Subject: [PATCH 1968/4023] Add unit tests for custom ParseException

---
 .../tests/Unit/CustomExceptionsTest.php       | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 8cc198dfc88..4c002d7bda7 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -11,6 +11,10 @@
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Framework\Exceptions\BaseUrlNotSetException;
 use Hyde\Framework\Exceptions\UnsupportedPageTypeException;
+use Hyde\Framework\Exceptions\ParseException;
+use RuntimeException;
+use Throwable;
+use Exception;
 
 /**
  * @covers \Hyde\Framework\Exceptions\FileConflictException
@@ -108,4 +112,64 @@ public function testBaseUrlNotSetExceptionCode()
     {
         $this->assertSame(500, (new BaseUrlNotSetException())->getCode());
     }
+
+    public function testParseExceptionWithDefaultMessage()
+    {
+        $exception = new ParseException();
+        $this->assertSame("Invalid data in file: ''", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithFileName()
+    {
+        $exception = new ParseException('example.md');
+        $this->assertSame("Invalid Markdown in file: 'example.md'", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithFileNameAndCustomMessage()
+    {
+        $previous = new RuntimeException('Custom error message.');
+        $exception = new ParseException('example.yml', $previous);
+        $this->assertSame("Invalid Yaml in file: 'example.yml' (Custom error message)", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithTxtExtension()
+    {
+        $exception = new ParseException('example.txt');
+        $this->assertSame("Invalid Text in file: 'example.txt'", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithUnsupportedExtension()
+    {
+        $exception = new ParseException('example.foo'); // Todo should be data?
+        $this->assertSame("Invalid Foo in file: 'example.foo'", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithEmptyFileNameAndCustomMessage()
+    {
+        $previous = new RuntimeException('Custom error message.');
+        $exception = new ParseException('', $previous);
+        $this->assertSame("Invalid data in file: '' (Custom error message)", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithEmptyFileNameAndEmptyPreviousMessage()
+    {
+        $previous = new RuntimeException('');
+        $exception = new ParseException('', $previous);
+        $this->assertSame("Invalid data in file: ''", $exception->getMessage());
+    }
+
+    public function testParseExceptionWithNoPrevious()
+    {
+        $exception = new ParseException('example.md');
+        $this->assertSame("Invalid Markdown in file: 'example.md'", $exception->getMessage());
+        $this->assertNull($exception->getPrevious());
+    }
+
+    public function testParseExceptionWithPrevious()
+    {
+        $previous = new Exception('Parsing error.');
+        $exception = new ParseException('example.md', $previous);
+        $this->assertSame("Invalid Markdown in file: 'example.md' (Parsing error)", $exception->getMessage());
+        $this->assertSame($previous, $exception->getPrevious());
+    }
 }

From 301c44ca423df55725f75ad2f4b1322c2e3d0a64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:02:36 +0200
Subject: [PATCH 1969/4023] Improve parse exception message assembly

---
 .../framework/src/Framework/Exceptions/ParseException.php   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 547050d20ca..7fd16e9fdfc 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,8 +20,10 @@ class ParseException extends RuntimeException
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
         $extension = Arr::last(explode('.', $file));
-        $type = ucfirst(str_replace(['md', 'yml'], ['markdown', 'yaml'], $extension));
+        $type = ucfirst(str_replace(['md', 'txt', 'yml'], ['markdown', 'text', 'yaml'], $extension)) ?: 'data';
 
-        parent::__construct(sprintf("Invalid %s in file: '%s' (%s)", $type, $file, rtrim($previous->getMessage(), '.')), previous: $previous);
+        $context = ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+
+        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $type, $file, $context)), previous: $previous);
     }
 }

From fcab984bc2b54ac144366ff2b07c3ecdc15ee6ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:02:41 +0200
Subject: [PATCH 1970/4023] Revert "Unit test covers ParseException"

This reverts commit 796035714d39d1af5182b73c2965af0f834f143e.
---
 packages/framework/tests/Unit/DataCollectionUnitTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/DataCollectionUnitTest.php b/packages/framework/tests/Unit/DataCollectionUnitTest.php
index 832612952f1..cf1c8122ffc 100644
--- a/packages/framework/tests/Unit/DataCollectionUnitTest.php
+++ b/packages/framework/tests/Unit/DataCollectionUnitTest.php
@@ -17,7 +17,6 @@
 
 /**
  * @covers \Hyde\Support\DataCollection
- * @covers \Hyde\Framework\Exceptions\ParseException
  *
  * @see \Hyde\Framework\Testing\Feature\DataCollectionTest
  */

From c604c93e5a83ccb02a8283add4d3264c584129cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:02:52 +0200
Subject: [PATCH 1971/4023] Test parse exception code

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 4c002d7bda7..c532b2503b4 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -113,6 +113,11 @@ public function testBaseUrlNotSetExceptionCode()
         $this->assertSame(500, (new BaseUrlNotSetException())->getCode());
     }
 
+    public function testParseExceptionCode()
+    {
+        $this->assertSame(0, (new ParseException())->getCode());
+    }
+
     public function testParseExceptionWithDefaultMessage()
     {
         $exception = new ParseException();

From eaa3045e78d85485f787cfd34e12ed90ec26862d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:03:22 +0200
Subject: [PATCH 1972/4023] Remove unused use statement

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index c532b2503b4..e841e303c83 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -13,7 +13,6 @@
 use Hyde\Framework\Exceptions\UnsupportedPageTypeException;
 use Hyde\Framework\Exceptions\ParseException;
 use RuntimeException;
-use Throwable;
 use Exception;
 
 /**

From 4348f1ce85b4148724514c830360711ad05f502f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:09:29 +0200
Subject: [PATCH 1973/4023] Set parse exception status code to 422

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 3 +++
 packages/framework/tests/Unit/CustomExceptionsTest.php         | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 7fd16e9fdfc..fe89cc2e677 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -17,6 +17,9 @@
 /** @experimental This class may change significantly before its release. */
 class ParseException extends RuntimeException
 {
+    /** @var int */
+    protected $code = 422;
+
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
         $extension = Arr::last(explode('.', $file));
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index e841e303c83..cef337a39fc 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -114,7 +114,7 @@ public function testBaseUrlNotSetExceptionCode()
 
     public function testParseExceptionCode()
     {
-        $this->assertSame(0, (new ParseException())->getCode());
+        $this->assertSame(422, (new ParseException())->getCode());
     }
 
     public function testParseExceptionWithDefaultMessage()

From 5fb82c140f178ede8aca31b644832ae5ebb8fb38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:11:24 +0200
Subject: [PATCH 1974/4023] Replace string replacement with match expression

More verbose, but clearer, and probably more accurate. Has cases for the exceptions we throw this for.
---
 .../src/Framework/Exceptions/ParseException.php          | 9 ++++++---
 packages/framework/tests/Unit/CustomExceptionsTest.php   | 6 +++---
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index fe89cc2e677..dbac34a03b7 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -11,8 +11,6 @@
 use function rtrim;
 use function sprintf;
 use function explode;
-use function ucfirst;
-use function str_replace;
 
 /** @experimental This class may change significantly before its release. */
 class ParseException extends RuntimeException
@@ -23,7 +21,12 @@ class ParseException extends RuntimeException
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
         $extension = Arr::last(explode('.', $file));
-        $type = ucfirst(str_replace(['md', 'txt', 'yml'], ['markdown', 'text', 'yaml'], $extension)) ?: 'data';
+        $type = match ($extension) {
+            'md' => 'Markdown',
+            'yaml', 'yml' => 'Yaml',
+            'json' => 'Json',
+            default => 'data',
+        };
 
         $context = ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
 
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index cef337a39fc..68d9313769b 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -139,13 +139,13 @@ public function testParseExceptionWithFileNameAndCustomMessage()
     public function testParseExceptionWithTxtExtension()
     {
         $exception = new ParseException('example.txt');
-        $this->assertSame("Invalid Text in file: 'example.txt'", $exception->getMessage());
+        $this->assertSame("Invalid data in file: 'example.txt'", $exception->getMessage());
     }
 
     public function testParseExceptionWithUnsupportedExtension()
     {
-        $exception = new ParseException('example.foo'); // Todo should be data?
-        $this->assertSame("Invalid Foo in file: 'example.foo'", $exception->getMessage());
+        $exception = new ParseException('example.foo');
+        $this->assertSame("Invalid data in file: 'example.foo'", $exception->getMessage());
     }
 
     public function testParseExceptionWithEmptyFileNameAndCustomMessage()

From ad15064946a8cbb1a23bc4aca4449227b71cc996 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:12:07 +0200
Subject: [PATCH 1975/4023] Add source code spacing

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 68d9313769b..fcaeb77b1f3 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -120,12 +120,14 @@ public function testParseExceptionCode()
     public function testParseExceptionWithDefaultMessage()
     {
         $exception = new ParseException();
+
         $this->assertSame("Invalid data in file: ''", $exception->getMessage());
     }
 
     public function testParseExceptionWithFileName()
     {
         $exception = new ParseException('example.md');
+
         $this->assertSame("Invalid Markdown in file: 'example.md'", $exception->getMessage());
     }
 
@@ -133,18 +135,21 @@ public function testParseExceptionWithFileNameAndCustomMessage()
     {
         $previous = new RuntimeException('Custom error message.');
         $exception = new ParseException('example.yml', $previous);
+
         $this->assertSame("Invalid Yaml in file: 'example.yml' (Custom error message)", $exception->getMessage());
     }
 
     public function testParseExceptionWithTxtExtension()
     {
         $exception = new ParseException('example.txt');
+
         $this->assertSame("Invalid data in file: 'example.txt'", $exception->getMessage());
     }
 
     public function testParseExceptionWithUnsupportedExtension()
     {
         $exception = new ParseException('example.foo');
+
         $this->assertSame("Invalid data in file: 'example.foo'", $exception->getMessage());
     }
 
@@ -152,6 +157,7 @@ public function testParseExceptionWithEmptyFileNameAndCustomMessage()
     {
         $previous = new RuntimeException('Custom error message.');
         $exception = new ParseException('', $previous);
+
         $this->assertSame("Invalid data in file: '' (Custom error message)", $exception->getMessage());
     }
 
@@ -159,12 +165,14 @@ public function testParseExceptionWithEmptyFileNameAndEmptyPreviousMessage()
     {
         $previous = new RuntimeException('');
         $exception = new ParseException('', $previous);
+
         $this->assertSame("Invalid data in file: ''", $exception->getMessage());
     }
 
     public function testParseExceptionWithNoPrevious()
     {
         $exception = new ParseException('example.md');
+
         $this->assertSame("Invalid Markdown in file: 'example.md'", $exception->getMessage());
         $this->assertNull($exception->getPrevious());
     }
@@ -173,6 +181,7 @@ public function testParseExceptionWithPrevious()
     {
         $previous = new Exception('Parsing error.');
         $exception = new ParseException('example.md', $previous);
+
         $this->assertSame("Invalid Markdown in file: 'example.md' (Parsing error)", $exception->getMessage());
         $this->assertSame($previous, $exception->getPrevious());
     }

From 05910f3880b260494f6ca029bbaed762d31053e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:13:21 +0200
Subject: [PATCH 1976/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 08dc7771ea2..aaa55ca2fcf 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -12,6 +12,7 @@ This serves two purposes:
 ### Added
 - You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
+- Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
 - The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
 
 ### Changed

From 68b096df48586cc40d95bd59f6e5da5ac21f3578 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 17:15:02 +0200
Subject: [PATCH 1977/4023] Extract helper method

---
 .../framework/src/Framework/Exceptions/ParseException.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index dbac34a03b7..0475c5427d0 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -28,8 +28,13 @@ public function __construct(string $file = '', ?Throwable $previous = null)
             default => 'data',
         };
 
-        $context = ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+        $context = $this->getContext($previous);
 
         parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $type, $file, $context)), previous: $previous);
     }
+
+    protected function getContext(?Throwable $previous): string
+    {
+        return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+    }
 }

From 19ac8dfdd9cad303d8d5a8f1d69367614911db6e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:41:00 +0200
Subject: [PATCH 1978/4023] Inline local variable

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 0475c5427d0..78a38bd3351 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,8 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        $extension = Arr::last(explode('.', $file));
-        $type = match ($extension) {
+        $type = match (Arr::last(explode('.', $file))) {
             'md' => 'Markdown',
             'yaml', 'yml' => 'Yaml',
             'json' => 'Json',

From 5393e369474e61f3d3b8688ab2442f835f67e508 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:41:35 +0200
Subject: [PATCH 1979/4023] Extract helper method

---
 .../src/Framework/Exceptions/ParseException.php | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 78a38bd3351..cbeb87032ac 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,12 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        $type = match (Arr::last(explode('.', $file))) {
-            'md' => 'Markdown',
-            'yaml', 'yml' => 'Yaml',
-            'json' => 'Json',
-            default => 'data',
-        };
+        $type = $this->getTypeLabel($file);
 
         $context = $this->getContext($previous);
 
@@ -36,4 +31,14 @@ protected function getContext(?Throwable $previous): string
     {
         return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
     }
+
+    protected function getTypeLabel(string $file): string
+    {
+        return match (Arr::last(explode('.', $file))) {
+            'md' => 'Markdown',
+            'yaml', 'yml' => 'Yaml',
+            'json' => 'Json',
+            default => 'data',
+        };
+    }
 }

From 6fc3d21aa8914ae5efeebe7bd9f6b68d51e665b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:41:44 +0200
Subject: [PATCH 1980/4023] Move up method in source

---
 .../src/Framework/Exceptions/ParseException.php        | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index cbeb87032ac..d0feec9aa41 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -27,11 +27,6 @@ public function __construct(string $file = '', ?Throwable $previous = null)
         parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $type, $file, $context)), previous: $previous);
     }
 
-    protected function getContext(?Throwable $previous): string
-    {
-        return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
-    }
-
     protected function getTypeLabel(string $file): string
     {
         return match (Arr::last(explode('.', $file))) {
@@ -41,4 +36,9 @@ protected function getTypeLabel(string $file): string
             default => 'data',
         };
     }
+
+    protected function getContext(?Throwable $previous): string
+    {
+        return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+    }
 }

From 177185bac7523873086a25fe233a76f9cd5f09f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:41:52 +0200
Subject: [PATCH 1981/4023] Inline local variables

---
 .../framework/src/Framework/Exceptions/ParseException.php   | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index d0feec9aa41..c78361b7415 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,11 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        $type = $this->getTypeLabel($file);
-
-        $context = $this->getContext($previous);
-
-        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $type, $file, $context)), previous: $previous);
+        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous))), previous: $previous);
     }
 
     protected function getTypeLabel(string $file): string

From 770df88e5b7ee31d25c455cc65739c22e4f1b0ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:42:22 +0200
Subject: [PATCH 1982/4023] Convert a 'sprintf()' call to string interpolation

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index c78361b7415..a5e0df0400e 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,7 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous))), previous: $previous);
+        parent::__construct(rtrim("Invalid {$this->getTypeLabel($file)} in file: '{$file}' {$this->getContext($previous)}"), previous: $previous);
     }
 
     protected function getTypeLabel(string $file): string

From e1ce0c3460a47f27be47db39ba49c8a5cbf15b3e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:42:26 +0200
Subject: [PATCH 1983/4023] Revert "Convert a 'sprintf()' call to string
 interpolation"

This reverts commit 770df88e5b7ee31d25c455cc65739c22e4f1b0ce.
---
 packages/framework/src/Framework/Exceptions/ParseException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index a5e0df0400e..c78361b7415 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,7 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        parent::__construct(rtrim("Invalid {$this->getTypeLabel($file)} in file: '{$file}' {$this->getContext($previous)}"), previous: $previous);
+        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous))), previous: $previous);
     }
 
     protected function getTypeLabel(string $file): string

From 3d05b2f2a6114861c72f8334ffd3ff7bf3d772fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:42:49 +0200
Subject: [PATCH 1984/4023] Split comma-separated values into multiple lines

---
 .../framework/src/Framework/Exceptions/ParseException.php     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index c78361b7415..4dc1e899d0d 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,7 +20,9 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous))), previous: $previous);
+        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s",
+            $this->getTypeLabel($file), $file, $this->getContext($previous))
+        ), previous: $previous);
     }
 
     protected function getTypeLabel(string $file): string

From b2d3282a1b6b06b5deb566b9d18be411dd4da42f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:43:16 +0200
Subject: [PATCH 1985/4023] Extract helper method

---
 .../src/Framework/Exceptions/ParseException.php          | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 4dc1e899d0d..3452b493648 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -20,9 +20,7 @@ class ParseException extends RuntimeException
 
     public function __construct(string $file = '', ?Throwable $previous = null)
     {
-        parent::__construct(rtrim(sprintf("Invalid %s in file: '%s' %s",
-            $this->getTypeLabel($file), $file, $this->getContext($previous))
-        ), previous: $previous);
+        parent::__construct($this->formatMessage($file, $previous), previous: $previous);
     }
 
     protected function getTypeLabel(string $file): string
@@ -39,4 +37,9 @@ protected function getContext(?Throwable $previous): string
     {
         return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
     }
+
+    protected function formatMessage(string $file, ?Throwable $previous): string
+    {
+        return rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous)));
+    }
 }

From 323abb1cf21f3bd3a65e5a74a4e8b09caa36cbae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:43:31 +0200
Subject: [PATCH 1986/4023] Move up method in source

---
 .../src/Framework/Exceptions/ParseException.php        | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 3452b493648..753cb870780 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -23,6 +23,11 @@ public function __construct(string $file = '', ?Throwable $previous = null)
         parent::__construct($this->formatMessage($file, $previous), previous: $previous);
     }
 
+    protected function formatMessage(string $file, ?Throwable $previous): string
+    {
+        return rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous)));
+    }
+
     protected function getTypeLabel(string $file): string
     {
         return match (Arr::last(explode('.', $file))) {
@@ -37,9 +42,4 @@ protected function getContext(?Throwable $previous): string
     {
         return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
     }
-
-    protected function formatMessage(string $file, ?Throwable $previous): string
-    {
-        return rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous)));
-    }
 }

From 8fba6af90c92c11e287963f2cc9bbc66f4debb8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 18:46:18 +0200
Subject: [PATCH 1987/4023] Conditionally assemble file path string

---
 .../framework/src/Framework/Exceptions/ParseException.php   | 4 +++-
 packages/framework/tests/Unit/CustomExceptionsTest.php      | 6 +++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 753cb870780..aaf4724ae0a 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -25,7 +25,9 @@ public function __construct(string $file = '', ?Throwable $previous = null)
 
     protected function formatMessage(string $file, ?Throwable $previous): string
     {
-        return rtrim(sprintf("Invalid %s in file: '%s' %s", $this->getTypeLabel($file), $file, $this->getContext($previous)));
+        $fileLabel = $file ? sprintf(": '%s'", $file) : '';
+
+        return rtrim(sprintf('Invalid %s in file%s %s', $this->getTypeLabel($file), $fileLabel, $this->getContext($previous)));
     }
 
     protected function getTypeLabel(string $file): string
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index fcaeb77b1f3..e3894eec0a0 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -121,7 +121,7 @@ public function testParseExceptionWithDefaultMessage()
     {
         $exception = new ParseException();
 
-        $this->assertSame("Invalid data in file: ''", $exception->getMessage());
+        $this->assertSame('Invalid data in file', $exception->getMessage());
     }
 
     public function testParseExceptionWithFileName()
@@ -158,7 +158,7 @@ public function testParseExceptionWithEmptyFileNameAndCustomMessage()
         $previous = new RuntimeException('Custom error message.');
         $exception = new ParseException('', $previous);
 
-        $this->assertSame("Invalid data in file: '' (Custom error message)", $exception->getMessage());
+        $this->assertSame('Invalid data in file (Custom error message)', $exception->getMessage());
     }
 
     public function testParseExceptionWithEmptyFileNameAndEmptyPreviousMessage()
@@ -166,7 +166,7 @@ public function testParseExceptionWithEmptyFileNameAndEmptyPreviousMessage()
         $previous = new RuntimeException('');
         $exception = new ParseException('', $previous);
 
-        $this->assertSame("Invalid data in file: ''", $exception->getMessage());
+        $this->assertSame('Invalid data in file', $exception->getMessage());
     }
 
     public function testParseExceptionWithNoPrevious()

From 694b1cdd72933665a5b3f51d04175756e84304ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:29:53 +0200
Subject: [PATCH 1988/4023] Refactor and cleanup code

---
 .../src/Framework/Exceptions/ParseException.php          | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index aaf4724ae0a..1611bdbd347 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -25,9 +25,7 @@ public function __construct(string $file = '', ?Throwable $previous = null)
 
     protected function formatMessage(string $file, ?Throwable $previous): string
     {
-        $fileLabel = $file ? sprintf(": '%s'", $file) : '';
-
-        return rtrim(sprintf('Invalid %s in file%s %s', $this->getTypeLabel($file), $fileLabel, $this->getContext($previous)));
+        return rtrim(sprintf('Invalid %s in file%s %s', $this->getTypeLabel($file), $this->getFileLabel($file), $this->getContext($previous)));
     }
 
     protected function getTypeLabel(string $file): string
@@ -40,6 +38,11 @@ protected function getTypeLabel(string $file): string
         };
     }
 
+    protected function getFileLabel(string $file): string
+    {
+        return $file ? sprintf(": '%s'", $file) : '';
+    }
+
     protected function getContext(?Throwable $previous): string
     {
         return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';

From f1e82a173c49f42c1734df54902b8382fce844e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:43:48 +0200
Subject: [PATCH 1989/4023] Remove unnecessary parentheses

---
 packages/framework/src/Framework/Exceptions/ParseException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index 1611bdbd347..a53680dce61 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -45,6 +45,6 @@ protected function getFileLabel(string $file): string
 
     protected function getContext(?Throwable $previous): string
     {
-        return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+        return $previous && $previous->getMessage() ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
     }
 }

From e976cee951d770b17d6692f77eeeaebd5c525e59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:43:52 +0200
Subject: [PATCH 1990/4023] Revert "Remove unnecessary parentheses"

This reverts commit f1e82a173c49f42c1734df54902b8382fce844e6.
---
 packages/framework/src/Framework/Exceptions/ParseException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/ParseException.php b/packages/framework/src/Framework/Exceptions/ParseException.php
index a53680dce61..1611bdbd347 100644
--- a/packages/framework/src/Framework/Exceptions/ParseException.php
+++ b/packages/framework/src/Framework/Exceptions/ParseException.php
@@ -45,6 +45,6 @@ protected function getFileLabel(string $file): string
 
     protected function getContext(?Throwable $previous): string
     {
-        return $previous && $previous->getMessage() ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
+        return ($previous && $previous->getMessage()) ? sprintf('(%s)', rtrim($previous->getMessage(), '.')) : '';
     }
 }

From d6a619f0b507f6ca41fb48a469c69d9796a910d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:47:08 +0200
Subject: [PATCH 1991/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index aaa55ca2fcf..010e925d2ac 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -231,9 +231,10 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 
 - The `DataCollections` class has been renamed to `DataCollection`. If you have used the `DataCollections` class in your code, you will need to update your code to use the new class name.
 
-#### Minor impact
+#### Changes
 
 - Calling the `DataCollection` methods will no longer create the data collections directory automatically
+- The `DataCollection` class now validates the syntax of all data collection files during discovery, and throws a `ParseException` if the syntax is invalid
 
 #### Issues that may arise
 

From b2912a3d3227711a36b49bfea2528e721280daf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:47:59 +0200
Subject: [PATCH 1992/4023] Draft upcoming change notes

See https://github.com/hydephp/develop/pull/1732#issuecomment-2186498121
---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 010e925d2ac..7fe5c37db0c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -235,6 +235,7 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 
 - Calling the `DataCollection` methods will no longer create the data collections directory automatically
 - The `DataCollection` class now validates the syntax of all data collection files during discovery, and throws a `ParseException` if the syntax is invalid
+- The collections are now no longer keyed by the relative file path, instead only the basename identifier is used (see https://github.com/hydephp/develop/pull/1732#issuecomment-2186498121)
 
 #### Issues that may arise
 

From 227db4f8faa338798c526bfc407e8f0f99743af4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:51:17 +0200
Subject: [PATCH 1993/4023] Revert "Draft upcoming change notes"

This reverts commit b2912a3d3227711a36b49bfea2528e721280daf1.
---
 RELEASE_NOTES.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7fe5c37db0c..010e925d2ac 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -235,7 +235,6 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 
 - Calling the `DataCollection` methods will no longer create the data collections directory automatically
 - The `DataCollection` class now validates the syntax of all data collection files during discovery, and throws a `ParseException` if the syntax is invalid
-- The collections are now no longer keyed by the relative file path, instead only the basename identifier is used (see https://github.com/hydephp/develop/pull/1732#issuecomment-2186498121)
 
 #### Issues that may arise
 

From 0a3a65a694584ca5054588b18163731995ee5540 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 25 Jun 2024 19:57:12 +0200
Subject: [PATCH 1994/4023] Clean up release notes

---
 RELEASE_NOTES.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 010e925d2ac..a62b07d4786 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -233,14 +233,14 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 
 #### Changes
 
-- Calling the `DataCollection` methods will no longer create the data collections directory automatically
-- The `DataCollection` class now validates the syntax of all data collection files during discovery, and throws a `ParseException` if the syntax is invalid
+- Calling the `DataCollection` methods will no longer create the data collections directory automatically.
+- The `DataCollection` class now validates the syntax of all data collection files during discovery, and throws a `ParseException` if the syntax is invalid.
 
 #### Issues that may arise
 
 If you start getting a `ParseException` when using the `DataCollection` class, it may be due to malformed data collection files.
-Starting from this version, we validate the syntax of JSON and YAML files during discovery, to help you catch errors early.
-See https://github.com/hydephp/develop/issues/1736 for more information.
+Starting from this version, we validate the syntax of JSON and YAML in data files during discovery, including any front matter in Markdown data files. 
+We do this to help you catch errors early. See https://github.com/hydephp/develop/issues/1736 for more information.
 
 For example, an empty or malformed JSON file will now throw an exception like this:
  
@@ -248,5 +248,5 @@ For example, an empty or malformed JSON file will now throw an exception like th
 \Hyde\Framework\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```
 
-In order to normalize the thrown exceptions, we now rethrow `Symfony/Yaml` `ParseException` as our custom `ParseException` to match the JSON and Markdown validation.
-Additionally, an exception will be thrown if a data file is empty, as this is unlikely to be intentional.
+In order to normalize the thrown exceptions, we now rethrow the `ParseException` from `Symfony/Yaml` as our custom `ParseException` to match the JSON and Markdown validation.
+Additionally, an exception will be thrown if a data file is empty, as this is unlikely to be intentional. Markdown files can have an empty body if front matter is present.

From 25733a12470fd8e6617ca5000a83f05a19542a74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 09:51:11 +0200
Subject: [PATCH 1995/4023] Extract helper method

---
 packages/framework/src/Support/Includes.php | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 21b0eab2620..6d262acea23 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -64,7 +64,7 @@ public static function get(string $filename, ?string $default = null): ?string
      */
     public static function html(string $filename, ?string $default = null): ?string
     {
-        $path = static::path(basename($filename, '.html').'.html');
+        $path = static::normalizePath($filename, '.html');
 
         if (! file_exists($path)) {
             return $default === null ? null : $default;
@@ -82,7 +82,7 @@ public static function html(string $filename, ?string $default = null): ?string
      */
     public static function markdown(string $filename, ?string $default = null): ?string
     {
-        $path = static::path(basename($filename, '.md').'.md');
+        $path = static::normalizePath($filename, '.md');
 
         if (! file_exists($path)) {
             return $default === null ? null : Markdown::render($default);
@@ -100,7 +100,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
      */
     public static function blade(string $filename, ?string $default = null): ?string
     {
-        $path = static::path(basename($filename, '.blade.php').'.blade.php');
+        $path = static::normalizePath($filename, '.blade.php');
 
         if (! file_exists($path)) {
             return $default === null ? null : Blade::render($default);
@@ -108,4 +108,9 @@ public static function blade(string $filename, ?string $default = null): ?string
 
         return Blade::render(file_get_contents($path));
     }
+
+    protected static function normalizePath(string $filename, string $extension): string
+    {
+        return static::path(basename($filename, $extension).$extension);
+    }
 }

From 2da4e75f2eda3aa1738e07efc76836d987203b66 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:00:05 +0200
Subject: [PATCH 1996/4023] Get file contents using filesystem facade

---
 packages/framework/src/Support/Includes.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 6d262acea23..3e4e2785805 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -5,12 +5,12 @@
 namespace Hyde\Support;
 
 use Hyde\Hyde;
+use Hyde\Facades\Filesystem;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
 
 use function basename;
 use function file_exists;
-use function file_get_contents;
 
 /**
  * The Includes facade provides a simple way to access partials in the includes directory.
@@ -52,7 +52,7 @@ public static function get(string $filename, ?string $default = null): ?string
             return $default;
         }
 
-        return file_get_contents($path);
+        return Filesystem::getContents($path);
     }
 
     /**
@@ -70,7 +70,7 @@ public static function html(string $filename, ?string $default = null): ?string
             return $default === null ? null : $default;
         }
 
-        return file_get_contents($path);
+        return Filesystem::getContents($path);
     }
 
     /**
@@ -88,7 +88,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
             return $default === null ? null : Markdown::render($default);
         }
 
-        return Markdown::render(file_get_contents($path));
+        return Markdown::render(Filesystem::getContents($path));
     }
 
     /**
@@ -106,7 +106,7 @@ public static function blade(string $filename, ?string $default = null): ?string
             return $default === null ? null : Blade::render($default);
         }
 
-        return Blade::render(file_get_contents($path));
+        return Blade::render(Filesystem::getContents($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string

From 2df07d5b949b31ec3a78cb28c4e7fe9dc0005fbf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:02:03 +0200
Subject: [PATCH 1997/4023] Get file existence using filesystem facade

---
 packages/framework/src/Support/Includes.php | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 3e4e2785805..b477b20615e 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -10,7 +10,6 @@
 use Illuminate\Support\Facades\Blade;
 
 use function basename;
-use function file_exists;
 
 /**
  * The Includes facade provides a simple way to access partials in the includes directory.
@@ -48,7 +47,7 @@ public static function get(string $filename, ?string $default = null): ?string
     {
         $path = static::path($filename);
 
-        if (! file_exists($path)) {
+        if (! Filesystem::exists($path)) {
             return $default;
         }
 
@@ -66,7 +65,7 @@ public static function html(string $filename, ?string $default = null): ?string
     {
         $path = static::normalizePath($filename, '.html');
 
-        if (! file_exists($path)) {
+        if (! Filesystem::exists($path)) {
             return $default === null ? null : $default;
         }
 
@@ -84,7 +83,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
     {
         $path = static::normalizePath($filename, '.md');
 
-        if (! file_exists($path)) {
+        if (! Filesystem::exists($path)) {
             return $default === null ? null : Markdown::render($default);
         }
 
@@ -102,7 +101,7 @@ public static function blade(string $filename, ?string $default = null): ?string
     {
         $path = static::normalizePath($filename, '.blade.php');
 
-        if (! file_exists($path)) {
+        if (! Filesystem::exists($path)) {
             return $default === null ? null : Blade::render($default);
         }
 

From 3a7373641cba3d7237a923bc12de794ae307b795 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:03:49 +0200
Subject: [PATCH 1998/4023] Create IncludesFacadeUnitTest.php

---
 .../tests/Unit/IncludesFacadeUnitTest.php         | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/IncludesFacadeUnitTest.php

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
new file mode 100644
index 00000000000..2c73a531566
--- /dev/null
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Support\Includes
+ */
+class IncludesFacadeUnitTest extends UnitTestCase
+{
+    //
+}

From dfc5581e473fdb17931a847a8143618c4ff95670 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:15:09 +0200
Subject: [PATCH 1999/4023] Add test crosslinks

---
 packages/framework/tests/Feature/IncludesFacadeTest.php  | 2 ++
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index e2c95bc7c3d..cffcbb79f3c 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -11,6 +11,8 @@
 
 /**
  * @covers \Hyde\Support\Includes
+ *
+ * @see \Hyde\Framework\Testing\Unit\IncludesFacadeUnitTest
  */
 class IncludesFacadeTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 2c73a531566..2ca2b2f0fed 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -8,6 +8,8 @@
 
 /**
  * @covers \Hyde\Support\Includes
+ *
+ * @see \Hyde\Framework\Testing\Feature\IncludesFacadeTest
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {

From 48180bc9dd3ef982645487549b1e121198670586 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:19:54 +0200
Subject: [PATCH 2000/4023] Generate unit test with GPT 4

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 193 +++++++++++++++++-
 1 file changed, 192 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 2ca2b2f0fed..c8a8a9ee3db 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -4,7 +4,12 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Mockery;
+use Hyde\Hyde;
+use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\Facades\Blade;
+use Hyde\Facades\Filesystem;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -13,5 +18,191 @@
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {
-    //
+    protected function tearDown(): void
+    {
+        Mockery::close();
+        parent::tearDown();
+    }
+
+    public function testPathReturnsTheIncludesDirectory()
+    {
+        $this->assertSame(Hyde::path('resources/includes'), Includes::path());
+    }
+
+    public function testPathReturnsAPartialWithinTheIncludesDirectory()
+    {
+        $this->assertSame(Hyde::path('resources/includes/partial.html'), Includes::path('partial.html'));
+    }
+
+    public function testGetReturnsPartial()
+    {
+        $filename = 'foo.txt';
+        $expected = 'foo bar';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        $this->assertSame($expected, Includes::get($filename));
+    }
+
+    public function testGetReturnsDefaultValueWhenNotFound()
+    {
+        $filename = 'foo.txt';
+        $default = 'default';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        $this->assertNull(Includes::get($filename));
+        $this->assertSame($default, Includes::get($filename, $default));
+    }
+
+    public function testHtmlReturnsRenderedPartial()
+    {
+        $filename = 'foo.html';
+        $expected = '<h1>foo bar</h1>';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        $this->assertSame($expected, Includes::html($filename));
+    }
+
+    public function testHtmlReturnsDefaultValueWhenNotFound()
+    {
+        $filename = 'foo.html';
+        $default = '<h1>default</h1>';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        $this->assertNull(Includes::html($filename));
+        $this->assertSame($default, Includes::html($filename, $default));
+    }
+
+    public function testHtmlWithAndWithoutExtension()
+    {
+        $filename = 'foo.html';
+        $content = '<h1>foo bar</h1>';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        $this->assertSame(Includes::html('foo.html'), Includes::html('foo'));
+    }
+
+    public function testMarkdownReturnsRenderedPartial()
+    {
+        $filename = 'foo.md';
+        $content = '# foo bar';
+        $expected = "<h1>foo bar</h1>\n";
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Markdown::shouldReceive('render')->with($content)->andReturn($expected);
+
+        $this->assertSame($expected, Includes::markdown($filename));
+    }
+
+    public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
+    {
+        $filename = 'foo.md';
+        $default = '# default';
+        $expected = "<h1>default</h1>\n";
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Markdown::shouldReceive('render')->with($default)->andReturn($expected);
+
+        $this->assertNull(Includes::markdown($filename));
+        $this->assertSame($expected, Includes::markdown($filename, $default));
+    }
+
+    public function testMarkdownWithAndWithoutExtension()
+    {
+        $filename = 'foo.md';
+        $content = '# foo bar';
+        $expected = "<h1>foo bar</h1>\n";
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Markdown::shouldReceive('render')->with($content)->andReturn($expected);
+
+        $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
+    }
+
+    public function testBladeReturnsRenderedPartial()
+    {
+        $filename = 'foo.blade.php';
+        $content = '{{ "foo bar" }}';
+        $expected = 'foo bar';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+
+        $this->assertSame($expected, Includes::blade($filename));
+    }
+
+    public function testBladeWithAndWithoutExtension()
+    {
+        $filename = 'foo.blade.php';
+        $content = '{{ "foo bar" }}';
+        $expected = 'foo bar';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+
+        $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
+    }
+
+    public function testBladeReturnsDefaultValueWhenNotFound()
+    {
+        $filename = 'foo.blade.php';
+        $default = '{{ "default" }}';
+        $expected = 'default';
+
+        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+
+        app()->instance(Filesystem::class, $filesystem);
+
+        Blade::shouldReceive('render')->with($default)->andReturn($expected);
+
+        $this->assertNull(Includes::blade($filename));
+        $this->assertSame($expected, Includes::blade($filename, $default));
+    }
 }

From 8a776ef4dfeb1cb5a7358550a1bc19945596d24d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:20:21 +0200
Subject: [PATCH 2001/4023] Test needs kernel

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index c8a8a9ee3db..473c126e11d 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -18,6 +18,8 @@
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+
     protected function tearDown(): void
     {
         Mockery::close();

From b117a3768d21e694d6f126073ee97a67e91730fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:20:39 +0200
Subject: [PATCH 2002/4023] Clean up formatting

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 473c126e11d..e4cee2d1a5c 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -23,6 +23,7 @@ class IncludesFacadeUnitTest extends UnitTestCase
     protected function tearDown(): void
     {
         Mockery::close();
+
         parent::tearDown();
     }
 

From d66537d6b1ead15dfb305417f0d9c8044aab5d89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:24:42 +0200
Subject: [PATCH 2003/4023] Use mockable get instead of get contents

---
 packages/framework/src/Support/Includes.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index b477b20615e..2f02b38d801 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -51,7 +51,7 @@ public static function get(string $filename, ?string $default = null): ?string
             return $default;
         }
 
-        return Filesystem::getContents($path);
+        return Filesystem::get($path);
     }
 
     /**
@@ -69,7 +69,7 @@ public static function html(string $filename, ?string $default = null): ?string
             return $default === null ? null : $default;
         }
 
-        return Filesystem::getContents($path);
+        return Filesystem::get($path);
     }
 
     /**
@@ -87,7 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
             return $default === null ? null : Markdown::render($default);
         }
 
-        return Markdown::render(Filesystem::getContents($path));
+        return Markdown::render(Filesystem::get($path));
     }
 
     /**
@@ -105,7 +105,7 @@ public static function blade(string $filename, ?string $default = null): ?string
             return $default === null ? null : Blade::render($default);
         }
 
-        return Blade::render(Filesystem::getContents($path));
+        return Blade::render(Filesystem::get($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string

From 85314bfbd3b3a3b0b4520b8f1d235098c9e4f966 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:24:45 +0200
Subject: [PATCH 2004/4023] Revert "Use mockable get instead of get contents"

This reverts commit d66537d6b1ead15dfb305417f0d9c8044aab5d89.
---
 packages/framework/src/Support/Includes.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 2f02b38d801..b477b20615e 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -51,7 +51,7 @@ public static function get(string $filename, ?string $default = null): ?string
             return $default;
         }
 
-        return Filesystem::get($path);
+        return Filesystem::getContents($path);
     }
 
     /**
@@ -69,7 +69,7 @@ public static function html(string $filename, ?string $default = null): ?string
             return $default === null ? null : $default;
         }
 
-        return Filesystem::get($path);
+        return Filesystem::getContents($path);
     }
 
     /**
@@ -87,7 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
             return $default === null ? null : Markdown::render($default);
         }
 
-        return Markdown::render(Filesystem::get($path));
+        return Markdown::render(Filesystem::getContents($path));
     }
 
     /**
@@ -105,7 +105,7 @@ public static function blade(string $filename, ?string $default = null): ?string
             return $default === null ? null : Blade::render($default);
         }
 
-        return Blade::render(Filesystem::get($path));
+        return Blade::render(Filesystem::getContents($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string

From 37e7ddd7b626095d7d18b0b00100eaed723e278c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:25:44 +0200
Subject: [PATCH 2005/4023] Reapply "Use mockable get instead of get contents"

This reverts commit 85314bfbd3b3a3b0b4520b8f1d235098c9e4f966.
---
 packages/framework/src/Support/Includes.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index b477b20615e..2f02b38d801 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -51,7 +51,7 @@ public static function get(string $filename, ?string $default = null): ?string
             return $default;
         }
 
-        return Filesystem::getContents($path);
+        return Filesystem::get($path);
     }
 
     /**
@@ -69,7 +69,7 @@ public static function html(string $filename, ?string $default = null): ?string
             return $default === null ? null : $default;
         }
 
-        return Filesystem::getContents($path);
+        return Filesystem::get($path);
     }
 
     /**
@@ -87,7 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?str
             return $default === null ? null : Markdown::render($default);
         }
 
-        return Markdown::render(Filesystem::getContents($path));
+        return Markdown::render(Filesystem::get($path));
     }
 
     /**
@@ -105,7 +105,7 @@ public static function blade(string $filename, ?string $default = null): ?string
             return $default === null ? null : Blade::render($default);
         }
 
-        return Blade::render(Filesystem::getContents($path));
+        return Blade::render(Filesystem::get($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string

From 84a6d9384c6523276945bdf69e50f12f05ec4fe2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:25:55 +0200
Subject: [PATCH 2006/4023] Use Illuminate filesystem

---
 .../tests/Unit/IncludesFacadeUnitTest.php       | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index e4cee2d1a5c..1eea8568033 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,7 +9,7 @@
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Facades\Blade;
-use Hyde\Facades\Filesystem;
+use Illuminate\Filesystem\Filesystem;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -43,8 +43,9 @@ public function testGetReturnsPartial()
         $expected = 'foo bar';
 
         $filesystem = Mockery::mock(Filesystem::class);
+
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -72,7 +73,7 @@ public function testHtmlReturnsRenderedPartial()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -100,7 +101,7 @@ public function testHtmlWithAndWithoutExtension()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -115,7 +116,7 @@ public function testMarkdownReturnsRenderedPartial()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -149,7 +150,7 @@ public function testMarkdownWithAndWithoutExtension()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -166,7 +167,7 @@ public function testBladeReturnsRenderedPartial()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
         app()->instance(Filesystem::class, $filesystem);
 
@@ -183,7 +184,7 @@ public function testBladeWithAndWithoutExtension()
 
         $filesystem = Mockery::mock(Filesystem::class);
         $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('getContents')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
         app()->instance(Filesystem::class, $filesystem);
 

From a216620716561cdf5b73f651cf2b4be2f4f5a3e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:28:08 +0200
Subject: [PATCH 2007/4023] Don't mock Markdown class

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 1eea8568033..b5cfde5e7d5 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -120,8 +120,6 @@ public function testMarkdownReturnsRenderedPartial()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Markdown::shouldReceive('render')->with($content)->andReturn($expected);
-
         $this->assertSame($expected, Includes::markdown($filename));
     }
 
@@ -136,8 +134,6 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Markdown::shouldReceive('render')->with($default)->andReturn($expected);
-
         $this->assertNull(Includes::markdown($filename));
         $this->assertSame($expected, Includes::markdown($filename, $default));
     }
@@ -154,8 +150,6 @@ public function testMarkdownWithAndWithoutExtension()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Markdown::shouldReceive('render')->with($content)->andReturn($expected);
-
         $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
     }
 

From 5bcb54da0aa4557da05eb55808541c9ba5463cd6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:29:32 +0200
Subject: [PATCH 2008/4023] Add missing assertions

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index b5cfde5e7d5..dd4019c6038 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -150,7 +150,9 @@ public function testMarkdownWithAndWithoutExtension()
 
         app()->instance(Filesystem::class, $filesystem);
 
+        $this->assertSame($expected, Includes::markdown('foo.md'));
         $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
+        $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo.md'));
     }
 
     public function testBladeReturnsRenderedPartial()

From bfa129c21823d1671dd70c81c724e8ea8052fba6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:33:29 +0200
Subject: [PATCH 2009/4023] Clear resolved Blade instances

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index dd4019c6038..3a46f44d5f1 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -23,6 +23,7 @@ class IncludesFacadeUnitTest extends UnitTestCase
     protected function tearDown(): void
     {
         Mockery::close();
+        Blade::clearResolvedInstances();
 
         parent::tearDown();
     }

From 6288483c76b71abceb63c3c78cbfb53d56411582 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:35:11 +0200
Subject: [PATCH 2010/4023] Revert "Clear resolved Blade instances"

This reverts commit bfa129c21823d1671dd70c81c724e8ea8052fba6.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 3a46f44d5f1..dd4019c6038 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -23,7 +23,6 @@ class IncludesFacadeUnitTest extends UnitTestCase
     protected function tearDown(): void
     {
         Mockery::close();
-        Blade::clearResolvedInstances();
 
         parent::tearDown();
     }

From 852cb99d147d4f5e0d0beda110795f43956fbedf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:39:36 +0200
Subject: [PATCH 2011/4023] Remove Blade mocks

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index dd4019c6038..032080898c5 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -167,8 +167,6 @@ public function testBladeReturnsRenderedPartial()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Blade::shouldReceive('render')->with($content)->andReturn($expected);
-
         $this->assertSame($expected, Includes::blade($filename));
     }
 
@@ -184,8 +182,6 @@ public function testBladeWithAndWithoutExtension()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Blade::shouldReceive('render')->with($content)->andReturn($expected);
-
         $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
     }
 
@@ -200,8 +196,6 @@ public function testBladeReturnsDefaultValueWhenNotFound()
 
         app()->instance(Filesystem::class, $filesystem);
 
-        Blade::shouldReceive('render')->with($default)->andReturn($expected);
-
         $this->assertNull(Includes::blade($filename));
         $this->assertSame($expected, Includes::blade($filename, $default));
     }

From 60c21346cd1b419f16e41894870e1f3c4c3497da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:39:49 +0200
Subject: [PATCH 2012/4023] Revert "Remove Blade mocks"

This reverts commit 852cb99d147d4f5e0d0beda110795f43956fbedf.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 032080898c5..dd4019c6038 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -167,6 +167,8 @@ public function testBladeReturnsRenderedPartial()
 
         app()->instance(Filesystem::class, $filesystem);
 
+        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+
         $this->assertSame($expected, Includes::blade($filename));
     }
 
@@ -182,6 +184,8 @@ public function testBladeWithAndWithoutExtension()
 
         app()->instance(Filesystem::class, $filesystem);
 
+        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+
         $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
     }
 
@@ -196,6 +200,8 @@ public function testBladeReturnsDefaultValueWhenNotFound()
 
         app()->instance(Filesystem::class, $filesystem);
 
+        Blade::shouldReceive('render')->with($default)->andReturn($expected);
+
         $this->assertNull(Includes::blade($filename));
         $this->assertSame($expected, Includes::blade($filename, $default));
     }

From bd04137f1b753a3a28180945e9cb4ae939e82d08 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:40:30 +0200
Subject: [PATCH 2013/4023] Swap Blade for a mock

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index dd4019c6038..c6f36f2606c 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -20,6 +20,13 @@ class IncludesFacadeUnitTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        Blade::swap(Mockery::mock());
+    }
+
     protected function tearDown(): void
     {
         Mockery::close();

From 2661b8ed4058c84c3d72ef7811b8c55c1c9b1313 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:56:47 +0200
Subject: [PATCH 2014/4023] Refactor to extract helper method

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index c6f36f2606c..b79ca9d45fb 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Mockery;
+use Closure;
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
@@ -49,12 +50,10 @@ public function testGetReturnsPartial()
         $filename = 'foo.txt';
         $expected = 'foo bar';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+        });
 
         $this->assertSame($expected, Includes::get($filename));
     }
@@ -212,4 +211,13 @@ public function testBladeReturnsDefaultValueWhenNotFound()
         $this->assertNull(Includes::blade($filename));
         $this->assertSame($expected, Includes::blade($filename, $default));
     }
+
+    protected function mockFilesystem(Closure $config): void
+    {
+        $filesystem = Mockery::mock(Filesystem::class);
+
+        $config($filesystem);
+
+        app()->instance(Filesystem::class, $filesystem);
+    }
 }

From d950c906eb7f369297603f0d3261c505321f0484 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:57:49 +0200
Subject: [PATCH 2015/4023] Refactor with GPT 4 to use the added helper method

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 82 ++++++++-----------
 1 file changed, 36 insertions(+), 46 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index b79ca9d45fb..6aaca573af0 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -63,10 +63,9 @@ public function testGetReturnsDefaultValueWhenNotFound()
         $filename = 'foo.txt';
         $default = 'default';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+        });
 
         $this->assertNull(Includes::get($filename));
         $this->assertSame($default, Includes::get($filename, $default));
@@ -77,11 +76,10 @@ public function testHtmlReturnsRenderedPartial()
         $filename = 'foo.html';
         $expected = '<h1>foo bar</h1>';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+        });
 
         $this->assertSame($expected, Includes::html($filename));
     }
@@ -91,10 +89,9 @@ public function testHtmlReturnsDefaultValueWhenNotFound()
         $filename = 'foo.html';
         $default = '<h1>default</h1>';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+        });
 
         $this->assertNull(Includes::html($filename));
         $this->assertSame($default, Includes::html($filename, $default));
@@ -105,11 +102,10 @@ public function testHtmlWithAndWithoutExtension()
         $filename = 'foo.html';
         $content = '<h1>foo bar</h1>';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        });
 
         $this->assertSame(Includes::html('foo.html'), Includes::html('foo'));
     }
@@ -120,11 +116,10 @@ public function testMarkdownReturnsRenderedPartial()
         $content = '# foo bar';
         $expected = "<h1>foo bar</h1>\n";
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        });
 
         $this->assertSame($expected, Includes::markdown($filename));
     }
@@ -135,10 +130,9 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
         $default = '# default';
         $expected = "<h1>default</h1>\n";
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+        });
 
         $this->assertNull(Includes::markdown($filename));
         $this->assertSame($expected, Includes::markdown($filename, $default));
@@ -150,11 +144,10 @@ public function testMarkdownWithAndWithoutExtension()
         $content = '# foo bar';
         $expected = "<h1>foo bar</h1>\n";
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        });
 
         $this->assertSame($expected, Includes::markdown('foo.md'));
         $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
@@ -167,11 +160,10 @@ public function testBladeReturnsRenderedPartial()
         $content = '{{ "foo bar" }}';
         $expected = 'foo bar';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        });
 
         Blade::shouldReceive('render')->with($content)->andReturn($expected);
 
@@ -184,11 +176,10 @@ public function testBladeWithAndWithoutExtension()
         $content = '{{ "foo bar" }}';
         $expected = 'foo bar';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-        $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+        });
 
         Blade::shouldReceive('render')->with($content)->andReturn($expected);
 
@@ -201,10 +192,9 @@ public function testBladeReturnsDefaultValueWhenNotFound()
         $default = '{{ "default" }}';
         $expected = 'default';
 
-        $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
-
-        app()->instance(Filesystem::class, $filesystem);
+        $this->mockFilesystem(function ($filesystem) use ($filename) {
+            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+        });
 
         Blade::shouldReceive('render')->with($default)->andReturn($expected);
 

From 5e7869fbad9e7d474496de3c938877f3f73e5328 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 10:59:12 +0200
Subject: [PATCH 2016/4023] Move variable assignments inside closures

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 6aaca573af0..c13fd8065f1 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -99,10 +99,10 @@ public function testHtmlReturnsDefaultValueWhenNotFound()
 
     public function testHtmlWithAndWithoutExtension()
     {
-        $filename = 'foo.html';
-        $content = '<h1>foo bar</h1>';
 
-        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+        $this->mockFilesystem(function ($filesystem) {
+            $filename = 'foo.html';
+            $content = '<h1>foo bar</h1>';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -113,10 +113,10 @@ public function testHtmlWithAndWithoutExtension()
     public function testMarkdownReturnsRenderedPartial()
     {
         $filename = 'foo.md';
-        $content = '# foo bar';
         $expected = "<h1>foo bar</h1>\n";
 
-        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+        $this->mockFilesystem(function ($filesystem) use ($filename) {
+            $content = '# foo bar';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -140,11 +140,11 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
 
     public function testMarkdownWithAndWithoutExtension()
     {
-        $filename = 'foo.md';
-        $content = '# foo bar';
         $expected = "<h1>foo bar</h1>\n";
 
-        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+        $this->mockFilesystem(function ($filesystem) {
+            $content = '# foo bar';
+            $filename = 'foo.md';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -172,11 +172,11 @@ public function testBladeReturnsRenderedPartial()
 
     public function testBladeWithAndWithoutExtension()
     {
-        $filename = 'foo.blade.php';
         $content = '{{ "foo bar" }}';
         $expected = 'foo bar';
 
-        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+        $this->mockFilesystem(function ($filesystem) use ($content) {
+            $filename = 'foo.blade.php';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });

From 4868497000d4b32e524d79d0ab9d523a60ff7b9d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 11:00:57 +0200
Subject: [PATCH 2017/4023] Refactor to move Blade mocks into closure

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 23 +++++++++----------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index c13fd8065f1..33c226116c7 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -157,31 +157,31 @@ public function testMarkdownWithAndWithoutExtension()
     public function testBladeReturnsRenderedPartial()
     {
         $filename = 'foo.blade.php';
-        $content = '{{ "foo bar" }}';
         $expected = 'foo bar';
 
-        $this->mockFilesystem(function ($filesystem) use ($content, $filename) {
+        $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
+            $content = '{{ "foo bar" }}';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-        });
 
-        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+            Blade::shouldReceive('render')->with($content)->andReturn($expected);
+        });
 
         $this->assertSame($expected, Includes::blade($filename));
     }
 
     public function testBladeWithAndWithoutExtension()
     {
-        $content = '{{ "foo bar" }}';
-        $expected = 'foo bar';
 
-        $this->mockFilesystem(function ($filesystem) use ($content) {
+        $this->mockFilesystem(function ($filesystem) {
+            $expected = 'foo bar';
+            $content = '{{ "foo bar" }}';
             $filename = 'foo.blade.php';
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
-        });
 
-        Blade::shouldReceive('render')->with($content)->andReturn($expected);
+            Blade::shouldReceive('render')->with($content)->andReturn($expected);
+        });
 
         $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
     }
@@ -192,12 +192,11 @@ public function testBladeReturnsDefaultValueWhenNotFound()
         $default = '{{ "default" }}';
         $expected = 'default';
 
-        $this->mockFilesystem(function ($filesystem) use ($filename) {
+        $this->mockFilesystem(function ($filesystem) use ($default, $expected, $filename) {
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+            Blade::shouldReceive('render')->with($default)->andReturn($expected);
         });
 
-        Blade::shouldReceive('render')->with($default)->andReturn($expected);
-
         $this->assertNull(Includes::blade($filename));
         $this->assertSame($expected, Includes::blade($filename, $default));
     }

From 45e59cec354854878c89af9c66801e3db2ea709f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 11:01:28 +0200
Subject: [PATCH 2018/4023] Cleanup formatting

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 33c226116c7..853b000adf8 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -99,10 +99,10 @@ public function testHtmlReturnsDefaultValueWhenNotFound()
 
     public function testHtmlWithAndWithoutExtension()
     {
-
         $this->mockFilesystem(function ($filesystem) {
             $filename = 'foo.html';
             $content = '<h1>foo bar</h1>';
+
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -117,6 +117,7 @@ public function testMarkdownReturnsRenderedPartial()
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
             $content = '# foo bar';
+
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -145,6 +146,7 @@ public function testMarkdownWithAndWithoutExtension()
         $this->mockFilesystem(function ($filesystem) {
             $content = '# foo bar';
             $filename = 'foo.md';
+
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
         });
@@ -161,6 +163,7 @@ public function testBladeReturnsRenderedPartial()
 
         $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
             $content = '{{ "foo bar" }}';
+
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
@@ -172,11 +175,11 @@ public function testBladeReturnsRenderedPartial()
 
     public function testBladeWithAndWithoutExtension()
     {
-
         $this->mockFilesystem(function ($filesystem) {
             $expected = 'foo bar';
             $content = '{{ "foo bar" }}';
             $filename = 'foo.blade.php';
+
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
 
@@ -194,6 +197,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
 
         $this->mockFilesystem(function ($filesystem) use ($default, $expected, $filename) {
             $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+
             Blade::shouldReceive('render')->with($default)->andReturn($expected);
         });
 

From 26587084b390f7123e9a6054205dd6f27ff5c0cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 11:23:03 +0200
Subject: [PATCH 2019/4023] Add broader level feature test

---
 .../tests/Feature/IncludesFacadeTest.php      | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index cffcbb79f3c..5e7cbd70cd4 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -115,4 +115,59 @@ public function testBladeReturnsRenderedDefaultValueWhenNotFound()
         $this->assertNull(Includes::blade('foo.blade.php'));
         $this->assertSame('default', Includes::blade('foo.blade.php', '{{ "default" }}'));
     }
+
+    public function testAdvancedMarkdownDocumentIsCompiledToHtml()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Heading
+        
+        This is a paragraph. It has some **bold** and *italic* text.
+        
+        >info Info Blockquote
+        
+        ```php
+        // filepath: hello.php
+        echo 'Hello, World!';
+        ```
+        
+        ## Subheading
+        
+        
+        - [x] Checked task list
+        - [ ] Unchecked task list
+        
+        ### Table
+        
+        | Syntax | Description |
+        | ----------- | ----------- |
+        | Header | Title |
+        | Paragraph | Text |
+        
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <h1>Heading</h1>
+        <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
+        <blockquote>
+        <p>info Info Blockquote</p>
+        </blockquote>
+        <pre><code class="language-php">// filepath: hello.php
+        echo 'Hello, World!';
+        </code></pre>
+        <h2>Subheading</h2>
+        <ul>
+        <li>[x] Checked task list</li>
+        <li>[ ] Unchecked task list</li>
+        </ul>
+        <h3>Table</h3>
+        <p>| Syntax | Description |
+        | ----------- | ----------- |
+        | Header | Title |
+        | Paragraph | Text |</p>
+
+        HTML;
+
+        $this->file('resources/includes/advanced.md', $markdown);
+        $this->assertSame($expected, Includes::markdown('advanced.md'));
+    }
 }

From 9f6a57918ee93722c33e79230985cd503ace8fc5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 11:28:12 +0200
Subject: [PATCH 2020/4023] Specify page class to use the custom Markdown
 features

---
 packages/framework/src/Support/Includes.php   |  5 +--
 .../tests/Feature/IncludesFacadeTest.php      | 33 ++++++++++++-------
 .../tests/Unit/IncludesFacadeUnitTest.php     |  1 +
 3 files changed, 26 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 2f02b38d801..0f537a1f8f7 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Filesystem;
+use Hyde\Pages\Concerns\HydePage;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
 
@@ -84,10 +85,10 @@ public static function markdown(string $filename, ?string $default = null): ?str
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : Markdown::render($default);
+            return $default === null ? null : Markdown::render($default, HydePage::class);
         }
 
-        return Markdown::render(Filesystem::get($path));
+        return Markdown::render(Filesystem::get($path), HydePage::class);
     }
 
     /**
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 5e7cbd70cd4..9af0751f203 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -148,22 +148,33 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $expected = <<<'HTML'
         <h1>Heading</h1>
         <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
-        <blockquote>
-        <p>info Info Blockquote</p>
-        </blockquote>
-        <pre><code class="language-php">// filepath: hello.php
-        echo 'Hello, World!';
+        <blockquote class="info"><p>Info Blockquote</p></blockquote>
+        <pre><code class="language-php"><small class="filepath not-prose"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
         </code></pre>
         <h2>Subheading</h2>
         <ul>
-        <li>[x] Checked task list</li>
-        <li>[ ] Unchecked task list</li>
+        <li><input checked="" disabled="" type="checkbox"> Checked task list</li>
+        <li><input disabled="" type="checkbox"> Unchecked task list</li>
         </ul>
         <h3>Table</h3>
-        <p>| Syntax | Description |
-        | ----------- | ----------- |
-        | Header | Title |
-        | Paragraph | Text |</p>
+        <table>
+        <thead>
+        <tr>
+        <th>Syntax</th>
+        <th>Description</th>
+        </tr>
+        </thead>
+        <tbody>
+        <tr>
+        <td>Header</td>
+        <td>Title</td>
+        </tr>
+        <tr>
+        <td>Paragraph</td>
+        <td>Text</td>
+        </tr>
+        </tbody>
+        </table>
 
         HTML;
 
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 853b000adf8..9343147f18b 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -20,6 +20,7 @@
 class IncludesFacadeUnitTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
 
     protected function setUp(): void
     {

From f15bea8eb839e0121b166a9ed30c6b89811d0104 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:32:37 +0200
Subject: [PATCH 2021/4023] Change page class used to render Markdown partials
 to MarkdownDocument

See https://github.com/hydephp/develop/pull/1738#discussion_r1654660038
---
 packages/framework/src/Support/Includes.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 0f537a1f8f7..6433d7561c5 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -6,7 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Filesystem;
-use Hyde\Pages\Concerns\HydePage;
+use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
 
@@ -85,10 +85,10 @@ public static function markdown(string $filename, ?string $default = null): ?str
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : Markdown::render($default, HydePage::class);
+            return $default === null ? null : Markdown::render($default, MarkdownDocument::class);
         }
 
-        return Markdown::render(Filesystem::get($path), HydePage::class);
+        return Markdown::render(Filesystem::get($path), MarkdownDocument::class);
     }
 
     /**

From 9a8538c0a75b5255d44d739a3ff9affcb254179d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:35:20 +0200
Subject: [PATCH 2022/4023] Add test for current state

---
 .../tests/Feature/IncludesFacadeTest.php         | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 9af0751f203..7ce41b0cfd9 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -181,4 +181,20 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $this->file('resources/includes/advanced.md', $markdown);
         $this->assertSame($expected, Includes::markdown('advanced.md'));
     }
+
+    public function testTorchlightAttributionIsInjectedToMarkdownPartials()
+    {
+        $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
+
+        $this->assertSame(
+            '<p>Syntax highlighted by torchlight.dev</p>
+<br><p>
+    <i>
+        Syntax highlighting by <a href="https://torchlight.dev/" rel="noopener nofollow">Torchlight.dev</a>
+    </i>
+</p>
+',
+            Includes::markdown('without-torchlight.md')
+        );
+    }
 }

From 83c613649bcb2199a452251254e2d17479ed81ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:37:37 +0200
Subject: [PATCH 2023/4023] Do not inject Torchlight attribution for included
 partials

See https://github.com/hydephp/develop/pull/1738#discussion_r1654660038
---
 .../framework/src/Framework/Services/MarkdownService.php   | 2 ++
 packages/framework/tests/Feature/IncludesFacadeTest.php    | 7 +------
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index 79bf560b41c..1e13044b681 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Config;
 use Hyde\Facades\Features;
+use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Markdown\MarkdownConverter;
@@ -186,6 +187,7 @@ public function hasFeature(string $feature): bool
     protected function determineIfTorchlightAttributionShouldBeInjected(): bool
     {
         return ! $this->isDocumentationPage()
+            && ! (isset($this->pageClass) && $this->pageClass === MarkdownDocument::class)
             && Config::getBool('torchlight.attribution.enabled', true)
             && str_contains($this->html, 'Syntax highlighted by torchlight.dev');
     }
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 7ce41b0cfd9..71d5016af3f 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -182,17 +182,12 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $this->assertSame($expected, Includes::markdown('advanced.md'));
     }
 
-    public function testTorchlightAttributionIsInjectedToMarkdownPartials()
+    public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
     {
         $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
 
         $this->assertSame(
             '<p>Syntax highlighted by torchlight.dev</p>
-<br><p>
-    <i>
-        Syntax highlighting by <a href="https://torchlight.dev/" rel="noopener nofollow">Torchlight.dev</a>
-    </i>
-</p>
 ',
             Includes::markdown('without-torchlight.md')
         );

From e56494d6f74b066a5dccffb2ef092fc654b1f442 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:38:14 +0200
Subject: [PATCH 2024/4023] Clean up formatting

---
 packages/framework/tests/Feature/IncludesFacadeTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 71d5016af3f..dbbc680fa9f 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -187,8 +187,7 @@ public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
         $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
 
         $this->assertSame(
-            '<p>Syntax highlighted by torchlight.dev</p>
-',
+            "<p>Syntax highlighted by torchlight.dev</p>\n",
             Includes::markdown('without-torchlight.md')
         );
     }

From 9d4a85bccde1b6f80a1129bdb470a74cd3cc2a39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:50:05 +0200
Subject: [PATCH 2025/4023] Move up test in source

---
 .../tests/Feature/IncludesFacadeTest.php      | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index dbbc680fa9f..137824e3be0 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -116,6 +116,16 @@ public function testBladeReturnsRenderedDefaultValueWhenNotFound()
         $this->assertSame('default', Includes::blade('foo.blade.php', '{{ "default" }}'));
     }
 
+    public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
+    {
+        $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
+
+        $this->assertSame(
+            "<p>Syntax highlighted by torchlight.dev</p>\n",
+            Includes::markdown('without-torchlight.md')
+        );
+    }
+
     public function testAdvancedMarkdownDocumentIsCompiledToHtml()
     {
         $markdown = <<<'MARKDOWN'
@@ -181,14 +191,4 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $this->file('resources/includes/advanced.md', $markdown);
         $this->assertSame($expected, Includes::markdown('advanced.md'));
     }
-
-    public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
-    {
-        $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
-
-        $this->assertSame(
-            "<p>Syntax highlighted by torchlight.dev</p>\n",
-            Includes::markdown('without-torchlight.md')
-        );
-    }
 }

From 0225eddf4ad7af57a8b51b9a6fb1002620f88887 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:51:58 +0200
Subject: [PATCH 2026/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a62b07d4786..65127708ac2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -29,6 +29,7 @@ This serves two purposes:
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
 - Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
+- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels.
 
 ### Deprecated
 - for soon-to-be removed features.

From b7a7a79ae947919704de0dd8019c21b00139038d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 14:52:45 +0200
Subject: [PATCH 2027/4023] Extract helper method

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 41 +++++++++++--------
 1 file changed, 23 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 9343147f18b..d7eeb8f9269 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -52,8 +52,8 @@ public function testGetReturnsPartial()
         $expected = 'foo bar';
 
         $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($expected);
         });
 
         $this->assertSame($expected, Includes::get($filename));
@@ -65,7 +65,7 @@ public function testGetReturnsDefaultValueWhenNotFound()
         $default = 'default';
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
         $this->assertNull(Includes::get($filename));
@@ -78,8 +78,8 @@ public function testHtmlReturnsRenderedPartial()
         $expected = '<h1>foo bar</h1>';
 
         $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($expected);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($expected);
         });
 
         $this->assertSame($expected, Includes::html($filename));
@@ -91,7 +91,7 @@ public function testHtmlReturnsDefaultValueWhenNotFound()
         $default = '<h1>default</h1>';
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
         $this->assertNull(Includes::html($filename));
@@ -104,8 +104,8 @@ public function testHtmlWithAndWithoutExtension()
             $filename = 'foo.html';
             $content = '<h1>foo bar</h1>';
 
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
         $this->assertSame(Includes::html('foo.html'), Includes::html('foo'));
@@ -119,8 +119,8 @@ public function testMarkdownReturnsRenderedPartial()
         $this->mockFilesystem(function ($filesystem) use ($filename) {
             $content = '# foo bar';
 
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
         $this->assertSame($expected, Includes::markdown($filename));
@@ -133,7 +133,7 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
         $expected = "<h1>default</h1>\n";
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
         $this->assertNull(Includes::markdown($filename));
@@ -148,8 +148,8 @@ public function testMarkdownWithAndWithoutExtension()
             $content = '# foo bar';
             $filename = 'foo.md';
 
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
         $this->assertSame($expected, Includes::markdown('foo.md'));
@@ -165,8 +165,8 @@ public function testBladeReturnsRenderedPartial()
         $this->mockFilesystem(function ($filesystem) use ($expected, $filename) {
             $content = '{{ "foo bar" }}';
 
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
 
             Blade::shouldReceive('render')->with($content)->andReturn($expected);
         });
@@ -181,8 +181,8 @@ public function testBladeWithAndWithoutExtension()
             $content = '{{ "foo bar" }}';
             $filename = 'foo.blade.php';
 
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(true);
-            $filesystem->shouldReceive('get')->with(Hyde::path('resources/includes/'.$filename))->andReturn($content);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
 
             Blade::shouldReceive('render')->with($content)->andReturn($expected);
         });
@@ -197,7 +197,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
         $expected = 'default';
 
         $this->mockFilesystem(function ($filesystem) use ($default, $expected, $filename) {
-            $filesystem->shouldReceive('exists')->with(Hyde::path('resources/includes/'.$filename))->andReturn(false);
+            $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
 
             Blade::shouldReceive('render')->with($default)->andReturn($expected);
         });
@@ -214,4 +214,9 @@ protected function mockFilesystem(Closure $config): void
 
         app()->instance(Filesystem::class, $filesystem);
     }
+
+    protected function includesPath(string $filename): string
+    {
+        return Hyde::path('resources/includes/'.$filename);
+    }
 }

From 5c1833ebf64ad0f90d82cdc597239619d7bafd90 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:32:33 +0200
Subject: [PATCH 2028/4023] Test advanced Blade partial is compiled to HTML

---
 .../tests/Feature/IncludesFacadeTest.php      | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 137824e3be0..6019ffdf528 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -191,4 +191,37 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $this->file('resources/includes/advanced.md', $markdown);
         $this->assertSame($expected, Includes::markdown('advanced.md'));
     }
+
+    public function testAdvancedBladePartialIsCompiledToHtml()
+    {
+        $blade = <<<'BLADE'
+        <h1>Heading</h1>
+        @foreach(range(1, 3) as $i)
+            <p>Paragraph {{ $i }}</p>
+        @endforeach
+
+        @include('hyde::components.link')
+        
+        {{-- This is a comment --}}
+
+        @php($foo = 'bar')
+
+        {{ 'foo' . $foo }}
+        BLADE;
+
+        $expected = <<<'HTML'
+        <h1>Heading</h1>
+            <p>Paragraph 1</p>
+            <p>Paragraph 2</p>
+            <p>Paragraph 3</p>
+        
+        
+        
+        
+        foobar
+        HTML;
+
+        $this->file('resources/includes/advanced.blade.php', $blade);
+        $this->assertSame($expected, Includes::blade('advanced.blade.php'));
+    }
 }

From 0127802f7e533a3c9eefb85648584a2e14f3d0cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:32:50 +0200
Subject: [PATCH 2029/4023] Remove link include requiring more setup

---
 packages/framework/tests/Feature/IncludesFacadeTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 6019ffdf528..87c8dd908f1 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -200,8 +200,6 @@ public function testAdvancedBladePartialIsCompiledToHtml()
             <p>Paragraph {{ $i }}</p>
         @endforeach
 
-        @include('hyde::components.link')
-        
         {{-- This is a comment --}}
 
         @php($foo = 'bar')

From 1d25d0100d1513b9a896a189821f797546fe9a95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:34:03 +0200
Subject: [PATCH 2030/4023] Clean up whitespace

---
 .../framework/tests/Feature/IncludesFacadeTest.php     | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 87c8dd908f1..8dd2594c9cb 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -199,12 +199,9 @@ public function testAdvancedBladePartialIsCompiledToHtml()
         @foreach(range(1, 3) as $i)
             <p>Paragraph {{ $i }}</p>
         @endforeach
-
         {{-- This is a comment --}}
-
         @php($foo = 'bar')
-
-        {{ 'foo' . $foo }}
+        {{ 'foo ' . $foo }}
         BLADE;
 
         $expected = <<<'HTML'
@@ -213,10 +210,7 @@ public function testAdvancedBladePartialIsCompiledToHtml()
             <p>Paragraph 2</p>
             <p>Paragraph 3</p>
         
-        
-        
-        
-        foobar
+        foo bar
         HTML;
 
         $this->file('resources/includes/advanced.blade.php', $blade);

From ffc8e7d42353989762fd22e2366eb536ff0c1c72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:43:31 +0200
Subject: [PATCH 2031/4023] Test includes usage from Blade view

Emulates the actual usage of the Includes facade from a Blade view
---
 .../tests/Feature/IncludesFacadeTest.php      | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 8dd2594c9cb..66be0e393e3 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -8,6 +8,7 @@
 use Hyde\Support\Includes;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Facades\Blade;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -216,4 +217,28 @@ public function testAdvancedBladePartialIsCompiledToHtml()
         $this->file('resources/includes/advanced.blade.php', $blade);
         $this->assertSame($expected, Includes::blade('advanced.blade.php'));
     }
+
+    public function testIncludesUsageFromBladeView()
+    {
+        // Emulates the actual usage of the Includes facade from a Blade view.
+
+        $this->file('resources/includes/foo.blade.php', '{{ "foo bar" }}');
+        $this->file('resources/includes/foo.md', '# foo bar');
+        $this->file('resources/includes/foo.html', '<h1>foo bar</h1>');
+
+        $view = <<<'BLADE'
+        {!! Includes::blade('foo.blade.php') !!}
+        {!! Includes::markdown('foo.md') !!}
+        {!! Includes::html('foo.html') !!}
+        BLADE;
+
+        $expected = <<<'HTML'
+        foo bar
+        <h1>foo bar</h1>
+
+        <h1>foo bar</h1>
+        HTML;
+
+        $this->assertSame($expected, Blade::render($view));
+    }
 }

From b64292050aa1dafe30ee69351a8a9bbfd74d2332 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:46:20 +0200
Subject: [PATCH 2032/4023] Test without extensions

---
 .../framework/tests/Feature/IncludesFacadeTest.php  | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 66be0e393e3..5c2d60367c3 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -227,15 +227,28 @@ public function testIncludesUsageFromBladeView()
         $this->file('resources/includes/foo.html', '<h1>foo bar</h1>');
 
         $view = <<<'BLADE'
+        // With extension
         {!! Includes::blade('foo.blade.php') !!}
         {!! Includes::markdown('foo.md') !!}
         {!! Includes::html('foo.html') !!}
+        
+        // Without extension
+        {!! Includes::blade('foo') !!}
+        {!! Includes::markdown('foo') !!}
+        {!! Includes::html('foo') !!}
         BLADE;
 
         $expected = <<<'HTML'
+        // With extension
         foo bar
         <h1>foo bar</h1>
 
+        <h1>foo bar</h1>
+
+        // Without extension
+        foo bar
+        <h1>foo bar</h1>
+        
         <h1>foo bar</h1>
         HTML;
 

From f6d975564bebf74bd29590eef7fb014c155ff8b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:47:10 +0200
Subject: [PATCH 2033/4023] Add element to match others

---
 packages/framework/tests/Feature/IncludesFacadeTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 5c2d60367c3..c93d1d427e1 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -222,7 +222,7 @@ public function testIncludesUsageFromBladeView()
     {
         // Emulates the actual usage of the Includes facade from a Blade view.
 
-        $this->file('resources/includes/foo.blade.php', '{{ "foo bar" }}');
+        $this->file('resources/includes/foo.blade.php', '<h1>{{ "foo bar" }}</h1>');
         $this->file('resources/includes/foo.md', '# foo bar');
         $this->file('resources/includes/foo.html', '<h1>foo bar</h1>');
 
@@ -240,13 +240,13 @@ public function testIncludesUsageFromBladeView()
 
         $expected = <<<'HTML'
         // With extension
-        foo bar
+        <h1>foo bar</h1>
         <h1>foo bar</h1>
 
         <h1>foo bar</h1>
 
         // Without extension
-        foo bar
+        <h1>foo bar</h1>
         <h1>foo bar</h1>
         
         <h1>foo bar</h1>

From b207e9b79b3ac849d7432fac167af503c4def647 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:48:06 +0200
Subject: [PATCH 2034/4023] Clarify the test data

---
 .../tests/Feature/IncludesFacadeTest.php      | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index c93d1d427e1..c2300c32520 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -222,9 +222,9 @@ public function testIncludesUsageFromBladeView()
     {
         // Emulates the actual usage of the Includes facade from a Blade view.
 
-        $this->file('resources/includes/foo.blade.php', '<h1>{{ "foo bar" }}</h1>');
-        $this->file('resources/includes/foo.md', '# foo bar');
-        $this->file('resources/includes/foo.html', '<h1>foo bar</h1>');
+        $this->file('resources/includes/foo.blade.php', '<h1>{{ "Rendered Blade" }}</h1>');
+        $this->file('resources/includes/foo.md', '# Compiled Markdown');
+        $this->file('resources/includes/foo.html', '<h1>Literal HTML</h1>');
 
         $view = <<<'BLADE'
         // With extension
@@ -240,16 +240,16 @@ public function testIncludesUsageFromBladeView()
 
         $expected = <<<'HTML'
         // With extension
-        <h1>foo bar</h1>
-        <h1>foo bar</h1>
+        <h1>Rendered Blade</h1>
+        <h1>Compiled Markdown</h1>
 
-        <h1>foo bar</h1>
+        <h1>Literal HTML</h1>
 
         // Without extension
-        <h1>foo bar</h1>
-        <h1>foo bar</h1>
-        
-        <h1>foo bar</h1>
+        <h1>Rendered Blade</h1>
+        <h1>Compiled Markdown</h1>
+
+        <h1>Literal HTML</h1>
         HTML;
 
         $this->assertSame($expected, Blade::render($view));

From 2d8a349ce729d54307ef6cbb9cb0673bc23c473e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:49:28 +0200
Subject: [PATCH 2035/4023] Reorder lines

---
 .../framework/tests/Feature/IncludesFacadeTest.php     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index c2300c32520..4b2a1426a2f 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -223,33 +223,33 @@ public function testIncludesUsageFromBladeView()
         // Emulates the actual usage of the Includes facade from a Blade view.
 
         $this->file('resources/includes/foo.blade.php', '<h1>{{ "Rendered Blade" }}</h1>');
-        $this->file('resources/includes/foo.md', '# Compiled Markdown');
         $this->file('resources/includes/foo.html', '<h1>Literal HTML</h1>');
+        $this->file('resources/includes/foo.md', '# Compiled Markdown');
 
         $view = <<<'BLADE'
         // With extension
+        {!! Includes::html('foo.html') !!}
         {!! Includes::blade('foo.blade.php') !!}
         {!! Includes::markdown('foo.md') !!}
-        {!! Includes::html('foo.html') !!}
         
         // Without extension
+        {!! Includes::html('foo') !!}
         {!! Includes::blade('foo') !!}
         {!! Includes::markdown('foo') !!}
-        {!! Includes::html('foo') !!}
         BLADE;
 
         $expected = <<<'HTML'
         // With extension
+        <h1>Literal HTML</h1>
         <h1>Rendered Blade</h1>
         <h1>Compiled Markdown</h1>
 
-        <h1>Literal HTML</h1>
 
         // Without extension
+        <h1>Literal HTML</h1>
         <h1>Rendered Blade</h1>
         <h1>Compiled Markdown</h1>
 
-        <h1>Literal HTML</h1>
         HTML;
 
         $this->assertSame($expected, Blade::render($view));

From 1365f1c7622b551c600301434010b77aac94c79b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:51:17 +0200
Subject: [PATCH 2036/4023] Document the associated PR

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 65127708ac2..3618c72eb0e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -29,7 +29,7 @@ This serves two purposes:
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
 - Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
 - Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
-- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels.
+- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in https://github.com/hydephp/develop/pull/1738
 
 ### Deprecated
 - for soon-to-be removed features.

From 9cc70f67766e4dddd88c5f30a22dd599136f8497 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 19:53:09 +0200
Subject: [PATCH 2037/4023] Trim trailing whitespace from included Markdown

To normalize with the Blade and Html includes
---
 RELEASE_NOTES.md                                         | 1 +
 packages/framework/src/Support/Includes.php              | 5 +++--
 packages/framework/tests/Feature/IncludesFacadeTest.php  | 9 +++------
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 6 +++---
 4 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3618c72eb0e..6e13734032e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -30,6 +30,7 @@ This serves two purposes:
 - Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
 - Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
 - Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in https://github.com/hydephp/develop/pull/1738
+- Markdown returned from includes are now trimmed of trailing whitespace and newlines in https://github.com/hydephp/develop/pull/1738
 
 ### Deprecated
 - for soon-to-be removed features.
diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 6433d7561c5..a032e9ab2dd 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -10,6 +10,7 @@
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
 
+use function trim;
 use function basename;
 
 /**
@@ -85,10 +86,10 @@ public static function markdown(string $filename, ?string $default = null): ?str
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : Markdown::render($default, MarkdownDocument::class);
+            return $default === null ? null : trim(Markdown::render($default, MarkdownDocument::class));
         }
 
-        return Markdown::render(Filesystem::get($path), MarkdownDocument::class);
+        return trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class));
     }
 
     /**
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 4b2a1426a2f..13f2dbf89d7 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -77,7 +77,7 @@ public function testHtmlWithAndWithoutExtension()
 
     public function testMarkdownReturnsRenderedPartial()
     {
-        $expected = "<h1>foo bar</h1>\n";
+        $expected = '<h1>foo bar</h1>';
         file_put_contents(Hyde::path('resources/includes/foo.md'), '# foo bar');
         $this->assertSame($expected, Includes::markdown('foo.md'));
         Filesystem::unlink('resources/includes/foo.md');
@@ -86,7 +86,7 @@ public function testMarkdownReturnsRenderedPartial()
     public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
     {
         $this->assertNull(Includes::markdown('foo.md'));
-        $this->assertSame("<h1>default</h1>\n", Includes::markdown('foo.md', '# default'));
+        $this->assertSame('<h1>default</h1>', Includes::markdown('foo.md', '# default'));
     }
 
     public function testMarkdownWithAndWithoutExtension()
@@ -122,7 +122,7 @@ public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
         $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
 
         $this->assertSame(
-            "<p>Syntax highlighted by torchlight.dev</p>\n",
+            '<p>Syntax highlighted by torchlight.dev</p>',
             Includes::markdown('without-torchlight.md')
         );
     }
@@ -186,7 +186,6 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         </tr>
         </tbody>
         </table>
-
         HTML;
 
         $this->file('resources/includes/advanced.md', $markdown);
@@ -244,12 +243,10 @@ public function testIncludesUsageFromBladeView()
         <h1>Rendered Blade</h1>
         <h1>Compiled Markdown</h1>
 
-
         // Without extension
         <h1>Literal HTML</h1>
         <h1>Rendered Blade</h1>
         <h1>Compiled Markdown</h1>
-
         HTML;
 
         $this->assertSame($expected, Blade::render($view));
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index d7eeb8f9269..7abd16eb9a4 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -114,7 +114,7 @@ public function testHtmlWithAndWithoutExtension()
     public function testMarkdownReturnsRenderedPartial()
     {
         $filename = 'foo.md';
-        $expected = "<h1>foo bar</h1>\n";
+        $expected = '<h1>foo bar</h1>';
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
             $content = '# foo bar';
@@ -130,7 +130,7 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
     {
         $filename = 'foo.md';
         $default = '# default';
-        $expected = "<h1>default</h1>\n";
+        $expected = '<h1>default</h1>';
 
         $this->mockFilesystem(function ($filesystem) use ($filename) {
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
@@ -142,7 +142,7 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
 
     public function testMarkdownWithAndWithoutExtension()
     {
-        $expected = "<h1>foo bar</h1>\n";
+        $expected = '<h1>foo bar</h1>';
 
         $this->mockFilesystem(function ($filesystem) {
             $content = '# foo bar';

From eeb1fe49171c48048575922287275bfc3085884d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:00:24 +0200
Subject: [PATCH 2038/4023] Clarify how the test works

---
 .../framework/tests/Feature/IncludesFacadeTest.php  | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 13f2dbf89d7..99a5d1adfbf 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -119,12 +119,15 @@ public function testBladeReturnsRenderedDefaultValueWhenNotFound()
 
     public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
     {
-        $this->file('resources/includes/without-torchlight.md', 'Syntax highlighted by torchlight.dev');
+        $placeholder = 'Syntax highlighted by torchlight.dev';
+        $this->file('resources/includes/without-torchlight.md', $placeholder);
 
-        $this->assertSame(
-            '<p>Syntax highlighted by torchlight.dev</p>',
-            Includes::markdown('without-torchlight.md')
-        );
+        $rendered = Includes::markdown('without-torchlight.md');
+
+        $attribution = 'Syntax highlighting by <a href="https://torchlight.dev/" rel="noopener nofollow">Torchlight.dev</a>';
+
+        $this->assertStringNotContainsString($attribution, $rendered);
+        $this->assertSame("<p>$placeholder</p>", $rendered);
     }
 
     public function testAdvancedMarkdownDocumentIsCompiledToHtml()

From e9b877ae77e57d3e7e0a24903b3da76c6ae28028 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:02:41 +0200
Subject: [PATCH 2039/4023] Add cases for the current escape state

---
 .../framework/tests/Feature/IncludesFacadeTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 99a5d1adfbf..860467c5656 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -238,6 +238,11 @@ public function testIncludesUsageFromBladeView()
         {!! Includes::html('foo') !!}
         {!! Includes::blade('foo') !!}
         {!! Includes::markdown('foo') !!}
+        
+        // With escaped
+        {{ Includes::html('foo.html') }}
+        {{ Includes::blade('foo.blade.php') }}
+        {{ Includes::markdown('foo.md') }}
         BLADE;
 
         $expected = <<<'HTML'
@@ -250,6 +255,11 @@ public function testIncludesUsageFromBladeView()
         <h1>Literal HTML</h1>
         <h1>Rendered Blade</h1>
         <h1>Compiled Markdown</h1>
+
+        // With escaped
+        &lt;h1&gt;Literal HTML&lt;/h1&gt;
+        &lt;h1&gt;Rendered Blade&lt;/h1&gt;
+        &lt;h1&gt;Compiled Markdown&lt;/h1&gt;
         HTML;
 
         $this->assertSame($expected, Blade::render($view));

From 6f656e4379e3a4b01e19d35f7b501b15320cf437 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:24:27 +0200
Subject: [PATCH 2040/4023] Extra comment clarification

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index a032e9ab2dd..6e88fb4506f 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -43,7 +43,7 @@ public static function path(?string $filename = null): string
      *
      * @param  string  $filename  The name of the partial file, including the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
-     * @return string|null The contents of the partial file, or the default value if not found.
+     * @return string|null The raw contents of the partial file, or the default value if not found.
      */
     public static function get(string $filename, ?string $default = null): ?string
     {

From cc3317414ed261237582546cdb9c3703ba6a74d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:43:58 +0200
Subject: [PATCH 2041/4023] Update `Includes` helpers to return `HtmlString`
 objects

Fixes https://github.com/hydephp/develop/issues/1734
---
 RELEASE_NOTES.md                              | 20 ++++++++++
 docs/digging-deeper/helpers.md                | 10 ++++-
 packages/framework/src/Support/Includes.php   | 25 ++++++------
 .../tests/Feature/IncludesFacadeTest.php      | 39 +++++++++++--------
 .../tests/Unit/IncludesFacadeUnitTest.php     | 29 ++++++++------
 5 files changed, 83 insertions(+), 40 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 6e13734032e..c37997d25b4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -24,6 +24,7 @@ This serves two purposes:
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
 - Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
+- Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
@@ -223,6 +224,25 @@ For example, if you triggered the media transfer with a build service method cal
 (new TransferMediaAssets())->run();
 ```
 
+### Includes facade changes
+
+The following methods in the `Includes` facade now return `HtmlString` objects instead of `string`:
+
+- `Includes::html()`
+- `Includes::blade()`
+- `Includes::markdown()`
+
+- This means that you no longer need to use `{!! !!}` to render the output of these methods in Blade templates, instead just use `{{ }}`.
+- If you have used the return value of these methods in custom code, you may need to adjust your code to work with the new return type.
+
+For more information, see the RFC that proposed this change: https://github.com/hydephp/develop/issues/1734
+The RFC was implemented in https://github.com/hydephp/develop/pull/1738
+
+#### Remember to escape output if necessary
+
+**Note:** Remember that this means that includes are **no longer escaped** by default, so make sure to escape the output if necessary, for example if the content is user-generated.
+- (Use `{{ e(Includes::html('foo')) }}` instead of `{{ Includes::html('foo') }}` to escape the output, matching the previous behavior.)
+
 ### DataCollection API changes
 
 The DataCollection feature has been reworked to improve the developer experience and make it more consistent with the rest of the API.
diff --git a/docs/digging-deeper/helpers.md b/docs/digging-deeper/helpers.md
index 6414fba758a..8cde4e71f1d 100644
--- a/docs/digging-deeper/helpers.md
+++ b/docs/digging-deeper/helpers.md
@@ -73,7 +73,15 @@ Includes::markdown('example') === Includes::markdown('example.md');
 
 All methods will return `null` if the file does not exist.
 However, you can supply a default value as the second argument to be used instead.
-Remember that Markdown and Blade defaults will still be rendered to HTML.
+Remember that Markdown and Blade defaults will also be rendered to HTML.
+
+Includes are particularly useful in Blade views, as you can echo them directly. You do not need to import the namespace, as it is already aliased.
+
+```blade
+<footer>
+    {{ Includes::markdown('footer.md') }}
+</footer>
+```
 
 ```php
 use Hyde\Support\Includes;
diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 6e88fb4506f..182ce218c7b 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Filesystem;
+use Illuminate\Support\HtmlString;
 use Hyde\Markdown\Models\MarkdownDocument;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Facades\Blade;
@@ -61,17 +62,17 @@ public static function get(string $filename, ?string $default = null): ?string
      *
      * @param  string  $filename  The name of the partial file, with or without the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
-     * @return string|null The raw contents of the partial file, or the default value if not found.
+     * @return HtmlString|null The contents of the partial file, or the default value if not found.
      */
-    public static function html(string $filename, ?string $default = null): ?string
+    public static function html(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.html');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : $default;
+            return $default === null ? null : new HtmlString($default);
         }
 
-        return Filesystem::get($path);
+        return new HtmlString(Filesystem::get($path));
     }
 
     /**
@@ -79,17 +80,17 @@ public static function html(string $filename, ?string $default = null): ?string
      *
      * @param  string  $filename  The name of the partial file, with or without the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
-     * @return string|null The rendered contents of the partial file, or the default value if not found.
+     * @return HtmlString|null The rendered contents of the partial file, or the default value if not found.
      */
-    public static function markdown(string $filename, ?string $default = null): ?string
+    public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : trim(Markdown::render($default, MarkdownDocument::class));
+            return $default === null ? null : new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
         }
 
-        return trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class));
+        return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));
     }
 
     /**
@@ -97,17 +98,17 @@ public static function markdown(string $filename, ?string $default = null): ?str
      *
      * @param  string  $filename  The name of the partial file, with or without the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
-     * @return string|null The rendered contents of the partial file, or the default value if not found.
+     * @return HtmlString|null The rendered contents of the partial file, or the default value if not found.
      */
-    public static function blade(string $filename, ?string $default = null): ?string
+    public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.blade.php');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : Blade::render($default);
+            return $default === null ? null : new HtmlString(Blade::render($default));
         }
 
-        return Blade::render(Filesystem::get($path));
+        return new HtmlString(Blade::render(Filesystem::get($path)));
     }
 
     protected static function normalizePath(string $filename, string $extension): string
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 860467c5656..92ccdd2cb9a 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -8,6 +8,7 @@
 use Hyde\Support\Includes;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\HtmlString;
 use Illuminate\Support\Facades\Blade;
 
 /**
@@ -58,20 +59,20 @@ public function testHtmlReturnsRenderedPartial()
     {
         $expected = '<h1>foo bar</h1>';
         file_put_contents(Hyde::path('resources/includes/foo.html'), '<h1>foo bar</h1>');
-        $this->assertSame($expected, Includes::html('foo.html'));
+        $this->assertHtmlStringIsSame($expected, Includes::html('foo.html'));
         Filesystem::unlink('resources/includes/foo.html');
     }
 
     public function testHtmlReturnsEfaultValueWhenNotFound()
     {
         $this->assertNull(Includes::html('foo.html'));
-        $this->assertSame('<h1>default</h1>', Includes::html('foo.html', '<h1>default</h1>'));
+        $this->assertHtmlStringIsSame('<h1>default</h1>', Includes::html('foo.html', '<h1>default</h1>'));
     }
 
     public function testHtmlWithAndWithoutExtension()
     {
         file_put_contents(Hyde::path('resources/includes/foo.html'), '# foo bar');
-        $this->assertSame(Includes::html('foo.html'), Includes::html('foo'));
+        $this->assertHtmlStringIsSame(Includes::html('foo.html'), Includes::html('foo'));
         Filesystem::unlink('resources/includes/foo.html');
     }
 
@@ -79,20 +80,20 @@ public function testMarkdownReturnsRenderedPartial()
     {
         $expected = '<h1>foo bar</h1>';
         file_put_contents(Hyde::path('resources/includes/foo.md'), '# foo bar');
-        $this->assertSame($expected, Includes::markdown('foo.md'));
+        $this->assertHtmlStringIsSame($expected, Includes::markdown('foo.md'));
         Filesystem::unlink('resources/includes/foo.md');
     }
 
     public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
     {
         $this->assertNull(Includes::markdown('foo.md'));
-        $this->assertSame('<h1>default</h1>', Includes::markdown('foo.md', '# default'));
+        $this->assertHtmlStringIsSame('<h1>default</h1>', Includes::markdown('foo.md', '# default'));
     }
 
     public function testMarkdownWithAndWithoutExtension()
     {
         file_put_contents(Hyde::path('resources/includes/foo.md'), '# foo bar');
-        $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
+        $this->assertHtmlStringIsSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
         Filesystem::unlink('resources/includes/foo.md');
     }
 
@@ -100,21 +101,21 @@ public function testBladeReturnsRenderedPartial()
     {
         $expected = 'foo bar';
         file_put_contents(Hyde::path('resources/includes/foo.blade.php'), '{{ "foo bar" }}');
-        $this->assertSame($expected, Includes::blade('foo.blade.php'));
+        $this->assertHtmlStringIsSame($expected, Includes::blade('foo.blade.php'));
         Filesystem::unlink('resources/includes/foo.blade.php');
     }
 
     public function testBladeWithAndWithoutExtension()
     {
         file_put_contents(Hyde::path('resources/includes/foo.blade.php'), '# foo bar');
-        $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
+        $this->assertHtmlStringIsSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
         Filesystem::unlink('resources/includes/foo.blade.php');
     }
 
     public function testBladeReturnsRenderedDefaultValueWhenNotFound()
     {
         $this->assertNull(Includes::blade('foo.blade.php'));
-        $this->assertSame('default', Includes::blade('foo.blade.php', '{{ "default" }}'));
+        $this->assertHtmlStringIsSame('default', Includes::blade('foo.blade.php', '{{ "default" }}'));
     }
 
     public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
@@ -126,8 +127,8 @@ public function testTorchlightAttributionIsNotInjectedToMarkdownPartials()
 
         $attribution = 'Syntax highlighting by <a href="https://torchlight.dev/" rel="noopener nofollow">Torchlight.dev</a>';
 
-        $this->assertStringNotContainsString($attribution, $rendered);
-        $this->assertSame("<p>$placeholder</p>", $rendered);
+        $this->assertStringNotContainsString($attribution, $rendered->toHtml());
+        $this->assertHtmlStringIsSame("<p>$placeholder</p>", $rendered);
     }
 
     public function testAdvancedMarkdownDocumentIsCompiledToHtml()
@@ -192,7 +193,7 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         HTML;
 
         $this->file('resources/includes/advanced.md', $markdown);
-        $this->assertSame($expected, Includes::markdown('advanced.md'));
+        $this->assertHtmlStringIsSame($expected, Includes::markdown('advanced.md'));
     }
 
     public function testAdvancedBladePartialIsCompiledToHtml()
@@ -217,7 +218,7 @@ public function testAdvancedBladePartialIsCompiledToHtml()
         HTML;
 
         $this->file('resources/includes/advanced.blade.php', $blade);
-        $this->assertSame($expected, Includes::blade('advanced.blade.php'));
+        $this->assertHtmlStringIsSame($expected, Includes::blade('advanced.blade.php'));
     }
 
     public function testIncludesUsageFromBladeView()
@@ -257,11 +258,17 @@ public function testIncludesUsageFromBladeView()
         <h1>Compiled Markdown</h1>
 
         // With escaped
-        &lt;h1&gt;Literal HTML&lt;/h1&gt;
-        &lt;h1&gt;Rendered Blade&lt;/h1&gt;
-        &lt;h1&gt;Compiled Markdown&lt;/h1&gt;
+        <h1>Literal HTML</h1>
+        <h1>Rendered Blade</h1>
+        <h1>Compiled Markdown</h1>
         HTML;
 
         $this->assertSame($expected, Blade::render($view));
     }
+
+    protected function assertHtmlStringIsSame(string|HtmlString $expected, mixed $actual): void
+    {
+        $this->assertInstanceOf(HtmlString::class, $actual);
+        $this->assertSame((string) $expected, $actual->toHtml());
+    }
 }
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 7abd16eb9a4..dfd6c1b8a12 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,6 +9,7 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\HtmlString;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 
@@ -82,7 +83,7 @@ public function testHtmlReturnsRenderedPartial()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($expected);
         });
 
-        $this->assertSame($expected, Includes::html($filename));
+        $this->assertHtmlStringIsSame($expected, Includes::html($filename));
     }
 
     public function testHtmlReturnsDefaultValueWhenNotFound()
@@ -95,7 +96,7 @@ public function testHtmlReturnsDefaultValueWhenNotFound()
         });
 
         $this->assertNull(Includes::html($filename));
-        $this->assertSame($default, Includes::html($filename, $default));
+        $this->assertHtmlStringIsSame($default, Includes::html($filename, $default));
     }
 
     public function testHtmlWithAndWithoutExtension()
@@ -108,7 +109,7 @@ public function testHtmlWithAndWithoutExtension()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
-        $this->assertSame(Includes::html('foo.html'), Includes::html('foo'));
+        $this->assertHtmlStringIsSame(Includes::html('foo.html'), Includes::html('foo'));
     }
 
     public function testMarkdownReturnsRenderedPartial()
@@ -123,7 +124,7 @@ public function testMarkdownReturnsRenderedPartial()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
-        $this->assertSame($expected, Includes::markdown($filename));
+        $this->assertHtmlStringIsSame($expected, Includes::markdown($filename));
     }
 
     public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
@@ -137,7 +138,7 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
         });
 
         $this->assertNull(Includes::markdown($filename));
-        $this->assertSame($expected, Includes::markdown($filename, $default));
+        $this->assertHtmlStringIsSame($expected, Includes::markdown($filename, $default));
     }
 
     public function testMarkdownWithAndWithoutExtension()
@@ -152,9 +153,9 @@ public function testMarkdownWithAndWithoutExtension()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
-        $this->assertSame($expected, Includes::markdown('foo.md'));
-        $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
-        $this->assertSame(Includes::markdown('foo.md'), Includes::markdown('foo.md'));
+        $this->assertHtmlStringIsSame($expected, Includes::markdown('foo.md'));
+        $this->assertHtmlStringIsSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
+        $this->assertHtmlStringIsSame(Includes::markdown('foo.md'), Includes::markdown('foo.md'));
     }
 
     public function testBladeReturnsRenderedPartial()
@@ -171,7 +172,7 @@ public function testBladeReturnsRenderedPartial()
             Blade::shouldReceive('render')->with($content)->andReturn($expected);
         });
 
-        $this->assertSame($expected, Includes::blade($filename));
+        $this->assertHtmlStringIsSame($expected, Includes::blade($filename));
     }
 
     public function testBladeWithAndWithoutExtension()
@@ -187,7 +188,7 @@ public function testBladeWithAndWithoutExtension()
             Blade::shouldReceive('render')->with($content)->andReturn($expected);
         });
 
-        $this->assertSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
+        $this->assertHtmlStringIsSame(Includes::blade('foo.blade.php'), Includes::blade('foo'));
     }
 
     public function testBladeReturnsDefaultValueWhenNotFound()
@@ -203,7 +204,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
         });
 
         $this->assertNull(Includes::blade($filename));
-        $this->assertSame($expected, Includes::blade($filename, $default));
+        $this->assertHtmlStringIsSame($expected, Includes::blade($filename, $default));
     }
 
     protected function mockFilesystem(Closure $config): void
@@ -219,4 +220,10 @@ protected function includesPath(string $filename): string
     {
         return Hyde::path('resources/includes/'.$filename);
     }
+
+    protected function assertHtmlStringIsSame(string|HtmlString $expected, mixed $actual): void
+    {
+        $this->assertInstanceOf(HtmlString::class, $actual);
+        $this->assertSame((string) $expected, $actual->toHtml());
+    }
 }

From c527e9781f82a4057a50965899de2f2298cde2ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:49:38 +0200
Subject: [PATCH 2042/4023] Replace ternary expression with if/else block

---
 packages/framework/src/Support/Includes.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 182ce218c7b..824e1ae3382 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,7 +87,11 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
+            if ($default === null) {
+                return null;
+            } else {
+                return new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
+            }
         }
 
         return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));

From 4d44b834f9a11b699a6c0b0f70bd9c5d5fa921c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:49:49 +0200
Subject: [PATCH 2043/4023] Introduce local variables

---
 packages/framework/src/Support/Includes.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 824e1ae3382..f667c2968b4 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -90,11 +90,13 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             if ($default === null) {
                 return null;
             } else {
-                return new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
+                $markdown = $default;
+                return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
             }
         }
 
-        return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));
+        $markdown = Filesystem::get($path);
+        return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
     }
 
     /**

From 2282b8e78282f1e7fdf1d2cb10544d39c7256a8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:50:09 +0200
Subject: [PATCH 2044/4023] Wrap declaration in else block

---
 packages/framework/src/Support/Includes.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f667c2968b4..568df93c298 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -93,9 +93,10 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
                 $markdown = $default;
                 return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
             }
+        } else {
+            $markdown = Filesystem::get($path);
         }
 
-        $markdown = Filesystem::get($path);
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
     }
 

From 1e1520a06334d273ffde7733c248272caedf482e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:50:33 +0200
Subject: [PATCH 2045/4023] Unwrap common parts of if/else block

---
 packages/framework/src/Support/Includes.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 568df93c298..8ca693185d6 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -91,7 +91,6 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
                 return null;
             } else {
                 $markdown = $default;
-                return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
             }
         } else {
             $markdown = Filesystem::get($path);

From 370524a5101248cc24e5e861b70eca50420a8694 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:50:52 +0200
Subject: [PATCH 2046/4023] Unwrap 'else'

---
 packages/framework/src/Support/Includes.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 8ca693185d6..bb9ce3b6368 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -89,9 +89,9 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         if (! Filesystem::exists($path)) {
             if ($default === null) {
                 return null;
-            } else {
-                $markdown = $default;
             }
+
+            $markdown = $default;
         } else {
             $markdown = Filesystem::get($path);
         }

From 667f7d9b103b0ec61ad33bff7825d4ff4a8895f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:52:13 +0200
Subject: [PATCH 2047/4023] Invert control flow to simply conditional paths

---
 packages/framework/src/Support/Includes.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index bb9ce3b6368..82e3cbc571a 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -86,14 +86,13 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
     {
         $path = static::normalizePath($filename, '.md');
 
-        if (! Filesystem::exists($path)) {
+        if (Filesystem::exists($path)) {
+            $markdown = Filesystem::get($path);
+        } else {
             if ($default === null) {
                 return null;
             }
-
             $markdown = $default;
-        } else {
-            $markdown = Filesystem::get($path);
         }
 
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));

From 6cd529fabbfdd1bcd6c0bb91206825f9b5286d22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:53:32 +0200
Subject: [PATCH 2048/4023] Move out return from condition

---
 packages/framework/src/Support/Includes.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 82e3cbc571a..904f941b737 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -90,9 +90,14 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             $markdown = Filesystem::get($path);
         } else {
             if ($default === null) {
-                return null;
+                $markdown = null;
+            } else {
+                $markdown = $default;
             }
-            $markdown = $default;
+        }
+
+        if ($markdown === null) {
+            return null;
         }
 
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));

From 130dd77e7661e2d7bed3e8d35c26f0042d7857e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:53:47 +0200
Subject: [PATCH 2049/4023] Merge into 'elseif'

---
 packages/framework/src/Support/Includes.php | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 904f941b737..9dcea75e042 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -88,12 +88,10 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
 
         if (Filesystem::exists($path)) {
             $markdown = Filesystem::get($path);
+        } elseif ($default === null) {
+            $markdown = null;
         } else {
-            if ($default === null) {
-                $markdown = null;
-            } else {
-                $markdown = $default;
-            }
+            $markdown = $default;
         }
 
         if ($markdown === null) {

From d0d67093237ac5fef32a794aaaf99f6e6929c264 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:35 +0200
Subject: [PATCH 2050/4023] Revert "Merge into 'elseif'"

This reverts commit 130dd77e7661e2d7bed3e8d35c26f0042d7857e6.
---
 packages/framework/src/Support/Includes.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 9dcea75e042..904f941b737 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -88,10 +88,12 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
 
         if (Filesystem::exists($path)) {
             $markdown = Filesystem::get($path);
-        } elseif ($default === null) {
-            $markdown = null;
         } else {
-            $markdown = $default;
+            if ($default === null) {
+                $markdown = null;
+            } else {
+                $markdown = $default;
+            }
         }
 
         if ($markdown === null) {

From d248f04f3cdafd537a0a0e35d68f06e4a61df860 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:38 +0200
Subject: [PATCH 2051/4023] Revert "Move out return from condition"

This reverts commit 6cd529fabbfdd1bcd6c0bb91206825f9b5286d22.
---
 packages/framework/src/Support/Includes.php | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 904f941b737..82e3cbc571a 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -90,14 +90,9 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             $markdown = Filesystem::get($path);
         } else {
             if ($default === null) {
-                $markdown = null;
-            } else {
-                $markdown = $default;
+                return null;
             }
-        }
-
-        if ($markdown === null) {
-            return null;
+            $markdown = $default;
         }
 
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));

From dc7c75cbdec2fcc1b852f5a538973642805bb993 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:39 +0200
Subject: [PATCH 2052/4023] Revert "Invert control flow to simply conditional
 paths"

This reverts commit 667f7d9b103b0ec61ad33bff7825d4ff4a8895f9.
---
 packages/framework/src/Support/Includes.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 82e3cbc571a..bb9ce3b6368 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -86,13 +86,14 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
     {
         $path = static::normalizePath($filename, '.md');
 
-        if (Filesystem::exists($path)) {
-            $markdown = Filesystem::get($path);
-        } else {
+        if (! Filesystem::exists($path)) {
             if ($default === null) {
                 return null;
             }
+
             $markdown = $default;
+        } else {
+            $markdown = Filesystem::get($path);
         }
 
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));

From 012a91da8eeb312560aa94462b13aa8d890ebbec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:40 +0200
Subject: [PATCH 2053/4023] Revert "Unwrap 'else'"

This reverts commit 370524a5101248cc24e5e861b70eca50420a8694.
---
 packages/framework/src/Support/Includes.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index bb9ce3b6368..8ca693185d6 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -89,9 +89,9 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         if (! Filesystem::exists($path)) {
             if ($default === null) {
                 return null;
+            } else {
+                $markdown = $default;
             }
-
-            $markdown = $default;
         } else {
             $markdown = Filesystem::get($path);
         }

From de5131ec7ba0e94a2076f3f687b133e01e0f6f8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:40 +0200
Subject: [PATCH 2054/4023] Revert "Unwrap common parts of if/else block"

This reverts commit 1e1520a06334d273ffde7733c248272caedf482e.
---
 packages/framework/src/Support/Includes.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 8ca693185d6..568df93c298 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -91,6 +91,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
                 return null;
             } else {
                 $markdown = $default;
+                return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
             }
         } else {
             $markdown = Filesystem::get($path);

From 59448a6303036ef734a8821de0dfbd9ee508cc7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:41 +0200
Subject: [PATCH 2055/4023] Revert "Wrap declaration in else block"

This reverts commit 2282b8e78282f1e7fdf1d2cb10544d39c7256a8c.
---
 packages/framework/src/Support/Includes.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 568df93c298..f667c2968b4 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -93,10 +93,9 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
                 $markdown = $default;
                 return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
             }
-        } else {
-            $markdown = Filesystem::get($path);
         }
 
+        $markdown = Filesystem::get($path);
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
     }
 

From fc6460d2f4d5250c0cbdd16a11a896ee8dd400eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:55:41 +0200
Subject: [PATCH 2056/4023] Revert "Introduce local variables"

This reverts commit 4d44b834f9a11b699a6c0b0f70bd9c5d5fa921c6.
---
 packages/framework/src/Support/Includes.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f667c2968b4..824e1ae3382 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -90,13 +90,11 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             if ($default === null) {
                 return null;
             } else {
-                $markdown = $default;
-                return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
+                return new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
             }
         }
 
-        $markdown = Filesystem::get($path);
-        return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
+        return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));
     }
 
     /**

From 80e6e1efaa18d010da8c23cac68abe53eb7963b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:56:30 +0200
Subject: [PATCH 2057/4023] Revert "Replace ternary expression with if/else
 block"

This reverts commit c527e9781f82a4057a50965899de2f2298cde2ff.
---
 packages/framework/src/Support/Includes.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 824e1ae3382..182ce218c7b 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,11 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            if ($default === null) {
-                return null;
-            } else {
-                return new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
-            }
+            return $default === null ? null : new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
         }
 
         return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));

From 66ced70ae45e8a85d21e156f854b1cfb402c56ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:57:30 +0200
Subject: [PATCH 2058/4023] Extract helper method to render Markdown

---
 packages/framework/src/Support/Includes.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 182ce218c7b..67b6214d096 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,10 +87,10 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : new HtmlString(trim(Markdown::render($default, MarkdownDocument::class)));
+            return $default === null ? null : static::renderMarkdown($default);
         }
 
-        return new HtmlString(trim(Markdown::render(Filesystem::get($path), MarkdownDocument::class)));
+        return static::renderMarkdown(Filesystem::get($path));
     }
 
     /**
@@ -115,4 +115,9 @@ protected static function normalizePath(string $filename, string $extension): st
     {
         return static::path(basename($filename, $extension).$extension);
     }
+
+    protected static function renderMarkdown(string $markdown): HtmlString
+    {
+        return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
+    }
 }

From b9232620407ac079f06495dafdab307c24d0cf9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 20:59:51 +0200
Subject: [PATCH 2059/4023] Extract helper method to render Blade

---
 packages/framework/src/Support/Includes.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 67b6214d096..e2517e927f3 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -105,10 +105,10 @@ public static function blade(string $filename, ?string $default = null): ?HtmlSt
         $path = static::normalizePath($filename, '.blade.php');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : new HtmlString(Blade::render($default));
+            return $default === null ? null : static::renderBlade($default);
         }
 
-        return new HtmlString(Blade::render(Filesystem::get($path)));
+        return static::renderBlade(Filesystem::get($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string
@@ -120,4 +120,9 @@ protected static function renderMarkdown(string $markdown): HtmlString
     {
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
     }
+
+    protected static function renderBlade(string $blade): HtmlString
+    {
+        return new HtmlString(Blade::render($blade));
+    }
 }

From 8d7b1cbd3ba9acfd4cc41fe7050eef31fe5c1f19 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:00:48 +0200
Subject: [PATCH 2060/4023] Extract helper method to render Html

Literally just for matching the code style
---
 packages/framework/src/Support/Includes.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index e2517e927f3..75a039f7b35 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -69,10 +69,10 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
         $path = static::normalizePath($filename, '.html');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : new HtmlString($default);
+            return $default === null ? null : static::renderHtml($default);
         }
 
-        return new HtmlString(Filesystem::get($path));
+        return static::renderHtml(Filesystem::get($path));
     }
 
     /**
@@ -116,6 +116,11 @@ protected static function normalizePath(string $filename, string $extension): st
         return static::path(basename($filename, $extension).$extension);
     }
 
+    protected static function renderHtml(string $html): HtmlString
+    {
+        return new HtmlString($html);
+    }
+
     protected static function renderMarkdown(string $markdown): HtmlString
     {
         return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));

From 9038ab07872f8c0c805d1627f82dec64142fa266 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:02:30 +0200
Subject: [PATCH 2061/4023] Refactor control flow

---
 packages/framework/src/Support/Includes.php | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 75a039f7b35..7b52c92351c 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,10 +87,16 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            return $default === null ? null : static::renderMarkdown($default);
+            if ($default === null) {
+                return null;
+            } else {
+                $contents = null;
+            }
+        } else {
+            $contents = Filesystem::get($path);
         }
 
-        return static::renderMarkdown(Filesystem::get($path));
+        return static::renderMarkdown($contents ?? $default);
     }
 
     /**

From e120ba3bbf700564fdff354ef00ce0e590406294 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:02:42 +0200
Subject: [PATCH 2062/4023] Unwrap 'else'

---
 packages/framework/src/Support/Includes.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 7b52c92351c..4147b63e2f3 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -89,9 +89,8 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         if (! Filesystem::exists($path)) {
             if ($default === null) {
                 return null;
-            } else {
-                $contents = null;
             }
+            $contents = null;
         } else {
             $contents = Filesystem::get($path);
         }

From c0efe456469520d115555dbed69ba75af3aa5c98 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:04:30 +0200
Subject: [PATCH 2063/4023] Revert "Unwrap 'else'"

This reverts commit e120ba3bbf700564fdff354ef00ce0e590406294.
---
 packages/framework/src/Support/Includes.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 4147b63e2f3..7b52c92351c 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -89,8 +89,9 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         if (! Filesystem::exists($path)) {
             if ($default === null) {
                 return null;
+            } else {
+                $contents = null;
             }
-            $contents = null;
         } else {
             $contents = Filesystem::get($path);
         }

From 760af6bd9cf08de13e1b6af9dae49a510ebf46ad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:04:36 +0200
Subject: [PATCH 2064/4023] Revert "Refactor control flow"

This reverts commit 9038ab07872f8c0c805d1627f82dec64142fa266.
---
 packages/framework/src/Support/Includes.php | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 7b52c92351c..75a039f7b35 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,16 +87,10 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
 
         if (! Filesystem::exists($path)) {
-            if ($default === null) {
-                return null;
-            } else {
-                $contents = null;
-            }
-        } else {
-            $contents = Filesystem::get($path);
+            return $default === null ? null : static::renderMarkdown($default);
         }
 
-        return static::renderMarkdown($contents ?? $default);
+        return static::renderMarkdown(Filesystem::get($path));
     }
 
     /**

From ac255eea9a3b401c96a021a3a75333216d9f23ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:05:21 +0200
Subject: [PATCH 2065/4023] Extract helper to get file contents

---
 packages/framework/src/Support/Includes.php | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 75a039f7b35..917743f1e43 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -54,7 +54,7 @@ public static function get(string $filename, ?string $default = null): ?string
             return $default;
         }
 
-        return Filesystem::get($path);
+        return static::getFileContents($path);
     }
 
     /**
@@ -72,7 +72,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
             return $default === null ? null : static::renderHtml($default);
         }
 
-        return static::renderHtml(Filesystem::get($path));
+        return static::renderHtml(static::getFileContents($path));
     }
 
     /**
@@ -90,7 +90,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             return $default === null ? null : static::renderMarkdown($default);
         }
 
-        return static::renderMarkdown(Filesystem::get($path));
+        return static::renderMarkdown(static::getFileContents($path));
     }
 
     /**
@@ -108,7 +108,7 @@ public static function blade(string $filename, ?string $default = null): ?HtmlSt
             return $default === null ? null : static::renderBlade($default);
         }
 
-        return static::renderBlade(Filesystem::get($path));
+        return static::renderBlade(static::getFileContents($path));
     }
 
     protected static function normalizePath(string $filename, string $extension): string
@@ -130,4 +130,9 @@ protected static function renderBlade(string $blade): HtmlString
     {
         return new HtmlString(Blade::render($blade));
     }
+
+    protected static function getFileContents(string $path): string
+    {
+        return Filesystem::get($path);
+    }
 }

From 20f764a2551ee1d1a340eb995762b2f44ee717cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:05:57 +0200
Subject: [PATCH 2066/4023] Return null if file does not exist

---
 packages/framework/src/Support/Includes.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 917743f1e43..9706a49e593 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -131,8 +131,12 @@ protected static function renderBlade(string $blade): HtmlString
         return new HtmlString(Blade::render($blade));
     }
 
-    protected static function getFileContents(string $path): string
+    protected static function getFileContents(string $path): ?string
     {
+        if (! Filesystem::exists($path)) {
+            return null;
+        }
+
         return Filesystem::get($path);
     }
 }

From b1ad1fce1b5fc256a375a827328b970ac36e9b15 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:06:32 +0200
Subject: [PATCH 2067/4023] Introduce local variable

---
 packages/framework/src/Support/Includes.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 9706a49e593..76746e913f1 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -85,12 +85,13 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.md');
+        $contents = static::getFileContents($path);
 
         if (! Filesystem::exists($path)) {
             return $default === null ? null : static::renderMarkdown($default);
         }
 
-        return static::renderMarkdown(static::getFileContents($path));
+        return static::renderMarkdown($contents);
     }
 
     /**

From 4ac8f35074a2db92033ccae2c506a1234551ce1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:06:52 +0200
Subject: [PATCH 2068/4023] Check if contents is null

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 76746e913f1..f252c5f2eb8 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,7 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
         $contents = static::getFileContents($path);
 
-        if (! Filesystem::exists($path)) {
+        if ($contents === null) {
             return $default === null ? null : static::renderMarkdown($default);
         }
 

From 01d8833c23ab481d8f3b3ec7d4a0b9e2415a133c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:07:15 +0200
Subject: [PATCH 2069/4023] Replace ternary expression with if/else block

---
 packages/framework/src/Support/Includes.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f252c5f2eb8..34c8f5f4849 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -88,7 +88,11 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $contents = static::getFileContents($path);
 
         if ($contents === null) {
-            return $default === null ? null : static::renderMarkdown($default);
+            if ($default === null) {
+                return null;
+            } else {
+                return static::renderMarkdown($default);
+            }
         }
 
         return static::renderMarkdown($contents);

From 7eb2dab8920342e7e0341984f8badad211846a99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:07:34 +0200
Subject: [PATCH 2070/4023] Set contents to default

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 34c8f5f4849..ce7ac0d4a04 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -91,7 +91,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             if ($default === null) {
                 return null;
             } else {
-                return static::renderMarkdown($default);
+                $contents = $default;
             }
         }
 

From dae62babb92f64a6f71e5cd66472e042f7bb26c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:07:46 +0200
Subject: [PATCH 2071/4023] Unwrap 'else'

---
 packages/framework/src/Support/Includes.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index ce7ac0d4a04..593922ffb6c 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -90,9 +90,8 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         if ($contents === null) {
             if ($default === null) {
                 return null;
-            } else {
-                $contents = $default;
             }
+            $contents = $default;
         }
 
         return static::renderMarkdown($contents);

From a62671d6daff68eecdaa96b22fef3ad895092fcb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:08:20 +0200
Subject: [PATCH 2072/4023] Flatten nested conditions

---
 packages/framework/src/Support/Includes.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 593922ffb6c..5c7acb223b5 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,10 +87,11 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         $path = static::normalizePath($filename, '.md');
         $contents = static::getFileContents($path);
 
+        if ($contents === null && $default === null) {
+            return null;
+        }
+
         if ($contents === null) {
-            if ($default === null) {
-                return null;
-            }
             $contents = $default;
         }
 

From c2b9f6867658de7ed28b83392313e572a2788c5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:08:45 +0200
Subject: [PATCH 2073/4023] Null coalesce to default

---
 packages/framework/src/Support/Includes.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 5c7acb223b5..d7e5fc39778 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -91,11 +91,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
             return null;
         }
 
-        if ($contents === null) {
-            $contents = $default;
-        }
-
-        return static::renderMarkdown($contents);
+        return static::renderMarkdown($contents ?? $default);
     }
 
     /**

From dfdceb365baf32bb11f43d2f09a5c731e42f1c96 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:09:33 +0200
Subject: [PATCH 2074/4023] Inline local variable

---
 packages/framework/src/Support/Includes.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index d7e5fc39778..cfec1f9e12b 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -84,8 +84,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        $path = static::normalizePath($filename, '.md');
-        $contents = static::getFileContents($path);
+        $contents = static::getFileContents(static::normalizePath($filename, '.md'));
 
         if ($contents === null && $default === null) {
             return null;

From 0e6b17f2a2e869652e07b53e9566b5af907729b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:09:48 +0200
Subject: [PATCH 2075/4023] Revert "Inline local variable"

This reverts commit dfdceb365baf32bb11f43d2f09a5c731e42f1c96.
---
 packages/framework/src/Support/Includes.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index cfec1f9e12b..d7e5fc39778 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -84,7 +84,8 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        $contents = static::getFileContents(static::normalizePath($filename, '.md'));
+        $path = static::normalizePath($filename, '.md');
+        $contents = static::getFileContents($path);
 
         if ($contents === null && $default === null) {
             return null;

From 456bf344764f8bcb7ac0e26f7b34c74dadd5f454 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:10:50 +0200
Subject: [PATCH 2076/4023] Refactor other methods to use improved control flow

---
 packages/framework/src/Support/Includes.php | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index d7e5fc39778..30de07b015b 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -67,12 +67,13 @@ public static function get(string $filename, ?string $default = null): ?string
     public static function html(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.html');
+        $contents = static::getFileContents($path);
 
-        if (! Filesystem::exists($path)) {
-            return $default === null ? null : static::renderHtml($default);
+        if ($contents === null && $default === null) {
+            return null;
         }
 
-        return static::renderHtml(static::getFileContents($path));
+        return static::renderHtml($contents ?? $default);
     }
 
     /**
@@ -104,12 +105,13 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
     public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
         $path = static::normalizePath($filename, '.blade.php');
+        $contents = static::getFileContents($path);
 
-        if (! Filesystem::exists($path)) {
-            return $default === null ? null : static::renderBlade($default);
+        if ($contents === null && $default === null) {
+            return null;
         }
 
-        return static::renderBlade(static::getFileContents($path));
+        return static::renderBlade($contents ?? $default);
     }
 
     protected static function normalizePath(string $filename, string $extension): string

From acbe58b3b3873a1b9213250a897986ea6dde70cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:12:50 +0200
Subject: [PATCH 2077/4023] Extract helper method for shared code

---
 packages/framework/src/Support/Includes.php | 39 ++++++++-------------
 1 file changed, 15 insertions(+), 24 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 30de07b015b..875563c1472 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -66,14 +66,7 @@ public static function get(string $filename, ?string $default = null): ?string
      */
     public static function html(string $filename, ?string $default = null): ?HtmlString
     {
-        $path = static::normalizePath($filename, '.html');
-        $contents = static::getFileContents($path);
-
-        if ($contents === null && $default === null) {
-            return null;
-        }
-
-        return static::renderHtml($contents ?? $default);
+        return static::getInclude($filename, '.html', $default, 'renderHtml');
     }
 
     /**
@@ -85,14 +78,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        $path = static::normalizePath($filename, '.md');
-        $contents = static::getFileContents($path);
-
-        if ($contents === null && $default === null) {
-            return null;
-        }
-
-        return static::renderMarkdown($contents ?? $default);
+        return static::getInclude($filename, '.md', $default, 'renderMarkdown');
     }
 
     /**
@@ -104,14 +90,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
      */
     public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
-        $path = static::normalizePath($filename, '.blade.php');
-        $contents = static::getFileContents($path);
-
-        if ($contents === null && $default === null) {
-            return null;
-        }
-
-        return static::renderBlade($contents ?? $default);
+        return static::getInclude($filename, '.blade.php', $default, 'renderBlade');
     }
 
     protected static function normalizePath(string $filename, string $extension): string
@@ -142,4 +121,16 @@ protected static function getFileContents(string $path): ?string
 
         return Filesystem::get($path);
     }
+
+    protected static function getInclude(string $filename, string $extension, ?string $default, string $method): ?HtmlString
+    {
+        $path = static::normalizePath($filename, $extension);
+        $contents = static::getFileContents($path);
+
+        if ($contents === null && $default === null) {
+            return null;
+        }
+
+        return static::$method($contents ?? $default);
+    }
 }

From 877aa043321b33b19bc88f5e3b3d6dbdd777453d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:16:17 +0200
Subject: [PATCH 2078/4023] Move up method parameter in signature

---
 packages/framework/src/Support/Includes.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 875563c1472..9eb9f5c43a4 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -66,7 +66,7 @@ public static function get(string $filename, ?string $default = null): ?string
      */
     public static function html(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude($filename, '.html', $default, 'renderHtml');
+        return static::getInclude('renderHtml', '.html', $default, $filename);
     }
 
     /**
@@ -78,7 +78,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude($filename, '.md', $default, 'renderMarkdown');
+        return static::getInclude('renderMarkdown', '.md', $default, $filename);
     }
 
     /**
@@ -90,7 +90,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
      */
     public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude($filename, '.blade.php', $default, 'renderBlade');
+        return static::getInclude('renderBlade', '.blade.php', $default, $filename);
     }
 
     protected static function normalizePath(string $filename, string $extension): string
@@ -122,7 +122,7 @@ protected static function getFileContents(string $path): ?string
         return Filesystem::get($path);
     }
 
-    protected static function getInclude(string $filename, string $extension, ?string $default, string $method): ?HtmlString
+    protected static function getInclude(string $method, string $extension, ?string $default, string $filename): ?HtmlString
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents($path);

From 5fc1c1cd721511e4281f322e2bd4cb7b9fcd3930 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:17:36 +0200
Subject: [PATCH 2079/4023] Use callable method parameter

Gets better IDE support and doesn't report the methods as unused
---
 packages/framework/src/Support/Includes.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 9eb9f5c43a4..93cb4f62417 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -66,7 +66,7 @@ public static function get(string $filename, ?string $default = null): ?string
      */
     public static function html(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude('renderHtml', '.html', $default, $filename);
+        return static::getInclude([static::class, 'renderHtml'], '.html', $default, $filename);
     }
 
     /**
@@ -78,7 +78,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude('renderMarkdown', '.md', $default, $filename);
+        return static::getInclude([static::class, 'renderMarkdown'], '.md', $default, $filename);
     }
 
     /**
@@ -90,7 +90,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
      */
     public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude('renderBlade', '.blade.php', $default, $filename);
+        return static::getInclude([static::class, 'renderBlade'], '.blade.php', $default, $filename);
     }
 
     protected static function normalizePath(string $filename, string $extension): string
@@ -122,7 +122,7 @@ protected static function getFileContents(string $path): ?string
         return Filesystem::get($path);
     }
 
-    protected static function getInclude(string $method, string $extension, ?string $default, string $filename): ?HtmlString
+    protected static function getInclude(callable $method, string $extension, ?string $default, string $filename): ?HtmlString
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents($path);
@@ -131,6 +131,6 @@ protected static function getInclude(string $method, string $extension, ?string
             return null;
         }
 
-        return static::$method($contents ?? $default);
+        return $method($contents ?? $default);
     }
 }

From 6b8e32866c591ee2f4465160d0cc6f21c1859072 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:19:55 +0200
Subject: [PATCH 2080/4023] Reorder methods in source

Matches the execution flow and documentation order
---
 packages/framework/src/Support/Includes.php | 50 ++++++++++-----------
 1 file changed, 25 insertions(+), 25 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 93cb4f62417..f8ab257ddfc 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -70,47 +70,44 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
     }
 
     /**
-     * Get the rendered Markdown of a partial file in the includes directory.
+     * Get the rendered Blade of a partial file in the includes directory.
      *
      * @param  string  $filename  The name of the partial file, with or without the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
      * @return HtmlString|null The rendered contents of the partial file, or the default value if not found.
      */
-    public static function markdown(string $filename, ?string $default = null): ?HtmlString
+    public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude([static::class, 'renderMarkdown'], '.md', $default, $filename);
+        return static::getInclude([static::class, 'renderBlade'], '.blade.php', $default, $filename);
     }
 
     /**
-     * Get the rendered Blade of a partial file in the includes directory.
+     * Get the rendered Markdown of a partial file in the includes directory.
      *
      * @param  string  $filename  The name of the partial file, with or without the extension.
      * @param  string|null  $default  The default value to return if the partial is not found.
      * @return HtmlString|null The rendered contents of the partial file, or the default value if not found.
      */
-    public static function blade(string $filename, ?string $default = null): ?HtmlString
+    public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude([static::class, 'renderBlade'], '.blade.php', $default, $filename);
+        return static::getInclude([static::class, 'renderMarkdown'], '.md', $default, $filename);
     }
 
-    protected static function normalizePath(string $filename, string $extension): string
+    protected static function getInclude(callable $method, string $extension, ?string $default, string $filename): ?HtmlString
     {
-        return static::path(basename($filename, $extension).$extension);
-    }
+        $path = static::normalizePath($filename, $extension);
+        $contents = static::getFileContents($path);
 
-    protected static function renderHtml(string $html): HtmlString
-    {
-        return new HtmlString($html);
-    }
+        if ($contents === null && $default === null) {
+            return null;
+        }
 
-    protected static function renderMarkdown(string $markdown): HtmlString
-    {
-        return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
+        return $method($contents ?? $default);
     }
 
-    protected static function renderBlade(string $blade): HtmlString
+    protected static function normalizePath(string $filename, string $extension): string
     {
-        return new HtmlString(Blade::render($blade));
+        return static::path(basename($filename, $extension).$extension);
     }
 
     protected static function getFileContents(string $path): ?string
@@ -122,15 +119,18 @@ protected static function getFileContents(string $path): ?string
         return Filesystem::get($path);
     }
 
-    protected static function getInclude(callable $method, string $extension, ?string $default, string $filename): ?HtmlString
+    protected static function renderHtml(string $html): HtmlString
     {
-        $path = static::normalizePath($filename, $extension);
-        $contents = static::getFileContents($path);
+        return new HtmlString($html);
+    }
 
-        if ($contents === null && $default === null) {
-            return null;
-        }
+    protected static function renderBlade(string $blade): HtmlString
+    {
+        return new HtmlString(Blade::render($blade));
+    }
 
-        return $method($contents ?? $default);
+    protected static function renderMarkdown(string $markdown): HtmlString
+    {
+        return new HtmlString(trim(Markdown::render($markdown, MarkdownDocument::class)));
     }
 }

From 64eb92ab97562325e1ed0ad868e4d5c9db720fe7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:37:12 +0200
Subject: [PATCH 2081/4023] Make extension optional

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f8ab257ddfc..92ff6f2c545 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -105,7 +105,7 @@ protected static function getInclude(callable $method, string $extension, ?strin
         return $method($contents ?? $default);
     }
 
-    protected static function normalizePath(string $filename, string $extension): string
+    protected static function normalizePath(string $filename, string $extension = ''): string
     {
         return static::path(basename($filename, $extension).$extension);
     }

From ea9326172dcbc1fa7f16f58a6e2f28641f929627 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:38:23 +0200
Subject: [PATCH 2082/4023] Shift absolute path qualification to retrieval

Will prevent recursion issue in upcoming change
---
 packages/framework/src/Support/Includes.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 92ff6f2c545..f4c34e70664 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -107,16 +107,16 @@ protected static function getInclude(callable $method, string $extension, ?strin
 
     protected static function normalizePath(string $filename, string $extension = ''): string
     {
-        return static::path(basename($filename, $extension).$extension);
+        return basename($filename, $extension).$extension;
     }
 
     protected static function getFileContents(string $path): ?string
     {
-        if (! Filesystem::exists($path)) {
+        if (! Filesystem::exists(static::path($path))) {
             return null;
         }
 
-        return Filesystem::get($path);
+        return Filesystem::get(static::path($path));
     }
 
     protected static function renderHtml(string $html): HtmlString

From 83b24801c68534d8fdbe56360ef314b07797c4a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:38:50 +0200
Subject: [PATCH 2083/4023] Introduce local variable

---
 packages/framework/src/Support/Includes.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f4c34e70664..1dd40e6511e 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -112,11 +112,13 @@ protected static function normalizePath(string $filename, string $extension = ''
 
     protected static function getFileContents(string $path): ?string
     {
-        if (! Filesystem::exists(static::path($path))) {
+        $path = static::path($path);
+
+        if (! Filesystem::exists($path)) {
             return null;
         }
 
-        return Filesystem::get(static::path($path));
+        return Filesystem::get($path);
     }
 
     protected static function renderHtml(string $html): HtmlString

From 76b35dc6c27323ec45adc7516eb6e025c1696108 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:39:04 +0200
Subject: [PATCH 2084/4023] Revert "Introduce local variable"

This reverts commit 83b24801c68534d8fdbe56360ef314b07797c4a2.
---
 packages/framework/src/Support/Includes.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 1dd40e6511e..f4c34e70664 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -112,13 +112,11 @@ protected static function normalizePath(string $filename, string $extension = ''
 
     protected static function getFileContents(string $path): ?string
     {
-        $path = static::path($path);
-
-        if (! Filesystem::exists($path)) {
+        if (! Filesystem::exists(static::path($path))) {
             return null;
         }
 
-        return Filesystem::get($path);
+        return Filesystem::get(static::path($path));
     }
 
     protected static function renderHtml(string $html): HtmlString

From c77d1fcfa3a5823194a97348cf6e95800c96e1fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:40:26 +0200
Subject: [PATCH 2085/4023] Shift absolute path qualification to calling method

Also reduces unnecessary double qualification attempt in the get method
---
 packages/framework/src/Support/Includes.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index f4c34e70664..e3b4fda566f 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -96,7 +96,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
     protected static function getInclude(callable $method, string $extension, ?string $default, string $filename): ?HtmlString
     {
         $path = static::normalizePath($filename, $extension);
-        $contents = static::getFileContents($path);
+        $contents = static::getFileContents(static::path($path));
 
         if ($contents === null && $default === null) {
             return null;
@@ -112,11 +112,11 @@ protected static function normalizePath(string $filename, string $extension = ''
 
     protected static function getFileContents(string $path): ?string
     {
-        if (! Filesystem::exists(static::path($path))) {
+        if (! Filesystem::exists($path)) {
             return null;
         }
 
-        return Filesystem::get(static::path($path));
+        return Filesystem::get($path);
     }
 
     protected static function renderHtml(string $html): HtmlString

From 11a6015f3121714a4602a4caebffc603d3740dbe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:44:05 +0200
Subject: [PATCH 2086/4023] Normalize includes paths using same rules as other
 helpers

This means that nested directories are no longer supported, as you should use a data collection for that. See https://github.com/hydephp/develop/pull/1738/files#r1655369910
---
 RELEASE_NOTES.md                              |  1 +
 packages/framework/src/Support/Includes.php   |  4 ++--
 .../tests/Unit/IncludesFacadeUnitTest.php     | 19 +++++++++++++++++++
 3 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c37997d25b4..85cd42010ba 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -25,6 +25,7 @@ This serves two purposes:
 - Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
+- Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index e3b4fda566f..33460ba6d8d 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -36,7 +36,7 @@ public static function path(?string $filename = null): string
     {
         return $filename === null
             ? Hyde::path(static::$includesDirectory)
-            : Hyde::path(static::$includesDirectory.'/'.$filename);
+            : Hyde::path(static::$includesDirectory.'/'.static::normalizePath($filename));
     }
 
     /**
@@ -48,7 +48,7 @@ public static function path(?string $filename = null): string
      */
     public static function get(string $filename, ?string $default = null): ?string
     {
-        $path = static::path($filename);
+        $path = static::path(static::normalizePath($filename));
 
         if (! Filesystem::exists($path)) {
             return $default;
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index dfd6c1b8a12..1da30c9d435 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -47,6 +47,11 @@ public function testPathReturnsAPartialWithinTheIncludesDirectory()
         $this->assertSame(Hyde::path('resources/includes/partial.html'), Includes::path('partial.html'));
     }
 
+    public function testPathNormalizesNestedIdentifiers()
+    {
+        $this->assertSame(Hyde::path('resources/includes/partial.html'), Includes::path('foo/partial.html'));
+    }
+
     public function testGetReturnsPartial()
     {
         $filename = 'foo.txt';
@@ -73,6 +78,20 @@ public function testGetReturnsDefaultValueWhenNotFound()
         $this->assertSame($default, Includes::get($filename, $default));
     }
 
+    public function testGetNormalizesNestedIdentifiers()
+    {
+        $filename = 'foo/bar.txt';
+        $normalized = 'bar.txt';
+        $expected = 'foo bar';
+
+        $this->mockFilesystem(function ($filesystem) use ($expected, $normalized) {
+            $filesystem->shouldReceive('exists')->with($this->includesPath($normalized))->andReturn(true);
+            $filesystem->shouldReceive('get')->with($this->includesPath($normalized))->andReturn($expected);
+        });
+
+        $this->assertSame($expected, Includes::get($filename));
+    }
+
     public function testHtmlReturnsRenderedPartial()
     {
         $filename = 'foo.html';

From 9a07581d18ce0093817e824dae22a0fab7081f09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:47:12 +0200
Subject: [PATCH 2087/4023] Normalize control flow

---
 packages/framework/src/Support/Includes.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 33460ba6d8d..34179ebf394 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -49,12 +49,13 @@ public static function path(?string $filename = null): string
     public static function get(string $filename, ?string $default = null): ?string
     {
         $path = static::path(static::normalizePath($filename));
+        $contents = static::getFileContents($path);
 
-        if (! Filesystem::exists($path)) {
-            return $default;
+        if ($contents === null && $default === null) {
+            return null;
         }
 
-        return static::getFileContents($path);
+        return $contents ?? $default;
     }
 
     /**

From 15472ec37bdb779bf25b08fdbff84def070c60de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:48:57 +0200
Subject: [PATCH 2088/4023] Move extension to last in signature

---
 packages/framework/src/Support/Includes.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 34179ebf394..125ea80b484 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -67,7 +67,7 @@ public static function get(string $filename, ?string $default = null): ?string
      */
     public static function html(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude([static::class, 'renderHtml'], '.html', $default, $filename);
+        return static::getInclude([static::class, 'renderHtml'], $filename, $default, '.html');
     }
 
     /**
@@ -79,7 +79,7 @@ public static function html(string $filename, ?string $default = null): ?HtmlStr
      */
     public static function blade(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude([static::class, 'renderBlade'], '.blade.php', $default, $filename);
+        return static::getInclude([static::class, 'renderBlade'], $filename, $default, '.blade.php');
     }
 
     /**
@@ -91,10 +91,10 @@ public static function blade(string $filename, ?string $default = null): ?HtmlSt
      */
     public static function markdown(string $filename, ?string $default = null): ?HtmlString
     {
-        return static::getInclude([static::class, 'renderMarkdown'], '.md', $default, $filename);
+        return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    protected static function getInclude(callable $method, string $extension, ?string $default, string $filename): ?HtmlString
+    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension): ?HtmlString
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents(static::path($path));

From 92fe45d328f1a7772af7d52bcb178c94e59b3d01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:49:08 +0200
Subject: [PATCH 2089/4023] Make extension optional

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 125ea80b484..e523807d751 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -94,7 +94,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension): ?HtmlString
+    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): ?HtmlString
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents(static::path($path));

From 1c010cdca2b9275653da2f095f023db39864a9b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:49:46 +0200
Subject: [PATCH 2090/4023] Union type null instead of nullable short syntax

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index e523807d751..0cda2bb2d2f 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -94,7 +94,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): ?HtmlString
+    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|null
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents(static::path($path));

From 22c16d2fe1295b5ce848580711d01de054dae2e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:50:42 +0200
Subject: [PATCH 2091/4023] Add no-op helper method

---
 packages/framework/src/Support/Includes.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 0cda2bb2d2f..dc672b6ab99 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -120,6 +120,11 @@ protected static function getFileContents(string $path): ?string
         return Filesystem::get($path);
     }
 
+    protected static function getRaw(string $contents): string
+    {
+        return $contents;
+    }
+
     protected static function renderHtml(string $html): HtmlString
     {
         return new HtmlString($html);

From daedfdf269ecac21714eedbb5176385024ccce5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:52:20 +0200
Subject: [PATCH 2092/4023] Union type string return

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index dc672b6ab99..78d8999ac78 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -94,7 +94,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|null
+    protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|string|null
     {
         $path = static::normalizePath($filename, $extension);
         $contents = static::getFileContents(static::path($path));

From 7a7d9db04d3796a92a18823f335240d5f47f53bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:52:26 +0200
Subject: [PATCH 2093/4023] Use the helper method

---
 packages/framework/src/Support/Includes.php | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 78d8999ac78..4f2624a4023 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -48,14 +48,7 @@ public static function path(?string $filename = null): string
      */
     public static function get(string $filename, ?string $default = null): ?string
     {
-        $path = static::path(static::normalizePath($filename));
-        $contents = static::getFileContents($path);
-
-        if ($contents === null && $default === null) {
-            return null;
-        }
-
-        return $contents ?? $default;
+        return static::getInclude([static::class, 'getRaw'], $filename, $default);
     }
 
     /**

From 289ae7f49b98b9bcf41c0be1146258d8ac3f62df Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:53:54 +0200
Subject: [PATCH 2094/4023] Annotate callable generics

---
 packages/framework/src/Support/Includes.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 4f2624a4023..084900a46fd 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,6 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
+    /** @param callable(string): \Illuminate\Support\HtmlString|string|null $method */
     protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|string|null
     {
         $path = static::normalizePath($filename, $extension);

From 12d845e447f5391ab416c93a5a54e1bfe4b06f9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:56:23 +0200
Subject: [PATCH 2095/4023] Fix parameter annotation formatting

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 084900a46fd..7de90ddc07f 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -87,7 +87,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    /** @param callable(string): \Illuminate\Support\HtmlString|string|null $method */
+    /** @param callable(string): (\Illuminate\Support\HtmlString|string|null) $method */
     protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|string|null
     {
         $path = static::normalizePath($filename, $extension);

From 36e8b5eb981de72e637186c4c0a3ba1fbf0f0383 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:57:29 +0200
Subject: [PATCH 2096/4023] Inline no-op helper method into arrow function

---
 packages/framework/src/Support/Includes.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index 7de90ddc07f..bb237c66a1c 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -48,7 +48,7 @@ public static function path(?string $filename = null): string
      */
     public static function get(string $filename, ?string $default = null): ?string
     {
-        return static::getInclude([static::class, 'getRaw'], $filename, $default);
+        return static::getInclude(fn (string $contents): string => $contents, $filename, $default);
     }
 
     /**
@@ -114,11 +114,6 @@ protected static function getFileContents(string $path): ?string
         return Filesystem::get($path);
     }
 
-    protected static function getRaw(string $contents): string
-    {
-        return $contents;
-    }
-
     protected static function renderHtml(string $html): HtmlString
     {
         return new HtmlString($html);

From cdcf30e866447b356787bcbe7b14e9903a553e1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:58:11 +0200
Subject: [PATCH 2097/4023] Replace ternary expression with if/else block

---
 packages/framework/src/Support/Includes.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index bb237c66a1c..bb9b89104be 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -34,9 +34,11 @@ class Includes
      */
     public static function path(?string $filename = null): string
     {
-        return $filename === null
-            ? Hyde::path(static::$includesDirectory)
-            : Hyde::path(static::$includesDirectory.'/'.static::normalizePath($filename));
+        if ($filename === null) {
+            return Hyde::path(static::$includesDirectory);
+        } else {
+            return Hyde::path(static::$includesDirectory.'/'.static::normalizePath($filename));
+        }
     }
 
     /**

From f30d834d3660daf7f1684fbe972a0c26b34ca8de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:58:21 +0200
Subject: [PATCH 2098/4023] Unwrap else block

---
 packages/framework/src/Support/Includes.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index bb9b89104be..c98bcc6d3f0 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -36,9 +36,9 @@ public static function path(?string $filename = null): string
     {
         if ($filename === null) {
             return Hyde::path(static::$includesDirectory);
-        } else {
-            return Hyde::path(static::$includesDirectory.'/'.static::normalizePath($filename));
         }
+
+        return Hyde::path(static::$includesDirectory.'/'.static::normalizePath($filename));
     }
 
     /**

From befd302d5ff42a6aed7df67813ffb7a730389192 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 26 Jun 2024 21:59:44 +0200
Subject: [PATCH 2099/4023] Remove null union from callable that should not
 return it

---
 packages/framework/src/Support/Includes.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Includes.php b/packages/framework/src/Support/Includes.php
index c98bcc6d3f0..88b99ba280b 100644
--- a/packages/framework/src/Support/Includes.php
+++ b/packages/framework/src/Support/Includes.php
@@ -89,7 +89,7 @@ public static function markdown(string $filename, ?string $default = null): ?Htm
         return static::getInclude([static::class, 'renderMarkdown'], $filename, $default, '.md');
     }
 
-    /** @param callable(string): (\Illuminate\Support\HtmlString|string|null) $method */
+    /** @param callable(string): (\Illuminate\Support\HtmlString|string) $method */
     protected static function getInclude(callable $method, string $filename, ?string $default, string $extension = ''): HtmlString|string|null
     {
         $path = static::normalizePath($filename, $extension);

From 2e4b95946e5581b91eec325789feea702e1989c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 09:43:15 +0200
Subject: [PATCH 2100/4023] Update the `route` function to throw if the route
 does not exist

Fixes https://github.com/hydephp/develop/issues/1731
---
 packages/framework/src/helpers.php               | 2 +-
 packages/framework/tests/Feature/HelpersTest.php | 8 ++------
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index eccc720e66f..f7ae7ccb540 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -44,7 +44,7 @@ function asset(string $name, bool $preferQualifiedUrl = false): string
              */
             function route(string $key): ?Hyde\Support\Models\Route
             {
-                return hyde()->route($key);
+                return hyde()->routes()->getRoute($key);
             }
         }
 
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 733a832e7ec..fb55a9acaf0 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -142,13 +142,9 @@ public function testRouteFunction()
     /** @covers ::route */
     public function testRouteFunctionWithInvalidRoute()
     {
-        $this->assertNull(route('foo'));
-    }
+        $this->expectException(\Hyde\Framework\Exceptions\RouteNotFoundException::class);
 
-    /** @covers ::route */
-    public function testRouteFunctionReturnsNullForNonExistentRoute()
-    {
-        $this->assertNull(route('nonexistent'));
+        route('invalid');
     }
 
     /** @covers ::url */

From 583a0be3b9c313526c70f880e33fbf27d754984c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 09:44:28 +0200
Subject: [PATCH 2101/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 85cd42010ba..88c857db8e2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -19,6 +19,7 @@ This serves two purposes:
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
+- Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
 - Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566

From d6d94816b3e9628e4d9909ca47462534591d1dc5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:07:04 +0200
Subject: [PATCH 2102/4023] Extract helper to get change frequency

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 38e53a3aa3b..19e4c337fcf 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -61,7 +61,7 @@ protected function addRoute(Route $route): void
 
         $this->addChild($urlItem, 'loc', $this->resolveRouteLink($route));
         $this->addChild($urlItem, 'lastmod', $this->getLastModDate($route->getSourcePath()));
-        $this->addChild($urlItem, 'changefreq', 'daily');
+        $this->addChild($urlItem, 'changefreq', $this->getChangeFrequency());
 
         if (Config::getBool('hyde.sitemap.dynamic_priority', true)) {
             $this->addChild($urlItem, 'priority', $this->getPriority(
@@ -100,6 +100,11 @@ protected function getPriority(string $pageClass, string $slug): string
         return (string) $priority;
     }
 
+    protected function getChangeFrequency(): string
+    {
+        return 'daily';
+    }
+
     /** @return numeric-string */
     protected function getFormattedProcessingTime(): string
     {

From d768a3d912db9ddeff9c6b534e608396ce60b3ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:09:56 +0200
Subject: [PATCH 2103/4023] Add core data parameter

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 19e4c337fcf..eb14c5263e3 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -61,7 +61,7 @@ protected function addRoute(Route $route): void
 
         $this->addChild($urlItem, 'loc', $this->resolveRouteLink($route));
         $this->addChild($urlItem, 'lastmod', $this->getLastModDate($route->getSourcePath()));
-        $this->addChild($urlItem, 'changefreq', $this->getChangeFrequency());
+        $this->addChild($urlItem, 'changefreq', $this->getChangeFrequency($route->getPageClass(), $route->getPage()->getIdentifier()));
 
         if (Config::getBool('hyde.sitemap.dynamic_priority', true)) {
             $this->addChild($urlItem, 'priority', $this->getPriority(
@@ -100,7 +100,7 @@ protected function getPriority(string $pageClass, string $slug): string
         return (string) $priority;
     }
 
-    protected function getChangeFrequency(): string
+    protected function getChangeFrequency(string $pageClass, string $slug): string
     {
         return 'daily';
     }

From 8e44b8108146b1e8d0bd742e5e381bef4b4c2e4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:10:36 +0200
Subject: [PATCH 2104/4023] Normalize protected legacy parameter name to use
 identifiers

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index eb14c5263e3..9c0d9fc3496 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -75,16 +75,16 @@ protected function getLastModDate(string $file): string
         return date('c', @filemtime($file) ?: time());
     }
 
-    protected function getPriority(string $pageClass, string $slug): string
+    protected function getPriority(string $pageClass, string $identifier): string
     {
         $priority = 0.5;
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class])) {
             $priority = 0.9;
-            if ($slug === 'index') {
+            if ($identifier === 'index') {
                 $priority = 1;
             }
-            if ($slug === '404') {
+            if ($identifier === '404') {
                 $priority = 0.5;
             }
         }
@@ -100,7 +100,7 @@ protected function getPriority(string $pageClass, string $slug): string
         return (string) $priority;
     }
 
-    protected function getChangeFrequency(string $pageClass, string $slug): string
+    protected function getChangeFrequency(string $pageClass, string $identifier): string
     {
         return 'daily';
     }

From e470ac3164782b3ff10f6258a5206643e0e44b5f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:11:02 +0200
Subject: [PATCH 2105/4023] Document variable

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 9c0d9fc3496..013d0637aad 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -77,6 +77,7 @@ protected function getLastModDate(string $file): string
 
     protected function getPriority(string $pageClass, string $identifier): string
     {
+        // The default priority, unless we find a better match.
         $priority = 0.5;
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class])) {

From 8a6b35fb67caeadfc9a7974f41708a106bee662d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:11:14 +0200
Subject: [PATCH 2106/4023] Add source code spacing

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 013d0637aad..d3de3357b25 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -82,9 +82,11 @@ protected function getPriority(string $pageClass, string $identifier): string
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class])) {
             $priority = 0.9;
+
             if ($identifier === 'index') {
                 $priority = 1;
             }
+
             if ($identifier === '404') {
                 $priority = 0.5;
             }

From 7e2e4981706c5c5079dc1b77cd5e52efa09daa62 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:11:46 +0200
Subject: [PATCH 2107/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 88c857db8e2..7ed45f5fa5c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -27,6 +27,7 @@ This serves two purposes:
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
+- Improved the sitemap data generation to be even smarter in https://github.com/hydephp/develop/pull/1744
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.

From 1a6c69a5de9340acf5a1f1df70a8d1c76599c45a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:13:20 +0200
Subject: [PATCH 2108/4023] Move down helper method

---
 .../Features/XmlGenerators/SitemapGenerator.php      | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index d3de3357b25..bf077d469cc 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -108,12 +108,6 @@ protected function getChangeFrequency(string $pageClass, string $identifier): st
         return 'daily';
     }
 
-    /** @return numeric-string */
-    protected function getFormattedProcessingTime(): string
-    {
-        return (string) $this->getExecutionTimeInMs();
-    }
-
     protected function resolveRouteLink(Route $route): string
     {
         $baseUrl = Config::getNullableString('hyde.url');
@@ -127,4 +121,10 @@ protected function resolveRouteLink(Route $route): string
             return Hyde::url($route->getOutputPath());
         }
     }
+
+    /** @return numeric-string */
+    protected function getFormattedProcessingTime(): string
+    {
+        return (string) $this->getExecutionTimeInMs();
+    }
 }

From a69867bf8552bc2d0a23d0a72b03c99ba1a9adab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:14:06 +0200
Subject: [PATCH 2109/4023] Create SitemapFeatureTest.php

---
 .../framework/tests/Feature/SitemapFeatureTest.php   | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 packages/framework/tests/Feature/SitemapFeatureTest.php

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
new file mode 100644
index 00000000000..31c6ab54f85
--- /dev/null
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+class SitemapFeatureTest extends TestCase
+{
+    //
+}

From 9492fe5a4ed3c75938af8808a16c41d62ca49b53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:14:33 +0200
Subject: [PATCH 2110/4023] Document test abstract

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 31c6ab54f85..eb87f8840ad 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -6,6 +6,9 @@
 
 use Hyde\Testing\TestCase;
 
+/**
+ * High level test of the sitemap generation feature.
+ */
 class SitemapFeatureTest extends TestCase
 {
     //

From cea246c1974d2781fbd154f0c5048dd83c9ab7a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:14:55 +0200
Subject: [PATCH 2111/4023] Annotate test crosslinks

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index eb87f8840ad..dd5b1fb0577 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -8,6 +8,9 @@
 
 /**
  * High level test of the sitemap generation feature.
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\SitemapServiceTest
+ * @see \Hyde\Framework\Testing\Feature\Commands\BuildSitemapCommandTest
  */
 class SitemapFeatureTest extends TestCase
 {

From 3072b81adfc9dc468746711a5976aa2b1337868d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:15:33 +0200
Subject: [PATCH 2112/4023] Annotate test coverage

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index dd5b1fb0577..88ce410b1f9 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -11,6 +11,10 @@
  *
  * @see \Hyde\Framework\Testing\Feature\Services\SitemapServiceTest
  * @see \Hyde\Framework\Testing\Feature\Commands\BuildSitemapCommandTest
+ *
+ * @covers \Hyde\Framework\Features\XmlGenerators\SitemapGenerator
+ * @covers \Hyde\Framework\Actions\PostBuildTasks\GenerateSitemap
+ * @covers \Hyde\Console\Commands\BuildSitemapCommand
  */
 class SitemapFeatureTest extends TestCase
 {

From f17fb0760055d200833562ffa4e1564cff08d536 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:16:26 +0200
Subject: [PATCH 2113/4023] Draft test method

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 88ce410b1f9..3a66fb51b87 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -18,5 +18,8 @@
  */
 class SitemapFeatureTest extends TestCase
 {
-    //
+    public function testTheSitemapFeature()
+    {
+        //
+    }
 }

From d6b19d764f7de1afdab1bd2c6bc193d16126b423 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:19:01 +0200
Subject: [PATCH 2114/4023] Set up broad site structure

---
 .../framework/tests/Feature/SitemapFeatureTest.php | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 3a66fb51b87..e873318a90b 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -20,6 +20,18 @@ class SitemapFeatureTest extends TestCase
 {
     public function testTheSitemapFeature()
     {
-        //
+        $this->setUpBroadSiteStructure();
+    }
+
+    protected function setUpBroadSiteStructure(): void
+    {
+        $this->file('_pages/about.md', "# About\n\nThis is the about page.");
+        $this->file('_pages/contact.html', '<h1>Contact</h1><p>This is the contact page.</p>');
+        $this->file('_posts/hello-world.md', "# Hello, World!\n\nThis is the first post.");
+        $this->file('_posts/second-post.md', "# Second Post\n\nThis is the second post.");
+        $this->file('_docs/index.md', "# Documentation\n\nThis is the documentation index.");
+        $this->file('_docs/installation.md', "# Installation\n\nThis is the installation guide.");
+        $this->file('_docs/usage.md', "# Usage\n\nThis is the usage guide.");
+        $this->file('_docs/404.md', "# 404\n\nThis is the 404 page.");
     }
 }

From b6827390f0113214aeb9a28552998cbd39512408 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:21:58 +0200
Subject: [PATCH 2115/4023] Comment line with no effect

---
 .../tests/Feature/Commands/BuildSitemapCommandTest.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index af77486f2cc..19fc41415b7 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -17,7 +17,7 @@ class BuildSitemapCommandTest extends TestCase
     public function testSitemapIsGeneratedWhenConditionsAreMet()
     {
         config(['hyde.url' => 'https://example.com']);
-        config(['hyde.generate_sitemap' => true]);
+        // config(['hyde.generate_sitemap' => true]); This is only applied when calling the main build command. If the user calls this command directly, it will always generate the sitemap as long as the URL is set.
 
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
 

From 2d29ed8b839edac8009a8451171b89c31b18f1ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:22:06 +0200
Subject: [PATCH 2116/4023] Test sitemap is not generated when conditions are
 not met

---
 .../tests/Feature/Commands/BuildSitemapCommandTest.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index 19fc41415b7..792555560f0 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -26,4 +26,14 @@ public function testSitemapIsGeneratedWhenConditionsAreMet()
 
         Filesystem::unlink('_site/sitemap.xml');
     }
+
+    public function testSitemapIsNotGeneratedWhenConditionsAreNotMet()
+    {
+        config(['hyde.url' => '']);
+
+        $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
+
+        $this->artisan('build:sitemap')->assertExitCode(0);
+        $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
+    }
 }

From 1deff38cde60222a8c8b3b1f57eed9e0f7ed271a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:33:58 +0200
Subject: [PATCH 2117/4023] Add output assertions

---
 .../Feature/Commands/BuildSitemapCommandTest.php   | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index 792555560f0..f4235787c5f 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -21,7 +21,12 @@ public function testSitemapIsGeneratedWhenConditionsAreMet()
 
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
 
-        $this->artisan('build:sitemap')->assertExitCode(0);
+        $this->artisan('build:sitemap')
+            ->expectsOutputToContain('Generating sitemap...')
+            ->doesntExpectOutputToContain('Skipped')
+            ->expectsOutputToContain(' > Created _site/sitemap.xml')
+            ->assertExitCode(0);
+
         $this->assertFileExists(Hyde::path('_site/sitemap.xml'));
 
         Filesystem::unlink('_site/sitemap.xml');
@@ -33,7 +38,12 @@ public function testSitemapIsNotGeneratedWhenConditionsAreNotMet()
 
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
 
-        $this->artisan('build:sitemap')->assertExitCode(0);
+        $this->artisan('build:sitemap')
+            ->expectsOutputToContain('Generating sitemap...')
+            ->expectsOutputToContain('Skipped')
+            ->expectsOutput(' > Cannot generate sitemap without a valid base URL')
+            ->assertExitCode(0);
+
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
     }
 }

From d8aaa38570f9b763f1d46333fa8d10786eb33878 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:35:30 +0200
Subject: [PATCH 2118/4023] Remove commented code covered in main site build
 test

---
 .../framework/tests/Feature/Commands/BuildSitemapCommandTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index f4235787c5f..0600ffed7df 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -17,7 +17,6 @@ class BuildSitemapCommandTest extends TestCase
     public function testSitemapIsGeneratedWhenConditionsAreMet()
     {
         config(['hyde.url' => 'https://example.com']);
-        // config(['hyde.generate_sitemap' => true]); This is only applied when calling the main build command. If the user calls this command directly, it will always generate the sitemap as long as the URL is set.
 
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
 

From 5801af292779988e7b31fea40c850cabf9a331f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 10:36:33 +0200
Subject: [PATCH 2119/4023] Clean up sitemap file when done

This is more fault tolerant
---
 .../tests/Feature/Commands/BuildSitemapCommandTest.php       | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index 0600ffed7df..ee13bc9bf03 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature\Commands;
 
-use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 
@@ -18,6 +17,8 @@ public function testSitemapIsGeneratedWhenConditionsAreMet()
     {
         config(['hyde.url' => 'https://example.com']);
 
+        $this->cleanUpWhenDone('_site/sitemap.xml');
+
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
 
         $this->artisan('build:sitemap')
@@ -27,8 +28,6 @@ public function testSitemapIsGeneratedWhenConditionsAreMet()
             ->assertExitCode(0);
 
         $this->assertFileExists(Hyde::path('_site/sitemap.xml'));
-
-        Filesystem::unlink('_site/sitemap.xml');
     }
 
     public function testSitemapIsNotGeneratedWhenConditionsAreNotMet()

From cd0411bbd10d7f99fa48e4d01510f2224d339242 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:47:34 +0200
Subject: [PATCH 2120/4023] Run test with site URL

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index e873318a90b..b986a45d115 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -21,6 +21,7 @@ class SitemapFeatureTest extends TestCase
     public function testTheSitemapFeature()
     {
         $this->setUpBroadSiteStructure();
+        $this->withSiteUrl();
     }
 
     protected function setUpBroadSiteStructure(): void

From ad6905877d67344b11456c6c77ff5f856c81fcae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:47:58 +0200
Subject: [PATCH 2121/4023] Build the sitemap

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index b986a45d115..ba369a270a4 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -22,6 +22,10 @@ public function testTheSitemapFeature()
     {
         $this->setUpBroadSiteStructure();
         $this->withSiteUrl();
+
+        $this->artisan('build:sitemap')
+            ->expectsOutputToContain('Created _site/sitemap.xml')
+            ->assertExitCode(0);
     }
 
     protected function setUpBroadSiteStructure(): void

From 66ef0b4a3497e883708b0183ccfaa2176c33efca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:48:15 +0200
Subject: [PATCH 2122/4023] Assert file exists

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index ba369a270a4..ceed7d946a6 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -26,6 +26,8 @@ public function testTheSitemapFeature()
         $this->artisan('build:sitemap')
             ->expectsOutputToContain('Created _site/sitemap.xml')
             ->assertExitCode(0);
+
+        $this->assertFileExists('_site/sitemap.xml');
     }
 
     protected function setUpBroadSiteStructure(): void

From 1c0d67f70fb6b551a2a9ca9c7b4ffd84dbb6ef69 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:49:46 +0200
Subject: [PATCH 2123/4023] Assert file equals string

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index ceed7d946a6..f9a18216ed7 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -28,6 +28,15 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
+        $this->assertFileEqualsString($this->expected(), '_site/sitemap.xml');
+    }
+
+    protected function expected(): string
+    {
+        return <<<XML
+        <?xml version="1.0" encoding="UTF-8"?>
+        TODO
+        XML;
     }
 
     protected function setUpBroadSiteStructure(): void

From 9ac5acc1200dc50b6e11b525db7a0d471f9af898 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:53:22 +0200
Subject: [PATCH 2124/4023] Document test proof intention

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index f9a18216ed7..04425d0e2e0 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -9,6 +9,8 @@
 /**
  * High level test of the sitemap generation feature.
  *
+ * It contains a setup that covers all code paths, proving 100% coverage in actual usage.
+ *
  * @see \Hyde\Framework\Testing\Feature\Services\SitemapServiceTest
  * @see \Hyde\Framework\Testing\Feature\Commands\BuildSitemapCommandTest
  *

From 5e357850ee92f9f17364880014a598fe61737ba3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:56:54 +0200
Subject: [PATCH 2125/4023] Format expected XML in test source

---
 .../tests/Feature/SitemapFeatureTest.php      | 84 ++++++++++++++++++-
 1 file changed, 81 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 04425d0e2e0..f4c6d912fb8 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -30,14 +30,87 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
-        $this->assertFileEqualsString($this->expected(), '_site/sitemap.xml');
+        $this->assertFileEqualsString(
+            '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected()), '_site/sitemap.xml');
     }
 
     protected function expected(): string
     {
         return <<<XML
-        <?xml version="1.0" encoding="UTF-8"?>
-        TODO
+        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP 1.6.0" processing_time_ms="31.628131866455">
+            <url>
+                <loc>https://example.com/contact.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.5</priority>
+            </url>
+            <url>
+                <loc>https://example.com/404.html</loc>
+                <lastmod>2024-06-28T08:12:42+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.5</priority>
+            </url>
+            <url>
+                <loc>https://example.com/index.html</loc>
+                <lastmod>2024-06-28T08:12:42+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>1</priority>
+            </url>
+            <url>
+                <loc>https://example.com/about.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.9</priority>
+            </url>
+            <url>
+                <loc>https://example.com/posts/hello-world.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.75</priority>
+            </url>
+            <url>
+                <loc>https://example.com/posts/second-post.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.75</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/404.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.9</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/index.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.9</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/installation.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.9</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/usage.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.9</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/search.json</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.5</priority>
+            </url>
+            <url>
+                <loc>https://example.com/docs/search.html</loc>
+                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <changefreq>daily</changefreq>
+                <priority>0.5</priority>
+            </url>
+        </urlset>
         XML;
     }
 
@@ -52,4 +125,9 @@ protected function setUpBroadSiteStructure(): void
         $this->file('_docs/usage.md', "# Usage\n\nThis is the usage guide.");
         $this->file('_docs/404.md', "# 404\n\nThis is the 404 page.");
     }
+
+    protected function stripFormatting(string $xml): string
+    {
+        return str_replace("\n", '', $xml);
+    }
 }

From e5fcfee044ba5dc863d4264788a87eed8b6b7efe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:57:50 +0200
Subject: [PATCH 2126/4023] Formatting

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index f4c6d912fb8..e709a9913ac 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -30,8 +30,7 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
-        $this->assertFileEqualsString(
-            '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected()), '_site/sitemap.xml');
+        $this->assertFileEqualsString('<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected()), '_site/sitemap.xml');
     }
 
     protected function expected(): string

From 585af3e95910c2ff790037b086381db4dafb12a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 11:57:58 +0200
Subject: [PATCH 2127/4023] Add todo

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index e709a9913ac..db4fb3b6b1e 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -30,6 +30,7 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
+        // TODO: Fix dynamic data in comparison 
         $this->assertFileEqualsString('<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected()), '_site/sitemap.xml');
     }
 

From d8d731ddf5be011843ec8593fb4c76a0e4e1f682 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:00:03 +0200
Subject: [PATCH 2128/4023] Introduce local variable

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index db4fb3b6b1e..07f19c5e7c6 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -30,8 +30,9 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
-        // TODO: Fix dynamic data in comparison 
-        $this->assertFileEqualsString('<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected()), '_site/sitemap.xml');
+        // TODO: Fix dynamic data in comparison
+        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
+        $this->assertFileEqualsString($expected, '_site/sitemap.xml');
     }
 
     protected function expected(): string

From 0278fd5b37af7cdb1567dcca9d5c2454c60325f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:00:27 +0200
Subject: [PATCH 2129/4023] Inline relevant helper method call

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 07f19c5e7c6..7e38594e42f 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -32,7 +32,7 @@ public function testTheSitemapFeature()
         $this->assertFileExists('_site/sitemap.xml');
         // TODO: Fix dynamic data in comparison
         $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
-        $this->assertFileEqualsString($expected, '_site/sitemap.xml');
+        $this->assertSame($expected, file_get_contents('_site/sitemap.xml'));
     }
 
     protected function expected(): string

From e592f2d5e542e2dce45ef59831c3c04ca9bd445b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:00:35 +0200
Subject: [PATCH 2130/4023] Introduce local variable

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 7e38594e42f..0ddd7ccc913 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -32,7 +32,8 @@ public function testTheSitemapFeature()
         $this->assertFileExists('_site/sitemap.xml');
         // TODO: Fix dynamic data in comparison
         $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
-        $this->assertSame($expected, file_get_contents('_site/sitemap.xml'));
+        $actual = file_get_contents('_site/sitemap.xml');
+        $this->assertSame($expected, $actual);
     }
 
     protected function expected(): string

From 88dc5d72ec9e47ef473a8136954a9b2440c68e00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:01:35 +0200
Subject: [PATCH 2131/4023] Draft helper to strip dynamic data

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 0ddd7ccc913..bad50f077e5 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -33,7 +33,7 @@ public function testTheSitemapFeature()
         // TODO: Fix dynamic data in comparison
         $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
         $actual = file_get_contents('_site/sitemap.xml');
-        $this->assertSame($expected, $actual);
+        $this->assertSame($this->stripDynamicData($expected), $this->stripDynamicData($actual));
     }
 
     protected function expected(): string
@@ -132,4 +132,9 @@ protected function stripFormatting(string $xml): string
     {
         return str_replace("\n", '', $xml);
     }
+
+    protected function stripDynamicData(string $string): string
+    {
+        return $string;
+    }
 }

From 29eba252bed0c65684ee2d8f45e1304be2cc94e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:02:20 +0200
Subject: [PATCH 2132/4023] Clean up when done

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index bad50f077e5..22dc1b05323 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -22,6 +22,7 @@ class SitemapFeatureTest extends TestCase
 {
     public function testTheSitemapFeature()
     {
+        $this->cleanUpWhenDone('_site/sitemap.xml');
         $this->setUpBroadSiteStructure();
         $this->withSiteUrl();
 

From 8c52c0e825fedd871115087eaa4c1984f64773f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:05:21 +0200
Subject: [PATCH 2133/4023] Fix dynamic data in comparison

---
 .../tests/Feature/SitemapFeatureTest.php      | 28 +++++++++++--------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 22dc1b05323..e4776488ffa 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -31,7 +31,7 @@ public function testTheSitemapFeature()
             ->assertExitCode(0);
 
         $this->assertFileExists('_site/sitemap.xml');
-        // TODO: Fix dynamic data in comparison
+
         $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
         $actual = file_get_contents('_site/sitemap.xml');
         $this->assertSame($this->stripDynamicData($expected), $this->stripDynamicData($actual));
@@ -40,10 +40,10 @@ public function testTheSitemapFeature()
     protected function expected(): string
     {
         return <<<XML
-        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP 1.6.0" processing_time_ms="31.628131866455">
+        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP {{ dynamic }}" processing_time_ms="{{ dynamic }}">
             <url>
                 <loc>https://example.com/contact.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
@@ -61,55 +61,55 @@ protected function expected(): string
             </url>
             <url>
                 <loc>https://example.com/about.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/posts/hello-world.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/posts/second-post.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/404.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/index.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/installation.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/usage.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/search.json</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/search.html</loc>
-                <lastmod>2024-06-28T09:48:58+00:00</lastmod>
+                <lastmod>{{ dynamic }}</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
@@ -136,6 +136,10 @@ protected function stripFormatting(string $xml): string
 
     protected function stripDynamicData(string $string): string
     {
+        $string = preg_replace('/HydePHP \d+\.\d+\.\d+/', 'HydePHP {{ dynamic }}', $string);
+        $string = preg_replace('/processing_time_ms="\d+"/', 'processing_time_ms="{{ dynamic }}"', $string);
+        $string = preg_replace('/<lastmod>\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+\d{2}:\d{2}<\/lastmod>/', '<lastmod>{{ dynamic }}</lastmod>', $string);
+
         return $string;
     }
 }

From 99bc070c83503936b56fa76bc7fd4ff47b43abf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:06:29 +0200
Subject: [PATCH 2134/4023] Set Carbon time

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index e4776488ffa..6c862a98aec 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Carbon;
 
 /**
  * High level test of the sitemap generation feature.
@@ -22,6 +23,8 @@ class SitemapFeatureTest extends TestCase
 {
     public function testTheSitemapFeature()
     {
+        Carbon::setTestNow('2024-01-01 12:00:00');
+
         $this->cleanUpWhenDone('_site/sitemap.xml');
         $this->setUpBroadSiteStructure();
         $this->withSiteUrl();

From 0d4ce007073eb6467f6d6f45311d695084ffd71a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:06:58 +0200
Subject: [PATCH 2135/4023] Skip test until ready

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 6c862a98aec..db2f28f08c7 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -23,6 +23,8 @@ class SitemapFeatureTest extends TestCase
 {
     public function testTheSitemapFeature()
     {
+        $this->markTestSkipped('This test is not yet complete.');
+
         Carbon::setTestNow('2024-01-01 12:00:00');
 
         $this->cleanUpWhenDone('_site/sitemap.xml');

From 79a7862ead4af831555bb03bbb59023f6365af84 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Fri, 28 Jun 2024 10:07:08 +0000
Subject: [PATCH 2136/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index db2f28f08c7..a027188b501 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -44,7 +44,7 @@ public function testTheSitemapFeature()
 
     protected function expected(): string
     {
-        return <<<XML
+        return <<<'XML'
         <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP {{ dynamic }}" processing_time_ms="{{ dynamic }}">
             <url>
                 <loc>https://example.com/contact.html</loc>

From f2ee36f250265b5c32149bde01a672e24074fb3e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:11:30 +0200
Subject: [PATCH 2137/4023] Remove the sitemap `processing_time_ms` attribute
 as it adds no value

This is not a standard attribute, it's just a "cool thing" that adds no real value, as this file is not even intended for humans to read.
---
 RELEASE_NOTES.md                                          | 1 +
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 --------
 packages/framework/tests/Feature/SitemapFeatureTest.php   | 2 +-
 3 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7ed45f5fa5c..0d98f09ad6c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -27,6 +27,7 @@ This serves two purposes:
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
+- Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Improved the sitemap data generation to be even smarter in https://github.com/hydephp/develop/pull/1744
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index bf077d469cc..184f1c34d78 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -42,8 +42,6 @@ public function generate(): static
 
     public function getXml(): string
     {
-        $this->xmlElement->addAttribute('processing_time_ms', $this->getFormattedProcessingTime());
-
         return parent::getXml();
     }
 
@@ -121,10 +119,4 @@ protected function resolveRouteLink(Route $route): string
             return Hyde::url($route->getOutputPath());
         }
     }
-
-    /** @return numeric-string */
-    protected function getFormattedProcessingTime(): string
-    {
-        return (string) $this->getExecutionTimeInMs();
-    }
 }
diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index a027188b501..2ca9c26cc01 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -45,7 +45,7 @@ public function testTheSitemapFeature()
     protected function expected(): string
     {
         return <<<'XML'
-        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP {{ dynamic }}" processing_time_ms="{{ dynamic }}">
+        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP {{ dynamic }}">
             <url>
                 <loc>https://example.com/contact.html</loc>
                 <lastmod>{{ dynamic }}</lastmod>

From acdc6816bf81e47028c5274162a59a42267b7443 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:12:53 +0200
Subject: [PATCH 2138/4023] Sitemap generator no longer needs to track
 execution time

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php    | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 184f1c34d78..217ec39cc01 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -15,7 +15,6 @@
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Framework\Concerns\TracksExecutionTime;
 
 use function blank;
 use function filemtime;
@@ -29,8 +28,6 @@
  */
 class SitemapGenerator extends BaseXmlGenerator
 {
-    use TracksExecutionTime;
-
     public function generate(): static
     {
         Routes::all()->each(function (Route $route): void {
@@ -47,8 +44,6 @@ public function getXml(): string
 
     protected function constructBaseElement(): void
     {
-        $this->startClock();
-
         $this->xmlElement = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9"></urlset>');
         $this->xmlElement->addAttribute('generator', 'HydePHP '.Hyde::version());
     }

From 39d91deba924c926d4c74224b9ab2fe0adc02742 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:13:19 +0200
Subject: [PATCH 2139/4023] Remove redundant method override

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php    | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 217ec39cc01..ed65013d9c1 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -37,11 +37,6 @@ public function generate(): static
         return $this;
     }
 
-    public function getXml(): string
-    {
-        return parent::getXml();
-    }
-
     protected function constructBaseElement(): void
     {
         $this->xmlElement = new SimpleXMLElement('<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9"></urlset>');

From 0604d17609c482ab2aec8d3ce814a73aa788208f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:20:00 +0200
Subject: [PATCH 2140/4023] Replace ternary expression with if/else block

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php   | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index ed65013d9c1..63bc52f7919 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -60,7 +60,11 @@ protected function addRoute(Route $route): void
 
     protected function getLastModDate(string $file): string
     {
-        return date('c', @filemtime($file) ?: time());
+        if (@filemtime($file)) {
+            return date('c', @filemtime($file));
+        } else {
+            return date('c', time());
+        }
     }
 
     protected function getPriority(string $pageClass, string $identifier): string

From 013657ee509eda3726fc5457798eb62be093c4b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:21:05 +0200
Subject: [PATCH 2141/4023] Refactor to extract common parts of if/else block

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 63bc52f7919..8f322fa081b 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -60,11 +60,11 @@ protected function addRoute(Route $route): void
 
     protected function getLastModDate(string $file): string
     {
-        if (@filemtime($file)) {
-            return date('c', @filemtime($file));
-        } else {
-            return date('c', time());
+        $timestamp = @filemtime($file);
+        if (! $timestamp) {
+            $timestamp = time();
         }
+        return date('c', $timestamp);
     }
 
     protected function getPriority(string $pageClass, string $identifier): string

From 4a0e418ae005e5993d3c0d24ea58ee6612d1d6c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:22:20 +0200
Subject: [PATCH 2142/4023] Get modified time from mockable Filesystem

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 8f322fa081b..32f6d364ba2 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -12,12 +12,12 @@
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
+use Hyde\Facades\Filesystem;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
 
 use function blank;
-use function filemtime;
 use function in_array;
 use function date;
 use function time;
@@ -60,7 +60,7 @@ protected function addRoute(Route $route): void
 
     protected function getLastModDate(string $file): string
     {
-        $timestamp = @filemtime($file);
+        $timestamp = @Filesystem::lastModified($file);
         if (! $timestamp) {
             $timestamp = time();
         }

From dd863a93c1b3b7f5b9647b774e86bae10cdf3bf7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:22:58 +0200
Subject: [PATCH 2143/4023] Fix formatting

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 32f6d364ba2..2a346f1e3a8 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -61,9 +61,11 @@ protected function addRoute(Route $route): void
     protected function getLastModDate(string $file): string
     {
         $timestamp = @Filesystem::lastModified($file);
+
         if (! $timestamp) {
             $timestamp = time();
         }
+
         return date('c', $timestamp);
     }
 

From cfe58aef75651df75796282484304ddbc16efc13 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:23:31 +0200
Subject: [PATCH 2144/4023] Get current time from mockable Carbon

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 2a346f1e3a8..8da9dbf1b03 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -14,13 +14,13 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Facades\Filesystem;
 use Hyde\Support\Models\Route;
+use Illuminate\Support\Carbon;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
 
 use function blank;
 use function in_array;
 use function date;
-use function time;
 use function str_starts_with;
 
 /**
@@ -63,7 +63,7 @@ protected function getLastModDate(string $file): string
         $timestamp = @Filesystem::lastModified($file);
 
         if (! $timestamp) {
-            $timestamp = time();
+            $timestamp = Carbon::now()->timestamp;
         }
 
         return date('c', $timestamp);

From 2cceb37374fa27bf58640b1a92c83b3dc40fc4f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:24:48 +0200
Subject: [PATCH 2145/4023] Revert "Replace ternary expression with if/else
 block"

This reverts commit 0604d17609c482ab2aec8d3ce814a73aa788208f.
---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 8da9dbf1b03..af6e4e31654 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -60,13 +60,7 @@ protected function addRoute(Route $route): void
 
     protected function getLastModDate(string $file): string
     {
-        $timestamp = @Filesystem::lastModified($file);
-
-        if (! $timestamp) {
-            $timestamp = Carbon::now()->timestamp;
-        }
-
-        return date('c', $timestamp);
+        return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
     }
 
     protected function getPriority(string $pageClass, string $identifier): string

From 07e7650ed0227ff6621d6766e67f94e96a762d2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:41:06 +0200
Subject: [PATCH 2146/4023] Revert "Skip test until ready"

This reverts commit 0d4ce007073eb6467f6d6f45311d695084ffd71a.
---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 2ca9c26cc01..878e7b08180 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -23,8 +23,6 @@ class SitemapFeatureTest extends TestCase
 {
     public function testTheSitemapFeature()
     {
-        $this->markTestSkipped('This test is not yet complete.');
-
         Carbon::setTestNow('2024-01-01 12:00:00');
 
         $this->cleanUpWhenDone('_site/sitemap.xml');

From 7c2088f6461d5708fbc25c5506b91a55a2d19745 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:49:39 +0200
Subject: [PATCH 2147/4023] Refactor test to replace dynamic data with static
 mocks

---
 .../tests/Feature/SitemapFeatureTest.php      | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 878e7b08180..d778e58a4fb 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -4,8 +4,11 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Mockery;
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\File;
 
 /**
  * High level test of the sitemap generation feature.
@@ -25,6 +28,10 @@ public function testTheSitemapFeature()
     {
         Carbon::setTestNow('2024-01-01 12:00:00');
 
+        $filesystem = Mockery::mock(\Illuminate\Filesystem\Filesystem::class)->makePartial();
+        $filesystem->shouldReceive('lastModified')->andReturn(Carbon::now()->timestamp);
+        File::swap($filesystem);
+
         $this->cleanUpWhenDone('_site/sitemap.xml');
         $this->setUpBroadSiteStructure();
         $this->withSiteUrl();
@@ -35,84 +42,86 @@ public function testTheSitemapFeature()
 
         $this->assertFileExists('_site/sitemap.xml');
 
-        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected());
+        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected())."\n";
         $actual = file_get_contents('_site/sitemap.xml');
-        $this->assertSame($this->stripDynamicData($expected), $this->stripDynamicData($actual));
+        $this->assertSame($expected, $actual);
     }
 
     protected function expected(): string
     {
-        return <<<'XML'
-        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP {{ dynamic }}">
+        $version = Hyde::version();
+
+        return <<<XML
+        <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP $version">
             <url>
                 <loc>https://example.com/contact.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/404.html</loc>
-                <lastmod>2024-06-28T08:12:42+00:00</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/index.html</loc>
-                <lastmod>2024-06-28T08:12:42+00:00</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>1</priority>
             </url>
             <url>
                 <loc>https://example.com/about.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/posts/hello-world.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/posts/second-post.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/404.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/index.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/installation.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/usage.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.9</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/search.json</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/search.html</loc>
-                <lastmod>{{ dynamic }}</lastmod>
+                <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
                 <priority>0.5</priority>
             </url>
@@ -134,15 +143,6 @@ protected function setUpBroadSiteStructure(): void
 
     protected function stripFormatting(string $xml): string
     {
-        return str_replace("\n", '', $xml);
-    }
-
-    protected function stripDynamicData(string $string): string
-    {
-        $string = preg_replace('/HydePHP \d+\.\d+\.\d+/', 'HydePHP {{ dynamic }}', $string);
-        $string = preg_replace('/processing_time_ms="\d+"/', 'processing_time_ms="{{ dynamic }}"', $string);
-        $string = preg_replace('/<lastmod>\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+\d{2}:\d{2}<\/lastmod>/', '<lastmod>{{ dynamic }}</lastmod>', $string);
-
-        return $string;
+        return implode('', array_map('trim', explode("\n", $xml)));
     }
 }

From 93051299dfecdac3478bb5bd11bfe71b656c2105 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:50:17 +0200
Subject: [PATCH 2148/4023] Replace qualifier with an import

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index d778e58a4fb..1ade6c54f9e 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -9,6 +9,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\File;
+use Illuminate\Filesystem\Filesystem;
 
 /**
  * High level test of the sitemap generation feature.
@@ -28,7 +29,7 @@ public function testTheSitemapFeature()
     {
         Carbon::setTestNow('2024-01-01 12:00:00');
 
-        $filesystem = Mockery::mock(\Illuminate\Filesystem\Filesystem::class)->makePartial();
+        $filesystem = Mockery::mock(Filesystem::class)->makePartial();
         $filesystem->shouldReceive('lastModified')->andReturn(Carbon::now()->timestamp);
         File::swap($filesystem);
 

From 2a77dc6ca7bfe7a7e61300aa7ca01b345ea48711 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:51:30 +0200
Subject: [PATCH 2149/4023] Clean up data passing

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 1ade6c54f9e..b23209611f7 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -43,15 +43,13 @@ public function testTheSitemapFeature()
 
         $this->assertFileExists('_site/sitemap.xml');
 
-        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected())."\n";
+        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected(Hyde::version()))."\n";
         $actual = file_get_contents('_site/sitemap.xml');
         $this->assertSame($expected, $actual);
     }
 
-    protected function expected(): string
+    protected function expected(string $version): string
     {
-        $version = Hyde::version();
-
         return <<<XML
         <urlset xmlns="https://www.sitemaps.org/schemas/sitemap/0.9" generator="HydePHP $version">
             <url>

From 0dcaa429aaf99676474c3a1232d11200b1655bb5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:52:38 +0200
Subject: [PATCH 2150/4023] Convert concatenation to string interpolation

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index b23209611f7..a1a549db795 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -43,7 +43,7 @@ public function testTheSitemapFeature()
 
         $this->assertFileExists('_site/sitemap.xml');
 
-        $expected = '<?xml version="1.0" encoding="UTF-8"?>'."\n".$this->stripFormatting($this->expected(Hyde::version()))."\n";
+        $expected =  '<?xml version="1.0" encoding="UTF-8"?>'."\n{$this->stripFormatting($this->expected(Hyde::version()))}\n";
         $actual = file_get_contents('_site/sitemap.xml');
         $this->assertSame($expected, $actual);
     }

From 19935d8ec4717caf7716ea1fe223b6b3e5ea864d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:52:50 +0200
Subject: [PATCH 2151/4023] Inline local variable

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index a1a549db795..a8959c0710c 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -44,8 +44,7 @@ public function testTheSitemapFeature()
         $this->assertFileExists('_site/sitemap.xml');
 
         $expected =  '<?xml version="1.0" encoding="UTF-8"?>'."\n{$this->stripFormatting($this->expected(Hyde::version()))}\n";
-        $actual = file_get_contents('_site/sitemap.xml');
-        $this->assertSame($expected, $actual);
+        $this->assertSame($expected, file_get_contents('_site/sitemap.xml'));
     }
 
     protected function expected(string $version): string

From 1434d431bdf2a3823f0439a7381407097cd1ed1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:53:19 +0200
Subject: [PATCH 2152/4023] Clean up formatting

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index a8959c0710c..5d75ca50e20 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -28,7 +28,6 @@ class SitemapFeatureTest extends TestCase
     public function testTheSitemapFeature()
     {
         Carbon::setTestNow('2024-01-01 12:00:00');
-
         $filesystem = Mockery::mock(Filesystem::class)->makePartial();
         $filesystem->shouldReceive('lastModified')->andReturn(Carbon::now()->timestamp);
         File::swap($filesystem);
@@ -43,8 +42,10 @@ public function testTheSitemapFeature()
 
         $this->assertFileExists('_site/sitemap.xml');
 
-        $expected =  '<?xml version="1.0" encoding="UTF-8"?>'."\n{$this->stripFormatting($this->expected(Hyde::version()))}\n";
-        $this->assertSame($expected, file_get_contents('_site/sitemap.xml'));
+        $this->assertSame(
+            '<?xml version="1.0" encoding="UTF-8"?>'."\n{$this->stripFormatting($this->expected(Hyde::version()))}\n",
+            file_get_contents('_site/sitemap.xml')
+        );
     }
 
     protected function expected(string $version): string

From 301ba734419978c46b0183fa5bf73454ede6c1de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:55:39 +0200
Subject: [PATCH 2153/4023] Move up method in source

---
 .../tests/Feature/SitemapFeatureTest.php      | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 5d75ca50e20..0477f24093a 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -48,6 +48,18 @@ public function testTheSitemapFeature()
         );
     }
 
+    protected function setUpBroadSiteStructure(): void
+    {
+        $this->file('_pages/about.md', "# About\n\nThis is the about page.");
+        $this->file('_pages/contact.html', '<h1>Contact</h1><p>This is the contact page.</p>');
+        $this->file('_posts/hello-world.md', "# Hello, World!\n\nThis is the first post.");
+        $this->file('_posts/second-post.md', "# Second Post\n\nThis is the second post.");
+        $this->file('_docs/index.md', "# Documentation\n\nThis is the documentation index.");
+        $this->file('_docs/installation.md', "# Installation\n\nThis is the installation guide.");
+        $this->file('_docs/usage.md', "# Usage\n\nThis is the usage guide.");
+        $this->file('_docs/404.md', "# 404\n\nThis is the 404 page.");
+    }
+
     protected function expected(string $version): string
     {
         return <<<XML
@@ -128,18 +140,6 @@ protected function expected(string $version): string
         XML;
     }
 
-    protected function setUpBroadSiteStructure(): void
-    {
-        $this->file('_pages/about.md', "# About\n\nThis is the about page.");
-        $this->file('_pages/contact.html', '<h1>Contact</h1><p>This is the contact page.</p>');
-        $this->file('_posts/hello-world.md', "# Hello, World!\n\nThis is the first post.");
-        $this->file('_posts/second-post.md', "# Second Post\n\nThis is the second post.");
-        $this->file('_docs/index.md', "# Documentation\n\nThis is the documentation index.");
-        $this->file('_docs/installation.md', "# Installation\n\nThis is the installation guide.");
-        $this->file('_docs/usage.md', "# Usage\n\nThis is the usage guide.");
-        $this->file('_docs/404.md', "# 404\n\nThis is the 404 page.");
-    }
-
     protected function stripFormatting(string $xml): string
     {
         return implode('', array_map('trim', explode("\n", $xml)));

From 1f8a3afaac0ec4ffc738ac85ff0302d85ee42c9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 12:57:01 +0200
Subject: [PATCH 2154/4023] Add todo to remove unreachable code

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php   | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index af6e4e31654..8c217de70bc 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -101,6 +101,8 @@ protected function resolveRouteLink(Route $route): string
         $baseUrl = Config::getNullableString('hyde.url');
 
         if (blank($baseUrl) || str_starts_with($baseUrl, 'http://localhost')) {
+            // TODO: This does not seem to be reachable from the actual commands, and should be removed.
+
             // While the sitemap spec requires a full URL, we rather fall back
             // to using relative links instead of using localhost links.
 

From 8e7969e7e7112cf0c8cd0cf57fc4e6eed1626e33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:37:28 +0200
Subject: [PATCH 2155/4023] Unwrap 'else'

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 8c217de70bc..2c2d992c9a6 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -107,8 +107,8 @@ protected function resolveRouteLink(Route $route): string
             // to using relative links instead of using localhost links.
 
             return $route->getLink();
-        } else {
-            return Hyde::url($route->getOutputPath());
         }
+
+        return Hyde::url($route->getOutputPath());
     }
 }

From 31ffc5eadc239999d361e30ca2b4733143562845 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:39:08 +0200
Subject: [PATCH 2156/4023] Remove unreachable legacy relative sitemap link
 resolving

This does not seem to be reachable from the actual commands, only by unit tests and direct code access. Since it's a protected method it is not covered by BC.
---
 .../Features/XmlGenerators/SitemapGenerator.php     | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 2c2d992c9a6..e2e1faa5257 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -18,10 +18,8 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
 
-use function blank;
 use function in_array;
 use function date;
-use function str_starts_with;
 
 /**
  * @see https://www.sitemaps.org/protocol.html
@@ -98,17 +96,6 @@ protected function getChangeFrequency(string $pageClass, string $identifier): st
 
     protected function resolveRouteLink(Route $route): string
     {
-        $baseUrl = Config::getNullableString('hyde.url');
-
-        if (blank($baseUrl) || str_starts_with($baseUrl, 'http://localhost')) {
-            // TODO: This does not seem to be reachable from the actual commands, and should be removed.
-
-            // While the sitemap spec requires a full URL, we rather fall back
-            // to using relative links instead of using localhost links.
-
-            return $route->getLink();
-        }
-
         return Hyde::url($route->getOutputPath());
     }
 }

From 7f002118de3284690bd93e36744495afa69f4381 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:41:44 +0200
Subject: [PATCH 2157/4023] Adjust 404 priority logic to be independent of page
 type

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index e2e1faa5257..219f7151010 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -72,10 +72,10 @@ protected function getPriority(string $pageClass, string $identifier): string
             if ($identifier === 'index') {
                 $priority = 1;
             }
+        }
 
-            if ($identifier === '404') {
-                $priority = 0.5;
-            }
+        if ($identifier === '404') {
+            $priority = 0.5;
         }
 
         if ($pageClass === DocumentationPage::class) {

From cfd554591b2fd02fd21ea267ba66bd66cf9bbc53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:42:57 +0200
Subject: [PATCH 2158/4023] Move down 404 priority to last in chain to prevent
 it being overwritten

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 219f7151010..5ddc3daaf40 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -74,10 +74,6 @@ protected function getPriority(string $pageClass, string $identifier): string
             }
         }
 
-        if ($identifier === '404') {
-            $priority = 0.5;
-        }
-
         if ($pageClass === DocumentationPage::class) {
             $priority = 0.9;
         }
@@ -86,6 +82,10 @@ protected function getPriority(string $pageClass, string $identifier): string
             $priority = 0.75;
         }
 
+        if ($identifier === '404') {
+            $priority = 0.5;
+        }
+
         return (string) $priority;
     }
 

From c5f6f3e0c7d2fe0dd47a783b737694f1f33af4a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:43:20 +0200
Subject: [PATCH 2159/4023] Expect lower 404 priority

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 0477f24093a..cbd43e00415 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -104,7 +104,7 @@ protected function expected(string $version): string
                 <loc>https://example.com/docs/404.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
-                <priority>0.9</priority>
+                <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/index.html</loc>

From 8ae31f9abe3b18165d67e9a792a9cf34450497d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:46:25 +0200
Subject: [PATCH 2160/4023] Document the priority algorithm intentions

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php   | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 5ddc3daaf40..a36a455336e 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -61,28 +61,34 @@ protected function getLastModDate(string $file): string
         return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
     }
 
+    /** Intelligently find a good priority for the given page based on assumptions about the site structure. */
     protected function getPriority(string $pageClass, string $identifier): string
     {
         // The default priority, unless we find a better match.
         $priority = 0.5;
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class])) {
+            // These pages are usually high up in the site hierarchy, so they get a higher priority.
             $priority = 0.9;
 
             if ($identifier === 'index') {
+                // The homepage is the most important page, so it gets the highest priority.
                 $priority = 1;
             }
         }
 
         if ($pageClass === DocumentationPage::class) {
+            // If a site has documentation pages, they are usually important as well.
             $priority = 0.9;
         }
 
         if ($pageClass === MarkdownPost::class) {
+            // Posts are usually less important than pages as there may be many of them.
             $priority = 0.75;
         }
 
         if ($identifier === '404') {
+            // 404 pages are rarely important to index, so they get a lower priority.
             $priority = 0.5;
         }
 

From 619a28a326c1a637cbfe84401e08b27d42d8d40d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:47:59 +0200
Subject: [PATCH 2161/4023] Merge up documentation page rules with matching
 semantics

Also gives documentation indexes top priority
---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php  | 7 +------
 packages/framework/tests/Feature/SitemapFeatureTest.php    | 2 +-
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index a36a455336e..5ead80ab8da 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -67,7 +67,7 @@ protected function getPriority(string $pageClass, string $identifier): string
         // The default priority, unless we find a better match.
         $priority = 0.5;
 
-        if (in_array($pageClass, [BladePage::class, MarkdownPage::class])) {
+        if (in_array($pageClass, [BladePage::class, MarkdownPage::class, DocumentationPage::class])) {
             // These pages are usually high up in the site hierarchy, so they get a higher priority.
             $priority = 0.9;
 
@@ -77,11 +77,6 @@ protected function getPriority(string $pageClass, string $identifier): string
             }
         }
 
-        if ($pageClass === DocumentationPage::class) {
-            // If a site has documentation pages, they are usually important as well.
-            $priority = 0.9;
-        }
-
         if ($pageClass === MarkdownPost::class) {
             // Posts are usually less important than pages as there may be many of them.
             $priority = 0.75;
diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index cbd43e00415..c91a7e17188 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -110,7 +110,7 @@ protected function expected(string $version): string
                 <loc>https://example.com/docs/index.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
-                <priority>0.9</priority>
+                <priority>1</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/installation.html</loc>

From ffa91616db47a30bceb0fb0571f91a852d8a7fd4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:50:40 +0200
Subject: [PATCH 2162/4023] Lower 404 page priority

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 2 +-
 packages/framework/tests/Feature/SitemapFeatureTest.php       | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 5ead80ab8da..41a1f15d5e7 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -84,7 +84,7 @@ protected function getPriority(string $pageClass, string $identifier): string
 
         if ($identifier === '404') {
             // 404 pages are rarely important to index, so they get a lower priority.
-            $priority = 0.5;
+            $priority = 0.25;
         }
 
         return (string) $priority;
diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index c91a7e17188..8f508352b09 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -74,7 +74,7 @@ protected function expected(string $version): string
                 <loc>https://example.com/404.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
-                <priority>0.5</priority>
+                <priority>0.25</priority>
             </url>
             <url>
                 <loc>https://example.com/index.html</loc>
@@ -104,7 +104,7 @@ protected function expected(string $version): string
                 <loc>https://example.com/docs/404.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
-                <priority>0.5</priority>
+                <priority>0.25</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/index.html</loc>

From aabe8b82f262ba123eac74779d5b3243ed589307 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:52:55 +0200
Subject: [PATCH 2163/4023] Create priority group for more page types

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php  | 7 +++++--
 packages/framework/tests/Feature/SitemapFeatureTest.php    | 2 +-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 41a1f15d5e7..96fe5545e87 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -9,10 +9,12 @@
 use Hyde\Hyde;
 use SimpleXMLElement;
 use Hyde\Facades\Config;
+use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Facades\Filesystem;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Support\Models\Route;
 use Illuminate\Support\Carbon;
 use Hyde\Pages\DocumentationPage;
@@ -77,8 +79,9 @@ protected function getPriority(string $pageClass, string $identifier): string
             }
         }
 
-        if ($pageClass === MarkdownPost::class) {
-            // Posts are usually less important than pages as there may be many of them.
+        if (in_array($pageClass, [MarkdownPost::class, InMemoryPage::class, HtmlPage::class])) {
+            // Posts are usually less important than normal pages as there may be many of them.
+            // We group in InMemoryPages and HtmlPages here since we don't have much context for them.
             $priority = 0.75;
         }
 
diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 8f508352b09..0f58538ee5d 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -68,7 +68,7 @@ protected function expected(string $version): string
                 <loc>https://example.com/contact.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
                 <changefreq>daily</changefreq>
-                <priority>0.5</priority>
+                <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/404.html</loc>

From 00b94078b39d713c7053e5e4d5b3fd62b9d0201b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 13:59:16 +0200
Subject: [PATCH 2164/4023] Extract new testing helper

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 0f58538ee5d..42ff23f5ffc 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -42,7 +42,7 @@ public function testTheSitemapFeature()
 
         $this->assertFileExists('_site/sitemap.xml');
 
-        $this->assertSame(
+        $this->assertSameXml(
             '<?xml version="1.0" encoding="UTF-8"?>'."\n{$this->stripFormatting($this->expected(Hyde::version()))}\n",
             file_get_contents('_site/sitemap.xml')
         );
@@ -144,4 +144,9 @@ protected function stripFormatting(string $xml): string
     {
         return implode('', array_map('trim', explode("\n", $xml)));
     }
+
+    protected function assertSameXml(string $expected, string $actual): void
+    {
+        $this->assertSame($expected, $actual);
+    }
 }

From 91dcfea8bdcd67b55dfafa646f597dba92c39195 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:00:40 +0200
Subject: [PATCH 2165/4023] Expand the XML to make it easier to read in the
 test output

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 42ff23f5ffc..54da7f4c1af 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -145,8 +145,14 @@ protected function stripFormatting(string $xml): string
         return implode('', array_map('trim', explode("\n", $xml)));
     }
 
+    protected function expandLines(string $xml): string
+    {
+        // Expand the XML to make it easier to read in the test output.
+        return str_replace('><', ">\n<", $xml);
+    }
+
     protected function assertSameXml(string $expected, string $actual): void
     {
-        $this->assertSame($expected, $actual);
+        $this->assertSame($this->expandLines($expected), $this->expandLines($actual));
     }
 }

From 48cef462816c97aa41a1e89b48efa3cd1f8230a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:01:20 +0200
Subject: [PATCH 2166/4023] Create dynamic change frequencies

---
 .../Features/XmlGenerators/SitemapGenerator.php    | 14 +++++++++++++-
 .../framework/tests/Feature/SitemapFeatureTest.php | 14 +++++++-------
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 96fe5545e87..2c779c71bc8 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -95,7 +95,19 @@ protected function getPriority(string $pageClass, string $identifier): string
 
     protected function getChangeFrequency(string $pageClass, string $identifier): string
     {
-        return 'daily';
+        if ($identifier === '404') {
+            return 'monthly';
+        }
+
+        if (in_array($pageClass, [BladePage::class, MarkdownPage::class, DocumentationPage::class])) {
+            return 'daily';
+        }
+
+        if (in_array($pageClass, [MarkdownPost::class, InMemoryPage::class, HtmlPage::class])) {
+            return 'weekly';
+        }
+
+        return 'weekly';
     }
 
     protected function resolveRouteLink(Route $route): string
diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 54da7f4c1af..938b654266a 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -67,13 +67,13 @@ protected function expected(string $version): string
             <url>
                 <loc>https://example.com/contact.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>weekly</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/404.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>monthly</changefreq>
                 <priority>0.25</priority>
             </url>
             <url>
@@ -91,19 +91,19 @@ protected function expected(string $version): string
             <url>
                 <loc>https://example.com/posts/hello-world.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>weekly</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/posts/second-post.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>weekly</changefreq>
                 <priority>0.75</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/404.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>monthly</changefreq>
                 <priority>0.25</priority>
             </url>
             <url>
@@ -127,13 +127,13 @@ protected function expected(string $version): string
             <url>
                 <loc>https://example.com/docs/search.json</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>weekly</changefreq>
                 <priority>0.5</priority>
             </url>
             <url>
                 <loc>https://example.com/docs/search.html</loc>
                 <lastmod>2024-01-01T12:00:00+00:00</lastmod>
-                <changefreq>daily</changefreq>
+                <changefreq>weekly</changefreq>
                 <priority>0.5</priority>
             </url>
         </urlset>

From eb1baabb160cbb79e2293a2821bea92ae22e3d7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:02:25 +0200
Subject: [PATCH 2167/4023] Collapse 'if' statement with common parts

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 2c779c71bc8..67fb1edc77c 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -103,10 +103,6 @@ protected function getChangeFrequency(string $pageClass, string $identifier): st
             return 'daily';
         }
 
-        if (in_array($pageClass, [MarkdownPost::class, InMemoryPage::class, HtmlPage::class])) {
-            return 'weekly';
-        }
-
         return 'weekly';
     }
 

From c265521c1f39593f849280b396bae4a1c9729547 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:03:46 +0200
Subject: [PATCH 2168/4023] Clean up and refactor method

---
 .../Features/XmlGenerators/SitemapGenerator.php     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 67fb1edc77c..311c7e1b3ef 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -93,17 +93,20 @@ protected function getPriority(string $pageClass, string $identifier): string
         return (string) $priority;
     }
 
+    /** Intelligently find a good change frequency for the given page based on assumptions about the site structure. */
     protected function getChangeFrequency(string $pageClass, string $identifier): string
     {
-        if ($identifier === '404') {
-            return 'monthly';
-        }
+        $frequency = 'weekly';
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class, DocumentationPage::class])) {
-            return 'daily';
+            $frequency = 'daily';
+        }
+
+        if ($identifier === '404') {
+            $frequency = 'monthly';
         }
 
-        return 'weekly';
+        return $frequency;
     }
 
     protected function resolveRouteLink(Route $route): string

From 6c619285c53a0fdf9b7488ae8d87b5931cac7186 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:05:44 +0200
Subject: [PATCH 2169/4023] Remove undocumented `sitemap.dynamic_priority`
 config option

Either we add something like this for the changefreq logic, or we remove it, and I think it can be removed since it's not documented, and it's such an uncommon use case. And if one is unhappy with the generation, a better way is to customize the class to add custom logic.
---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 311c7e1b3ef..4e7279e75f9 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -8,7 +8,6 @@
 
 use Hyde\Hyde;
 use SimpleXMLElement;
-use Hyde\Facades\Config;
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
@@ -50,12 +49,7 @@ protected function addRoute(Route $route): void
         $this->addChild($urlItem, 'loc', $this->resolveRouteLink($route));
         $this->addChild($urlItem, 'lastmod', $this->getLastModDate($route->getSourcePath()));
         $this->addChild($urlItem, 'changefreq', $this->getChangeFrequency($route->getPageClass(), $route->getPage()->getIdentifier()));
-
-        if (Config::getBool('hyde.sitemap.dynamic_priority', true)) {
-            $this->addChild($urlItem, 'priority', $this->getPriority(
-                $route->getPageClass(), $route->getPage()->getIdentifier()
-            ));
-        }
+        $this->addChild($urlItem, 'priority', $this->getPriority($route->getPageClass(), $route->getPage()->getIdentifier()));
     }
 
     protected function getLastModDate(string $file): string

From 8ff7247c20f9d3849fcf7ac052116760573f3195 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:07:21 +0200
Subject: [PATCH 2170/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0d98f09ad6c..3ce93987389 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -28,6 +28,7 @@ This serves two purposes:
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
+- Improved sitemap generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Improved the sitemap data generation to be even smarter in https://github.com/hydephp/develop/pull/1744
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.

From 502d7efd038425770ee1598b34f46c1b30ccd122 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:07:43 +0200
Subject: [PATCH 2171/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3ce93987389..c152c7a480a 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -28,8 +28,7 @@ This serves two purposes:
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
-- Improved sitemap generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
-- Improved the sitemap data generation to be even smarter in https://github.com/hydephp/develop/pull/1744
+- Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.

From 92d1296bacde6649d4c7f28ab0a6713c7dba6e6e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:08:16 +0200
Subject: [PATCH 2172/4023] Clean up test code

---
 packages/framework/tests/Feature/SitemapFeatureTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/SitemapFeatureTest.php b/packages/framework/tests/Feature/SitemapFeatureTest.php
index 938b654266a..e0825f18013 100644
--- a/packages/framework/tests/Feature/SitemapFeatureTest.php
+++ b/packages/framework/tests/Feature/SitemapFeatureTest.php
@@ -147,7 +147,6 @@ protected function stripFormatting(string $xml): string
 
     protected function expandLines(string $xml): string
     {
-        // Expand the XML to make it easier to read in the test output.
         return str_replace('><', ">\n<", $xml);
     }
 

From a82680fa3d204fe5dc5df400c47d6dfa64a8e9e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:09:26 +0200
Subject: [PATCH 2173/4023] Clarify helper method names

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 4e7279e75f9..259cef6cdc5 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -48,8 +48,8 @@ protected function addRoute(Route $route): void
 
         $this->addChild($urlItem, 'loc', $this->resolveRouteLink($route));
         $this->addChild($urlItem, 'lastmod', $this->getLastModDate($route->getSourcePath()));
-        $this->addChild($urlItem, 'changefreq', $this->getChangeFrequency($route->getPageClass(), $route->getPage()->getIdentifier()));
-        $this->addChild($urlItem, 'priority', $this->getPriority($route->getPageClass(), $route->getPage()->getIdentifier()));
+        $this->addChild($urlItem, 'changefreq', $this->generateChangeFrequency($route->getPageClass(), $route->getPage()->getIdentifier()));
+        $this->addChild($urlItem, 'priority', $this->generatePriority($route->getPageClass(), $route->getPage()->getIdentifier()));
     }
 
     protected function getLastModDate(string $file): string
@@ -58,7 +58,7 @@ protected function getLastModDate(string $file): string
     }
 
     /** Intelligently find a good priority for the given page based on assumptions about the site structure. */
-    protected function getPriority(string $pageClass, string $identifier): string
+    protected function generatePriority(string $pageClass, string $identifier): string
     {
         // The default priority, unless we find a better match.
         $priority = 0.5;
@@ -88,7 +88,7 @@ protected function getPriority(string $pageClass, string $identifier): string
     }
 
     /** Intelligently find a good change frequency for the given page based on assumptions about the site structure. */
-    protected function getChangeFrequency(string $pageClass, string $identifier): string
+    protected function generateChangeFrequency(string $pageClass, string $identifier): string
     {
         $frequency = 'weekly';
 

From c294778a5d43d0687e8f475fe5e7077c57a7fceb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:09:56 +0200
Subject: [PATCH 2174/4023] Revert "Document the priority algorithm intentions"

This reverts commit 8ae31f9abe3b18165d67e9a792a9cf34450497d2.
---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 259cef6cdc5..e3b464313bf 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -57,37 +57,29 @@ protected function getLastModDate(string $file): string
         return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
     }
 
-    /** Intelligently find a good priority for the given page based on assumptions about the site structure. */
     protected function generatePriority(string $pageClass, string $identifier): string
     {
-        // The default priority, unless we find a better match.
         $priority = 0.5;
 
         if (in_array($pageClass, [BladePage::class, MarkdownPage::class, DocumentationPage::class])) {
-            // These pages are usually high up in the site hierarchy, so they get a higher priority.
             $priority = 0.9;
 
             if ($identifier === 'index') {
-                // The homepage is the most important page, so it gets the highest priority.
                 $priority = 1;
             }
         }
 
         if (in_array($pageClass, [MarkdownPost::class, InMemoryPage::class, HtmlPage::class])) {
-            // Posts are usually less important than normal pages as there may be many of them.
-            // We group in InMemoryPages and HtmlPages here since we don't have much context for them.
             $priority = 0.75;
         }
 
         if ($identifier === '404') {
-            // 404 pages are rarely important to index, so they get a lower priority.
             $priority = 0.25;
         }
 
         return (string) $priority;
     }
 
-    /** Intelligently find a good change frequency for the given page based on assumptions about the site structure. */
     protected function generateChangeFrequency(string $pageClass, string $identifier): string
     {
         $frequency = 'weekly';

From 203c9d60e6640ac2197afa34acbe13e20bb3959e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:11:57 +0200
Subject: [PATCH 2175/4023] Extract helper method for repeated code

---
 .../Features/XmlGenerators/SitemapGenerator.php          | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index e3b464313bf..b404195afb3 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -48,8 +48,8 @@ protected function addRoute(Route $route): void
 
         $this->addChild($urlItem, 'loc', $this->resolveRouteLink($route));
         $this->addChild($urlItem, 'lastmod', $this->getLastModDate($route->getSourcePath()));
-        $this->addChild($urlItem, 'changefreq', $this->generateChangeFrequency($route->getPageClass(), $route->getPage()->getIdentifier()));
-        $this->addChild($urlItem, 'priority', $this->generatePriority($route->getPageClass(), $route->getPage()->getIdentifier()));
+        $this->addChild($urlItem, 'changefreq', $this->generateChangeFrequency(...$this->getRouteInformation($route)));
+        $this->addChild($urlItem, 'priority', $this->generatePriority(...$this->getRouteInformation($route)));
     }
 
     protected function getLastModDate(string $file): string
@@ -99,4 +99,9 @@ protected function resolveRouteLink(Route $route): string
     {
         return Hyde::url($route->getOutputPath());
     }
+
+    protected function getRouteInformation(Route $route): array
+    {
+        return [$route->getPageClass(), $route->getPage()->getIdentifier()];
+    }
 }

From 8b45cd9eca03c6bd291aa06d73f5b1789fae7268 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:13:24 +0200
Subject: [PATCH 2176/4023] Add generic type annotations

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index b404195afb3..0145c515f54 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -57,6 +57,7 @@ protected function getLastModDate(string $file): string
         return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
     }
 
+    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     protected function generatePriority(string $pageClass, string $identifier): string
     {
         $priority = 0.5;
@@ -80,6 +81,7 @@ protected function generatePriority(string $pageClass, string $identifier): stri
         return (string) $priority;
     }
 
+    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     protected function generateChangeFrequency(string $pageClass, string $identifier): string
     {
         $frequency = 'weekly';
@@ -100,6 +102,7 @@ protected function resolveRouteLink(Route $route): string
         return Hyde::url($route->getOutputPath());
     }
 
+    /** @return array{class-string<\Hyde\Pages\Concerns\HydePage>, string} */
     protected function getRouteInformation(Route $route): array
     {
         return [$route->getPageClass(), $route->getPage()->getIdentifier()];

From 04aebd18398f44942772f12441a93f5248bce3de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:14:09 +0200
Subject: [PATCH 2177/4023] Move up helper method declaration to match call
 order

---
 .../Features/XmlGenerators/SitemapGenerator.php        | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 0145c515f54..43b83ff0a06 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -52,6 +52,11 @@ protected function addRoute(Route $route): void
         $this->addChild($urlItem, 'priority', $this->generatePriority(...$this->getRouteInformation($route)));
     }
 
+    protected function resolveRouteLink(Route $route): string
+    {
+        return Hyde::url($route->getOutputPath());
+    }
+
     protected function getLastModDate(string $file): string
     {
         return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
@@ -97,11 +102,6 @@ protected function generateChangeFrequency(string $pageClass, string $identifier
         return $frequency;
     }
 
-    protected function resolveRouteLink(Route $route): string
-    {
-        return Hyde::url($route->getOutputPath());
-    }
-
     /** @return array{class-string<\Hyde\Pages\Concerns\HydePage>, string} */
     protected function getRouteInformation(Route $route): array
     {

From 29661ffdf4fd8826b6eab7c4b469425f08e64d6a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:15:12 +0200
Subject: [PATCH 2178/4023] Expand PHPDoc comments

---
 .../Framework/Features/XmlGenerators/SitemapGenerator.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 43b83ff0a06..999dd90b9aa 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -62,7 +62,9 @@ protected function getLastModDate(string $file): string
         return date('c', @Filesystem::lastModified($file) ?: Carbon::now()->timestamp);
     }
 
-    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
+     */
     protected function generatePriority(string $pageClass, string $identifier): string
     {
         $priority = 0.5;
@@ -86,7 +88,9 @@ protected function generatePriority(string $pageClass, string $identifier): stri
         return (string) $priority;
     }
 
-    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
+    /**
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
+     */
     protected function generateChangeFrequency(string $pageClass, string $identifier): string
     {
         $frequency = 'weekly';

From 7538520288f754310361459bce6f82a0de870920 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:18:04 +0200
Subject: [PATCH 2179/4023] Annotate numeric string return

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index 999dd90b9aa..be81abeecaf 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -64,6 +64,7 @@ protected function getLastModDate(string $file): string
 
     /**
      * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
+     * @return numeric-string
      */
     protected function generatePriority(string $pageClass, string $identifier): string
     {

From b8d30ba947b581744b39b0f8126e92c51c215e71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 14:18:58 +0200
Subject: [PATCH 2180/4023] Annotate enumerated string returns based on sitemap
 spec

---
 .../src/Framework/Features/XmlGenerators/SitemapGenerator.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
index be81abeecaf..01b3f2f10a8 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/SitemapGenerator.php
@@ -91,6 +91,7 @@ protected function generatePriority(string $pageClass, string $identifier): stri
 
     /**
      * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
+     * @return 'always'|'hourly'|'daily '|'weekly'|'monthly'|'yearly'|'never'
      */
     protected function generateChangeFrequency(string $pageClass, string $identifier): string
     {

From 334a83ab51ec5fc2f5a164d695ef6bd84602883c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 15:42:26 +0200
Subject: [PATCH 2181/4023] Set the `BuildTaskSkippedException` code to 2

Fixes https://github.com/hydephp/develop/issues/1745
---
 .../Framework/Features/BuildTasks/BuildTaskSkippedException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php b/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
index cc4cff9b406..55443d7c83a 100644
--- a/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
+++ b/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
@@ -8,7 +8,7 @@
 
 class BuildTaskSkippedException extends RuntimeException
 {
-    public function __construct(string $message = 'Task was skipped', int $code = 0)
+    public function __construct(string $message = 'Task was skipped', int $code = 2)
     {
         parent::__construct($message, $code);
     }

From 70291fbc822d5ff00415567dd53dc896e1356e5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 15:42:59 +0200
Subject: [PATCH 2182/4023] Set the `BuildTaskSkippedException` code to 3

See https://github.com/hydephp/develop/issues/1745#issuecomment-2196424475
---
 .../Framework/Features/BuildTasks/BuildTaskSkippedException.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php b/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
index 55443d7c83a..e10e8d60f31 100644
--- a/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
+++ b/packages/framework/src/Framework/Features/BuildTasks/BuildTaskSkippedException.php
@@ -8,7 +8,7 @@
 
 class BuildTaskSkippedException extends RuntimeException
 {
-    public function __construct(string $message = 'Task was skipped', int $code = 2)
+    public function __construct(string $message = 'Task was skipped', int $code = 3)
     {
         parent::__construct($message, $code);
     }

From d90dcc7723ea81e5545f573fc2a8108ebae81f78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 15:45:01 +0200
Subject: [PATCH 2183/4023] Test skipped tasks have exit code 3

---
 .../tests/Feature/Commands/BuildSitemapCommandTest.php        | 2 +-
 .../framework/tests/Unit/BuildTaskSkippedExceptionTest.php    | 2 +-
 packages/framework/tests/Unit/BuildTaskUnitTest.php           | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
index ee13bc9bf03..ab66436b8a4 100644
--- a/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/BuildSitemapCommandTest.php
@@ -40,7 +40,7 @@ public function testSitemapIsNotGeneratedWhenConditionsAreNotMet()
             ->expectsOutputToContain('Generating sitemap...')
             ->expectsOutputToContain('Skipped')
             ->expectsOutput(' > Cannot generate sitemap without a valid base URL')
-            ->assertExitCode(0);
+            ->assertExitCode(3);
 
         $this->assertFileDoesNotExist(Hyde::path('_site/sitemap.xml'));
     }
diff --git a/packages/framework/tests/Unit/BuildTaskSkippedExceptionTest.php b/packages/framework/tests/Unit/BuildTaskSkippedExceptionTest.php
index 3d3e91aa581..8d48ab00f16 100644
--- a/packages/framework/tests/Unit/BuildTaskSkippedExceptionTest.php
+++ b/packages/framework/tests/Unit/BuildTaskSkippedExceptionTest.php
@@ -39,7 +39,7 @@ public function testDefaultExceptionCode()
     {
         $exception = new BuildTaskSkippedException();
 
-        $this->assertSame(0, $exception->getCode());
+        $this->assertSame(3, $exception->getCode());
     }
 
     public function testCustomExceptionCode()
diff --git a/packages/framework/tests/Unit/BuildTaskUnitTest.php b/packages/framework/tests/Unit/BuildTaskUnitTest.php
index fa5494f7407..48c49b8bbda 100644
--- a/packages/framework/tests/Unit/BuildTaskUnitTest.php
+++ b/packages/framework/tests/Unit/BuildTaskUnitTest.php
@@ -192,7 +192,7 @@ public function testTaskSkipping()
             })->run();
         });
 
-        $this->assertSame(0, $task->property('exitCode'));
+        $this->assertSame(3, $task->property('exitCode'));
         $this->assertSame('<bg=yellow>Skipped</>', trim($task->buffer[1]));
         $this->assertSame('<fg=gray> > Task was skipped</>', $task->buffer[2]);
     }
@@ -205,7 +205,7 @@ public function testTaskSkippingWithCustomMessage()
             })->run();
         });
 
-        $this->assertSame(0, $task->property('exitCode'));
+        $this->assertSame(3, $task->property('exitCode'));
         $this->assertSame('<bg=yellow>Skipped</>', trim($task->buffer[1]));
         $this->assertSame('<fg=gray> > Custom reason</>', $task->buffer[2]);
     }

From 7a3ad7fffeaac0caa3b72a738de9e2722b2ab9fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 15:56:14 +0200
Subject: [PATCH 2184/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c152c7a480a..0b412158291 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -29,6 +29,7 @@ This serves two purposes:
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
+- Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
 - Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
 - Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.

From ce34eecb6dfe2c72412c4b5cb9857cf165f2e262 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 16:54:27 +0200
Subject: [PATCH 2185/4023] Remove the deprecated global `unslash` function

---
 packages/framework/src/helpers.php | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 73be251439e..34e8f9da12b 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -4,7 +4,6 @@
 
 namespace {
     use Hyde\Foundation\HydeKernel;
-    use JetBrains\PhpStorm\Deprecated;
 
     if (! function_exists('hyde')) {
         /**
@@ -16,21 +15,6 @@ function hyde(): HydeKernel
         }
     }
 
-    if (! function_exists('unslash')) {
-        /**
-         * Remove trailing slashes from the start and end of a string.
-         *
-         * @deprecated This function will be replaced by {@see \Hyde\unslash()} in v2.0
-         *
-         * @codeCoverageIgnore This function is deprecated and will be removed in a future release.
-         */
-        #[Deprecated(reason: 'Replaced by the \Hyde\unslash() function', replacement: '\Hyde\unslash(%parametersList%)', since: '1.7.0')]
-        function unslash(string $string): string
-        {
-            return \Hyde\unslash($string);
-        }
-    }
-
     if (defined('HYDE_COMPATIBILITY_MODE') && HYDE_COMPATIBILITY_MODE === true) {
         // Don't declare these functions when running in compatibility mode.
     } else {

From 8a1e57f7be88e2461361d58be3b4cd0afab2c719 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 28 Jun 2024 16:55:46 +0200
Subject: [PATCH 2186/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0b412158291..48d8030036e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -44,6 +44,7 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
+- Internal: Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed

From ecbf74928f8714eec55cd9730f9a293629edb7aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 29 Jun 2024 09:41:00 +0200
Subject: [PATCH 2187/4023] Remove unintended internal marker from release
 notes

Fixes an issue from https://github.com/hydephp/develop/pull/1754/commits/8a1e57f7be88e2461361d58be3b4cd0afab2c719
---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 48d8030036e..99255b09e89 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -44,7 +44,7 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
-- Internal: Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
+- Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed

From e45185af6caa6c2b627f16fc2ae560ea7b00fcbf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 29 Jun 2024 10:49:30 +0200
Subject: [PATCH 2188/4023] Update URL helper to return null instead of
 throwing an exception

Updates the `Hyde::url()` helper to return null instead of throwing when no site URL is set
---
 RELEASE_NOTES.md                                         | 1 +
 .../src/Foundation/Concerns/ForwardsHyperlinks.php       | 2 +-
 packages/framework/src/Foundation/Kernel/Hyperlinks.php  | 9 +++------
 packages/framework/src/Hyde.php                          | 2 +-
 packages/framework/src/helpers.php                       | 2 +-
 packages/framework/tests/Feature/HelpersTest.php         | 2 --
 .../Unit/Foundation/HyperlinksUrlPathHelpersTest.php     | 8 ++------
 7 files changed, 9 insertions(+), 17 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 99255b09e89..476497696ce 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -28,6 +28,7 @@ This serves two purposes:
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
+- Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 9d194fd5f42..d5b87105f0e 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -33,7 +33,7 @@ public function asset(string $name, bool $preferQualifiedUrl = false): string
         return $this->hyperlinks->asset($name, $preferQualifiedUrl);
     }
 
-    public function url(string $path = ''): string
+    public function url(string $path = ''): ?string
     {
         return $this->hyperlinks->url($path);
     }
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 2a4a9aa9573..f94f79d3a24 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -7,7 +7,6 @@
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
-use Hyde\Framework\Exceptions\BaseUrlNotSetException;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -140,10 +139,9 @@ public function hasSiteUrl(): bool
      * Return a qualified URL to the supplied path if a base URL is set.
      *
      * @param  string  $path  An optional relative path suffix. Omit to return the base URL.
-     *
-     * @throws BaseUrlNotSetException If no site URL is set and no path is provided.
+     * @return string|null The qualified URL, or null if the base URL is not set and no path is provided.
      */
-    public function url(string $path = ''): string
+    public function url(string $path = ''): ?string
     {
         $path = $this->formatLink(trim($path, '/'));
 
@@ -162,8 +160,7 @@ public function url(string $path = ''): string
         }
 
         // User is trying to get the base URL, but it's not set
-        // This exception is deprecated and will be removed in v2.0.0, and we will return null instead.
-        throw new BaseUrlNotSetException();
+        return null;
     }
 
     /**
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 07d82d968fd..20b8313e897 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -38,7 +38,7 @@
  * @method static string relativeLink(string $destination)
  * @method static string mediaLink(string $destination, bool $validate = false)
  * @method static string asset(string $name, bool $preferQualifiedUrl = false)
- * @method static string url(string $path = '')
+ * @method static string|null url(string $path = '')
  * @method static Route|null route(string $key)
  * @method static string makeTitle(string $value)
  * @method static string normalizeNewlines(string $string)
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 34e8f9da12b..4f47188b222 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -42,7 +42,7 @@ function route(string $key): ?Hyde\Support\Models\Route
             /**
              * Get a qualified URL to the supplied path if a base URL is set.
              */
-            function url(string $path = ''): string
+            function url(string $path = ''): ?string
             {
                 return hyde()->url($path);
             }
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 61e4b31e645..4ea9d3a0c29 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -178,7 +178,6 @@ public function testUrlFunctionWithoutBaseUrl()
     public function testUrlFunctionWithoutBaseUrlOrPath()
     {
         $this->app['config']->set(['hyde.url' => null]);
-        $this->expectException(\Hyde\Framework\Exceptions\BaseUrlNotSetException::class);
         $this->assertNull(url());
     }
 
@@ -186,7 +185,6 @@ public function testUrlFunctionWithoutBaseUrlOrPath()
     public function testUrlFunctionWithLocalhostBaseUrlButNoPath()
     {
         $this->app['config']->set(['hyde.url' => 'http://localhost']);
-        $this->expectException(\Hyde\Framework\Exceptions\BaseUrlNotSetException::class);
         $this->assertNull(url());
     }
 
diff --git a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
index d228f3aee3d..cb541abb725 100644
--- a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
+++ b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
@@ -6,7 +6,6 @@
 
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Kernel\Hyperlinks;
-use Hyde\Framework\Exceptions\BaseUrlNotSetException;
 use Hyde\Testing\TestCase;
 
 /**
@@ -155,14 +154,11 @@ public function testQualifiedUrlHelperWithAlreadyQualifiedUrlStillFormatsPathWit
         $this->assertSame('http://localhost/foo/bar', $this->class->url('http://localhost/foo/bar/'));
     }
 
-    public function testQualifiedUrlThrowsExceptionWhenNoSiteUrlIsSet()
+    public function testQualifiedUrlReturnsNullWhenNoSiteUrlIsSet()
     {
         $this->withSiteUrl(null);
 
-        $this->expectException(BaseUrlNotSetException::class);
-        $this->expectExceptionMessage('No site URL has been set in config (or .env).');
-
-        $this->class->url();
+        $this->assertNull($this->class->url());
     }
 
     public function testHelperFallsBackToRelativeLinksWhenNoSiteUrlIsSet()

From 5ad8bdfb1cd2c2df6cc38368c694972e438ef04b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 29 Jun 2024 10:59:01 +0200
Subject: [PATCH 2189/4023] Remove the deprecated `BaseUrlNotSetException`
 class

---
 RELEASE_NOTES.md                              |  1 +
 .../Exceptions/BaseUrlNotSetException.php     | 19 -------------------
 .../tests/Unit/CustomExceptionsTest.php       | 12 ------------
 .../HyperlinksUrlPathHelpersTest.php          |  1 -
 4 files changed, 1 insertion(+), 32 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Exceptions/BaseUrlNotSetException.php

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 476497696ce..1394f0ca38f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -46,6 +46,7 @@ This serves two purposes:
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
+- Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now returning `null` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed
diff --git a/packages/framework/src/Framework/Exceptions/BaseUrlNotSetException.php b/packages/framework/src/Framework/Exceptions/BaseUrlNotSetException.php
deleted file mode 100644
index 41a5482e1bc..00000000000
--- a/packages/framework/src/Framework/Exceptions/BaseUrlNotSetException.php
+++ /dev/null
@@ -1,19 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Exceptions;
-
-use Exception;
-
-/**
- * @deprecated This exception will be removed in v2.0.0.
- */
-class BaseUrlNotSetException extends Exception
-{
-    /** @var string */
-    protected $message = 'No site URL has been set in config (or .env).';
-
-    /** @var int */
-    protected $code = 500;
-}
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index e3894eec0a0..38be357f085 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -9,7 +9,6 @@
 use Hyde\Framework\Exceptions\FileConflictException;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
-use Hyde\Framework\Exceptions\BaseUrlNotSetException;
 use Hyde\Framework\Exceptions\UnsupportedPageTypeException;
 use Hyde\Framework\Exceptions\ParseException;
 use RuntimeException;
@@ -19,7 +18,6 @@
  * @covers \Hyde\Framework\Exceptions\FileConflictException
  * @covers \Hyde\Framework\Exceptions\FileNotFoundException
  * @covers \Hyde\Framework\Exceptions\RouteNotFoundException
- * @covers \Hyde\Framework\Exceptions\BaseUrlNotSetException
  * @covers \Hyde\Framework\Exceptions\UnsupportedPageTypeException
  * @covers \Hyde\Framework\Exceptions\ParseException
  */
@@ -82,11 +80,6 @@ public function testUnsupportedPageTypeExceptionWithPage()
         $this->assertSame('The page type [foo] is not supported.', (new UnsupportedPageTypeException('foo'))->getMessage());
     }
 
-    public function testBaseUrlNotSetException()
-    {
-        $this->assertSame('No site URL has been set in config (or .env).', (new BaseUrlNotSetException())->getMessage());
-    }
-
     public function testFileConflictExceptionCode()
     {
         $this->assertSame(409, (new FileConflictException())->getCode());
@@ -107,11 +100,6 @@ public function testUnsupportedPageTypeExceptionCode()
         $this->assertSame(400, (new UnsupportedPageTypeException())->getCode());
     }
 
-    public function testBaseUrlNotSetExceptionCode()
-    {
-        $this->assertSame(500, (new BaseUrlNotSetException())->getCode());
-    }
-
     public function testParseExceptionCode()
     {
         $this->assertSame(422, (new ParseException())->getCode());
diff --git a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
index cb541abb725..14b18821ce3 100644
--- a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
+++ b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
@@ -10,7 +10,6 @@
 
 /**
  * @covers \Hyde\Foundation\Kernel\Hyperlinks
- * @covers \Hyde\Framework\Exceptions\BaseUrlNotSetException
  */
 class HyperlinksUrlPathHelpersTest extends TestCase
 {

From 517015a06b8c874503c8e1f2c136dd0f6bc43842 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 29 Jun 2024 22:13:57 +0200
Subject: [PATCH 2190/4023] Sync configuration files

Commit https://github.com/hydephp/develop/commit/b9f8e3dca0ce71e46394d8f8cb1b110a1527a889 missed to do this
---
 packages/framework/config/docs.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/config/docs.php b/packages/framework/config/docs.php
index 93bbc751dc2..4ac1dd70706 100644
--- a/packages/framework/config/docs.php
+++ b/packages/framework/config/docs.php
@@ -30,9 +30,8 @@
         // When using a grouped sidebar, should the groups be collapsible?
         'collapsible' => true,
 
-        // Should the sidebar footer be shown? You can also set this to a string
-        // of Markdown to show in the footer. Set to `false` to disable.
-        'footer' => true,
+        // A string of Markdown to show in the footer. Set to `false` to disable.
+        'footer' => '[Back to home page](../)',
 
         /*
         |--------------------------------------------------------------------------

From f369a3a85f1c4916b3b6ae160e0f7e40a2cc5c74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:34:17 +0200
Subject: [PATCH 2191/4023] Update class documentation

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index ac6b850bf94..37baa790fb9 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -13,7 +13,7 @@
 use function is_string;
 
 /**
- * Object representation of a post author for the site.
+ * Object representation of a blog post author for the site.
  */
 class PostAuthor implements Stringable
 {

From 576f94f11f5f59362b76182f888fae64cb4ecb9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:38:33 +0200
Subject: [PATCH 2192/4023] Create HasKernelData.php

---
 .../src/Foundation/Concerns/HasKernelData.php     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/src/Foundation/Concerns/HasKernelData.php

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
new file mode 100644
index 00000000000..b5fb4572249
--- /dev/null
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Foundation\Concerns;
+
+/**
+ * @internal Single-use trait for the HydeKernel class.
+ *
+ * @see \Hyde\Foundation\HydeKernel
+ */
+trait HasKernelData
+{
+    //
+}

From eba7450288660ecb45955e290912ecca86e54e7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:38:43 +0200
Subject: [PATCH 2193/4023] Use HasKernelData trait

---
 packages/framework/src/Foundation/HydeKernel.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index d52af53fda1..a41dd3371df 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -45,6 +45,7 @@ class HydeKernel implements SerializableContract
     use Concerns\ManagesExtensions;
     use Concerns\ManagesViewData;
     use Concerns\BootsHydeKernel;
+    use Concerns\HasKernelData;
 
     use Serializable;
     use Macroable;

From 863ce8a28af2ba04197740602b4a9d8faac2c7c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:39:11 +0200
Subject: [PATCH 2194/4023] Update class description

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index b5fb4572249..0fcb0ca828d 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -5,6 +5,8 @@
 namespace Hyde\Foundation\Concerns;
 
 /**
+ * Contains accessors and containers for data stored in the kernel.
+ *
  * @internal Single-use trait for the HydeKernel class.
  *
  * @see \Hyde\Foundation\HydeKernel

From 90027fda406f5d7b317ce72857299ae6d9ffee2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:40:46 +0200
Subject: [PATCH 2195/4023] Add authors array to the kernel

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 0fcb0ca828d..032a39984cd 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -13,5 +13,5 @@
  */
 trait HasKernelData
 {
-    //
+    protected array $authors = [];
 }

From 88ef93006b46a9b630ced4feff138487966b2375 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:41:06 +0200
Subject: [PATCH 2196/4023] Change array to Collection

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 032a39984cd..00ebfdbb04a 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Illuminate\Support\Collection;
+
 /**
  * Contains accessors and containers for data stored in the kernel.
  *
@@ -13,5 +15,5 @@
  */
 trait HasKernelData
 {
-    protected array $authors = [];
+    protected Collection $authors = [];
 }

From 7de564011bc2d3e8b8135c75fa1a4da3044785d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:41:17 +0200
Subject: [PATCH 2197/4023] Remove disallowed initialiser

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 00ebfdbb04a..95c33ee5a1e 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -15,5 +15,5 @@
  */
 trait HasKernelData
 {
-    protected Collection $authors = [];
+    protected Collection $authors;
 }

From 25d03bd9f3c03d4542f61202507c7b9acdba6fa9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:41:40 +0200
Subject: [PATCH 2198/4023] Annotate the collection generics

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 95c33ee5a1e..b319459b75c 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -15,5 +15,8 @@
  */
 trait HasKernelData
 {
+    /**
+     * @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
+     */
     protected Collection $authors;
 }

From d40d8ed2207c4749bf922d92efa619032ddafd78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:41:47 +0200
Subject: [PATCH 2199/4023] Document the property

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index b319459b75c..59437fb2caa 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -16,6 +16,8 @@
 trait HasKernelData
 {
     /**
+     * The collection of authors defined in the config.
+     *
      * @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
      */
     protected Collection $authors;

From d23a697f83a5aede30665935fb373e0043946c11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:42:26 +0200
Subject: [PATCH 2200/4023] Add authors getter

---
 .../src/Foundation/Concerns/HasKernelData.php          | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 59437fb2caa..ce989cefe79 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -21,4 +21,14 @@ trait HasKernelData
      * @var \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
      */
     protected Collection $authors;
+
+    /**
+     * Get the collection of authors defined in the config.
+     *
+     * @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
+     */
+    public function getAuthors(): Collection
+    {
+        return $this->authors;
+    }
 }

From 9a4524f302513ecdf1ca72745547f3b7073ffcdc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:47:00 +0200
Subject: [PATCH 2201/4023] Class PostAuthor implements SerializableContract

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 37baa790fb9..e3a8eade213 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -8,6 +8,7 @@
 use Hyde\Facades\Author;
 use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
+use Hyde\Support\Contracts\SerializableContract;
 
 use function strtolower;
 use function is_string;
@@ -15,7 +16,7 @@
 /**
  * Object representation of a blog post author for the site.
  */
-class PostAuthor implements Stringable
+class PostAuthor implements Stringable, SerializableContract
 {
     /**
      * The username of the author.

From 3b5bf3a57094b1b8249ccb2ab1b9ed0954b6c36d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:47:39 +0200
Subject: [PATCH 2202/4023] Use the Serializable trait

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index e3a8eade213..56a3480937e 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -8,6 +8,7 @@
 use Hyde\Facades\Author;
 use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
+use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 
 use function strtolower;
@@ -18,6 +19,8 @@
  */
 class PostAuthor implements Stringable, SerializableContract
 {
+    use Serializable;
+
     /**
      * The username of the author.
      * This is the key used to find authors in the config.

From 11a8f368d0a81a5a7acc887b4f7d0700bc2f7851 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:48:12 +0200
Subject: [PATCH 2203/4023] Implement the toArray method

---
 .../Framework/Features/Blogging/Models/PostAuthor.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 56a3480937e..fc22e534600 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -89,6 +89,15 @@ public function __toString(): string
         return $this->getName();
     }
 
+    public function toArray(): array
+    {
+        return [
+            'username' => $this->username,
+            'name' => $this->name,
+            'website' => $this->website,
+        ];
+    }
+
     public function getName(): string
     {
         return $this->name ?? $this->username;

From d21b4f3333285080ad3b20126fd047b96fcef0bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:49:52 +0200
Subject: [PATCH 2204/4023] Test author serialization

---
 .../framework/tests/Unit/PostAuthorTest.php   | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index c6c98a9c5aa..9b3eeae5fba 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -140,4 +140,51 @@ public function testToStringHelperReturnsTheName()
 
         $this->assertEquals('John Doe', (string) $author);
     }
+
+    public function testToArrayMethodReturnsArrayRepresentationOfAuthor()
+    {
+        $author = new PostAuthor('username', 'John Doe', 'https://example.com');
+
+        $this->assertEquals([
+            'username' => 'username',
+            'name' => 'John Doe',
+            'website' => 'https://example.com',
+        ], $author->toArray());
+    }
+
+    public function testJsonSerializeMethodReturnsArrayRepresentationOfAuthor()
+    {
+        $author = new PostAuthor('username', 'John Doe', 'https://example.com');
+
+        $this->assertEquals([
+            'username' => 'username',
+            'name' => 'John Doe',
+            'website' => 'https://example.com',
+        ], $author->jsonSerialize());
+    }
+
+    public function testArraySerializeMethodReturnsArrayRepresentationOfAuthor()
+    {
+        $author = new PostAuthor('username', 'John Doe', 'https://example.com');
+
+        $this->assertEquals([
+            'username' => 'username',
+            'name' => 'John Doe',
+            'website' => 'https://example.com',
+        ], $author->arraySerialize());
+    }
+
+    public function testToJsonMethodReturnsJsonRepresentationOfAuthor()
+    {
+        $author = new PostAuthor('username', 'John Doe', 'https://example.com');
+
+        $this->assertEquals('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', $author->toJson());
+    }
+
+    public function testCanJsonEncodeAuthor()
+    {
+        $author = new PostAuthor('username', 'John Doe', 'https://example.com');
+
+        $this->assertEquals('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', json_encode($author));
+    }
 }

From 0b2b1e763feaee45b7f53b8fbb5d33a035f279f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:50:02 +0200
Subject: [PATCH 2205/4023] Normalize formatting

---
 packages/framework/tests/Unit/PostAuthorTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 9b3eeae5fba..0e7469342d1 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -56,6 +56,7 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
             'name' => 'bar',
             'website' => 'https://example.com',
         ]);
+
         $this->assertEquals($author, Author::create('foo', 'bar', 'https://example.com'));
     }
 

From 142bdb563b5d92ad69af9b401b4c2765fe95a0de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:59:42 +0200
Subject: [PATCH 2206/4023] Update kernel test to test the author access

---
 .../framework/tests/Feature/HydeKernelTest.php  | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index a5ea908354c..e6de52158a8 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -23,6 +23,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\HtmlString;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
 /**
  * This test class runs high-level tests on the HydeKernel class,
@@ -528,6 +529,22 @@ public function testFeaturesClassIsBoundAsSingleton()
 
         $this->assertSame($kernel->features(), $kernel->features());
     }
+
+    public function testGetAuthors()
+    {
+        $kernel = new HydeKernel();
+
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, $kernel->getAuthors());
+        $this->assertContainsOnlyInstancesOf(PostAuthor::class, $kernel->getAuthors());
+
+        $this->assertSame([
+            'mr_hyde' => [
+                'username' => 'mr_hyde',
+                'name' => 'Mr. Hyde',
+                'website' => 'https://hydephp.com',
+            ],
+        ], $kernel->getAuthors()->toArray());
+    }
 }
 
 class CallableClass

From 6cd24fcb1ac74633f0a013d676c9d8b9c5eec5bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 18:59:57 +0200
Subject: [PATCH 2207/4023] Null coalesce assign the authors data

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index ce989cefe79..30d948feba1 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Concerns;
 
 use Illuminate\Support\Collection;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
 /**
  * Contains accessors and containers for data stored in the kernel.
@@ -29,6 +30,6 @@ trait HasKernelData
      */
     public function getAuthors(): Collection
     {
-        return $this->authors;
+        return $this->authors ??= PostAuthor::all();
     }
 }

From 6c55b2d938cae0d5204174cd240f532a9c9defee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:00:50 +0200
Subject: [PATCH 2208/4023] Add additional kernel author tests

---
 .../framework/tests/Feature/HydeKernelTest.php  | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index e6de52158a8..f7dd6223ef8 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -545,6 +545,23 @@ public function testGetAuthors()
             ],
         ], $kernel->getAuthors()->toArray());
     }
+
+    public function testGetAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
+    {
+        $kernel = new HydeKernel();
+
+        Config::set('hyde', []);
+
+        $this->assertInstanceOf(\Illuminate\Support\Collection::class, $kernel->getAuthors());
+        $this->assertEmpty($kernel->getAuthors());
+    }
+
+    public function testGetAuthorsReturnsSingletonCollection()
+    {
+        $kernel = new HydeKernel();
+
+        $this->assertSame($kernel->getAuthors(), $kernel->getAuthors());
+    }
 }
 
 class CallableClass

From ad535d61b7b4962fadbc39b049bdfef7b5b32f85 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:01:13 +0200
Subject: [PATCH 2209/4023] Replace qualifiers with an import

---
 packages/framework/tests/Feature/HydeKernelTest.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index f7dd6223ef8..ded8ce2ae7f 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Features;
 use Hyde\Foundation\Facades\Pages;
+use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Enums\Feature;
@@ -534,7 +535,7 @@ public function testGetAuthors()
     {
         $kernel = new HydeKernel();
 
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, $kernel->getAuthors());
+        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
         $this->assertContainsOnlyInstancesOf(PostAuthor::class, $kernel->getAuthors());
 
         $this->assertSame([
@@ -552,7 +553,7 @@ public function testGetAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
 
         Config::set('hyde', []);
 
-        $this->assertInstanceOf(\Illuminate\Support\Collection::class, $kernel->getAuthors());
+        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
         $this->assertEmpty($kernel->getAuthors());
     }
 

From 64f3e3617970cc706d96884dabbb0bfc9f42fdd1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:01:49 +0200
Subject: [PATCH 2210/4023] Reorder tests

---
 .../framework/tests/Feature/HydeKernelTest.php     | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index ded8ce2ae7f..2ac39e67970 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -547,21 +547,21 @@ public function testGetAuthors()
         ], $kernel->getAuthors()->toArray());
     }
 
-    public function testGetAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
+    public function testGetAuthorsReturnsSingletonCollection()
     {
         $kernel = new HydeKernel();
 
-        Config::set('hyde', []);
-
-        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
-        $this->assertEmpty($kernel->getAuthors());
+        $this->assertSame($kernel->getAuthors(), $kernel->getAuthors());
     }
 
-    public function testGetAuthorsReturnsSingletonCollection()
+    public function testGetAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
     {
         $kernel = new HydeKernel();
 
-        $this->assertSame($kernel->getAuthors(), $kernel->getAuthors());
+        Config::set('hyde', []);
+
+        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
+        $this->assertEmpty($kernel->getAuthors());
     }
 }
 

From c36bcaf5c26c6bfbd83cba87e68d6946cd394943 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:03:24 +0200
Subject: [PATCH 2211/4023] Assert same for scalar values

---
 .../framework/tests/Unit/PostAuthorTest.php   | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 0e7469342d1..b12bba78e52 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -29,9 +29,9 @@ public function testCreateMethodAcceptsAllParameters()
     {
         $author = Author::create('foo', 'bar', 'https://example.com');
 
-        $this->assertEquals('foo', $author->username);
-        $this->assertEquals('bar', $author->name);
-        $this->assertEquals('https://example.com', $author->website);
+        $this->assertSame('foo', $author->username);
+        $this->assertSame('bar', $author->name);
+        $this->assertSame('https://example.com', $author->website);
     }
 
     public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
@@ -108,8 +108,8 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
         $author = PostAuthor::get('foo');
 
         $this->assertInstanceOf(PostAuthor::class, $author);
-        $this->assertEquals('foo', $author->username);
-        $this->assertEquals('bar', $author->name);
+        $this->assertSame('foo', $author->username);
+        $this->assertSame('bar', $author->name);
     }
 
     public function testGetMethodReturnsNewAuthorIfUsernameNotFoundInConfig()
@@ -118,28 +118,28 @@ public function testGetMethodReturnsNewAuthorIfUsernameNotFoundInConfig()
         $author = PostAuthor::get('foo');
 
         $this->assertInstanceOf(PostAuthor::class, $author);
-        $this->assertEquals('foo', $author->username);
+        $this->assertSame('foo', $author->username);
     }
 
     public function testGetNameHelperReturnsNameIfSet()
     {
         $author = new PostAuthor('username', 'John Doe');
 
-        $this->assertEquals('John Doe', $author->getName());
+        $this->assertSame('John Doe', $author->getName());
     }
 
     public function testGetNameHelperReturnsUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');
 
-        $this->assertEquals('username', $author->getName());
+        $this->assertSame('username', $author->getName());
     }
 
     public function testToStringHelperReturnsTheName()
     {
         $author = new PostAuthor('username', 'John Doe');
 
-        $this->assertEquals('John Doe', (string) $author);
+        $this->assertSame('John Doe', (string) $author);
     }
 
     public function testToArrayMethodReturnsArrayRepresentationOfAuthor()
@@ -179,13 +179,13 @@ public function testToJsonMethodReturnsJsonRepresentationOfAuthor()
     {
         $author = new PostAuthor('username', 'John Doe', 'https://example.com');
 
-        $this->assertEquals('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', $author->toJson());
+        $this->assertSame('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', $author->toJson());
     }
 
     public function testCanJsonEncodeAuthor()
     {
         $author = new PostAuthor('username', 'John Doe', 'https://example.com');
 
-        $this->assertEquals('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', json_encode($author));
+        $this->assertSame('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', json_encode($author));
     }
 }

From 7a90a2a9262d1a59533ff1645f33ac8d36768fea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:03:48 +0200
Subject: [PATCH 2212/4023] Filter empty fields from serialization

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php  | 5 +++--
 packages/framework/tests/Unit/PostAuthorTest.php           | 7 +++++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index fc22e534600..e0b4b22a3b7 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -13,6 +13,7 @@
 
 use function strtolower;
 use function is_string;
+use function array_filter;
 
 /**
  * Object representation of a blog post author for the site.
@@ -91,11 +92,11 @@ public function __toString(): string
 
     public function toArray(): array
     {
-        return [
+        return array_filter([
             'username' => $this->username,
             'name' => $this->name,
             'website' => $this->website,
-        ];
+        ]);
     }
 
     public function getName(): string
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index b12bba78e52..c48264f8c9d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -188,4 +188,11 @@ public function testCanJsonEncodeAuthor()
 
         $this->assertSame('{"username":"username","name":"John Doe","website":"https:\/\/example.com"}', json_encode($author));
     }
+
+    public function testEmptyFieldsAreRemovedFromSerializedModel()
+    {
+        $author = new PostAuthor('username', null, null);
+
+        $this->assertSame('{"username":"username"}', $author->toJson());
+    }
 }

From 0811dc92c7b6ea6198964778b24bb47b7b16538a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:09:22 +0200
Subject: [PATCH 2213/4023] Add semantic testing helper to reset the kernel

---
 packages/testing/src/UnitTestCase.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index cb0b4a48a43..23e6083a903 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -40,6 +40,11 @@ protected static function setupKernel(): void
         self::$hasSetUpKernel = true;
     }
 
+    protected static function resetKernel(): void
+    {
+        HydeKernel::setInstance(new HydeKernel());
+    }
+
     protected static function mockConfig(array $items = []): void
     {
         app()->bind('config', fn (): Repository => new Repository($items));

From 82ac9e38788a15e9e75fe1e798fef992f7d524f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:09:44 +0200
Subject: [PATCH 2214/4023] Move author discovery logic to kernel

---
 .../framework/src/Foundation/Concerns/HasKernelData.php    | 7 ++++++-
 .../src/Framework/Features/Blogging/Models/PostAuthor.php  | 6 ++----
 packages/framework/tests/Unit/PostAuthorTest.php           | 7 +++++++
 3 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 30d948feba1..b9c0ecb6983 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -4,9 +4,12 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
+use function strtolower;
+
 /**
  * Contains accessors and containers for data stored in the kernel.
  *
@@ -30,6 +33,8 @@ trait HasKernelData
      */
     public function getAuthors(): Collection
     {
-        return $this->authors ??= PostAuthor::all();
+        return $this->authors ??= (new Collection(Config::getArray('hyde.authors', [])))->mapWithKeys(function (PostAuthor $author): array {
+            return [strtolower($author->username) => $author];
+        });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index e0b4b22a3b7..5047f9ee5e0 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -4,9 +4,9 @@
 
 namespace Hyde\Framework\Features\Blogging\Models;
 
+use Hyde\Hyde;
 use Stringable;
 use Hyde\Facades\Author;
-use Hyde\Facades\Config;
 use Illuminate\Support\Collection;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
@@ -80,9 +80,7 @@ public static function get(string $username): static
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
     public static function all(): Collection
     {
-        return (new Collection(Config::getArray('hyde.authors', [])))->mapWithKeys(function (self $author): array {
-            return [strtolower($author->username) => $author];
-        });
+        return Hyde::getAuthors();
     }
 
     public function __toString(): string
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index c48264f8c9d..f53c414013f 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -18,6 +18,13 @@ class PostAuthorTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        self::resetKernel();
+    }
+
     public function testCreateMethodCreatesNewAuthorModel()
     {
         $author = Author::create('foo');

From 701fbbc4caee9e908d392f5dd42c5dc844c72842 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:15:12 +0200
Subject: [PATCH 2215/4023] Defer setting the authors property until the next
 try

---
 .../src/Foundation/Concerns/HasKernelData.php       | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index b9c0ecb6983..0c8ca7481f4 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -33,7 +33,18 @@ trait HasKernelData
      */
     public function getAuthors(): Collection
     {
-        return $this->authors ??= (new Collection(Config::getArray('hyde.authors', [])))->mapWithKeys(function (PostAuthor $author): array {
+        if (isset($this->authors)) {
+            return $this->authors;
+        }
+
+        $config = new Collection(Config::getArray('hyde.authors', []));
+
+        if ($config->isEmpty()) {
+            // Defer setting the authors property until the next try.
+            return new Collection();
+        }
+
+        return $this->authors ??= $config->mapWithKeys(function (PostAuthor $author): array {
             return [strtolower($author->username) => $author];
         });
     }

From f02091ddc95933026b17ea0829cc8d3d2f718d4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:15:40 +0200
Subject: [PATCH 2216/4023] Remove getter prefix from kernel author accessor

 We don't use this for other kernel collections
---
 .../src/Foundation/Concerns/HasKernelData.php  |  2 +-
 .../Features/Blogging/Models/PostAuthor.php    |  2 +-
 .../framework/tests/Feature/HydeKernelTest.php | 18 +++++++++---------
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 0c8ca7481f4..841e2131795 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -31,7 +31,7 @@ trait HasKernelData
      *
      * @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
      */
-    public function getAuthors(): Collection
+    public function authors(): Collection
     {
         if (isset($this->authors)) {
             return $this->authors;
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 5047f9ee5e0..d3d2818c754 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -80,7 +80,7 @@ public static function get(string $username): static
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
     public static function all(): Collection
     {
-        return Hyde::getAuthors();
+        return Hyde::authors();
     }
 
     public function __toString(): string
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 2ac39e67970..0181cb0e212 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -531,12 +531,12 @@ public function testFeaturesClassIsBoundAsSingleton()
         $this->assertSame($kernel->features(), $kernel->features());
     }
 
-    public function testGetAuthors()
+    public function testAuthors()
     {
         $kernel = new HydeKernel();
 
-        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
-        $this->assertContainsOnlyInstancesOf(PostAuthor::class, $kernel->getAuthors());
+        $this->assertInstanceOf(Collection::class, $kernel->authors());
+        $this->assertContainsOnlyInstancesOf(PostAuthor::class, $kernel->authors());
 
         $this->assertSame([
             'mr_hyde' => [
@@ -544,24 +544,24 @@ public function testGetAuthors()
                 'name' => 'Mr. Hyde',
                 'website' => 'https://hydephp.com',
             ],
-        ], $kernel->getAuthors()->toArray());
+        ], $kernel->authors()->toArray());
     }
 
-    public function testGetAuthorsReturnsSingletonCollection()
+    public function testAuthorsReturnsSingletonCollection()
     {
         $kernel = new HydeKernel();
 
-        $this->assertSame($kernel->getAuthors(), $kernel->getAuthors());
+        $this->assertSame($kernel->authors(), $kernel->authors());
     }
 
-    public function testGetAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
+    public function testAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
     {
         $kernel = new HydeKernel();
 
         Config::set('hyde', []);
 
-        $this->assertInstanceOf(Collection::class, $kernel->getAuthors());
-        $this->assertEmpty($kernel->getAuthors());
+        $this->assertInstanceOf(Collection::class, $kernel->authors());
+        $this->assertEmpty($kernel->authors());
     }
 }
 

From f445f24fb8b28eac5ba1a0b22522a6f4b6bf74e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:19:05 +0200
Subject: [PATCH 2217/4023] Annotate the authors method

---
 packages/framework/src/Hyde.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 20b8313e897..c431e41dbe7 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -7,10 +7,12 @@
 use Hyde\Enums\Feature;
 use Hyde\Facades\Features;
 use Hyde\Foundation\HydeKernel;
+use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Pages\Concerns\HydePage;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Filesystem\SourceFile;
@@ -53,6 +55,7 @@
  * @method static string getMediaDirectory()
  * @method static string getMediaOutputDirectory()
  * @method static Features features()
+ * @method static Collection<string, PostAuthor> authors()
  * @method static FileCollection<SourceFile> files()
  * @method static PageCollection<HydePage> pages()
  * @method static RouteCollection<Route> routes()

From 84289ecd12985139f755008481c591bd6c88b1f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:23:18 +0200
Subject: [PATCH 2218/4023] Clean up formatting

---
 packages/framework/tests/Unit/PostAuthorTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index f53c414013f..041c808f6cb 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -86,6 +86,7 @@ public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
         Config::set('hyde.authors', [
             Author::create('foo'),
         ]);
+
         $authors = PostAuthor::all();
 
         $this->assertInstanceOf(Collection::class, $authors);
@@ -99,6 +100,7 @@ public function testMultipleAuthorsCanBeDefinedInConfig()
             Author::create('foo'),
             Author::create('bar'),
         ]);
+
         $authors = PostAuthor::all();
 
         $this->assertInstanceOf(Collection::class, $authors);

From d82a8f4593cc3bb5a824c8f3e3a14b7efba6c85d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:23:25 +0200
Subject: [PATCH 2219/4023] Test authors property is not written until there
 are authors defined

---
 .../framework/tests/Feature/HydeKernelTest.php     | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 0181cb0e212..20a31f080a5 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Facades\Author;
 use Hyde\Facades\Features;
 use Hyde\Foundation\Facades\Pages;
 use Illuminate\Support\Collection;
@@ -563,6 +564,19 @@ public function testAuthorsReturnsEmptyCollectionWhenNoAuthorsDefined()
         $this->assertInstanceOf(Collection::class, $kernel->authors());
         $this->assertEmpty($kernel->authors());
     }
+
+    public function testAuthorsPropertyIsNotWrittenUntilThereAreAuthorsDefined()
+    {
+        $kernel = new HydeKernel();
+
+        Config::set('hyde', []);
+
+        $this->assertEmpty($kernel->authors()->toArray());
+
+        Config::set('hyde.authors', [Author::create('foo')]);
+
+        $this->assertNotEmpty($kernel->authors()->toArray());
+    }
 }
 
 class CallableClass

From 5b06ff49c8b51bc791b18a2083aedeaebf4f3539 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:30:29 +0200
Subject: [PATCH 2220/4023] Return the empty collection instead of creating a
 new one

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 841e2131795..dadef62aefa 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -41,7 +41,7 @@ public function authors(): Collection
 
         if ($config->isEmpty()) {
             // Defer setting the authors property until the next try.
-            return new Collection();
+            return $config;
         }
 
         return $this->authors ??= $config->mapWithKeys(function (PostAuthor $author): array {

From 8be7284fc5422cf719eeeff963f8e073a236a2c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:31:00 +0200
Subject: [PATCH 2221/4023] Remove null coalesce part of evaluated assignment

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index dadef62aefa..5b3238f2d96 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -44,7 +44,7 @@ public function authors(): Collection
             return $config;
         }
 
-        return $this->authors ??= $config->mapWithKeys(function (PostAuthor $author): array {
+        return $this->authors = $config->mapWithKeys(function (PostAuthor $author): array {
             return [strtolower($author->username) => $author];
         });
     }

From aff2083dcfcf06f948698402c85966e35daa3a81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:31:55 +0200
Subject: [PATCH 2222/4023] Extract helper method for parsing the authors

---
 .../framework/src/Foundation/Concerns/HasKernelData.php    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 5b3238f2d96..dd982feac3a 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -44,7 +44,12 @@ public function authors(): Collection
             return $config;
         }
 
-        return $this->authors = $config->mapWithKeys(function (PostAuthor $author): array {
+        return $this->authors = $this->parseConfigurationAuthors($config);
+    }
+
+    protected function parseConfigurationAuthors(Collection $authors): Collection
+    {
+        return $authors->mapWithKeys(function (PostAuthor $author): array {
             return [strtolower($author->username) => $author];
         });
     }

From 7a230e97ad4991e890ad69e2b0c0d5123cbb53de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 19:39:50 +0200
Subject: [PATCH 2223/4023] Update the blog post author configuration to be
 keyed by the usernames

> We may also want to consider keying the array, to make the username relationship more explicit. This means we would do this for v2.

See https://github.com/hydephp/develop/issues/1778
---
 config/hyde.php                                       |  2 +-
 packages/framework/config/hyde.php                    |  2 +-
 .../src/Foundation/Concerns/HasKernelData.php         |  6 ++----
 packages/framework/tests/Feature/HydeKernelTest.php   | 11 +++++++++++
 4 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 5e74e0784e2..9d6301a1bf7 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -284,7 +284,7 @@
     */
 
     'authors' => [
-        Author::create(
+        'mr_hyde' => Author::create(
             'mr_hyde', // Required username
             'Mr. Hyde', // Optional display name
             'https://hydephp.com' // Optional website URL
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 5e74e0784e2..9d6301a1bf7 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -284,7 +284,7 @@
     */
 
     'authors' => [
-        Author::create(
+        'mr_hyde' => Author::create(
             'mr_hyde', // Required username
             'Mr. Hyde', // Optional display name
             'https://hydephp.com' // Optional website URL
diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index dd982feac3a..2c0b34f9618 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -8,8 +8,6 @@
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
-use function strtolower;
-
 /**
  * Contains accessors and containers for data stored in the kernel.
  *
@@ -49,8 +47,8 @@ public function authors(): Collection
 
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
-        return $authors->mapWithKeys(function (PostAuthor $author): array {
-            return [strtolower($author->username) => $author];
+        return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
+            return [$username ?: $author->username => $author];
         });
     }
 }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 20a31f080a5..3732dc52878 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -577,6 +577,17 @@ public function testAuthorsPropertyIsNotWrittenUntilThereAreAuthorsDefined()
 
         $this->assertNotEmpty($kernel->authors()->toArray());
     }
+
+    public function testAuthorsUseTheConfigArrayKey()
+    {
+        Config::set('hyde.authors', ['foo' => Author::create('bar')]);
+
+        $this->assertSame([
+            'foo' => [
+                'username' => 'bar',
+            ],
+        ], Hyde::authors()->toArray());
+    }
 }
 
 class CallableClass

From 1faaa167abb873ef6813ed9e4631b5ebe44379ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:28:57 +0200
Subject: [PATCH 2224/4023] Update the kernel array representation to include
 the site authors

---
 packages/framework/src/Foundation/HydeKernel.php    | 1 +
 packages/framework/tests/Feature/HydeKernelTest.php | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/HydeKernel.php b/packages/framework/src/Foundation/HydeKernel.php
index a41dd3371df..86b0c9c2bae 100644
--- a/packages/framework/src/Foundation/HydeKernel.php
+++ b/packages/framework/src/Foundation/HydeKernel.php
@@ -110,6 +110,7 @@ public function toArray(): array
             'files' => $this->files(),
             'pages' => $this->pages(),
             'routes' => $this->routes(),
+            'authors' => $this->authors(),
         ];
     }
 }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 3732dc52878..7d67c6203ed 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -283,6 +283,7 @@ public function testToArrayMethod()
             'files' => Hyde::files(),
             'pages' => Hyde::pages(),
             'routes' => Hyde::routes(),
+            'authors' => Hyde::authors(),
         ], Hyde::toArray());
     }
 

From 8891c8fd49b97cffb77de9eab4dbec0b3ff107bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:38:16 +0200
Subject: [PATCH 2225/4023] Clarify documentation

---
 docs/creating-content/blog-posts.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index 70f4b454e26..b50cc96fdf5 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -156,7 +156,7 @@ author:
 ```
 
 When specifying an array you don't need all the sub-properties. The example just shows all the supported values.
-Array values here will override all the values in the `authors` config entry.
+Array values here will override all the values in the `authors` config entry, if one exists.
 
 ### Image
 

From 4d5a936e56f2c9add6ce40fe61af16313f6064d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:47:15 +0200
Subject: [PATCH 2226/4023] Add base constructor tests

---
 packages/framework/tests/Unit/PostAuthorTest.php | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 041c808f6cb..a6da7cdcd48 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -25,6 +25,22 @@ protected function setUp(): void
         self::resetKernel();
     }
 
+    public function testCanCreateAuthorModel()
+    {
+        $author = new PostAuthor('foo');
+
+        $this->assertInstanceOf(PostAuthor::class, $author);
+    }
+
+    public function testCanCreateAuthorModelWithDetails()
+    {
+        $author = new PostAuthor('foo', 'bar', 'https://example.com');
+
+        $this->assertSame('foo', $author->username);
+        $this->assertSame('bar', $author->name);
+        $this->assertSame('https://example.com', $author->website);
+    }
+
     public function testCreateMethodCreatesNewAuthorModel()
     {
         $author = Author::create('foo');

From 0dfb841b809d41149ba870b69d09baacf072e18d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:50:01 +0200
Subject: [PATCH 2227/4023] Update post author name to fall back to username at
 construct time

---
 .../Framework/Features/Blogging/Models/PostAuthor.php    | 4 ++--
 packages/framework/tests/Feature/HydeKernelTest.php      | 1 +
 packages/framework/tests/Feature/MarkdownPostTest.php    | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php         | 9 ++++++++-
 4 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index d3d2818c754..142b74e7896 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -53,7 +53,7 @@ class PostAuthor implements Stringable, SerializableContract
     public function __construct(string $username, ?string $name = null, ?string $website = null)
     {
         $this->username = $username;
-        $this->name = $name;
+        $this->name = $name ?? $username;
         $this->website = $website;
     }
 
@@ -99,7 +99,7 @@ public function toArray(): array
 
     public function getName(): string
     {
-        return $this->name ?? $this->username;
+        return $this->name;
     }
 
     /** @param array{username?: string, name?: string, website?: string} $data */
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 7d67c6203ed..1b0d2838ef2 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -586,6 +586,7 @@ public function testAuthorsUseTheConfigArrayKey()
         $this->assertSame([
             'foo' => [
                 'username' => 'bar',
+                'name' => 'bar',
             ],
         ], Hyde::authors()->toArray());
     }
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index 66c76b3a0ba..4040d1c35c7 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -25,7 +25,7 @@ public function testConstructorCanCreateANewAuthorInstanceFromUsernameString()
 
         $this->assertInstanceOf(PostAuthor::class, $post->author);
         $this->assertSame('John Doe', $post->author->username);
-        $this->assertNull($post->author->name);
+        $this->assertSame('John Doe', $post->author->name);
         $this->assertNull($post->author->website);
     }
 
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index a6da7cdcd48..cde23a22556 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -41,6 +41,13 @@ public function testCanCreateAuthorModelWithDetails()
         $this->assertSame('https://example.com', $author->website);
     }
 
+    public function testNameIsSetToUsernameIfNoNameIsProvided()
+    {
+        $author = new PostAuthor('foo');
+
+        $this->assertSame('foo', $author->name);
+    }
+
     public function testCreateMethodCreatesNewAuthorModel()
     {
         $author = Author::create('foo');
@@ -218,6 +225,6 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
     {
         $author = new PostAuthor('username', null, null);
 
-        $this->assertSame('{"username":"username"}', $author->toJson());
+        $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
     }
 }

From 96d39694429b2f0d7163897cd4a71b36b57abbb1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:53:00 +0200
Subject: [PATCH 2228/4023] Return keyed author array

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 142b74e7896..fe4de590f17 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -90,11 +90,11 @@ public function __toString(): string
 
     public function toArray(): array
     {
-        return array_filter([
+        return [$this->username => array_filter([
             'username' => $this->username,
             'name' => $this->name,
             'website' => $this->website,
-        ]);
+        ])];
     }
 
     public function getName(): string

From 024067575a78ab91a094ae2143aace3213a713b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 20:53:17 +0200
Subject: [PATCH 2229/4023] Revert "Return keyed author array"

This reverts commit beef1acd94803618bea66a18a636effb3ec1d0c9.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index fe4de590f17..142b74e7896 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -90,11 +90,11 @@ public function __toString(): string
 
     public function toArray(): array
     {
-        return [$this->username => array_filter([
+        return array_filter([
             'username' => $this->username,
             'name' => $this->name,
             'website' => $this->website,
-        ])];
+        ]);
     }
 
     public function getName(): string

From 3151b640bd0e41f55f67c3ad3a47489c8f24beab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 21:24:40 +0200
Subject: [PATCH 2230/4023] Update authors to support setting a biography

---
 .../Framework/Features/Blogging/Models/PostAuthor.php  |  9 ++++++++-
 .../Contracts/FrontMatter/SubSchemas/AuthorSchema.php  |  1 +
 packages/framework/tests/Unit/PostAuthorTest.php       | 10 ++++++++++
 packages/framework/tests/Unit/SchemaContractsTest.php  |  1 +
 4 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 142b74e7896..fa07d05bdb0 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -41,6 +41,11 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public readonly ?string $website;
 
+    /**
+     * The author's biography.
+     */
+    public readonly ?string $bio;
+
     /**
      * Construct a new Post Author object.
      *
@@ -49,12 +54,14 @@ class PostAuthor implements Stringable, SerializableContract
      * @param  string  $username
      * @param  string|null  $name
      * @param  string|null  $website
+     * @param  string|null  $bio
      */
-    public function __construct(string $username, ?string $name = null, ?string $website = null)
+    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null)
     {
         $this->username = $username;
         $this->name = $name ?? $username;
         $this->website = $website;
+        $this->bio = $bio;
     }
 
     /**
diff --git a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
index 7028cef6d6c..38ca6cfaa6b 100644
--- a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
+++ b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
@@ -15,5 +15,6 @@ interface AuthorSchema extends BlogPostSchema
         'name' => 'string',
         'username' => 'string',
         'website' => 'string',
+        'bio' => 'string',
     ];
 }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index cde23a22556..f97821360d5 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -41,6 +41,16 @@ public function testCanCreateAuthorModelWithDetails()
         $this->assertSame('https://example.com', $author->website);
     }
 
+    public function testCanCreateAuthorModelWithFullDetails()
+    {
+        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?');
+
+        $this->assertSame('mr_hyde', $author->username);
+        $this->assertSame('Mr. Hyde', $author->name);
+        $this->assertSame('https://HydePHP.com', $author->website);
+        $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
+    }
+
     public function testNameIsSetToUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');
diff --git a/packages/framework/tests/Unit/SchemaContractsTest.php b/packages/framework/tests/Unit/SchemaContractsTest.php
index 2d78f740b47..1223acb2fb5 100644
--- a/packages/framework/tests/Unit/SchemaContractsTest.php
+++ b/packages/framework/tests/Unit/SchemaContractsTest.php
@@ -60,6 +60,7 @@ public function testSchemasAreNotAccidentallyChanged()
             'name' => 'string',
             'username' => 'string',
             'website' => 'string',
+            'bio' => 'string',
         ], AuthorSchema::AUTHOR_SCHEMA);
 
         $this->assertSame([

From e370dc71937af7057f83a75b142ffd5789dbd5e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 21:33:50 +0200
Subject: [PATCH 2231/4023] Update authors to support setting social media
 handles

---
 .../Features/Blogging/Models/PostAuthor.php         | 13 ++++++++++++-
 .../FrontMatter/SubSchemas/AuthorSchema.php         |  1 +
 packages/framework/tests/Unit/PostAuthorTest.php    |  3 ++-
 .../framework/tests/Unit/SchemaContractsTest.php    |  1 +
 4 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index fa07d05bdb0..cbc212980e1 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -46,6 +46,15 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public readonly ?string $bio;
 
+    /**
+     * The author's social media links/handles.
+     *
+     * @var array<string, string
+     *
+     * @example ['twitter' => 'mr_hyde'] ($service => $handle)
+     */
+    public array $socials = [];
+
     /**
      * Construct a new Post Author object.
      *
@@ -55,13 +64,15 @@ class PostAuthor implements Stringable, SerializableContract
      * @param  string|null  $name
      * @param  string|null  $website
      * @param  string|null  $bio
+     * @param  array<string, string>  $socials
      */
-    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null)
+    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, array $socials = [])
     {
         $this->username = $username;
         $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
+        $this->socials = $socials;
     }
 
     /**
diff --git a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
index 38ca6cfaa6b..17f2e8e4517 100644
--- a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
+++ b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
@@ -16,5 +16,6 @@ interface AuthorSchema extends BlogPostSchema
         'username' => 'string',
         'website' => 'string',
         'bio' => 'string',
+        'socials' => 'array<string, string>',
     ];
 }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index f97821360d5..17a800b3597 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,12 +43,13 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?');
+        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']);
 
         $this->assertSame('mr_hyde', $author->username);
         $this->assertSame('Mr. Hyde', $author->name);
         $this->assertSame('https://HydePHP.com', $author->website);
         $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
+        $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author->socials);
     }
 
     public function testNameIsSetToUsernameIfNoNameIsProvided()
diff --git a/packages/framework/tests/Unit/SchemaContractsTest.php b/packages/framework/tests/Unit/SchemaContractsTest.php
index 1223acb2fb5..9da068b9149 100644
--- a/packages/framework/tests/Unit/SchemaContractsTest.php
+++ b/packages/framework/tests/Unit/SchemaContractsTest.php
@@ -61,6 +61,7 @@ public function testSchemasAreNotAccidentallyChanged()
             'username' => 'string',
             'website' => 'string',
             'bio' => 'string',
+            'socials' => 'array<string, string>',
         ], AuthorSchema::AUTHOR_SCHEMA);
 
         $this->assertSame([

From 4425913f505fca3bf2fe76a0d1ce7cb91647dbf4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 5 Jul 2024 22:01:13 +0200
Subject: [PATCH 2232/4023] Update authors to support setting avatars

---
 .../Framework/Features/Blogging/Models/PostAuthor.php | 11 ++++++++++-
 .../Contracts/FrontMatter/SubSchemas/AuthorSchema.php |  1 +
 packages/framework/tests/Unit/PostAuthorTest.php      |  3 ++-
 packages/framework/tests/Unit/SchemaContractsTest.php |  1 +
 4 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index cbc212980e1..dbc6ffa36b7 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -46,6 +46,13 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public readonly ?string $bio;
 
+    /**
+     * The author's avatar image.
+     *
+     * If you in your Blade view use `Hyde::asset($author->avatar)`, then this value supports using both image names for files in `_media`, or full URIs starting with the protocol.
+     */
+    public readonly ?string $avatar;
+
     /**
      * The author's social media links/handles.
      *
@@ -64,14 +71,16 @@ class PostAuthor implements Stringable, SerializableContract
      * @param  string|null  $name
      * @param  string|null  $website
      * @param  string|null  $bio
+     * @param  string|null  $avatar
      * @param  array<string, string>  $socials
      */
-    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, array $socials = [])
+    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, array $socials = [])
     {
         $this->username = $username;
         $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
+        $this->avatar = $avatar;
         $this->socials = $socials;
     }
 
diff --git a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
index 17f2e8e4517..028b9f24e1a 100644
--- a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
+++ b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
@@ -16,6 +16,7 @@ interface AuthorSchema extends BlogPostSchema
         'username' => 'string',
         'website' => 'string',
         'bio' => 'string',
+        'avatar' => 'string',
         'socials' => 'array<string, string>',
     ];
 }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 17a800b3597..ef895e02063 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,12 +43,13 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']);
+        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', 'mr_hyde.png', ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']);
 
         $this->assertSame('mr_hyde', $author->username);
         $this->assertSame('Mr. Hyde', $author->name);
         $this->assertSame('https://HydePHP.com', $author->website);
         $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
+        $this->assertSame('mr_hyde.png', $author->avatar);
         $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author->socials);
     }
 
diff --git a/packages/framework/tests/Unit/SchemaContractsTest.php b/packages/framework/tests/Unit/SchemaContractsTest.php
index 9da068b9149..351d3a30d5c 100644
--- a/packages/framework/tests/Unit/SchemaContractsTest.php
+++ b/packages/framework/tests/Unit/SchemaContractsTest.php
@@ -61,6 +61,7 @@ public function testSchemasAreNotAccidentallyChanged()
             'username' => 'string',
             'website' => 'string',
             'bio' => 'string',
+            'avatar' => 'string',
             'socials' => 'array<string, string>',
         ], AuthorSchema::AUTHOR_SCHEMA);
 

From da1680eccfe9e4191b923de003e6fd7beb6da34a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:51:53 +0200
Subject: [PATCH 2233/4023] Clarify code documentation

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index dbc6ffa36b7..6a23266fc3c 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -98,7 +98,7 @@ public static function getOrCreate(string|array $data): static
         return Author::create(static::findUsername($data), $data['name'] ?? null, $data['website'] ?? null);
     }
 
-    /** Get an Author from the config, or create it. */
+    /** Get an Author from the config, or create it with the username. */
     public static function get(string $username): static
     {
         return static::all()->firstWhere('username', strtolower($username)) ?? Author::create($username);

From bcebbc5fb452f6ef98b0c637e220c5ab3911539e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:55:44 +0200
Subject: [PATCH 2234/4023] Get authors by array key

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 6a23266fc3c..9482212daea 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -11,7 +11,6 @@
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 
-use function strtolower;
 use function is_string;
 use function array_filter;
 
@@ -101,7 +100,7 @@ public static function getOrCreate(string|array $data): static
     /** Get an Author from the config, or create it with the username. */
     public static function get(string $username): static
     {
-        return static::all()->firstWhere('username', strtolower($username)) ?? Author::create($username);
+        return static::all()->get($username) ?? Author::create($username);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */

From c56e92d5dc08eb78071b3827110880f85371e391 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:56:18 +0200
Subject: [PATCH 2235/4023] Make socials readonly

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 9482212daea..65301fa18c8 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -59,7 +59,7 @@ class PostAuthor implements Stringable, SerializableContract
      *
      * @example ['twitter' => 'mr_hyde'] ($service => $handle)
      */
-    public array $socials = [];
+    public readonly array $socials = [];
 
     /**
      * Construct a new Post Author object.

From 6bfef3ba3413a189e09c5051f2297e306eb4e365 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:56:48 +0200
Subject: [PATCH 2236/4023] Remove initializer from readonly field

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 65301fa18c8..4926b769810 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -59,7 +59,7 @@ class PostAuthor implements Stringable, SerializableContract
      *
      * @example ['twitter' => 'mr_hyde'] ($service => $handle)
      */
-    public readonly array $socials = [];
+    public readonly array $socials;
 
     /**
      * Construct a new Post Author object.

From 74b080f820722176c8de6a68a20dedd9b9bb2af0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:58:48 +0200
Subject: [PATCH 2237/4023] Split comma-separated values into multiple lines

---
 packages/framework/tests/Unit/PostAuthorTest.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index ef895e02063..4e7f44f897a 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,7 +43,14 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        $author = new PostAuthor('mr_hyde', 'Mr. Hyde', 'https://HydePHP.com', 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', 'mr_hyde.png', ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']);
+        $author = new PostAuthor(
+            'mr_hyde',
+            'Mr. Hyde',
+            'https://HydePHP.com',
+            'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?',
+            'mr_hyde.png',
+            ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']
+        );
 
         $this->assertSame('mr_hyde', $author->username);
         $this->assertSame('Mr. Hyde', $author->name);

From 03855869a767a7ac9882e17d711ff217567c7748 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 10:59:53 +0200
Subject: [PATCH 2238/4023] Introduce local variables

---
 .../framework/tests/Unit/PostAuthorTest.php   | 31 ++++++++++++-------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 4e7f44f897a..8c7d151b3e7 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,21 +43,28 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
+        $username = 'mr_hyde';
+        $name = 'Mr. Hyde';
+        $website = 'https://HydePHP.com';
+        $bio = 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?';
+        $avatar = 'mr_hyde.png';
+        $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
+
         $author = new PostAuthor(
-            'mr_hyde',
-            'Mr. Hyde',
-            'https://HydePHP.com',
-            'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?',
-            'mr_hyde.png',
-            ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']
+            $username,
+            $name,
+            $website,
+            $bio,
+            $avatar,
+            $socials
         );
 
-        $this->assertSame('mr_hyde', $author->username);
-        $this->assertSame('Mr. Hyde', $author->name);
-        $this->assertSame('https://HydePHP.com', $author->website);
-        $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
-        $this->assertSame('mr_hyde.png', $author->avatar);
-        $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author->socials);
+        $this->assertSame($username, $author->username);
+        $this->assertSame($name, $author->name);
+        $this->assertSame($website, $author->website);
+        $this->assertSame($bio, $author->bio);
+        $this->assertSame($avatar, $author->avatar);
+        $this->assertSame($socials, $author->socials);
     }
 
     public function testNameIsSetToUsernameIfNoNameIsProvided()

From 0a494712df7a82a865df206dad9c23b42bd72b97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:00:04 +0200
Subject: [PATCH 2239/4023] Join comma-separated values into a single line

---
 packages/framework/tests/Unit/PostAuthorTest.php | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 8c7d151b3e7..efc26c7cacc 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -50,14 +50,7 @@ public function testCanCreateAuthorModelWithFullDetails()
         $avatar = 'mr_hyde.png';
         $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
 
-        $author = new PostAuthor(
-            $username,
-            $name,
-            $website,
-            $bio,
-            $avatar,
-            $socials
-        );
+        $author = new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
 
         $this->assertSame($username, $author->username);
         $this->assertSame($name, $author->name);

From 9b11c94ae0cdc0103f913d4c9aef4238fc12d450 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:00:07 +0200
Subject: [PATCH 2240/4023] Revert "Join comma-separated values into a single
 line"

This reverts commit 0a494712df7a82a865df206dad9c23b42bd72b97.
---
 packages/framework/tests/Unit/PostAuthorTest.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index efc26c7cacc..8c7d151b3e7 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -50,7 +50,14 @@ public function testCanCreateAuthorModelWithFullDetails()
         $avatar = 'mr_hyde.png';
         $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
 
-        $author = new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
+        $author = new PostAuthor(
+            $username,
+            $name,
+            $website,
+            $bio,
+            $avatar,
+            $socials
+        );
 
         $this->assertSame($username, $author->username);
         $this->assertSame($name, $author->name);

From abd618b23ae7e4ce5d94b4816535b123d0121efb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:00:25 +0200
Subject: [PATCH 2241/4023] Add name identifiers to arguments

---
 packages/framework/tests/Unit/PostAuthorTest.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 8c7d151b3e7..e1f44520c15 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -51,12 +51,12 @@ public function testCanCreateAuthorModelWithFullDetails()
         $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
 
         $author = new PostAuthor(
-            $username,
-            $name,
-            $website,
-            $bio,
-            $avatar,
-            $socials
+            username: $username,
+            name: $name,
+            website: $website,
+            bio: $bio,
+            avatar: $avatar,
+            socials: $socials
         );
 
         $this->assertSame($username, $author->username);

From dcae0aff3f9799204c499cc4a3d0e13b016e4a88 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:01:41 +0200
Subject: [PATCH 2242/4023] Extract helper method

---
 .../framework/tests/Unit/PostAuthorTest.php   | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e1f44520c15..e031aae879d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,12 +43,7 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        $username = 'mr_hyde';
-        $name = 'Mr. Hyde';
-        $website = 'https://HydePHP.com';
-        $bio = 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?';
-        $avatar = 'mr_hyde.png';
-        $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
+        [$username, $name, $website, $bio, $avatar, $socials] = $this->exampleData();
 
         $author = new PostAuthor(
             username: $username,
@@ -253,4 +248,16 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
 
         $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
     }
+
+    protected function exampleData(): array
+    {
+        $username = 'mr_hyde';
+        $name = 'Mr. Hyde';
+        $website = 'https://HydePHP.com';
+        $bio = 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?';
+        $avatar = 'mr_hyde.png';
+        $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
+
+        return [$username, $name, $website, $bio, $avatar, $socials];
+    }
 }

From 67d4b9e3e91570ac514ced55194d474243dba9f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:05:27 +0200
Subject: [PATCH 2243/4023] Split comma-separated values into multiple lines

---
 packages/framework/tests/Unit/PostAuthorTest.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e031aae879d..ce5325a89f5 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -258,6 +258,13 @@ protected function exampleData(): array
         $avatar = 'mr_hyde.png';
         $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
 
-        return [$username, $name, $website, $bio, $avatar, $socials];
+        return [
+            $username,
+            $name,
+            $website,
+            $bio,
+            $avatar,
+            $socials
+        ];
     }
 }

From dd70f876bdd0c2cda7db3486ccd6a4c5ee774929 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:06:01 +0200
Subject: [PATCH 2244/4023] Convert to keyed array

---
 packages/framework/tests/Unit/PostAuthorTest.php | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index ce5325a89f5..bc6a2403deb 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -43,7 +43,7 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        [$username, $name, $website, $bio, $avatar, $socials] = $this->exampleData();
+        [$username, $name, $website, $bio, $avatar, $socials] = array_values($this->exampleData());
 
         $author = new PostAuthor(
             username: $username,
@@ -259,12 +259,12 @@ protected function exampleData(): array
         $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
 
         return [
-            $username,
-            $name,
-            $website,
-            $bio,
-            $avatar,
-            $socials
+            'username' => $username,
+            'name' => $name,
+            'website' => $website,
+            'bio' => $bio,
+            'avatar' => $avatar,
+            'socials' => $socials
         ];
     }
 }

From 9b4dd57eed2e81f893c23dba363b0f0c6f89606a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:06:20 +0200
Subject: [PATCH 2245/4023] Inline local variables

---
 .../framework/tests/Unit/PostAuthorTest.php   | 21 +++++++------------
 1 file changed, 7 insertions(+), 14 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index bc6a2403deb..d679d6fe571 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -251,20 +251,13 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
 
     protected function exampleData(): array
     {
-        $username = 'mr_hyde';
-        $name = 'Mr. Hyde';
-        $website = 'https://HydePHP.com';
-        $bio = 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?';
-        $avatar = 'mr_hyde.png';
-        $socials = ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'];
-
-        return [
-            'username' => $username,
-            'name' => $name,
-            'website' => $website,
-            'bio' => $bio,
-            'avatar' => $avatar,
-            'socials' => $socials
+         return [
+            'username' => 'mr_hyde',
+            'name' => 'Mr. Hyde',
+            'website' => 'https://HydePHP.com',
+            'bio' => 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?',
+            'avatar' => 'mr_hyde.png',
+            'socials' => ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']
         ];
     }
 }

From f55ffbb658209fb1d1c8707a3c93d46245c661f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:15:27 +0200
Subject: [PATCH 2246/4023] Fix formatting

---
 packages/framework/tests/Unit/PostAuthorTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index d679d6fe571..bb301b59654 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -251,13 +251,13 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
 
     protected function exampleData(): array
     {
-         return [
+        return [
             'username' => 'mr_hyde',
             'name' => 'Mr. Hyde',
             'website' => 'https://HydePHP.com',
             'bio' => 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?',
             'avatar' => 'mr_hyde.png',
-            'socials' => ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com']
+            'socials' => ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'],
         ];
     }
 }

From d5454c2cb429f45cf9039d68c6127d183fd3817d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:08:49 +0200
Subject: [PATCH 2247/4023] Add ArrayShape to PHPDoc

---
 packages/framework/tests/Unit/PostAuthorTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index bb301b59654..439e98364f8 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -249,6 +249,9 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
         $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
     }
 
+    /**
+     * @return array{username: string, name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
+     */
     protected function exampleData(): array
     {
         return [

From b0a5c34c638cf4cc53d030006c11c68791ab7ce3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:09:31 +0200
Subject: [PATCH 2248/4023] Test can create author model with full details
 argument unpacking

---
 packages/framework/tests/Unit/PostAuthorTest.php | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 439e98364f8..49f0ec2598d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -62,6 +62,20 @@ public function testCanCreateAuthorModelWithFullDetails()
         $this->assertSame($socials, $author->socials);
     }
 
+    public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
+    {
+        $data = $this->exampleData();
+
+        $author = new PostAuthor(...$data);
+
+        $this->assertSame($data['username'], $author->username);
+        $this->assertSame($data['name'], $author->name);
+        $this->assertSame($data['website'], $author->website);
+        $this->assertSame($data['bio'], $author->bio);
+        $this->assertSame($data['avatar'], $author->avatar);
+        $this->assertSame($data['socials'], $author->socials);
+    }
+
     public function testNameIsSetToUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');

From d29744c40e6d8e21ab6746f68bf1fe2a8571d019 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:18:03 +0200
Subject: [PATCH 2249/4023] Remove faulty legacy argument from test

---
 packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index aa445431c65..48e1818fcf0 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -48,7 +48,6 @@ public function testComponentRendersPostWithAuthorObject()
         $view = $this->renderTestView(MarkdownPost::make(matter: [
             'author' => [
                 'name' => 'John Doe',
-                'url' => '#',
             ],
         ]));
 

From 5d6ddab87863b07b5e5910aa012135d021a99912 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:14:59 +0200
Subject: [PATCH 2250/4023] Support setting all arguments through the array
 constructor

---
 .../Features/Blogging/Models/PostAuthor.php   |  5 +-
 .../framework/tests/Unit/PostAuthorTest.php   | 59 +++++++++++++++++++
 2 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 4926b769810..9e2070f79e8 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -12,6 +12,7 @@
 use Hyde\Support\Contracts\SerializableContract;
 
 use function is_string;
+use function array_merge;
 use function array_filter;
 
 /**
@@ -94,7 +95,9 @@ public static function getOrCreate(string|array $data): static
             return static::get($data);
         }
 
-        return Author::create(static::findUsername($data), $data['name'] ?? null, $data['website'] ?? null);
+        return new static(...array_merge([
+            'username' => static::findUsername($data),
+        ], $data));
     }
 
     /** Get an Author from the config, or create it with the username. */
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 49f0ec2598d..9128b1d4e30 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -76,6 +76,65 @@ public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
         $this->assertSame($data['socials'], $author->socials);
     }
 
+    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate()
+    {
+        $data = $this->exampleData();
+
+        $author = PostAuthor::getOrCreate($data);
+
+        $this->assertSame($data['username'], $author->username);
+        $this->assertSame($data['name'], $author->name);
+        $this->assertSame($data['website'], $author->website);
+        $this->assertSame($data['bio'], $author->bio);
+        $this->assertSame($data['avatar'], $author->avatar);
+        $this->assertSame($data['socials'], $author->socials);
+    }
+
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate()
+    {
+        $data = $this->exampleData();
+
+        $author = PostAuthor::getOrCreate([
+            'username' => $data['username'],
+            'name' => $data['name'],
+            'website' => $data['website'],
+        ]);
+
+        $this->assertSame($data['username'], $author->username);
+        $this->assertSame($data['name'], $author->name);
+        $this->assertSame($data['website'], $author->website);
+        $this->assertNull($author->bio);
+        $this->assertNull($author->avatar);
+        $this->assertEmpty($author->socials);
+    }
+
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutUsername()
+    {
+        $data = $this->exampleData();
+
+        $author = PostAuthor::getOrCreate([
+            'name' => $data['name'],
+            'website' => $data['website'],
+        ]);
+
+        $this->assertSame($data['name'], $author->username);
+        $this->assertSame($data['name'], $author->name);
+        $this->assertSame($data['website'], $author->website);
+    }
+
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutAnyNames()
+    {
+        $data = $this->exampleData();
+
+        $author = PostAuthor::getOrCreate([
+            'website' => $data['website'],
+        ]);
+
+        $this->assertSame('Guest', $author->username);
+        $this->assertSame('Guest', $author->name);
+        $this->assertSame($data['website'], $author->website);
+    }
+
     public function testNameIsSetToUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');

From 1baa0c3523cdb3af0812785231abb3f783ea1a09 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:17:48 +0200
Subject: [PATCH 2251/4023] Update outdated ArrayShape annotation

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 9e2070f79e8..a21d9f05f19 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -87,7 +87,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     /**
      * Dynamically get or create an author based on a username string or front matter array.
      *
-     * @param  string|array{username?: string, name?: string, website?: string}  $data
+     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
     public static function getOrCreate(string|array $data): static
     {

From 2f54b9f9aad5a9065ae51ec9df5dc9ee0d023795 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:22:27 +0200
Subject: [PATCH 2252/4023] Deprecate the `PostAuthor::getName()` method

This is not needed as the name property can be accessed directly
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php    | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index a21d9f05f19..94303a8323f 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -8,6 +8,7 @@
 use Stringable;
 use Hyde\Facades\Author;
 use Illuminate\Support\Collection;
+use JetBrains\PhpStorm\Deprecated;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 
@@ -126,6 +127,10 @@ public function toArray(): array
         ]);
     }
 
+    /**
+     * @deprecated This is not needed as the name property can be accessed directly.
+     */
+    #[Deprecated(reason: 'Use the name property instead.', replacement: '%class%->name')]
     public function getName(): string
     {
         return $this->name;

From 76ab3ab398a2241c6139f690c448d81cb000d001 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:23:12 +0200
Subject: [PATCH 2253/4023] Replace with '$this->name'

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 94303a8323f..ad0f880d7a3 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -115,7 +115,7 @@ public static function all(): Collection
 
     public function __toString(): string
     {
-        return $this->getName();
+        return $this->name;
     }
 
     public function toArray(): array

From a20350acfa2eb87dd50da138b1d8c69fe422d174 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:23:41 +0200
Subject: [PATCH 2254/4023] Add newline

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php        | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index ad0f880d7a3..85675675c09 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -25,6 +25,7 @@ class PostAuthor implements Stringable, SerializableContract
 
     /**
      * The username of the author.
+     *
      * This is the key used to find authors in the config.
      */
     public readonly string $username;

From 369a7e68692284c3d57c50a4c1cd0dfd26921496 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:49:16 +0200
Subject: [PATCH 2255/4023] Test that post authors can be set in the Yaml
 config

---
 .../Feature/YamlConfigurationFeatureTest.php  | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 41362764b04..bb3688e5cf6 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
 /**
  * Test the Yaml configuration feature.
@@ -389,6 +390,54 @@ public function testSettingSiteNameSetsRssFeedSiteNameUnlessAlreadySpecifiedInSt
         $this->assertSame('Custom', config('hyde.rss.description'));
     }
 
+    public function testCanSetAuthorsInTheYamlConfig()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        authors:
+          username1:
+            name: 'User 1'
+            bio: 'Bio of user 1'
+            website: 'https://user1.com'
+            socials:
+              twitter: '@user1'
+              github: 'user1'
+        
+          username2:
+            name: 'User 2'
+            bio: 'Bio of user 2'
+            socials:
+              twitter: '@user2'
+              github: 'user2'
+        
+          test:
+            name: 'Test user'
+            bio: 'Bio of test user'
+            website: 'https://test.com'
+        YAML);
+
+        $this->runBootstrappers();
+
+        $authors = config('hyde.authors');
+
+        $this->assertCount(3, $authors);
+        $this->assertContainsOnlyInstancesOf(PostAuthor::class, $authors);
+        $this->assertSame('User 1', $authors['username1']->name);
+        $this->assertSame('User 2', $authors['username2']->name);
+        $this->assertSame('Test user', $authors['test']->name);
+
+        $this->assertSame('Bio of user 1', $authors['username1']->bio);
+        $this->assertSame('Bio of user 2', $authors['username2']->bio);
+        $this->assertSame('Bio of test user', $authors['test']->bio);
+
+        $this->assertSame('https://user1.com', $authors['username1']->website);
+        $this->assertNull($authors['username2']->website);
+        $this->assertSame('https://test.com', $authors['test']->website);
+
+        $this->assertSame(['twitter' => '@user1', 'github' => 'user1'], $authors['username1']->socials);
+        $this->assertSame(['twitter' => '@user2', 'github' => 'user2'], $authors['username2']->socials);
+        $this->assertSame([], $authors['test']->socials);
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 2ad343a8992ff0ce05937b5c2a685421964a64dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:33:08 +0200
Subject: [PATCH 2256/4023] Draft method to parse authors

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index d5d75accb3c..737c2fd7e37 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -51,4 +51,9 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     {
         $this->config[$namespace] = array_merge($this->config[$namespace] ?? [], $yaml);
     }
+
+    protected function parseAuthors(array $authors): array
+    {
+        return []; // TODO: Implement author parsing.
+    }
 }

From 8115c623c37af52ffa901ef1d1e9647d13ee04f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:33:31 +0200
Subject: [PATCH 2257/4023] If namespace is for Hyde and authors are set then
 parse them

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php         | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 737c2fd7e37..2271b755a6b 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -43,6 +43,10 @@ public function bootstrap(Application $app): void
     protected function mergeParsedConfiguration(): void
     {
         foreach ($this->yaml->getData() as $namespace => $data) {
+            if ($namespace === 'hyde' && isset($data['authors'])) {
+                $data['authors'] = $this->parseAuthors($data['authors']);
+            }
+
             $this->mergeConfiguration($namespace, Arr::undot($data ?: []));
         }
     }

From 2191c88961406692dfa41f8c577c51762cf97965 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:34:56 +0200
Subject: [PATCH 2258/4023] Annotate the helper method generics

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php         | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 2271b755a6b..fd7a5e55593 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -56,6 +56,10 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
         $this->config[$namespace] = array_merge($this->config[$namespace] ?? [], $yaml);
     }
 
+    /**
+     * @param  array<string, array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}>  $authors
+     * @return array<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor>
+     */
     protected function parseAuthors(array $authors): array
     {
         return []; // TODO: Implement author parsing.

From ff2ddfc9398ab0ded4413a9f25c2c57743f0b70c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:39:12 +0200
Subject: [PATCH 2259/4023] Implement Yaml configuration author parsing

Fixes https://github.com/hydephp/develop/issues/1719
---
 .../src/Foundation/Internal/LoadYamlConfiguration.php        | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index fd7a5e55593..f1976f8f788 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -7,6 +7,7 @@
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
+use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
 use function array_merge;
 
@@ -62,6 +63,8 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
      */
     protected function parseAuthors(array $authors): array
     {
-        return []; // TODO: Implement author parsing.
+        return Arr::mapWithKeys($authors, function (array $author, string $username): array {
+            return [$username => PostAuthor::getOrCreate($author)];
+        });
     }
 }

From 208c84834f7b3d159080e4ec7b402f79a344de1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:52:52 +0200
Subject: [PATCH 2260/4023] Draft test for Yaml config authors being merged
 with the PHP config

---
 .../framework/tests/Feature/YamlConfigurationFeatureTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index bb3688e5cf6..563ea26cc82 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -438,6 +438,11 @@ public function testCanSetAuthorsInTheYamlConfig()
         $this->assertSame([], $authors['test']->socials);
     }
 
+    public function testYamlConfigAuthorsAreMergedWithPhpConfig()
+    {
+        //
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 5f1e2d360165f82bba25395e9ce784e2e6e94a6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:52:55 +0200
Subject: [PATCH 2261/4023] Revert "Draft test for Yaml config authors being
 merged with the PHP config"

This reverts commit 1a86dc454f3e34c388645511b06f4b779fb48c2a. See https://github.com/hydephp/develop/pull/1782/files#r1667340453
---
 .../framework/tests/Feature/YamlConfigurationFeatureTest.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 563ea26cc82..bb3688e5cf6 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -438,11 +438,6 @@ public function testCanSetAuthorsInTheYamlConfig()
         $this->assertSame([], $authors['test']->socials);
     }
 
-    public function testYamlConfigAuthorsAreMergedWithPhpConfig()
-    {
-        //
-    }
-
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 896860f91dec317b6ea408fd3a75a7b1d38e1f48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 11:54:45 +0200
Subject: [PATCH 2262/4023] Add todo

---
 .../framework/tests/Feature/YamlConfigurationFeatureTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index bb3688e5cf6..a4f0ada878d 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -411,7 +411,7 @@ public function testCanSetAuthorsInTheYamlConfig()
         
           test:
             name: 'Test user'
-            bio: 'Bio of test user'
+            bio: 'Bio of test user' # TODO: support 'biography'
             website: 'https://test.com'
         YAML);
 

From a98d5be722b414a3f3ded1ea2669ac33252f9f0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 16:21:04 +0200
Subject: [PATCH 2263/4023] Use automatic array serialisation

Uses logic from https://github.com/hydephp/develop/pull/1793
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php   | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 85675675c09..e763ab1f659 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -121,11 +121,7 @@ public function __toString(): string
 
     public function toArray(): array
     {
-        return array_filter([
-            'username' => $this->username,
-            'name' => $this->name,
-            'website' => $this->website,
-        ]);
+        return array_filter($this->automaticallySerialize());
     }
 
     /**

From ad35ed37d3aae467e0a111d88ec8747a76bacadb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 16:22:19 +0200
Subject: [PATCH 2264/4023] Test to array method serializes all data

---
 packages/framework/tests/Unit/PostAuthorTest.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 9128b1d4e30..dc54a225051 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -279,6 +279,15 @@ public function testToArrayMethodReturnsArrayRepresentationOfAuthor()
         ], $author->toArray());
     }
 
+    public function testToArrayMethodSerializesAllData()
+    {
+        $data = $this->exampleData();
+
+        $author = new PostAuthor(...$data);
+
+        $this->assertSame($data, $author->toArray());
+    }
+
     public function testJsonSerializeMethodReturnsArrayRepresentationOfAuthor()
     {
         $author = new PostAuthor('username', 'John Doe', 'https://example.com');

From b7951a217a2a63b7c46bcf74de5ebee249591db7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 16:22:41 +0200
Subject: [PATCH 2265/4023] Move down test method

---
 .../framework/tests/Unit/PostAuthorTest.php    | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index dc54a225051..a60620861fb 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -279,15 +279,6 @@ public function testToArrayMethodReturnsArrayRepresentationOfAuthor()
         ], $author->toArray());
     }
 
-    public function testToArrayMethodSerializesAllData()
-    {
-        $data = $this->exampleData();
-
-        $author = new PostAuthor(...$data);
-
-        $this->assertSame($data, $author->toArray());
-    }
-
     public function testJsonSerializeMethodReturnsArrayRepresentationOfAuthor()
     {
         $author = new PostAuthor('username', 'John Doe', 'https://example.com');
@@ -331,6 +322,15 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
         $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
     }
 
+    public function testToArrayMethodSerializesAllData()
+    {
+        $data = $this->exampleData();
+
+        $author = new PostAuthor(...$data);
+
+        $this->assertSame($data, $author->toArray());
+    }
+
     /**
      * @return array{username: string, name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
      */

From 86b5de9504eaed5bc528152d0ec81fa2823bb15b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 18:24:05 +0200
Subject: [PATCH 2266/4023] Add `$author->getPosts()` method to get all the
 author's posts

---
 .../Features/Blogging/Models/PostAuthor.php   | 14 +++++++++
 .../framework/tests/Unit/PostAuthorTest.php   | 29 +++++++++++++++++++
 2 files changed, 43 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index e763ab1f659..10d79fc1bdf 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -7,9 +7,11 @@
 use Hyde\Hyde;
 use Stringable;
 use Hyde\Facades\Author;
+use Hyde\Pages\MarkdownPost;
 use Illuminate\Support\Collection;
 use JetBrains\PhpStorm\Deprecated;
 use Hyde\Support\Concerns\Serializable;
+use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
 use function is_string;
@@ -133,6 +135,18 @@ public function getName(): string
         return $this->name;
     }
 
+    /**
+     * Get all posts by this author.
+     *
+     * @return \Hyde\Foundation\Kernel\PageCollection<\Hyde\Pages\MarkdownPost>
+     */
+    public function getPosts(): PageCollection
+    {
+        return MarkdownPost::getLatestPosts()->filter(function (MarkdownPost $post) {
+            return $post->author?->username === $this->username;
+        });
+    }
+
     /** @param array{username?: string, name?: string, website?: string} $data */
     protected static function findUsername(array $data): string
     {
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index a60620861fb..c5832c34b3d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Hyde;
 use Hyde\Facades\Author;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
@@ -331,6 +333,33 @@ public function testToArrayMethodSerializesAllData()
         $this->assertSame($data, $author->toArray());
     }
 
+    public function testGetPostsWithNoPosts()
+    {
+        $author = new PostAuthor('username');
+
+        $this->assertSame([], $author->getPosts()->all());
+    }
+
+    public function testGetPostsReturnsAllPostsByAuthor()
+    {
+        Hyde::pages()->addPage(new MarkdownPost('foo', ['author' => 'username']));
+        Hyde::pages()->addPage(new MarkdownPost('bar', ['author' => 'username']));
+        Hyde::pages()->addPage(new MarkdownPost('baz', ['author' => 'other']));
+        Hyde::pages()->addPage(new MarkdownPost('qux'));
+
+        $author = new PostAuthor('username');
+
+        $this->assertCount(2, $author->getPosts());
+        $this->assertSame('username', $author->getPosts()->first()->author->username);
+        $this->assertSame('username', $author->getPosts()->last()->author->username);
+
+        $this->assertSame('foo', $author->getPosts()->first()->identifier);
+        $this->assertSame('bar', $author->getPosts()->last()->identifier);
+
+        $this->assertEquals($author, $author->getPosts()->first()->author);
+        $this->assertEquals($author, $author->getPosts()->last()->author);
+    }
+
     /**
      * @return array{username: string, name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
      */

From b3f9af6362964153fe504aab4a818bab5934651f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 18:26:10 +0200
Subject: [PATCH 2267/4023] Rename helper method to be clearer

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 10d79fc1bdf..343109e3b66 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -100,7 +100,7 @@ public static function getOrCreate(string|array $data): static
         }
 
         return new static(...array_merge([
-            'username' => static::findUsername($data),
+            'username' => static::findUsernameFromData($data),
         ], $data));
     }
 
@@ -148,7 +148,7 @@ public function getPosts(): PageCollection
     }
 
     /** @param array{username?: string, name?: string, website?: string} $data */
-    protected static function findUsername(array $data): string
+    protected static function findUsernameFromData(array $data): string
     {
         return $data['username'] ?? $data['name'] ?? 'Guest';
     }

From 5fb193eea80fe4e57ea8edbb575a1f06c245ac63 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 18:32:30 +0200
Subject: [PATCH 2268/4023] Merge `getOrCreate` method into the `get` method

---
 .../Internal/LoadYamlConfiguration.php        |  2 +-
 .../Factories/BlogPostDataFactory.php         |  2 +-
 .../Features/Blogging/Models/PostAuthor.php   | 25 ++++++++-------
 .../framework/tests/Unit/PostAuthorTest.php   | 32 +++++++++----------
 4 files changed, 32 insertions(+), 29 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index f1976f8f788..5285d6bca7c 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -64,7 +64,7 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            return [$username => PostAuthor::getOrCreate($author)];
+            return [$username => PostAuthor::get($author)];
         });
     }
 }
diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 161477a98d9..983a97258b8 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -91,7 +91,7 @@ protected function makeDate(): ?DateString
     protected function makeAuthor(): ?PostAuthor
     {
         if ($this->getMatter('author')) {
-            return PostAuthor::getOrCreate($this->getMatter('author'));
+            return PostAuthor::get($this->getMatter('author'));
         }
 
         return null;
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 343109e3b66..14272106b96 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -89,25 +89,28 @@ public function __construct(string $username, ?string $name = null, ?string $web
     }
 
     /**
-     * Dynamically get or create an author based on a username string or front matter array.
+     * Get the author by their username, or create a new instance with the supplied data.
      *
-     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
+     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $usernameOrData
      */
-    public static function getOrCreate(string|array $data): static
+    public static function get(string|array $usernameOrData): static
     {
-        if (is_string($data)) {
-            return static::get($data);
+        if (is_string($usernameOrData)) {
+            if (static::all()->has($usernameOrData)) {
+                return static::all()->get($usernameOrData);
+            }
+
+            return static::fromArray(['username' => $usernameOrData]);
         }
 
-        return new static(...array_merge([
-            'username' => static::findUsernameFromData($data),
-        ], $data));
+        return static::fromArray($usernameOrData);
     }
 
-    /** Get an Author from the config, or create it with the username. */
-    public static function get(string $username): static
+    protected static function fromArray(array $data): static
     {
-        return static::all()->get($username) ?? Author::create($username);
+        return new static(...array_merge([
+            'username' => static::findUsernameFromData($data),
+        ], $data));
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index c5832c34b3d..16c832ed7bb 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -78,11 +78,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate()
+    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetHelper()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate($data);
+        $author = PostAuthor::get($data);
 
         $this->assertSame($data['username'], $author->username);
         $this->assertSame($data['name'], $author->name);
@@ -92,11 +92,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelper()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::get([
             'username' => $data['username'],
             'name' => $data['name'],
             'website' => $data['website'],
@@ -110,11 +110,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate
         $this->assertEmpty($author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutUsername()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelperWithoutUsername()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::get([
             'name' => $data['name'],
             'website' => $data['website'],
         ]);
@@ -124,11 +124,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate
         $this->assertSame($data['website'], $author->website);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutAnyNames()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelperWithoutAnyNames()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::get([
             'website' => $data['website'],
         ]);
 
@@ -160,24 +160,24 @@ public function testCreateMethodAcceptsAllParameters()
         $this->assertSame('https://example.com', $author->website);
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
+    public function testGetHelperMethodCreatesNewAuthorModelFromString()
     {
-        $author = PostAuthor::getOrCreate('foo');
+        $author = PostAuthor::get('foo');
         $this->assertEquals($author, new PostAuthor('foo'));
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
+    public function testGetHelperMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
             Author::create('foo', 'bar'),
         ]);
 
-        $this->assertEquals(PostAuthor::getOrCreate('foo'), Author::create('foo', 'bar'));
+        $this->assertEquals(PostAuthor::get('foo'), Author::create('foo', 'bar'));
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
+    public function testGetHelperMethodCreatesNewAuthorModelFromArray()
     {
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::get([
             'username' => 'foo',
             'name' => 'bar',
             'website' => 'https://example.com',
@@ -186,9 +186,9 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
         $this->assertEquals($author, Author::create('foo', 'bar', 'https://example.com'));
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
+    public function testGetHelperMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
     {
-        $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), Author::create('foo'));
+        $this->assertEquals(PostAuthor::get(['username' => 'foo']), Author::create('foo'));
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()

From a08fb507574c9ac47f97a06053a19b0a10905b73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:06:12 +0200
Subject: [PATCH 2269/4023] Revert "Merge `getOrCreate` method into the `get`
 method"

This reverts commit 5fb193eea80fe4e57ea8edbb575a1f06c245ac63.
---
 .../Internal/LoadYamlConfiguration.php        |  2 +-
 .../Factories/BlogPostDataFactory.php         |  2 +-
 .../Features/Blogging/Models/PostAuthor.php   | 25 +++++++--------
 .../framework/tests/Unit/PostAuthorTest.php   | 32 +++++++++----------
 4 files changed, 29 insertions(+), 32 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 5285d6bca7c..f1976f8f788 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -64,7 +64,7 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            return [$username => PostAuthor::get($author)];
+            return [$username => PostAuthor::getOrCreate($author)];
         });
     }
 }
diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 983a97258b8..161477a98d9 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -91,7 +91,7 @@ protected function makeDate(): ?DateString
     protected function makeAuthor(): ?PostAuthor
     {
         if ($this->getMatter('author')) {
-            return PostAuthor::get($this->getMatter('author'));
+            return PostAuthor::getOrCreate($this->getMatter('author'));
         }
 
         return null;
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 14272106b96..343109e3b66 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -89,30 +89,27 @@ public function __construct(string $username, ?string $name = null, ?string $web
     }
 
     /**
-     * Get the author by their username, or create a new instance with the supplied data.
+     * Dynamically get or create an author based on a username string or front matter array.
      *
-     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $usernameOrData
+     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
-    public static function get(string|array $usernameOrData): static
+    public static function getOrCreate(string|array $data): static
     {
-        if (is_string($usernameOrData)) {
-            if (static::all()->has($usernameOrData)) {
-                return static::all()->get($usernameOrData);
-            }
-
-            return static::fromArray(['username' => $usernameOrData]);
+        if (is_string($data)) {
+            return static::get($data);
         }
 
-        return static::fromArray($usernameOrData);
-    }
-
-    protected static function fromArray(array $data): static
-    {
         return new static(...array_merge([
             'username' => static::findUsernameFromData($data),
         ], $data));
     }
 
+    /** Get an Author from the config, or create it with the username. */
+    public static function get(string $username): static
+    {
+        return static::all()->get($username) ?? Author::create($username);
+    }
+
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
     public static function all(): Collection
     {
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 16c832ed7bb..c5832c34b3d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -78,11 +78,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetHelper()
+    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::get($data);
+        $author = PostAuthor::getOrCreate($data);
 
         $this->assertSame($data['username'], $author->username);
         $this->assertSame($data['name'], $author->name);
@@ -92,11 +92,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetHelper()
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelper()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::get([
+        $author = PostAuthor::getOrCreate([
             'username' => $data['username'],
             'name' => $data['name'],
             'website' => $data['website'],
@@ -110,11 +110,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelper()
         $this->assertEmpty($author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelperWithoutUsername()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutUsername()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::get([
+        $author = PostAuthor::getOrCreate([
             'name' => $data['name'],
             'website' => $data['website'],
         ]);
@@ -124,11 +124,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelperWi
         $this->assertSame($data['website'], $author->website);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetHelperWithoutAnyNames()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutAnyNames()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::get([
+        $author = PostAuthor::getOrCreate([
             'website' => $data['website'],
         ]);
 
@@ -160,24 +160,24 @@ public function testCreateMethodAcceptsAllParameters()
         $this->assertSame('https://example.com', $author->website);
     }
 
-    public function testGetHelperMethodCreatesNewAuthorModelFromString()
+    public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
     {
-        $author = PostAuthor::get('foo');
+        $author = PostAuthor::getOrCreate('foo');
         $this->assertEquals($author, new PostAuthor('foo'));
     }
 
-    public function testGetHelperMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
+    public function testGetOrCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
             Author::create('foo', 'bar'),
         ]);
 
-        $this->assertEquals(PostAuthor::get('foo'), Author::create('foo', 'bar'));
+        $this->assertEquals(PostAuthor::getOrCreate('foo'), Author::create('foo', 'bar'));
     }
 
-    public function testGetHelperMethodCreatesNewAuthorModelFromArray()
+    public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
     {
-        $author = PostAuthor::get([
+        $author = PostAuthor::getOrCreate([
             'username' => 'foo',
             'name' => 'bar',
             'website' => 'https://example.com',
@@ -186,9 +186,9 @@ public function testGetHelperMethodCreatesNewAuthorModelFromArray()
         $this->assertEquals($author, Author::create('foo', 'bar', 'https://example.com'));
     }
 
-    public function testGetHelperMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
+    public function testGetOrCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
     {
-        $this->assertEquals(PostAuthor::get(['username' => 'foo']), Author::create('foo'));
+        $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), Author::create('foo'));
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()

From 3f8e6a3cb06a55e3d39ec1716ea3d585095b1de1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:22:08 +0200
Subject: [PATCH 2270/4023] Split out creator methods

https://claude.ai/chat/d82c5409-76af-4cf4-b88b-fdd74edd7728
---
 .../Features/Blogging/Models/PostAuthor.php      | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 343109e3b66..ed2e88740ac 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -89,25 +89,23 @@ public function __construct(string $username, ?string $name = null, ?string $web
     }
 
     /**
-     * Dynamically get or create an author based on a username string or front matter array.
+     * Create an author from the given data.
      *
      * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
-    public static function getOrCreate(string|array $data): static
+    public static function create(string|array $data): static
     {
-        if (is_string($data)) {
-            return static::get($data);
-        }
-
         return new static(...array_merge([
             'username' => static::findUsernameFromData($data),
         ], $data));
     }
 
-    /** Get an Author from the config, or create it with the username. */
-    public static function get(string $username): static
+    /**
+     * Get an author by the given username, or null if not found.
+     */
+    public static function get(string $username): ?static
     {
-        return static::all()->get($username) ?? Author::create($username);
+        return static::all()->get($username);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */

From bef60ad0f1349dc82170ea42052db64be312f200 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:22:10 +0200
Subject: [PATCH 2271/4023] Revert "Split out creator methods"

This reverts commit 3f8e6a3cb06a55e3d39ec1716ea3d585095b1de1.
---
 .../Features/Blogging/Models/PostAuthor.php      | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index ed2e88740ac..343109e3b66 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -89,23 +89,25 @@ public function __construct(string $username, ?string $name = null, ?string $web
     }
 
     /**
-     * Create an author from the given data.
+     * Dynamically get or create an author based on a username string or front matter array.
      *
      * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
-    public static function create(string|array $data): static
+    public static function getOrCreate(string|array $data): static
     {
+        if (is_string($data)) {
+            return static::get($data);
+        }
+
         return new static(...array_merge([
             'username' => static::findUsernameFromData($data),
         ], $data));
     }
 
-    /**
-     * Get an author by the given username, or null if not found.
-     */
-    public static function get(string $username): ?static
+    /** Get an Author from the config, or create it with the username. */
+    public static function get(string $username): static
     {
-        return static::all()->get($username);
+        return static::all()->get($username) ?? Author::create($username);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */

From 453a6c45e1a7019bdd61690fd4465d56cc3dcdc6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:49:39 +0200
Subject: [PATCH 2272/4023] Remove deprecated `PostAuthor::getName()` method

---
 .../Features/Blogging/Models/PostAuthor.php        | 10 ----------
 packages/framework/tests/Unit/PostAuthorTest.php   | 14 --------------
 2 files changed, 24 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 343109e3b66..665279ba2cd 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -9,7 +9,6 @@
 use Hyde\Facades\Author;
 use Hyde\Pages\MarkdownPost;
 use Illuminate\Support\Collection;
-use JetBrains\PhpStorm\Deprecated;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
@@ -126,15 +125,6 @@ public function toArray(): array
         return array_filter($this->automaticallySerialize());
     }
 
-    /**
-     * @deprecated This is not needed as the name property can be accessed directly.
-     */
-    #[Deprecated(reason: 'Use the name property instead.', replacement: '%class%->name')]
-    public function getName(): string
-    {
-        return $this->name;
-    }
-
     /**
      * Get all posts by this author.
      *
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index cc5611e2a05..cd7a9258785 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -249,20 +249,6 @@ public function testGetMethodReturnsNewAuthorIfUsernameNotFoundInConfig()
         $this->assertSame('foo', $author->username);
     }
 
-    public function testGetNameHelperReturnsNameIfSet()
-    {
-        $author = new PostAuthor('username', 'John Doe');
-
-        $this->assertSame('John Doe', $author->getName());
-    }
-
-    public function testGetNameHelperReturnsUsernameIfNameIsNotSet()
-    {
-        $author = new PostAuthor('username');
-
-        $this->assertSame('username', $author->getName());
-    }
-
     public function testNameIsSetToUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');

From af6fa4317ba8a05cb01bfbe579af75f25e736bfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:51:11 +0200
Subject: [PATCH 2273/4023] Add todo

See https://github.com/hydephp/develop/pull/1782/files#r1667091929
---
 .../Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
index 028b9f24e1a..1cf190c13c7 100644
--- a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
+++ b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/AuthorSchema.php
@@ -15,7 +15,7 @@ interface AuthorSchema extends BlogPostSchema
         'name' => 'string',
         'username' => 'string',
         'website' => 'string',
-        'bio' => 'string',
+        'bio' => 'string', // Todo: Support 'biography' as well?
         'avatar' => 'string',
         'socials' => 'array<string, string>',
     ];

From f6a4725f367727e7c7e85797953594fe6b8e4f15 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:53:16 +0200
Subject: [PATCH 2274/4023] Use a collect call instead of new collection

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 2c0b34f9618..5f630e0ef20 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -8,6 +8,8 @@
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
+use function collect;
+
 /**
  * Contains accessors and containers for data stored in the kernel.
  *
@@ -35,7 +37,7 @@ public function authors(): Collection
             return $this->authors;
         }
 
-        $config = new Collection(Config::getArray('hyde.authors', []));
+        $config = collect(Config::getArray('hyde.authors', []));
 
         if ($config->isEmpty()) {
             // Defer setting the authors property until the next try.

From d4f7d95b2af1e2718599c465642840803421ede9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:53:28 +0200
Subject: [PATCH 2275/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index f0044b91a63..7a9cb87ec89 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -19,6 +19,7 @@ This serves two purposes:
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
+- **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames. For more information, see below.
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
@@ -29,6 +30,7 @@ This serves two purposes:
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
+- Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
 - The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
@@ -47,6 +49,7 @@ This serves two purposes:
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now returning `null` if no base URL is set in https://github.com/hydephp/develop/pull/1760
+- Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 
 ### Fixed
@@ -146,6 +149,23 @@ Of course, if you have disabled any of the features, do not include them in the
 
 ## General impact
 
+### Post Author changes
+
+This release makes major improvements into the usability and design of the blog post author feature.
+
+Here is the full list of changes:
+
+- Breaking: The `hyde.authors` config setting should now be keyed by the usernames
+- Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`)
+- Feature: We now support setting authors in the YAML configuration! Fixes `#1719`
+- Feature: Added a `$author->getPosts()` method to get all author's posts
+- Feature: Authors now can also have custom biographies and social media links
+- The PostAuthor class is now Arrayable and JsonSerializable
+- The collection of site authors are now stored in the HydeKernel
+- Authors can additionally be accessed through `Hyde::authors()`
+
+For more information, see https://github.com/hydephp/develop/pull/1782
+
 ### Documentation search page changes
 
 The documentation search page and search index have been changed to be generated as `InMemoryPages` instead of a post-build task.

From 63675c78262bf6b3f9aca642928a18ab201e73d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 6 Jul 2024 20:37:32 +0200
Subject: [PATCH 2276/4023] Remove nullable modifier from author name as it is
 now never null

Cherry picks https://github.com/hydephp/develop/pull/1794/commits/f389ef4fecd10a4ca05dcf82fc9043abbaa92585 as it was lost when merging the branch into 2.x
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 665279ba2cd..d28d271e370 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -34,7 +34,7 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * The display name of the author.
      */
-    public readonly ?string $name;
+    public readonly string $name;
 
     /**
      * The author's website URL.

From 48beca6b440ba06b92c4c19ee338da8cb4cc9e0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:38:20 +0200
Subject: [PATCH 2277/4023] Add missing array keys to mocked config values

Updates to use the new format specified in https://github.com/hydephp/develop/pull/1782
---
 packages/framework/tests/Feature/HydeKernelTest.php    |  2 +-
 .../tests/Feature/PostsAuthorIntegrationTest.php       |  4 ++--
 packages/framework/tests/Unit/PostAuthorTest.php       | 10 +++++-----
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 5ab1a1025a1..f0838709ff9 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -575,7 +575,7 @@ public function testAuthorsPropertyIsNotWrittenUntilThereAreAuthorsDefined()
 
         $this->assertEmpty($kernel->authors()->toArray());
 
-        Config::set('hyde.authors', [Author::create('foo')]);
+        Config::set('hyde.authors', ['foo' => Author::create('foo')]);
 
         $this->assertNotEmpty($kernel->authors()->toArray());
     }
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index a8e1a134eae..2157efb43ec 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -51,7 +51,7 @@ public function testCreatePostWithDefinedAuthorWithName()
         $this->createPostFile('post-with-defined-author-with-name', 'named_author');
 
         Config::set('hyde.authors', [
-            Author::create('named_author', 'Test Author', null),
+            'named_author' => Author::create('named_author', 'Test Author', null),
         ]);
 
         $this->artisan('rebuild _posts/post-with-defined-author-with-name.md')->assertExitCode(0);
@@ -72,7 +72,7 @@ public function testCreatePostWithDefinedAuthorWithWebsite()
         $this->createPostFile('post-with-defined-author-with-name', 'test_author_with_website');
 
         Config::set('hyde.authors', [
-            Author::create('test_author_with_website', 'Test Author', 'https://example.org'),
+            'test_author_with_website' => Author::create('test_author_with_website', 'Test Author', 'https://example.org'),
         ]);
 
         $this->artisan('rebuild _posts/post-with-defined-author-with-name.md')->assertExitCode(0);
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 448be1837ed..b4c03887784 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -169,7 +169,7 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
     public function testGetOrCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
-            Author::create('foo', 'bar'),
+            'foo' => Author::create('foo', 'bar'),
         ]);
 
         $this->assertEquals(PostAuthor::getOrCreate('foo'), Author::create('foo', 'bar'));
@@ -203,7 +203,7 @@ public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
     public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
     {
         Config::set('hyde.authors', [
-            Author::create('foo'),
+            'foo' => Author::create('foo'),
         ]);
 
         $authors = PostAuthor::all();
@@ -216,8 +216,8 @@ public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
     public function testMultipleAuthorsCanBeDefinedInConfig()
     {
         Config::set('hyde.authors', [
-            Author::create('foo'),
-            Author::create('bar'),
+            'foo' => Author::create('foo'),
+            'bar' => Author::create('bar'),
         ]);
 
         $authors = PostAuthor::all();
@@ -231,7 +231,7 @@ public function testMultipleAuthorsCanBeDefinedInConfig()
     public function testGetMethodReturnsConfigDefinedAuthorByUsername()
     {
         Config::set('hyde.authors', [
-            Author::create('foo', 'bar'),
+            'foo' => Author::create('foo', 'bar'),
         ]);
         $author = PostAuthor::get('foo');
 

From b2dcd7a0713a693705581516d7a0d810443176be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:26:40 +0200
Subject: [PATCH 2278/4023] Clarify test name and expect the described result

---
 packages/framework/tests/Feature/HydeKernelTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index f0838709ff9..39cb505427f 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -580,13 +580,13 @@ public function testAuthorsPropertyIsNotWrittenUntilThereAreAuthorsDefined()
         $this->assertNotEmpty($kernel->authors()->toArray());
     }
 
-    public function testAuthorsUseTheConfigArrayKey()
+    public function testAuthorsUseTheConfigArrayKeyAsTheUsername()
     {
         Config::set('hyde.authors', ['foo' => Author::create('bar')]);
 
         $this->assertSame([
             'foo' => [
-                'username' => 'bar',
+                'username' => 'foo',
                 'name' => 'bar',
             ],
         ], Hyde::authors()->toArray());

From f43a3aff3305e100d922054733400b564204d625 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:33:01 +0200
Subject: [PATCH 2279/4023] Remove readonly modifier from author username

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index d28d271e370..b1a53ecf5c9 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -29,7 +29,7 @@ class PostAuthor implements Stringable, SerializableContract
      *
      * This is the key used to find authors in the config.
      */
-    public readonly string $username;
+    public string $username;
 
     /**
      * The display name of the author.

From 26be37d82f80ac5d1229420129f28008d995d284 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:33:30 +0200
Subject: [PATCH 2280/4023] Update parser to tap author to set the username to
 the array key

Normalizes the API
---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 5f630e0ef20..fd632c8c9fa 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -50,7 +50,7 @@ public function authors(): Collection
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
         return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
-            return [$username ?: $author->username => $author];
+            return [$username => tap($author, fn (PostAuthor $author) => $author->username = $username)];
         });
     }
 }

From fb12b6bca77e51031d54bdd97b0491e2230da15b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:36:47 +0200
Subject: [PATCH 2281/4023] Throw an InvalidArgumentException when missing the
 array key

Enforces the new state. Consider adding a BadConfigurationException?
---
 .../src/Foundation/Concerns/HasKernelData.php         |  5 +++++
 packages/framework/tests/Feature/HydeKernelTest.php   | 11 +++++++++++
 2 files changed, 16 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index fd632c8c9fa..37254e0903f 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Concerns;
 
 use Hyde\Facades\Config;
+use InvalidArgumentException;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
@@ -50,6 +51,10 @@ public function authors(): Collection
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
         return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
+            if (! $username) {
+                throw new InvalidArgumentException('Author username cannot be empty. Did you forget to set the author\'s array key?');
+            }
+
             return [$username => tap($author, fn (PostAuthor $author) => $author->username = $username)];
         });
     }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 39cb505427f..8c1470b4206 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Author;
 use Hyde\Facades\Features;
+use InvalidArgumentException;
 use Hyde\Foundation\Facades\Pages;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
@@ -591,6 +592,16 @@ public function testAuthorsUseTheConfigArrayKeyAsTheUsername()
             ],
         ], Hyde::authors()->toArray());
     }
+
+    public function testAuthorsThrowsExceptionWhenUsernameIsNotSet()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('Author username cannot be empty. Did you forget to set the author\'s array key?');
+
+        Config::set('hyde.authors', ['' => Author::create('foo')]);
+
+        Hyde::authors();
+    }
 }
 
 class CallableClass

From fbfa5075fc798da6ed33a3575d9da88b8bc3836c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:44:46 +0200
Subject: [PATCH 2282/4023] Deprecate the `Author::create` method's `$username`
 parameter

This leads to duplication which gets confusing
---
 packages/framework/src/Facades/Author.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 16976036fb5..62e488cc7cd 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Facades;
 
+use JetBrains\PhpStorm\Deprecated;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Illuminate\Support\Collection;
 
@@ -24,7 +25,7 @@ class Author
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      */
-    public static function create(string $username, ?string $name = null, ?string $website = null): PostAuthor
+    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website);
     }

From a1b9cfe5a1f7dbb1d664548bd434060d7f502b55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:48:19 +0200
Subject: [PATCH 2283/4023] Update the `Author::create` method to support all
 parameters

---
 packages/framework/src/Facades/Author.php        |  4 ++--
 packages/framework/tests/Unit/PostAuthorTest.php | 14 +++++++++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 62e488cc7cd..6740fafbe68 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -25,9 +25,9 @@ class Author
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      */
-    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null): PostAuthor
+    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, array $socials = []): PostAuthor
     {
-        return new PostAuthor($username, $name, $website);
+        return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index b4c03887784..c730e70cbc2 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -151,7 +151,7 @@ public function testCreateMethodCreatesNewAuthorModel()
         $this->assertInstanceOf(PostAuthor::class, $author);
     }
 
-    public function testCreateMethodAcceptsAllParameters()
+    public function testCreateMethodAcceptsExtraParameters()
     {
         $author = Author::create('foo', 'bar', 'https://example.com');
 
@@ -160,6 +160,18 @@ public function testCreateMethodAcceptsAllParameters()
         $this->assertSame('https://example.com', $author->website);
     }
 
+    public function testCreateMethodAcceptsAllParameters()
+    {
+        $author = Author::create(...$this->exampleData());
+
+        $this->assertSame('mr_hyde', $author->username);
+        $this->assertSame('Mr. Hyde', $author->name);
+        $this->assertSame('https://HydePHP.com', $author->website);
+        $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
+        $this->assertSame('mr_hyde.png', $author->avatar);
+        $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author->socials);
+    }
+
     public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
     {
         $author = PostAuthor::getOrCreate('foo');

From f5a66ee03dc66595a2bf4025e705e6fdc4d84659 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:51:19 +0200
Subject: [PATCH 2284/4023] Create InvalidConfigurationException.php

---
 .../Exceptions/InvalidConfigurationException.php       | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
new file mode 100644
index 00000000000..80c29c2d50e
--- /dev/null
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Exceptions;
+
+class InvalidConfigurationException
+{
+    //
+}

From 26aeea731a9c24373aa6361c95f14d9c275847c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:51:39 +0200
Subject: [PATCH 2285/4023] Update InvalidConfigurationException to extend
 InvalidArgumentException

---
 .../Framework/Exceptions/InvalidConfigurationException.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 80c29c2d50e..9394b39eb3d 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Exceptions;
 
-class InvalidConfigurationException
+use InvalidArgumentException;
+
+class InvalidConfigurationException extends InvalidArgumentException
 {
     //
 }

From 1bdda780691181c2dfb45a559a2e80862d2cb123 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:52:06 +0200
Subject: [PATCH 2286/4023] Throw custom InvalidConfigurationException

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 37254e0903f..ae23b49f1a9 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -5,9 +5,9 @@
 namespace Hyde\Foundation\Concerns;
 
 use Hyde\Facades\Config;
-use InvalidArgumentException;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 use function collect;
 
@@ -52,7 +52,7 @@ protected function parseConfigurationAuthors(Collection $authors): Collection
     {
         return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
             if (! $username) {
-                throw new InvalidArgumentException('Author username cannot be empty. Did you forget to set the author\'s array key?');
+                throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?');
             }
 
             return [$username => tap($author, fn (PostAuthor $author) => $author->username = $username)];

From fb029e1888d875b0fd863147fdf4ec9d10c9b721 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:02:07 +0200
Subject: [PATCH 2287/4023] Override constructor

---
 .../Framework/Exceptions/InvalidConfigurationException.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 9394b39eb3d..ee57bc39266 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -8,5 +8,8 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    //
+    public function __construct(string $message = 'Invalid configuration detected.')
+    {
+        parent::__construct($message);
+    }
 }

From 771d84db2a53599eb44a143cc5c1852d1294b056 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:08:10 +0200
Subject: [PATCH 2288/4023] Create initial logic to find the errored config
 line

---
 .../InvalidConfigurationException.php         | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index ee57bc39266..b27f960bd70 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -8,8 +8,32 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.')
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
     {
+        if ($namespace && $key) {
+            [$file, $line] = $this->findConfigLine($namespace, $key);
+
+            if ($file && $line) {
+                $this->file = $file;
+                $this->line = $line;
+            }
+        }
+
         parent::__construct($message);
     }
+
+    protected function findConfigLine(string $namespace, string $key): array
+    {
+        $file = "config/$namespace.php";
+        $contents = file_get_contents(base_path($file));
+        $lines = explode("\n", $contents);
+
+        foreach ($lines as $line => $content) {
+            if (str_contains($content, "'$key' =>")) {
+                break;
+            }
+        }
+
+        return [$file, $line + 1];
+    }
 }

From e7748bc11267f5b9520e301cfe5dbf2db78f5153 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:08:45 +0200
Subject: [PATCH 2289/4023] Replace break with early return

---
 .../Framework/Exceptions/InvalidConfigurationException.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index b27f960bd70..25589bffae9 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -30,10 +30,10 @@ protected function findConfigLine(string $namespace, string $key): array
 
         foreach ($lines as $line => $content) {
             if (str_contains($content, "'$key' =>")) {
-                break;
+                return [$file, $line + 1];
             }
         }
 
-        return [$file, $line + 1];
+        return [null, null];
     }
 }

From 5f414e53b999b35dd53cbdd2b4b8eff4951adf75 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:13:51 +0200
Subject: [PATCH 2290/4023] Add spacing

---
 .../src/Framework/Exceptions/InvalidConfigurationException.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 25589bffae9..771a368b7fb 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -26,6 +26,7 @@ protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";
         $contents = file_get_contents(base_path($file));
+
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {

From e57592ac6d0bc18da87a8560b6d4f03ba91b8fbd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:13:57 +0200
Subject: [PATCH 2291/4023] Annotate return types

---
 .../src/Framework/Exceptions/InvalidConfigurationException.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 771a368b7fb..d556429cc2b 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -22,6 +22,7 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
+    /** @return array{string|null, int|null} */
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";

From d343f0ab3f8404b4b2f3dfec1cb8d8da700e76aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:16:38 +0200
Subject: [PATCH 2292/4023] Remove graceful handling as internal developer
 needs to use proper paths

If we can't find the line, it's probably because an internal/package developer made a mistake
---
 .../Exceptions/InvalidConfigurationException.php      | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index d556429cc2b..ef1b907e62c 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -13,10 +13,8 @@ public function __construct(string $message = 'Invalid configuration detected.',
         if ($namespace && $key) {
             [$file, $line] = $this->findConfigLine($namespace, $key);
 
-            if ($file && $line) {
-                $this->file = $file;
-                $this->line = $line;
-            }
+            $this->file = $file;
+            $this->line = $line;
         }
 
         parent::__construct($message);
@@ -27,15 +25,14 @@ protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";
         $contents = file_get_contents(base_path($file));
-
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
             if (str_contains($content, "'$key' =>")) {
-                return [$file, $line + 1];
+                break;
             }
         }
 
-        return [null, null];
+        return [$file, $line + 1];
     }
 }

From 901b0588c9939e07024060588774d3d7f9ad48b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:21:37 +0200
Subject: [PATCH 2293/4023] Cleanup and improve the line finder code

---
 .../Exceptions/InvalidConfigurationException.php   | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index ef1b907e62c..8a6f7722492 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,8 +4,13 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
+use function assert;
+use function explode;
+use function realpath;
+
 class InvalidConfigurationException extends InvalidArgumentException
 {
     public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
@@ -20,11 +25,11 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
-    /** @return array{string|null, int|null} */
+    /** @return array{string, int} */
     protected function findConfigLine(string $namespace, string $key): array
     {
-        $file = "config/$namespace.php";
-        $contents = file_get_contents(base_path($file));
+        $file = realpath("config/$namespace.php");
+        $contents = Filesystem::getContents($file);
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
@@ -33,6 +38,9 @@ protected function findConfigLine(string $namespace, string $key): array
             }
         }
 
+        assert($file !== false);
+        assert(isset($line));
+
         return [$file, $line + 1];
     }
 }

From 56306f7f8568fe8dab9824d6a91324b62bfbec6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:22:09 +0200
Subject: [PATCH 2294/4023] Inline local variables

---
 .../Framework/Exceptions/InvalidConfigurationException.php   | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 8a6f7722492..1ea898af91f 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -16,10 +16,7 @@ class InvalidConfigurationException extends InvalidArgumentException
     public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
     {
         if ($namespace && $key) {
-            [$file, $line] = $this->findConfigLine($namespace, $key);
-
-            $this->file = $file;
-            $this->line = $line;
+            [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
         }
 
         parent::__construct($message);

From ba2a3526389e0ed890ed6aead1f5b07535539cc1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:23:46 +0200
Subject: [PATCH 2295/4023] Mark helper as experimental

---
 .../Framework/Exceptions/InvalidConfigurationException.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 1ea898af91f..67a13ba331c 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -22,7 +22,11 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
-    /** @return array{string, int} */
+    /**
+     * @experimental Please report any issues with this method to the authors at https://github.com/hydephp/develop/issues
+     *
+     * @return array{string, int}
+     */
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = realpath("config/$namespace.php");

From 46d0bd2820f506aecca3b77601bbd30dc7e96329 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:25:43 +0200
Subject: [PATCH 2296/4023] Clarify trait scope

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index ae23b49f1a9..fcfb45a3539 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -12,7 +12,7 @@
 use function collect;
 
 /**
- * Contains accessors and containers for data stored in the kernel.
+ * Contains accessors and containers for general data stored in the kernel.
  *
  * @internal Single-use trait for the HydeKernel class.
  *

From 4b369ecb3de08569afe73f0110096a5d8ed1c2f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:26:26 +0200
Subject: [PATCH 2297/4023] Specify the exception location

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index fcfb45a3539..5868dc39a67 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -52,7 +52,7 @@ protected function parseConfigurationAuthors(Collection $authors): Collection
     {
         return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
             if (! $username) {
-                throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?');
+                throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
 
             return [$username => tap($author, fn (PostAuthor $author) => $author->username = $username)];

From bb566a650991705d293723eb05a25578d8200c70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:51:19 +0200
Subject: [PATCH 2298/4023] Create InvalidConfigurationException.php

---
 .../Exceptions/InvalidConfigurationException.php       | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
new file mode 100644
index 00000000000..80c29c2d50e
--- /dev/null
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Exceptions;
+
+class InvalidConfigurationException
+{
+    //
+}

From ce7e96f8cfb32ce9fd5f88480b63edc7f0605fa8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 14:51:39 +0200
Subject: [PATCH 2299/4023] Update InvalidConfigurationException to extend
 InvalidArgumentException

---
 .../Framework/Exceptions/InvalidConfigurationException.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 80c29c2d50e..9394b39eb3d 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Framework\Exceptions;
 
-class InvalidConfigurationException
+use InvalidArgumentException;
+
+class InvalidConfigurationException extends InvalidArgumentException
 {
     //
 }

From 11dde57d1ed53158c4d26e13b2ff513f2f86c56d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:02:07 +0200
Subject: [PATCH 2300/4023] Override constructor

---
 .../Framework/Exceptions/InvalidConfigurationException.php   | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 9394b39eb3d..ee57bc39266 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -8,5 +8,8 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    //
+    public function __construct(string $message = 'Invalid configuration detected.')
+    {
+        parent::__construct($message);
+    }
 }

From 5947a85ba314bd7c2402f649ba9690b3a9731312 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:08:10 +0200
Subject: [PATCH 2301/4023] Create initial logic to find the errored config
 line

---
 .../InvalidConfigurationException.php         | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index ee57bc39266..b27f960bd70 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -8,8 +8,32 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.')
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
     {
+        if ($namespace && $key) {
+            [$file, $line] = $this->findConfigLine($namespace, $key);
+
+            if ($file && $line) {
+                $this->file = $file;
+                $this->line = $line;
+            }
+        }
+
         parent::__construct($message);
     }
+
+    protected function findConfigLine(string $namespace, string $key): array
+    {
+        $file = "config/$namespace.php";
+        $contents = file_get_contents(base_path($file));
+        $lines = explode("\n", $contents);
+
+        foreach ($lines as $line => $content) {
+            if (str_contains($content, "'$key' =>")) {
+                break;
+            }
+        }
+
+        return [$file, $line + 1];
+    }
 }

From 65d113c577b8d1189d5c0657c10ff7a406932e54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:08:45 +0200
Subject: [PATCH 2302/4023] Replace break with early return

---
 .../Framework/Exceptions/InvalidConfigurationException.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index b27f960bd70..25589bffae9 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -30,10 +30,10 @@ protected function findConfigLine(string $namespace, string $key): array
 
         foreach ($lines as $line => $content) {
             if (str_contains($content, "'$key' =>")) {
-                break;
+                return [$file, $line + 1];
             }
         }
 
-        return [$file, $line + 1];
+        return [null, null];
     }
 }

From 0cf1c4d473d83f0395245ef2c99a9b2626b58e6a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:13:51 +0200
Subject: [PATCH 2303/4023] Add spacing

---
 .../src/Framework/Exceptions/InvalidConfigurationException.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 25589bffae9..771a368b7fb 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -26,6 +26,7 @@ protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";
         $contents = file_get_contents(base_path($file));
+
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {

From 4b751931ada809467324ad0192d93948c6327f38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:13:57 +0200
Subject: [PATCH 2304/4023] Annotate return types

---
 .../src/Framework/Exceptions/InvalidConfigurationException.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 771a368b7fb..d556429cc2b 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -22,6 +22,7 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
+    /** @return array{string|null, int|null} */
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";

From 52895b9f3884a20c2c7dbad62682532b8f308c72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:16:38 +0200
Subject: [PATCH 2305/4023] Remove graceful handling as internal developer
 needs to use proper paths

If we can't find the line, it's probably because an internal/package developer made a mistake
---
 .../Exceptions/InvalidConfigurationException.php      | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index d556429cc2b..ef1b907e62c 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -13,10 +13,8 @@ public function __construct(string $message = 'Invalid configuration detected.',
         if ($namespace && $key) {
             [$file, $line] = $this->findConfigLine($namespace, $key);
 
-            if ($file && $line) {
-                $this->file = $file;
-                $this->line = $line;
-            }
+            $this->file = $file;
+            $this->line = $line;
         }
 
         parent::__construct($message);
@@ -27,15 +25,14 @@ protected function findConfigLine(string $namespace, string $key): array
     {
         $file = "config/$namespace.php";
         $contents = file_get_contents(base_path($file));
-
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
             if (str_contains($content, "'$key' =>")) {
-                return [$file, $line + 1];
+                break;
             }
         }
 
-        return [null, null];
+        return [$file, $line + 1];
     }
 }

From 9d7cf76e5f02850d91158c1b0555472475ccb7dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:21:37 +0200
Subject: [PATCH 2306/4023] Cleanup and improve the line finder code

---
 .../Exceptions/InvalidConfigurationException.php   | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index ef1b907e62c..8a6f7722492 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,8 +4,13 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
+use function assert;
+use function explode;
+use function realpath;
+
 class InvalidConfigurationException extends InvalidArgumentException
 {
     public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
@@ -20,11 +25,11 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
-    /** @return array{string|null, int|null} */
+    /** @return array{string, int} */
     protected function findConfigLine(string $namespace, string $key): array
     {
-        $file = "config/$namespace.php";
-        $contents = file_get_contents(base_path($file));
+        $file = realpath("config/$namespace.php");
+        $contents = Filesystem::getContents($file);
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
@@ -33,6 +38,9 @@ protected function findConfigLine(string $namespace, string $key): array
             }
         }
 
+        assert($file !== false);
+        assert(isset($line));
+
         return [$file, $line + 1];
     }
 }

From f2c667d4c56d1d5e27838e323bd0bfdc575ec590 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:22:09 +0200
Subject: [PATCH 2307/4023] Inline local variables

---
 .../Framework/Exceptions/InvalidConfigurationException.php   | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 8a6f7722492..1ea898af91f 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -16,10 +16,7 @@ class InvalidConfigurationException extends InvalidArgumentException
     public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
     {
         if ($namespace && $key) {
-            [$file, $line] = $this->findConfigLine($namespace, $key);
-
-            $this->file = $file;
-            $this->line = $line;
+            [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
         }
 
         parent::__construct($message);

From dc495d1ff20bb35803ffc4a1e12f236995d756ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:23:46 +0200
Subject: [PATCH 2308/4023] Mark helper as experimental

---
 .../Framework/Exceptions/InvalidConfigurationException.php  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 1ea898af91f..67a13ba331c 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -22,7 +22,11 @@ public function __construct(string $message = 'Invalid configuration detected.',
         parent::__construct($message);
     }
 
-    /** @return array{string, int} */
+    /**
+     * @experimental Please report any issues with this method to the authors at https://github.com/hydephp/develop/issues
+     *
+     * @return array{string, int}
+     */
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = realpath("config/$namespace.php");

From 7e912288494f294095c323e229150316ccde7442 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:31:41 +0200
Subject: [PATCH 2309/4023] Test covers InvalidConfigurationException

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 38be357f085..8b6e94e5831 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -19,6 +19,7 @@
  * @covers \Hyde\Framework\Exceptions\FileNotFoundException
  * @covers \Hyde\Framework\Exceptions\RouteNotFoundException
  * @covers \Hyde\Framework\Exceptions\UnsupportedPageTypeException
+ * @covers \Hyde\Framework\Exceptions\InvalidConfigurationException
  * @covers \Hyde\Framework\Exceptions\ParseException
  */
 class CustomExceptionsTest extends UnitTestCase

From 07fc54208f09aeadad6a149485a9c451ddb71c80 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:35:28 +0200
Subject: [PATCH 2310/4023] Generate tests with Claude

---
 .../tests/Unit/CustomExceptionsTest.php       | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 8b6e94e5831..f2a1bd38b77 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -13,6 +13,7 @@
 use Hyde\Framework\Exceptions\ParseException;
 use RuntimeException;
 use Exception;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 /**
  * @covers \Hyde\Framework\Exceptions\FileConflictException
@@ -174,4 +175,55 @@ public function testParseExceptionWithPrevious()
         $this->assertSame("Invalid Markdown in file: 'example.md' (Parsing error)", $exception->getMessage());
         $this->assertSame($previous, $exception->getPrevious());
     }
+
+    public function testInvalidConfigurationExceptionWithDefaultMessage()
+    {
+        $exception = new InvalidConfigurationException();
+
+        $this->assertSame('Invalid configuration detected.', $exception->getMessage());
+    }
+
+    public function testInvalidConfigurationExceptionWithCustomMessage()
+    {
+        $exception = new InvalidConfigurationException('Custom error message.');
+
+        $this->assertSame('Custom error message.', $exception->getMessage());
+    }
+
+    public function testInvalidConfigurationExceptionWithNamespaceAndKey()
+    {
+        $exception = new InvalidConfigurationException('Invalid configuration.', 'app', 'debug');
+
+        $this->assertSame('Invalid configuration.', $exception->getMessage());
+        $this->assertFileExists($exception->file);
+        $this->assertIsInt($exception->line);
+    }
+
+    public function testInvalidConfigurationExceptionWithNonExistentNamespace()
+    {
+        $this->expectException(\AssertionError::class);
+        new InvalidConfigurationException('Invalid configuration.', 'non_existent', 'key');
+    }
+
+    public function testInvalidConfigurationExceptionWithNonExistentKey()
+    {
+        $this->expectException(\AssertionError::class);
+        new InvalidConfigurationException('Invalid configuration.', 'app', 'non_existent_key');
+    }
+
+    public function testInvalidConfigurationExceptionFindConfigLine()
+    {
+        $exception = new class('Invalid configuration.', 'app', 'debug') extends InvalidConfigurationException {
+            public function exposedFindConfigLine(string $namespace, string $key): array
+            {
+                return $this->findConfigLine($namespace, $key);
+            }
+        };
+
+        [$file, $line] = $exception->exposedFindConfigLine('app', 'debug');
+
+        $this->assertFileExists($file);
+        $this->assertIsInt($line);
+        $this->assertGreaterThan(0, $line);
+    }
 }

From 29234ce757bf150f3593a745eccf562ebec6bfe1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:37:24 +0200
Subject: [PATCH 2311/4023] Fix up generated tests

---
 .../framework/tests/Unit/CustomExceptionsTest.php     | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index f2a1bd38b77..fad2c5e664e 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -192,11 +192,14 @@ public function testInvalidConfigurationExceptionWithCustomMessage()
 
     public function testInvalidConfigurationExceptionWithNamespaceAndKey()
     {
-        $exception = new InvalidConfigurationException('Invalid configuration.', 'app', 'debug');
+        $exception = new InvalidConfigurationException('Invalid configuration.', 'hyde', 'name');
 
         $this->assertSame('Invalid configuration.', $exception->getMessage());
-        $this->assertFileExists($exception->file);
-        $this->assertIsInt($exception->line);
+        $this->assertFileExists($exception->getFile());
+        $this->assertIsInt($exception->getLine());
+
+        $this->assertStringContainsString('config'.DIRECTORY_SEPARATOR.'hyde.php', $exception->getFile());
+        $this->assertGreaterThan(0, $exception->getLine());
     }
 
     public function testInvalidConfigurationExceptionWithNonExistentNamespace()
@@ -213,7 +216,7 @@ public function testInvalidConfigurationExceptionWithNonExistentKey()
 
     public function testInvalidConfigurationExceptionFindConfigLine()
     {
-        $exception = new class('Invalid configuration.', 'app', 'debug') extends InvalidConfigurationException {
+        $exception = new class('Invalid configuration.', 'hyde', 'name') extends InvalidConfigurationException {
             public function exposedFindConfigLine(string $namespace, string $key): array
             {
                 return $this->findConfigLine($namespace, $key);

From 3083c7f0230da7f42dd449c2e05691a59f8e9be9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:37:37 +0200
Subject: [PATCH 2312/4023] Remove unnecessary tests

---
 .../tests/Unit/CustomExceptionsTest.php       | 28 -------------------
 1 file changed, 28 deletions(-)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index fad2c5e664e..dc6e9b460f7 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -201,32 +201,4 @@ public function testInvalidConfigurationExceptionWithNamespaceAndKey()
         $this->assertStringContainsString('config'.DIRECTORY_SEPARATOR.'hyde.php', $exception->getFile());
         $this->assertGreaterThan(0, $exception->getLine());
     }
-
-    public function testInvalidConfigurationExceptionWithNonExistentNamespace()
-    {
-        $this->expectException(\AssertionError::class);
-        new InvalidConfigurationException('Invalid configuration.', 'non_existent', 'key');
-    }
-
-    public function testInvalidConfigurationExceptionWithNonExistentKey()
-    {
-        $this->expectException(\AssertionError::class);
-        new InvalidConfigurationException('Invalid configuration.', 'app', 'non_existent_key');
-    }
-
-    public function testInvalidConfigurationExceptionFindConfigLine()
-    {
-        $exception = new class('Invalid configuration.', 'hyde', 'name') extends InvalidConfigurationException {
-            public function exposedFindConfigLine(string $namespace, string $key): array
-            {
-                return $this->findConfigLine($namespace, $key);
-            }
-        };
-
-        [$file, $line] = $exception->exposedFindConfigLine('app', 'debug');
-
-        $this->assertFileExists($file);
-        $this->assertIsInt($line);
-        $this->assertGreaterThan(0, $line);
-    }
 }

From f8c884797c198665aa71058caa927d6c4a0b4055 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:39:40 +0200
Subject: [PATCH 2313/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7a9cb87ec89..3a3f3fc2eb5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -13,6 +13,7 @@ This serves two purposes:
 - You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 - Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
+- Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in https://github.com/hydephp/develop/pull/1799
 - The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
 
 ### Changed

From 8250a7992f8f6c4d82f5b63a07d99fe1513be6f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 15:25:43 +0200
Subject: [PATCH 2314/4023] Clarify trait scope

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 5f630e0ef20..ccd14e60a72 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -11,7 +11,7 @@
 use function collect;
 
 /**
- * Contains accessors and containers for data stored in the kernel.
+ * Contains accessors and containers for general data stored in the kernel.
  *
  * @internal Single-use trait for the HydeKernel class.
  *

From 49f3be18b178e7bcd60e0c5df187e13abd02b870 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 16:16:37 +0200
Subject: [PATCH 2315/4023] Add missing generics closing tag

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index b1a53ecf5c9..2bca30114b7 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -59,7 +59,7 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * The author's social media links/handles.
      *
-     * @var array<string, string
+     * @var array<string, string>
      *
      * @example ['twitter' => 'mr_hyde'] ($service => $handle)
      */

From 89a3eb7bb7c97854fa49baf5f6f3847d51a9c3c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 16:18:17 +0200
Subject: [PATCH 2316/4023] Make the socials array nullable to match other
 properties in class

---
 packages/framework/src/Facades/Author.php                   | 2 +-
 .../src/Framework/Features/Blogging/Models/PostAuthor.php   | 6 +++---
 .../tests/Feature/YamlConfigurationFeatureTest.php          | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 6740fafbe68..c989e9df35b 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -25,7 +25,7 @@ class Author
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      */
-    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, array $socials = []): PostAuthor
+    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 2bca30114b7..cb4f673df01 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -59,11 +59,11 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * The author's social media links/handles.
      *
-     * @var array<string, string>
+     * @var ?array<string, string>
      *
      * @example ['twitter' => 'mr_hyde'] ($service => $handle)
      */
-    public readonly array $socials;
+    public readonly ?array $socials;
 
     /**
      * Construct a new Post Author object.
@@ -77,7 +77,7 @@ class PostAuthor implements Stringable, SerializableContract
      * @param  string|null  $avatar
      * @param  array<string, string>  $socials
      */
-    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, array $socials = [])
+    public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
         $this->username = $username;
         $this->name = $name ?? $username;
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index a4f0ada878d..41d657de0c8 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -435,7 +435,7 @@ public function testCanSetAuthorsInTheYamlConfig()
 
         $this->assertSame(['twitter' => '@user1', 'github' => 'user1'], $authors['username1']->socials);
         $this->assertSame(['twitter' => '@user2', 'github' => 'user2'], $authors['username2']->socials);
-        $this->assertSame([], $authors['test']->socials);
+        $this->assertSame(null, $authors['test']->socials);
     }
 
     protected function runBootstrappers(?array $withMergedConfig = null): void

From 239e67c06e54c6db820851d48903b5eebcd7f466 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 16:20:53 +0200
Subject: [PATCH 2317/4023] Document the deprecation reason

---
 packages/framework/src/Facades/Author.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index c989e9df35b..ebb9e86aed0 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -25,7 +25,7 @@ class Author
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      */
-    public static function create(#[Deprecated]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
+    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }

From 156461988740bdb6d366f27c1f352663e60fad5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:03:52 +0200
Subject: [PATCH 2318/4023] Make deprecated parameter optional

---
 packages/framework/src/Facades/Author.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index ebb9e86aed0..ae9b0fca2f4 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -25,7 +25,7 @@ class Author
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      */
-    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
+    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = '', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }

From 93b812a1489c174f241f977a29443a39320157f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:10:51 +0200
Subject: [PATCH 2319/4023] Document remaining constructor properties

---
 packages/framework/src/Facades/Author.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index ae9b0fca2f4..6ad831e39be 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -24,6 +24,9 @@ class Author
      * @param  string  $username  The username of the author. This is the key used to find authors in the config.
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
+     * @param  string|null  $bio  The author's optional biography text. Markdown supported.
+     * @param  string|null  $avatar  The author's optional avatar image. Supports both image names and full URIs.
+     * @param  array<string, string>|null  $socials  The author's optional social media links/handles.
      */
     public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = '', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {

From 9c7c4f4016d37ea46d25e7c3213c9c453143ff9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:16:15 +0200
Subject: [PATCH 2320/4023] Add name identifiers to the author fields in the
 config example

---
 config/hyde.php                    | 6 +++---
 packages/framework/config/hyde.php | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 9d6301a1bf7..bc76bb9151c 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -285,9 +285,9 @@
 
     'authors' => [
         'mr_hyde' => Author::create(
-            'mr_hyde', // Required username
-            'Mr. Hyde', // Optional display name
-            'https://hydephp.com' // Optional website URL
+            username: 'mr_hyde', // Required username
+            name: 'Mr. Hyde', // Optional display name
+            website: 'https://hydephp.com' // Optional website URL
         ),
     ],
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 9d6301a1bf7..bc76bb9151c 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -285,9 +285,9 @@
 
     'authors' => [
         'mr_hyde' => Author::create(
-            'mr_hyde', // Required username
-            'Mr. Hyde', // Optional display name
-            'https://hydephp.com' // Optional website URL
+            username: 'mr_hyde', // Required username
+            name: 'Mr. Hyde', // Optional display name
+            website: 'https://hydephp.com' // Optional website URL
         ),
     ],
 

From 4500a5fcd63f6b1db8d6d84b82091c4664bb05d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:18:26 +0200
Subject: [PATCH 2321/4023] Fill in all the author fields in the config example

---
 config/hyde.php                    | 8 +++++++-
 packages/framework/config/hyde.php | 8 +++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index bc76bb9151c..adf4a49079f 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -287,7 +287,13 @@
         'mr_hyde' => Author::create(
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
-            website: 'https://hydephp.com' // Optional website URL
+            website: 'https://hydephp.com', // Optional website URL
+            bio: 'The mysterious author of HydePHP', // Optional biography
+            avatar: 'avatar.png', // Optional avatar image (media asset/URI)
+            socials: [ // Optional social media links
+                'twitter' => 'HydeFramework',
+                'github' => 'hydephp',
+            ],
         ),
     ],
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index bc76bb9151c..adf4a49079f 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -287,7 +287,13 @@
         'mr_hyde' => Author::create(
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
-            website: 'https://hydephp.com' // Optional website URL
+            website: 'https://hydephp.com', // Optional website URL
+            bio: 'The mysterious author of HydePHP', // Optional biography
+            avatar: 'avatar.png', // Optional avatar image (media asset/URI)
+            socials: [ // Optional social media links
+                'twitter' => 'HydeFramework',
+                'github' => 'hydephp',
+            ],
         ),
     ],
 

From b0d9115d10460e62760a054f49a1b8d68a95d237 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:19:01 +0200
Subject: [PATCH 2322/4023] Comment out extra author fields

---
 config/hyde.php                    | 12 ++++++------
 packages/framework/config/hyde.php | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index adf4a49079f..fc9a0d5963d 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -288,12 +288,12 @@
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
-            bio: 'The mysterious author of HydePHP', // Optional biography
-            avatar: 'avatar.png', // Optional avatar image (media asset/URI)
-            socials: [ // Optional social media links
-                'twitter' => 'HydeFramework',
-                'github' => 'hydephp',
-            ],
+            // bio: 'The mysterious author of HydePHP', // Optional biography
+            // avatar: 'avatar.png', // Optional avatar image (media asset/URI)
+            // socials: [ // Optional social media links
+            //     'twitter' => 'HydeFramework',
+            //     'github' => 'hydephp',
+            // ],
         ),
     ],
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index adf4a49079f..fc9a0d5963d 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -288,12 +288,12 @@
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
-            bio: 'The mysterious author of HydePHP', // Optional biography
-            avatar: 'avatar.png', // Optional avatar image (media asset/URI)
-            socials: [ // Optional social media links
-                'twitter' => 'HydeFramework',
-                'github' => 'hydephp',
-            ],
+            // bio: 'The mysterious author of HydePHP', // Optional biography
+            // avatar: 'avatar.png', // Optional avatar image (media asset/URI)
+            // socials: [ // Optional social media links
+            //     'twitter' => 'HydeFramework',
+            //     'github' => 'hydephp',
+            // ],
         ),
     ],
 

From a6263d1897d598b8982739b0cc3ed6d1e8ca90e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:24:31 +0200
Subject: [PATCH 2323/4023] Improve the author configuration documentation

---
 config/hyde.php                    | 6 +++---
 packages/framework/config/hyde.php | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index fc9a0d5963d..a7c8f86c8d9 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -277,9 +277,9 @@
     | However, it's tedious to have to add those to each and every
     | post you make, and keeping them updated is even harder.
     |
-    | Here you can add predefined authors. When writing posts,
-    | just specify the username in the front matter, and the
-    | rest of the data will be pulled from a matching entry.
+    | To solve this problem, you can add predefined authors with this setting.
+    | When writing posts just specify the author's username (the array key).
+    | Hyde will pull the matching data from here and fill in the blanks.
     |
     */
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index fc9a0d5963d..a7c8f86c8d9 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -277,9 +277,9 @@
     | However, it's tedious to have to add those to each and every
     | post you make, and keeping them updated is even harder.
     |
-    | Here you can add predefined authors. When writing posts,
-    | just specify the username in the front matter, and the
-    | rest of the data will be pulled from a matching entry.
+    | To solve this problem, you can add predefined authors with this setting.
+    | When writing posts just specify the author's username (the array key).
+    | Hyde will pull the matching data from here and fill in the blanks.
     |
     */
 

From 960989cdfdaea89802f3e61a534516a7bed7146c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:27:55 +0200
Subject: [PATCH 2324/4023] Improve inline author config documentation

---
 config/hyde.php                    | 10 +++++++---
 packages/framework/config/hyde.php | 10 +++++++---
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index a7c8f86c8d9..a3302f2d63d 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -285,12 +285,16 @@
 
     'authors' => [
         'mr_hyde' => Author::create(
+            // The following settings are used in the default blog post template.
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
-            // bio: 'The mysterious author of HydePHP', // Optional biography
-            // avatar: 'avatar.png', // Optional avatar image (media asset/URI)
-            // socials: [ // Optional social media links
+
+            // The following settings are not used in the bundled templates,
+            // but you can use them in your own custom views, for example.
+            // bio: 'The mysterious author of HydePHP',
+            // avatar: 'avatar.png',
+            // socials: [
             //     'twitter' => 'HydeFramework',
             //     'github' => 'hydephp',
             // ],
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index a7c8f86c8d9..a3302f2d63d 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -285,12 +285,16 @@
 
     'authors' => [
         'mr_hyde' => Author::create(
+            // The following settings are used in the default blog post template.
             username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
-            // bio: 'The mysterious author of HydePHP', // Optional biography
-            // avatar: 'avatar.png', // Optional avatar image (media asset/URI)
-            // socials: [ // Optional social media links
+
+            // The following settings are not used in the bundled templates,
+            // but you can use them in your own custom views, for example.
+            // bio: 'The mysterious author of HydePHP',
+            // avatar: 'avatar.png',
+            // socials: [
             //     'twitter' => 'HydeFramework',
             //     'github' => 'hydephp',
             // ],

From c780fc8d964fc929f4fad409da62a9f3efea4191 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:30:11 +0200
Subject: [PATCH 2325/4023] Return new static

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index cb4f673df01..b69bed14d14 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -106,7 +106,7 @@ public static function getOrCreate(string|array $data): static
     /** Get an Author from the config, or create it with the username. */
     public static function get(string $username): static
     {
-        return static::all()->get($username) ?? Author::create($username);
+        return static::all()->get($username) ?? new static($username);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */

From 8030c1885b509979551655282be4926c4d721e98 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:35:03 +0200
Subject: [PATCH 2326/4023] Test against new post author

---
 packages/framework/tests/Unit/PostAuthorTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index c730e70cbc2..6736e8992a4 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -222,7 +222,7 @@ public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(Author::create('foo'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo'), $authors->first());
     }
 
     public function testMultipleAuthorsCanBeDefinedInConfig()
@@ -236,8 +236,8 @@ public function testMultipleAuthorsCanBeDefinedInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(2, $authors);
-        $this->assertEquals(Author::create('foo'), $authors->first());
-        $this->assertEquals(Author::create('bar'), $authors->last());
+        $this->assertEquals(new PostAuthor('foo'), $authors->first());
+        $this->assertEquals(new PostAuthor('bar'), $authors->last());
     }
 
     public function testGetMethodReturnsConfigDefinedAuthorByUsername()

From 4ade2141e4a157965dc409b713c372e14bcb29b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:37:22 +0200
Subject: [PATCH 2327/4023] Annotate the closure return

---
 packages/framework/src/Foundation/Concerns/HasKernelData.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 5868dc39a67..d1c15f8e3cc 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -55,7 +55,7 @@ protected function parseConfigurationAuthors(Collection $authors): Collection
                 throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
 
-            return [$username => tap($author, fn (PostAuthor $author) => $author->username = $username)];
+            return [$username => tap($author, fn (PostAuthor $author): string => $author->username = $username)];
         });
     }
 }

From dd082623b4d557d83ab6e69304314f072cd33913 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:38:39 +0200
Subject: [PATCH 2328/4023] Remove unused use statement

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php        | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index b69bed14d14..4e2d7ef57a2 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Stringable;
-use Hyde\Facades\Author;
 use Hyde\Pages\MarkdownPost;
 use Illuminate\Support\Collection;
 use Hyde\Support\Concerns\Serializable;

From 5639b1bb97bf20df1283dd205ebb7c2ad8bc7578 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:44:47 +0200
Subject: [PATCH 2329/4023] Set default blank username to guest

Matches name coalesce chain
---
 packages/framework/src/Facades/Author.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 6ad831e39be..9cdd1594d2a 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -28,7 +28,7 @@ class Author
      * @param  string|null  $avatar  The author's optional avatar image. Supports both image names and full URIs.
      * @param  array<string, string>|null  $socials  The author's optional social media links/handles.
      */
-    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = '', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
+    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = 'guest', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }

From e9731c9cae3df91558cc8a7aefe4a8776bb08671 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:45:11 +0200
Subject: [PATCH 2330/4023] Test can define author with no data in config

---
 packages/framework/tests/Unit/PostAuthorTest.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 6736e8992a4..b5e197f5d76 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -203,6 +203,19 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUser
         $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), Author::create('foo'));
     }
 
+    public function testCanDefineAuthorWithNoDataInConfig()
+    {
+        Config::set('hyde.authors', [
+            'foo' => Author::create(),
+        ]);
+
+        $authors = PostAuthor::all();
+
+        $this->assertInstanceOf(Collection::class, $authors);
+        $this->assertCount(1, $authors);
+        $this->assertEquals(new PostAuthor('foo', 'guest'), $authors->first());
+    }
+
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
     {
         Config::set('hyde.authors', []);

From ac9f5f74b5087c02648e3e68f138f749b22124eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:46:19 +0200
Subject: [PATCH 2331/4023] Capitalize the username when making the name
 fallback

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php | 3 ++-
 packages/framework/tests/Feature/HydeKernelTest.php       | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php          | 8 ++++----
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 4e2d7ef57a2..64d97a685e1 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -12,6 +12,7 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
+use function ucfirst;
 use function is_string;
 use function array_merge;
 use function array_filter;
@@ -79,7 +80,7 @@ class PostAuthor implements Stringable, SerializableContract
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
         $this->username = $username;
-        $this->name = $name ?? $username;
+        $this->name = $name ?? ucfirst($username);
         $this->website = $website;
         $this->bio = $bio;
         $this->avatar = $avatar;
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 8c1470b4206..7f586ae15a3 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -588,7 +588,7 @@ public function testAuthorsUseTheConfigArrayKeyAsTheUsername()
         $this->assertSame([
             'foo' => [
                 'username' => 'foo',
-                'name' => 'bar',
+                'name' => 'Bar',
             ],
         ], Hyde::authors()->toArray());
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index b5e197f5d76..78938e0793d 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -141,7 +141,7 @@ public function testNameIsSetToUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');
 
-        $this->assertSame('foo', $author->name);
+        $this->assertSame('Foo', $author->name);
     }
 
     public function testCreateMethodCreatesNewAuthorModel()
@@ -213,7 +213,7 @@ public function testCanDefineAuthorWithNoDataInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo', 'guest'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo', 'Guest'), $authors->first());
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
@@ -278,7 +278,7 @@ public function testNameIsSetToUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');
 
-        $this->assertSame('username', $author->name);
+        $this->assertSame('Username', $author->name);
     }
 
     public function testToStringHelperReturnsTheName()
@@ -339,7 +339,7 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
     {
         $author = new PostAuthor('username', null, null);
 
-        $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
+        $this->assertSame('{"username":"username","name":"Username"}', $author->toJson());
     }
 
     public function testToArrayMethodSerializesAllData()

From 94588e42e95e51d3afc65452a90e449b8a9b5b4c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:54:51 +0200
Subject: [PATCH 2332/4023] Revert "Capitalize the username when making the
 name fallback"

This reverts commit ac9f5f74b5087c02648e3e68f138f749b22124eb.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php | 3 +--
 packages/framework/tests/Feature/HydeKernelTest.php       | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php          | 8 ++++----
 3 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 64d97a685e1..4e2d7ef57a2 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -12,7 +12,6 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
-use function ucfirst;
 use function is_string;
 use function array_merge;
 use function array_filter;
@@ -80,7 +79,7 @@ class PostAuthor implements Stringable, SerializableContract
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
         $this->username = $username;
-        $this->name = $name ?? ucfirst($username);
+        $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
         $this->avatar = $avatar;
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 7f586ae15a3..8c1470b4206 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -588,7 +588,7 @@ public function testAuthorsUseTheConfigArrayKeyAsTheUsername()
         $this->assertSame([
             'foo' => [
                 'username' => 'foo',
-                'name' => 'Bar',
+                'name' => 'bar',
             ],
         ], Hyde::authors()->toArray());
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 78938e0793d..b5e197f5d76 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -141,7 +141,7 @@ public function testNameIsSetToUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');
 
-        $this->assertSame('Foo', $author->name);
+        $this->assertSame('foo', $author->name);
     }
 
     public function testCreateMethodCreatesNewAuthorModel()
@@ -213,7 +213,7 @@ public function testCanDefineAuthorWithNoDataInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo', 'Guest'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo', 'guest'), $authors->first());
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
@@ -278,7 +278,7 @@ public function testNameIsSetToUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');
 
-        $this->assertSame('Username', $author->name);
+        $this->assertSame('username', $author->name);
     }
 
     public function testToStringHelperReturnsTheName()
@@ -339,7 +339,7 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
     {
         $author = new PostAuthor('username', null, null);
 
-        $this->assertSame('{"username":"username","name":"Username"}', $author->toJson());
+        $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
     }
 
     public function testToArrayMethodSerializesAllData()

From aa81aba5da1b4e25615718c96f06add07fba3739 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:54:55 +0200
Subject: [PATCH 2333/4023] Revert "Set default blank username to guest"

This reverts commit 5639b1bb97bf20df1283dd205ebb7c2ad8bc7578.
---
 packages/framework/src/Facades/Author.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 9cdd1594d2a..6ad831e39be 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -28,7 +28,7 @@ class Author
      * @param  string|null  $avatar  The author's optional avatar image. Supports both image names and full URIs.
      * @param  array<string, string>|null  $socials  The author's optional social media links/handles.
      */
-    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = 'guest', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
+    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = '', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
     {
         return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
     }

From 8ea1b911b1f9f7dbbe32b4dc796d494d3be46d8c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 18:55:20 +0200
Subject: [PATCH 2334/4023] Update PostAuthorTest.php

---
 packages/framework/tests/Unit/PostAuthorTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index b5e197f5d76..1d1215faf1c 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -213,7 +213,7 @@ public function testCanDefineAuthorWithNoDataInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo', 'guest'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo', ''), $authors->first());
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()

From b9235dce1ff3cdb3818b01045da249b168a7229f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 19:09:36 +0200
Subject: [PATCH 2335/4023] Create a new and improved Author facade system

Fixes https://github.com/hydephp/develop/issues/1797 by decoupling the facade method from instantiating an element we need to tap with new data, and where the facade should not allow usernames, but the object must require it. A big BC break, but the most elegant way I can think of accomplishing this. We might also be able to reduce overlapping logic from the Yaml author configuration loader.
---
 config/hyde.php                               |  1 -
 packages/framework/config/hyde.php            |  1 -
 packages/framework/src/Facades/Author.php     | 11 ++--
 .../src/Foundation/Concerns/HasKernelData.php |  6 +-
 .../Features/Blogging/Models/PostAuthor.php   |  2 +-
 .../Feature/PostsAuthorIntegrationTest.php    |  4 +-
 .../tests/Unit/Facades/AuthorTest.php         | 40 ++++++++++--
 .../framework/tests/Unit/PostAuthorTest.php   | 62 +++++++++++--------
 8 files changed, 83 insertions(+), 44 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index a3302f2d63d..0898d2a80f4 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -286,7 +286,6 @@
     'authors' => [
         'mr_hyde' => Author::create(
             // The following settings are used in the default blog post template.
-            username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index a3302f2d63d..0898d2a80f4 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -286,7 +286,6 @@
     'authors' => [
         'mr_hyde' => Author::create(
             // The following settings are used in the default blog post template.
-            username: 'mr_hyde', // Required username
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com', // Optional website URL
 
diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 6ad831e39be..5949b49f001 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Facades;
 
-use JetBrains\PhpStorm\Deprecated;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Illuminate\Support\Collection;
 
@@ -16,21 +15,21 @@
 class Author
 {
     /**
-     * Construct a new Post Author. For Hyde to discover this author,
-     * you must call this method from your hyde.php config file.
+     * Configuration helper method to define a new blog post author, with better IDE support.
+     *
+     * The returned array will then be used by the framework to create a new PostAuthor instance.
      *
      * @see https://hydephp.com/docs/1.x/customization.html#authors
      *
-     * @param  string  $username  The username of the author. This is the key used to find authors in the config.
      * @param  string|null  $name  The optional display name of the author, leave blank to use the username.
      * @param  string|null  $website  The author's optional website URL. Website, Twitter, etc.
      * @param  string|null  $bio  The author's optional biography text. Markdown supported.
      * @param  string|null  $avatar  The author's optional avatar image. Supports both image names and full URIs.
      * @param  array<string, string>|null  $socials  The author's optional social media links/handles.
      */
-    public static function create(#[Deprecated(reason: 'The username is set by the array key in the configuration file')]string $username = '', ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): PostAuthor
+    public static function create(?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null): array
     {
-        return new PostAuthor($username, $name, $website, $bio, $avatar, $socials);
+        return compact('name', 'website', 'bio', 'avatar', 'socials');
     }
 
     /**
diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index d1c15f8e3cc..02123db1800 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -50,12 +50,14 @@ public function authors(): Collection
 
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
-        return $authors->mapWithKeys(function (PostAuthor $author, string $username): array {
+        return $authors->mapWithKeys(function (array $author, string $username): array {
             if (! $username) {
                 throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
 
-            return [$username => tap($author, fn (PostAuthor $author): string => $author->username = $username)];
+            $author['username'] = $username;
+
+            return [$username => PostAuthor::getOrCreate($author)];
         });
     }
 }
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 4e2d7ef57a2..be167e00b7d 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -28,7 +28,7 @@ class PostAuthor implements Stringable, SerializableContract
      *
      * This is the key used to find authors in the config.
      */
-    public string $username;
+    public readonly string $username;
 
     /**
      * The display name of the author.
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index 2157efb43ec..ce5d49b5879 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -51,7 +51,7 @@ public function testCreatePostWithDefinedAuthorWithName()
         $this->createPostFile('post-with-defined-author-with-name', 'named_author');
 
         Config::set('hyde.authors', [
-            'named_author' => Author::create('named_author', 'Test Author', null),
+            'named_author' => Author::create('Test Author', null),
         ]);
 
         $this->artisan('rebuild _posts/post-with-defined-author-with-name.md')->assertExitCode(0);
@@ -72,7 +72,7 @@ public function testCreatePostWithDefinedAuthorWithWebsite()
         $this->createPostFile('post-with-defined-author-with-name', 'test_author_with_website');
 
         Config::set('hyde.authors', [
-            'test_author_with_website' => Author::create('test_author_with_website', 'Test Author', 'https://example.org'),
+            'test_author_with_website' => Author::create('Test Author', 'https://example.org'),
         ]);
 
         $this->artisan('rebuild _posts/post-with-defined-author-with-name.md')->assertExitCode(0);
diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorTest.php
index f89502369a2..b15dec9a55f 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorTest.php
@@ -15,19 +15,49 @@ class AuthorTest extends TestCase
 {
     public function testCreate()
     {
-        $author = Author::create('john_doe', 'John Doe', 'https://johndoe.com');
+        $author = Author::create('John Doe', 'https://johndoe.com');
 
-        $this->assertSame('john_doe', $author->username);
-        $this->assertSame('John Doe', $author->name);
-        $this->assertSame('https://johndoe.com', $author->website);
+        $this->assertIsArray($author);
+        $this->assertFalse(isset($author['username']));
+        $this->assertSame('John Doe', $author['name']);
+        $this->assertSame('https://johndoe.com', $author['website']);
 
-        $this->assertEquals(Author::create('foo', null, null), Author::create('foo'));
+        $this->assertSame([
+            'name' => 'John Doe',
+            'website' => 'https://johndoe.com',
+            'bio' => null,
+            'avatar' => null,
+            'socials' => null,
+        ], $author);
+
+        $this->assertEquals(Author::create('foo'), Author::create('foo'));
+    }
+
+    public function testCreateWithAllParameters()
+    {
+        $author = Author::create('John Doe', 'https://johndoe.com', 'A cool guy', 'https://johndoe.com/avatar.jpg', [
+            'twitter' => 'johndoe',
+            'github' => 'johndoe',
+        ]);
+
+        $this->assertSame([
+            'name' => 'John Doe',
+            'website' => 'https://johndoe.com',
+            'bio' => 'A cool guy',
+            'avatar' => 'https://johndoe.com/avatar.jpg',
+            'socials' => [
+                'twitter' => 'johndoe',
+                'github' => 'johndoe',
+            ],
+        ], $author);
     }
 
     public function testGet()
     {
         $author = Author::get('mr_hyde');
 
+        $this->assertInstanceOf(PostAuthor::class, $author);
+
         $this->assertSame('mr_hyde', $author->username);
         $this->assertSame('Mr. Hyde', $author->name);
         $this->assertSame('https://hydephp.com', $author->website);
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 1d1215faf1c..e86fb73d0e8 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -45,7 +45,7 @@ public function testCanCreateAuthorModelWithDetails()
 
     public function testCanCreateAuthorModelWithFullDetails()
     {
-        [$username, $name, $website, $bio, $avatar, $socials] = array_values($this->exampleData());
+        [$username, $name, $website, $bio, $avatar, $socials] = array_values($this->exampleDataWithUsername());
 
         $author = new PostAuthor(
             username: $username,
@@ -66,7 +66,7 @@ public function testCanCreateAuthorModelWithFullDetails()
 
     public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
     {
-        $data = $this->exampleData();
+        $data = $this->exampleDataWithUsername();
 
         $author = new PostAuthor(...$data);
 
@@ -84,7 +84,6 @@ public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate
 
         $author = PostAuthor::getOrCreate($data);
 
-        $this->assertSame($data['username'], $author->username);
         $this->assertSame($data['name'], $author->name);
         $this->assertSame($data['website'], $author->website);
         $this->assertSame($data['bio'], $author->bio);
@@ -97,12 +96,10 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate
         $data = $this->exampleData();
 
         $author = PostAuthor::getOrCreate([
-            'username' => $data['username'],
             'name' => $data['name'],
             'website' => $data['website'],
         ]);
 
-        $this->assertSame($data['username'], $author->username);
         $this->assertSame($data['name'], $author->name);
         $this->assertSame($data['website'], $author->website);
         $this->assertNull($author->bio);
@@ -144,32 +141,38 @@ public function testNameIsSetToUsernameIfNoNameIsProvided()
         $this->assertSame('foo', $author->name);
     }
 
-    public function testCreateMethodCreatesNewAuthorModel()
+    public function testCreateMethodCreatesNewPendingAuthorArray()
     {
         $author = Author::create('foo');
 
-        $this->assertInstanceOf(PostAuthor::class, $author);
+        $this->assertSame([
+            'name' => 'foo',
+            'website' => null,
+            'bio' => null,
+            'avatar' => null,
+            'socials' => null,
+        ], $author);
     }
 
     public function testCreateMethodAcceptsExtraParameters()
     {
-        $author = Author::create('foo', 'bar', 'https://example.com');
+        $author = Author::create('foo', 'https://example.com');
 
-        $this->assertSame('foo', $author->username);
-        $this->assertSame('bar', $author->name);
-        $this->assertSame('https://example.com', $author->website);
+        $this->assertFalse(isset($author['username']));
+        $this->assertSame('foo', $author['name']);
+        $this->assertSame('https://example.com', $author['website']);
     }
 
     public function testCreateMethodAcceptsAllParameters()
     {
         $author = Author::create(...$this->exampleData());
 
-        $this->assertSame('mr_hyde', $author->username);
-        $this->assertSame('Mr. Hyde', $author->name);
-        $this->assertSame('https://HydePHP.com', $author->website);
-        $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author->bio);
-        $this->assertSame('mr_hyde.png', $author->avatar);
-        $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author->socials);
+        $this->assertFalse(isset($author['username']));
+        $this->assertSame('Mr. Hyde', $author['name']);
+        $this->assertSame('https://HydePHP.com', $author['website']);
+        $this->assertSame('A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?', $author['bio']);
+        $this->assertSame('mr_hyde.png', $author['avatar']);
+        $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author['socials']);
     }
 
     public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
@@ -181,10 +184,10 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
     public function testGetOrCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
-            'foo' => Author::create('foo', 'bar'),
+            'foo' => Author::create('bar'),
         ]);
 
-        $this->assertEquals(PostAuthor::getOrCreate('foo'), Author::create('foo', 'bar'));
+        $this->assertEquals(PostAuthor::getOrCreate('foo'), new PostAuthor('foo', 'bar'));
     }
 
     public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
@@ -195,12 +198,12 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
             'website' => 'https://example.com',
         ]);
 
-        $this->assertEquals($author, Author::create('foo', 'bar', 'https://example.com'));
+        $this->assertEquals($author, new PostAuthor('foo', 'bar', 'https://example.com'));
     }
 
     public function testGetOrCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
     {
-        $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), Author::create('foo'));
+        $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), new PostAuthor('foo'));
     }
 
     public function testCanDefineAuthorWithNoDataInConfig()
@@ -213,7 +216,7 @@ public function testCanDefineAuthorWithNoDataInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo', ''), $authors->first());
+        $this->assertEquals(new PostAuthor('foo', 'foo'), $authors->first());
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
@@ -256,7 +259,7 @@ public function testMultipleAuthorsCanBeDefinedInConfig()
     public function testGetMethodReturnsConfigDefinedAuthorByUsername()
     {
         Config::set('hyde.authors', [
-            'foo' => Author::create('foo', 'bar'),
+            'foo' => Author::create('bar'),
         ]);
         $author = PostAuthor::get('foo');
 
@@ -344,7 +347,7 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
 
     public function testToArrayMethodSerializesAllData()
     {
-        $data = $this->exampleData();
+        $data = $this->exampleDataWithUsername();
 
         $author = new PostAuthor(...$data);
 
@@ -379,12 +382,11 @@ public function testGetPostsReturnsAllPostsByAuthor()
     }
 
     /**
-     * @return array{username: string, name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
+     * @return array{name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
      */
     protected function exampleData(): array
     {
         return [
-            'username' => 'mr_hyde',
             'name' => 'Mr. Hyde',
             'website' => 'https://HydePHP.com',
             'bio' => 'A mysterious figure. Is he as evil as he seems? And what did he do with Dr. Jekyll?',
@@ -392,4 +394,12 @@ protected function exampleData(): array
             'socials' => ['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'],
         ];
     }
+
+    /**
+     * @return array{username: string, name: string, website: string, bio: string, avatar: string, socials: array{twitter: string, github: string, custom: string}}
+     */
+    protected function exampleDataWithUsername(): array
+    {
+        return array_merge(['username' => 'mr_hyde'], $this->exampleData());
+    }
 }

From b8dc3a448f411dd9f5c36837944028f809d0cad9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:33:39 +0200
Subject: [PATCH 2336/4023] Update Author getters to return null when username
 is not found

---
 packages/framework/src/Facades/Author.php                 | 5 ++---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php | 8 ++++----
 packages/framework/tests/Unit/PostAuthorTest.php          | 5 ++---
 3 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 5949b49f001..1b810bb19ee 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -33,10 +33,9 @@ public static function create(?string $name = null, ?string $website = null, ?st
     }
 
     /**
-     * Get a Post Author instance from the config. If no author matching the username is found,
-     * a new Post Author instance will be created with just username supplied to the method.
+     * Get a Post Author instance by username, or null if not found.
      */
-    public static function get(string $username): PostAuthor
+    public static function get(string $username): ?PostAuthor
     {
         return PostAuthor::get($username);
     }
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index be167e00b7d..32e599cb85b 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         if (is_string($data)) {
-            return static::get($data);
+            return static::get($data) ?? new static($data);
         }
 
         return new static(...array_merge([
@@ -102,10 +102,10 @@ public static function getOrCreate(string|array $data): static
         ], $data));
     }
 
-    /** Get an Author from the config, or create it with the username. */
-    public static function get(string $username): static
+    /**  Get a Post Author instance by username, or null if not found. */
+    public static function get(string $username): ?static
     {
-        return static::all()->get($username) ?? new static($username);
+        return static::all()->get($username);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e86fb73d0e8..be1e4892f36 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -268,13 +268,12 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
         $this->assertSame('bar', $author->name);
     }
 
-    public function testGetMethodReturnsNewAuthorIfUsernameNotFoundInConfig()
+    public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
     {
         Config::set('hyde.authors', []);
         $author = PostAuthor::get('foo');
 
-        $this->assertInstanceOf(PostAuthor::class, $author);
-        $this->assertSame('foo', $author->username);
+        $this->assertNull($author);
     }
 
     public function testNameIsSetToUsernameIfNameIsNotSet()

From fabf4040522400826f4a54b90a65183e6c765ca9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:36:30 +0200
Subject: [PATCH 2337/4023] Simplify get or create method logic

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 32e599cb85b..11ca0fe1857 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,8 +93,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data)) {
-            return static::get($data) ?? new static($data);
+        if (is_string($data) && ($author = static::get($data))) {
+            return $author;
         }
 
         return new static(...array_merge([

From 05c52544856a890b2caf27c583e2db5f2f6aa4ac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:37:30 +0200
Subject: [PATCH 2338/4023] Revert "Simplify get or create method logic"

This reverts commit fabf4040522400826f4a54b90a65183e6c765ca9.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 11ca0fe1857..32e599cb85b 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,8 +93,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data) && ($author = static::get($data))) {
-            return $author;
+        if (is_string($data)) {
+            return static::get($data) ?? new static($data);
         }
 
         return new static(...array_merge([

From 66212b8dfc1983fbfcd6c046f900d1f7d50d31a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:37:41 +0200
Subject: [PATCH 2339/4023] Reapply "Simplify get or create method logic"

This reverts commit 05c52544856a890b2caf27c583e2db5f2f6aa4ac.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 32e599cb85b..11ca0fe1857 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,8 +93,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data)) {
-            return static::get($data) ?? new static($data);
+        if (is_string($data) && ($author = static::get($data))) {
+            return $author;
         }
 
         return new static(...array_merge([

From a892c1baae0dc92332f4e9f30ca92a457b7824e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:37:54 +0200
Subject: [PATCH 2340/4023] Move assignment out of the condition

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 11ca0fe1857..088d39962af 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,7 +93,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data) && ($author = static::get($data))) {
+        $author = static::get($data);
+        if (is_string($data) && ($author)) {
             return $author;
         }
 

From dca99914df39b03323eef1b5ee7037bebdcb8cd7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:38:02 +0200
Subject: [PATCH 2341/4023] Remove unnecessary parentheses

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 088d39962af..597d3abaaa5 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         $author = static::get($data);
-        if (is_string($data) && ($author)) {
+        if (is_string($data) && $author) {
             return $author;
         }
 

From 65c7dec433bd85e5414baf1df8e089fad1da969f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:38:53 +0200
Subject: [PATCH 2342/4023] New ternary logic

---
 .../Framework/Features/Blogging/Models/PostAuthor.php  | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 597d3abaaa5..16bdc627d5a 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,9 +93,13 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        $author = static::get($data);
-        if (is_string($data) && $author) {
-            return $author;
+        if (is_string($data)) {
+            $author = static::get($data);
+            if ($author !== null) {
+                return $author;
+            } else {
+                $data = ['username' => $data];
+            }
         }
 
         return new static(...array_merge([

From 43dda0b877eb89aaed3b8fd9bbab38504593e6b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:38:58 +0200
Subject: [PATCH 2343/4023] Revert "New ternary logic"

This reverts commit 65c7dec433bd85e5414baf1df8e089fad1da969f.
---
 .../Framework/Features/Blogging/Models/PostAuthor.php  | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 16bdc627d5a..597d3abaaa5 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,13 +93,9 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data)) {
-            $author = static::get($data);
-            if ($author !== null) {
-                return $author;
-            } else {
-                $data = ['username' => $data];
-            }
+        $author = static::get($data);
+        if (is_string($data) && $author) {
+            return $author;
         }
 
         return new static(...array_merge([

From 7872a233ce8bb1017ca9226fd4af3cd1b7337509 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:39:01 +0200
Subject: [PATCH 2344/4023] Revert "Remove unnecessary parentheses"

This reverts commit dca99914df39b03323eef1b5ee7037bebdcb8cd7.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 597d3abaaa5..088d39962af 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         $author = static::get($data);
-        if (is_string($data) && $author) {
+        if (is_string($data) && ($author)) {
             return $author;
         }
 

From 5eb61bec63ab238dd64c95208d3584832a8e8f7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:39:07 +0200
Subject: [PATCH 2345/4023] Revert "Move assignment out of the condition"

This reverts commit a892c1baae0dc92332f4e9f30ca92a457b7824e2.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 088d39962af..11ca0fe1857 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,8 +93,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        $author = static::get($data);
-        if (is_string($data) && ($author)) {
+        if (is_string($data) && ($author = static::get($data))) {
             return $author;
         }
 

From e41853c337b13612c13d1a569a6834ee86bcd49a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:39:09 +0200
Subject: [PATCH 2346/4023] Revert "Reapply "Simplify get or create method
 logic""

This reverts commit 66212b8dfc1983fbfcd6c046f900d1f7d50d31a1.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 11ca0fe1857..32e599cb85b 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -93,8 +93,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
      */
     public static function getOrCreate(string|array $data): static
     {
-        if (is_string($data) && ($author = static::get($data))) {
-            return $author;
+        if (is_string($data)) {
+            return static::get($data) ?? new static($data);
         }
 
         return new static(...array_merge([

From 53f61cf338efd5dbf10172a8abc3918c62a07d57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:39:41 +0200
Subject: [PATCH 2347/4023] Fall back to method retry with username

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 32e599cb85b..4290d18b392 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         if (is_string($data)) {
-            return static::get($data) ?? new static($data);
+            return static::get($data) ?? static::getOrCreate(['username' => $data]);
         }
 
         return new static(...array_merge([

From d9e7a8bd3500e73a50da544356b9e616d0d36927 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:39:51 +0200
Subject: [PATCH 2348/4023] Revert "Fall back to method retry with username"

This reverts commit 53f61cf338efd5dbf10172a8abc3918c62a07d57.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 4290d18b392..32e599cb85b 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         if (is_string($data)) {
-            return static::get($data) ?? static::getOrCreate(['username' => $data]);
+            return static::get($data) ?? new static($data);
         }
 
         return new static(...array_merge([

From 473a625321792fec907f1035c252651d46533d8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:41:01 +0200
Subject: [PATCH 2349/4023] Reapply "Fall back to method retry with username"

This reverts commit d9e7a8bd3500e73a50da544356b9e616d0d36927.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 32e599cb85b..4290d18b392 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -94,7 +94,7 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         if (is_string($data)) {
-            return static::get($data) ?? new static($data);
+            return static::get($data) ?? static::getOrCreate(['username' => $data]);
         }
 
         return new static(...array_merge([

From 57ab54475323b87bd0173ebe0a79f5e91f632855 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:58:41 +0200
Subject: [PATCH 2350/4023] Clarify test method names

---
 packages/framework/tests/Unit/PostAuthorTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index be1e4892f36..ebfd6731501 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -141,7 +141,7 @@ public function testNameIsSetToUsernameIfNoNameIsProvided()
         $this->assertSame('foo', $author->name);
     }
 
-    public function testCreateMethodCreatesNewPendingAuthorArray()
+    public function testFacadeCreateMethodCreatesNewPendingAuthorArray()
     {
         $author = Author::create('foo');
 
@@ -154,7 +154,7 @@ public function testCreateMethodCreatesNewPendingAuthorArray()
         ], $author);
     }
 
-    public function testCreateMethodAcceptsExtraParameters()
+    public function testFacadeCreateMethodAcceptsExtraParameters()
     {
         $author = Author::create('foo', 'https://example.com');
 
@@ -163,7 +163,7 @@ public function testCreateMethodAcceptsExtraParameters()
         $this->assertSame('https://example.com', $author['website']);
     }
 
-    public function testCreateMethodAcceptsAllParameters()
+    public function testFacadeCreateMethodAcceptsAllParameters()
     {
         $author = Author::create(...$this->exampleData());
 

From 9d689b49fca5a6409b1c79967765e4a4055801e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:41:58 +0200
Subject: [PATCH 2351/4023] Extract new more scoped create method

---
 .../Features/Blogging/Models/PostAuthor.php    | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 4290d18b392..5b7cbe869da 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -86,6 +86,18 @@ public function __construct(string $username, ?string $name = null, ?string $web
         $this->socials = $socials;
     }
 
+    /**
+     * Create a new Post Author instance from an array of data.
+     *
+     * @param  array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
+     */
+    public static function create(array $data): PostAuthor
+    {
+        return new static(...array_merge([
+            'username' => static::findUsernameFromData($data),
+        ], $data));
+    }
+
     /**
      * Dynamically get or create an author based on a username string or front matter array.
      *
@@ -94,12 +106,10 @@ public function __construct(string $username, ?string $name = null, ?string $web
     public static function getOrCreate(string|array $data): static
     {
         if (is_string($data)) {
-            return static::get($data) ?? static::getOrCreate(['username' => $data]);
+            return static::get($data) ?? static::create(['username' => $data]);
         }
 
-        return new static(...array_merge([
-            'username' => static::findUsernameFromData($data),
-        ], $data));
+        return self::create($data);
     }
 
     /**  Get a Post Author instance by username, or null if not found. */

From 1e9f09d54b09522a4278240b2211a516a726562a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 20:57:05 +0200
Subject: [PATCH 2352/4023] Deprecate the `PostAuthor::getOrCreate` method

---
 .../Features/Blogging/Models/PostAuthor.php   |  2 +
 .../framework/tests/Unit/PostAuthorTest.php   | 48 ++++++++++++-------
 2 files changed, 33 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 5b7cbe869da..20918870ca3 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -101,6 +101,8 @@ public static function create(array $data): PostAuthor
     /**
      * Dynamically get or create an author based on a username string or front matter array.
      *
+     * @deprecated Use either `get` or `create` directly depending on your use case.
+     *
      * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
     public static function getOrCreate(string|array $data): static
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index ebfd6731501..e5b5828b996 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -78,11 +78,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArgumentUnpacking()
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate()
+    public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingCreate()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate($data);
+        $author = PostAuthor::create($data);
 
         $this->assertSame($data['name'], $author->name);
         $this->assertSame($data['website'], $author->website);
@@ -91,11 +91,11 @@ public function testCanCreateAuthorModelWithFullDetailsFromArrayUsingGetOrCreate
         $this->assertSame($data['socials'], $author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreate()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::create([
             'name' => $data['name'],
             'website' => $data['website'],
         ]);
@@ -107,11 +107,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate
         $this->assertEmpty($author->socials);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutUsername()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWithoutUsername()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::create([
             'name' => $data['name'],
             'website' => $data['website'],
         ]);
@@ -121,11 +121,11 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreate
         $this->assertSame($data['website'], $author->website);
     }
 
-    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingGetOrCreateWithoutAnyNames()
+    public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWithoutAnyNames()
     {
         $data = $this->exampleData();
 
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::create([
             'website' => $data['website'],
         ]);
 
@@ -175,24 +175,24 @@ public function testFacadeCreateMethodAcceptsAllParameters()
         $this->assertSame(['twitter' => 'HydeFramework', 'github' => 'hydephp', 'custom' => 'https://example.com'], $author['socials']);
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromString()
+    public function testGetMethodReturnsNullWhenAuthorIsNotFound()
     {
-        $author = PostAuthor::getOrCreate('foo');
-        $this->assertEquals($author, new PostAuthor('foo'));
+        $author = PostAuthor::get('foo');
+        $this->assertNull($author);
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
+    public function testGetMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
             'foo' => Author::create('bar'),
         ]);
 
-        $this->assertEquals(PostAuthor::getOrCreate('foo'), new PostAuthor('foo', 'bar'));
+        $this->assertEquals(PostAuthor::get('foo'), new PostAuthor('foo', 'bar'));
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
+    public function testGetMethodCreatesNewAuthorModelFromArray()
     {
-        $author = PostAuthor::getOrCreate([
+        $author = PostAuthor::create([
             'username' => 'foo',
             'name' => 'bar',
             'website' => 'https://example.com',
@@ -201,9 +201,23 @@ public function testGetOrCreateMethodCreatesNewAuthorModelFromArray()
         $this->assertEquals($author, new PostAuthor('foo', 'bar', 'https://example.com'));
     }
 
-    public function testGetOrCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
+    public function testCreateMethodCreatesNewAuthorModelFromArrayOnlyNeedsUsername()
+    {
+        $this->assertEquals(PostAuthor::create(['username' => 'foo']), new PostAuthor('foo'));
+    }
+
+    public function testCreateMethodWithNoUsernameUsesNameAsUsernameIfNameIsSupplied()
     {
-        $this->assertEquals(PostAuthor::getOrCreate(['username' => 'foo']), new PostAuthor('foo'));
+        $author = PostAuthor::create(['name' => 'foo']);
+
+        $this->assertEquals($author, new PostAuthor('foo'));
+    }
+
+    public function testCreateMethodWithNoUsernameUsesGuestAsUsernameIfNoNameIsSupplied()
+    {
+        $author = PostAuthor::create([]);
+
+        $this->assertEquals($author, new PostAuthor('Guest'));
     }
 
     public function testCanDefineAuthorWithNoDataInConfig()

From bf10755c00126263dd7e791eb4732f09af5f4419 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:07:35 +0200
Subject: [PATCH 2353/4023] Use the create method as there should be no models
 before parsing

It makes no sense to check for existing models when we are in the process of creating them
---
 packages/framework/src/Foundation/Concerns/HasKernelData.php    | 2 +-
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 02123db1800..0e292d09c2f 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -57,7 +57,7 @@ protected function parseConfigurationAuthors(Collection $authors): Collection
 
             $author['username'] = $username;
 
-            return [$username => PostAuthor::getOrCreate($author)];
+            return [$username => PostAuthor::create($author)];
         });
     }
 }
diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index f1976f8f788..12d2591fdc6 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -64,7 +64,7 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            return [$username => PostAuthor::getOrCreate($author)];
+            return [$username => PostAuthor::create($author)];
         });
     }
 }

From b673d6b651cbb2c110402c534229c5de100eca08 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:11:11 +0200
Subject: [PATCH 2354/4023] Add todo

---
 packages/framework/tests/Unit/PostAuthorTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e5b5828b996..4b59ada48d2 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -217,7 +217,7 @@ public function testCreateMethodWithNoUsernameUsesGuestAsUsernameIfNoNameIsSuppl
     {
         $author = PostAuthor::create([]);
 
-        $this->assertEquals($author, new PostAuthor('Guest'));
+        $this->assertEquals($author, new PostAuthor('Guest')); // Todo: Should we expect (and normalize to?) lowercase 'guest'?
     }
 
     public function testCanDefineAuthorWithNoDataInConfig()

From a2d15ee8a3c267434ca8e9a0fdcddffe44f77d9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:11:14 +0200
Subject: [PATCH 2355/4023] Add todo

---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 12d2591fdc6..8a8ee8ced32 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -64,6 +64,8 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
+            // Todo: Catch type errors so we can rethrow them as InvalidConfigurationException with the correct context.
+
             return [$username => PostAuthor::create($author)];
         });
     }

From cf4831d784a4180958f6a75634fb998b090d7131 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:13:14 +0200
Subject: [PATCH 2356/4023] Extract helper method

---
 .../src/Framework/Factories/BlogPostDataFactory.php        | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 161477a98d9..d78faccf18f 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -91,7 +91,7 @@ protected function makeDate(): ?DateString
     protected function makeAuthor(): ?PostAuthor
     {
         if ($this->getMatter('author')) {
-            return PostAuthor::getOrCreate($this->getMatter('author'));
+            return $this->getOrCreateAuthor();
         }
 
         return null;
@@ -111,6 +111,11 @@ private function makeDescriptionFromMarkdownBody(): string
         return Str::limit((new ConvertsMarkdownToPlainText($this->markdown->body()))->execute(), 125);
     }
 
+    private function getOrCreateAuthor(): PostAuthor
+    {
+        return PostAuthor::getOrCreate($this->getMatter('author'));
+    }
+
     protected function getMatter(string $key): string|null|array
     {
         /** @var string|null|array $value */

From fdc4d8355ac639b4d058ff93ec242c1f8a1e3915 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:14:11 +0200
Subject: [PATCH 2357/4023] Introduce local variable

---
 .../framework/src/Framework/Factories/BlogPostDataFactory.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index d78faccf18f..c5f27d7439c 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -113,7 +113,9 @@ private function makeDescriptionFromMarkdownBody(): string
 
     private function getOrCreateAuthor(): PostAuthor
     {
-        return PostAuthor::getOrCreate($this->getMatter('author'));
+        $data = $this->getMatter('author');
+
+        return PostAuthor::getOrCreate($data);
     }
 
     protected function getMatter(string $key): string|null|array

From ceec673c3ec686e6b87ec571d3e4dd0d8bed23ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:15:06 +0200
Subject: [PATCH 2358/4023] Inline the helper method usage into last remaining
 usage

---
 .../src/Framework/Factories/BlogPostDataFactory.php       | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index c5f27d7439c..2a1f781e7b8 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -14,6 +14,8 @@
 use Hyde\Markdown\Models\Markdown;
 use Hyde\Support\Models\DateString;
 
+use function is_string;
+
 /**
  * Streamlines the data construction specific to a blog post.
  *
@@ -115,7 +117,11 @@ private function getOrCreateAuthor(): PostAuthor
     {
         $data = $this->getMatter('author');
 
-        return PostAuthor::getOrCreate($data);
+        if (is_string($data)) {
+            return PostAuthor::get($data) ?? PostAuthor::create(['username' => $data]);
+        }
+
+        return PostAuthor::create($data);
     }
 
     protected function getMatter(string $key): string|null|array

From fa4213fc16251e4a5f3a8c19f4d51ff3fde8fb96 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:15:33 +0200
Subject: [PATCH 2359/4023] Ignore coverage for deprecated method

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 20918870ca3..c8b0aaa8054 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -103,6 +103,8 @@ public static function create(array $data): PostAuthor
      *
      * @deprecated Use either `get` or `create` directly depending on your use case.
      *
+     * @codeCoverageIgnore Until we can remove this method.
+     *
      * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
     public static function getOrCreate(string|array $data): static

From 672cfb5ae47b5b31603ab70a212efad590346e2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:16:32 +0200
Subject: [PATCH 2360/4023] Use static instead of self

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index c8b0aaa8054..a40ae89ec37 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -113,7 +113,7 @@ public static function getOrCreate(string|array $data): static
             return static::get($data) ?? static::create(['username' => $data]);
         }
 
-        return self::create($data);
+        return static::create($data);
     }
 
     /**  Get a Post Author instance by username, or null if not found. */

From 9fa15e62b608cfc71f2ccb2c4c3134b6d0c899fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:17:12 +0200
Subject: [PATCH 2361/4023] Update documentation for replacement method

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index a40ae89ec37..92d673c2d89 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -67,7 +67,7 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * Construct a new Post Author object.
      *
-     * If your input is in the form of an array, you may rather want to use the `getOrCreate` method.
+     * If your input is in the form of an array, you may rather want to use the `create` method.
      *
      * @param  string  $username
      * @param  string|null  $name

From bac4eb2428dbe8e2fa31a3757e4cbb7564bf626b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:17:27 +0200
Subject: [PATCH 2362/4023] Remove the `PostAuthor::getOrCreate` method

---
 .../Features/Blogging/Models/PostAuthor.php   | 19 -------------------
 1 file changed, 19 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 92d673c2d89..f48a3c17c4a 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -12,7 +12,6 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
-use function is_string;
 use function array_merge;
 use function array_filter;
 
@@ -98,24 +97,6 @@ public static function create(array $data): PostAuthor
         ], $data));
     }
 
-    /**
-     * Dynamically get or create an author based on a username string or front matter array.
-     *
-     * @deprecated Use either `get` or `create` directly depending on your use case.
-     *
-     * @codeCoverageIgnore Until we can remove this method.
-     *
-     * @param  string|array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
-     */
-    public static function getOrCreate(string|array $data): static
-    {
-        if (is_string($data)) {
-            return static::get($data) ?? static::create(['username' => $data]);
-        }
-
-        return static::create($data);
-    }
-
     /**  Get a Post Author instance by username, or null if not found. */
     public static function get(string $username): ?static
     {

From 557168f22acbdec2a3c6b979b1b75dd6b5c65683 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:20:33 +0200
Subject: [PATCH 2363/4023] Normalize documentation formatting

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index f48a3c17c4a..0740774cfd9 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -64,7 +64,7 @@ class PostAuthor implements Stringable, SerializableContract
     public readonly ?array $socials;
 
     /**
-     * Construct a new Post Author object.
+     * Construct a new Post Author instance with the given data.
      *
      * If your input is in the form of an array, you may rather want to use the `create` method.
      *

From c5270468cb20783111e0b76c11d609fa3261c0cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:20:54 +0200
Subject: [PATCH 2364/4023] Document that username will never be null

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 0740774cfd9..adbb48c8b75 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -88,6 +88,8 @@ public function __construct(string $username, ?string $name = null, ?string $web
     /**
      * Create a new Post Author instance from an array of data.
      *
+     * If you do not supply a username, the name will be used as the username, or 'Guest' if no name is provided.
+     *
      * @param  array{username?: string, name?: string, website?: string, bio?: string, avatar?: string, socials?: array<string, string>}  $data
      */
     public static function create(array $data): PostAuthor

From 2f16657daf62039e387c9c1be912d3f11354b864 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:21:17 +0200
Subject: [PATCH 2365/4023] Document where the key comes from

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index adbb48c8b75..d60e98651d9 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -25,7 +25,7 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * The username of the author.
      *
-     * This is the key used to find authors in the config.
+     * This is the key used to find authors in the config and is taken from that array key.
      */
     public readonly string $username;
 

From 7290ccd96b605039158059823a071eb518be49f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:25:32 +0200
Subject: [PATCH 2366/4023] Document string to string map type

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index d60e98651d9..a0fbd52b4ed 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -57,7 +57,7 @@ class PostAuthor implements Stringable, SerializableContract
     /**
      * The author's social media links/handles.
      *
-     * @var ?array<string, string>
+     * @var ?array<string, string> String-to-string map of social media services to their respective handles.
      *
      * @example ['twitter' => 'mr_hyde'] ($service => $handle)
      */

From f86d01c057d39675a51566a24cd159ce8ecae5a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:29:15 +0200
Subject: [PATCH 2367/4023] Update fallback username to be lowercase

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php   | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php            | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index a0fbd52b4ed..98b2aa6c2e8 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -136,6 +136,6 @@ public function getPosts(): PageCollection
     /** @param array{username?: string, name?: string, website?: string} $data */
     protected static function findUsernameFromData(array $data): string
     {
-        return $data['username'] ?? $data['name'] ?? 'Guest';
+        return $data['username'] ?? $data['name'] ?? 'guest';
     }
 }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 4b59ada48d2..a7ad69b21a3 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -129,8 +129,8 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWitho
             'website' => $data['website'],
         ]);
 
-        $this->assertSame('Guest', $author->username);
-        $this->assertSame('Guest', $author->name);
+        $this->assertSame('guest', $author->username);
+        $this->assertSame('guest', $author->name);
         $this->assertSame($data['website'], $author->website);
     }
 
@@ -217,7 +217,7 @@ public function testCreateMethodWithNoUsernameUsesGuestAsUsernameIfNoNameIsSuppl
     {
         $author = PostAuthor::create([]);
 
-        $this->assertEquals($author, new PostAuthor('Guest')); // Todo: Should we expect (and normalize to?) lowercase 'guest'?
+        $this->assertEquals($author, new PostAuthor('guest'));
     }
 
     public function testCanDefineAuthorWithNoDataInConfig()

From b8bad2560e936d10f8ddf5a173f57cb366333caa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:37:42 +0200
Subject: [PATCH 2368/4023] Normalize post author usernames to lowercase

This approach offers several benefits:

1.  Consistency: All internal operations use the lowercase username.
2.  Simplicity: We're not adding any new properties, just using the existing ones more effectively.
3.  Backwards compatibility: Existing code that uses the `username` property will continue to work, just with a normalized value.
4.  Flexibility: The pretty username (in the `name` property) can still be used for display purposes with any desired capitalization.

This solution adheres to the Principle of Least Astonishment by:

*   Using a consistent, predictable format for usernames internally
*   Allowing flexible display names through the existing `name` property
*   Maintaining the expected behavior of existing methods

It also improves DX by reducing the chance of errors due to case sensitivity in username comparisons.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php    | 5 +++--
 packages/framework/tests/Feature/MarkdownPostTest.php        | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php             | 2 +-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 98b2aa6c2e8..094a9b8a926 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -12,6 +12,7 @@
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
+use function strtolower;
 use function array_merge;
 use function array_filter;
 
@@ -77,7 +78,7 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
-        $this->username = $username;
+        $this->username = strtolower($username);
         $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
@@ -136,6 +137,6 @@ public function getPosts(): PageCollection
     /** @param array{username?: string, name?: string, website?: string} $data */
     protected static function findUsernameFromData(array $data): string
     {
-        return $data['username'] ?? $data['name'] ?? 'guest';
+        return strtolower($data['username'] ?? $data['name'] ?? 'guest');
     }
 }
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index 4040d1c35c7..d79b1525a45 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -24,7 +24,7 @@ public function testConstructorCanCreateANewAuthorInstanceFromUsernameString()
         ]));
 
         $this->assertInstanceOf(PostAuthor::class, $post->author);
-        $this->assertSame('John Doe', $post->author->username);
+        $this->assertSame('john doe', $post->author->username);
         $this->assertSame('John Doe', $post->author->name);
         $this->assertNull($post->author->website);
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index a7ad69b21a3..5a9e0fc20ac 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -116,7 +116,7 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWitho
             'website' => $data['website'],
         ]);
 
-        $this->assertSame($data['name'], $author->username);
+        $this->assertSame(strtolower($data['name']), $author->username);
         $this->assertSame($data['name'], $author->name);
         $this->assertSame($data['website'], $author->website);
     }

From 33a75b2c15e6890af3da5558c4462029422976b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:46:45 +0200
Subject: [PATCH 2369/4023] Normalize post author usernames to snake case

This approach offers several advantages:

1.  Consistency: All generated usernames will follow the same snake\_case format.
2.  URL-friendly: Snake_case is often used in URLs and is generally more web-friendly.
3.  Readability: It maintains readability while removing spaces and special characters.
4.  Uniqueness: It reduces the chance of conflicts between similar names.

In terms of the Principle of Least Astonishment and good DX:

1.  It's a common convention in many systems to use snake\_case for identifiers, so it aligns with developer expectations.
2.  It creates a clear distinction between the username (used for identification and linking) and the display name.
3.  It's predictable and easy to understand how a display name will be converted to a username.

While we usually use kebab-case slugs, I think using snake_case is better here as it matches what we recommend for the config keys, and the idea is to emulate those. Most importantly, these are URL routable compared to using just lowercase.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php   | 6 +++---
 packages/framework/tests/Feature/MarkdownPostTest.php       | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php            | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 094a9b8a926..2e79d4cb226 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -6,13 +6,13 @@
 
 use Hyde\Hyde;
 use Stringable;
+use Illuminate\Support\Str;
 use Hyde\Pages\MarkdownPost;
 use Illuminate\Support\Collection;
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Support\Contracts\SerializableContract;
 
-use function strtolower;
 use function array_merge;
 use function array_filter;
 
@@ -78,7 +78,7 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
-        $this->username = strtolower($username);
+        $this->username = Str::slug($username, '_');
         $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
@@ -137,6 +137,6 @@ public function getPosts(): PageCollection
     /** @param array{username?: string, name?: string, website?: string} $data */
     protected static function findUsernameFromData(array $data): string
     {
-        return strtolower($data['username'] ?? $data['name'] ?? 'guest');
+        return Str::slug($data['username'] ?? $data['name'] ?? 'guest', '_');
     }
 }
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index d79b1525a45..bf14c1946e6 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -24,7 +24,7 @@ public function testConstructorCanCreateANewAuthorInstanceFromUsernameString()
         ]));
 
         $this->assertInstanceOf(PostAuthor::class, $post->author);
-        $this->assertSame('john doe', $post->author->username);
+        $this->assertSame('john_doe', $post->author->username);
         $this->assertSame('John Doe', $post->author->name);
         $this->assertNull($post->author->website);
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 5a9e0fc20ac..5b33709909c 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -116,7 +116,7 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWitho
             'website' => $data['website'],
         ]);
 
-        $this->assertSame(strtolower($data['name']), $author->username);
+        $this->assertSame('mr_hyde', $author->username);
         $this->assertSame($data['name'], $author->name);
         $this->assertSame($data['website'], $author->website);
     }

From 1fd4ef24f6a0fdcc80ca4b0074775bc7b0c67b8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:51:31 +0200
Subject: [PATCH 2370/4023] Extract helper method

---
 .../Framework/Features/Blogging/Models/PostAuthor.php    | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 2e79d4cb226..68e592f7ee1 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -78,7 +78,7 @@ class PostAuthor implements Stringable, SerializableContract
      */
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
-        $this->username = Str::slug($username, '_');
+        $this->username = static::normalizeUsername($username);
         $this->name = $name ?? $username;
         $this->website = $website;
         $this->bio = $bio;
@@ -137,6 +137,11 @@ public function getPosts(): PageCollection
     /** @param array{username?: string, name?: string, website?: string} $data */
     protected static function findUsernameFromData(array $data): string
     {
-        return Str::slug($data['username'] ?? $data['name'] ?? 'guest', '_');
+        return static::normalizeUsername($data['username'] ?? $data['name'] ?? 'guest');
+    }
+
+    protected static function normalizeUsername(string $username): string
+    {
+        return Str::slug($username, '_');
     }
 }

From b41c4a65924ca3cd70ac52f23dd3c54785a9ee55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 21:54:18 +0200
Subject: [PATCH 2371/4023] Test the username is normalized

---
 .../framework/tests/Unit/PostAuthorTest.php   | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 5b33709909c..863654cac74 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -290,6 +290,27 @@ public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
         $this->assertNull($author);
     }
 
+    public function testUsernameIsNormalized()
+    {
+        $author = new PostAuthor('Foo Bar');
+
+        $this->assertSame('foo_bar', $author->username);
+    }
+
+    public function testUsernameIsNormalizedWhenCreatedFromArray()
+    {
+        $author = PostAuthor::create(['username' => 'Foo Bar']);
+
+        $this->assertSame('foo_bar', $author->username);
+    }
+
+    public function testUsernameGeneratedFromNameIsNormalized()
+    {
+        $author = PostAuthor::create(['name' => 'Foo Bar']);
+
+        $this->assertSame('foo_bar', $author->username);
+    }
+
     public function testNameIsSetToUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');

From c5c7611df98e37fb1ccd2d0d7a11dc0ebbfa847b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:04:30 +0200
Subject: [PATCH 2372/4023] Remove fixture with no bearing on test

---
 packages/framework/tests/Unit/PostAuthorTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 863654cac74..4aca0c3997a 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -245,7 +245,7 @@ public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
     public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
     {
         Config::set('hyde.authors', [
-            'foo' => Author::create('foo'),
+            'foo' => Author::create(),
         ]);
 
         $authors = PostAuthor::all();
@@ -258,8 +258,8 @@ public function testAllMethodReturnsCollectionWithAllAuthorsDefinedInConfig()
     public function testMultipleAuthorsCanBeDefinedInConfig()
     {
         Config::set('hyde.authors', [
-            'foo' => Author::create('foo'),
-            'bar' => Author::create('bar'),
+            'foo' => Author::create(),
+            'bar' => Author::create(),
         ]);
 
         $authors = PostAuthor::all();

From f7fac010f170f18ac06993b35d22c191c84935ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:08:14 +0200
Subject: [PATCH 2373/4023] Generate the name as a proper title

This approach offers several benefits:

1.  Consistency: It provides a predictable way to generate display names from usernames.
2.  Readability: The capitalized and spaced version is much more readable as a display name.
3.  Fallback mechanism: It ensures that even if no specific name is provided, there's still a presentable display name.

In terms of the Principle of Least Astonishment and good DX:

1.  It meets user expectations by presenting a capitalized name, which is more common in display contexts.
2.  It maintains the distinction between the lowercase, normalized username and the formatted display name.
3.  It's intuitive -- developers can easily predict how a username will be transformed into a display name.

Considered using just ucfirst, but I think this "all in" method is better. It gives a smart default, but can be easily overridden. Just how it should be in HydePHP.
---
 .../Features/Blogging/Models/PostAuthor.php   |  7 ++++-
 .../framework/tests/Feature/MetadataTest.php  |  2 +-
 .../Feature/PostsAuthorIntegrationTest.php    |  2 +-
 .../framework/tests/Unit/PostAuthorTest.php   | 26 +++++++++++++------
 4 files changed, 26 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 68e592f7ee1..a09f005153c 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -79,7 +79,7 @@ class PostAuthor implements Stringable, SerializableContract
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)
     {
         $this->username = static::normalizeUsername($username);
-        $this->name = $name ?? $username;
+        $this->name = $name ?? static::generateName($username);
         $this->website = $website;
         $this->bio = $bio;
         $this->avatar = $avatar;
@@ -144,4 +144,9 @@ protected static function normalizeUsername(string $username): string
     {
         return Str::slug($username, '_');
     }
+
+    protected static function generateName(string $username): string
+    {
+        return Str::title($username);
+    }
 }
diff --git a/packages/framework/tests/Feature/MetadataTest.php b/packages/framework/tests/Feature/MetadataTest.php
index c5b31be52c3..52773b18a77 100644
--- a/packages/framework/tests/Feature/MetadataTest.php
+++ b/packages/framework/tests/Feature/MetadataTest.php
@@ -476,7 +476,7 @@ public function testDynamicPostAuthorReturnsAuthorNameWhenAuthorSetToArrayUsingU
             ],
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta name="author" content="username">');
+        $this->assertPageHasMetadata($page, '<meta name="author" content="Username">');
     }
 
     public function testDynamicPostAuthorReturnsAuthorNameWhenAuthorSetToArrayUsingName()
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index ce5d49b5879..647d53c668c 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -38,7 +38,7 @@ public function testCreatePostWithUndefinedAuthor()
 
         // Check that the author is rendered as is in the DOM
         $this->assertStringContainsString(
-            '>test_undefined_author</span>',
+            '>Test_Undefined_Author</span>',
             file_get_contents(Hyde::path('_site/posts/post-with-undefined-author.html'))
         );
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 4aca0c3997a..ba6376761f8 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -130,15 +130,15 @@ public function testCanCreateAuthorModelWithSomeDetailsFromArrayUsingCreateWitho
         ]);
 
         $this->assertSame('guest', $author->username);
-        $this->assertSame('guest', $author->name);
+        $this->assertSame('Guest', $author->name);
         $this->assertSame($data['website'], $author->website);
     }
 
-    public function testNameIsSetToUsernameIfNoNameIsProvided()
+    public function testNameIsGeneratedFromUsernameIfNoNameIsProvided()
     {
         $author = new PostAuthor('foo');
 
-        $this->assertSame('foo', $author->name);
+        $this->assertSame('Foo', $author->name);
     }
 
     public function testFacadeCreateMethodCreatesNewPendingAuthorArray()
@@ -210,7 +210,14 @@ public function testCreateMethodWithNoUsernameUsesNameAsUsernameIfNameIsSupplied
     {
         $author = PostAuthor::create(['name' => 'foo']);
 
-        $this->assertEquals($author, new PostAuthor('foo'));
+        $this->assertEquals($author, new PostAuthor('foo', 'foo'));
+    }
+
+    public function testCreateMethodWithNoUsernameUsesNormalizedNameAsUsernameIfNameIsSupplied()
+    {
+        $author = PostAuthor::create(['name' => 'Foo']);
+
+        $this->assertEquals($author, new PostAuthor('foo', 'Foo'));
     }
 
     public function testCreateMethodWithNoUsernameUsesGuestAsUsernameIfNoNameIsSupplied()
@@ -218,6 +225,9 @@ public function testCreateMethodWithNoUsernameUsesGuestAsUsernameIfNoNameIsSuppl
         $author = PostAuthor::create([]);
 
         $this->assertEquals($author, new PostAuthor('guest'));
+
+        $this->assertSame('guest', $author->username);
+        $this->assertSame('Guest', $author->name);
     }
 
     public function testCanDefineAuthorWithNoDataInConfig()
@@ -230,7 +240,7 @@ public function testCanDefineAuthorWithNoDataInConfig()
 
         $this->assertInstanceOf(Collection::class, $authors);
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo', 'foo'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo', 'Foo'), $authors->first());
     }
 
     public function testAllMethodReturnsEmptyCollectionIfNoAuthorsAreSetInConfig()
@@ -311,11 +321,11 @@ public function testUsernameGeneratedFromNameIsNormalized()
         $this->assertSame('foo_bar', $author->username);
     }
 
-    public function testNameIsSetToUsernameIfNameIsNotSet()
+    public function testNameIsCreatedFromUsernameIfNameIsNotSet()
     {
         $author = new PostAuthor('username');
 
-        $this->assertSame('username', $author->name);
+        $this->assertSame('Username', $author->name);
     }
 
     public function testToStringHelperReturnsTheName()
@@ -376,7 +386,7 @@ public function testEmptyFieldsAreRemovedFromSerializedModel()
     {
         $author = new PostAuthor('username', null, null);
 
-        $this->assertSame('{"username":"username","name":"username"}', $author->toJson());
+        $this->assertSame('{"username":"username","name":"Username"}', $author->toJson());
     }
 
     public function testToArrayMethodSerializesAllData()

From 88303fc8e46eb22b6218a34164ad7a9f5a89a9fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:15:17 +0200
Subject: [PATCH 2374/4023] Normalize name before making it into a title

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index a09f005153c..1538e65d1ac 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -147,6 +147,6 @@ protected static function normalizeUsername(string $username): string
 
     protected static function generateName(string $username): string
     {
-        return Str::title($username);
+        return Str::title(Str::slug($username, ' '));
     }
 }

From 27225c09f406bb507be07f9fa42bb6e99fbbc1dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:15:21 +0200
Subject: [PATCH 2375/4023] Revert "Normalize name before making it into a
 title"

This reverts commit 61828bbe2cb3edbbc00139b8b1bb117a458c1086.
---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 1538e65d1ac..a09f005153c 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -147,6 +147,6 @@ protected static function normalizeUsername(string $username): string
 
     protected static function generateName(string $username): string
     {
-        return Str::title(Str::slug($username, ' '));
+        return Str::title($username);
     }
 }

From 6c30e0a2b0c11c6a916a7c82bea6e3cc86bfb33a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:23:06 +0200
Subject: [PATCH 2376/4023] Use more complex title parsing

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php  | 2 +-
 .../framework/tests/Feature/PostsAuthorIntegrationTest.php | 2 +-
 packages/framework/tests/Unit/PostAuthorTest.php           | 7 +++++++
 3 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index a09f005153c..025d758d7df 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -147,6 +147,6 @@ protected static function normalizeUsername(string $username): string
 
     protected static function generateName(string $username): string
     {
-        return Str::title($username);
+        return Str::headline($username);
     }
 }
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index 647d53c668c..7a22d73d5b9 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -38,7 +38,7 @@ public function testCreatePostWithUndefinedAuthor()
 
         // Check that the author is rendered as is in the DOM
         $this->assertStringContainsString(
-            '>Test_Undefined_Author</span>',
+            '>Test Undefined Author</span>',
             file_get_contents(Hyde::path('_site/posts/post-with-undefined-author.html'))
         );
     }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index ba6376761f8..15a91b02c11 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -328,6 +328,13 @@ public function testNameIsCreatedFromUsernameIfNameIsNotSet()
         $this->assertSame('Username', $author->name);
     }
 
+    public function testNameIsCreatedFromComplexUsernameIfNameIsNotSet()
+    {
+        $author = new PostAuthor('foo_bar');
+
+        $this->assertSame('Foo Bar', $author->name);
+    }
+
     public function testToStringHelperReturnsTheName()
     {
         $author = new PostAuthor('username', 'John Doe');

From a0c832ee241b210ce2077758c8bf087e11b155bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:44:54 +0200
Subject: [PATCH 2377/4023] Initial Yaml config error rethrow proof of concept

---
 .../Internal/LoadYamlConfiguration.php        | 51 ++++++++++++++++++-
 .../Internal/YamlConfigurationRepository.php  |  6 ++-
 .../InvalidConfigurationException.php         | 17 +++++--
 .../Feature/YamlConfigurationFeatureTest.php  | 14 +++++
 4 files changed, 80 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 8a8ee8ced32..1d3ecd02b57 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -4,11 +4,14 @@
 
 namespace Hyde\Foundation\Internal;
 
+use Throwable;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 use function array_merge;
 
 /**
@@ -64,9 +67,53 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            // Todo: Catch type errors so we can rethrow them as InvalidConfigurationException with the correct context.
+            try {
+                return [$username => PostAuthor::create($author)];
+            } catch (Throwable $exception) {
+                $message = $exception->getMessage();
 
-            return [$username => PostAuthor::create($author)];
+                $message = $this->trimExceptionMessage($message);
+
+                throw new InvalidConfigurationException(
+                    $message,
+                    'hyde',
+                    "authors.$username",
+                    $this->yaml->getFilePath(),
+                    $this->findConfigLine(file($this->yaml->getFilePath()), $username),
+                    // $exception
+                );
+            }
         });
     }
+
+    private function findConfigLine(array $file, string $username): int
+    {
+        foreach ($file as $line => $content) {
+            if (str_contains($content, "$username:")) {
+                return $line + 1;
+            }
+        }
+    }
+
+    private function trimExceptionMessage(string $message): string
+    {
+        // Trim unnecessary information from the exception message.
+        $leftStrips = [
+            '__construct(): ',
+        ];
+        $rightStrips = [
+            ' called in ',
+        ];
+        // Trim the left side of the message.
+        foreach ($leftStrips as $strip) {
+            $message = Str::after($message, $strip);
+        }
+
+        // Trim the right side of the message.
+        foreach ($rightStrips as $strip) {
+            $message = Str::before($message, $strip);
+        }
+
+        return trim($message, ' .,');
+    }
 }
diff --git a/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php b/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
index 8745e40aa9e..4e44292fa45 100644
--- a/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
+++ b/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
@@ -54,8 +54,12 @@ protected function parseYamlFile(): array
         return Arr::undot((array) Yaml::parse(file_get_contents($this->file)));
     }
 
-    protected function getFilePath(): string|false
+    public function getFilePath(): string|false
     {
+        if (isset($this->file)) {
+            return $this->file;
+        }
+
         return match (true) {
             file_exists(Hyde::path('hyde.yml')) => Hyde::path('hyde.yml'),
             file_exists(Hyde::path('hyde.yaml')) => Hyde::path('hyde.yaml'),
diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 67a13ba331c..78242929720 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,22 +4,29 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Throwable;
 use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
 use function assert;
 use function explode;
 use function realpath;
+use function file_get_contents;
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null, ?string $file = null, ?int $line = null, ?Throwable $previous = null)
     {
-        if ($namespace && $key) {
-            [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
+        if ($file && $line) {
+            $this->file = $file;
+            $this->line = $line;
+        } else {
+            if ($namespace && $key) {
+                [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
+            }
         }
 
-        parent::__construct($message);
+        parent::__construct($message, previous: $previous);
     }
 
     /**
@@ -30,7 +37,7 @@ public function __construct(string $message = 'Invalid configuration detected.',
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = realpath("config/$namespace.php");
-        $contents = Filesystem::getContents($file);
+        $contents = file_get_contents($file);
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 41d657de0c8..f32c1872f65 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -7,6 +7,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 /**
  * Test the Yaml configuration feature.
@@ -438,6 +439,19 @@ public function testCanSetAuthorsInTheYamlConfig()
         $this->assertSame(null, $authors['test']->socials);
     }
 
+    public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        authors:
+          wrong:
+            name: false
+        YAML);
+
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Invalid value for "name" in "authors.wrong"');
+        $this->runBootstrappers();
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 4c7cd81fb9c5cdfd24b6071d6e095d7287d9e1b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 7 Jul 2024 22:46:52 +0200
Subject: [PATCH 2378/4023] Revert "Initial Yaml config error rethrow proof of
 concept"

This reverts commit a0c832ee241b210ce2077758c8bf087e11b155bf.
---
 .../Internal/LoadYamlConfiguration.php        | 51 +------------------
 .../Internal/YamlConfigurationRepository.php  |  6 +--
 .../InvalidConfigurationException.php         | 17 ++-----
 .../Feature/YamlConfigurationFeatureTest.php  | 14 -----
 4 files changed, 8 insertions(+), 80 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 1d3ecd02b57..8a8ee8ced32 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -4,14 +4,11 @@
 
 namespace Hyde\Foundation\Internal;
 
-use Throwable;
 use Illuminate\Support\Arr;
-use Illuminate\Support\Str;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 
-use Hyde\Framework\Exceptions\InvalidConfigurationException;
 use function array_merge;
 
 /**
@@ -67,53 +64,9 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            try {
-                return [$username => PostAuthor::create($author)];
-            } catch (Throwable $exception) {
-                $message = $exception->getMessage();
+            // Todo: Catch type errors so we can rethrow them as InvalidConfigurationException with the correct context.
 
-                $message = $this->trimExceptionMessage($message);
-
-                throw new InvalidConfigurationException(
-                    $message,
-                    'hyde',
-                    "authors.$username",
-                    $this->yaml->getFilePath(),
-                    $this->findConfigLine(file($this->yaml->getFilePath()), $username),
-                    // $exception
-                );
-            }
+            return [$username => PostAuthor::create($author)];
         });
     }
-
-    private function findConfigLine(array $file, string $username): int
-    {
-        foreach ($file as $line => $content) {
-            if (str_contains($content, "$username:")) {
-                return $line + 1;
-            }
-        }
-    }
-
-    private function trimExceptionMessage(string $message): string
-    {
-        // Trim unnecessary information from the exception message.
-        $leftStrips = [
-            '__construct(): ',
-        ];
-        $rightStrips = [
-            ' called in ',
-        ];
-        // Trim the left side of the message.
-        foreach ($leftStrips as $strip) {
-            $message = Str::after($message, $strip);
-        }
-
-        // Trim the right side of the message.
-        foreach ($rightStrips as $strip) {
-            $message = Str::before($message, $strip);
-        }
-
-        return trim($message, ' .,');
-    }
 }
diff --git a/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php b/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
index 4e44292fa45..8745e40aa9e 100644
--- a/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
+++ b/packages/framework/src/Foundation/Internal/YamlConfigurationRepository.php
@@ -54,12 +54,8 @@ protected function parseYamlFile(): array
         return Arr::undot((array) Yaml::parse(file_get_contents($this->file)));
     }
 
-    public function getFilePath(): string|false
+    protected function getFilePath(): string|false
     {
-        if (isset($this->file)) {
-            return $this->file;
-        }
-
         return match (true) {
             file_exists(Hyde::path('hyde.yml')) => Hyde::path('hyde.yml'),
             file_exists(Hyde::path('hyde.yaml')) => Hyde::path('hyde.yaml'),
diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 78242929720..67a13ba331c 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,29 +4,22 @@
 
 namespace Hyde\Framework\Exceptions;
 
-use Throwable;
 use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
 use function assert;
 use function explode;
 use function realpath;
-use function file_get_contents;
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null, ?string $file = null, ?int $line = null, ?Throwable $previous = null)
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
     {
-        if ($file && $line) {
-            $this->file = $file;
-            $this->line = $line;
-        } else {
-            if ($namespace && $key) {
-                [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
-            }
+        if ($namespace && $key) {
+            [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
         }
 
-        parent::__construct($message, previous: $previous);
+        parent::__construct($message);
     }
 
     /**
@@ -37,7 +30,7 @@ public function __construct(string $message = 'Invalid configuration detected.',
     protected function findConfigLine(string $namespace, string $key): array
     {
         $file = realpath("config/$namespace.php");
-        $contents = file_get_contents($file);
+        $contents = Filesystem::getContents($file);
         $lines = explode("\n", $contents);
 
         foreach ($lines as $line => $content) {
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index f32c1872f65..41d657de0c8 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -7,7 +7,6 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
-use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 /**
  * Test the Yaml configuration feature.
@@ -439,19 +438,6 @@ public function testCanSetAuthorsInTheYamlConfig()
         $this->assertSame(null, $authors['test']->socials);
     }
 
-    public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
-    {
-        $this->file('hyde.yml', <<<'YAML'
-        authors:
-          wrong:
-            name: false
-        YAML);
-
-        $this->expectException(InvalidConfigurationException::class);
-        $this->expectExceptionMessage('Invalid value for "name" in "authors.wrong"');
-        $this->runBootstrappers();
-    }
-
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 9bb7853a466ca6a18dc08f26db3e519cd0571764 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:06:48 +0200
Subject: [PATCH 2379/4023] Rethrow type errors as configuration exceptions

Using line finding like in https://github.com/hydephp/develop/pull/1798/commits/a0c832ee241b210ce2077758c8bf087e11b155bf adds way too much complexity to be justified. Just a hint to check the syntax should be enough.
---
 .../Foundation/Internal/LoadYamlConfiguration.php  | 13 ++++++++++---
 .../tests/Feature/YamlConfigurationFeatureTest.php | 14 ++++++++++++++
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 8a8ee8ced32..6a1cda350e7 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -4,10 +4,12 @@
 
 namespace Hyde\Foundation\Internal;
 
+use Throwable;
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 use function array_merge;
 
@@ -64,9 +66,14 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            // Todo: Catch type errors so we can rethrow them as InvalidConfigurationException with the correct context.
-
-            return [$username => PostAuthor::create($author)];
+            try {
+                return [$username => PostAuthor::create($author)];
+            } catch (Throwable $exception) {
+                throw new InvalidConfigurationException(
+                    'Invalid author configuration detected in the YAML config file. Please double check the syntax.',
+                    previous: $exception
+                );
+            }
         });
     }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 41d657de0c8..1e7f788c4dc 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -7,6 +7,7 @@
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 /**
  * Test the Yaml configuration feature.
@@ -438,6 +439,19 @@ public function testCanSetAuthorsInTheYamlConfig()
         $this->assertSame(null, $authors['test']->socials);
     }
 
+    public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        authors:
+          wrong:
+            name: false
+        YAML);
+
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Invalid author configuration detected in the YAML config file. Please double check the syntax.');
+        $this->runBootstrappers();
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 2ad5de23ecc0464e98cd066a5593f1e44e60cfb9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:07:01 +0200
Subject: [PATCH 2380/4023] Update custom exception class to accept previous
 throwable

---
 .../Framework/Exceptions/InvalidConfigurationException.php   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 67a13ba331c..694566ed717 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Throwable;
 use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
@@ -13,13 +14,13 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null, ?Throwable $previous = null)
     {
         if ($namespace && $key) {
             [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
         }
 
-        parent::__construct($message);
+        parent::__construct($message, previous: $previous);
     }
 
     /**

From 106b4c16f03857db39a58143e4814859edc8c126 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:09:18 +0200
Subject: [PATCH 2381/4023] Custom exception testing as default breaks file
 memory

For some reason, this tears down the application to soon, meaning the filesystem class is gone.
---
 .../tests/Feature/YamlConfigurationFeatureTest.php   | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 1e7f788c4dc..9c34bf1fdec 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -441,15 +441,19 @@ public function testCanSetAuthorsInTheYamlConfig()
 
     public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
     {
-        $this->file('hyde.yml', <<<'YAML'
+        file_put_contents('hyde.yml', <<<'YAML'
         authors:
           wrong:
             name: false
         YAML);
 
-        $this->expectException(InvalidConfigurationException::class);
-        $this->expectExceptionMessage('Invalid author configuration detected in the YAML config file. Please double check the syntax.');
-        $this->runBootstrappers();
+        try {
+            $this->runBootstrappers();
+        } catch (InvalidConfigurationException $exception) {
+            $this->assertSame('Invalid author configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+        }
+
+        unlink('hyde.yml');
     }
 
     protected function runBootstrappers(?array $withMergedConfig = null): void

From 41e0d190413f4fbc8c6bbffb8bf3dc0ceaaa8b9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:32:09 +0200
Subject: [PATCH 2382/4023] Fix wrong test names

---
 packages/framework/tests/Unit/PostAuthorTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 15a91b02c11..43e5239aa9e 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -181,7 +181,7 @@ public function testGetMethodReturnsNullWhenAuthorIsNotFound()
         $this->assertNull($author);
     }
 
-    public function testGetMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
+    public function testCreateMethodCreatesNewAuthorModelFromStringCanFindExistingAuthor()
     {
         Config::set('hyde.authors', [
             'foo' => Author::create('bar'),
@@ -190,7 +190,7 @@ public function testGetMethodCreatesNewAuthorModelFromStringCanFindExistingAutho
         $this->assertEquals(PostAuthor::get('foo'), new PostAuthor('foo', 'bar'));
     }
 
-    public function testGetMethodCreatesNewAuthorModelFromArray()
+    public function testCreateMethodCreatesNewAuthorModelFromArray()
     {
         $author = PostAuthor::create([
             'username' => 'foo',

From 58711e6f4929aad49088dc2a4f35b15e7c0f9444 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:32:47 +0200
Subject: [PATCH 2383/4023] Improve formatting

---
 packages/framework/tests/Unit/PostAuthorTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 43e5239aa9e..9f08f3ffd65 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -285,6 +285,7 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
         Config::set('hyde.authors', [
             'foo' => Author::create('bar'),
         ]);
+
         $author = PostAuthor::get('foo');
 
         $this->assertInstanceOf(PostAuthor::class, $author);
@@ -295,6 +296,7 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
     public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
     {
         Config::set('hyde.authors', []);
+
         $author = PostAuthor::get('foo');
 
         $this->assertNull($author);

From 21faf4687f18c7e176f82ac29e2cd758b12e71ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 12:07:01 +0200
Subject: [PATCH 2384/4023] Update custom exception class to accept previous
 throwable

---
 .../Exceptions/InvalidConfigurationException.php         | 5 +++--
 packages/framework/tests/Unit/CustomExceptionsTest.php   | 9 +++++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 67a13ba331c..694566ed717 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Exceptions;
 
+use Throwable;
 use Hyde\Facades\Filesystem;
 use InvalidArgumentException;
 
@@ -13,13 +14,13 @@
 
 class InvalidConfigurationException extends InvalidArgumentException
 {
-    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null)
+    public function __construct(string $message = 'Invalid configuration detected.', ?string $namespace = null, ?string $key = null, ?Throwable $previous = null)
     {
         if ($namespace && $key) {
             [$this->file, $this->line] = $this->findConfigLine($namespace, $key);
         }
 
-        parent::__construct($message);
+        parent::__construct($message, previous: $previous);
     }
 
     /**
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index dc6e9b460f7..6009a31bc4e 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -201,4 +201,13 @@ public function testInvalidConfigurationExceptionWithNamespaceAndKey()
         $this->assertStringContainsString('config'.DIRECTORY_SEPARATOR.'hyde.php', $exception->getFile());
         $this->assertGreaterThan(0, $exception->getLine());
     }
+
+    public function testInvalidConfigurationExceptionWithPreviousThrowable()
+    {
+        $previous = new Exception('Previous exception.');
+        $exception = new InvalidConfigurationException('Invalid configuration.', 'hyde', 'name', $previous);
+
+        $this->assertSame('Invalid configuration.', $exception->getMessage());
+        $this->assertSame($previous, $exception->getPrevious());
+    }
 }

From 41f5a91319302f086504ed3ca16e873b00878a51 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:08:17 +0200
Subject: [PATCH 2385/4023] Normalize the usernames when retrieving them

---
 .../Features/Blogging/Models/PostAuthor.php   |  2 +-
 .../tests/Feature/MarkdownPostTest.php        | 17 +++++++++++++
 .../framework/tests/Unit/PostAuthorTest.php   | 24 +++++++++++++++++++
 3 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 025d758d7df..553ce6777a6 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -103,7 +103,7 @@ public static function create(array $data): PostAuthor
     /**  Get a Post Author instance by username, or null if not found. */
     public static function get(string $username): ?static
     {
-        return static::all()->get($username);
+        return static::all()->get(static::normalizeUsername($username));
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Framework\Features\Blogging\Models\PostAuthor> */
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index bf14c1946e6..9716c9c78bf 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -45,6 +45,23 @@ public function testConstructorCanCreateANewAuthorInstanceFromUserArray()
         $this->assertSame('https://example.com', $post->author->website);
     }
 
+    public function testAuthorRetrievalUsesNormalizedUsernameToFindTheRightAuthorRegardlessOfFormatting()
+    {
+        $postA = new MarkdownPost(matter: FrontMatter::fromArray([
+            'author' => 'mr hyde',
+        ]));
+
+        $postB = new MarkdownPost(matter: FrontMatter::fromArray([
+            'author' => 'Mr Hyde',
+        ]));
+
+        $postC = new MarkdownPost(matter: FrontMatter::fromArray([
+            'author' => 'mr_hyde',
+        ]));
+
+        $this->assertAllSame($postA->author, $postB->author, $postC->author);
+    }
+
     public function testConstructorCanCreateANewImageInstanceFromAString()
     {
         $post = new MarkdownPost(matter: FrontMatter::fromArray([
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 9f08f3ffd65..b30b200d917 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Facades\Author;
 use Hyde\Pages\MarkdownPost;
+use Hyde\Testing\FluentTestingHelpers;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
@@ -17,6 +18,8 @@
  */
 class PostAuthorTest extends UnitTestCase
 {
+    use FluentTestingHelpers;
+
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
@@ -293,6 +296,27 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
         $this->assertSame('bar', $author->name);
     }
 
+    public function testGetMethodNormalizesUsernamesForRetrieval()
+    {
+        Config::set('hyde.authors', [
+            'foo_bar' => Author::create(),
+        ]);
+
+        $author = PostAuthor::get('Foo bar');
+
+        $this->assertInstanceOf(PostAuthor::class, $author);
+        $this->assertSame('foo_bar', $author->username);
+        $this->assertSame('Foo Bar', $author->name);
+
+        $this->assertAllSame(
+            PostAuthor::get('foo_bar'),
+            PostAuthor::get('foo-bar'),
+            PostAuthor::get('foo bar'),
+            PostAuthor::get('Foo Bar'),
+            PostAuthor::get('FOO BAR'),
+        );
+    }
+
     public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
     {
         Config::set('hyde.authors', []);

From fc9bd9e0264641a0ff890f1966cf0ef5a09609af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:17:25 +0200
Subject: [PATCH 2386/4023] Move up test

---
 .../framework/tests/Unit/PostAuthorTest.php    | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index b30b200d917..4eb4b00d243 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -296,6 +296,15 @@ public function testGetMethodReturnsConfigDefinedAuthorByUsername()
         $this->assertSame('bar', $author->name);
     }
 
+    public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
+    {
+        Config::set('hyde.authors', []);
+
+        $author = PostAuthor::get('foo');
+
+        $this->assertNull($author);
+    }
+
     public function testGetMethodNormalizesUsernamesForRetrieval()
     {
         Config::set('hyde.authors', [
@@ -317,15 +326,6 @@ public function testGetMethodNormalizesUsernamesForRetrieval()
         );
     }
 
-    public function testGetMethodReturnsNullIfUsernameNotFoundInConfig()
-    {
-        Config::set('hyde.authors', []);
-
-        $author = PostAuthor::get('foo');
-
-        $this->assertNull($author);
-    }
-
     public function testUsernameIsNormalized()
     {
         $author = new PostAuthor('Foo Bar');

From 9cdbed38deea18ca15aa771c0b2f66625ad82170 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:24:48 +0200
Subject: [PATCH 2387/4023] Make protected normalization helper public internal

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 553ce6777a6..f7dd78593a5 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -140,7 +140,8 @@ protected static function findUsernameFromData(array $data): string
         return static::normalizeUsername($data['username'] ?? $data['name'] ?? 'guest');
     }
 
-    protected static function normalizeUsername(string $username): string
+    /** @internal */
+    public static function normalizeUsername(string $username): string
     {
         return Str::slug($username, '_');
     }

From d9ceeefc3b9b94e21eae40c8b3f4fac6e839be99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:30:33 +0200
Subject: [PATCH 2388/4023] Normalize the usernames when parsing the author
 config

See discussion at https://github.com/hydephp/develop/pull/1798#discussion_r1669148862
---
 .../src/Foundation/Concerns/HasKernelData.php |  2 ++
 .../framework/tests/Unit/PostAuthorTest.php   | 30 +++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 0e292d09c2f..071d8d8caa6 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -55,6 +55,8 @@ protected function parseConfigurationAuthors(Collection $authors): Collection
                 throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
 
+            $username = PostAuthor::normalizeUsername($username);
+
             $author['username'] = $username;
 
             return [$username => PostAuthor::create($author)];
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 4eb4b00d243..8f5199cd4b7 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -326,6 +326,36 @@ public function testGetMethodNormalizesUsernamesForRetrieval()
         );
     }
 
+    public function testAuthorUsernamesAreNormalizedInTheConfig()
+    {
+        Config::set('hyde.authors', [
+            'foo_bar' => Author::create(),
+            'foo-bar' => Author::create(),
+            'foo bar' => Author::create(),
+            'Foo Bar' => Author::create(),
+            'FOO BAR' => Author::create(),
+        ]);
+
+        $this->assertCount(1, PostAuthor::all());
+    }
+
+    public function testOnlyLastAuthorWithNormalizedUsernameIsKept()
+    {
+        // Technically, a first come, first-served principle would make most sense,
+        // but this is the lightest code implementation and can be used for now.
+
+        Config::set('hyde.authors', [
+            'foo_bar' => Author::create('Author 1'),
+            'foo-bar' => Author::create('Author 2'),
+            'foo bar' => Author::create('Author 3'),
+        ]);
+
+        $authors = PostAuthor::all();
+
+        $this->assertCount(1, $authors);
+        $this->assertEquals(new PostAuthor('foo_bar', 'Author 3'), $authors->first());
+    }
+
     public function testUsernameIsNormalized()
     {
         $author = new PostAuthor('Foo Bar');

From 196ceb71312fdf9e3f8ab57badfc70967a742a5f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:34:12 +0200
Subject: [PATCH 2389/4023] Test covers HasKernelData trait

---
 packages/framework/tests/Unit/PostAuthorTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 8f5199cd4b7..e0204b1a906 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -15,6 +15,7 @@
 
 /**
  * @covers \Hyde\Framework\Features\Blogging\Models\PostAuthor
+ * @covers \Hyde\Foundation\Concerns\HasKernelData
  */
 class PostAuthorTest extends UnitTestCase
 {

From a03541585e646144cf45f47b82ee2f170e6f9f9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:41:20 +0200
Subject: [PATCH 2390/4023] Add a filter pass to only keep the first author
 with matching username

See https://github.com/hydephp/develop/pull/1798#discussion_r1669181306
---
 .../framework/src/Foundation/Concerns/HasKernelData.php    | 4 +++-
 packages/framework/tests/Unit/PostAuthorTest.php           | 7 ++-----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index 071d8d8caa6..d94ca8d5726 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -50,7 +50,9 @@ public function authors(): Collection
 
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
-        return $authors->mapWithKeys(function (array $author, string $username): array {
+        return $authors->unique(function (array $author, string $username): string {
+            return PostAuthor::normalizeUsername($username);
+        })->mapWithKeys(function (array $author, string $username): array {
             if (! $username) {
                 throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e0204b1a906..0afd4146ca1 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -340,11 +340,8 @@ public function testAuthorUsernamesAreNormalizedInTheConfig()
         $this->assertCount(1, PostAuthor::all());
     }
 
-    public function testOnlyLastAuthorWithNormalizedUsernameIsKept()
+    public function testOnlyFirstAuthorWithNormalizedUsernameIsKept()
     {
-        // Technically, a first come, first-served principle would make most sense,
-        // but this is the lightest code implementation and can be used for now.
-
         Config::set('hyde.authors', [
             'foo_bar' => Author::create('Author 1'),
             'foo-bar' => Author::create('Author 2'),
@@ -354,7 +351,7 @@ public function testOnlyLastAuthorWithNormalizedUsernameIsKept()
         $authors = PostAuthor::all();
 
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo_bar', 'Author 3'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo_bar', 'Author 1'), $authors->first());
     }
 
     public function testUsernameIsNormalized()

From e91e646e2472ebf3f8ba2187f675ecd33b58de70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:41:47 +0200
Subject: [PATCH 2391/4023] Revert "Add a filter pass to only keep the first
 author"

This reverts commit 1c727fe4b15dcd46e8e4e14f33c5130036feb45e as the complexity cannot be justified. See https://github.com/hydephp/develop/pull/1798#discussion_r1669193311
---
 .../framework/src/Foundation/Concerns/HasKernelData.php    | 4 +---
 packages/framework/tests/Unit/PostAuthorTest.php           | 7 +++++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasKernelData.php b/packages/framework/src/Foundation/Concerns/HasKernelData.php
index d94ca8d5726..071d8d8caa6 100644
--- a/packages/framework/src/Foundation/Concerns/HasKernelData.php
+++ b/packages/framework/src/Foundation/Concerns/HasKernelData.php
@@ -50,9 +50,7 @@ public function authors(): Collection
 
     protected function parseConfigurationAuthors(Collection $authors): Collection
     {
-        return $authors->unique(function (array $author, string $username): string {
-            return PostAuthor::normalizeUsername($username);
-        })->mapWithKeys(function (array $author, string $username): array {
+        return $authors->mapWithKeys(function (array $author, string $username): array {
             if (! $username) {
                 throw new InvalidConfigurationException('Author username cannot be empty. Did you forget to set the author\'s array key?', 'hyde', 'authors');
             }
diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index 0afd4146ca1..e0204b1a906 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -340,8 +340,11 @@ public function testAuthorUsernamesAreNormalizedInTheConfig()
         $this->assertCount(1, PostAuthor::all());
     }
 
-    public function testOnlyFirstAuthorWithNormalizedUsernameIsKept()
+    public function testOnlyLastAuthorWithNormalizedUsernameIsKept()
     {
+        // Technically, a first come, first-served principle would make most sense,
+        // but this is the lightest code implementation and can be used for now.
+
         Config::set('hyde.authors', [
             'foo_bar' => Author::create('Author 1'),
             'foo-bar' => Author::create('Author 2'),
@@ -351,7 +354,7 @@ public function testOnlyFirstAuthorWithNormalizedUsernameIsKept()
         $authors = PostAuthor::all();
 
         $this->assertCount(1, $authors);
-        $this->assertEquals(new PostAuthor('foo_bar', 'Author 1'), $authors->first());
+        $this->assertEquals(new PostAuthor('foo_bar', 'Author 3'), $authors->first());
     }
 
     public function testUsernameIsNormalized()

From 838fa42614d1649c2631fd1f581fc0ace238845a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 21:44:16 +0200
Subject: [PATCH 2392/4023] Remove todo

---
 packages/framework/tests/Unit/PostAuthorTest.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Unit/PostAuthorTest.php b/packages/framework/tests/Unit/PostAuthorTest.php
index e0204b1a906..3eeb7bd0d27 100644
--- a/packages/framework/tests/Unit/PostAuthorTest.php
+++ b/packages/framework/tests/Unit/PostAuthorTest.php
@@ -342,9 +342,6 @@ public function testAuthorUsernamesAreNormalizedInTheConfig()
 
     public function testOnlyLastAuthorWithNormalizedUsernameIsKept()
     {
-        // Technically, a first come, first-served principle would make most sense,
-        // but this is the lightest code implementation and can be used for now.
-
         Config::set('hyde.authors', [
             'foo_bar' => Author::create('Author 1'),
             'foo-bar' => Author::create('Author 2'),

From 86f9025f0e54ad0a8c0263f9f0aa609c21831823 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 8 Jul 2024 22:20:41 +0200
Subject: [PATCH 2393/4023] Write new release notes for the new author system

---
 RELEASE_NOTES.md | 52 ++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 41 insertions(+), 11 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3a3f3fc2eb5..9e683ffcf96 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -152,20 +152,50 @@ Of course, if you have disabled any of the features, do not include them in the
 
 ### Post Author changes
 
-This release makes major improvements into the usability and design of the blog post author feature.
+This release makes major improvements to the usability and design of the blog post author feature.
 
 Here is the full list of changes:
 
-- Breaking: The `hyde.authors` config setting should now be keyed by the usernames
-- Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`)
-- Feature: We now support setting authors in the YAML configuration! Fixes `#1719`
-- Feature: Added a `$author->getPosts()` method to get all author's posts
-- Feature: Authors now can also have custom biographies and social media links
-- The PostAuthor class is now Arrayable and JsonSerializable
-- The collection of site authors are now stored in the HydeKernel
-- Authors can additionally be accessed through `Hyde::authors()`
-
-For more information, see https://github.com/hydephp/develop/pull/1782
+- Breaking: The `hyde.authors` config setting must now be keyed by the usernames, instead of providing the username in the author facade constructor.
+- Breaking: The `Author::create()` method now returns an array instead of a `PostAuthor` instance. This only affects custom code that uses the `Author` facade.
+- Breaking: The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. This only affects custom code that uses the `Author` facade.
+- Removed: The deprecated `PostAuthor::getName()` method has been removed (use `$author->name` instead).
+- Changed: Author usernames are now automatically normalized (converted to lowercase and spaces replaced with underscores in order to ensure URL routability).
+- Changed: If an author display name is not provided, it is now intelligently generated from the username.
+- Feature: Authors can now be set in the YAML configuration.
+- Feature: Added a `$author->getPosts()` method to get all of an author's posts.
+- Feature: Authors now support custom biographies, avatars, and social media links. Note that these are not currently used in any of the default templates, but you can use them in your custom views.
+- The collection of site authors is now stored in the HydeKernel, meaning authors can be accessed through `Hyde::authors()`.
+- The `PostAuthor` class is now Arrayable and JsonSerializable.
+
+#### Upgrade guide:
+
+1. Update your `config/hyde.php` file to use the new author configuration format:
+   ```php
+   'authors' => [
+       'username' => Author::create(
+           name: 'Display Name',
+           website: 'https://example.com',
+           bio: 'Author bio',
+           avatar: 'avatar.png',
+           socials: ['twitter' => '@username']
+       ),
+   ],
+   ```
+
+2. Review and update any code that uses the `Author` facade:
+  - The `create()` method now returns an array instead of a `PostAuthor` instance.
+  - The `get()` method may return `null`, so handle this case in your code.
+
+3. Check your blog post front matter and ensure that `author` fields match the new username keys in your configuration.
+
+4. If you have custom templates that use author data, update them to:
+  - Optional: Feel free to use the new available fields: `bio`, `avatar`, and `socials`.
+  - Account for usernames now being lowercase with underscores which may lead to changed HTML or URL paths.
+
+5. If you were relying on `Author::get()` to create new authors on the fly, update your code to handle `null` returns or create authors explicitly.
+
+For more information, see https://github.com/hydephp/develop/pull/1782 and https://github.com/hydephp/develop/pull/1798
 
 ### Documentation search page changes
 

From f25e4423543a8d53aeb58d90f0d66a34facc36e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 09:49:39 +0200
Subject: [PATCH 2394/4023] Document all breaking author changes in changelist

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9e683ffcf96..998c920ef11 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -21,6 +21,8 @@ This serves two purposes:
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
 - **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames. For more information, see below.
+- **Breaking:** The `Author::create()` method now returns an array instead of a `PostAuthor` instance. For more information, see below.
+- **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)

From 50de689dafb9c569cfe93417bb4bb76aa68eee50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:09:44 +0200
Subject: [PATCH 2395/4023] Test all post author fields can be set in front
 matter

---
 .../Feature/PostsAuthorIntegrationTest.php    | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index 7a22d73d5b9..9fdc0f22ec8 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Facades\Author;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Framework\Actions\CreatesNewMarkdownPostFile;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
@@ -91,6 +92,46 @@ public function testCreatePostWithDefinedAuthorWithWebsite()
         );
     }
 
+    public function testAllPostAuthorFieldsCanBeSetInFrontMatter()
+    {
+        $this->file('_posts/post-with-all-author-fields.md', <<<'MD'
+            ---
+            author:
+                username: mr_hyde
+                name: Mr. Hyde
+                website: https://hydephp.com
+                bio: The mysterious author of HydePHP
+                avatar: avatar.png
+                socials:
+                    twitter: "@HydeFramework"
+                    github: hydephp
+            ---
+            
+            # Post with all author fields
+            MD
+        );
+
+        $this->artisan('rebuild _posts/post-with-all-author-fields.md')->assertExitCode(0);
+        $this->cleanUpWhenDone('_site/posts/post-with-all-author-fields.html');
+        $this->assertFileExists(Hyde::path('_site/posts/post-with-all-author-fields.html'));
+
+        $page = MarkdownPost::get('post-with-all-author-fields');
+        $this->assertNotNull($page);
+        $this->assertNotNull($page->author);
+
+        $this->assertSame([
+            'username' => 'mr_hyde',
+            'name' => 'Mr. Hyde',
+            'website' => 'https://hydephp.com',
+            'bio' => 'The mysterious author of HydePHP',
+            'avatar' => 'avatar.png',
+            'socials' => [
+                'twitter' => '@HydeFramework',
+                'github' => 'hydephp',
+            ],
+        ], $page->author->toArray());
+    }
+
     protected function createPostFile(string $title, string $author): void
     {
         (new CreatesNewMarkdownPostFile($title, '', '', $author))->save();

From 6c3f56d1f10f9acb32b58fd0b6842ec4826cfcb7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:15:44 +0200
Subject: [PATCH 2396/4023] Update customization documentation for new author
 system

---
 docs/digging-deeper/customization.md | 31 +++++++++++++++++++++-------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index de5730d01e1..58bddbbf00e 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -124,21 +124,29 @@ Here are the default settings:
 
 ### Authors
 
-Hyde has support for adding authors in front matter, for example to automatically add a link to your website or social media profiles.
-However, it's tedious to have to add those to each and every post you make, and keeping them updated is even harder.
+Hyde supports adding authors to blog posts, allowing you to automatically include information like display names and website links.
+We even support fields for avatars, biographies, and social media profiles, which you can use in your custom Blade templates. 
 
+While you can set all this data directly in the front matter, that quickly becomes tedious and hard to maintain.
 Instead, you can predefine authors in the Hyde config. When writing posts, just specify the username in the front matter,
 and the rest of the data will be pulled from a matching entry found in the configuration file.
 
-#### Example
+#### Configuration
+
+Authors are defined in the `config/hyde.php` file under the `authors` key. Each author is keyed by their username and configured using the `Author::create()` method:
 
 ```php
 // filepath: config/hyde.php
 'authors' => [
-    Author::create(
-        username: 'mr_hyde', // Required username
-        name: 'Mr. Hyde', // Optional display name
-        website: 'https://hydephp.com' // Optional website URL
+    'mr_hyde' => Author::create(
+        name: 'Mr. Hyde',
+        website: 'https://hydephp.com',
+        bio: 'The mysterious author of HydePHP',
+        avatar: 'avatar.png',
+        socials: [
+            'twitter' => '@HydeFramework',
+            'github' => 'hydephp',
+        ],
     ),
 ],
 ```
@@ -150,14 +158,21 @@ author:
     username: mr_hyde
     name: Mr. Hyde
     website: https://hydephp.com
+    bio: The mysterious author of HydePHP
+    avatar: avatar.png
+    socials:
+        twitter: "@HydeFramework"
+        github: hydephp
 ```
 
-But you only have to specify the username:
+But you only have to specify the username to get all the other data.
 
 ```yaml
 author: mr_hyde
 ```
 
+If you want to override some of the data for a specific post, you can do so in the front matter. Additionally, the front matter method is great for guest authors or one-off posts.
+
 ### Footer
 
 Most websites have a footer with copyright details and contact information. You probably want to change the Markdown to include your information, though you are of course welcome to keep the default attribution link!

From c788172bac8a30a7b4bdc136964107cf1844df56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:18:10 +0200
Subject: [PATCH 2397/4023] Improve wording

---
 docs/digging-deeper/customization.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 58bddbbf00e..9e245974bc4 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -133,7 +133,7 @@ and the rest of the data will be pulled from a matching entry found in the confi
 
 #### Configuration
 
-Authors are defined in the `config/hyde.php` file under the `authors` key. Each author is keyed by their username and configured using the `Author::create()` method:
+Authors are defined in the `config/hyde.php` file under the `authors` key. Each author is keyed by their username and is configured using the `Author::create()` method:
 
 ```php
 // filepath: config/hyde.php

From 9510e21445ac269420ace0dd6dcde6134fdadcc7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:19:22 +0200
Subject: [PATCH 2398/4023] Link to related docs

---
 docs/digging-deeper/customization.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 9e245974bc4..be9bf142863 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -127,7 +127,7 @@ Here are the default settings:
 Hyde supports adding authors to blog posts, allowing you to automatically include information like display names and website links.
 We even support fields for avatars, biographies, and social media profiles, which you can use in your custom Blade templates. 
 
-While you can set all this data directly in the front matter, that quickly becomes tedious and hard to maintain.
+While you can set all this data directly in the [front matter](blog-posts#author), that quickly becomes tedious and hard to maintain.
 Instead, you can predefine authors in the Hyde config. When writing posts, just specify the username in the front matter,
 and the rest of the data will be pulled from a matching entry found in the configuration file.
 

From 33d786bfbc56f7c50d6d62be394fa61ac6f1ded9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:16:18 +0200
Subject: [PATCH 2399/4023] Test configured post author fields can be
 customized in front matter

---
 .../Feature/PostsAuthorIntegrationTest.php    | 75 +++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index 9fdc0f22ec8..d6ee4467e49 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -132,6 +132,81 @@ public function testAllPostAuthorFieldsCanBeSetInFrontMatter()
         ], $page->author->toArray());
     }
 
+    public function testConfiguredPostAuthorFieldsCanBeCustomizedInFrontMatter()
+    {
+        Config::set('hyde.authors', [
+            'mr_hyde' => Author::create(
+                name: 'Mr. Hyde',
+                website: 'https://hydephp.com',
+                bio: 'The mysterious author of HydePHP',
+                avatar: 'avatar.png',
+                socials: [
+                    'twitter' => '@HydeFramework',
+                    'github' => 'hydephp',
+                ],
+            ),
+        ]);
+
+        $this->file('_posts/literal.md', <<<'MD'
+            ---
+            author: mr_hyde
+            ---
+            
+            # Using the configured author
+            MD
+        );
+
+        $this->file('_posts/changed.md', <<<'MD'
+            ---
+            author:
+                username: mr_hyde
+                name: Dr. Jekyll
+            ---
+            
+            # Modifying the configured author
+            MD
+        );
+
+        $this->artisan('rebuild _posts/literal.md')->assertExitCode(0);
+        $this->artisan('rebuild _posts/changed.md')->assertExitCode(0);
+        $this->assertFileExists(Hyde::path('_site/posts/literal.html'));
+        $this->assertFileExists(Hyde::path('_site/posts/changed.html'));
+        $this->cleanUpWhenDone('_site/posts/literal.html');
+        $this->cleanUpWhenDone('_site/posts/changed.html');
+
+        $page = MarkdownPost::get('literal');
+        $this->assertNotNull($page);
+        $this->assertNotNull($page->author);
+
+        $this->assertSame([
+            'username' => 'mr_hyde',
+            'name' => 'Mr. Hyde',
+            'website' => 'https://hydephp.com',
+            'bio' => 'The mysterious author of HydePHP',
+            'avatar' => 'avatar.png',
+            'socials' => [
+                'twitter' => '@HydeFramework',
+                'github' => 'hydephp',
+            ],
+        ], $page->author->toArray());
+
+        $page = MarkdownPost::get('changed');
+        $this->assertNotNull($page);
+        $this->assertNotNull($page->author);
+
+        $this->assertSame([
+            'username' => 'mr_hyde',
+            'name' => 'Dr. Jekyll',
+            'website' => 'https://hydephp.com',
+            'bio' => 'The mysterious author of HydePHP',
+            'avatar' => 'avatar.png',
+            'socials' => [
+                'twitter' => '@HydeFramework',
+                'github' => 'hydephp',
+            ],
+        ], $page->author->toArray());
+    }
+
     protected function createPostFile(string $title, string $author): void
     {
         (new CreatesNewMarkdownPostFile($title, '', '', $author))->save();

From b1bb99a7be8348683a94efcd3120925632d0f817 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:22:35 +0200
Subject: [PATCH 2400/4023] Fix documented discrepancy against actuality as
 changes are not merged

---
 docs/digging-deeper/customization.md                   |  2 +-
 .../tests/Feature/PostsAuthorIntegrationTest.php       | 10 ++--------
 2 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index be9bf142863..5d066e7653b 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -171,7 +171,7 @@ But you only have to specify the username to get all the other data.
 author: mr_hyde
 ```
 
-If you want to override some of the data for a specific post, you can do so in the front matter. Additionally, the front matter method is great for guest authors or one-off posts.
+If you want to override the data for a specific post, you can do so in the front matter. Additionally, the front matter method is great for guest authors or one-off posts.
 
 ### Footer
 
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index d6ee4467e49..c88d2389929 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -132,7 +132,7 @@ public function testAllPostAuthorFieldsCanBeSetInFrontMatter()
         ], $page->author->toArray());
     }
 
-    public function testConfiguredPostAuthorFieldsCanBeCustomizedInFrontMatter()
+    public function testConfiguredPostAuthorFieldsCanBeOverriddenInFrontMatter()
     {
         Config::set('hyde.authors', [
             'mr_hyde' => Author::create(
@@ -197,13 +197,7 @@ public function testConfiguredPostAuthorFieldsCanBeCustomizedInFrontMatter()
         $this->assertSame([
             'username' => 'mr_hyde',
             'name' => 'Dr. Jekyll',
-            'website' => 'https://hydephp.com',
-            'bio' => 'The mysterious author of HydePHP',
-            'avatar' => 'avatar.png',
-            'socials' => [
-                'twitter' => '@HydeFramework',
-                'github' => 'hydephp',
-            ],
+            // The original fields are not overwritten
         ], $page->author->toArray());
     }
 

From b8a2b10f816ddbacb44cbb50ec78dbb3163be9f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:24:22 +0200
Subject: [PATCH 2401/4023] Improve documentation section wording

---
 docs/digging-deeper/customization.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 5d066e7653b..572aae3b5d5 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -171,7 +171,7 @@ But you only have to specify the username to get all the other data.
 author: mr_hyde
 ```
 
-If you want to override the data for a specific post, you can do so in the front matter. Additionally, the front matter method is great for guest authors or one-off posts.
+If you want to override the data for a specific post, you can do so in the [front matter](blog-posts#author) which is great for guest authors or one-off posts.
 
 ### Footer
 

From 5fda7061c0b6a7846c094cdd91d8a5937fea7ffa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:26:00 +0200
Subject: [PATCH 2402/4023] Document the optional fields better

---
 docs/digging-deeper/customization.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 572aae3b5d5..829f0b09fde 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -139,8 +139,11 @@ Authors are defined in the `config/hyde.php` file under the `authors` key. Each
 // filepath: config/hyde.php
 'authors' => [
     'mr_hyde' => Author::create(
+        // The following fields, along with the username, are used by the default blog post templates.
         name: 'Mr. Hyde',
         website: 'https://hydephp.com',
+        
+        // These fields are not currently used in the default templates, but you can use them in your custom views.
         bio: 'The mysterious author of HydePHP',
         avatar: 'avatar.png',
         socials: [

From a5fe0e05b473b47a737ed82f5071fbcc74edada8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:30:42 +0200
Subject: [PATCH 2403/4023] Document fields and notes

---
 docs/digging-deeper/customization.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 829f0b09fde..1349c01d9b4 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -176,6 +176,23 @@ author: mr_hyde
 
 If you want to override the data for a specific post, you can do so in the [front matter](blog-posts#author) which is great for guest authors or one-off posts.
 
+
+#### Available Fields
+
+- `name`: The author's display name (optional, generated from username if not provided)
+- `website`: The author's website URL (optional)
+- `bio`: A short biography (optional, not used in default templates)
+- `avatar`: Path to the author's avatar image (optional, not used in default templates)
+- `socials`: An array of social media links (optional, not used in default templates)
+
+#### Notes
+
+- Usernames are automatically normalized (converted to lowercase with spaces replaced by underscores)
+- The `PostAuthor` class includes a `getPosts()` method to retrieve all posts by an author
+- Authors can be accessed through `Hyde::authors()`
+
+For more advanced usage and customization, refer to the source code which is well documented.
+
 ### Footer
 
 Most websites have a footer with copyright details and contact information. You probably want to change the Markdown to include your information, though you are of course welcome to keep the default attribution link!

From 60b68311a08e5c117f7b6af260bc934cf6aa64d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:30:49 +0200
Subject: [PATCH 2404/4023] Link to the source code

---
 docs/digging-deeper/customization.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 1349c01d9b4..75a01280a7b 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -191,7 +191,7 @@ If you want to override the data for a specific post, you can do so in the [fron
 - The `PostAuthor` class includes a `getPosts()` method to retrieve all posts by an author
 - Authors can be accessed through `Hyde::authors()`
 
-For more advanced usage and customization, refer to the source code which is well documented.
+For more advanced usage and customization, refer to the [source code](https://github.com/hydephp/framework/blob/master/src/Framework/Features/Blogging/Models/PostAuthor.php) which is well documented.
 
 ### Footer
 

From 931f429f4f040bf395a4dac4863876640962326b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:31:28 +0200
Subject: [PATCH 2405/4023] Link to the facade

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index f7dd78593a5..79778bc4799 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -18,6 +18,8 @@
 
 /**
  * Object representation of a blog post author for the site.
+ *
+ * @see \Hyde\Facades\Author For the facade to conveniently interact with and create authors.
  */
 class PostAuthor implements Stringable, SerializableContract
 {

From d1927e503c57e317a0cf6c12bed2b188e42f061c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 10:33:41 +0200
Subject: [PATCH 2406/4023] Update blog post documentation for new author
 system

---
 docs/creating-content/blog-posts.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index 182c395cdff..c0557cd468c 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -150,13 +150,23 @@ author: mr_hyde
 
 ```yaml
 author:
+    # These are used in the default author templates
     name: "Mr. Hyde"
     username: mr_hyde
     website: https://twitter.com/HydeFramework
+
+    # These are not used in the default author templates, but can be used in your custom views
+    bio: "The mysterious author of HydePHP"
+    avatar: avatar.png
+    socials:
+      twitter: "@HydeFramework"
+      github: "hydephp"
 ```
 
-When specifying an array you don't need all the sub-properties. The example just shows all the supported values.
-Array values here will override all the values in the `authors` config entry, if one exists.
+
+When using an array, you don't need to include all properties. Specified values will override the corresponding entries in the `authors` config.
+
+Note: Author usernames are automatically normalized (converted to lowercase with spaces replaced by underscores).
 
 ### Image
 

From 1086372b422fe0e99dcd9fb4354ecc1cc6b33dce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 9 Jul 2024 13:02:50 +0200
Subject: [PATCH 2407/4023] Migrate configuration to 2.x Authors API

[2.x] Breaking: Improve the new Authors API
---
 monorepo/gh-pages/gh-pages-config-dev-docs/config/hyde.php | 3 +--
 monorepo/gh-pages/gh-pages-config/config/hyde.php          | 3 +--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/monorepo/gh-pages/gh-pages-config-dev-docs/config/hyde.php b/monorepo/gh-pages/gh-pages-config-dev-docs/config/hyde.php
index 8c2fac4bd92..afe764c64fb 100644
--- a/monorepo/gh-pages/gh-pages-config-dev-docs/config/hyde.php
+++ b/monorepo/gh-pages/gh-pages-config-dev-docs/config/hyde.php
@@ -144,8 +144,7 @@
     */
 
     'authors' => [
-        Author::create(
-            username: 'mr_hyde', // Required username
+        'mr_hyde' => Author::create(
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com' // Optional website URL
         ),
diff --git a/monorepo/gh-pages/gh-pages-config/config/hyde.php b/monorepo/gh-pages/gh-pages-config/config/hyde.php
index 90c42014b33..590ab91162a 100644
--- a/monorepo/gh-pages/gh-pages-config/config/hyde.php
+++ b/monorepo/gh-pages/gh-pages-config/config/hyde.php
@@ -143,8 +143,7 @@
     */
 
     'authors' => [
-        Author::create(
-            username: 'mr_hyde', // Required username
+        'mr_hyde' => Author::create(
             name: 'Mr. Hyde', // Optional display name
             website: 'https://hydephp.com' // Optional website URL
         ),

From 9046c882eac9d6f8ea28e6d222bc7476189c843d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 12:43:07 +0200
Subject: [PATCH 2408/4023] Create NavigationFacadeTest.php

---
 .../tests/Unit/Facades/NavigationFacadeTest.php   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Facades/NavigationFacadeTest.php

diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
new file mode 100644
index 00000000000..f9474f285bc
--- /dev/null
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Facades;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Facades\Navigation
+ */
+class NavigationFacadeTest extends UnitTestCase
+{
+    //
+}

From 1b4b0b494fa39ac73f3a11f6a596f624c526f9e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 12:39:10 +0200
Subject: [PATCH 2409/4023] Create Navigation.php

---
 packages/framework/src/Facades/Navigation.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Facades/Navigation.php

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
new file mode 100644
index 00000000000..a1e2286b01f
--- /dev/null
+++ b/packages/framework/src/Facades/Navigation.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Facades;
+
+class Navigation
+{
+    //
+}

From 53c29dc9fe45a67dbc55789b858e48189e35e40f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 12:44:04 +0200
Subject: [PATCH 2410/4023] Alias the Navigation facade

---
 app/config.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/config.php b/app/config.php
index ab5db6907b0..143a4a6dda4 100644
--- a/app/config.php
+++ b/app/config.php
@@ -97,6 +97,7 @@
         'Features' => \Hyde\Facades\Features::class,
         'Config' => \Hyde\Facades\Config::class,
         'Filesystem' => \Hyde\Facades\Filesystem::class,
+        'Navigation' => \Hyde\Facades\Navigation::class,
         'Routes' => \Hyde\Foundation\Facades\Routes::class,
         'HtmlPage' => \Hyde\Pages\HtmlPage::class,
         'BladePage' => \Hyde\Pages\BladePage::class,

From c35db97b1c8b8235243182a13589c19a2d02d1c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 12:46:51 +0200
Subject: [PATCH 2411/4023] Add facade class documentation

---
 packages/framework/src/Facades/Navigation.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index a1e2286b01f..60d4ac8360a 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Facades;
 
+/**
+ * General facade for navigation features.
+ */
 class Navigation
 {
     //

From 7638b0a9beb30caa81d9739abb4c0184402f93b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:03:52 +0200
Subject: [PATCH 2412/4023] Import used function

---
 packages/framework/src/Facades/Author.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Author.php b/packages/framework/src/Facades/Author.php
index 1b810bb19ee..c5e042742d0 100644
--- a/packages/framework/src/Facades/Author.php
+++ b/packages/framework/src/Facades/Author.php
@@ -7,6 +7,8 @@
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Illuminate\Support\Collection;
 
+use function compact;
+
 /**
  * Allows you to easily add pre-defined authors for your blog posts.
  *

From 97aea64db307fc6a234f4d32b08cac53142436d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 12:57:02 +0200
Subject: [PATCH 2413/4023] Refactor unit test to use the unit test case

---
 .../tests/Unit/Facades/AuthorTest.php         | 20 +++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorTest.php
index b15dec9a55f..8c61b3e5993 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorTest.php
@@ -4,15 +4,31 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Hyde;
 use Hyde\Facades\Author;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
-use Hyde\Testing\TestCase;
+use Hyde\Testing\UnitTestCase;
 
 /**
  * @covers \Hyde\Facades\Author
  */
-class AuthorTest extends TestCase
+class AuthorTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        static $config = null;
+
+        if ($config === null) {
+            $config = require_once Hyde::path('config/hyde.php');
+        }
+
+        self::mockConfig(['hyde' => $config]);
+    }
+
     public function testCreate()
     {
         $author = Author::create('John Doe', 'https://johndoe.com');

From 241a894d7643651dd98e38f315cbb30fccfef98c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:03:21 +0200
Subject: [PATCH 2414/4023] Simplify test

---
 packages/framework/tests/Unit/Facades/AuthorTest.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorTest.php
index 8c61b3e5993..8213f6b558b 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorTest.php
@@ -20,11 +20,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        static $config = null;
-
-        if ($config === null) {
-            $config = require_once Hyde::path('config/hyde.php');
-        }
+        $config = require_once Hyde::path('config/hyde.php');
 
         self::mockConfig(['hyde' => $config]);
     }

From a387d53b7575a73f4cd1b6126c2ec65ea27abe88 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:05:07 +0200
Subject: [PATCH 2415/4023] Use require instead of require once

---
 packages/framework/tests/Unit/Facades/AuthorTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorTest.php
index 8213f6b558b..4e295379f55 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorTest.php
@@ -20,7 +20,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        $config = require_once Hyde::path('config/hyde.php');
+        $config = require Hyde::path('config/hyde.php');
 
         self::mockConfig(['hyde' => $config]);
     }

From fa5ad03fcabecad32aec9919ffde1272bf852a82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:07:02 +0200
Subject: [PATCH 2416/4023] Revert "Simplify test"

This reverts commit 241a894d7643651dd98e38f315cbb30fccfef98c.
---
 packages/framework/tests/Unit/Facades/AuthorTest.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorTest.php
index 4e295379f55..8c45f5637e9 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorTest.php
@@ -20,7 +20,11 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        $config = require Hyde::path('config/hyde.php');
+        static $config = null;
+
+        if ($config === null) {
+            $config = require Hyde::path('config/hyde.php');
+        }
 
         self::mockConfig(['hyde' => $config]);
     }

From b49214951f4daa5301a8eb554d15cc5e468c650c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:10:47 +0200
Subject: [PATCH 2417/4023] Rename test to make it easier to find

---
 .../tests/Unit/Facades/{AuthorTest.php => AuthorFacadeTest.php} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Unit/Facades/{AuthorTest.php => AuthorFacadeTest.php} (98%)

diff --git a/packages/framework/tests/Unit/Facades/AuthorTest.php b/packages/framework/tests/Unit/Facades/AuthorFacadeTest.php
similarity index 98%
rename from packages/framework/tests/Unit/Facades/AuthorTest.php
rename to packages/framework/tests/Unit/Facades/AuthorFacadeTest.php
index 8c45f5637e9..43bc49291e2 100644
--- a/packages/framework/tests/Unit/Facades/AuthorTest.php
+++ b/packages/framework/tests/Unit/Facades/AuthorFacadeTest.php
@@ -12,7 +12,7 @@
 /**
  * @covers \Hyde\Facades\Author
  */
-class AuthorTest extends UnitTestCase
+class AuthorFacadeTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 

From c97c935f0d0bc65c0e468cb74488d920b4870652 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:12:14 +0200
Subject: [PATCH 2418/4023] Remove unnecessary PHPDoc annotations offering no
 new information

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php    | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 79778bc4799..8b92866f768 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -71,11 +71,6 @@ class PostAuthor implements Stringable, SerializableContract
      *
      * If your input is in the form of an array, you may rather want to use the `create` method.
      *
-     * @param  string  $username
-     * @param  string|null  $name
-     * @param  string|null  $website
-     * @param  string|null  $bio
-     * @param  string|null  $avatar
      * @param  array<string, string>  $socials
      */
     public function __construct(string $username, ?string $name = null, ?string $website = null, ?string $bio = null, ?string $avatar = null, ?array $socials = null)

From 623a8af6c10d31f14d1eeb01c3bcf1419675d320 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 13:12:59 +0200
Subject: [PATCH 2419/4023] Remove extra whitespace in comment

---
 .../src/Framework/Features/Blogging/Models/PostAuthor.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
index 8b92866f768..e9448384f45 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -97,7 +97,7 @@ public static function create(array $data): PostAuthor
         ], $data));
     }
 
-    /**  Get a Post Author instance by username, or null if not found. */
+    /** Get a Post Author instance by username, or null if not found. */
     public static function get(string $username): ?static
     {
         return static::all()->get(static::normalizeUsername($username));

From 5e276288d2008d2d82361f07a544e505086468fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 15:55:39 +0200
Subject: [PATCH 2420/4023] Add configuration helper to the Navigation facade
 to create item array

---
 packages/framework/src/Facades/Navigation.php | 18 ++++++++++++++-
 .../Unit/Facades/NavigationFacadeTest.php     | 23 ++++++++++++++++++-
 2 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 60d4ac8360a..a91b41fef5a 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -4,10 +4,26 @@
 
 namespace Hyde\Facades;
 
+use function compact;
+
 /**
  * General facade for navigation features.
  */
 class Navigation
 {
-    //
+    /**
+     * Configuration helper method to define a new navigation item, with better IDE support.
+     *
+     * The returned array will then be used by the framework to create a new NavigationItem instance.
+     *
+     * @see https://hydephp.com/docs/2.x/navigation-api
+     *
+     * @param  string<\Hyde\Support\Models\RouteKey>|string  $destination  Route key, or an external URI.
+     * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
+     * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     */
+    public static function item(string $destination, ?string $label = null, ?int $priority = null): array
+    {
+        return compact('destination', 'label', 'priority');
+    }
 }
diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index f9474f285bc..2c7e27e61ac 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Facades\Navigation;
 use Hyde\Testing\UnitTestCase;
 
 /**
@@ -11,5 +12,25 @@
  */
 class NavigationFacadeTest extends UnitTestCase
 {
-    //
+    public function testItem(): void
+    {
+        $item = Navigation::item('home', 'Home', 100);
+
+        $this->assertSame([
+            'destination' => 'home',
+            'label' => 'Home',
+            'priority' => 100,
+        ], $item);
+    }
+
+    public function testItemWithOnlyDestination(): void
+    {
+        $item = Navigation::item('home');
+
+        $this->assertSame([
+            'destination' => 'home',
+            'label' => null,
+            'priority' => null,
+        ], $item);
+    }
 }

From 7733c698ceda2d14b60708f2a4674cf9ca5badad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 15:58:32 +0200
Subject: [PATCH 2421/4023] Remove test method type annotations

---
 .../framework/tests/Unit/Facades/NavigationFacadeTest.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index 2c7e27e61ac..b9365eefb0d 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -12,7 +12,7 @@
  */
 class NavigationFacadeTest extends UnitTestCase
 {
-    public function testItem(): void
+    public function testItem()
     {
         $item = Navigation::item('home', 'Home', 100);
 
@@ -23,7 +23,7 @@ public function testItem(): void
         ], $item);
     }
 
-    public function testItemWithOnlyDestination(): void
+    public function testItemWithOnlyDestination()
     {
         $item = Navigation::item('home');
 

From 4c99f022e6a38703bedf837625850fdee735b395 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 15:58:18 +0200
Subject: [PATCH 2422/4023] Test item method with URL

---
 .../tests/Unit/Facades/NavigationFacadeTest.php       | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index b9365eefb0d..bbc7e2d84f0 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -33,4 +33,15 @@ public function testItemWithOnlyDestination()
             'priority' => null,
         ], $item);
     }
+
+    public function testItemWithUrl()
+    {
+        $item = Navigation::item('https://example.com', 'External', 200);
+
+        $this->assertSame([
+            'destination' => 'https://example.com',
+            'label' => 'External',
+            'priority' => 200,
+        ], $item);
+    }
 }

From 598df29b13fac48d3a27ada08c45d18365dc224a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:01:38 +0200
Subject: [PATCH 2423/4023] Prepare generator for configuration type change

---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d2bd01921f8..d2dbab7d0d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -17,6 +17,7 @@
 use function collect;
 use function in_array;
 use function strtolower;
+use function trigger_deprecation;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -81,7 +82,16 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem $item): void {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem|array $item): void {
+                // In preparation of refactor:
+                // @codeCoverageIgnoreStart
+                if (is_array($item)) {
+                    $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+                } else {
+                    trigger_deprecation('hydephp/hyde', '2.0', 'Passing a NavigationItem instance directly to the navigation menu is deprecated. Use the array format instead. (Replace with \Navigation::item(...))');
+                }
+                // @codeCoverageIgnoreEnd
+
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);
             });

From ebb703828bc34064d100862e982916ee7384cd39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:03:32 +0200
Subject: [PATCH 2424/4023] Test covers the navigation facade

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8d3ee0e380d..c5763cf2e89 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -28,6 +28,7 @@
  *
  * @see \Hyde\Framework\Testing\Unit\Views\NavigationHtmlLayoutsTest
  *
+ * @covers \Hyde\Facades\Navigation
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuGenerator
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar

From 7fcd967f0784b248016288e255205fe37eaeb8e9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:06:50 +0200
Subject: [PATCH 2425/4023] Remove temporary refactor code

Want to see where this fails so we can update it in the right places
---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d2dbab7d0d2..e510dcdae28 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -17,7 +17,6 @@
 use function collect;
 use function in_array;
 use function strtolower;
-use function trigger_deprecation;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -82,15 +81,8 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem|array $item): void {
-                // In preparation of refactor:
-                // @codeCoverageIgnoreStart
-                if (is_array($item)) {
-                    $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
-                } else {
-                    trigger_deprecation('hydephp/hyde', '2.0', 'Passing a NavigationItem instance directly to the navigation menu is deprecated. Use the array format instead. (Replace with \Navigation::item(...))');
-                }
-                // @codeCoverageIgnoreEnd
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
+                $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
 
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);

From ab6e659a97f4f667f1183072168f121b1aa732af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:12:33 +0200
Subject: [PATCH 2426/4023] Revert "Remove temporary refactor code"

This reverts commit 7fcd967f0784b248016288e255205fe37eaeb8e9.
---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index e510dcdae28..d2dbab7d0d2 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -17,6 +17,7 @@
 use function collect;
 use function in_array;
 use function strtolower;
+use function trigger_deprecation;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -81,8 +82,15 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
-                $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem|array $item): void {
+                // In preparation of refactor:
+                // @codeCoverageIgnoreStart
+                if (is_array($item)) {
+                    $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+                } else {
+                    trigger_deprecation('hydephp/hyde', '2.0', 'Passing a NavigationItem instance directly to the navigation menu is deprecated. Use the array format instead. (Replace with \Navigation::item(...))');
+                }
+                // @codeCoverageIgnoreEnd
 
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);

From b22c3118d502bb1b4b1bc121cd633f9908ec40fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:12:39 +0200
Subject: [PATCH 2427/4023] Revert "Prepare generator for configuration type
 change"

This reverts commit 598df29b13fac48d3a27ada08c45d18365dc224a.
---
 .../Features/Navigation/NavigationMenuGenerator.php  | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d2dbab7d0d2..d2bd01921f8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -17,7 +17,6 @@
 use function collect;
 use function in_array;
 use function strtolower;
-use function trigger_deprecation;
 
 /**
  * @experimental This class may change significantly before its release.
@@ -82,16 +81,7 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem|array $item): void {
-                // In preparation of refactor:
-                // @codeCoverageIgnoreStart
-                if (is_array($item)) {
-                    $item = NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
-                } else {
-                    trigger_deprecation('hydephp/hyde', '2.0', 'Passing a NavigationItem instance directly to the navigation menu is deprecated. Use the array format instead. (Replace with \Navigation::item(...))');
-                }
-                // @codeCoverageIgnoreEnd
-
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem $item): void {
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);
             });

From 7188b38d998eeaa949e0e1dda367a6e1f2b0eb7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:13:37 +0200
Subject: [PATCH 2428/4023] Breaking: The custom navigation item config now
 uses array inputs

---
 .../Navigation/NavigationMenuGenerator.php    |  4 +-
 .../tests/Feature/NavigationMenuTest.php      | 45 ++++++++++++++++---
 2 files changed, 40 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index d2bd01921f8..c9a0ad405d6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -81,9 +81,9 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (NavigationItem $item): void {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
                 // Since these were added explicitly by the user, we can assume they should always be shown
-                $this->items->push($item);
+                $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null));
             });
         }
     }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 7f6cb8b3ac7..3c6876935c3 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Hyde;
+use Hyde\Facades\Navigation;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
@@ -91,9 +92,39 @@ public function testIsSortedAutomaticallyWhenUsingNavigationMenuCreate()
         $this->assertEquals($expected, $menu->getItems());
     }
 
+    public function testCanAddCustomLinksInConfig()
+    {
+        config(['hyde.navigation.custom' => [Navigation::item('foo', 'Foo')]]);
+
+        $menu = $this->createNavigationMenu();
+
+        $expected = collect([
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create('foo', 'Foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
+    }
+
+    public function testCanAddCustomLinksInConfigAsArray()
+    {
+        config(['hyde.navigation.custom' => [['destination' => 'foo', 'label' => 'Foo']]]);
+
+        $menu = $this->createNavigationMenu();
+
+        $expected = collect([
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create('foo', 'Foo'),
+        ]);
+
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
+    }
+
     public function testExternalLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavigationItem::create('https://example.com', 'foo')]]);
+        config(['hyde.navigation.custom' => [Navigation::item('https://example.com', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
@@ -108,7 +139,7 @@ public function testExternalLinkCanBeAddedInConfig()
 
     public function testPathLinkCanBeAddedInConfig()
     {
-        config(['hyde.navigation.custom' => [NavigationItem::create('foo', 'foo')]]);
+        config(['hyde.navigation.custom' => [Navigation::item('foo', 'foo')]]);
 
         $menu = $this->createNavigationMenu();
 
@@ -124,8 +155,8 @@ public function testPathLinkCanBeAddedInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     {
         config(['hyde.navigation.custom' => [
-            NavigationItem::create('foo', 'foo'),
-            NavigationItem::create('foo', 'foo'),
+            Navigation::item('foo', 'foo'),
+            Navigation::item('foo', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
@@ -143,8 +174,8 @@ public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     public function testDuplicatesAreNotRemovedWhenAddingInConfigRegardlessOfDestination()
     {
         config(['hyde.navigation.custom' => [
-            NavigationItem::create('foo', 'foo'),
-            NavigationItem::create('bar', 'foo'),
+            Navigation::item('foo', 'foo'),
+            Navigation::item('bar', 'foo'),
         ]]);
 
         $menu = $this->createNavigationMenu();
@@ -163,7 +194,7 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
     {
         $this->file('_pages/foo.md');
 
-        config(['hyde.navigation.custom' => [NavigationItem::create('bar', 'Foo')]]);
+        config(['hyde.navigation.custom' => [Navigation::item('bar', 'Foo')]]);
 
         $menu = $this->createNavigationMenu();
 

From 8142e7f8e28d0b1d2d3478c9282708d2a20a90f7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:37:37 +0200
Subject: [PATCH 2429/4023] Update Yaml configuration loader to parse
 navigation items

---
 .../Internal/LoadYamlConfiguration.php        | 16 ++++++++
 .../Feature/YamlConfigurationFeatureTest.php  | 38 +++++++++++++++++++
 2 files changed, 54 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 6a1cda350e7..8ff06c9998d 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -8,6 +8,7 @@
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
@@ -50,6 +51,10 @@ protected function mergeParsedConfiguration(): void
                 $data['authors'] = $this->parseAuthors($data['authors']);
             }
 
+            if ($namespace === 'hyde' && isset($data['navigation']['custom'])) {
+                $data['navigation']['custom'] = $this->parseNavigationItems($data['navigation']['custom']);
+            }
+
             $this->mergeConfiguration($namespace, Arr::undot($data ?: []));
         }
     }
@@ -76,4 +81,15 @@ protected function parseAuthors(array $authors): array
             }
         });
     }
+
+    /**
+     * @param array<array{destination: string, label: ?string, priority: ?int}> $items Where destination is a route key or an external URI.
+     * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
+     */
+    protected function parseNavigationItems(array $items): array
+    {
+        return Arr::map($items, function (array $item): NavigationItem {
+            return NavigationItem::create($item['destination'], $item['label'], $item['priority']);
+        });
+    }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index efb6baeb5c6..cf9c17bf423 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
+use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
@@ -456,6 +457,43 @@ public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
         unlink('hyde.yml');
     }
 
+    public function testCanSetCustomNavigationItemsInTheYamlConfig()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'https://example.com'
+                label: 'Example'
+                priority: 100
+              - destination: 'about'
+                label: 'About Us'
+                priority: 200
+              - destination: 'contact'
+                label: 'Contact'
+                priority: 300
+        YAML);
+
+        $this->runBootstrappers();
+
+        $navigationItems = config('hyde.navigation.custom');
+
+        $this->assertCount(3, $navigationItems);
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
+
+        $this->assertSame('https://example.com', $navigationItems[0]->destination);
+        $this->assertSame('Example', $navigationItems[0]->label);
+        $this->assertSame(100, $navigationItems[0]->priority);
+
+        $this->assertSame('about', $navigationItems[1]->destination);
+        $this->assertSame('About Us', $navigationItems[1]->label);
+        $this->assertSame(200, $navigationItems[1]->priority);
+
+        $this->assertSame('contact', $navigationItems[2]->destination);
+        $this->assertSame('Contact', $navigationItems[2]->label);
+        $this->assertSame(300, $navigationItems[2]->priority);
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From af201607e83f3b98872462670a3df7f024b33e31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:43:40 +0200
Subject: [PATCH 2430/4023] Loader must create array structures as routes are
 not available yet

This is essentially no-op now so we may not need it
---
 .../Internal/LoadYamlConfiguration.php        |  5 +-
 .../Feature/YamlConfigurationFeatureTest.php  | 47 ++++++++++++++-----
 2 files changed, 39 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 8ff06c9998d..8b1fa0b5dc9 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -6,6 +6,7 @@
 
 use Throwable;
 use Illuminate\Support\Arr;
+use Hyde\Facades\Navigation;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Navigation\NavigationItem;
@@ -88,8 +89,8 @@ protected function parseAuthors(array $authors): array
      */
     protected function parseNavigationItems(array $items): array
     {
-        return Arr::map($items, function (array $item): NavigationItem {
-            return NavigationItem::create($item['destination'], $item['label'], $item['priority']);
+        return Arr::map($items, function (array $item): array {
+            return Navigation::item($item['destination'], $item['label'], $item['priority']);
         });
     }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index cf9c17bf423..b9de9681679 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -8,7 +8,9 @@
 use Illuminate\Support\Env;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Exceptions\InvalidConfigurationException;
+use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
  * Test the Yaml configuration feature.
@@ -476,22 +478,45 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
 
         $this->runBootstrappers();
 
-        $navigationItems = config('hyde.navigation.custom');
+        $configItems = config('hyde.navigation.custom');
 
-        $this->assertCount(3, $navigationItems);
+        $this->assertSame([
+            [
+                'destination' => 'https://example.com',
+                'label' => 'Example',
+                'priority' => 100,
+            ], [
+                'destination' => 'about',
+                'label' => 'About Us',
+                'priority' => 200,
+            ], [
+                'destination' => 'contact',
+                'label' => 'Contact',
+                'priority' => 300,
+            ],
+        ], $configItems);
+
+        /** @var NavigationItem[] $navigationItems */
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        $this->assertCount(4, $navigationItems);
         $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
 
-        $this->assertSame('https://example.com', $navigationItems[0]->destination);
-        $this->assertSame('Example', $navigationItems[0]->label);
-        $this->assertSame(100, $navigationItems[0]->priority);
+        $this->assertSame('index.html', $navigationItems[0]->getLink());
+        $this->assertSame('Home', $navigationItems[0]->getLabel());
+        $this->assertSame(0, $navigationItems[0]->getPriority());
+
+        $this->assertSame('https://example.com', $navigationItems[1]->getLink());
+        $this->assertSame('Example', $navigationItems[1]->getLabel());
+        $this->assertSame(100, $navigationItems[1]->getPriority());
 
-        $this->assertSame('about', $navigationItems[1]->destination);
-        $this->assertSame('About Us', $navigationItems[1]->label);
-        $this->assertSame(200, $navigationItems[1]->priority);
+        $this->assertSame('about', $navigationItems[2]->getLink());
+        $this->assertSame('About Us', $navigationItems[2]->getLabel());
+        $this->assertSame(200, $navigationItems[2]->getPriority());
 
-        $this->assertSame('contact', $navigationItems[2]->destination);
-        $this->assertSame('Contact', $navigationItems[2]->label);
-        $this->assertSame(300, $navigationItems[2]->priority);
+        $this->assertSame('contact', $navigationItems[3]->getLink());
+        $this->assertSame('Contact', $navigationItems[3]->getLabel());
+        $this->assertSame(300, $navigationItems[3]->getPriority());
     }
 
     protected function runBootstrappers(?array $withMergedConfig = null): void

From 01f36306263c2661a90de67142cf7b6a7800c4f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 16:44:05 +0200
Subject: [PATCH 2431/4023] Clean up code

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 8b1fa0b5dc9..18413688ebe 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -9,10 +9,10 @@
 use Hyde\Facades\Navigation;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
-use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
+use function tap;
 use function array_merge;
 
 /**
@@ -84,7 +84,7 @@ protected function parseAuthors(array $authors): array
     }
 
     /**
-     * @param array<array{destination: string, label: ?string, priority: ?int}> $items Where destination is a route key or an external URI.
+     * @param  array<array{destination: string, label: ?string, priority: ?int}>  $items  Where destination is a route key or an external URI.
      * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
      */
     protected function parseNavigationItems(array $items): array

From 0724ac00e49919d139026f00291e92cc16ff65d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:04:04 +0200
Subject: [PATCH 2432/4023] Test navigation items in the YAML config can be
 resolved to routes

---
 .../Feature/YamlConfigurationFeatureTest.php  | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index b9de9681679..8457f163fb7 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -4,8 +4,10 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Env;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
@@ -519,6 +521,32 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
         $this->assertSame(300, $navigationItems[3]->getPriority());
     }
 
+    public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'about'
+        YAML);
+
+        $this->runBootstrappers();
+
+        Hyde::routes()->addRoute((new MarkdownPage('about', ['title' => 'About Us', 'navigation' => ['priority' => 250]]))->getRoute());
+
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        // The route is already automatically added to the navigation menu, so we'll have two of it.
+        $this->assertCount(3, $navigationItems);
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
+
+        $this->assertEquals($navigationItems[1], $navigationItems[2]);
+
+        $this->assertSame('about.html', $navigationItems[1]->getLink());
+        $this->assertSame('About Us', $navigationItems[1]->getLabel());
+        $this->assertSame(250, $navigationItems[1]->getPriority());
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 600dfd5e325d73c0d8ebb17158561ce4eda17603 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:09:01 +0200
Subject: [PATCH 2433/4023] Add null fallbacks

---
 .../Internal/LoadYamlConfiguration.php        |  2 +-
 .../Feature/YamlConfigurationFeatureTest.php  | 36 +++++++++++++++++++
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 18413688ebe..d8aa49f44d8 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -90,7 +90,7 @@ protected function parseAuthors(array $authors): array
     protected function parseNavigationItems(array $items): array
     {
         return Arr::map($items, function (array $item): array {
-            return Navigation::item($item['destination'], $item['label'], $item['priority']);
+            return Navigation::item($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
         });
     }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 8457f163fb7..c7cf48962f2 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -521,6 +521,42 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
         $this->assertSame(300, $navigationItems[3]->getPriority());
     }
 
+    public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'about.html'
+        YAML);
+
+        $this->runBootstrappers();
+
+        $configItems = config('hyde.navigation.custom');
+
+        $this->assertSame([
+            [
+                'destination' => 'about.html',
+                'label' => null,
+                'priority' => null,
+            ],
+        ], $configItems);
+
+        /** @var NavigationItem[] $navigationItems */
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        $this->assertCount(2, $navigationItems);
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
+
+        $this->assertSame('index.html', $navigationItems[0]->getLink());
+        $this->assertSame('Home', $navigationItems[0]->getLabel());
+        $this->assertSame(0, $navigationItems[0]->getPriority());
+
+        $this->assertSame('about.html', $navigationItems[1]->getLink());
+        $this->assertSame('about.html', $navigationItems[1]->getLabel()); // The label is automatically set to the destination.
+        $this->assertSame(500, $navigationItems[1]->getPriority());
+    }
+
     public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
     {
         $this->file('hyde.yml', <<<'YAML'

From 9af37e1aceee37d834ee8d88dc9efdafd9f53645 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:14:32 +0200
Subject: [PATCH 2434/4023] Rethrow exceptions more helpfully

---
 .../Internal/LoadYamlConfiguration.php        |  9 ++++-
 .../Feature/YamlConfigurationFeatureTest.php  | 36 +++++++++++++++++++
 2 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index d8aa49f44d8..d3872cc5e55 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -90,7 +90,14 @@ protected function parseAuthors(array $authors): array
     protected function parseNavigationItems(array $items): array
     {
         return Arr::map($items, function (array $item): array {
-            return Navigation::item($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+            try {
+                return Navigation::item($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+            } catch (Throwable $exception) {
+                throw new InvalidConfigurationException(
+                    'Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.',
+                    previous: $exception
+                );
+            }
         });
     }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index c7cf48962f2..a3ee6809eec 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -557,6 +557,42 @@ public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
         $this->assertSame(500, $navigationItems[1]->getPriority());
     }
 
+    public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
+    {
+        file_put_contents('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: false
+        YAML);
+
+        try {
+            $this->runBootstrappers();
+        } catch (InvalidConfigurationException $exception) {
+            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+        }
+
+        unlink('hyde.yml');
+    }
+
+    public function testMustAddDestinationToYamlConfiguredNavigationItems()
+    {
+        file_put_contents('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - label: 'About Us'
+        YAML);
+
+        try {
+            $this->runBootstrappers();
+        } catch (InvalidConfigurationException $exception) {
+            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+        }
+
+        unlink('hyde.yml');
+    }
+
     public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
     {
         $this->file('hyde.yml', <<<'YAML'

From 4e1fbf933b85029bd6c4d63fb62f66a426aaacd2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:14:47 +0200
Subject: [PATCH 2435/4023] Reorder tests

---
 .../Feature/YamlConfigurationFeatureTest.php  | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index a3ee6809eec..bf99165f5d7 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -557,6 +557,32 @@ public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
         $this->assertSame(500, $navigationItems[1]->getPriority());
     }
 
+    public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'about'
+        YAML);
+
+        $this->runBootstrappers();
+
+        Hyde::routes()->addRoute((new MarkdownPage('about', ['title' => 'About Us', 'navigation' => ['priority' => 250]]))->getRoute());
+
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        // The route is already automatically added to the navigation menu, so we'll have two of it.
+        $this->assertCount(3, $navigationItems);
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
+
+        $this->assertEquals($navigationItems[1], $navigationItems[2]);
+
+        $this->assertSame('about.html', $navigationItems[1]->getLink());
+        $this->assertSame('About Us', $navigationItems[1]->getLabel());
+        $this->assertSame(250, $navigationItems[1]->getPriority());
+    }
+
     public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
     {
         file_put_contents('hyde.yml', <<<'YAML'
@@ -593,32 +619,6 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
         unlink('hyde.yml');
     }
 
-    public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
-    {
-        $this->file('hyde.yml', <<<'YAML'
-        hyde:
-          navigation:
-            custom:
-              - destination: 'about'
-        YAML);
-
-        $this->runBootstrappers();
-
-        Hyde::routes()->addRoute((new MarkdownPage('about', ['title' => 'About Us', 'navigation' => ['priority' => 250]]))->getRoute());
-
-        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
-
-        // The route is already automatically added to the navigation menu, so we'll have two of it.
-        $this->assertCount(3, $navigationItems);
-        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
-
-        $this->assertEquals($navigationItems[1], $navigationItems[2]);
-
-        $this->assertSame('about.html', $navigationItems[1]->getLink());
-        $this->assertSame('About Us', $navigationItems[1]->getLabel());
-        $this->assertSame(250, $navigationItems[1]->getPriority());
-    }
-
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 44573ddb8a9ad48e2f2a2c652365b91a60e9bab7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:19:46 +0200
Subject: [PATCH 2436/4023] Mark method as experimental

---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index d3872cc5e55..ed5cf8adef8 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -84,6 +84,8 @@ protected function parseAuthors(array $authors): array
     }
 
     /**
+     * @experimental Since the main configuration also uses arrays, the only thing this method really does is to rethrow any exceptions.
+     *
      * @param  array<array{destination: string, label: ?string, priority: ?int}>  $items  Where destination is a route key or an external URI.
      * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
      */

From 74240c061285a4893feafd2b76461644cb933813 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:20:10 +0200
Subject: [PATCH 2437/4023] Update type annotation to match actual values

---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index ed5cf8adef8..52a80feb8a4 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -87,7 +87,7 @@ protected function parseAuthors(array $authors): array
      * @experimental Since the main configuration also uses arrays, the only thing this method really does is to rethrow any exceptions.
      *
      * @param  array<array{destination: string, label: ?string, priority: ?int}>  $items  Where destination is a route key or an external URI.
-     * @return array<\Hyde\Framework\Features\Navigation\NavigationItem>
+     * @return array<array{destination: string, label: ?string, priority: ?int}>
      */
     protected function parseNavigationItems(array $items): array
     {

From a6c5ba09893f110f3a3d2886d661a36eb8466cde Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:28:31 +0200
Subject: [PATCH 2438/4023] Test extra YAML navigation item fields are ignored

---
 .../Feature/YamlConfigurationFeatureTest.php  | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index bf99165f5d7..c9cf81ffadf 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -583,6 +583,37 @@ public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
         $this->assertSame(250, $navigationItems[1]->getPriority());
     }
 
+    public function testExtraYamlNavigationItemFieldsAreIgnored()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'about'
+                extra: 'field'
+        YAML);
+
+        $this->runBootstrappers();
+
+        $configItems = config('hyde.navigation.custom');
+
+        $this->assertSame([
+            [
+                'destination' => 'about',
+                'label' => null,
+                'priority' => null,
+            ],
+        ], $configItems);
+
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        $this->assertCount(2, $navigationItems);
+
+        $this->assertSame('about', $navigationItems[1]->getLink());
+        $this->assertSame('about', $navigationItems[1]->getLabel());
+        $this->assertSame(500, $navigationItems[1]->getPriority());
+    }
+
     public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
     {
         file_put_contents('hyde.yml', <<<'YAML'

From c773393387e2515469cf60f726b2bfe54ed9f3db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:29:32 +0200
Subject: [PATCH 2439/4023] Revert "Test extra YAML navigation item fields are
 ignored"

This reverts commit a6c5ba09893f110f3a3d2886d661a36eb8466cde.
---
 .../Feature/YamlConfigurationFeatureTest.php  | 31 -------------------
 1 file changed, 31 deletions(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index c9cf81ffadf..bf99165f5d7 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -583,37 +583,6 @@ public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
         $this->assertSame(250, $navigationItems[1]->getPriority());
     }
 
-    public function testExtraYamlNavigationItemFieldsAreIgnored()
-    {
-        $this->file('hyde.yml', <<<'YAML'
-        hyde:
-          navigation:
-            custom:
-              - destination: 'about'
-                extra: 'field'
-        YAML);
-
-        $this->runBootstrappers();
-
-        $configItems = config('hyde.navigation.custom');
-
-        $this->assertSame([
-            [
-                'destination' => 'about',
-                'label' => null,
-                'priority' => null,
-            ],
-        ], $configItems);
-
-        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
-
-        $this->assertCount(2, $navigationItems);
-
-        $this->assertSame('about', $navigationItems[1]->getLink());
-        $this->assertSame('about', $navigationItems[1]->getLabel());
-        $this->assertSame(500, $navigationItems[1]->getPriority());
-    }
-
     public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
     {
         file_put_contents('hyde.yml', <<<'YAML'

From efea4a447d966e64289169fdff75acf040bf91ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:31:10 +0200
Subject: [PATCH 2440/4023] Test adding extra YAML navigation item fields
 throws an exception

---
 .../Feature/YamlConfigurationFeatureTest.php  | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index bf99165f5d7..4d8ea7376a2 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -619,6 +619,25 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
         unlink('hyde.yml');
     }
 
+    public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
+    {
+        file_put_contents('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'about'
+                extra: 'field'
+        YAML);
+
+        try {
+            $this->runBootstrappers();
+        } catch (InvalidConfigurationException $exception) {
+            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+        }
+
+        unlink('hyde.yml');
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From acb740da8ce20b6b1731a70006071ec12753e1dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:31:43 +0200
Subject: [PATCH 2441/4023] Unpack the array directly

Reduces extra code, and adds type safety as it will throw when supplied an extra parameter
---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 52a80feb8a4..0ac92ab01d0 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -93,7 +93,7 @@ protected function parseNavigationItems(array $items): array
     {
         return Arr::map($items, function (array $item): array {
             try {
-                return Navigation::item($item['destination'], $item['label'] ?? null, $item['priority'] ?? null);
+                return Navigation::item(...$item);
             } catch (Throwable $exception) {
                 throw new InvalidConfigurationException(
                     'Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.',

From cc0f567e1ab83f6bab06a009ad7feda6e0ef0c71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:37:30 +0200
Subject: [PATCH 2442/4023] Clean up if a test failed to clean up after itself

---
 .../tests/Feature/YamlConfigurationFeatureTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 4d8ea7376a2..71c1d5c8d24 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -25,6 +25,16 @@
  */
 class YamlConfigurationFeatureTest extends TestCase
 {
+    public static function setUpBeforeClass(): void
+    {
+        parent::setUpBeforeClass();
+
+        if (file_exists('hyde.yml')) {
+            // Clean up if a test failed to clean up after itself.
+            unlink('hyde.yml');
+        }
+    }
+
     protected function tearDown(): void
     {
         $this->clearEnvVars();

From 709bc3541086a671eb62c20f8fa8adac2c9a7348 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:41:29 +0200
Subject: [PATCH 2443/4023] Update navigation item configuration to use the new
 facade

---
 config/hyde.php                    | 3 ++-
 packages/framework/config/hyde.php | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 0898d2a80f4..2cbe97e8047 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -25,6 +25,7 @@
 use Hyde\Facades\Author;
 use Hyde\Facades\Meta;
 use Hyde\Enums\Feature;
+use Hyde\Facades\Navigation;
 
 return [
 
@@ -358,7 +359,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 0898d2a80f4..2cbe97e8047 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -25,6 +25,7 @@
 use Hyde\Facades\Author;
 use Hyde\Facades\Meta;
 use Hyde\Enums\Feature;
+use Hyde\Facades\Navigation;
 
 return [
 
@@ -358,7 +359,7 @@
         // To get started quickly, you can uncomment the defaults here.
         // See the documentation link above for more information.
         'custom' => [
-            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
+            // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ],
 
         // How should pages in subdirectories be displayed in the menu?

From c06a475dfde5f8bd0ba40f781b21f3a5dc8c902b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 17:50:05 +0200
Subject: [PATCH 2444/4023] Breaking: Rename `subdirectories` option to
 `subdirectory_display`

Breaking: Renames the `hyde.navigation.subdirectories` option to `hyde.navigation.subdirectory_display` to make its usage much clearer.
---
 config/hyde.php                               |  2 +-
 docs/digging-deeper/navigation.md             |  4 ++--
 packages/framework/config/hyde.php            |  2 +-
 .../Factories/NavigationDataFactory.php       |  2 +-
 .../Navigation/NavigationMenuGenerator.php    |  2 +-
 .../AutomaticNavigationConfigurationsTest.php | 22 +++++++++----------
 .../framework/tests/Feature/HydePageTest.php  |  6 ++---
 .../tests/Feature/NavigationMenuTest.php      |  6 ++---
 .../NumericalPageOrderingHelperTest.php       |  2 +-
 .../Unit/NavigationDataFactoryUnitTest.php    |  4 ++--
 ...veLinksAcrossPagesRetainsIntegrityTest.php |  2 +-
 .../Unit/Views/NavigationHtmlLayoutsTest.php  |  2 +-
 .../Unit/Views/NavigationMenuViewTest.php     |  4 ++--
 13 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 2cbe97e8047..8d9c62357c5 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -364,7 +364,7 @@
 
         // How should pages in subdirectories be displayed in the menu?
         // You can choose between 'dropdown', 'flat', and 'hidden'.
-        'subdirectories' => 'hidden',
+        'subdirectory_display' => 'hidden',
     ],
 
     /*
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index efbd049babd..3ff1d9d16b9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -259,7 +259,7 @@ Within the Hyde config you can configure how subdirectories should be displayed
 ```php
 // filepath config/hyde.php
 'navigation' => [
-    'subdirectories' => 'dropdown'
+    'subdirectory_display' => 'dropdown'
 ]
 ```
 
@@ -279,7 +279,7 @@ For pages that can be in the main site menu, this feature needs to be enabled in
 // filepath config/hyde.php
 
 'navigation' => [
-    'subdirectories' => 'dropdown',
+    'subdirectory_display' => 'dropdown',
 ],
 ```
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 2cbe97e8047..8d9c62357c5 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -364,7 +364,7 @@
 
         // How should pages in subdirectories be displayed in the menu?
         // You can choose between 'dropdown', 'flat', and 'hidden'.
-        'subdirectories' => 'hidden',
+        'subdirectory_display' => 'hidden',
     ],
 
     /*
diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index b7b331e6db6..61526679f33 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -274,7 +274,7 @@ private function getSubdirectoryName(): string
 
     protected function getSubdirectoryConfiguration(): string
     {
-        return Config::getString('hyde.navigation.subdirectories', 'hidden');
+        return Config::getString('hyde.navigation.subdirectory_display', 'hidden');
     }
 
     /** @param class-string<\Hyde\Pages\Concerns\HydePage> $class */
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index c9a0ad405d6..eae219d2f53 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -96,7 +96,7 @@ protected function usesGroups(): bool
 
             return $this->routes->first(fn (Route $route): bool => filled($route->getPage()->navigationMenuGroup())) !== null;
         } else {
-            return Config::getString('hyde.navigation.subdirectories', 'hidden') === 'dropdown';
+            return Config::getString('hyde.navigation.subdirectory_display', 'hidden') === 'dropdown';
         }
     }
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index c5763cf2e89..ab6939903ba 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -412,7 +412,7 @@ public function testMainNavigationDropdownLabelsCanBeSetInConfig()
 
     public function testMainNavigationAutomaticSubdirectoryDropdownLabelsCanBeSetInConfig()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
         config(['hyde.navigation.labels' => ['hello' => 'World']]);
 
         $this->assertMenuEquals(['World'], [
@@ -444,7 +444,7 @@ public function testPagesInSubdirectoriesAreNotAddedToNavigation()
 
     public function testPagesInSubdirectoriesAreAddedToNavigationWhenNavigationSubdirectoriesIsSetToFlat()
     {
-        config(['hyde.navigation.subdirectories' => 'flat']);
+        config(['hyde.navigation.subdirectory_display' => 'flat']);
 
         $this->assertMenuEquals(['Foo', 'Bar', 'Baz'], [
             new MarkdownPage('about/foo'),
@@ -455,7 +455,7 @@ public function testPagesInSubdirectoriesAreAddedToNavigationWhenNavigationSubdi
 
     public function testPagesInSubdirectoriesAreAddedAsDropdownsWhenNavigationSubdirectoriesIsSetToDropdown()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $this->assertMenuEquals([
             ['label' => 'About', 'children' => ['Foo', 'Bar', 'Baz']],
@@ -502,7 +502,7 @@ public function testMainNavigationMenuItemsWithSameLabelButDifferentGroupsAreNot
 
     public function testMainNavigationMenuDropdownItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $this->assertMenuEquals([
             ['label' => 'One', 'children' => ['Foo']],
@@ -515,7 +515,7 @@ public function testMainNavigationMenuDropdownItemsWithSameLabelButDifferentGrou
 
     public function testMainNavigationMenuAutomaticDropdownItemsWithSameLabelButDifferentGroupsAreNotFiltered()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $this->assertMenuEquals([
             ['label' => 'One', 'children' => ['Foo']],
@@ -532,7 +532,7 @@ public function testConflictingSubdirectoryAndFrontMatterDropdownConfigurationGi
         // we run into a conflicting state where we don't know what the user intended. We solve this by giving
         // precedence to the subdirectory configuration. This is opinionated, but allows for good grouping.
 
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $this->assertMenuEquals([
             ['label' => 'Foo', 'children' => ['Child']],
@@ -543,7 +543,7 @@ public function testConflictingSubdirectoryAndFrontMatterDropdownConfigurationGi
 
     public function testCanMixSubdirectoryDropdownsWithFrontMatterDropdowns()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $this->assertMenuEquals([
             ['label' => 'Foo', 'children' => ['Bar', 'Baz']],
@@ -555,7 +555,7 @@ public function testCanMixSubdirectoryDropdownsWithFrontMatterDropdowns()
 
     public function testMainMenuAutomaticDropdownLabelsCanBeSetInConfig()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
         config(['hyde.navigation.labels' => ['foo' => 'Bar']]);
 
         $this->assertMenuEquals([
@@ -1110,7 +1110,7 @@ public function testSidebarCanMixSubdirectoryGroupsWithFrontMatterGroups()
 
     public function testMainNavigationDropdownPriorityCanBeSetInConfig()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
         config(['hyde.navigation.order' => ['foo' => 500]]);
 
         $this->assertMenuEquals(
@@ -1121,7 +1121,7 @@ public function testMainNavigationDropdownPriorityCanBeSetInConfig()
 
     public function testMainNavigationDropdownPriorityCanBeSetInConfigUsingDifferingCases()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
         config(['hyde.navigation.order' => ['hello-world' => 500]]);
 
         $expected = [['label' => 'Hello World', 'priority' => 500]];
@@ -1176,7 +1176,7 @@ public function testMainMenuNavigationItemCasingUsingFrontMatter()
 
     public function testMainMenuNavigationGroupCasing()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         // When using subdirectory groupings, we try to format them the same way as the page titles
 
diff --git a/packages/framework/tests/Feature/HydePageTest.php b/packages/framework/tests/Feature/HydePageTest.php
index c6adb02918f..d9ca0150311 100644
--- a/packages/framework/tests/Feature/HydePageTest.php
+++ b/packages/framework/tests/Feature/HydePageTest.php
@@ -1176,7 +1176,7 @@ public function testNavigationDataFactoryHidesPageFromNavigationWhenInASubdirect
 
     public function testNavigationDataFactoryHidesPageFromNavigationWhenInAAndConfigIsSetToHidden()
     {
-        config(['hyde.navigation.subdirectories' => 'hidden']);
+        config(['hyde.navigation.subdirectory_display' => 'hidden']);
 
         $page = MarkdownPage::make('foo/bar');
 
@@ -1186,7 +1186,7 @@ public function testNavigationDataFactoryHidesPageFromNavigationWhenInAAndConfig
 
     public function testNavigationDataFactoryDoesNotHidePageFromNavigationWhenInASubdirectoryAndAllowedInConfiguration()
     {
-        config(['hyde.navigation.subdirectories' => 'flat']);
+        config(['hyde.navigation.subdirectory_display' => 'flat']);
 
         $page = MarkdownPage::make('foo/bar');
 
@@ -1196,7 +1196,7 @@ public function testNavigationDataFactoryDoesNotHidePageFromNavigationWhenInASub
 
     public function testNavigationDataFactoryAllowsShowInNavigationAndSetsGroupWhenDropdownIsSelectedInConfig()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $page = MarkdownPage::make('foo/bar');
 
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 3c6876935c3..cd9d6f72986 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -239,7 +239,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenu()
 
     public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfigFlatSetting()
     {
-        config(['hyde.navigation.subdirectories' => 'flat']);
+        config(['hyde.navigation.subdirectory_display' => 'flat']);
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
@@ -256,7 +256,7 @@ public function testPagesInSubdirectoriesCanBeAddedToTheNavigationMenuWithConfig
 
     public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfigDropdownSetting()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
         $this->directory('_pages/foo');
         $this->file('_pages/foo/bar.md');
 
@@ -275,7 +275,7 @@ public function testPagesInSubdirectoriesAreNotAddedToTheNavigationMenuWithConfi
 
     public function testPagesInDropdownsDoNotGetAddedToTheMainNavigation()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         Routes::push((new MarkdownPage('foo'))->getRoute());
         Routes::push((new MarkdownPage('bar/baz'))->getRoute());
diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index b5b54025ac0..82137389905 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -38,7 +38,7 @@ protected function setUp(): void
 
         $this->helper = new FilenamePrefixNavigationPriorityTestingHelper($this);
 
-        Config::set('hyde.navigation.subdirectories', 'dropdown');
+        Config::set('hyde.navigation.subdirectory_display', 'dropdown');
 
         // Todo: Replace kernel with mock class
         $this->withoutDefaultPages();
diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index eccd5604465..bdbca3f172e 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -248,7 +248,7 @@ public function testMakeGroupUsesFrontMatterGroupIfSet()
 
     public function testMakeGroupUsesFrontMatterGroupIfSetRegardlessOfSubdirectoryConfiguration()
     {
-        self::mockConfig(['hyde.navigation.subdirectories' => 'hidden']);
+        self::mockConfig(['hyde.navigation.subdirectory_display' => 'hidden']);
 
         $frontMatter = new FrontMatter(['navigation.group' => 'Test Group']);
         $coreDataObject = new CoreDataObject($frontMatter, new Markdown(), MarkdownPage::class, 'test.md', '', '', '');
@@ -259,7 +259,7 @@ public function testMakeGroupUsesFrontMatterGroupIfSetRegardlessOfSubdirectoryCo
 
     public function testMakeGroupDefaultsToNullIfFrontMatterGroupNotSetAndSubdirectoriesNotUsed()
     {
-        self::mockConfig(['hyde.navigation.subdirectories' => 'hidden']);
+        self::mockConfig(['hyde.navigation.subdirectory_display' => 'hidden']);
 
         $coreDataObject = new CoreDataObject(new FrontMatter(), new Markdown(), MarkdownPage::class, 'test.md', '', '', '');
         $factory = new NavigationConfigTestClass($coreDataObject);
diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index facec7a3cc6..e8f9f8c1f66 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -23,7 +23,7 @@ protected function setUp(): void
         parent::setUp();
 
         config(['hyde.enable_cache_busting' => false]);
-        config(['hyde.navigation.subdirectories' => 'flat']);
+        config(['hyde.navigation.subdirectory_display' => 'flat']);
 
         $this->needsDirectory('_pages/nested');
         $this->file('_pages/root.md');
diff --git a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
index b34f0d78af2..9935ef20e84 100644
--- a/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationHtmlLayoutsTest.php
@@ -515,7 +515,7 @@ protected function sidebar(array $withPages = []): RenderedDocumentationSidebarM
 
     protected function useSubdirectoryConfig(string $option): static
     {
-        config(['hyde.navigation.subdirectories' => $option]);
+        config(['hyde.navigation.subdirectory_display' => $option]);
 
         return $this;
     }
diff --git a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
index 18d9bfd7cbf..e1aa632ac05 100644
--- a/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationMenuViewTest.php
@@ -78,7 +78,7 @@ public function testNavigationMenuWithRootPages()
 
     public function testNavigationMenuWithDropdownPages()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $page = new MarkdownPage('page');
         $bar = new MarkdownPage('foo/bar');
@@ -104,7 +104,7 @@ public function testNavigationMenuWithDropdownPages()
 
     public function testNavigationMenuWithDropdownPagesWithRootGroupPage()
     {
-        config(['hyde.navigation.subdirectories' => 'dropdown']);
+        config(['hyde.navigation.subdirectory_display' => 'dropdown']);
 
         $foo = new MarkdownPage('foo');
         $bar = new MarkdownPage('foo/bar');

From ba547bdd23fe4d5bff18d5e7a68ff85668c2bef3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:34:17 +0200
Subject: [PATCH 2445/4023] Test the entire component state

---
 .../tests/Unit/Views/NavigationLinkViewTest.php     | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index de571ed18df..877eac0b14c 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -88,4 +88,17 @@ public function testComponentHasActiveClassWhenActive()
             ->assertHasClass('navigation-link')
             ->assertHasClass('navigation-link-active');
     }
+
+    public function testComponentState()
+    {
+        $this->mockCurrentPage('foo');
+
+        $view = $this->testView();
+
+        $expected = <<<'HTML'
+        <a href="foo.html" aria-current="page" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent">Foo</a>
+        HTML;
+
+        $this->assertSame($expected, $view->getRendered());
+    }
 }

From 5d7fb5e12f88fb3cd036196246e29dee040da681 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:22:15 +0200
Subject: [PATCH 2446/4023] Add attributes array to the navigation item class

---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 43d2cf5312b..b8cbf5b81b5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,6 +23,8 @@ class NavigationItem implements Stringable
     protected string $label;
     protected int $priority;
 
+    protected array $attributes = [];
+
     /**
      * Create a new navigation menu item, automatically filling in the properties from a Route instance if provided.
      *

From b07ecf56cd0bbc5b17c6fba68fb5a17454177afa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:22:29 +0200
Subject: [PATCH 2447/4023] Annotate scalar array generics

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index b8cbf5b81b5..6e5d610e010 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -23,6 +23,7 @@ class NavigationItem implements Stringable
     protected string $label;
     protected int $priority;
 
+    /** @var array<string, scalar> */
     protected array $attributes = [];
 
     /**

From 9762449f1deb9ce95192181f25453d9a97a7c91f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:22:49 +0200
Subject: [PATCH 2448/4023] Add attributes accessor

---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 6e5d610e010..bdec0a01a5f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -119,4 +119,9 @@ protected static function make(Route|string $destination, ?string $label = null,
 
         return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
     }
+
+    public function getAttributes(): array
+    {
+        return $this->attributes;
+    }
 }

From 6c5961bd5c9f8468f6bd9c75e21dc78bb5540fad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:23:27 +0200
Subject: [PATCH 2449/4023] Return attributes as component attribute bag

---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index bdec0a01a5f..e70f75fb1a3 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -9,6 +9,7 @@
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Stringable;
+use Illuminate\View\ComponentAttributeBag;
 
 use function is_string;
 
@@ -120,8 +121,8 @@ protected static function make(Route|string $destination, ?string $label = null,
         return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
     }
 
-    public function getAttributes(): array
+    public function getAttributes(): ComponentAttributeBag
     {
-        return $this->attributes;
+        return new ComponentAttributeBag($this->attributes);
     }
 }

From 15b97f9db5e48a9917e72080ada9bce928ae09e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:23:30 +0200
Subject: [PATCH 2450/4023] Revert "Return attributes as component attribute
 bag"

This reverts commit 3a0c2798132f9ae7a581e38ea89369cd9c68f4fe.
---
 .../src/Framework/Features/Navigation/NavigationItem.php     | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index e70f75fb1a3..bdec0a01a5f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -9,7 +9,6 @@
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
 use Stringable;
-use Illuminate\View\ComponentAttributeBag;
 
 use function is_string;
 
@@ -121,8 +120,8 @@ protected static function make(Route|string $destination, ?string $label = null,
         return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
     }
 
-    public function getAttributes(): ComponentAttributeBag
+    public function getAttributes(): array
     {
-        return new ComponentAttributeBag($this->attributes);
+        return $this->attributes;
     }
 }

From 66dc9b29dc789e1d227386412162e6ababb49620 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:23:58 +0200
Subject: [PATCH 2451/4023] Rename accessor to signify it's for extra
 attributes

Inspired by Filament
---
 .../src/Framework/Features/Navigation/NavigationItem.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index bdec0a01a5f..1254ce72a53 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -120,7 +120,7 @@ protected static function make(Route|string $destination, ?string $label = null,
         return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
     }
 
-    public function getAttributes(): array
+    public function getExtraAttributes(): array
     {
         return $this->attributes;
     }

From caae63617e14ad6ef875d16ecb9851b7cd503dda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:24:47 +0200
Subject: [PATCH 2452/4023] Annotate the scalar return array

---
 .../src/Framework/Features/Navigation/NavigationItem.php         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 1254ce72a53..418f029f7c6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -120,6 +120,7 @@ protected static function make(Route|string $destination, ?string $label = null,
         return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
     }
 
+    /** @return array<string, scalar> */
     public function getExtraAttributes(): array
     {
         return $this->attributes;

From 283016f0b68a39c270eaaa68bf776ffc252f0523 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:25:38 +0200
Subject: [PATCH 2453/4023] Merge in the extra attributes

---
 .../views/components/navigation/navigation-link.blade.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index 60ce617081d..f5fc6d7de60 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -3,4 +3,4 @@
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
 ])->merge([
     'aria-current' => $item->isActive() ? 'page' : false,
-]) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
+])->merge($item->getExtraAttributes()) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file

From 93cef20ee21ea8447cf1731c140b78a707b1fff6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:37:22 +0200
Subject: [PATCH 2454/4023] Change merge order to preserve output format

May want to revert this later as it makes sense for user added data to be last, but this preserves the current attribute order for now
---
 .../views/components/navigation/navigation-link.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index f5fc6d7de60..5d2725b22e2 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,6 +1,6 @@
 <a href="{{ $item }}" {{ $attributes->except('item')->class([
     'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
-])->merge([
+])->merge($item->getExtraAttributes())->merge([
     'aria-current' => $item->isActive() ? 'page' : false,
-])->merge($item->getExtraAttributes()) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
+]) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file

From 395dbfb849cc00ac29466300ad8f8ced9f0c5cd2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:39:44 +0200
Subject: [PATCH 2455/4023] Merge in extra attributes last in component

This reverts commit 93cef20ee21ea8447cf1731c140b78a707b1fff6.
---
 .../views/components/navigation/navigation-link.blade.php     | 4 ++--
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php     | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index 5d2725b22e2..f5fc6d7de60 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,6 +1,6 @@
 <a href="{{ $item }}" {{ $attributes->except('item')->class([
     'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
-])->merge($item->getExtraAttributes())->merge([
+])->merge([
     'aria-current' => $item->isActive() ? 'page' : false,
-]) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
+])->merge($item->getExtraAttributes()) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 877eac0b14c..7f512e5c769 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -96,7 +96,7 @@ public function testComponentState()
         $view = $this->testView();
 
         $expected = <<<'HTML'
-        <a href="foo.html" aria-current="page" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent">Foo</a>
+        <a href="foo.html" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent" aria-current="page">Foo</a>
         HTML;
 
         $this->assertSame($expected, $view->getRendered());

From b558720c6c37e424c8f8cd8ba03f19182abd2992 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:45:24 +0200
Subject: [PATCH 2456/4023] Update
 RelativeLinksAcrossPagesRetainsIntegrityTest.php

---
 .../Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index e8f9f8c1f66..30267866c34 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -73,10 +73,11 @@ public function testRelativeLinksAcrossPagesRetainsIntegrity()
             '<link rel="stylesheet" href="media/app.css">',
             '<a href="index.html"',
             '<a href="docs/index.html"',
-            '<a href="root.html" aria-current="page"',
+            '<a href="root.html"',
             '<a href="root1.html"',
             '<a href="nested/level1.html"',
             '<a href="nested/level1b.html"',
+            'aria-current="page"',
         ]);
 
         $this->assertSee('nested/level1', [
@@ -85,8 +86,9 @@ public function testRelativeLinksAcrossPagesRetainsIntegrity()
             '<a href="../docs/index.html"',
             '<a href="../root.html"',
             '<a href="../root1.html"',
-            '<a href="../nested/level1.html" aria-current="page"',
+            '<a href="../nested/level1.html"',
             '<a href="../nested/level1b.html"',
+            'aria-current="page"'
         ]);
 
         $this->assertSee('docs/index', [

From 9c60087503f8811d80afc4f9305de8685c53d890 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:47:28 +0200
Subject: [PATCH 2457/4023] Revert "Update
 RelativeLinksAcrossPagesRetainsIntegrityTest.php"

This reverts commit b558720c6c37e424c8f8cd8ba03f19182abd2992.
---
 .../Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php   | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index 30267866c34..e8f9f8c1f66 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -73,11 +73,10 @@ public function testRelativeLinksAcrossPagesRetainsIntegrity()
             '<link rel="stylesheet" href="media/app.css">',
             '<a href="index.html"',
             '<a href="docs/index.html"',
-            '<a href="root.html"',
+            '<a href="root.html" aria-current="page"',
             '<a href="root1.html"',
             '<a href="nested/level1.html"',
             '<a href="nested/level1b.html"',
-            'aria-current="page"',
         ]);
 
         $this->assertSee('nested/level1', [
@@ -86,9 +85,8 @@ public function testRelativeLinksAcrossPagesRetainsIntegrity()
             '<a href="../docs/index.html"',
             '<a href="../root.html"',
             '<a href="../root1.html"',
-            '<a href="../nested/level1.html"',
+            '<a href="../nested/level1.html" aria-current="page"',
             '<a href="../nested/level1b.html"',
-            'aria-current="page"'
         ]);
 
         $this->assertSee('docs/index', [

From c087bbf46548ae8b83da6739f83480ba1ed6820e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 18:47:31 +0200
Subject: [PATCH 2458/4023] Revert "Merge in extra attributes last in
 component"

This reverts commit 395dbfb849cc00ac29466300ad8f8ced9f0c5cd2.
---
 .../views/components/navigation/navigation-link.blade.php     | 4 ++--
 .../framework/tests/Unit/Views/NavigationLinkViewTest.php     | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/navigation/navigation-link.blade.php b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
index f5fc6d7de60..5d2725b22e2 100644
--- a/packages/framework/resources/views/components/navigation/navigation-link.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-link.blade.php
@@ -1,6 +1,6 @@
 <a href="{{ $item }}" {{ $attributes->except('item')->class([
     'navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100',
     'navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent' => $item->isActive()
-])->merge([
+])->merge($item->getExtraAttributes())->merge([
     'aria-current' => $item->isActive() ? 'page' : false,
-])->merge($item->getExtraAttributes()) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
+]) }}>{{ $item->getLabel() }}</a>
\ No newline at end of file
diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 7f512e5c769..877eac0b14c 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -96,7 +96,7 @@ public function testComponentState()
         $view = $this->testView();
 
         $expected = <<<'HTML'
-        <a href="foo.html" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent" aria-current="page">Foo</a>
+        <a href="foo.html" aria-current="page" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent">Foo</a>
         HTML;
 
         $this->assertSame($expected, $view->getRendered());

From 33e40d82bf8a34f5b9e33ebfcce1825fd510b853 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:17:33 +0200
Subject: [PATCH 2459/4023] Update navigation item facade to support the
 attribute parameter

---
 packages/framework/src/Facades/Navigation.php                | 5 +++--
 .../framework/tests/Feature/YamlConfigurationFeatureTest.php | 4 ++++
 .../framework/tests/Unit/Facades/NavigationFacadeTest.php    | 3 +++
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index a91b41fef5a..e7d12646e06 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -21,9 +21,10 @@ class Navigation
      * @param  string<\Hyde\Support\Models\RouteKey>|string  $destination  Route key, or an external URI.
      * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
      * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
      */
-    public static function item(string $destination, ?string $label = null, ?int $priority = null): array
+    public static function item(string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): array
     {
-        return compact('destination', 'label', 'priority');
+        return compact('destination', 'label', 'priority', 'attributes');
     }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 71c1d5c8d24..6f3f32db097 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -497,14 +497,17 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
                 'destination' => 'https://example.com',
                 'label' => 'Example',
                 'priority' => 100,
+                'attributes' => [],
             ], [
                 'destination' => 'about',
                 'label' => 'About Us',
                 'priority' => 200,
+                'attributes' => [],
             ], [
                 'destination' => 'contact',
                 'label' => 'Contact',
                 'priority' => 300,
+                'attributes' => [],
             ],
         ], $configItems);
 
@@ -549,6 +552,7 @@ public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
                 'destination' => 'about.html',
                 'label' => null,
                 'priority' => null,
+                'attributes' => [],
             ],
         ], $configItems);
 
diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index bbc7e2d84f0..a4b68d9f7c4 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -20,6 +20,7 @@ public function testItem()
             'destination' => 'home',
             'label' => 'Home',
             'priority' => 100,
+            'attributes' => [],
         ], $item);
     }
 
@@ -31,6 +32,7 @@ public function testItemWithOnlyDestination()
             'destination' => 'home',
             'label' => null,
             'priority' => null,
+            'attributes' => [],
         ], $item);
     }
 
@@ -42,6 +44,7 @@ public function testItemWithUrl()
             'destination' => 'https://example.com',
             'label' => 'External',
             'priority' => 200,
+            'attributes' => [],
         ], $item);
     }
 }

From 1beec7e8f343d5cb43785c40fb8df1693a3ad65b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:28:17 +0200
Subject: [PATCH 2460/4023] Update the make method to support extra attributes

---
 .../src/Framework/Features/Navigation/NavigationItem.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 418f029f7c6..d0f1c7c8868 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -103,8 +103,8 @@ public function isActive(): bool
         return Hyde::currentRoute()?->getLink() === $this->getLink();
     }
 
-    /** @return array{\Hyde\Support\Models\Route|string, string, int} */
-    protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null): array
+    /** @return array{\Hyde\Support\Models\Route|string, string, int, array<string, scalar>} */
+    protected static function make(Route|string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): array
     {
         // Automatically resolve the destination if it's a route key.
         if (is_string($destination) && Routes::has($destination)) {
@@ -117,7 +117,7 @@ protected static function make(Route|string $destination, ?string $label = null,
             $priority ??= $destination->getPage()->navigationMenuPriority();
         }
 
-        return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT];
+        return [$destination, $label ?? $destination, $priority ?? NavigationMenu::DEFAULT, $attributes];
     }
 
     /** @return array<string, scalar> */

From 8080709c578dce1ad7bd4df14500e934fb6b1908 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:30:01 +0200
Subject: [PATCH 2461/4023] Update the constructors to support extra attributes

---
 .../Framework/Features/Navigation/NavigationItem.php | 10 ++++++----
 packages/framework/tests/Unit/NavigationItemTest.php | 12 ++++++++++++
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index d0f1c7c8868..a7fa7bb252c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -32,10 +32,11 @@ class NavigationItem implements Stringable
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or an external URI.
      * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
      * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
      */
-    public function __construct(Route|string $destination, ?string $label = null, ?int $priority = null)
+    public function __construct(Route|string $destination, ?string $label = null, ?int $priority = null, array $attributes = [])
     {
-        [$this->destination, $this->label, $this->priority] = self::make($destination, $label, $priority);
+        [$this->destination, $this->label, $this->priority, $this->attributes] = self::make($destination, $label, $priority, $attributes);
     }
 
     /**
@@ -44,10 +45,11 @@ public function __construct(Route|string $destination, ?string $label = null, ?i
      * @param  \Hyde\Support\Models\Route|string<\Hyde\Support\Models\RouteKey>|string  $destination  Route instance or route key, or an external URI.
      * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
      * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
      */
-    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null): static
+    public static function create(Route|string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): static
     {
-        return new static(...self::make($destination, $label, $priority));
+        return new static(...self::make($destination, $label, $priority, $attributes));
     }
 
     /**
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index e0a669adf9a..22742802644 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -325,4 +325,16 @@ public function testIsCurrentIsNullSafe()
     {
         $this->assertFalse(NavigationItem::create('foo', 'bar')->isActive());
     }
+
+    public function testConstructWithAttributes()
+    {
+        $item = new NavigationItem('foo', 'Test', 500, ['class' => 'active']);
+        $this->assertSame(['class' => 'active'], $item->getExtraAttributes());
+    }
+
+    public function testCreateWithAttributes()
+    {
+        $item = NavigationItem::create('foo', 'Test', 500, ['class' => 'active']);
+        $this->assertSame(['class' => 'active'], $item->getExtraAttributes());
+    }
 }

From 8b6d678ef44ea969855a1c87680d37bae5ddf30f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:31:39 +0200
Subject: [PATCH 2462/4023] Generate attribute accessors

---
 .../Features/Navigation/NavigationItem.php    | 47 +++++++++++++++++++
 .../tests/Unit/NavigationItemTest.php         | 29 ++++++++++++
 2 files changed, 76 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index a7fa7bb252c..9b6a498ab59 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -127,4 +127,51 @@ public function getExtraAttributes(): array
     {
         return $this->attributes;
     }
+
+    /**
+     * Set an extra attribute for the navigation item.
+     *
+     * @param string $key
+     * @param scalar $value
+     * @return $this
+     */
+    public function setAttribute(string $key, $value): self
+    {
+        $this->attributes[$key] = $value;
+        return $this;
+    }
+
+    /**
+     * Set multiple extra attributes for the navigation item.
+     *
+     * @param array<string, scalar> $attributes
+     * @return $this
+     */
+    public function setAttributes(array $attributes): self
+    {
+        $this->attributes = array_merge($this->attributes, $attributes);
+        return $this;
+    }
+
+    /**
+     * Get an extra attribute of the navigation item.
+     *
+     * @param string $key
+     * @param scalar|null $default
+     * @return scalar|null
+     */
+    public function getAttribute(string $key, $default = null)
+    {
+        return $this->attributes[$key] ?? $default;
+    }
+
+    /**
+     * Get all extra attributes of the navigation item.
+     *
+     * @return array<string, scalar>
+     */
+    public function getAttributes(): array
+    {
+        return $this->attributes;
+    }
 }
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 22742802644..f27269745d2 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -337,4 +337,33 @@ public function testCreateWithAttributes()
         $item = NavigationItem::create('foo', 'Test', 500, ['class' => 'active']);
         $this->assertSame(['class' => 'active'], $item->getExtraAttributes());
     }
+
+    public function testSetAttribute()
+    {
+        $item = new NavigationItem('foo', 'Test');
+        $item->setAttribute('class', 'active');
+        $this->assertSame('active', $item->getAttribute('class'));
+    }
+
+    public function testSetAttributes()
+    {
+        $item = new NavigationItem('foo', 'Test');
+        $item->setAttributes(['class' => 'active', 'id' => 'nav-item']);
+        $this->assertSame(['class' => 'active', 'id' => 'nav-item'], $item->getAttributes());
+    }
+
+    public function testGetAttribute()
+    {
+        $item = new NavigationItem('foo', 'Test', 500, ['class' => 'active']);
+        $this->assertSame('active', $item->getAttribute('class'));
+        $this->assertNull($item->getAttribute('id'));
+        $this->assertSame('default', $item->getAttribute('id', 'default'));
+    }
+
+    public function testGetAttributes()
+    {
+        $attributes = ['class' => 'active', 'id' => 'nav-item'];
+        $item = new NavigationItem('foo', 'Test', 500, $attributes);
+        $this->assertSame($attributes, $item->getAttributes());
+    }
 }

From 17a33e0c56801879e30194d71b9db5e814c9c1ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:31:42 +0200
Subject: [PATCH 2463/4023] Revert "Generate attribute accessors"

This reverts commit 8b6d678ef44ea969855a1c87680d37bae5ddf30f.
---
 .../Features/Navigation/NavigationItem.php    | 47 -------------------
 .../tests/Unit/NavigationItemTest.php         | 29 ------------
 2 files changed, 76 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
index 9b6a498ab59..a7fa7bb252c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationItem.php
@@ -127,51 +127,4 @@ public function getExtraAttributes(): array
     {
         return $this->attributes;
     }
-
-    /**
-     * Set an extra attribute for the navigation item.
-     *
-     * @param string $key
-     * @param scalar $value
-     * @return $this
-     */
-    public function setAttribute(string $key, $value): self
-    {
-        $this->attributes[$key] = $value;
-        return $this;
-    }
-
-    /**
-     * Set multiple extra attributes for the navigation item.
-     *
-     * @param array<string, scalar> $attributes
-     * @return $this
-     */
-    public function setAttributes(array $attributes): self
-    {
-        $this->attributes = array_merge($this->attributes, $attributes);
-        return $this;
-    }
-
-    /**
-     * Get an extra attribute of the navigation item.
-     *
-     * @param string $key
-     * @param scalar|null $default
-     * @return scalar|null
-     */
-    public function getAttribute(string $key, $default = null)
-    {
-        return $this->attributes[$key] ?? $default;
-    }
-
-    /**
-     * Get all extra attributes of the navigation item.
-     *
-     * @return array<string, scalar>
-     */
-    public function getAttributes(): array
-    {
-        return $this->attributes;
-    }
 }
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index f27269745d2..22742802644 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -337,33 +337,4 @@ public function testCreateWithAttributes()
         $item = NavigationItem::create('foo', 'Test', 500, ['class' => 'active']);
         $this->assertSame(['class' => 'active'], $item->getExtraAttributes());
     }
-
-    public function testSetAttribute()
-    {
-        $item = new NavigationItem('foo', 'Test');
-        $item->setAttribute('class', 'active');
-        $this->assertSame('active', $item->getAttribute('class'));
-    }
-
-    public function testSetAttributes()
-    {
-        $item = new NavigationItem('foo', 'Test');
-        $item->setAttributes(['class' => 'active', 'id' => 'nav-item']);
-        $this->assertSame(['class' => 'active', 'id' => 'nav-item'], $item->getAttributes());
-    }
-
-    public function testGetAttribute()
-    {
-        $item = new NavigationItem('foo', 'Test', 500, ['class' => 'active']);
-        $this->assertSame('active', $item->getAttribute('class'));
-        $this->assertNull($item->getAttribute('id'));
-        $this->assertSame('default', $item->getAttribute('id', 'default'));
-    }
-
-    public function testGetAttributes()
-    {
-        $attributes = ['class' => 'active', 'id' => 'nav-item'];
-        $item = new NavigationItem('foo', 'Test', 500, $attributes);
-        $this->assertSame($attributes, $item->getAttributes());
-    }
 }

From 3f7c34b178a7535106d32db65468052522289ddd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:38:00 +0200
Subject: [PATCH 2464/4023] Test the view with extra attributes

Claude is just insanely good
---
 .../Unit/Views/NavigationLinkViewTest.php     | 53 ++++++++++++++++++-
 1 file changed, 51 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
index 877eac0b14c..274a71420e0 100644
--- a/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
+++ b/packages/framework/tests/Unit/Views/NavigationLinkViewTest.php
@@ -26,10 +26,10 @@ protected function setUp(): void
         $this->mockPage();
     }
 
-    protected function testView(): TestView
+    protected function testView(array $extraAttributes = []): TestView
     {
         return $this->view(view('hyde::components.navigation.navigation-link', [
-            'item' => NavigationItem::create(new Route(new InMemoryPage('foo')), 'Foo'),
+            'item' => NavigationItem::create(new Route(new InMemoryPage('foo')), 'Foo', null, $extraAttributes),
             'attributes' => new ComponentAttributeBag(),
         ]));
     }
@@ -89,6 +89,55 @@ public function testComponentHasActiveClassWhenActive()
             ->assertHasClass('navigation-link-active');
     }
 
+    public function testComponentRendersExtraAttributes()
+    {
+        $this->testView(['data-test' => 'value'])
+            ->assertHasAttribute('data-test')
+            ->assertAttributeIs('data-test="value"');
+    }
+
+    public function testComponentRendersMultipleExtraAttributes()
+    {
+        $this->testView(['data-test' => 'value', 'data-foo' => 'bar'])
+            ->assertHasAttribute('data-test')
+            ->assertAttributeIs('data-test="value"')
+            ->assertHasAttribute('data-foo')
+            ->assertAttributeIs('data-foo="bar"');
+    }
+
+    public function testComponentRendersExtraAttributesWithExistingAttributes()
+    {
+        $this->mockCurrentPage('foo');
+
+        $view = $this->testView(['data-test' => 'value']);
+
+        $expected = <<<'HTML'
+        <a href="foo.html" aria-current="page" class="navigation-link block my-2 md:my-0 md:inline-block py-1 text-gray-700 hover:text-gray-900 dark:text-gray-100 navigation-link-active border-l-4 border-indigo-500 md:border-none font-medium -ml-6 pl-5 md:ml-0 md:pl-0 bg-gray-100 dark:bg-gray-800 md:bg-transparent dark:md:bg-transparent" data-test="value">Foo</a>
+        HTML;
+
+        $this->assertSame($expected, $view->getRendered());
+    }
+
+    public function testComponentMergesClassAttributeCorrectly()
+    {
+        $this->testView(['class' => 'custom-class'])
+            ->assertHasClass('navigation-link')
+            ->assertHasClass('custom-class');
+    }
+
+    public function testComponentOverridesDefaultAttributesWithExtraAttributes()
+    {
+        $this->testView(['href' => 'https://example.com'])
+            ->assertAttributeIs('href="https://example.com"');
+    }
+
+    public function testComponentHandlesEmptyExtraAttributes()
+    {
+        $this->testView([])
+            ->assertHasElement('<a>')
+            ->assertTextIs('Foo');
+    }
+
     public function testComponentState()
     {
         $this->mockCurrentPage('foo');

From 798d363f2b50409012da280af280a1da036054aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:40:26 +0200
Subject: [PATCH 2465/4023] Annotate the return array shape

---
 packages/framework/src/Facades/Navigation.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index e7d12646e06..b2dda93d6c7 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -22,6 +22,7 @@ class Navigation
      * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
      * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
      * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
+     * @return array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}
      */
     public static function item(string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): array
     {

From ed615a7c9bef361973d8e42c6e4b99bfa6adba8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:41:07 +0200
Subject: [PATCH 2466/4023] Update YAML parser array shapes

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 0ac92ab01d0..8a8f2afe540 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -86,8 +86,8 @@ protected function parseAuthors(array $authors): array
     /**
      * @experimental Since the main configuration also uses arrays, the only thing this method really does is to rethrow any exceptions.
      *
-     * @param  array<array{destination: string, label: ?string, priority: ?int}>  $items  Where destination is a route key or an external URI.
-     * @return array<array{destination: string, label: ?string, priority: ?int}>
+     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $items  Where destination is a route key or an external URI.
+     * @return array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>
      */
     protected function parseNavigationItems(array $items): array
     {

From 57317389474b6d5115c3d9726886bd4bedf96aa4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:44:21 +0200
Subject: [PATCH 2467/4023] Support setting navigation items with extra
 attributes in the config

---
 .../Navigation/NavigationMenuGenerator.php    |  2 +-
 .../tests/Feature/NavigationMenuTest.php      | 15 +++++
 .../Feature/YamlConfigurationFeatureTest.php  | 61 +++++++++++++++++++
 3 files changed, 77 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index eae219d2f53..54ed54cbf26 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -83,7 +83,7 @@ protected function generate(): void
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
                 // Since these were added explicitly by the user, we can assume they should always be shown
-                $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null));
+                $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null, $item['attributes'] ?? []));
             });
         }
     }
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index cd9d6f72986..b07e62e13de 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -152,6 +152,21 @@ public function testPathLinkCanBeAddedInConfig()
         $this->assertEquals($expected, $menu->getItems());
     }
 
+    public function testCanAddCustomLinksInConfigWithExtraAttributes()
+    {
+        config(['hyde.navigation.custom' => [Navigation::item('foo', 'Foo', 100, ['class' => 'foo'])]]);
+
+        $menu = $this->createNavigationMenu();
+
+        $expected = collect([
+            NavigationItem::create(Routes::get('index')),
+            NavigationItem::create('foo', 'Foo', 100, ['class' => 'foo']),
+        ]);
+
+        $this->assertCount(count($expected), $menu->getItems());
+        $this->assertEquals($expected, $menu->getItems());
+    }
+
     public function testDuplicatesAreNotRemovedWhenAddingInConfig()
     {
         config(['hyde.navigation.custom' => [
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 6f3f32db097..7531bf44f94 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -534,6 +534,67 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
         $this->assertSame(300, $navigationItems[3]->getPriority());
     }
 
+    public function testCanSetAttributesInNavigationItemsInTheYamlConfig()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          navigation:
+            custom:
+              - destination: 'https://example.com'
+                label: 'Example'
+                priority: 100
+                attributes:
+                  class: 'example'
+              - destination: 'about'
+                label: 'About Us'
+                priority: 200
+                attributes:
+                  class: 'about'
+                  id: 'about'
+              - destination: 'contact'
+                label: 'Contact'
+                priority: 300
+                attributes:
+                   target: '_blank'
+                   rel: 'noopener noreferrer'
+                   foo: 'bar'
+        YAML);
+
+        $this->runBootstrappers();
+
+        $configItems = config('hyde.navigation.custom');
+
+        $this->assertSame([
+            [
+                'destination' => 'https://example.com',
+                'label' => 'Example',
+                'priority' => 100,
+                'attributes' => ['class' => 'example'],
+            ], [
+                'destination' => 'about',
+                'label' => 'About Us',
+                'priority' => 200,
+                'attributes' => ['class' => 'about', 'id' => 'about'],
+            ], [
+                'destination' => 'contact',
+                'label' => 'Contact',
+                'priority' => 300,
+                'attributes' => ['target' => '_blank', 'rel' => 'noopener noreferrer', 'foo' => 'bar'],
+            ],
+        ], $configItems);
+
+        /** @var NavigationItem[] $navigationItems */
+        $navigationItems = NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
+
+        $this->assertCount(4, $navigationItems);
+        $this->assertContainsOnlyInstancesOf(NavigationItem::class, $navigationItems);
+
+        $this->assertSame([], $navigationItems[0]->getExtraAttributes());
+        $this->assertSame(['class' => 'example'], $navigationItems[1]->getExtraAttributes());
+        $this->assertSame(['class' => 'about', 'id' => 'about'], $navigationItems[2]->getExtraAttributes());
+        $this->assertSame(['target' => '_blank', 'rel' => 'noopener noreferrer', 'foo' => 'bar'], $navigationItems[3]->getExtraAttributes());
+    }
+
     public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
     {
         $this->file('hyde.yml', <<<'YAML'

From 09db9f10e91834ddf8789d2483dd789d1b47682c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:48:24 +0200
Subject: [PATCH 2468/4023] Annotate the parameter array shape

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php  | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 54ed54cbf26..ddbe9679dd5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -81,7 +81,8 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(
+                /** @param array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */ function (array $item): void {
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null, $item['attributes'] ?? []));
             });

From c8a72a87c30ba7795cddca6f347142a901e7dff2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:49:24 +0200
Subject: [PATCH 2469/4023] Use variable annotation for cleaner looking code

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index ddbe9679dd5..b4e55a60706 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -81,8 +81,8 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(
-                /** @param array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */ function (array $item): void {
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
+                /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null, $item['attributes'] ?? []));
             });

From c6cdbab07e533afd23220133554fe281da96fc18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:53:32 +0200
Subject: [PATCH 2470/4023] Test invalid custom navigation configuration throws
 exception

---
 .../framework/tests/Feature/NavigationMenuTest.php   | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index b07e62e13de..7696bb6eb10 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -223,6 +223,18 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
         $this->assertEquals($expected, $menu->getItems());
     }
 
+    public function testInvalidCustomNavigationConfigurationThrowsException()
+    {
+        $this->expectException(\Error::class);
+        // $this->expectExceptionMessage('Invalid configuration for custom navigation item');
+
+        config(['hyde.navigation.custom' => [
+            ['invalid_key' => 'value'],
+        ]]);
+
+        $this->createNavigationMenu();
+    }
+
     public function testDocumentationPagesThatAreNotIndexAreNotAddedToTheMenu()
     {
         $this->file('_docs/foo.md');

From b0bbfa7a8c4aee68bbbf615b00ad1cfa07936f30 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:53:38 +0200
Subject: [PATCH 2471/4023] Unpack the array directly

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b4e55a60706..2a9d54c701e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -84,7 +84,7 @@ protected function generate(): void
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
                 /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */
                 // Since these were added explicitly by the user, we can assume they should always be shown
-                $this->items->push(NavigationItem::create($item['destination'], $item['label'] ?? null, $item['priority'] ?? null, $item['attributes'] ?? []));
+                $this->items->push(NavigationItem::create(...$item));
             });
         }
     }

From 87bb7efc8d7f36cf22b57a8231fa41f78939007b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:58:27 +0200
Subject: [PATCH 2472/4023] Introduce local variable

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 2a9d54c701e..b7d2781d908 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -83,8 +83,10 @@ protected function generate(): void
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
                 /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */
+                $item = NavigationItem::create(...$item);
+             
                 // Since these were added explicitly by the user, we can assume they should always be shown
-                $this->items->push(NavigationItem::create(...$item));
+                $this->items->push($item);
             });
         }
     }

From ca28299a2d595ac72b442f92a74fe7dc662990f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 20:59:17 +0200
Subject: [PATCH 2473/4023] Catch and rethrow error caused by bad configuration

---
 .../Features/Navigation/NavigationMenuGenerator.php | 13 +++++++++++--
 .../framework/tests/Feature/NavigationMenuTest.php  |  5 +++--
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b7d2781d908..8bcbb2c2f14 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -5,12 +5,14 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Hyde;
+use Throwable;
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 
 use function filled;
 use function assert;
@@ -83,8 +85,15 @@ protected function generate(): void
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
                 /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */
-                $item = NavigationItem::create(...$item);
-             
+                try {
+                    $item = NavigationItem::create(...$item);
+                } catch (Throwable $exception) {
+                    throw new InvalidConfigurationException(
+                        'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',
+                        previous: $exception
+                    );
+                }
+
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);
             });
diff --git a/packages/framework/tests/Feature/NavigationMenuTest.php b/packages/framework/tests/Feature/NavigationMenuTest.php
index 7696bb6eb10..0b48b00c05d 100644
--- a/packages/framework/tests/Feature/NavigationMenuTest.php
+++ b/packages/framework/tests/Feature/NavigationMenuTest.php
@@ -14,6 +14,7 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Collection;
+use Hyde\Framework\Exceptions\InvalidConfigurationException;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
@@ -225,8 +226,8 @@ public function testConfigItemsTakePrecedenceOverGeneratedItems()
 
     public function testInvalidCustomNavigationConfigurationThrowsException()
     {
-        $this->expectException(\Error::class);
-        // $this->expectExceptionMessage('Invalid configuration for custom navigation item');
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Invalid navigation item configuration detected the configuration file. Please double check the syntax.');
 
         config(['hyde.navigation.custom' => [
             ['invalid_key' => 'value'],

From 3f2878ae4480b619f5563fd8a0d80b8e43ecc285 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:00:18 +0200
Subject: [PATCH 2474/4023] Normalize to more generic error message

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php       | 2 +-
 .../tests/Feature/YamlConfigurationFeatureTest.php          | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 8a8f2afe540..126e8296b12 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -96,7 +96,7 @@ protected function parseNavigationItems(array $items): array
                 return Navigation::item(...$item);
             } catch (Throwable $exception) {
                 throw new InvalidConfigurationException(
-                    'Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.',
+                    'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',
                     previous: $exception
                 );
             }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 7531bf44f94..266e0804866 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -670,7 +670,7 @@ public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
-            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+            $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
         unlink('hyde.yml');
@@ -688,7 +688,7 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
-            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+            $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
         unlink('hyde.yml');
@@ -707,7 +707,7 @@ public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
-            $this->assertSame('Invalid navigation item configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
+            $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
         unlink('hyde.yml');

From 5ed108226e1149d85d2987e0c00235b453cddf2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:03:32 +0200
Subject: [PATCH 2475/4023] Add helpers to assert exception was thrown

---
 .../Feature/YamlConfigurationFeatureTest.php     | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 266e0804866..1e6245f2170 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -456,6 +456,8 @@ public function testCanSetAuthorsInTheYamlConfig()
 
     public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
     {
+        $exceptionThrown = false;
+
         file_put_contents('hyde.yml', <<<'YAML'
         authors:
           wrong:
@@ -465,9 +467,11 @@ public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
+            $exceptionThrown = true;
             $this->assertSame('Invalid author configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
         }
 
+        $this->assertTrue($exceptionThrown);
         unlink('hyde.yml');
     }
 
@@ -660,6 +664,8 @@ public function testNavigationItemsInTheYamlConfigCanBeResolvedToRoutes()
 
     public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
     {
+        $exceptionThrown = false;
+
         file_put_contents('hyde.yml', <<<'YAML'
         hyde:
           navigation:
@@ -670,14 +676,18 @@ public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
+            $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
+        $this->assertTrue($exceptionThrown);
         unlink('hyde.yml');
     }
 
     public function testMustAddDestinationToYamlConfiguredNavigationItems()
     {
+        $exceptionThrown = false;
+
         file_put_contents('hyde.yml', <<<'YAML'
         hyde:
           navigation:
@@ -688,14 +698,18 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
+            $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
+        $this->assertTrue($exceptionThrown);
         unlink('hyde.yml');
     }
 
     public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
     {
+        $exceptionThrown = false;
+
         file_put_contents('hyde.yml', <<<'YAML'
         hyde:
           navigation:
@@ -707,9 +721,11 @@ public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
         try {
             $this->runBootstrappers();
         } catch (InvalidConfigurationException $exception) {
+            $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
+        $this->assertTrue($exceptionThrown);
         unlink('hyde.yml');
     }
 

From 138e4b9c92453c3405327359e88f8ad7a8906d82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:03:45 +0200
Subject: [PATCH 2476/4023] Add message to custom assertion

---
 .../tests/Feature/YamlConfigurationFeatureTest.php        | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 1e6245f2170..b9f6a3fc8fe 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -471,7 +471,7 @@ public function testTypeErrorsInAuthorsYamlConfigAreRethrownMoreHelpfully()
             $this->assertSame('Invalid author configuration detected in the YAML config file. Please double check the syntax.', $exception->getMessage());
         }
 
-        $this->assertTrue($exceptionThrown);
+        $this->assertTrue($exceptionThrown, 'Failed asserting that the exception was thrown.');
         unlink('hyde.yml');
     }
 
@@ -680,7 +680,7 @@ public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
-        $this->assertTrue($exceptionThrown);
+        $this->assertTrue($exceptionThrown, 'Failed asserting that the exception was thrown.');
         unlink('hyde.yml');
     }
 
@@ -702,7 +702,7 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
-        $this->assertTrue($exceptionThrown);
+        $this->assertTrue($exceptionThrown, 'Failed asserting that the exception was thrown.');
         unlink('hyde.yml');
     }
 
@@ -725,7 +725,7 @@ public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
         }
 
-        $this->assertTrue($exceptionThrown);
+        $this->assertTrue($exceptionThrown, 'Failed asserting that the exception was thrown.');
         unlink('hyde.yml');
     }
 

From 6a076b831b3cf07341605c314f0c29bfa4c0a8da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:07:04 +0200
Subject: [PATCH 2477/4023] Let the generator parse navigation items instead of
 the loader

We "lose" out on the null defaults, but they don't offer any value anyways.
---
 .../Internal/LoadYamlConfiguration.php        | 25 -------------------
 .../Feature/YamlConfigurationFeatureTest.php  |  9 +++----
 2 files changed, 3 insertions(+), 31 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 126e8296b12..1f1dc4963e3 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -6,7 +6,6 @@
 
 use Throwable;
 use Illuminate\Support\Arr;
-use Hyde\Facades\Navigation;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
@@ -52,10 +51,6 @@ protected function mergeParsedConfiguration(): void
                 $data['authors'] = $this->parseAuthors($data['authors']);
             }
 
-            if ($namespace === 'hyde' && isset($data['navigation']['custom'])) {
-                $data['navigation']['custom'] = $this->parseNavigationItems($data['navigation']['custom']);
-            }
-
             $this->mergeConfiguration($namespace, Arr::undot($data ?: []));
         }
     }
@@ -82,24 +77,4 @@ protected function parseAuthors(array $authors): array
             }
         });
     }
-
-    /**
-     * @experimental Since the main configuration also uses arrays, the only thing this method really does is to rethrow any exceptions.
-     *
-     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $items  Where destination is a route key or an external URI.
-     * @return array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>
-     */
-    protected function parseNavigationItems(array $items): array
-    {
-        return Arr::map($items, function (array $item): array {
-            try {
-                return Navigation::item(...$item);
-            } catch (Throwable $exception) {
-                throw new InvalidConfigurationException(
-                    'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',
-                    previous: $exception
-                );
-            }
-        });
-    }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index b9f6a3fc8fe..4bd0a733680 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -501,17 +501,14 @@ public function testCanSetCustomNavigationItemsInTheYamlConfig()
                 'destination' => 'https://example.com',
                 'label' => 'Example',
                 'priority' => 100,
-                'attributes' => [],
             ], [
                 'destination' => 'about',
                 'label' => 'About Us',
                 'priority' => 200,
-                'attributes' => [],
             ], [
                 'destination' => 'contact',
                 'label' => 'Contact',
                 'priority' => 300,
-                'attributes' => [],
             ],
         ], $configItems);
 
@@ -615,9 +612,6 @@ public function testOnlyNeedToAddDestinationToYamlConfiguredNavigationItems()
         $this->assertSame([
             [
                 'destination' => 'about.html',
-                'label' => null,
-                'priority' => null,
-                'attributes' => [],
             ],
         ], $configItems);
 
@@ -675,6 +669,7 @@ public function testTypeErrorsInNavigationYamlConfigAreRethrownMoreHelpfully()
 
         try {
             $this->runBootstrappers();
+            NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
         } catch (InvalidConfigurationException $exception) {
             $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
@@ -697,6 +692,7 @@ public function testMustAddDestinationToYamlConfiguredNavigationItems()
 
         try {
             $this->runBootstrappers();
+            NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
         } catch (InvalidConfigurationException $exception) {
             $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());
@@ -720,6 +716,7 @@ public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
 
         try {
             $this->runBootstrappers();
+            NavigationMenuGenerator::handle(MainNavigationMenu::class)->getItems()->all();
         } catch (InvalidConfigurationException $exception) {
             $exceptionThrown = true;
             $this->assertSame('Invalid navigation item configuration detected the configuration file. Please double check the syntax.', $exception->getMessage());

From 16d70f0b8090680c880d08082cd3b45e0596456a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:09:07 +0200
Subject: [PATCH 2478/4023] Add todo

---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 6a1cda350e7..c574d6abfe9 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -47,6 +47,7 @@ protected function mergeParsedConfiguration(): void
     {
         foreach ($this->yaml->getData() as $namespace => $data) {
             if ($namespace === 'hyde' && isset($data['authors'])) {
+                // Todo: We may not actually need this, since the parser in the kernel can handle this. See https://github.com/hydephp/develop/pull/1824/commits/6a076b831b3cf07341605c314f0c29bfa4c0a8da
                 $data['authors'] = $this->parseAuthors($data['authors']);
             }
 

From 997a6ee47025be4f5c4ebc5fffff200f07612d37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:11:00 +0200
Subject: [PATCH 2479/4023] Rename closure parameter

---
 .../Features/Navigation/NavigationMenuGenerator.php         | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 8bcbb2c2f14..b97ecfbdf8b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -83,10 +83,10 @@ protected function generate(): void
                 $this->items->push(NavigationItem::create(DocumentationPage::home()));
             }
         } else {
-            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $item): void {
-                /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $item */
+            collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $data): void {
+                /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $data */
                 try {
-                    $item = NavigationItem::create(...$item);
+                    $item = NavigationItem::create(...$data);
                 } catch (Throwable $exception) {
                     throw new InvalidConfigurationException(
                         'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',

From 912f7b2b72f2697f8df0a57e12778b445c6dacda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 10 Jul 2024 21:17:38 +0200
Subject: [PATCH 2480/4023] Extract experimental helper method to try parsing
 config values

---
 .../Internal/LoadYamlConfiguration.php        | 12 ++----
 .../InvalidConfigurationException.php         | 14 +++++++
 .../Navigation/NavigationMenuGenerator.php    | 11 +----
 .../tests/Unit/CustomExceptionsTest.php       | 41 +++++++++++++++++++
 4 files changed, 60 insertions(+), 18 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 1f1dc4963e3..9ac4af5fa5b 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Foundation\Internal;
 
-use Throwable;
 use Illuminate\Support\Arr;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
@@ -67,14 +66,9 @@ protected function mergeConfiguration(string $namespace, array $yaml): void
     protected function parseAuthors(array $authors): array
     {
         return Arr::mapWithKeys($authors, function (array $author, string $username): array {
-            try {
-                return [$username => PostAuthor::create($author)];
-            } catch (Throwable $exception) {
-                throw new InvalidConfigurationException(
-                    'Invalid author configuration detected in the YAML config file. Please double check the syntax.',
-                    previous: $exception
-                );
-            }
+            $message = 'Invalid author configuration detected in the YAML config file. Please double check the syntax.';
+
+            return InvalidConfigurationException::try(fn () => [$username => PostAuthor::create($author)], $message);
         });
     }
 }
diff --git a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
index 694566ed717..306b6fd4a51 100644
--- a/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
+++ b/packages/framework/src/Framework/Exceptions/InvalidConfigurationException.php
@@ -45,4 +45,18 @@ protected function findConfigLine(string $namespace, string $key): array
 
         return [$file, $line + 1];
     }
+
+    /**
+     * @internal
+     *
+     * @experimental
+     */
+    public static function try(callable $callback, ?string $message = null): mixed
+    {
+        try {
+            return $callback();
+        } catch (Throwable $exception) {
+            throw new static($message ?? $exception->getMessage(), previous: $exception);
+        }
+    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index b97ecfbdf8b..94976bcff51 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use Hyde\Hyde;
-use Throwable;
 use Hyde\Facades\Config;
 use Hyde\Support\Models\Route;
 use Hyde\Pages\DocumentationPage;
@@ -85,14 +84,8 @@ protected function generate(): void
         } else {
             collect(Config::getArray('hyde.navigation.custom', []))->each(function (array $data): void {
                 /** @var array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>} $data */
-                try {
-                    $item = NavigationItem::create(...$data);
-                } catch (Throwable $exception) {
-                    throw new InvalidConfigurationException(
-                        'Invalid navigation item configuration detected the configuration file. Please double check the syntax.',
-                        previous: $exception
-                    );
-                }
+                $message = 'Invalid navigation item configuration detected the configuration file. Please double check the syntax.';
+                $item = InvalidConfigurationException::try(fn () => NavigationItem::create(...$data), $message);
 
                 // Since these were added explicitly by the user, we can assume they should always be shown
                 $this->items->push($item);
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 6009a31bc4e..af058ac7390 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -210,4 +210,45 @@ public function testInvalidConfigurationExceptionWithPreviousThrowable()
         $this->assertSame('Invalid configuration.', $exception->getMessage());
         $this->assertSame($previous, $exception->getPrevious());
     }
+
+    public function testInvalidConfigurationExceptionTryMethodWithSuccessfulCallback()
+    {
+        $result = InvalidConfigurationException::try(function () {
+            return 'success';
+        });
+
+        $this->assertSame('success', $result);
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodWithThrowingCallback()
+    {
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Custom error message');
+
+        InvalidConfigurationException::try(function () {
+            throw new RuntimeException('Original error');
+        }, 'Custom error message');
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodWithDefaultMessage()
+    {
+        $this->expectException(InvalidConfigurationException::class);
+        $this->expectExceptionMessage('Original error');
+
+        InvalidConfigurationException::try(function () {
+            throw new RuntimeException('Original error');
+        });
+    }
+
+    public function testInvalidConfigurationExceptionTryMethodPreservesPreviousException()
+    {
+        try {
+            InvalidConfigurationException::try(function () {
+                throw new RuntimeException('Original error');
+            }, 'Custom error message');
+        } catch (InvalidConfigurationException $e) {
+            $this->assertInstanceOf(RuntimeException::class, $e->getPrevious());
+            $this->assertSame('Original error', $e->getPrevious()->getMessage());
+        }
+    }
 }

From fabaf2920336f7cf5fcf3b66f741ebe76753b003 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:46:32 +0200
Subject: [PATCH 2481/4023] Draft builder method

---
 packages/framework/src/Facades/Navigation.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index b2dda93d6c7..5dbad8c0459 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -28,4 +28,9 @@ public static function item(string $destination, ?string $label = null, ?int $pr
     {
         return compact('destination', 'label', 'priority', 'attributes');
     }
+
+    public static function builder()
+    {
+        //
+    }
 }

From 7c896680e9544a1c68172bf515a53a88c8b61282 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:46:38 +0200
Subject: [PATCH 2482/4023] Draft method documentation

---
 packages/framework/src/Facades/Navigation.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 5dbad8c0459..fcad2f4fff8 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -29,6 +29,13 @@ public static function item(string $destination, ?string $label = null, ?int $pr
         return compact('destination', 'label', 'priority', 'attributes');
     }
 
+    /**
+     * Configuration helper method to define the navigation menu configuration with better IDE support.
+     *
+     * The returned object will then be cast to an array that will be used by the framework to set the config data.
+     *
+     * @experimental This method is experimental and may change in the future.
+     */
     public static function builder()
     {
         //

From 7f395d9691df466dedf2827975deb1211b7c0907 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:47:03 +0200
Subject: [PATCH 2483/4023] Rename added builder method to define

---
 packages/framework/src/Facades/Navigation.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index fcad2f4fff8..7138c339722 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -36,7 +36,7 @@ public static function item(string $destination, ?string $label = null, ?int $pr
      *
      * @experimental This method is experimental and may change in the future.
      */
-    public static function builder()
+    public static function define()
     {
         //
     }

From 5415a91b4077503d41332964aed1b6eeb694bb5d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:47:15 +0200
Subject: [PATCH 2484/4023] Rename added builder method to configure

---
 packages/framework/src/Facades/Navigation.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 7138c339722..b43d205e52a 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -36,7 +36,7 @@ public static function item(string $destination, ?string $label = null, ?int $pr
      *
      * @experimental This method is experimental and may change in the future.
      */
-    public static function define()
+    public static function configure()
     {
         //
     }

From 2cbe18dacda323068f06fe915412eed92f66338d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:48:53 +0200
Subject: [PATCH 2485/4023] Create NavigationMenuConfigurationBuilder.php

---
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
new file mode 100644
index 00000000000..ad56ac7b08c
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+class NavigationMenuConfigurationBuilder
+{
+    //
+}

From 519ee26b2348b6ff8922ce9c9fa949ac8c4632fc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:49:29 +0200
Subject: [PATCH 2486/4023] Draft the class documentation

---
 .../Navigation/NavigationMenuConfigurationBuilder.php      | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index ad56ac7b08c..d854f28f3fd 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -4,6 +4,13 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+/**
+ * Configuration helper method to define the navigation menu configuration with better IDE support.
+ *
+ * The configured object will be cast to an array that will be used by the framework to set the config data.
+ *
+ * @experimental This method is experimental and may change in the future.
+ */
 class NavigationMenuConfigurationBuilder
 {
     //

From 58f9b774d4c25707f3e9a5366aa9f211310a30ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:50:01 +0200
Subject: [PATCH 2487/4023] Return new navigation menu configuration builder

---
 packages/framework/src/Facades/Navigation.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index b43d205e52a..00809edd5e1 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Facades;
 
+use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
 use function compact;
 
 /**
@@ -36,8 +37,8 @@ public static function item(string $destination, ?string $label = null, ?int $pr
      *
      * @experimental This method is experimental and may change in the future.
      */
-    public static function configure()
+    public static function configure(): NavigationMenuConfigurationBuilder
     {
-        //
+        return new NavigationMenuConfigurationBuilder();
     }
 }

From 9ae9d6662d055e5473b53706e6862ab980868e74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:50:39 +0200
Subject: [PATCH 2488/4023] Add protected config array

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index d854f28f3fd..fd2577e3f71 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -13,5 +13,5 @@
  */
 class NavigationMenuConfigurationBuilder
 {
-    //
+    protected array $config = [];
 }

From 4446fd1d09705fe207df61c5f7fc76acf406d9fa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:51:21 +0200
Subject: [PATCH 2489/4023] Class NavigationMenuConfigurationBuilder extends
 ArrayObject

---
 .../Navigation/NavigationMenuConfigurationBuilder.php         | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index fd2577e3f71..53c6b082f60 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use ArrayObject;
+
 /**
  * Configuration helper method to define the navigation menu configuration with better IDE support.
  *
@@ -11,7 +13,7 @@
  *
  * @experimental This method is experimental and may change in the future.
  */
-class NavigationMenuConfigurationBuilder
+class NavigationMenuConfigurationBuilder extends ArrayObject
 {
     protected array $config = [];
 }

From a456ff03d4cc4ae367a4f30a06a7b954dcb343cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:51:35 +0200
Subject: [PATCH 2490/4023] Class NavigationMenuConfigurationBuilder implements
 Arrayable

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 53c6b082f60..3c0218254a0 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Features\Navigation;
 
 use ArrayObject;
+use Illuminate\Contracts\Support\Arrayable;
 
 /**
  * Configuration helper method to define the navigation menu configuration with better IDE support.
@@ -13,7 +14,7 @@
  *
  * @experimental This method is experimental and may change in the future.
  */
-class NavigationMenuConfigurationBuilder extends ArrayObject
+class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
 {
     protected array $config = [];
 }

From 15abd0cb647f739b0b7d01aad73e100841616e86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:52:01 +0200
Subject: [PATCH 2491/4023] Implement toArray() method

---
 .../Navigation/NavigationMenuConfigurationBuilder.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 3c0218254a0..5a7e3ef641c 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -17,4 +17,9 @@
 class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
 {
     protected array $config = [];
+
+    public function toArray(): array
+    {
+        return $this->config;
+    }
 }

From 01080ddf1d11c7df555ac3064fea31d28719a2e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:55:34 +0200
Subject: [PATCH 2492/4023] Draft the builder methods

---
 .../NavigationMenuConfigurationBuilder.php    | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 5a7e3ef641c..1d18227d409 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -22,4 +22,29 @@ public function toArray(): array
     {
         return $this->config;
     }
+
+    public function order(array $order): static
+    {
+        // TODO: Implement order() method.
+    }
+
+    public function labels(array $labels): static
+    {
+        // TODO: Implement labels() method.
+    }
+
+    public function exclude(array $exclude): static
+    {
+        // TODO: Implement exclude() method.
+    }
+
+    public function custom(array $custom): static
+    {
+        // TODO: Implement custom() method.
+    }
+
+    public function subdirectoryDisplay(string $displayMode): static
+    {
+        // TODO: Implement subdirectoryDisplay() method.
+    }
 }

From 1487cab2d09aaf614debc6d431d2ee12522a6c36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:56:28 +0200
Subject: [PATCH 2493/4023] Add method descriptions

---
 .../NavigationMenuConfigurationBuilder.php        | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 1d18227d409..806e2ef98ab 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -23,26 +23,41 @@ public function toArray(): array
         return $this->config;
     }
 
+    /**
+     * Set the order of the navigation items.
+     */
     public function order(array $order): static
     {
         // TODO: Implement order() method.
     }
 
+    /**
+     * Set the labels for the navigation items.
+     */
     public function labels(array $labels): static
     {
         // TODO: Implement labels() method.
     }
 
+    /**
+     * Exclude certain items from the navigation.
+     */
     public function exclude(array $exclude): static
     {
         // TODO: Implement exclude() method.
     }
 
+    /**
+     * Add custom items to the navigation.
+     */
     public function custom(array $custom): static
     {
         // TODO: Implement custom() method.
     }
 
+    /**
+     * Set the display mode for subdirectories.
+     */
     public function subdirectoryDisplay(string $displayMode): static
     {
         // TODO: Implement subdirectoryDisplay() method.

From 51ea211acfc98ce5760a70dd3d4a0b8383aa4e2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:56:50 +0200
Subject: [PATCH 2494/4023] Annotate fluent method return

---
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 806e2ef98ab..0408ff7b696 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -25,6 +25,8 @@ public function toArray(): array
 
     /**
      * Set the order of the navigation items.
+     *
+     * @return $this
      */
     public function order(array $order): static
     {
@@ -33,6 +35,8 @@ public function order(array $order): static
 
     /**
      * Set the labels for the navigation items.
+     *
+     * @return $this
      */
     public function labels(array $labels): static
     {
@@ -41,6 +45,8 @@ public function labels(array $labels): static
 
     /**
      * Exclude certain items from the navigation.
+     *
+     * @return $this
      */
     public function exclude(array $exclude): static
     {
@@ -49,6 +55,8 @@ public function exclude(array $exclude): static
 
     /**
      * Add custom items to the navigation.
+     *
+     * @return $this
      */
     public function custom(array $custom): static
     {
@@ -57,6 +65,8 @@ public function custom(array $custom): static
 
     /**
      * Set the display mode for subdirectories.
+     *
+     * @return $this
      */
     public function subdirectoryDisplay(string $displayMode): static
     {

From 9ddc7aeabb242547d4b5980450776a6966a7ad6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 10:57:13 +0200
Subject: [PATCH 2495/4023] Prepare parameter annotations

---
 .../Navigation/NavigationMenuConfigurationBuilder.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 0408ff7b696..48c69871088 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -26,6 +26,7 @@ public function toArray(): array
     /**
      * Set the order of the navigation items.
      *
+     * @param array $order
      * @return $this
      */
     public function order(array $order): static
@@ -36,6 +37,7 @@ public function order(array $order): static
     /**
      * Set the labels for the navigation items.
      *
+     * @param array $labels
      * @return $this
      */
     public function labels(array $labels): static
@@ -46,6 +48,7 @@ public function labels(array $labels): static
     /**
      * Exclude certain items from the navigation.
      *
+     * @param array $exclude
      * @return $this
      */
     public function exclude(array $exclude): static
@@ -56,6 +59,7 @@ public function exclude(array $exclude): static
     /**
      * Add custom items to the navigation.
      *
+     * @param array $custom
      * @return $this
      */
     public function custom(array $custom): static
@@ -66,6 +70,7 @@ public function custom(array $custom): static
     /**
      * Set the display mode for subdirectories.
      *
+     * @param string $displayMode
      * @return $this
      */
     public function subdirectoryDisplay(string $displayMode): static

From 87936dea21b42fc53ef4863b6b3c21313a937f99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:00:12 +0200
Subject: [PATCH 2496/4023] Annotate the parameter generics and enumerated
 types

---
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 48c69871088..ebd0243b5de 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -26,7 +26,7 @@ public function toArray(): array
     /**
      * Set the order of the navigation items.
      *
-     * @param array $order
+     * @param array<string, int>|array<string> $order
      * @return $this
      */
     public function order(array $order): static
@@ -37,7 +37,7 @@ public function order(array $order): static
     /**
      * Set the labels for the navigation items.
      *
-     * @param array $labels
+     * @param array<string, string> $labels
      * @return $this
      */
     public function labels(array $labels): static
@@ -48,7 +48,7 @@ public function labels(array $labels): static
     /**
      * Exclude certain items from the navigation.
      *
-     * @param array $exclude
+     * @param array<string> $exclude
      * @return $this
      */
     public function exclude(array $exclude): static
@@ -59,7 +59,7 @@ public function exclude(array $exclude): static
     /**
      * Add custom items to the navigation.
      *
-     * @param array $custom
+     * @param array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}> $custom
      * @return $this
      */
     public function custom(array $custom): static
@@ -70,7 +70,7 @@ public function custom(array $custom): static
     /**
      * Set the display mode for subdirectories.
      *
-     * @param string $displayMode
+     * @param 'dropdown'|'flat'|'hidden' $displayMode
      * @return $this
      */
     public function subdirectoryDisplay(string $displayMode): static

From 5328cf7b9db584aeb59044d8728b0be67d3672b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:00:37 +0200
Subject: [PATCH 2497/4023] Move down the toArray method

---
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index ebd0243b5de..62f76bf0d1d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -18,11 +18,6 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
 {
     protected array $config = [];
 
-    public function toArray(): array
-    {
-        return $this->config;
-    }
-
     /**
      * Set the order of the navigation items.
      *
@@ -77,4 +72,9 @@ public function subdirectoryDisplay(string $displayMode): static
     {
         // TODO: Implement subdirectoryDisplay() method.
     }
+
+    public function toArray(): array
+    {
+        return $this->config;
+    }
 }

From 118eb177d3a5cbec8dae08e4f6828f4c4c2f9a2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:02:20 +0200
Subject: [PATCH 2498/4023] Implement the builder methods

---
 .../NavigationMenuConfigurationBuilder.php    | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 62f76bf0d1d..7fea0a56c8f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -26,7 +26,9 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
      */
     public function order(array $order): static
     {
-        // TODO: Implement order() method.
+        $this->config['order'] = $order;
+
+        return $this;
     }
 
     /**
@@ -37,7 +39,9 @@ public function order(array $order): static
      */
     public function labels(array $labels): static
     {
-        // TODO: Implement labels() method.
+        $this->config['labels'] = $labels;
+
+        return $this;
     }
 
     /**
@@ -48,7 +52,9 @@ public function labels(array $labels): static
      */
     public function exclude(array $exclude): static
     {
-        // TODO: Implement exclude() method.
+        $this->config['exclude'] = $exclude;
+
+        return $this;
     }
 
     /**
@@ -59,7 +65,9 @@ public function exclude(array $exclude): static
      */
     public function custom(array $custom): static
     {
-        // TODO: Implement custom() method.
+        $this->config['custom'] = $custom;
+
+        return $this;
     }
 
     /**
@@ -70,7 +78,9 @@ public function custom(array $custom): static
      */
     public function subdirectoryDisplay(string $displayMode): static
     {
-        // TODO: Implement subdirectoryDisplay() method.
+        $this->config['subdirectory_display'] = $displayMode;
+
+        return $this;
     }
 
     public function toArray(): array

From 283852aae2541fe12c5d16cf784c96a71055387d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:02:56 +0200
Subject: [PATCH 2499/4023] Create NavigationMenuConfigurationBuilderTest.php

---
 .../NavigationMenuConfigurationBuilderTest.php   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
new file mode 100644
index 00000000000..c3e7125dece
--- /dev/null
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder
+ */
+class NavigationMenuConfigurationBuilderTest extends UnitTestCase
+{
+    public function testExample()
+    {
+        $this->assertTrue(true);
+    }
+}

From 5a48d0a83e1721728b73142ed9c3673edf5d42b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:06:58 +0200
Subject: [PATCH 2500/4023] Generate unit test with Claude

---
 ...NavigationMenuConfigurationBuilderTest.php | 134 +++++++++++++++++-
 1 file changed, 132 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index c3e7125dece..900e44875e4 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -3,14 +3,144 @@
 declare(strict_types=1);
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
+use Hyde\Facades\Navigation;
 
 /**
  * @covers \Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder
  */
 class NavigationMenuConfigurationBuilderTest extends UnitTestCase
 {
-    public function testExample()
+    private NavigationMenuConfigurationBuilder $builder;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->builder = new NavigationMenuConfigurationBuilder();
+    }
+
+    public function testOrder()
+    {
+        $order = ['index' => 0, 'posts' => 10, 'docs/index' => 100];
+        $result = $this->builder->order($order)->toArray();
+
+        $this->assertArrayHasKey('order', $result);
+        $this->assertEquals($order, $result['order']);
+    }
+
+    public function testLabels()
+    {
+        $labels = ['index' => 'Home', 'docs/index' => 'Docs'];
+        $result = $this->builder->labels($labels)->toArray();
+
+        $this->assertArrayHasKey('labels', $result);
+        $this->assertEquals($labels, $result['labels']);
+    }
+
+    public function testExclude()
+    {
+        $exclude = ['404', 'admin'];
+        $result = $this->builder->exclude($exclude)->toArray();
+
+        $this->assertArrayHasKey('exclude', $result);
+        $this->assertEquals($exclude, $result['exclude']);
+    }
+
+    public function testCustom()
+    {
+        $custom = [
+            Navigation::item('https://example.com', 'Example', 200),
+            Navigation::item('https://github.com', 'GitHub', 300),
+        ];
+        $result = $this->builder->custom($custom)->toArray();
+
+        $this->assertArrayHasKey('custom', $result);
+        $this->assertEquals($custom, $result['custom']);
+    }
+
+    public function testSubdirectoryDisplay()
+    {
+        $displayModes = ['dropdown', 'flat', 'hidden'];
+
+        foreach ($displayModes as $mode) {
+            $result = $this->builder->subdirectoryDisplay($mode)->toArray();
+
+            $this->assertArrayHasKey('subdirectory_display', $result);
+            $this->assertEquals($mode, $result['subdirectory_display']);
+        }
+    }
+
+    public function testChainedMethods()
+    {
+        $result = $this->builder
+            ->order(['index' => 0, 'posts' => 10])
+            ->labels(['index' => 'Home'])
+            ->exclude(['404'])
+            ->custom([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->subdirectoryDisplay('dropdown')
+            ->toArray();
+
+        $this->assertArrayHasKey('order', $result);
+        $this->assertArrayHasKey('labels', $result);
+        $this->assertArrayHasKey('exclude', $result);
+        $this->assertArrayHasKey('custom', $result);
+        $this->assertArrayHasKey('subdirectory_display', $result);
+    }
+
+    public function testEmptyConfiguration()
+    {
+        $result = $this->builder->toArray();
+
+        $this->assertEmpty($result);
+    }
+
+    public function testInvalidSubdirectoryDisplay()
+    {
+        $this->expectException(\TypeError::class);
+        $this->builder->subdirectoryDisplay('invalid');
+    }
+
+    public function testRealLifeUsageScenario()
+    {
+        $result = $this->builder
+            ->order([
+                'index' => 0,
+                'posts' => 10,
+                'docs/index' => 100,
+            ])
+            ->labels([
+                'index' => 'Home',
+                'docs/index' => 'Docs',
+            ])
+            ->exclude([
+                '404',
+            ])
+            ->custom([
+                Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
+            ])
+            ->subdirectoryDisplay('dropdown')
+            ->toArray();
+
+        $this->assertEquals([
+            'order' => ['index' => 0, 'posts' => 10, 'docs/index' => 100],
+            'labels' => ['index' => 'Home', 'docs/index' => 'Docs'],
+            'exclude' => ['404'],
+            'custom' => [
+                ['destination' => 'https://github.com/hydephp/hyde', 'label' => 'GitHub', 'priority' => 200, 'attributes' => []],
+            ],
+            'subdirectory_display' => 'dropdown',
+        ], $result);
+    }
+
+    public function testArrayableInterface()
+    {
+        $this->assertInstanceOf(\Illuminate\Contracts\Support\Arrayable::class, $this->builder);
+    }
+
+    public function testArrayObjectMethods()
     {
-        $this->assertTrue(true);
+        $this->builder->order(['index' => 0]);
+        $this->assertCount(1, $this->builder);
+        $this->assertEquals(['order' => ['index' => 0]], $this->builder->getArrayCopy());
     }
 }

From 289ef291366beebb447f770ac2d05a2c00e94a43 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:28:25 +0200
Subject: [PATCH 2501/4023] Test the added facade method

---
 .../Unit/Facades/NavigationFacadeTest.php     | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index a4b68d9f7c4..d16fa71c776 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Facades\Navigation;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
 
 /**
  * @covers \Hyde\Facades\Navigation
@@ -47,4 +48,50 @@ public function testItemWithUrl()
             'attributes' => [],
         ], $item);
     }
+
+    public function testConfigure()
+    {
+        $builder = Navigation::configure();
+
+        $this->assertInstanceOf(NavigationMenuConfigurationBuilder::class, $builder);
+    }
+
+    public function testConfigureWithChainedMethods()
+    {
+        $config = Navigation::configure()
+            ->order(['index' => 0, 'posts' => 10])
+            ->labels(['index' => 'Home'])
+            ->exclude(['404'])
+            ->custom([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->subdirectoryDisplay('dropdown')
+            ->toArray();
+
+        $this->assertIsArray($config);
+        $this->assertArrayHasKey('order', $config);
+        $this->assertArrayHasKey('labels', $config);
+        $this->assertArrayHasKey('exclude', $config);
+        $this->assertArrayHasKey('custom', $config);
+        $this->assertArrayHasKey('subdirectory_display', $config);
+
+        $this->assertEquals(['index' => 0, 'posts' => 10], $config['order']);
+        $this->assertEquals(['index' => 'Home'], $config['labels']);
+        $this->assertEquals(['404'], $config['exclude']);
+        $this->assertEquals([Navigation::item('https://github.com', 'GitHub', 200)], $config['custom']);
+        $this->assertEquals('dropdown', $config['subdirectory_display']);
+    }
+
+    public function testConfigureWithSomeChainedMethods()
+    {
+        $config = Navigation::configure()
+            ->order(['about' => 1, 'contact' => 2])
+            ->labels(['about' => 'About Us'])
+            ->subdirectoryDisplay('flat')
+            ->toArray();
+
+        $this->assertEquals(['about' => 1, 'contact' => 2], $config['order']);
+        $this->assertEquals(['about' => 'About Us'], $config['labels']);
+        $this->assertEquals('flat', $config['subdirectory_display']);
+        $this->assertArrayNotHasKey('exclude', $config);
+        $this->assertArrayNotHasKey('custom', $config);
+    }
 }

From 073faa76614ca1a2e18626d89482e0852ea78331 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:10:46 +0200
Subject: [PATCH 2502/4023] Skip test for not implemented feature

---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 900e44875e4..b7c6d608220 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -96,6 +96,8 @@ public function testEmptyConfiguration()
 
     public function testInvalidSubdirectoryDisplay()
     {
+        $this->markTestSkipped('Not yet implemented');
+
         $this->expectException(\TypeError::class);
         $this->builder->subdirectoryDisplay('invalid');
     }

From 121159fb4402db3cdc2ce85540bd9f9892fe6507 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:11:11 +0200
Subject: [PATCH 2503/4023] Construct with the config property

---
 .../Navigation/NavigationMenuConfigurationBuilder.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 7fea0a56c8f..9ddb26ed3e9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -18,6 +18,11 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
 {
     protected array $config = [];
 
+    public function __construct()
+    {
+        parent::__construct($this->config);
+    }
+
     /**
      * Set the order of the navigation items.
      *

From 374c5291c58e490f353806d6524c76284b05a3ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:11:19 +0200
Subject: [PATCH 2504/4023] Construct with array object flags

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 9ddb26ed3e9..e4c59ea5e49 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -20,7 +20,7 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
 
     public function __construct()
     {
-        parent::__construct($this->config);
+        parent::__construct($this->config, ArrayObject::ARRAY_AS_PROPS | ArrayObject::STD_PROP_LIST);
     }
 
     /**

From 5118abea3a92f957aea2ac9a493de500b95d28f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:11:22 +0200
Subject: [PATCH 2505/4023] Revert "Construct with array object flags"

This reverts commit 38743f97f0479b3716abcd7af674ae06559c6ffa.
---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index e4c59ea5e49..9ddb26ed3e9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -20,7 +20,7 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
 
     public function __construct()
     {
-        parent::__construct($this->config, ArrayObject::ARRAY_AS_PROPS | ArrayObject::STD_PROP_LIST);
+        parent::__construct($this->config);
     }
 
     /**

From 6c60b5d2e7793354ce7734d4c9d6dd55da752839 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:11:26 +0200
Subject: [PATCH 2506/4023] Revert "Construct with the config property"

This reverts commit 808b437352dbd22465288b965d651246e3f7a40c.
---
 .../Navigation/NavigationMenuConfigurationBuilder.php        | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 9ddb26ed3e9..7fea0a56c8f 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -18,11 +18,6 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
 {
     protected array $config = [];
 
-    public function __construct()
-    {
-        parent::__construct($this->config);
-    }
-
     /**
      * Set the order of the navigation items.
      *

From ee6eac0b4b49c24a326cea5bdea40a0031c4045e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:11:53 +0200
Subject: [PATCH 2507/4023] Fix typo in description

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 7fea0a56c8f..102346a0507 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -8,7 +8,7 @@
 use Illuminate\Contracts\Support\Arrayable;
 
 /**
- * Configuration helper method to define the navigation menu configuration with better IDE support.
+ * Configuration helper class to define the navigation menu configuration with better IDE support.
  *
  * The configured object will be cast to an array that will be used by the framework to set the config data.
  *

From 413c12c68d216e79d6f271b021c6ff28af86535f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:12:13 +0200
Subject: [PATCH 2508/4023] Fix typo in description

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 102346a0507..588d4a8599e 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -12,7 +12,7 @@
  *
  * The configured object will be cast to an array that will be used by the framework to set the config data.
  *
- * @experimental This method is experimental and may change in the future.
+ * @experimental This class is experimental and may change in the future.
  */
 class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
 {

From aff25115bee6184a99c1c79f7724ad1b0ebf8349 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:13:06 +0200
Subject: [PATCH 2509/4023] Refactor the class to property utilise the array
 object features

---
 .../NavigationMenuConfigurationBuilder.php         | 14 ++++++--------
 .../NavigationMenuConfigurationBuilderTest.php     |  7 ++++++-
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 588d4a8599e..c85dd24173b 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -16,8 +16,6 @@
  */
 class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
 {
-    protected array $config = [];
-
     /**
      * Set the order of the navigation items.
      *
@@ -26,7 +24,7 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
      */
     public function order(array $order): static
     {
-        $this->config['order'] = $order;
+        $this['order'] = $order;
 
         return $this;
     }
@@ -39,7 +37,7 @@ public function order(array $order): static
      */
     public function labels(array $labels): static
     {
-        $this->config['labels'] = $labels;
+        $this['labels'] = $labels;
 
         return $this;
     }
@@ -52,7 +50,7 @@ public function labels(array $labels): static
      */
     public function exclude(array $exclude): static
     {
-        $this->config['exclude'] = $exclude;
+        $this['exclude'] = $exclude;
 
         return $this;
     }
@@ -65,7 +63,7 @@ public function exclude(array $exclude): static
      */
     public function custom(array $custom): static
     {
-        $this->config['custom'] = $custom;
+        $this['custom'] = $custom;
 
         return $this;
     }
@@ -78,13 +76,13 @@ public function custom(array $custom): static
      */
     public function subdirectoryDisplay(string $displayMode): static
     {
-        $this->config['subdirectory_display'] = $displayMode;
+        $this['subdirectory_display'] = $displayMode;
 
         return $this;
     }
 
     public function toArray(): array
     {
-        return $this->config;
+        return $this->getArrayCopy();
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index b7c6d608220..a31ceb06bb0 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -139,10 +139,15 @@ public function testArrayableInterface()
         $this->assertInstanceOf(\Illuminate\Contracts\Support\Arrayable::class, $this->builder);
     }
 
-    public function testArrayObjectMethods()
+    public function testArrayObjectBehavior()
     {
         $this->builder->order(['index' => 0]);
+
+        // ArrayObject methods now operate on the configuration data
         $this->assertCount(1, $this->builder);
         $this->assertEquals(['order' => ['index' => 0]], $this->builder->getArrayCopy());
+
+        // toArray() method should return the same result
+        $this->assertEquals(['order' => ['index' => 0]], $this->builder->toArray());
     }
 }

From 97bb4f95f9a0053a73195c1590146943f60ea4e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:14:12 +0200
Subject: [PATCH 2510/4023] Replace qualifier with an import

---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php      | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index a31ceb06bb0..15124bc1ea9 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Contracts\Support\Arrayable;
 use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
 use Hyde\Facades\Navigation;
 
@@ -136,7 +137,7 @@ public function testRealLifeUsageScenario()
 
     public function testArrayableInterface()
     {
-        $this->assertInstanceOf(\Illuminate\Contracts\Support\Arrayable::class, $this->builder);
+        $this->assertInstanceOf(Arrayable::class, $this->builder);
     }
 
     public function testArrayObjectBehavior()

From 599abdc3931d94280ccee0bbf72e1fd3c414d3bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:24:58 +0200
Subject: [PATCH 2511/4023] Document the array shape returns

---
 .../Navigation/NavigationMenuConfigurationBuilder.php        | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index c85dd24173b..6741439fa0d 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -81,6 +81,11 @@ public function subdirectoryDisplay(string $displayMode): static
         return $this;
     }
 
+    /**
+     * Get the instance as an array.
+     *
+     * @return array{order: array<string, int>, labels: array<string, string>, exclude: array<string>, custom: array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>, subdirectory_display: string}
+     */
     public function toArray(): array
     {
         return $this->getArrayCopy();

From b5cc7ed813dbec93ce887293b0382b6c6957e0de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:29:21 +0200
Subject: [PATCH 2512/4023] Use assert same for scalar comparisons

---
 .../tests/Unit/Facades/NavigationFacadeTest.php  | 16 ++++++++--------
 .../NavigationMenuConfigurationBuilderTest.php   | 16 ++++++++--------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index d16fa71c776..f101a28263b 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -73,11 +73,11 @@ public function testConfigureWithChainedMethods()
         $this->assertArrayHasKey('custom', $config);
         $this->assertArrayHasKey('subdirectory_display', $config);
 
-        $this->assertEquals(['index' => 0, 'posts' => 10], $config['order']);
-        $this->assertEquals(['index' => 'Home'], $config['labels']);
-        $this->assertEquals(['404'], $config['exclude']);
-        $this->assertEquals([Navigation::item('https://github.com', 'GitHub', 200)], $config['custom']);
-        $this->assertEquals('dropdown', $config['subdirectory_display']);
+        $this->assertSame(['index' => 0, 'posts' => 10], $config['order']);
+        $this->assertSame(['index' => 'Home'], $config['labels']);
+        $this->assertSame(['404'], $config['exclude']);
+        $this->assertSame([Navigation::item('https://github.com', 'GitHub', 200)], $config['custom']);
+        $this->assertSame('dropdown', $config['subdirectory_display']);
     }
 
     public function testConfigureWithSomeChainedMethods()
@@ -88,9 +88,9 @@ public function testConfigureWithSomeChainedMethods()
             ->subdirectoryDisplay('flat')
             ->toArray();
 
-        $this->assertEquals(['about' => 1, 'contact' => 2], $config['order']);
-        $this->assertEquals(['about' => 'About Us'], $config['labels']);
-        $this->assertEquals('flat', $config['subdirectory_display']);
+        $this->assertSame(['about' => 1, 'contact' => 2], $config['order']);
+        $this->assertSame(['about' => 'About Us'], $config['labels']);
+        $this->assertSame('flat', $config['subdirectory_display']);
         $this->assertArrayNotHasKey('exclude', $config);
         $this->assertArrayNotHasKey('custom', $config);
     }
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 15124bc1ea9..199c45b634d 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -26,7 +26,7 @@ public function testOrder()
         $result = $this->builder->order($order)->toArray();
 
         $this->assertArrayHasKey('order', $result);
-        $this->assertEquals($order, $result['order']);
+        $this->assertSame($order, $result['order']);
     }
 
     public function testLabels()
@@ -35,7 +35,7 @@ public function testLabels()
         $result = $this->builder->labels($labels)->toArray();
 
         $this->assertArrayHasKey('labels', $result);
-        $this->assertEquals($labels, $result['labels']);
+        $this->assertSame($labels, $result['labels']);
     }
 
     public function testExclude()
@@ -44,7 +44,7 @@ public function testExclude()
         $result = $this->builder->exclude($exclude)->toArray();
 
         $this->assertArrayHasKey('exclude', $result);
-        $this->assertEquals($exclude, $result['exclude']);
+        $this->assertSame($exclude, $result['exclude']);
     }
 
     public function testCustom()
@@ -56,7 +56,7 @@ public function testCustom()
         $result = $this->builder->custom($custom)->toArray();
 
         $this->assertArrayHasKey('custom', $result);
-        $this->assertEquals($custom, $result['custom']);
+        $this->assertSame($custom, $result['custom']);
     }
 
     public function testSubdirectoryDisplay()
@@ -67,7 +67,7 @@ public function testSubdirectoryDisplay()
             $result = $this->builder->subdirectoryDisplay($mode)->toArray();
 
             $this->assertArrayHasKey('subdirectory_display', $result);
-            $this->assertEquals($mode, $result['subdirectory_display']);
+            $this->assertSame($mode, $result['subdirectory_display']);
         }
     }
 
@@ -124,7 +124,7 @@ public function testRealLifeUsageScenario()
             ->subdirectoryDisplay('dropdown')
             ->toArray();
 
-        $this->assertEquals([
+        $this->assertSame([
             'order' => ['index' => 0, 'posts' => 10, 'docs/index' => 100],
             'labels' => ['index' => 'Home', 'docs/index' => 'Docs'],
             'exclude' => ['404'],
@@ -146,9 +146,9 @@ public function testArrayObjectBehavior()
 
         // ArrayObject methods now operate on the configuration data
         $this->assertCount(1, $this->builder);
-        $this->assertEquals(['order' => ['index' => 0]], $this->builder->getArrayCopy());
+        $this->assertSame(['order' => ['index' => 0]], $this->builder->getArrayCopy());
 
         // toArray() method should return the same result
-        $this->assertEquals(['order' => ['index' => 0]], $this->builder->toArray());
+        $this->assertSame(['order' => ['index' => 0]], $this->builder->toArray());
     }
 }

From 1029dc1a5a88ed2d29f555dc30bb836615f85f41 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Thu, 11 Jul 2024 09:25:50 +0000
Subject: [PATCH 2513/4023] Apply fixes from StyleCI

---
 packages/framework/src/Facades/Navigation.php          |  1 +
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 +++++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 00809edd5e1..b6294e06e16 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -5,6 +5,7 @@
 namespace Hyde\Facades;
 
 use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
+
 use function compact;
 
 /**
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 6741439fa0d..b28ca750daa 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -19,7 +19,7 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
     /**
      * Set the order of the navigation items.
      *
-     * @param array<string, int>|array<string> $order
+     * @param  array<string, int>|array<string>  $order
      * @return $this
      */
     public function order(array $order): static
@@ -32,7 +32,7 @@ public function order(array $order): static
     /**
      * Set the labels for the navigation items.
      *
-     * @param array<string, string> $labels
+     * @param  array<string, string>  $labels
      * @return $this
      */
     public function labels(array $labels): static
@@ -45,7 +45,7 @@ public function labels(array $labels): static
     /**
      * Exclude certain items from the navigation.
      *
-     * @param array<string> $exclude
+     * @param  array<string>  $exclude
      * @return $this
      */
     public function exclude(array $exclude): static
@@ -58,7 +58,7 @@ public function exclude(array $exclude): static
     /**
      * Add custom items to the navigation.
      *
-     * @param array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}> $custom
+     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
      * @return $this
      */
     public function custom(array $custom): static
@@ -71,7 +71,7 @@ public function custom(array $custom): static
     /**
      * Set the display mode for subdirectories.
      *
-     * @param 'dropdown'|'flat'|'hidden' $displayMode
+     * @param  'dropdown'|'flat'|'hidden'  $displayMode
      * @return $this
      */
     public function subdirectoryDisplay(string $displayMode): static

From 7e9681e830748af23363baf183e6d2b9a5ce7c41 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:30:28 +0200
Subject: [PATCH 2514/4023] Remove unnecessary comment

---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php        | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 199c45b634d..dbfaa54ee60 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -144,7 +144,6 @@ public function testArrayObjectBehavior()
     {
         $this->builder->order(['index' => 0]);
 
-        // ArrayObject methods now operate on the configuration data
         $this->assertCount(1, $this->builder);
         $this->assertSame(['order' => ['index' => 0]], $this->builder->getArrayCopy());
 

From 6432901382ecc963bd315c9bd7c8ccf7cf400830 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:31:35 +0200
Subject: [PATCH 2515/4023] Split out assertion to dedicated test method

---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php   | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index dbfaa54ee60..2419ecf1c24 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -146,8 +146,12 @@ public function testArrayObjectBehavior()
 
         $this->assertCount(1, $this->builder);
         $this->assertSame(['order' => ['index' => 0]], $this->builder->getArrayCopy());
+    }
+
+    public function testToArrayMethodReturnsSameResultAsArrayObject()
+    {
+        $this->builder->order(['index' => 0]);
 
-        // toArray() method should return the same result
         $this->assertSame(['order' => ['index' => 0]], $this->builder->toArray());
     }
 }

From 9c1afcf9508ee425df7314884cb1ce21e790bfc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:33:00 +0200
Subject: [PATCH 2516/4023] Revert "Skip test for not implemented feature"

This reverts commit 073faa76614ca1a2e18626d89482e0852ea78331.
---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php       | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 2419ecf1c24..e93c3dd3b72 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -97,8 +97,6 @@ public function testEmptyConfiguration()
 
     public function testInvalidSubdirectoryDisplay()
     {
-        $this->markTestSkipped('Not yet implemented');
-
         $this->expectException(\TypeError::class);
         $this->builder->subdirectoryDisplay('invalid');
     }

From 2842aebf136f48bd424159bdd5b0ef02271d3f3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:33:29 +0200
Subject: [PATCH 2517/4023] Assert the enumerated string type

---
 .../Navigation/NavigationMenuConfigurationBuilder.php | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index b28ca750daa..1056bf016f8 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
+use TypeError;
 use ArrayObject;
 use Illuminate\Contracts\Support\Arrayable;
 
@@ -76,6 +77,8 @@ public function custom(array $custom): static
      */
     public function subdirectoryDisplay(string $displayMode): static
     {
+        self::assertType(['dropdown', 'flat', 'hidden'], $displayMode);
+
         $this['subdirectory_display'] = $displayMode;
 
         return $this;
@@ -90,4 +93,12 @@ public function toArray(): array
     {
         return $this->getArrayCopy();
     }
+
+    /** @internal */
+    protected static function assertType(array $types, string $value): void
+    {
+        if (! in_array($value, $types)) {
+            throw new TypeError('Value must be one of: '.implode(', ', $types));
+        }
+    }
 }

From bd3595470d48607b39bbab992c5c343b72bb4d4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:33:57 +0200
Subject: [PATCH 2518/4023] Replace internal marker for already internal method
 with experimental

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 1056bf016f8..2d031badd16 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -94,7 +94,7 @@ public function toArray(): array
         return $this->getArrayCopy();
     }
 
-    /** @internal */
+    /** @experimental May be moved to a separate helper class in the future. */
     protected static function assertType(array $types, string $value): void
     {
         if (! in_array($value, $types)) {

From d0c9c1c9d5ed2f89f7fc04d1de58685f27e092bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 11:53:30 +0200
Subject: [PATCH 2519/4023] Improve the configuration method documentation

---
 .../Navigation/NavigationMenuConfigurationBuilder.php  | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 2d031badd16..621a0a109c6 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -20,6 +20,8 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
     /**
      * Set the order of the navigation items.
      *
+     * Either define a map of route keys to priorities, or just a list of route keys and we'll try to match that order.
+     *
      * @param  array<string, int>|array<string>  $order
      * @return $this
      */
@@ -33,6 +35,8 @@ public function order(array $order): static
     /**
      * Set the labels for the navigation items.
      *
+     * Each key should be a route key, and the value should be the label to display.
+     *
      * @param  array<string, string>  $labels
      * @return $this
      */
@@ -46,6 +50,8 @@ public function labels(array $labels): static
     /**
      * Exclude certain items from the navigation.
      *
+     * Each item should be a route key for the page to exclude.
+     *
      * @param  array<string>  $exclude
      * @return $this
      */
@@ -59,6 +65,8 @@ public function exclude(array $exclude): static
     /**
      * Add custom items to the navigation.
      *
+     * @example `[Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200, ['target' => '_blank'])]`
+     *
      * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
      * @return $this
      */
@@ -72,6 +80,8 @@ public function custom(array $custom): static
     /**
      * Set the display mode for subdirectories.
      *
+     * You can choose between 'dropdown', 'flat', and 'hidden'.
+     *
      * @param  'dropdown'|'flat'|'hidden'  $displayMode
      * @return $this
      */

From 80ae091dfe97beff26a28fefb66e12bb57e833da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 13:49:21 +0200
Subject: [PATCH 2520/4023] Test can configure main menu using array settings

---
 .../AutomaticNavigationConfigurationsTest.php | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ab6939903ba..34784461c8c 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1234,6 +1234,61 @@ public function testSidebarGroupCasingUsingFrontMatter()
         $this->assertSidebarEquals(['Hello World'], [new DocumentationPage('foo', ['navigation.group' => 'hello world'])]);
     }
 
+    // Configuration tests
+
+    public function testCanConfigureMainMenuUsingArraySettings()
+    {
+        $config = [
+            'navigation' => [
+                'order' => [
+                    'foo' => 3,
+                    'bar' => 2,
+                    'baz' => 1,
+                ],
+
+                'labels' => [
+                    'foo' => 'Foo Page',
+                    'bar' => 'Bar Page',
+                    'baz' => 'Baz Page',
+                    'dropdown/item' => 'Dropdown Item Page',
+                ],
+
+                'exclude' => [
+                    'qux',
+                ],
+
+                'custom' => [
+                    [
+                        'label' => 'Custom',
+                        'destination' => 'https://example.com',
+                        'priority' => 120,
+                        'attributes' => [
+                            'target' => '_blank',
+                        ],
+                    ],
+                ],
+
+                'subdirectory_display' => 'flat',
+            ],
+        ];
+
+        config(['hyde' => $config]);
+
+        $this->assertMenuEquals([
+            ['label' => 'Baz Page', 'priority' => 1],
+            ['label' => 'Bar Page', 'priority' => 2],
+            ['label' => 'Foo Page', 'priority' => 3],
+            ['label' => 'Custom', 'priority' => 120, 'attributes' => ['target' => '_blank']],
+            ['label' => 'Dropdown Item Page', 'priority' => 999],
+        ], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('bar'),
+            new MarkdownPage('baz'),
+            new MarkdownPage('qux'),
+            new MarkdownPage('dropdown/item'),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): AssertableNavigationMenu

From de4e8c39958af708641c8d3a79b64ad42b4cfe9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 13:55:52 +0200
Subject: [PATCH 2521/4023] Test can configure main menu using builder settings

---
 .../AutomaticNavigationConfigurationsTest.php | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 34784461c8c..82ba3fdb209 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -10,6 +10,7 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\InMemoryPage;
+use Hyde\Facades\Navigation;
 use Hyde\Foundation\HydeKernel;
 use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
@@ -1289,6 +1290,56 @@ public function testCanConfigureMainMenuUsingArraySettings()
         ]);
     }
 
+    public function testCanConfigureMainMenuUsingBuilderSettings()
+    {
+        $builder = Navigation::configure()
+            ->order([
+                'foo' => 3,
+                'bar' => 2,
+                'baz' => 1,
+            ])
+            ->labels([
+                'foo' => 'Foo Page',
+                'bar' => 'Bar Page',
+                'baz' => 'Baz Page',
+                'dropdown/item' => 'Dropdown Item Page',
+            ])
+            ->exclude([
+                'qux',
+            ])
+            ->custom([
+                [
+                    'label' => 'Custom',
+                    'destination' => 'https://example.com',
+                    'priority' => 120,
+                    'attributes' => [
+                        'target' => '_blank',
+                    ],
+                ],
+            ])
+            ->subdirectoryDisplay('flat');
+
+        $config = [
+            'navigation' => $builder,
+        ];
+
+        config(['hyde' => $config]);
+
+        $this->assertMenuEquals([
+            ['label' => 'Baz Page', 'priority' => 1],
+            ['label' => 'Bar Page', 'priority' => 2],
+            ['label' => 'Foo Page', 'priority' => 3],
+            ['label' => 'Custom', 'priority' => 120, 'attributes' => ['target' => '_blank']],
+            ['label' => 'Dropdown Item Page', 'priority' => 999],
+        ], [
+            new MarkdownPage('foo'),
+            new MarkdownPage('bar'),
+            new MarkdownPage('baz'),
+            new MarkdownPage('qux'),
+            new MarkdownPage('dropdown/item'),
+        ]);
+    }
+
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): AssertableNavigationMenu

From ea05a987b2775074b304c2bcce108eb2d67e821b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 13:59:41 +0200
Subject: [PATCH 2522/4023] Inline local variable

---
 .../AutomaticNavigationConfigurationsTest.php | 54 +++++++++----------
 1 file changed, 26 insertions(+), 28 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 82ba3fdb209..14757d9935a 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1292,35 +1292,33 @@ public function testCanConfigureMainMenuUsingArraySettings()
 
     public function testCanConfigureMainMenuUsingBuilderSettings()
     {
-        $builder = Navigation::configure()
-            ->order([
-                'foo' => 3,
-                'bar' => 2,
-                'baz' => 1,
-            ])
-            ->labels([
-                'foo' => 'Foo Page',
-                'bar' => 'Bar Page',
-                'baz' => 'Baz Page',
-                'dropdown/item' => 'Dropdown Item Page',
-            ])
-            ->exclude([
-                'qux',
-            ])
-            ->custom([
-                [
-                    'label' => 'Custom',
-                    'destination' => 'https://example.com',
-                    'priority' => 120,
-                    'attributes' => [
-                        'target' => '_blank',
-                    ],
-                ],
-            ])
-            ->subdirectoryDisplay('flat');
-
         $config = [
-            'navigation' => $builder,
+            'navigation' => Navigation::configure()
+                ->order([
+                    'foo' => 3,
+                    'bar' => 2,
+                    'baz' => 1,
+                ])
+                ->labels([
+                    'foo' => 'Foo Page',
+                    'bar' => 'Bar Page',
+                    'baz' => 'Baz Page',
+                    'dropdown/item' => 'Dropdown Item Page',
+                ])
+                ->exclude([
+                    'qux',
+                ])
+                ->custom([
+                    [
+                        'label' => 'Custom',
+                        'destination' => 'https://example.com',
+                        'priority' => 120,
+                        'attributes' => [
+                            'target' => '_blank',
+                        ],
+                    ],
+                ])
+                ->subdirectoryDisplay('flat'),
         ];
 
         config(['hyde' => $config]);

From 57b703583338d38e2f443742fbf8504cab10b109 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:08:29 +0200
Subject: [PATCH 2523/4023] Use the new Navigation configuration builder class

Updates the configuration files to use the new Navigation configuration builder
---
 config/hyde.php                    | 42 +++++++++++-------------------
 packages/framework/config/hyde.php | 42 +++++++++++-------------------
 2 files changed, 30 insertions(+), 54 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 8d9c62357c5..4b224b922ae 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -332,40 +332,28 @@
     |
     */
 
-    'navigation' => [
-        // This configuration sets the priorities used to determine the order of the menu.
-        // The default values have been added below for reference and easy editing.
-        // The array key is the page's route key, the value is the priority.
-        // Lower values show up first in the menu. The default is 999.
-        'order' => [
+    'navigation' => Navigation::configure()
+        ->order([
+            // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
-        ],
-
-        // In case you want to customize the labels for the menu items, you can do so here.
-        // Simply add the route key as the array key, and the label as the value.
-        'labels' => [
+        ])
+        ->labels([
+            // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
-        ],
-
-        // These are the route keys of pages that should not show up in the navigation menu.
-        'exclude' => [
+        ])
+        ->exclude([
+            // Exclude pages from the navigation
             '404',
-        ],
-
-        // Any extra links you want to add to the navigation menu can be added here.
-        // To get started quickly, you can uncomment the defaults here.
-        // See the documentation link above for more information.
-        'custom' => [
+        ])
+        ->custom([
+            // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ],
-
-        // How should pages in subdirectories be displayed in the menu?
-        // You can choose between 'dropdown', 'flat', and 'hidden'.
-        'subdirectory_display' => 'hidden',
-    ],
+        ])
+        // Configure how subdirectories are displayed in the navigation
+        ->subdirectoryDisplay('hidden'),
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 8d9c62357c5..4b224b922ae 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -332,40 +332,28 @@
     |
     */
 
-    'navigation' => [
-        // This configuration sets the priorities used to determine the order of the menu.
-        // The default values have been added below for reference and easy editing.
-        // The array key is the page's route key, the value is the priority.
-        // Lower values show up first in the menu. The default is 999.
-        'order' => [
+    'navigation' => Navigation::configure()
+        ->order([
+            // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
-        ],
-
-        // In case you want to customize the labels for the menu items, you can do so here.
-        // Simply add the route key as the array key, and the label as the value.
-        'labels' => [
+        ])
+        ->labels([
+            // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
-        ],
-
-        // These are the route keys of pages that should not show up in the navigation menu.
-        'exclude' => [
+        ])
+        ->exclude([
+            // Exclude pages from the navigation
             '404',
-        ],
-
-        // Any extra links you want to add to the navigation menu can be added here.
-        // To get started quickly, you can uncomment the defaults here.
-        // See the documentation link above for more information.
-        'custom' => [
+        ])
+        ->custom([
+            // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ],
-
-        // How should pages in subdirectories be displayed in the menu?
-        // You can choose between 'dropdown', 'flat', and 'hidden'.
-        'subdirectory_display' => 'hidden',
-    ],
+        ])
+        // Configure how subdirectories are displayed in the navigation
+        ->subdirectoryDisplay('hidden'),
 
     /*
     |--------------------------------------------------------------------------

From 8588cb9b12fbc64d70f0718033c43a5a7d5022f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:14:54 +0200
Subject: [PATCH 2524/4023] Rename builder methods to be self describing

---
 config/hyde.php                               | 10 ++--
 packages/framework/config/hyde.php            | 10 ++--
 .../NavigationMenuConfigurationBuilder.php    | 10 ++--
 .../AutomaticNavigationConfigurationsTest.php | 10 ++--
 .../Unit/Facades/NavigationFacadeTest.php     | 16 +++----
 ...NavigationMenuConfigurationBuilderTest.php | 46 +++++++++----------
 6 files changed, 51 insertions(+), 51 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 4b224b922ae..4458eabc7a4 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -333,27 +333,27 @@
     */
 
     'navigation' => Navigation::configure()
-        ->order([
+        ->setPagePriorities([
             // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
         ])
-        ->labels([
+        ->setPageLabels([
             // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
         ])
-        ->exclude([
+        ->excludePages([
             // Exclude pages from the navigation
             '404',
         ])
-        ->custom([
+        ->addCustomNavigationItems([
             // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
         // Configure how subdirectories are displayed in the navigation
-        ->subdirectoryDisplay('hidden'),
+        ->setSubdirectoryDisplayMode('hidden'),
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 4b224b922ae..4458eabc7a4 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -333,27 +333,27 @@
     */
 
     'navigation' => Navigation::configure()
-        ->order([
+        ->setPagePriorities([
             // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
         ])
-        ->labels([
+        ->setPageLabels([
             // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
         ])
-        ->exclude([
+        ->excludePages([
             // Exclude pages from the navigation
             '404',
         ])
-        ->custom([
+        ->addCustomNavigationItems([
             // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
         // Configure how subdirectories are displayed in the navigation
-        ->subdirectoryDisplay('hidden'),
+        ->setSubdirectoryDisplayMode('hidden'),
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 621a0a109c6..aa44c5cbbe9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -25,7 +25,7 @@ class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayabl
      * @param  array<string, int>|array<string>  $order
      * @return $this
      */
-    public function order(array $order): static
+    public function setPagePriorities(array $order): static
     {
         $this['order'] = $order;
 
@@ -40,7 +40,7 @@ public function order(array $order): static
      * @param  array<string, string>  $labels
      * @return $this
      */
-    public function labels(array $labels): static
+    public function setPageLabels(array $labels): static
     {
         $this['labels'] = $labels;
 
@@ -55,7 +55,7 @@ public function labels(array $labels): static
      * @param  array<string>  $exclude
      * @return $this
      */
-    public function exclude(array $exclude): static
+    public function excludePages(array $exclude): static
     {
         $this['exclude'] = $exclude;
 
@@ -70,7 +70,7 @@ public function exclude(array $exclude): static
      * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
      * @return $this
      */
-    public function custom(array $custom): static
+    public function addCustomNavigationItems(array $custom): static
     {
         $this['custom'] = $custom;
 
@@ -85,7 +85,7 @@ public function custom(array $custom): static
      * @param  'dropdown'|'flat'|'hidden'  $displayMode
      * @return $this
      */
-    public function subdirectoryDisplay(string $displayMode): static
+    public function setSubdirectoryDisplayMode(string $displayMode): static
     {
         self::assertType(['dropdown', 'flat', 'hidden'], $displayMode);
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 14757d9935a..ea5a8a48938 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1294,21 +1294,21 @@ public function testCanConfigureMainMenuUsingBuilderSettings()
     {
         $config = [
             'navigation' => Navigation::configure()
-                ->order([
+                ->setPagePriorities([
                     'foo' => 3,
                     'bar' => 2,
                     'baz' => 1,
                 ])
-                ->labels([
+                ->setPageLabels([
                     'foo' => 'Foo Page',
                     'bar' => 'Bar Page',
                     'baz' => 'Baz Page',
                     'dropdown/item' => 'Dropdown Item Page',
                 ])
-                ->exclude([
+                ->excludePages([
                     'qux',
                 ])
-                ->custom([
+                ->addCustomNavigationItems([
                     [
                         'label' => 'Custom',
                         'destination' => 'https://example.com',
@@ -1318,7 +1318,7 @@ public function testCanConfigureMainMenuUsingBuilderSettings()
                         ],
                     ],
                 ])
-                ->subdirectoryDisplay('flat'),
+                ->setSubdirectoryDisplayMode('flat'),
         ];
 
         config(['hyde' => $config]);
diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index f101a28263b..a81acc59297 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -59,11 +59,11 @@ public function testConfigure()
     public function testConfigureWithChainedMethods()
     {
         $config = Navigation::configure()
-            ->order(['index' => 0, 'posts' => 10])
-            ->labels(['index' => 'Home'])
-            ->exclude(['404'])
-            ->custom([Navigation::item('https://github.com', 'GitHub', 200)])
-            ->subdirectoryDisplay('dropdown')
+            ->setPagePriorities(['index' => 0, 'posts' => 10])
+            ->setPageLabels(['index' => 'Home'])
+            ->excludePages(['404'])
+            ->addCustomNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->setSubdirectoryDisplayMode('dropdown')
             ->toArray();
 
         $this->assertIsArray($config);
@@ -83,9 +83,9 @@ public function testConfigureWithChainedMethods()
     public function testConfigureWithSomeChainedMethods()
     {
         $config = Navigation::configure()
-            ->order(['about' => 1, 'contact' => 2])
-            ->labels(['about' => 'About Us'])
-            ->subdirectoryDisplay('flat')
+            ->setPagePriorities(['about' => 1, 'contact' => 2])
+            ->setPageLabels(['about' => 'About Us'])
+            ->setSubdirectoryDisplayMode('flat')
             ->toArray();
 
         $this->assertSame(['about' => 1, 'contact' => 2], $config['order']);
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index e93c3dd3b72..0d0035c018a 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -20,51 +20,51 @@ protected function setUp(): void
         $this->builder = new NavigationMenuConfigurationBuilder();
     }
 
-    public function testOrder()
+    public function testSetPagePriorities()
     {
         $order = ['index' => 0, 'posts' => 10, 'docs/index' => 100];
-        $result = $this->builder->order($order)->toArray();
+        $result = $this->builder->setPagePriorities($order)->toArray();
 
         $this->assertArrayHasKey('order', $result);
         $this->assertSame($order, $result['order']);
     }
 
-    public function testLabels()
+    public function testSetPageLabels()
     {
         $labels = ['index' => 'Home', 'docs/index' => 'Docs'];
-        $result = $this->builder->labels($labels)->toArray();
+        $result = $this->builder->setPageLabels($labels)->toArray();
 
         $this->assertArrayHasKey('labels', $result);
         $this->assertSame($labels, $result['labels']);
     }
 
-    public function testExclude()
+    public function testExcludePages()
     {
         $exclude = ['404', 'admin'];
-        $result = $this->builder->exclude($exclude)->toArray();
+        $result = $this->builder->excludePages($exclude)->toArray();
 
         $this->assertArrayHasKey('exclude', $result);
         $this->assertSame($exclude, $result['exclude']);
     }
 
-    public function testCustom()
+    public function testAddCustomNavigationItems()
     {
         $custom = [
             Navigation::item('https://example.com', 'Example', 200),
             Navigation::item('https://github.com', 'GitHub', 300),
         ];
-        $result = $this->builder->custom($custom)->toArray();
+        $result = $this->builder->addCustomNavigationItems($custom)->toArray();
 
         $this->assertArrayHasKey('custom', $result);
         $this->assertSame($custom, $result['custom']);
     }
 
-    public function testSubdirectoryDisplay()
+    public function testSetSubdirectoryDisplayMode()
     {
         $displayModes = ['dropdown', 'flat', 'hidden'];
 
         foreach ($displayModes as $mode) {
-            $result = $this->builder->subdirectoryDisplay($mode)->toArray();
+            $result = $this->builder->setSubdirectoryDisplayMode($mode)->toArray();
 
             $this->assertArrayHasKey('subdirectory_display', $result);
             $this->assertSame($mode, $result['subdirectory_display']);
@@ -74,11 +74,11 @@ public function testSubdirectoryDisplay()
     public function testChainedMethods()
     {
         $result = $this->builder
-            ->order(['index' => 0, 'posts' => 10])
-            ->labels(['index' => 'Home'])
-            ->exclude(['404'])
-            ->custom([Navigation::item('https://github.com', 'GitHub', 200)])
-            ->subdirectoryDisplay('dropdown')
+            ->setPagePriorities(['index' => 0, 'posts' => 10])
+            ->setPageLabels(['index' => 'Home'])
+            ->excludePages(['404'])
+            ->addCustomNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->setSubdirectoryDisplayMode('dropdown')
             ->toArray();
 
         $this->assertArrayHasKey('order', $result);
@@ -98,28 +98,28 @@ public function testEmptyConfiguration()
     public function testInvalidSubdirectoryDisplay()
     {
         $this->expectException(\TypeError::class);
-        $this->builder->subdirectoryDisplay('invalid');
+        $this->builder->setSubdirectoryDisplayMode('invalid');
     }
 
     public function testRealLifeUsageScenario()
     {
         $result = $this->builder
-            ->order([
+            ->setPagePriorities([
                 'index' => 0,
                 'posts' => 10,
                 'docs/index' => 100,
             ])
-            ->labels([
+            ->setPageLabels([
                 'index' => 'Home',
                 'docs/index' => 'Docs',
             ])
-            ->exclude([
+            ->excludePages([
                 '404',
             ])
-            ->custom([
+            ->addCustomNavigationItems([
                 Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
             ])
-            ->subdirectoryDisplay('dropdown')
+            ->setSubdirectoryDisplayMode('dropdown')
             ->toArray();
 
         $this->assertSame([
@@ -140,7 +140,7 @@ public function testArrayableInterface()
 
     public function testArrayObjectBehavior()
     {
-        $this->builder->order(['index' => 0]);
+        $this->builder->setPagePriorities(['index' => 0]);
 
         $this->assertCount(1, $this->builder);
         $this->assertSame(['order' => ['index' => 0]], $this->builder->getArrayCopy());
@@ -148,7 +148,7 @@ public function testArrayObjectBehavior()
 
     public function testToArrayMethodReturnsSameResultAsArrayObject()
     {
-        $this->builder->order(['index' => 0]);
+        $this->builder->setPagePriorities(['index' => 0]);
 
         $this->assertSame(['order' => ['index' => 0]], $this->builder->toArray());
     }

From 93497a41048b2bc98dc5e94edbed429a1095c359 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:15:39 +0200
Subject: [PATCH 2525/4023] Remove now redundant code comments

---
 config/hyde.php                    | 5 -----
 packages/framework/config/hyde.php | 5 -----
 2 files changed, 10 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 4458eabc7a4..9ae31e9a627 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -334,25 +334,20 @@
 
     'navigation' => Navigation::configure()
         ->setPagePriorities([
-            // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
         ])
         ->setPageLabels([
-            // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
         ])
         ->excludePages([
-            // Exclude pages from the navigation
             '404',
         ])
         ->addCustomNavigationItems([
-            // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
-        // Configure how subdirectories are displayed in the navigation
         ->setSubdirectoryDisplayMode('hidden'),
 
     /*
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 4458eabc7a4..9ae31e9a627 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -334,25 +334,20 @@
 
     'navigation' => Navigation::configure()
         ->setPagePriorities([
-            // Override page priority order
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
         ])
         ->setPageLabels([
-            // Override page labels
             'index' => 'Home',
             'docs/index' => 'Docs',
         ])
         ->excludePages([
-            // Exclude pages from the navigation
             '404',
         ])
         ->addCustomNavigationItems([
-            // Add custom items to the navigation menu
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
-        // Configure how subdirectories are displayed in the navigation
         ->setSubdirectoryDisplayMode('hidden'),
 
     /*

From e7b5a1ce57fb0799c1a33706491be6273e06eb04 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:19:22 +0200
Subject: [PATCH 2526/4023] Remove infix from helper method name

Don't think this adds value
---
 config/hyde.php                                           | 2 +-
 packages/framework/config/hyde.php                        | 2 +-
 .../Navigation/NavigationMenuConfigurationBuilder.php     | 2 +-
 .../Feature/AutomaticNavigationConfigurationsTest.php     | 2 +-
 .../framework/tests/Unit/Facades/NavigationFacadeTest.php | 2 +-
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php | 8 ++++----
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 9ae31e9a627..67c1da3b43b 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -345,7 +345,7 @@
         ->excludePages([
             '404',
         ])
-        ->addCustomNavigationItems([
+        ->addNavigationItems([
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
         ->setSubdirectoryDisplayMode('hidden'),
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 9ae31e9a627..67c1da3b43b 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -345,7 +345,7 @@
         ->excludePages([
             '404',
         ])
-        ->addCustomNavigationItems([
+        ->addNavigationItems([
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
         ])
         ->setSubdirectoryDisplayMode('hidden'),
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index aa44c5cbbe9..ef8d409f6ef 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -70,7 +70,7 @@ public function excludePages(array $exclude): static
      * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
      * @return $this
      */
-    public function addCustomNavigationItems(array $custom): static
+    public function addNavigationItems(array $custom): static
     {
         $this['custom'] = $custom;
 
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index ea5a8a48938..8262d1acc8f 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -1308,7 +1308,7 @@ public function testCanConfigureMainMenuUsingBuilderSettings()
                 ->excludePages([
                     'qux',
                 ])
-                ->addCustomNavigationItems([
+                ->addNavigationItems([
                     [
                         'label' => 'Custom',
                         'destination' => 'https://example.com',
diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index a81acc59297..fa2350fda8f 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -62,7 +62,7 @@ public function testConfigureWithChainedMethods()
             ->setPagePriorities(['index' => 0, 'posts' => 10])
             ->setPageLabels(['index' => 'Home'])
             ->excludePages(['404'])
-            ->addCustomNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->addNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
             ->setSubdirectoryDisplayMode('dropdown')
             ->toArray();
 
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 0d0035c018a..bd0d9acdcf0 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -47,13 +47,13 @@ public function testExcludePages()
         $this->assertSame($exclude, $result['exclude']);
     }
 
-    public function testAddCustomNavigationItems()
+    public function testAddNavigationItems()
     {
         $custom = [
             Navigation::item('https://example.com', 'Example', 200),
             Navigation::item('https://github.com', 'GitHub', 300),
         ];
-        $result = $this->builder->addCustomNavigationItems($custom)->toArray();
+        $result = $this->builder->addNavigationItems($custom)->toArray();
 
         $this->assertArrayHasKey('custom', $result);
         $this->assertSame($custom, $result['custom']);
@@ -77,7 +77,7 @@ public function testChainedMethods()
             ->setPagePriorities(['index' => 0, 'posts' => 10])
             ->setPageLabels(['index' => 'Home'])
             ->excludePages(['404'])
-            ->addCustomNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
+            ->addNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
             ->setSubdirectoryDisplayMode('dropdown')
             ->toArray();
 
@@ -116,7 +116,7 @@ public function testRealLifeUsageScenario()
             ->excludePages([
                 '404',
             ])
-            ->addCustomNavigationItems([
+            ->addNavigationItems([
                 Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
             ])
             ->setSubdirectoryDisplayMode('dropdown')

From 491d08e0fafceaaa60693cf89724f04bf09241fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:20:07 +0200
Subject: [PATCH 2527/4023] Clean up formatting

---
 .../tests/Unit/NavigationMenuConfigurationBuilderTest.php       | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index bd0d9acdcf0..8e24330ef83 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -17,6 +17,7 @@ class NavigationMenuConfigurationBuilderTest extends UnitTestCase
     protected function setUp(): void
     {
         parent::setUp();
+
         $this->builder = new NavigationMenuConfigurationBuilder();
     }
 
@@ -53,6 +54,7 @@ public function testAddNavigationItems()
             Navigation::item('https://example.com', 'Example', 200),
             Navigation::item('https://github.com', 'GitHub', 300),
         ];
+
         $result = $this->builder->addNavigationItems($custom)->toArray();
 
         $this->assertArrayHasKey('custom', $result);

From 7641ff9d99d4b5269b70f5a2d58e512a9db23392 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:21:37 +0200
Subject: [PATCH 2528/4023] Clarify comment

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index ef8d409f6ef..2686a6b3936 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -78,7 +78,7 @@ public function addNavigationItems(array $custom): static
     }
 
     /**
-     * Set the display mode for subdirectories.
+     * Set the display mode for pages in subdirectories.
      *
      * You can choose between 'dropdown', 'flat', and 'hidden'.
      *

From e48da59a74ec8df1e103247d1c320b062c3bcf02 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:22:25 +0200
Subject: [PATCH 2529/4023] Document default value

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 2686a6b3936..78b76dd01dc 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -80,7 +80,7 @@ public function addNavigationItems(array $custom): static
     /**
      * Set the display mode for pages in subdirectories.
      *
-     * You can choose between 'dropdown', 'flat', and 'hidden'.
+     * You can choose between 'dropdown', 'flat', and 'hidden'. The default is 'hidden'.
      *
      * @param  'dropdown'|'flat'|'hidden'  $displayMode
      * @return $this

From 7f9f9b776e70eed0c65f76c39b1c28e5900c1d1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:23:38 +0200
Subject: [PATCH 2530/4023] Add experimental fluent shorthand

---
 .../NavigationMenuConfigurationBuilder.php           | 12 ++++++++++++
 .../Unit/NavigationMenuConfigurationBuilderTest.php  |  7 +++++++
 2 files changed, 19 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 78b76dd01dc..1f27c65dbc5 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -94,6 +94,18 @@ public function setSubdirectoryDisplayMode(string $displayMode): static
         return $this;
     }
 
+    /**
+     * Hide pages in subdirectories from the navigation.
+     *
+     * @experimental This method is experimental and may change or be removed before the final release.
+     *
+     * @return $this
+     */
+    public function hideSubdirectoriesFromNavigation(): static
+    {
+        return $this->setSubdirectoryDisplayMode('hidden');
+    }
+
     /**
      * Get the instance as an array.
      *
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
index 8e24330ef83..cde1e6c4100 100644
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
@@ -135,6 +135,13 @@ public function testRealLifeUsageScenario()
         ], $result);
     }
 
+    public function testHideSubdirectoriesFromNavigationShorthand()
+    {
+        $result = $this->builder->hideSubdirectoriesFromNavigation()->toArray();
+
+        $this->assertSame('hidden', $result['subdirectory_display']);
+    }
+
     public function testArrayableInterface()
     {
         $this->assertInstanceOf(Arrayable::class, $this->builder);

From a961afefae6d70028525580c2ccbcb945e93248a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:32:34 +0200
Subject: [PATCH 2531/4023] Update experimental marker

---
 .../Features/Navigation/NavigationMenuConfigurationBuilder.php  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 1f27c65dbc5..48bd4429489 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -13,7 +13,7 @@
  *
  * The configured object will be cast to an array that will be used by the framework to set the config data.
  *
- * @experimental This class is experimental and may change in the future.
+ * @experimental This class is experimental and may change or be removed before the final release.
  */
 class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
 {

From d5f2439dc1d13b9a9766941a009d40d8ec5c82ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 16:34:32 +0200
Subject: [PATCH 2532/4023] Link to facade method and normalize documentation

---
 packages/framework/src/Facades/Navigation.php                 | 4 ++--
 .../Navigation/NavigationMenuConfigurationBuilder.php         | 4 +++-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index b6294e06e16..1f64d809f3c 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -34,9 +34,9 @@ public static function item(string $destination, ?string $label = null, ?int $pr
     /**
      * Configuration helper method to define the navigation menu configuration with better IDE support.
      *
-     * The returned object will then be cast to an array that will be used by the framework to set the config data.
+     * The builder is an array object that will be used by the framework to set the navigation menu configuration.
      *
-     * @experimental This method is experimental and may change in the future.
+     * @experimental This method is experimental and may change or be removed before the final release.
      */
     public static function configure(): NavigationMenuConfigurationBuilder
     {
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
index 48bd4429489..4f5d9957628 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
@@ -11,7 +11,9 @@
 /**
  * Configuration helper class to define the navigation menu configuration with better IDE support.
  *
- * The configured object will be cast to an array that will be used by the framework to set the config data.
+ * The configured data will then be used by the framework to set the navigation menu configuration.
+ *
+ * @see \Hyde\Facades\Navigation::configure()
  *
  * @experimental This class is experimental and may change or be removed before the final release.
  */

From 210271f202ad028d80e30e5e7a500e906fd5bc95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:03:10 +0200
Subject: [PATCH 2533/4023] Remove documentation for alternate front matter
 properties

I think it's confusing to note these, it's best to document the canonical ones, but silently support alternates for fault tolerance and interoperability.
---
 docs/digging-deeper/navigation.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 3ff1d9d16b9..7c58475dccc 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -70,9 +70,9 @@ You don't need to specify all the keys, only the ones you want to customize.
 ```yaml
 navigation:
     label: string  # The text to display
-    priority: int  # Order is also supported
-    hidden: bool   # Visible is also supported (but obviously invert the value)
-    group: string  # Category is also supported
+    priority: int  # The priority of the page used for determining the order, lower means higher up/first
+    hidden: bool   # Whether the page should be hidden from the navigation menu
+    group: string  # For sidebars, this is the sidebar group, for the main menu, this is the dropdown group
 ```
 
 ### `label`
@@ -86,7 +86,7 @@ navigation:
 
 ### `priority`
 
-The `priority` option allows you to control the order in which the page appears in the navigation menu. You can also use `order` instead of `priority`.
+The `priority` option allows you to control the order in which the page appears in the navigation menu. 
 
 ```yaml
 navigation:
@@ -95,7 +95,7 @@ navigation:
 
 ### `hidden`
 
-The `hidden` option allows you to control if the page appears in the navigation menu. You can also use `visible` instead of `hidden`, but obviously invert the value.
+The `hidden` option allows you to control if the page appears in the navigation menu. 
 
 ```yaml
 navigation:
@@ -107,7 +107,6 @@ navigation:
 The `group` option has a slightly different meaning depending on the type of navigation menu.
 For the primary navigation menu, it allows you to group pages together in dropdowns.
 For the sidebar, it allows you to group pages together in the sidebar under a common heading.
-You can also use `category` instead of `group`.
 
 ```yaml
 navigation:

From a6fa2951245c2dc94795a0e336e08512445788cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:15:18 +0200
Subject: [PATCH 2534/4023] Merge long parts of introduction to a single
 section

---
 docs/digging-deeper/navigation.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 7c58475dccc..c28d9188e3a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -8,18 +8,16 @@ navigation:
 
 ## Introduction
 
-A great time-saving feature of HydePHP is the automatic navigation menu and documentation sidebar generation.
-Hyde is designed to automatically configure these menus for you based on the content you have in your project.
+HydePHP offers an automatic navigation menu and documentation sidebar generation feature, designed to take the pain out of creating navigation menus.
+While Hyde does its best to configure these menus automatically based on understanding your project files, you may want to customize them further.
+This documentation will guide you through the customization process.
 
 There are two types of navigation menus in Hyde:
 
 - **Primary Navigation Menu**: This is the main navigation menu that appears on most pages of your site.
 - **Documentation Sidebar**: This is a sidebar that appears on documentation pages and contains links to other documentation pages.
 
-HydePHP automatically generates all of these menus for you based on the content of your project,
-and does its best to automatically configure them in the way that you most likely want them to be.
 
-Of course, this won't always be perfect, so thankfully Hyde makes it a breeze to customize these menus to your liking.
 Keep on reading to learn how! To learn even more about the sidebars, visit the [Documentation Pages](documentation-pages) documentation.
 
 ### Quick primer on the internals

From f72a4f525fd7d26650e8b7c8076fab91060f39a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:15:49 +0200
Subject: [PATCH 2535/4023] Update the menu types list text

---
 docs/digging-deeper/navigation.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index c28d9188e3a..baaa3c409bf 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -14,8 +14,8 @@ This documentation will guide you through the customization process.
 
 There are two types of navigation menus in Hyde:
 
-- **Primary Navigation Menu**: This is the main navigation menu that appears on most pages of your site.
-- **Documentation Sidebar**: This is a sidebar that appears on documentation pages and contains links to other documentation pages.
+1. **Primary Navigation Menu**: The main navigation menu appearing on most pages of your site. Unique features include dropdowns for subdirectories, depending on configuration.
+2. **Documentation Sidebar**: The sidebar on documentation pages with links to other documentation pages. Unique features include automatic grouping based on subdirectories.
 
 
 Keep on reading to learn how! To learn even more about the sidebars, visit the [Documentation Pages](documentation-pages) documentation.

From d98f73b4872def93deaac51a79d2c5aad6f710d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:16:39 +0200
Subject: [PATCH 2536/4023] Merge together sections in the introduction

---
 docs/digging-deeper/navigation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index baaa3c409bf..c525f72d56c 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -10,15 +10,14 @@ navigation:
 
 HydePHP offers an automatic navigation menu and documentation sidebar generation feature, designed to take the pain out of creating navigation menus.
 While Hyde does its best to configure these menus automatically based on understanding your project files, you may want to customize them further.
-This documentation will guide you through the customization process.
 
 There are two types of navigation menus in Hyde:
 
 1. **Primary Navigation Menu**: The main navigation menu appearing on most pages of your site. Unique features include dropdowns for subdirectories, depending on configuration.
 2. **Documentation Sidebar**: The sidebar on documentation pages with links to other documentation pages. Unique features include automatic grouping based on subdirectories.
 
+This documentation will guide you through the customization process. To learn even more about sidebars, visit the [Documentation Pages](documentation-pages) documentation.
 
-Keep on reading to learn how! To learn even more about the sidebars, visit the [Documentation Pages](documentation-pages) documentation.
 
 ### Quick primer on the internals
 

From 49fb29c595a44278ef29e11784b65a3ae72a6afe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:18:12 +0200
Subject: [PATCH 2537/4023] Improve headings

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index c525f72d56c..5378ec31ed4 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -19,7 +19,7 @@ There are two types of navigation menus in Hyde:
 This documentation will guide you through the customization process. To learn even more about sidebars, visit the [Documentation Pages](documentation-pages) documentation.
 
 
-### Quick primer on the internals
+### Internal Structure Overview
 
 It may be beneficial to understand the internal workings of the navigation menus to take full advantage of the options.
 
@@ -28,13 +28,13 @@ they are configured is very similar, making the documentation here applicable to
 
 See the [Digging Deeper](#digging-deeper-into-the-internals) section of this page if you want the full scoop on the internals!
 
-### Primer on priorities
+### Understanding Priorities
 
 All navigation menu items have an internal priority value that determines their order in the navigation.
 Lower values mean that the item will be higher up in the menu. The default for pages is `999` which puts them last.
 However, some pages are autoconfigured to have a lower priority, for example, the `index` page defaults to a priority of `0`.
 
-### What to customize?
+### Customization Options
 
 Here is a quick overview of what you might want to customize in your navigation menus:
 
@@ -43,7 +43,7 @@ Here is a quick overview of what you might want to customize in your navigation
 - Navigation menu item visibility - control if pages may show up in the menus
 - Navigation menu item grouping - group pages together in dropdowns
 
-### How and where to customize?
+### Customization Methods
 
 Hyde provides a few different ways to customize the navigation menus, depending on what you prefer.
 

From 70993a54195ff910ccdc6416eaccd38ad544458a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:19:24 +0200
Subject: [PATCH 2538/4023] Merge internal structure section to be more concise
 and clear

---
 docs/digging-deeper/navigation.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 5378ec31ed4..6651cda3675 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -21,12 +21,10 @@ This documentation will guide you through the customization process. To learn ev
 
 ### Internal Structure Overview
 
-It may be beneficial to understand the internal workings of the navigation menus to take full advantage of the options.
+Internally, both navigation menu types extend the same base class, and thus share core functionality. This means the configuration process is similar for both types, making the documentation applicable to both.
 
-In short, both navigation menu types extend the same class (meaning they share the same base code), this means that the way
-they are configured is very similar, making the documentation here applicable to both types of menus.
+For a deeper understanding of the internal workings, refer to the [Digging Deeper](#digging-deeper-into-the-internals) section.
 
-See the [Digging Deeper](#digging-deeper-into-the-internals) section of this page if you want the full scoop on the internals!
 
 ### Understanding Priorities
 

From e2a6934e559142aad060cc807652255c9a3d87c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:21:08 +0200
Subject: [PATCH 2539/4023] Improve the wording of the priorities section

---
 docs/digging-deeper/navigation.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 6651cda3675..a08e650d422 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -28,9 +28,7 @@ For a deeper understanding of the internal workings, refer to the [Digging Deepe
 
 ### Understanding Priorities
 
-All navigation menu items have an internal priority value that determines their order in the navigation.
-Lower values mean that the item will be higher up in the menu. The default for pages is `999` which puts them last.
-However, some pages are autoconfigured to have a lower priority, for example, the `index` page defaults to a priority of `0`.
+All navigation menu items have an internal priority value determining their order. Lower values place items higher in the menu. The default priority for pages is `999`, placing them last unless you specify a value. Some pages, like the `index` page, are by default configured with the lowest priority of `0`.
 
 ### Customization Options
 

From 5b5692298129bda5475d4350a199e134130434d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:21:23 +0200
Subject: [PATCH 2540/4023] Reword introduction to be more concise

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index a08e650d422..4cf0b9bf8ec 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -32,7 +32,7 @@ All navigation menu items have an internal priority value determining their orde
 
 ### Customization Options
 
-Here is a quick overview of what you might want to customize in your navigation menus:
+Here's an overview of what you can customize in your navigation menus:
 
 - Navigation menu item labels - the text that appears in the menu links
 - Navigation menu item priority - control the order in which the links appear

From a7abfba94423968937a75e4080f8003961fd551d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:22:16 +0200
Subject: [PATCH 2541/4023] Reword list to be more concise

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4cf0b9bf8ec..3fd008786d7 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -34,10 +34,10 @@ All navigation menu items have an internal priority value determining their orde
 
 Here's an overview of what you can customize in your navigation menus:
 
-- Navigation menu item labels - the text that appears in the menu links
-- Navigation menu item priority - control the order in which the links appear
-- Navigation menu item visibility - control if pages may show up in the menus
-- Navigation menu item grouping - group pages together in dropdowns
+- Item labels: The text displayed in menu links
+- Item priorities: Control the order of link appearance
+- Item visibility: Choose to hide or show pages in the menu
+- Item grouping: Group pages together in dropdowns or sidebar categories
 
 ### Customization Methods
 

From a9ff6f36e573bc5f468c23ff6f5fdddd18636684 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:22:37 +0200
Subject: [PATCH 2542/4023] Reword introduction to be more concise

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 3fd008786d7..eb61b4e94ca 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -41,7 +41,7 @@ Here's an overview of what you can customize in your navigation menus:
 
 ### Customization Methods
 
-Hyde provides a few different ways to customize the navigation menus, depending on what you prefer.
+Hyde provides multiple ways to customize navigation menus to suit your needs:
 
 Specifying the data in the front matter will override any dynamically inferred or config-defined priority.
 While this is useful for one-offs, it can make it harder to reorder items later on as you can't see the whole picture at once.

From cfbc1b1a2345b1ba89799cf533e5940a9e76748f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:25:23 +0200
Subject: [PATCH 2543/4023] Rewrite section to use an easier to read list

---
 docs/digging-deeper/navigation.md | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index eb61b4e94ca..a0d75d43172 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -43,16 +43,13 @@ Here's an overview of what you can customize in your navigation menus:
 
 Hyde provides multiple ways to customize navigation menus to suit your needs:
 
-Specifying the data in the front matter will override any dynamically inferred or config-defined priority.
-While this is useful for one-offs, it can make it harder to reorder items later on as you can't see the whole picture at once.
-It's up to you which method you prefer to use.
+1. Front matter data in Markdown and Blade page files, applicable to all menu types
+2. Configuration in the `hyde` config file for main navigation items
+3. Configuration in the `docs` config file for documentation sidebar items
 
-To customize how a page is represented in navigation, you can either set the `navigation` front matter data in the page's markdown file,
-or configure it in the config file. Main navigation items are in the `hyde` config file, while documentation sidebar items are in the `docs` config file.
-General options for the entire navigation menus are also available in the `hyde` and `docs` config files.
-
-Now that you know the basics, let's dive into the details of how to customize the navigation menus!
+Keep in mind that front matter data overrides dynamically inferred or config-defined priorities. While useful for quick one-off changes on small sites, it can make reordering items later on more challenging as you can't see the entire structure at once.
 
+Additionally, general options for the entire navigation menus are also available in the `hyde` and `docs` config files.
 
 ## Front Matter Configuration
 

From 528b4fc37487fa043c55791b81c1918e8f9ffd2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:26:38 +0200
Subject: [PATCH 2544/4023] Remove extra newlines

---
 docs/digging-deeper/navigation.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index a0d75d43172..3e23a848749 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -18,14 +18,12 @@ There are two types of navigation menus in Hyde:
 
 This documentation will guide you through the customization process. To learn even more about sidebars, visit the [Documentation Pages](documentation-pages) documentation.
 
-
 ### Internal Structure Overview
 
 Internally, both navigation menu types extend the same base class, and thus share core functionality. This means the configuration process is similar for both types, making the documentation applicable to both.
 
 For a deeper understanding of the internal workings, refer to the [Digging Deeper](#digging-deeper-into-the-internals) section.
 
-
 ### Understanding Priorities
 
 All navigation menu items have an internal priority value determining their order. Lower values place items higher in the menu. The default priority for pages is `999`, placing them last unless you specify a value. Some pages, like the `index` page, are by default configured with the lowest priority of `0`.

From 1d8953926da7a3257a9a1f40940173c57574ccdb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:40:01 +0200
Subject: [PATCH 2545/4023] Move down part not needed in introduction to bottom
 of the section

---
 docs/digging-deeper/navigation.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 3e23a848749..763edae235a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -51,9 +51,7 @@ Additionally, general options for the entire navigation menus are also available
 
 ## Front Matter Configuration
 
-The front matter options allow you to customize the navigation menus on a per-page basis.
-Here is a quick reference of the available options. The full documentation of each option is below.
-You don't need to specify all the keys, only the ones you want to customize.
+Front matter options allow per-page customization of navigation menus. Here's a quick reference of available options:
 
 ```yaml
 navigation:
@@ -63,6 +61,8 @@ navigation:
     group: string  # For sidebars, this is the sidebar group, for the main menu, this is the dropdown group
 ```
 
+You only need to specify the keys you want to customize.
+
 ### `label`
 
 The `label` option allows you to customize the text that appears in the navigation menu for the page.

From a6415704d5a9f168ebb48d6767eee62908c8f9ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:42:21 +0200
Subject: [PATCH 2546/4023] Reword list to be more concise

---
 docs/digging-deeper/navigation.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 763edae235a..6a0d43098f9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -55,10 +55,10 @@ Front matter options allow per-page customization of navigation menus. Here's a
 
 ```yaml
 navigation:
-    label: string  # The text to display
-    priority: int  # The priority of the page used for determining the order, lower means higher up/first
+    label: string  # The displayed text in the navigation item link
+    priority: int  # The page's priority for ordering (lower means higher up/first)
     hidden: bool   # Whether the page should be hidden from the navigation menu
-    group: string  # For sidebars, this is the sidebar group, for the main menu, this is the dropdown group
+    group: string  # Set main menu dropdown or sidebar group key
 ```
 
 You only need to specify the keys you want to customize.

From f8b56aa5ea01e06ea1e5fface2c8ee7b938e4fa4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:45:13 +0200
Subject: [PATCH 2547/4023] Remove redundant information from section
 introductions

---
 docs/digging-deeper/navigation.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 6a0d43098f9..9f71319485d 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -65,7 +65,7 @@ You only need to specify the keys you want to customize.
 
 ### `label`
 
-The `label` option allows you to customize the text that appears in the navigation menu for the page.
+Customizes the text appearing in the navigation menu link for the page.
 
 ```yaml
 navigation:
@@ -74,7 +74,7 @@ navigation:
 
 ### `priority`
 
-The `priority` option allows you to control the order in which the page appears in the navigation menu. 
+Controls the order in which the page appears in the navigation menu.
 
 ```yaml
 navigation:
@@ -83,7 +83,7 @@ navigation:
 
 ### `hidden`
 
-The `hidden` option allows you to control if the page appears in the navigation menu. 
+Determines if the page appears in the navigation menu.
 
 ```yaml
 navigation:

From 0bd1377d5c0743425875abcf9233096662f2d7dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:45:23 +0200
Subject: [PATCH 2548/4023] Document default data sources

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 9f71319485d..584f355cc19 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -65,7 +65,7 @@ You only need to specify the keys you want to customize.
 
 ### `label`
 
-Customizes the text appearing in the navigation menu link for the page.
+Customizes the text appearing in the navigation menu link for the page. If not set anywhere else, Hyde will search for a title in the page content or generate one from the filename.
 
 ```yaml
 navigation:

From 059f1c6efc9125327bb2240677d7a52f0f74c6b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:45:44 +0200
Subject: [PATCH 2549/4023] Add tip about alternate syntax

---
 docs/digging-deeper/navigation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 584f355cc19..908e0f3f8d5 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -90,6 +90,8 @@ navigation:
     hidden: true
 ```
 
+**Tip:** You can also use `visible: false` to achieve the same effect.
+
 ### `group`
 
 The `group` option has a slightly different meaning depending on the type of navigation menu.

From f437ba286393fd855411edf3c33169bd0482e8e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:50:09 +0200
Subject: [PATCH 2550/4023] Reword section to be more concise

---
 docs/digging-deeper/navigation.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 908e0f3f8d5..63bede80181 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -94,9 +94,7 @@ navigation:
 
 ### `group`
 
-The `group` option has a slightly different meaning depending on the type of navigation menu.
-For the primary navigation menu, it allows you to group pages together in dropdowns.
-For the sidebar, it allows you to group pages together in the sidebar under a common heading.
+For the primary navigation menu, this groups pages together in dropdowns. For the sidebar, it groups pages under a common heading.
 
 ```yaml
 navigation:

From 9d6a5170ee54b70ac827628ce06a4f271f3475ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:54:12 +0200
Subject: [PATCH 2551/4023] Add note about grouping normalization

---
 docs/digging-deeper/navigation.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 63bede80181..a5fc35ff75d 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -101,6 +101,7 @@ navigation:
     group: "My Group"
 ```
 
+**Note:** Sidebar group keys are normalized, so `My Group` and `my-group` are equivalent.
 
 ## Config File Configuration
 

From cb24a792435810e6faf8f674007e72df4232c6e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:58:59 +0200
Subject: [PATCH 2552/4023] Update introduction to allow for section to stand
 alone

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index a5fc35ff75d..916069a4485 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -105,7 +105,7 @@ navigation:
 
 ## Config File Configuration
 
-Next up, let's look at how to customize the navigation menus using the config files.
+Let's explore how to customize navigation menus using config files:
 
 - To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
 - When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.

From b4541d2720ea799d4e39ad910e87f3151c83062f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 18:59:38 +0200
Subject: [PATCH 2553/4023] Expand abbreviation

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 916069a4485..bfa140ecbe7 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -105,7 +105,7 @@ navigation:
 
 ## Config File Configuration
 
-Let's explore how to customize navigation menus using config files:
+Let's explore how to customize navigation menus using configuration files:
 
 - To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
 - When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.

From f3e1195a811892006af358cf873f424509d9ec95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 19:05:27 +0200
Subject: [PATCH 2554/4023] Clean up the section to be easier and clearer to
 read

---
 docs/digging-deeper/navigation.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index bfa140ecbe7..addb37cbb61 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -107,11 +107,10 @@ navigation:
 
 Let's explore how to customize navigation menus using configuration files:
 
-- To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
-- When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.
+- For the main navigation menu, use `navigation` setting in the `hyde.php` config file.
+- For the sidebar, use `sidebar` setting in the `docs.php` config file.
 
-- To customize the sidebar, use the setting `sidebar.order` in the `docs.php` config.
-- When customizing the sidebar, can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
+When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
 
 ### Changing the priorities
 

From d021aca8d02980cfca30f1a9410239905e9473cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 19:07:36 +0200
Subject: [PATCH 2555/4023] Update headings to be more concise

---
 docs/digging-deeper/navigation.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index addb37cbb61..c1fd6bd89e2 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -112,7 +112,7 @@ Let's explore how to customize navigation menus using configuration files:
 
 When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
 
-### Changing the priorities
+### Changing Priorities
 
 The `navigation.order` and `sidebar.order` settings allow you to customize the order of the pages in the navigation menus.
 
@@ -145,7 +145,7 @@ The offset is added to make it easier to place pages earlier in the list using f
 ]
 ```
 
-#### Explicit syntax for changing the priorities
+#### Explicit Priority Syntax
 
 You can also specify explicit priorities by adding a value to the array key:
 

From a282b9cf1e38c8ba007378f334cf40829ee9d9c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:43:11 +0200
Subject: [PATCH 2556/4023] Update heading to be more concise

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index c1fd6bd89e2..b36b9f3c08a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -116,7 +116,7 @@ When customizing the main navigation menu, use the [route key](core-concepts#rou
 
 The `navigation.order` and `sidebar.order` settings allow you to customize the order of the pages in the navigation menus.
 
-#### Basic syntax for changing the priorities
+#### Basic Priority Syntax
 
 The cleanest way is to use the list-style syntax where each item will get the priority calculated according to its position in the list, plus an offset of `500`.
 The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.

From 143eb6dea46fd35c972fdbd2b351094aad78186f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:43:16 +0200
Subject: [PATCH 2557/4023] Update sentence to be more concise

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index b36b9f3c08a..dfa5a6a5d41 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -114,7 +114,7 @@ When customizing the main navigation menu, use the [route key](core-concepts#rou
 
 ### Changing Priorities
 
-The `navigation.order` and `sidebar.order` settings allow you to customize the order of the pages in the navigation menus.
+The `navigation.order` and `sidebar.order` settings allow you to customize the order of pages in the navigation menus.
 
 #### Basic Priority Syntax
 

From 12c055c3fddc2d0a5e8624dd6f48f1a93c4dd70a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:45:51 +0200
Subject: [PATCH 2558/4023] Rewrite introduction to be more fluent

---
 docs/digging-deeper/navigation.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index dfa5a6a5d41..b8c011200c0 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -118,8 +118,9 @@ The `navigation.order` and `sidebar.order` settings allow you to customize the o
 
 #### Basic Priority Syntax
 
-The cleanest way is to use the list-style syntax where each item will get the priority calculated according to its position in the list, plus an offset of `500`.
-The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
+A nice and simple way to define the order of pages, is to add their route keys as a simple list array. We'll then match that array order.
+
+It may be useful to know that we internally will assign a priority calculated according to its position in the list, plus an offset of `500`. The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
 
 ```php
 // filepath: config/hyde.php

From eed07c34005c2398dd890747f49c59d2df19183d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:46:24 +0200
Subject: [PATCH 2559/4023] Remove unnecessary qualifiers from examples

---
 docs/digging-deeper/navigation.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index b8c011200c0..cb61d2372f8 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -127,9 +127,9 @@ It may be useful to know that we internally will assign a priority calculated ac
 
 'navigation' => [
     'order' => [
-        'home', // Gets priority 500
-        'about', // Gets priority 501
-        'contact', // Gets priority 502
+        'home', // Priority: 500
+        'about', // Priority: 501
+        'contact', // Priority: 502
     ]
 ]
 ```
@@ -139,9 +139,9 @@ It may be useful to know that we internally will assign a priority calculated ac
 
 'sidebar' => [
     'order' => [
-        'readme', // Gets priority 500
-        'installation', // Gets priority 501
-        'getting-started', // Gets priority 502
+        'readme', // Priority: 500
+        'installation', // Priority: 501
+        'getting-started', // Priority: 502
     ]
 ]
 ```

From 58e4ed038d9d2a8ff28608314022586b0a3f5770 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:48:49 +0200
Subject: [PATCH 2560/4023] Document explicitness in introduction instead in
 the examples

---
 docs/digging-deeper/navigation.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index cb61d2372f8..f671624c2d3 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -148,16 +148,16 @@ It may be useful to know that we internally will assign a priority calculated ac
 
 #### Explicit Priority Syntax
 
-You can also specify explicit priorities by adding a value to the array key:
+You can also specify explicit priorities by adding a value to the array keys. We'll then use these exact values as the priorities.
 
 ```php
 // filepath: config/hyde.php
 
 'navigation' => [
     'order' => [
-        'home' => 10, // Gets priority 10
-        'about' => 15, // Gets priority 15
-        'contact' => 20, // Gets priority 20
+        'home' => 10,
+        'about' => 15,
+        'contact' => 20,
     ]
 ]
 ```
@@ -167,9 +167,9 @@ You can also specify explicit priorities by adding a value to the array key:
 
 'sidebar' => [
     'order' => [
-        'readme' => 10, // Gets priority 10
-        'installation' => 15, // Gets priority 15
-        'getting-started' => 20, // Gets priority 20
+        'readme' => 10,
+        'installation' => 15,
+        'getting-started' => 20,
     ]
 ]
 ```

From 6eb7084fde5b4ff3f1702998ba2d66c793c05314 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:49:16 +0200
Subject: [PATCH 2561/4023] Remove extra lines from file path labels

---
 docs/digging-deeper/navigation.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index f671624c2d3..0fceaf2c8e9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -124,7 +124,6 @@ It may be useful to know that we internally will assign a priority calculated ac
 
 ```php
 // filepath: config/hyde.php
-
 'navigation' => [
     'order' => [
         'home', // Priority: 500
@@ -136,7 +135,6 @@ It may be useful to know that we internally will assign a priority calculated ac
 
 ```php
 // filepath: config/docs.php
-
 'sidebar' => [
     'order' => [
         'readme', // Priority: 500
@@ -152,7 +150,6 @@ You can also specify explicit priorities by adding a value to the array keys. We
 
 ```php
 // filepath: config/hyde.php
-
 'navigation' => [
     'order' => [
         'home' => 10,
@@ -164,7 +161,6 @@ You can also specify explicit priorities by adding a value to the array keys. We
 
 ```php
 // filepath: config/docs.php
-
 'sidebar' => [
     'order' => [
         'readme' => 10,

From ecbbee3116bfcf03287d170797e41d85b6a7e3ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:49:37 +0200
Subject: [PATCH 2562/4023] Clean up section

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 0fceaf2c8e9..0b6e5bf62d5 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -170,14 +170,14 @@ You can also specify explicit priorities by adding a value to the array keys. We
 ]
 ```
 
-**You can of course also combine these methods if you want:**
+You could also combine these methods if desired:
 
 ```php
 // filepath: Applicable to both
 [
-    'readme' => 10, // Gets priority 10
-    'installation', // Gets priority 500
-    'getting-started', // Gets priority 501
+    'readme' => 10, // Priority: 10
+    'installation', // Priority: 500
+    'getting-started', // Priority: 501
 ]
 ```
 

From 2385ac001d25bf3cd1594c7c6eb52d6ca2378388 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:50:03 +0200
Subject: [PATCH 2563/4023] Update heading to be more concise

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 0b6e5bf62d5..3473fd75ceb 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -181,7 +181,7 @@ You could also combine these methods if desired:
 ]
 ```
 
-### Changing the menu item labels
+### Changing Menu Item Labels
 
 Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
 

From b17bfe166e3e79a0bfee8e99ef86a13134b6b8b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:50:26 +0200
Subject: [PATCH 2564/4023] Normalize file path syntax

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 3473fd75ceb..4314b911aef 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -189,7 +189,7 @@ From the Hyde config you can override the label of navigation links using the by
 This is not yet supported for the sidebar, but will be in the future.
 
 ```php
-// filepath config/hyde.php
+// filepath: config/hyde.php
 'navigation' => [
     'labels' => [
         'index' => 'Start',
@@ -204,7 +204,7 @@ Sometimes, especially if you have a lot of pages, you may want to prevent links
 To remove items from being automatically added, simply add the page's route key to the blacklist.
 
 ```php
-// filepath config/hyde.php
+// filepath: config/hyde.php
 'navigation' => [
     'exclude' => [
         '404'
@@ -220,7 +220,7 @@ When linking to an external site, you should use the `NavigationItem::create()`
 destination and label, both required. The third argument is the priority, which is optional, and defaults to `500`.
 
 ```php
-// filepath config/hyde.php
+// filepath: config/hyde.php
 use Hyde\Framework\Features\Navigation\NavigationItem;
 
 'navigation' => [
@@ -241,7 +241,7 @@ Simplified, this will then be rendered as follows:
 Within the Hyde config you can configure how subdirectories should be displayed in the menu.
 
 ```php
-// filepath config/hyde.php
+// filepath: config/hyde.php
 'navigation' => [
     'subdirectory_display' => 'dropdown'
 ]

From 1e32a89d5383fcc5ee16d6db1aba1cd2fae36f08 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:53:44 +0200
Subject: [PATCH 2565/4023] Remove introductory line offering no real
 information

---
 docs/digging-deeper/navigation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4314b911aef..8c4d98f340a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -200,8 +200,7 @@ This is not yet supported for the sidebar, but will be in the future.
 
 ### Excluding Items (Blacklist)
 
-Sometimes, especially if you have a lot of pages, you may want to prevent links from showing up in the main navigation menu.
-To remove items from being automatically added, simply add the page's route key to the blacklist.
+To prevent specific pages from showing up in the main navigation menu, simply add their route keys to the blacklist:
 
 ```php
 // filepath: config/hyde.php

From 83bccaec3f527cea8354408a77518d74692eaf5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:54:27 +0200
Subject: [PATCH 2566/4023] Revert "Remove introductory line offering no real
 information"

This reverts commit 1e32a89d5383fcc5ee16d6db1aba1cd2fae36f08.
---
 docs/digging-deeper/navigation.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 8c4d98f340a..4314b911aef 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -200,7 +200,8 @@ This is not yet supported for the sidebar, but will be in the future.
 
 ### Excluding Items (Blacklist)
 
-To prevent specific pages from showing up in the main navigation menu, simply add their route keys to the blacklist:
+Sometimes, especially if you have a lot of pages, you may want to prevent links from showing up in the main navigation menu.
+To remove items from being automatically added, simply add the page's route key to the blacklist.
 
 ```php
 // filepath: config/hyde.php

From aaeff4bd4f6fd6e2fbf4f35a4eed313d2f436cb8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:56:52 +0200
Subject: [PATCH 2567/4023] Clean up introduction

---
 docs/digging-deeper/navigation.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4314b911aef..34c7f79d62d 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -200,8 +200,9 @@ This is not yet supported for the sidebar, but will be in the future.
 
 ### Excluding Items (Blacklist)
 
-Sometimes, especially if you have a lot of pages, you may want to prevent links from showing up in the main navigation menu.
-To remove items from being automatically added, simply add the page's route key to the blacklist.
+When you have a lot of pages, it may be useful to prevent links from being added to the main navigation menu.
+
+To exclude items from being added, simply add the page's route key to the navigation blacklist in the Hyde config:
 
 ```php
 // filepath: config/hyde.php

From 984a02d9115e7bec8c1c284a2fa01074965f3609 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 20:57:36 +0200
Subject: [PATCH 2568/4023] Rewrite section to be more fluent

---
 docs/digging-deeper/navigation.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 34c7f79d62d..ef7608ef0fe 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -185,8 +185,7 @@ You could also combine these methods if desired:
 
 Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
 
-From the Hyde config you can override the label of navigation links using the by mapping the route key to the desired title.
-This is not yet supported for the sidebar, but will be in the future.
+If you're not happy with these, it's easy to override navigation link labels by mapping the route key to the desired title in the Hyde config:
 
 ```php
 // filepath: config/hyde.php
@@ -198,6 +197,8 @@ This is not yet supported for the sidebar, but will be in the future.
 ]
 ```
 
+**Note:** This feature is not yet supported for the sidebar.
+
 ### Excluding Items (Blacklist)
 
 When you have a lot of pages, it may be useful to prevent links from being added to the main navigation menu.

From 0f925e14d9dfa7c6b2c1b7358dfb07bd30cfb834 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:01:34 +0200
Subject: [PATCH 2569/4023] Simplify custom navigation link section
 introduction

---
 docs/digging-deeper/navigation.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index ef7608ef0fe..2728eaa4a87 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -216,10 +216,7 @@ To exclude items from being added, simply add the page's route key to the naviga
 
 ### Adding Custom Navigation Menu Links
 
-You can easily add custom navigation menu links similar to how we add Authors. Simply add a `NavigationItem` model to the `navigation.custom` array.
-
-When linking to an external site, you should use the `NavigationItem::create()` method facade. The first two arguments are the
-destination and label, both required. The third argument is the priority, which is optional, and defaults to `500`.
+You can easily add custom navigation menu links in the Hyde config:
 
 ```php
 // filepath: config/hyde.php

From 13c5ef478a74a4b95dfb12dab8e2acec06035eb0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:06:12 +0200
Subject: [PATCH 2570/4023] Update custom navigation links example to use new
 facade method

---
 docs/digging-deeper/navigation.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 2728eaa4a87..9f8e04ee4c5 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -220,11 +220,15 @@ You can easily add custom navigation menu links in the Hyde config:
 
 ```php
 // filepath: config/hyde.php
-use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Facades\Navigation;
 
 'navigation' => [
     'custom' => [
-        NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
+        Navigation::item(
+            destination: 'https://github.com/hydephp/hyde', // Required
+            label: 'GitHub', // Optional, defaults to the destination value
+            priority: 200 // Optional, defaults to 500
+        ),
     ]
 ]
 ```

From c186ae0b6a3b54d336ae9e77e0767d1788a9d1c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:06:32 +0200
Subject: [PATCH 2571/4023] Add tip on named arguments

---
 docs/digging-deeper/navigation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 9f8e04ee4c5..0f3662a047e 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -233,6 +233,8 @@ use Hyde\Facades\Navigation;
 ]
 ```
 
+**Tip:** While named arguments are used in the example for clarity, they are not required.
+
 Simplified, this will then be rendered as follows:
 
 ```html

From b2f20575dc396ecf0ec56cc89e1961fb1ce3cc0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:07:01 +0200
Subject: [PATCH 2572/4023] Remove rendered HTML example

Not sure how much value this offers
---
 docs/digging-deeper/navigation.md | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 0f3662a047e..8735c6de583 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -235,11 +235,6 @@ use Hyde\Facades\Navigation;
 
 **Tip:** While named arguments are used in the example for clarity, they are not required.
 
-Simplified, this will then be rendered as follows:
-
-```html
-<a href="https://github.com/hydephp/hyde">GitHub</a>
-```
 
 ### Configure subdirectory handling
 

From 6ebd643e389fae46bd1e79812c5c188aee0a8c23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:07:16 +0200
Subject: [PATCH 2573/4023] Normalize heading

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 8735c6de583..c68fff88868 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -236,7 +236,7 @@ use Hyde\Facades\Navigation;
 **Tip:** While named arguments are used in the example for clarity, they are not required.
 
 
-### Configure subdirectory handling
+### Configure Subdirectory Display
 
 Within the Hyde config you can configure how subdirectories should be displayed in the menu.
 

From 7c2f90cfffcf41a25fa2c4e9ecdeeaaf4fb361c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:12:10 +0200
Subject: [PATCH 2574/4023] Improve the subdirectory display section

---
 docs/digging-deeper/navigation.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index c68fff88868..04c575f296c 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -238,7 +238,7 @@ use Hyde\Facades\Navigation;
 
 ### Configure Subdirectory Display
 
-Within the Hyde config you can configure how subdirectories should be displayed in the menu.
+You can configure how subdirectories should be displayed in the menu:
 
 ```php
 // filepath: config/hyde.php
@@ -247,9 +247,10 @@ Within the Hyde config you can configure how subdirectories should be displayed
 ]
 ```
 
-Dropdown means that pages in subdirectories will be displayed in a dropdown menu,
-while `flat` means that pages in subdirectories will be displayed as individual items in the menu.
-Hidden means that pages in subdirectories will not be displayed in the menu at all.
+**Supported Options:**
+- `dropdown`: Pages in subdirectories are displayed in a dropdown menu
+- `hidden`: Pages in subdirectories are not displayed at all the menus
+- `flat`: Pages in subdirectories are displayed as individual items
 
 ### Automatic menu groups
 

From cc01ba341b1fee40a799f3b0991636fa291b958e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:31:26 +0200
Subject: [PATCH 2575/4023] Normalize heading

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 04c575f296c..cf84a14eeb0 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -252,7 +252,7 @@ You can configure how subdirectories should be displayed in the menu:
 - `hidden`: Pages in subdirectories are not displayed at all the menus
 - `flat`: Pages in subdirectories are displayed as individual items
 
-### Automatic menu groups
+### Automatic Menu Groups
 
 HydePHP has a neat feature to automatically place pages in dropdowns based on subdirectories.
 

From 03262ef357218c21792ac7ee17efe13b18540821 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:57:28 +0200
Subject: [PATCH 2576/4023] Clean up the subdirectory grouping documentation

---
 docs/digging-deeper/navigation.md | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index cf84a14eeb0..dd55c32879c 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -254,15 +254,14 @@ You can configure how subdirectories should be displayed in the menu:
 
 ### Automatic Menu Groups
 
-HydePHP has a neat feature to automatically place pages in dropdowns based on subdirectories.
+A handy feature HydePHP has is that it can automatically place pages in dropdowns based on subdirectory structures.
 
-#### Automatic navigation menu dropdowns
+#### Automatic Navigation Menu Dropdowns
 
-For pages that can be in the main site menu, this feature needs to be enabled in the `hyde.php` config file.
+Enable this feature in the `hyde.php` config file by setting the `subdirectory_display` key to `dropdown`.
 
 ```php
-// filepath config/hyde.php
-
+// filepath: config/hyde.php
 'navigation' => [
     'subdirectory_display' => 'dropdown',
 ],
@@ -270,20 +269,18 @@ For pages that can be in the main site menu, this feature needs to be enabled in
 
 Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
 
-#### Automatic documentation sidebar grouping
+#### Automatic Documentation Sidebar Grouping
 
-This feature works similarly to the automatic navigation menu dropdowns, but instead places the sidebar items in named groups.
-This feature is enabled by default, so you only need to place your pages in subdirectories to have them grouped.
+This feature is always enabled for documentation pages. Simply place your pages in subdirectories to have them grouped in the sidebar.
 
 For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
 
 >info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
 
-#### Dropdown menu notes
+#### Dropdown Menu Notes
 
-Here are some things to keep in mind when using dropdown menus, regardless of the configuration:
-- Dropdowns take priority over standard items. So if you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
-    - For example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost.
+- Dropdowns take priority over standard items. If you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
+- Example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost, so please keep this in mind when using this feature.
 
 ## Numerical Prefix Navigation Ordering
 

From 2d1b20549ec623caf4d326385a55037e074a7af2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 21:58:39 +0200
Subject: [PATCH 2577/4023] Clean up the Navigation API section to be more
 concise

---
 docs/digging-deeper/navigation.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index dd55c32879c..16cb6108e23 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -373,7 +373,6 @@ use Hyde\Framework\Features\Navigation\NavigationGroup;
 
 ## The Navigation API
 
-If you want to interact with the site navigation programmatically, or if you want to create complex custom menus, you can do so through the new Navigation API.
-For most cases you don't need this, as Hyde creates the navigation for you. But it can be useful for advanced users and package developers.
+For advanced users and package developers, Hyde offers a Navigation API for programmatic interaction with site navigation. This API consists of a set of PHP classes allowing fluent interaction with navigation menus.
 
-The Navigation API consists of a set of PHP classes, allowing you to fluently interact with the navigation menus. You can learn more about the API in the [Navigation API](navigation-api) documentation.
+For more detailed information about the API, refer to the [Navigation API](navigation-api) documentation.

From 5c1b73f7f8029b1dbe73f3b826d0c6b04d715545 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:00:56 +0200
Subject: [PATCH 2578/4023] Shorten the introduction to be more concise

---
 docs/digging-deeper/navigation.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 16cb6108e23..716e5a0a308 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -284,9 +284,7 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 ## Numerical Prefix Navigation Ordering
 
-HydePHP v2 introduces a new feature that allows navigation items to be ordered based on a numerical prefix in the filename.
-This is a great way to control the ordering of pages in both the primary navigation menu and the documentation sidebar,
-as your file structure will match the order of the pages in the navigation menus.
+HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
 
 For example, the following will have the same order in the navigation menu as in a file explorer:
 

From cfffe1d3553fcff66e31648255c73d92f7c9bd4c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:01:40 +0200
Subject: [PATCH 2579/4023] Improve information presented in example
 introduction

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 716e5a0a308..c6d52ef3aa3 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -286,7 +286,7 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
 
-For example, the following will have the same order in the navigation menu as in a file explorer:
+This has the great benefit of matching the navigation menu layout with the file structure view, and works especially great with subdirectory-based navigation grouping.
 
 ```shell
 _pages/

From f353b372410648ba0ac4b0410fc3dbaf006edb2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:03:11 +0200
Subject: [PATCH 2580/4023] Remove unnecessary information from example

---
 docs/digging-deeper/navigation.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index c6d52ef3aa3..032e3223d1b 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -290,9 +290,9 @@ This has the great benefit of matching the navigation menu layout with the file
 
 ```shell
 _pages/
-  01-home.md # Gets priority 1, putting it first (will be saved to _site/index.html)
-  02-about.md # Gets priority 2, putting it second (will be saved to _site/about.html)
-  03-contact.md # Gets priority 3, putting it third (will be saved to _site/contact.html)
+  01-home.md     # Priority: 1 (saved to _site/index.html)
+  02-about.md    # Priority: 2 (saved to _site/about.html)
+  03-contact.md  # Priority: 3 (saved to _site/contact.html)
 ```
 
 Hyde will then parse the number from the filename and use it as the priority for the page in the navigation menus.

From 2ff20cdcbda7e79708ccdcb2dd34026cfb8c8fe4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:03:24 +0200
Subject: [PATCH 2581/4023] Merge in prefix stripping information into line

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 032e3223d1b..b4b88b04ca6 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -295,7 +295,7 @@ _pages/
   03-contact.md  # Priority: 3 (saved to _site/contact.html)
 ```
 
-Hyde will then parse the number from the filename and use it as the priority for the page in the navigation menus.
+As you can seem Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
 
 ### Keep in mind
 

From 3e6b3b009a1252f337db5a7229a673fc67226ec4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:03:38 +0200
Subject: [PATCH 2582/4023] Rename heading

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index b4b88b04ca6..0c83b1f73c3 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -297,7 +297,7 @@ _pages/
 
 As you can seem Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
 
-### Keep in mind
+### Important Notes
 
 Here are some things to keep in mind, especially if you mix numerical prefix ordering with other ordering methods:
 

From f7e71fd910d4eabfc3bbc020046aca171f0284f3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:05:19 +0200
Subject: [PATCH 2583/4023] Remove introduction containing discouraged usage

---
 docs/digging-deeper/navigation.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 0c83b1f73c3..47608ed2385 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -299,7 +299,6 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
 
 ### Important Notes
 
-Here are some things to keep in mind, especially if you mix numerical prefix ordering with other ordering methods:
 
 1. The numerical prefix will still be part of the page identifier, but it will be stripped from the route key.
     - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.

From f18507f0db19aa250cfc83de6ff4e055afcf54c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:06:25 +0200
Subject: [PATCH 2584/4023] Remove extra newline

---
 docs/digging-deeper/navigation.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 47608ed2385..00796c89872 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -299,7 +299,6 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
 
 ### Important Notes
 
-
 1. The numerical prefix will still be part of the page identifier, but it will be stripped from the route key.
     - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.
 2. You can delimit the numerical prefix with either a dash or an underscore.

From ee0e57f695c3651c366cecc863704d48c553b9cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:06:50 +0200
Subject: [PATCH 2585/4023] Use more concise language

---
 docs/digging-deeper/navigation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 00796c89872..67d7c9df638 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -299,11 +299,11 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
 
 ### Important Notes
 
-1. The numerical prefix will still be part of the page identifier, but it will be stripped from the route key.
-    - For example: `_pages/01-home.md` will have the route key `home` and the page identifier `01-home`.
+1. The numerical prefix remains part of the page identifier but is stripped from the route key.
+   For example: `_pages/01-home.md` has route key `home` and page identifier `01-home`.
 2. You can delimit the numerical prefix with either a dash or an underscore.
-    - For example: `_pages/01-home.md` and `_pages/01_home.md` are both valid.
-3. The leading zeroes are optional, so `_pages/1-home.md` is also valid.
+   For example: Both `_pages/01-home.md` and `_pages/01_home.md` are valid.
+3. Leading zeros are optional. `_pages/1-home.md` is equally valid.
 
 ### Using numerical prefix ordering in subdirectories
 

From 23ff410807405bed7e5f908d631202f780b76a79 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:07:07 +0200
Subject: [PATCH 2586/4023] Normalize heading

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 67d7c9df638..1a2fd68bf90 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -305,7 +305,7 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
    For example: Both `_pages/01-home.md` and `_pages/01_home.md` are valid.
 3. Leading zeros are optional. `_pages/1-home.md` is equally valid.
 
-### Using numerical prefix ordering in subdirectories
+### Using Numerical Prefix Ordering in Subdirectories
 
 The numerical prefix ordering feature works great when using the automatic subdirectory-based grouping for navigation menu dropdowns and documentation sidebar categories.
 

From a505a0b626b2ba62e62128d9ef31a4687d98a474 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:08:05 +0200
Subject: [PATCH 2587/4023] Use more concise wording

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1a2fd68bf90..0f6cd5f7573 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -313,7 +313,7 @@ This integration has two main features to consider:
 1. You can use numerical prefixes in subdirectories to control the order of dropdowns.
 2. The ordering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
 
-Here is an example structure of how you may want to organize a documentation site:
+Here is an example structure of how could organize a documentation site:
 
 ```shell
 _docs/

From a32354c0d66607daa013a227ef9c2a1661e166a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:08:16 +0200
Subject: [PATCH 2588/4023] Use more concise wording

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 0f6cd5f7573..abed3eb3432 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -307,7 +307,7 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
 
 ### Using Numerical Prefix Ordering in Subdirectories
 
-The numerical prefix ordering feature works great when using the automatic subdirectory-based grouping for navigation menu dropdowns and documentation sidebar categories.
+This feature integrates well with automatic subdirectory-based grouping for navigation menu dropdowns and documentation sidebar categories:
 
 This integration has two main features to consider:
 1. You can use numerical prefixes in subdirectories to control the order of dropdowns.

From 995bd8148021a0141cf07f4a3fce52f91f4f5c4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:10:20 +0200
Subject: [PATCH 2589/4023] Update section to be more concise

---
 docs/digging-deeper/navigation.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index abed3eb3432..9d82c7df5fa 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -307,11 +307,10 @@ As you can seem Hyde parses the number from the filename and uses it as the prio
 
 ### Using Numerical Prefix Ordering in Subdirectories
 
-This feature integrates well with automatic subdirectory-based grouping for navigation menu dropdowns and documentation sidebar categories:
+This feature integrates well with automatic subdirectory-based navigation grouping. Here are two useful tips:
 
-This integration has two main features to consider:
-1. You can use numerical prefixes in subdirectories to control the order of dropdowns.
-2. The ordering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
+1. You can use numerical prefixes in subdirectories to control the dropdown/sidebar order.
+2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
 
 Here is an example structure of how could organize a documentation site:
 

From 23e610d104bdd95adcfa3f901ae10b573af398df Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:11:28 +0200
Subject: [PATCH 2590/4023] Remove section detailing discouraged use with no
 real benefit

---
 docs/digging-deeper/navigation.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 9d82c7df5fa..7fefa32f269 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -338,7 +338,6 @@ You can disable this feature by setting the `numerical_page_ordering` setting to
 'numerical_page_ordering' => false,
 ```
 
-While it's not recommended, as you lose out on the convenience of the automatic ordering, any front matter priority settings will override the numerical prefix ordering if you for some reason need to.
 
 ## Digging Deeper into the internals
 

From e8639f487e9f7e3760a4958567e100a6979c2f64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:12:14 +0200
Subject: [PATCH 2591/4023] Reword section introduction

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 7fefa32f269..e7702c4926a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -330,7 +330,7 @@ _docs/
 
 ### Customization
 
-You can disable this feature by setting the `numerical_page_ordering` setting to `false` in the `hyde.php` config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
+If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
 
 ```php
 // filepath config/hyde.php

From f0e2ff3330d1871bd920fc7cd03df286ebcdd660 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:12:24 +0200
Subject: [PATCH 2592/4023] Normalize file path label syntax

---
 docs/digging-deeper/navigation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index e7702c4926a..bed7f3d1488 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -333,8 +333,7 @@ _docs/
 If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
 
 ```php
-// filepath config/hyde.php
-
+// filepath: config/hyde.php
 'numerical_page_ordering' => false,
 ```
 

From 14e5c4c0d7fee93855ccc3aebbd574a3baf4103d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:12:36 +0200
Subject: [PATCH 2593/4023] Normalize heading formatting

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index bed7f3d1488..f5cf1737888 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -338,7 +338,7 @@ If you're not interested in using numerical prefix ordering, you can disable it
 ```
 
 
-## Digging Deeper into the internals
+## Digging Deeper into the Internals
 
 While not required to know, you may find it interesting to learn more about how the navigation is handled internally. Here is a high level overview,
 but you can find more detailed information in the [Navigation API](navigation-api) documentation.

From 519002a35d91145f61ad259d0b13036402d73dfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:13:43 +0200
Subject: [PATCH 2594/4023] Remove newline

---
 docs/digging-deeper/navigation.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index f5cf1737888..e809f33d418 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -337,7 +337,6 @@ If you're not interested in using numerical prefix ordering, you can disable it
 'numerical_page_ordering' => false,
 ```
 
-
 ## Digging Deeper into the Internals
 
 While not required to know, you may find it interesting to learn more about how the navigation is handled internally. Here is a high level overview,

From bd2f05a9b8e05df2c30c0e28a1136b674b1b3c44 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:15:11 +0200
Subject: [PATCH 2595/4023] Merge introduction sections

---
 docs/digging-deeper/navigation.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index e809f33d418..949c92cf8e8 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -339,8 +339,7 @@ If you're not interested in using numerical prefix ordering, you can disable it
 
 ## Digging Deeper into the Internals
 
-While not required to know, you may find it interesting to learn more about how the navigation is handled internally. Here is a high level overview,
-but you can find more detailed information in the [Navigation API](navigation-api) documentation.
+While not essential, understanding the internal workings of the navigation system can be as beneficial as it's interesting. Here's a quick high-level overview of the [Navigation API](navigation-api).
 
 The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class. Both extend the same base `NavigationMenu` class.
 

From 9206cf410dc7075f8c111e8a9a3f77bf4c576eec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:15:48 +0200
Subject: [PATCH 2596/4023] Add subheading

---
 docs/digging-deeper/navigation.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 949c92cf8e8..4c50dfee198 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -341,6 +341,8 @@ If you're not interested in using numerical prefix ordering, you can disable it
 
 While not essential, understanding the internal workings of the navigation system can be as beneficial as it's interesting. Here's a quick high-level overview of the [Navigation API](navigation-api).
 
+### Navigation Menu Classes
+
 The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class. Both extend the same base `NavigationMenu` class.
 
 ```php

From 17bf95fa9bbeca9c5ec33812ddf0b1fd089e3846 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:16:43 +0200
Subject: [PATCH 2597/4023] Reword and summarize parts of the internals
 overview

---
 docs/digging-deeper/navigation.md | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4c50dfee198..1f037908a70 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -343,7 +343,7 @@ While not essential, understanding the internal workings of the navigation syste
 
 ### Navigation Menu Classes
 
-The main navigation menu is the `MainNavigationMenu` class, and the documentation sidebar is the `DocumentationSidebar` class. Both extend the same base `NavigationMenu` class.
+The main navigation menu uses the `MainNavigationMenu` class, while the documentation sidebar uses the `DocumentationSidebar` class. Both extend the base `NavigationMenu` class:
 
 ```php
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
@@ -351,13 +351,9 @@ use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenu;
 ```
 
-Within the base `NavigationMenu` class, you will find the main logic for how the menus are generated,
-while the child implementations contain the extra logic tailored for their specific use cases.
+The base `NavigationMenu` class contains the main logic for menu generation, while child implementations contain extra logic for specific use cases.
 
-All the navigation menus store the menu items in their `$items` collection containing instances of the `NavigationItem` class.
-
-The `NavigationItem` class is a simple class that contains the label and URL of the menu item and is used to represent each item in the menu.
-Dropdowns are represented by `NavigationGroup` instances, which extend the `NavigationMenu` class and contain a collection of additional `NavigationItem` instances.
+All navigation menus store items in their `$items` collection, containing instances of the `NavigationItem` class. Dropdowns are represented by `NavigationGroup` instances, which extend the `NavigationMenu` class and contain additional `NavigationItem` instances:
 
 ```php
 use Hyde\Framework\Features\Navigation\NavigationItem;

From b47bae066476f74577915572be52a51ebdddee72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 11 Jul 2024 22:18:47 +0200
Subject: [PATCH 2598/4023] Link to the related class

---
 packages/framework/src/Facades/Navigation.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 1f64d809f3c..2eb846b0613 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -16,7 +16,7 @@ class Navigation
     /**
      * Configuration helper method to define a new navigation item, with better IDE support.
      *
-     * The returned array will then be used by the framework to create a new NavigationItem instance.
+     * The returned array will then be used by the framework to create a new NavigationItem instance. {@see \Hyde\Framework\Features\Navigation\NavigationItem}
      *
      * @see https://hydephp.com/docs/2.x/navigation-api
      *

From 901b810ef1f0846b1cb4bc30780ba2a2f1d568c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 10:42:54 +0200
Subject: [PATCH 2599/4023] Create Claude draft

---
 context.php                       | 330 ++++++++++++++++++++++++++
 docs/digging-deeper/navigation.md | 371 ++++++++----------------------
 2 files changed, 428 insertions(+), 273 deletions(-)
 create mode 100644 context.php

diff --git a/context.php b/context.php
new file mode 100644
index 00000000000..b338e14ca4d
--- /dev/null
+++ b/context.php
@@ -0,0 +1,330 @@
+
+    /*
+    |--------------------------------------------------------------------------
+    | Navigation Menu Configuration
+    |--------------------------------------------------------------------------
+    |
+    | If you are looking to customize the main navigation menu, this is the place!
+    |
+    | All these settings uses Route Keys to identify the page you want to configure.
+    | A route key is simply the URL path to the page, without the file extension.
+    | So `_site/posts/hello-world.html` has the route key 'posts/hello-world'.
+    |
+    */
+
+    // OLD
+    
+    'navigation' => [
+        // This configuration sets the priorities used to determine the order of the menu.
+        // The default values have been added below for reference and easy editing.
+        // The array key is the page's route key, the value is the priority.
+        // Lower values show up first in the menu. The default is 999.
+        'order' => [
+            'index' => 0,
+            'posts' => 10,
+            'docs/index' => 100,
+        ],
+
+        // In case you want to customize the labels for the menu items, you can do so here.
+        // Simply add the route key as the array key, and the label as the value.
+        'labels' => [
+            'index' => 'Home',
+            'docs/index' => 'Docs',
+        ],
+
+        // These are the route keys of pages that should not show up in the navigation menu.
+        'exclude' => [
+            '404',
+        ],
+
+        // Any extra links you want to add to the navigation menu can be added here.
+        // To get started quickly, you can uncomment the defaults here.
+        // See the documentation link above for more information.
+        'custom' => [
+            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
+        ],
+
+        // How should pages in subdirectories be displayed in the menu?
+        // You can choose between 'dropdown', 'flat', and 'hidden'.
+        'subdirectories' => 'hidden',
+    ],
+
+
+    // NEW (creates an array exactly like the one above, but with a more fluent API that supports better autocomplete)
+
+    'navigation' => Navigation::configure()
+        ->setPagePriorities([
+            'index' => 0,
+            'posts' => 10,
+            'docs/index' => 100,
+        ])
+        ->setPageLabels([
+            'index' => 'Home',
+            'docs/index' => 'Docs',
+        ])
+        ->excludePages([
+            '404',
+        ])
+        ->addNavigationItems([
+            // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
+        ])
+        ->setSubdirectoryDisplayMode('hidden'),
+
+    // All of these options work in the yaml config (this is just an example, please use the same example data as above in the docs)
+    hyde:
+        navigation:
+            custom:
+                - destination: 'https://example.com'
+                label: 'Example'
+                priority: 100
+                attributes:
+                    class: 'example'
+                - destination: 'about'
+                label: 'About Us'
+                priority: 200
+                attributes:
+                    class: 'about'
+                    id: 'about'
+                - destination: 'contact'
+                label: 'Contact'
+                priority: 300
+                attributes:
+                    target: '_blank'
+                    rel: 'noopener noreferrer'
+                    foo: 'bar'
+
+
+// relevant code snippets
+
+<?php
+
+/**
+ * General facade for navigation features.
+ */
+class Navigation
+{
+    /**
+     * Configuration helper method to define a new navigation item, with better IDE support.
+     *
+     * The returned array will then be used by the framework to create a new NavigationItem instance. {@see \Hyde\Framework\Features\Navigation\NavigationItem}
+     *
+     * @see https://hydephp.com/docs/2.x/navigation-api
+     *
+     * @param  string<\Hyde\Support\Models\RouteKey>|string  $destination  Route key, or an external URI.
+     * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
+     * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
+     * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
+     * @return array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}
+     */
+    public static function item(string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): array
+    {
+        return compact('destination', 'label', 'priority', 'attributes');
+    }
+
+    /**
+     * Configuration helper method to define the navigation menu configuration with better IDE support.
+     *
+     * The builder is an array object that will be used by the framework to set the navigation menu configuration.
+     *
+     * @experimental This method is experimental and may change or be removed before the final release.
+     */
+    public static function configure(): NavigationMenuConfigurationBuilder
+    {
+        return new NavigationMenuConfigurationBuilder();
+    }
+}
+
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Navigation;
+
+use TypeError;
+use ArrayObject;
+use Illuminate\Contracts\Support\Arrayable;
+
+/**
+ * Configuration helper class to define the navigation menu configuration with better IDE support.
+ *
+ * The configured data will then be used by the framework to set the navigation menu configuration.
+ *
+ * @see \Hyde\Facades\Navigation::configure()
+ *
+ * @experimental This class is experimental and may change or be removed before the final release.
+ */
+class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
+{
+    /**
+     * Set the order of the navigation items.
+     *
+     * Either define a map of route keys to priorities, or just a list of route keys and we'll try to match that order.
+     *
+     * @param  array<string, int>|array<string>  $order
+     * @return $this
+     */
+    public function setPagePriorities(array $order): static
+    {
+        $this['order'] = $order;
+
+        return $this;
+    }
+
+    /**
+     * Set the labels for the navigation items.
+     *
+     * Each key should be a route key, and the value should be the label to display.
+     *
+     * @param  array<string, string>  $labels
+     * @return $this
+     */
+    public function setPageLabels(array $labels): static
+    {
+        $this['labels'] = $labels;
+
+        return $this;
+    }
+
+    /**
+     * Exclude certain items from the navigation.
+     *
+     * Each item should be a route key for the page to exclude.
+     *
+     * @param  array<string>  $exclude
+     * @return $this
+     */
+    public function excludePages(array $exclude): static
+    {
+        $this['exclude'] = $exclude;
+
+        return $this;
+    }
+
+    /**
+     * Add custom items to the navigation.
+     *
+     * @example `[Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200, ['target' => '_blank'])]`
+     *
+     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
+     * @return $this
+     */
+    public function addNavigationItems(array $custom): static
+    {
+        $this['custom'] = $custom;
+
+        return $this;
+    }
+
+    /**
+     * Set the display mode for pages in subdirectories.
+     *
+     * You can choose between 'dropdown', 'flat', and 'hidden'. The default is 'hidden'.
+     *
+     * @param  'dropdown'|'flat'|'hidden'  $displayMode
+     * @return $this
+     */
+    public function setSubdirectoryDisplayMode(string $displayMode): static
+    {
+        self::assertType(['dropdown', 'flat', 'hidden'], $displayMode);
+
+        $this['subdirectory_display'] = $displayMode;
+
+        return $this;
+    }
+
+    /**
+     * Hide pages in subdirectories from the navigation.
+     *
+     * @experimental This method is experimental and may change or be removed before the final release.
+     *
+     * @return $this
+     */
+    public function hideSubdirectoriesFromNavigation(): static
+    {
+        return $this->setSubdirectoryDisplayMode('hidden');
+    }
+
+    /**
+     * Get the instance as an array.
+     *
+     * @return array{order: array<string, int>, labels: array<string, string>, exclude: array<string>, custom: array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>, subdirectory_display: string}
+     */
+    public function toArray(): array
+    {
+        return $this->getArrayCopy();
+    }
+
+    /** @experimental May be moved to a separate helper class in the future. */
+    protected static function assertType(array $types, string $value): void
+    {
+        if (! in_array($value, $types)) {
+            throw new TypeError('Value must be one of: '.implode(', ', $types));
+        }
+    }
+}
+
+
+// The docs config has not been updated to use the builder api
+
+    /*
+    |--------------------------------------------------------------------------
+    | Sidebar Settings
+    |--------------------------------------------------------------------------
+    |
+    | The Hyde Documentation Module comes with a fancy Sidebar that is
+    | automatically populated with links to your documentation pages.
+    | Here, you can configure its behavior, content, look and feel.
+    |
+    */
+
+    'sidebar' => [
+        // The title in the sidebar header
+        'header' => env('SITE_NAME', 'HydePHP').' Docs',
+
+        // When using a grouped sidebar, should the groups be collapsible?
+        'collapsible' => true,
+
+        // A string of Markdown to show in the footer. Set to `false` to disable.
+        'footer' => '[Back to home page](../)',
+
+        /*
+        |--------------------------------------------------------------------------
+        | Sidebar Page Order
+        |--------------------------------------------------------------------------
+        |
+        | In the generated Documentation pages the navigation links in the sidebar
+        | default to sort alphabetically. You can reorder the page identifiers
+        | in the list below, and the links will get sorted in that order.
+        |
+        | The items will get a priority of 500 plus the order its found in the list.
+        | Pages without a priority will fall back to the default priority of 999.
+        |
+        | You can also set explicit priorities in front matter or by specifying
+        | a value to the array key in the list to override the inferred value.
+        |
+        */
+
+        'order' => [
+            'readme',
+            'installation',
+            'getting-started',
+        ],
+
+        /*
+        |--------------------------------------------------------------------------
+        | Table of Contents Settings
+        |--------------------------------------------------------------------------
+        |
+        | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
+        | has a Table of Contents included. Here, you can configure its behavior,
+        | content, look and feel. You can also disable the feature completely.
+        |
+        */
+
+        'table_of_contents' => [
+            'enabled' => true,
+            'min_heading_level' => 2,
+            'max_heading_level' => 4,
+        ],
+
+    ],
\ No newline at end of file
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1f037908a70..36482372801 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -37,331 +37,156 @@ Here's an overview of what you can customize in your navigation menus:
 - Item visibility: Choose to hide or show pages in the menu
 - Item grouping: Group pages together in dropdowns or sidebar categories
 
-### Customization Methods
+## Configuration Methods
 
 Hyde provides multiple ways to customize navigation menus to suit your needs:
 
 1. Front matter data in Markdown and Blade page files, applicable to all menu types
-2. Configuration in the `hyde` config file for main navigation items
-3. Configuration in the `docs` config file for documentation sidebar items
+2. Configuration in the `hyde.php` or `hyde.yml` config file for main navigation items
+3. Configuration in the `docs.php` config file for documentation sidebar items
 
-Keep in mind that front matter data overrides dynamically inferred or config-defined priorities. While useful for quick one-off changes on small sites, it can make reordering items later on more challenging as you can't see the entire structure at once.
+The new builder pattern in the configuration allows for a more fluent and IDE-friendly way to customize navigation. However, the old array-based method still works, as the navigation builder is an `ArrayObject` and can be used as an array.
 
-Additionally, general options for the entire navigation menus are also available in the `hyde` and `docs` config files.
+### Using the Navigation Builder
 
-## Front Matter Configuration
-
-Front matter options allow per-page customization of navigation menus. Here's a quick reference of available options:
-
-```yaml
-navigation:
-    label: string  # The displayed text in the navigation item link
-    priority: int  # The page's priority for ordering (lower means higher up/first)
-    hidden: bool   # Whether the page should be hidden from the navigation menu
-    group: string  # Set main menu dropdown or sidebar group key
-```
-
-You only need to specify the keys you want to customize.
-
-### `label`
-
-Customizes the text appearing in the navigation menu link for the page. If not set anywhere else, Hyde will search for a title in the page content or generate one from the filename.
-
-```yaml
-navigation:
-    label: "My Custom Label"
-```
-
-### `priority`
-
-Controls the order in which the page appears in the navigation menu.
-
-```yaml
-navigation:
-    priority: 10
-```
-
-### `hidden`
-
-Determines if the page appears in the navigation menu.
-
-```yaml
-navigation:
-    hidden: true
-```
-
-**Tip:** You can also use `visible: false` to achieve the same effect.
-
-### `group`
-
-For the primary navigation menu, this groups pages together in dropdowns. For the sidebar, it groups pages under a common heading.
-
-```yaml
-navigation:
-    group: "My Group"
-```
-
-**Note:** Sidebar group keys are normalized, so `My Group` and `my-group` are equivalent.
-
-## Config File Configuration
-
-Let's explore how to customize navigation menus using configuration files:
-
-- For the main navigation menu, use `navigation` setting in the `hyde.php` config file.
-- For the sidebar, use `sidebar` setting in the `docs.php` config file.
-
-When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
-
-### Changing Priorities
-
-The `navigation.order` and `sidebar.order` settings allow you to customize the order of pages in the navigation menus.
-
-#### Basic Priority Syntax
-
-A nice and simple way to define the order of pages, is to add their route keys as a simple list array. We'll then match that array order.
-
-It may be useful to know that we internally will assign a priority calculated according to its position in the list, plus an offset of `500`. The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
+To use the new builder pattern, you can configure your navigation in the `hyde.php` file like this:
 
 ```php
-// filepath: config/hyde.php
-'navigation' => [
-    'order' => [
-        'home', // Priority: 500
-        'about', // Priority: 501
-        'contact', // Priority: 502
-    ]
-]
-```
+use Hyde\Facades\Navigation;
 
-```php
-// filepath: config/docs.php
-'sidebar' => [
-    'order' => [
-        'readme', // Priority: 500
-        'installation', // Priority: 501
-        'getting-started', // Priority: 502
-    ]
-]
-```
+return [
+    // ...
+
+    'navigation' => Navigation::configure()
+        ->setPagePriorities([
+            'index' => 0,
+            'posts' => 10,
+            'docs/index' => 100,
+        ])
+        ->setPageLabels([
+            'index' => 'Home',
+            'docs/index' => 'Docs',
+        ])
+        ->excludePages([
+            '404',
+        ])
+        ->addNavigationItems([
+            Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
+        ])
+        ->setSubdirectoryDisplayMode('hidden'),
+];
+```
+
+### Using YAML Configuration
+
+You can also set the navigation configuration in the `hyde.yml` file. The structure remains the same as the array-based method:
 
-#### Explicit Priority Syntax
+```yaml
+hyde:
+  navigation:
+    order:
+      index: 0
+      posts: 10
+      docs/index: 100
+    labels:
+      index: Home
+      docs/index: Docs
+    exclude:
+      - 404
+    custom:
+      - destination: 'https://github.com/hydephp/hyde'
+        label: 'GitHub'
+        priority: 200
+    subdirectory_display: hidden
+```
+
+## Customization Options
 
-You can also specify explicit priorities by adding a value to the array keys. We'll then use these exact values as the priorities.
+Here's an overview of what you can customize in your navigation menus:
 
-```php
-// filepath: config/hyde.php
-'navigation' => [
-    'order' => [
-        'home' => 10,
-        'about' => 15,
-        'contact' => 20,
-    ]
-]
-```
+- Item labels: The text displayed in menu links
+- Item priorities: Control the order of link appearance
+- Item visibility: Choose to hide or show pages in the menu
+- Item grouping: Group pages together in dropdowns or sidebar categories
 
-```php
-// filepath: config/docs.php
-'sidebar' => [
-    'order' => [
-        'readme' => 10,
-        'installation' => 15,
-        'getting-started' => 20,
-    ]
-]
-```
+### Setting Page Priorities
 
-You could also combine these methods if desired:
+Use the `setPagePriorities` method to define the order of pages in the navigation menu:
 
 ```php
-// filepath: Applicable to both
-[
-    'readme' => 10, // Priority: 10
-    'installation', // Priority: 500
-    'getting-started', // Priority: 501
-]
+->setPagePriorities([
+    'index' => 0,
+    'posts' => 10,
+    'docs/index' => 100,
+])
 ```
 
 ### Changing Menu Item Labels
 
-Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
-
-If you're not happy with these, it's easy to override navigation link labels by mapping the route key to the desired title in the Hyde config:
+Override navigation link labels using the `setPageLabels` method:
 
 ```php
-// filepath: config/hyde.php
-'navigation' => [
-    'labels' => [
-        'index' => 'Start',
-        'docs/index' => 'Documentation',
-    ]
-]
+->setPageLabels([
+    'index' => 'Home',
+    'docs/index' => 'Documentation',
+])
 ```
 
-**Note:** This feature is not yet supported for the sidebar.
-
-### Excluding Items (Blacklist)
+### Excluding Items
 
-When you have a lot of pages, it may be useful to prevent links from being added to the main navigation menu.
-
-To exclude items from being added, simply add the page's route key to the navigation blacklist in the Hyde config:
+Prevent links from being added to the main navigation menu using the `excludePages` method:
 
 ```php
-// filepath: config/hyde.php
-'navigation' => [
-    'exclude' => [
-        '404'
-    ]
-]
+->excludePages([
+    '404',
+])
 ```
 
 ### Adding Custom Navigation Menu Links
 
-You can easily add custom navigation menu links in the Hyde config:
+Add custom navigation menu links using the `addNavigationItems` method:
 
 ```php
-// filepath: config/hyde.php
-use Hyde\Facades\Navigation;
-
-'navigation' => [
-    'custom' => [
-        Navigation::item(
-            destination: 'https://github.com/hydephp/hyde', // Required
-            label: 'GitHub', // Optional, defaults to the destination value
-            priority: 200 // Optional, defaults to 500
-        ),
-    ]
-]
+->addNavigationItems([
+    Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
+])
 ```
 
-**Tip:** While named arguments are used in the example for clarity, they are not required.
-
-
 ### Configure Subdirectory Display
 
-You can configure how subdirectories should be displayed in the menu:
+Set how subdirectories should be displayed in the menu using the `setSubdirectoryDisplayMode` method:
 
 ```php
-// filepath: config/hyde.php
-'navigation' => [
-    'subdirectory_display' => 'dropdown'
-]
+->setSubdirectoryDisplayMode('dropdown')
 ```
 
-**Supported Options:**
-- `dropdown`: Pages in subdirectories are displayed in a dropdown menu
-- `hidden`: Pages in subdirectories are not displayed at all the menus
-- `flat`: Pages in subdirectories are displayed as individual items
-
-### Automatic Menu Groups
+Supported options are 'dropdown', 'hidden', and 'flat'.
 
-A handy feature HydePHP has is that it can automatically place pages in dropdowns based on subdirectory structures.
-
-#### Automatic Navigation Menu Dropdowns
+## Front Matter Configuration
 
-Enable this feature in the `hyde.php` config file by setting the `subdirectory_display` key to `dropdown`.
+Front matter options allow per-page customization of navigation menus. These options remain unchanged:
 
-```php
-// filepath: config/hyde.php
-'navigation' => [
-    'subdirectory_display' => 'dropdown',
-],
+```yaml
+navigation:
+  label: string  # The displayed text in the navigation item link
+  priority: int  # The page's priority for ordering (lower means higher up/first)
+  hidden: bool   # Whether the page should be hidden from the navigation menu
+  group: string  # Set main menu dropdown or sidebar group key
 ```
 
-Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
-
-#### Automatic Documentation Sidebar Grouping
-
-This feature is always enabled for documentation pages. Simply place your pages in subdirectories to have them grouped in the sidebar.
-
-For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
-
->info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
-
-#### Dropdown Menu Notes
-
-- Dropdowns take priority over standard items. If you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
-- Example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost, so please keep this in mind when using this feature.
-
 ## Numerical Prefix Navigation Ordering
 
-HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
+The numerical prefix navigation ordering feature remains unchanged. You can still use numerical prefixes in filenames to control the order of navigation items.
 
-This has the great benefit of matching the navigation menu layout with the file structure view, and works especially great with subdirectory-based navigation grouping.
-
-```shell
-_pages/
-  01-home.md     # Priority: 1 (saved to _site/index.html)
-  02-about.md    # Priority: 2 (saved to _site/about.html)
-  03-contact.md  # Priority: 3 (saved to _site/contact.html)
-```
-
-As you can seem Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
-
-### Important Notes
-
-1. The numerical prefix remains part of the page identifier but is stripped from the route key.
-   For example: `_pages/01-home.md` has route key `home` and page identifier `01-home`.
-2. You can delimit the numerical prefix with either a dash or an underscore.
-   For example: Both `_pages/01-home.md` and `_pages/01_home.md` are valid.
-3. Leading zeros are optional. `_pages/1-home.md` is equally valid.
-
-### Using Numerical Prefix Ordering in Subdirectories
-
-This feature integrates well with automatic subdirectory-based navigation grouping. Here are two useful tips:
-
-1. You can use numerical prefixes in subdirectories to control the dropdown/sidebar order.
-2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
-
-Here is an example structure of how could organize a documentation site:
-
-```shell
-_docs/
-  01-getting-started/
-    01-installation.md
-    02-requirements.md
-    03-configuration.md
-  02-usage/
-    01-quick-start.md
-    02-advanced-usage.md
-  03-features/
-    01-feature-1.md
-    02-feature-2.md
-```
-
-### Customization
-
-If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
+To disable this feature, you can use the following configuration:
 
 ```php
-// filepath: config/hyde.php
-'numerical_page_ordering' => false,
+return [
+    // ...
+    'numerical_page_ordering' => false,
+];
 ```
 
-## Digging Deeper into the Internals
-
-While not essential, understanding the internal workings of the navigation system can be as beneficial as it's interesting. Here's a quick high-level overview of the [Navigation API](navigation-api).
-
-### Navigation Menu Classes
-
-The main navigation menu uses the `MainNavigationMenu` class, while the documentation sidebar uses the `DocumentationSidebar` class. Both extend the base `NavigationMenu` class:
-
-```php
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
-use Hyde\Framework\Features\Navigation\DocumentationSidebar;
-use Hyde\Framework\Features\Navigation\NavigationMenu;
-```
-
-The base `NavigationMenu` class contains the main logic for menu generation, while child implementations contain extra logic for specific use cases.
-
-All navigation menus store items in their `$items` collection, containing instances of the `NavigationItem` class. Dropdowns are represented by `NavigationGroup` instances, which extend the `NavigationMenu` class and contain additional `NavigationItem` instances:
-
-```php
-use Hyde\Framework\Features\Navigation\NavigationItem;
-use Hyde\Framework\Features\Navigation\NavigationGroup;
-```
-
-## The Navigation API
-
-For advanced users and package developers, Hyde offers a Navigation API for programmatic interaction with site navigation. This API consists of a set of PHP classes allowing fluent interaction with navigation menus.
+## Conclusion
 
-For more detailed information about the API, refer to the [Navigation API](navigation-api) documentation.
+The new builder pattern provides a more fluent and IDE-friendly way to configure navigation in HydePHP. However, the old array-based method and YAML configuration are still supported, giving you flexibility in how you choose to customize your site's navigation.
\ No newline at end of file

From d51c4af5e4cc2810b9616769c1d4178f81ce6f2b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 12:54:18 +0200
Subject: [PATCH 2600/4023] Revert "Create Claude draft"

This reverts commit 901b810ef1f0846b1cb4bc30780ba2a2f1d568c1.
---
 context.php                       | 330 --------------------------
 docs/digging-deeper/navigation.md | 371 ++++++++++++++++++++++--------
 2 files changed, 273 insertions(+), 428 deletions(-)
 delete mode 100644 context.php

diff --git a/context.php b/context.php
deleted file mode 100644
index b338e14ca4d..00000000000
--- a/context.php
+++ /dev/null
@@ -1,330 +0,0 @@
-
-    /*
-    |--------------------------------------------------------------------------
-    | Navigation Menu Configuration
-    |--------------------------------------------------------------------------
-    |
-    | If you are looking to customize the main navigation menu, this is the place!
-    |
-    | All these settings uses Route Keys to identify the page you want to configure.
-    | A route key is simply the URL path to the page, without the file extension.
-    | So `_site/posts/hello-world.html` has the route key 'posts/hello-world'.
-    |
-    */
-
-    // OLD
-    
-    'navigation' => [
-        // This configuration sets the priorities used to determine the order of the menu.
-        // The default values have been added below for reference and easy editing.
-        // The array key is the page's route key, the value is the priority.
-        // Lower values show up first in the menu. The default is 999.
-        'order' => [
-            'index' => 0,
-            'posts' => 10,
-            'docs/index' => 100,
-        ],
-
-        // In case you want to customize the labels for the menu items, you can do so here.
-        // Simply add the route key as the array key, and the label as the value.
-        'labels' => [
-            'index' => 'Home',
-            'docs/index' => 'Docs',
-        ],
-
-        // These are the route keys of pages that should not show up in the navigation menu.
-        'exclude' => [
-            '404',
-        ],
-
-        // Any extra links you want to add to the navigation menu can be added here.
-        // To get started quickly, you can uncomment the defaults here.
-        // See the documentation link above for more information.
-        'custom' => [
-            // NavigationItem::create('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ],
-
-        // How should pages in subdirectories be displayed in the menu?
-        // You can choose between 'dropdown', 'flat', and 'hidden'.
-        'subdirectories' => 'hidden',
-    ],
-
-
-    // NEW (creates an array exactly like the one above, but with a more fluent API that supports better autocomplete)
-
-    'navigation' => Navigation::configure()
-        ->setPagePriorities([
-            'index' => 0,
-            'posts' => 10,
-            'docs/index' => 100,
-        ])
-        ->setPageLabels([
-            'index' => 'Home',
-            'docs/index' => 'Docs',
-        ])
-        ->excludePages([
-            '404',
-        ])
-        ->addNavigationItems([
-            // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ])
-        ->setSubdirectoryDisplayMode('hidden'),
-
-    // All of these options work in the yaml config (this is just an example, please use the same example data as above in the docs)
-    hyde:
-        navigation:
-            custom:
-                - destination: 'https://example.com'
-                label: 'Example'
-                priority: 100
-                attributes:
-                    class: 'example'
-                - destination: 'about'
-                label: 'About Us'
-                priority: 200
-                attributes:
-                    class: 'about'
-                    id: 'about'
-                - destination: 'contact'
-                label: 'Contact'
-                priority: 300
-                attributes:
-                    target: '_blank'
-                    rel: 'noopener noreferrer'
-                    foo: 'bar'
-
-
-// relevant code snippets
-
-<?php
-
-/**
- * General facade for navigation features.
- */
-class Navigation
-{
-    /**
-     * Configuration helper method to define a new navigation item, with better IDE support.
-     *
-     * The returned array will then be used by the framework to create a new NavigationItem instance. {@see \Hyde\Framework\Features\Navigation\NavigationItem}
-     *
-     * @see https://hydephp.com/docs/2.x/navigation-api
-     *
-     * @param  string<\Hyde\Support\Models\RouteKey>|string  $destination  Route key, or an external URI.
-     * @param  string|null  $label  If not provided, Hyde will try to get it from the route's connected page, or from the URL.
-     * @param  int|null  $priority  If not provided, Hyde will try to get it from the route or the default priority of 500.
-     * @param  array<string, scalar>  $attributes  Additional attributes for the navigation item.
-     * @return array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}
-     */
-    public static function item(string $destination, ?string $label = null, ?int $priority = null, array $attributes = []): array
-    {
-        return compact('destination', 'label', 'priority', 'attributes');
-    }
-
-    /**
-     * Configuration helper method to define the navigation menu configuration with better IDE support.
-     *
-     * The builder is an array object that will be used by the framework to set the navigation menu configuration.
-     *
-     * @experimental This method is experimental and may change or be removed before the final release.
-     */
-    public static function configure(): NavigationMenuConfigurationBuilder
-    {
-        return new NavigationMenuConfigurationBuilder();
-    }
-}
-
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-use TypeError;
-use ArrayObject;
-use Illuminate\Contracts\Support\Arrayable;
-
-/**
- * Configuration helper class to define the navigation menu configuration with better IDE support.
- *
- * The configured data will then be used by the framework to set the navigation menu configuration.
- *
- * @see \Hyde\Facades\Navigation::configure()
- *
- * @experimental This class is experimental and may change or be removed before the final release.
- */
-class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
-{
-    /**
-     * Set the order of the navigation items.
-     *
-     * Either define a map of route keys to priorities, or just a list of route keys and we'll try to match that order.
-     *
-     * @param  array<string, int>|array<string>  $order
-     * @return $this
-     */
-    public function setPagePriorities(array $order): static
-    {
-        $this['order'] = $order;
-
-        return $this;
-    }
-
-    /**
-     * Set the labels for the navigation items.
-     *
-     * Each key should be a route key, and the value should be the label to display.
-     *
-     * @param  array<string, string>  $labels
-     * @return $this
-     */
-    public function setPageLabels(array $labels): static
-    {
-        $this['labels'] = $labels;
-
-        return $this;
-    }
-
-    /**
-     * Exclude certain items from the navigation.
-     *
-     * Each item should be a route key for the page to exclude.
-     *
-     * @param  array<string>  $exclude
-     * @return $this
-     */
-    public function excludePages(array $exclude): static
-    {
-        $this['exclude'] = $exclude;
-
-        return $this;
-    }
-
-    /**
-     * Add custom items to the navigation.
-     *
-     * @example `[Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200, ['target' => '_blank'])]`
-     *
-     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
-     * @return $this
-     */
-    public function addNavigationItems(array $custom): static
-    {
-        $this['custom'] = $custom;
-
-        return $this;
-    }
-
-    /**
-     * Set the display mode for pages in subdirectories.
-     *
-     * You can choose between 'dropdown', 'flat', and 'hidden'. The default is 'hidden'.
-     *
-     * @param  'dropdown'|'flat'|'hidden'  $displayMode
-     * @return $this
-     */
-    public function setSubdirectoryDisplayMode(string $displayMode): static
-    {
-        self::assertType(['dropdown', 'flat', 'hidden'], $displayMode);
-
-        $this['subdirectory_display'] = $displayMode;
-
-        return $this;
-    }
-
-    /**
-     * Hide pages in subdirectories from the navigation.
-     *
-     * @experimental This method is experimental and may change or be removed before the final release.
-     *
-     * @return $this
-     */
-    public function hideSubdirectoriesFromNavigation(): static
-    {
-        return $this->setSubdirectoryDisplayMode('hidden');
-    }
-
-    /**
-     * Get the instance as an array.
-     *
-     * @return array{order: array<string, int>, labels: array<string, string>, exclude: array<string>, custom: array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>, subdirectory_display: string}
-     */
-    public function toArray(): array
-    {
-        return $this->getArrayCopy();
-    }
-
-    /** @experimental May be moved to a separate helper class in the future. */
-    protected static function assertType(array $types, string $value): void
-    {
-        if (! in_array($value, $types)) {
-            throw new TypeError('Value must be one of: '.implode(', ', $types));
-        }
-    }
-}
-
-
-// The docs config has not been updated to use the builder api
-
-    /*
-    |--------------------------------------------------------------------------
-    | Sidebar Settings
-    |--------------------------------------------------------------------------
-    |
-    | The Hyde Documentation Module comes with a fancy Sidebar that is
-    | automatically populated with links to your documentation pages.
-    | Here, you can configure its behavior, content, look and feel.
-    |
-    */
-
-    'sidebar' => [
-        // The title in the sidebar header
-        'header' => env('SITE_NAME', 'HydePHP').' Docs',
-
-        // When using a grouped sidebar, should the groups be collapsible?
-        'collapsible' => true,
-
-        // A string of Markdown to show in the footer. Set to `false` to disable.
-        'footer' => '[Back to home page](../)',
-
-        /*
-        |--------------------------------------------------------------------------
-        | Sidebar Page Order
-        |--------------------------------------------------------------------------
-        |
-        | In the generated Documentation pages the navigation links in the sidebar
-        | default to sort alphabetically. You can reorder the page identifiers
-        | in the list below, and the links will get sorted in that order.
-        |
-        | The items will get a priority of 500 plus the order its found in the list.
-        | Pages without a priority will fall back to the default priority of 999.
-        |
-        | You can also set explicit priorities in front matter or by specifying
-        | a value to the array key in the list to override the inferred value.
-        |
-        */
-
-        'order' => [
-            'readme',
-            'installation',
-            'getting-started',
-        ],
-
-        /*
-        |--------------------------------------------------------------------------
-        | Table of Contents Settings
-        |--------------------------------------------------------------------------
-        |
-        | The Hyde Documentation Module comes with a fancy Sidebar that, by default,
-        | has a Table of Contents included. Here, you can configure its behavior,
-        | content, look and feel. You can also disable the feature completely.
-        |
-        */
-
-        'table_of_contents' => [
-            'enabled' => true,
-            'min_heading_level' => 2,
-            'max_heading_level' => 4,
-        ],
-
-    ],
\ No newline at end of file
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 36482372801..1f037908a70 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -37,156 +37,331 @@ Here's an overview of what you can customize in your navigation menus:
 - Item visibility: Choose to hide or show pages in the menu
 - Item grouping: Group pages together in dropdowns or sidebar categories
 
-## Configuration Methods
+### Customization Methods
 
 Hyde provides multiple ways to customize navigation menus to suit your needs:
 
 1. Front matter data in Markdown and Blade page files, applicable to all menu types
-2. Configuration in the `hyde.php` or `hyde.yml` config file for main navigation items
-3. Configuration in the `docs.php` config file for documentation sidebar items
+2. Configuration in the `hyde` config file for main navigation items
+3. Configuration in the `docs` config file for documentation sidebar items
 
-The new builder pattern in the configuration allows for a more fluent and IDE-friendly way to customize navigation. However, the old array-based method still works, as the navigation builder is an `ArrayObject` and can be used as an array.
+Keep in mind that front matter data overrides dynamically inferred or config-defined priorities. While useful for quick one-off changes on small sites, it can make reordering items later on more challenging as you can't see the entire structure at once.
 
-### Using the Navigation Builder
+Additionally, general options for the entire navigation menus are also available in the `hyde` and `docs` config files.
 
-To use the new builder pattern, you can configure your navigation in the `hyde.php` file like this:
+## Front Matter Configuration
 
-```php
-use Hyde\Facades\Navigation;
+Front matter options allow per-page customization of navigation menus. Here's a quick reference of available options:
+
+```yaml
+navigation:
+    label: string  # The displayed text in the navigation item link
+    priority: int  # The page's priority for ordering (lower means higher up/first)
+    hidden: bool   # Whether the page should be hidden from the navigation menu
+    group: string  # Set main menu dropdown or sidebar group key
+```
 
-return [
-    // ...
-
-    'navigation' => Navigation::configure()
-        ->setPagePriorities([
-            'index' => 0,
-            'posts' => 10,
-            'docs/index' => 100,
-        ])
-        ->setPageLabels([
-            'index' => 'Home',
-            'docs/index' => 'Docs',
-        ])
-        ->excludePages([
-            '404',
-        ])
-        ->addNavigationItems([
-            Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ])
-        ->setSubdirectoryDisplayMode('hidden'),
-];
-```
-
-### Using YAML Configuration
-
-You can also set the navigation configuration in the `hyde.yml` file. The structure remains the same as the array-based method:
+You only need to specify the keys you want to customize.
+
+### `label`
+
+Customizes the text appearing in the navigation menu link for the page. If not set anywhere else, Hyde will search for a title in the page content or generate one from the filename.
 
 ```yaml
-hyde:
-  navigation:
-    order:
-      index: 0
-      posts: 10
-      docs/index: 100
-    labels:
-      index: Home
-      docs/index: Docs
-    exclude:
-      - 404
-    custom:
-      - destination: 'https://github.com/hydephp/hyde'
-        label: 'GitHub'
-        priority: 200
-    subdirectory_display: hidden
-```
-
-## Customization Options
+navigation:
+    label: "My Custom Label"
+```
 
-Here's an overview of what you can customize in your navigation menus:
+### `priority`
 
-- Item labels: The text displayed in menu links
-- Item priorities: Control the order of link appearance
-- Item visibility: Choose to hide or show pages in the menu
-- Item grouping: Group pages together in dropdowns or sidebar categories
+Controls the order in which the page appears in the navigation menu.
+
+```yaml
+navigation:
+    priority: 10
+```
+
+### `hidden`
+
+Determines if the page appears in the navigation menu.
+
+```yaml
+navigation:
+    hidden: true
+```
+
+**Tip:** You can also use `visible: false` to achieve the same effect.
+
+### `group`
+
+For the primary navigation menu, this groups pages together in dropdowns. For the sidebar, it groups pages under a common heading.
+
+```yaml
+navigation:
+    group: "My Group"
+```
+
+**Note:** Sidebar group keys are normalized, so `My Group` and `my-group` are equivalent.
+
+## Config File Configuration
+
+Let's explore how to customize navigation menus using configuration files:
+
+- For the main navigation menu, use `navigation` setting in the `hyde.php` config file.
+- For the sidebar, use `sidebar` setting in the `docs.php` config file.
+
+When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
+
+### Changing Priorities
+
+The `navigation.order` and `sidebar.order` settings allow you to customize the order of pages in the navigation menus.
+
+#### Basic Priority Syntax
+
+A nice and simple way to define the order of pages, is to add their route keys as a simple list array. We'll then match that array order.
+
+It may be useful to know that we internally will assign a priority calculated according to its position in the list, plus an offset of `500`. The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
+
+```php
+// filepath: config/hyde.php
+'navigation' => [
+    'order' => [
+        'home', // Priority: 500
+        'about', // Priority: 501
+        'contact', // Priority: 502
+    ]
+]
+```
+
+```php
+// filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme', // Priority: 500
+        'installation', // Priority: 501
+        'getting-started', // Priority: 502
+    ]
+]
+```
+
+#### Explicit Priority Syntax
+
+You can also specify explicit priorities by adding a value to the array keys. We'll then use these exact values as the priorities.
 
-### Setting Page Priorities
+```php
+// filepath: config/hyde.php
+'navigation' => [
+    'order' => [
+        'home' => 10,
+        'about' => 15,
+        'contact' => 20,
+    ]
+]
+```
 
-Use the `setPagePriorities` method to define the order of pages in the navigation menu:
+```php
+// filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme' => 10,
+        'installation' => 15,
+        'getting-started' => 20,
+    ]
+]
+```
+
+You could also combine these methods if desired:
 
 ```php
-->setPagePriorities([
-    'index' => 0,
-    'posts' => 10,
-    'docs/index' => 100,
-])
+// filepath: Applicable to both
+[
+    'readme' => 10, // Priority: 10
+    'installation', // Priority: 500
+    'getting-started', // Priority: 501
+]
 ```
 
 ### Changing Menu Item Labels
 
-Override navigation link labels using the `setPageLabels` method:
+Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
+
+If you're not happy with these, it's easy to override navigation link labels by mapping the route key to the desired title in the Hyde config:
 
 ```php
-->setPageLabels([
-    'index' => 'Home',
-    'docs/index' => 'Documentation',
-])
+// filepath: config/hyde.php
+'navigation' => [
+    'labels' => [
+        'index' => 'Start',
+        'docs/index' => 'Documentation',
+    ]
+]
 ```
 
-### Excluding Items
+**Note:** This feature is not yet supported for the sidebar.
+
+### Excluding Items (Blacklist)
 
-Prevent links from being added to the main navigation menu using the `excludePages` method:
+When you have a lot of pages, it may be useful to prevent links from being added to the main navigation menu.
+
+To exclude items from being added, simply add the page's route key to the navigation blacklist in the Hyde config:
 
 ```php
-->excludePages([
-    '404',
-])
+// filepath: config/hyde.php
+'navigation' => [
+    'exclude' => [
+        '404'
+    ]
+]
 ```
 
 ### Adding Custom Navigation Menu Links
 
-Add custom navigation menu links using the `addNavigationItems` method:
+You can easily add custom navigation menu links in the Hyde config:
 
 ```php
-->addNavigationItems([
-    Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-])
+// filepath: config/hyde.php
+use Hyde\Facades\Navigation;
+
+'navigation' => [
+    'custom' => [
+        Navigation::item(
+            destination: 'https://github.com/hydephp/hyde', // Required
+            label: 'GitHub', // Optional, defaults to the destination value
+            priority: 200 // Optional, defaults to 500
+        ),
+    ]
+]
 ```
 
+**Tip:** While named arguments are used in the example for clarity, they are not required.
+
+
 ### Configure Subdirectory Display
 
-Set how subdirectories should be displayed in the menu using the `setSubdirectoryDisplayMode` method:
+You can configure how subdirectories should be displayed in the menu:
 
 ```php
-->setSubdirectoryDisplayMode('dropdown')
+// filepath: config/hyde.php
+'navigation' => [
+    'subdirectory_display' => 'dropdown'
+]
 ```
 
-Supported options are 'dropdown', 'hidden', and 'flat'.
+**Supported Options:**
+- `dropdown`: Pages in subdirectories are displayed in a dropdown menu
+- `hidden`: Pages in subdirectories are not displayed at all the menus
+- `flat`: Pages in subdirectories are displayed as individual items
 
-## Front Matter Configuration
+### Automatic Menu Groups
 
-Front matter options allow per-page customization of navigation menus. These options remain unchanged:
+A handy feature HydePHP has is that it can automatically place pages in dropdowns based on subdirectory structures.
 
-```yaml
-navigation:
-  label: string  # The displayed text in the navigation item link
-  priority: int  # The page's priority for ordering (lower means higher up/first)
-  hidden: bool   # Whether the page should be hidden from the navigation menu
-  group: string  # Set main menu dropdown or sidebar group key
+#### Automatic Navigation Menu Dropdowns
+
+Enable this feature in the `hyde.php` config file by setting the `subdirectory_display` key to `dropdown`.
+
+```php
+// filepath: config/hyde.php
+'navigation' => [
+    'subdirectory_display' => 'dropdown',
+],
 ```
 
+Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
+
+#### Automatic Documentation Sidebar Grouping
+
+This feature is always enabled for documentation pages. Simply place your pages in subdirectories to have them grouped in the sidebar.
+
+For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
+
+>info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
+
+#### Dropdown Menu Notes
+
+- Dropdowns take priority over standard items. If you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
+- Example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost, so please keep this in mind when using this feature.
+
 ## Numerical Prefix Navigation Ordering
 
-The numerical prefix navigation ordering feature remains unchanged. You can still use numerical prefixes in filenames to control the order of navigation items.
+HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
 
-To disable this feature, you can use the following configuration:
+This has the great benefit of matching the navigation menu layout with the file structure view, and works especially great with subdirectory-based navigation grouping.
+
+```shell
+_pages/
+  01-home.md     # Priority: 1 (saved to _site/index.html)
+  02-about.md    # Priority: 2 (saved to _site/about.html)
+  03-contact.md  # Priority: 3 (saved to _site/contact.html)
+```
+
+As you can seem Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
+
+### Important Notes
+
+1. The numerical prefix remains part of the page identifier but is stripped from the route key.
+   For example: `_pages/01-home.md` has route key `home` and page identifier `01-home`.
+2. You can delimit the numerical prefix with either a dash or an underscore.
+   For example: Both `_pages/01-home.md` and `_pages/01_home.md` are valid.
+3. Leading zeros are optional. `_pages/1-home.md` is equally valid.
+
+### Using Numerical Prefix Ordering in Subdirectories
+
+This feature integrates well with automatic subdirectory-based navigation grouping. Here are two useful tips:
+
+1. You can use numerical prefixes in subdirectories to control the dropdown/sidebar order.
+2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
+
+Here is an example structure of how could organize a documentation site:
+
+```shell
+_docs/
+  01-getting-started/
+    01-installation.md
+    02-requirements.md
+    03-configuration.md
+  02-usage/
+    01-quick-start.md
+    02-advanced-usage.md
+  03-features/
+    01-feature-1.md
+    02-feature-2.md
+```
+
+### Customization
+
+If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
 
 ```php
-return [
-    // ...
-    'numerical_page_ordering' => false,
-];
+// filepath: config/hyde.php
+'numerical_page_ordering' => false,
 ```
 
-## Conclusion
+## Digging Deeper into the Internals
+
+While not essential, understanding the internal workings of the navigation system can be as beneficial as it's interesting. Here's a quick high-level overview of the [Navigation API](navigation-api).
+
+### Navigation Menu Classes
+
+The main navigation menu uses the `MainNavigationMenu` class, while the documentation sidebar uses the `DocumentationSidebar` class. Both extend the base `NavigationMenu` class:
+
+```php
+use Hyde\Framework\Features\Navigation\MainNavigationMenu;
+use Hyde\Framework\Features\Navigation\DocumentationSidebar;
+use Hyde\Framework\Features\Navigation\NavigationMenu;
+```
+
+The base `NavigationMenu` class contains the main logic for menu generation, while child implementations contain extra logic for specific use cases.
+
+All navigation menus store items in their `$items` collection, containing instances of the `NavigationItem` class. Dropdowns are represented by `NavigationGroup` instances, which extend the `NavigationMenu` class and contain additional `NavigationItem` instances:
+
+```php
+use Hyde\Framework\Features\Navigation\NavigationItem;
+use Hyde\Framework\Features\Navigation\NavigationGroup;
+```
+
+## The Navigation API
+
+For advanced users and package developers, Hyde offers a Navigation API for programmatic interaction with site navigation. This API consists of a set of PHP classes allowing fluent interaction with navigation menus.
 
-The new builder pattern provides a more fluent and IDE-friendly way to configure navigation in HydePHP. However, the old array-based method and YAML configuration are still supported, giving you flexibility in how you choose to customize your site's navigation.
\ No newline at end of file
+For more detailed information about the API, refer to the [Navigation API](navigation-api) documentation.

From 3f9f9f8cfff988e7a8980a5447efce7e9127cd36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:06:37 +0200
Subject: [PATCH 2601/4023] Remove hard line breaks from sections

---
 docs/creating-content/documentation-pages.md | 90 +++++++-------------
 1 file changed, 29 insertions(+), 61 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index aed6f445be6..689e8bebdcf 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -8,23 +8,17 @@ navigation:
 
 ## Introduction to Hyde Documentation Pages
 
-Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier.
-Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
+Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier. Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
 
-Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a
-responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order,
-labels, and even groups, of the sidebar items to suit your needs.
+Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and even groups, of the sidebar items to suit your needs.
 
-Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated
-"Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
+Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
 
-If you have a Torchlight API token in your .env file, Hyde will even enable syntax highlighting automatically,
-saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
+If you have a Torchlight API token in your .env file, Hyde will even enable syntax highlighting automatically, saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
 
 ### Best Practices and Hyde Expectations
 
-Since Hyde does a lot of things automatically, there are some things you may need
-to keep in mind when creating blog posts so that you don't get unexpected results.
+Since Hyde does a lot of things automatically, there are some things you may need to keep in mind when creating blog posts so that you don't get unexpected results.
 
 #### Filenames
 
@@ -78,13 +72,11 @@ navigation:
 
 ## Dynamic Content Generation
 
-Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title.
-If you are not happy with the results you can customize them in the config or with front matter.
+Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title. If you are not happy with the results you can customize them in the config or with front matter.
 
 ### Front Matter reference
 
-Before we look at how to override things, here is an overview of the relevant content Hyde generates,
-and where the data is from as well as where it can be overridden.
+Before we look at how to override things, here is an overview of the relevant content Hyde generates, and where the data is from as well as where it can be overridden.
 
 | Property                        | Description                                            | Dynamic Data Source                 | Override in          |
 |---------------------------------|--------------------------------------------------------|-------------------------------------|----------------------|
@@ -97,29 +89,26 @@ and where the data is from as well as where it can be overridden.
 
 ## Sidebar
 
-The sidebar is automatically generated from the files in the `_docs` directory. You will probably want to change the order
-of these items. You can do this in two ways, either in the config or with front matter using the navigation array settings.
+The sidebar is automatically generated from the files in the `_docs` directory. You will probably want to change the order of these items. You can do this in two ways, either in the config or with front matter using the navigation array settings.
 
-Since this feature shares a lot of similarities and implementation details with the navigation menu,
-I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
+Since this feature shares a lot of similarities and implementation details with the navigation menu, I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
 
 ### Sidebar ordering
 
-The sidebar is sorted/ordered by the `priority` property. The higher the priority the further down in the sidebar it will be.
-The default priority is 999. You can override the priority using the following front matter:
+The sidebar is sorted/ordered by the `priority` property. The higher the priority the further down in the sidebar it will be. The default priority is 999. You can override the priority using the following front matter:
 
 ```yaml
 navigation:
     priority: 5
 ```
 
-You can also change the order in the Docs configuration file.
-See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
+You can also change the order in the Docs configuration file. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
 _I personally think the config route is easier as it gives an instant overview, however the first way is nice as well._
 
 ### Sidebar labels
 
 The sidebar items are labelled with the `label` property. The default label is the filename of the file.
+
 You can change it with the following front matter:
 
 ```yaml
@@ -129,12 +118,9 @@ navigation:
 
 ### Sidebar grouping
 
-Sidebar grouping allows you to group items in the sidebar into categories. This is useful for creating a sidebar with a lot of items.
-The Hyde docs for instance use this.
+Sidebar grouping allows you to group items in the sidebar into categories. This is useful for creating a sidebar with a lot of items. The Hyde docs for instance use this.
 
-The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set
-in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories.
-Any pages without the group front matter will get put in the "Other" group.
+The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories. Any pages without the group front matter will get put in the "Other" group.
 
 ### Sidebar footer customization
 
@@ -185,13 +171,12 @@ This can be useful to create redirects or other items that should not be shown i
 
 ## Customization
 
-Please see the [customization page](customization) for in-depth information on how to customize Hyde,
-including the documentation pages. Here is a high level overview for quick reference though.
+Please see the [customization page](customization) for in-depth information on how to customize Hyde, including the documentation pages. Here is a high level overview for quick reference though.
 
 ### Output directory
 
-If you want to store the compiled documentation pages in a different directory than the default 'docs' directory,
-for example to specify a version like the Hyde docs does, you can specify the output directory in the Hyde configuration file.
+If you want to store the compiled documentation pages in a different directory than the default 'docs' directory, for example to specify a version like the Hyde docs does, you can specify the output directory in the Hyde configuration file.
+
 The path is relative to the site output, typically `_site`.
 
 ```php
@@ -210,8 +195,7 @@ By default, a link to the documentation page is added to the navigation menu whe
 
 ### Sidebar header name
 
-By default, the site title shown in the sidebar header is generated from the configured site name suffixed with "docs".
-You can change this in the Docs configuration file. Tip: The header will link to the docs/index page, if it exists.
+By default, the site title shown in the sidebar header is generated from the configured site name suffixed with "docs". You can change this in the Docs configuration file. Tip: The header will link to the docs/index page, if it exists.
 
 ```php
 'title' => 'API Documentation',
@@ -219,8 +203,7 @@ You can change this in the Docs configuration file. Tip: The header will link to
 
 ### Sidebar page order
 
-To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order.
-Link items without an entry here will fall back to the default priority of 999, putting them last.
+To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order. Link items without an entry here will fall back to the default priority of 999, putting them last.
 
 ```php
 'sidebar' => [
@@ -236,9 +219,7 @@ See [the chapter in the customization page](customization#navigation-menu--sideb
 
 ### Automatic sidebar group labels
 
-When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names.
-If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file.
-The array key is the directory name, and the value is the label.
+When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names. If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file. The array key is the directory name, and the value is the label.
 
 Please note that this option is not added to the config file by default, as it's not a super common use case. No worries though, just add the following yourself!
 
@@ -254,8 +235,7 @@ Please note that this option is not added to the config file by default, as it's
 
 Hyde automatically generates a table of contents for the page and adds it to the sidebar.
 
-In the `config/docs.php` file you can configure the behaviour, content, and the look and feel of the sidebar table of contents.
-You can also disable the feature completely.
+In the `config/docs.php` file you can configure the behaviour, content, and the look and feel of the sidebar table of contents. You can also disable the feature completely.
 
 ```php
 'sidebar' => [
@@ -269,9 +249,7 @@ You can also disable the feature completely.
 
 ### Using flattened output paths
 
-If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory.
-This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure.
-Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
+If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory. This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure. Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
 
 If you set this to false, Hyde will match the directory structure of the source files (just like all other pages).
 
@@ -285,8 +263,7 @@ If you set this to false, Hyde will match the directory structure of the source
 
 ### Introduction
 
-The HydeSearch plugin adds a search feature to documentation pages. It consists of two parts, a search index generator
-that runs during the build command, and a frontend JavaScript plugin that adds the actual search widget.
+The HydeSearch plugin adds a search feature to documentation pages. It consists of two parts, a search index generator that runs during the build command, and a frontend JavaScript plugin that adds the actual search widget.
 
 >info Tip: The HydeSearch plugin is what powers the search feature on this site! Why not [try it out](search)?
 
@@ -305,16 +282,13 @@ The search works by generating a JSON search index which the JavaScript plugin l
 
 Two ways to access the search are added, one is a full page search screen that will be saved to `docs/search.html`.
 
-The second method is a button added to the documentation pages, similar to how Algolia DocSearch works.
-Opening it will open a modal with an integrated search screen. You can also open the dialogue using the keyboard shortcut `/`.
+The second method is a button added to the documentation pages, similar to how Algolia DocSearch works. Opening it will open a modal with an integrated search screen. You can also open the dialogue using the keyboard shortcut `/`.
 
 >info The full page can be disabled by setting `create_search_page` to `false` in the `docs` config.
 
 ### Hiding pages from indexing
 
-If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index.
-You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how
-navigation menu items are hidden. The page will still be accessible as normal but will be added to the search index JSON file.
+If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will be added to the search index JSON file.
 
 ```php
 // filepath: config/docs.php
@@ -332,13 +306,9 @@ The Realtime Compiler that powers the `php hyde serve` command will automaticall
 
 ### Introduction
 
-Hyde can automatically add links to documentation pages that take the user
-to a GitHub page (or similar) to edit the page. This makes it great for open-source projects
-looking to allow others to contribute to the documentation in a quick and easy manner.
+Hyde can automatically add links to documentation pages that take the user to a GitHub page (or similar) to edit the page. This makes it great for open-source projects looking to allow others to contribute to the documentation in a quick and easy manner.
 
-The feature is automatically enabled when you specify a base URL in the Docs configuration file.
-Hyde expects this to be a GitHub path, but it will probably work with other methods as well,
-if not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
+The feature is automatically enabled when you specify a base URL in the Docs configuration file. Hyde expects this to be a GitHub path, but it will probably work with other methods as well, if not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
 
 >info Tip: This documentation site uses this feature, scroll down to the bottom of this page and try it out!
 
@@ -363,8 +333,7 @@ Changing the label is easy, just change the following config setting:
 
 #### Changing the position
 
-By default, the button will be shown in both the documentation page footer.
-You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
+By default, the button will be shown in both the documentation page footer. You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
 
 ```php
 // Filepath: config/docs.php
@@ -373,8 +342,7 @@ You can change this by setting the following config setting to `'header'`, `'foo
 
 #### Adding a button icon
 
-This is not included out of the box, but is easy to add with some CSS!
-Just target the `.edit-page-link` class.
+This is not included out of the box, but is easy to add with some CSS! Just target the `.edit-page-link` class.
 
 ```css
 // filepath e.g. app.css

From 7a85697a90b4c4fc066a5ba0ea4975fc3694234c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:07:26 +0200
Subject: [PATCH 2602/4023] Remove extra newlines

---
 docs/creating-content/documentation-pages.md | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 689e8bebdcf..68bf8361e8a 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -34,7 +34,6 @@ Since Hyde does a lot of things automatically, there are some things you may nee
 Like most of HydePHP, the Hyde Documentation module is highly customizable. Much of the frontend is composed using Blade templates and components, which you can customize to your heart's content.
 Since there are so many components, it's hard to list them all here in the documentation, so I encourage you to check out the [source code](https://github.com/hydephp/framework/tree/master/resources/views/components/docs) to see how it's all put together and find the customizations you are looking for.
 
-
 ## Creating Documentation Pages
 
 You can create a Documentation page by adding a file to the `_docs` directory where the filename ends in `.md`.
@@ -69,7 +68,6 @@ navigation:
 ---
 ```
 
-
 ## Dynamic Content Generation
 
 Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title. If you are not happy with the results you can customize them in the config or with front matter.
@@ -168,7 +166,6 @@ This can be useful to create redirects or other items that should not be shown i
 
 >info The index page is by default not shown as a sidebar item, but instead is linked in the sidebar header. <br>
 
-
 ## Customization
 
 Please see the [customization page](customization) for in-depth information on how to customize Hyde, including the documentation pages. Here is a high level overview for quick reference though.
@@ -258,7 +255,6 @@ If you set this to false, Hyde will match the directory structure of the source
 'flattened_output_paths' => true,
 ```
 
-
 ## Search Feature
 
 ### Introduction
@@ -301,7 +297,6 @@ If you have a large page on your documentation site, like a changelog, you may w
 
 The Realtime Compiler that powers the `php hyde serve` command will automatically generate a fresh search index each time the browser requests it.
 
-
 ## Automatic "Edit Page" Button
 
 ### Introduction

From 467b99191848153bf7ec4af1c1024ca7d12ec72f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:08:37 +0200
Subject: [PATCH 2603/4023] Cleanup line

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 68bf8361e8a..ce0daea81e7 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -10,7 +10,7 @@ navigation:
 
 Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier. Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
 
-Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and even groups, of the sidebar items to suit your needs.
+Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and groups of the sidebar items to suit your needs.
 
 Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
 

From ac511dbb872f148b676a86c2f6d5eb521c1bab2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:09:55 +0200
Subject: [PATCH 2604/4023] Shorten line

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index ce0daea81e7..65f708c2c8e 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -309,7 +309,7 @@ The feature is automatically enabled when you specify a base URL in the Docs con
 
 ### Configuration
 
-As an example configuration, let's take a practical example of how HydePHP.com uses this feature.
+Here's an example configuration from the official HydePHP.com documentation:
 
 ```php
 // Filepath: config/docs.php

From 4ec275f69aee9e55a9abdb21cb3702872be1f692 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:58:15 +0200
Subject: [PATCH 2605/4023] Reformat Markdown

---
 docs/advanced-features/navigation-api.md | 10 ++--------
 docs/creating-content/blog-posts.md      |  1 -
 docs/digging-deeper/customization.md     |  5 ++---
 docs/digging-deeper/navigation.md        |  2 --
 4 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/docs/advanced-features/navigation-api.md b/docs/advanced-features/navigation-api.md
index 9c5fcad14d2..7facfe0b7bd 100644
--- a/docs/advanced-features/navigation-api.md
+++ b/docs/advanced-features/navigation-api.md
@@ -7,7 +7,6 @@ navigation:
 
 >warning This article covers advanced information that is only relevant if you want to create custom navigation menus. Instead, you may want to read the [Navigation](navigation) article for a general overview.
 
-
 ## Abstract
 
 This article describes the Navigation API introduced in HydePHP v2. Both the main navigation menu and the documentation sidebar bundled with HydePHP are built with this API.
@@ -17,7 +16,6 @@ This article is intended for advanced users, as most users will not need to crea
 For this reason, the documentation is very code-driven due to the technical nature of the API.
 We'll also be mixing in some practical examples of Blade and PHP code to illustrate how you can use the API in your own projects.
 
-
 ## Overview
 
 The Navigation API consists of a set of classes within the `Hyde\Framework\Features\Navigation` namespace.
@@ -74,7 +72,6 @@ $sidebar = DocumentationSidebar::get();
 
 >info Developer tip: The menus are only generated *after* the Hyde Kernel is booted. If you are getting BindingResolutionExceptions, ensure that you are not trying to access the menus too early in the application lifecycle. (Consider using the `booted` event.)
 
-
 ## Creating Custom Menus
 
 ### Introduction Overview
@@ -148,12 +145,10 @@ Here are some general tips to keep in mind when working with the Navigation API:
 - You can also construct NavigationItem instances directly, but the `create` method is a convenient shorthand, and can fill in data from routes, if you use them.
 - It's also possible to set an item's priority as the third parameter, but here we don't need it, as they default to the order they are added.
 
-
 ## Class Reference
 
 Below is a reference of the classes and methods available in the Navigation API.
 
-
 ## NavigationMenu
 
 The `NavigationMenu` class represents a navigation menu. It contains a collection of items, which can be either `NavigationItem` or `NavigationGroup` instances.
@@ -251,7 +246,7 @@ $item->getLabel(): string;
 $item->getPriority(): int;
 
 // Check if the item is active. (Only works when the destination is a route)
-$item->isActive(): bool; 
+$item->isActive(): bool;
 ```
 
 ### Blade Example
@@ -330,7 +325,7 @@ If the destination is a route, the link will be resolved to the correct URL, usi
 
 ```php
 $item = new NavigationItem(Routes::get('index'));
-$item->getLink(); // Outputs 'index.html' 
+$item->getLink(); // Outputs 'index.html'
 
 $item = new NavigationItem('https://example.com');
 $item->getLink(); // Outputs 'https://example.com'
@@ -388,7 +383,6 @@ $item->isActive(fn($item) => $item->getLink() === 'index.html');
 This is useful if you want to check for a specific query parameter, or if you want to check if the item is active based on a more complex condition.
 -->
 
-
 ## NavigationGroup
 
 The `NavigationGroup` class represents a group of items in a navigation menu. It contains a label, priority, and a collection of navigation items.
diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index 39351b88f6d..ae5eaef27fa 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -160,7 +160,6 @@ author:
       github: "hydephp"
 ```
 
-
 When using an array, you don't need to include all properties. Specified values will override the corresponding entries in the `authors` config.
 
 Note: Author usernames are automatically normalized (converted to lowercase with spaces replaced by underscores).
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 4d211cb41f1..8b42ca38b7c 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -122,7 +122,7 @@ Here are the default settings:
 ### Authors
 
 Hyde supports adding authors to blog posts, allowing you to automatically include information like display names and website links.
-We even support fields for avatars, biographies, and social media profiles, which you can use in your custom Blade templates. 
+We even support fields for avatars, biographies, and social media profiles, which you can use in your custom Blade templates.
 
 While you can set all this data directly in the [front matter](blog-posts#author), that quickly becomes tedious and hard to maintain.
 Instead, you can predefine authors in the Hyde config. When writing posts, just specify the username in the front matter,
@@ -139,7 +139,7 @@ Authors are defined in the `config/hyde.php` file under the `authors` key. Each
         // The following fields, along with the username, are used by the default blog post templates.
         name: 'Mr. Hyde',
         website: 'https://hydephp.com',
-        
+
         // These fields are not currently used in the default templates, but you can use them in your custom views.
         bio: 'The mysterious author of HydePHP',
         avatar: 'avatar.png',
@@ -173,7 +173,6 @@ author: mr_hyde
 
 If you want to override the data for a specific post, you can do so in the [front matter](blog-posts#author) which is great for guest authors or one-off posts.
 
-
 #### Available Fields
 
 - `name`: The author's display name (optional, generated from username if not provided)
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4f0fe9c350e..9faf3d250d8 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -60,7 +60,6 @@ General options for the entire navigation menus are also available in the `hyde`
 
 Now that you know the basics, let's dive into the details of how to customize the navigation menus!
 
-
 ## Front Matter Configuration
 
 The front matter options allow you to customize the navigation menus on a per-page basis.
@@ -114,7 +113,6 @@ navigation:
     group: "My Group"
 ```
 
-
 ## Config File Configuration
 
 Next up, let's look at how to customize the navigation menus using the config files.

From 51dc2ed0d77780924a4aa3b1bee81b76dbe22768 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 13:06:37 +0200
Subject: [PATCH 2606/4023] Remove hard line breaks from sections

---
 docs/creating-content/documentation-pages.md | 90 +++++++-------------
 1 file changed, 29 insertions(+), 61 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 309fc0cd7f7..f2e86881ab3 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -8,23 +8,17 @@ navigation:
 
 ## Introduction to Hyde Documentation Pages
 
-Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier.
-Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
+Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier. Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
 
-Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a
-responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order,
-labels, and even groups, of the sidebar items to suit your needs.
+Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and even groups, of the sidebar items to suit your needs.
 
-Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated
-"Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
+Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
 
-If you have a Torchlight API token in your .env file, Hyde will even enable syntax highlighting automatically,
-saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
+If you have a Torchlight API token in your .env file, Hyde will even enable syntax highlighting automatically, saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
 
 ### Best Practices and Hyde Expectations
 
-Since Hyde does a lot of things automatically, there are some things you may need
-to keep in mind when creating blog posts so that you don't get unexpected results.
+Since Hyde does a lot of things automatically, there are some things you may need to keep in mind when creating blog posts so that you don't get unexpected results.
 
 #### Filenames
 
@@ -77,13 +71,11 @@ navigation:
 
 ## Dynamic Content Generation
 
-Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title.
-If you are not happy with the results you can customize them in the config or with front matter.
+Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title. If you are not happy with the results you can customize them in the config or with front matter.
 
 ### Front Matter reference
 
-Before we look at how to override things, here is an overview of the relevant content Hyde generates,
-and where the data is from as well as where it can be overridden.
+Before we look at how to override things, here is an overview of the relevant content Hyde generates, and where the data is from as well as where it can be overridden.
 
 | Property                        | Description                                            | Dynamic Data Source                 | Override in          |
 |---------------------------------|--------------------------------------------------------|-------------------------------------|----------------------|
@@ -95,29 +87,26 @@ and where the data is from as well as where it can be overridden.
 
 ## Sidebar
 
-The sidebar is automatically generated from the files in the `_docs` directory. You will probably want to change the order
-of these items. You can do this in two ways, either in the config or with front matter using the navigation array settings.
+The sidebar is automatically generated from the files in the `_docs` directory. You will probably want to change the order of these items. You can do this in two ways, either in the config or with front matter using the navigation array settings.
 
-Since this feature shares a lot of similarities and implementation details with the navigation menu,
-I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
+Since this feature shares a lot of similarities and implementation details with the navigation menu, I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
 
 ### Sidebar ordering
 
-The sidebar is sorted/ordered by the `priority` property. The higher the priority the further down in the sidebar it will be.
-The default priority is 999. You can override the priority using the following front matter:
+The sidebar is sorted/ordered by the `priority` property. The higher the priority the further down in the sidebar it will be. The default priority is 999. You can override the priority using the following front matter:
 
 ```yaml
 navigation:
     priority: 5
 ```
 
-You can also change the order in the Docs configuration file.
-See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
+You can also change the order in the Docs configuration file. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
 _I personally think the config route is easier as it gives an instant overview, however the first way is nice as well._
 
 ### Sidebar labels
 
 The sidebar items are labelled with the `label` property. The default label is the filename of the file.
+
 You can change it with the following front matter:
 
 ```yaml
@@ -127,12 +116,9 @@ navigation:
 
 ### Sidebar grouping
 
-Sidebar grouping allows you to group items in the sidebar into categories. This is useful for creating a sidebar with a lot of items.
-The Hyde docs for instance use this.
+Sidebar grouping allows you to group items in the sidebar into categories. This is useful for creating a sidebar with a lot of items. The Hyde docs for instance use this.
 
-The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set
-in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories.
-Any pages without the group front matter will get put in the "Other" group.
+The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories. Any pages without the group front matter will get put in the "Other" group.
 
 ### Sidebar footer customization
 
@@ -182,13 +168,12 @@ This can be useful to create redirects or other items that should not be shown i
 
 ## Customization
 
-Please see the [customization page](customization) for in-depth information on how to customize Hyde,
-including the documentation pages. Here is a high level overview for quick reference though.
+Please see the [customization page](customization) for in-depth information on how to customize Hyde, including the documentation pages. Here is a high level overview for quick reference though.
 
 ### Output directory
 
-If you want to store the compiled documentation pages in a different directory than the default 'docs' directory,
-for example to specify a version like the Hyde docs does, you can specify the output directory in the Hyde configuration file.
+If you want to store the compiled documentation pages in a different directory than the default 'docs' directory, for example to specify a version like the Hyde docs does, you can specify the output directory in the Hyde configuration file.
+
 The path is relative to the site output, typically `_site`.
 
 ```php
@@ -207,8 +192,7 @@ By default, a link to the documentation page is added to the navigation menu whe
 
 ### Sidebar header name
 
-By default, the site title shown in the sidebar header is generated from the configured site name suffixed with "docs".
-You can change this in the Docs configuration file. Tip: The header will link to the docs/index page, if it exists.
+By default, the site title shown in the sidebar header is generated from the configured site name suffixed with "docs". You can change this in the Docs configuration file. Tip: The header will link to the docs/index page, if it exists.
 
 ```php
 'title' => 'API Documentation',
@@ -216,8 +200,7 @@ You can change this in the Docs configuration file. Tip: The header will link to
 
 ### Sidebar page order
 
-To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order.
-Link items without an entry here will fall back to the default priority of 999, putting them last.
+To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order. Link items without an entry here will fall back to the default priority of 999, putting them last.
 
 ```php
 'sidebar' => [
@@ -233,9 +216,7 @@ See [the chapter in the customization page](customization#navigation-menu--sideb
 
 ### Automatic sidebar group labels
 
-When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names.
-If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file.
-The array key is the directory name, and the value is the label.
+When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names. If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file. The array key is the directory name, and the value is the label.
 
 Please note that this option is not added to the config file by default, as it's not a super common use case. No worries though, just add the following yourself!
 
@@ -251,8 +232,7 @@ Please note that this option is not added to the config file by default, as it's
 
 Hyde automatically generates a table of contents for the page and adds it to the sidebar.
 
-In the `config/docs.php` file you can configure the behaviour, content, and the look and feel of the sidebar table of contents.
-You can also disable the feature completely.
+In the `config/docs.php` file you can configure the behaviour, content, and the look and feel of the sidebar table of contents. You can also disable the feature completely.
 
 ```php
 'sidebar' => [
@@ -266,9 +246,7 @@ You can also disable the feature completely.
 
 ### Using flattened output paths
 
-If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory.
-This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure.
-Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
+If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory. This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure. Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
 
 If you set this to false, Hyde will match the directory structure of the source files (just like all other pages).
 
@@ -281,8 +259,7 @@ If you set this to false, Hyde will match the directory structure of the source
 
 ### Introduction
 
-The HydeSearch plugin adds a search feature to documentation pages. It consists of two parts, a search index generator
-that runs during the build command, and a frontend JavaScript plugin that adds the actual search widget.
+The HydeSearch plugin adds a search feature to documentation pages. It consists of two parts, a search index generator that runs during the build command, and a frontend JavaScript plugin that adds the actual search widget.
 
 >info Tip: The HydeSearch plugin is what powers the search feature on this site! Why not [try it out](search)?
 
@@ -301,16 +278,13 @@ The search works by generating a JSON search index which the JavaScript plugin l
 
 Two ways to access the search are added, one is a full page search screen that will be saved to `docs/search.html`.
 
-The second method is a button added to the documentation pages, similar to how Algolia DocSearch works.
-Opening it will open a modal with an integrated search screen. You can also open the dialogue using the keyboard shortcut `/`.
+The second method is a button added to the documentation pages, similar to how Algolia DocSearch works. Opening it will open a modal with an integrated search screen. You can also open the dialogue using the keyboard shortcut `/`.
 
 >info The full page can be disabled by setting `create_search_page` to `false` in the `docs` config.
 
 ### Hiding pages from indexing
 
-If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index.
-You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how
-navigation menu items are hidden. The page will still be accessible as normal but will be added to the search index JSON file.
+If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will be added to the search index JSON file.
 
 ```php
 // filepath: config/docs.php
@@ -327,13 +301,9 @@ The Realtime Compiler that powers the `php hyde serve` command will automaticall
 
 ### Introduction
 
-Hyde can automatically add links to documentation pages that take the user
-to a GitHub page (or similar) to edit the page. This makes it great for open-source projects
-looking to allow others to contribute to the documentation in a quick and easy manner.
+Hyde can automatically add links to documentation pages that take the user to a GitHub page (or similar) to edit the page. This makes it great for open-source projects looking to allow others to contribute to the documentation in a quick and easy manner.
 
-The feature is automatically enabled when you specify a base URL in the Docs configuration file.
-Hyde expects this to be a GitHub path, but it will probably work with other methods as well,
-if not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
+The feature is automatically enabled when you specify a base URL in the Docs configuration file. Hyde expects this to be a GitHub path, but it will probably work with other methods as well, if not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
 
 >info Tip: This documentation site uses this feature, scroll down to the bottom of this page and try it out!
 
@@ -358,8 +328,7 @@ Changing the label is easy, just change the following config setting:
 
 #### Changing the position
 
-By default, the button will be shown in both the documentation page footer.
-You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
+By default, the button will be shown in both the documentation page footer. You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
 
 ```php
 // Filepath: config/docs.php
@@ -368,8 +337,7 @@ You can change this by setting the following config setting to `'header'`, `'foo
 
 #### Adding a button icon
 
-This is not included out of the box, but is easy to add with some CSS!
-Just target the `.edit-page-link` class.
+This is not included out of the box, but is easy to add with some CSS! Just target the `.edit-page-link` class.
 
 ```css
 // filepath e.g. app.css

From accc2f7c36a0783424083ae0b877d08bea2d4da6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:31:23 +0200
Subject: [PATCH 2607/4023] Clarify that lower priority values result in higher
 placement in the sidebar

Matches writing style, and is more intuitive
---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index ed64817e624..d9c498e01a9 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -93,7 +93,7 @@ Since this feature shares a lot of similarities and implementation details with
 
 ### Sidebar ordering
 
-The sidebar is sorted/ordered by the `priority` property. The higher the priority the further down in the sidebar it will be. The default priority is 999. You can override the priority using the following front matter:
+The sidebar is sorted/ordered by the `priority` property. The lower the priority value, the higher up in the sidebar it will be. The default priority is 999. You can override the priority using the following front matter:
 
 ```yaml
 navigation:

From cc0d2e3ef0eedf94a02e448d665eec1a8dce9f01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:32:57 +0200
Subject: [PATCH 2608/4023] Clean up section

---
 docs/creating-content/documentation-pages.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index d9c498e01a9..c3aa6d2f3d3 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -100,8 +100,7 @@ navigation:
     priority: 5
 ```
 
-You can also change the order in the Docs configuration file. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
-_I personally think the config route is easier as it gives an instant overview, however the first way is nice as well._
+You can also change the order in the `config/docs.php` configuration file, which may be easier to manage for larger sites. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details.
 
 ### Sidebar labels
 

From 0df917bd7eed259c1797cd1f9960bdfaf68e54a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:34:50 +0200
Subject: [PATCH 2609/4023] Reformat table

---
 docs/creating-content/documentation-pages.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index c3aa6d2f3d3..8e98b4722ce 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -77,13 +77,13 @@ Hyde makes documentation pages easy to create by automatically generating dynami
 
 Before we look at how to override things, here is an overview of the relevant content Hyde generates, and where the data is from as well as where it can be overridden.
 
-| Property                        | Description                                            | Dynamic Data Source                 | Override in          |
-|---------------------------------|--------------------------------------------------------|-------------------------------------|----------------------|
-| `title` (string)                | The title of the page used in the HTML `<title>` tag   | The first H1 heading (`# Foo`)      | Front matter         |
-| `navigation.label` (string)     | The label for the page shown in the sidebar            | The page basename | Front matter, config |
-| `navigation.priority` (integer) | The priority of the page used for ordering the sidebar | Defaults to 999                     | Front matter, config |
-| `navigation.hidden` (boolean)   | Hides the page from the sidebar                        | _none_                              | Front matter, config |
-| `navigation.group` (string)     | The group the page belongs to in the sidebar           | Subdirectory, if nested             | Front matter         |
+| Property                        | Description                                            | Dynamic Data Source            | Override in          |
+|---------------------------------|--------------------------------------------------------|--------------------------------|----------------------|
+| `title` (string)                | The title of the page used in the HTML `<title>` tag   | The first H1 heading (`# Foo`) | Front matter         |
+| `navigation.label` (string)     | The label for the page shown in the sidebar            | The page basename              | Front matter, config |
+| `navigation.priority` (integer) | The priority of the page used for ordering the sidebar | Defaults to 999                | Front matter, config |
+| `navigation.hidden` (boolean)   | Hides the page from the sidebar                        | _none_                         | Front matter, config |
+| `navigation.group` (string)     | The group the page belongs to in the sidebar           | Subdirectory, if nested        | Front matter         |
 
 ## Sidebar
 

From ab46ba42448864011e1a540aca972f13178f7891 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:35:16 +0200
Subject: [PATCH 2610/4023] Clarify that label is generated not literal

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 8e98b4722ce..6c1844014cb 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -104,7 +104,7 @@ You can also change the order in the `config/docs.php` configuration file, which
 
 ### Sidebar labels
 
-The sidebar items are labelled with the `label` property. The default label is the filename of the file.
+The sidebar items are labelled with the `label` property. The default label is generated from the filename of the file.
 
 You can change it with the following front matter:
 

From ad504acffba78e30e05e835eb5e9153274c66176 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:39:41 +0200
Subject: [PATCH 2611/4023] Improve grouping documentation wording

---
 docs/creating-content/documentation-pages.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 6c1844014cb..b1e75ad3bf2 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -115,9 +115,8 @@ navigation:
 
 ### Sidebar grouping
 
-Sidebar grouping allows you to group items in the sidebar into categories. This is useful for creating a sidebar with a lot of items. The Hyde docs for instance use this.
+Sidebar grouping allows you to group items in the sidebar under category headings. This is useful for creating a sidebar with a lot of items. The official HydePHP.com docs, for instance, use this feature.
 
-The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set in the front matter, or when subdirectories are used. This will then switch to a slightly more compact sidebar layout with pages sorted into categories. Any pages without the group front matter will get put in the "Other" group.
 
 ### Sidebar footer customization
 
@@ -132,6 +131,7 @@ The sidebar footer contains, by default, a link to your site homepage. You can c
 ```
 
 You can also set the option to `false` to disable it entirely.
+The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set in the front matter, or when documentation pages are organized in subdirectories. Once activated, Hyde will switch to a slightly more compact sidebar layout with pages sorted into labeled groups. Any pages without the group information will be put in the "Other" group.
 
 #### Using Front Matter
 

From 5aa2fa59a06fbf9f6f2ed0fd29475d02aa449550 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:40:44 +0200
Subject: [PATCH 2612/4023] Fix wrong term used for sidebars

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index b1e75ad3bf2..2b9d87d78db 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -150,7 +150,7 @@ For example, putting a Markdown file in `_docs/getting-started/`, is equivalent
 
 >info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they overwrite each other.
 
->info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
+>info Tip: When using subdirectory-based grouping, you can set their priority using the directory name as the array key.
 
 ### Hiding items
 

From cff03ac0513db462bf7ce087b44d2455e0996c25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:41:07 +0200
Subject: [PATCH 2613/4023] Improve wording to be clearer

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 2b9d87d78db..bb6b10d5af6 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -150,7 +150,7 @@ For example, putting a Markdown file in `_docs/getting-started/`, is equivalent
 
 >info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they overwrite each other.
 
->info Tip: When using subdirectory-based grouping, you can set their priority using the directory name as the array key.
+>info Tip: When using subdirectory-based grouping, you can set the priority of the groups using the directory name as the array key in the config file.
 
 ### Hiding items
 

From c3fe8fb30ec3490acaa9bc820ab119c2c24ad1f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:41:40 +0200
Subject: [PATCH 2614/4023] Remove unnecessary line break

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index bb6b10d5af6..6d94081a09c 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -163,7 +163,7 @@ navigation:
 
 This can be useful to create redirects or other items that should not be shown in the sidebar.
 
->info The index page is by default not shown as a sidebar item, but instead is linked in the sidebar header. <br>
+>info The index page is by default not shown as a sidebar item, but instead is linked in the sidebar header.
 
 ## Customization
 

From 9a2b2ef92c0a75327f0b3a218f8f0fa8799e7223 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:43:13 +0200
Subject: [PATCH 2615/4023] Fix punctuation

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 6d94081a09c..429c52fdf02 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -146,7 +146,7 @@ navigation:
 
 You can also automatically group your documentation pages by placing source files in sub-directories.
 
-For example, putting a Markdown file in `_docs/getting-started/`, is equivalent to adding the same front matter seen above.
+For example, putting a Markdown file in `_docs/getting-started/` is equivalent to adding the same front matter seen above.
 
 >info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they overwrite each other.
 

From a7c6f8fd872a714df24de5fd084b57fbef99f2fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:43:23 +0200
Subject: [PATCH 2616/4023] Clarify wording

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 429c52fdf02..a41b0051a9d 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -148,7 +148,7 @@ You can also automatically group your documentation pages by placing source file
 
 For example, putting a Markdown file in `_docs/getting-started/` is equivalent to adding the same front matter seen above.
 
->info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they overwrite each other.
+>info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they would overwrite each other.
 
 >info Tip: When using subdirectory-based grouping, you can set the priority of the groups using the directory name as the array key in the config file.
 

From 87eec33dc43d08702dc59e04fe7e7159e7dcc04e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:43:59 +0200
Subject: [PATCH 2617/4023] Fix section order

---
 docs/creating-content/documentation-pages.md | 28 ++++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index a41b0051a9d..9781b605969 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -117,20 +117,6 @@ navigation:
 
 Sidebar grouping allows you to group items in the sidebar under category headings. This is useful for creating a sidebar with a lot of items. The official HydePHP.com docs, for instance, use this feature.
 
-
-### Sidebar footer customization
-
-The sidebar footer contains, by default, a link to your site homepage. You can change this in the `config/docs.php` file.
-
-```php
-// filepath: config/docs.php
-
-'sidebar' => [
-    'footer' => 'My **Markdown** Footer Text',
-],
-```
-
-You can also set the option to `false` to disable it entirely.
 The feature is enabled automatically when one or more of your documentation pages have the `navigation.group` property set in the front matter, or when documentation pages are organized in subdirectories. Once activated, Hyde will switch to a slightly more compact sidebar layout with pages sorted into labeled groups. Any pages without the group information will be put in the "Other" group.
 
 #### Using Front Matter
@@ -197,6 +183,20 @@ By default, the site title shown in the sidebar header is generated from the con
 'title' => 'API Documentation',
 ```
 
+### Sidebar footer customization
+
+The sidebar footer contains, by default, a link to your site homepage. You can change this in the `config/docs.php` file.
+
+```php
+// filepath: config/docs.php
+
+'sidebar' => [
+    'footer' => 'My **Markdown** Footer Text',
+],
+```
+
+You can also set the option to `false` to disable it entirely.
+
 ### Sidebar page order
 
 To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order. Link items without an entry here will fall back to the default priority of 999, putting them last.

From 3fb32ab31fec7aaa72f81059d121613ef121de99 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:50:30 +0200
Subject: [PATCH 2618/4023] Fix inline code formatting

---
 docs/creating-content/documentation-pages.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 9781b605969..4e93ca87311 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -8,13 +8,13 @@ navigation:
 
 ## Introduction to Hyde Documentation Pages
 
-Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier. Using the Hyde Documentation module, all you need to do is place standard Markdown files in the _docs/ directory, and Hyde takes care of the rest.
+Welcome to the Hyde Documentation Pages, where creating professional-looking documentation sites has never been easier. Using the Hyde Documentation module, all you need to do is place standard Markdown files in the `_docs/` directory, and Hyde takes care of the rest.
 
 Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and groups of the sidebar items to suit your needs.
 
 Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
 
-If you have a Torchlight API token in your .env file, Hyde will even enable syntax highlighting automatically, saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
+If you have a Torchlight API token in your `.env` file, Hyde will even enable syntax highlighting automatically, saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
 
 ### Best Practices and Hyde Expectations
 

From 79ef5b2c65fc3a83f592089c20d03dd29852bb94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:50:42 +0200
Subject: [PATCH 2619/4023] Fix wrong page type name

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 4e93ca87311..d346b4b5356 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -18,7 +18,7 @@ If you have a Torchlight API token in your `.env` file, Hyde will even enable sy
 
 ### Best Practices and Hyde Expectations
 
-Since Hyde does a lot of things automatically, there are some things you may need to keep in mind when creating blog posts so that you don't get unexpected results.
+Since Hyde does a lot of things automatically, there are some things you may need to keep in mind when creating documentation pages so that you don't get unexpected results.
 
 #### Filenames
 

From 591ae52148af9ef461f228b86f721a44a1308eea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 14:57:29 +0200
Subject: [PATCH 2620/4023] Fix grammar

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index d346b4b5356..14b6931f2dd 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -12,7 +12,7 @@ Welcome to the Hyde Documentation Pages, where creating professional-looking doc
 
 Hyde compiles your Markdown content into beautiful static HTML pages using a TailwindCSS frontend, complete with a responsive sidebar that is automatically generated based on your Markdown files. You can even customize the order, labels, and groups of the sidebar items to suit your needs.
 
-Additionally, if you have a `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
+Additionally, if you have an `_docs/index.md` file, the sidebar header will link to it, and an automatically generated "Docs" link will be added to your site's main navigation menu, pointing to your documentation page.
 
 If you have a Torchlight API token in your `.env` file, Hyde will even enable syntax highlighting automatically, saving you time and effort. For more information about this feature, see the [extensions page](extensions#torchlight).
 

From 3d3932d004744b8e94a1ba1de43c2323f2839331 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:26:48 +0200
Subject: [PATCH 2621/4023] Remove word that isn't to be there

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 3b32dec349a..708ed7e3d42 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -327,7 +327,7 @@ Changing the label is easy, just change the following config setting:
 
 #### Changing the position
 
-By default, the button will be shown in both the documentation page footer. You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
+By default, the button will be shown in the documentation page footer. You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
 
 ```php
 // Filepath: config/docs.php

From 3f5a4dd3a74aceb80955a32fa83db4a153268afb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:27:07 +0200
Subject: [PATCH 2622/4023] Add missing important word

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 708ed7e3d42..362dce28406 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -283,7 +283,7 @@ The second method is a button added to the documentation pages, similar to how A
 
 ### Hiding pages from indexing
 
-If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will be added to the search index JSON file.
+If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will not be added to the search index JSON file.
 
 ```php
 // filepath: config/docs.php

From 4b5c86de32cb0b79fb52b4491545a71f3224b443 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:27:13 +0200
Subject: [PATCH 2623/4023] Use American English

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 362dce28406..7c809614f51 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -277,7 +277,7 @@ The search works by generating a JSON search index which the JavaScript plugin l
 
 Two ways to access the search are added, one is a full page search screen that will be saved to `docs/search.html`.
 
-The second method is a button added to the documentation pages, similar to how Algolia DocSearch works. Opening it will open a modal with an integrated search screen. You can also open the dialogue using the keyboard shortcut `/`.
+The second method is a button added to the documentation pages, similar to how Algolia DocSearch works. Opening it will open a modal with an integrated search screen. You can also open the dialog using the keyboard shortcut `/`.
 
 >info The full page can be disabled by setting `create_search_page` to `false` in the `docs` config.
 

From f3c494e0a92818506fefb3e6c777f00a69485a74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:27:36 +0200
Subject: [PATCH 2624/4023] Split out subordinate clause to separate sentence

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 7c809614f51..1c566e85cd0 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -302,7 +302,7 @@ The Realtime Compiler that powers the `php hyde serve` command will automaticall
 
 Hyde can automatically add links to documentation pages that take the user to a GitHub page (or similar) to edit the page. This makes it great for open-source projects looking to allow others to contribute to the documentation in a quick and easy manner.
 
-The feature is automatically enabled when you specify a base URL in the Docs configuration file. Hyde expects this to be a GitHub path, but it will probably work with other methods as well, if not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
+The feature is automatically enabled when you specify a base URL in the Docs configuration file. Hyde expects this to be a GitHub path, but it will probably work with other methods as well. If not, please send a PR and/or create an issue on the [GitHub repository](https://github.com/hydephp/framework)!
 
 >info Tip: This documentation site uses this feature, scroll down to the bottom of this page and try it out!
 

From dc69f6ab6b58df53a9dd2af7469139d0499c6b3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:28:00 +0200
Subject: [PATCH 2625/4023] Use APA style headings

---
 docs/creating-content/documentation-pages.md | 44 ++++++++++----------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 1c566e85cd0..185a6539b2f 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -29,7 +29,7 @@ Since Hyde does a lot of things automatically, there are some things you may nee
 - You should always have an `index.md` file in the `_docs/` directory
 - Your page will be stored in `_site/docs/<identifier>.html` unless you [change it in the config](#output-directory)
 
-### Advanced usage and customization
+### Advanced Usage and Customization
 
 Like most of HydePHP, the Hyde Documentation module is highly customizable. Much of the frontend is composed using Blade templates and components, which you can customize to your heart's content.
 Since there are so many components, it's hard to list them all here in the documentation, so I encourage you to check out the [source code](https://github.com/hydephp/framework/tree/master/resources/views/components/docs) to see how it's all put together and find the customizations you are looking for.
@@ -51,7 +51,7 @@ This will create the following file saved as `_docs/page-title.md`
 
 ```
 
-### Front Matter is optional
+### Front Matter Is Optional
 
 You don't need to use [front matter](blog-posts#supported-front-matter-properties) to create a documentation page.
 
@@ -73,7 +73,7 @@ navigation:
 
 Hyde makes documentation pages easy to create by automatically generating dynamic content such as the sidebar and page title. If you are not happy with the results you can customize them in the config or with front matter.
 
-### Front Matter reference
+### Front Matter Reference
 
 Before we look at how to override things, here is an overview of the relevant content Hyde generates, and where the data is from as well as where it can be overridden.
 
@@ -91,7 +91,7 @@ The sidebar is automatically generated from the files in the `_docs` directory.
 
 Since this feature shares a lot of similarities and implementation details with the navigation menu, I recommend you read the [navigation menu documentation](navigation) page as well to learn more about the fundamentals and terminology.
 
-### Sidebar ordering
+### Sidebar Ordering
 
 The sidebar is sorted/ordered by the `priority` property. The lower the priority value, the higher up in the sidebar it will be. The default priority is 999. You can override the priority using the following front matter:
 
@@ -102,7 +102,7 @@ navigation:
 
 You can also change the order in the `config/docs.php` configuration file, which may be easier to manage for larger sites. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details.
 
-### Sidebar labels
+### Sidebar Labels
 
 The sidebar items are labelled with the `label` property. The default label is generated from the filename of the file.
 
@@ -113,7 +113,7 @@ navigation:
     label: "My Custom Sidebar Label"
 ```
 
-### Sidebar grouping
+### Sidebar Grouping
 
 Sidebar grouping allows you to group items in the sidebar under category headings. This is useful for creating a sidebar with a lot of items. The official HydePHP.com docs, for instance, use this feature.
 
@@ -128,7 +128,7 @@ navigation:
     group: "Getting Started"
 ```
 
-#### Automatic subdirectory-based grouping
+#### Automatic Subdirectory-Based Grouping
 
 You can also automatically group your documentation pages by placing source files in sub-directories.
 
@@ -155,7 +155,7 @@ This can be useful to create redirects or other items that should not be shown i
 
 Please see the [customization page](customization) for in-depth information on how to customize Hyde, including the documentation pages. Here is a high level overview for quick reference though.
 
-### Output directory
+### Output Directory
 
 If you want to store the compiled documentation pages in a different directory than the default 'docs' directory, for example to specify a version like the Hyde docs does, you can specify the output directory in the Hyde configuration file.
 
@@ -171,11 +171,11 @@ The path is relative to the site output, typically `_site`.
 
 Note that you need to take care as to not set it to something that may conflict with other parts, such as media or posts directories.
 
-### Automatic navigation menu
+### Automatic Navigation Menu
 
 By default, a link to the documentation page is added to the navigation menu when an index.md file is found in the `_docs` directory. Please see [the customization page](customization#navigation-menu--sidebar) for more information.
 
-### Sidebar header name
+### Sidebar Header Name
 
 By default, the site title shown in the sidebar header is generated from the configured site name suffixed with "docs". You can change this in the Docs configuration file. Tip: The header will link to the docs/index page, if it exists.
 
@@ -183,7 +183,7 @@ By default, the site title shown in the sidebar header is generated from the con
 'title' => 'API Documentation',
 ```
 
-### Sidebar footer customization
+### Sidebar Footer Customization
 
 The sidebar footer contains, by default, a link to your site homepage. You can change this in the `config/docs.php` file.
 
@@ -197,7 +197,7 @@ The sidebar footer contains, by default, a link to your site homepage. You can c
 
 You can also set the option to `false` to disable it entirely.
 
-### Sidebar page order
+### Sidebar Page Order
 
 To quickly arrange the order of items in the sidebar, you can reorder the page identifiers in the list and the links will be sorted in that order. Link items without an entry here will fall back to the default priority of 999, putting them last.
 
@@ -213,7 +213,7 @@ To quickly arrange the order of items in the sidebar, you can reorder the page i
 
 See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
 
-### Automatic sidebar group labels
+### Automatic Sidebar Group Labels
 
 When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names. If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file. The array key is the directory name, and the value is the label.
 
@@ -227,7 +227,7 @@ Please note that this option is not added to the config file by default, as it's
 ],
 ```
 
-### Table of contents settings
+### Table of Contents Settings
 
 Hyde automatically generates a table of contents for the page and adds it to the sidebar.
 
@@ -243,7 +243,7 @@ In the `config/docs.php` file you can configure the behaviour, content, and the
 ],
 ```
 
-### Using flattened output paths
+### Using Flattened Output Paths
 
 If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory. This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure. Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
 
@@ -271,7 +271,7 @@ The search feature is enabled by default. You can disable it by removing the `Do
 ],
 ```
 
-### Using the search
+### Using the Search
 
 The search works by generating a JSON search index which the JavaScript plugin loads asynchronously.
 
@@ -281,7 +281,7 @@ The second method is a button added to the documentation pages, similar to how A
 
 >info The full page can be disabled by setting `create_search_page` to `false` in the `docs` config.
 
-### Hiding pages from indexing
+### Hiding Pages from Indexing
 
 If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will not be added to the search index JSON file.
 
@@ -292,7 +292,7 @@ If you have a large page on your documentation site, like a changelog, you may w
 ]
 ```
 
-### Live search with the realtime compiler
+### Live Search with the Realtime Compiler
 
 The Realtime Compiler that powers the `php hyde serve` command will automatically generate a fresh search index each time the browser requests it.
 
@@ -316,7 +316,7 @@ Here's an example configuration from the official HydePHP.com documentation:
 'source_file_location_base' => 'https://github.com/hydephp/docs/blob/master/',
 ```
 
-#### Changing the button text
+#### Changing the Button Text
 
 Changing the label is easy, just change the following config setting:
 
@@ -325,7 +325,7 @@ Changing the label is easy, just change the following config setting:
 'edit_source_link_text' => 'Edit Source on GitHub',
 ```
 
-#### Changing the position
+#### Changing the Position
 
 By default, the button will be shown in the documentation page footer. You can change this by setting the following config setting to `'header'`, `'footer'`, or `'both'`
 
@@ -334,7 +334,7 @@ By default, the button will be shown in the documentation page footer. You can c
 'edit_source_link_position' => 'header',
 ```
 
-#### Adding a button icon
+#### Adding a Button Icon
 
 This is not included out of the box, but is easy to add with some CSS! Just target the `.edit-page-link` class.
 
@@ -343,6 +343,6 @@ This is not included out of the box, but is easy to add with some CSS! Just targ
 .edit-page-link::before {content: "✏ "}
 ```
 
-#### Changing the Blade view
+#### Changing the Blade View
 
 You can also publish the `edit-source-button.blade.php` view and change it to your liking.

From 7021d23d5e65507b6513456f63feaef27e5fc93c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:34:46 +0200
Subject: [PATCH 2626/4023] Fix clarity

---
 docs/digging-deeper/navigation.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index e9ae8e50818..04832cdb3b9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -107,8 +107,8 @@ navigation:
 
 Let's explore how to customize navigation menus using configuration files:
 
-- For the main navigation menu, use `navigation` setting in the `hyde.php` config file.
-- For the sidebar, use `sidebar` setting in the `docs.php` config file.
+- For the main navigation menu, use the `navigation` setting in the `hyde.php` config file.
+- For the sidebar, use the `sidebar` setting in the `docs.php` config file.
 
 When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
 

From 1eb578ce29a1de6d03b703464b5b5a774afb09d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:34:59 +0200
Subject: [PATCH 2627/4023] Fix title formatting

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 04832cdb3b9..a25c4329b8f 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -181,7 +181,7 @@ You could also combine these methods if desired:
 ]
 ```
 
-### Changing Menu item Labels
+### Changing Menu Item Labels
 
 Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
 

From 14c5ac64e24340959210be825b763b929775f671 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:35:07 +0200
Subject: [PATCH 2628/4023] Use shorter synonym

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index a25c4329b8f..bd0cfe13260 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -201,7 +201,7 @@ If you're not happy with these, it's easy to override navigation link labels by
 
 ### Excluding Items (Blacklist)
 
-When you have a lot of pages, it may be useful to prevent links from being added to the main navigation menu.
+When you have many pages, it may be useful to prevent links from being added to the main navigation menu.
 
 To exclude items from being added, simply add the page's route key to the navigation blacklist in the Hyde config:
 

From 18fafba70484ded8328de00b272120b4698c2960 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:35:38 +0200
Subject: [PATCH 2629/4023] Remove comma from coupled clauses

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index bd0cfe13260..561281a3bac 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -20,7 +20,7 @@ This documentation will guide you through the customization process. To learn ev
 
 ### Internal Structure Overview
 
-Internally, both navigation menu types extend the same base class, and thus share core functionality. This means the configuration process is similar for both types, making the documentation applicable to both.
+Internally, both navigation menu types extend the same base class and thus share core functionality. This means the configuration process is similar for both types, making the documentation applicable to both.
 
 For a deeper understanding of the internal workings, refer to the [Digging Deeper](#digging-deeper-into-the-internals) section.
 

From fcc030d65aa0b115c5a19ead2683df738ba51342 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:35:49 +0200
Subject: [PATCH 2630/4023] Reword line to be more fluent

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 561281a3bac..8019adf378e 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -33,7 +33,7 @@ All navigation menu items have an internal priority value determining their orde
 Here's an overview of what you can customize in your navigation menus:
 
 - Item labels: The text displayed in menu links
-- Item priorities: Control the order of link appearance
+- Item priorities: Control the order in which links appear
 - Item visibility: Choose to hide or show pages in the menu
 - Item grouping: Group pages together in dropdowns or sidebar categories
 

From 714e941f0d4e07b08946f025d6fa8eab954de367 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:40:46 +0200
Subject: [PATCH 2631/4023] Use plural wording to match other pluralized terms
 in sentence

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 8019adf378e..5772e667c58 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -183,7 +183,7 @@ You could also combine these methods if desired:
 
 ### Changing Menu Item Labels
 
-Hyde makes a few attempts to find a suitable label for the navigation menu items to automatically create helpful titles.
+Hyde makes a few attempts to find suitable labels for the navigation menu items to automatically create helpful titles.
 
 If you're not happy with these, it's easy to override navigation link labels by mapping the route key to the desired title in the Hyde config:
 

From 1bea0eff74c4b698c6d3ebf0141822903d6d486a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:40:55 +0200
Subject: [PATCH 2632/4023] Add missing infix

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 5772e667c58..4f9f4407567 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -248,7 +248,7 @@ You can configure how subdirectories should be displayed in the menu:
 
 **Supported Options:**
 - `dropdown`: Pages in subdirectories are displayed in a dropdown menu
-- `hidden`: Pages in subdirectories are not displayed at all the menus
+- `hidden`: Pages in subdirectories are not displayed at all in the menus
 - `flat`: Pages in subdirectories are displayed as individual items
 
 ### Automatic Menu Groups

From d269f6aa981fcd063d93e79057b18f14efe334c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:41:19 +0200
Subject: [PATCH 2633/4023] Add comma between independent clauses

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 4f9f4407567..1c729c6bf28 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -266,7 +266,7 @@ Enable this feature in the `hyde.php` config file by setting the `subdirectory_d
 ],
 ```
 
-Now if you create a page called `_pages/about/contact.md` it will automatically be placed in a dropdown called "About".
+Now if you create a page called `_pages/about/contact.md`, it will automatically be placed in a dropdown called "About".
 
 #### Automatic Documentation Sidebar Grouping
 

From 74c4924e24c44134f00d9a5adf62102cc64b070e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:41:27 +0200
Subject: [PATCH 2634/4023] Fix typo should be a comma

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1c729c6bf28..cad3ff23fd3 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -294,7 +294,7 @@ _pages/
   03-contact.md  # Priority: 3 (saved to _site/contact.html)
 ```
 
-As you can seem Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
+As you can see, Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
 
 ### Important Notes
 

From c00ab1b394d3337b43eb687ba1b11a968a8213c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:41:33 +0200
Subject: [PATCH 2635/4023] Add missing word

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index cad3ff23fd3..6dbfcca6c9a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -311,7 +311,7 @@ This feature integrates well with automatic subdirectory-based navigation groupi
 1. You can use numerical prefixes in subdirectories to control the dropdown/sidebar order.
 2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
 
-Here is an example structure of how could organize a documentation site:
+Here is an example structure of how you could organize a documentation site:
 
 ```shell
 _docs/

From 8129241d413a1d92d1f08e1ee6de895937a5a22d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:41:49 +0200
Subject: [PATCH 2636/4023] Remove comma from coupled clauses

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 6dbfcca6c9a..532c40ab24a 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -118,7 +118,7 @@ The `navigation.order` and `sidebar.order` settings allow you to customize the o
 
 #### Basic Priority Syntax
 
-A nice and simple way to define the order of pages, is to add their route keys as a simple list array. We'll then match that array order.
+A nice and simple way to define the order of pages is to add their route keys as a simple list array. We'll then match that array order.
 
 It may be useful to know that we internally will assign a priority calculated according to its position in the list, plus an offset of `500`. The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
 

From 312135ee71eefc64e64ab3c7dc911adc6a605e3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:42:00 +0200
Subject: [PATCH 2637/4023] Change word order to be more fluent

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 532c40ab24a..1e8c73bce68 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -26,7 +26,7 @@ For a deeper understanding of the internal workings, refer to the [Digging Deepe
 
 ### Understanding Priorities
 
-All navigation menu items have an internal priority value determining their order. Lower values place items higher in the menu. The default priority for pages is `999`, placing them last unless you specify a value. Some pages, like the `index` page, are by default configured with the lowest priority of `0`.
+All navigation menu items have an internal priority value determining their order. Lower values place items higher in the menu. The default priority for pages is `999`, placing them last unless you specify a value. Some pages, like the `index` page, are configured by default with the lowest priority of `0`.
 
 ### Customization Options
 

From e46b837feec20ec8673068ded7ef346e22cd158f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:42:38 +0200
Subject: [PATCH 2638/4023] Split out coupled clause to standalone sentence

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1e8c73bce68..b79b2f39478 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -285,7 +285,7 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
 
-This has the great benefit of matching the navigation menu layout with the file structure view, and works especially great with subdirectory-based navigation grouping.
+This has the great benefit of matching the navigation menu layout with the file structure view. It also works especially well with subdirectory-based navigation grouping.
 
 ```shell
 _pages/

From a5df67f53181ebc8277d9f25fa9e675a19a0c08a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 15:42:54 +0200
Subject: [PATCH 2639/4023] Reword to pluralize feature in introduction

---
 docs/digging-deeper/navigation.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index b79b2f39478..95e926b45c9 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -8,7 +8,7 @@ navigation:
 
 ## Introduction
 
-HydePHP offers an automatic navigation menu and documentation sidebar generation feature, designed to take the pain out of creating navigation menus.
+HydePHP offers automatic navigation menu and documentation sidebar generation features, designed to take the pain out of creating navigation menus.
 While Hyde does its best to configure these menus automatically based on understanding your project files, you may want to customize them further.
 
 There are two types of navigation menus in Hyde:

From 5a5d36d9c593a914e2c71a3d9ded631f7ed0b73c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:28:58 +0200
Subject: [PATCH 2640/4023] Move the sidebar documentation to the documentation
 pages page

---
 docs/creating-content/documentation-pages.md | 47 +++++++++++-
 docs/digging-deeper/customization.md         |  7 +-
 docs/digging-deeper/navigation.md            | 78 ++++----------------
 3 files changed, 66 insertions(+), 66 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 185a6539b2f..08cb115a596 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -100,7 +100,52 @@ navigation:
     priority: 5
 ```
 
-You can also change the order in the `config/docs.php` configuration file, which may be easier to manage for larger sites. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details.
+You can also change the order in the `config/docs.php` configuration file, which may be easier to manage for larger sites.
+
+#### Basic Priority Syntax
+
+A nice and simple way to define the order of pages is to add their route keys as a simple list array. Hyde will then match that array order.
+
+It may be useful to know that Hyde internally will assign a priority calculated according to its position in the list, plus an offset of `500`. The offset is added to make it easier to place pages earlier in the list using front matter or with explicit priority settings.
+
+```php
+// filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme', // Priority: 500
+        'installation', // Priority: 501
+        'getting-started', // Priority: 502
+    ]
+]
+```
+
+#### Explicit Priority Syntax
+
+You can also specify explicit priorities by adding a value to the array keys. Hyde will then use these exact values as the priorities.
+
+```php
+// filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme' => 10,
+        'installation' => 15,
+        'getting-started' => 20,
+    ]
+]
+```
+
+You could also combine these methods if desired:
+
+```php
+// filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme' => 10, // Priority: 10
+        'installation', // Priority: 500
+        'getting-started', // Priority: 501
+    ]
+]
+```
 
 ### Sidebar Labels
 
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 19b78e541f7..f9c7a0f5682 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -283,15 +283,18 @@ Still, you will likely want to customize some parts of these menus, and thankful
 
 - To customize the navigation menu, use the setting `navigation.order` in the `hyde.php` config.
 - When customizing the navigation menu, you should use the [route key](core-concepts#route-keys) of the page.
+- You can use either a basic list array or specify explicit priorities.
 
 Learn more in the [Navigation Menu](navigation) documentation.
 
 #### Customizing the documentation sidebar
 
 - To customize the sidebar, use the setting `sidebar.order` in the `docs.php` config.
-- When customizing the sidebar, can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
+- When customizing the sidebar, you can use the route key, or just the [page identifier](core-concepts#page-identifiers) of the page.
+- Similar to the navigation menu, you can use a basic list array or specify explicit priorities.
+- You can also use front matter in individual documentation pages to customize their appearance and behavior in the sidebar.
 
-Learn more in the [Documentation Pages](documentation-pages) documentation.
+Learn more in the [Documentation Pages](documentation-pages#sidebar) documentation.
 
 ## Additional Advanced Options
 
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 95e926b45c9..1eaa8464876 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -8,7 +8,7 @@ navigation:
 
 ## Introduction
 
-HydePHP offers automatic navigation menu and documentation sidebar generation features, designed to take the pain out of creating navigation menus.
+HydePHP offers automatic navigation menu generation features, designed to take the pain out of creating navigation menus.
 While Hyde does its best to configure these menus automatically based on understanding your project files, you may want to customize them further.
 
 There are two types of navigation menus in Hyde:
@@ -16,7 +16,7 @@ There are two types of navigation menus in Hyde:
 1. **Primary Navigation Menu**: The main navigation menu appearing on most pages of your site. Unique features include dropdowns for subdirectories, depending on configuration.
 2. **Documentation Sidebar**: The sidebar on documentation pages with links to other documentation pages. Unique features include automatic grouping based on subdirectories.
 
-This documentation will guide you through the customization process. To learn even more about sidebars, visit the [Documentation Pages](documentation-pages) documentation.
+This documentation will guide you through the customization process of the primary navigation menu. To learn about the documentation sidebar, visit the [Documentation Pages](documentation-pages) documentation.
 
 ### Internal Structure Overview
 
@@ -43,11 +43,10 @@ Hyde provides multiple ways to customize navigation menus to suit your needs:
 
 1. Front matter data in Markdown and Blade page files, applicable to all menu types
 2. Configuration in the `hyde` config file for main navigation items
-3. Configuration in the `docs` config file for documentation sidebar items
 
 Keep in mind that front matter data overrides dynamically inferred or config-defined priorities. While useful for quick one-off changes on small sites, it can make reordering items later on more challenging as you can't see the entire structure at once.
 
-Additionally, general options for the entire navigation menus are also available in the `hyde` and `docs` config files.
+Additionally, general options for the entire navigation menus are also available in the `hyde` config file.
 
 ## Front Matter Configuration
 
@@ -105,16 +104,15 @@ navigation:
 
 ## Config File Configuration
 
-Let's explore how to customize navigation menus using configuration files:
+Let's explore how to customize the main navigation menu using configuration files:
 
 - For the main navigation menu, use the `navigation` setting in the `hyde.php` config file.
-- For the sidebar, use the `sidebar` setting in the `docs.php` config file.
 
-When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page. For the sidebar, you can use either the route key or the [page identifier](core-concepts#page-identifiers).
+When customizing the main navigation menu, use the [route key](core-concepts#route-keys) of the page.
 
 ### Changing Priorities
 
-The `navigation.order` and `sidebar.order` settings allow you to customize the order of pages in the navigation menus.
+The `navigation.order` setting allows you to customize the order of pages in the main navigation menu.
 
 #### Basic Priority Syntax
 
@@ -133,17 +131,6 @@ It may be useful to know that we internally will assign a priority calculated ac
 ]
 ```
 
-```php
-// filepath: config/docs.php
-'sidebar' => [
-    'order' => [
-        'readme', // Priority: 500
-        'installation', // Priority: 501
-        'getting-started', // Priority: 502
-    ]
-]
-```
-
 #### Explicit Priority Syntax
 
 You can also specify explicit priorities by adding a value to the array keys. We'll then use these exact values as the priorities.
@@ -159,25 +146,16 @@ You can also specify explicit priorities by adding a value to the array keys. We
 ]
 ```
 
-```php
-// filepath: config/docs.php
-'sidebar' => [
-    'order' => [
-        'readme' => 10,
-        'installation' => 15,
-        'getting-started' => 20,
-    ]
-]
-```
-
 You could also combine these methods if desired:
 
 ```php
-// filepath: Applicable to both
-[
-    'readme' => 10, // Priority: 10
-    'installation', // Priority: 500
-    'getting-started', // Priority: 501
+// filepath: config/hyde.php
+'navigation' => [
+    'order' => [
+        'home' => 10, // Priority: 10
+        'about', // Priority: 500
+        'contact', // Priority: 501
+    ]
 ]
 ```
 
@@ -197,8 +175,6 @@ If you're not happy with these, it's easy to override navigation link labels by
 ]
 ```
 
-**Note:** This feature is not yet supported for the sidebar.
-
 ### Excluding Items (Blacklist)
 
 When you have many pages, it may be useful to prevent links from being added to the main navigation menu.
@@ -268,14 +244,6 @@ Enable this feature in the `hyde.php` config file by setting the `subdirectory_d
 
 Now if you create a page called `_pages/about/contact.md`, it will automatically be placed in a dropdown called "About".
 
-#### Automatic Documentation Sidebar Grouping
-
-This feature is always enabled for documentation pages. Simply place your pages in subdirectories to have them grouped in the sidebar.
-
-For example: `_docs/getting-started/installation.md` will be placed in a group called "Getting Started".
-
->info Tip: When using subdirectory-based dropdowns, you can set their priority using the directory name as the array key.
-
 #### Dropdown Menu Notes
 
 - Dropdowns take priority over standard items. If you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
@@ -283,7 +251,7 @@ For example: `_docs/getting-started/installation.md` will be placed in a group c
 
 ## Numerical Prefix Navigation Ordering
 
-HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for both the primary navigation menu and the documentation sidebar.
+HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for the primary navigation menu.
 
 This has the great benefit of matching the navigation menu layout with the file structure view. It also works especially well with subdirectory-based navigation grouping.
 
@@ -308,25 +276,9 @@ As you can see, Hyde parses the number from the filename and uses it as the prio
 
 This feature integrates well with automatic subdirectory-based navigation grouping. Here are two useful tips:
 
-1. You can use numerical prefixes in subdirectories to control the dropdown/sidebar order.
+1. You can use numerical prefixes in subdirectories to control the dropdown order.
 2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
 
-Here is an example structure of how you could organize a documentation site:
-
-```shell
-_docs/
-  01-getting-started/
-    01-installation.md
-    02-requirements.md
-    03-configuration.md
-  02-usage/
-    01-quick-start.md
-    02-advanced-usage.md
-  03-features/
-    01-feature-1.md
-    02-feature-2.md
-```
-
 ### Customization
 
 If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.

From 8427e55bb455cc446ba07b9eb75a6691c99aae74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:29:43 +0200
Subject: [PATCH 2641/4023] Add lost section

---
 docs/creating-content/documentation-pages.md | 55 ++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 08cb115a596..5341159625b 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -272,6 +272,61 @@ Please note that this option is not added to the config file by default, as it's
 ],
 ```
 
+### Numerical Prefix Sidebar Ordering
+
+HydePHP v2 introduces sidebar item ordering based on numerical prefixes in filenames. This feature works for the documentation sidebar.
+
+This has the great benefit of matching the sidebar layout with the file structure view. It also works especially well with subdirectory-based sidebar grouping.
+
+```shell
+_docs/
+  01-installation.md     # Priority: 1
+  02-configuration.md    # Priority: 2
+  03-usage.md            # Priority: 3
+```
+
+As you can see, Hyde parses the number from the filename and uses it as the priority for the page in the sidebar, while stripping the prefix from the route key.
+
+#### Important Notes
+
+1. The numerical prefix remains part of the page identifier but is stripped from the route key.
+   For example: `_docs/01-installation.md` has route key `installation` and page identifier `01-installation`.
+2. You can delimit the numerical prefix with either a dash or an underscore.
+   For example: Both `_docs/01-installation.md` and `_docs/01_installation.md` are valid.
+3. Leading zeros are optional. `_docs/1-installation.md` is equally valid.
+
+#### Using Numerical Prefix Ordering in Subdirectories
+
+This feature integrates well with automatic subdirectory-based sidebar grouping. Here's an example of how you could organize a documentation site:
+
+```shell
+_docs/
+  01-getting-started/
+    01-installation.md
+    02-requirements.md
+    03-configuration.md
+  02-usage/
+    01-quick-start.md
+    02-advanced-usage.md
+  03-features/
+    01-feature-1.md
+    02-feature-2.md
+```
+
+Here are two useful tips:
+
+1. You can use numerical prefixes in subdirectories to control the sidebar group order.
+2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
+
+#### Customization
+
+If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
+
+```php
+// filepath: config/hyde.php
+'numerical_page_ordering' => false,
+```
+
 ### Table of Contents Settings
 
 Hyde automatically generates a table of contents for the page and adds it to the sidebar.

From 68f3d33d9d1fd8beb258938e32f3d6084a037be8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:43:03 +0200
Subject: [PATCH 2642/4023] Remove documentation for syntax with no benefit

---
 docs/creating-content/documentation-pages.md | 13 -------------
 docs/digging-deeper/navigation.md            | 13 -------------
 2 files changed, 26 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 5341159625b..3c7d7680026 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -134,19 +134,6 @@ You can also specify explicit priorities by adding a value to the array keys. Hy
 ]
 ```
 
-You could also combine these methods if desired:
-
-```php
-// filepath: config/docs.php
-'sidebar' => [
-    'order' => [
-        'readme' => 10, // Priority: 10
-        'installation', // Priority: 500
-        'getting-started', // Priority: 501
-    ]
-]
-```
-
 ### Sidebar Labels
 
 The sidebar items are labelled with the `label` property. The default label is generated from the filename of the file.
diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index 1eaa8464876..ffef925624d 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -146,19 +146,6 @@ You can also specify explicit priorities by adding a value to the array keys. We
 ]
 ```
 
-You could also combine these methods if desired:
-
-```php
-// filepath: config/hyde.php
-'navigation' => [
-    'order' => [
-        'home' => 10, // Priority: 10
-        'about', // Priority: 500
-        'contact', // Priority: 501
-    ]
-]
-```
-
 ### Changing Menu Item Labels
 
 Hyde makes a few attempts to find suitable labels for the navigation menu items to automatically create helpful titles.

From 8d06b5e6f3b4f8937badfc298ff758a231e31f3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:43:46 +0200
Subject: [PATCH 2643/4023] Normalize spelling

---
 docs/creating-content/documentation-pages.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 3c7d7680026..5bc9a900133 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -162,7 +162,7 @@ navigation:
 
 #### Automatic Subdirectory-Based Grouping
 
-You can also automatically group your documentation pages by placing source files in sub-directories.
+You can also automatically group your documentation pages by placing source files in subdirectories.
 
 For example, putting a Markdown file in `_docs/getting-started/` is equivalent to adding the same front matter seen above.
 

From c2dcb0fd2498a9cc31b779d370dd8de9c232f926 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:53:30 +0200
Subject: [PATCH 2644/4023] Restructure and improve the documentation

---
 docs/creating-content/documentation-pages.md | 27 +++++++++++++++-----
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 5bc9a900133..0819dc267e9 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -166,9 +166,7 @@ You can also automatically group your documentation pages by placing source file
 
 For example, putting a Markdown file in `_docs/getting-started/` is equivalent to adding the same front matter seen above.
 
->info Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they would overwrite each other.
-
->info Tip: When using subdirectory-based grouping, you can set the priority of the groups using the directory name as the array key in the config file.
+>warning Note that when the [flattened output paths](#using-flattened-output-paths) setting is enabled (which it is by default), the file will still be compiled to the `_site/docs/` directory like it would be if you didn't use the subdirectories. Note that this means that you can't have two documentation pages with the same filename as they would overwrite each other.
 
 ### Hiding Items
 
@@ -245,11 +243,9 @@ To quickly arrange the order of items in the sidebar, you can reorder the page i
 
 See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
 
-### Automatic Sidebar Group Labels
-
-When using the automatic sidebar grouping feature (based on subdirectories), the titles of the groups are generated from the directory names. If these are not to your liking, for example if you need to use special characters, you can override them in the Docs configuration file. The array key is the directory name, and the value is the label.
+### Setting Sidebar Group Labels
 
-Please note that this option is not added to the config file by default, as it's not a super common use case. No worries though, just add the following yourself!
+When using the automatic sidebar grouping feature the titles of the groups are generated from the subdirectory names. If these are not to your liking, for example if you need to use special characters, you can override them in the configuration file. The array key is the directory name, and the value is the label.
 
 ```php
 // Filepath: config/docs.php
@@ -259,6 +255,23 @@ Please note that this option is not added to the config file by default, as it's
 ],
 ```
 
+Please note that this option is not added to the config file by default, as it's not a super common use case. No worries though, just add the following yourself!
+
+#### Setting Group Priorities
+
+When using subdirectory-based grouping, you can set the priority of the groups using the directory name as the array key in the config file:
+
+```php
+// Filepath: config/docs.php
+'sidebar' => [
+    'order' => [
+        'readme',
+        'installation',
+        'getting-started',
+    ],
+],
+```
+
 ### Numerical Prefix Sidebar Ordering
 
 HydePHP v2 introduces sidebar item ordering based on numerical prefixes in filenames. This feature works for the documentation sidebar.

From 358bfcc81207676c44580dd8281f03987e2e83af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:57:24 +0200
Subject: [PATCH 2645/4023] Improve priority setting

---
 docs/creating-content/documentation-pages.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 0819dc267e9..2238f6777d9 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -257,9 +257,11 @@ When using the automatic sidebar grouping feature the titles of the groups are g
 
 Please note that this option is not added to the config file by default, as it's not a super common use case. No worries though, just add the following yourself!
 
-#### Setting Group Priorities
+#### Setting Sidebar Group Priorities
 
-When using subdirectory-based grouping, you can set the priority of the groups using the directory name as the array key in the config file:
+By default, each group will be assigned the lowest priority found inside the group. However, you can specify the order and priorities for sidebar group keys the same way you can for the sidebar items.
+
+Just use the sidebar group key as instead of the page identifier/route key:
 
 ```php
 // Filepath: config/docs.php

From 2d5edf6967b963010f0ff171bcd5bb2cd2796715 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 17:58:35 +0200
Subject: [PATCH 2646/4023] Add todo

---
 .../Framework/Features/Navigation/NavigationMenuGenerator.php    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
index 94976bcff51..02467e4c986 100644
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
+++ b/packages/framework/src/Framework/Features/Navigation/NavigationMenuGenerator.php
@@ -194,6 +194,7 @@ protected function normalizeGroupLabel(string $label): string
 
     protected function searchForGroupLabelInConfig(string $groupKey): ?string
     {
+        // TODO: Normalize this: sidebar_group_labels -> docs.sidebar.labels
         return $this->getConfigArray($this->generatesSidebar ? 'docs.sidebar_group_labels' : 'hyde.navigation.labels')[$groupKey] ?? null;
     }
 

From 3cbc864bae54f28e5bf33f43e2eb98757e31013b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 18:13:08 +0200
Subject: [PATCH 2647/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 998c920ef11..ac9d8bce2e2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -15,6 +15,9 @@ This serves two purposes:
 - Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
 - Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in https://github.com/hydephp/develop/pull/1799
 - The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
+- Added support for setting custom navigation items in the YAML configuration in https://github.com/hydephp/develop/pull/1818
+- Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
+- Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
@@ -23,6 +26,8 @@ This serves two purposes:
 - **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames. For more information, see below.
 - **Breaking:** The `Author::create()` method now returns an array instead of a `PostAuthor` instance. For more information, see below.
 - **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
+- **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
+- **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)

From a313579797704cf18ed5f8cc9efccf2d368f1750 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 18:13:36 +0200
Subject: [PATCH 2648/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index ac9d8bce2e2..d090a09cdca 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -48,6 +48,8 @@ This serves two purposes:
 - Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
 - Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in https://github.com/hydephp/develop/pull/1738
 - Markdown returned from includes are now trimmed of trailing whitespace and newlines in https://github.com/hydephp/develop/pull/1738
+- Reorganized and cleaned up the navigation and sidebar documentation for improved clarity.
+- Moved the sidebar documentation to the documentation pages section for better organization.
 
 ### Deprecated
 - for soon-to-be removed features.

From e2cdca688aebae71b89d08d5c9e2e3880c78cc07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 18:15:54 +0200
Subject: [PATCH 2649/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d090a09cdca..1bd2a7a4fcd 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -340,3 +340,78 @@ For example, an empty or malformed JSON file will now throw an exception like th
 
 In order to normalize the thrown exceptions, we now rethrow the `ParseException` from `Symfony/Yaml` as our custom `ParseException` to match the JSON and Markdown validation.
 Additionally, an exception will be thrown if a data file is empty, as this is unlikely to be intentional. Markdown files can have an empty body if front matter is present.
+
+## New features
+
+<!-- Editors note: Todo: Maybe move to the relevant docs... -->
+
+### Navigation configuration changes
+
+The custom navigation item configuration format has been updated to use array inputs. This change allows for more flexibility and consistency in defining navigation items.
+
+#### Old format:
+
+```php
+'navigation' => [
+    'custom_items' => [
+        'Custom Item' => '/custom-page',
+    ],
+],
+```
+
+#### New format:
+
+```php
+'navigation' => [
+    'custom_items' => [
+        ['label' => 'Custom Item', 'destination' => '/custom-page'],
+    ],
+],
+```
+
+Additionally, the `hyde.navigation.subdirectories` configuration option has been renamed to `hyde.navigation.subdirectory_display`. Update your configuration files accordingly.
+
+### YAML configuration for navigation items
+
+You can now set custom navigation items directly in your YAML configuration files. This provides an alternative to defining them in the PHP configuration files.
+
+Example:
+
+```yaml
+navigation:
+  custom_items:
+    - label: Custom Item
+      destination: /custom-page
+```
+
+### Extra attributes for navigation items
+
+Navigation items now support extra attributes, allowing you to add custom data or styling to your navigation elements. You can set these attributes in both PHP and YAML configurations.
+
+Example in PHP:
+
+```php
+'navigation' => [
+    'custom_items' => [
+        [
+            'label' => 'Custom Item',
+            'destination' => '/custom-page',
+            'attributes' => ['class' => 'special-link', 'target' => '_blank'],
+        ],
+    ],
+],
+```
+
+Example in YAML:
+
+```yaml
+navigation:
+  custom_items:
+    - label: Custom Item
+      destination: /custom-page
+      attributes:
+        class: special-link
+        target: _blank
+```
+
+These changes provide more flexibility and control over your site's navigation structure. Make sure to update your configuration files and any custom code that interacts with navigation items to align with these new formats and features.

From 84f92a9e85bba40b481e7181d7a6ea301d829a72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 12 Jul 2024 18:17:56 +0200
Subject: [PATCH 2650/4023] Clarify test name and fix invalid option

---
 .../tests/Feature/AutomaticNavigationConfigurationsTest.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 8d3ee0e380d..1c3d0e3611d 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -899,12 +899,12 @@ public function testDocumentationPagesInSubdirectoriesAreAddedToSidebar()
         ]);
     }
 
-    public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfConfiguration()
+    public function testPagesInSubdirectoriesAreAddedToSidebarRegardlessOfHydeConfiguration()
     {
         $options = ['dropdown', 'flat', 'hidden'];
 
         foreach ($options as $option) {
-            config(['docs.sidebar.subdirectories' => $option]);
+            config(['hyde.navigation.subdirectory_display' => $option]);
 
             $this->assertSidebarEquals([[
                 'label' => 'About',

From 8d4a0a305035ffd37ad5d9b8496e9c66a870a3f7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 14:35:30 +0200
Subject: [PATCH 2651/4023] Change test teardown type

---
 packages/framework/tests/Unit/RouteKeyTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index cc30305afd5..3e0e8bf9943 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -145,7 +145,7 @@ public function testItDoesNotExtractNonNumericalFilenamePrefixes()
         $this->assertSame('abc-bar', RouteKey::fromPage(InMemoryPage::class, 'abc-bar')->get());
     }
 
-    public static function tearDownAfterClass(): void
+    protected function tearDown(): void
     {
         MarkdownPage::setOutputDirectory('');
     }

From 8db58efc1259033665922b75bf89eccecdb930ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 14:35:38 +0200
Subject: [PATCH 2652/4023] Test with Markdown page

---
 .../framework/tests/Unit/RouteKeyTest.php     | 40 +++++++++----------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index 3e0e8bf9943..6cf11b989cb 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -97,52 +97,52 @@ public function testFromPageWithCustomNestedOutputDirectory()
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefix()
     {
-        $this->assertSame('test', RouteKey::fromPage(InMemoryPage::class, '01-test')->get());
+        $this->assertSame('test', RouteKey::fromPage(MarkdownPage::class, '01-test')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithKebabCaseSyntax()
     {
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '01-foo')->get());
-        $this->assertSame('bar', RouteKey::fromPage(InMemoryPage::class, '02-bar')->get());
-        $this->assertSame('baz', RouteKey::fromPage(InMemoryPage::class, '03-baz')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '01-foo')->get());
+        $this->assertSame('bar', RouteKey::fromPage(MarkdownPage::class, '02-bar')->get());
+        $this->assertSame('baz', RouteKey::fromPage(MarkdownPage::class, '03-baz')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithSnakeCaseSyntax()
     {
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '01_foo')->get());
-        $this->assertSame('bar', RouteKey::fromPage(InMemoryPage::class, '02_bar')->get());
-        $this->assertSame('baz', RouteKey::fromPage(InMemoryPage::class, '03_baz')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '01_foo')->get());
+        $this->assertSame('bar', RouteKey::fromPage(MarkdownPage::class, '02_bar')->get());
+        $this->assertSame('baz', RouteKey::fromPage(MarkdownPage::class, '03_baz')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixRegardlessOfLeadingZeroes()
     {
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '0123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '00123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '000123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(InMemoryPage::class, '0000123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '0123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '00123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '000123-foo')->get());
+        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '0000123-foo')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixForNestedIdentifiers()
     {
-        $this->assertSame('foo/bar', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar')->get());
-        $this->assertSame('foo/bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/bar/02-baz')->get());
-        $this->assertSame('foo/bar/baz', RouteKey::fromPage(InMemoryPage::class, 'foo/01-bar/03-baz')->get());
+        $this->assertSame('foo/bar', RouteKey::fromPage(MarkdownPage::class, 'foo/01-bar')->get());
+        $this->assertSame('foo/bar/baz', RouteKey::fromPage(MarkdownPage::class, 'foo/bar/02-baz')->get());
+        $this->assertSame('foo/bar/baz', RouteKey::fromPage(MarkdownPage::class, 'foo/01-bar/03-baz')->get());
     }
 
     public function testItDoesNotExtractCoreIdentifierPartFromNumericalFilenamePrefixWhenFeatureIsDisabled()
     {
         self::mockConfig(['hyde.numerical_page_ordering' => false]);
 
-        $this->assertSame('01-test', RouteKey::fromPage(InMemoryPage::class, '01-test')->get());
-        $this->assertSame('01-home', RouteKey::fromPage(InMemoryPage::class, '01-home')->get());
-        $this->assertSame('01-404', RouteKey::fromPage(InMemoryPage::class, '01-404')->get());
+        $this->assertSame('01-test', RouteKey::fromPage(MarkdownPage::class, '01-test')->get());
+        $this->assertSame('01-home', RouteKey::fromPage(MarkdownPage::class, '01-home')->get());
+        $this->assertSame('01-404', RouteKey::fromPage(MarkdownPage::class, '01-404')->get());
     }
 
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
-        $this->assertSame('foo-bar', RouteKey::fromPage(InMemoryPage::class, 'foo-bar')->get());
-        $this->assertSame('abc-bar', RouteKey::fromPage(InMemoryPage::class, 'abc-bar')->get());
+        $this->assertSame('foo-bar', RouteKey::fromPage(MarkdownPage::class, 'foo-bar')->get());
+        $this->assertSame('abc-bar', RouteKey::fromPage(MarkdownPage::class, 'abc-bar')->get());
     }
 
     protected function tearDown(): void

From 78cd93721510cfe075916d4f87fb13f601bed13b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 14:36:04 +0200
Subject: [PATCH 2653/4023] Move up teardown method

---
 packages/framework/tests/Unit/RouteKeyTest.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index 6cf11b989cb..a59848feb51 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -20,6 +20,11 @@ class RouteKeyTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
 
+    protected function tearDown(): void
+    {
+        MarkdownPage::setOutputDirectory('');
+    }
+
     public function testMake()
     {
         $this->assertEquals(RouteKey::make('foo'), new RouteKey('foo'));
@@ -144,9 +149,4 @@ public function testItDoesNotExtractNonNumericalFilenamePrefixes()
         $this->assertSame('foo-bar', RouteKey::fromPage(MarkdownPage::class, 'foo-bar')->get());
         $this->assertSame('abc-bar', RouteKey::fromPage(MarkdownPage::class, 'abc-bar')->get());
     }
-
-    protected function tearDown(): void
-    {
-        MarkdownPage::setOutputDirectory('');
-    }
 }

From 087f183ed8b0b8a0047ae80cfa19750934acb977 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 14:36:33 +0200
Subject: [PATCH 2654/4023] Inline teardown where needed

---
 packages/framework/tests/Unit/RouteKeyTest.php | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index a59848feb51..6fe51cc403c 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -20,11 +20,6 @@ class RouteKeyTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
 
-    protected function tearDown(): void
-    {
-        MarkdownPage::setOutputDirectory('');
-    }
-
     public function testMake()
     {
         $this->assertEquals(RouteKey::make('foo'), new RouteKey('foo'));
@@ -92,12 +87,14 @@ public function testFromPageWithCustomOutputDirectory()
     {
         MarkdownPage::setOutputDirectory('foo');
         $this->assertEquals(new RouteKey('foo/bar'), RouteKey::fromPage(MarkdownPage::class, 'bar'));
+        MarkdownPage::setOutputDirectory('');
     }
 
     public function testFromPageWithCustomNestedOutputDirectory()
     {
         MarkdownPage::setOutputDirectory('foo/bar');
         $this->assertEquals(new RouteKey('foo/bar/baz'), RouteKey::fromPage(MarkdownPage::class, 'baz'));
+        MarkdownPage::setOutputDirectory('');
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefix()

From 71549442574d1948632b0a11b9c0878ba197db5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:00:03 +0200
Subject: [PATCH 2655/4023] Add booting/booted callbacks to the base
 HydeExtension class

---
 .../src/Foundation/Concerns/HydeExtension.php  | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HydeExtension.php b/packages/framework/src/Foundation/Concerns/HydeExtension.php
index 0eb9f6ccf0c..08f30b7e040 100644
--- a/packages/framework/src/Foundation/Concerns/HydeExtension.php
+++ b/packages/framework/src/Foundation/Concerns/HydeExtension.php
@@ -77,4 +77,22 @@ public function discoverRoutes(RouteCollection $collection): void
     {
         //
     }
+
+    /**
+     * Register a callback to be run before the kernel is booted.
+     * Override this method to define your booting logic.
+     */
+    public function booting(): void
+    {
+        //
+    }
+
+    /**
+     * Register a callback to be run after the kernel is booted.
+     * Override this method to define your booted logic.
+     */
+    public function booted(): void
+    {
+        //
+    }
 }

From 9b4b19fd6c6c9e65aa5c3e059e7b28d1ce80d3bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:00:54 +0200
Subject: [PATCH 2656/4023] Introduce local variable so we can use the instance

---
 .../framework/src/Foundation/Concerns/ManagesExtensions.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/ManagesExtensions.php b/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
index 080c74e5344..ec63d54074f 100644
--- a/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
+++ b/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
@@ -54,7 +54,8 @@ public function registerExtension(string $extension): void
             throw new InvalidArgumentException("Extension [$extension] is already registered.");
         }
 
-        $this->extensions[$extension] = new $extension();
+        $instance = new $extension();
+        $this->extensions[$extension] = $instance;
     }
 
     /**

From c1bf78fecb050bfbdfa1f022ccbd332a8672599a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:01:34 +0200
Subject: [PATCH 2657/4023] Register the boot callbacks with the extension

Much more elegant idea by Claude, compared to what I was thinking (looping extensions before/after boot)
---
 .../framework/src/Foundation/Concerns/ManagesExtensions.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/ManagesExtensions.php b/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
index ec63d54074f..52de766e3cf 100644
--- a/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
+++ b/packages/framework/src/Foundation/Concerns/ManagesExtensions.php
@@ -56,6 +56,9 @@ public function registerExtension(string $extension): void
 
         $instance = new $extension();
         $this->extensions[$extension] = $instance;
+
+        $this->booting([$instance, 'booting']);
+        $this->booted([$instance, 'booted']);
     }
 
     /**

From 838dc6e4d0885624c59f4ac7ab89ca5e910be20e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:09:09 +0200
Subject: [PATCH 2658/4023] Update test to cover new callback methods

---
 .../Feature/HydeExtensionFeatureTest.php      | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
index 6ed83dd5793..a773e97f4f4 100644
--- a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
+++ b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
@@ -51,7 +51,7 @@ public function testHandlerMethodsAreCalledByDiscovery()
 
         $this->kernel->boot();
 
-        $this->assertSame(['files', 'pages', 'routes'], HydeTestExtension::$callCache);
+        $this->assertSame(['booting', 'files', 'pages', 'routes', 'booted'], HydeTestExtension::$callCache);
 
         HydeTestExtension::$callCache = [];
     }
@@ -133,6 +133,19 @@ public function testCustomRegisteredPagesAreDiscoveredByTheRouteCollectionClass(
         $this->assertEquals(new Route(new TestPageClass('bar')), Routes::get('foo/bar'));
     }
 
+    public function testBootingAndBootedMethodsAreCalled()
+    {
+        $this->kernel->registerExtension(BootableTestExtension::class);
+
+        $this->assertSame([], BootableTestExtension::$callCache);
+
+        $this->kernel->boot();
+
+        $this->assertSame(['booting', 'booted'], BootableTestExtension::$callCache);
+
+        BootableTestExtension::$callCache = [];
+    }
+
     protected function markTestSuccessful(): void
     {
         $this->assertTrue(true);
@@ -165,6 +178,16 @@ public function discoverRoutes(RouteCollection $collection): void
     {
         static::$callCache[] = 'routes';
     }
+
+    public function booting(): void
+    {
+        static::$callCache[] = 'booting';
+    }
+
+    public function booted(): void
+    {
+        static::$callCache[] = 'booted';
+    }
 }
 
 class HydeExtensionTestPage extends HydePage
@@ -225,3 +248,18 @@ public static function getCalled(string $method): array
         return self::$callCache[$method];
     }
 }
+
+class BootableTestExtension extends HydeExtension
+{
+    public static array $callCache = [];
+
+    public function booting(): void
+    {
+        static::$callCache[] = 'booting';
+    }
+
+    public function booted(): void
+    {
+        static::$callCache[] = 'booted';
+    }
+}

From 2f44b8501b7118bd69c85b3c9668eadef6204da3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:18:33 +0200
Subject: [PATCH 2659/4023] Document extension booting and booted callbacks

---
 docs/architecture-concepts/extensions-api.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/architecture-concepts/extensions-api.md b/docs/architecture-concepts/extensions-api.md
index d71e6a258b5..5213e0f139d 100644
--- a/docs/architecture-concepts/extensions-api.md
+++ b/docs/architecture-concepts/extensions-api.md
@@ -92,6 +92,24 @@ public function discoverRoutes(RouteCollection $collection): void;
 Any of these can be implemented in your extension class, and they will be called during the discovery. As you can see,
 the instance of the discovery collection is injected into the method for you to interact with.
 
+### Booting and Booted Callbacks
+
+In addition to the discovery handlers, you can also define `booting` and `booted` callbacks in your extension class. These methods allow you to run custom logic before and after the kernel boots, respectively.
+
+```php
+class JsonPageExtension extends HydeExtension {
+    public function booting(): void {
+        // This runs before the kernel boots, meaning pages have not been discovered yet
+    }
+
+    public function booted(): void {
+        // This runs after the kernel has booted, meaning pages have been discovered
+    }
+}
+```
+
+These methods are particularly useful for setting up your extension's environment or performing post-boot operations.
+
 #### Discovery handler example
 
 Let's go crazy and implement a discovery handler to collect `JsonPage` files from an external API! We will do this

From 798a948939358b09a23c928a8ebbae792e4e7543 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:26:38 +0200
Subject: [PATCH 2660/4023] Update extension boot callbacks to inject the
 kernel

---
 docs/architecture-concepts/extensions-api.md  | 12 +++++++----
 .../src/Foundation/Concerns/HydeExtension.php |  5 +++--
 .../Feature/HydeExtensionFeatureTest.php      | 21 ++++++++++++-------
 3 files changed, 24 insertions(+), 14 deletions(-)

diff --git a/docs/architecture-concepts/extensions-api.md b/docs/architecture-concepts/extensions-api.md
index 5213e0f139d..2a5588927ae 100644
--- a/docs/architecture-concepts/extensions-api.md
+++ b/docs/architecture-concepts/extensions-api.md
@@ -94,21 +94,25 @@ the instance of the discovery collection is injected into the method for you to
 
 ### Booting and Booted Callbacks
 
-In addition to the discovery handlers, you can also define `booting` and `booted` callbacks in your extension class. These methods allow you to run custom logic before and after the kernel boots, respectively.
+In addition to the discovery handlers, you can also define `booting` and `booted` callbacks in your extension class. These methods allow you to run custom logic before and after the kernel boots, respectively. Both methods receive the `HydeKernel` instance as a parameter, allowing you to interact with the kernel directly.
 
 ```php
+use Hyde\Foundation\HydeKernel;
+
 class JsonPageExtension extends HydeExtension {
-    public function booting(): void {
+    public function booting(HydeKernel $kernel): void {
         // This runs before the kernel boots, meaning pages have not been discovered yet
+        // You can use $kernel to interact with the HydeKernel instance
     }
 
-    public function booted(): void {
+    public function booted(HydeKernel $kernel): void {
         // This runs after the kernel has booted, meaning pages have been discovered
+        // You can use $kernel to interact with the HydeKernel instance
     }
 }
 ```
 
-These methods are particularly useful for setting up your extension's environment or performing post-boot operations.
+These callbacks provide powerful hooks into the Hyde system, allowing your extensions to integrate deeply and modify Hyde's behavior as needed. The `booting` callback can be used to set up the system with information needed to discover pages, while the `booted` callback can can be used to perform operations requiring knowledge of discovered data, even modifying them if needed.
 
 #### Discovery handler example
 
diff --git a/packages/framework/src/Foundation/Concerns/HydeExtension.php b/packages/framework/src/Foundation/Concerns/HydeExtension.php
index 08f30b7e040..d274ddbd663 100644
--- a/packages/framework/src/Foundation/Concerns/HydeExtension.php
+++ b/packages/framework/src/Foundation/Concerns/HydeExtension.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\PageCollection;
 use Hyde\Foundation\Kernel\RouteCollection;
@@ -82,7 +83,7 @@ public function discoverRoutes(RouteCollection $collection): void
      * Register a callback to be run before the kernel is booted.
      * Override this method to define your booting logic.
      */
-    public function booting(): void
+    public function booting(HydeKernel $kernel): void
     {
         //
     }
@@ -91,7 +92,7 @@ public function booting(): void
      * Register a callback to be run after the kernel is booted.
      * Override this method to define your booted logic.
      */
-    public function booted(): void
+    public function booted(HydeKernel $kernel): void
     {
         //
     }
diff --git a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
index a773e97f4f4..dc46d02c503 100644
--- a/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
+++ b/packages/framework/tests/Feature/HydeExtensionFeatureTest.php
@@ -133,7 +133,7 @@ public function testCustomRegisteredPagesAreDiscoveredByTheRouteCollectionClass(
         $this->assertEquals(new Route(new TestPageClass('bar')), Routes::get('foo/bar'));
     }
 
-    public function testBootingAndBootedMethodsAreCalled()
+    public function testBootingAndBootedMethodsAreCalledWithKernel()
     {
         $this->kernel->registerExtension(BootableTestExtension::class);
 
@@ -141,7 +141,12 @@ public function testBootingAndBootedMethodsAreCalled()
 
         $this->kernel->boot();
 
-        $this->assertSame(['booting', 'booted'], BootableTestExtension::$callCache);
+        $this->assertCount(2, BootableTestExtension::$callCache);
+
+        $this->assertInstanceOf(HydeKernel::class, BootableTestExtension::$callCache['booting']);
+        $this->assertInstanceOf(HydeKernel::class, BootableTestExtension::$callCache['booted']);
+        $this->assertSame($this->kernel, BootableTestExtension::$callCache['booting']);
+        $this->assertSame($this->kernel, BootableTestExtension::$callCache['booted']);
 
         BootableTestExtension::$callCache = [];
     }
@@ -179,12 +184,12 @@ public function discoverRoutes(RouteCollection $collection): void
         static::$callCache[] = 'routes';
     }
 
-    public function booting(): void
+    public function booting(HydeKernel $kernel): void
     {
         static::$callCache[] = 'booting';
     }
 
-    public function booted(): void
+    public function booted(HydeKernel $kernel): void
     {
         static::$callCache[] = 'booted';
     }
@@ -253,13 +258,13 @@ class BootableTestExtension extends HydeExtension
 {
     public static array $callCache = [];
 
-    public function booting(): void
+    public function booting(HydeKernel $kernel): void
     {
-        static::$callCache[] = 'booting';
+        static::$callCache['booting'] = $kernel;
     }
 
-    public function booted(): void
+    public function booted(HydeKernel $kernel): void
     {
-        static::$callCache[] = 'booted';
+        static::$callCache['booted'] = $kernel;
     }
 }

From 9db32e71ca0d2c9e60c09ca1c2b35a30a4e63deb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:32:10 +0200
Subject: [PATCH 2661/4023] Remove parts of documentation that should be
 obvious

---
 docs/architecture-concepts/extensions-api.md                 | 2 --
 packages/framework/src/Foundation/Concerns/HydeExtension.php | 2 --
 2 files changed, 4 deletions(-)

diff --git a/docs/architecture-concepts/extensions-api.md b/docs/architecture-concepts/extensions-api.md
index 2a5588927ae..e894444b6c0 100644
--- a/docs/architecture-concepts/extensions-api.md
+++ b/docs/architecture-concepts/extensions-api.md
@@ -102,12 +102,10 @@ use Hyde\Foundation\HydeKernel;
 class JsonPageExtension extends HydeExtension {
     public function booting(HydeKernel $kernel): void {
         // This runs before the kernel boots, meaning pages have not been discovered yet
-        // You can use $kernel to interact with the HydeKernel instance
     }
 
     public function booted(HydeKernel $kernel): void {
         // This runs after the kernel has booted, meaning pages have been discovered
-        // You can use $kernel to interact with the HydeKernel instance
     }
 }
 ```
diff --git a/packages/framework/src/Foundation/Concerns/HydeExtension.php b/packages/framework/src/Foundation/Concerns/HydeExtension.php
index d274ddbd663..1435eb8e929 100644
--- a/packages/framework/src/Foundation/Concerns/HydeExtension.php
+++ b/packages/framework/src/Foundation/Concerns/HydeExtension.php
@@ -81,7 +81,6 @@ public function discoverRoutes(RouteCollection $collection): void
 
     /**
      * Register a callback to be run before the kernel is booted.
-     * Override this method to define your booting logic.
      */
     public function booting(HydeKernel $kernel): void
     {
@@ -90,7 +89,6 @@ public function booting(HydeKernel $kernel): void
 
     /**
      * Register a callback to be run after the kernel is booted.
-     * Override this method to define your booted logic.
      */
     public function booted(HydeKernel $kernel): void
     {

From 4f339b6acf516feb45f7c7939b1088f93f502bcf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:32:30 +0200
Subject: [PATCH 2662/4023] Update code documentation

---
 .../framework/src/Foundation/Concerns/HydeExtension.php     | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HydeExtension.php b/packages/framework/src/Foundation/Concerns/HydeExtension.php
index 1435eb8e929..54f99977325 100644
--- a/packages/framework/src/Foundation/Concerns/HydeExtension.php
+++ b/packages/framework/src/Foundation/Concerns/HydeExtension.php
@@ -80,7 +80,8 @@ public function discoverRoutes(RouteCollection $collection): void
     }
 
     /**
-     * Register a callback to be run before the kernel is booted.
+     * Register a callback to be run before the kernel is booted,
+     * and before file/page/route discovery has begun.
      */
     public function booting(HydeKernel $kernel): void
     {
@@ -88,7 +89,8 @@ public function booting(HydeKernel $kernel): void
     }
 
     /**
-     * Register a callback to be run after the kernel is booted.
+     * Register a callback to be run after the kernel is booted,
+     * and after file/page/route discovery has completed.
      */
     public function booted(HydeKernel $kernel): void
     {

From b8547688682bccac90d3701469b649cc8cb343f7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:33:53 +0200
Subject: [PATCH 2663/4023] Restructure documentation

---
 docs/architecture-concepts/extensions-api.md              | 8 +++++---
 .../framework/src/Foundation/Concerns/HydeExtension.php   | 4 ++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/architecture-concepts/extensions-api.md b/docs/architecture-concepts/extensions-api.md
index e894444b6c0..7c6f4c7928e 100644
--- a/docs/architecture-concepts/extensions-api.md
+++ b/docs/architecture-concepts/extensions-api.md
@@ -101,16 +101,18 @@ use Hyde\Foundation\HydeKernel;
 
 class JsonPageExtension extends HydeExtension {
     public function booting(HydeKernel $kernel): void {
-        // This runs before the kernel boots, meaning pages have not been discovered yet
+        // This runs before the kernel boots and before running auto-discovery
     }
 
     public function booted(HydeKernel $kernel): void {
-        // This runs after the kernel has booted, meaning pages have been discovered
+        // This runs after the kernel boots and after running auto-discovery
     }
 }
 ```
 
-These callbacks provide powerful hooks into the Hyde system, allowing your extensions to integrate deeply and modify Hyde's behavior as needed. The `booting` callback can be used to set up the system with information needed to discover pages, while the `booted` callback can can be used to perform operations requiring knowledge of discovered data, even modifying them if needed.
+The `booting` callback can be used to set up the system with information needed to discover pages, while the `booted` callback can can be used to perform operations requiring knowledge of discovered data, even modifying them if needed.
+
+These callbacks provide powerful hooks into the Hyde system, allowing your extensions to integrate deeply and modify Hyde's behavior as needed. 
 
 #### Discovery handler example
 
diff --git a/packages/framework/src/Foundation/Concerns/HydeExtension.php b/packages/framework/src/Foundation/Concerns/HydeExtension.php
index 54f99977325..b83a83780bc 100644
--- a/packages/framework/src/Foundation/Concerns/HydeExtension.php
+++ b/packages/framework/src/Foundation/Concerns/HydeExtension.php
@@ -81,7 +81,7 @@ public function discoverRoutes(RouteCollection $collection): void
 
     /**
      * Register a callback to be run before the kernel is booted,
-     * and before file/page/route discovery has begun.
+     * which is before any file/page/route discovery has begun.
      */
     public function booting(HydeKernel $kernel): void
     {
@@ -90,7 +90,7 @@ public function booting(HydeKernel $kernel): void
 
     /**
      * Register a callback to be run after the kernel is booted,
-     * and after file/page/route discovery has completed.
+     * which is after file/page/route discovery has completed.
      */
     public function booted(HydeKernel $kernel): void
     {

From af8714f88508626247d154c70d11d66412945d0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 13 Jul 2024 19:35:24 +0200
Subject: [PATCH 2664/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1bd2a7a4fcd..443c767eab7 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -15,6 +15,7 @@ This serves two purposes:
 - Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
 - Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in https://github.com/hydephp/develop/pull/1799
 - The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
+- Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily in https://github.com/hydephp/develop/pull/1847
 - Added support for setting custom navigation items in the YAML configuration in https://github.com/hydephp/develop/pull/1818
 - Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827

From ff9dfb3a328dc95ce89915882ec71b869fe3a71d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 16 Jul 2024 13:58:21 +0200
Subject: [PATCH 2665/4023] Update CustomExceptionsTest.php

---
 packages/framework/tests/Unit/CustomExceptionsTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index af058ac7390..97927a1760b 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -136,6 +136,13 @@ public function testParseExceptionWithTxtExtension()
         $this->assertSame("Invalid data in file: 'example.txt'", $exception->getMessage());
     }
 
+    public function testParseExceptionWithJsonExtension()
+    {
+        $exception = new ParseException('example.json');
+
+        $this->assertSame("Invalid Json in file: 'example.json'", $exception->getMessage());
+    }
+
     public function testParseExceptionWithUnsupportedExtension()
     {
         $exception = new ParseException('example.foo');

From a26ea882776b699a30b4122d82a3fa337464ff4c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 17 Jul 2024 15:01:57 +0200
Subject: [PATCH 2666/4023] Update develop.iml

---
 .idea/develop.iml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.idea/develop.iml b/.idea/develop.iml
index c351593718e..d5243986813 100644
--- a/.idea/develop.iml
+++ b/.idea/develop.iml
@@ -14,11 +14,6 @@
       <sourceFolder url="file://$MODULE_DIR$/packages/hyde/app" isTestSource="false" packagePrefix="App\" />
       <sourceFolder url="file://$MODULE_DIR$/packages/testing/src" isTestSource="false" packagePrefix="Hyde\Testing\" />
       <sourceFolder url="file://$MODULE_DIR$/packages/ui-kit/src" isTestSource="false" packagePrefix="Hyde\UIKit\" />
-      <sourceFolder url="file://$MODULE_DIR$/packages/framework/tests/Feature" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/packages/framework/tests/Unit" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/packages/hyde/tests/Feature" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/packages/publications/tests" isTestSource="true" />
-      <sourceFolder url="file://$MODULE_DIR$/packages/realtime-compiler/tests/Integration" isTestSource="true" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyde" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyde/framework" />
       <excludeFolder url="file://$MODULE_DIR$/packages/realtime-compiler/vendor/hyde" />

From 6240e9bad72ddf5d5777a980148e4fa195c43afe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 12:45:16 +0200
Subject: [PATCH 2667/4023] Don't proxy search index files as they are now
 based on page objects

Fixes https://github.com/hydephp/develop/issues/1802. We could add some code to save to disk if preview saving is enabled, something for later. I considered having this read from the file if it exists, but think that is not intuitive as it then won't change with content changes.
---
 packages/realtime-compiler/src/Routing/Router.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/realtime-compiler/src/Routing/Router.php b/packages/realtime-compiler/src/Routing/Router.php
index 963d3cef51c..37c0aac9a06 100644
--- a/packages/realtime-compiler/src/Routing/Router.php
+++ b/packages/realtime-compiler/src/Routing/Router.php
@@ -63,6 +63,11 @@ protected function shouldProxy(Request $request): bool
             return false;
         }
 
+        // Don't proxy the search.json file, as it's generated on the fly.
+        if (str_ends_with($request->path, 'search.json')) {
+            return false;
+        }
+
         // The page is not a web page, so we assume it should be proxied.
         return true;
     }

From 9d3920387247184db3a39f50cf135ee0151859bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 12:47:44 +0200
Subject: [PATCH 2668/4023] Remove old search index proxying code

---
 packages/realtime-compiler/src/Routing/Router.php | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/packages/realtime-compiler/src/Routing/Router.php b/packages/realtime-compiler/src/Routing/Router.php
index 37c0aac9a06..9fb7dcf5e46 100644
--- a/packages/realtime-compiler/src/Routing/Router.php
+++ b/packages/realtime-compiler/src/Routing/Router.php
@@ -11,7 +11,6 @@
 use Hyde\RealtimeCompiler\Concerns\SendsErrorResponses;
 use Hyde\RealtimeCompiler\Models\FileObject;
 use Hyde\RealtimeCompiler\Concerns\InteractsWithLaravel;
-use Hyde\Framework\Actions\GeneratesDocumentationSearchIndex;
 
 class Router
 {
@@ -77,10 +76,6 @@ protected function shouldProxy(Request $request): bool
      */
     protected function proxyStatic(): Response
     {
-        if ($this->request->path === '/docs/search.json') {
-            $this->generateSearchIndex();
-        }
-
         $path = AssetFileLocator::find($this->request->path);
 
         if ($path === null) {
@@ -96,14 +91,4 @@ protected function proxyStatic(): Response
             'Content-Length' => $file->getContentLength(),
         ]);
     }
-
-    /**
-     * Generate the documentation search index.
-     */
-    protected function generateSearchIndex(): void
-    {
-        $this->bootApplication();
-
-        GeneratesDocumentationSearchIndex::handle();
-    }
 }

From 36168364cef5319201d7abd8f3fc53eccba05993 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 16:14:27 +0200
Subject: [PATCH 2669/4023] Remove deprecated method
 `FeaturedImage::isRemote()`

Tie in with https://github.com/hydephp/develop/pull/1882
---
 .../Features/Blogging/Models/FeaturedImage.php       | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index ebb3522c883..0f42f961c87 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -9,7 +9,6 @@
 use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 use Hyde\Support\BuildWarnings;
-use JetBrains\PhpStorm\Deprecated;
 use Illuminate\Support\Facades\Http;
 use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Framework\Exceptions\FileNotFoundException;
@@ -241,15 +240,4 @@ protected function getContentLengthForRemoteImage(): int
 
         return 0;
     }
-
-    /**
-     * @codeCoverageIgnore Deprecated method.
-     *
-     * @deprecated This method will be removed in v2.0. Please use `Hyperlinks::isRemote` instead.
-     */
-    #[Deprecated(reason: 'Replaced by the \Hyde\Foundation\Kernel\Hyperlinks::isRemote method', replacement: '\Hyde\Foundation\Kernel\Hyperlinks::isRemote(%parametersList%)', since: '1.8.0')]
-    public static function isRemote(string $source): bool
-    {
-        return Hyperlinks::isRemote($source);
-    }
 }

From cc3733fcf1145cae24c3f48871e9d8828ddb14a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 16:19:03 +0200
Subject: [PATCH 2670/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 443c767eab7..e19121252fc 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -62,6 +62,7 @@ This serves two purposes:
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now returning `null` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
+- Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
 
 ### Fixed
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784

From 58673694cc1946bfe63f71eea20cd2aaabb61e3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 16:21:20 +0200
Subject: [PATCH 2671/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index e19121252fc..11438f7662f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -343,6 +343,26 @@ For example, an empty or malformed JSON file will now throw an exception like th
 In order to normalize the thrown exceptions, we now rethrow the `ParseException` from `Symfony/Yaml` as our custom `ParseException` to match the JSON and Markdown validation.
 Additionally, an exception will be thrown if a data file is empty, as this is unlikely to be intentional. Markdown files can have an empty body if front matter is present.
 
+### Removal of `FeaturedImage::isRemote()` method
+
+The `FeaturedImage::isRemote()` method has been removed in v2.0. This method was deprecated in v1.8.0 and has now been completely removed.
+
+#### Upgrade guide
+
+If you were using `FeaturedImage::isRemote()` in your code, you should replace it with `Hyperlinks::isRemote()`. Here's how to update your code:
+
+```php
+// Old code
+FeaturedImage::isRemote($source);
+
+// New code
+use Hyde\Foundation\Kernel\Hyperlinks;
+
+Hyperlinks::isRemote($source);
+```
+
+This change was implemented in https://github.com/hydephp/develop/pull/1883. Make sure to update any instances of `FeaturedImage::isRemote()` in your codebase to ensure compatibility with HydePHP v2.0.
+
 ## New features
 
 <!-- Editors note: Todo: Maybe move to the relevant docs... -->

From 2382709bfae243629c292335dfe8bc7722169b89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 18:31:58 +0200
Subject: [PATCH 2672/4023] Update blog posts to use `BlogPosting` Schema.org
 type

This is a more specific subset of Article. Fixes https://github.com/hydephp/develop/issues/1842
---
 RELEASE_NOTES.md                                                | 1 +
 .../framework/resources/views/components/post/article.blade.php | 2 +-
 .../framework/tests/Feature/StaticSiteBuilderPostModuleTest.php | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 11438f7662f..d5ce619590d 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,6 +39,7 @@ This serves two purposes:
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
+- Minor: Updated the blog post layout to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
 - Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
diff --git a/packages/framework/resources/views/components/post/article.blade.php b/packages/framework/resources/views/components/post/article.blade.php
index 9d54df611f2..bed0f77e4fc 100644
--- a/packages/framework/resources/views/components/post/article.blade.php
+++ b/packages/framework/resources/views/components/post/article.blade.php
@@ -1,4 +1,4 @@
-<article aria-label="Article" id="{{ $page->identifier }}" itemscope itemtype="https://schema.org/Article"
+<article aria-label="Article" id="{{ $page->identifier }}" itemscope itemtype="https://schema.org/BlogPosting"
     @class(['post-article mx-auto', config('markdown.prose_classes', 'prose dark:prose-invert'), 'torchlight-enabled' => Features::hasTorchlight()])>
     <meta itemprop="identifier" content="{{ $page->identifier }}">
     @if($page->getCanonicalUrl() !== null)
diff --git a/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
index 10af1b63700..18f4743ecdb 100644
--- a/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
+++ b/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
@@ -96,7 +96,7 @@ public function testPostContainsExpectedMetaTags()
     public function testPostContainsExpectedItemprops()
     {
         $this->inspectHtml([
-            'itemtype="https://schema.org/Article"',
+            'itemtype="https://schema.org/BlogPosting"',
             'itemtype="https://schema.org/Person"',
             'itemprop="identifier"',
             'itemprop="headline"',

From 12001d9dea7bc2c0a6570acb49c139eb3b3e40d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 18:39:21 +0200
Subject: [PATCH 2673/4023] Update blog post feeds to use `BlogPosting`
 Schema.org type

This is a more specific subset of Article. See https://github.com/hydephp/develop/issues/1842
---
 RELEASE_NOTES.md                                                | 2 +-
 .../resources/views/components/article-excerpt.blade.php        | 2 +-
 packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d5ce619590d..b4899c03a0c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,7 +39,7 @@ This serves two purposes:
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
-- Minor: Updated the blog post layout to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
+- Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
 - Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 666c628ab0f..3e4574f2343 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -1,5 +1,5 @@
 @php /** @var \Hyde\Pages\MarkdownPost $post */ @endphp
-<article class="mt-4 mb-8" itemscope itemtype="https://schema.org/Article">
+<article class="mt-4 mb-8" itemscope itemtype="https://schema.org/BlogPosting">
     <meta itemprop="identifier" content="{{ $post->identifier }}">
     @if(Hyde::hasSiteUrl())
         <meta itemprop="url" content="{{ Hyde::url('posts/' . $post->identifier) }}">
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index 48e1818fcf0..508b009f5cd 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -24,7 +24,7 @@ protected function renderTestView(MarkdownPost $post): string
     public function testComponentCanBeRendered()
     {
         $view = $this->renderTestView(MarkdownPost::make());
-        $this->assertStringContainsString('https://schema.org/Article', $view);
+        $this->assertStringContainsString('https://schema.org/BlogPosting', $view);
     }
 
     public function testComponentRendersPostData()

From 0492507e0d84078dd3129e02577aa1c84bc2589b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 18:49:01 +0200
Subject: [PATCH 2674/4023] Add more rich metadata to article excerpt content

---
 .../resources/views/components/article-excerpt.blade.php      | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 3e4574f2343..15d2dd07e7e 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -7,7 +7,7 @@
 
     <header>
         <a href="{{ $post->getRoute() }}" class="block w-fit">
-            <h2 class="text-2xl font-bold text-gray-700 hover:text-gray-900 dark:text-gray-200 dark:hover:text-white transition-colors duration-75">
+            <h2 itemprop="headline" class="text-2xl font-bold text-gray-700 hover:text-gray-900 dark:text-gray-200 dark:hover:text-white transition-colors duration-75">
                 {{ $post->data('title') ?? $post->title }}
             </h2>
         </a>
@@ -31,7 +31,7 @@
 
     @if($post->data('description') !== null)
         <section role="doc-abstract" aria-label="Excerpt">
-            <p class="leading-relaxed my-1">
+            <p itemprop="description" class="leading-relaxed my-1">
                 {{ $post->data('description') }}
             </p>
         </section>

From 58b87e02b0b599453ab55ae1a0ab6e4dce440569 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 18:50:22 +0200
Subject: [PATCH 2675/4023] Update the blog post feed to be a rich item list

---
 .../views/components/article-excerpt.blade.php        |  2 +-
 .../views/components/blog-post-feed.blade.php         | 11 ++++++++---
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 15d2dd07e7e..c16a9cd01e3 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -1,5 +1,5 @@
 @php /** @var \Hyde\Pages\MarkdownPost $post */ @endphp
-<article class="mt-4 mb-8" itemscope itemtype="https://schema.org/BlogPosting">
+<article itemprop="item" itemscope itemtype="https://schema.org/BlogPosting">
     <meta itemprop="identifier" content="{{ $post->identifier }}">
     @if(Hyde::hasSiteUrl())
         <meta itemprop="url" content="{{ Hyde::url('posts/' . $post->identifier) }}">
diff --git a/packages/framework/resources/views/components/blog-post-feed.blade.php b/packages/framework/resources/views/components/blog-post-feed.blade.php
index 6276589e72b..652c22988a5 100644
--- a/packages/framework/resources/views/components/blog-post-feed.blade.php
+++ b/packages/framework/resources/views/components/blog-post-feed.blade.php
@@ -1,3 +1,8 @@
-@foreach(MarkdownPost::getLatestPosts() as $post)
-    @include('hyde::components.article-excerpt')
-@endforeach
\ No newline at end of file
+<ol itemscope itemtype="https://schema.org/ItemList">
+@foreach(MarkdownPost::getLatestPosts()->values() as $index => $post)
+    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" class="mt-4 mb-8">
+        <meta itemprop="position" content="{{ $index + 1 }}">
+        @include('hyde::components.article-excerpt')
+    </li>
+  @endforeach
+</ol>
\ No newline at end of file

From 9ee426e0af4f56bc803af08436354f1e3873a613 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 18:52:52 +0200
Subject: [PATCH 2676/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index b4899c03a0c..f1fca25c216 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -40,6 +40,7 @@ This serves two purposes:
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
 - Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
+- Added more rich markup data to blog post components in https://github.com/hydephp/develop/pull/1888 (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
 - Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
 - Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749

From 84d38c4fafe4dcd461ca72d5b4bf54c27c5e5d1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 19:16:18 +0200
Subject: [PATCH 2677/4023] Update blog post feed to add image metadata when
 available

---
 .../components/article-excerpt.blade.php      |  4 +++
 .../Unit/Views/ArticleExcerptViewTest.php     | 25 +++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 4e1e148ee00..3cba5bf7c46 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -5,6 +5,10 @@
         <meta itemprop="url" content="{{ $post->getCanonicalUrl()  }}">
     @endif
 
+    @isset($post->image)
+         <meta itemprop="image" content="{{ $post->image }}">
+    @endif
+
     <header>
         <a href="{{ $post->getRoute() }}" class="block w-fit">
             <h2 itemprop="headline" class="text-2xl font-bold text-gray-700 hover:text-gray-900 dark:text-gray-200 dark:hover:text-white transition-colors duration-75">
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index 508b009f5cd..04187b8a3fc 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -73,4 +73,29 @@ public function testThereIsACommaAfterDateStringWhenThereIsAAuthor()
 
         $this->assertStringContainsString('Jan 1st, 2022</span>,', $view);
     }
+
+    public function testItempropImageIsNotAddedWhenThereIsNoImage()
+    {
+        $view = $this->renderTestView(MarkdownPost::make());
+        $this->assertStringNotContainsString('itemprop="image"', $view);
+    }
+
+    public function testItempropImageIsAddedWhenThereIsAnImage()
+    {
+        // Test with local path
+        $viewLocal = $this->renderTestView(MarkdownPost::make(matter: [
+            'image' => 'path/to/local/image.jpg',
+        ]));
+
+        $this->assertStringContainsString('itemprop="image"', $viewLocal);
+        $this->assertStringContainsString('content="media/path/to/local/image.jpg"', $viewLocal);
+
+        // Test with remote URL
+        $viewRemote = $this->renderTestView(MarkdownPost::make(matter: [
+            'image' => 'https://example.com/image.jpg',
+        ]));
+
+        $this->assertStringContainsString('itemprop="image"', $viewRemote);
+        $this->assertStringContainsString('content="https://example.com/image.jpg"', $viewRemote);
+    }
 }

From 0cc1816fc2cd0bf056a2bd9a0fa206e987be816f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 19:24:27 +0200
Subject: [PATCH 2678/4023] Update article excerpt date span to be a time
 element

---
 .../resources/views/components/article-excerpt.blade.php    | 2 +-
 .../framework/tests/Unit/Views/ArticleExcerptViewTest.php   | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 3cba5bf7c46..131d805ff1b 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -20,7 +20,7 @@
     <footer>
         @isset($post->date)
             <span class="opacity-75">
-                <span itemprop="dateCreated datePublished">{{ $post->date->short }}</span>{{ isset($post->author) ? ',' : '' }}
+                <time itemprop="dateCreated datePublished">{{ $post->date->short }}</time>{{ isset($post->author) ? ',' : '' }}
             </span>
         @endisset
         @isset($post->author)
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index 04187b8a3fc..64d233f008d 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -60,8 +60,8 @@ public function testThereIsNoCommaAfterDateStringWhenThereIsNoAuthor()
             'date' => '2022-01-01',
         ]));
 
-        $this->assertStringContainsString('Jan 1st, 2022</span>', $view);
-        $this->assertStringNotContainsString('Jan 1st, 2022</span>,', $view);
+        $this->assertStringContainsString('Jan 1st, 2022</time>', $view);
+        $this->assertStringNotContainsString('Jan 1st, 2022</time>,', $view);
     }
 
     public function testThereIsACommaAfterDateStringWhenThereIsAAuthor()
@@ -71,7 +71,7 @@ public function testThereIsACommaAfterDateStringWhenThereIsAAuthor()
             'author' => 'John Doe',
         ]));
 
-        $this->assertStringContainsString('Jan 1st, 2022</span>,', $view);
+        $this->assertStringContainsString('Jan 1st, 2022</time>,', $view);
     }
 
     public function testItempropImageIsNotAddedWhenThereIsNoImage()

From bd8b709785e1974f893f86adf9f747b932acc9ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 19:28:32 +0200
Subject: [PATCH 2679/4023] Add the proper datetime to metadata element

---
 .../resources/views/components/article-excerpt.blade.php | 2 +-
 .../tests/Unit/Views/ArticleExcerptViewTest.php          | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/article-excerpt.blade.php b/packages/framework/resources/views/components/article-excerpt.blade.php
index 131d805ff1b..92ae514acc2 100644
--- a/packages/framework/resources/views/components/article-excerpt.blade.php
+++ b/packages/framework/resources/views/components/article-excerpt.blade.php
@@ -20,7 +20,7 @@
     <footer>
         @isset($post->date)
             <span class="opacity-75">
-                <time itemprop="dateCreated datePublished">{{ $post->date->short }}</time>{{ isset($post->author) ? ',' : '' }}
+                <time itemprop="dateCreated datePublished" datetime="{{ $post->date->datetime }}">{{ $post->date->short }}</time>{{ isset($post->author) ? ',' : '' }}
             </span>
         @endisset
         @isset($post->author)
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index 64d233f008d..d49838ccd16 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -54,6 +54,15 @@ public function testComponentRendersPostWithAuthorObject()
         $this->assertStringContainsString('John Doe', $view);
     }
 
+    public function testMetadataHasIsoDate()
+    {
+        $view = $this->renderTestView(MarkdownPost::make(matter: [
+            'date' => '2022-01-01',
+        ]));
+
+        $this->assertStringContainsString('<time itemprop="dateCreated datePublished" datetime="2022-01-01T00:00:00+00:00">Jan 1st, 2022</time>', $view);
+    }
+
     public function testThereIsNoCommaAfterDateStringWhenThereIsNoAuthor()
     {
         $view = $this->renderTestView(MarkdownPost::make(matter: [

From bba209b1866f19255341fe14feade17c1844cb3c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 19:29:13 +0200
Subject: [PATCH 2680/4023] Test date is not added when not set

---
 .../framework/tests/Unit/Views/ArticleExcerptViewTest.php  | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index d49838ccd16..ea83bdc457a 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -63,6 +63,13 @@ public function testMetadataHasIsoDate()
         $this->assertStringContainsString('<time itemprop="dateCreated datePublished" datetime="2022-01-01T00:00:00+00:00">Jan 1st, 2022</time>', $view);
     }
 
+    public function testDateIsNotAddedWhenNotSet()
+    {
+        $view = $this->renderTestView(MarkdownPost::make());
+
+        $this->assertStringNotContainsString('<time', $view);
+    }
+
     public function testThereIsNoCommaAfterDateStringWhenThereIsNoAuthor()
     {
         $view = $this->renderTestView(MarkdownPost::make(matter: [

From 790654c980839540fc04adc5fce83900d5b4933c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 23 Jul 2024 19:44:13 +0200
Subject: [PATCH 2681/4023] Revert to throw an exception when trying to get
 unconfigured base URL

---
 RELEASE_NOTES.md                                      |  4 ++--
 .../src/Foundation/Concerns/ForwardsHyperlinks.php    |  2 +-
 .../framework/src/Foundation/Kernel/Hyperlinks.php    | 11 +++++++----
 packages/framework/src/Hyde.php                       |  2 +-
 packages/framework/src/helpers.php                    |  2 +-
 packages/framework/tests/Feature/HelpersTest.php      |  3 +++
 .../Unit/Foundation/HyperlinksUrlPathHelpersTest.php  |  8 ++++++--
 7 files changed, 21 insertions(+), 11 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index f1fca25c216..56c25e5f345 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -38,7 +38,7 @@ This serves two purposes:
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
 - Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
-- Minor: Updated the `Hyde::url()` helper to return `null` instead of throwing a `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760
+- Minor: Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760 and https://github.com/hydephp/develop/pull/1890
 - Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
 - Added more rich markup data to blog post components in https://github.com/hydephp/develop/pull/1888 (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
 - Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
@@ -61,7 +61,7 @@ This serves two purposes:
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
-- Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now returning `null` if no base URL is set in https://github.com/hydephp/develop/pull/1760
+- Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 - Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index d5b87105f0e..9d194fd5f42 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -33,7 +33,7 @@ public function asset(string $name, bool $preferQualifiedUrl = false): string
         return $this->hyperlinks->asset($name, $preferQualifiedUrl);
     }
 
-    public function url(string $path = ''): ?string
+    public function url(string $path = ''): string
     {
         return $this->hyperlinks->url($path);
     }
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 15ae4b27a52..e127cdfaa82 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Kernel;
 
 use Hyde\Facades\Config;
+use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Framework\Exceptions\FileNotFoundException;
@@ -139,9 +140,11 @@ public function hasSiteUrl(): bool
      * Return a qualified URL to the supplied path if a base URL is set.
      *
      * @param  string  $path  An optional relative path suffix. Omit to return the base URL.
-     * @return string|null The qualified URL, or null if the base URL is not set and no path is provided.
+     * @return string The qualified URL, or the base URL if no path is supplied.
+     *
+     * @throws BadMethodCallException If the site URL is not set in the configuration and no path is supplied.
      */
-    public function url(string $path = ''): ?string
+    public function url(string $path = ''): string
     {
         $path = $this->formatLink(trim($path, '/'));
 
@@ -159,8 +162,8 @@ public function url(string $path = ''): ?string
             return $path;
         }
 
-        // User is trying to get the base URL, but it's not set
-        return null;
+        // User is trying to get the base URL, but it's not set, so we throw an exception.
+        throw new BadMethodCallException('The site URL is not set in the configuration.');
     }
 
     /**
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 3c13830d05a..cc309a3b21c 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -39,7 +39,7 @@
  * @method static string relativeLink(string $destination)
  * @method static string mediaLink(string $destination, bool $validate = false)
  * @method static string asset(string $name, bool $preferQualifiedUrl = false)
- * @method static string|null url(string $path = '')
+ * @method static string url(string $path = '')
  * @method static Route|null route(string $key)
  * @method static string makeTitle(string $value)
  * @method static string normalizeNewlines(string $string)
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 4f47188b222..34e8f9da12b 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -42,7 +42,7 @@ function route(string $key): ?Hyde\Support\Models\Route
             /**
              * Get a qualified URL to the supplied path if a base URL is set.
              */
-            function url(string $path = ''): ?string
+            function url(string $path = ''): string
             {
                 return hyde()->url($path);
             }
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 4ea9d3a0c29..300342e4735 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -6,6 +6,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use BadMethodCallException;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
@@ -178,6 +179,7 @@ public function testUrlFunctionWithoutBaseUrl()
     public function testUrlFunctionWithoutBaseUrlOrPath()
     {
         $this->app['config']->set(['hyde.url' => null]);
+        $this->expectException(BadMethodCallException::class);
         $this->assertNull(url());
     }
 
@@ -185,6 +187,7 @@ public function testUrlFunctionWithoutBaseUrlOrPath()
     public function testUrlFunctionWithLocalhostBaseUrlButNoPath()
     {
         $this->app['config']->set(['hyde.url' => 'http://localhost']);
+        $this->expectException(BadMethodCallException::class);
         $this->assertNull(url());
     }
 
diff --git a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
index 14b18821ce3..bc3a1f0061f 100644
--- a/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
+++ b/packages/framework/tests/Unit/Foundation/HyperlinksUrlPathHelpersTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Foundation;
 
+use BadMethodCallException;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Testing\TestCase;
@@ -153,11 +154,14 @@ public function testQualifiedUrlHelperWithAlreadyQualifiedUrlStillFormatsPathWit
         $this->assertSame('http://localhost/foo/bar', $this->class->url('http://localhost/foo/bar/'));
     }
 
-    public function testQualifiedUrlReturnsNullWhenNoSiteUrlIsSet()
+    public function testQualifiedUrlThrowsExceptionWhenNoSiteUrlIsSet()
     {
         $this->withSiteUrl(null);
 
-        $this->assertNull($this->class->url());
+        $this->expectException(BadMethodCallException::class);
+        $this->expectExceptionMessage('The site URL is not set in the configuration.');
+
+        $this->class->url();
     }
 
     public function testHelperFallsBackToRelativeLinksWhenNoSiteUrlIsSet()

From 3026fa4934b42fcdc12f85059ee712fa9369f2fb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:00:10 +0200
Subject: [PATCH 2682/4023] Fix formatting

---
 .../resources/views/components/blog-post-feed.blade.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/blog-post-feed.blade.php b/packages/framework/resources/views/components/blog-post-feed.blade.php
index 652c22988a5..0cfa5ad87a4 100644
--- a/packages/framework/resources/views/components/blog-post-feed.blade.php
+++ b/packages/framework/resources/views/components/blog-post-feed.blade.php
@@ -4,5 +4,5 @@
         <meta itemprop="position" content="{{ $index + 1 }}">
         @include('hyde::components.article-excerpt')
     </li>
-  @endforeach
+@endforeach
 </ol>
\ No newline at end of file

From 571ebc94e8e2071c95f59cbce9b89928d7ef2062 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:12:04 +0200
Subject: [PATCH 2683/4023] Update to expect author data being used

---
 packages/framework/tests/Feature/HomepageViewTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/HomepageViewTest.php b/packages/framework/tests/Feature/HomepageViewTest.php
index 49193cd72c1..a7e48f25ed1 100644
--- a/packages/framework/tests/Feature/HomepageViewTest.php
+++ b/packages/framework/tests/Feature/HomepageViewTest.php
@@ -52,7 +52,7 @@ public function testPostFeedHomepageWithPosts()
     {
         Hyde::shareViewData(new BladePage('index'));
 
-        Hyde::pages()->add(new MarkdownPost('hello-world', ['author' => 'Mr Hyde'], 'Hello World!'));
+        Hyde::pages()->add(new MarkdownPost('hello-world', ['author' => 'mr_hyde'], 'Hello World!'));
 
         $view = $this->view(view('hyde::homepages.post-feed'));
 
@@ -61,6 +61,6 @@ public function testPostFeedHomepageWithPosts()
             ->assertSeeHtml('id="post-feed"')
             ->assertSeeHtml('<a href="posts/hello-world.html"')
             ->assertSee('Hello World!')
-            ->assertSee('Mr Hyde');
+            ->assertSee('Mr. Hyde');
     }
 }

From 0f33d15ec68756f16329de9b4f02b788c541c91b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:32:08 +0200
Subject: [PATCH 2684/4023] Reformat view

---
 .../views/components/blog-post-feed.blade.php        | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/blog-post-feed.blade.php b/packages/framework/resources/views/components/blog-post-feed.blade.php
index 0cfa5ad87a4..59e4ca4bd76 100644
--- a/packages/framework/resources/views/components/blog-post-feed.blade.php
+++ b/packages/framework/resources/views/components/blog-post-feed.blade.php
@@ -1,8 +1,8 @@
 <ol itemscope itemtype="https://schema.org/ItemList">
-@foreach(MarkdownPost::getLatestPosts()->values() as $index => $post)
-    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" class="mt-4 mb-8">
-        <meta itemprop="position" content="{{ $index + 1 }}">
-        @include('hyde::components.article-excerpt')
-    </li>
-@endforeach
+    @foreach(MarkdownPost::getLatestPosts()->values() as $index => $post)
+        <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" class="mt-4 mb-8">
+            <meta itemprop="position" content="{{ $index + 1 }}">
+            @include('hyde::components.article-excerpt')
+        </li>
+    @endforeach
 </ol>
\ No newline at end of file

From 5bc606845357dac7f7f32ef12a44e0ef4dcf9324 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:40:16 +0200
Subject: [PATCH 2685/4023] Create BlogPostFeedComponentViewTest.php

---
 .../Views/BlogPostFeedComponentViewTest.php   | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php

diff --git a/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php b/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php
new file mode 100644
index 00000000000..cbc5b8c1f03
--- /dev/null
+++ b/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php
@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Views;
+
+use Hyde\Hyde;
+use Hyde\Testing\TestCase;
+use Hyde\Pages\MarkdownPost;
+use Hyde\Testing\TestsBladeViews;
+
+/**
+ * @coversNothing Test to ensure the blog post feed component can be rendered
+ */
+class BlogPostFeedComponentViewTest extends TestCase
+{
+    use TestsBladeViews;
+
+    public function testPostFeedWithoutPosts()
+    {
+        $view = $this->view(view('hyde::components.blog-post-feed'));
+
+        $view->assertSeeHtml('<ol itemscope itemtype="https://schema.org/ItemList">')
+            ->assertDontSee('<li')
+            ->assertDontSee('<article')
+            ->assertSeeHtml('</ol>');
+    }
+
+    public function testPostFeedWithSinglePost()
+    {
+        Hyde::pages()->add(new MarkdownPost('hello-world', ['author' => 'mr_hyde'], 'Hello World!'));
+
+        $view = $this->view(view('hyde::components.blog-post-feed'));
+
+        $view->assertSeeHtml('<ol itemscope itemtype="https://schema.org/ItemList">')
+            ->assertSeeHtml('<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem"')
+            ->assertSeeHtml('<meta itemprop="position" content="1">')
+            ->assertSeeHtml('<article itemprop="item" itemscope itemtype="https://schema.org/BlogPosting">')
+            ->assertSeeHtml('<meta itemprop="identifier" content="hello-world">')
+            ->assertSeeHtml('<a href="posts/hello-world.html"')
+            ->assertSeeHtml('<h2 itemprop="headline"')
+            ->assertSee('Hello World')
+            ->assertSeeHtml('<span itemprop="author" itemscope itemtype="https://schema.org/Person">')
+            ->assertSee('Mr. Hyde')
+            ->assertSeeHtml('<p itemprop="description"')
+            ->assertSee('Hello World!')
+            ->assertSeeHtml('<a href="posts/hello-world.html"')
+            ->assertSee('Read post')
+            ->assertSeeHtml('</article>')
+            ->assertSeeHtml('</li>')
+            ->assertSeeHtml('</ol>');
+    }
+
+    public function testPostFeedWithMultiplePosts()
+    {
+        Hyde::pages()->add(new MarkdownPost('hello-world', ['author' => 'mr_hyde'], 'Hello World!'));
+        Hyde::pages()->add(new MarkdownPost('second-post', ['author' => 'jane_doe'], 'Another post content'));
+
+        $view = $this->view(view('hyde::components.blog-post-feed'));
+
+        $view->assertSeeHtml('<ol itemscope itemtype="https://schema.org/ItemList">')
+            ->assertSeeHtml('<meta itemprop="position" content="1">')
+            ->assertSeeHtml('<meta itemprop="position" content="2">')
+            ->assertSee('Hello World')
+            ->assertSee('Mr. Hyde')
+            ->assertSee('Another post content')
+            ->assertSee('Jane Doe')
+            ->assertSeeHtml('</ol>');
+    }
+}

From 6cbefcfeff892681cb4d9c586e69ecdf81b03739 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:43:39 +0200
Subject: [PATCH 2686/4023] Refactor to use the loop variable instead of the
 index

---
 .../resources/views/components/blog-post-feed.blade.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/blog-post-feed.blade.php b/packages/framework/resources/views/components/blog-post-feed.blade.php
index 59e4ca4bd76..67a6c6d9e19 100644
--- a/packages/framework/resources/views/components/blog-post-feed.blade.php
+++ b/packages/framework/resources/views/components/blog-post-feed.blade.php
@@ -1,7 +1,7 @@
 <ol itemscope itemtype="https://schema.org/ItemList">
-    @foreach(MarkdownPost::getLatestPosts()->values() as $index => $post)
+    @foreach(MarkdownPost::getLatestPosts() as $post)
         <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" class="mt-4 mb-8">
-            <meta itemprop="position" content="{{ $index + 1 }}">
+            <meta itemprop="position" content="{{ $loop->iteration }}">
             @include('hyde::components.article-excerpt')
         </li>
     @endforeach

From 8bb51164b1aa3038a1871b2884883384cede6d33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:54:11 +0200
Subject: [PATCH 2687/4023] Support passing posts to the component

---
 .../views/components/blog-post-feed.blade.php |  2 +-
 .../Views/BlogPostFeedComponentViewTest.php   | 22 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/blog-post-feed.blade.php b/packages/framework/resources/views/components/blog-post-feed.blade.php
index 67a6c6d9e19..e3943b3532a 100644
--- a/packages/framework/resources/views/components/blog-post-feed.blade.php
+++ b/packages/framework/resources/views/components/blog-post-feed.blade.php
@@ -1,5 +1,5 @@
 <ol itemscope itemtype="https://schema.org/ItemList">
-    @foreach(MarkdownPost::getLatestPosts() as $post)
+    @foreach($posts ?? MarkdownPost::getLatestPosts() as $post)
         <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" class="mt-4 mb-8">
             <meta itemprop="position" content="{{ $loop->iteration }}">
             @include('hyde::components.article-excerpt')
diff --git a/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php b/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php
index cbc5b8c1f03..9cf2198fce8 100644
--- a/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/BlogPostFeedComponentViewTest.php
@@ -67,4 +67,26 @@ public function testPostFeedWithMultiplePosts()
             ->assertSee('Jane Doe')
             ->assertSeeHtml('</ol>');
     }
+
+    public function testPostFeedWithCustomPosts()
+    {
+        Hyde::pages()->add(new MarkdownPost('global', ['author' => 'default'], 'Ignored post content'));
+
+        $customPosts = [
+            new MarkdownPost('hello-world', ['author' => 'mr_hyde'], 'Hello World!'),
+            new MarkdownPost('second-post', ['author' => 'jane_doe'], 'Another post content'),
+        ];
+
+        $view = $this->view(view('hyde::components.blog-post-feed', [
+            'posts' => $customPosts,
+        ]));
+
+        $view->assertSeeHtml('<ol itemscope itemtype="https://schema.org/ItemList">')
+            ->assertDontSee('Ignored post content')
+            ->assertSee('Hello World')
+            ->assertSee('Mr. Hyde')
+            ->assertSee('Another post content')
+            ->assertSee('Jane Doe')
+            ->assertSeeHtml('</ol>');
+    }
 }

From f74102e8e2ee7d395748de4de5f168ca25480ecb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 11:54:53 +0200
Subject: [PATCH 2688/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 56c25e5f345..1d25087a717 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -19,6 +19,7 @@ This serves two purposes:
 - Added support for setting custom navigation items in the YAML configuration in https://github.com/hydephp/develop/pull/1818
 - Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
+- You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.

From 0f5526aee870d2397d4815f1c3a48ea1586dd64f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:00:03 +0200
Subject: [PATCH 2689/4023] Create FeatureEnumTest.php

---
 .../framework/tests/Unit/FeatureEnumTest.php   | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 packages/framework/tests/Unit/FeatureEnumTest.php

diff --git a/packages/framework/tests/Unit/FeatureEnumTest.php b/packages/framework/tests/Unit/FeatureEnumTest.php
new file mode 100644
index 00000000000..2688dc7880e
--- /dev/null
+++ b/packages/framework/tests/Unit/FeatureEnumTest.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Enums\Feature
+ */
+class FeatureEnumTest extends UnitTestCase
+{
+    public function testExample()
+    {
+        $this->assertTrue(true);
+    }
+}

From e09313fb2ece38cfbde4406acfa63c67455ac34a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:00:56 +0200
Subject: [PATCH 2690/4023] Generate test with Claude

---
 .../framework/tests/Unit/FeatureEnumTest.php  | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/FeatureEnumTest.php b/packages/framework/tests/Unit/FeatureEnumTest.php
index 2688dc7880e..bc2aefb39e8 100644
--- a/packages/framework/tests/Unit/FeatureEnumTest.php
+++ b/packages/framework/tests/Unit/FeatureEnumTest.php
@@ -5,14 +5,29 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Enums\Feature;
 
 /**
  * @covers \Hyde\Enums\Feature
  */
 class FeatureEnumTest extends UnitTestCase
 {
-    public function testExample()
+    public function testEnumCasesExist()
     {
-        $this->assertTrue(true);
+        $this->assertInstanceOf(Feature::class, Feature::HtmlPages);
+        $this->assertInstanceOf(Feature::class, Feature::MarkdownPosts);
+        $this->assertInstanceOf(Feature::class, Feature::BladePages);
+        $this->assertInstanceOf(Feature::class, Feature::MarkdownPages);
+        $this->assertInstanceOf(Feature::class, Feature::DocumentationPages);
+        $this->assertInstanceOf(Feature::class, Feature::Darkmode);
+        $this->assertInstanceOf(Feature::class, Feature::DocumentationSearch);
+        $this->assertInstanceOf(Feature::class, Feature::Torchlight);
+    }
+
+    public function testEnumValuesAreUnique()
+    {
+        $values = array_map(fn($case) => $case->name, Feature::cases());
+        $uniqueValues = array_unique($values);
+        $this->assertSame(count($values), count($uniqueValues));
     }
 }

From 39e62be7070efef12a61b177fd8bdfc608e1f2be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:01:04 +0200
Subject: [PATCH 2691/4023] Add a `Feature::fromName()` enum helper

---
 packages/framework/src/Enums/Feature.php       |  7 +++++++
 .../framework/tests/Unit/FeatureEnumTest.php   | 18 ++++++++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 85694270e0c..36dbaa013c9 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Enums;
 
+use function constant;
+
 /**
  * A configurable feature that belongs to the Features class.
  *
@@ -24,4 +26,9 @@ enum Feature
 
     // Integrations
     case Torchlight;
+
+    public static function fromName(string $name): self
+    {
+        return constant("self::$name");
+    }
 }
diff --git a/packages/framework/tests/Unit/FeatureEnumTest.php b/packages/framework/tests/Unit/FeatureEnumTest.php
index bc2aefb39e8..d2b81923443 100644
--- a/packages/framework/tests/Unit/FeatureEnumTest.php
+++ b/packages/framework/tests/Unit/FeatureEnumTest.php
@@ -24,6 +24,24 @@ public function testEnumCasesExist()
         $this->assertInstanceOf(Feature::class, Feature::Torchlight);
     }
 
+    public function testFromNameMethod()
+    {
+        $this->assertSame(Feature::HtmlPages, Feature::fromName('HtmlPages'));
+        $this->assertSame(Feature::MarkdownPosts, Feature::fromName('MarkdownPosts'));
+        $this->assertSame(Feature::BladePages, Feature::fromName('BladePages'));
+        $this->assertSame(Feature::MarkdownPages, Feature::fromName('MarkdownPages'));
+        $this->assertSame(Feature::DocumentationPages, Feature::fromName('DocumentationPages'));
+        $this->assertSame(Feature::Darkmode, Feature::fromName('Darkmode'));
+        $this->assertSame(Feature::DocumentationSearch, Feature::fromName('DocumentationSearch'));
+        $this->assertSame(Feature::Torchlight, Feature::fromName('Torchlight'));
+    }
+
+    public function testFromNameMethodThrowsExceptionForInvalidName()
+    {
+        $this->expectException(\Error::class);
+        Feature::fromName('InvalidFeatureName');
+    }
+
     public function testEnumValuesAreUnique()
     {
         $values = array_map(fn($case) => $case->name, Feature::cases());

From f7cc5ed718ef8e948b23f5f3f6a2b8a0a46e4244 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:04:09 +0200
Subject: [PATCH 2692/4023] Update helper to return null if not defined

---
 packages/framework/src/Enums/Feature.php          | 7 ++++++-
 packages/framework/tests/Unit/FeatureEnumTest.php | 5 ++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index 36dbaa013c9..ed9f40cb6df 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Enums;
 
+use function defined;
 use function constant;
 
 /**
@@ -27,8 +28,12 @@ enum Feature
     // Integrations
     case Torchlight;
 
-    public static function fromName(string $name): self
+    public static function fromName(string $name): ?self
     {
+        if (! defined("self::$name")) {
+            return null;
+        }
+
         return constant("self::$name");
     }
 }
diff --git a/packages/framework/tests/Unit/FeatureEnumTest.php b/packages/framework/tests/Unit/FeatureEnumTest.php
index d2b81923443..d1d724830ed 100644
--- a/packages/framework/tests/Unit/FeatureEnumTest.php
+++ b/packages/framework/tests/Unit/FeatureEnumTest.php
@@ -36,10 +36,9 @@ public function testFromNameMethod()
         $this->assertSame(Feature::Torchlight, Feature::fromName('Torchlight'));
     }
 
-    public function testFromNameMethodThrowsExceptionForInvalidName()
+    public function testFromNameMethodReturnsNullForInvalidName()
     {
-        $this->expectException(\Error::class);
-        Feature::fromName('InvalidFeatureName');
+        $this->assertNull(Feature::fromName('InvalidName'));
     }
 
     public function testEnumValuesAreUnique()

From de729eb99abee1af09e9d2d2fa3e44dd45d230a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:04:39 +0200
Subject: [PATCH 2693/4023] Document method

Matching the PHP tryFrom method documentation
---
 packages/framework/src/Enums/Feature.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Enums/Feature.php b/packages/framework/src/Enums/Feature.php
index ed9f40cb6df..2c854356686 100644
--- a/packages/framework/src/Enums/Feature.php
+++ b/packages/framework/src/Enums/Feature.php
@@ -28,6 +28,7 @@ enum Feature
     // Integrations
     case Torchlight;
 
+    /** Translates a case name into the corresponding Enum case, if any. If there is no matching case defined, it will return null. */
     public static function fromName(string $name): ?self
     {
         if (! defined("self::$name")) {

From 5ccdbec12a3e2e10bc55fbe2446501c3dcfe730b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:10:32 +0200
Subject: [PATCH 2694/4023] Clean up generated test

---
 .../framework/tests/Unit/FeatureEnumTest.php  | 27 ++++++++-----------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/FeatureEnumTest.php b/packages/framework/tests/Unit/FeatureEnumTest.php
index d1d724830ed..bb1ee28dd5a 100644
--- a/packages/framework/tests/Unit/FeatureEnumTest.php
+++ b/packages/framework/tests/Unit/FeatureEnumTest.php
@@ -12,16 +12,18 @@
  */
 class FeatureEnumTest extends UnitTestCase
 {
-    public function testEnumCasesExist()
+    public function testEnumCases()
     {
-        $this->assertInstanceOf(Feature::class, Feature::HtmlPages);
-        $this->assertInstanceOf(Feature::class, Feature::MarkdownPosts);
-        $this->assertInstanceOf(Feature::class, Feature::BladePages);
-        $this->assertInstanceOf(Feature::class, Feature::MarkdownPages);
-        $this->assertInstanceOf(Feature::class, Feature::DocumentationPages);
-        $this->assertInstanceOf(Feature::class, Feature::Darkmode);
-        $this->assertInstanceOf(Feature::class, Feature::DocumentationSearch);
-        $this->assertInstanceOf(Feature::class, Feature::Torchlight);
+        $this->assertSame([
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
+            Feature::MarkdownPages,
+            Feature::DocumentationPages,
+            Feature::Darkmode,
+            Feature::DocumentationSearch,
+            Feature::Torchlight,
+        ], Feature::cases());
     }
 
     public function testFromNameMethod()
@@ -40,11 +42,4 @@ public function testFromNameMethodReturnsNullForInvalidName()
     {
         $this->assertNull(Feature::fromName('InvalidName'));
     }
-
-    public function testEnumValuesAreUnique()
-    {
-        $values = array_map(fn($case) => $case->name, Feature::cases());
-        $uniqueValues = array_unique($values);
-        $this->assertSame(count($values), count($uniqueValues));
-    }
 }

From d7a173d3ec4da0956dab09f04bdc80c81b3ba3de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:12:02 +0200
Subject: [PATCH 2695/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 1d25087a717..05e014306af 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -20,6 +20,7 @@ This serves two purposes:
 - Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
 - You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
+- Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.

From ea17c2151423adba4de83b65abad32327c440f76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 13:48:55 +0200
Subject: [PATCH 2696/4023] Test can specify features in YAML configuration

---
 .../Feature/YamlConfigurationFeatureTest.php  | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 4bd0a733680..3100b9a6c60 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -5,7 +5,10 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Hyde;
+use ReflectionClass;
+use Hyde\Enums\Feature;
 use Hyde\Testing\TestCase;
+use Hyde\Facades\Features;
 use Illuminate\Support\Env;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
@@ -726,6 +729,50 @@ public function testAddingExtraYamlNavigationItemFieldsThrowsAnException()
         unlink('hyde.yml');
     }
 
+    public function testCanSpecifyFeaturesInYamlConfiguration()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          features:
+            - html-pages
+            - markdown-posts
+            - blade-pages
+            - markdown-pages
+            - documentation-pages
+        YAML);
+
+        $this->runBootstrappers();
+
+        $expectedFeatures = [
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
+            Feature::MarkdownPages,
+            Feature::DocumentationPages,
+        ];
+
+        // Test that the Features facade methods return the correct values
+        $this->assertTrue(Features::hasHtmlPages());
+        $this->assertTrue(Features::hasMarkdownPosts());
+        $this->assertTrue(Features::hasBladePages());
+        $this->assertTrue(Features::hasMarkdownPages());
+        $this->assertTrue(Features::hasDocumentationPages());
+        $this->assertFalse(Features::hasDarkmode());
+        $this->assertFalse(Features::hasDocumentationSearch());
+        $this->assertFalse(Features::hasTorchlight());
+
+        // Test that a disabled feature returns false
+        $this->assertFalse(Features::has(Feature::Darkmode));
+
+
+        // Use reflection to access the protected features property
+        $reflection = new ReflectionClass(Hyde::features());
+        $featuresProperty = $reflection->getProperty('features');
+        $actualFeatures = $featuresProperty->getValue(Hyde::features());
+
+        $this->assertSame($expectedFeatures, $actualFeatures);
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From d395df6f1221627c086fc036a503463430da6c9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:17:14 +0200
Subject: [PATCH 2697/4023] Support specifying features in the YAML
 configuration

---
 .../Internal/LoadYamlConfiguration.php        | 23 +++++++++
 .../Feature/YamlConfigurationFeatureTest.php  | 51 +++++++++++++++++++
 2 files changed, 74 insertions(+)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 51c9bb9df1f..1c815bc498d 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Foundation\Internal;
 
+use Hyde\Enums\Feature;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
 use Hyde\Foundation\Application;
 use Illuminate\Config\Repository;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
@@ -56,6 +58,10 @@ protected function mergeParsedConfiguration(): void
                 $data['authors'] = $this->parseAuthors($data['authors']);
             }
 
+            if ($namespace === 'hyde' && isset($data['features'])) {
+                $data['features'] = $this->parseFeatures($data['features']);
+            }
+
             $this->mergeConfiguration($namespace, Arr::undot($data ?: []));
         }
     }
@@ -77,4 +83,21 @@ protected function parseAuthors(array $authors): array
             return InvalidConfigurationException::try(fn () => [$username => PostAuthor::create($author)], $message);
         });
     }
+
+    /**
+     * @param  array<string>  $features
+     * @return array<\Hyde\Enums\Feature>
+     */
+    protected function parseFeatures(array $features): array
+    {
+        return array_map(function (string $feature): Feature {
+            $enumName = Str::studly($feature);
+            $case = Feature::fromName($enumName);
+            if (! $case) {
+                throw new InvalidConfigurationException("Invalid feature '{$feature}' specified in the YAML config file. (Feature::{$enumName} does not exist)");
+            }
+
+            return $case;
+        }, $features);
+    }
 }
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 3100b9a6c60..5f2eefb0870 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -764,6 +764,35 @@ public function testCanSpecifyFeaturesInYamlConfiguration()
         // Test that a disabled feature returns false
         $this->assertFalse(Features::has(Feature::Darkmode));
 
+        // Use reflection to access the protected features property
+        $reflection = new ReflectionClass(Hyde::features());
+        $featuresProperty = $reflection->getProperty('features');
+        $actualFeatures = $featuresProperty->getValue(Hyde::features());
+
+        $this->assertSame($expectedFeatures, $actualFeatures);
+    }
+
+    public function testCanSpecifyFeaturesInYamlConfigurationWithUnderscores()
+    {
+        $this->file('hyde.yml', <<<'YAML'
+        hyde:
+          features:
+            - html_pages
+            - markdown_posts
+            - blade_pages
+            - markdown_pages
+            - documentation_pages
+        YAML);
+
+        $this->runBootstrappers();
+
+        $expectedFeatures = [
+            Feature::HtmlPages,
+            Feature::MarkdownPosts,
+            Feature::BladePages,
+            Feature::MarkdownPages,
+            Feature::DocumentationPages,
+        ];
 
         // Use reflection to access the protected features property
         $reflection = new ReflectionClass(Hyde::features());
@@ -773,6 +802,28 @@ public function testCanSpecifyFeaturesInYamlConfiguration()
         $this->assertSame($expectedFeatures, $actualFeatures);
     }
 
+    public function testExceptionIsThrownWhenFeatureIsNotDefined()
+    {
+        $exceptionThrown = false;
+
+        file_put_contents('hyde.yml', <<<'YAML'
+        hyde:
+          features:
+            - not-a-feature
+        YAML);
+
+        try {
+            $this->runBootstrappers();
+        } catch (InvalidConfigurationException $exception) {
+            $exceptionThrown = true;
+            $this->assertSame("Invalid feature 'not-a-feature' specified in the YAML config file. (Feature::NotAFeature does not exist)", $exception->getMessage());
+        }
+
+        unlink('hyde.yml');
+
+        $this->assertTrue($exceptionThrown, 'Failed asserting that the exception was thrown.');
+    }
+
     protected function runBootstrappers(?array $withMergedConfig = null): void
     {
         $this->refreshApplication();

From 1c6381d3d277a792a6bfcaacbe4e5897c607cd58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:18:47 +0200
Subject: [PATCH 2698/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 05e014306af..3a38491bf1c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -21,6 +21,7 @@ This serves two purposes:
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
 - You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
+- Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.

From 61457cdaddc917cbbb7c94d42e2109902cdfae76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:22:27 +0200
Subject: [PATCH 2699/4023] Cleanup the code

---
 .../src/Foundation/Internal/LoadYamlConfiguration.php      | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 1c815bc498d..1a39dc46948 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -91,10 +91,11 @@ protected function parseAuthors(array $authors): array
     protected function parseFeatures(array $features): array
     {
         return array_map(function (string $feature): Feature {
-            $enumName = Str::studly($feature);
-            $case = Feature::fromName($enumName);
+            $name = Str::studly($feature);
+            $case = Feature::fromName($name);
+
             if (! $case) {
-                throw new InvalidConfigurationException("Invalid feature '{$feature}' specified in the YAML config file. (Feature::{$enumName} does not exist)");
+                throw new InvalidConfigurationException("Invalid feature '{$feature}' specified in the YAML config file. (Feature::{$name} does not exist)");
             }
 
             return $case;

From 2a97871d285dcd2e0b4ad211fb68dfa4fd1c52ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 14:29:32 +0200
Subject: [PATCH 2700/4023] Unwrap curly braces

---
 .../framework/src/Foundation/Internal/LoadYamlConfiguration.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
index 1a39dc46948..7a0e07e9d03 100644
--- a/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
+++ b/packages/framework/src/Foundation/Internal/LoadYamlConfiguration.php
@@ -95,7 +95,7 @@ protected function parseFeatures(array $features): array
             $case = Feature::fromName($name);
 
             if (! $case) {
-                throw new InvalidConfigurationException("Invalid feature '{$feature}' specified in the YAML config file. (Feature::{$name} does not exist)");
+                throw new InvalidConfigurationException("Invalid feature '$feature' specified in the YAML config file. (Feature::$name does not exist)");
             }
 
             return $case;

From c201d3a911e563d84d1c2ada7540fef1159b8df9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 16:27:49 +0200
Subject: [PATCH 2701/4023] Update the build service to group together dynamic
 pages

---
 .../framework/src/Framework/Services/BuildService.php    | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/src/Framework/Services/BuildService.php b/packages/framework/src/Framework/Services/BuildService.php
index e275ed2dd39..37d489afe8d 100644
--- a/packages/framework/src/Framework/Services/BuildService.php
+++ b/packages/framework/src/Framework/Services/BuildService.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Services;
 
 use Hyde\Hyde;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\RouteCollection;
 use Hyde\Framework\Actions\StaticPageBuilder;
@@ -62,6 +63,10 @@ protected function compilePagesForClass(string $pageClass): void
 
     protected function getClassPluralName(string $pageClass): string
     {
+        if ($pageClass === InMemoryPage::class) {
+            return 'Dynamic Pages';
+        }
+
         return preg_replace('/([a-z])([A-Z])/', '$1 $2', class_basename($pageClass)).'s';
     }
 
@@ -69,6 +74,10 @@ protected function getClassPluralName(string $pageClass): string
     protected function getPageTypes(): array
     {
         return Hyde::pages()->map(function (HydePage $page): string {
+            if ($page instanceof InMemoryPage) {
+                return InMemoryPage::class;
+            }
+
             return $page::class;
         })->unique()->values()->toArray();
     }

From cf0bfc8a4cfb23b991c3ad654ab6e40039d671bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 16:33:02 +0200
Subject: [PATCH 2702/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3a38491bf1c..2c37ec7a021 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -56,6 +56,7 @@ This serves two purposes:
 - Markdown returned from includes are now trimmed of trailing whitespace and newlines in https://github.com/hydephp/develop/pull/1738
 - Reorganized and cleaned up the navigation and sidebar documentation for improved clarity.
 - Moved the sidebar documentation to the documentation pages section for better organization.
+- The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 
 ### Deprecated
 - for soon-to-be removed features.

From 37e5921bc1b46cd98b133668f6859922571b7a23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 18:39:43 +0100
Subject: [PATCH 2703/4023] Initial feature abstract

---
 docs/digging-deeper/advanced-markdown.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index bf58e739fd1..3b13d463bed 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -156,6 +156,14 @@ anything within the path label will be rendered as HTML. This means you can add
 ```
 ````
 
+### Dynamic Markdown links
+
+In order to create automatically resolved links from your pages and posts, you can use the special Hyde Markdown link syntax.
+
+For all the supported syntax options, Hyde will resolve a relative link based on the current page being rendered.
+
+Since this happens in our Markdown processor, this will work regardless of if you have custom HTML or Blade enabled for your site.
+
 ### Limitations
 
 The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.

From 1f9912865a541e331c97f92364a10363331be61c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 18:39:48 +0100
Subject: [PATCH 2704/4023] Add examples

---
 docs/digging-deeper/advanced-markdown.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 3b13d463bed..0256ed6458f 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -164,6 +164,24 @@ For all the supported syntax options, Hyde will resolve a relative link based on
 
 Since this happens in our Markdown processor, this will work regardless of if you have custom HTML or Blade enabled for your site.
 
+#### Resolving a route
+
+```markdown
+[Home](hyde::route('home'))
+```
+
+#### Resolving a relative link
+
+```markdown
+[Home](hyde::relativeLink('home'))
+```
+
+#### Resolving a media asset
+
+```markdown
+![Image](hyde::media('image.jpg'))
+```
+
 ### Limitations
 
 The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.

From 04dcd92ddbfd8bc395df8d9d40917cb378033a3c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 25 Feb 2024 18:43:05 +0100
Subject: [PATCH 2705/4023] Streamline examples

---
 docs/digging-deeper/advanced-markdown.md | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 0256ed6458f..bf2240e6c93 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -164,21 +164,14 @@ For all the supported syntax options, Hyde will resolve a relative link based on
 
 Since this happens in our Markdown processor, this will work regardless of if you have custom HTML or Blade enabled for your site.
 
-#### Resolving a route
-
 ```markdown
+<!-- Resolving a route -->
 [Home](hyde::route('home'))
-```
 
-#### Resolving a relative link
-
-```markdown
+<!-- Resolving a relative link -->
 [Home](hyde::relativeLink('home'))
-```
-
-#### Resolving a media asset
 
-```markdown
+<!-- Resolving a media asset -->
 ![Image](hyde::media('image.jpg'))
 ```
 

From eec58870c6ff389c90244bd5f701ab52872dce78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:15:06 +0200
Subject: [PATCH 2706/4023] Match the Hyde facade methods

---
 docs/digging-deeper/advanced-markdown.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index bf2240e6c93..fd9803663a1 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -172,7 +172,7 @@ Since this happens in our Markdown processor, this will work regardless of if yo
 [Home](hyde::relativeLink('home'))
 
 <!-- Resolving a media asset -->
-![Image](hyde::media('image.jpg'))
+![Image](hyde::asset('image.jpg'))
 ```
 
 ### Limitations

From 397da8e0045aba6e59a0104a1f83a89c919cc477 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:24:25 +0200
Subject: [PATCH 2707/4023] Create DynamicMarkdownLinksTest.php

---
 .../tests/Feature/DynamicMarkdownLinksTest.php | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 packages/framework/tests/Feature/DynamicMarkdownLinksTest.php

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
new file mode 100644
index 00000000000..eae8ef2be58
--- /dev/null
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Hyde
+ */
+class DynamicMarkdownLinksTest extends TestCase
+{
+    public function testExample()
+    {
+        $this->assertTrue(true);
+    }
+}

From 63bab3b8308b95d6cabb0772a448c8690e24bfd1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:17:36 +0200
Subject: [PATCH 2708/4023] Create DynamicMarkdownLinkProcessor.php

---
 .../Processing/DynamicMarkdownLinkProcessor.php        | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
new file mode 100644
index 00000000000..24b2415c298
--- /dev/null
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Markdown\Processing;
+
+class DynamicMarkdownLinkProcessor
+{
+    //
+}

From d1ee654e231b6ecdcc2152a608abd5edc719504c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:17:51 +0200
Subject: [PATCH 2709/4023] Implements MarkdownPostProcessorContract

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 24b2415c298..ce913e077d5 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -4,7 +4,9 @@
 
 namespace Hyde\Markdown\Processing;
 
-class DynamicMarkdownLinkProcessor
+use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
+
+class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     //
 }

From a2e30520d8e03088afc0763f0167899174d209ac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:24:16 +0200
Subject: [PATCH 2710/4023] Draft postprocess method

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index ce913e077d5..a47642414a4 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -8,5 +8,8 @@
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
-    //
+    public static function postprocess(string $html): string
+    {
+        // TODO: Implement postprocess() method.
+    }
 }

From 59b06182e4716c528ec90d43d22590ece6c9be39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:24:32 +0200
Subject: [PATCH 2711/4023] Revert "Create DynamicMarkdownLinksTest.php"

This reverts commit 091a8d5c48f51af5e24686cfca3494daf79c3ba6.
---
 .../tests/Feature/DynamicMarkdownLinksTest.php | 18 ------------------
 1 file changed, 18 deletions(-)
 delete mode 100644 packages/framework/tests/Feature/DynamicMarkdownLinksTest.php

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
deleted file mode 100644
index eae8ef2be58..00000000000
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Feature;
-
-use Hyde\Testing\TestCase;
-
-/**
- * @covers \Hyde\Hyde
- */
-class DynamicMarkdownLinksTest extends TestCase
-{
-    public function testExample()
-    {
-        $this->assertTrue(true);
-    }
-}

From 47bfef53fb5985da8123466fb055cdbcd9c90d95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:26:21 +0200
Subject: [PATCH 2712/4023] Create DynamicMarkdownLinkProcessorTest.php

---
 .../Markdown/DynamicMarkdownLinkProcessorTest.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
new file mode 100644
index 00000000000..4fc7c0e2f1a
--- /dev/null
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature\Services\Markdown;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
+ */
+class DynamicMarkdownLinkProcessorTest extends UnitTestCase
+{
+    //
+}

From 9a08865586e21def88514c4ad64e2ae007e3e09b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:33:23 +0200
Subject: [PATCH 2713/4023] Implement the initial dynamic markdown link feature

---
 .../DynamicMarkdownLinkProcessor.php          | 19 ++++++-
 .../DynamicMarkdownLinkProcessorTest.php      | 52 ++++++++++++++++++-
 2 files changed, 69 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index a47642414a4..3b17b28b5fc 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -4,12 +4,29 @@
 
 namespace Hyde\Markdown\Processing;
 
+use Hyde\Hyde;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
-        // TODO: Implement postprocess() method.
+        $patterns = [
+            '/<a href="hyde::route\(\'([^\']+)\'\)"/' => function ($matches) {
+                return '<a href="'.Hyde::route($matches[1]).'"';
+            },
+            '/<a href="hyde::relativeLink\(\'([^\']+)\'\)"/' => function ($matches) {
+                return '<a href="'.Hyde::relativeLink($matches[1]).'"';
+            },
+            '/<img src="hyde::asset\(\'([^\']+)\'\)"/' => function ($matches) {
+                return '<img src="'.Hyde::asset($matches[1]).'"';
+            },
+        ];
+
+        foreach ($patterns as $pattern => $replacement) {
+            $html = preg_replace_callback($pattern, $replacement, $html);
+        }
+
+        return $html;
     }
 }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 4fc7c0e2f1a..c6e42bcff2a 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -4,12 +4,62 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
+use Hyde\Pages\InMemoryPage;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Models\Route;
+use Hyde\Support\Facades\Render;
+use Hyde\Foundation\Facades\Routes;
+use Hyde\Support\Models\RenderData;
+use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
  */
 class DynamicMarkdownLinkProcessorTest extends UnitTestCase
 {
-    //
+    protected static bool $needsConfig = true;
+    protected static bool $needsKernel = true;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        Render::swap(new RenderData());
+
+        Routes::addRoute(new Route(new InMemoryPage('home')));
+    }
+
+    public function testRouteReplacement()
+    {
+        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
+        $expected = '<p><a href="home.html">Home</a></p>';
+        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testRelativeLinkReplacement()
+    {
+        $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
+        $expected = '<p><a href="about">About</a></p>';
+        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testAssetReplacement()
+    {
+        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
+        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
+        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMultipleReplacements()
+    {
+        $input = '<p><a href="hyde::route(\'home\')">Home</a> <a href="hyde::relativeLink(\'about\')">About</a> <img src="hyde::asset(\'logo.png\')" alt="Logo" /></p>';
+        $expected = '<p><a href="home.html">Home</a> <a href="about">About</a> <img src="media/logo.png" alt="Logo" /></p>';
+        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testNoReplacements()
+    {
+        $input = '<p>This is a regular <a href="https://example.com">link</a> with no Hyde syntax.</p>';
+        $this->assertEquals($input, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 }

From 6ec38dd1f4b1fbde44ef66cd099c8829342aa8a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:45:56 +0200
Subject: [PATCH 2714/4023] Refactor to use strict types

---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php   | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 3b17b28b5fc..ef41334443b 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -11,14 +11,15 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
+        /** @var array<string, callable(array<int, string>): string> $patterns */
         $patterns = [
-            '/<a href="hyde::route\(\'([^\']+)\'\)"/' => function ($matches) {
+            '/<a href="hyde::route\(\'([^\']+)\'\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::route($matches[1]).'"';
             },
-            '/<a href="hyde::relativeLink\(\'([^\']+)\'\)"/' => function ($matches) {
+            '/<a href="hyde::relativeLink\(\'([^\']+)\'\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::relativeLink($matches[1]).'"';
             },
-            '/<img src="hyde::asset\(\'([^\']+)\'\)"/' => function ($matches) {
+            '/<img src="hyde::asset\(\'([^\']+)\'\)"/' => function (array $matches): string {
                 return '<img src="'.Hyde::asset($matches[1]).'"';
             },
         ];

From eabee96bbe0a4500aeca4bf8b52a937aed13a468 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:48:12 +0200
Subject: [PATCH 2715/4023] Extract helper method

---
 .../DynamicMarkdownLinkProcessor.php          | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index ef41334443b..52ae7a605eb 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -11,8 +11,17 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
-        /** @var array<string, callable(array<int, string>): string> $patterns */
-        $patterns = [
+        foreach (static::patterns() as $pattern => $replacement) {
+            $html = preg_replace_callback($pattern, $replacement, $html);
+        }
+
+        return $html;
+    }
+
+    /** @return array<string, callable(array<int, string>): string> */
+    protected static function patterns(): array
+    {
+        return [
             '/<a href="hyde::route\(\'([^\']+)\'\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::route($matches[1]).'"';
             },
@@ -23,11 +32,5 @@ public static function postprocess(string $html): string
                 return '<img src="'.Hyde::asset($matches[1]).'"';
             },
         ];
-
-        foreach ($patterns as $pattern => $replacement) {
-            $html = preg_replace_callback($pattern, $replacement, $html);
-        }
-
-        return $html;
     }
 }

From 3c91dd7958e16d4449b2322b03d94ab309e40117 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:49:51 +0200
Subject: [PATCH 2716/4023] Supress faulty inspection

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index c6e42bcff2a..d722ca54b0e 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -1,5 +1,7 @@
 <?php
 
+/** @noinspection HtmlUnknownTarget */
+
 declare(strict_types=1);
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;

From a2c7879815e84a59e73ab5d152350da2febcea95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:54:33 +0200
Subject: [PATCH 2717/4023] Use more readable formatting for complex test
 fixture

---
 .../Markdown/DynamicMarkdownLinkProcessorTest.php  | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index d722ca54b0e..183a6d7414b 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -54,8 +54,18 @@ public function testAssetReplacement()
 
     public function testMultipleReplacements()
     {
-        $input = '<p><a href="hyde::route(\'home\')">Home</a> <a href="hyde::relativeLink(\'about\')">About</a> <img src="hyde::asset(\'logo.png\')" alt="Logo" /></p>';
-        $expected = '<p><a href="home.html">Home</a> <a href="about">About</a> <img src="media/logo.png" alt="Logo" /></p>';
+        $input = <<<'MARKDOWN'
+        <a href="hyde::route('home')">Home</a>
+        <a href="hyde::relativeLink('about')">About</a>
+        <img src="hyde::asset('logo.png')" alt="Logo" />
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <a href="home.html">Home</a>
+        <a href="about">About</a>
+        <img src="media/logo.png" alt="Logo" />
+        HTML;
+
         $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 

From 33ba914f9ec938abf3cb4909a4871d2ed0811504 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:54:59 +0200
Subject: [PATCH 2718/4023] Use assert same instead of assert equals

---
 .../Markdown/DynamicMarkdownLinkProcessorTest.php      | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 183a6d7414b..48026b79b39 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -35,21 +35,21 @@ public function testRouteReplacement()
     {
         $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
         $expected = '<p><a href="home.html">Home</a></p>';
-        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testRelativeLinkReplacement()
     {
         $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
         $expected = '<p><a href="about">About</a></p>';
-        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacement()
     {
         $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
         $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
-        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testMultipleReplacements()
@@ -66,12 +66,12 @@ public function testMultipleReplacements()
         <img src="media/logo.png" alt="Logo" />
         HTML;
 
-        $this->assertEquals($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testNoReplacements()
     {
         $input = '<p>This is a regular <a href="https://example.com">link</a> with no Hyde syntax.</p>';
-        $this->assertEquals($input, DynamicMarkdownLinkProcessor::postprocess($input));
+        $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 }

From 15ecda86a7272dcc92ddc8a9b4485a8be0c2d86a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 17:58:44 +0200
Subject: [PATCH 2719/4023] Update Markdown link support to work without single
 quotes

---
 .../Processing/DynamicMarkdownLinkProcessor.php | 12 ++++++------
 .../DynamicMarkdownLinkProcessorTest.php        | 17 +++++++++++++++++
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 52ae7a605eb..bf00a9a8c1a 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -22,14 +22,14 @@ public static function postprocess(string $html): string
     protected static function patterns(): array
     {
         return [
-            '/<a href="hyde::route\(\'([^\']+)\'\)"/' => function (array $matches): string {
-                return '<a href="'.Hyde::route($matches[1]).'"';
+            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+                return '<a href="'.Hyde::route($matches[2]).'"';
             },
-            '/<a href="hyde::relativeLink\(\'([^\']+)\'\)"/' => function (array $matches): string {
-                return '<a href="'.Hyde::relativeLink($matches[1]).'"';
+            '/<a href="hyde::relativeLink\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+                return '<a href="'.Hyde::relativeLink($matches[2]).'"';
             },
-            '/<img src="hyde::asset\(\'([^\']+)\'\)"/' => function (array $matches): string {
-                return '<img src="'.Hyde::asset($matches[1]).'"';
+            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+                return '<img src="'.Hyde::asset($matches[2]).'"';
             },
         ];
     }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 48026b79b39..8191fdb7c45 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -36,6 +36,9 @@ public function testRouteReplacement()
         $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
         $expected = '<p><a href="home.html">Home</a></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputUnquoted = '<p><a href="hyde::route(home)">Home</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
     }
 
     public function testRelativeLinkReplacement()
@@ -43,6 +46,9 @@ public function testRelativeLinkReplacement()
         $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
         $expected = '<p><a href="about">About</a></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputUnquoted = '<p><a href="hyde::relativeLink(about)">About</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
     }
 
     public function testAssetReplacement()
@@ -50,6 +56,9 @@ public function testAssetReplacement()
         $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
         $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputUnquoted = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
     }
 
     public function testMultipleReplacements()
@@ -67,6 +76,14 @@ public function testMultipleReplacements()
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputUnquoted = <<<'MARKDOWN'
+        <a href="hyde::route(home)">Home</a>
+        <a href="hyde::relativeLink(about)">About</a>
+        <img src="hyde::asset(logo.png)" alt="Logo" />
+        MARKDOWN;
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
     }
 
     public function testNoReplacements()

From 048910d6d913f591d0d951867c465d8b6cecd6ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:00:20 +0200
Subject: [PATCH 2720/4023] Update Markdown link support to work with double
 quotes

---
 .../DynamicMarkdownLinkProcessor.php          |  6 +--
 .../DynamicMarkdownLinkProcessorTest.php      | 46 +++++++++++++------
 2 files changed, 36 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index bf00a9a8c1a..fe50a979784 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -22,13 +22,13 @@ public static function postprocess(string $html): string
     protected static function patterns(): array
     {
         return [
-            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<a href="hyde::route\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::route($matches[2]).'"';
             },
-            '/<a href="hyde::relativeLink\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<a href="hyde::relativeLink\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::relativeLink($matches[2]).'"';
             },
-            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<img src="hyde::asset\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<img src="'.Hyde::asset($matches[2]).'"';
             },
         ];
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 8191fdb7c45..7ff8843d509 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -33,9 +33,13 @@ protected function setUp(): void
 
     public function testRouteReplacement()
     {
-        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
         $expected = '<p><a href="home.html">Home</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputSingleQuotes = '<p><a href="hyde::route(\'home\')">Home</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+
+        $inputDoubleQuotes = '<p><a href="hyde::route("home")">Home</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
 
         $inputUnquoted = '<p><a href="hyde::route(home)">Home</a></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
@@ -43,9 +47,13 @@ public function testRouteReplacement()
 
     public function testRelativeLinkReplacement()
     {
-        $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
         $expected = '<p><a href="about">About</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputSingleQuotes = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+
+        $inputDoubleQuotes = '<p><a href="hyde::relativeLink("about")">About</a></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
 
         $inputUnquoted = '<p><a href="hyde::relativeLink(about)">About</a></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
@@ -53,9 +61,13 @@ public function testRelativeLinkReplacement()
 
     public function testAssetReplacement()
     {
-        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
         $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+
+        $inputSingleQuotes = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+
+        $inputDoubleQuotes = '<p><img src="hyde::asset("image.jpg")" alt="Image" /></p>';
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
 
         $inputUnquoted = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
@@ -63,19 +75,27 @@ public function testAssetReplacement()
 
     public function testMultipleReplacements()
     {
-        $input = <<<'MARKDOWN'
-        <a href="hyde::route('home')">Home</a>
-        <a href="hyde::relativeLink('about')">About</a>
-        <img src="hyde::asset('logo.png')" alt="Logo" />
-        MARKDOWN;
-
         $expected = <<<'HTML'
         <a href="home.html">Home</a>
         <a href="about">About</a>
         <img src="media/logo.png" alt="Logo" />
         HTML;
 
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $inputSingleQuotes = <<<'MARKDOWN'
+        <a href="hyde::route('home')">Home</a>
+        <a href="hyde::relativeLink('about')">About</a>
+        <img src="hyde::asset('logo.png')" alt="Logo" />
+        MARKDOWN;
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+
+        $inputDoubleQuotes = <<<'MARKDOWN'
+        <a href="hyde::route("home")">Home</a>
+        <a href="hyde::relativeLink("about")">About</a>
+        <img src="hyde::asset("logo.png")" alt="Logo" />
+        MARKDOWN;
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
 
         $inputUnquoted = <<<'MARKDOWN'
         <a href="hyde::route(home)">Home</a>

From 017355f117a9475bb83eb09a54747d04b11523c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:03:16 +0200
Subject: [PATCH 2721/4023] Split out multiple assertions to dedicated unit
 tests

The testMultipleReplacements method does not need to be split since we don't get any new information from testing already tested alternate syntaxes. That test is mainly for humans to visualise the applicable code better in a more real life scenario.
---
 .../DynamicMarkdownLinkProcessorTest.php      | 97 +++++++++++--------
 1 file changed, 56 insertions(+), 41 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 7ff8843d509..57c875b2f7b 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -33,82 +33,97 @@ protected function setUp(): void
 
     public function testRouteReplacement()
     {
+        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
         $expected = '<p><a href="home.html">Home</a></p>';
 
-        $inputSingleQuotes = '<p><a href="hyde::route(\'home\')">Home</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 
-        $inputDoubleQuotes = '<p><a href="hyde::route("home")">Home</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
+    public function testRouteReplacementWithDoubleQuotes()
+    {
+        $input = '<p><a href="hyde::route("home")">Home</a></p>';
+        $expected = '<p><a href="home.html">Home</a></p>';
 
-        $inputUnquoted = '<p><a href="hyde::route(home)">Home</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testRouteReplacementWithoutQuotes()
+    {
+        $input = '<p><a href="hyde::route(home)">Home</a></p>';
+        $expected = '<p><a href="home.html">Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testRelativeLinkReplacement()
     {
+        $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
         $expected = '<p><a href="about">About</a></p>';
 
-        $inputSingleQuotes = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 
-        $inputDoubleQuotes = '<p><a href="hyde::relativeLink("about")">About</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
+    public function testRelativeLinkReplacementWithDoubleQuotes()
+    {
+        $input = '<p><a href="hyde::relativeLink("about")">About</a></p>';
+        $expected = '<p><a href="about">About</a></p>';
 
-        $inputUnquoted = '<p><a href="hyde::relativeLink(about)">About</a></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testRelativeLinkReplacementWithoutQuotes()
+    {
+        $input = '<p><a href="hyde::relativeLink(about)">About</a></p>';
+        $expected = '<p><a href="about">About</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacement()
     {
+        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
         $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
 
-        $inputSingleQuotes = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 
-        $inputDoubleQuotes = '<p><img src="hyde::asset("image.jpg")" alt="Image" /></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
+    public function testAssetReplacementWithDoubleQuotes()
+    {
+        $input = '<p><img src="hyde::asset("image.jpg")" alt="Image" /></p>';
+        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
 
-        $inputUnquoted = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testMultipleReplacements()
+    public function testAssetReplacementWithoutQuotes()
     {
-        $expected = <<<'HTML'
-        <a href="home.html">Home</a>
-        <a href="about">About</a>
-        <img src="media/logo.png" alt="Logo" />
-        HTML;
+        $input = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
+        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
 
-        $inputSingleQuotes = <<<'MARKDOWN'
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMultipleReplacements()
+    {
+        $input = <<<'MARKDOWN'
         <a href="hyde::route('home')">Home</a>
         <a href="hyde::relativeLink('about')">About</a>
         <img src="hyde::asset('logo.png')" alt="Logo" />
         MARKDOWN;
 
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputSingleQuotes));
-
-        $inputDoubleQuotes = <<<'MARKDOWN'
-        <a href="hyde::route("home")">Home</a>
-        <a href="hyde::relativeLink("about")">About</a>
-        <img src="hyde::asset("logo.png")" alt="Logo" />
-        MARKDOWN;
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputDoubleQuotes));
-
-        $inputUnquoted = <<<'MARKDOWN'
-        <a href="hyde::route(home)">Home</a>
-        <a href="hyde::relativeLink(about)">About</a>
-        <img src="hyde::asset(logo.png)" alt="Logo" />
-        MARKDOWN;
+        $expected = <<<'HTML'
+        <a href="home.html">Home</a>
+        <a href="about">About</a>
+        <img src="media/logo.png" alt="Logo" />
+        HTML;
 
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($inputUnquoted));
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testNoReplacements()
     {
         $input = '<p>This is a regular <a href="https://example.com">link</a> with no Hyde syntax.</p>';
+
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 }

From df09449ab2e856f3fe360888382f958cf3c104bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:08:42 +0200
Subject: [PATCH 2722/4023] Revert "Update Markdown link support to work with
 double quotes"

This reverts commit 048910d6d913f591d0d951867c465d8b6cecd6ed. See https://github.com/hydephp/develop/pull/1590#discussion_r1690082732
---
 .../DynamicMarkdownLinkProcessor.php          |  6 ++---
 .../DynamicMarkdownLinkProcessorTest.php      | 24 -------------------
 2 files changed, 3 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index fe50a979784..bf00a9a8c1a 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -22,13 +22,13 @@ public static function postprocess(string $html): string
     protected static function patterns(): array
     {
         return [
-            '/<a href="hyde::route\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::route($matches[2]).'"';
             },
-            '/<a href="hyde::relativeLink\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<a href="hyde::relativeLink\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::relativeLink($matches[2]).'"';
             },
-            '/<img src="hyde::asset\((\'|"|)([^\'"]+)\1\)"/' => function (array $matches): string {
+            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<img src="'.Hyde::asset($matches[2]).'"';
             },
         ];
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 57c875b2f7b..e87afe8ee2c 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -39,14 +39,6 @@ public function testRouteReplacement()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRouteReplacementWithDoubleQuotes()
-    {
-        $input = '<p><a href="hyde::route("home")">Home</a></p>';
-        $expected = '<p><a href="home.html">Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testRouteReplacementWithoutQuotes()
     {
         $input = '<p><a href="hyde::route(home)">Home</a></p>';
@@ -63,14 +55,6 @@ public function testRelativeLinkReplacement()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRelativeLinkReplacementWithDoubleQuotes()
-    {
-        $input = '<p><a href="hyde::relativeLink("about")">About</a></p>';
-        $expected = '<p><a href="about">About</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testRelativeLinkReplacementWithoutQuotes()
     {
         $input = '<p><a href="hyde::relativeLink(about)">About</a></p>';
@@ -87,14 +71,6 @@ public function testAssetReplacement()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testAssetReplacementWithDoubleQuotes()
-    {
-        $input = '<p><img src="hyde::asset("image.jpg")" alt="Image" /></p>';
-        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testAssetReplacementWithoutQuotes()
     {
         $input = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';

From 55df5a3a4724021aab6c73a5852be8fc148eb512 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:10:33 +0200
Subject: [PATCH 2723/4023] Register the dynamic Markdown link processor

---
 .../Framework/Concerns/Internal/SetsUpMarkdownConverter.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php b/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
index 38302778834..307c2caa81d 100644
--- a/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
+++ b/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
@@ -8,6 +8,7 @@
 use Hyde\Markdown\Processing\BladeDownProcessor;
 use Hyde\Markdown\Processing\ShortcodeProcessor;
 use Hyde\Markdown\Processing\CodeblockFilepathProcessor;
+use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 use Torchlight\Commonmark\V2\TorchlightExtension;
 
 use function array_merge;
@@ -73,6 +74,8 @@ protected function registerPostProcessors(): void
             CodeblockFilepathProcessor::class,
             Config::getBool('markdown.features.codeblock_filepaths', true)
         );
+
+        $this->registerPostProcessor(DynamicMarkdownLinkProcessor::class);
     }
 
     protected function registerPreProcessor(string $class, bool $when = true): void

From 16051f7e2c2bab364f8de18adb1b33aef72b9d4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:11:05 +0200
Subject: [PATCH 2724/4023] Reapply "Create DynamicMarkdownLinksTest.php"

This reverts commit 59b06182e4716c528ec90d43d22590ece6c9be39.
---
 .../tests/Feature/DynamicMarkdownLinksTest.php | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 packages/framework/tests/Feature/DynamicMarkdownLinksTest.php

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
new file mode 100644
index 00000000000..eae8ef2be58
--- /dev/null
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Hyde
+ */
+class DynamicMarkdownLinksTest extends TestCase
+{
+    public function testExample()
+    {
+        $this->assertTrue(true);
+    }
+}

From b0fe2bb0708e4971fa830da78874f2419da426bf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:11:34 +0200
Subject: [PATCH 2725/4023] Rename test to DynamicMarkdownLinksFeatureTest

---
 ...arkdownLinksTest.php => DynamicMarkdownLinksFeatureTest.php} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Feature/{DynamicMarkdownLinksTest.php => DynamicMarkdownLinksFeatureTest.php} (79%)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
similarity index 79%
rename from packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
rename to packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index eae8ef2be58..66814d5b4af 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -9,7 +9,7 @@
 /**
  * @covers \Hyde\Hyde
  */
-class DynamicMarkdownLinksTest extends TestCase
+class DynamicMarkdownLinksFeatureTest extends TestCase
 {
     public function testExample()
     {

From 69a5277a239a874c8cb48037f72b000cb3749df7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:12:34 +0200
Subject: [PATCH 2726/4023] Set up coverage

---
 .../tests/Feature/DynamicMarkdownLinksFeatureTest.php          | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 66814d5b4af..0d186b56e45 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -7,7 +7,8 @@
 use Hyde\Testing\TestCase;
 
 /**
- * @covers \Hyde\Hyde
+ * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
+ * @covers \Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {

From 6a7f46a9497844d4fe762e101075332eaa9a942c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:12:57 +0200
Subject: [PATCH 2727/4023] Add test crosslinks

---
 .../framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php | 2 ++
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php      | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 0d186b56e45..87aafdc3007 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -9,6 +9,8 @@
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
  * @covers \Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\Markdown\DynamicMarkdownLinkProcessorTest
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index e87afe8ee2c..ff7bb6923ef 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -16,6 +16,8 @@
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
+ *
+ * @see \Hyde\Framework\Testing\Feature\DynamicMarkdownLinksFeatureTest
  */
 class DynamicMarkdownLinkProcessorTest extends UnitTestCase
 {

From 85860164032a6c5efa81b2701fe44103be264055 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:15:23 +0200
Subject: [PATCH 2728/4023] Match heredoc name to type

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index ff7bb6923ef..04f53ca365d 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -83,11 +83,11 @@ public function testAssetReplacementWithoutQuotes()
 
     public function testMultipleReplacements()
     {
-        $input = <<<'MARKDOWN'
+        $input = <<<'HTML'
         <a href="hyde::route('home')">Home</a>
         <a href="hyde::relativeLink('about')">About</a>
         <img src="hyde::asset('logo.png')" alt="Logo" />
-        MARKDOWN;
+        HTML;
 
         $expected = <<<'HTML'
         <a href="home.html">Home</a>

From 18607561dc1ed8b717870b16bf46c0f61442235c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:29:59 +0200
Subject: [PATCH 2729/4023] Always render Markdown using the service

---
 .../framework/src/Markdown/Models/Markdown.php     | 14 +++-----------
 .../Feature/ColoredBlockquoteShortcodesTest.php    |  3 +++
 .../framework/tests/Unit/MarkdownFacadeTest.php    |  3 +++
 3 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Markdown/Models/Markdown.php b/packages/framework/src/Markdown/Models/Markdown.php
index 568ae22be2e..e9c6c80c6a7 100644
--- a/packages/framework/src/Markdown/Models/Markdown.php
+++ b/packages/framework/src/Markdown/Models/Markdown.php
@@ -5,7 +5,6 @@
 namespace Hyde\Markdown\Models;
 
 use Hyde\Framework\Services\MarkdownService;
-use Hyde\Markdown\MarkdownConverter;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Contracts\Support\Htmlable;
 use Illuminate\Support\HtmlString;
@@ -84,20 +83,13 @@ public static function fromFile(string $path): static
     /**
      * Render a Markdown string into HTML.
      *
-     * If a source model is provided, the Markdown will be converted using the dynamic MarkdownService,
-     * otherwise, the pre-configured singleton from the service container will be used instead.
+     * If a source page class is provided, that class will be used to configure
+     * the Hyde Markdown converter to enable features specific to that page.
      *
      * @return string $html
      */
     public static function render(string $markdown, ?string $pageClass = null): string
     {
-        if ($pageClass !== null) {
-            return (new MarkdownService($markdown, $pageClass))->parse();
-        } else {
-            /** @var MarkdownConverter $converter */
-            $converter = app(MarkdownConverter::class);
-
-            return (string) $converter->convert($markdown);
-        }
+        return (new MarkdownService($markdown, $pageClass))->parse();
     }
 }
diff --git a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
index dce752c8313..f12ffed3492 100644
--- a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
@@ -12,6 +12,9 @@
  */
 class ColoredBlockquoteShortcodesTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
     public function testSignature()
     {
         $this->assertSame('>', ColoredBlockquotes::signature());
diff --git a/packages/framework/tests/Unit/MarkdownFacadeTest.php b/packages/framework/tests/Unit/MarkdownFacadeTest.php
index 88531f35744..88903630f90 100644
--- a/packages/framework/tests/Unit/MarkdownFacadeTest.php
+++ b/packages/framework/tests/Unit/MarkdownFacadeTest.php
@@ -12,6 +12,9 @@
  */
 class MarkdownFacadeTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
     public function testRender(): void
     {
         $html = Markdown::render('# Hello World!');

From 2b6e40efa9b18590c5a16ddf63a4e931eaaaeb82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:37:56 +0200
Subject: [PATCH 2730/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2c37ec7a021..3871aafcb54 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -57,6 +57,7 @@ This serves two purposes:
 - Reorganized and cleaned up the navigation and sidebar documentation for improved clarity.
 - Moved the sidebar documentation to the documentation pages section for better organization.
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
+- The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
 
 ### Deprecated
 - for soon-to-be removed features.

From e943c198b4c4eece221224664f0c5e8270409bdf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:44:58 +0200
Subject: [PATCH 2731/4023] Implement the basic test

---
 .../DynamicMarkdownLinksFeatureTest.php       | 38 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 87aafdc3007..66ca829ad27 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -1,10 +1,16 @@
 <?php
 
+/** @noinspection HtmlUnknownTarget */
+
 declare(strict_types=1);
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Hyde\Pages\InMemoryPage;
+use Hyde\Support\Models\Route;
+use Hyde\Foundation\Facades\Routes;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
@@ -14,8 +20,36 @@
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
-    public function testExample()
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        Routes::addRoute(new Route(new InMemoryPage('home')));
+        Routes::addRoute(new Route(new InMemoryPage('blog/post')));
+    }
+
+    public function testDynamicMarkdownLinks()
     {
-        $this->assertTrue(true);
+        $input = <<<'MARKDOWN'
+        [Home](hyde::route('home'))
+        [About](hyde::relativeLink('about'))
+        ![Logo](hyde::asset('logo.png'))
+        
+        [Home](hyde::route(home))
+        [About](hyde::relativeLink(about))
+        ![Logo](hyde::asset(logo.png))
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="home.html">Home</a>
+        <a href="about">About</a>
+        <img src="media/logo.png" alt="Logo" /></p>
+        <p><a href="home.html">Home</a>
+        <a href="about">About</a>
+        <img src="media/logo.png" alt="Logo" /></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
 }

From d489d9020f85b3a7c8ed6d0653139a8aa7ba59ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:45:24 +0200
Subject: [PATCH 2732/4023] Generate more tests with Claude

---
 .../DynamicMarkdownLinksFeatureTest.php       | 103 +++++++++++++++++-
 1 file changed, 102 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 66ca829ad27..10a2e96c5ac 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -28,7 +28,7 @@ protected function setUp(): void
         Routes::addRoute(new Route(new InMemoryPage('blog/post')));
     }
 
-    public function testDynamicMarkdownLinks()
+    public function testBasicDynamicMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
         [Home](hyde::route('home'))
@@ -52,4 +52,105 @@ public function testDynamicMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testDynamicMarkdownLinksWithDoubleQuotes()
+    {
+        $input = <<<'MARKDOWN'
+        [Home](hyde::route("home"))
+        [About](hyde::relativeLink("about"))
+        ![Logo](hyde::asset("logo.png"))
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="home.html">Home</a>
+        <a href="about">About</a>
+        <img src="media/logo.png" alt="Logo" /></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
+
+    public function testDynamicMarkdownLinksInParagraphs()
+    {
+        $input = <<<'MARKDOWN'
+        This is a paragraph with a [link to home](hyde::route('home')) and an [about link](hyde::relativeLink('about')).
+
+        Another paragraph with an ![image](hyde::asset('image.jpg')).
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p>This is a paragraph with a <a href="home.html">link to home</a> and an <a href="about">about link</a>.</p>
+        <p>Another paragraph with an <img src="media/image.jpg" alt="image" />.</p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
+
+    public function testDynamicMarkdownLinksInLists()
+    {
+        $input = <<<'MARKDOWN'
+        - [Home](hyde::route('home'))
+        - [About](hyde::relativeLink('about'))
+        - ![Logo](hyde::asset('logo.png'))
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <ul>
+        <li>
+        <a href="home.html">Home</a>
+        </li>
+        <li>
+        <a href="about">About</a>
+        </li>
+        <li>
+        <img src="media/logo.png" alt="Logo" />
+        </li>
+        </ul>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
+
+    public function testDynamicMarkdownLinksWithNestedRoutes()
+    {
+        $input = <<<'MARKDOWN'
+        [Blog Post](hyde::route('blog/post'))
+        [Relative Blog](hyde::relativeLink('blog/post'))
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="blog/post.html">Blog Post</a>
+        <a href="blog/post">Relative Blog</a></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
+
+    public function testMixOfDynamicAndRegularMarkdownLinks()
+    {
+        $input = <<<'MARKDOWN'
+        [Home](hyde::route('home'))
+        [External](https://example.com)
+        [About](hyde::relativeLink('about'))
+        [Regular](regular-link.html)
+        ![Logo](hyde::asset('logo.png'))
+        ![External Image](https://example.com/image.jpg)
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="home.html">Home</a>
+        <a href="https://example.com">External</a>
+        <a href="about">About</a>
+        <a href="regular-link.html">Regular</a>
+        <img src="media/logo.png" alt="Logo" />
+        <img src="https://example.com/image.jpg" alt="External Image" /></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
 }

From a8aeb8bf91e0e1d7d86ec81199df1780882c2b5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:45:40 +0200
Subject: [PATCH 2733/4023] Skip unsupported test

See https://github.com/hydephp/develop/pull/1590#discussion_r1690082732
---
 .../framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 10a2e96c5ac..5034aecda8a 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -55,6 +55,8 @@ public function testBasicDynamicMarkdownLinks()
 
     public function testDynamicMarkdownLinksWithDoubleQuotes()
     {
+        $this->markTestSkipped('https://github.com/hydephp/develop/pull/1590#discussion_r1690082732');
+
         $input = <<<'MARKDOWN'
         [Home](hyde::route("home"))
         [About](hyde::relativeLink("about"))

From b10b55a5d67c3300f6fa2ff42f09939831cf54e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:48:11 +0200
Subject: [PATCH 2734/4023] Add fault tolerance testing

---
 .../DynamicMarkdownLinkProcessorTest.php      | 87 +++++++++++++++++++
 1 file changed, 87 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 04f53ca365d..6f7ee4bb102 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -104,4 +104,91 @@ public function testNoReplacements()
 
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
+
+    public function testMalformedRouteLink()
+    {
+        $input = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedRelativeLink()
+    {
+        $input = '<p><a href="hyde::relativeLink(about\')">Malformed About</a></p>';
+        $expected = '<p><a href="hyde::relativeLink(about\')">Malformed About</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedAssetLink()
+    {
+        $input = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
+        $expected = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testEmptyRouteLink()
+    {
+        $input = '<p><a href="hyde::route()">Empty Route</a></p>';
+        $expected = '<p><a href="hyde::route()">Empty Route</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testEmptyRelativeLink()
+    {
+        $input = '<p><a href="hyde::relativeLink()">Empty Relative Link</a></p>';
+        $expected = '<p><a href="hyde::relativeLink()">Empty Relative Link</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testEmptyAssetLink()
+    {
+        $input = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
+        $expected = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMixedValidAndInvalidLinks()
+    {
+        $input = <<<'HTML'
+        <a href="hyde::route('home')">Valid Home</a>
+        <a href="hyde::route(invalid'">Invalid Route</a>
+        <a href="hyde::relativeLink('about')">Valid About</a>
+        <a href="hyde::relativeLink(about')">Invalid Relative</a>
+        <img src="hyde::asset('logo.png')" alt="Valid Logo" />
+        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
+        HTML;
+
+        $expected = <<<'HTML'
+        <a href="home.html">Valid Home</a>
+        <a href="hyde::route(invalid'">Invalid Route</a>
+        <a href="about">Valid About</a>
+        <a href="hyde::relativeLink(about')">Invalid Relative</a>
+        <img src="media/logo.png" alt="Valid Logo" />
+        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
+        HTML;
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedHydeSyntax()
+    {
+        $input = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
+        $expected = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testNonExistentRouteFunction()
+    {
+        $input = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
+        $expected = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 }

From d105152f3e9b19eca36d6f98767a3d371c027318 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 18:48:17 +0200
Subject: [PATCH 2735/4023] Section test code

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 6f7ee4bb102..e5790ea88d6 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -105,6 +105,8 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
+    // Fault tolerance tests
+
     public function testMalformedRouteLink()
     {
         $input = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';

From f2d02fbd33c07d7d07a6feb86a0f41c377b446a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:01:32 +0200
Subject: [PATCH 2736/4023] Add more fault tolerance tests

---
 .../DynamicMarkdownLinkProcessorTest.php         | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index e5790ea88d6..c917bc2e1ab 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -115,6 +115,22 @@ public function testMalformedRouteLink()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
+    public function testMalformedRouteLink2()
+    {
+        $input = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedRouteLink3()
+    {
+        $input = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
     public function testMalformedRelativeLink()
     {
         $input = '<p><a href="hyde::relativeLink(about\')">Malformed About</a></p>';

From ad20f39262517d90b3453f2dd442fef9cbd19208 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:07:01 +0200
Subject: [PATCH 2737/4023] Throw an exception for non existent routes

---
 .../Processing/DynamicMarkdownLinkProcessor.php       | 11 ++++++++++-
 .../Markdown/DynamicMarkdownLinkProcessorTest.php     | 10 ++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index bf00a9a8c1a..d6b9796d344 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,6 +5,7 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
+use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
@@ -23,7 +24,15 @@ protected static function patterns(): array
     {
         return [
             '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                return '<a href="'.Hyde::route($matches[2]).'"';
+                $route = Hyde::route($matches[2]);
+                if ($route === null) {
+                    // While the other patterns work regardless of if input is valid,
+                    // this method returns null, which silently fails to an empty string.
+                    // So we instead throw an exception to alert the developer of the issue.
+                    throw new RouteNotFoundException($matches[2]);
+                }
+
+                return '<a href="'.$route.'"';
             },
             '/<a href="hyde::relativeLink\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<a href="'.Hyde::relativeLink($matches[2]).'"';
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index c917bc2e1ab..4ebc368e653 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -12,6 +12,7 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\RenderData;
+use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
@@ -105,6 +106,15 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
+    public function testNonExistentRouteThrowsException()
+    {
+        $this->expectException(RouteNotFoundException::class);
+        $this->expectExceptionMessage('Route [non-existent] not found.');
+
+        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
+        DynamicMarkdownLinkProcessor::postprocess($input);
+    }
+
     // Fault tolerance tests
 
     public function testMalformedRouteLink()

From 61a552beb06f43ae0f8055105a89643154183df0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:10:37 +0200
Subject: [PATCH 2738/4023] Extract helper method

---
 .../DynamicMarkdownLinkProcessor.php           | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index d6b9796d344..b9d3c37a10e 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,6 +5,7 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
+use Hyde\Support\Models\Route;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -25,12 +26,7 @@ protected static function patterns(): array
         return [
             '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 $route = Hyde::route($matches[2]);
-                if ($route === null) {
-                    // While the other patterns work regardless of if input is valid,
-                    // this method returns null, which silently fails to an empty string.
-                    // So we instead throw an exception to alert the developer of the issue.
-                    throw new RouteNotFoundException($matches[2]);
-                }
+                static::validateRouteExists($route, $matches[2]);
 
                 return '<a href="'.$route.'"';
             },
@@ -42,4 +38,14 @@ protected static function patterns(): array
             },
         ];
     }
+
+    protected static function validateRouteExists(?Route $route, $routeKey): void
+    {
+        if ($route === null) {
+            // While the other patterns work regardless of if input is valid,
+            // this method returns null, which silently fails to an empty string.
+            // So we instead throw an exception to alert the developer of the issue.
+            throw new RouteNotFoundException($routeKey);
+        }
+    }
 }

From ee000ced31862c0ba2e26bfe0af007991c708150 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:10:49 +0200
Subject: [PATCH 2739/4023] Add newline

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index b9d3c37a10e..2b48b86c203 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -26,6 +26,7 @@ protected static function patterns(): array
         return [
             '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 $route = Hyde::route($matches[2]);
+
                 static::validateRouteExists($route, $matches[2]);
 
                 return '<a href="'.$route.'"';

From 80edd88d786f813e9d72cb66714ae714cd6ce820 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:11:08 +0200
Subject: [PATCH 2740/4023] Add newline

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 2b48b86c203..2c2eb91cd66 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -46,6 +46,7 @@ protected static function validateRouteExists(?Route $route, $routeKey): void
             // While the other patterns work regardless of if input is valid,
             // this method returns null, which silently fails to an empty string.
             // So we instead throw an exception to alert the developer of the issue.
+
             throw new RouteNotFoundException($routeKey);
         }
     }

From 8e1e51678bb3609e1c396443500b920b39860339 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:17:17 +0200
Subject: [PATCH 2741/4023] Try to find the faulty line

---
 .../Framework/Exceptions/RouteNotFoundException.php  | 12 ++++++++++++
 .../Processing/DynamicMarkdownLinkProcessor.php      | 12 +++++++++++-
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
index 1f173d27f78..4e8c05e3d45 100644
--- a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
+++ b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
@@ -20,4 +20,16 @@ public function __construct(?string $routeKey = null)
     {
         parent::__construct($routeKey ? sprintf('Route [%s] not found.', $routeKey) : $this->message);
     }
+
+    /**
+     * @interal
+     *
+     * @experimental
+     *
+     * @codeCoverageIgnore
+     */
+    public function setErroredFile(string $path): void
+    {
+        $this->message = rtrim($this->message, '.').sprintf(' (in file [%s])', $path);
+    }
 }
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 2c2eb91cd66..c983ca3f638 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Support\Models\Route;
+use Hyde\Support\Facades\Render;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -47,7 +48,16 @@ protected static function validateRouteExists(?Route $route, $routeKey): void
             // this method returns null, which silently fails to an empty string.
             // So we instead throw an exception to alert the developer of the issue.
 
-            throw new RouteNotFoundException($routeKey);
+            $exception = new RouteNotFoundException($routeKey);
+
+            // In order to show the developer where this error is, we try to find the faulty Markdown file.
+            $page = Render::getPage();
+            if ($page !== null) {
+                $path = $page->getSourcePath();
+                $exception->setErroredFile($path);
+            }
+
+            throw $exception;
         }
     }
 }

From 12383155c8773356e37a0566ee731bfb1c393012 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:25:11 +0200
Subject: [PATCH 2742/4023] Try to find the line number of the error

---
 .../Framework/Exceptions/RouteNotFoundException.php  |  7 +++++--
 .../Processing/DynamicMarkdownLinkProcessor.php      | 12 +++++++++++-
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
index 4e8c05e3d45..61b408b7c0d 100644
--- a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
+++ b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
@@ -28,8 +28,11 @@ public function __construct(?string $routeKey = null)
      *
      * @codeCoverageIgnore
      */
-    public function setErroredFile(string $path): void
+    public function setErroredFile(string $path, int $line = 0): void
     {
-        $this->message = rtrim($this->message, '.').sprintf(' (in file [%s])', $path);
+        $this->message = rtrim($this->message, '.').sprintf(' (in file %s)', $path);
+
+        $this->file = realpath($path) ?: $path;
+        $this->line = $line;
     }
 }
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index c983ca3f638..598ec42eb78 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,8 +5,10 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
+use Hyde\Facades\Filesystem;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
+use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -54,7 +56,15 @@ protected static function validateRouteExists(?Route $route, $routeKey): void
             $page = Render::getPage();
             if ($page !== null) {
                 $path = $page->getSourcePath();
-                $exception->setErroredFile($path);
+                $contents = Filesystem::getContents($path);
+                // Try to find the line number of the error.
+                $lineNumber = strpos($contents, $routeKey);
+                if ($lineNumber !== false) {
+                    $lineNumber = substr_count(substr($contents, 0, $lineNumber), "\n") + 1;
+                    $exception->setErroredFile($path, $lineNumber);
+                } else {
+                    $exception->setErroredFile($path);
+                }
             }
 
             throw $exception;

From 5fa57910d5a8e5ef2b1e7e36a9cb669ddd137ecd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:27:09 +0200
Subject: [PATCH 2743/4023] Extract method

---
 .../DynamicMarkdownLinkProcessor.php          | 38 ++++++++++++-------
 1 file changed, 25 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 598ec42eb78..8d7d0967930 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -53,21 +53,33 @@ protected static function validateRouteExists(?Route $route, $routeKey): void
             $exception = new RouteNotFoundException($routeKey);
 
             // In order to show the developer where this error is, we try to find the faulty Markdown file.
-            $page = Render::getPage();
-            if ($page !== null) {
-                $path = $page->getSourcePath();
-                $contents = Filesystem::getContents($path);
-                // Try to find the line number of the error.
-                $lineNumber = strpos($contents, $routeKey);
-                if ($lineNumber !== false) {
-                    $lineNumber = substr_count(substr($contents, 0, $lineNumber), "\n") + 1;
-                    $exception->setErroredFile($path, $lineNumber);
-                } else {
-                    $exception->setErroredFile($path);
-                }
-            }
+            self::tryToFindErroredLine($routeKey, $exception);
 
             throw $exception;
         }
     }
+
+    /**
+     * @interal If we use more features like these we may want to wrap the RouteNotFoundException in a custom MarkdownPageException.
+     *
+     * @experimental
+     *
+     * @codeCoverageIgnore
+     */
+    protected static function tryToFindErroredLine($routeKey, RouteNotFoundException $exception): void
+    {
+        $page = Render::getPage();
+        if ($page !== null) {
+            $path = $page->getSourcePath();
+            $contents = Filesystem::getContents($path);
+            // Try to find the line number of the error.
+            $lineNumber = strpos($contents, $routeKey);
+            if ($lineNumber !== false) {
+                $lineNumber = substr_count(substr($contents, 0, $lineNumber), "\n") + 1;
+                $exception->setErroredFile($path, $lineNumber);
+            } else {
+                $exception->setErroredFile($path);
+            }
+        }
+    }
 }

From 475c8efe2f1ce15f643204b26174d009e7dd47fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 19:43:14 +0200
Subject: [PATCH 2744/4023] Test the line finding

---
 .../DynamicMarkdownLinkProcessor.php          |  4 +--
 .../DynamicMarkdownLinksFeatureTest.php       | 26 +++++++++++++++++++
 .../DynamicMarkdownLinkProcessorTest.php      | 16 ++++++++++++
 3 files changed, 43 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 8d7d0967930..458bc3c9d39 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -63,13 +63,11 @@ protected static function validateRouteExists(?Route $route, $routeKey): void
      * @interal If we use more features like these we may want to wrap the RouteNotFoundException in a custom MarkdownPageException.
      *
      * @experimental
-     *
-     * @codeCoverageIgnore
      */
     protected static function tryToFindErroredLine($routeKey, RouteNotFoundException $exception): void
     {
         $page = Render::getPage();
-        if ($page !== null) {
+        if ($page !== null && Filesystem::exists($page->getSourcePath())) {
             $path = $page->getSourcePath();
             $contents = Filesystem::getContents($path);
             // Try to find the line number of the error.
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 5034aecda8a..9b0e51151ea 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -9,8 +9,11 @@
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Framework\Actions\StaticPageBuilder;
+use Hyde\Framework\Exceptions\RouteNotFoundException;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
@@ -155,4 +158,27 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testNonExistentRouteThrowsExceptionWithLineLocationWhenRenderingAPage()
+    {
+        $this->file('_pages/test.md', <<<'MARKDOWN'
+        Some
+        Extra
+        Newlines
+
+        [test](hyde::route('non-existent'))
+        
+        And some more text.
+        MARKDOWN);
+
+        try {
+            $page = MarkdownPage::parse('test');
+            StaticPageBuilder::handle($page);
+        } catch (RouteNotFoundException $exception) {
+            $this->assertSame('Route [non-existent] not found (in file _pages/test.md)', $exception->getMessage());
+            $this->assertSame(realpath(Hyde::path('_pages/test.md')), $exception->getFile());
+            $this->assertSame(5, $exception->getLine());
+            $this->assertIsString($exception->getFile());
+        }
+    }
 }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 4ebc368e653..42192af9878 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,7 +6,9 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
+use Mockery;
 use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
@@ -115,6 +117,20 @@ public function testNonExistentRouteThrowsException()
         DynamicMarkdownLinkProcessor::postprocess($input);
     }
 
+    public function testNonExistentRouteThrowsExceptionWithGracefulLineFindingWhenNoFileSourceExists()
+    {
+        $instance = Mockery::mock(RenderData::class);
+        $instance->shouldReceive('getPage')->andReturn(new MarkdownPage('test'));
+
+        Render::swap($instance);
+
+        $this->expectException(RouteNotFoundException::class);
+        $this->expectExceptionMessage('Route [non-existent] not found.');
+
+        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
+        DynamicMarkdownLinkProcessor::postprocess($input);
+    }
+
     // Fault tolerance tests
 
     public function testMalformedRouteLink()

From 5da5b2fd5cc8fc62d3cf915810fa4c479a5543b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 20:42:44 +0200
Subject: [PATCH 2745/4023] Revert out of scope line finder

See https://github.com/hydephp/develop/pull/1590#discussion_r1690205820

Revert "Extract helper method"
This reverts commit 61a552beb06f43ae0f8055105a89643154183df0.

Revert "Test the line finding"

This reverts commit 475c8efe2f1ce15f643204b26174d009e7dd47fe.

Revert "Extract method"

This reverts commit 5fa57910d5a8e5ef2b1e7e36a9cb669ddd137ecd.

Revert "Try to find the line number of the error"

This reverts commit 12383155c8773356e37a0566ee731bfb1c393012.

Revert "Try to find the faulty line"

This reverts commit 8e1e51678bb3609e1c396443500b920b39860339.

Revert "Add newline"

This reverts commit 80edd88d786f813e9d72cb66714ae714cd6ce820.

Revert "Add newline"

This reverts commit ee000ced31862c0ba2e26bfe0af007991c708150.
---
 .../Exceptions/RouteNotFoundException.php     | 15 ------
 .../DynamicMarkdownLinkProcessor.php          | 50 +++----------------
 .../DynamicMarkdownLinksFeatureTest.php       | 26 ----------
 .../DynamicMarkdownLinkProcessorTest.php      | 16 ------
 4 files changed, 6 insertions(+), 101 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
index 61b408b7c0d..1f173d27f78 100644
--- a/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
+++ b/packages/framework/src/Framework/Exceptions/RouteNotFoundException.php
@@ -20,19 +20,4 @@ public function __construct(?string $routeKey = null)
     {
         parent::__construct($routeKey ? sprintf('Route [%s] not found.', $routeKey) : $this->message);
     }
-
-    /**
-     * @interal
-     *
-     * @experimental
-     *
-     * @codeCoverageIgnore
-     */
-    public function setErroredFile(string $path, int $line = 0): void
-    {
-        $this->message = rtrim($this->message, '.').sprintf(' (in file %s)', $path);
-
-        $this->file = realpath($path) ?: $path;
-        $this->line = $line;
-    }
 }
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 458bc3c9d39..d6b9796d344 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,10 +5,6 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
-use Hyde\Facades\Filesystem;
-use Hyde\Support\Models\Route;
-use Hyde\Support\Facades\Render;
-use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -29,8 +25,12 @@ protected static function patterns(): array
         return [
             '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 $route = Hyde::route($matches[2]);
-
-                static::validateRouteExists($route, $matches[2]);
+                if ($route === null) {
+                    // While the other patterns work regardless of if input is valid,
+                    // this method returns null, which silently fails to an empty string.
+                    // So we instead throw an exception to alert the developer of the issue.
+                    throw new RouteNotFoundException($matches[2]);
+                }
 
                 return '<a href="'.$route.'"';
             },
@@ -42,42 +42,4 @@ protected static function patterns(): array
             },
         ];
     }
-
-    protected static function validateRouteExists(?Route $route, $routeKey): void
-    {
-        if ($route === null) {
-            // While the other patterns work regardless of if input is valid,
-            // this method returns null, which silently fails to an empty string.
-            // So we instead throw an exception to alert the developer of the issue.
-
-            $exception = new RouteNotFoundException($routeKey);
-
-            // In order to show the developer where this error is, we try to find the faulty Markdown file.
-            self::tryToFindErroredLine($routeKey, $exception);
-
-            throw $exception;
-        }
-    }
-
-    /**
-     * @interal If we use more features like these we may want to wrap the RouteNotFoundException in a custom MarkdownPageException.
-     *
-     * @experimental
-     */
-    protected static function tryToFindErroredLine($routeKey, RouteNotFoundException $exception): void
-    {
-        $page = Render::getPage();
-        if ($page !== null && Filesystem::exists($page->getSourcePath())) {
-            $path = $page->getSourcePath();
-            $contents = Filesystem::getContents($path);
-            // Try to find the line number of the error.
-            $lineNumber = strpos($contents, $routeKey);
-            if ($lineNumber !== false) {
-                $lineNumber = substr_count(substr($contents, 0, $lineNumber), "\n") + 1;
-                $exception->setErroredFile($path, $lineNumber);
-            } else {
-                $exception->setErroredFile($path);
-            }
-        }
-    }
 }
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 9b0e51151ea..5034aecda8a 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -9,11 +9,8 @@
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\InMemoryPage;
-use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Framework\Actions\StaticPageBuilder;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
@@ -158,27 +155,4 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
-
-    public function testNonExistentRouteThrowsExceptionWithLineLocationWhenRenderingAPage()
-    {
-        $this->file('_pages/test.md', <<<'MARKDOWN'
-        Some
-        Extra
-        Newlines
-
-        [test](hyde::route('non-existent'))
-        
-        And some more text.
-        MARKDOWN);
-
-        try {
-            $page = MarkdownPage::parse('test');
-            StaticPageBuilder::handle($page);
-        } catch (RouteNotFoundException $exception) {
-            $this->assertSame('Route [non-existent] not found (in file _pages/test.md)', $exception->getMessage());
-            $this->assertSame(realpath(Hyde::path('_pages/test.md')), $exception->getFile());
-            $this->assertSame(5, $exception->getLine());
-            $this->assertIsString($exception->getFile());
-        }
-    }
 }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 42192af9878..4ebc368e653 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,9 +6,7 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
-use Mockery;
 use Hyde\Pages\InMemoryPage;
-use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
@@ -117,20 +115,6 @@ public function testNonExistentRouteThrowsException()
         DynamicMarkdownLinkProcessor::postprocess($input);
     }
 
-    public function testNonExistentRouteThrowsExceptionWithGracefulLineFindingWhenNoFileSourceExists()
-    {
-        $instance = Mockery::mock(RenderData::class);
-        $instance->shouldReceive('getPage')->andReturn(new MarkdownPage('test'));
-
-        Render::swap($instance);
-
-        $this->expectException(RouteNotFoundException::class);
-        $this->expectExceptionMessage('Route [non-existent] not found.');
-
-        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
-        DynamicMarkdownLinkProcessor::postprocess($input);
-    }
-
     // Fault tolerance tests
 
     public function testMalformedRouteLink()

From 2bf321c0b080d8dca574bcf9bacffc5031a13199 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 20:49:53 +0200
Subject: [PATCH 2746/4023] Generate new documentation with Claude

---
 docs/digging-deeper/advanced-markdown.md | 53 +++++++++++++++++++++---
 1 file changed, 47 insertions(+), 6 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index fd9803663a1..5b4f1225019 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -156,25 +156,66 @@ anything within the path label will be rendered as HTML. This means you can add
 ```
 ````
 
-### Dynamic Markdown links
+## Dynamic Markdown Links
 
-In order to create automatically resolved links from your pages and posts, you can use the special Hyde Markdown link syntax.
+HydePHP provides a powerful feature for creating automatically resolved links within your pages and posts using a special Hyde Markdown link syntax. This feature allows you to generate dynamic links that are resolved based on the current page being rendered.
 
-For all the supported syntax options, Hyde will resolve a relative link based on the current page being rendered.
+### Usage
 
-Since this happens in our Markdown processor, this will work regardless of if you have custom HTML or Blade enabled for your site.
+You can use the following syntax options in your Markdown files:
 
 ```markdown
 <!-- Resolving a route -->
 [Home](hyde::route('home'))
 
 <!-- Resolving a relative link -->
-[Home](hyde::relativeLink('home'))
+[About](hyde::relativeLink('about'))
 
 <!-- Resolving a media asset -->
-![Image](hyde::asset('image.jpg'))
+![Logo](hyde::asset('logo.png'))
 ```
 
+### How It Works
+
+The Hyde Markdown processor handles these special links during the conversion process. This means that the feature works regardless of whether you have custom HTML or Blade enabled for your site.
+
+Here's what each function does:
+
+- `hyde::route()`: Generates a link to a specific route in your Hyde site.
+- `hyde::relativeLink()`: Creates a relative link to another page.
+- `hyde::asset()`: Resolves the path to a media asset in your site.
+
+### Behavior and Error Handling
+
+- If the specified route or asset exists, Hyde will generate the correct URL.
+- If a route specified in `hyde::route()` does not exist, a `RouteNotFoundException` will be thrown. This helps catch errors early in the development process.
+
+>info Note: The exception throwing behavior for non-existent routes is designed to provide immediate feedback during development. In production environments, you may want to handle these exceptions gracefully.
+
+### Best Practices
+
+1. Always double-check that the pages or assets you're linking to exist in your project.
+2. Use meaningful names for your routes to make your Markdown more readable and maintainable.
+3. Consider using `hyde::relativeLink()` for local navigation if your site structure might change.
+
+### Customization
+
+You can customize how Hyde handles dynamic links by modifying the `config/hyde.php` file. For example, you might want to change how non-existent routes are handled in production:
+
+```php
+// filepath: config/hyde.php
+'dynamic_links' => [
+    'throw_exception_on_missing_route' => env('APP_ENV') === 'local',
+],
+```
+
+### Limitations
+
+- The dynamic link syntax is only processed within Markdown files. It won't work in plain HTML or Blade templates.
+- Make sure to use the correct syntax (`hyde::function('parameter')`) as other variations may not be recognized.
+
+By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links.
+
 ### Limitations
 
 The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.

From 6d43f736811ecee50b6016195fa5f010367064a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 20:50:03 +0200
Subject: [PATCH 2747/4023] Proof generated documentation

---
 docs/digging-deeper/advanced-markdown.md | 40 +++++-------------------
 1 file changed, 8 insertions(+), 32 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 5b4f1225019..26432b77999 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -165,7 +165,7 @@ HydePHP provides a powerful feature for creating automatically resolved links wi
 You can use the following syntax options in your Markdown files:
 
 ```markdown
-<!-- Resolving a route -->
+<!-- Resolving a page route -->
 [Home](hyde::route('home'))
 
 <!-- Resolving a relative link -->
@@ -179,42 +179,18 @@ You can use the following syntax options in your Markdown files:
 
 The Hyde Markdown processor handles these special links during the conversion process. This means that the feature works regardless of whether you have custom HTML or Blade enabled for your site.
 
-Here's what each function does:
-
-- `hyde::route()`: Generates a link to a specific route in your Hyde site.
-- `hyde::relativeLink()`: Creates a relative link to another page.
-- `hyde::asset()`: Resolves the path to a media asset in your site.
-
-### Behavior and Error Handling
-
-- If the specified route or asset exists, Hyde will generate the correct URL.
-- If a route specified in `hyde::route()` does not exist, a `RouteNotFoundException` will be thrown. This helps catch errors early in the development process.
-
->info Note: The exception throwing behavior for non-existent routes is designed to provide immediate feedback during development. In production environments, you may want to handle these exceptions gracefully.
-
-### Best Practices
-
-1. Always double-check that the pages or assets you're linking to exist in your project.
-2. Use meaningful names for your routes to make your Markdown more readable and maintainable.
-3. Consider using `hyde::relativeLink()` for local navigation if your site structure might change.
 
-### Customization
-
-You can customize how Hyde handles dynamic links by modifying the `config/hyde.php` file. For example, you might want to change how non-existent routes are handled in production:
+Here's what each function does:
 
-```php
-// filepath: config/hyde.php
-'dynamic_links' => [
-    'throw_exception_on_missing_route' => env('APP_ENV') === 'local',
-],
-```
+- `hyde::route()`: Generates a link to a specific route in your Hyde site. This is equivalent to `{{ Hyde::route('route.name') }}` in Blade (But we throw if the route doesn't exist).
+- `hyde::relativeLink()`: Creates a relative link to another page. This is equivalent to `{{ Hyde::relativeLink('path') }}` in Blade.
+- `hyde::asset()`: Resolves the path to a media asset in your site. This is equivalent to `{{ Hyde::asset('path') }}` in Blade.
 
-### Limitations
+By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links.
 
-- The dynamic link syntax is only processed within Markdown files. It won't work in plain HTML or Blade templates.
-- Make sure to use the correct syntax (`hyde::function('parameter')`) as other variations may not be recognized.
+### Considerations
 
-By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links.
+**Note:** For the route helper we throw an exception if the route doesn't exist. This is to provide immediate feedback during development.
 
 ### Limitations
 

From 5e96cda5fe2443a42ebb5894e5ca4f347b797a82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 21:04:44 +0200
Subject: [PATCH 2748/4023] Streamline documentation

---
 docs/digging-deeper/advanced-markdown.md | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 26432b77999..72ebe98d07e 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -158,7 +158,7 @@ anything within the path label will be rendered as HTML. This means you can add
 
 ## Dynamic Markdown Links
 
-HydePHP provides a powerful feature for creating automatically resolved links within your pages and posts using a special Hyde Markdown link syntax. This feature allows you to generate dynamic links that are resolved based on the current page being rendered.
+HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using a special Hyde Markdown link syntax, designed to match the syntax of the `Hyde` facade.
 
 ### Usage
 
@@ -175,22 +175,25 @@ You can use the following syntax options in your Markdown files:
 ![Logo](hyde::asset('logo.png'))
 ```
 
-### How It Works
+By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links. The feature is always enabled in the Markdown converter.
 
-The Hyde Markdown processor handles these special links during the conversion process. This means that the feature works regardless of whether you have custom HTML or Blade enabled for your site.
 
+### Breakdown
 
-Here's what each function does:
+The example above is equivalent to the following Blade syntax:
 
-- `hyde::route()`: Generates a link to a specific route in your Hyde site. This is equivalent to `{{ Hyde::route('route.name') }}` in Blade (But we throw if the route doesn't exist).
-- `hyde::relativeLink()`: Creates a relative link to another page. This is equivalent to `{{ Hyde::relativeLink('path') }}` in Blade.
-- `hyde::asset()`: Resolves the path to a media asset in your site. This is equivalent to `{{ Hyde::asset('path') }}` in Blade.
+```blade
+<!-- Resolving a page route -->
+{{ Hyde::route('route.name') ?? throw new RouteNotFoundException() }}
 
-By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links.
+<!-- Resolving a relative link -->
+{{ Hyde::relativeLink('path') }}
 
-### Considerations
+<!-- Resolving a media asset -->
+{{ Hyde::asset('path') }}
+```
 
-**Note:** For the route helper we throw an exception if the route doesn't exist. This is to provide immediate feedback during development.
+As you can see, we throw an exception if the route doesn't exist, to provide immediate feedback during development.
 
 ### Limitations
 

From a2b256b6c5f77435e8d90fb41cd82594fc6ff4af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 21:05:06 +0200
Subject: [PATCH 2749/4023] Fix documentation location

---
 docs/digging-deeper/advanced-markdown.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 72ebe98d07e..60123b9d3f0 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -156,6 +156,11 @@ anything within the path label will be rendered as HTML. This means you can add
 ```
 ````
 
+### Limitations
+
+The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.
+
+
 ## Dynamic Markdown Links
 
 HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using a special Hyde Markdown link syntax, designed to match the syntax of the `Hyde` facade.
@@ -195,9 +200,6 @@ The example above is equivalent to the following Blade syntax:
 
 As you can see, we throw an exception if the route doesn't exist, to provide immediate feedback during development.
 
-### Limitations
-
-The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.
 
 ## Configuration
 

From 9589bc17d1165cbc577e298d4500c7aeb9a2c48d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 21:12:32 +0200
Subject: [PATCH 2750/4023] Remove dynamic relative link Markdown feature
 offering little value

Can't see too big of a use case for this
---
 docs/digging-deeper/advanced-markdown.md      |  6 ---
 .../DynamicMarkdownLinkProcessor.php          |  3 --
 .../DynamicMarkdownLinksFeatureTest.php       | 20 ++--------
 .../DynamicMarkdownLinkProcessorTest.php      | 38 -------------------
 4 files changed, 3 insertions(+), 64 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 60123b9d3f0..f8d59d14267 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -173,9 +173,6 @@ You can use the following syntax options in your Markdown files:
 <!-- Resolving a page route -->
 [Home](hyde::route('home'))
 
-<!-- Resolving a relative link -->
-[About](hyde::relativeLink('about'))
-
 <!-- Resolving a media asset -->
 ![Logo](hyde::asset('logo.png'))
 ```
@@ -191,9 +188,6 @@ The example above is equivalent to the following Blade syntax:
 <!-- Resolving a page route -->
 {{ Hyde::route('route.name') ?? throw new RouteNotFoundException() }}
 
-<!-- Resolving a relative link -->
-{{ Hyde::relativeLink('path') }}
-
 <!-- Resolving a media asset -->
 {{ Hyde::asset('path') }}
 ```
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index d6b9796d344..0bbe7643826 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -34,9 +34,6 @@ protected static function patterns(): array
 
                 return '<a href="'.$route.'"';
             },
-            '/<a href="hyde::relativeLink\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                return '<a href="'.Hyde::relativeLink($matches[2]).'"';
-            },
             '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
                 return '<img src="'.Hyde::asset($matches[2]).'"';
             },
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 5034aecda8a..a4d57aa76a5 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -32,20 +32,16 @@ public function testBasicDynamicMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
         [Home](hyde::route('home'))
-        [About](hyde::relativeLink('about'))
         ![Logo](hyde::asset('logo.png'))
         
         [Home](hyde::route(home))
-        [About](hyde::relativeLink(about))
         ![Logo](hyde::asset(logo.png))
         MARKDOWN;
 
         $expected = <<<'HTML'
         <p><a href="home.html">Home</a>
-        <a href="about">About</a>
         <img src="media/logo.png" alt="Logo" /></p>
         <p><a href="home.html">Home</a>
-        <a href="about">About</a>
         <img src="media/logo.png" alt="Logo" /></p>
 
         HTML;
@@ -59,13 +55,11 @@ public function testDynamicMarkdownLinksWithDoubleQuotes()
 
         $input = <<<'MARKDOWN'
         [Home](hyde::route("home"))
-        [About](hyde::relativeLink("about"))
         ![Logo](hyde::asset("logo.png"))
         MARKDOWN;
 
         $expected = <<<'HTML'
         <p><a href="home.html">Home</a>
-        <a href="about">About</a>
         <img src="media/logo.png" alt="Logo" /></p>
 
         HTML;
@@ -76,13 +70,13 @@ public function testDynamicMarkdownLinksWithDoubleQuotes()
     public function testDynamicMarkdownLinksInParagraphs()
     {
         $input = <<<'MARKDOWN'
-        This is a paragraph with a [link to home](hyde::route('home')) and an [about link](hyde::relativeLink('about')).
+        This is a paragraph with a [link to home](hyde::route('home')).
 
         Another paragraph with an ![image](hyde::asset('image.jpg')).
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p>This is a paragraph with a <a href="home.html">link to home</a> and an <a href="about">about link</a>.</p>
+        <p>This is a paragraph with a <a href="home.html">link to home</a>.</p>
         <p>Another paragraph with an <img src="media/image.jpg" alt="image" />.</p>
 
         HTML;
@@ -94,7 +88,6 @@ public function testDynamicMarkdownLinksInLists()
     {
         $input = <<<'MARKDOWN'
         - [Home](hyde::route('home'))
-        - [About](hyde::relativeLink('about'))
         - ![Logo](hyde::asset('logo.png'))
         MARKDOWN;
 
@@ -104,9 +97,6 @@ public function testDynamicMarkdownLinksInLists()
         <a href="home.html">Home</a>
         </li>
         <li>
-        <a href="about">About</a>
-        </li>
-        <li>
         <img src="media/logo.png" alt="Logo" />
         </li>
         </ul>
@@ -120,12 +110,10 @@ public function testDynamicMarkdownLinksWithNestedRoutes()
     {
         $input = <<<'MARKDOWN'
         [Blog Post](hyde::route('blog/post'))
-        [Relative Blog](hyde::relativeLink('blog/post'))
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="blog/post.html">Blog Post</a>
-        <a href="blog/post">Relative Blog</a></p>
+        <p><a href="blog/post.html">Blog Post</a></p>
 
         HTML;
 
@@ -137,7 +125,6 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
         $input = <<<'MARKDOWN'
         [Home](hyde::route('home'))
         [External](https://example.com)
-        [About](hyde::relativeLink('about'))
         [Regular](regular-link.html)
         ![Logo](hyde::asset('logo.png'))
         ![External Image](https://example.com/image.jpg)
@@ -146,7 +133,6 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
         $expected = <<<'HTML'
         <p><a href="home.html">Home</a>
         <a href="https://example.com">External</a>
-        <a href="about">About</a>
         <a href="regular-link.html">Regular</a>
         <img src="media/logo.png" alt="Logo" />
         <img src="https://example.com/image.jpg" alt="External Image" /></p>
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 4ebc368e653..daca2d7ea34 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -50,22 +50,6 @@ public function testRouteReplacementWithoutQuotes()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRelativeLinkReplacement()
-    {
-        $input = '<p><a href="hyde::relativeLink(\'about\')">About</a></p>';
-        $expected = '<p><a href="about">About</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testRelativeLinkReplacementWithoutQuotes()
-    {
-        $input = '<p><a href="hyde::relativeLink(about)">About</a></p>';
-        $expected = '<p><a href="about">About</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testAssetReplacement()
     {
         $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
@@ -86,13 +70,11 @@ public function testMultipleReplacements()
     {
         $input = <<<'HTML'
         <a href="hyde::route('home')">Home</a>
-        <a href="hyde::relativeLink('about')">About</a>
         <img src="hyde::asset('logo.png')" alt="Logo" />
         HTML;
 
         $expected = <<<'HTML'
         <a href="home.html">Home</a>
-        <a href="about">About</a>
         <img src="media/logo.png" alt="Logo" />
         HTML;
 
@@ -141,14 +123,6 @@ public function testMalformedRouteLink3()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testMalformedRelativeLink()
-    {
-        $input = '<p><a href="hyde::relativeLink(about\')">Malformed About</a></p>';
-        $expected = '<p><a href="hyde::relativeLink(about\')">Malformed About</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testMalformedAssetLink()
     {
         $input = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
@@ -165,14 +139,6 @@ public function testEmptyRouteLink()
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testEmptyRelativeLink()
-    {
-        $input = '<p><a href="hyde::relativeLink()">Empty Relative Link</a></p>';
-        $expected = '<p><a href="hyde::relativeLink()">Empty Relative Link</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
     public function testEmptyAssetLink()
     {
         $input = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
@@ -186,8 +152,6 @@ public function testMixedValidAndInvalidLinks()
         $input = <<<'HTML'
         <a href="hyde::route('home')">Valid Home</a>
         <a href="hyde::route(invalid'">Invalid Route</a>
-        <a href="hyde::relativeLink('about')">Valid About</a>
-        <a href="hyde::relativeLink(about')">Invalid Relative</a>
         <img src="hyde::asset('logo.png')" alt="Valid Logo" />
         <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
         HTML;
@@ -195,8 +159,6 @@ public function testMixedValidAndInvalidLinks()
         $expected = <<<'HTML'
         <a href="home.html">Valid Home</a>
         <a href="hyde::route(invalid'">Invalid Route</a>
-        <a href="about">Valid About</a>
-        <a href="hyde::relativeLink(about')">Invalid Relative</a>
         <img src="media/logo.png" alt="Valid Logo" />
         <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
         HTML;

From d4d8762640544f0402c651797715b0303384940e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 21:47:29 +0200
Subject: [PATCH 2751/4023] New proof of concept

---
 docs/digging-deeper/advanced-markdown.md      |  38 ++++--
 .../DynamicMarkdownLinkProcessor.php          |  59 +++++----
 .../DynamicMarkdownLinksFeatureTest.php       |  83 ++++++------
 .../DynamicMarkdownLinkProcessorTest.php      | 122 ++++++------------
 4 files changed, 141 insertions(+), 161 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index f8d59d14267..ce04af98bfd 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -163,7 +163,7 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 ## Dynamic Markdown Links
 
-HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using a special Hyde Markdown link syntax, designed to match the syntax of the `Hyde` facade.
+HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using source file paths, which are then converted to the appropriate routes in the built site.
 
 ### Usage
 
@@ -171,29 +171,43 @@ You can use the following syntax options in your Markdown files:
 
 ```markdown
 <!-- Resolving a page route -->
-[Home](hyde::route('home'))
+[Home](/_pages/index.blade.php)
 
 <!-- Resolving a media asset -->
-![Logo](hyde::asset('logo.png'))
+![Logo](/_media/logo.svg)
 ```
 
 By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links. The feature is always enabled in the Markdown converter.
 
+### How It Works
 
-### Breakdown
+When you use a source file path in your Markdown links, HydePHP will automatically convert it to the appropriate route or asset path in the built site. For example:
 
-The example above is equivalent to the following Blade syntax:
+- `/_pages/index.blade.php` will be converted to `index.html`
+- `/_pages/blog/post.blade.php` will be converted to `blog/post.html`
+- `/_media/logo.svg` will be converted to `media/logo.svg`
 
-```blade
-<!-- Resolving a page route -->
-{{ Hyde::route('route.name') ?? throw new RouteNotFoundException() }}
+This conversion happens during the build process, ensuring that your links are always up-to-date with your current site structure.
 
-<!-- Resolving a media asset -->
-{{ Hyde::asset('path') }}
-```
+### Benefits
+
+1. **IDE Support**: By using actual file paths, you get better IDE support, including autocompletion and error checking.
+2. **Syntax Highlighting**: Your Markdown editor can provide proper syntax highlighting for these links, as they use standard Markdown syntax.
+3. **Easy Navigation**: You can easily navigate to the source files by clicking on the links in your IDE.
+
+### Limitations
+
+- This syntax doesn't support linking to dynamic routes. For such cases, you may need to use a different approach.
+- If you move or rename source files, make sure to update any Markdown links referencing them to avoid broken links.
+- While this approach provides better IDE support and syntax highlighting, it does couple your content to your project structure. Consider this trade-off when deciding to use this feature.
+
+### Best Practices
 
-As you can see, we throw an exception if the route doesn't exist, to provide immediate feedback during development.
+1. Always use the leading slash (`/`) in your links to ensure consistency and avoid potential issues with relative paths.
+2. Keep your file structure organized and consistent to make it easier to manage links.
+3. Regularly check for broken links in your content, especially after moving or renaming files.
 
+By following these guidelines and understanding the limitations, you can effectively use dynamic Markdown links to create more maintainable and flexible content in your HydePHP projects.
 
 ## Configuration
 
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 0bbe7643826..5ab0541ad2c 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,38 +5,49 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
+use Illuminate\Support\Str;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
-        foreach (static::patterns() as $pattern => $replacement) {
-            $html = preg_replace_callback($pattern, $replacement, $html);
+        // Todo cache in static property bound to kernel version (but evaluation is tied to rendering page)
+
+        $map = [];
+
+        /** @var \Hyde\Support\Models\Route $route */
+        foreach (Hyde::routes() as $route) {
+            $map[$route->getSourcePath()] = $route;
         }
 
-        return $html;
-    }
+        foreach ($map as $sourcePath => $route) {
+            $patterns = [
+                '<a href="'.$sourcePath.'">',
+                '<a href="/'.$sourcePath.'">',
+            ];
 
-    /** @return array<string, callable(array<int, string>): string> */
-    protected static function patterns(): array
-    {
-        return [
-            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                $route = Hyde::route($matches[2]);
-                if ($route === null) {
-                    // While the other patterns work regardless of if input is valid,
-                    // this method returns null, which silently fails to an empty string.
-                    // So we instead throw an exception to alert the developer of the issue.
-                    throw new RouteNotFoundException($matches[2]);
-                }
-
-                return '<a href="'.$route.'"';
-            },
-            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                return '<img src="'.Hyde::asset($matches[2]).'"';
-            },
-        ];
+            $html = str_replace($patterns, '<a href="'.$route->getLink().'">', $html);
+        }
+
+        // maybe we just need to cache this, as the kernel is already a singleton, but this is not
+        $assetMap = [];
+
+        foreach (MediaFile::all() as $mediaFile) {
+            $assetMap[$mediaFile->getPath()] = $mediaFile;
+        }
+
+        foreach ($assetMap as $path => $mediaFile) {
+            $patterns = [
+                '<img src="'.$path.'"',
+                '<img src="/'.$path.'"',
+            ];
+
+            $localPath = Str::after($mediaFile->getPath(), '_media/');
+            $html = str_replace($patterns, '<img src="'.Hyde::asset($localPath).'"', $html);
+        }
+
+        return $html;
     }
 }
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index a4d57aa76a5..c88cf429291 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -8,58 +8,41 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
-use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
  * @covers \Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter
- *
- * @see \Hyde\Framework\Testing\Feature\Services\Markdown\DynamicMarkdownLinkProcessorTest
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
-    protected function setUp(): void
+    public static function setUpBeforeClass(): void
     {
-        parent::setUp();
+        parent::setUpBeforeClass();
 
-        Routes::addRoute(new Route(new InMemoryPage('home')));
-        Routes::addRoute(new Route(new InMemoryPage('blog/post')));
+        touch('_media/logo.png');
+        touch('_media/image.jpg');
     }
 
-    public function testBasicDynamicMarkdownLinks()
+    public static function tearDownAfterClass(): void
     {
-        $input = <<<'MARKDOWN'
-        [Home](hyde::route('home'))
-        ![Logo](hyde::asset('logo.png'))
-        
-        [Home](hyde::route(home))
-        ![Logo](hyde::asset(logo.png))
-        MARKDOWN;
-
-        $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
-        <img src="media/logo.png" alt="Logo" /></p>
-        <p><a href="home.html">Home</a>
-        <img src="media/logo.png" alt="Logo" /></p>
-
-        HTML;
+        unlink('_media/logo.png');
+        unlink('_media/image.jpg');
 
-        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+        parent::tearDownAfterClass();
     }
 
-    public function testDynamicMarkdownLinksWithDoubleQuotes()
+    public function testBasicDynamicMarkdownLinks()
     {
-        $this->markTestSkipped('https://github.com/hydephp/develop/pull/1590#discussion_r1690082732');
-
         $input = <<<'MARKDOWN'
-        [Home](hyde::route("home"))
-        ![Logo](hyde::asset("logo.png"))
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
+        <p><a href="index.html">Home</a>
         <img src="media/logo.png" alt="Logo" /></p>
 
         HTML;
@@ -70,13 +53,13 @@ public function testDynamicMarkdownLinksWithDoubleQuotes()
     public function testDynamicMarkdownLinksInParagraphs()
     {
         $input = <<<'MARKDOWN'
-        This is a paragraph with a [link to home](hyde::route('home')).
+        This is a paragraph with a [link to home](/_pages/index.blade.php).
 
-        Another paragraph with an ![image](hyde::asset('image.jpg')).
+        Another paragraph with an ![image](/_media/image.jpg).
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p>This is a paragraph with a <a href="home.html">link to home</a>.</p>
+        <p>This is a paragraph with a <a href="index.html">link to home</a>.</p>
         <p>Another paragraph with an <img src="media/image.jpg" alt="image" />.</p>
 
         HTML;
@@ -87,14 +70,14 @@ public function testDynamicMarkdownLinksInParagraphs()
     public function testDynamicMarkdownLinksInLists()
     {
         $input = <<<'MARKDOWN'
-        - [Home](hyde::route('home'))
-        - ![Logo](hyde::asset('logo.png'))
+        - [Home](/_pages/index.blade.php)
+        - ![Logo](/_media/logo.png)
         MARKDOWN;
 
         $expected = <<<'HTML'
         <ul>
         <li>
-        <a href="home.html">Home</a>
+        <a href="index.html">Home</a>
         </li>
         <li>
         <img src="media/logo.png" alt="Logo" />
@@ -108,12 +91,14 @@ public function testDynamicMarkdownLinksInLists()
 
     public function testDynamicMarkdownLinksWithNestedRoutes()
     {
+        Routes::addRoute(new Route(new MarkdownPage('about/contact')));
+
         $input = <<<'MARKDOWN'
-        [Blog Post](hyde::route('blog/post'))
+        [Contact](/_pages/about/contact.md)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="blog/post.html">Blog Post</a></p>
+        <p><a href="about/contact.html">Contact</a></p>
 
         HTML;
 
@@ -123,15 +108,15 @@ public function testDynamicMarkdownLinksWithNestedRoutes()
     public function testMixOfDynamicAndRegularMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
-        [Home](hyde::route('home'))
+        [Home](/_pages/index.blade.php)
         [External](https://example.com)
         [Regular](regular-link.html)
-        ![Logo](hyde::asset('logo.png'))
+        ![Logo](/_media/logo.png)
         ![External Image](https://example.com/image.jpg)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
+        <p><a href="index.html">Home</a>
         <a href="https://example.com">External</a>
         <a href="regular-link.html">Regular</a>
         <img src="media/logo.png" alt="Logo" />
@@ -141,4 +126,20 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testLinksWithLeadingSlash()
+    {
+        $input = <<<'MARKDOWN'
+        [Home with slash](/_pages/index.blade.php)
+        ![Logo with slash](/_media/logo.png)
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="index.html">Home with slash</a>
+        <img src="media/logo.png" alt="Logo with slash" /></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
 }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index daca2d7ea34..002ba287a8a 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,13 +6,13 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
-use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\BladePage;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\RenderData;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
@@ -31,37 +31,40 @@ protected function setUp(): void
 
         Render::swap(new RenderData());
 
-        Routes::addRoute(new Route(new InMemoryPage('home')));
+        Routes::addRoute(new Route(new BladePage('index')));
+        Routes::addRoute(new Route(new MarkdownPost('post')));
+
+        // Todo: No way to mock media files, so we are using app.css as a test asset for now.
     }
 
     public function testRouteReplacement()
     {
-        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
-        $expected = '<p><a href="home.html">Home</a></p>';
+        $input = '<p><a href="_pages/index.blade.php">Home</a></p>';
+        $expected = '<p><a href="index.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRouteReplacementWithoutQuotes()
+    public function testRouteReplacementWithLeadingSlash()
     {
-        $input = '<p><a href="hyde::route(home)">Home</a></p>';
-        $expected = '<p><a href="home.html">Home</a></p>';
+        $input = '<p><a href="/_pages/index.blade.php">Home</a></p>';
+        $expected = '<p><a href="index.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacement()
     {
-        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
-        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
+        $input = '<p><img src="_media/app.css" alt="Logo" /></p>';
+        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testAssetReplacementWithoutQuotes()
+    public function testAssetReplacementWithLeadingSlash()
     {
-        $input = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
-        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
+        $input = '<p><img src="/_media/app.css" alt="Logo" /></p>';
+        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -69,13 +72,13 @@ public function testAssetReplacementWithoutQuotes()
     public function testMultipleReplacements()
     {
         $input = <<<'HTML'
-        <a href="hyde::route('home')">Home</a>
-        <img src="hyde::asset('logo.png')" alt="Logo" />
+        <a href="_pages/index.blade.php">Home</a>
+        <img src="_media/app.css" alt="Logo" />
         HTML;
 
         $expected = <<<'HTML'
-        <a href="home.html">Home</a>
-        <img src="media/logo.png" alt="Logo" />
+        <a href="index.html">Home</a>
+        <img src="media/app.css" alt="Logo" />
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
@@ -88,61 +91,28 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testNonExistentRouteThrowsException()
-    {
-        $this->expectException(RouteNotFoundException::class);
-        $this->expectExceptionMessage('Route [non-existent] not found.');
-
-        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
-        DynamicMarkdownLinkProcessor::postprocess($input);
-    }
-
-    // Fault tolerance tests
-
-    public function testMalformedRouteLink()
-    {
-        $input = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMalformedRouteLink2()
-    {
-        $input = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMalformedRouteLink3()
+    public function testNestedRouteReplacement()
     {
-        $input = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
+        $input = '<p><a href="_posts/post.md">Blog Post</a></p>';
+        $expected = '<p><a href="posts/post.html">Blog Post</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testMalformedAssetLink()
-    {
-        $input = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
-        $expected = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
+    // Fault tolerance tests
 
-    public function testEmptyRouteLink()
+    public function testNonExistentRouteIsNotReplaced()
     {
-        $input = '<p><a href="hyde::route()">Empty Route</a></p>';
-        $expected = '<p><a href="hyde::route()">Empty Route</a></p>';
+        $input = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
+        $expected = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testEmptyAssetLink()
+    public function testNonExistentAssetIsNotReplaced()
     {
-        $input = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
-        $expected = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
+        $input = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
+        $expected = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -150,35 +120,19 @@ public function testEmptyAssetLink()
     public function testMixedValidAndInvalidLinks()
     {
         $input = <<<'HTML'
-        <a href="hyde::route('home')">Valid Home</a>
-        <a href="hyde::route(invalid'">Invalid Route</a>
-        <img src="hyde::asset('logo.png')" alt="Valid Logo" />
-        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
+        <a href="_pages/index.blade.php">Valid Home</a>
+        <a href="_pages/invalid.blade.php">Invalid Route</a>
+        <img src="_media/app.css" alt="Valid Logo" />
+        <img src="_media/invalid.jpg" alt="Invalid Asset" />
         HTML;
 
         $expected = <<<'HTML'
-        <a href="home.html">Valid Home</a>
-        <a href="hyde::route(invalid'">Invalid Route</a>
-        <img src="media/logo.png" alt="Valid Logo" />
-        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
+        <a href="index.html">Valid Home</a>
+        <a href="_pages/invalid.blade.php">Invalid Route</a>
+        <img src="media/app.css" alt="Valid Logo" />
+        <img src="_media/invalid.jpg" alt="Invalid Asset" />
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
-
-    public function testMalformedHydeSyntax()
-    {
-        $input = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
-        $expected = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testNonExistentRouteFunction()
-    {
-        $input = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
-        $expected = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
 }

From 9e613daae4995f0b078c91b1a481db45933b0cce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 24 Jul 2024 22:28:58 +0200
Subject: [PATCH 2752/4023] Improve proof of concept

---
 docs/digging-deeper/advanced-markdown.md      |  55 ++++-----
 .../DynamicMarkdownLinkProcessor.php          |  56 ++++++---
 .../DynamicMarkdownLinksFeatureTest.php       | 107 ++++++++++++++++++
 .../tests/Unit/IncludesFacadeUnitTest.php     |   9 ++
 4 files changed, 176 insertions(+), 51 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index ce04af98bfd..1278f1702a4 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -163,51 +163,40 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 ## Dynamic Markdown Links
 
-HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using source file paths, which are then converted to the appropriate routes in the built site.
+## Overview
+HydePHP automatically resolves links in your Markdown files using source file paths, converting them to appropriate routes in the built site.
 
-### Usage
-
-You can use the following syntax options in your Markdown files:
+## Usage
+In your Markdown files, use source file paths for links:
 
 ```markdown
-<!-- Resolving a page route -->
 [Home](/_pages/index.blade.php)
-
-<!-- Resolving a media asset -->
 ![Logo](/_media/logo.svg)
 ```
 
-By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links. The feature is always enabled in the Markdown converter.
-
-### How It Works
-
-When you use a source file path in your Markdown links, HydePHP will automatically convert it to the appropriate route or asset path in the built site. For example:
+## How It Works
+During the build process, HydePHP converts source paths to their corresponding routes:
 
-- `/_pages/index.blade.php` will be converted to `index.html`
-- `/_pages/blog/post.blade.php` will be converted to `blog/post.html`
-- `/_media/logo.svg` will be converted to `media/logo.svg`
-
-This conversion happens during the build process, ensuring that your links are always up-to-date with your current site structure.
-
-### Benefits
-
-1. **IDE Support**: By using actual file paths, you get better IDE support, including autocompletion and error checking.
-2. **Syntax Highlighting**: Your Markdown editor can provide proper syntax highlighting for these links, as they use standard Markdown syntax.
-3. **Easy Navigation**: You can easily navigate to the source files by clicking on the links in your IDE.
-
-### Limitations
+- `/_pages/index.blade.php` becomes `index.html`
+- `/_pages/blog/post.blade.php` becomes `blog/post.html`
+- `/_media/logo.svg` becomes `media/logo.svg`
 
-- This syntax doesn't support linking to dynamic routes. For such cases, you may need to use a different approach.
-- If you move or rename source files, make sure to update any Markdown links referencing them to avoid broken links.
-- While this approach provides better IDE support and syntax highlighting, it does couple your content to your project structure. Consider this trade-off when deciding to use this feature.
+## Benefits
+- Enhanced IDE support (autocompletion, error checking)
+- Proper syntax highlighting in Markdown editors
+- Easy navigation to source files
 
-### Best Practices
+## Limitations
+- Doesn't support dynamic routes
+- Content becomes coupled to project structure
+- Requires manual updates if files are moved or renamed
 
-1. Always use the leading slash (`/`) in your links to ensure consistency and avoid potential issues with relative paths.
-2. Keep your file structure organized and consistent to make it easier to manage links.
-3. Regularly check for broken links in your content, especially after moving or renaming files.
+## Best Practices
+1. Use leading slashes in links for consistency
+2. Maintain an organized file structure
+3. Regularly check for broken links, especially after file operations
 
-By following these guidelines and understanding the limitations, you can effectively use dynamic Markdown links to create more maintainable and flexible content in your HydePHP projects.
+By leveraging this feature, you can create more maintainable content while enjoying improved developer tooling support.
 
 ## Configuration
 
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 5ab0541ad2c..0a12e54b03c 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -12,6 +12,32 @@
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
+    {
+        foreach (static::routeMap() as $sourcePath => $route) {
+            $patterns = [
+                sprintf('<a href="%s">', $sourcePath),
+                sprintf('<a href="/%s">', $sourcePath),
+            ];
+
+            $html = str_replace($patterns, sprintf('<a href="%s">', $route->getLink()), $html);
+        }
+
+        foreach (static::assetMap() as $path => $mediaFile) {
+            $patterns = [
+                sprintf('<img src="%s"', $path),
+                sprintf('<img src="/%s"', $path),
+            ];
+
+            $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);
+        }
+
+        return $html;
+    }
+
+    /**
+     * @return array<string, \Hyde\Support\Models\Route>
+     */
+    protected static function routeMap(): array
     {
         // Todo cache in static property bound to kernel version (but evaluation is tied to rendering page)
 
@@ -22,15 +48,14 @@ public static function postprocess(string $html): string
             $map[$route->getSourcePath()] = $route;
         }
 
-        foreach ($map as $sourcePath => $route) {
-            $patterns = [
-                '<a href="'.$sourcePath.'">',
-                '<a href="/'.$sourcePath.'">',
-            ];
-
-            $html = str_replace($patterns, '<a href="'.$route->getLink().'">', $html);
-        }
+        return $map;
+    }
 
+    /**
+     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
+     */
+    protected static function assetMap(): array
+    {
         // maybe we just need to cache this, as the kernel is already a singleton, but this is not
         $assetMap = [];
 
@@ -38,16 +63,11 @@ public static function postprocess(string $html): string
             $assetMap[$mediaFile->getPath()] = $mediaFile;
         }
 
-        foreach ($assetMap as $path => $mediaFile) {
-            $patterns = [
-                '<img src="'.$path.'"',
-                '<img src="/'.$path.'"',
-            ];
-
-            $localPath = Str::after($mediaFile->getPath(), '_media/');
-            $html = str_replace($patterns, '<img src="'.Hyde::asset($localPath).'"', $html);
-        }
+        return $assetMap;
+    }
 
-        return $html;
+    protected static function assetPath(MediaFile $mediaFile): string
+    {
+        return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
     }
 }
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index c88cf429291..dd0c4f408c5 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -8,6 +8,7 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Hyde\Support\Includes;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
@@ -15,6 +16,8 @@
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
  * @covers \Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter
+ *
+ * @see \Hyde\Framework\Testing\Feature\Services\Markdown\DynamicMarkdownLinkProcessorTest
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
@@ -142,4 +145,108 @@ public function testLinksWithLeadingSlash()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testCanRenderPageWithDynamicMarkdownLinks()
+    {
+        $this->file('_pages/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $page = MarkdownPage::get('test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="index.html">Home</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderNestedPageWithDynamicMarkdownLinks()
+    {
+        $this->file('_pages/nested/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $page = MarkdownPage::get('nested/test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="../index.html">Home</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderIncludeWithDynamicMarkdownLinks()
+    {
+        // if there is no current path data, we assume the file is included from the root
+
+        $this->file('resources/includes/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $html = Includes::markdown('test')->toHtml();
+
+        $expected = [
+            '<a href="index.html">Home</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderIncludeFromNestedPageWithDynamicMarkdownLinks()
+    {
+        $this->mockCurrentPage('nested/test');
+
+        $this->file('resources/includes/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $html = Includes::markdown('test')->toHtml();
+
+        $expected = [
+            '<a href="../index.html">Home</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
 }
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 1da30c9d435..6dac17db2f5 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,9 +9,12 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
+use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
+use Hyde\Testing\MocksKernelFeatures;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -20,6 +23,8 @@
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {
+    use MocksKernelFeatures;
+
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
@@ -28,6 +33,10 @@ protected function setUp(): void
         parent::setUp();
 
         Blade::swap(Mockery::mock());
+
+        $this->setupTestKernel();
+        $this->kernel->setRoutes(collect());
+        Render::swap(new RenderData());
     }
 
     protected function tearDown(): void

From 6a5f159d2bd4f6cea4901af7bd4b0e8cb97871c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:31:32 +0200
Subject: [PATCH 2753/4023] Prepare to refactor proof of concept

Want to reimplement these a bit better

Revert "New proof of concept"

This reverts commit d4d8762640544f0402c651797715b0303384940e.

Revert "Improve proof of concept"

This reverts commit 9e613daae4995f0b078c91b1a481db45933b0cce.
---
 docs/digging-deeper/advanced-markdown.md      |  45 ++---
 .../DynamicMarkdownLinkProcessor.php          |  73 ++-----
 .../DynamicMarkdownLinksFeatureTest.php       | 186 ++++--------------
 .../DynamicMarkdownLinkProcessorTest.php      | 122 ++++++++----
 .../tests/Unit/IncludesFacadeUnitTest.php     |   9 -
 5 files changed, 165 insertions(+), 270 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 1278f1702a4..f8d59d14267 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -163,40 +163,37 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 ## Dynamic Markdown Links
 
-## Overview
-HydePHP automatically resolves links in your Markdown files using source file paths, converting them to appropriate routes in the built site.
+HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using a special Hyde Markdown link syntax, designed to match the syntax of the `Hyde` facade.
 
-## Usage
-In your Markdown files, use source file paths for links:
+### Usage
+
+You can use the following syntax options in your Markdown files:
 
 ```markdown
-[Home](/_pages/index.blade.php)
-![Logo](/_media/logo.svg)
+<!-- Resolving a page route -->
+[Home](hyde::route('home'))
+
+<!-- Resolving a media asset -->
+![Logo](hyde::asset('logo.png'))
 ```
 
-## How It Works
-During the build process, HydePHP converts source paths to their corresponding routes:
+By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links. The feature is always enabled in the Markdown converter.
 
-- `/_pages/index.blade.php` becomes `index.html`
-- `/_pages/blog/post.blade.php` becomes `blog/post.html`
-- `/_media/logo.svg` becomes `media/logo.svg`
 
-## Benefits
-- Enhanced IDE support (autocompletion, error checking)
-- Proper syntax highlighting in Markdown editors
-- Easy navigation to source files
+### Breakdown
 
-## Limitations
-- Doesn't support dynamic routes
-- Content becomes coupled to project structure
-- Requires manual updates if files are moved or renamed
+The example above is equivalent to the following Blade syntax:
+
+```blade
+<!-- Resolving a page route -->
+{{ Hyde::route('route.name') ?? throw new RouteNotFoundException() }}
+
+<!-- Resolving a media asset -->
+{{ Hyde::asset('path') }}
+```
 
-## Best Practices
-1. Use leading slashes in links for consistency
-2. Maintain an organized file structure
-3. Regularly check for broken links, especially after file operations
+As you can see, we throw an exception if the route doesn't exist, to provide immediate feedback during development.
 
-By leveraging this feature, you can create more maintainable content while enjoying improved developer tooling support.
 
 ## Configuration
 
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 0a12e54b03c..0bbe7643826 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,69 +5,38 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
-use Illuminate\Support\Str;
-use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
-        foreach (static::routeMap() as $sourcePath => $route) {
-            $patterns = [
-                sprintf('<a href="%s">', $sourcePath),
-                sprintf('<a href="/%s">', $sourcePath),
-            ];
-
-            $html = str_replace($patterns, sprintf('<a href="%s">', $route->getLink()), $html);
-        }
-
-        foreach (static::assetMap() as $path => $mediaFile) {
-            $patterns = [
-                sprintf('<img src="%s"', $path),
-                sprintf('<img src="/%s"', $path),
-            ];
-
-            $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);
+        foreach (static::patterns() as $pattern => $replacement) {
+            $html = preg_replace_callback($pattern, $replacement, $html);
         }
 
         return $html;
     }
 
-    /**
-     * @return array<string, \Hyde\Support\Models\Route>
-     */
-    protected static function routeMap(): array
-    {
-        // Todo cache in static property bound to kernel version (but evaluation is tied to rendering page)
-
-        $map = [];
-
-        /** @var \Hyde\Support\Models\Route $route */
-        foreach (Hyde::routes() as $route) {
-            $map[$route->getSourcePath()] = $route;
-        }
-
-        return $map;
-    }
-
-    /**
-     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
-     */
-    protected static function assetMap(): array
-    {
-        // maybe we just need to cache this, as the kernel is already a singleton, but this is not
-        $assetMap = [];
-
-        foreach (MediaFile::all() as $mediaFile) {
-            $assetMap[$mediaFile->getPath()] = $mediaFile;
-        }
-
-        return $assetMap;
-    }
-
-    protected static function assetPath(MediaFile $mediaFile): string
+    /** @return array<string, callable(array<int, string>): string> */
+    protected static function patterns(): array
     {
-        return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
+        return [
+            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+                $route = Hyde::route($matches[2]);
+                if ($route === null) {
+                    // While the other patterns work regardless of if input is valid,
+                    // this method returns null, which silently fails to an empty string.
+                    // So we instead throw an exception to alert the developer of the issue.
+                    throw new RouteNotFoundException($matches[2]);
+                }
+
+                return '<a href="'.$route.'"';
+            },
+            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
+                return '<img src="'.Hyde::asset($matches[2]).'"';
+            },
+        ];
     }
 }
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index dd0c4f408c5..a4d57aa76a5 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -8,8 +8,7 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
-use Hyde\Support\Includes;
-use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 
@@ -21,31 +20,46 @@
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
-    public static function setUpBeforeClass(): void
+    protected function setUp(): void
     {
-        parent::setUpBeforeClass();
+        parent::setUp();
 
-        touch('_media/logo.png');
-        touch('_media/image.jpg');
+        Routes::addRoute(new Route(new InMemoryPage('home')));
+        Routes::addRoute(new Route(new InMemoryPage('blog/post')));
     }
 
-    public static function tearDownAfterClass(): void
+    public function testBasicDynamicMarkdownLinks()
     {
-        unlink('_media/logo.png');
-        unlink('_media/image.jpg');
+        $input = <<<'MARKDOWN'
+        [Home](hyde::route('home'))
+        ![Logo](hyde::asset('logo.png'))
+        
+        [Home](hyde::route(home))
+        ![Logo](hyde::asset(logo.png))
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="home.html">Home</a>
+        <img src="media/logo.png" alt="Logo" /></p>
+        <p><a href="home.html">Home</a>
+        <img src="media/logo.png" alt="Logo" /></p>
+
+        HTML;
 
-        parent::tearDownAfterClass();
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
 
-    public function testBasicDynamicMarkdownLinks()
+    public function testDynamicMarkdownLinksWithDoubleQuotes()
     {
+        $this->markTestSkipped('https://github.com/hydephp/develop/pull/1590#discussion_r1690082732');
+
         $input = <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
-        ![Logo](/_media/logo.png)
+        [Home](hyde::route("home"))
+        ![Logo](hyde::asset("logo.png"))
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="index.html">Home</a>
+        <p><a href="home.html">Home</a>
         <img src="media/logo.png" alt="Logo" /></p>
 
         HTML;
@@ -56,13 +70,13 @@ public function testBasicDynamicMarkdownLinks()
     public function testDynamicMarkdownLinksInParagraphs()
     {
         $input = <<<'MARKDOWN'
-        This is a paragraph with a [link to home](/_pages/index.blade.php).
+        This is a paragraph with a [link to home](hyde::route('home')).
 
-        Another paragraph with an ![image](/_media/image.jpg).
+        Another paragraph with an ![image](hyde::asset('image.jpg')).
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p>This is a paragraph with a <a href="index.html">link to home</a>.</p>
+        <p>This is a paragraph with a <a href="home.html">link to home</a>.</p>
         <p>Another paragraph with an <img src="media/image.jpg" alt="image" />.</p>
 
         HTML;
@@ -73,14 +87,14 @@ public function testDynamicMarkdownLinksInParagraphs()
     public function testDynamicMarkdownLinksInLists()
     {
         $input = <<<'MARKDOWN'
-        - [Home](/_pages/index.blade.php)
-        - ![Logo](/_media/logo.png)
+        - [Home](hyde::route('home'))
+        - ![Logo](hyde::asset('logo.png'))
         MARKDOWN;
 
         $expected = <<<'HTML'
         <ul>
         <li>
-        <a href="index.html">Home</a>
+        <a href="home.html">Home</a>
         </li>
         <li>
         <img src="media/logo.png" alt="Logo" />
@@ -94,14 +108,12 @@ public function testDynamicMarkdownLinksInLists()
 
     public function testDynamicMarkdownLinksWithNestedRoutes()
     {
-        Routes::addRoute(new Route(new MarkdownPage('about/contact')));
-
         $input = <<<'MARKDOWN'
-        [Contact](/_pages/about/contact.md)
+        [Blog Post](hyde::route('blog/post'))
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="about/contact.html">Contact</a></p>
+        <p><a href="blog/post.html">Blog Post</a></p>
 
         HTML;
 
@@ -111,15 +123,15 @@ public function testDynamicMarkdownLinksWithNestedRoutes()
     public function testMixOfDynamicAndRegularMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
+        [Home](hyde::route('home'))
         [External](https://example.com)
         [Regular](regular-link.html)
-        ![Logo](/_media/logo.png)
+        ![Logo](hyde::asset('logo.png'))
         ![External Image](https://example.com/image.jpg)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="index.html">Home</a>
+        <p><a href="home.html">Home</a>
         <a href="https://example.com">External</a>
         <a href="regular-link.html">Regular</a>
         <img src="media/logo.png" alt="Logo" />
@@ -129,124 +141,4 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
-
-    public function testLinksWithLeadingSlash()
-    {
-        $input = <<<'MARKDOWN'
-        [Home with slash](/_pages/index.blade.php)
-        ![Logo with slash](/_media/logo.png)
-        MARKDOWN;
-
-        $expected = <<<'HTML'
-        <p><a href="index.html">Home with slash</a>
-        <img src="media/logo.png" alt="Logo with slash" /></p>
-
-        HTML;
-
-        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
-    }
-
-    public function testCanRenderPageWithDynamicMarkdownLinks()
-    {
-        $this->file('_pages/test.md', <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
-        ![Logo](/_media/logo.png)
-
-        [non-existent](/_pages/non-existent.md)
-        ![non-existent](/_media/non-existent.png)
-        MARKDOWN);
-
-        $page = MarkdownPage::get('test');
-        Hyde::shareViewData($page);
-        $html = $page->compile();
-
-        $expected = [
-            '<a href="index.html">Home</a>',
-            '<img src="media/logo.png" alt="Logo" />',
-            '<a href="/_pages/non-existent.md">non-existent</a>',
-            '<img src="/_media/non-existent.png" alt="non-existent" />',
-        ];
-
-        foreach ($expected as $expectation) {
-            $this->assertStringContainsString($expectation, $html);
-        }
-    }
-
-    public function testCanRenderNestedPageWithDynamicMarkdownLinks()
-    {
-        $this->file('_pages/nested/test.md', <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
-        ![Logo](/_media/logo.png)
-
-        [non-existent](/_pages/non-existent.md)
-        ![non-existent](/_media/non-existent.png)
-        MARKDOWN);
-
-        $page = MarkdownPage::get('nested/test');
-        Hyde::shareViewData($page);
-        $html = $page->compile();
-
-        $expected = [
-            '<a href="../index.html">Home</a>',
-            '<img src="../media/logo.png" alt="Logo" />',
-            '<a href="/_pages/non-existent.md">non-existent</a>',
-            '<img src="/_media/non-existent.png" alt="non-existent" />',
-        ];
-
-        foreach ($expected as $expectation) {
-            $this->assertStringContainsString($expectation, $html);
-        }
-    }
-
-    public function testCanRenderIncludeWithDynamicMarkdownLinks()
-    {
-        // if there is no current path data, we assume the file is included from the root
-
-        $this->file('resources/includes/test.md', <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
-        ![Logo](/_media/logo.png)
-
-        [non-existent](/_pages/non-existent.md)
-        ![non-existent](/_media/non-existent.png)
-        MARKDOWN);
-
-        $html = Includes::markdown('test')->toHtml();
-
-        $expected = [
-            '<a href="index.html">Home</a>',
-            '<img src="media/logo.png" alt="Logo" />',
-            '<a href="/_pages/non-existent.md">non-existent</a>',
-            '<img src="/_media/non-existent.png" alt="non-existent" />',
-        ];
-
-        foreach ($expected as $expectation) {
-            $this->assertStringContainsString($expectation, $html);
-        }
-    }
-
-    public function testCanRenderIncludeFromNestedPageWithDynamicMarkdownLinks()
-    {
-        $this->mockCurrentPage('nested/test');
-
-        $this->file('resources/includes/test.md', <<<'MARKDOWN'
-        [Home](/_pages/index.blade.php)
-        ![Logo](/_media/logo.png)
-
-        [non-existent](/_pages/non-existent.md)
-        ![non-existent](/_media/non-existent.png)
-        MARKDOWN);
-
-        $html = Includes::markdown('test')->toHtml();
-
-        $expected = [
-            '<a href="../index.html">Home</a>',
-            '<img src="../media/logo.png" alt="Logo" />',
-            '<a href="/_pages/non-existent.md">non-existent</a>',
-            '<img src="/_media/non-existent.png" alt="non-existent" />',
-        ];
-
-        foreach ($expected as $expectation) {
-            $this->assertStringContainsString($expectation, $html);
-        }
-    }
 }
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 002ba287a8a..daca2d7ea34 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,13 +6,13 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
-use Hyde\Pages\BladePage;
-use Hyde\Pages\MarkdownPost;
+use Hyde\Pages\InMemoryPage;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\RenderData;
+use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
@@ -31,40 +31,37 @@ protected function setUp(): void
 
         Render::swap(new RenderData());
 
-        Routes::addRoute(new Route(new BladePage('index')));
-        Routes::addRoute(new Route(new MarkdownPost('post')));
-
-        // Todo: No way to mock media files, so we are using app.css as a test asset for now.
+        Routes::addRoute(new Route(new InMemoryPage('home')));
     }
 
     public function testRouteReplacement()
     {
-        $input = '<p><a href="_pages/index.blade.php">Home</a></p>';
-        $expected = '<p><a href="index.html">Home</a></p>';
+        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
+        $expected = '<p><a href="home.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRouteReplacementWithLeadingSlash()
+    public function testRouteReplacementWithoutQuotes()
     {
-        $input = '<p><a href="/_pages/index.blade.php">Home</a></p>';
-        $expected = '<p><a href="index.html">Home</a></p>';
+        $input = '<p><a href="hyde::route(home)">Home</a></p>';
+        $expected = '<p><a href="home.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacement()
     {
-        $input = '<p><img src="_media/app.css" alt="Logo" /></p>';
-        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
+        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
+        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testAssetReplacementWithLeadingSlash()
+    public function testAssetReplacementWithoutQuotes()
     {
-        $input = '<p><img src="/_media/app.css" alt="Logo" /></p>';
-        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
+        $input = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
+        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -72,13 +69,13 @@ public function testAssetReplacementWithLeadingSlash()
     public function testMultipleReplacements()
     {
         $input = <<<'HTML'
-        <a href="_pages/index.blade.php">Home</a>
-        <img src="_media/app.css" alt="Logo" />
+        <a href="hyde::route('home')">Home</a>
+        <img src="hyde::asset('logo.png')" alt="Logo" />
         HTML;
 
         $expected = <<<'HTML'
-        <a href="index.html">Home</a>
-        <img src="media/app.css" alt="Logo" />
+        <a href="home.html">Home</a>
+        <img src="media/logo.png" alt="Logo" />
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
@@ -91,28 +88,61 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testNestedRouteReplacement()
+    public function testNonExistentRouteThrowsException()
     {
-        $input = '<p><a href="_posts/post.md">Blog Post</a></p>';
-        $expected = '<p><a href="posts/post.html">Blog Post</a></p>';
+        $this->expectException(RouteNotFoundException::class);
+        $this->expectExceptionMessage('Route [non-existent] not found.');
 
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
+        DynamicMarkdownLinkProcessor::postprocess($input);
     }
 
     // Fault tolerance tests
 
-    public function testNonExistentRouteIsNotReplaced()
+    public function testMalformedRouteLink()
+    {
+        $input = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedRouteLink2()
+    {
+        $input = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedRouteLink3()
+    {
+        $input = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
+        $expected = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMalformedAssetLink()
+    {
+        $input = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
+        $expected = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testEmptyRouteLink()
     {
-        $input = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
-        $expected = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
+        $input = '<p><a href="hyde::route()">Empty Route</a></p>';
+        $expected = '<p><a href="hyde::route()">Empty Route</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testNonExistentAssetIsNotReplaced()
+    public function testEmptyAssetLink()
     {
-        $input = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
-        $expected = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
+        $input = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
+        $expected = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -120,19 +150,35 @@ public function testNonExistentAssetIsNotReplaced()
     public function testMixedValidAndInvalidLinks()
     {
         $input = <<<'HTML'
-        <a href="_pages/index.blade.php">Valid Home</a>
-        <a href="_pages/invalid.blade.php">Invalid Route</a>
-        <img src="_media/app.css" alt="Valid Logo" />
-        <img src="_media/invalid.jpg" alt="Invalid Asset" />
+        <a href="hyde::route('home')">Valid Home</a>
+        <a href="hyde::route(invalid'">Invalid Route</a>
+        <img src="hyde::asset('logo.png')" alt="Valid Logo" />
+        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
         HTML;
 
         $expected = <<<'HTML'
-        <a href="index.html">Valid Home</a>
-        <a href="_pages/invalid.blade.php">Invalid Route</a>
-        <img src="media/app.css" alt="Valid Logo" />
-        <img src="_media/invalid.jpg" alt="Invalid Asset" />
+        <a href="home.html">Valid Home</a>
+        <a href="hyde::route(invalid'">Invalid Route</a>
+        <img src="media/logo.png" alt="Valid Logo" />
+        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
+
+    public function testMalformedHydeSyntax()
+    {
+        $input = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
+        $expected = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testNonExistentRouteFunction()
+    {
+        $input = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
+        $expected = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 }
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 6dac17db2f5..1da30c9d435 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,12 +9,9 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
-use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
-use Hyde\Testing\MocksKernelFeatures;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -23,8 +20,6 @@
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {
-    use MocksKernelFeatures;
-
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
@@ -33,10 +28,6 @@ protected function setUp(): void
         parent::setUp();
 
         Blade::swap(Mockery::mock());
-
-        $this->setupTestKernel();
-        $this->kernel->setRoutes(collect());
-        Render::swap(new RenderData());
     }
 
     protected function tearDown(): void

From 9c19e5025063d8575c8e1b0a6972e3a2d1499cb4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:40:28 +0200
Subject: [PATCH 2754/4023] Document new dynamic Markdown link feature spec

---
 docs/digging-deeper/advanced-markdown.md | 47 +++++++++++++++---------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index f8d59d14267..e0ce47a5a37 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -163,37 +163,48 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 ## Dynamic Markdown Links
 
-HydePHP provides a powerful feature for automatically resolving dynamic links within your pages and posts using a special Hyde Markdown link syntax, designed to match the syntax of the `Hyde` facade.
+## Overview
 
-### Usage
+HydePHP provides a powerful feature for automatically converting Markdown links to source files to the corresponding routes in the built site.
 
-You can use the following syntax options in your Markdown files:
+This allows for much better writing experience when using an IDE, as you can easily navigate to the source file by clicking on the link.
 
-```markdown
-<!-- Resolving a page route -->
-[Home](hyde::route('home'))
+## Usage
+
+Using the feature is simple: Just use source file paths for links:
 
-<!-- Resolving a media asset -->
-![Logo](hyde::asset('logo.png'))
+```markdown
+[Home](/_pages/index.blade.php)
+![Logo](/_media/logo.svg)
 ```
 
-By using these dynamic Markdown links, you can create more maintainable and flexible content, allowing your site structure to evolve without breaking internal links. The feature is always enabled in the Markdown converter.
+As you can see, it works for both pages and media assets. The leading slash is optional and will be ignored by Hyde, but including it often gives better IDE support.
 
+### Behind the Scenes
 
-### Breakdown
+During the build process, HydePHP converts source paths to their corresponding routes, and evaluates them depending on the page being rendered.
 
-The example above is equivalent to the following Blade syntax:
+If your page is in the site root then:
 
-```blade
-<!-- Resolving a page route -->
-{{ Hyde::route('route.name') ?? throw new RouteNotFoundException() }}
+- `/_pages/index.blade.php` becomes `index.html`
+- `/_media/logo.svg` becomes `media/logo.svg`
 
-<!-- Resolving a media asset -->
-{{ Hyde::asset('path') }}
-```
+If your page is in a subdirectory then:
+
+- `/_pages/index.blade.php` becomes `../index.html`
+- `/_media/logo.svg` becomes `../media/logo.svg`
+
+Of course, if your page is in a more deeply nested directory, the number of `../` will increase accordingly.
+
+We will of course also match your configured preference for `pretty_urls` and only include the `.html` extension when desired.
+
+### Limitations
 
-As you can see, we throw an exception if the route doesn't exist, to provide immediate feedback during development.
+There are some limitations and considerations to keep in mind when using this feature:
 
+- This feature won't work for dynamic routes (not backed by a file)
+- If you rename a file, links will break. Your IDE may warn about this.
+- If a file is not found, we won't be able to see it when evaluating links.
 
 ## Configuration
 

From 70deb8ca82137a5fd01a77f5e0571afe749d5352 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:43:22 +0200
Subject: [PATCH 2755/4023] Remove the patterns method

---
 .../DynamicMarkdownLinkProcessor.php          | 21 -------------------
 1 file changed, 21 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 0bbe7643826..ab0dc0a7236 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -18,25 +18,4 @@ public static function postprocess(string $html): string
 
         return $html;
     }
-
-    /** @return array<string, callable(array<int, string>): string> */
-    protected static function patterns(): array
-    {
-        return [
-            '/<a href="hyde::route\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                $route = Hyde::route($matches[2]);
-                if ($route === null) {
-                    // While the other patterns work regardless of if input is valid,
-                    // this method returns null, which silently fails to an empty string.
-                    // So we instead throw an exception to alert the developer of the issue.
-                    throw new RouteNotFoundException($matches[2]);
-                }
-
-                return '<a href="'.$route.'"';
-            },
-            '/<img src="hyde::asset\(([\'"]?)([^\'"]+)\1\)"/' => function (array $matches): string {
-                return '<img src="'.Hyde::asset($matches[2]).'"';
-            },
-        ];
-    }
 }

From 780b871d0c7e5fc366518dfce45508c437a221a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:44:25 +0200
Subject: [PATCH 2756/4023] Remove the patterns loop

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php   | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index ab0dc0a7236..cd2888e6bfa 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -12,9 +12,6 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
-        foreach (static::patterns() as $pattern => $replacement) {
-            $html = preg_replace_callback($pattern, $replacement, $html);
-        }
 
         return $html;
     }

From dee2c96d87af33711b6636ddc213abe3d802f030 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:44:37 +0200
Subject: [PATCH 2757/4023] Remove unused import

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php     | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index cd2888e6bfa..29ad4a388fa 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,7 +5,6 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract

From 642ec731c2bacfb9872234c0999e8ddb3e588358 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:44:56 +0200
Subject: [PATCH 2758/4023] Draft new processing loop

---
 .../Processing/DynamicMarkdownLinkProcessor.php | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 29ad4a388fa..784e8a46e4b 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -11,6 +11,23 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
     public static function postprocess(string $html): string
     {
+        foreach (static::routeMap() as $sourcePath => $route) {
+            $patterns = [
+                '<a href="'.$sourcePath.'">',
+                '<a href="/'.$sourcePath.'">',
+            ];
+
+            $html = str_replace($patterns, '<a href="'.$route->getLink().'">', $html);
+        }
+
+        foreach (static::assetMap() as $path => $mediaFile) {
+            $patterns = [
+                '<img src="'.$path.'"',
+                '<img src="/'.$path.'"',
+            ];
+
+            $html = str_replace($patterns, '<img src="'.static::assetPath($mediaFile).'"', $html);
+        }
 
         return $html;
     }

From 2b35be29d405747f8d5d500d0e25816ae183a54f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:45:48 +0200
Subject: [PATCH 2759/4023] Convert concatenation to 'sprintf()' calls

---
 .../Processing/DynamicMarkdownLinkProcessor.php      | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 784e8a46e4b..e6a3483a1ba 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -13,20 +13,20 @@ public static function postprocess(string $html): string
     {
         foreach (static::routeMap() as $sourcePath => $route) {
             $patterns = [
-                '<a href="'.$sourcePath.'">',
-                '<a href="/'.$sourcePath.'">',
+                sprintf('<a href="%s">', $sourcePath),
+                sprintf('<a href="/%s">', $sourcePath),
             ];
 
-            $html = str_replace($patterns, '<a href="'.$route->getLink().'">', $html);
+            $html = str_replace($patterns, sprintf('<a href="%s">', $route->getLink()), $html);
         }
 
         foreach (static::assetMap() as $path => $mediaFile) {
             $patterns = [
-                '<img src="'.$path.'"',
-                '<img src="/'.$path.'"',
+                sprintf('<img src="%s"', $path),
+                sprintf('<img src="/%s"', $path),
             ];
 
-            $html = str_replace($patterns, '<img src="'.static::assetPath($mediaFile).'"', $html);
+            $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);
         }
 
         return $html;

From 2afc335e06ac1ff09fd1bac354d31efbaa9a4e05 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:46:12 +0200
Subject: [PATCH 2760/4023] Implement the route map method

---
 .../Processing/DynamicMarkdownLinkProcessor.php   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index e6a3483a1ba..5efab805bd6 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -31,4 +31,19 @@ public static function postprocess(string $html): string
 
         return $html;
     }
+
+    /**
+     * @return array<string, \Hyde\Support\Models\Route>
+     */
+    protected static function routeMap(): array
+    {
+        $map = [];
+
+        /** @var \Hyde\Support\Models\Route $route */
+        foreach (Hyde::routes() as $route) {
+            $map[$route->getSourcePath()] = $route;
+        }
+
+        return $map;
+    }
 }

From 04a0a7c09f9d57530e7b2da17251fa476ffe54db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:46:47 +0200
Subject: [PATCH 2761/4023] Implement the asset map method

---
 .../Processing/DynamicMarkdownLinkProcessor.php   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 5efab805bd6..a334a5cbf06 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,6 +5,7 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
@@ -46,4 +47,18 @@ protected static function routeMap(): array
 
         return $map;
     }
+
+    /**
+     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
+     */
+    protected static function assetMap(): array
+    {
+        $assetMap = [];
+
+        foreach (MediaFile::all() as $mediaFile) {
+            $assetMap[$mediaFile->getPath()] = $mediaFile;
+        }
+
+        return $assetMap;
+    }
 }

From 48efa5ea4f2824aa49a0ed8ce6b9c01ddbc1405d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:47:04 +0200
Subject: [PATCH 2762/4023] Implement the asset path method

---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index a334a5cbf06..4086e23e03b 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -5,6 +5,7 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Hyde;
+use Illuminate\Support\Str;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -61,4 +62,9 @@ protected static function assetMap(): array
 
         return $assetMap;
     }
+
+    protected static function assetPath(MediaFile $mediaFile): string
+    {
+        return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
+    }
 }

From f8c2c22db84aad3ebb8dfc0bc8c783b8ed385770 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 10:47:08 +0200
Subject: [PATCH 2763/4023] Add todo

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 4086e23e03b..247a41d3c14 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -50,6 +50,8 @@ protected static function routeMap(): array
     }
 
     /**
+     * @todo Consider adding caching, since this is not a singleton like the routes.
+     *
      * @return array<string, \Hyde\Support\Filesystem\MediaFile>
      */
     protected static function assetMap(): array

From b5d8f71096019d61b3b7101a3306e755b140cac7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:01:53 +0200
Subject: [PATCH 2764/4023] Update imports

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index daca2d7ea34..e50098cfcc6 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,13 +6,12 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
-use Hyde\Pages\InMemoryPage;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Support\Models\RenderData;
-use Hyde\Framework\Exceptions\RouteNotFoundException;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**

From 37b8f84caf1214fa5043aaa56d4aa8b653e2d60f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:02:01 +0200
Subject: [PATCH 2765/4023] Add import

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index e50098cfcc6..3fdf5cee477 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -6,6 +6,7 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
+use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;

From a44357d96441b925b29d61e1abcf1ded977d0762 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:02:12 +0200
Subject: [PATCH 2766/4023] Update route mocks

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 3fdf5cee477..d5c82d9ed89 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -31,7 +31,8 @@ protected function setUp(): void
 
         Render::swap(new RenderData());
 
-        Routes::addRoute(new Route(new InMemoryPage('home')));
+        Routes::addRoute(new Route(new BladePage('index')));
+        Routes::addRoute(new Route(new MarkdownPost('post')));
     }
 
     public function testRouteReplacement()

From c175cb585ec4c88ca092a6c6876dad4f13202613 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:02:53 +0200
Subject: [PATCH 2767/4023] Remove old exception test

---
 .../Markdown/DynamicMarkdownLinkProcessorTest.php        | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index d5c82d9ed89..81e9e3fa443 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -89,15 +89,6 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testNonExistentRouteThrowsException()
-    {
-        $this->expectException(RouteNotFoundException::class);
-        $this->expectExceptionMessage('Route [non-existent] not found.');
-
-        $input = '<p><a href="hyde::route(\'non-existent\')">Non-existent Route</a></p>';
-        DynamicMarkdownLinkProcessor::postprocess($input);
-    }
-
     // Fault tolerance tests
 
     public function testMalformedRouteLink()

From a8be72d63cba247dc80f470271c7b0652d28dcfc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:03:22 +0200
Subject: [PATCH 2768/4023] Remove old fault tolerance tests

---
 .../DynamicMarkdownLinkProcessorTest.php         | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 81e9e3fa443..a11e4b07083 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -157,20 +157,4 @@ public function testMixedValidAndInvalidLinks()
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
-
-    public function testMalformedHydeSyntax()
-    {
-        $input = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
-        $expected = '<p><a href="hyde:route(\'home\')">Malformed Hyde Syntax</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testNonExistentRouteFunction()
-    {
-        $input = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
-        $expected = '<p><a href="hyde::nonexistent(\'home\')">Non-existent Function</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
 }

From 77af426995451c0133cf1ae34929c2894a4f540d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:04:18 +0200
Subject: [PATCH 2769/4023] Remove old fault tolerance tests

---
 .../DynamicMarkdownLinkProcessorTest.php      | 69 -------------------
 1 file changed, 69 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index a11e4b07083..3da31d46cd2 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -88,73 +88,4 @@ public function testNoReplacements()
 
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
-
-    // Fault tolerance tests
-
-    public function testMalformedRouteLink()
-    {
-        $input = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home">Malformed Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMalformedRouteLink2()
-    {
-        $input = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home)">Malformed Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMalformedRouteLink3()
-    {
-        $input = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
-        $expected = '<p><a href="hyde::route(\'home\'">Malformed Home</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMalformedAssetLink()
-    {
-        $input = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
-        $expected = '<p><img src="hyde::asset(\'image.jpg" alt="Malformed Image" /></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testEmptyRouteLink()
-    {
-        $input = '<p><a href="hyde::route()">Empty Route</a></p>';
-        $expected = '<p><a href="hyde::route()">Empty Route</a></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testEmptyAssetLink()
-    {
-        $input = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
-        $expected = '<p><img src="hyde::asset()" alt="Empty Asset" /></p>';
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
-
-    public function testMixedValidAndInvalidLinks()
-    {
-        $input = <<<'HTML'
-        <a href="hyde::route('home')">Valid Home</a>
-        <a href="hyde::route(invalid'">Invalid Route</a>
-        <img src="hyde::asset('logo.png')" alt="Valid Logo" />
-        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
-        HTML;
-
-        $expected = <<<'HTML'
-        <a href="home.html">Valid Home</a>
-        <a href="hyde::route(invalid'">Invalid Route</a>
-        <img src="media/logo.png" alt="Valid Logo" />
-        <img src="hyde::asset('image.jpg" alt="Invalid Asset" />
-        HTML;
-
-        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
-    }
 }

From c3a46c957d803433c18356cf7419a06049bc134b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:05:05 +0200
Subject: [PATCH 2770/4023] Add new fault tolerance tests

---
 .../DynamicMarkdownLinkProcessorTest.php      | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 3da31d46cd2..cf90f6ccd1d 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -88,4 +88,41 @@ public function testNoReplacements()
 
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
+
+    // Fault tolerance tests
+
+    public function testNonExistentRouteIsNotReplaced()
+    {
+        $input = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
+        $expected = '<p><a href="_pages/non-existent.blade.php">Non-existent Route</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testNonExistentAssetIsNotReplaced()
+    {
+        $input = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
+        $expected = '<p><img src="_media/non-existent.png" alt="Non-existent Asset" /></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
+    public function testMixedValidAndInvalidLinks()
+    {
+        $input = <<<'HTML'
+        <a href="_pages/index.blade.php">Valid Home</a>
+        <a href="_pages/invalid.blade.php">Invalid Route</a>
+        <img src="_media/logo.png" alt="Valid Logo" />
+        <img src="_media/invalid.jpg" alt="Invalid Asset" />
+        HTML;
+
+        $expected = <<<'HTML'
+        <a href="index.html">Valid Home</a>
+        <a href="_pages/invalid.blade.php">Invalid Route</a>
+        <img src="media/logo.png" alt="Valid Logo" />
+        <img src="_media/invalid.jpg" alt="Invalid Asset" />
+        HTML;
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
 }

From b79d983f5a112c01892d739e744ba25685a76db5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:06:06 +0200
Subject: [PATCH 2771/4023] Update test for the new dynamic Markdown link
 feature

---
 .../DynamicMarkdownLinkProcessorTest.php      | 34 ++++++++++++-------
 1 file changed, 21 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index cf90f6ccd1d..6e5969a2e05 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -37,32 +37,32 @@ protected function setUp(): void
 
     public function testRouteReplacement()
     {
-        $input = '<p><a href="hyde::route(\'home\')">Home</a></p>';
-        $expected = '<p><a href="home.html">Home</a></p>';
+        $input = '<p><a href="_pages/index.blade.php">Home</a></p>';
+        $expected = '<p><a href="index.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testRouteReplacementWithoutQuotes()
+    public function testRouteReplacementWithLeadingSlash()
     {
-        $input = '<p><a href="hyde::route(home)">Home</a></p>';
-        $expected = '<p><a href="home.html">Home</a></p>';
+        $input = '<p><a href="/_pages/index.blade.php">Home</a></p>';
+        $expected = '<p><a href="index.html">Home</a></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacement()
     {
-        $input = '<p><img src="hyde::asset(\'image.jpg\')" alt="Image" /></p>';
-        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
+        $input = '<p><img src="_media/logo.png" alt="Logo" /></p>';
+        $expected = '<p><img src="media/logo.png" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
-    public function testAssetReplacementWithoutQuotes()
+    public function testAssetReplacementWithLeadingSlash()
     {
-        $input = '<p><img src="hyde::asset(image.jpg)" alt="Image" /></p>';
-        $expected = '<p><img src="media/image.jpg" alt="Image" /></p>';
+        $input = '<p><img src="/_media/logo.png" alt="Logo" /></p>';
+        $expected = '<p><img src="media/logo.png" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -70,12 +70,12 @@ public function testAssetReplacementWithoutQuotes()
     public function testMultipleReplacements()
     {
         $input = <<<'HTML'
-        <a href="hyde::route('home')">Home</a>
-        <img src="hyde::asset('logo.png')" alt="Logo" />
+        <a href="_pages/index.blade.php">Home</a>
+        <img src="_media/logo.png" alt="Logo" />
         HTML;
 
         $expected = <<<'HTML'
-        <a href="home.html">Home</a>
+        <a href="index.html">Home</a>
         <img src="media/logo.png" alt="Logo" />
         HTML;
 
@@ -89,6 +89,14 @@ public function testNoReplacements()
         $this->assertSame($input, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
+    public function testNestedRouteReplacement()
+    {
+        $input = '<p><a href="_posts/post.md">Blog Post</a></p>';
+        $expected = '<p><a href="posts/post.html">Blog Post</a></p>';
+
+        $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
+    }
+
     // Fault tolerance tests
 
     public function testNonExistentRouteIsNotReplaced()

From c6445010ee6ada62cd13c584c94736d08f8912ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:06:26 +0200
Subject: [PATCH 2772/4023] Use existing file pending mock support

---
 .../DynamicMarkdownLinkProcessorTest.php       | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 6e5969a2e05..002ba287a8a 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -33,6 +33,8 @@ protected function setUp(): void
 
         Routes::addRoute(new Route(new BladePage('index')));
         Routes::addRoute(new Route(new MarkdownPost('post')));
+
+        // Todo: No way to mock media files, so we are using app.css as a test asset for now.
     }
 
     public function testRouteReplacement()
@@ -53,16 +55,16 @@ public function testRouteReplacementWithLeadingSlash()
 
     public function testAssetReplacement()
     {
-        $input = '<p><img src="_media/logo.png" alt="Logo" /></p>';
-        $expected = '<p><img src="media/logo.png" alt="Logo" /></p>';
+        $input = '<p><img src="_media/app.css" alt="Logo" /></p>';
+        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
 
     public function testAssetReplacementWithLeadingSlash()
     {
-        $input = '<p><img src="/_media/logo.png" alt="Logo" /></p>';
-        $expected = '<p><img src="media/logo.png" alt="Logo" /></p>';
+        $input = '<p><img src="/_media/app.css" alt="Logo" /></p>';
+        $expected = '<p><img src="media/app.css" alt="Logo" /></p>';
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
@@ -71,12 +73,12 @@ public function testMultipleReplacements()
     {
         $input = <<<'HTML'
         <a href="_pages/index.blade.php">Home</a>
-        <img src="_media/logo.png" alt="Logo" />
+        <img src="_media/app.css" alt="Logo" />
         HTML;
 
         $expected = <<<'HTML'
         <a href="index.html">Home</a>
-        <img src="media/logo.png" alt="Logo" />
+        <img src="media/app.css" alt="Logo" />
         HTML;
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
@@ -120,14 +122,14 @@ public function testMixedValidAndInvalidLinks()
         $input = <<<'HTML'
         <a href="_pages/index.blade.php">Valid Home</a>
         <a href="_pages/invalid.blade.php">Invalid Route</a>
-        <img src="_media/logo.png" alt="Valid Logo" />
+        <img src="_media/app.css" alt="Valid Logo" />
         <img src="_media/invalid.jpg" alt="Invalid Asset" />
         HTML;
 
         $expected = <<<'HTML'
         <a href="index.html">Valid Home</a>
         <a href="_pages/invalid.blade.php">Invalid Route</a>
-        <img src="media/logo.png" alt="Valid Logo" />
+        <img src="media/app.css" alt="Valid Logo" />
         <img src="_media/invalid.jpg" alt="Invalid Asset" />
         HTML;
 

From 6e50913ecefa775945a039d2024d7e41f0a5e076 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:08:11 +0200
Subject: [PATCH 2773/4023] Replace feature test setup with lower level
 filesystem configuration

---
 .../tests/Feature/DynamicMarkdownLinksFeatureTest.php     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index a4d57aa76a5..f2cd450f7bd 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -20,12 +20,12 @@
  */
 class DynamicMarkdownLinksFeatureTest extends TestCase
 {
-    protected function setUp(): void
+    public static function setUpBeforeClass(): void
     {
-        parent::setUp();
+        parent::setUpBeforeClass();
 
-        Routes::addRoute(new Route(new InMemoryPage('home')));
-        Routes::addRoute(new Route(new InMemoryPage('blog/post')));
+        touch('_media/logo.png');
+        touch('_media/image.jpg');
     }
 
     public function testBasicDynamicMarkdownLinks()

From 6d6d75388e0a617434247b780f167487ba280d36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:08:58 +0200
Subject: [PATCH 2774/4023] Tear down filesystem after class

---
 .../tests/Feature/DynamicMarkdownLinksFeatureTest.php     | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index f2cd450f7bd..acebe47a10c 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -28,6 +28,14 @@ public static function setUpBeforeClass(): void
         touch('_media/image.jpg');
     }
 
+    public static function tearDownAfterClass(): void
+    {
+        unlink('_media/logo.png');
+        unlink('_media/image.jpg');
+
+        parent::tearDownAfterClass();
+    }
+
     public function testBasicDynamicMarkdownLinks()
     {
         $input = <<<'MARKDOWN'

From 48558faec24b40118ff28877a7f23abf939b0cb8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:09:37 +0200
Subject: [PATCH 2775/4023] Update test for the new dynamic Markdown link
 feature

---
 .../DynamicMarkdownLinksFeatureTest.php       | 72 +++++++++----------
 1 file changed, 34 insertions(+), 38 deletions(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index acebe47a10c..b720b006b4a 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -8,7 +8,8 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
-use Hyde\Pages\InMemoryPage;
+use Hyde\Support\Includes;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
 
@@ -39,35 +40,12 @@ public static function tearDownAfterClass(): void
     public function testBasicDynamicMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
-        [Home](hyde::route('home'))
-        ![Logo](hyde::asset('logo.png'))
-        
-        [Home](hyde::route(home))
-        ![Logo](hyde::asset(logo.png))
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
-        <img src="media/logo.png" alt="Logo" /></p>
-        <p><a href="home.html">Home</a>
-        <img src="media/logo.png" alt="Logo" /></p>
-
-        HTML;
-
-        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
-    }
-
-    public function testDynamicMarkdownLinksWithDoubleQuotes()
-    {
-        $this->markTestSkipped('https://github.com/hydephp/develop/pull/1590#discussion_r1690082732');
-
-        $input = <<<'MARKDOWN'
-        [Home](hyde::route("home"))
-        ![Logo](hyde::asset("logo.png"))
-        MARKDOWN;
-
-        $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
+        <p><a href="index.html">Home</a>
         <img src="media/logo.png" alt="Logo" /></p>
 
         HTML;
@@ -78,13 +56,13 @@ public function testDynamicMarkdownLinksWithDoubleQuotes()
     public function testDynamicMarkdownLinksInParagraphs()
     {
         $input = <<<'MARKDOWN'
-        This is a paragraph with a [link to home](hyde::route('home')).
+        This is a paragraph with a [link to home](/_pages/index.blade.php).
 
-        Another paragraph with an ![image](hyde::asset('image.jpg')).
+        Another paragraph with an ![image](/_media/image.jpg).
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p>This is a paragraph with a <a href="home.html">link to home</a>.</p>
+        <p>This is a paragraph with a <a href="index.html">link to home</a>.</p>
         <p>Another paragraph with an <img src="media/image.jpg" alt="image" />.</p>
 
         HTML;
@@ -95,14 +73,14 @@ public function testDynamicMarkdownLinksInParagraphs()
     public function testDynamicMarkdownLinksInLists()
     {
         $input = <<<'MARKDOWN'
-        - [Home](hyde::route('home'))
-        - ![Logo](hyde::asset('logo.png'))
+        - [Home](/_pages/index.blade.php)
+        - ![Logo](/_media/logo.png)
         MARKDOWN;
 
         $expected = <<<'HTML'
         <ul>
         <li>
-        <a href="home.html">Home</a>
+        <a href="index.html">Home</a>
         </li>
         <li>
         <img src="media/logo.png" alt="Logo" />
@@ -116,12 +94,14 @@ public function testDynamicMarkdownLinksInLists()
 
     public function testDynamicMarkdownLinksWithNestedRoutes()
     {
+        Routes::addRoute(new Route(new MarkdownPage('about/contact')));
+
         $input = <<<'MARKDOWN'
-        [Blog Post](hyde::route('blog/post'))
+        [Contact](/_pages/about/contact.md)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="blog/post.html">Blog Post</a></p>
+        <p><a href="about/contact.html">Contact</a></p>
 
         HTML;
 
@@ -131,15 +111,15 @@ public function testDynamicMarkdownLinksWithNestedRoutes()
     public function testMixOfDynamicAndRegularMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
-        [Home](hyde::route('home'))
+        [Home](/_pages/index.blade.php)
         [External](https://example.com)
         [Regular](regular-link.html)
-        ![Logo](hyde::asset('logo.png'))
+        ![Logo](/_media/logo.png)
         ![External Image](https://example.com/image.jpg)
         MARKDOWN;
 
         $expected = <<<'HTML'
-        <p><a href="home.html">Home</a>
+        <p><a href="index.html">Home</a>
         <a href="https://example.com">External</a>
         <a href="regular-link.html">Regular</a>
         <img src="media/logo.png" alt="Logo" />
@@ -149,4 +129,20 @@ public function testMixOfDynamicAndRegularMarkdownLinks()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testLinksWithLeadingSlash()
+    {
+        $input = <<<'MARKDOWN'
+        [Home with slash](/_pages/index.blade.php)
+        ![Logo with slash](/_media/logo.png)
+        MARKDOWN;
+
+        $expected = <<<'HTML'
+        <p><a href="index.html">Home with slash</a>
+        <img src="media/logo.png" alt="Logo with slash" /></p>
+
+        HTML;
+
+        $this->assertSame($expected, Hyde::markdown($input)->toHtml());
+    }
 }

From 60786a556133fc1b26e131b7e34deb23a5149e58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:10:00 +0200
Subject: [PATCH 2776/4023] Add more high level feature test cases

---
 .../DynamicMarkdownLinksFeatureTest.php       | 104 ++++++++++++++++++
 1 file changed, 104 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index b720b006b4a..dd0c4f408c5 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -145,4 +145,108 @@ public function testLinksWithLeadingSlash()
 
         $this->assertSame($expected, Hyde::markdown($input)->toHtml());
     }
+
+    public function testCanRenderPageWithDynamicMarkdownLinks()
+    {
+        $this->file('_pages/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $page = MarkdownPage::get('test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="index.html">Home</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderNestedPageWithDynamicMarkdownLinks()
+    {
+        $this->file('_pages/nested/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $page = MarkdownPage::get('nested/test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="../index.html">Home</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderIncludeWithDynamicMarkdownLinks()
+    {
+        // if there is no current path data, we assume the file is included from the root
+
+        $this->file('resources/includes/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $html = Includes::markdown('test')->toHtml();
+
+        $expected = [
+            '<a href="index.html">Home</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testCanRenderIncludeFromNestedPageWithDynamicMarkdownLinks()
+    {
+        $this->mockCurrentPage('nested/test');
+
+        $this->file('resources/includes/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        ![Logo](/_media/logo.png)
+
+        [non-existent](/_pages/non-existent.md)
+        ![non-existent](/_media/non-existent.png)
+        MARKDOWN);
+
+        $html = Includes::markdown('test')->toHtml();
+
+        $expected = [
+            '<a href="../index.html">Home</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+            '<a href="/_pages/non-existent.md">non-existent</a>',
+            '<img src="/_media/non-existent.png" alt="non-existent" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
 }

From 75fc296b167e9f1f3ea83675eb76ace0b737e499 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:10:18 +0200
Subject: [PATCH 2777/4023] Update unit test to mock the kernel routes

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 1da30c9d435..6dac17db2f5 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,9 +9,12 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
+use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
+use Hyde\Testing\MocksKernelFeatures;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -20,6 +23,8 @@
  */
 class IncludesFacadeUnitTest extends UnitTestCase
 {
+    use MocksKernelFeatures;
+
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
@@ -28,6 +33,10 @@ protected function setUp(): void
         parent::setUp();
 
         Blade::swap(Mockery::mock());
+
+        $this->setupTestKernel();
+        $this->kernel->setRoutes(collect());
+        Render::swap(new RenderData());
     }
 
     protected function tearDown(): void

From f0e006475de0fcf40a601e0279622e50917f5b97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 11:26:24 +0200
Subject: [PATCH 2778/4023] Add static variable to cache the asset map in
 memory

This change makes it go from a constant ~2ms per call to essentially zero (0.000ms avg on 100 000 iterations)
---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php  | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 247a41d3c14..db0e4fc411a 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -50,13 +50,15 @@ protected static function routeMap(): array
     }
 
     /**
-     * @todo Consider adding caching, since this is not a singleton like the routes.
-     *
      * @return array<string, \Hyde\Support\Filesystem\MediaFile>
      */
     protected static function assetMap(): array
     {
-        $assetMap = [];
+        static $assetMap = null;
+
+        if ($assetMap !== null) {
+            return $assetMap;
+        }
 
         foreach (MediaFile::all() as $mediaFile) {
             $assetMap[$mediaFile->getPath()] = $mediaFile;

From 25a7328633e76e218abfc84e1b8a1b2001bf4fbe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:05:10 +0200
Subject: [PATCH 2779/4023] Refactor static variable to a static property

---
 .../DynamicMarkdownLinkProcessor.php          | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index db0e4fc411a..a69b2561d48 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -11,6 +11,11 @@
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
+    /**
+     * @var array<string, \Hyde\Support\Filesystem\MediaFile>|null
+     */
+    protected static ?array $assetMapCache = null;
+
     public static function postprocess(string $html): string
     {
         foreach (static::routeMap() as $sourcePath => $route) {
@@ -54,17 +59,15 @@ protected static function routeMap(): array
      */
     protected static function assetMap(): array
     {
-        static $assetMap = null;
-
-        if ($assetMap !== null) {
-            return $assetMap;
-        }
+        if (static::$assetMapCache === null) {
+            static::$assetMapCache = [];
 
-        foreach (MediaFile::all() as $mediaFile) {
-            $assetMap[$mediaFile->getPath()] = $mediaFile;
+            foreach (MediaFile::all() as $mediaFile) {
+                static::$assetMapCache[$mediaFile->getPath()] = $mediaFile;
+            }
         }
 
-        return $assetMap;
+        return static::$assetMapCache;
     }
 
     protected static function assetPath(MediaFile $mediaFile): string

From ae464632e21f8e1ea80dda750d54a4c9b1a5c908 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:05:47 +0200
Subject: [PATCH 2780/4023] Add internal testing helper to reset the asset map
 cache

---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php  | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index a69b2561d48..b1e2ed237a7 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -74,4 +74,12 @@ protected static function assetPath(MediaFile $mediaFile): string
     {
         return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
     }
+
+    /**
+     * @internal Testing helper to reset the asset map cache.
+     */
+    public static function resetAssetMapCache(): void
+    {
+        static::$assetMapCache = null;
+    }
 }

From 8755f49db95e38f85f9a7210a729e08f10874573 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:06:18 +0200
Subject: [PATCH 2781/4023] Reset the asset map cache

---
 .../tests/Feature/DynamicMarkdownLinksFeatureTest.php          | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index dd0c4f408c5..cdf9a416eca 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -12,6 +12,7 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
  * @covers \Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor
@@ -27,6 +28,8 @@ public static function setUpBeforeClass(): void
 
         touch('_media/logo.png');
         touch('_media/image.jpg');
+
+        DynamicMarkdownLinkProcessor::resetAssetMapCache();
     }
 
     public static function tearDownAfterClass(): void

From 1b7bfcb2840efdf2909c6c55ea21999ac46f4604 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:16:45 +0200
Subject: [PATCH 2782/4023] Ignore coverage

---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index b1e2ed237a7..a7f3971617c 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -77,6 +77,8 @@ protected static function assetPath(MediaFile $mediaFile): string
 
     /**
      * @internal Testing helper to reset the asset map cache.
+     *
+     * @codeCoverageIgnore Only used in tests, where it's implicitly covered.
      */
     public static function resetAssetMapCache(): void
     {

From 7e7927b094e10d2fe4e77de21eb6b79f466d49d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:19:54 +0200
Subject: [PATCH 2783/4023] Revert "Ignore coverage"

This reverts commit 1b7bfcb2840efdf2909c6c55ea21999ac46f4604.
---
 .../src/Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index a7f3971617c..b1e2ed237a7 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -77,8 +77,6 @@ protected static function assetPath(MediaFile $mediaFile): string
 
     /**
      * @internal Testing helper to reset the asset map cache.
-     *
-     * @codeCoverageIgnore Only used in tests, where it's implicitly covered.
      */
     public static function resetAssetMapCache(): void
     {

From 76672b26571309cd6ea6c7aa34af74626375450e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:20:40 +0200
Subject: [PATCH 2784/4023] Test the method

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 002ba287a8a..67acd7ffe39 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -135,4 +135,11 @@ public function testMixedValidAndInvalidLinks()
 
         $this->assertSame($expected, DynamicMarkdownLinkProcessor::postprocess($input));
     }
+
+    public function testResetAssetMapCache()
+    {
+        DynamicMarkdownLinkProcessor::resetAssetMapCache();
+
+        $this->assertTrue(true);
+    }
 }

From 7ed5a854debdd3725605bec460a43ad7728f3bf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:22:07 +0200
Subject: [PATCH 2785/4023] Compress PHPDoc annotations

---
 .../Processing/DynamicMarkdownLinkProcessor.php  | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index b1e2ed237a7..39a083cb7c6 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -11,9 +11,7 @@
 
 class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 {
-    /**
-     * @var array<string, \Hyde\Support\Filesystem\MediaFile>|null
-     */
+    /** @var array<string, \Hyde\Support\Filesystem\MediaFile>|null */
     protected static ?array $assetMapCache = null;
 
     public static function postprocess(string $html): string
@@ -39,9 +37,7 @@ public static function postprocess(string $html): string
         return $html;
     }
 
-    /**
-     * @return array<string, \Hyde\Support\Models\Route>
-     */
+    /** @return array<string, \Hyde\Support\Models\Route> */
     protected static function routeMap(): array
     {
         $map = [];
@@ -54,9 +50,7 @@ protected static function routeMap(): array
         return $map;
     }
 
-    /**
-     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
-     */
+    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> */
     protected static function assetMap(): array
     {
         if (static::$assetMapCache === null) {
@@ -75,9 +69,7 @@ protected static function assetPath(MediaFile $mediaFile): string
         return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
     }
 
-    /**
-     * @internal Testing helper to reset the asset map cache.
-     */
+    /** @internal Testing helper to reset the asset map cache. */
     public static function resetAssetMapCache(): void
     {
         static::$assetMapCache = null;

From 376d3eccbae2b418c3c9d5f6fbd2dc6f664e27e9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:25:18 +0200
Subject: [PATCH 2786/4023] Normalize the signatures to be looser and match
 images

---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 39a083cb7c6..f31f1db76fb 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -18,11 +18,11 @@ public static function postprocess(string $html): string
     {
         foreach (static::routeMap() as $sourcePath => $route) {
             $patterns = [
-                sprintf('<a href="%s">', $sourcePath),
-                sprintf('<a href="/%s">', $sourcePath),
+                sprintf('<a href="%s"', $sourcePath),
+                sprintf('<a href="/%s"', $sourcePath),
             ];
 
-            $html = str_replace($patterns, sprintf('<a href="%s">', $route->getLink()), $html);
+            $html = str_replace($patterns, sprintf('<a href="%s"', $route->getLink()), $html);
         }
 
         foreach (static::assetMap() as $path => $mediaFile) {

From 831c83c6aa9a36d0d63f4f948dc0deb3f23bc958 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:25:57 +0200
Subject: [PATCH 2787/4023] Normalize the loop variable name

---
 .../Markdown/Processing/DynamicMarkdownLinkProcessor.php    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index f31f1db76fb..7dc220855e0 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -25,10 +25,10 @@ public static function postprocess(string $html): string
             $html = str_replace($patterns, sprintf('<a href="%s"', $route->getLink()), $html);
         }
 
-        foreach (static::assetMap() as $path => $mediaFile) {
+        foreach (static::assetMap() as $sourcePath => $mediaFile) {
             $patterns = [
-                sprintf('<img src="%s"', $path),
-                sprintf('<img src="/%s"', $path),
+                sprintf('<img src="%s"', $sourcePath),
+                sprintf('<img src="/%s"', $sourcePath),
             ];
 
             $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);

From 851b17a5e0dec626ae56c3a7ed20bc6e2d482a50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:31:39 +0200
Subject: [PATCH 2788/4023] Refactor to extract methods for common logic

---
 .../DynamicMarkdownLinkProcessor.php          | 31 ++++++++++++-------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 7dc220855e0..fc9e6b45330 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
+use Hyde\Support\Models\Route;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -16,27 +17,35 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 
     public static function postprocess(string $html): string
     {
-        foreach (static::routeMap() as $sourcePath => $route) {
-            $patterns = [
-                sprintf('<a href="%s"', $sourcePath),
-                sprintf('<a href="/%s"', $sourcePath),
-            ];
+        $html = static::processMap(static::routeMap(), $html, 'a', 'href');
+        $html = static::processMap(static::assetMap(), $html, 'img', 'src');
 
-            $html = str_replace($patterns, sprintf('<a href="%s"', $route->getLink()), $html);
-        }
+        return $html;
+    }
 
-        foreach (static::assetMap() as $sourcePath => $mediaFile) {
+    /**
+     * @param array<string, \Hyde\Support\Models\Route|\Hyde\Support\Filesystem\MediaFile> $map
+     */
+    protected static function processMap(array $map, string $html, string $tag, string $attribute): string
+    {
+        foreach ($map as $sourcePath => $item) {
             $patterns = [
-                sprintf('<img src="%s"', $sourcePath),
-                sprintf('<img src="/%s"', $sourcePath),
+                sprintf('<%s %s="%s"', $tag, $attribute, $sourcePath),
+                sprintf('<%s %s="/%s"', $tag, $attribute, $sourcePath),
             ];
 
-            $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);
+            $replacement = sprintf('<%s %s="%s"', $tag, $attribute, static::getItemPath($item));
+            $html = str_replace($patterns, $replacement, $html);
         }
 
         return $html;
     }
 
+    protected static function getItemPath(MediaFile|Route $item): string
+    {
+        return $item instanceof MediaFile ? static::assetPath($item) : $item->getLink();
+    }
+
     /** @return array<string, \Hyde\Support\Models\Route> */
     protected static function routeMap(): array
     {

From ede0cdf2b0c7259044f38e2593cf54b464fd874b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:31:42 +0200
Subject: [PATCH 2789/4023] Revert "Refactor to extract methods for common
 logic"

This reverts commit 851b17a5e0dec626ae56c3a7ed20bc6e2d482a50. Cleaner is not always better.
---
 .../DynamicMarkdownLinkProcessor.php          | 31 +++++++------------
 1 file changed, 11 insertions(+), 20 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index fc9e6b45330..7dc220855e0 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
-use Hyde\Support\Models\Route;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract;
 
@@ -17,35 +16,27 @@ class DynamicMarkdownLinkProcessor implements MarkdownPostProcessorContract
 
     public static function postprocess(string $html): string
     {
-        $html = static::processMap(static::routeMap(), $html, 'a', 'href');
-        $html = static::processMap(static::assetMap(), $html, 'img', 'src');
+        foreach (static::routeMap() as $sourcePath => $route) {
+            $patterns = [
+                sprintf('<a href="%s"', $sourcePath),
+                sprintf('<a href="/%s"', $sourcePath),
+            ];
 
-        return $html;
-    }
+            $html = str_replace($patterns, sprintf('<a href="%s"', $route->getLink()), $html);
+        }
 
-    /**
-     * @param array<string, \Hyde\Support\Models\Route|\Hyde\Support\Filesystem\MediaFile> $map
-     */
-    protected static function processMap(array $map, string $html, string $tag, string $attribute): string
-    {
-        foreach ($map as $sourcePath => $item) {
+        foreach (static::assetMap() as $sourcePath => $mediaFile) {
             $patterns = [
-                sprintf('<%s %s="%s"', $tag, $attribute, $sourcePath),
-                sprintf('<%s %s="/%s"', $tag, $attribute, $sourcePath),
+                sprintf('<img src="%s"', $sourcePath),
+                sprintf('<img src="/%s"', $sourcePath),
             ];
 
-            $replacement = sprintf('<%s %s="%s"', $tag, $attribute, static::getItemPath($item));
-            $html = str_replace($patterns, $replacement, $html);
+            $html = str_replace($patterns, sprintf('<img src="%s"', static::assetPath($mediaFile)), $html);
         }
 
         return $html;
     }
 
-    protected static function getItemPath(MediaFile|Route $item): string
-    {
-        return $item instanceof MediaFile ? static::assetPath($item) : $item->getLink();
-    }
-
     /** @return array<string, \Hyde\Support\Models\Route> */
     protected static function routeMap(): array
     {

From 4a46a584cc93be51cf7df6b4484819526886f798 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 16:33:24 +0200
Subject: [PATCH 2790/4023] Document that relative links is not supported here

Would take a ton of complexity
---
 docs/digging-deeper/advanced-markdown.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index e0ce47a5a37..791213a6a39 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -205,6 +205,7 @@ There are some limitations and considerations to keep in mind when using this fe
 - This feature won't work for dynamic routes (not backed by a file)
 - If you rename a file, links will break. Your IDE may warn about this.
 - If a file is not found, we won't be able to see it when evaluating links.
+- Relative links are not supported (so ../_pages/index.blade.php won't work)
 
 ## Configuration
 

From 5cbde9cc429c54b9e95fce3928f9258fc1edfa81 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 18:10:55 +0200
Subject: [PATCH 2791/4023] Add more feature tests

---
 .../DynamicMarkdownLinksFeatureTest.php       | 145 ++++++++++++++++++
 1 file changed, 145 insertions(+)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index cdf9a416eca..60208243185 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -10,7 +10,9 @@
 use Hyde\Testing\TestCase;
 use Hyde\Support\Includes;
 use Hyde\Pages\MarkdownPage;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Support\Models\Route;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
@@ -252,4 +254,147 @@ public function testCanRenderIncludeFromNestedPageWithDynamicMarkdownLinks()
             $this->assertStringContainsString($expectation, $html);
         }
     }
+
+    public function testDynamicMarkdownLinksForDifferentPageTypes()
+    {
+        $this->file('_pages/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        [Documentation](/_docs/index.md)
+        [Readme](/_docs/readme.md)
+        [Example](/_pages/example.md)
+        [Contact](/_pages/about/contact.md)
+        [About](/_pages/about/index.md)
+        [Post](/_posts/hello-world.md)
+        
+        ![Logo](/_media/logo.png)
+        MARKDOWN);
+
+        Routes::addRoute(new Route(new MarkdownPage('example')));
+        Routes::addRoute(new Route(new MarkdownPage('about/index')));
+        Routes::addRoute(new Route(new MarkdownPage('about/contact')));
+        Routes::addRoute(new Route(new MarkdownPost('hello-world')));
+        Routes::addRoute(new Route(new DocumentationPage('index')));
+        Routes::addRoute(new Route(new DocumentationPage('readme')));
+
+        $page = MarkdownPage::get('test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="index.html">Home</a>',
+            '<a href="docs/index.html">Documentation</a>',
+            '<a href="docs/readme.html">Readme</a>',
+            '<a href="example.html">Example</a>',
+            '<a href="about/contact.html">Contact</a>',
+            '<a href="about/index.html">About</a>',
+            '<a href="posts/hello-world.html">Post</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testDynamicMarkdownLinksUseTheSitePrettyUrlConfiguration()
+    {
+        config(['hyde.pretty_urls' => true]);
+
+        $this->file('_pages/test.md', <<<'MARKDOWN'
+        [Home](/_pages/index.blade.php)
+        [Documentation](/_docs/index.md)
+        [Readme](/_docs/readme.md)
+        [Example](/_pages/example.md)
+        [Contact](/_pages/about/contact.md)
+        [About](/_pages/about/index.md)
+        [Post](/_posts/hello-world.md)
+        
+        ![Logo](/_media/logo.png)
+        MARKDOWN);
+
+        Routes::addRoute(new Route(new MarkdownPage('example')));
+        Routes::addRoute(new Route(new MarkdownPage('about/index')));
+        Routes::addRoute(new Route(new MarkdownPage('about/contact')));
+        Routes::addRoute(new Route(new MarkdownPost('hello-world')));
+        Routes::addRoute(new Route(new DocumentationPage('index')));
+        Routes::addRoute(new Route(new DocumentationPage('readme')));
+
+        $page = MarkdownPage::get('test');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="./">Home</a>',
+            '<a href="docs/">Documentation</a>',
+            '<a href="docs/readme">Readme</a>',
+            '<a href="example">Example</a>',
+            '<a href="about/contact">Contact</a>',
+            '<a href="about/">About</a>',
+            '<a href="posts/hello-world">Post</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
+
+    public function testDynamicMarkdownLinksFromDifferentPageTypes()
+    {
+        $links = <<<'MARKDOWN'
+        [Docs](/_docs/docs.md)
+        [Post](/_posts/post.md)
+        [Page](/_pages/page.md)
+        ![Logo](/_media/logo.png)
+        MARKDOWN;
+
+        $this->file('_docs/docs.md', $links);
+        $this->file('_posts/post.md', $links);
+        $this->file('_pages/page.md', $links);
+
+        $page = DocumentationPage::get('docs');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="../docs/docs.html">Docs</a>',
+            '<a href="../posts/post.html">Post</a>',
+            '<a href="../page.html">Page</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+
+        $page = MarkdownPost::get('post');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="../docs/docs.html">Docs</a>',
+            '<a href="../posts/post.html">Post</a>',
+            '<a href="../page.html">Page</a>',
+            '<img src="../media/logo.png" alt="Logo" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+
+        $page = MarkdownPage::get('page');
+        Hyde::shareViewData($page);
+        $html = $page->compile();
+
+        $expected = [
+            '<a href="docs/docs.html">Docs</a>',
+            '<a href="posts/post.html">Post</a>',
+            '<a href="page.html">Page</a>',
+            '<img src="media/logo.png" alt="Logo" />',
+        ];
+
+        foreach ($expected as $expectation) {
+            $this->assertStringContainsString($expectation, $html);
+        }
+    }
 }

From a2bd4468a04a4ee45e53c6db39428ac7487b9653 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 18:11:44 +0200
Subject: [PATCH 2792/4023] Clean up the documentation

---
 docs/digging-deeper/advanced-markdown.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 791213a6a39..b2852df3828 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -163,18 +163,18 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 ## Dynamic Markdown Links
 
-## Overview
-
 HydePHP provides a powerful feature for automatically converting Markdown links to source files to the corresponding routes in the built site.
 
-This allows for much better writing experience when using an IDE, as you can easily navigate to the source file by clicking on the link.
+This allows for much better writing experience when using an IDE, as you can easily navigate to the source file by clicking on the link. Hyde will then automatically resolve the link to the correct route when building the site, formatting the links properly using dynamic relative paths and your configured `pretty_urls` setting.
 
 ## Usage
 
-Using the feature is simple: Just use source file paths for links:
+Using the feature is simple: Just use the source file path when linking to the page you want to resolve:
 
 ```markdown
 [Home](/_pages/index.blade.php)
+[Docs](/_docs/index.md)
+[Featured Post](/_posts/hello-world.md)
 ![Logo](/_media/logo.svg)
 ```
 

From a307b8899169eb3e553db3bd369c4c9ba97a4e51 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 18:11:58 +0200
Subject: [PATCH 2793/4023] Proof the documentation

---
 docs/digging-deeper/advanced-markdown.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index b2852df3828..2fe8bd3648d 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -165,7 +165,7 @@ The filepaths are hidden on mobile devices using CSS to prevent them from overla
 
 HydePHP provides a powerful feature for automatically converting Markdown links to source files to the corresponding routes in the built site.
 
-This allows for much better writing experience when using an IDE, as you can easily navigate to the source file by clicking on the link. Hyde will then automatically resolve the link to the correct route when building the site, formatting the links properly using dynamic relative paths and your configured `pretty_urls` setting.
+This allows for a much better writing experience when using an IDE, as you can easily navigate to the source file by clicking on the link. Hyde will then automatically resolve the link to the correct route when building the site, formatting the links properly using dynamic relative paths and your configured `pretty_urls` setting.
 
 ## Usage
 
@@ -182,7 +182,7 @@ As you can see, it works for both pages and media assets. The leading slash is o
 
 ### Behind the Scenes
 
-During the build process, HydePHP converts source paths to their corresponding routes, and evaluates them depending on the page being rendered.
+During the build process, HydePHP converts source paths to their corresponding routes and evaluates them depending on the page being rendered.
 
 If your page is in the site root then:
 
@@ -196,16 +196,16 @@ If your page is in a subdirectory then:
 
 Of course, if your page is in a more deeply nested directory, the number of `../` will increase accordingly.
 
-We will of course also match your configured preference for `pretty_urls` and only include the `.html` extension when desired.
+We will also match your configured preference for `pretty_urls` and only include the `.html` extension when desired.
 
 ### Limitations
 
 There are some limitations and considerations to keep in mind when using this feature:
 
-- This feature won't work for dynamic routes (not backed by a file)
+- This feature will not work for dynamic routes (not backed by a file)
 - If you rename a file, links will break. Your IDE may warn about this.
-- If a file is not found, we won't be able to see it when evaluating links.
-- Relative links are not supported (so ../_pages/index.blade.php won't work)
+- If a file is not found, we will not be able to see it when evaluating links.
+- Relative links are not supported (so `../_pages/index.blade.php` will not work)
 
 ## Configuration
 

From 2ae3ef998f8710a819e1722cd7ebc338c5f86ff0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 18:12:02 +0200
Subject: [PATCH 2794/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3871aafcb54..86740ca0d9c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,6 +11,7 @@ This serves two purposes:
 
 ### Added
 - You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
+- Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 - Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
 - Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in https://github.com/hydephp/develop/pull/1799

From 788004106c91c7591b6f9d1012689e0a9fccaf62 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:16:49 +0200
Subject: [PATCH 2795/4023] Create spec.md

---
 spec.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 spec.md

diff --git a/spec.md b/spec.md
new file mode 100644
index 00000000000..531a8f21b68
--- /dev/null
+++ b/spec.md
@@ -0,0 +1,45 @@
+# Asset API Overview
+
+## Abstract
+
+In order to rework the Asset API, we need to analyze the current state of the API, to find what can be improved.
+
+## Current State
+
+### Asset Facade
+
+```php
+Asset::cdnLink(string $file) // Gets remote URL to any file in /dist/ in the HydeFront version
+Asset::mediaLink(string $file) // Returns Hyde::mediaLink but with a cache buster
+Asset::hasMediaFile(string $file) // Returns file_exists(Hyde::mediaPath($file))
+
+/**
+ * Real implementations of the facade methods:
+ * 
+ * @see \Hyde\Framework\Services\AssetService::cdnLink
+ * @see \Hyde\Framework\Services\AssetService::mediaLink
+ * @see \Hyde\Framework\Services\AssetService::hasMediaFile
+ */
+```
+
+### Hyde Facade
+
+```php
+Hyde::mediaPath() // Get the absolute path to the media source directory, or a file within it. (Intended as a sibling to Hyde::path and Hyde::sitePath helpers, and the HydePage::path methods)
+Hyde::mediaLink() // Gets a relative web link to the given file stored in the _site/media folder. (Intended as a sibling to Hyde::relativeLink, which is called by this) (A second $validate parameter will return throw an exception if the file does not exist)
+Hyde::asset() // Gets a relative web link to the given image stored in the _site/media folder. (But leaves remote URLs alone) (A second $preferQualifiedUrl parameter will return a fully qualified URL if a site URL is set)
+
+/**
+ * Real implementations of the facade methods:
+ * 
+ * @see \Hyde\Foundation\HydeKernel::mediaPath {@see \Hyde\Foundation\Kernel\Filesystem::mediaPath}
+ * @see \Hyde\Foundation\HydeKernel::mediaLink {@see \Hyde\Foundation\Kernel\Hyperlinks::mediaLink}
+ * @see \Hyde\Foundation\HydeKernel::asset {@see \Hyde\Foundation\Kernel\Hyperlinks::asset}
+ */
+```
+
+### Helper Functions
+
+```php
+asset() // Calls Hyde::asset 
+```

From a05d56076fd136b8dd38d794a75647f7bd9b55ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:24:57 +0200
Subject: [PATCH 2796/4023] Add AI context

---
 spec.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/spec.md b/spec.md
index 531a8f21b68..6d20f397d73 100644
--- a/spec.md
+++ b/spec.md
@@ -43,3 +43,67 @@ Hyde::asset() // Gets a relative web link to the given image stored in the _site
 ```php
 asset() // Calls Hyde::asset 
 ```
+
+## AI Context
+
+Please provide feedback on how we can improve the Asset API.
+
+For context: This is for static site generator HydePHP, based on Laravel.
+
+Motto: "Simplicity first. Power when you need it. Quality always."
+Tagline: Create static websites with the tools you already know and love with HydePHP.
+
+The Hyde Philosophy:
+> Developing Hyde sites, and contributing to the framework should be a joy. Great Developer Experience (DX) is our top priority.
+> Code should make sense and be intuitive, especially user-facing APIs. Convention over configuration, but not at the expense of flexibility.
+> Making sites should not be boring and repetitive - Hyde is all about taking focus away from boilerplate, and letting users focus on the content.
+
+Considerations: While HydePHP targets developers, not all users necessarily are familiar with Laravel, or PHP. So while we want to provide a familiar interface for Laravel/PHP users, we also want to make sure that the API is intuitive and easy to use for all users.
+
+For additional context on the naming conventions, here is the entire Hyde facade methods:
+
+ * @method static string path(string $path = '')
+ * @method static string vendorPath(string $path = '', string $package = 'framework')
+ * @method static string pathToAbsolute(string $path)
+ * @method static string pathToRelative(string $path)
+ * @method static string sitePath(string $path = '')
+ * @method static string mediaPath(string $path = '')
+ * @method static string siteMediaPath(string $path = '')
+ * @method static string formatLink(string $destination)
+ * @method static string relativeLink(string $destination)
+ * @method static string mediaLink(string $destination, bool $validate = false)
+ * @method static string asset(string $name, bool $preferQualifiedUrl = false)
+ * @method static string url(string $path = '')
+ * @method static Route|null route(string $key)
+ * @method static string makeTitle(string $value)
+ * @method static string normalizeNewlines(string $string)
+ * @method static string stripNewlines(string $string)
+ * @method static string trimSlashes(string $string)
+ * @method static HtmlString markdown(string $text, bool $stripIndentation = false)
+ * @method static string currentPage()
+ * @method static string currentRouteKey()
+ * @method static string getBasePath()
+ * @method static string getSourceRoot()
+ * @method static string getOutputDirectory()
+ * @method static string getMediaDirectory()
+ * @method static string getMediaOutputDirectory()
+ * @method static Features features()
+ * @method static Collection<string, PostAuthor> authors()
+ * @method static FileCollection files()
+ * @method static PageCollection pages()
+ * @method static RouteCollection routes()
+ * @method static Route|null currentRoute()
+ * @method static HydeKernel getInstance()
+ * @method static Filesystem filesystem()
+ * @method static array getRegisteredExtensions()
+ * @method static bool hasFeature(Feature $feature)
+ * @method static bool hasSiteUrl()
+ * @method static void setInstance(HydeKernel $instance)
+ * @method static void setBasePath(string $basePath)
+ * @method static void setOutputDirectory(string $outputDirectory)
+ * @method static void setMediaDirectory(string $mediaDirectory)
+ * @method static void setSourceRoot(string $sourceRoot)
+ * @method static void shareViewData(HydePage $page)
+ * @method static array toArray()
+ * @method static bool isBooted()
+ * @method static void boot()

From 91e06e2cadd4d3d6776ba60319518243c5e37abb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:27:23 +0200
Subject: [PATCH 2797/4023] Update AI context

---
 spec.md | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 77 insertions(+), 1 deletion(-)

diff --git a/spec.md b/spec.md
index 6d20f397d73..05db70ad84d 100644
--- a/spec.md
+++ b/spec.md
@@ -46,7 +46,7 @@ asset() // Calls Hyde::asset
 
 ## AI Context
 
-Please provide feedback on how we can improve the Asset API.
+Please provide feedback on how we for HydePHP v2 can improve the Asset API, designed to make it easy to interact with Asset files stored in the `_media` directory.
 
 For context: This is for static site generator HydePHP, based on Laravel.
 
@@ -62,6 +62,7 @@ Considerations: While HydePHP targets developers, not all users necessarily are
 
 For additional context on the naming conventions, here is the entire Hyde facade methods:
 
+```php
  * @method static string path(string $path = '')
  * @method static string vendorPath(string $path = '', string $package = 'framework')
  * @method static string pathToAbsolute(string $path)
@@ -107,3 +108,78 @@ For additional context on the naming conventions, here is the entire Hyde facade
  * @method static array toArray()
  * @method static bool isBooted()
  * @method static void boot()
+```
+
+We also have a MediaFile class that looks like this:
+
+```php
+
+/**
+ * File abstraction for a project media file.
+ */
+class MediaFile extends ProjectFile
+{
+    /** @var array<string> The default extensions for media types */
+    final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
+
+    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
+    public static function all(): array
+    {
+        return static::discoverMediaAssetFiles();
+    }
+
+    /** @return array<string> Array of filenames relative to the _media/ directory */
+    public static function files(): array
+    {
+        return array_keys(static::all());
+    }
+
+    public function getIdentifier(): string
+    {
+        return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');
+    }
+
+    public function toArray(): array
+    {
+        return array_merge(parent::toArray(), [
+            'length' => $this->getContentLength(),
+            'mimeType' => $this->getMimeType(),
+        ]);
+    }
+
+    public function getContentLength(): int
+    {
+        if (! is_file($this->getAbsolutePath())) {
+            throw new FileNotFoundException($this->path);
+        }
+
+        return filesize($this->getAbsolutePath());
+    }
+
+    public function getMimeType(): string
+    {
+        return mime_content_type($this->getAbsolutePath());
+    }
+
+    protected static function discoverMediaAssetFiles(): array
+    {
+        return collect(static::getMediaAssetFiles())->mapWithKeys(function (string $path): array {
+            $file = static::make($path);
+
+            return [$file->getIdentifier() => $file];
+        })->all();
+    }
+
+    protected static function getMediaAssetFiles(): array
+    {
+        return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
+    }
+
+    protected static function getMediaGlobPattern(): string
+    {
+        return sprintf(Hyde::getMediaDirectory().'/{*,**/*,**/*/*}.{%s}', implode(',',
+            Config::getArray('hyde.media_extensions', self::EXTENSIONS)
+        ));
+    }
+}
+```

From 946b23974805f2c346fb0703e2a13cbee60f5881 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:28:13 +0200
Subject: [PATCH 2798/4023] Formatting

---
 spec.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/spec.md b/spec.md
index 05db70ad84d..b36609db605 100644
--- a/spec.md
+++ b/spec.md
@@ -113,7 +113,6 @@ For additional context on the naming conventions, here is the entire Hyde facade
 We also have a MediaFile class that looks like this:
 
 ```php
-
 /**
  * File abstraction for a project media file.
  */

From 7dfff263dc44e4eb3545cafd12b9b29877390f50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:29:57 +0200
Subject: [PATCH 2799/4023] Fluent Asset API proposal

---
 spec.md | 135 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 135 insertions(+)

diff --git a/spec.md b/spec.md
index b36609db605..efa9c8ba471 100644
--- a/spec.md
+++ b/spec.md
@@ -182,3 +182,138 @@ class MediaFile extends ProjectFile
     }
 }
 ```
+
+## Proposals
+
+### Fluent Asset API
+
+Author: Claude 3.5 Sonnet
+
+Based on the provided information and the goals of HydePHP, here are some suggestions to improve the Asset API for version 2:
+
+1. Consolidate and simplify the API:
+   The current API is spread across multiple facades (Asset, Hyde) and helper functions. To improve clarity and ease of use, consider consolidating these into a single, intuitive API.
+
+
+
+```php
+class Asset
+{
+    // Get the absolute path to a media file
+    public static function path(string $file = ''): string
+    {
+        // Implementation
+    }
+
+    // Get a relative web link to a media file
+    public static function link(string $file, bool $validate = false): string
+    {
+        // Implementation
+    }
+
+    // Get a CDN link for a file
+    public static function cdnLink(string $file): string
+    {
+        // Implementation
+    }
+
+    // Check if a media file exists
+    public static function exists(string $file): bool
+    {
+        // Implementation
+    }
+
+    // Get all media files
+    public static function all(): array
+    {
+        // Implementation using MediaFile::all()
+    }
+
+    // Get a MediaFile instance
+    public static function file(string $file): MediaFile
+    {
+        // Implementation
+    }
+}
+
+```
+
+This consolidated API provides a cleaner, more intuitive interface for working with assets. It combines functionality from the current Asset and Hyde facades, making it easier for developers to find and use the methods they need.
+
+2. Improve method naming:
+   Some current method names like `cdnLink` and `mediaLink` might be confusing. Consider using more descriptive names that clearly indicate their purpose.
+
+3. Consistent return types:
+   Ensure that all methods have consistent return types. For example, always return strings for paths and links, and use type hinting to make the API more predictable.
+
+4. Fluent interface:
+   Consider implementing a fluent interface for chaining operations on assets. This can make the API more flexible and expressive.
+
+
+
+```php
+class AssetFile
+{
+    protected $file;
+
+    public function __construct(string $file)
+    {
+        $this->file = $file;
+    }
+
+    public function path(): string
+    {
+        // Implementation
+    }
+
+    public function link(bool $validate = false): string
+    {
+        // Implementation
+    }
+
+    public function cdnLink(): string
+    {
+        // Implementation
+    }
+
+    public function exists(): bool
+    {
+        // Implementation
+    }
+
+    public function content(): string
+    {
+        // Implementation
+    }
+}
+
+class Asset
+{
+    public static function file(string $file): AssetFile
+    {
+        return new AssetFile($file);
+    }
+
+    // Other static methods...
+}
+
+// Usage example
+$assetUrl = Asset::file('image.jpg')->cdnLink();
+$assetContent = Asset::file('styles.css')->content();
+
+```
+
+5. Better integration with MediaFile:
+   Leverage the existing MediaFile class more prominently in the API. This can provide a richer set of operations on individual files.
+
+6. Consistent error handling:
+   Implement a consistent approach to error handling. Consider using custom exceptions that provide clear, actionable error messages.
+
+7. Caching:
+   Implement intelligent caching for asset operations to improve performance, especially for repeated operations.
+
+8. Configuration:
+   Provide a clear way to configure asset-related settings, such as CDN URLs or custom media directories, through a dedicated configuration file or section.
+
+These improvements aim to create a more intuitive, powerful, and flexible Asset API that aligns with HydePHP's philosophy and goals. The consolidated and fluent interfaces should make it easier for both Laravel-familiar and new users to work with assets effectively.
+

From 0e8e7e3fd9d14de8904bdc23c0515a9e62ae673d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:35:37 +0200
Subject: [PATCH 2800/4023] Add link

---
 spec.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/spec.md b/spec.md
index efa9c8ba471..953bc3a4cd3 100644
--- a/spec.md
+++ b/spec.md
@@ -188,6 +188,7 @@ class MediaFile extends ProjectFile
 ### Fluent Asset API
 
 Author: Claude 3.5 Sonnet
+Link: https://claude.ai/chat/3b4529e1-79f5-48b9-ac8f-d35fa705a377
 
 Based on the provided information and the goals of HydePHP, here are some suggestions to improve the Asset API for version 2:
 

From 99462466208d08cf3f5c8cef6df787b5eec6524e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:38:22 +0200
Subject: [PATCH 2801/4023] Update line

---
 spec.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec.md b/spec.md
index 953bc3a4cd3..42effd5dd97 100644
--- a/spec.md
+++ b/spec.md
@@ -110,7 +110,7 @@ For additional context on the naming conventions, here is the entire Hyde facade
  * @method static void boot()
 ```
 
-We also have a MediaFile class that looks like this:
+We also have a MediaFile class that looks like this, maybe we can unify this as well:
 
 ```php
 /**

From a990c488ca7252e9ac71badbdd64b24d7dcf6cce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:41:18 +0200
Subject: [PATCH 2802/4023] Refined Fluent Asset API proposal

---
 spec.md | 199 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 199 insertions(+)

diff --git a/spec.md b/spec.md
index 42effd5dd97..f3a8d3592f6 100644
--- a/spec.md
+++ b/spec.md
@@ -318,3 +318,202 @@ $assetContent = Asset::file('styles.css')->content();
 
 These improvements aim to create a more intuitive, powerful, and flexible Asset API that aligns with HydePHP's philosophy and goals. The consolidated and fluent interfaces should make it easier for both Laravel-familiar and new users to work with assets effectively.
 
+### Fluent Asset API (Refined)
+
+Author: Claude 3.5 Sonnet
+Link: https://claude.ai/chat/3b4529e1-79f5-48b9-ac8f-d35fa705a377
+
+Thank you for providing those additional considerations and the detailed API reference. Let's refine the proposal based on this new information. We'll focus on merging with MediaFiles, adjusting for the limited CDN use case, and aligning with the existing Hyde page classes API structure.
+
+
+
+```php
+abstract class Asset
+{
+    protected string $identifier;
+    protected string $sourceDirectory = '_media';
+    protected string $outputDirectory = 'media';
+    protected string $fileExtension;
+
+    public function __construct(string $identifier)
+    {
+        $this->identifier = $identifier;
+        $this->fileExtension = pathinfo($identifier, PATHINFO_EXTENSION);
+    }
+
+    public static function make(string $identifier): static
+    {
+        return new static($identifier);
+    }
+
+    public static function isDiscoverable(): bool
+    {
+        return true;
+    }
+
+    public static function get(string $identifier): static
+    {
+        if (!static::exists($identifier)) {
+            throw new FileNotFoundException("Asset not found: {$identifier}");
+        }
+        return new static($identifier);
+    }
+
+    public static function parse(string $identifier): static
+    {
+        return static::get($identifier);
+    }
+
+    public static function files(): array
+    {
+        // Implementation to get all asset file identifiers
+    }
+
+    public static function all(): AssetCollection
+    {
+        // Implementation to get all assets as a collection
+    }
+
+    public static function sourceDirectory(): string
+    {
+        return (new static(''))->sourceDirectory;
+    }
+
+    public static function outputDirectory(): string
+    {
+        return (new static(''))->outputDirectory;
+    }
+
+    public static function setSourceDirectory(string $sourceDirectory): void
+    {
+        (new static(''))->sourceDirectory = $sourceDirectory;
+    }
+
+    public static function setOutputDirectory(string $outputDirectory): void
+    {
+        (new static(''))->outputDirectory = $outputDirectory;
+    }
+
+    public function sourcePath(): string
+    {
+        return Hyde::path($this->sourceDirectory . '/' . $this->identifier);
+    }
+
+    public function outputPath(): string
+    {
+        return Hyde::sitePath($this->outputDirectory . '/' . $this->identifier);
+    }
+
+    public static function exists(string $identifier): bool
+    {
+        return file_exists((new static($identifier))->sourcePath());
+    }
+
+    public function getIdentifier(): string
+    {
+        return $this->identifier;
+    }
+
+    public function getLink(): string
+    {
+        return '/' . $this->outputDirectory . '/' . $this->identifier;
+    }
+
+    public function getContents(): string
+    {
+        return file_get_contents($this->sourcePath());
+    }
+
+    public function getMimeType(): string
+    {
+        return mime_content_type($this->sourcePath());
+    }
+
+    public function getSize(): int
+    {
+        return filesize($this->sourcePath());
+    }
+
+    public function copy(): bool
+    {
+        return copy($this->sourcePath(), $this->outputPath());
+    }
+
+    // HydeFront specific method
+    public static function cdnLink(string $file): string
+    {
+        // Implementation for HydeFront CDN links
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'identifier' => $this->getIdentifier(),
+            'sourcePath' => $this->sourcePath(),
+            'outputPath' => $this->outputPath(),
+            'link' => $this->getLink(),
+            'mimeType' => $this->getMimeType(),
+            'size' => $this->getSize(),
+        ];
+    }
+}
+
+class AssetCollection extends Collection
+{
+    // Implement any asset-specific collection methods here
+}
+
+```
+
+This refined Asset API proposal addresses the considerations you mentioned:
+
+1. Merging with MediaFiles:
+   The new `Asset` class incorporates functionality from both the current Asset facade and the MediaFile class. It provides methods for working with individual assets as well as collections of assets.
+
+2. CDN links:
+   The `cdnLink` method is retained but as a static method, reflecting its specific use for HydeFront files. This keeps the functionality available without overemphasizing its importance for general asset handling.
+
+3. Alignment with Hyde page classes:
+   The API structure closely follows the pattern established by the Hyde page classes. It includes similar static methods for file discovery and management, as well as instance methods for working with individual assets.
+
+Key improvements and features:
+
+1. Consistent API:
+   The new API provides a consistent interface for working with assets, following patterns familiar to users of other Hyde classes.
+
+2. Flexible file handling:
+   Methods like `sourcePath()`, `outputPath()`, `getLink()`, and `copy()` provide flexible ways to work with asset files throughout the build process.
+
+3. Asset information:
+   Methods like `getMimeType()`, `getSize()`, and `getContents()` provide easy access to important asset information.
+
+4. Collection support:
+   The `AssetCollection` class allows for easy management and manipulation of multiple assets.
+
+5. Extensibility:
+   As an abstract class, `Asset` can be extended for specific asset types if needed in the future.
+
+Usage examples:
+
+```php
+// Get all assets
+$assets = Asset::all();
+
+// Get a specific asset
+$logo = Asset::get('images/logo.png');
+
+// Get the web-accessible link to an asset
+$logoUrl = $logo->getLink();
+
+// Copy an asset to the output directory
+$logo->copy();
+
+// Get asset information
+$size = $logo->getSize();
+$mimeType = $logo->getMimeType();
+
+// HydeFront CDN link (for app.js or app.css)
+$appJsUrl = Asset::cdnLink('app.js');
+```
+
+This API maintains the simplicity-first approach of Hyde while providing power when needed. It should be intuitive for both Laravel-familiar developers and those new to the framework, aligning well with Hyde's philosophy and goals.

From 2296be6bdc4d1c4b326fce0fe2c3fba5ac8f0fdb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:42:45 +0200
Subject: [PATCH 2803/4023] Unified Asset API proposal

---
 spec.md | 261 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 261 insertions(+)

diff --git a/spec.md b/spec.md
index f3a8d3592f6..9636e744d17 100644
--- a/spec.md
+++ b/spec.md
@@ -517,3 +517,264 @@ $appJsUrl = Asset::cdnLink('app.js');
 ```
 
 This API maintains the simplicity-first approach of Hyde while providing power when needed. It should be intuitive for both Laravel-familiar developers and those new to the framework, aligning well with Hyde's philosophy and goals.
+
+### Unified Asset API
+
+Author: Claude 3.5 Sonnet
+Link: https://claude.ai/chat/9c1c98cc-db92-41cc-9a8e-1f51fd9a04d5
+
+Certainly, I'd be happy to help you improve the Asset API for HydePHP v2. Based on your requirements and the HydePHP philosophy, I've come up with a proposal for a new, more unified Asset API. Here's the proposed new API and implementation plan:
+
+```php
+<?php
+
+namespace Hyde\Framework\Facades;
+
+use Hyde\Framework\Contracts\AssetContract;
+use Hyde\Framework\Services\AssetService;
+
+/**
+ * @method static string get(string $path, bool $absolute = false)
+ * @method static string url(string $path)
+ * @method static bool exists(string $path)
+ * @method static int size(string $path)
+ * @method static string mime(string $path)
+ * @method static string|null hash(string $path)
+ * @method static AssetContract instance(string $path)
+ */
+class Asset extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return AssetService::class;
+    }
+}
+
+// AssetService.php
+class AssetService implements AssetContract
+{
+    protected $validateExistence;
+
+    public function __construct(bool $validateExistence = false)
+    {
+        $this->validateExistence = $validateExistence;
+    }
+
+    public function get(string $path, bool $absolute = false): string
+    {
+        if ($this->validateExistence && !$this->exists($path)) {
+            throw new AssetNotFoundException("Asset not found: {$path}");
+        }
+
+        return $absolute ? $this->getAbsolutePath($path) : $this->getRelativePath($path);
+    }
+
+    public function url(string $path): string
+    {
+        if (filter_var($path, FILTER_VALIDATE_URL)) {
+            return $path;
+        }
+
+        return Hyde::url($this->get($path));
+    }
+
+    public function exists(string $path): bool
+    {
+        return file_exists($this->getAbsolutePath($path));
+    }
+
+    public function size(string $path): int
+    {
+        return filesize($this->getAbsolutePath($path));
+    }
+
+    public function mime(string $path): string
+    {
+        return mime_content_type($this->getAbsolutePath($path));
+    }
+
+    public function hash(string $path): ?string
+    {
+        $file = $this->getAbsolutePath($path);
+        return file_exists($file) ? md5_file($file) : null;
+    }
+
+    public function instance(string $path): AssetContract
+    {
+        return new Asset($path);
+    }
+
+    protected function getAbsolutePath(string $path): string
+    {
+        return Hyde::mediaPath($path);
+    }
+
+    protected function getRelativePath(string $path): string
+    {
+        return Hyde::mediaLink($path);
+    }
+}
+
+// Asset.php (implements AssetContract)
+class Asset implements AssetContract
+{
+    protected $path;
+
+    public function __construct(string $path)
+    {
+        $this->path = $path;
+    }
+
+    public function get(bool $absolute = false): string
+    {
+        return app(AssetService::class)->get($this->path, $absolute);
+    }
+
+    public function url(): string
+    {
+        return app(AssetService::class)->url($this->path);
+    }
+
+    public function exists(): bool
+    {
+        return app(AssetService::class)->exists($this->path);
+    }
+
+    public function size(): int
+    {
+        return app(AssetService::class)->size($this->path);
+    }
+
+    public function mime(): string
+    {
+        return app(AssetService::class)->mime($this->path);
+    }
+
+    public function hash(): ?string
+    {
+        return app(AssetService::class)->hash($this->path);
+    }
+}
+
+// Helper function
+function asset(string $path, bool $absolute = false): string
+{
+    return Asset::get($path, $absolute);
+}
+
+```
+
+This new API proposal aims to simplify and unify the asset-related functions while maintaining flexibility and adhering to the HydePHP philosophy. Here's a breakdown of the changes and the implementation plan:
+
+1. Unified API:
+   - All asset-related functions are now under the `Asset` facade.
+   - The `get()` method replaces both `mediaLink()` and `asset()`, with an optional parameter for absolute paths.
+   - Added `url()` method to handle both local and remote URLs.
+   - Included utility methods like `exists()`, `size()`, `mime()`, and `hash()` for common operations.
+
+2. Validation:
+   - Instead of a parameter to validate, we've added a constructor parameter in the `AssetService` that can be set via configuration or environment variable.
+
+3. Flexibility:
+   - The `instance()` method allows for object-oriented usage when needed.
+
+Implementation Plan:
+
+1. Deprecation process in v1:
+   - Add deprecation notices to the existing methods in the `Asset` and `Hyde` facades.
+   - Introduce the new `Asset` facade with the proposed methods, marking them as `@since 1.x`.
+   - Update the documentation to recommend using the new `Asset` facade.
+
+2. Implementation in v2:
+   - Remove the deprecated methods from the `Asset` and `Hyde` facades.
+   - Fully implement the new `AssetService` and `Asset` classes.
+   - Update all internal usage to use the new API.
+
+3. Configuration:
+   - Add a new configuration option in `config/hyde.php`:
+     ```php
+     'assets' => [
+         'validate_existence' => env('HYDE_VALIDATE_ASSETS', false),
+     ],
+     ```
+
+4. Release Notes:
+   ```markdown
+   # HydePHP v2.0 Release Notes
+
+   ## Asset API Overhaul
+
+   We've completely revamped the Asset API to provide a more intuitive and unified interface for handling media files. Key changes include:
+
+   - New `Asset` facade with streamlined methods
+   - Simplified asset retrieval with `Asset::get()`
+   - Built-in URL handling with `Asset::url()`
+   - Additional utility methods: `exists()`, `size()`, `mime()`, `hash()`
+   - Object-oriented usage available through `Asset::instance()`
+   - Global `asset()` helper function updated
+
+   These changes aim to improve developer experience and make asset handling more straightforward and consistent.
+   ```
+
+5. Upgrade Guide:
+   ```markdown
+   # Upgrading to HydePHP v2.0
+
+   ## Asset API Changes
+
+   1. Replace all usage of `Hyde::mediaLink()`, `Hyde::asset()`, and `Asset::mediaLink()` with `Asset::get()`:
+
+      ```php
+      // Old
+      $path = Hyde::mediaLink('image.jpg');
+      $path = Hyde::asset('image.jpg');
+      $path = Asset::mediaLink('image.jpg');
+
+      // New
+      $path = Asset::get('image.jpg');
+      ```
+
+   2. For absolute paths, use the second parameter of `Asset::get()`:
+
+      ```php
+      $absolutePath = Asset::get('image.jpg', true);
+      ```
+
+   3. Use `Asset::url()` for handling both local and remote URLs:
+
+      ```php
+      $url = Asset::url('image.jpg');
+      $url = Asset::url('https://example.com/image.jpg');
+      ```
+
+   4. Take advantage of new utility methods:
+
+      ```php
+      if (Asset::exists('image.jpg')) {
+          $size = Asset::size('image.jpg');
+          $mime = Asset::mime('image.jpg');
+          $hash = Asset::hash('image.jpg');
+      }
+      ```
+
+   5. For object-oriented usage, use `Asset::instance()`:
+
+      ```php
+      $asset = Asset::instance('image.jpg');
+      $path = $asset->get();
+      $exists = $asset->exists();
+      ```
+
+   6. Update your configuration file to include the new asset validation option:
+
+      ```php
+      // config/hyde.php
+      'assets' => [
+          'validate_existence' => env('HYDE_VALIDATE_ASSETS', false),
+      ],
+      ```
+
+   These changes will ensure your project is compatible with HydePHP v2.0 and takes full advantage of the new Asset API.
+   ```
+
+This proposal aims to simplify the Asset API while maintaining flexibility and power. It adheres to the HydePHP philosophy by providing an intuitive interface that should be easy to use for both Laravel developers and those less familiar with the framework. The implementation plan ensures a smooth transition from v1 to v2, with clear deprecation notices and comprehensive upgrade instructions.

From 3bde4836b7e6000d0758af2603849a2d50945c60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:43:28 +0200
Subject: [PATCH 2804/4023] Fix formatting

---
 spec.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/spec.md b/spec.md
index 9636e744d17..e2f85013582 100644
--- a/spec.md
+++ b/spec.md
@@ -775,6 +775,5 @@ Implementation Plan:
       ```
 
    These changes will ensure your project is compatible with HydePHP v2.0 and takes full advantage of the new Asset API.
-   ```
 
 This proposal aims to simplify the Asset API while maintaining flexibility and power. It adheres to the HydePHP philosophy by providing an intuitive interface that should be easy to use for both Laravel developers and those less familiar with the framework. The implementation plan ensures a smooth transition from v1 to v2, with clear deprecation notices and comprehensive upgrade instructions.

From bc78d745a977bd2884033c6f2bfafba9f807f983 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:47:01 +0200
Subject: [PATCH 2805/4023] Add Proposal Summary and Analysis

---
 spec.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/spec.md b/spec.md
index e2f85013582..76ae89c8a98 100644
--- a/spec.md
+++ b/spec.md
@@ -777,3 +777,56 @@ Implementation Plan:
    These changes will ensure your project is compatible with HydePHP v2.0 and takes full advantage of the new Asset API.
 
 This proposal aims to simplify the Asset API while maintaining flexibility and power. It adheres to the HydePHP philosophy by providing an intuitive interface that should be easy to use for both Laravel developers and those less familiar with the framework. The implementation plan ensures a smooth transition from v1 to v2, with clear deprecation notices and comprehensive upgrade instructions.
+
+### Proposal Summary and Analysis
+
+Independent Claude 3.5 Sonnet executive summary of the three proposals for improving the Asset API in HydePHP v2:
+
+1. Fluent Asset API
+
+This proposal introduces a consolidated `Asset` class with both static and instance methods, integrating functionality from the current Asset and Hyde facades. It offers a fluent interface for chaining operations on assets.
+
+Benefits:
+- Simplified, intuitive API
+- Fluent interface for expressive chaining
+- Consistent with Laravel patterns
+
+Drawbacks:
+- Significant departure from current API, potentially high upgrade friction
+- Increased complexity with new classes (AssetFile, AssetCollection)
+
+2. Fluent Asset API (Refined)
+
+This refined proposal merges functionality from the Asset facade and MediaFile class into an abstract `Asset` class. It aligns more closely with existing Hyde page classes and retains some current naming conventions.
+
+Benefits:
+- Better alignment with existing Hyde patterns
+- Comprehensive asset handling (discovery, manipulation, information)
+- Extensibility through abstract class
+
+Drawbacks:
+- Still represents a major change from current API
+- Potential learning curve for users unfamiliar with Hyde patterns
+
+3. Unified Asset API
+
+This proposal focuses on unifying asset-related functions under a single `Asset` facade, with a backing `AssetService`. It aims for a balance between simplification and maintaining familiarity.
+
+Benefits:
+- Maintains facade pattern, reducing upgrade friction
+- Simplifies API while retaining familiar method names
+- Includes a clear deprecation and upgrade path
+
+Drawbacks:
+- Less dramatic improvement in DX compared to fluent proposals
+- Retains some potential for confusion with multiple ways to access assets
+
+#### Final Recommendation:
+
+Based on the analysis, the Unified Asset API (Proposal 3) appears to be the most balanced approach. It offers significant improvements in developer experience and API consistency while minimizing upgrade friction and implementation complexity. The clear deprecation process and upgrade path will ease the transition for existing users.
+
+This proposal aligns well with HydePHP's philosophy of "Simplicity first. Power when you need it." It provides a more intuitive API without a complete overhaul, allowing for gradual adoption of new features. The retained facade pattern and familiar method names will help maintain accessibility for developers of varying experience levels.
+
+While the fluent API proposals offer more dramatic improvements in expressiveness, the associated increase in complexity and potential for confusion may outweigh these benefits. The Unified Asset API strikes a good balance between enhancing DX and maintaining continuity with the current system.
+
+Recommendation: Proceed with implementing the Unified Asset API (Proposal 3), ensuring thorough documentation and clear upgrade guides to support users through the transition.

From 9788f7362661f30ef272efdbbdcc05073aa89366 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 21:55:24 +0200
Subject: [PATCH 2806/4023] Add obscure but relevant method

---
 spec.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/spec.md b/spec.md
index 76ae89c8a98..12e1b45ea3e 100644
--- a/spec.md
+++ b/spec.md
@@ -28,6 +28,7 @@ Asset::hasMediaFile(string $file) // Returns file_exists(Hyde::mediaPath($file))
 Hyde::mediaPath() // Get the absolute path to the media source directory, or a file within it. (Intended as a sibling to Hyde::path and Hyde::sitePath helpers, and the HydePage::path methods)
 Hyde::mediaLink() // Gets a relative web link to the given file stored in the _site/media folder. (Intended as a sibling to Hyde::relativeLink, which is called by this) (A second $validate parameter will return throw an exception if the file does not exist)
 Hyde::asset() // Gets a relative web link to the given image stored in the _site/media folder. (But leaves remote URLs alone) (A second $preferQualifiedUrl parameter will return a fully qualified URL if a site URL is set)
+Hyde::siteMediaPath() //  Get the absolute path to the compiled site's media directory, or a file within it. (Intended as a sibling to Hyde::sitePath)
 
 /**
  * Real implementations of the facade methods:
@@ -35,6 +36,7 @@ Hyde::asset() // Gets a relative web link to the given image stored in the _site
  * @see \Hyde\Foundation\HydeKernel::mediaPath {@see \Hyde\Foundation\Kernel\Filesystem::mediaPath}
  * @see \Hyde\Foundation\HydeKernel::mediaLink {@see \Hyde\Foundation\Kernel\Hyperlinks::mediaLink}
  * @see \Hyde\Foundation\HydeKernel::asset {@see \Hyde\Foundation\Kernel\Hyperlinks::asset}
+ * @see \Hyde\Foundation\HydeKernel::siteMediaPath {@see \Hyde\Foundation\Kernel\Filesystem::siteMediaPath}
  */
 ```
 

From 9731c8448cc67768f849e815f7244575c3e0fdf9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 25 Jul 2024 22:02:18 +0200
Subject: [PATCH 2807/4023] Add background

---
 spec.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/spec.md b/spec.md
index 12e1b45ea3e..bd834a652e2 100644
--- a/spec.md
+++ b/spec.md
@@ -4,6 +4,58 @@
 
 In order to rework the Asset API, we need to analyze the current state of the API, to find what can be improved.
 
+### Background
+
+Remember the original problem: The current system is confusing and unintuitive with multiple and inconsistent ways to access assets.
+
+Additionally, keep in mind that most ways users will commonly use this API is to link to assets in the `_media` directory, and to check if they exist.
+
+For example: Consider these Blade snippets from the default views, showing common usages that actual end users may use:
+
+```blade
+{{-- The compiled Tailwind/App styles --}}
+@if(config('hyde.load_app_styles_from_cdn', false))
+    <link rel="stylesheet" href="{{ Asset::cdnLink('app.css') }}">
+@elseif(Asset::hasMediaFile('app.css'))
+    <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
+@endif
+
+{{-- The compiled Laravel Mix scripts --}}
+@if(Asset::hasMediaFile('app.js'))
+    <script defer src="{{ Asset::mediaLink('app.js') }}"></script>
+@endif
+
+@if (file_exists(Hyde::mediaPath('favicon.ico')))
+    <link rel="shortcut icon" href="{{ Hyde::relativeLink('media/favicon.ico') }}" type="image/x-icon">
+@endif
+```
+
+Some other example usages could be things like:
+
+```blade
+<img src="{{ asset('images/logo.png') }}" alt="Logo">
+```
+
+We also use the Asset API helpers in the internal codebase that actually powers the static site generator. These kinds of usages would usually only be used by us, package developers, and serious power users. They have an important, but secondary role in the API design. Here are some examples from our codebase:
+
+```php
+// Code that transfers media assets from the source directory to the site output directory
+$this->createDirectoryifItDoesNotExist(Hyde::siteMediaPath());
+$this->mapWithProgressBar(MediaFile::files(), function (string $identifier): void {
+   copy(Hyde::mediaPath($identifier), Hyde::siteMediaPath($identifier));
+});
+
+// Helpers in the featured image class
+public function getSource(): string {
+    return Hyde::mediaLink($this->source);
+}
+
+protected function setSource(string $source): string {
+   // Normalize away any leading media path prefixes.
+   return Str::after($source, Hyde::getMediaDirectory().'/');
+}
+```
+
 ## Current State
 
 ### Asset Facade

From 0a0a4bdcabb1781c39410517c3e55105feb54e7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 09:57:04 +0200
Subject: [PATCH 2808/4023] Add example AI prompt

---
 spec.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/spec.md b/spec.md
index bd834a652e2..6d43377d19e 100644
--- a/spec.md
+++ b/spec.md
@@ -237,6 +237,15 @@ class MediaFile extends ProjectFile
 }
 ```
 
+### AI Example Prompt
+
+```markdown
+Task: Split out the HydeFront related parts of the AssetService to a new facade class.
+Motivation: We are simplifying the Asset API in https://github.com/hydephp/develop/pull/1904, and most users won't need the HydeFront related parts of the AssetService. Later, we will be able to merge the simplified AssetService into the other Asset helpers.
+Implementation: Make the necessary changes to the code and tests. Also update the release notes to detail all breaking changes and the upgrade path. Make sure the release notes contains all necessary information, but is not too verbose and should not contain any fluff. Also write a brief pull request description.
+Context: This is for v2 of static site generator HydePHP.
+```
+
 ## Proposals
 
 ### Fluent Asset API

From cca95dbc113645c819bff8c1753c8d931bb34715 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 09:59:07 +0200
Subject: [PATCH 2809/4023] Update context

---
 spec.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec.md b/spec.md
index 6d43377d19e..dd02d41f5c7 100644
--- a/spec.md
+++ b/spec.md
@@ -243,7 +243,7 @@ class MediaFile extends ProjectFile
 Task: Split out the HydeFront related parts of the AssetService to a new facade class.
 Motivation: We are simplifying the Asset API in https://github.com/hydephp/develop/pull/1904, and most users won't need the HydeFront related parts of the AssetService. Later, we will be able to merge the simplified AssetService into the other Asset helpers.
 Implementation: Make the necessary changes to the code and tests. Also update the release notes to detail all breaking changes and the upgrade path. Make sure the release notes contains all necessary information, but is not too verbose and should not contain any fluff. Also write a brief pull request description.
-Context: This is for v2 of static site generator HydePHP.
+Context: This is for v2 of static site generator HydePHP. Remember to match the code style of the existing codebase.
 ```
 
 ## Proposals

From 2f930e9be6fe1c3b5e77dae725c1e152109a4b1d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 10:20:38 +0200
Subject: [PATCH 2810/4023] Update context

---
 spec.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec.md b/spec.md
index dd02d41f5c7..b404251e8ea 100644
--- a/spec.md
+++ b/spec.md
@@ -242,7 +242,7 @@ class MediaFile extends ProjectFile
 ```markdown
 Task: Split out the HydeFront related parts of the AssetService to a new facade class.
 Motivation: We are simplifying the Asset API in https://github.com/hydephp/develop/pull/1904, and most users won't need the HydeFront related parts of the AssetService. Later, we will be able to merge the simplified AssetService into the other Asset helpers.
-Implementation: Make the necessary changes to the code and tests. Also update the release notes to detail all breaking changes and the upgrade path. Make sure the release notes contains all necessary information, but is not too verbose and should not contain any fluff. Also write a brief pull request description.
+Implementation: Make the necessary changes to the code and tests. Also update the release notes to detail all breaking changes and the upgrade path. Make sure the release notes contains all necessary information, but is not too verbose and should not contain any fluff. Also write a brief pull request description detailing the changes made and why they were made.
 Context: This is for v2 of static site generator HydePHP. Remember to match the code style of the existing codebase.
 ```
 

From 67ae2114d1a3a48b94fd16e94b62003e2b1acfae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 10:43:52 +0200
Subject: [PATCH 2811/4023] Remove the HydeFront version and CDN URL
 configuration options

I can't see a good reason to want to change the version to load assets that are unlikely to work with the versions in the views in the project Hyde version. Changing the CDN URL could be useful if you want to change the host to another CDN provider, but this current system is way too convoluted for that.
---
 config/hyde.php                               |  5 ---
 docs/digging-deeper/customization.md          | 14 -------
 packages/framework/config/hyde.php            |  5 ---
 .../src/Framework/Services/AssetService.php   |  4 +-
 .../tests/Unit/AssetServiceUnitTest.php       | 39 -------------------
 5 files changed, 2 insertions(+), 65 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 67c1da3b43b..87f5481d00e 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -470,11 +470,6 @@
     // Where should the build manifest be saved? (Relative to project root, for example _site/build-manifest.json)
     'build_manifest_path' => 'app/storage/framework/cache/build-manifest.json',
 
-    // Here you can specify HydeFront version and URL for when loading app.css from the CDN.
-    // Only change these if you know what you're doing as some versions may be incompatible with your Hyde version.
-    'hydefront_version' => \Hyde\Framework\Services\AssetService::HYDEFRONT_VERSION,
-    'hydefront_cdn_url' => \Hyde\Framework\Services\AssetService::HYDEFRONT_CDN_URL,
-
     // Should the theme toggle buttons be displayed in the layouts?
     'theme_toggle_buttons' => true,
 
diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index f9c7a0f5682..95965376d78 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -342,20 +342,6 @@ Specifies the path where the build manifest should be saved, relative to the pro
 'build_manifest_path' => 'app/storage/framework/cache/build-manifest.json',
 ```
 
-### `hydefront_version` and `hydefront_cdn_url`
-
-These options allow you to specify the HydeFront version and CDN URL when loading `app.css` from the CDN.
-
-Only change these if you know what you're doing as some versions may be incompatible with your Hyde version.
-
-```php
-// filepath config/hyde.php
-use \Hyde\Framework\Services\AssetService;
-
-'hydefront_version' => AssetService::HYDEFRONT_VERSION,
-'hydefront_cdn_url' => AssetService::HYDEFRONT_CDN_URL,
-```
-
 ### `theme_toggle_buttons`
 
 >info This feature was added in HydePHP v1.7.0
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 67c1da3b43b..87f5481d00e 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -470,11 +470,6 @@
     // Where should the build manifest be saved? (Relative to project root, for example _site/build-manifest.json)
     'build_manifest_path' => 'app/storage/framework/cache/build-manifest.json',
 
-    // Here you can specify HydeFront version and URL for when loading app.css from the CDN.
-    // Only change these if you know what you're doing as some versions may be incompatible with your Hyde version.
-    'hydefront_version' => \Hyde\Framework\Services\AssetService::HYDEFRONT_VERSION,
-    'hydefront_cdn_url' => \Hyde\Framework\Services\AssetService::HYDEFRONT_CDN_URL,
-
     // Should the theme toggle buttons be displayed in the layouts?
     'theme_toggle_buttons' => true,
 
diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index 9373b676e10..d1f9bd54179 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -41,8 +41,8 @@ class AssetService
 
     public function __construct()
     {
-        $this->version = Config::getString('hyde.hydefront_version', self::HYDEFRONT_VERSION);
-        $this->cdnUrl = Config::getString('hyde.hydefront_url', self::HYDEFRONT_CDN_URL);
+        $this->version = self::HYDEFRONT_VERSION;
+        $this->cdnUrl = self::HYDEFRONT_CDN_URL;
     }
 
     public function version(): string
diff --git a/packages/framework/tests/Unit/AssetServiceUnitTest.php b/packages/framework/tests/Unit/AssetServiceUnitTest.php
index 9267b4715a6..352d8144101 100644
--- a/packages/framework/tests/Unit/AssetServiceUnitTest.php
+++ b/packages/framework/tests/Unit/AssetServiceUnitTest.php
@@ -36,50 +36,11 @@ public function testVersionStringDefaultsToConstant()
         $this->assertSame(AssetService::HYDEFRONT_VERSION, (new AssetService())->version());
     }
 
-    public function testVersionCanBeSetInConfig()
-    {
-        self::mockConfig(['hyde.hydefront_version' => '1.0.0']);
-        $this->assertSame('1.0.0', (new AssetService())->version());
-    }
-
     public function testCdnPatternConstant()
     {
         $this->assertSame('https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}', AssetService::HYDEFRONT_CDN_URL);
     }
 
-    public function testCanSetCustomCdnUrlInConfig()
-    {
-        self::mockConfig(['hyde.hydefront_url' => 'https://example.com']);
-        $this->assertSame('https://example.com', (new AssetService())->cdnLink(''));
-    }
-
-    public function testCanUseCustomCdnUrlWithVersion()
-    {
-        self::mockConfig(['hyde.hydefront_url' => '{{ $version }}']);
-        $this->assertSame('v3.4', (new AssetService())->cdnLink(''));
-    }
-
-    public function testCanUseCustomCdnUrlWithFile()
-    {
-        self::mockConfig(['hyde.hydefront_url' => '{{ $file }}']);
-        $this->assertSame('styles.css', (new AssetService())->cdnLink('styles.css'));
-    }
-
-    public function testCanUseCustomCdnUrlWithVersionAndFile()
-    {
-        self::mockConfig(['hyde.hydefront_url' => '{{ $version }}/{{ $file }}']);
-        $this->assertSame('v3.4/styles.css', (new AssetService())->cdnLink('styles.css'));
-    }
-
-    public function testCanUseCustomCdnUrlWithCustomVersion()
-    {
-        self::mockConfig([
-            'hyde.hydefront_url' => '{{ $version }}',
-            'hyde.hydefront_version' => '1.0.0',
-        ]);
-        $this->assertSame('1.0.0', (new AssetService())->cdnLink(''));
-    }
-
     public function testCdnLinkHelper()
     {
         $this->assertSame(

From 73cc657fb1fa3a6f8aae84e561e2ffecd2c889a8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 10:51:25 +0200
Subject: [PATCH 2812/4023] Draft Asset API change section

---
 RELEASE_NOTES.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 86740ca0d9c..780688dfe65 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -239,6 +239,12 @@ The following methods in the `Features` class have been renamed to follow a more
 
 Note that this class was previously marked as internal in v1, but the change is logged here in case it was used in configuration files or custom code.
 
+### Asset API Changes
+
+The overall asset API has been improved and cleaned up. Unfortunately, this means that there are some breaking changes to the API.
+
+
+
 ## Low impact
 
 ### Navigation internal changes

From d7c1a225b427dff2d59abfc06c710018ff743635 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 10:54:25 +0200
Subject: [PATCH 2813/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 86740ca0d9c..3852a7188b6 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -59,6 +59,7 @@ This serves two purposes:
 - Moved the sidebar documentation to the documentation pages section for better organization.
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
+- The HydeFront asset version and CDN URL are now hardcoded in the `AssetService` class instead of being configurable in https://github.com/hydephp/develop/pull/1909
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -66,6 +67,7 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
+- Breaking: Removed the `hydefront_version` and `hydefront_cdn_url` configuration options from the `hyde.php` config file in https://github.com/hydephp/develop/pull/1909
 - Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
@@ -239,6 +241,31 @@ The following methods in the `Features` class have been renamed to follow a more
 
 Note that this class was previously marked as internal in v1, but the change is logged here in case it was used in configuration files or custom code.
 
+### Asset API Changes
+
+The overall asset API has been improved and cleaned up. Unfortunately, this means that there are some breaking changes to the API.
+
+#### Removal of HydeFront version and CDN URL configuration options
+
+The `hydefront_version` and `hydefront_cdn_url` configuration options have been removed from the `config/hyde.php` file. These options were previously used to specify the HydeFront version and CDN URL for loading assets.
+
+**Impact:** Low. This change will only affect users who have customized these options.
+
+**Upgrade steps:**
+
+<!-- TODO: Deprecate the constants in v1 -->
+
+1. Remove the following lines from your `config/hyde.php` file if they exist:
+   ```php
+   'hydefront_version' => \Hyde\Framework\Services\AssetService::HYDEFRONT_VERSION,
+   'hydefront_cdn_url' => \Hyde\Framework\Services\AssetService::HYDEFRONT_CDN_URL,
+   ```
+2. If you were using a custom CDN URL, you will need to implement your own solution for serving HydeFront assets from a different CDN. Consider copying the assets to your preferred CDN and updating your templates accordingly.
+
+**Rationale:** The ability to change the HydeFront version was removed because using a different version than the one bundled with your Hyde project could lead to compatibility issues. The CDN URL configuration was removed to simplify the asset loading process.
+
+If you need to use a different CDN for serving HydeFront assets, you should implement a custom solution tailored to your specific needs. You may also open a feature request if you believe this functionality should be added back in a future release.
+
 ## Low impact
 
 ### Navigation internal changes

From 1393a9c8a15afb8efd213b3e175d458b9b328aec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 11:40:48 +0200
Subject: [PATCH 2814/4023] Remove useless constructor

---
 packages/framework/src/Framework/Services/AssetService.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index d1f9bd54179..718a8dd6f81 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -39,12 +39,6 @@ class AssetService
     protected string $version = self::HYDEFRONT_VERSION;
     protected string $cdnUrl = self::HYDEFRONT_CDN_URL;
 
-    public function __construct()
-    {
-        $this->version = self::HYDEFRONT_VERSION;
-        $this->cdnUrl = self::HYDEFRONT_CDN_URL;
-    }
-
     public function version(): string
     {
         return $this->version;

From 6e16df9aac7c3230bfcd54bbdc5ac3f4abfcc755 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 11:45:12 +0200
Subject: [PATCH 2815/4023] Breaking: Make the AssetService constants protected

---
 .../src/Framework/Services/AssetService.php       |  4 ++--
 .../framework/tests/Unit/AssetServiceUnitTest.php | 15 ---------------
 2 files changed, 2 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index 718a8dd6f81..c306f623a09 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -31,10 +31,10 @@
 class AssetService
 {
     /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
-    final public const HYDEFRONT_VERSION = 'v3.4';
+    final protected const HYDEFRONT_VERSION = 'v3.4';
 
     /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
-    final public const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
+    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
 
     protected string $version = self::HYDEFRONT_VERSION;
     protected string $cdnUrl = self::HYDEFRONT_CDN_URL;
diff --git a/packages/framework/tests/Unit/AssetServiceUnitTest.php b/packages/framework/tests/Unit/AssetServiceUnitTest.php
index 352d8144101..02c33795d15 100644
--- a/packages/framework/tests/Unit/AssetServiceUnitTest.php
+++ b/packages/framework/tests/Unit/AssetServiceUnitTest.php
@@ -21,26 +21,11 @@ protected function setUp(): void
         self::mockConfig();
     }
 
-    public function testVersionStringConstant()
-    {
-        $this->assertSame('v3.4', AssetService::HYDEFRONT_VERSION);
-    }
-
     public function testServiceHasVersionString()
     {
         $this->assertIsString((new AssetService())->version());
     }
 
-    public function testVersionStringDefaultsToConstant()
-    {
-        $this->assertSame(AssetService::HYDEFRONT_VERSION, (new AssetService())->version());
-    }
-
-    public function testCdnPatternConstant()
-    {
-        $this->assertSame('https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}', AssetService::HYDEFRONT_CDN_URL);
-    }
-
     public function testCdnLinkHelper()
     {
         $this->assertSame(

From 95a7955f82064df13d0d3ed5be14d5415f9833f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:32:37 +0200
Subject: [PATCH 2816/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3852a7188b6..57e542a72f0 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -33,6 +33,7 @@ This serves two purposes:
 - **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
 - **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
 - **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
+- **Breaking:** The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class have been changed from `public` to `protected`. This improves encapsulation but may affect code that directly accessed these constants. For more information, see below.
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
@@ -73,6 +74,7 @@ This serves two purposes:
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 - Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
+- The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class have been removed from the public API in https://github.com/hydephp/develop/pull/1910
 
 ### Fixed
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
@@ -266,6 +268,33 @@ The `hydefront_version` and `hydefront_cdn_url` configuration options have been
 
 If you need to use a different CDN for serving HydeFront assets, you should implement a custom solution tailored to your specific needs. You may also open a feature request if you believe this functionality should be added back in a future release.
 
+#### AssetService constants visibility changes
+
+The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class are now `protected` instead of `public`. This change improves encapsulation and reduces the public API surface.
+
+**Impact:** Low. This change will only affect users who directly accessed these constants in their custom code.
+
+**Upgrade steps:**
+
+1. If you were directly accessing `AssetService::HYDEFRONT_VERSION` or `AssetService::HYDEFRONT_CDN_URL` in your code, you will need to update your implementation.
+2. Instead of using these constants directly, use the public methods provided by the `AssetService` class to interact with asset-related functionality.
+
+For example, if you were using:
+
+```php
+$version = AssetService::HYDEFRONT_VERSION;
+```
+
+You should now use:
+
+```php
+$version = (new AssetService())->version();
+```
+
+If you need access to the CDN URL pattern, consider using the `cdnLink()` method of the `AssetService` class instead.
+
+These changes were implemented to improve the API design and encapsulation of the `AssetService` class. If you have any custom implementations that relied on these constants, please review and update your code accordingly.
+
 ## Low impact
 
 ### Navigation internal changes

From 97c7b5a05aef19bf9e34f44931cd72532bfee2fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:36:04 +0200
Subject: [PATCH 2817/4023] Reset release note changes that may get out of date

---
 RELEASE_NOTES.md | 56 ------------------------------------------------
 1 file changed, 56 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 57e542a72f0..86740ca0d9c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -33,7 +33,6 @@ This serves two purposes:
 - **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
 - **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
 - **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
-- **Breaking:** The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class have been changed from `public` to `protected`. This improves encapsulation but may affect code that directly accessed these constants. For more information, see below.
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
@@ -60,7 +59,6 @@ This serves two purposes:
 - Moved the sidebar documentation to the documentation pages section for better organization.
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
-- The HydeFront asset version and CDN URL are now hardcoded in the `AssetService` class instead of being configurable in https://github.com/hydephp/develop/pull/1909
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -68,13 +66,11 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
-- Breaking: Removed the `hydefront_version` and `hydefront_cdn_url` configuration options from the `hyde.php` config file in https://github.com/hydephp/develop/pull/1909
 - Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 - Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
-- The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class have been removed from the public API in https://github.com/hydephp/develop/pull/1910
 
 ### Fixed
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
@@ -243,58 +239,6 @@ The following methods in the `Features` class have been renamed to follow a more
 
 Note that this class was previously marked as internal in v1, but the change is logged here in case it was used in configuration files or custom code.
 
-### Asset API Changes
-
-The overall asset API has been improved and cleaned up. Unfortunately, this means that there are some breaking changes to the API.
-
-#### Removal of HydeFront version and CDN URL configuration options
-
-The `hydefront_version` and `hydefront_cdn_url` configuration options have been removed from the `config/hyde.php` file. These options were previously used to specify the HydeFront version and CDN URL for loading assets.
-
-**Impact:** Low. This change will only affect users who have customized these options.
-
-**Upgrade steps:**
-
-<!-- TODO: Deprecate the constants in v1 -->
-
-1. Remove the following lines from your `config/hyde.php` file if they exist:
-   ```php
-   'hydefront_version' => \Hyde\Framework\Services\AssetService::HYDEFRONT_VERSION,
-   'hydefront_cdn_url' => \Hyde\Framework\Services\AssetService::HYDEFRONT_CDN_URL,
-   ```
-2. If you were using a custom CDN URL, you will need to implement your own solution for serving HydeFront assets from a different CDN. Consider copying the assets to your preferred CDN and updating your templates accordingly.
-
-**Rationale:** The ability to change the HydeFront version was removed because using a different version than the one bundled with your Hyde project could lead to compatibility issues. The CDN URL configuration was removed to simplify the asset loading process.
-
-If you need to use a different CDN for serving HydeFront assets, you should implement a custom solution tailored to your specific needs. You may also open a feature request if you believe this functionality should be added back in a future release.
-
-#### AssetService constants visibility changes
-
-The `HYDEFRONT_VERSION` and `HYDEFRONT_CDN_URL` constants in the `AssetService` class are now `protected` instead of `public`. This change improves encapsulation and reduces the public API surface.
-
-**Impact:** Low. This change will only affect users who directly accessed these constants in their custom code.
-
-**Upgrade steps:**
-
-1. If you were directly accessing `AssetService::HYDEFRONT_VERSION` or `AssetService::HYDEFRONT_CDN_URL` in your code, you will need to update your implementation.
-2. Instead of using these constants directly, use the public methods provided by the `AssetService` class to interact with asset-related functionality.
-
-For example, if you were using:
-
-```php
-$version = AssetService::HYDEFRONT_VERSION;
-```
-
-You should now use:
-
-```php
-$version = (new AssetService())->version();
-```
-
-If you need access to the CDN URL pattern, consider using the `cdnLink()` method of the `AssetService` class instead.
-
-These changes were implemented to improve the API design and encapsulation of the `AssetService` class. If you have any custom implementations that relied on these constants, please review and update your code accordingly.
-
 ## Low impact
 
 ### Navigation internal changes

From 4959e3b8356f594068e8daf41a8b605635d07b54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:38:22 +0200
Subject: [PATCH 2818/4023] Deprecate the AssetService class

---
 packages/framework/src/Framework/Services/AssetService.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index c306f623a09..82804bb6920 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -21,6 +21,8 @@
 /**
  * Handles the retrieval of core asset files. Commonly used through the Asset facade.
  *
+ * @deprecated Will be merged into the Asset facade.
+ *
  * This class is loaded into the service container, making it easy to access and modify.
  *
  * The class also provides helper methods for interacting with versioned files,

From 7e2b51acc5ca2bc164d07a7ec41aa59b37d207e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:46:06 +0200
Subject: [PATCH 2819/4023] Remove mixin for deprecated AssetService

---
 _ide_helper.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/_ide_helper.php b/_ide_helper.php
index 228893b3169..a838afac059 100644
--- a/_ide_helper.php
+++ b/_ide_helper.php
@@ -33,7 +33,6 @@
 class Hyde extends \Hyde\Hyde {}
 class Site extends \Hyde\Facades\Site {}
 class Meta extends \Hyde\Facades\Meta {}
-/** @mixin \Hyde\Framework\Services\AssetService */
 class Asset extends \Hyde\Facades\Asset {}
 class Author extends \Hyde\Facades\Author {}
 class Features extends \Hyde\Facades\Features {}

From 19c7d17b930a9aac8ae849e2b922ca5e2c81ac2c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:50:54 +0200
Subject: [PATCH 2820/4023] Remove kernel binding test for deprecated
 AssetService

---
 .../framework/tests/Feature/HydeServiceProviderTest.php   | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 6904c5b11d6..ee7d35ae140 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -9,7 +9,6 @@
 use Illuminate\Contracts\Container\BindingResolutionException;
 use Hyde\Console\ConsoleServiceProvider;
 use Hyde\Framework\HydeServiceProvider;
-use Hyde\Framework\Services\AssetService;
 use Hyde\Framework\Services\BuildTaskService;
 use Hyde\Foundation\HydeCoreExtension;
 use Hyde\Hyde;
@@ -54,13 +53,6 @@ public function testProviderHasBootMethod()
         $this->assertTrue(method_exists($this->provider, 'boot'));
     }
 
-    public function testProviderRegistersAssetServiceAsSingleton()
-    {
-        $this->assertTrue($this->app->bound(AssetService::class));
-        $this->assertInstanceOf(AssetService::class, $this->app->make(AssetService::class));
-        $this->assertSame($this->app->make(AssetService::class), $this->app->make(AssetService::class));
-    }
-
     public function testProviderRegistersBuildTaskServiceAsSingleton()
     {
         $this->assertTrue($this->app->bound(BuildTaskService::class));

From 293234076c1c20558799f19bb82afbd6afaaa7f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:51:42 +0200
Subject: [PATCH 2821/4023] Extend unit test case

---
 packages/framework/tests/Unit/Facades/AssetFacadeTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
index df8344a3771..5bc4f02d01a 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
@@ -6,12 +6,12 @@
 
 use Hyde\Facades\Asset;
 use Hyde\Framework\Services\AssetService;
-use Hyde\Testing\TestCase;
+use Hyde\Testing\UnitTestCase;
 
 /**
  * @covers \Hyde\Facades\Asset
  */
-class AssetFacadeTest extends TestCase
+class AssetFacadeTest extends UnitTestCase
 {
     public function testAssetFacadeReturnsTheAssetService()
     {

From 730f17783fabd039c9d1c658d52d381498be2e3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:52:04 +0200
Subject: [PATCH 2822/4023] Remove legacy facade implementation tests

---
 .../tests/Unit/Facades/AssetFacadeTest.php      | 17 +----------------
 1 file changed, 1 insertion(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
index 5bc4f02d01a..8335c4c7159 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Unit\Facades;
 
 use Hyde\Facades\Asset;
-use Hyde\Framework\Services\AssetService;
 use Hyde\Testing\UnitTestCase;
 
 /**
@@ -13,19 +12,5 @@
  */
 class AssetFacadeTest extends UnitTestCase
 {
-    public function testAssetFacadeReturnsTheAssetService()
-    {
-        $this->assertInstanceOf(AssetService::class, Asset::getFacadeRoot());
-    }
-
-    public function testFacadeReturnsSameInstanceAsBoundByTheContainer()
-    {
-        $this->assertSame(Asset::getFacadeRoot(), app(AssetService::class));
-    }
-
-    public function testAssetFacadeCanCallMethodsOnTheAssetService()
-    {
-        $service = new AssetService();
-        $this->assertEquals($service->version(), Asset::version());
-    }
+    //
 }

From 3e4d02377139f8bdaeb51e79ae43ba26bfc92f8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:52:59 +0200
Subject: [PATCH 2823/4023] Move unit tests to new code location

---
 .../tests/Unit/AssetServiceUnitTest.php       | 50 +------------------
 .../tests/Unit/Facades/AssetFacadeTest.php    | 50 ++++++++++++++++++-
 2 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/packages/framework/tests/Unit/AssetServiceUnitTest.php b/packages/framework/tests/Unit/AssetServiceUnitTest.php
index 02c33795d15..21f80004078 100644
--- a/packages/framework/tests/Unit/AssetServiceUnitTest.php
+++ b/packages/framework/tests/Unit/AssetServiceUnitTest.php
@@ -4,9 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Framework\Services\AssetService;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Hyde;
 
 /**
  * @covers \Hyde\Framework\Services\AssetService
@@ -15,51 +13,5 @@
  */
 class AssetServiceUnitTest extends UnitTestCase
 {
-    protected function setUp(): void
-    {
-        self::needsKernel();
-        self::mockConfig();
-    }
-
-    public function testServiceHasVersionString()
-    {
-        $this->assertIsString((new AssetService())->version());
-    }
-
-    public function testCdnLinkHelper()
-    {
-        $this->assertSame(
-            'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css',
-            (new AssetService())->cdnLink('styles.css')
-        );
-    }
-
-    public function testHasMediaFileHelper()
-    {
-        $this->assertFalse((new AssetService())->hasMediaFile('styles.css'));
-    }
-
-    public function testHasMediaFileHelperReturnsTrueForExistingFile()
-    {
-        $this->assertTrue((new AssetService())->hasMediaFile('app.css'));
-    }
-
-    public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
-    {
-        $service = new AssetService();
-        $this->assertIsString($config = $service->injectTailwindConfig());
-        $this->assertStringContainsString("darkMode: 'class'", $config);
-        $this->assertStringContainsString('theme: {', $config);
-        $this->assertStringContainsString('extend: {', $config);
-        $this->assertStringContainsString('typography: {', $config);
-        $this->assertStringNotContainsString('plugins', $config);
-    }
-
-    public function testInjectTailwindConfigHandlesMissingConfigFileGracefully()
-    {
-        rename(Hyde::path('tailwind.config.js'), Hyde::path('tailwind.config.js.bak'));
-        $this->assertIsString((new AssetService())->injectTailwindConfig());
-        $this->assertSame('', (new AssetService())->injectTailwindConfig());
-        rename(Hyde::path('tailwind.config.js.bak'), Hyde::path('tailwind.config.js'));
-    }
+    //
 }
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
index 8335c4c7159..7d65f59d626 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
@@ -4,13 +4,61 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Hyde;
 use Hyde\Facades\Asset;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Services\AssetService;
 
 /**
  * @covers \Hyde\Facades\Asset
  */
 class AssetFacadeTest extends UnitTestCase
 {
-    //
+    protected function setUp(): void
+    {
+        self::needsKernel();
+        self::mockConfig();
+    }
+
+    public function testServiceHasVersionString()
+    {
+        $this->assertIsString((new AssetService())->version());
+    }
+
+    public function testCdnLinkHelper()
+    {
+        $this->assertSame(
+            'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css',
+            (new AssetService())->cdnLink('styles.css')
+        );
+    }
+
+    public function testHasMediaFileHelper()
+    {
+        $this->assertFalse((new AssetService())->hasMediaFile('styles.css'));
+    }
+
+    public function testHasMediaFileHelperReturnsTrueForExistingFile()
+    {
+        $this->assertTrue((new AssetService())->hasMediaFile('app.css'));
+    }
+
+    public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
+    {
+        $service = new AssetService();
+        $this->assertIsString($config = $service->injectTailwindConfig());
+        $this->assertStringContainsString("darkMode: 'class'", $config);
+        $this->assertStringContainsString('theme: {', $config);
+        $this->assertStringContainsString('extend: {', $config);
+        $this->assertStringContainsString('typography: {', $config);
+        $this->assertStringNotContainsString('plugins', $config);
+    }
+
+    public function testInjectTailwindConfigHandlesMissingConfigFileGracefully()
+    {
+        rename(Hyde::path('tailwind.config.js'), Hyde::path('tailwind.config.js.bak'));
+        $this->assertIsString((new AssetService())->injectTailwindConfig());
+        $this->assertSame('', (new AssetService())->injectTailwindConfig());
+        rename(Hyde::path('tailwind.config.js.bak'), Hyde::path('tailwind.config.js'));
+    }
 }

From e8d9939ad2724f6234a4031268eb04aca0dd1f86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:56:26 +0200
Subject: [PATCH 2824/4023] Add temporary test interoperability

---
 packages/framework/tests/Unit/Facades/AssetFacadeTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
index 7d65f59d626..a2dae835e85 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
@@ -18,6 +18,9 @@ protected function setUp(): void
     {
         self::needsKernel();
         self::mockConfig();
+
+        // Temporary interoperability with the old AssetService
+        Asset::swap(new AssetService());
     }
 
     public function testServiceHasVersionString()

From 422e96612c16947a11da0c15330659e0ffd8ff8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:57:16 +0200
Subject: [PATCH 2825/4023] Call tests using the facade

---
 .../framework/tests/Unit/Facades/AssetFacadeTest.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
index a2dae835e85..a2e5ec2bf28 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
@@ -25,25 +25,25 @@ protected function setUp(): void
 
     public function testServiceHasVersionString()
     {
-        $this->assertIsString((new AssetService())->version());
+        $this->assertIsString(Asset::version());
     }
 
     public function testCdnLinkHelper()
     {
         $this->assertSame(
             'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css',
-            (new AssetService())->cdnLink('styles.css')
+            Asset::cdnLink('styles.css')
         );
     }
 
     public function testHasMediaFileHelper()
     {
-        $this->assertFalse((new AssetService())->hasMediaFile('styles.css'));
+        $this->assertFalse(Asset::hasMediaFile('styles.css'));
     }
 
     public function testHasMediaFileHelperReturnsTrueForExistingFile()
     {
-        $this->assertTrue((new AssetService())->hasMediaFile('app.css'));
+        $this->assertTrue(Asset::hasMediaFile('app.css'));
     }
 
     public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
@@ -60,8 +60,8 @@ public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
     public function testInjectTailwindConfigHandlesMissingConfigFileGracefully()
     {
         rename(Hyde::path('tailwind.config.js'), Hyde::path('tailwind.config.js.bak'));
-        $this->assertIsString((new AssetService())->injectTailwindConfig());
-        $this->assertSame('', (new AssetService())->injectTailwindConfig());
+        $this->assertIsString(Asset::injectTailwindConfig());
+        $this->assertSame('', Asset::injectTailwindConfig());
         rename(Hyde::path('tailwind.config.js.bak'), Hyde::path('tailwind.config.js'));
     }
 }

From db2e12ecb18421ebf6cb0c8d843b866fae80d316 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:57:18 +0200
Subject: [PATCH 2826/4023] Delete AssetServiceUnitTest.php

---
 .../tests/Unit/AssetServiceUnitTest.php         | 17 -----------------
 1 file changed, 17 deletions(-)
 delete mode 100644 packages/framework/tests/Unit/AssetServiceUnitTest.php

diff --git a/packages/framework/tests/Unit/AssetServiceUnitTest.php b/packages/framework/tests/Unit/AssetServiceUnitTest.php
deleted file mode 100644
index 21f80004078..00000000000
--- a/packages/framework/tests/Unit/AssetServiceUnitTest.php
+++ /dev/null
@@ -1,17 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Testing\UnitTestCase;
-
-/**
- * @covers \Hyde\Framework\Services\AssetService
- *
- * @see \Hyde\Framework\Testing\Feature\AssetServiceTest
- */
-class AssetServiceUnitTest extends UnitTestCase
-{
-    //
-}

From 3e53c3ba847a975fa92cf47fd568337fea853030 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:57:30 +0200
Subject: [PATCH 2827/4023] Rename test 'AssetFacadeTest' to
 'AssetFacadeUnitTest'

---
 .../Facades/{AssetFacadeTest.php => AssetFacadeUnitTest.php}    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Unit/Facades/{AssetFacadeTest.php => AssetFacadeUnitTest.php} (97%)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
similarity index 97%
rename from packages/framework/tests/Unit/Facades/AssetFacadeTest.php
rename to packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index a2e5ec2bf28..724981cfea6 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -12,7 +12,7 @@
 /**
  * @covers \Hyde\Facades\Asset
  */
-class AssetFacadeTest extends UnitTestCase
+class AssetFacadeUnitTest extends UnitTestCase
 {
     protected function setUp(): void
     {

From 9d393ab21f5b2311dea166a889c80cfcebe10044 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:58:17 +0200
Subject: [PATCH 2828/4023] Rename test 'AssetServiceTest' to 'AssetFacadeTest'

---
 .../tests/Feature/{AssetServiceTest.php => AssetFacadeTest.php} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Feature/{AssetServiceTest.php => AssetFacadeTest.php} (97%)

diff --git a/packages/framework/tests/Feature/AssetServiceTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
similarity index 97%
rename from packages/framework/tests/Feature/AssetServiceTest.php
rename to packages/framework/tests/Feature/AssetFacadeTest.php
index ae8661b8118..2b1bcfa2be2 100644
--- a/packages/framework/tests/Feature/AssetServiceTest.php
+++ b/packages/framework/tests/Feature/AssetFacadeTest.php
@@ -13,7 +13,7 @@
  *
  * @see \Hyde\Framework\Testing\Unit\AssetServiceUnitTest
  */
-class AssetServiceTest extends TestCase
+class AssetFacadeTest extends TestCase
 {
     public function testMediaLinkReturnsMediaPathWithCacheKey()
     {

From 171c4ac22dff39182285ea2d4c191b41e215bbb7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:58:30 +0200
Subject: [PATCH 2829/4023] Update covers annotation

---
 packages/framework/tests/Feature/AssetFacadeTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetFacadeTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
index 2b1bcfa2be2..eb61d40829a 100644
--- a/packages/framework/tests/Feature/AssetFacadeTest.php
+++ b/packages/framework/tests/Feature/AssetFacadeTest.php
@@ -9,7 +9,7 @@
 use Hyde\Testing\TestCase;
 
 /**
- * @covers \Hyde\Framework\Services\AssetService
+ * @covers \Hyde\Facades\Asset
  *
  * @see \Hyde\Framework\Testing\Unit\AssetServiceUnitTest
  */

From 5d5f14d53cf82321cff5b18eb8b2438c6ecfb9b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:58:59 +0200
Subject: [PATCH 2830/4023] Update test crosslinks

---
 packages/framework/tests/Feature/AssetFacadeTest.php          | 2 +-
 packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetFacadeTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
index eb61d40829a..20af8244fef 100644
--- a/packages/framework/tests/Feature/AssetFacadeTest.php
+++ b/packages/framework/tests/Feature/AssetFacadeTest.php
@@ -11,7 +11,7 @@
 /**
  * @covers \Hyde\Facades\Asset
  *
- * @see \Hyde\Framework\Testing\Unit\AssetServiceUnitTest
+ * @see \Hyde\Framework\Testing\Unit\Facades\AssetFacadeUnitTest
  */
 class AssetFacadeTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 724981cfea6..4d210b8e071 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -11,6 +11,8 @@
 
 /**
  * @covers \Hyde\Facades\Asset
+ *
+ * @see \Hyde\Framework\Testing\Feature\AssetFacadeTest
  */
 class AssetFacadeUnitTest extends UnitTestCase
 {

From 69b8f39353d0cce0fcdb6c84125c319c800a604a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 13:59:50 +0200
Subject: [PATCH 2831/4023] Call tests using the facade

---
 packages/framework/tests/Feature/AssetFacadeTest.php | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/AssetFacadeTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
index 20af8244fef..103230b296d 100644
--- a/packages/framework/tests/Feature/AssetFacadeTest.php
+++ b/packages/framework/tests/Feature/AssetFacadeTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Facades\Asset;
 use Hyde\Framework\Services\AssetService;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
@@ -17,9 +18,7 @@ class AssetFacadeTest extends TestCase
 {
     public function testMediaLinkReturnsMediaPathWithCacheKey()
     {
-        $service = new AssetService();
-
-        $this->assertIsString($path = $service->mediaLink('app.css'));
+        $this->assertIsString($path = Asset::mediaLink('app.css'));
         $this->assertSame('media/app.css?v='.md5_file(Hyde::path('_media/app.css')), $path);
     }
 
@@ -27,8 +26,7 @@ public function testMediaLinkReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisa
     {
         config(['hyde.enable_cache_busting' => false]);
 
-        $service = new AssetService();
-        $path = $service->mediaLink('app.css');
+        $path = Asset::mediaLink('app.css');
 
         $this->assertIsString($path);
         $this->assertSame('media/app.css', $path);
@@ -41,8 +39,7 @@ public function testMediaLinkSupportsCustomMediaDirectories()
 
         Hyde::setMediaDirectory('_assets');
 
-        $service = new AssetService();
-        $path = $service->mediaLink('app.css');
+        $path = Asset::mediaLink('app.css');
 
         $this->assertIsString($path);
         $this->assertSame('assets/app.css?v='.md5_file(Hyde::path('_assets/app.css')), $path);

From 5b48cef8bf7782b4bb4d4a5121dde41ed6163e95 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:03:12 +0200
Subject: [PATCH 2832/4023] Refactor class to be static

---
 .../src/Framework/Services/AssetService.php   | 28 +++++++++----------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index 82804bb6920..7391d1bcfdb 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -23,9 +23,7 @@
  *
  * @deprecated Will be merged into the Asset facade.
  *
- * This class is loaded into the service container, making it easy to access and modify.
- *
- * The class also provides helper methods for interacting with versioned files,
+ * This class provides static methods for interacting with versioned files,
  * as well as the HydeFront CDN service and the media directories.
  *
  * @see \Hyde\Facades\Asset
@@ -41,27 +39,27 @@ class AssetService
     protected string $version = self::HYDEFRONT_VERSION;
     protected string $cdnUrl = self::HYDEFRONT_CDN_URL;
 
-    public function version(): string
+    public static function version(): string
     {
-        return $this->version;
+        return static::HYDEFRONT_VERSION;
     }
 
-    public function cdnLink(string $file): string
+    public static function cdnLink(string $file): string
     {
-        return $this->constructCdnPath($file);
+        return static::constructCdnPath($file);
     }
 
-    public function mediaLink(string $file): string
+    public static function mediaLink(string $file): string
     {
-        return Hyde::mediaLink($file).$this->getCacheBustKey($file);
+        return Hyde::mediaLink($file).static::getCacheBustKey($file);
     }
 
-    public function hasMediaFile(string $file): bool
+    public static function hasMediaFile(string $file): bool
     {
         return file_exists(Hyde::mediaPath($file));
     }
 
-    public function injectTailwindConfig(): string
+    public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {
             return '';
@@ -79,15 +77,15 @@ public function injectTailwindConfig(): string
         return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
     }
 
-    protected function constructCdnPath(string $file): string
+    protected static function constructCdnPath(string $file): string
     {
         return str_replace(
-            ['{{ $version }}', '{{ $file }}'], [$this->version(), $file],
-            $this->cdnUrl
+            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
+            static::HYDEFRONT_CDN_URL
         );
     }
 
-    protected function getCacheBustKey(string $file): string
+    protected static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
             ? '?v='.md5_file(Hyde::mediaPath("$file"))

From e4886a729ba7518dcbc542eede7fafc578aabcb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:03:26 +0200
Subject: [PATCH 2833/4023] Remove now unused properties

---
 packages/framework/src/Framework/Services/AssetService.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index 7391d1bcfdb..6796f31a9d8 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -36,9 +36,6 @@ class AssetService
     /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
     final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
 
-    protected string $version = self::HYDEFRONT_VERSION;
-    protected string $cdnUrl = self::HYDEFRONT_CDN_URL;
-
     public static function version(): string
     {
         return static::HYDEFRONT_VERSION;

From 50600abebe5a3fcb4a92b830873f8b24f249b204 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:05:41 +0200
Subject: [PATCH 2834/4023] Call tests using the facade

---
 packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 4d210b8e071..b7545267e0f 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -50,8 +50,7 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
 
     public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
     {
-        $service = new AssetService();
-        $this->assertIsString($config = $service->injectTailwindConfig());
+        $this->assertIsString($config = Asset::injectTailwindConfig());
         $this->assertStringContainsString("darkMode: 'class'", $config);
         $this->assertStringContainsString('theme: {', $config);
         $this->assertStringContainsString('extend: {', $config);

From f801942c40ac6eb9651a84e0a52a23f7df523d42 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:05:53 +0200
Subject: [PATCH 2835/4023] Revert temporary test interoperability

---
 packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index b7545267e0f..c300236bc8d 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Facades\Asset;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Framework\Services\AssetService;
 
 /**
  * @covers \Hyde\Facades\Asset
@@ -20,9 +19,6 @@ protected function setUp(): void
     {
         self::needsKernel();
         self::mockConfig();
-
-        // Temporary interoperability with the old AssetService
-        Asset::swap(new AssetService());
     }
 
     public function testServiceHasVersionString()

From 1675dd09a17443a86219210a29eb492eb2973765 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:06:33 +0200
Subject: [PATCH 2836/4023] Merge the AssetService into the Asset facade class

---
 packages/framework/src/Facades/Asset.php      | 84 ++++++++++++++++---
 .../src/Framework/Services/AssetService.php   | 76 +----------------
 2 files changed, 72 insertions(+), 88 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index f0bd3b6c651..49065d3b352 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -4,25 +4,83 @@
 
 namespace Hyde\Facades;
 
-use Hyde\Framework\Services\AssetService;
-use Illuminate\Support\Facades\Facade;
+use Hyde\Hyde;
+use Illuminate\Support\Str;
+
+use function rtrim;
+use function explode;
+use function implode;
+use function md5_file;
+use function file_exists;
+use function str_replace;
+use function preg_replace;
+use function str_contains;
+use function file_get_contents;
 
 /**
  * Handles the retrieval of core asset files, either from the HydeFront CDN or from the local media folder.
  *
- * @see \Hyde\Framework\Services\AssetService
- *
- * @method static string version()
- * @method static string cdnLink(string $file)
- * @method static string mediaLink(string $file)
- * @method static bool hasMediaFile(string $file)
- * @method static string injectTailwindConfig()
+ * This class provides static methods for interacting with versioned files,
+ * as well as the HydeFront CDN service and the media directories.
  */
-class Asset extends Facade
+class Asset
 {
-    /** @psalm-return AssetService::class */
-    protected static function getFacadeAccessor(): string
+    /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
+    final protected const HYDEFRONT_VERSION = 'v3.4';
+
+    /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
+    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
+
+    public static function version(): string
+    {
+        return static::HYDEFRONT_VERSION;
+    }
+
+    public static function cdnLink(string $file): string
+    {
+        return static::constructCdnPath($file);
+    }
+
+    public static function mediaLink(string $file): string
+    {
+        return Hyde::mediaLink($file).static::getCacheBustKey($file);
+    }
+
+    public static function hasMediaFile(string $file): bool
+    {
+        return file_exists(Hyde::mediaPath($file));
+    }
+
+    public static function injectTailwindConfig(): string
+    {
+        if (! file_exists(Hyde::path('tailwind.config.js'))) {
+            return '';
+        }
+
+        $config = Str::between(file_get_contents(Hyde::path('tailwind.config.js')), '{', '}');
+
+        // Remove the plugins array, as it is not used in the frontend.
+        if (str_contains($config, 'plugins: [')) {
+            $tokens = explode('plugins: [', $config, 2);
+            $tokens[1] = Str::after($tokens[1], ']');
+            $config = implode('', $tokens);
+        }
+
+        return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
+    }
+
+    protected static function constructCdnPath(string $file): string
+    {
+        return str_replace(
+            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
+            static::HYDEFRONT_CDN_URL
+        );
+    }
+
+    protected static function getCacheBustKey(string $file): string
     {
-        return AssetService::class;
+        return Config::getBool('hyde.enable_cache_busting', true)
+            ? '?v='.md5_file(Hyde::mediaPath("$file"))
+            : '';
     }
 }
diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
index 6796f31a9d8..d6159d32535 100644
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ b/packages/framework/src/Framework/Services/AssetService.php
@@ -4,88 +4,14 @@
 
 namespace Hyde\Framework\Services;
 
-use Hyde\Hyde;
-use Hyde\Facades\Config;
-use Illuminate\Support\Str;
-
-use function rtrim;
-use function explode;
-use function implode;
-use function md5_file;
-use function file_exists;
-use function str_replace;
-use function preg_replace;
-use function str_contains;
-use function file_get_contents;
-
 /**
  * Handles the retrieval of core asset files. Commonly used through the Asset facade.
  *
  * @deprecated Will be merged into the Asset facade.
  *
- * This class provides static methods for interacting with versioned files,
- * as well as the HydeFront CDN service and the media directories.
- *
  * @see \Hyde\Facades\Asset
  */
 class AssetService
 {
-    /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
-    final protected const HYDEFRONT_VERSION = 'v3.4';
-
-    /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
-    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
-
-    public static function version(): string
-    {
-        return static::HYDEFRONT_VERSION;
-    }
-
-    public static function cdnLink(string $file): string
-    {
-        return static::constructCdnPath($file);
-    }
-
-    public static function mediaLink(string $file): string
-    {
-        return Hyde::mediaLink($file).static::getCacheBustKey($file);
-    }
-
-    public static function hasMediaFile(string $file): bool
-    {
-        return file_exists(Hyde::mediaPath($file));
-    }
-
-    public static function injectTailwindConfig(): string
-    {
-        if (! file_exists(Hyde::path('tailwind.config.js'))) {
-            return '';
-        }
-
-        $config = Str::between(file_get_contents(Hyde::path('tailwind.config.js')), '{', '}');
-
-        // Remove the plugins array, as it is not used in the frontend.
-        if (str_contains($config, 'plugins: [')) {
-            $tokens = explode('plugins: [', $config, 2);
-            $tokens[1] = Str::after($tokens[1], ']');
-            $config = implode('', $tokens);
-        }
-
-        return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
-    }
-
-    protected static function constructCdnPath(string $file): string
-    {
-        return str_replace(
-            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
-            static::HYDEFRONT_CDN_URL
-        );
-    }
-
-    protected static function getCacheBustKey(string $file): string
-    {
-        return Config::getBool('hyde.enable_cache_busting', true)
-            ? '?v='.md5_file(Hyde::mediaPath("$file"))
-            : '';
-    }
+    //
 }

From fb0e40c4c22eb82aac6f08411360d960a25161be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:06:46 +0200
Subject: [PATCH 2837/4023] Delete AssetService.php

---
 .../src/Framework/Services/AssetService.php     | 17 -----------------
 1 file changed, 17 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Services/AssetService.php

diff --git a/packages/framework/src/Framework/Services/AssetService.php b/packages/framework/src/Framework/Services/AssetService.php
deleted file mode 100644
index d6159d32535..00000000000
--- a/packages/framework/src/Framework/Services/AssetService.php
+++ /dev/null
@@ -1,17 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Services;
-
-/**
- * Handles the retrieval of core asset files. Commonly used through the Asset facade.
- *
- * @deprecated Will be merged into the Asset facade.
- *
- * @see \Hyde\Facades\Asset
- */
-class AssetService
-{
-    //
-}

From bf257a54be49685675c90b52864b52d361dc6661 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:08:04 +0200
Subject: [PATCH 2838/4023] Remove unused import

---
 packages/framework/tests/Feature/AssetFacadeTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetFacadeTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
index 103230b296d..3e934eab38b 100644
--- a/packages/framework/tests/Feature/AssetFacadeTest.php
+++ b/packages/framework/tests/Feature/AssetFacadeTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Facades\Asset;
-use Hyde\Framework\Services\AssetService;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 

From f0192f58f34404aa0d19406e0ab2707fa237e660 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:08:15 +0200
Subject: [PATCH 2839/4023] Remove AssetService container binding

---
 packages/framework/src/Framework/HydeServiceProvider.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/HydeServiceProvider.php b/packages/framework/src/Framework/HydeServiceProvider.php
index c2896efdc9b..e3dbd7eb5ea 100644
--- a/packages/framework/src/Framework/HydeServiceProvider.php
+++ b/packages/framework/src/Framework/HydeServiceProvider.php
@@ -10,7 +10,6 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\DocumentationPage;
-use Hyde\Framework\Services\AssetService;
 use Hyde\Framework\Services\BuildTaskService;
 use Hyde\Framework\Concerns\RegistersFileLocations;
 use Illuminate\Support\ServiceProvider;
@@ -29,7 +28,6 @@ public function register(): void
     {
         $this->kernel = HydeKernel::getInstance();
 
-        $this->app->singleton(AssetService::class, AssetService::class);
         $this->app->singleton(BuildTaskService::class, BuildTaskService::class);
 
         $this->kernel->setSourceRoot(Config::getString('hyde.source_root', ''));

From 83e69f8d43cec53483a341158306e67dfbf816b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:12:35 +0200
Subject: [PATCH 2840/4023] Update internal docs for removed asset service

---
 monorepo/docs/hydefront.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/monorepo/docs/hydefront.md b/monorepo/docs/hydefront.md
index 377f920e6e0..cb7733eabcd 100644
--- a/monorepo/docs/hydefront.md
+++ b/monorepo/docs/hydefront.md
@@ -64,6 +64,6 @@ This will create commits in both the monorepo and submodule. Now follow the foll
 9. Update the monorepo to use the new version.
     - [ ] `npm update hydefront`
     - **Note:** On major/minor version bumps, **remember to update** the `package.json` in the `packages/hyde` directory to use the new version!
-    - **Note:** On major version bumps, **remember to update the HydeFront version in the Asset Service!**
+    - **Note:** On major version bumps, **remember to update the HydeFront version in the Asset Facade!**
 10. Amend the monorepo commit with the updated files (package-lock.json, _media/app.css, packages\hydefront, packages\hyde\package.json)
-    - [ ] `git add packages/hydefront && git add packages/hyde/package.json && git add package-lock.json && git add _media/app.css && git add packages/framework/src/Framework/Services/AssetService.php && git commit --amend --no-edit`
+    - [ ] `git add packages/hydefront && git add packages/hyde/package.json && git add package-lock.json && git add _media/app.css && git add packages/framework/src/Facades/Asset.php && git commit --amend --no-edit`

From 251ed8bea4111d8effdffc137dcf9f46333ec3be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:13:41 +0200
Subject: [PATCH 2841/4023] Clean up test

---
 packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index c300236bc8d..ddfafe2ec72 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -46,7 +46,9 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
 
     public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
     {
-        $this->assertIsString($config = Asset::injectTailwindConfig());
+        $config = Asset::injectTailwindConfig();
+
+        $this->assertIsString($config);
         $this->assertStringContainsString("darkMode: 'class'", $config);
         $this->assertStringContainsString('theme: {', $config);
         $this->assertStringContainsString('extend: {', $config);

From 02dbc14b919b7c495d9d535d0e5f39248fdbbaff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:25:19 +0200
Subject: [PATCH 2842/4023] Create HydeFront.php

---
 packages/framework/src/Facades/HydeFront.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Facades/HydeFront.php

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
new file mode 100644
index 00000000000..5f5448313ee
--- /dev/null
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Facades;
+
+class HydeFront
+{
+    //
+}

From 718ac2a22749edbec9424005a934bc4e0b0d9277 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:26:32 +0200
Subject: [PATCH 2843/4023] Create HydeFrontFacadeTest.php

---
 .../tests/Unit/Facades/HydeFrontFacadeTest.php    | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php

diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
new file mode 100644
index 00000000000..e4c6d9e192f
--- /dev/null
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Facades;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Facades\HydeFront
+ */
+class HydeFrontFacadeTest extends UnitTestCase
+{
+    //
+}

From ecfafc85efeef288a82f104c722e795ca4e0b15d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:26:53 +0200
Subject: [PATCH 2844/4023] Alias the HydeFront facade

---
 app/config.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/config.php b/app/config.php
index 143a4a6dda4..009c0f586b7 100644
--- a/app/config.php
+++ b/app/config.php
@@ -94,6 +94,7 @@
         'Meta' => \Hyde\Facades\Meta::class,
         'Asset' => \Hyde\Facades\Asset::class,
         'Author' => \Hyde\Facades\Author::class,
+        'HydeFront' => \Hyde\Facades\HydeFront::class,
         'Features' => \Hyde\Facades\Features::class,
         'Config' => \Hyde\Facades\Config::class,
         'Filesystem' => \Hyde\Facades\Filesystem::class,

From ee69a0a9e0b44afa58d7fce5f326450673292157 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:48:20 +0200
Subject: [PATCH 2845/4023] Move HydeFront related methods to the new HydeFront
 facade

---
 packages/framework/src/Facades/Asset.php      | 53 ++++++++-----------
 packages/framework/src/Facades/HydeFront.php  | 27 +++++++++-
 .../Unit/Facades/AssetFacadeUnitTest.php      | 13 -----
 .../Unit/Facades/HydeFrontFacadeTest.php      | 12 ++++-
 4 files changed, 60 insertions(+), 45 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 49065d3b352..6d7a3afaeb3 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -6,15 +6,10 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
+use JetBrains\PhpStorm\Deprecated;
 
-use function rtrim;
-use function explode;
-use function implode;
 use function md5_file;
 use function file_exists;
-use function str_replace;
-use function preg_replace;
-use function str_contains;
 use function file_get_contents;
 
 /**
@@ -25,22 +20,6 @@
  */
 class Asset
 {
-    /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
-    final protected const HYDEFRONT_VERSION = 'v3.4';
-
-    /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
-    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
-
-    public static function version(): string
-    {
-        return static::HYDEFRONT_VERSION;
-    }
-
-    public static function cdnLink(string $file): string
-    {
-        return static::constructCdnPath($file);
-    }
-
     public static function mediaLink(string $file): string
     {
         return Hyde::mediaLink($file).static::getCacheBustKey($file);
@@ -69,18 +48,32 @@ public static function injectTailwindConfig(): string
         return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
     }
 
-    protected static function constructCdnPath(string $file): string
-    {
-        return str_replace(
-            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
-            static::HYDEFRONT_CDN_URL
-        );
-    }
-
     protected static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
             ? '?v='.md5_file(Hyde::mediaPath("$file"))
             : '';
     }
+
+    /**
+     * @deprecated Use HydeFront::version() instead.
+     *
+     * @codeCoverageIgnore Deprecated method.
+     */
+    #[Deprecated(reason: 'Use HydeFront::version() instead.', replacement: '\Hyde\Facades\HydeFront::version()')]
+    public static function version(): string
+    {
+        return HydeFront::version();
+    }
+
+    /**
+     * @deprecated Use HydeFront::cdnLink() instead.
+     *
+     * @codeCoverageIgnore Deprecated method.
+     */
+    #[Deprecated(reason: 'Use HydeFront::cdnLink() instead.', replacement: '\Hyde\Facades\HydeFront::cdnLink()')]
+    public static function cdnLink(string $file): string
+    {
+        return HydeFront::cdnLink($file);
+    }
 }
diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 5f5448313ee..e3b5c76f606 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -4,7 +4,32 @@
 
 namespace Hyde\Facades;
 
+use function str_replace;
+
 class HydeFront
 {
-    //
+    /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
+    final protected const HYDEFRONT_VERSION = 'v3.4';
+
+    /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
+    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
+
+    public static function version(): string
+    {
+        return static::HYDEFRONT_VERSION;
+    }
+
+    public static function cdnLink(string $file): string
+    {
+        return static::constructCdnPath($file);
+    }
+
+    protected static function constructCdnPath(string $file): string
+    {
+        return str_replace(
+            ['{{ $version }}', '{{ $file }}'],
+            [static::version(), $file],
+            static::HYDEFRONT_CDN_URL
+        );
+    }
 }
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index ddfafe2ec72..81cbfc029b4 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -21,19 +21,6 @@ protected function setUp(): void
         self::mockConfig();
     }
 
-    public function testServiceHasVersionString()
-    {
-        $this->assertIsString(Asset::version());
-    }
-
-    public function testCdnLinkHelper()
-    {
-        $this->assertSame(
-            'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css',
-            Asset::cdnLink('styles.css')
-        );
-    }
-
     public function testHasMediaFileHelper()
     {
         $this->assertFalse(Asset::hasMediaFile('styles.css'));
diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index e4c6d9e192f..37425127bf7 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Facades\HydeFront;
 use Hyde\Testing\UnitTestCase;
 
 /**
@@ -11,5 +12,14 @@
  */
 class HydeFrontFacadeTest extends UnitTestCase
 {
-    //
+    public function testVersionReturnsString()
+    {
+        $this->assertIsString(HydeFront::version());
+    }
+
+    public function testCdnLinkReturnsCorrectUrl()
+    {
+        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css';
+        $this->assertSame($expected, HydeFront::cdnLink('styles.css'));
+    }
 }

From 3db1b29adce5f88299de0fc990ce3b19ad3ecfd8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:54:25 +0200
Subject: [PATCH 2846/4023] Use the new HydeFront facade

---
 packages/framework/resources/views/layouts/styles.blade.php | 2 +-
 .../framework/tests/Unit/Views/StylesComponentViewTest.php  | 4 ++--
 spec.md                                                     | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/layouts/styles.blade.php b/packages/framework/resources/views/layouts/styles.blade.php
index 497e524ae1b..2a345a4ce18 100644
--- a/packages/framework/resources/views/layouts/styles.blade.php
+++ b/packages/framework/resources/views/layouts/styles.blade.php
@@ -3,7 +3,7 @@
 
 {{-- The compiled Tailwind/App styles --}}
 @if(config('hyde.load_app_styles_from_cdn', false))
-    <link rel="stylesheet" href="{{ Asset::cdnLink('app.css') }}">
+    <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
 @elseif(Asset::hasMediaFile('app.css'))
     <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
 @endif
diff --git a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
index bfe078d00f1..bb5358f9e08 100644
--- a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
@@ -5,7 +5,7 @@
 namespace Hyde\Framework\Testing\Unit\Views;
 
 use Hyde\Facades\Filesystem;
-use Hyde\Facades\Asset;
+use Hyde\Facades\HydeFront;
 use Hyde\Hyde;
 use Hyde\Support\Facades\Render;
 use Hyde\Testing\TestCase;
@@ -80,7 +80,7 @@ public function testComponentRendersTailwindPlayCdnLinkWhenEnabledInConfig()
     public function testComponentRendersAppCdnLinkWhenEnabledInConfig()
     {
         config(['hyde.load_app_styles_from_cdn' => true]);
-        $this->assertStringContainsString(Asset::cdnLink('app.css'), $this->renderTestView());
+        $this->assertStringContainsString(HydeFront::cdnLink('app.css'), $this->renderTestView());
     }
 
     public function testComponentDoesNotRenderLinkToLocalAppCssWhenCdnLinkIsEnabledInConfig()
diff --git a/spec.md b/spec.md
index b404251e8ea..a1ca493ac41 100644
--- a/spec.md
+++ b/spec.md
@@ -15,7 +15,7 @@ For example: Consider these Blade snippets from the default views, showing commo
 ```blade
 {{-- The compiled Tailwind/App styles --}}
 @if(config('hyde.load_app_styles_from_cdn', false))
-    <link rel="stylesheet" href="{{ Asset::cdnLink('app.css') }}">
+    <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
 @elseif(Asset::hasMediaFile('app.css'))
     <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
 @endif
@@ -61,7 +61,7 @@ protected function setSource(string $source): string {
 ### Asset Facade
 
 ```php
-Asset::cdnLink(string $file) // Gets remote URL to any file in /dist/ in the HydeFront version
+HydeFront::cdnLink(string $file) // Gets remote URL to any file in /dist/ in the HydeFront version
 Asset::mediaLink(string $file) // Returns Hyde::mediaLink but with a cache buster
 Asset::hasMediaFile(string $file) // Returns file_exists(Hyde::mediaPath($file))
 
@@ -576,7 +576,7 @@ $size = $logo->getSize();
 $mimeType = $logo->getMimeType();
 
 // HydeFront CDN link (for app.js or app.css)
-$appJsUrl = Asset::cdnLink('app.js');
+$appJsUrl = HydeFront::cdnLink('app.js');
 ```
 
 This API maintains the simplicity-first approach of Hyde while providing power when needed. It should be intuitive for both Laravel-familiar developers and those new to the framework, aligning well with Hyde's philosophy and goals.

From f5b752610ac5d9f8027afcaa13428669215b8110 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:52:35 +0200
Subject: [PATCH 2847/4023] Remove deprecated Asset facade methods

See https://github.com/hydephp/develop/pull/1904 for why we are skipping the normal deprecation process.
---
 packages/framework/src/Facades/Asset.php | 23 -----------------------
 1 file changed, 23 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 6d7a3afaeb3..2300dd6dc72 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Illuminate\Support\Str;
-use JetBrains\PhpStorm\Deprecated;
 
 use function md5_file;
 use function file_exists;
@@ -54,26 +53,4 @@ protected static function getCacheBustKey(string $file): string
             ? '?v='.md5_file(Hyde::mediaPath("$file"))
             : '';
     }
-
-    /**
-     * @deprecated Use HydeFront::version() instead.
-     *
-     * @codeCoverageIgnore Deprecated method.
-     */
-    #[Deprecated(reason: 'Use HydeFront::version() instead.', replacement: '\Hyde\Facades\HydeFront::version()')]
-    public static function version(): string
-    {
-        return HydeFront::version();
-    }
-
-    /**
-     * @deprecated Use HydeFront::cdnLink() instead.
-     *
-     * @codeCoverageIgnore Deprecated method.
-     */
-    #[Deprecated(reason: 'Use HydeFront::cdnLink() instead.', replacement: '\Hyde\Facades\HydeFront::cdnLink()')]
-    public static function cdnLink(string $file): string
-    {
-        return HydeFront::cdnLink($file);
-    }
 }

From 48a8a94aa8a54f85b3cbeab72594aae8189f3f2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 14:58:06 +0200
Subject: [PATCH 2848/4023] Remove unnecessary final modifiers from protected
 constants

---
 packages/framework/src/Facades/HydeFront.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index e3b5c76f606..22a25793caa 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -9,10 +9,10 @@
 class HydeFront
 {
     /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
-    final protected const HYDEFRONT_VERSION = 'v3.4';
+    protected const HYDEFRONT_VERSION = 'v3.4';
 
     /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
-    final protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
+    protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
 
     public static function version(): string
     {

From 57835e62662f90e7eae97d630b992e0f93d1f209 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:00:14 +0200
Subject: [PATCH 2849/4023] Inline helper method

---
 packages/framework/src/Facades/HydeFront.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 22a25793caa..aa45b7cfc3a 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -20,11 +20,6 @@ public static function version(): string
     }
 
     public static function cdnLink(string $file): string
-    {
-        return static::constructCdnPath($file);
-    }
-
-    protected static function constructCdnPath(string $file): string
     {
         return str_replace(
             ['{{ $version }}', '{{ $file }}'],

From 84a686456893f91fcf56ffed0e1fa6422af6fbda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:00:37 +0200
Subject: [PATCH 2850/4023] Clean up helper method

---
 packages/framework/src/Facades/HydeFront.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index aa45b7cfc3a..b2a43426e92 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -22,8 +22,7 @@ public static function version(): string
     public static function cdnLink(string $file): string
     {
         return str_replace(
-            ['{{ $version }}', '{{ $file }}'],
-            [static::version(), $file],
+            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
             static::HYDEFRONT_CDN_URL
         );
     }

From 324b316ab148ed325df19391a220b28378f9e62d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:03:14 +0200
Subject: [PATCH 2851/4023] Simplify helper method implementation

With the private API we can now use a more specific and cleaner implementation
---
 packages/framework/src/Facades/HydeFront.php | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index b2a43426e92..13892a380e1 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -4,15 +4,15 @@
 
 namespace Hyde\Facades;
 
-use function str_replace;
+use function sprintf;
 
 class HydeFront
 {
     /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
     protected const HYDEFRONT_VERSION = 'v3.4';
 
-    /** @var string The default HydeFront CDN path pattern. The Blade-style placeholders are replaced with the proper values. */
-    protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@{{ $version }}/dist/{{ $file }}';
+    /** @var string The default HydeFront CDN path pattern. */
+    protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@%s/dist/%s';
 
     public static function version(): string
     {
@@ -21,9 +21,6 @@ public static function version(): string
 
     public static function cdnLink(string $file): string
     {
-        return str_replace(
-            ['{{ $version }}', '{{ $file }}'], [static::version(), $file],
-            static::HYDEFRONT_CDN_URL
-        );
+        return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 }

From f2c63bcf3186a5d98973409e79fd39d38fe5f952 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:04:33 +0200
Subject: [PATCH 2852/4023] Add HydeFront facade class documentation

---
 packages/framework/src/Facades/HydeFront.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 13892a380e1..5c9223b7c85 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -6,6 +6,11 @@
 
 use function sprintf;
 
+/**
+ * HydeFront is the NPM package that bundles the default precompiled CSS and JavaScript assets for HydePHP.
+ *
+ * This facade makes it easy to access these assets from the HydeFront CDN, automatically getting the correct version.
+ */
 class HydeFront
 {
     /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */

From 24571037a9a2ba5eac12f03ffd60267756b9ca67 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:11:24 +0200
Subject: [PATCH 2853/4023] Add rich PHPDoc method annotations

---
 packages/framework/src/Facades/HydeFront.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 5c9223b7c85..00f5a6ce543 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -19,11 +19,21 @@ class HydeFront
     /** @var string The default HydeFront CDN path pattern. */
     protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@%s/dist/%s';
 
+    /**
+     * Get the current version of the HydeFront package.
+     *
+     * @return string {@see HYDEFRONT_VERSION}
+     */
     public static function version(): string
     {
         return static::HYDEFRONT_VERSION;
     }
 
+    /**
+     * Get the CDN link for a specific file.
+     *
+     * @param  'app.css'|'hyde.css'|'hyde.css.map'  $file
+     */
     public static function cdnLink(string $file): string
     {
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);

From e33c8213a700df0da06636fdb347674d4540117b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:13:03 +0200
Subject: [PATCH 2854/4023] Add more tests

---
 .../tests/Unit/Facades/HydeFrontFacadeTest.php       | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index 37425127bf7..4afe8ee9e36 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -22,4 +22,16 @@ public function testCdnLinkReturnsCorrectUrl()
         $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css';
         $this->assertSame($expected, HydeFront::cdnLink('styles.css'));
     }
+
+    public function testCdnLinkReturnsCorrectUrlForHydeCss()
+    {
+        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/hyde.css';
+        $this->assertSame($expected, HydeFront::cdnLink('hyde.css'));
+    }
+
+    public function testCdnLinkReturnsCorrectUrlForInvalidFile()
+    {
+        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/invalid';
+        $this->assertSame($expected, HydeFront::cdnLink('invalid'));
+    }
 }

From f00db0771ef14e40b146f6a5cc359ba2953bfef4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:13:28 +0200
Subject: [PATCH 2855/4023] Update constant comment

---
 packages/framework/src/Facades/HydeFront.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 00f5a6ce543..b566839b999 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -16,7 +16,7 @@ class HydeFront
     /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
     protected const HYDEFRONT_VERSION = 'v3.4';
 
-    /** @var string The default HydeFront CDN path pattern. */
+    /** @var string The default HydeFront CDN path pattern used to assemble CDN links. */
     protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@%s/dist/%s';
 
     /**

From dc129051b7831a23ebe81f41e37783d5f8a2fac7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:17:26 +0200
Subject: [PATCH 2856/4023] Add todo

---
 packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index 4afe8ee9e36..fd4336eff3a 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -12,6 +12,8 @@
  */
 class HydeFrontFacadeTest extends UnitTestCase
 {
+    // Todo: Check the version is correct? (When running in monorepo)
+
     public function testVersionReturnsString()
     {
         $this->assertIsString(HydeFront::version());

From 397e19e3d0e622dad4267d219dc159326f903d9e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:52:48 +0200
Subject: [PATCH 2857/4023] Move Tailwind config injection to HydeFront facade

This is more coupled to HydeFront than general Asset services
---
 .../resources/views/layouts/styles.blade.php  |  2 +-
 packages/framework/src/Facades/Asset.php      | 20 ----------------
 packages/framework/src/Facades/HydeFront.php  | 21 +++++++++++++++++
 .../Unit/Facades/AssetFacadeUnitTest.php      | 21 -----------------
 .../Unit/Facades/HydeFrontFacadeTest.php      | 23 +++++++++++++++++++
 5 files changed, 45 insertions(+), 42 deletions(-)

diff --git a/packages/framework/resources/views/layouts/styles.blade.php b/packages/framework/resources/views/layouts/styles.blade.php
index 2a345a4ce18..d1b374d73cf 100644
--- a/packages/framework/resources/views/layouts/styles.blade.php
+++ b/packages/framework/resources/views/layouts/styles.blade.php
@@ -11,7 +11,7 @@
 {{-- Dynamic TailwindCSS Play CDN --}}
 @if(config('hyde.use_play_cdn', false))
     <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
-    <script>tailwind.config = { {!! Asset::injectTailwindConfig() !!} }</script>
+    <script>tailwind.config = { {!! HydeFront::injectTailwindConfig() !!} }</script>
     <script>console.warn('The HydePHP TailwindCSS Play CDN is enabled. This is for development purposes only and should not be used in production.', 'See https://hydephp.com/docs/1.x/managing-assets');</script>
 @endif
 
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 2300dd6dc72..9691a43c211 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -5,11 +5,9 @@
 namespace Hyde\Facades;
 
 use Hyde\Hyde;
-use Illuminate\Support\Str;
 
 use function md5_file;
 use function file_exists;
-use function file_get_contents;
 
 /**
  * Handles the retrieval of core asset files, either from the HydeFront CDN or from the local media folder.
@@ -29,24 +27,6 @@ public static function hasMediaFile(string $file): bool
         return file_exists(Hyde::mediaPath($file));
     }
 
-    public static function injectTailwindConfig(): string
-    {
-        if (! file_exists(Hyde::path('tailwind.config.js'))) {
-            return '';
-        }
-
-        $config = Str::between(file_get_contents(Hyde::path('tailwind.config.js')), '{', '}');
-
-        // Remove the plugins array, as it is not used in the frontend.
-        if (str_contains($config, 'plugins: [')) {
-            $tokens = explode('plugins: [', $config, 2);
-            $tokens[1] = Str::after($tokens[1], ']');
-            $config = implode('', $tokens);
-        }
-
-        return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
-    }
-
     protected static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index b566839b999..546989442a8 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Facades;
 
+use Hyde\Hyde;
+use Illuminate\Support\Str;
+
 use function sprintf;
 
 /**
@@ -38,4 +41,22 @@ public static function cdnLink(string $file): string
     {
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
+
+    public static function injectTailwindConfig(): string
+    {
+        if (! file_exists(Hyde::path('tailwind.config.js'))) {
+            return '';
+        }
+
+        $config = Str::between(file_get_contents(Hyde::path('tailwind.config.js')), '{', '}');
+
+        // Remove the plugins array, as it is not used in the frontend.
+        if (str_contains($config, 'plugins: [')) {
+            $tokens = explode('plugins: [', $config, 2);
+            $tokens[1] = Str::after($tokens[1], ']');
+            $config = implode('', $tokens);
+        }
+
+        return preg_replace('/\s+/', ' ', "/* tailwind.config.js */ \n".rtrim($config, ",\n\r"));
+    }
 }
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 81cbfc029b4..4c62090bbae 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
-use Hyde\Hyde;
 use Hyde\Facades\Asset;
 use Hyde\Testing\UnitTestCase;
 
@@ -30,24 +29,4 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
     {
         $this->assertTrue(Asset::hasMediaFile('app.css'));
     }
-
-    public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
-    {
-        $config = Asset::injectTailwindConfig();
-
-        $this->assertIsString($config);
-        $this->assertStringContainsString("darkMode: 'class'", $config);
-        $this->assertStringContainsString('theme: {', $config);
-        $this->assertStringContainsString('extend: {', $config);
-        $this->assertStringContainsString('typography: {', $config);
-        $this->assertStringNotContainsString('plugins', $config);
-    }
-
-    public function testInjectTailwindConfigHandlesMissingConfigFileGracefully()
-    {
-        rename(Hyde::path('tailwind.config.js'), Hyde::path('tailwind.config.js.bak'));
-        $this->assertIsString(Asset::injectTailwindConfig());
-        $this->assertSame('', Asset::injectTailwindConfig());
-        rename(Hyde::path('tailwind.config.js.bak'), Hyde::path('tailwind.config.js'));
-    }
 }
diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index fd4336eff3a..3bcdf3a096d 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Hyde;
 use Hyde\Facades\HydeFront;
 use Hyde\Testing\UnitTestCase;
 
@@ -12,6 +13,8 @@
  */
 class HydeFrontFacadeTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+
     // Todo: Check the version is correct? (When running in monorepo)
 
     public function testVersionReturnsString()
@@ -36,4 +39,24 @@ public function testCdnLinkReturnsCorrectUrlForInvalidFile()
         $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/invalid';
         $this->assertSame($expected, HydeFront::cdnLink('invalid'));
     }
+
+    public function testInjectTailwindConfigReturnsExtractedTailwindConfig()
+    {
+        $config = HydeFront::injectTailwindConfig();
+
+        $this->assertIsString($config);
+        $this->assertStringContainsString("darkMode: 'class'", $config);
+        $this->assertStringContainsString('theme: {', $config);
+        $this->assertStringContainsString('extend: {', $config);
+        $this->assertStringContainsString('typography: {', $config);
+        $this->assertStringNotContainsString('plugins', $config);
+    }
+
+    public function testInjectTailwindConfigHandlesMissingConfigFileGracefully()
+    {
+        rename(Hyde::path('tailwind.config.js'), Hyde::path('tailwind.config.js.bak'));
+        $this->assertIsString(HydeFront::injectTailwindConfig());
+        $this->assertSame('', HydeFront::injectTailwindConfig());
+        rename(Hyde::path('tailwind.config.js.bak'), Hyde::path('tailwind.config.js'));
+    }
 }

From eb5136a7e392c2edae6cbc6c5065a1b9b4864cff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:55:21 +0200
Subject: [PATCH 2858/4023] Mark method as internal

---
 packages/framework/src/Facades/HydeFront.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 546989442a8..2529d2c2d91 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -42,6 +42,9 @@ public static function cdnLink(string $file): string
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 
+    /**
+     * @internal This method is used to inject the Tailwind CSS configuration into the Play CDN integration.
+     */
     public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {

From bbd960b49b7843a6b5afb714f333f8326b8b5dfd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:55:24 +0200
Subject: [PATCH 2859/4023] Revert "Mark method as internal"

This reverts commit eb5136a7e392c2edae6cbc6c5065a1b9b4864cff.
---
 packages/framework/src/Facades/HydeFront.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 2529d2c2d91..546989442a8 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -42,9 +42,6 @@ public static function cdnLink(string $file): string
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 
-    /**
-     * @internal This method is used to inject the Tailwind CSS configuration into the Play CDN integration.
-     */
     public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {

From fc5b464287f3e840def2aa718fcb90720bb5c58f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:55:55 +0200
Subject: [PATCH 2860/4023] Document method

---
 packages/framework/src/Facades/HydeFront.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 546989442a8..97cc2bdb091 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -42,6 +42,9 @@ public static function cdnLink(string $file): string
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 
+    /**
+     * This method is used to inject the Tailwind CSS configuration into the Play CDN integration.
+     */
     public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {

From 63b414a88724af984843ee2c77b95e586ae986a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 15:56:09 +0200
Subject: [PATCH 2861/4023] Compress comment formatting

---
 packages/framework/src/Facades/HydeFront.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 97cc2bdb091..ed2def95db9 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -42,9 +42,7 @@ public static function cdnLink(string $file): string
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 
-    /**
-     * This method is used to inject the Tailwind CSS configuration into the Play CDN integration.
-     */
+    /** This method is used to inject the Tailwind CSS configuration into the Play CDN integration. */
     public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {

From 9ba410a818c2c4875a65634d4cd6cf51fd67f58a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:00:24 +0200
Subject: [PATCH 2862/4023] Refactor to merge feature test into unit test

---
 .../tests/Feature/AssetFacadeTest.php         | 46 -------------------
 .../Unit/Facades/AssetFacadeUnitTest.php      | 44 +++++++++++++++++-
 2 files changed, 42 insertions(+), 48 deletions(-)
 delete mode 100644 packages/framework/tests/Feature/AssetFacadeTest.php

diff --git a/packages/framework/tests/Feature/AssetFacadeTest.php b/packages/framework/tests/Feature/AssetFacadeTest.php
deleted file mode 100644
index 3e934eab38b..00000000000
--- a/packages/framework/tests/Feature/AssetFacadeTest.php
+++ /dev/null
@@ -1,46 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Feature;
-
-use Hyde\Facades\Asset;
-use Hyde\Hyde;
-use Hyde\Testing\TestCase;
-
-/**
- * @covers \Hyde\Facades\Asset
- *
- * @see \Hyde\Framework\Testing\Unit\Facades\AssetFacadeUnitTest
- */
-class AssetFacadeTest extends TestCase
-{
-    public function testMediaLinkReturnsMediaPathWithCacheKey()
-    {
-        $this->assertIsString($path = Asset::mediaLink('app.css'));
-        $this->assertSame('media/app.css?v='.md5_file(Hyde::path('_media/app.css')), $path);
-    }
-
-    public function testMediaLinkReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
-    {
-        config(['hyde.enable_cache_busting' => false]);
-
-        $path = Asset::mediaLink('app.css');
-
-        $this->assertIsString($path);
-        $this->assertSame('media/app.css', $path);
-    }
-
-    public function testMediaLinkSupportsCustomMediaDirectories()
-    {
-        $this->directory('_assets');
-        $this->file('_assets/app.css');
-
-        Hyde::setMediaDirectory('_assets');
-
-        $path = Asset::mediaLink('app.css');
-
-        $this->assertIsString($path);
-        $this->assertSame('assets/app.css?v='.md5_file(Hyde::path('_assets/app.css')), $path);
-    }
-}
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 4c62090bbae..a004e805399 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -4,20 +4,31 @@
 
 namespace Hyde\Framework\Testing\Unit\Facades;
 
+use Hyde\Hyde;
 use Hyde\Facades\Asset;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Facades\Render;
+use Hyde\Support\Models\RenderData;
+use Hyde\Testing\CreatesTemporaryFiles;
 
 /**
  * @covers \Hyde\Facades\Asset
- *
- * @see \Hyde\Framework\Testing\Feature\AssetFacadeTest
  */
 class AssetFacadeUnitTest extends UnitTestCase
 {
+    use CreatesTemporaryFiles;
+
     protected function setUp(): void
     {
         self::needsKernel();
         self::mockConfig();
+
+        Render::swap(new RenderData());
+    }
+
+    protected function tearDown(): void
+    {
+        $this->cleanUpFilesystem();
     }
 
     public function testHasMediaFileHelper()
@@ -29,4 +40,33 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
     {
         $this->assertTrue(Asset::hasMediaFile('app.css'));
     }
+
+    public function testMediaLinkReturnsMediaPathWithCacheKey()
+    {
+        $this->assertIsString($path = Asset::mediaLink('app.css'));
+        $this->assertSame('media/app.css?v='.md5_file(Hyde::path('_media/app.css')), $path);
+    }
+
+    public function testMediaLinkReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false]);
+
+        $path = Asset::mediaLink('app.css');
+
+        $this->assertIsString($path);
+        $this->assertSame('media/app.css', $path);
+    }
+
+    public function testMediaLinkSupportsCustomMediaDirectories()
+    {
+        $this->directory('_assets');
+        $this->file('_assets/app.css');
+
+        Hyde::setMediaDirectory('_assets');
+
+        $path = Asset::mediaLink('app.css');
+
+        $this->assertIsString($path);
+        $this->assertSame('assets/app.css?v='.md5_file(Hyde::path('_assets/app.css')), $path);
+    }
 }

From 9edfe944225a12e696f99183e305a98b0cb633cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:12:38 +0200
Subject: [PATCH 2863/4023] Refactor test to be a unit test

---
 .../{Feature => Unit}/Support/MediaFileTest.php | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)
 rename packages/framework/tests/{Feature => Unit}/Support/MediaFileTest.php (93%)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
similarity index 93%
rename from packages/framework/tests/Feature/Support/MediaFileTest.php
rename to packages/framework/tests/Unit/Support/MediaFileTest.php
index 0782bfaf3bc..a4798f0db52 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -2,19 +2,30 @@
 
 declare(strict_types=1);
 
-namespace Hyde\Framework\Testing\Feature\Support;
+namespace Hyde\Framework\Testing\Unit\Support;
 
 use Hyde\Facades\Filesystem;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
-use Hyde\Testing\TestCase;
+use Hyde\Testing\UnitTestCase;
+use Hyde\Testing\CreatesTemporaryFiles;
 
 /**
  * @covers \Hyde\Support\Filesystem\MediaFile
  */
-class MediaFileTest extends TestCase
+class MediaFileTest extends UnitTestCase
 {
+    use CreatesTemporaryFiles;
+
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
+    protected function tearDown(): void
+    {
+        $this->cleanUpFilesystem();
+    }
+
     public function testCanConstruct()
     {
         $file = new MediaFile('foo');

From b6eed88c1161093f44daee2b30a4c0474a113212 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:19:28 +0200
Subject: [PATCH 2864/4023] Draft new mediaPath helper

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 45298a50694..e5f0fba95bf 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -41,6 +41,14 @@ public static function files(): array
         return array_keys(static::all());
     }
 
+    /**
+     * Get the absolute path to the media source directory, or a file within it.
+     */
+    public static function mediaPath(string $path = ''): string
+    {
+        return Hyde::mediaPath($path);
+    }
+
     public function getIdentifier(): string
     {
         return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');

From ccca1d773052be4e37f5204b774b1104983a3a76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:20:01 +0200
Subject: [PATCH 2865/4023] Draft new siteMediaPath helper

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e5f0fba95bf..418ea84e73c 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -49,6 +49,14 @@ public static function mediaPath(string $path = ''): string
         return Hyde::mediaPath($path);
     }
 
+    /**
+     * Get the absolute path to the compiled site's media directory, or a file within it.
+     */
+    public static function siteMediaPath(string $path = ''): string
+    {
+        return Hyde::siteMediaPath($path);
+    }
+
     public function getIdentifier(): string
     {
         return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');

From b6a1269272b9f9391f0ceb7a08539b426b3e1dfd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:21:31 +0200
Subject: [PATCH 2866/4023] Inline kernel access

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 418ea84e73c..539ac68f3fe 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Hyde\Foundation\HydeKernel;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -46,7 +47,7 @@ public static function files(): array
      */
     public static function mediaPath(string $path = ''): string
     {
-        return Hyde::mediaPath($path);
+        return HydeKernel::getInstance()->mediaPath($path);
     }
 
     /**
@@ -54,7 +55,7 @@ public static function mediaPath(string $path = ''): string
      */
     public static function siteMediaPath(string $path = ''): string
     {
-        return Hyde::siteMediaPath($path);
+        return HydeKernel::getInstance()->siteMediaPath($path);
     }
 
     public function getIdentifier(): string

From ecd98dbd436cc29663d956fbb9b0ab94ab89c768 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:22:14 +0200
Subject: [PATCH 2867/4023] Rename added methods to match HydePage siblings

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 539ac68f3fe..3b514361caf 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -45,7 +45,7 @@ public static function files(): array
     /**
      * Get the absolute path to the media source directory, or a file within it.
      */
-    public static function mediaPath(string $path = ''): string
+    public static function sourcePath(string $path = ''): string
     {
         return HydeKernel::getInstance()->mediaPath($path);
     }
@@ -53,7 +53,7 @@ public static function mediaPath(string $path = ''): string
     /**
      * Get the absolute path to the compiled site's media directory, or a file within it.
      */
-    public static function siteMediaPath(string $path = ''): string
+    public static function outputPath(string $path = ''): string
     {
         return HydeKernel::getInstance()->siteMediaPath($path);
     }

From beaf5114a3c086274430db9c2961a598c603062d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:23:27 +0200
Subject: [PATCH 2868/4023] Refactor base implementations to be class
 independent

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index a8f36a32df1..cdd1685b295 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -97,10 +97,10 @@ public function pathToRelative(string $path): string
     public function mediaPath(string $path = ''): string
     {
         if (empty($path)) {
-            return $this->path(Hyde::getMediaDirectory());
+            return Hyde::path(Hyde::getMediaDirectory());
         }
 
-        return $this->path(path_join(Hyde::getMediaDirectory(), unslash($path)));
+        return Hyde::path(path_join(Hyde::getMediaDirectory(), unslash($path)));
     }
 
     /**
@@ -121,12 +121,12 @@ public function sitePath(string $path = ''): string
     public function siteMediaPath(string $path = ''): string
     {
         if (empty($path)) {
-            return $this->sitePath(Hyde::getMediaOutputDirectory());
+            return Hyde::sitePath(Hyde::getMediaOutputDirectory());
         }
 
         $path = unslash($path);
 
-        return $this->sitePath(Hyde::getMediaOutputDirectory()."/$path");
+        return Hyde::sitePath(Hyde::getMediaOutputDirectory()."/$path");
     }
 
     /**

From 9aa1f66db9d946cf41e7f1b16f0e5f04f8a0ceba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:24:53 +0200
Subject: [PATCH 2869/4023] Move method logic to new code location

---
 .../src/Foundation/Kernel/Filesystem.php        | 15 +++------------
 .../src/Support/Filesystem/MediaFile.php        | 17 ++++++++++++++---
 2 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index cdd1685b295..c637ed271b9 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\PharSupport;
+use Hyde\Support\Filesystem\MediaFile;
 use Illuminate\Support\Collection;
 
 use function collect;
@@ -96,11 +97,7 @@ public function pathToRelative(string $path): string
      */
     public function mediaPath(string $path = ''): string
     {
-        if (empty($path)) {
-            return Hyde::path(Hyde::getMediaDirectory());
-        }
-
-        return Hyde::path(path_join(Hyde::getMediaDirectory(), unslash($path)));
+        return MediaFile::sourcePath($path);
     }
 
     /**
@@ -120,13 +117,7 @@ public function sitePath(string $path = ''): string
      */
     public function siteMediaPath(string $path = ''): string
     {
-        if (empty($path)) {
-            return Hyde::sitePath(Hyde::getMediaOutputDirectory());
-        }
-
-        $path = unslash($path);
-
-        return Hyde::sitePath(Hyde::getMediaOutputDirectory()."/$path");
+        return MediaFile::outputPath($path);
     }
 
     /**
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3b514361caf..fbf6f04ea9b 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,10 +6,11 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Hyde\Foundation\HydeKernel;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
+use function Hyde\unslash;
+use function Hyde\path_join;
 use function extension_loaded;
 use function file_exists;
 use function array_merge;
@@ -47,7 +48,11 @@ public static function files(): array
      */
     public static function sourcePath(string $path = ''): string
     {
-        return HydeKernel::getInstance()->mediaPath($path);
+        if (empty($path)) {
+            return Hyde::path(Hyde::getMediaDirectory());
+        }
+
+        return Hyde::path(path_join(Hyde::getMediaDirectory(), unslash($path)));
     }
 
     /**
@@ -55,7 +60,13 @@ public static function sourcePath(string $path = ''): string
      */
     public static function outputPath(string $path = ''): string
     {
-        return HydeKernel::getInstance()->siteMediaPath($path);
+        if (empty($path)) {
+            return Hyde::sitePath(Hyde::getMediaOutputDirectory());
+        }
+
+        $path = unslash($path);
+
+        return Hyde::sitePath(Hyde::getMediaOutputDirectory()."/$path");
     }
 
     public function getIdentifier(): string

From 5863d03613db465499d3f26e6344f66480c01b9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:27:20 +0200
Subject: [PATCH 2870/4023] Reorder methods to match sibling order

---
 .../hyde-kernel-filesystem-methods.md            | 10 +++++-----
 .../Foundation/Concerns/ForwardsFilesystem.php   |  8 ++++----
 .../src/Foundation/Kernel/Filesystem.php         | 16 ++++++++--------
 spec.md                                          |  4 ++--
 4 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index bdbe12dd34d..204bb419328 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2023-03-11 11:17:34 in 0.10ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-26 14:30:44 in 0.13ms -->
 
 #### `filesystem()`
 
@@ -35,20 +35,20 @@ No description provided.
 Hyde::mediaPath(string $path): string
 ```
 
-#### `sitePath()`
+#### `siteMediaPath()`
 
 No description provided.
 
 ```php
-Hyde::sitePath(string $path): string
+Hyde::siteMediaPath(string $path): string
 ```
 
-#### `siteMediaPath()`
+#### `sitePath()`
 
 No description provided.
 
 ```php
-Hyde::siteMediaPath(string $path): string
+Hyde::sitePath(string $path): string
 ```
 
 #### `pathToAbsolute()`
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index 88e8aba452b..c0ac1518277 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -33,14 +33,14 @@ public function mediaPath(string $path = ''): string
         return $this->filesystem->mediaPath($path);
     }
 
-    public function sitePath(string $path = ''): string
+    public function siteMediaPath(string $path = ''): string
     {
-        return $this->filesystem->sitePath($path);
+        return $this->filesystem->siteMediaPath($path);
     }
 
-    public function siteMediaPath(string $path = ''): string
+    public function sitePath(string $path = ''): string
     {
-        return $this->filesystem->siteMediaPath($path);
+        return $this->filesystem->sitePath($path);
     }
 
     public function pathToAbsolute(string|array $path): string|array
diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index c637ed271b9..f254440d3e8 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -100,6 +100,14 @@ public function mediaPath(string $path = ''): string
         return MediaFile::sourcePath($path);
     }
 
+    /**
+     * Get the absolute path to the compiled site's media directory, or a file within it.
+     */
+    public function siteMediaPath(string $path = ''): string
+    {
+        return MediaFile::outputPath($path);
+    }
+
     /**
      * Get the absolute path to the compiled site directory, or a file within it.
      */
@@ -112,14 +120,6 @@ public function sitePath(string $path = ''): string
         return $this->path(path_join(Hyde::getOutputDirectory(), unslash($path)));
     }
 
-    /**
-     * Get the absolute path to the compiled site's media directory, or a file within it.
-     */
-    public function siteMediaPath(string $path = ''): string
-    {
-        return MediaFile::outputPath($path);
-    }
-
     /**
      * Works similarly to the path() function, but returns a file in the Framework package.
      *
diff --git a/spec.md b/spec.md
index a1ca493ac41..cb78e76674c 100644
--- a/spec.md
+++ b/spec.md
@@ -78,17 +78,17 @@ Asset::hasMediaFile(string $file) // Returns file_exists(Hyde::mediaPath($file))
 
 ```php
 Hyde::mediaPath() // Get the absolute path to the media source directory, or a file within it. (Intended as a sibling to Hyde::path and Hyde::sitePath helpers, and the HydePage::path methods)
+Hyde::siteMediaPath() //  Get the absolute path to the compiled site's media directory, or a file within it. (Intended as a sibling to Hyde::sitePath)
 Hyde::mediaLink() // Gets a relative web link to the given file stored in the _site/media folder. (Intended as a sibling to Hyde::relativeLink, which is called by this) (A second $validate parameter will return throw an exception if the file does not exist)
 Hyde::asset() // Gets a relative web link to the given image stored in the _site/media folder. (But leaves remote URLs alone) (A second $preferQualifiedUrl parameter will return a fully qualified URL if a site URL is set)
-Hyde::siteMediaPath() //  Get the absolute path to the compiled site's media directory, or a file within it. (Intended as a sibling to Hyde::sitePath)
 
 /**
  * Real implementations of the facade methods:
  * 
  * @see \Hyde\Foundation\HydeKernel::mediaPath {@see \Hyde\Foundation\Kernel\Filesystem::mediaPath}
+ * @see \Hyde\Foundation\HydeKernel::siteMediaPath {@see \Hyde\Foundation\Kernel\Filesystem::siteMediaPath}
  * @see \Hyde\Foundation\HydeKernel::mediaLink {@see \Hyde\Foundation\Kernel\Hyperlinks::mediaLink}
  * @see \Hyde\Foundation\HydeKernel::asset {@see \Hyde\Foundation\Kernel\Hyperlinks::asset}
- * @see \Hyde\Foundation\HydeKernel::siteMediaPath {@see \Hyde\Foundation\Kernel\Filesystem::siteMediaPath}
  */
 ```
 

From a60e91b61659925ed17a370e37c5c69fc293bf5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:37:07 +0200
Subject: [PATCH 2871/4023] Move tests to match new code locations

---
 .../Feature/Foundation/FilesystemTest.php     | 25 +++++-----------
 .../tests/Unit/Support/MediaFileTest.php      | 30 +++++++++++++++++++
 2 files changed, 37 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 6c2c2811cd8..0be01b45c22 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -13,6 +13,7 @@
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 
 use function Hyde\normalize_slashes;
@@ -263,31 +264,19 @@ public function testHelperForDocumentationPages()
     public function testHelperForMediaPath()
     {
         $this->assertSame(Hyde::path('_media'), Hyde::mediaPath());
-    }
-
-    public function testHelperForMediaPathReturnsPathToFileWithinTheDirectory()
-    {
-        $this->assertSame(Hyde::path('_media/foo.css'), Hyde::mediaPath('foo.css'));
-    }
+        $this->assertSame(MediaFile::sourcePath(), Hyde::mediaPath());
 
-    public function testGetMediaPathReturnsAbsolutePath()
-    {
-        $this->assertSame(Hyde::path('_media'), Hyde::mediaPath());
+        $this->assertSame(Hyde::path('_media/foo.png'), Hyde::mediaPath('foo.png'));
+        $this->assertSame(MediaFile::sourcePath('foo.png'), Hyde::mediaPath('foo.png'));
     }
 
     public function testHelperForMediaOutputPath()
     {
         $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
-    }
-
-    public function testHelperForMediaOutputPathReturnsPathToFileWithinTheDirectory()
-    {
-        $this->assertSame(Hyde::path('_site/media/foo.css'), Hyde::siteMediaPath('foo.css'));
-    }
+        $this->assertSame(MediaFile::outputPath(), Hyde::siteMediaPath());
 
-    public function testGetMediaOutputPathReturnsAbsolutePath()
-    {
-        $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
+        $this->assertSame(Hyde::path('_site/media/foo.png'), Hyde::siteMediaPath('foo.png'));
+        $this->assertSame(MediaFile::outputPath('foo.png'), Hyde::siteMediaPath('foo.png'));
     }
 
     public function testHelperForSiteOutputPath()
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index a4798f0db52..86969b4d3ab 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -211,4 +211,34 @@ public function testGetIdentifierWithSubdirectory()
     {
         $this->assertSame('foo/bar', MediaFile::make('foo/bar')->getIdentifier());
     }
+
+    public function testHelperForMediaPath()
+    {
+        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
+    }
+
+    public function testHelperForMediaPathReturnsPathToFileWithinTheDirectory()
+    {
+        $this->assertSame(Hyde::path('_media/foo.css'), MediaFile::sourcePath('foo.css'));
+    }
+
+    public function testGetMediaPathReturnsAbsolutePath()
+    {
+        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
+    }
+
+    public function testHelperForMediaOutputPath()
+    {
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
+    }
+
+    public function testHelperForMediaOutputPathReturnsPathToFileWithinTheDirectory()
+    {
+        $this->assertSame(Hyde::path('_site/media/foo.css'), MediaFile::outputPath('foo.css'));
+    }
+
+    public function testGetMediaOutputPathReturnsAbsolutePath()
+    {
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
+    }
 }

From 8cfe0cd6d471f8c81bf259e0d1bc5066a57765f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:38:13 +0200
Subject: [PATCH 2872/4023] Add todos to move more tests to match new code
 locations

---
 packages/framework/tests/Feature/HydeKernelTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 8c1470b4206..bd22206502d 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -393,17 +393,23 @@ public function testGetMediaOutputDirectoryNameUsesTrimmedVersionOfMediaSourceDi
 
     public function testCanGetSiteMediaOutputDirectory()
     {
+        // Todo: Move to MediaFileTest
+
         $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
     }
 
     public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
     {
+        // Todo: Move to MediaFileTest
+
         Hyde::setMediaDirectory('_foo');
         $this->assertSame(Hyde::path('_site/foo'), Hyde::siteMediaPath());
     }
 
     public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
     {
+        // Todo: Move to MediaFileTest
+
         Hyde::setOutputDirectory(Hyde::path('foo'));
         Hyde::setMediaDirectory('bar');
 

From 89d0e52d4693ced01185fb7766c2d96208b47828 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:44:01 +0200
Subject: [PATCH 2873/4023] Create new internal trait for transitioning to v2

---
 packages/framework/src/Hyde.php                   |  3 +++
 .../framework/src/Support/V1Compatibility.php     | 15 +++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 packages/framework/src/Support/V1Compatibility.php

diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index cc309a3b21c..105b42de812 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -7,6 +7,7 @@
 use Hyde\Enums\Feature;
 use Hyde\Facades\Features;
 use Hyde\Foundation\HydeKernel;
+use Hyde\Support\V1Compatibility;
 use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\Filesystem;
@@ -79,6 +80,8 @@
  */
 class Hyde extends Facade
 {
+    use V1Compatibility;
+
     public static function version(): string
     {
         return HydeKernel::version();
diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
new file mode 100644
index 00000000000..ed03754713d
--- /dev/null
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Support;
+
+/**
+ * @internal Hyde Facade support to aid in the v1 to v2 transition.
+ *
+ * @deprecated All code here is deprecated, and exists to help you transition.
+ */
+trait V1Compatibility
+{
+    //
+}

From 4091051785fcc5cba66b6b4eb76abe0c23008655 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:46:05 +0200
Subject: [PATCH 2874/4023] Ignore class from code coverage

---
 packages/framework/src/Support/V1Compatibility.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
index ed03754713d..d26d62cd504 100644
--- a/packages/framework/src/Support/V1Compatibility.php
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -8,6 +8,8 @@
  * @internal Hyde Facade support to aid in the v1 to v2 transition.
  *
  * @deprecated All code here is deprecated, and exists to help you transition.
+ *
+ * @codeCoverageIgnore This class is ignored from code coverage.
  */
 trait V1Compatibility
 {

From 2004a4e67e8fd80b20ffb4f96d6dd177bf26b773 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:59:19 +0200
Subject: [PATCH 2875/4023] Revert "Ignore class from code coverage"

This reverts commit 4091051785fcc5cba66b6b4eb76abe0c23008655.
---
 packages/framework/src/Support/V1Compatibility.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
index d26d62cd504..ed03754713d 100644
--- a/packages/framework/src/Support/V1Compatibility.php
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -8,8 +8,6 @@
  * @internal Hyde Facade support to aid in the v1 to v2 transition.
  *
  * @deprecated All code here is deprecated, and exists to help you transition.
- *
- * @codeCoverageIgnore This class is ignored from code coverage.
  */
 trait V1Compatibility
 {

From 650d5a7e815033bdbdc60c6eb0e6c4a7899883b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 16:54:58 +0200
Subject: [PATCH 2876/4023] Manually proxy and deprecate legacy facade methods

This is so we can get an overview of the outdated methods that are inconsistently named

This means they are lost from the HydeKernel which could be a problem to review before merge.
---
 .../hyde-kernel-filesystem-methods.md         | 18 +--------------
 .../Concerns/ForwardsFilesystem.php           | 10 --------
 .../src/Foundation/Kernel/Filesystem.php      | 17 --------------
 packages/framework/src/Hyde.php               |  2 --
 .../framework/src/Support/V1Compatibility.php | 23 ++++++++++++++++++-
 5 files changed, 23 insertions(+), 47 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index 204bb419328..eb5983597e6 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2024-07-26 14:30:44 in 0.13ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-26 15:15:12 in 0.09ms -->
 
 #### `filesystem()`
 
@@ -27,22 +27,6 @@ No description provided.
 Hyde::vendorPath(string $path, string $package): string
 ```
 
-#### `mediaPath()`
-
-No description provided.
-
-```php
-Hyde::mediaPath(string $path): string
-```
-
-#### `siteMediaPath()`
-
-No description provided.
-
-```php
-Hyde::siteMediaPath(string $path): string
-```
-
 #### `sitePath()`
 
 No description provided.
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index c0ac1518277..cea06f5bbc2 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -28,16 +28,6 @@ public function vendorPath(string $path = '', string $package = 'framework'): st
         return $this->filesystem->vendorPath($path, $package);
     }
 
-    public function mediaPath(string $path = ''): string
-    {
-        return $this->filesystem->mediaPath($path);
-    }
-
-    public function siteMediaPath(string $path = ''): string
-    {
-        return $this->filesystem->siteMediaPath($path);
-    }
-
     public function sitePath(string $path = ''): string
     {
         return $this->filesystem->sitePath($path);
diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index f254440d3e8..8f3bb2fd2aa 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\PharSupport;
-use Hyde\Support\Filesystem\MediaFile;
 use Illuminate\Support\Collection;
 
 use function collect;
@@ -92,22 +91,6 @@ public function pathToRelative(string $path): string
             : $path);
     }
 
-    /**
-     * Get the absolute path to the media source directory, or a file within it.
-     */
-    public function mediaPath(string $path = ''): string
-    {
-        return MediaFile::sourcePath($path);
-    }
-
-    /**
-     * Get the absolute path to the compiled site's media directory, or a file within it.
-     */
-    public function siteMediaPath(string $path = ''): string
-    {
-        return MediaFile::outputPath($path);
-    }
-
     /**
      * Get the absolute path to the compiled site directory, or a file within it.
      */
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 105b42de812..9590fb6133a 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -34,8 +34,6 @@
  * @method static string pathToAbsolute(string $path)
  * @method static string pathToRelative(string $path)
  * @method static string sitePath(string $path = '')
- * @method static string mediaPath(string $path = '')
- * @method static string siteMediaPath(string $path = '')
  * @method static string formatLink(string $destination)
  * @method static string relativeLink(string $destination)
  * @method static string mediaLink(string $destination, bool $validate = false)
diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
index ed03754713d..f6bd2de40c7 100644
--- a/packages/framework/src/Support/V1Compatibility.php
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Support;
 
+use JetBrains\PhpStorm\Deprecated;
+use Hyde\Support\Filesystem\MediaFile;
+
 /**
  * @internal Hyde Facade support to aid in the v1 to v2 transition.
  *
@@ -11,5 +14,23 @@
  */
 trait V1Compatibility
 {
-    //
+    /**
+     * @deprecated Use MediaFile::sourcePath() instead.
+     * @see \Hyde\Support\Filesystem\MediaFile::sourcePath()
+     */
+    #[Deprecated(reason: 'Use MediaFile::sourcePath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::sourcePath()')]
+    public static function mediaPath(string $path = ''): string
+    {
+        return MediaFile::sourcePath($path);
+    }
+
+    /**
+     * @deprecated Use MediaFile::outputPath() instead.
+     * @see \Hyde\Support\Filesystem\MediaFile::outputPath()
+     */
+    #[Deprecated(reason: 'Use MediaFile::outputPath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::outputPath()')]
+    public static function siteMediaPath(string $path = ''): string
+    {
+        return MediaFile::outputPath($path);
+    }
 }

From 8228d7a474666aeaf63b9d6d072f48e63305782f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 17:04:58 +0200
Subject: [PATCH 2877/4023] Set the parameters list

---
 packages/framework/src/Support/V1Compatibility.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
index f6bd2de40c7..863734b99cd 100644
--- a/packages/framework/src/Support/V1Compatibility.php
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -18,7 +18,7 @@ trait V1Compatibility
      * @deprecated Use MediaFile::sourcePath() instead.
      * @see \Hyde\Support\Filesystem\MediaFile::sourcePath()
      */
-    #[Deprecated(reason: 'Use MediaFile::sourcePath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::sourcePath()')]
+    #[Deprecated(reason: 'Use MediaFile::sourcePath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::sourcePath(%parametersList%)')]
     public static function mediaPath(string $path = ''): string
     {
         return MediaFile::sourcePath($path);
@@ -28,7 +28,7 @@ public static function mediaPath(string $path = ''): string
      * @deprecated Use MediaFile::outputPath() instead.
      * @see \Hyde\Support\Filesystem\MediaFile::outputPath()
      */
-    #[Deprecated(reason: 'Use MediaFile::outputPath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::outputPath()')]
+    #[Deprecated(reason: 'Use MediaFile::outputPath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::outputPath(%parametersList%)')]
     public static function siteMediaPath(string $path = ''): string
     {
         return MediaFile::outputPath($path);

From 2e96631d81859d470251c4e86706971ea969eb46 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 17:05:43 +0200
Subject: [PATCH 2878/4023] Alias the MediaFile class

---
 app/config.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/config.php b/app/config.php
index 009c0f586b7..aed2519bbce 100644
--- a/app/config.php
+++ b/app/config.php
@@ -105,6 +105,7 @@
         'MarkdownPage' => \Hyde\Pages\MarkdownPage::class,
         'MarkdownPost' => \Hyde\Pages\MarkdownPost::class,
         'DocumentationPage' => \Hyde\Pages\DocumentationPage::class,
+        'MediaFile' => \Hyde\Support\Filesystem\MediaFile::class,
         'DataCollection' => \Hyde\Support\DataCollection::class,
         'Includes' => \Hyde\Support\Includes::class,
         'Feature' => \Hyde\Enums\Feature::class,

From bbe66f46095bb275661de093239aa2acf9fbd824 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 17:09:33 +0200
Subject: [PATCH 2879/4023] Update deprecated method usages with new helpers

---
 .../resources/views/layouts/head.blade.php       |  2 +-
 packages/framework/src/Facades/Asset.php         |  5 +++--
 .../Actions/PreBuildTasks/CleanSiteDirectory.php |  3 ++-
 .../PreBuildTasks/TransferMediaAssets.php        |  7 +++----
 .../Features/Blogging/Models/FeaturedImage.php   |  3 ++-
 .../src/Framework/Services/ValidationService.php |  5 +++--
 .../tests/Feature/Foundation/FilesystemTest.php  | 16 ++++++++--------
 .../framework/tests/Feature/HydeKernelTest.php   | 11 ++++++-----
 8 files changed, 28 insertions(+), 24 deletions(-)

diff --git a/packages/framework/resources/views/layouts/head.blade.php b/packages/framework/resources/views/layouts/head.blade.php
index 32ed4390d8b..111aced665b 100644
--- a/packages/framework/resources/views/layouts/head.blade.php
+++ b/packages/framework/resources/views/layouts/head.blade.php
@@ -2,7 +2,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{{ $page->title() }}</title>
 
-@if (file_exists(Hyde::mediaPath('favicon.ico')))
+@if (file_exists(MediaFile::sourcePath('favicon.ico')))
     <link rel="shortcut icon" href="{{ Hyde::relativeLink('media/favicon.ico') }}" type="image/x-icon">
 @endif
 
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 9691a43c211..45e16a0a881 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -5,6 +5,7 @@
 namespace Hyde\Facades;
 
 use Hyde\Hyde;
+use Hyde\Support\Filesystem\MediaFile;
 
 use function md5_file;
 use function file_exists;
@@ -24,13 +25,13 @@ public static function mediaLink(string $file): string
 
     public static function hasMediaFile(string $file): bool
     {
-        return file_exists(Hyde::mediaPath($file));
+        return file_exists(MediaFile::sourcePath($file));
     }
 
     protected static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
-            ? '?v='.md5_file(Hyde::mediaPath("$file"))
+            ? '?v='.md5_file(MediaFile::sourcePath("$file"))
             : '';
     }
 }
diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/CleanSiteDirectory.php b/packages/framework/src/Framework/Actions/PreBuildTasks/CleanSiteDirectory.php
index 849f077b7cb..ba64f24ee76 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/CleanSiteDirectory.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/CleanSiteDirectory.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
 
 use function basename;
@@ -22,7 +23,7 @@ public function handle(): void
     {
         if ($this->isItSafeToCleanOutputDirectory()) {
             Filesystem::unlink(glob(Hyde::sitePath('*.{html,json}'), GLOB_BRACE));
-            Filesystem::cleanDirectory(Hyde::siteMediaPath());
+            Filesystem::cleanDirectory(MediaFile::outputPath());
         }
     }
 
diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index fdec03a75ff..3acb112ea9d 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Actions\PreBuildTasks;
 
-use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
@@ -17,14 +16,14 @@ class TransferMediaAssets extends PreBuildTask
 
     public function handle(): void
     {
-        $this->needsDirectory(Hyde::siteMediaPath());
+        $this->needsDirectory(MediaFile::outputPath());
 
         $this->newLine();
 
         $this->withProgressBar(MediaFile::files(), function (string $identifier): void {
-            $sitePath = Hyde::siteMediaPath($identifier);
+            $sitePath = MediaFile::outputPath($identifier);
             $this->needsParentDirectory($sitePath);
-            copy(Hyde::mediaPath($identifier), $sitePath);
+            copy(MediaFile::sourcePath($identifier), $sitePath);
         });
 
         $this->newLine();
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index 0f42f961c87..5c4acef1996 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -11,6 +11,7 @@
 use Hyde\Support\BuildWarnings;
 use Illuminate\Support\Facades\Http;
 use Hyde\Foundation\Kernel\Hyperlinks;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\FeaturedImageSchema;
 
@@ -213,7 +214,7 @@ protected function has(string $property): bool
 
     protected function getContentLengthForLocalImage(): int
     {
-        $storagePath = Hyde::mediaPath($this->source);
+        $storagePath = MediaFile::sourcePath($this->source);
 
         if (! file_exists($storagePath)) {
             throw new FileNotFoundException(customMessage: sprintf('Featured image [%s] not found.', Hyde::pathToRelative($storagePath)));
diff --git a/packages/framework/src/Framework/Services/ValidationService.php b/packages/framework/src/Framework/Services/ValidationService.php
index 88deee3496b..052486d4041 100644
--- a/packages/framework/src/Framework/Services/ValidationService.php
+++ b/packages/framework/src/Framework/Services/ValidationService.php
@@ -11,6 +11,7 @@
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Enums\Feature;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Support\Models\ValidationResult as Result;
 
 use function count;
@@ -102,12 +103,12 @@ public function check_documentation_site_has_an_index_page(Result $result): Resu
 
     public function check_site_has_an_app_css_stylesheet(Result $result): Result
     {
-        if (file_exists(Hyde::siteMediaPath('/app.css')) || file_exists(Hyde::mediaPath('app.css'))) {
+        if (file_exists(MediaFile::outputPath('/app.css')) || file_exists(MediaFile::sourcePath('app.css'))) {
             return $result->pass('Your site has an app.css stylesheet');
         }
 
         return $result->fail(sprintf('Could not find an app.css file in the %s or %s directory!',
-            Hyde::pathToRelative(Hyde::siteMediaPath()), Hyde::getMediaDirectory()
+            Hyde::pathToRelative(MediaFile::outputPath()), Hyde::getMediaDirectory()
         ))->withTip('You may need to run `npm run dev`.`');
     }
 
diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 0be01b45c22..86bc2c76479 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -263,20 +263,20 @@ public function testHelperForDocumentationPages()
 
     public function testHelperForMediaPath()
     {
-        $this->assertSame(Hyde::path('_media'), Hyde::mediaPath());
-        $this->assertSame(MediaFile::sourcePath(), Hyde::mediaPath());
+        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
+        $this->assertSame(MediaFile::sourcePath(), MediaFile::sourcePath());
 
-        $this->assertSame(Hyde::path('_media/foo.png'), Hyde::mediaPath('foo.png'));
-        $this->assertSame(MediaFile::sourcePath('foo.png'), Hyde::mediaPath('foo.png'));
+        $this->assertSame(Hyde::path('_media/foo.png'), MediaFile::sourcePath('foo.png'));
+        $this->assertSame(MediaFile::sourcePath('foo.png'), MediaFile::sourcePath('foo.png'));
     }
 
     public function testHelperForMediaOutputPath()
     {
-        $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
-        $this->assertSame(MediaFile::outputPath(), Hyde::siteMediaPath());
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
+        $this->assertSame(MediaFile::outputPath(), MediaFile::outputPath());
 
-        $this->assertSame(Hyde::path('_site/media/foo.png'), Hyde::siteMediaPath('foo.png'));
-        $this->assertSame(MediaFile::outputPath('foo.png'), Hyde::siteMediaPath('foo.png'));
+        $this->assertSame(Hyde::path('_site/media/foo.png'), MediaFile::outputPath('foo.png'));
+        $this->assertSame(MediaFile::outputPath('foo.png'), MediaFile::outputPath('foo.png'));
     }
 
     public function testHelperForSiteOutputPath()
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index bd22206502d..9ff8799dd06 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -13,6 +13,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Enums\Feature;
 use Hyde\Foundation\Kernel\Filesystem;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\HydeServiceProvider;
 use Hyde\Hyde;
 use Hyde\Pages\BladePage;
@@ -262,9 +263,9 @@ public function testFluentModelSourcePathHelpers()
         $this->assertSame(Hyde::path('_pages'), MarkdownPage::path());
         $this->assertSame(Hyde::path('_docs'), DocumentationPage::path());
 
-        $this->assertSame(Hyde::path('_media'), Hyde::mediaPath());
+        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
         $this->assertSame(Hyde::path('_site'), Hyde::sitePath());
-        $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
     }
 
     public function testPathToRelativeHelperReturnsRelativePathForGivenPath()
@@ -395,7 +396,7 @@ public function testCanGetSiteMediaOutputDirectory()
     {
         // Todo: Move to MediaFileTest
 
-        $this->assertSame(Hyde::path('_site/media'), Hyde::siteMediaPath());
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
     }
 
     public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
@@ -403,7 +404,7 @@ public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDi
         // Todo: Move to MediaFileTest
 
         Hyde::setMediaDirectory('_foo');
-        $this->assertSame(Hyde::path('_site/foo'), Hyde::siteMediaPath());
+        $this->assertSame(Hyde::path('_site/foo'), MediaFile::outputPath());
     }
 
     public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
@@ -413,7 +414,7 @@ public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory
         Hyde::setOutputDirectory(Hyde::path('foo'));
         Hyde::setMediaDirectory('bar');
 
-        $this->assertSame(Hyde::path('foo/bar'), Hyde::siteMediaPath());
+        $this->assertSame(Hyde::path('foo/bar'), MediaFile::outputPath());
     }
 
     public function testMediaOutputDirectoryCanBeChangedInConfiguration()

From 74059a5cd81546649f58859c38ed9d0d28e521a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 17:10:58 +0200
Subject: [PATCH 2880/4023] Remove inconsistent infix from internal helper
 methods

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index fbf6f04ea9b..3ed834e7562 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -34,7 +34,7 @@ class MediaFile extends ProjectFile
     /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
     public static function all(): array
     {
-        return static::discoverMediaAssetFiles();
+        return static::discoverMediaFiles();
     }
 
     /** @return array<string> Array of filenames relative to the _media/ directory */
@@ -123,16 +123,16 @@ public function getMimeType(): string
         return 'text/plain';
     }
 
-    protected static function discoverMediaAssetFiles(): array
+    protected static function discoverMediaFiles(): array
     {
-        return collect(static::getMediaAssetFiles())->mapWithKeys(function (string $path): array {
+        return collect(static::getMediaFiles())->mapWithKeys(function (string $path): array {
             $file = static::make($path);
 
             return [$file->getIdentifier() => $file];
         })->all();
     }
 
-    protected static function getMediaAssetFiles(): array
+    protected static function getMediaFiles(): array
     {
         return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
     }

From 678b6f75c1c4fd60d989d2642e4f34aecae97d07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 17:12:30 +0200
Subject: [PATCH 2881/4023] Reapply "Ignore class from code coverage"

This reverts commit 2004a4e67e8fd80b20ffb4f96d6dd177bf26b773.
---
 packages/framework/src/Support/V1Compatibility.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
index 863734b99cd..3d8f5b5cd0c 100644
--- a/packages/framework/src/Support/V1Compatibility.php
+++ b/packages/framework/src/Support/V1Compatibility.php
@@ -11,6 +11,8 @@
  * @internal Hyde Facade support to aid in the v1 to v2 transition.
  *
  * @deprecated All code here is deprecated, and exists to help you transition.
+ *
+ * @codeCoverageIgnore This class is ignored from code coverage.
  */
 trait V1Compatibility
 {

From 46473331102f32baf8d6b5d0b374c084c1b6dda5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 18:32:38 +0200
Subject: [PATCH 2882/4023] Move the tests to the new code location

---
 .../tests/Feature/HydeKernelTest.php          | 25 -------------------
 .../tests/Unit/Support/MediaFileTest.php      | 19 ++++++++++++++
 2 files changed, 19 insertions(+), 25 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 9ff8799dd06..b12a5ea19bb 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -392,31 +392,6 @@ public function testGetMediaOutputDirectoryNameUsesTrimmedVersionOfMediaSourceDi
         $this->assertSame('foo', Hyde::getMediaOutputDirectory());
     }
 
-    public function testCanGetSiteMediaOutputDirectory()
-    {
-        // Todo: Move to MediaFileTest
-
-        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
-    }
-
-    public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
-    {
-        // Todo: Move to MediaFileTest
-
-        Hyde::setMediaDirectory('_foo');
-        $this->assertSame(Hyde::path('_site/foo'), MediaFile::outputPath());
-    }
-
-    public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
-    {
-        // Todo: Move to MediaFileTest
-
-        Hyde::setOutputDirectory(Hyde::path('foo'));
-        Hyde::setMediaDirectory('bar');
-
-        $this->assertSame(Hyde::path('foo/bar'), MediaFile::outputPath());
-    }
-
     public function testMediaOutputDirectoryCanBeChangedInConfiguration()
     {
         $this->assertSame('_media', Hyde::getMediaDirectory());
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 86969b4d3ab..44ded0474c5 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -241,4 +241,23 @@ public function testGetMediaOutputPathReturnsAbsolutePath()
     {
         $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
     }
+
+    public function testCanGetSiteMediaOutputDirectory()
+    {
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
+    }
+
+    public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
+    {
+        Hyde::setMediaDirectory('_foo');
+        $this->assertSame(Hyde::path('_site/foo'), MediaFile::outputPath());
+    }
+
+    public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
+    {
+        Hyde::setOutputDirectory(Hyde::path('foo'));
+        Hyde::setMediaDirectory('bar');
+
+        $this->assertSame(Hyde::path('foo/bar'), MediaFile::outputPath());
+    }
 }

From a130f0321f44f3df2870ae25e748a863a15db7f5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 18:55:14 +0200
Subject: [PATCH 2883/4023] Deprecate the `preferQualifiedUrl` parameter in the
 asset helper

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 3 ++-
 packages/framework/src/helpers.php                      | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index e127cdfaa82..ab6866a6600 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -8,6 +8,7 @@
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
+use JetBrains\PhpStorm\Deprecated;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -109,7 +110,7 @@ public function mediaLink(string $destination, bool $validate = false): string
      * If true is passed as the second argument, and a base URL is set,
      * the image will be returned with a qualified absolute URL.
      */
-    public function asset(string $name, bool $preferQualifiedUrl = false): string
+    public function asset(string $name, #[Deprecated(reason: 'This will be enabled automatically when a site URL is set')] bool $preferQualifiedUrl = false): string
     {
         if (static::isRemote($name)) {
             return $name;
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 34e8f9da12b..54f689619d3 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -4,6 +4,7 @@
 
 namespace {
     use Hyde\Foundation\HydeKernel;
+    use JetBrains\PhpStorm\Deprecated;
 
     if (! function_exists('hyde')) {
         /**
@@ -22,7 +23,7 @@ function hyde(): HydeKernel
             /**
              * Get a relative link or URL to an asset in the media directory.
              */
-            function asset(string $name, bool $preferQualifiedUrl = false): string
+            function asset(string $name, #[Deprecated(reason: 'This will be enabled automatically when a site URL is set')] bool $preferQualifiedUrl = false): string
             {
                 return hyde()->asset($name, $preferQualifiedUrl);
             }

From 54f8f0314aca05f27b5d83482318ff9a5ec0685c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 20:01:18 +0200
Subject: [PATCH 2884/4023] No longer use the `preferQualifiedUrl` parameter

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index ab6866a6600..04dedf77f6a 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -118,7 +118,7 @@ public function asset(string $name, #[Deprecated(reason: 'This will be enabled a
 
         $name = Str::start($name, "{$this->kernel->getMediaOutputDirectory()}/");
 
-        if ($preferQualifiedUrl && $this->hasSiteUrl()) {
+        if ($this->hasSiteUrl()) {
             return $this->url($name);
         }
 

From 7f773b30deefb8803c9c8e119a1a01d686adc00b Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Fri, 26 Jul 2024 18:11:31 +0000
Subject: [PATCH 2885/4023] Remove the `preferQualifiedUrl` parameter

---
 .../hyde-kernel-hyperlink-methods.md          |  4 ++--
 docs/architecture-concepts/the-hydekernel.md  |  2 +-
 .../Concerns/ForwardsHyperlinks.php           |  4 ++--
 .../src/Foundation/Kernel/Hyperlinks.php      |  6 ++----
 packages/framework/src/Hyde.php               |  2 +-
 packages/framework/src/helpers.php            |  5 ++---
 .../Feature/Foundation/HyperlinksTest.php     | 20 +++++++++----------
 .../framework/tests/Feature/HelpersTest.php   | 18 ++++++++---------
 8 files changed, 29 insertions(+), 32 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
index 1dceb9c542d..bd8d609104b 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-02-25 19:02:29 in 0.09ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-26 18:20:22 in 0.13ms -->
 
 #### `formatLink()`
 
@@ -32,7 +32,7 @@ Hyde::mediaLink(string $destination, bool $validate): string
 No description provided.
 
 ```php
-Hyde::asset(string $name, bool $preferQualifiedUrl): string
+Hyde::asset(string $name): string
 ```
 
 #### `url()`
diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index c9c9bf2577a..b4c3dab6dbf 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -218,7 +218,7 @@ Hyde::mediaLink(string $destination, bool $validate): string
 No description provided.
 
 ```php
-Hyde::asset(string $name, bool $preferQualifiedUrl): string
+Hyde::asset(string $name): string
 ```
 
 #### `url()`
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 9d194fd5f42..d797c3cd983 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -28,9 +28,9 @@ public function mediaLink(string $destination, bool $validate = false): string
         return $this->hyperlinks->mediaLink($destination, $validate);
     }
 
-    public function asset(string $name, bool $preferQualifiedUrl = false): string
+    public function asset(string $name): string
     {
-        return $this->hyperlinks->asset($name, $preferQualifiedUrl);
+        return $this->hyperlinks->asset($name);
     }
 
     public function url(string $path = ''): string
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 04dedf77f6a..e32b7af793f 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -8,7 +8,6 @@
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
-use JetBrains\PhpStorm\Deprecated;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -107,10 +106,9 @@ public function mediaLink(string $destination, bool $validate = false): string
      * Gets a relative web link to the given image stored in the _site/media folder.
      * If the image is remote (starts with http) it will be returned as is.
      *
-     * If true is passed as the second argument, and a base URL is set,
-     * the image will be returned with a qualified absolute URL.
+     * If a base URL is set, the image will be returned with a qualified absolute URL.
      */
-    public function asset(string $name, #[Deprecated(reason: 'This will be enabled automatically when a site URL is set')] bool $preferQualifiedUrl = false): string
+    public function asset(string $name): string
     {
         if (static::isRemote($name)) {
             return $name;
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 9590fb6133a..9cfb7841a6e 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -37,7 +37,7 @@
  * @method static string formatLink(string $destination)
  * @method static string relativeLink(string $destination)
  * @method static string mediaLink(string $destination, bool $validate = false)
- * @method static string asset(string $name, bool $preferQualifiedUrl = false)
+ * @method static string asset(string $name)
  * @method static string url(string $path = '')
  * @method static Route|null route(string $key)
  * @method static string makeTitle(string $value)
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 54f689619d3..2f7cc48e1b1 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -4,7 +4,6 @@
 
 namespace {
     use Hyde\Foundation\HydeKernel;
-    use JetBrains\PhpStorm\Deprecated;
 
     if (! function_exists('hyde')) {
         /**
@@ -23,9 +22,9 @@ function hyde(): HydeKernel
             /**
              * Get a relative link or URL to an asset in the media directory.
              */
-            function asset(string $name, #[Deprecated(reason: 'This will be enabled automatically when a site URL is set')] bool $preferQualifiedUrl = false): string
+            function asset(string $name): string
             {
-                return hyde()->asset($name, $preferQualifiedUrl);
+                return hyde()->asset($name);
             }
         }
 
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 3234e7cdcee..64f26c4f098 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -54,32 +54,32 @@ public function testAssetHelperResolvesPathsForNestedPages()
         }
     }
 
-    public function testAssetHelperReturnsQualifiedAbsoluteUriWhenRequestedAndSiteHasBaseUrl()
+    public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()
     {
         config(['hyde.url' => 'https://example.org']);
-        $this->assertSame('https://example.org/media/test.jpg', $this->class->asset('test.jpg', true));
+        $this->assertSame('https://example.org/media/test.jpg', $this->class->asset('test.jpg'));
     }
 
-    public function testAssetHelperReturnsDefaultRelativePathWhenQualifiedAbsoluteUriIsRequestedButSiteHasNoBaseUrl()
+    public function testAssetHelperReturnsDefaultRelativePathWhenSiteHasNoBaseUrl()
     {
         $this->withoutSiteUrl();
-        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg', true));
+        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
     }
 
-    public function testAssetHelperReturnsDefaultRelativePathWhenQualifiedAbsoluteUriIsRequestedButSiteBaseUrlIsLocalhost()
+    public function testAssetHelperReturnsDefaultRelativePathWhenSiteBaseUrlIsLocalhost()
     {
-        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg', true));
+        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
     }
 
-    public function testAssetHelperReturnsInputWhenQualifiedAbsoluteUriIsRequestedButImageIsAlreadyQualified()
+    public function testAssetHelperReturnsInputWhenImageIsAlreadyQualified()
     {
-        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg', true));
+        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
     }
 
-    public function testAssetHelperReturnsInputWhenQualifiedAbsoluteUriIsRequestedButImageIsAlreadyQualifiedRegardlessOfMatchingTheConfiguredUrl()
+    public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardlessOfMatchingTheConfiguredUrl()
     {
         config(['hyde.url' => 'https://example.org']);
-        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg', true));
+        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
     }
 
     public function testAssetHelperUsesConfiguredMediaDirectory()
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 300342e4735..86e49902513 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -77,36 +77,36 @@ public function testAssetFunction()
     /** @covers ::asset */
     public function testAssetFunctionWithQualifiedUrl()
     {
-        $this->assertSame(Hyde::asset('foo', true), asset('foo', true));
-        $this->assertSame('media/foo', asset('foo', true));
+        $this->assertSame(Hyde::asset('foo', true), asset('foo'));
+        $this->assertSame('media/foo', asset('foo'));
     }
 
     /** @covers ::asset */
-    public function testAssetFunctionWithQualifiedUrlAndSetBaseUrl()
+    public function testAssetFunctionWithSetBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => 'https://example.com']);
-        $this->assertSame('https://example.com/media/foo', asset('foo', true));
+        $this->assertSame('https://example.com/media/foo', asset('foo'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithExternalUrl()
     {
         $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
-        $this->assertSame('https://example.com/foo', asset('https://example.com/foo', true));
+        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
     }
 
     /** @covers ::asset */
-    public function testAssetFunctionWithQualifiedUrlAndNoBaseUrl()
+    public function testAssetFunctionWithNoBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => null]);
-        $this->assertSame('media/foo', asset('foo', true));
+        $this->assertSame('media/foo', asset('foo'));
     }
 
     /** @covers ::asset */
-    public function testAssetFunctionWithQualifiedUrlAndLocalhostBaseUrl()
+    public function testAssetFunctionWithLocalhostBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => 'http://localhost']);
-        $this->assertSame('media/foo', asset('foo', true));
+        $this->assertSame('media/foo', asset('foo'));
     }
 
     /** @covers ::asset */

From 4fa420c8b1527c66b9297b0cb1d4a4bab28a15f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 20:19:39 +0200
Subject: [PATCH 2886/4023] Reorder to group tests

---
 packages/framework/tests/Feature/HelpersTest.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 86e49902513..3b70f847262 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -82,17 +82,17 @@ public function testAssetFunctionWithQualifiedUrl()
     }
 
     /** @covers ::asset */
-    public function testAssetFunctionWithSetBaseUrl()
+    public function testAssetFunctionWithExternalUrl()
     {
-        $this->app['config']->set(['hyde.url' => 'https://example.com']);
-        $this->assertSame('https://example.com/media/foo', asset('foo'));
+        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
+        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
     }
 
     /** @covers ::asset */
-    public function testAssetFunctionWithExternalUrl()
+    public function testAssetFunctionWithSetBaseUrl()
     {
-        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
-        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
+        $this->app['config']->set(['hyde.url' => 'https://example.com']);
+        $this->assertSame('https://example.com/media/foo', asset('foo'));
     }
 
     /** @covers ::asset */

From b26bb18a7f36c49f0d8ee293f4b7ce84dd141e21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 20:31:16 +0200
Subject: [PATCH 2887/4023] Improve and normalize method documentation

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 6 +++---
 packages/framework/src/helpers.php                      | 5 ++++-
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index e32b7af793f..6f6c83a486f 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -103,10 +103,10 @@ public function mediaLink(string $destination, bool $validate = false): string
     }
 
     /**
-     * Gets a relative web link to the given image stored in the _site/media folder.
-     * If the image is remote (starts with http) it will be returned as is.
+     * Gets a relative web link to the given file stored in the `_site/media` folder.
+     * If the image is already qualified (starts with `http`) it will be returned as is.
      *
-     * If a base URL is set, the image will be returned with a qualified absolute URL.
+     * If a base URL is configured, the image will be returned with a qualified absolute URL.
      */
     public function asset(string $name): string
     {
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 2f7cc48e1b1..dda130bf3b2 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -20,7 +20,10 @@ function hyde(): HydeKernel
     } else {
         if (! function_exists('asset')) {
             /**
-             * Get a relative link or URL to an asset in the media directory.
+             * Gets a relative web link to the given file stored in the `_site/media` folder.
+             * If the image is already qualified (starts with `http`) it will be returned as is.
+             *
+             * If a base URL is configured, the image will be returned with a qualified absolute URL.
              */
             function asset(string $name): string
             {

From 82c7600bbe3e4941733204f664c2117b68fd7c36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 20:37:34 +0200
Subject: [PATCH 2888/4023] Add an alias method for asset retrieval to the
 facade

---
 packages/framework/src/Facades/Asset.php                     | 5 +++++
 .../framework/tests/Unit/Facades/AssetFacadeUnitTest.php     | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 45e16a0a881..11090959480 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -18,6 +18,11 @@
  */
 class Asset
 {
+    public static function get(string $file): string
+    {
+        return Hyde::asset($file);
+    }
+
     public static function mediaLink(string $file): string
     {
         return Hyde::mediaLink($file).static::getCacheBustKey($file);
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index a004e805399..5c43956cbcf 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -31,6 +31,11 @@ protected function tearDown(): void
         $this->cleanUpFilesystem();
     }
 
+    public function testGetHelper()
+    {
+        $this->assertSame(Hyde::asset('foo'), Asset::get('foo'));
+    }
+
     public function testHasMediaFileHelper()
     {
         $this->assertFalse(Asset::hasMediaFile('styles.css'));

From d47b220a39239d13bffb1ab8a64814180b4b2978 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 21:19:33 +0200
Subject: [PATCH 2889/4023] Reword cache busting option documentation to be
 more general

---
 config/hyde.php                    | 10 ++++------
 packages/framework/config/hyde.php | 10 ++++------
 2 files changed, 8 insertions(+), 12 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index 87f5481d00e..e601ff0a912 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -355,14 +355,12 @@
     | Cache Busting
     |--------------------------------------------------------------------------
     |
-    | Any assets loaded using the Asset::mediaLink() helper will automatically
-    | have a cache busting query string appended to the URL. This is useful
+    | Any assets loaded using the Hyde Asset helpers will automatically have
+    | a "cache busting" query string appended to the URL. This is useful
     | when you want to force browsers to load a new version of an asset.
+    | All included Blade templates use this feature to load assets.
     |
-    | The mediaLink helper is used in the built-in views to load the
-    | default stylesheets and scripts, and thus use this feature.
-    |
-    | To disable cache busting, set this setting to false.
+    | To disable the cache busting, set this setting to false.
     |
     */
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 87f5481d00e..e601ff0a912 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -355,14 +355,12 @@
     | Cache Busting
     |--------------------------------------------------------------------------
     |
-    | Any assets loaded using the Asset::mediaLink() helper will automatically
-    | have a cache busting query string appended to the URL. This is useful
+    | Any assets loaded using the Hyde Asset helpers will automatically have
+    | a "cache busting" query string appended to the URL. This is useful
     | when you want to force browsers to load a new version of an asset.
+    | All included Blade templates use this feature to load assets.
     |
-    | The mediaLink helper is used in the built-in views to load the
-    | default stylesheets and scripts, and thus use this feature.
-    |
-    | To disable cache busting, set this setting to false.
+    | To disable the cache busting, set this setting to false.
     |
     */
 

From d1d23773469254a81c5b3669c591201739c2c775 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:17:02 +0200
Subject: [PATCH 2890/4023] Copy cache busting key generator to new location

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3ed834e7562..ec4cf21110f 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -143,4 +143,11 @@ protected static function getMediaGlobPattern(): string
             Config::getArray('hyde.media_extensions', self::EXTENSIONS)
         ));
     }
+
+    protected static function getCacheBustKey(string $file): string
+    {
+        return Config::getBool('hyde.enable_cache_busting', true)
+            ? '?v='.md5_file(MediaFile::sourcePath("$file"))
+            : '';
+    }
 }

From 44e1b1a5b108ddd6414d9852eca9b84e85387689 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:19:02 +0200
Subject: [PATCH 2891/4023] Temporarily make the protected method public
 internal

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index ec4cf21110f..d52ea12ac95 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -144,7 +144,8 @@ protected static function getMediaGlobPattern(): string
         ));
     }
 
-    protected static function getCacheBustKey(string $file): string
+    /** @internal */
+    public static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
             ? '?v='.md5_file(MediaFile::sourcePath("$file"))

From 97718a587d9a089928bc1009146deaf94ba8d4b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:30:20 +0200
Subject: [PATCH 2892/4023] Use the new logic location

---
 packages/framework/src/Facades/Asset.php | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 11090959480..e531b84b148 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -7,7 +7,6 @@
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 
-use function md5_file;
 use function file_exists;
 
 /**
@@ -35,8 +34,6 @@ public static function hasMediaFile(string $file): bool
 
     protected static function getCacheBustKey(string $file): string
     {
-        return Config::getBool('hyde.enable_cache_busting', true)
-            ? '?v='.md5_file(MediaFile::sourcePath("$file"))
-            : '';
+        return MediaFile::getCacheBustKey($file);
     }
 }

From 0bd90cbb85c04e92909bba7f17d6eccb3c20ce1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:31:57 +0200
Subject: [PATCH 2893/4023] Inline simplified helper method

---
 packages/framework/src/Facades/Asset.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index e531b84b148..c823dcea40a 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -24,16 +24,11 @@ public static function get(string $file): string
 
     public static function mediaLink(string $file): string
     {
-        return Hyde::mediaLink($file).static::getCacheBustKey($file);
+        return Hyde::mediaLink($file).MediaFile::getCacheBustKey($file);
     }
 
     public static function hasMediaFile(string $file): bool
     {
         return file_exists(MediaFile::sourcePath($file));
     }
-
-    protected static function getCacheBustKey(string $file): string
-    {
-        return MediaFile::getCacheBustKey($file);
-    }
 }

From 244a22e73677323c2c7fa34e35c681c6f80e7e5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:37:36 +0200
Subject: [PATCH 2894/4023] Call the kernel methods directly

Makes the refactor easier as I can click to get to the code location
---
 packages/framework/src/Facades/Asset.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index c823dcea40a..4e4d7a4ae89 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -4,9 +4,9 @@
 
 namespace Hyde\Facades;
 
-use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 
+use function hyde;
 use function file_exists;
 
 /**
@@ -19,12 +19,12 @@ class Asset
 {
     public static function get(string $file): string
     {
-        return Hyde::asset($file);
+        return hyde()->asset($file);
     }
 
     public static function mediaLink(string $file): string
     {
-        return Hyde::mediaLink($file).MediaFile::getCacheBustKey($file);
+        return hyde()->mediaLink($file).MediaFile::getCacheBustKey($file);
     }
 
     public static function hasMediaFile(string $file): bool

From e57e9af3deee1c8da8b0d6431d533a6888b9fbd0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:41:43 +0200
Subject: [PATCH 2895/4023] Check that the file exists before trying to hash it

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index d52ea12ac95..fd459995f9f 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -147,7 +147,7 @@ protected static function getMediaGlobPattern(): string
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {
-        return Config::getBool('hyde.enable_cache_busting', true)
+        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(MediaFile::sourcePath("$file"))
             ? '?v='.md5_file(MediaFile::sourcePath("$file"))
             : '';
     }

From 41416b4f7e523f17bec241f4ff871de16dc2ad11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:39:42 +0200
Subject: [PATCH 2896/4023] Move cache busting to root media link method
 implementation

---
 packages/framework/src/Facades/Asset.php                       | 2 +-
 packages/framework/src/Foundation/Kernel/Hyperlinks.php        | 3 ++-
 packages/framework/tests/Feature/Foundation/HyperlinksTest.php | 2 +-
 .../framework/tests/Feature/Services/RssFeedServiceTest.php    | 2 ++
 4 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 4e4d7a4ae89..d014d1e5ad6 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -24,7 +24,7 @@ public static function get(string $file): string
 
     public static function mediaLink(string $file): string
     {
-        return hyde()->mediaLink($file).MediaFile::getCacheBustKey($file);
+        return hyde()->mediaLink($file);
     }
 
     public static function hasMediaFile(string $file): bool
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 6f6c83a486f..b4e43028049 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -8,6 +8,7 @@
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -99,7 +100,7 @@ public function mediaLink(string $destination, bool $validate = false): string
             throw new FileNotFoundException($sourcePath);
         }
 
-        return $this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination");
+        return $this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination").MediaFile::getCacheBustKey($destination);
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 64f26c4f098..9a7893a0d6a 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -108,7 +108,7 @@ public function testMediaLinkHelperUsesConfiguredMediaDirectory()
     public function testMediaLinkHelperWithValidationAndExistingFile()
     {
         $this->file('_media/foo');
-        $this->assertSame('media/foo', $this->class->mediaLink('foo', true));
+        $this->assertSame('media/foo?v=d41d8cd98f00b204e9800998ecf8427e', $this->class->mediaLink('foo', true));
     }
 
     public function testMediaLinkHelperWithValidationAndNonExistingFile()
diff --git a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
index e8ca9f8d518..96b9b9afcf9 100644
--- a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
+++ b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
@@ -86,6 +86,8 @@ public function testXmlChannelDataCanBeCustomized()
 
     public function testMarkdownBlogPostsAreAddedToRssFeedThroughAutodiscovery()
     {
+        config(['hyde.enable_cache_busting' => false]);
+
         file_put_contents(Hyde::path('_posts/rss.md'), <<<'MD'
             ---
             title: RSS

From 3b57fe82885d79c4456efea80208a4e27f07e2b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 11:57:21 +0200
Subject: [PATCH 2897/4023] Apply cache busting to the asset helper

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index b4e43028049..f6a15e7fb1e 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -118,10 +118,10 @@ public function asset(string $name): string
         $name = Str::start($name, "{$this->kernel->getMediaOutputDirectory()}/");
 
         if ($this->hasSiteUrl()) {
-            return $this->url($name);
+            return $this->url($name).MediaFile::getCacheBustKey($name);
         }
 
-        return $this->relativeLink($name);
+        return $this->relativeLink($name).MediaFile::getCacheBustKey($name);
     }
 
     /**

From d8cb4e4a6de831274412b14e3a2952b1f7855d73 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 15:25:29 +0200
Subject: [PATCH 2898/4023] Extract helper method to perform cache busting

---
 .../framework/src/Foundation/Kernel/Hyperlinks.php | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index f6a15e7fb1e..9fc377a9a9f 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -100,7 +100,7 @@ public function mediaLink(string $destination, bool $validate = false): string
             throw new FileNotFoundException($sourcePath);
         }
 
-        return $this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination").MediaFile::getCacheBustKey($destination);
+        return $this->withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
     }
 
     /**
@@ -118,10 +118,10 @@ public function asset(string $name): string
         $name = Str::start($name, "{$this->kernel->getMediaOutputDirectory()}/");
 
         if ($this->hasSiteUrl()) {
-            return $this->url($name).MediaFile::getCacheBustKey($name);
+            return $this->withCacheBusting($this->url($name), $name);
         }
 
-        return $this->relativeLink($name).MediaFile::getCacheBustKey($name);
+        return $this->withCacheBusting($this->relativeLink($name), $name);
     }
 
     /**
@@ -181,4 +181,12 @@ public static function isRemote(string $url): bool
     {
         return str_starts_with($url, 'http') || str_starts_with($url, '//');
     }
+
+    /**
+     * Apply cache to the URL if enabled in the configuration.
+     */
+    protected function withCacheBusting(string $url, string $file): string
+    {
+        return $url.MediaFile::getCacheBustKey($file);
+    }
 }

From f6b83824259222999d6ab1ff55c413b4677962f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 13:01:12 +0200
Subject: [PATCH 2899/4023] Create discovery benchmark

---
 .../tests/Unit/Support/MediaFileTest.php      | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 44ded0474c5..aa6d4124eb9 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -26,6 +26,43 @@ protected function tearDown(): void
         $this->cleanUpFilesystem();
     }
 
+    /** @deprecated */
+    public function testDiscoveryBenchmark()
+    {
+        $this->markTestSkipped('Uncomment this line to run the benchmark.');
+
+        $urls = [
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/austria.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/boat.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/croatia.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/fireworks.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/hallstatt.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/lemonade.jpg',
+            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/photographer.jpg',
+        ];
+
+        foreach ($urls as $url) {
+            $this->file('_media/'.basename($url), file_get_contents($url));
+        }
+
+        $this->file('_media/foo.css', 'body { color: red; }');
+        $this->file('_media/foo.js', 'console.log("Hello, World!");');
+        $this->file('_media/nested/foo.css', 'foo');
+        $this->file('_media/empty.css', '');
+        $this->file('_media/ignored', 'ignored');
+        $this->directory('_media/empty');
+        $this->file('_media/large.css', str_repeat('a', 1024 * 1024 * 10)); // 10 MB
+
+        // Warm up the classloader / cache
+        echo 'Warmup: '.\Illuminate\Support\Benchmark::measure(function () {
+            MediaFile::all();
+        })."ms\n";
+
+        echo 'Benchmark: '.\Illuminate\Support\Benchmark::measure(function () {
+            MediaFile::all();
+        }, 1000)."ms avg/1000/its\n";
+    }
+
     public function testCanConstruct()
     {
         $file = new MediaFile('foo');

From 1068d767fad87ad6ebe257ea4299416d0c7fb87d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 18:31:50 +0200
Subject: [PATCH 2900/4023] Create HasMediaFiles.php

---
 .../src/Foundation/Concerns/HasMediaFiles.php     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/src/Foundation/Concerns/HasMediaFiles.php

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
new file mode 100644
index 00000000000..a0c11c9747c
--- /dev/null
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Foundation\Concerns;
+
+/**
+ * @internal Single-use trait for the Filesystem class.
+ *
+ * @see \Hyde\Foundation\Kernel\Filesystem
+ */
+trait HasMediaFiles
+{
+    //
+}

From 1fc20f23a181474b33646b916393aa37e1c99b02 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 18:32:15 +0200
Subject: [PATCH 2901/4023] Use HasMediaFiles

---
 packages/framework/src/Foundation/Kernel/Filesystem.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Foundation/Kernel/Filesystem.php b/packages/framework/src/Foundation/Kernel/Filesystem.php
index 8f3bb2fd2aa..345f6caa524 100644
--- a/packages/framework/src/Foundation/Kernel/Filesystem.php
+++ b/packages/framework/src/Foundation/Kernel/Filesystem.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\PharSupport;
+use Hyde\Foundation\Concerns\HasMediaFiles;
 use Illuminate\Support\Collection;
 
 use function collect;
@@ -29,6 +30,8 @@
  */
 class Filesystem
 {
+    use HasMediaFiles;
+
     protected HydeKernel $kernel;
 
     public function __construct(HydeKernel $kernel)

From d30bbde7a756a673b3cebfa42edf3a01feaccd9b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 18:32:32 +0200
Subject: [PATCH 2902/4023] Test covers HasMediaFiles

---
 packages/framework/tests/Feature/Foundation/FilesystemTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 86bc2c76479..1b8e2c559b1 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -21,6 +21,7 @@
 /**
  * @covers \Hyde\Foundation\HydeKernel
  * @covers \Hyde\Foundation\Kernel\Filesystem
+ * @covers \Hyde\Foundation\Concerns\HasMediaFiles
  */
 class FilesystemTest extends UnitTestCase
 {

From a05cd8314f12d34800fcfc454fff750377a947f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 18:34:52 +0200
Subject: [PATCH 2903/4023] Annotate upcoming assets method

We'll see if we name this mediaFiles or assets
---
 .../hyde-pages-api/hyde-kernel-filesystem-methods.md   | 10 +++++++++-
 packages/framework/src/Hyde.php                        |  2 ++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index eb5983597e6..8da7c32a0e2 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2024-07-26 15:15:12 in 0.09ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-28 10:41:33 in 0.13ms -->
 
 #### `filesystem()`
 
@@ -51,6 +51,14 @@ No description provided.
 Hyde::pathToRelative(string $path): string
 ```
 
+#### `assets()`
+
+No description provided.
+
+```php
+Hyde::assets(): array
+```
+
 <!-- End generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
 
 </section>
diff --git a/packages/framework/src/Hyde.php b/packages/framework/src/Hyde.php
index 9cfb7841a6e..81b788108e9 100644
--- a/packages/framework/src/Hyde.php
+++ b/packages/framework/src/Hyde.php
@@ -9,6 +9,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Support\V1Compatibility;
 use Illuminate\Support\Collection;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Foundation\Kernel\FileCollection;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\Kernel\PageCollection;
@@ -37,6 +38,7 @@
  * @method static string formatLink(string $destination)
  * @method static string relativeLink(string $destination)
  * @method static string mediaLink(string $destination, bool $validate = false)
+ * @method static Collection<string, MediaFile> assets()
  * @method static string asset(string $name)
  * @method static string url(string $path = '')
  * @method static Route|null route(string $key)

From 772937eafcc595a61cdba336903f9267b7af5a31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 20:05:09 +0200
Subject: [PATCH 2904/4023] Add the assets array

---
 packages/framework/src/Foundation/Concerns/HasMediaFiles.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index a0c11c9747c..6c3d5a93cdc 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -11,5 +11,6 @@
  */
 trait HasMediaFiles
 {
-    //
+    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
+    protected array $assets = [];
 }

From e7a7fe0f6377f49307bdb998288e8012ad36cbf1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 20:06:55 +0200
Subject: [PATCH 2905/4023] Add the assets getter

---
 .../src/Foundation/Concerns/HasMediaFiles.php          | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index 6c3d5a93cdc..e5b556290b9 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -13,4 +13,14 @@ trait HasMediaFiles
 {
     /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
     protected array $assets = [];
+
+    /**
+     * Get all media files in the project.
+     *
+     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
+     */
+    public function assets(): array
+    {
+        return $this->assets;
+    }
 }

From 79a495f96c59599888a783379d7909030ce9e02d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 20:07:17 +0200
Subject: [PATCH 2906/4023] Uninitialize assets

---
 packages/framework/src/Foundation/Concerns/HasMediaFiles.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index e5b556290b9..f854165d52b 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -12,7 +12,7 @@
 trait HasMediaFiles
 {
     /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
-    protected array $assets = [];
+    protected array $assets;
 
     /**
      * Get all media files in the project.

From 8e288f6ab7fc52358ff3a202870845f4672eef1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 21:46:15 +0200
Subject: [PATCH 2907/4023] Coalesce assign the assets

---
 packages/framework/src/Foundation/Concerns/HasMediaFiles.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index f854165d52b..b589de6266e 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Hyde\Support\Filesystem\MediaFile;
+
 /**
  * @internal Single-use trait for the Filesystem class.
  *
@@ -21,6 +23,6 @@ trait HasMediaFiles
      */
     public function assets(): array
     {
-        return $this->assets;
+        return $this->assets ??= MediaFile::all();
     }
 }

From b82bfa8ced30df70781db7b8e2e8020d533f109c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 21:47:57 +0200
Subject: [PATCH 2908/4023] Forward assets

---
 .../framework/src/Foundation/Concerns/ForwardsFilesystem.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index cea06f5bbc2..19a2a835778 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -42,4 +42,9 @@ public function pathToRelative(string $path): string
     {
         return $this->filesystem->pathToRelative($path);
     }
+
+    public function assets(): array
+    {
+        return $this->filesystem->assets();
+    }
 }

From dda76c6bdaf9d3e2819abbb119629f425a2e85b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 27 Jul 2024 21:48:35 +0200
Subject: [PATCH 2909/4023] Move asset discovery to kernel filesystem

---
 .../src/Foundation/Concerns/HasMediaFiles.php | 30 ++++++++++++++++++-
 .../src/Support/Filesystem/MediaFile.php      | 27 +----------------
 2 files changed, 30 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index b589de6266e..5a3d0be4558 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -4,8 +4,15 @@
 
 namespace Hyde\Foundation\Concerns;
 
+use Hyde\Hyde;
+use Hyde\Facades\Config;
 use Hyde\Support\Filesystem\MediaFile;
 
+use function implode;
+use function collect;
+use function sprintf;
+use function glob;
+
 /**
  * @internal Single-use trait for the Filesystem class.
  *
@@ -23,6 +30,27 @@ trait HasMediaFiles
      */
     public function assets(): array
     {
-        return $this->assets ??= MediaFile::all();
+        return $this->assets ??= static::discoverMediaFiles();
+    }
+
+    protected static function discoverMediaFiles(): array
+    {
+        return collect(static::getMediaFiles())->mapWithKeys(function (string $path): array {
+            $file = MediaFile::make($path);
+
+            return [$file->getIdentifier() => $file];
+        })->all();
+    }
+
+    protected static function getMediaFiles(): array
+    {
+        return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
+    }
+
+    protected static function getMediaGlobPattern(): string
+    {
+        return sprintf(Hyde::getMediaDirectory().'/{*,**/*,**/*/*}.{%s}', implode(',',
+            Config::getArray('hyde.media_extensions', MediaFile::EXTENSIONS)
+        ));
     }
 }
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index fd459995f9f..6c117d09893 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -16,12 +16,8 @@
 use function array_merge;
 use function array_keys;
 use function filesize;
-use function implode;
 use function pathinfo;
-use function collect;
 use function is_file;
-use function sprintf;
-use function glob;
 
 /**
  * File abstraction for a project media file.
@@ -34,7 +30,7 @@ class MediaFile extends ProjectFile
     /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
     public static function all(): array
     {
-        return static::discoverMediaFiles();
+        return Hyde::assets();
     }
 
     /** @return array<string> Array of filenames relative to the _media/ directory */
@@ -123,27 +119,6 @@ public function getMimeType(): string
         return 'text/plain';
     }
 
-    protected static function discoverMediaFiles(): array
-    {
-        return collect(static::getMediaFiles())->mapWithKeys(function (string $path): array {
-            $file = static::make($path);
-
-            return [$file->getIdentifier() => $file];
-        })->all();
-    }
-
-    protected static function getMediaFiles(): array
-    {
-        return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
-    }
-
-    protected static function getMediaGlobPattern(): string
-    {
-        return sprintf(Hyde::getMediaDirectory().'/{*,**/*,**/*/*}.{%s}', implode(',',
-            Config::getArray('hyde.media_extensions', self::EXTENSIONS)
-        ));
-    }
-
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {

From 15d430ebe4fc966f7809c4d0b167648ede02f7bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 12:46:40 +0200
Subject: [PATCH 2910/4023] Split out test setup from assertions

---
 .../framework/tests/Feature/DiscoveryServiceTest.php   | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/DiscoveryServiceTest.php b/packages/framework/tests/Feature/DiscoveryServiceTest.php
index e545cd64b7b..cdc3dc396cb 100644
--- a/packages/framework/tests/Feature/DiscoveryServiceTest.php
+++ b/packages/framework/tests/Feature/DiscoveryServiceTest.php
@@ -88,10 +88,12 @@ public function testGetMediaAssetFilesDiscoversFiles()
     {
         $testFiles = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
-        foreach ($testFiles as $fileType) {
-            $path = 'test.'.$fileType;
-            $this->file('_media/'.$path);
-            $this->assertContains($path, MediaFile::files());
+        foreach ($testFiles as $type) {
+            $this->file("_media/test.$type");
+        }
+
+        foreach ($testFiles as $type) {
+            $this->assertContains("test.$type", MediaFile::files());
         }
     }
 

From 1d12225e211a343f01f934ae11a47cfacaae6fa8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 12:46:43 +0200
Subject: [PATCH 2911/4023] Reboot to rediscover new files

---
 packages/framework/tests/Feature/DiscoveryServiceTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/DiscoveryServiceTest.php b/packages/framework/tests/Feature/DiscoveryServiceTest.php
index cdc3dc396cb..1cb508ac488 100644
--- a/packages/framework/tests/Feature/DiscoveryServiceTest.php
+++ b/packages/framework/tests/Feature/DiscoveryServiceTest.php
@@ -103,6 +103,8 @@ public function testGetMediaAssetFilesDiscoversCustomFileTypes()
         $this->file("_media/$path");
         $this->assertNotContains($path, MediaFile::files());
         self::mockConfig(['hyde.media_extensions' => ['custom']]);
+
+        $this->resetKernel(); // Reboot to rediscover new files
         $this->assertContains($path, MediaFile::files());
     }
 
@@ -133,6 +135,7 @@ public function testMediaAssetExtensionsCanBeAddedByCommaSeparatedValues()
         $this->assertSame([], MediaFile::files());
 
         self::mockConfig(['hyde.media_extensions' => ['1,2,3']]);
+        $this->resetKernel(); // Reboot to rediscover new files
         $this->assertSame(['test.1', 'test.2', 'test.3'], MediaFile::files());
     }
 
@@ -145,6 +148,7 @@ public function testMediaAssetExtensionsCanBeAddedByArray()
 
         $this->assertSame([], MediaFile::files());
         self::mockConfig(['hyde.media_extensions' => ['1', '2', '3']]);
+        $this->resetKernel(); // Reboot to rediscover new files
         $this->assertSame(['test.1', 'test.2', 'test.3'], MediaFile::files());
     }
 

From b0f3a89013855d1e4fa38a606a3869fc876591da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 13:17:53 +0200
Subject: [PATCH 2912/4023] Update assets to be stored as a Collection

Better matches other file collections
---
 .../hyde-kernel-filesystem-methods.md               |  4 ++--
 .../src/Foundation/Concerns/ForwardsFilesystem.php  |  3 ++-
 .../src/Foundation/Concerns/HasMediaFiles.php       | 13 +++++++------
 .../framework/src/Support/Filesystem/MediaFile.php  |  8 ++++----
 .../framework/tests/Unit/Support/MediaFileTest.php  |  4 ++--
 5 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index 8da7c32a0e2..55dfcdafe4b 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2024-07-28 10:41:33 in 0.13ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-28 11:20:12 in 0.11ms -->
 
 #### `filesystem()`
 
@@ -56,7 +56,7 @@ Hyde::pathToRelative(string $path): string
 No description provided.
 
 ```php
-Hyde::assets(): array
+Hyde::assets(): Illuminate\Support\Collection
 ```
 
 <!-- End generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index 19a2a835778..888f3abf4d0 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Concerns;
 
 use Hyde\Foundation\Kernel\Filesystem;
+use Illuminate\Support\Collection;
 
 /**
  * @internal Single-use trait for the HydeKernel class.
@@ -43,7 +44,7 @@ public function pathToRelative(string $path): string
         return $this->filesystem->pathToRelative($path);
     }
 
-    public function assets(): array
+    public function assets(): Collection
     {
         return $this->filesystem->assets();
     }
diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index 5a3d0be4558..3dff8db788d 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -7,6 +7,7 @@
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Hyde\Support\Filesystem\MediaFile;
+use Illuminate\Support\Collection;
 
 use function implode;
 use function collect;
@@ -20,26 +21,26 @@
  */
 trait HasMediaFiles
 {
-    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
-    protected array $assets;
+    /** @var Collection<string, \Hyde\Support\Filesystem\MediaFile> The Collection keys are the filenames relative to the _media/ directory */
+    protected Collection $assets;
 
     /**
      * Get all media files in the project.
      *
-     * @return array<string, \Hyde\Support\Filesystem\MediaFile>
+     * @return Collection<string, \Hyde\Support\Filesystem\MediaFile>
      */
-    public function assets(): array
+    public function assets(): Collection
     {
         return $this->assets ??= static::discoverMediaFiles();
     }
 
-    protected static function discoverMediaFiles(): array
+    protected static function discoverMediaFiles(): Collection
     {
         return collect(static::getMediaFiles())->mapWithKeys(function (string $path): array {
             $file = MediaFile::make($path);
 
             return [$file->getIdentifier() => $file];
-        })->all();
+        });
     }
 
     protected static function getMediaFiles(): array
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 6c117d09893..5457e18ba03 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Illuminate\Support\Collection;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -14,7 +15,6 @@
 use function extension_loaded;
 use function file_exists;
 use function array_merge;
-use function array_keys;
 use function filesize;
 use function pathinfo;
 use function is_file;
@@ -27,8 +27,8 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
-    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
-    public static function all(): array
+    /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
+    public static function all(): Collection
     {
         return Hyde::assets();
     }
@@ -36,7 +36,7 @@ public static function all(): array
     /** @return array<string> Array of filenames relative to the _media/ directory */
     public static function files(): array
     {
-        return array_keys(static::all());
+        return static::all()->keys()->all();
     }
 
     /**
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index aa6d4124eb9..16f9c1477f3 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -222,7 +222,7 @@ public function testAllHelperReturnsAllMediaFiles()
     {
         $this->assertEquals([
             'app.css' => new MediaFile('_media/app.css'),
-        ], MediaFile::all());
+        ], MediaFile::all()->all());
     }
 
     public function testAllHelperDoesNotIncludeNonMediaFiles()
@@ -231,7 +231,7 @@ public function testAllHelperDoesNotIncludeNonMediaFiles()
 
         $this->assertEquals([
             'app.css' => new MediaFile('_media/app.css'),
-        ], MediaFile::all());
+        ], MediaFile::all()->all());
     }
 
     public function testFilesHelperReturnsAllMediaFiles()

From 575ddbd36a819a0c9e64d4524f2bb5a09251ba25 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:19:50 +0200
Subject: [PATCH 2913/4023] Create kernel asset tests

---
 .../tests/Feature/HydeKernelTest.php          | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index b12a5ea19bb..d9a41c95983 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -204,6 +204,34 @@ public function testImageHelperSupportsCustomMediaDirectories()
         $this->assertSame('assets/foo.jpg', Hyde::asset('foo.jpg'));
     }
 
+    public function testAssetsHelperGetsAllSiteAssets()
+    {
+        $this->assertEquals(new Collection([
+            'app.css' => new MediaFile('_media/app.css'),
+        ]), Hyde::assets());
+    }
+
+    public function testAssetsHelperGetsAllSiteAssetsAsArray()
+    {
+        $assets = Hyde::assets()->toArray();
+
+        $assets['app.css']['length'] = 123;
+
+        $this->assertSame([
+            'app.css' => [
+                'name' => 'app.css',
+                'path' => '_media/app.css',
+                'length' => 123,
+                'mimeType' => 'text/css',
+            ],
+        ], $assets);
+    }
+
+    public function testAssetsHelperReturnsAssetCollectionSingleton()
+    {
+        $this->assertSame(Hyde::assets(), Hyde::assets());
+    }
+
     public function testRouteHelper()
     {
         $this->assertNotNull(Hyde::route('index'));

From c21db94b432f8fd28edf6bcf41f5e7b8541fd7bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:21:58 +0200
Subject: [PATCH 2914/4023] Move bulk tests to test for implementation

---
 .../Feature/Foundation/FilesystemTest.php     | 30 +++++++++++++++++++
 .../tests/Feature/HydeKernelTest.php          | 16 ----------
 2 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 1b8e2c559b1..01f7e83ac11 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature\Foundation;
 
 use Hyde\Foundation\HydeKernel;
+use Illuminate\Support\Collection;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Foundation\PharSupport;
 use Hyde\Hyde;
@@ -30,6 +31,7 @@ class FilesystemTest extends UnitTestCase
     protected Filesystem $filesystem;
 
     protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
 
     protected function setUp(): void
     {
@@ -355,4 +357,32 @@ public function testPathToRelativeHelperDoesNotModifyNonProjectPaths()
             $this->assertSame(normalize_slashes($testString), Hyde::pathToRelative($testString));
         }
     }
+
+    public function testAssetsMethodGetsAllSiteAssets()
+    {
+        $this->assertEquals(new Collection([
+            'app.css' => new MediaFile('_media/app.css'),
+        ]), $this->filesystem->assets());
+    }
+
+    public function testAssetsMethodGetsAllSiteAssetsAsArray()
+    {
+        $assets = $this->filesystem->assets()->toArray();
+
+        $assets['app.css']['length'] = 123;
+
+        $this->assertSame([
+            'app.css' => [
+                'name' => 'app.css',
+                'path' => '_media/app.css',
+                'length' => 123,
+                'mimeType' => 'text/css',
+            ],
+        ], $assets);
+    }
+
+    public function testAssetsMethodReturnsAssetCollectionSingleton()
+    {
+        $this->assertSame($this->filesystem->assets(), $this->filesystem->assets());
+    }
 }
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index d9a41c95983..f0dac45e3ba 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -211,22 +211,6 @@ public function testAssetsHelperGetsAllSiteAssets()
         ]), Hyde::assets());
     }
 
-    public function testAssetsHelperGetsAllSiteAssetsAsArray()
-    {
-        $assets = Hyde::assets()->toArray();
-
-        $assets['app.css']['length'] = 123;
-
-        $this->assertSame([
-            'app.css' => [
-                'name' => 'app.css',
-                'path' => '_media/app.css',
-                'length' => 123,
-                'mimeType' => 'text/css',
-            ],
-        ], $assets);
-    }
-
     public function testAssetsHelperReturnsAssetCollectionSingleton()
     {
         $this->assertSame(Hyde::assets(), Hyde::assets());

From 65ed8634ea71d504fa087192df02b71cb4cc7142 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:28:49 +0200
Subject: [PATCH 2915/4023] Claude: Create FilesystemHasMediaFilesTest.php

---
 .../FilesystemHasMediaFilesTest.php           | 162 ++++++++++++++++++
 1 file changed, 162 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
new file mode 100644
index 00000000000..0c993cce49e
--- /dev/null
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -0,0 +1,162 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Foundation;
+
+use Hyde\Foundation\Kernel\Filesystem;
+use Hyde\Hyde;
+use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Testing\UnitTestCase;
+use Illuminate\Support\Collection;
+use Mockery;
+
+/**
+ * @covers \Hyde\Foundation\Kernel\Filesystem
+ * @covers \Hyde\Foundation\Concerns\HasMediaFiles
+ */
+class FilesystemHasMediaFilesTest extends UnitTestCase
+{
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
+    protected Filesystem $filesystem;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->filesystem = new Filesystem(Hyde::getInstance());
+    }
+
+    public function testAssetsMethodReturnsSameInstanceOnSubsequentCalls()
+    {
+        $firstCall = $this->filesystem->assets();
+        $secondCall = $this->filesystem->assets();
+
+        $this->assertSame($firstCall, $secondCall);
+    }
+
+    public function testAssetsMethodReturnsEmptyCollectionWhenNoMediaFiles()
+    {
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [];
+        });
+
+        $assets = $this->filesystem->assets();
+
+        $this->assertInstanceOf(Collection::class, $assets);
+        $this->assertTrue($assets->isEmpty());
+    }
+
+    public function testAssetsMethodWithCustomMediaExtensions()
+    {
+        $this->app['config']->set('hyde.media_extensions', ['jpg', 'png']);
+
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [
+                Hyde::path('_media/image1.jpg'),
+                Hyde::path('_media/image2.png'),
+                Hyde::path('_media/document.pdf'), // This should be excluded
+            ];
+        });
+
+        $assets = $this->filesystem->assets();
+
+        $this->assertCount(2, $assets);
+        $this->assertTrue($assets->has('image1.jpg'));
+        $this->assertTrue($assets->has('image2.png'));
+        $this->assertFalse($assets->has('document.pdf'));
+    }
+
+    public function testAssetsMethodWithNestedDirectories()
+    {
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [
+                Hyde::path('_media/images/photo.jpg'),
+                Hyde::path('_media/documents/report.pdf'),
+            ];
+        });
+
+        $assets = $this->filesystem->assets();
+
+        $this->assertCount(2, $assets);
+        $this->assertTrue($assets->has('images/photo.jpg'));
+        $this->assertTrue($assets->has('documents/report.pdf'));
+    }
+
+    public function testAssetsMethodWithInvalidMediaFile()
+    {
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [
+                Hyde::path('_media/valid.jpg'),
+                Hyde::path('_media/invalid'), // File without extension
+            ];
+        });
+
+        $assets = $this->filesystem->assets();
+
+        $this->assertCount(1, $assets);
+        $this->assertTrue($assets->has('valid.jpg'));
+        $this->assertFalse($assets->has('invalid'));
+    }
+
+    public function testGetMediaGlobPatternWithCustomMediaDirectory()
+    {
+        $this->app['config']->set('hyde.media_directory', 'custom_media');
+
+        $pattern = $this->invokeProtectedMethod(Filesystem::class, 'getMediaGlobPattern');
+
+        $this->assertStringContainsString('custom_media/', $pattern);
+    }
+
+    public function testGetMediaGlobPatternWithCustomExtensions()
+    {
+        $this->app['config']->set('hyde.media_extensions', ['gif', 'svg']);
+
+        $pattern = $this->invokeProtectedMethod(Filesystem::class, 'getMediaGlobPattern');
+
+        $this->assertStringContainsString('{gif,svg}', $pattern);
+    }
+
+    public function testDiscoverMediaFilesWithEmptyResult()
+    {
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [];
+        });
+
+        $result = $this->invokeProtectedMethod(Filesystem::class, 'discoverMediaFiles');
+
+        $this->assertInstanceOf(Collection::class, $result);
+        $this->assertTrue($result->isEmpty());
+    }
+
+    public function testDiscoverMediaFilesWithMultipleFiles()
+    {
+        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
+            return [
+                Hyde::path('_media/image.jpg'),
+                Hyde::path('_media/document.pdf'),
+            ];
+        });
+
+        $result = $this->invokeProtectedMethod(Filesystem::class, 'discoverMediaFiles');
+
+        $this->assertCount(2, $result);
+        $this->assertInstanceOf(MediaFile::class, $result->get('image.jpg'));
+        $this->assertInstanceOf(MediaFile::class, $result->get('document.pdf'));
+    }
+
+    protected function mockStaticMethod($class, $method, $return)
+    {
+        $mock = Mockery::mock('alias:' . $class);
+        $mock->shouldReceive($method)->andReturn($return);
+    }
+
+    protected function invokeProtectedMethod($class, $method, array $args = [])
+    {
+        $reflection = new \ReflectionClass($class);
+        $method = $reflection->getMethod($method);
+        $method->setAccessible(true);
+        return $method->invokeArgs(null, $args);
+    }
+}

From ee8e4354bc3207b26535e043c7a498d1ad172c74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:31:12 +0200
Subject: [PATCH 2916/4023] Static mocks

---
 .../FilesystemHasMediaFilesTest.php           | 99 +++++++++----------
 1 file changed, 48 insertions(+), 51 deletions(-)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 0c993cce49e..71d37e4bea7 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -9,23 +9,21 @@
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
-use Mockery;
 
 /**
  * @covers \Hyde\Foundation\Kernel\Filesystem
- * @covers \Hyde\Foundation\Concerns\HasMediaFiles
  */
 class FilesystemHasMediaFilesTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
-    protected Filesystem $filesystem;
+    protected TestableFilesystem $filesystem;
 
     protected function setUp(): void
     {
         parent::setUp();
-        $this->filesystem = new Filesystem(Hyde::getInstance());
+        $this->filesystem = new TestableFilesystem(Hyde::getInstance());
     }
 
     public function testAssetsMethodReturnsSameInstanceOnSubsequentCalls()
@@ -38,9 +36,7 @@ public function testAssetsMethodReturnsSameInstanceOnSubsequentCalls()
 
     public function testAssetsMethodReturnsEmptyCollectionWhenNoMediaFiles()
     {
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [];
-        });
+        $this->filesystem->setTestMediaFiles([]);
 
         $assets = $this->filesystem->assets();
 
@@ -50,15 +46,13 @@ public function testAssetsMethodReturnsEmptyCollectionWhenNoMediaFiles()
 
     public function testAssetsMethodWithCustomMediaExtensions()
     {
-        $this->app['config']->set('hyde.media_extensions', ['jpg', 'png']);
+        Hyde::getInstance()->config()->set('hyde.media_extensions', ['jpg', 'png']);
 
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [
-                Hyde::path('_media/image1.jpg'),
-                Hyde::path('_media/image2.png'),
-                Hyde::path('_media/document.pdf'), // This should be excluded
-            ];
-        });
+        $this->filesystem->setTestMediaFiles([
+            Hyde::path('_media/image1.jpg'),
+            Hyde::path('_media/image2.png'),
+            Hyde::path('_media/document.pdf'), // This should be excluded
+        ]);
 
         $assets = $this->filesystem->assets();
 
@@ -70,12 +64,10 @@ public function testAssetsMethodWithCustomMediaExtensions()
 
     public function testAssetsMethodWithNestedDirectories()
     {
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [
-                Hyde::path('_media/images/photo.jpg'),
-                Hyde::path('_media/documents/report.pdf'),
-            ];
-        });
+        $this->filesystem->setTestMediaFiles([
+            Hyde::path('_media/images/photo.jpg'),
+            Hyde::path('_media/documents/report.pdf'),
+        ]);
 
         $assets = $this->filesystem->assets();
 
@@ -86,12 +78,10 @@ public function testAssetsMethodWithNestedDirectories()
 
     public function testAssetsMethodWithInvalidMediaFile()
     {
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [
-                Hyde::path('_media/valid.jpg'),
-                Hyde::path('_media/invalid'), // File without extension
-            ];
-        });
+        $this->filesystem->setTestMediaFiles([
+            Hyde::path('_media/valid.jpg'),
+            Hyde::path('_media/invalid'), // File without extension
+        ]);
 
         $assets = $this->filesystem->assets();
 
@@ -102,29 +92,27 @@ public function testAssetsMethodWithInvalidMediaFile()
 
     public function testGetMediaGlobPatternWithCustomMediaDirectory()
     {
-        $this->app['config']->set('hyde.media_directory', 'custom_media');
+        Hyde::getInstance()->config()->set('hyde.media_directory', 'custom_media');
 
-        $pattern = $this->invokeProtectedMethod(Filesystem::class, 'getMediaGlobPattern');
+        $pattern = $this->filesystem->getTestMediaGlobPattern();
 
         $this->assertStringContainsString('custom_media/', $pattern);
     }
 
     public function testGetMediaGlobPatternWithCustomExtensions()
     {
-        $this->app['config']->set('hyde.media_extensions', ['gif', 'svg']);
+        Hyde::getInstance()->config()->set('hyde.media_extensions', ['gif', 'svg']);
 
-        $pattern = $this->invokeProtectedMethod(Filesystem::class, 'getMediaGlobPattern');
+        $pattern = $this->filesystem->getTestMediaGlobPattern();
 
         $this->assertStringContainsString('{gif,svg}', $pattern);
     }
 
     public function testDiscoverMediaFilesWithEmptyResult()
     {
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [];
-        });
+        $this->filesystem->setTestMediaFiles([]);
 
-        $result = $this->invokeProtectedMethod(Filesystem::class, 'discoverMediaFiles');
+        $result = $this->filesystem->getTestDiscoverMediaFiles();
 
         $this->assertInstanceOf(Collection::class, $result);
         $this->assertTrue($result->isEmpty());
@@ -132,31 +120,40 @@ public function testDiscoverMediaFilesWithEmptyResult()
 
     public function testDiscoverMediaFilesWithMultipleFiles()
     {
-        $this->mockStaticMethod(Filesystem::class, 'getMediaFiles', function () {
-            return [
-                Hyde::path('_media/image.jpg'),
-                Hyde::path('_media/document.pdf'),
-            ];
-        });
+        $this->filesystem->setTestMediaFiles([
+            Hyde::path('_media/image.jpg'),
+            Hyde::path('_media/document.pdf'),
+        ]);
 
-        $result = $this->invokeProtectedMethod(Filesystem::class, 'discoverMediaFiles');
+        $result = $this->filesystem->getTestDiscoverMediaFiles();
 
         $this->assertCount(2, $result);
         $this->assertInstanceOf(MediaFile::class, $result->get('image.jpg'));
         $this->assertInstanceOf(MediaFile::class, $result->get('document.pdf'));
     }
+}
+
+class TestableFilesystem extends Filesystem
+{
+    private static array $testMediaFiles = [];
 
-    protected function mockStaticMethod($class, $method, $return)
+    public function setTestMediaFiles(array $files): void
     {
-        $mock = Mockery::mock('alias:' . $class);
-        $mock->shouldReceive($method)->andReturn($return);
+        self::$testMediaFiles = $files;
     }
 
-    protected function invokeProtectedMethod($class, $method, array $args = [])
+    protected static function getMediaFiles(): array
     {
-        $reflection = new \ReflectionClass($class);
-        $method = $reflection->getMethod($method);
-        $method->setAccessible(true);
-        return $method->invokeArgs(null, $args);
+        return self::$testMediaFiles;
     }
-}
+
+    public function getTestMediaGlobPattern(): string
+    {
+        return static::getMediaGlobPattern();
+    }
+
+    public function getTestDiscoverMediaFiles(): Collection
+    {
+        return static::discoverMediaFiles();
+    }
+}
\ No newline at end of file

From 43e72bb6c8b7be912da838977ecbe78cdeee605d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:32:51 +0200
Subject: [PATCH 2917/4023] Fix config mocks

---
 .../tests/Unit/Foundation/FilesystemHasMediaFilesTest.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 71d37e4bea7..24b5b726586 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -46,7 +46,7 @@ public function testAssetsMethodReturnsEmptyCollectionWhenNoMediaFiles()
 
     public function testAssetsMethodWithCustomMediaExtensions()
     {
-        Hyde::getInstance()->config()->set('hyde.media_extensions', ['jpg', 'png']);
+        self::mockConfig(['hyde.media_extensions' => ['jpg', 'png']]);
 
         $this->filesystem->setTestMediaFiles([
             Hyde::path('_media/image1.jpg'),
@@ -92,7 +92,7 @@ public function testAssetsMethodWithInvalidMediaFile()
 
     public function testGetMediaGlobPatternWithCustomMediaDirectory()
     {
-        Hyde::getInstance()->config()->set('hyde.media_directory', 'custom_media');
+        self::mockConfig(['hyde.media_directory' => 'custom_media']);
 
         $pattern = $this->filesystem->getTestMediaGlobPattern();
 
@@ -101,7 +101,7 @@ public function testGetMediaGlobPatternWithCustomMediaDirectory()
 
     public function testGetMediaGlobPatternWithCustomExtensions()
     {
-        Hyde::getInstance()->config()->set('hyde.media_extensions', ['gif', 'svg']);
+        self::mockConfig(['hyde.media_extensions' => ['gif', 'svg']]);
 
         $pattern = $this->filesystem->getTestMediaGlobPattern();
 
@@ -156,4 +156,4 @@ public function getTestDiscoverMediaFiles(): Collection
     {
         return static::discoverMediaFiles();
     }
-}
\ No newline at end of file
+}

From 19dfea93ea8900dc8a526cab95c7951a3a18c55d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:35:46 +0200
Subject: [PATCH 2918/4023] Filter static files using the glob pattern

---
 .../FilesystemHasMediaFilesTest.php           | 26 ++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 24b5b726586..7cf5c233857 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -144,7 +144,31 @@ public function setTestMediaFiles(array $files): void
 
     protected static function getMediaFiles(): array
     {
-        return self::$testMediaFiles;
+        $pattern = static::getMediaGlobPattern();
+        $baseDir = Hyde::path('_media');
+        $patternParts = explode('/', $pattern);
+        $globPattern = end($patternParts);
+
+        return array_filter(self::$testMediaFiles, function ($file) use ($baseDir, $globPattern) {
+            $relativePath = str_replace($baseDir . DIRECTORY_SEPARATOR, '', $file);
+            return self::matchesGlobPattern($relativePath, $globPattern);
+        });
+    }
+
+    private static function matchesGlobPattern(string $filename, string $pattern): bool
+    {
+        $regex = self::globToRegex($pattern);
+        return preg_match($regex, $filename) === 1;
+    }
+
+    private static function globToRegex(string $pattern): string
+    {
+        $regex = preg_quote($pattern, '/');
+        $regex = str_replace('\*', '.*', $regex);
+        $regex = str_replace('\{', '(', $regex);
+        $regex = str_replace('\}', ')', $regex);
+        $regex = str_replace(',', '|', $regex);
+        return '/^' . $regex . '$/i';
     }
 
     public function getTestMediaGlobPattern(): string

From eb0cb020f7b70c846891790555b852d79dbfc21f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:35:49 +0200
Subject: [PATCH 2919/4023] Revert "Filter static files using the glob pattern"

This reverts commit f3a177c385bd72805cb529f75c276472e1939021.
---
 .../FilesystemHasMediaFilesTest.php           | 26 +------------------
 1 file changed, 1 insertion(+), 25 deletions(-)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 7cf5c233857..24b5b726586 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -144,31 +144,7 @@ public function setTestMediaFiles(array $files): void
 
     protected static function getMediaFiles(): array
     {
-        $pattern = static::getMediaGlobPattern();
-        $baseDir = Hyde::path('_media');
-        $patternParts = explode('/', $pattern);
-        $globPattern = end($patternParts);
-
-        return array_filter(self::$testMediaFiles, function ($file) use ($baseDir, $globPattern) {
-            $relativePath = str_replace($baseDir . DIRECTORY_SEPARATOR, '', $file);
-            return self::matchesGlobPattern($relativePath, $globPattern);
-        });
-    }
-
-    private static function matchesGlobPattern(string $filename, string $pattern): bool
-    {
-        $regex = self::globToRegex($pattern);
-        return preg_match($regex, $filename) === 1;
-    }
-
-    private static function globToRegex(string $pattern): string
-    {
-        $regex = preg_quote($pattern, '/');
-        $regex = str_replace('\*', '.*', $regex);
-        $regex = str_replace('\{', '(', $regex);
-        $regex = str_replace('\}', ')', $regex);
-        $regex = str_replace(',', '|', $regex);
-        return '/^' . $regex . '$/i';
+        return self::$testMediaFiles;
     }
 
     public function getTestMediaGlobPattern(): string

From 94e3f21b91ed1a151226c71aeb657d1290b666f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:38:04 +0200
Subject: [PATCH 2920/4023] Clean up and improve the Claude generated unit test

---
 .../FilesystemHasMediaFilesTest.php           | 36 ++-----------------
 1 file changed, 3 insertions(+), 33 deletions(-)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 24b5b726586..594e6966bcf 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -44,24 +44,6 @@ public function testAssetsMethodReturnsEmptyCollectionWhenNoMediaFiles()
         $this->assertTrue($assets->isEmpty());
     }
 
-    public function testAssetsMethodWithCustomMediaExtensions()
-    {
-        self::mockConfig(['hyde.media_extensions' => ['jpg', 'png']]);
-
-        $this->filesystem->setTestMediaFiles([
-            Hyde::path('_media/image1.jpg'),
-            Hyde::path('_media/image2.png'),
-            Hyde::path('_media/document.pdf'), // This should be excluded
-        ]);
-
-        $assets = $this->filesystem->assets();
-
-        $this->assertCount(2, $assets);
-        $this->assertTrue($assets->has('image1.jpg'));
-        $this->assertTrue($assets->has('image2.png'));
-        $this->assertFalse($assets->has('document.pdf'));
-    }
-
     public function testAssetsMethodWithNestedDirectories()
     {
         $this->filesystem->setTestMediaFiles([
@@ -76,27 +58,15 @@ public function testAssetsMethodWithNestedDirectories()
         $this->assertTrue($assets->has('documents/report.pdf'));
     }
 
-    public function testAssetsMethodWithInvalidMediaFile()
-    {
-        $this->filesystem->setTestMediaFiles([
-            Hyde::path('_media/valid.jpg'),
-            Hyde::path('_media/invalid'), // File without extension
-        ]);
-
-        $assets = $this->filesystem->assets();
-
-        $this->assertCount(1, $assets);
-        $this->assertTrue($assets->has('valid.jpg'));
-        $this->assertFalse($assets->has('invalid'));
-    }
-
     public function testGetMediaGlobPatternWithCustomMediaDirectory()
     {
-        self::mockConfig(['hyde.media_directory' => 'custom_media']);
+        Hyde::setMediaDirectory('custom_media');
 
         $pattern = $this->filesystem->getTestMediaGlobPattern();
 
         $this->assertStringContainsString('custom_media/', $pattern);
+
+        Hyde::setMediaDirectory('_media');
     }
 
     public function testGetMediaGlobPatternWithCustomExtensions()

From 1bdf4ba3c50c89a2e50afe567b12a5583041d796 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 14:43:11 +0200
Subject: [PATCH 2921/4023] Annotate the collection generics

---
 .../partials/hyde-pages-api/hyde-kernel-filesystem-methods.md | 4 ++--
 .../framework/src/Foundation/Concerns/ForwardsFilesystem.php  | 1 +
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index 55dfcdafe4b..9823b18f5f4 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2024-07-28 11:20:12 in 0.11ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-28 12:43:01 in 0.11ms -->
 
 #### `filesystem()`
 
@@ -56,7 +56,7 @@ Hyde::pathToRelative(string $path): string
 No description provided.
 
 ```php
-Hyde::assets(): Illuminate\Support\Collection
+Hyde::assets(): Collection<string, \Hyde\Support\Filesystem\MediaFile>
 ```
 
 <!-- End generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index 888f3abf4d0..1f45bc30655 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -44,6 +44,7 @@ public function pathToRelative(string $path): string
         return $this->filesystem->pathToRelative($path);
     }
 
+    /** @return Collection<string, \Hyde\Support\Filesystem\MediaFile> */
     public function assets(): Collection
     {
         return $this->filesystem->assets();

From 96781f996026d8782f094ae95cfe465fce1d9bb5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 15:52:08 +0200
Subject: [PATCH 2922/4023] Normalize implementation syntax

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5457e18ba03..5d362d7aeb4 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -60,9 +60,7 @@ public static function outputPath(string $path = ''): string
             return Hyde::sitePath(Hyde::getMediaOutputDirectory());
         }
 
-        $path = unslash($path);
-
-        return Hyde::sitePath(Hyde::getMediaOutputDirectory()."/$path");
+        return Hyde::sitePath(path_join(Hyde::getMediaOutputDirectory(), unslash($path)));
     }
 
     public function getIdentifier(): string

From 27778927dd2931bed4ef5d224d4674587ff769cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:18:47 +0200
Subject: [PATCH 2923/4023] Document identifier method

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5d362d7aeb4..d25889dff82 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -63,6 +63,9 @@ public static function outputPath(string $path = ''): string
         return Hyde::sitePath(path_join(Hyde::getMediaOutputDirectory(), unslash($path)));
     }
 
+    /**
+     * Get the path to the media file relative to the media directory.
+     */
     public function getIdentifier(): string
     {
         return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');

From 58cfaf85862be68470c1d0b3554583580c86169c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:18:55 +0200
Subject: [PATCH 2924/4023] Add more tests for the identifier method

---
 .../framework/tests/Unit/Support/MediaFileTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 16f9c1477f3..0043845a48d 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -249,6 +249,16 @@ public function testGetIdentifierWithSubdirectory()
         $this->assertSame('foo/bar', MediaFile::make('foo/bar')->getIdentifier());
     }
 
+    public function testGetIdentifierReturnsIdentifierWithFileExtension()
+    {
+        $this->assertSame('foo.png', MediaFile::make('foo.png')->getIdentifier());
+    }
+
+    public function testGetIdentifierWithSubdirectoryWithFileExtension()
+    {
+        $this->assertSame('foo/bar.png', MediaFile::make('foo/bar.png')->getIdentifier());
+    }
+
     public function testHelperForMediaPath()
     {
         $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());

From 4e4ef03dbe6f32a73790a2109c1551a08cfb4877 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:10:21 +0200
Subject: [PATCH 2925/4023] Override parent constructor

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index d25889dff82..4571582d1b7 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -27,6 +27,11 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
+    public function __construct(string $path)
+    {
+        parent::__construct($path);
+    }
+
     /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
     public static function all(): Collection
     {

From c8ca302ada7f561f58d4863799bca9196914b9be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:13:50 +0200
Subject: [PATCH 2926/4023] Normalize stored internal path

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 4571582d1b7..55f95d6a1a7 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -12,6 +12,7 @@
 
 use function Hyde\unslash;
 use function Hyde\path_join;
+use function Hyde\trim_slashes;
 use function extension_loaded;
 use function file_exists;
 use function array_merge;
@@ -29,6 +30,8 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
+        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
+
         parent::__construct($path);
     }
 

From c4b7af3c42069e7e9a553b00482f33170c3d0540 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:16:52 +0200
Subject: [PATCH 2927/4023] Normalize formatter syntax

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 55f95d6a1a7..525cae51fd7 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -30,7 +30,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
+        $path = Str::after($path, Hyde::getMediaDirectory().'/');
 
         parent::__construct($path);
     }

From b20eab63d01f6c366714ad4f99a1475741094dec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:19:32 +0200
Subject: [PATCH 2928/4023] Revert "Normalize formatter syntax"

This reverts commit c4b7af3c42069e7e9a553b00482f33170c3d0540.
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 525cae51fd7..55f95d6a1a7 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -30,7 +30,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = Str::after($path, Hyde::getMediaDirectory().'/');
+        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
 
         parent::__construct($path);
     }

From 0907bc5c7e38752b1a9887b5e420e77ceb67096c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:20:54 +0200
Subject: [PATCH 2929/4023] Test normalization

---
 .../framework/tests/Unit/Support/MediaFileTest.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 0043845a48d..e47e8a290b4 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -86,6 +86,16 @@ public function testAbsolutePathIsNormalizedToRelative()
         $this->assertSame('foo', MediaFile::make(Hyde::path('foo'))->path);
     }
 
+    public function testMediaPathIsNormalizedToRelative()
+    {
+        $this->assertSame('foo', MediaFile::make('_media/foo')->path);
+    }
+
+    public function testAbsoluteMediaPathIsNormalizedToRelative()
+    {
+        $this->assertSame('foo', MediaFile::make(Hyde::path('_media/foo'))->path);
+    }
+
     public function testGetNameReturnsNameOfFile()
     {
         $this->assertSame('foo.txt', MediaFile::make('foo.txt')->getName());

From c3b7ca8c9cd16ad51871a02cc8b9a0d459b353b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:24:31 +0200
Subject: [PATCH 2930/4023] Add initial normalization

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 55f95d6a1a7..8b375af9026 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -30,7 +30,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
+        $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
 
         parent::__construct($path);
     }

From e82649c18458d451b9762f6a36b738aa8fafc0f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:43:57 +0200
Subject: [PATCH 2931/4023] Update MediaFileTest.php

---
 .../framework/tests/Unit/Support/MediaFileTest.php    | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index e47e8a290b4..cf5c80dc9d3 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -81,17 +81,22 @@ public function testCanConstructWithNestedPaths()
         $this->assertSame('path/to/file.txt', MediaFile::make('path/to/file.txt')->path);
     }
 
-    public function testAbsolutePathIsNormalizedToRelative()
+    public function testPathIsNormalizedToRelativeMediaPath()
+    {
+        $this->assertSame('_media/foo', MediaFile::make('foo')->path);
+    }
+
+    public function testAbsolutePathIsNormalizedToRelativeMediaPath()
     {
         $this->assertSame('foo', MediaFile::make(Hyde::path('foo'))->path);
     }
 
-    public function testMediaPathIsNormalizedToRelative()
+    public function testMediaPathIsNormalizedToRelativeMediaPath()
     {
         $this->assertSame('foo', MediaFile::make('_media/foo')->path);
     }
 
-    public function testAbsoluteMediaPathIsNormalizedToRelative()
+    public function testAbsoluteMediaPathIsNormalizedToRelativeMediaPath()
     {
         $this->assertSame('foo', MediaFile::make(Hyde::path('_media/foo'))->path);
     }

From 4e9ea803122424a1dd040435dfea3db455601150 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:28:04 +0200
Subject: [PATCH 2932/4023] Change normalization to enforce parent documented
 state

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 8b375af9026..e31297c93ba 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -32,7 +32,7 @@ public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
 
-        parent::__construct($path);
+        parent::__construct(static::sourcePath($path));
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */

From 82bbc1c4224f1daed697dfa53a36f73589a32a2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:40:50 +0200
Subject: [PATCH 2933/4023] Update tests to expect media file paths are
 normalized on construct

---
 .../tests/Unit/Support/MediaFileTest.php      | 60 +++++++++----------
 1 file changed, 30 insertions(+), 30 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index cf5c80dc9d3..ec118f5b700 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -68,7 +68,7 @@ public function testCanConstruct()
         $file = new MediaFile('foo');
 
         $this->assertInstanceOf(MediaFile::class, $file);
-        $this->assertSame('foo', $file->path);
+        $this->assertSame('_media/foo', $file->path);
     }
 
     public function testCanMake()
@@ -78,7 +78,7 @@ public function testCanMake()
 
     public function testCanConstructWithNestedPaths()
     {
-        $this->assertSame('path/to/file.txt', MediaFile::make('path/to/file.txt')->path);
+        $this->assertSame('_media/path/to/file.txt', MediaFile::make('path/to/file.txt')->path);
     }
 
     public function testPathIsNormalizedToRelativeMediaPath()
@@ -88,17 +88,17 @@ public function testPathIsNormalizedToRelativeMediaPath()
 
     public function testAbsolutePathIsNormalizedToRelativeMediaPath()
     {
-        $this->assertSame('foo', MediaFile::make(Hyde::path('foo'))->path);
+        $this->assertSame('_media/foo', MediaFile::make(Hyde::path('foo'))->path);
     }
 
     public function testMediaPathIsNormalizedToRelativeMediaPath()
     {
-        $this->assertSame('foo', MediaFile::make('_media/foo')->path);
+        $this->assertSame('_media/foo', MediaFile::make('_media/foo')->path);
     }
 
     public function testAbsoluteMediaPathIsNormalizedToRelativeMediaPath()
     {
-        $this->assertSame('foo', MediaFile::make(Hyde::path('_media/foo'))->path);
+        $this->assertSame('_media/foo', MediaFile::make(Hyde::path('_media/foo'))->path);
     }
 
     public function testGetNameReturnsNameOfFile()
@@ -109,38 +109,38 @@ public function testGetNameReturnsNameOfFile()
 
     public function testGetPathReturnsPathOfFile()
     {
-        $this->assertSame('foo.txt', MediaFile::make('foo.txt')->getPath());
-        $this->assertSame('foo/bar.txt', MediaFile::make('foo/bar.txt')->getPath());
+        $this->assertSame('_media/foo.txt', MediaFile::make('foo.txt')->getPath());
+        $this->assertSame('_media/foo/bar.txt', MediaFile::make('foo/bar.txt')->getPath());
     }
 
     public function testGetAbsolutePathReturnsAbsolutePathOfFile()
     {
-        $this->assertSame(Hyde::path('foo.txt'), MediaFile::make('foo.txt')->getAbsolutePath());
-        $this->assertSame(Hyde::path('foo/bar.txt'), MediaFile::make('foo/bar.txt')->getAbsolutePath());
+        $this->assertSame(Hyde::path('_media/foo.txt'), MediaFile::make('foo.txt')->getAbsolutePath());
+        $this->assertSame(Hyde::path('_media/foo/bar.txt'), MediaFile::make('foo/bar.txt')->getAbsolutePath());
     }
 
     public function testGetContentsReturnsContentsOfFile()
     {
-        $this->file('foo.txt', 'foo bar');
+        $this->file('_media/foo.txt', 'foo bar');
         $this->assertSame('foo bar', MediaFile::make('foo.txt')->getContents());
     }
 
     public function testGetExtensionReturnsExtensionOfFile()
     {
-        $this->file('foo.txt', 'foo');
+        $this->file('_media/foo.txt', 'foo');
         $this->assertSame('txt', MediaFile::make('foo.txt')->getExtension());
 
-        $this->file('foo.png', 'foo');
+        $this->file('_media/foo.png', 'foo');
         $this->assertSame('png', MediaFile::make('foo.png')->getExtension());
     }
 
     public function testToArrayReturnsArrayOfFileProperties()
     {
-        $this->file('foo.txt', 'foo bar');
+        $this->file('_media/foo.txt', 'foo bar');
 
         $this->assertSame([
             'name' => 'foo.txt',
-            'path' => 'foo.txt',
+            'path' => '_media/foo.txt',
             'length' => 7,
             'mimeType' => 'text/plain',
         ], MediaFile::make('foo.txt')->toArray());
@@ -148,11 +148,11 @@ public function testToArrayReturnsArrayOfFileProperties()
 
     public function testToArrayWithEmptyFileWithNoExtension()
     {
-        $this->file('foo', 'foo bar');
+        $this->file('_media/foo', 'foo bar');
 
         $this->assertSame([
             'name' => 'foo',
-            'path' => 'foo',
+            'path' => '_media/foo',
             'length' => 7,
             'mimeType' => 'text/plain',
         ], MediaFile::make('foo')->toArray());
@@ -160,38 +160,38 @@ public function testToArrayWithEmptyFileWithNoExtension()
 
     public function testToArrayWithFileInSubdirectory()
     {
-        mkdir(Hyde::path('foo'));
-        touch(Hyde::path('foo/bar.txt'));
+        mkdir(Hyde::path('_media/foo'));
+        touch(Hyde::path('_media/foo/bar.txt'));
 
         $this->assertSame([
             'name' => 'bar.txt',
-            'path' => 'foo/bar.txt',
+            'path' => '_media/foo/bar.txt',
             'length' => 0,
             'mimeType' => 'text/plain',
         ], MediaFile::make('foo/bar.txt')->toArray());
 
-        Filesystem::unlink('foo/bar.txt');
-        rmdir(Hyde::path('foo'));
+        Filesystem::unlink('_media/foo/bar.txt');
+        rmdir(Hyde::path('_media/foo'));
     }
 
     public function testGetContentLength()
     {
-        $this->file('foo', 'Hello World!');
+        $this->file('_media/foo', 'Hello World!');
         $this->assertSame(12, MediaFile::make('foo')->getContentLength());
     }
 
     public function testGetContentLengthWithEmptyFile()
     {
-        $this->file('foo', '');
+        $this->file('_media/foo', '');
         $this->assertSame(0, MediaFile::make('foo')->getContentLength());
     }
 
     public function testGetContentLengthWithDirectory()
     {
-        $this->directory('foo');
+        $this->directory('_media/foo');
 
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [foo] not found.');
+        $this->expectExceptionMessage('File [_media/foo] not found.');
 
         MediaFile::make('foo')->getContentLength();
     }
@@ -199,32 +199,32 @@ public function testGetContentLengthWithDirectory()
     public function testGetContentLengthWithNonExistentFile()
     {
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [foo] not found.');
+        $this->expectExceptionMessage('File [_media/foo] not found.');
 
         MediaFile::make('foo')->getContentLength();
     }
 
     public function testGetMimeType()
     {
-        $this->file('foo.txt', 'Hello World!');
+        $this->file('_media/foo.txt', 'Hello World!');
         $this->assertSame('text/plain', MediaFile::make('foo.txt')->getMimeType());
     }
 
     public function testGetMimeTypeWithoutExtension()
     {
-        $this->file('foo', 'Hello World!');
+        $this->file('_media/foo', 'Hello World!');
         $this->assertSame('text/plain', MediaFile::make('foo')->getMimeType());
     }
 
     public function testGetMimeTypeWithEmptyFile()
     {
-        $this->file('foo', '');
+        $this->file('_media/foo', '');
         $this->assertSame('application/x-empty', MediaFile::make('foo')->getMimeType());
     }
 
     public function testGetMimeTypeWithDirectory()
     {
-        $this->directory('foo');
+        $this->directory('_media/foo');
         $this->assertSame('directory', MediaFile::make('foo')->getMimeType());
     }
 

From 67f056f39e2d7009e5b28c1d27858b47f1737ff5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 16:45:40 +0200
Subject: [PATCH 2934/4023] Add more unit tests

---
 .../framework/tests/Unit/Support/MediaFileTest.php    | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index ec118f5b700..3feee0d53c2 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -101,6 +101,17 @@ public function testAbsoluteMediaPathIsNormalizedToRelativeMediaPath()
         $this->assertSame('_media/foo', MediaFile::make(Hyde::path('_media/foo'))->path);
     }
 
+    public function testCustomMediaPathsAreNormalizedToRelativeCustomizedMediaPath()
+    {
+        Hyde::setMediaDirectory('bar');
+
+        $this->assertSame('bar/foo', MediaFile::make('foo')->path);
+        $this->assertSame('bar/foo', MediaFile::make('bar/foo')->path);
+        $this->assertSame('bar/foo', MediaFile::make(Hyde::path('foo'))->path);
+
+        Hyde::setMediaDirectory('_media');
+    }
+
     public function testGetNameReturnsNameOfFile()
     {
         $this->assertSame('foo.txt', MediaFile::make('foo.txt')->getName());

From 9f920f71170452fc385a23f337e44a8d6c2feda3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 17:31:35 +0200
Subject: [PATCH 2935/4023] Fix missing test reset

---
 packages/framework/tests/Unit/Support/MediaFileTest.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 3feee0d53c2..488d95f324c 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -332,5 +332,8 @@ public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory
         Hyde::setMediaDirectory('bar');
 
         $this->assertSame(Hyde::path('foo/bar'), MediaFile::outputPath());
+
+        Hyde::setOutputDirectory(Hyde::path('_site'));
+        Hyde::setMediaDirectory('_media');
     }
 }

From 4aa11b4b2fd8c8bb0c032074b8271bc494272fcc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 17:06:40 +0200
Subject: [PATCH 2936/4023] Add hash accessor

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 +++++
 packages/framework/tests/Unit/Support/MediaFileTest.php | 7 +++++++
 2 files changed, 12 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e31297c93ba..c67ab173e2a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -128,6 +128,11 @@ public function getMimeType(): string
         return 'text/plain';
     }
 
+    public function getHash(): string
+    {
+        return md5_file($this->getAbsolutePath());
+    }
+
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 488d95f324c..85a60d18330 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -336,4 +336,11 @@ public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory
         Hyde::setOutputDirectory(Hyde::path('_site'));
         Hyde::setMediaDirectory('_media');
     }
+
+    public function testGetHash()
+    {
+        $this->file('_media/foo.txt', 'Hello World!');
+
+        $this->assertSame(md5('Hello World!'), MediaFile::make('foo.txt')->getHash());
+    }
 }

From dca20a021d646a11cbd4b79e13c697cd85c67b5f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 20:36:32 +0200
Subject: [PATCH 2937/4023] Use CRC32 for media asset hashing

See lengthy discussion at https://github.com/hydephp/develop/pull/1918#discussion_r1694288128
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 packages/framework/tests/Unit/Support/MediaFileTest.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index c67ab173e2a..d7d42ead576 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -130,7 +130,7 @@ public function getMimeType(): string
 
     public function getHash(): string
     {
-        return md5_file($this->getAbsolutePath());
+        return hash_file('crc32', $this->getAbsolutePath());
     }
 
     /** @internal */
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 85a60d18330..e2000a6b370 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -341,6 +341,6 @@ public function testGetHash()
     {
         $this->file('_media/foo.txt', 'Hello World!');
 
-        $this->assertSame(md5('Hello World!'), MediaFile::make('foo.txt')->getHash());
+        $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
 }

From 4cb592f5cf0ec80f47c1b2c20a10355616d85280 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 20:51:18 +0200
Subject: [PATCH 2938/4023] Use CRC32 for media asset cache busting

See lengthy discussion at https://github.com/hydephp/develop/pull/1918#discussion_r1694288128
---
 packages/framework/src/Support/Filesystem/MediaFile.php       | 2 +-
 .../framework/tests/Feature/Foundation/HyperlinksTest.php     | 4 ++--
 packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php | 4 ++--
 .../framework/tests/Unit/MediaDirectoryCanBeChangedTest.php   | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index d7d42ead576..b2a2f76dd6d 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -137,7 +137,7 @@ public function getHash(): string
     public static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true) && file_exists(MediaFile::sourcePath("$file"))
-            ? '?v='.md5_file(MediaFile::sourcePath("$file"))
+            ? '?v='.hash_file('crc32', MediaFile::sourcePath("$file"))
             : '';
     }
 }
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 9a7893a0d6a..88fa946bf24 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -107,8 +107,8 @@ public function testMediaLinkHelperUsesConfiguredMediaDirectory()
 
     public function testMediaLinkHelperWithValidationAndExistingFile()
     {
-        $this->file('_media/foo');
-        $this->assertSame('media/foo?v=d41d8cd98f00b204e9800998ecf8427e', $this->class->mediaLink('foo', true));
+        $this->file('_media/foo', 'test');
+        $this->assertSame('media/foo?v=accf8b33', $this->class->mediaLink('foo', true));
     }
 
     public function testMediaLinkHelperWithValidationAndNonExistingFile()
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 5c43956cbcf..f219a8d9318 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -49,7 +49,7 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
     public function testMediaLinkReturnsMediaPathWithCacheKey()
     {
         $this->assertIsString($path = Asset::mediaLink('app.css'));
-        $this->assertSame('media/app.css?v='.md5_file(Hyde::path('_media/app.css')), $path);
+        $this->assertSame('media/app.css?v='.hash_file('crc32', Hyde::path('_media/app.css')), $path);
     }
 
     public function testMediaLinkReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
@@ -72,6 +72,6 @@ public function testMediaLinkSupportsCustomMediaDirectories()
         $path = Asset::mediaLink('app.css');
 
         $this->assertIsString($path);
-        $this->assertSame('assets/app.css?v='.md5_file(Hyde::path('_assets/app.css')), $path);
+        $this->assertSame('assets/app.css?v='.hash_file('crc32', Hyde::path('_assets/app.css')), $path);
     }
 }
diff --git a/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php b/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
index f2521fc54f6..741646b4c7e 100644
--- a/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
+++ b/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
@@ -67,12 +67,12 @@ public function testCompiledPagesHaveLinksToTheRightMediaFileLocation()
         $this->assertFileExists(Hyde::path('_site/foo.html'));
         $contents = file_get_contents(Hyde::path('_site/foo.html'));
         $this->assertStringContainsString(
-            '<link rel="stylesheet" href="assets/app.css?v='.md5_file(Hyde::path('_assets/app.css')).'">',
+            '<link rel="stylesheet" href="assets/app.css?v='.hash_file('crc32', Hyde::path('_assets/app.css')).'">',
             $contents
         );
 
         $this->assertStringContainsString(
-            '<script defer src="assets/app.js?v='.md5_file(Hyde::path('_assets/app.js')).'"></script>',
+            '<script defer src="assets/app.js?v='.hash_file('crc32', Hyde::path('_assets/app.js')).'"></script>',
             $contents
         );
 

From 9af2d815f8cbfda7758dd0d934992e5ec7e71c5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 21:18:10 +0200
Subject: [PATCH 2939/4023] Get the hash through creating an instance

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index b2a2f76dd6d..9481be80b72 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -137,7 +137,7 @@ public function getHash(): string
     public static function getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true) && file_exists(MediaFile::sourcePath("$file"))
-            ? '?v='.hash_file('crc32', MediaFile::sourcePath("$file"))
+            ? '?v='.MediaFile::make($file)->getHash()
             : '';
     }
 }

From 43e99aed97d4b51af73c33ec1adbad44784188c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 21:18:40 +0200
Subject: [PATCH 2940/4023] Use static to reference the same class

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 9481be80b72..7e1c540170c 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -136,8 +136,8 @@ public function getHash(): string
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {
-        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(MediaFile::sourcePath("$file"))
-            ? '?v='.MediaFile::make($file)->getHash()
+        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(static::sourcePath("$file"))
+            ? '?v='.static::make($file)->getHash()
             : '';
     }
 }

From 09689fbe83ae7dfccc6508cc255a6bc54f34f7a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 28 Jul 2024 21:30:19 +0200
Subject: [PATCH 2941/4023] Add the hash to the array representation

---
 packages/framework/src/Support/Filesystem/MediaFile.php        | 1 +
 packages/framework/tests/Feature/Foundation/FilesystemTest.php | 1 +
 packages/framework/tests/Unit/Support/MediaFileTest.php        | 3 +++
 3 files changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 7e1c540170c..85be0113ea4 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -84,6 +84,7 @@ public function toArray(): array
         return array_merge(parent::toArray(), [
             'length' => $this->getContentLength(),
             'mimeType' => $this->getMimeType(),
+            'hash' => $this->getHash(),
         ]);
     }
 
diff --git a/packages/framework/tests/Feature/Foundation/FilesystemTest.php b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
index 01f7e83ac11..a65c92d8d67 100644
--- a/packages/framework/tests/Feature/Foundation/FilesystemTest.php
+++ b/packages/framework/tests/Feature/Foundation/FilesystemTest.php
@@ -377,6 +377,7 @@ public function testAssetsMethodGetsAllSiteAssetsAsArray()
                 'path' => '_media/app.css',
                 'length' => 123,
                 'mimeType' => 'text/css',
+                'hash' => hash_file('crc32', Hyde::path('_media/app.css')),
             ],
         ], $assets);
     }
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index e2000a6b370..a0efbf73091 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -154,6 +154,7 @@ public function testToArrayReturnsArrayOfFileProperties()
             'path' => '_media/foo.txt',
             'length' => 7,
             'mimeType' => 'text/plain',
+            'hash' => hash('crc32', 'foo bar'),
         ], MediaFile::make('foo.txt')->toArray());
     }
 
@@ -166,6 +167,7 @@ public function testToArrayWithEmptyFileWithNoExtension()
             'path' => '_media/foo',
             'length' => 7,
             'mimeType' => 'text/plain',
+            'hash' => hash('crc32', 'foo bar'),
         ], MediaFile::make('foo')->toArray());
     }
 
@@ -179,6 +181,7 @@ public function testToArrayWithFileInSubdirectory()
             'path' => '_media/foo/bar.txt',
             'length' => 0,
             'mimeType' => 'text/plain',
+            'hash' => hash('crc32', ''),
         ], MediaFile::make('foo/bar.txt')->toArray());
 
         Filesystem::unlink('_media/foo/bar.txt');

From b936744062fcf2d1620eb92d9f8471d14df95eea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:30:10 +0200
Subject: [PATCH 2942/4023] Throw exception if media file does not exist

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 85be0113ea4..63b2bd22f22 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
@@ -32,6 +33,10 @@ public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
 
+        if (Filesystem::missing($path)) {
+            throw new FileNotFoundException($path);
+        }
+
         parent::__construct(static::sourcePath($path));
     }
 

From b1d6f30400e24129aa2f114ab754fc97e69ef0a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:32:39 +0200
Subject: [PATCH 2943/4023] Revert "Throw exception if media file does not
 exist"

This reverts commit b936744062fcf2d1620eb92d9f8471d14df95eea as it should not be possible for this to happen with normal usage, since we generate these based on discovered files. If a developer does something custom, we can't assume they want files backed by disk. We'll see how we handle construct time data generation though...

It also makes unit testing harder (we could add an internal static property to disable validation)
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 63b2bd22f22..85be0113ea4 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
@@ -33,10 +32,6 @@ public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
 
-        if (Filesystem::missing($path)) {
-            throw new FileNotFoundException($path);
-        }
-
         parent::__construct(static::sourcePath($path));
     }
 

From 0b77a4d42d1f57d2cd850eed48b850d52f4ee35d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:33:31 +0200
Subject: [PATCH 2944/4023] Reapply "Throw exception if media file does not
 exist"

This reverts commit b1d6f30400e24129aa2f114ab754fc97e69ef0a5 as we're going to need this sanity check to reduce complexity with construct time data generation
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 85be0113ea4..63b2bd22f22 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
@@ -32,6 +33,10 @@ public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
 
+        if (Filesystem::missing($path)) {
+            throw new FileNotFoundException($path);
+        }
+
         parent::__construct(static::sourcePath($path));
     }
 

From 21340c90529c7e4335bab80c1ba9216ccab8665a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:35:55 +0200
Subject: [PATCH 2945/4023] Files should receive missing and return false

---
 packages/framework/tests/Unit/Support/MediaFileTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index a0efbf73091..efdbe12b859 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit\Support;
 
 use Hyde\Facades\Filesystem;
+use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
@@ -21,6 +22,13 @@ class MediaFileTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        File::shouldReceive('missing')->andReturn(false);
+    }
+
     protected function tearDown(): void
     {
         $this->cleanUpFilesystem();

From 6e5c26106c300445470e99d0f862d354dfa61f8d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:43:15 +0200
Subject: [PATCH 2946/4023] Validate the normalized path

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 63b2bd22f22..445748f9f46 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -32,12 +32,13 @@ class MediaFile extends ProjectFile
     public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
+        $path = static::sourcePath($path);
 
         if (Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
         }
 
-        parent::__construct(static::sourcePath($path));
+        parent::__construct($path);
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */

From 070a7ff4d73797cc21b0aa858f1e5a534ffd72dd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:47:49 +0200
Subject: [PATCH 2947/4023] Refactor to use mocks

---
 .../tests/Unit/Support/MediaFileTest.php      | 40 ++++++++++++++++---
 1 file changed, 35 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index efdbe12b859..a4cadc7d4d7 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Support;
 
+use Mockery;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\FileNotFoundException;
@@ -11,6 +12,7 @@
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Testing\CreatesTemporaryFiles;
+use Illuminate\Filesystem\Filesystem as BaseFilesystem;
 
 /**
  * @covers \Hyde\Support\Filesystem\MediaFile
@@ -26,11 +28,15 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        File::shouldReceive('missing')->andReturn(false);
+        $this->mockFilesystem([
+            'missing' => false,
+        ]);
     }
 
     protected function tearDown(): void
     {
+        $this->withoutMockingFilesystem();
+
         $this->cleanUpFilesystem();
     }
 
@@ -140,21 +146,25 @@ public function testGetAbsolutePathReturnsAbsolutePathOfFile()
 
     public function testGetContentsReturnsContentsOfFile()
     {
-        $this->file('_media/foo.txt', 'foo bar');
+        $this->mockFilesystem([
+            'missing' => false,
+            'get' => 'foo bar',
+        ]);
+
         $this->assertSame('foo bar', MediaFile::make('foo.txt')->getContents());
     }
 
     public function testGetExtensionReturnsExtensionOfFile()
     {
-        $this->file('_media/foo.txt', 'foo');
         $this->assertSame('txt', MediaFile::make('foo.txt')->getExtension());
 
-        $this->file('_media/foo.png', 'foo');
         $this->assertSame('png', MediaFile::make('foo.png')->getExtension());
     }
 
     public function testToArrayReturnsArrayOfFileProperties()
     {
+        $this->withoutMockingFilesystem();
+
         $this->file('_media/foo.txt', 'foo bar');
 
         $this->assertSame([
@@ -168,6 +178,8 @@ public function testToArrayReturnsArrayOfFileProperties()
 
     public function testToArrayWithEmptyFileWithNoExtension()
     {
+        $this->withoutMockingFilesystem();
+
         $this->file('_media/foo', 'foo bar');
 
         $this->assertSame([
@@ -181,6 +193,8 @@ public function testToArrayWithEmptyFileWithNoExtension()
 
     public function testToArrayWithFileInSubdirectory()
     {
+        $this->withoutMockingFilesystem();
+
         mkdir(Hyde::path('_media/foo'));
         touch(Hyde::path('_media/foo/bar.txt'));
 
@@ -198,7 +212,11 @@ public function testToArrayWithFileInSubdirectory()
 
     public function testGetContentLength()
     {
-        $this->file('_media/foo', 'Hello World!');
+        $this->mockFilesystem([
+            'missing' => false,
+            'size' => 12,
+        ]);
+
         $this->assertSame(12, MediaFile::make('foo')->getContentLength());
     }
 
@@ -210,6 +228,8 @@ public function testGetContentLengthWithEmptyFile()
 
     public function testGetContentLengthWithDirectory()
     {
+        $this->withoutMockingFilesystem();
+
         $this->directory('_media/foo');
 
         $this->expectException(FileNotFoundException::class);
@@ -354,4 +374,14 @@ public function testGetHash()
 
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
+
+    protected function mockFilesystem(array $methods): void
+    {
+        app()->instance(BaseFilesystem::class, Mockery::mock(BaseFilesystem::class, $methods));
+    }
+
+    protected function withoutMockingFilesystem(): void
+    {
+        app()->forgetInstance(BaseFilesystem::class);
+    }
 }

From f22f8e1854f18949b3d6a3c25a8116d18e1b9364 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:47:52 +0200
Subject: [PATCH 2948/4023] Revert "Refactor to use mocks"

This reverts commit 070a7ff4d73797cc21b0aa858f1e5a534ffd72dd.
---
 .../tests/Unit/Support/MediaFileTest.php      | 40 +++----------------
 1 file changed, 5 insertions(+), 35 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index a4cadc7d4d7..efdbe12b859 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit\Support;
 
-use Mockery;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\FileNotFoundException;
@@ -12,7 +11,6 @@
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Testing\CreatesTemporaryFiles;
-use Illuminate\Filesystem\Filesystem as BaseFilesystem;
 
 /**
  * @covers \Hyde\Support\Filesystem\MediaFile
@@ -28,15 +26,11 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        $this->mockFilesystem([
-            'missing' => false,
-        ]);
+        File::shouldReceive('missing')->andReturn(false);
     }
 
     protected function tearDown(): void
     {
-        $this->withoutMockingFilesystem();
-
         $this->cleanUpFilesystem();
     }
 
@@ -146,25 +140,21 @@ public function testGetAbsolutePathReturnsAbsolutePathOfFile()
 
     public function testGetContentsReturnsContentsOfFile()
     {
-        $this->mockFilesystem([
-            'missing' => false,
-            'get' => 'foo bar',
-        ]);
-
+        $this->file('_media/foo.txt', 'foo bar');
         $this->assertSame('foo bar', MediaFile::make('foo.txt')->getContents());
     }
 
     public function testGetExtensionReturnsExtensionOfFile()
     {
+        $this->file('_media/foo.txt', 'foo');
         $this->assertSame('txt', MediaFile::make('foo.txt')->getExtension());
 
+        $this->file('_media/foo.png', 'foo');
         $this->assertSame('png', MediaFile::make('foo.png')->getExtension());
     }
 
     public function testToArrayReturnsArrayOfFileProperties()
     {
-        $this->withoutMockingFilesystem();
-
         $this->file('_media/foo.txt', 'foo bar');
 
         $this->assertSame([
@@ -178,8 +168,6 @@ public function testToArrayReturnsArrayOfFileProperties()
 
     public function testToArrayWithEmptyFileWithNoExtension()
     {
-        $this->withoutMockingFilesystem();
-
         $this->file('_media/foo', 'foo bar');
 
         $this->assertSame([
@@ -193,8 +181,6 @@ public function testToArrayWithEmptyFileWithNoExtension()
 
     public function testToArrayWithFileInSubdirectory()
     {
-        $this->withoutMockingFilesystem();
-
         mkdir(Hyde::path('_media/foo'));
         touch(Hyde::path('_media/foo/bar.txt'));
 
@@ -212,11 +198,7 @@ public function testToArrayWithFileInSubdirectory()
 
     public function testGetContentLength()
     {
-        $this->mockFilesystem([
-            'missing' => false,
-            'size' => 12,
-        ]);
-
+        $this->file('_media/foo', 'Hello World!');
         $this->assertSame(12, MediaFile::make('foo')->getContentLength());
     }
 
@@ -228,8 +210,6 @@ public function testGetContentLengthWithEmptyFile()
 
     public function testGetContentLengthWithDirectory()
     {
-        $this->withoutMockingFilesystem();
-
         $this->directory('_media/foo');
 
         $this->expectException(FileNotFoundException::class);
@@ -374,14 +354,4 @@ public function testGetHash()
 
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
-
-    protected function mockFilesystem(array $methods): void
-    {
-        app()->instance(BaseFilesystem::class, Mockery::mock(BaseFilesystem::class, $methods));
-    }
-
-    protected function withoutMockingFilesystem(): void
-    {
-        app()->forgetInstance(BaseFilesystem::class);
-    }
 }

From 2eb56a9cd20aec28108cc931721b1c0603d1bf69 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:50:53 +0200
Subject: [PATCH 2949/4023] Revert "Files should receive missing and return
 false"

This reverts commit 21340c90529c7e4335bab80c1ba9216ccab8665a.
---
 packages/framework/tests/Unit/Support/MediaFileTest.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index efdbe12b859..a0efbf73091 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -5,7 +5,6 @@
 namespace Hyde\Framework\Testing\Unit\Support;
 
 use Hyde\Facades\Filesystem;
-use Illuminate\Support\Facades\File;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
@@ -22,13 +21,6 @@ class MediaFileTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        File::shouldReceive('missing')->andReturn(false);
-    }
-
     protected function tearDown(): void
     {
         $this->cleanUpFilesystem();

From 000f19a1e9fb5ed5e8ed6f8ca6642eb23264ef9c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:54:39 +0200
Subject: [PATCH 2950/4023] Create public internal static property to control
 validation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 445748f9f46..94495885257 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -29,12 +29,15 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
+    /** @internal Controls whether to validate the existence of the file. Turning this off may lead to unexpected behavior. */
+    public static bool $validateExistence = true;
+
     public function __construct(string $path)
     {
         $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
         $path = static::sourcePath($path);
 
-        if (Filesystem::missing($path)) {
+        if (static::$validateExistence && Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
         }
 

From 21df2e36039e5596a078c17412d8aeb951fbc524 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:55:30 +0200
Subject: [PATCH 2951/4023] Disable existence validation during unit tests

---
 .../tests/Unit/Foundation/FilesystemHasMediaFilesTest.php  | 7 +++++++
 packages/framework/tests/Unit/Support/MediaFileTest.php    | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index 594e6966bcf..f55345c8487 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -24,6 +24,13 @@ protected function setUp(): void
     {
         parent::setUp();
         $this->filesystem = new TestableFilesystem(Hyde::getInstance());
+        MediaFile::$validateExistence = false;
+    }
+
+    protected function tearDown(): void
+    {
+        parent::tearDown();
+        MediaFile::$validateExistence = true;
     }
 
     public function testAssetsMethodReturnsSameInstanceOnSubsequentCalls()
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index a0efbf73091..c9efd3452b4 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -21,9 +21,16 @@ class MediaFileTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected function setUp(): void
+    {
+        MediaFile::$validateExistence = false;
+    }
+
     protected function tearDown(): void
     {
         $this->cleanUpFilesystem();
+
+        MediaFile::$validateExistence = true;
     }
 
     /** @deprecated */

From bfda13398798420d1ef22a21c8f357f103c91a63 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 14:31:35 +0200
Subject: [PATCH 2952/4023] Normalize paths using output directory to have
 source directory prefix

---
 .../src/Support/Filesystem/MediaFile.php       |  9 ++++++++-
 .../tests/Unit/Support/MediaFileTest.php       | 18 ++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 94495885257..1cf472168cd 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -34,7 +34,14 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = trim_slashes(Str::after(Hyde::pathToRelative($path), Hyde::getMediaDirectory()));
+        $path = Hyde::pathToRelative($path);
+
+        // Normalize paths using output directory to have source directory prefix
+        if (str_starts_with($path, Hyde::getMediaOutputDirectory()) && str_starts_with(Hyde::getMediaDirectory(), '_')) {
+            $path = '_'.$path;
+        }
+
+        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
         $path = static::sourcePath($path);
 
         if (static::$validateExistence && Filesystem::missing($path)) {
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index c9efd3452b4..aa39a7a51a9 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -108,6 +108,16 @@ public function testAbsoluteMediaPathIsNormalizedToRelativeMediaPath()
         $this->assertSame('_media/foo', MediaFile::make(Hyde::path('_media/foo'))->path);
     }
 
+    public function testOutputMediaPathIsNormalizedToRelativeMediaPath()
+    {
+        $this->assertSame('_media/foo', MediaFile::make('media/foo')->path);
+    }
+
+    public function testAbsoluteOutputMediaPathIsNormalizedToRelativeMediaPath()
+    {
+        $this->assertSame('_media/foo', MediaFile::make(Hyde::path('media/foo'))->path);
+    }
+
     public function testCustomMediaPathsAreNormalizedToRelativeCustomizedMediaPath()
     {
         Hyde::setMediaDirectory('bar');
@@ -116,6 +126,14 @@ public function testCustomMediaPathsAreNormalizedToRelativeCustomizedMediaPath()
         $this->assertSame('bar/foo', MediaFile::make('bar/foo')->path);
         $this->assertSame('bar/foo', MediaFile::make(Hyde::path('foo'))->path);
 
+        Hyde::setMediaDirectory('_bar');
+
+        $this->assertSame('_bar/foo', MediaFile::make('foo')->path);
+        $this->assertSame('_bar/foo', MediaFile::make('_bar/foo')->path);
+        $this->assertSame('_bar/foo', MediaFile::make(Hyde::path('_bar/foo'))->path);
+        $this->assertSame('_bar/foo', MediaFile::make('bar/foo')->path);
+        $this->assertSame('_bar/foo', MediaFile::make(Hyde::path('foo'))->path);
+
         Hyde::setMediaDirectory('_media');
     }
 

From 13266594d8cd401e4e6d2ec1e8a314014fb4b7a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 13:56:48 +0200
Subject: [PATCH 2953/4023] Test existence validation

---
 .../tests/Unit/Support/MediaFileTest.php      | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index aa39a7a51a9..d774c47e0f4 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -371,4 +371,23 @@ public function testGetHash()
 
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
+
+    public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
+    {
+        MediaFile::$validateExistence = true;
+
+        $this->expectException(FileNotFoundException::class);
+        $this->expectExceptionMessage('File [_media/foo] not found.');
+
+        MediaFile::make('foo');
+    }
+
+    public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
+    {
+        MediaFile::$validateExistence = true;
+
+        $this->file('_media/foo', 'Hello World!');
+
+        $this->assertInstanceOf(MediaFile::class, MediaFile::make('foo'));
+    }
 }

From 0ccec37131d1d87a468a70616707c1986c1e6797 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 14:42:44 +0200
Subject: [PATCH 2954/4023] Remove content length validation now performed at
 construct time

---
 .../src/Support/Filesystem/MediaFile.php       |  5 -----
 .../tests/Unit/Support/MediaFileTest.php       | 18 ------------------
 2 files changed, 23 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1cf472168cd..3d3ff974168 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -19,7 +19,6 @@
 use function array_merge;
 use function filesize;
 use function pathinfo;
-use function is_file;
 
 /**
  * File abstraction for a project media file.
@@ -106,10 +105,6 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
-        if (! is_file($this->getAbsolutePath())) {
-            throw new FileNotFoundException($this->path);
-        }
-
         return filesize($this->getAbsolutePath());
     }
 
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index d774c47e0f4..6d82881a2d0 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -225,24 +225,6 @@ public function testGetContentLengthWithEmptyFile()
         $this->assertSame(0, MediaFile::make('foo')->getContentLength());
     }
 
-    public function testGetContentLengthWithDirectory()
-    {
-        $this->directory('_media/foo');
-
-        $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [_media/foo] not found.');
-
-        MediaFile::make('foo')->getContentLength();
-    }
-
-    public function testGetContentLengthWithNonExistentFile()
-    {
-        $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [_media/foo] not found.');
-
-        MediaFile::make('foo')->getContentLength();
-    }
-
     public function testGetMimeType()
     {
         $this->file('_media/foo.txt', 'Hello World!');

From 9a7f58b16eb32e13fb123c6895ddb641c375ad0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 14:51:45 +0200
Subject: [PATCH 2955/4023] Extract method to normalize path

---
 .../src/Support/Filesystem/MediaFile.php      | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3d3ff974168..e543da54f1a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -33,15 +33,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = Hyde::pathToRelative($path);
-
-        // Normalize paths using output directory to have source directory prefix
-        if (str_starts_with($path, Hyde::getMediaOutputDirectory()) && str_starts_with(Hyde::getMediaDirectory(), '_')) {
-            $path = '_'.$path;
-        }
-
-        $path = trim_slashes(Str::after($path, Hyde::getMediaDirectory()));
-        $path = static::sourcePath($path);
+        $path = $this->normalizePath($path);
 
         if (static::$validateExistence && Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
@@ -152,4 +144,16 @@ public static function getCacheBustKey(string $file): string
             ? '?v='.static::make($file)->getHash()
             : '';
     }
+
+    protected function normalizePath(string $path): string
+    {
+        $path = Hyde::pathToRelative($path);
+
+        // Normalize paths using output directory to have source directory prefix
+        if (str_starts_with($path, Hyde::getMediaOutputDirectory()) && str_starts_with(Hyde::getMediaDirectory(), '_')) {
+            $path = '_'.$path;
+        }
+
+        return static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
+    }
 }

From 5f037217327f2d813f88502cca2d484829e9991e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 14:57:20 +0200
Subject: [PATCH 2956/4023] Set metadata properties at construct time

---
 .../framework/src/Support/Filesystem/MediaFile.php     | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e543da54f1a..b33a4d6b66e 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -31,6 +31,10 @@ class MediaFile extends ProjectFile
     /** @internal Controls whether to validate the existence of the file. Turning this off may lead to unexpected behavior. */
     public static bool $validateExistence = true;
 
+    protected int $length;
+    protected string $mimeType;
+    protected string $hash;
+
     public function __construct(string $path)
     {
         $path = $this->normalizePath($path);
@@ -40,6 +44,12 @@ public function __construct(string $path)
         }
 
         parent::__construct($path);
+
+        if (is_file($this->getAbsolutePath())) {
+            $this->length = filesize($this->getAbsolutePath());
+            $this->mimeType = $this->getMimeType();
+            $this->hash = $this->getHash();
+        }
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */

From 937917f4dca94bf39e6a823f86c44a2cee916f48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 15:15:34 +0200
Subject: [PATCH 2957/4023] Return value when set

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index b33a4d6b66e..2c88ffc74a9 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -107,6 +107,10 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
+        if (isset($this->length)) {
+            return $this->length;
+        }
+
         return filesize($this->getAbsolutePath());
     }
 

From cb37c4e05b335c72d178eb2c756ff80469ccb407 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 15:15:50 +0200
Subject: [PATCH 2958/4023] Return value when set

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 2c88ffc74a9..0dd583ba96a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -116,6 +116,10 @@ public function getContentLength(): int
 
     public function getMimeType(): string
     {
+        if (isset($this->mimeType)) {
+            return $this->mimeType;
+        }
+
         $extension = pathinfo($this->getAbsolutePath(), PATHINFO_EXTENSION);
 
         // See if we can find a mime type for the extension instead of

From 523051fa8b026445e37afba6f78eac725425700c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 15:16:04 +0200
Subject: [PATCH 2959/4023] Return value when set

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 0dd583ba96a..15071dabf63 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -152,6 +152,10 @@ public function getMimeType(): string
 
     public function getHash(): string
     {
+        if (isset($this->hash)) {
+            return $this->hash;
+        }
+
         return hash_file('crc32', $this->getAbsolutePath());
     }
 

From e3104fb087cafa6bdff8f55560da25770abbbc59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 16:03:57 +0200
Subject: [PATCH 2960/4023] Assume value is set

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 15071dabf63..e5da6935844 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -107,11 +107,7 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
-        if (isset($this->length)) {
-            return $this->length;
-        }
-
-        return filesize($this->getAbsolutePath());
+        return $this->length;
     }
 
     public function getMimeType(): string

From 134d24e8a923af356b671d42d4551fad9138061f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 17:23:40 +0200
Subject: [PATCH 2961/4023] Revert "Assume value is set"

This reverts commit e3104fb087cafa6bdff8f55560da25770abbbc59.
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e5da6935844..15071dabf63 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -107,7 +107,11 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
-        return $this->length;
+        if (isset($this->length)) {
+            return $this->length;
+        }
+
+        return filesize($this->getAbsolutePath());
     }
 
     public function getMimeType(): string

From 8b9de19736624406c8c2848d52835356918316e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 17:34:48 +0200
Subject: [PATCH 2962/4023] Find all media file metadata at construct time

---
 .../src/Support/Filesystem/MediaFile.php      | 73 ++++++++++---------
 .../tests/Unit/Support/MediaFileTest.php      |  2 +
 2 files changed, 40 insertions(+), 35 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 15071dabf63..8efd9e2f169 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -46,9 +46,9 @@ public function __construct(string $path)
         parent::__construct($path);
 
         if (is_file($this->getAbsolutePath())) {
-            $this->length = filesize($this->getAbsolutePath());
-            $this->mimeType = $this->getMimeType();
-            $this->hash = $this->getHash();
+            $this->length = $this->findContentLength();
+            $this->mimeType = $this->findMimeType();
+            $this->hash = $this->findHash();
         }
     }
 
@@ -107,19 +107,46 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
-        if (isset($this->length)) {
-            return $this->length;
-        }
-
-        return filesize($this->getAbsolutePath());
+        return $this->length;
     }
 
     public function getMimeType(): string
     {
-        if (isset($this->mimeType)) {
-            return $this->mimeType;
+        return $this->mimeType;
+    }
+
+    public function getHash(): string
+    {
+        return $this->hash;
+    }
+
+    /** @internal */
+    public static function getCacheBustKey(string $file): string
+    {
+        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(static::sourcePath("$file"))
+            ? '?v='.static::make($file)->getHash()
+            : '';
+    }
+
+    protected function normalizePath(string $path): string
+    {
+        $path = Hyde::pathToRelative($path);
+
+        // Normalize paths using output directory to have source directory prefix
+        if (str_starts_with($path, Hyde::getMediaOutputDirectory()) && str_starts_with(Hyde::getMediaDirectory(), '_')) {
+            $path = '_'.$path;
         }
 
+        return static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
+    }
+
+    protected function findContentLength(): int
+    {
+        return filesize($this->getAbsolutePath());
+    }
+
+    protected function findMimeType(): string
+    {
         $extension = pathinfo($this->getAbsolutePath(), PATHINFO_EXTENSION);
 
         // See if we can find a mime type for the extension instead of
@@ -150,32 +177,8 @@ public function getMimeType(): string
         return 'text/plain';
     }
 
-    public function getHash(): string
+    protected function findHash(): string
     {
-        if (isset($this->hash)) {
-            return $this->hash;
-        }
-
         return hash_file('crc32', $this->getAbsolutePath());
     }
-
-    /** @internal */
-    public static function getCacheBustKey(string $file): string
-    {
-        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(static::sourcePath("$file"))
-            ? '?v='.static::make($file)->getHash()
-            : '';
-    }
-
-    protected function normalizePath(string $path): string
-    {
-        $path = Hyde::pathToRelative($path);
-
-        // Normalize paths using output directory to have source directory prefix
-        if (str_starts_with($path, Hyde::getMediaOutputDirectory()) && str_starts_with(Hyde::getMediaDirectory(), '_')) {
-            $path = '_'.$path;
-        }
-
-        return static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
-    }
 }
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 6d82881a2d0..04369d9d514 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -245,12 +245,14 @@ public function testGetMimeTypeWithEmptyFile()
 
     public function testGetMimeTypeWithDirectory()
     {
+        $this->markTestSkipped('Undecided on what should happen here.');
         $this->directory('_media/foo');
         $this->assertSame('directory', MediaFile::make('foo')->getMimeType());
     }
 
     public function testGetMimeTypeWithNonExistentFile()
     {
+        $this->markTestSkipped('Undecided on what should happen here.');
         $this->assertSame('text/plain', MediaFile::make('foo')->getMimeType());
     }
 

From d4a9390f967f63c478a14c40f6a2709b2e05b702 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 17:37:58 +0200
Subject: [PATCH 2963/4023] Remove tests for weird edge cases with no benefit

---
 .../framework/tests/Unit/Support/MediaFileTest.php  | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileTest.php
index 04369d9d514..6b2a1d10fc8 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileTest.php
@@ -243,19 +243,6 @@ public function testGetMimeTypeWithEmptyFile()
         $this->assertSame('application/x-empty', MediaFile::make('foo')->getMimeType());
     }
 
-    public function testGetMimeTypeWithDirectory()
-    {
-        $this->markTestSkipped('Undecided on what should happen here.');
-        $this->directory('_media/foo');
-        $this->assertSame('directory', MediaFile::make('foo')->getMimeType());
-    }
-
-    public function testGetMimeTypeWithNonExistentFile()
-    {
-        $this->markTestSkipped('Undecided on what should happen here.');
-        $this->assertSame('text/plain', MediaFile::make('foo')->getMimeType());
-    }
-
     public function testAllHelperReturnsAllMediaFiles()
     {
         $this->assertEquals([

From 39d5169da36e26ae608b4c67199240cc518268f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:10:04 +0200
Subject: [PATCH 2964/4023] Split out unit test and feature test

---
 .../tests/Feature/Support/MediaFileTest.php   | 23 +++++++++++++++++++
 ...ediaFileTest.php => MediaFileUnitTest.php} |  4 +++-
 2 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 packages/framework/tests/Feature/Support/MediaFileTest.php
 rename packages/framework/tests/Unit/Support/{MediaFileTest.php => MediaFileUnitTest.php} (99%)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
new file mode 100644
index 00000000000..f1c6a0a74dd
--- /dev/null
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature\Support;
+
+use Hyde\Hyde;
+use Hyde\Testing\TestCase;
+use Hyde\Facades\Filesystem;
+use Hyde\Testing\UnitTestCase;
+use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Testing\CreatesTemporaryFiles;
+use Hyde\Framework\Exceptions\FileNotFoundException;
+
+/**
+ * @covers \Hyde\Support\Filesystem\MediaFile
+ *
+ * @see \Hyde\Framework\Testing\Unit\Support\MediaFileUnitTest
+ */
+class MediaFileTest extends TestCase
+{
+    //
+}
diff --git a/packages/framework/tests/Unit/Support/MediaFileTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
similarity index 99%
rename from packages/framework/tests/Unit/Support/MediaFileTest.php
rename to packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 6b2a1d10fc8..af0fa5546bd 100644
--- a/packages/framework/tests/Unit/Support/MediaFileTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -13,8 +13,10 @@
 
 /**
  * @covers \Hyde\Support\Filesystem\MediaFile
+ *
+ * @see \Hyde\Framework\Testing\Feature\Support\MediaFileTest
  */
-class MediaFileTest extends UnitTestCase
+class MediaFileUnitTest extends UnitTestCase
 {
     use CreatesTemporaryFiles;
 

From df1bc7c74b918dacc8e9874073f8090a2fcc8393 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:12:39 +0200
Subject: [PATCH 2965/4023] Generate feature test with Claude

---
 .../tests/Feature/Support/MediaFileTest.php   | 96 ++++++++++++++++++-
 1 file changed, 95 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index f1c6a0a74dd..d336b54fe2a 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -19,5 +19,99 @@
  */
 class MediaFileTest extends TestCase
 {
-    //
+    public function testMediaFileCreationAndBasicProperties()
+    {
+        $this->file('_media/test.txt', 'Hello, World!');
+
+        $mediaFile = MediaFile::make('test.txt');
+
+        $this->assertInstanceOf(MediaFile::class, $mediaFile);
+        $this->assertEquals('test.txt', $mediaFile->getName());
+        $this->assertEquals('_media/test.txt', $mediaFile->getPath());
+        $this->assertEquals(Hyde::path('_media/test.txt'), $mediaFile->getAbsolutePath());
+        $this->assertEquals('Hello, World!', $mediaFile->getContents());
+        $this->assertEquals('txt', $mediaFile->getExtension());
+    }
+
+    public function testMediaFileDiscovery()
+    {
+        $this->file('_media/image.png', 'PNG content');
+        $this->file('_media/style.css', 'CSS content');
+        $this->file('_media/script.js', 'JS content');
+
+        $allFiles = MediaFile::all();
+
+        $this->assertCount(3, $allFiles);
+        $this->assertArrayHasKey('image.png', $allFiles);
+        $this->assertArrayHasKey('style.css', $allFiles);
+        $this->assertArrayHasKey('script.js', $allFiles);
+
+        $fileNames = MediaFile::files();
+        $this->assertEquals(['image.png', 'style.css', 'script.js'], $fileNames);
+    }
+
+    public function testMediaFileProperties()
+    {
+        $content = str_repeat('a', 1024); // 1KB content
+        $this->file('_media/large_file.txt', $content);
+
+        $mediaFile = MediaFile::make('large_file.txt');
+
+        $this->assertEquals(1024, $mediaFile->getContentLength());
+        $this->assertEquals('text/plain', $mediaFile->getMimeType());
+        $this->assertEquals(hash('crc32', $content), $mediaFile->getHash());
+    }
+
+    public function testMediaFilePathHandling()
+    {
+        $this->file('_media/subfolder/nested_file.txt', 'Nested content');
+
+        $mediaFile = MediaFile::make('subfolder/nested_file.txt');
+
+        $this->assertEquals('subfolder/nested_file.txt', $mediaFile->getIdentifier());
+        $this->assertEquals('_media/subfolder/nested_file.txt', $mediaFile->getPath());
+    }
+
+    public function testMediaFileExceptionHandling()
+    {
+        MediaFile::$validateExistence = true;
+
+        $this->expectException(FileNotFoundException::class);
+        MediaFile::make('non_existent_file.txt');
+    }
+
+    public function testMediaDirectoryCustomization()
+    {
+        Hyde::setMediaDirectory('custom_media');
+
+        $this->file('custom_media/custom_file.txt', 'Custom content');
+
+        $mediaFile = MediaFile::make('custom_file.txt');
+
+        $this->assertEquals('custom_media/custom_file.txt', $mediaFile->getPath());
+        $this->assertEquals(Hyde::path('custom_media/custom_file.txt'), $mediaFile->getAbsolutePath());
+
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testMediaFileOutputPaths()
+    {
+        $this->assertEquals(Hyde::path('_site/media'), MediaFile::outputPath());
+        $this->assertEquals(Hyde::path('_site/media/test.css'), MediaFile::outputPath('test.css'));
+
+        Hyde::setOutputDirectory('custom_output');
+        $this->assertEquals(Hyde::path('custom_output/media'), MediaFile::outputPath());
+
+        Hyde::setOutputDirectory('_site'); // Reset to default
+    }
+
+    public function testMediaFileCacheBusting()
+    {
+        $this->file('_media/cachebust_test.js', 'console.log("Hello");');
+
+        $cacheBustKey = MediaFile::getCacheBustKey('cachebust_test.js');
+
+        $this->assertStringStartsWith('?v=', $cacheBustKey);
+        $this->assertNotEquals('?v=', $cacheBustKey); // Ensure it's not empty
+    }
 }

From 84591e4c517d3ebc9a626ece56765238dba26958 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:12:49 +0200
Subject: [PATCH 2966/4023] Fix all 'Unused import' problems in file

---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index d336b54fe2a..06caf8059e3 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -6,10 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
-use Hyde\Facades\Filesystem;
-use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Filesystem\MediaFile;
-use Hyde\Testing\CreatesTemporaryFiles;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**

From ec8099b8b5ec2c48403f6ff3d91a1bf0ad9850d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:13:34 +0200
Subject: [PATCH 2967/4023] Expect default file

---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 06caf8059e3..8d05f889096 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -32,19 +32,20 @@ public function testMediaFileCreationAndBasicProperties()
 
     public function testMediaFileDiscovery()
     {
+        // App.css is a default file
         $this->file('_media/image.png', 'PNG content');
         $this->file('_media/style.css', 'CSS content');
         $this->file('_media/script.js', 'JS content');
 
         $allFiles = MediaFile::all();
 
-        $this->assertCount(3, $allFiles);
+        $this->assertCount(4, $allFiles);
         $this->assertArrayHasKey('image.png', $allFiles);
         $this->assertArrayHasKey('style.css', $allFiles);
         $this->assertArrayHasKey('script.js', $allFiles);
 
         $fileNames = MediaFile::files();
-        $this->assertEquals(['image.png', 'style.css', 'script.js'], $fileNames);
+        $this->assertEquals(['image.png', 'app.css', 'style.css', 'script.js'], $fileNames);
     }
 
     public function testMediaFileProperties()

From d819bff24fcfb74159cd19135eef65b8923bd819 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:14:05 +0200
Subject: [PATCH 2968/4023] Remove setter for already default value

---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 8d05f889096..db9f789f012 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -72,8 +72,6 @@ public function testMediaFilePathHandling()
 
     public function testMediaFileExceptionHandling()
     {
-        MediaFile::$validateExistence = true;
-
         $this->expectException(FileNotFoundException::class);
         MediaFile::make('non_existent_file.txt');
     }

From c51915e921a02ff75c0e8644bef6960666fcef29 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:14:52 +0200
Subject: [PATCH 2969/4023] Expect CRC32 hash

---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index db9f789f012..f68cc16dab1 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -108,6 +108,6 @@ public function testMediaFileCacheBusting()
         $cacheBustKey = MediaFile::getCacheBustKey('cachebust_test.js');
 
         $this->assertStringStartsWith('?v=', $cacheBustKey);
-        $this->assertNotEquals('?v=', $cacheBustKey); // Ensure it's not empty
+        $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect crc32 hash
     }
 }

From 36f3545ba04895971c1df3ee9f277c3a8bf77ac9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:16:04 +0200
Subject: [PATCH 2970/4023] Cleanup test code comments

---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index f68cc16dab1..8daf91809ab 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -87,7 +87,7 @@ public function testMediaDirectoryCustomization()
         $this->assertEquals('custom_media/custom_file.txt', $mediaFile->getPath());
         $this->assertEquals(Hyde::path('custom_media/custom_file.txt'), $mediaFile->getAbsolutePath());
 
-        Hyde::setMediaDirectory('_media'); // Reset to default
+        Hyde::setMediaDirectory('_media');
     }
 
     public function testMediaFileOutputPaths()
@@ -98,7 +98,7 @@ public function testMediaFileOutputPaths()
         Hyde::setOutputDirectory('custom_output');
         $this->assertEquals(Hyde::path('custom_output/media'), MediaFile::outputPath());
 
-        Hyde::setOutputDirectory('_site'); // Reset to default
+        Hyde::setOutputDirectory('_site');
     }
 
     public function testMediaFileCacheBusting()
@@ -108,6 +108,6 @@ public function testMediaFileCacheBusting()
         $cacheBustKey = MediaFile::getCacheBustKey('cachebust_test.js');
 
         $this->assertStringStartsWith('?v=', $cacheBustKey);
-        $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect crc32 hash
+        $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect CRC32 hash
     }
 }

From 3a1c66bbd6a07ae1c4b923007713d4a947d79fc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:16:08 +0200
Subject: [PATCH 2971/4023] Use assert same instead of assert equals

---
 .../tests/Feature/Support/MediaFileTest.php   | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 8daf91809ab..a82e6f71456 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -23,11 +23,11 @@ public function testMediaFileCreationAndBasicProperties()
         $mediaFile = MediaFile::make('test.txt');
 
         $this->assertInstanceOf(MediaFile::class, $mediaFile);
-        $this->assertEquals('test.txt', $mediaFile->getName());
-        $this->assertEquals('_media/test.txt', $mediaFile->getPath());
-        $this->assertEquals(Hyde::path('_media/test.txt'), $mediaFile->getAbsolutePath());
-        $this->assertEquals('Hello, World!', $mediaFile->getContents());
-        $this->assertEquals('txt', $mediaFile->getExtension());
+        $this->assertSame('test.txt', $mediaFile->getName());
+        $this->assertSame('_media/test.txt', $mediaFile->getPath());
+        $this->assertSame(Hyde::path('_media/test.txt'), $mediaFile->getAbsolutePath());
+        $this->assertSame('Hello, World!', $mediaFile->getContents());
+        $this->assertSame('txt', $mediaFile->getExtension());
     }
 
     public function testMediaFileDiscovery()
@@ -45,7 +45,7 @@ public function testMediaFileDiscovery()
         $this->assertArrayHasKey('script.js', $allFiles);
 
         $fileNames = MediaFile::files();
-        $this->assertEquals(['image.png', 'app.css', 'style.css', 'script.js'], $fileNames);
+        $this->assertSame(['image.png', 'app.css', 'style.css', 'script.js'], $fileNames);
     }
 
     public function testMediaFileProperties()
@@ -55,9 +55,9 @@ public function testMediaFileProperties()
 
         $mediaFile = MediaFile::make('large_file.txt');
 
-        $this->assertEquals(1024, $mediaFile->getContentLength());
-        $this->assertEquals('text/plain', $mediaFile->getMimeType());
-        $this->assertEquals(hash('crc32', $content), $mediaFile->getHash());
+        $this->assertSame(1024, $mediaFile->getContentLength());
+        $this->assertSame('text/plain', $mediaFile->getMimeType());
+        $this->assertSame(hash('crc32', $content), $mediaFile->getHash());
     }
 
     public function testMediaFilePathHandling()
@@ -66,8 +66,8 @@ public function testMediaFilePathHandling()
 
         $mediaFile = MediaFile::make('subfolder/nested_file.txt');
 
-        $this->assertEquals('subfolder/nested_file.txt', $mediaFile->getIdentifier());
-        $this->assertEquals('_media/subfolder/nested_file.txt', $mediaFile->getPath());
+        $this->assertSame('subfolder/nested_file.txt', $mediaFile->getIdentifier());
+        $this->assertSame('_media/subfolder/nested_file.txt', $mediaFile->getPath());
     }
 
     public function testMediaFileExceptionHandling()
@@ -84,19 +84,19 @@ public function testMediaDirectoryCustomization()
 
         $mediaFile = MediaFile::make('custom_file.txt');
 
-        $this->assertEquals('custom_media/custom_file.txt', $mediaFile->getPath());
-        $this->assertEquals(Hyde::path('custom_media/custom_file.txt'), $mediaFile->getAbsolutePath());
+        $this->assertSame('custom_media/custom_file.txt', $mediaFile->getPath());
+        $this->assertSame(Hyde::path('custom_media/custom_file.txt'), $mediaFile->getAbsolutePath());
 
         Hyde::setMediaDirectory('_media');
     }
 
     public function testMediaFileOutputPaths()
     {
-        $this->assertEquals(Hyde::path('_site/media'), MediaFile::outputPath());
-        $this->assertEquals(Hyde::path('_site/media/test.css'), MediaFile::outputPath('test.css'));
+        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
+        $this->assertSame(Hyde::path('_site/media/test.css'), MediaFile::outputPath('test.css'));
 
         Hyde::setOutputDirectory('custom_output');
-        $this->assertEquals(Hyde::path('custom_output/media'), MediaFile::outputPath());
+        $this->assertSame(Hyde::path('custom_output/media'), MediaFile::outputPath());
 
         Hyde::setOutputDirectory('_site');
     }

From 521df1ea6cca43274443c48cf4268d4f1a4c3337 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:17:33 +0200
Subject: [PATCH 2972/4023] Assert on the array

---
 .../framework/tests/Feature/Support/MediaFileTest.php     | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index a82e6f71456..df8756e6551 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -28,6 +28,14 @@ public function testMediaFileCreationAndBasicProperties()
         $this->assertSame(Hyde::path('_media/test.txt'), $mediaFile->getAbsolutePath());
         $this->assertSame('Hello, World!', $mediaFile->getContents());
         $this->assertSame('txt', $mediaFile->getExtension());
+
+        $this->assertSame([
+            'name' => 'test.txt',
+            'path' => '_media/test.txt',
+            'length' => 13,
+            'mimeType' => 'text/plain',
+            'hash' => 'dffed8e6',
+        ], $mediaFile->toArray());
     }
 
     public function testMediaFileDiscovery()

From 77722257a228f911861f778a5dd062f98f64f461 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:39:56 +0200
Subject: [PATCH 2973/4023] Bypass discovery to isolate unit test

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 6dac17db2f5..74818e459e8 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,12 +9,17 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
+use Illuminate\Support\Collection;
 use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 use Hyde\Testing\MocksKernelFeatures;
+use Hyde\Foundation\Kernel\FileCollection;
+use Hyde\Foundation\Kernel\PageCollection;
+use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -37,6 +42,22 @@ protected function setUp(): void
         $this->setupTestKernel();
         $this->kernel->setRoutes(collect());
         Render::swap(new RenderData());
+
+        HydeKernel::setInstance(new class extends HydeKernel
+        {
+            // Bypass discovery to isolate test
+            public function boot(): void
+            {
+                $this->files = FileCollection::init($this);
+                $this->pages = PageCollection::init($this);
+                $this->routes = RouteCollection::init($this);
+            }
+
+            public function assets(): Collection
+            {
+                return collect();
+            }
+        });
     }
 
     protected function tearDown(): void

From 1f28f2123133f1499b2f783e2eff0a1de343494c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:25:48 +0200
Subject: [PATCH 2974/4023] Refactor media file class to use the Filesystem
 facade

This makes unit testing easier as it's mockable
---
 .../src/Support/Filesystem/MediaFile.php        | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 8efd9e2f169..aa703d81bdc 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -15,10 +15,7 @@
 use function Hyde\path_join;
 use function Hyde\trim_slashes;
 use function extension_loaded;
-use function file_exists;
 use function array_merge;
-use function filesize;
-use function pathinfo;
 
 /**
  * File abstraction for a project media file.
@@ -45,7 +42,7 @@ public function __construct(string $path)
 
         parent::__construct($path);
 
-        if (is_file($this->getAbsolutePath())) {
+        if (Filesystem::isFile($this->getAbsolutePath())) {
             $this->length = $this->findContentLength();
             $this->mimeType = $this->findMimeType();
             $this->hash = $this->findHash();
@@ -123,7 +120,7 @@ public function getHash(): string
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {
-        return Config::getBool('hyde.enable_cache_busting', true) && file_exists(static::sourcePath("$file"))
+        return Config::getBool('hyde.enable_cache_busting', true) && Filesystem::exists(static::sourcePath("$file"))
             ? '?v='.static::make($file)->getHash()
             : '';
     }
@@ -142,12 +139,12 @@ protected function normalizePath(string $path): string
 
     protected function findContentLength(): int
     {
-        return filesize($this->getAbsolutePath());
+        return Filesystem::size($this->getAbsolutePath());
     }
 
     protected function findMimeType(): string
     {
-        $extension = pathinfo($this->getAbsolutePath(), PATHINFO_EXTENSION);
+        $extension = Filesystem::extension($this->getAbsolutePath());
 
         // See if we can find a mime type for the extension instead of
         // having to rely on a PHP extension and filesystem lookups.
@@ -170,8 +167,8 @@ protected function findMimeType(): string
             return $lookup[$extension];
         }
 
-        if (extension_loaded('fileinfo') && file_exists($this->getAbsolutePath())) {
-            return mime_content_type($this->getAbsolutePath());
+        if (extension_loaded('fileinfo') && Filesystem::exists($this->getAbsolutePath())) {
+            return Filesystem::mimeType($this->getAbsolutePath());
         }
 
         return 'text/plain';
@@ -179,6 +176,6 @@ protected function findMimeType(): string
 
     protected function findHash(): string
     {
-        return hash_file('crc32', $this->getAbsolutePath());
+        return Filesystem::hash($this->getAbsolutePath(), 'crc32');
     }
 }

From bc4c511b5d0657a2fbd4bbea608518d756bfae0f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:27:02 +0200
Subject: [PATCH 2975/4023] No need to qualify path handled by Filesystem
 facade

---
 .../framework/src/Support/Filesystem/MediaFile.php   | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index aa703d81bdc..24e45f3a5c8 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -42,7 +42,7 @@ public function __construct(string $path)
 
         parent::__construct($path);
 
-        if (Filesystem::isFile($this->getAbsolutePath())) {
+        if (Filesystem::isFile($this->getPath())) {
             $this->length = $this->findContentLength();
             $this->mimeType = $this->findMimeType();
             $this->hash = $this->findHash();
@@ -139,12 +139,12 @@ protected function normalizePath(string $path): string
 
     protected function findContentLength(): int
     {
-        return Filesystem::size($this->getAbsolutePath());
+        return Filesystem::size($this->getPath());
     }
 
     protected function findMimeType(): string
     {
-        $extension = Filesystem::extension($this->getAbsolutePath());
+        $extension = Filesystem::extension($this->getPath());
 
         // See if we can find a mime type for the extension instead of
         // having to rely on a PHP extension and filesystem lookups.
@@ -167,8 +167,8 @@ protected function findMimeType(): string
             return $lookup[$extension];
         }
 
-        if (extension_loaded('fileinfo') && Filesystem::exists($this->getAbsolutePath())) {
-            return Filesystem::mimeType($this->getAbsolutePath());
+        if (extension_loaded('fileinfo') && Filesystem::exists($this->getPath())) {
+            return Filesystem::mimeType($this->getPath());
         }
 
         return 'text/plain';
@@ -176,6 +176,6 @@ protected function findMimeType(): string
 
     protected function findHash(): string
     {
-        return Filesystem::hash($this->getAbsolutePath(), 'crc32');
+        return Filesystem::hash($this->getPath(), 'crc32');
     }
 }

From 5e3e279c80413a46cd0b20ea157a192d74dafdfb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 20:49:01 +0200
Subject: [PATCH 2976/4023] Prepare unit test for refactor

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 50 +++++--------------
 1 file changed, 13 insertions(+), 37 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index af0fa5546bd..1d63abcb810 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -4,12 +4,14 @@
 
 namespace Hyde\Framework\Testing\Unit\Support;
 
+use Mockery;
 use Hyde\Facades\Filesystem;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Testing\CreatesTemporaryFiles;
+use Illuminate\Filesystem\Filesystem as BaseFilesystem;
 
 /**
  * @covers \Hyde\Support\Filesystem\MediaFile
@@ -18,6 +20,7 @@
  */
 class MediaFileUnitTest extends UnitTestCase
 {
+    // TODO: Use mocks here instead of filesystem operations
     use CreatesTemporaryFiles;
 
     protected static bool $needsKernel = true;
@@ -26,52 +29,20 @@ class MediaFileUnitTest extends UnitTestCase
     protected function setUp(): void
     {
         MediaFile::$validateExistence = false;
+
+        $this->mockFilesystem([
+            'missing' => false,
+        ]);
     }
 
     protected function tearDown(): void
     {
+        // TODO: Use mocks here instead of filesystem operations
         $this->cleanUpFilesystem();
 
         MediaFile::$validateExistence = true;
     }
 
-    /** @deprecated */
-    public function testDiscoveryBenchmark()
-    {
-        $this->markTestSkipped('Uncomment this line to run the benchmark.');
-
-        $urls = [
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/austria.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/boat.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/croatia.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/fireworks.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/hallstatt.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/lemonade.jpg',
-            'https://raw.githubusercontent.com/caendesilva/RandomDatasets/master/Media/photographer.jpg',
-        ];
-
-        foreach ($urls as $url) {
-            $this->file('_media/'.basename($url), file_get_contents($url));
-        }
-
-        $this->file('_media/foo.css', 'body { color: red; }');
-        $this->file('_media/foo.js', 'console.log("Hello, World!");');
-        $this->file('_media/nested/foo.css', 'foo');
-        $this->file('_media/empty.css', '');
-        $this->file('_media/ignored', 'ignored');
-        $this->directory('_media/empty');
-        $this->file('_media/large.css', str_repeat('a', 1024 * 1024 * 10)); // 10 MB
-
-        // Warm up the classloader / cache
-        echo 'Warmup: '.\Illuminate\Support\Benchmark::measure(function () {
-            MediaFile::all();
-        })."ms\n";
-
-        echo 'Benchmark: '.\Illuminate\Support\Benchmark::measure(function () {
-            MediaFile::all();
-        }, 1000)."ms avg/1000/its\n";
-    }
-
     public function testCanConstruct()
     {
         $file = new MediaFile('foo');
@@ -363,4 +334,9 @@ public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
 
         $this->assertInstanceOf(MediaFile::class, MediaFile::make('foo'));
     }
+
+    protected function mockFilesystem(array $methods): void
+    {
+        app()->instance(BaseFilesystem::class, Mockery::mock(BaseFilesystem::class, $methods));
+    }
 }

From 749e3ead3827e4ff2d7330a80fde407507979631 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 22:42:15 +0200
Subject: [PATCH 2977/4023] Refactor unit test to use the filesystem mocks

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 217 +++++-------------
 1 file changed, 63 insertions(+), 154 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 1d63abcb810..cebc5c29fe4 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -5,12 +5,10 @@
 namespace Hyde\Framework\Testing\Unit\Support;
 
 use Mockery;
-use Hyde\Facades\Filesystem;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Testing\CreatesTemporaryFiles;
 use Illuminate\Filesystem\Filesystem as BaseFilesystem;
 
 /**
@@ -20,27 +18,40 @@
  */
 class MediaFileUnitTest extends UnitTestCase
 {
-    // TODO: Use mocks here instead of filesystem operations
-    use CreatesTemporaryFiles;
-
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected $mockFilesystem;
+
     protected function setUp(): void
     {
+        parent::setUp();
+
         MediaFile::$validateExistence = false;
 
-        $this->mockFilesystem([
-            'missing' => false,
-        ]);
+        $this->mockFilesystem = Mockery::mock(BaseFilesystem::class);
+        app()->instance(BaseFilesystem::class, $this->mockFilesystem);
+
+        // Set up default expectations for commonly called methods
+        $this->mockFilesystem->shouldReceive('isFile')->andReturn(true)->byDefault();
+        $this->mockFilesystem->shouldReceive('missing')->andReturn(false)->byDefault();
+        $this->mockFilesystem->shouldReceive('extension')->andReturn('txt')->byDefault();
+        $this->mockFilesystem->shouldReceive('size')->andReturn(12)->byDefault();
+        $this->mockFilesystem->shouldReceive('mimeType')->andReturn('text/plain')->byDefault();
+        $this->mockFilesystem->shouldReceive('hash')->andReturn(hash('crc32', 'Hello World!'))->byDefault();
+        $this->mockFilesystem->shouldReceive('get')->andReturn('Hello World!')->byDefault();
+
+        // Mock Hyde facade
+        $hyde = Mockery::mock(Hyde::kernel())->makePartial();
+        $hyde->shouldReceive('assets')->andReturn(collect(['app.css' => new MediaFile('_media/app.css')]))->byDefault();
     }
 
     protected function tearDown(): void
     {
-        // TODO: Use mocks here instead of filesystem operations
-        $this->cleanUpFilesystem();
+        parent::tearDown();
 
         MediaFile::$validateExistence = true;
+        Mockery::close();
     }
 
     public function testCanConstruct()
@@ -130,22 +141,40 @@ public function testGetAbsolutePathReturnsAbsolutePathOfFile()
 
     public function testGetContentsReturnsContentsOfFile()
     {
-        $this->file('_media/foo.txt', 'foo bar');
+        $this->mockFilesystem->shouldReceive('get')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn('foo bar');
+
         $this->assertSame('foo bar', MediaFile::make('foo.txt')->getContents());
     }
 
     public function testGetExtensionReturnsExtensionOfFile()
     {
-        $this->file('_media/foo.txt', 'foo');
-        $this->assertSame('txt', MediaFile::make('foo.txt')->getExtension());
+        $this->mockFilesystem->shouldReceive('extension')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn('txt');
+
+        $this->mockFilesystem->shouldReceive('extension')
+            ->with(Hyde::path('_media/foo.png'))
+            ->andReturn('png');
 
-        $this->file('_media/foo.png', 'foo');
+        $this->assertSame('txt', MediaFile::make('foo.txt')->getExtension());
         $this->assertSame('png', MediaFile::make('foo.png')->getExtension());
     }
 
     public function testToArrayReturnsArrayOfFileProperties()
     {
-        $this->file('_media/foo.txt', 'foo bar');
+        $this->mockFilesystem->shouldReceive('size')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn(7);
+
+        $this->mockFilesystem->shouldReceive('mimeType')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn('text/plain');
+
+        $this->mockFilesystem->shouldReceive('hash')
+            ->with(Hyde::path('_media/foo.txt'), 'crc32')
+            ->andReturn(hash('crc32', 'foo bar'));
 
         $this->assertSame([
             'name' => 'foo.txt',
@@ -156,64 +185,22 @@ public function testToArrayReturnsArrayOfFileProperties()
         ], MediaFile::make('foo.txt')->toArray());
     }
 
-    public function testToArrayWithEmptyFileWithNoExtension()
-    {
-        $this->file('_media/foo', 'foo bar');
-
-        $this->assertSame([
-            'name' => 'foo',
-            'path' => '_media/foo',
-            'length' => 7,
-            'mimeType' => 'text/plain',
-            'hash' => hash('crc32', 'foo bar'),
-        ], MediaFile::make('foo')->toArray());
-    }
-
-    public function testToArrayWithFileInSubdirectory()
-    {
-        mkdir(Hyde::path('_media/foo'));
-        touch(Hyde::path('_media/foo/bar.txt'));
-
-        $this->assertSame([
-            'name' => 'bar.txt',
-            'path' => '_media/foo/bar.txt',
-            'length' => 0,
-            'mimeType' => 'text/plain',
-            'hash' => hash('crc32', ''),
-        ], MediaFile::make('foo/bar.txt')->toArray());
-
-        Filesystem::unlink('_media/foo/bar.txt');
-        rmdir(Hyde::path('_media/foo'));
-    }
-
     public function testGetContentLength()
     {
-        $this->file('_media/foo', 'Hello World!');
-        $this->assertSame(12, MediaFile::make('foo')->getContentLength());
-    }
+        $this->mockFilesystem->shouldReceive('size')
+            ->with(Hyde::path('_media/foo'))
+            ->andReturn(12);
 
-    public function testGetContentLengthWithEmptyFile()
-    {
-        $this->file('_media/foo', '');
-        $this->assertSame(0, MediaFile::make('foo')->getContentLength());
+        $this->assertSame(12, MediaFile::make('foo')->getContentLength());
     }
 
     public function testGetMimeType()
     {
-        $this->file('_media/foo.txt', 'Hello World!');
-        $this->assertSame('text/plain', MediaFile::make('foo.txt')->getMimeType());
-    }
-
-    public function testGetMimeTypeWithoutExtension()
-    {
-        $this->file('_media/foo', 'Hello World!');
-        $this->assertSame('text/plain', MediaFile::make('foo')->getMimeType());
-    }
+        $this->mockFilesystem->shouldReceive('mimeType')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn('text/plain');
 
-    public function testGetMimeTypeWithEmptyFile()
-    {
-        $this->file('_media/foo', '');
-        $this->assertSame('application/x-empty', MediaFile::make('foo')->getMimeType());
+        $this->assertSame('text/plain', MediaFile::make('foo.txt')->getMimeType());
     }
 
     public function testAllHelperReturnsAllMediaFiles()
@@ -223,95 +210,16 @@ public function testAllHelperReturnsAllMediaFiles()
         ], MediaFile::all()->all());
     }
 
-    public function testAllHelperDoesNotIncludeNonMediaFiles()
-    {
-        $this->file('_media/foo.blade.php');
-
-        $this->assertEquals([
-            'app.css' => new MediaFile('_media/app.css'),
-        ], MediaFile::all()->all());
-    }
-
     public function testFilesHelperReturnsAllMediaFiles()
     {
         $this->assertSame(['app.css'], MediaFile::files());
     }
 
-    public function testGetIdentifierReturnsIdentifier()
+    public function testGetHashReturnsHash()
     {
-        $this->assertSame('foo', MediaFile::make('foo')->getIdentifier());
-    }
-
-    public function testGetIdentifierWithSubdirectory()
-    {
-        $this->assertSame('foo/bar', MediaFile::make('foo/bar')->getIdentifier());
-    }
-
-    public function testGetIdentifierReturnsIdentifierWithFileExtension()
-    {
-        $this->assertSame('foo.png', MediaFile::make('foo.png')->getIdentifier());
-    }
-
-    public function testGetIdentifierWithSubdirectoryWithFileExtension()
-    {
-        $this->assertSame('foo/bar.png', MediaFile::make('foo/bar.png')->getIdentifier());
-    }
-
-    public function testHelperForMediaPath()
-    {
-        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
-    }
-
-    public function testHelperForMediaPathReturnsPathToFileWithinTheDirectory()
-    {
-        $this->assertSame(Hyde::path('_media/foo.css'), MediaFile::sourcePath('foo.css'));
-    }
-
-    public function testGetMediaPathReturnsAbsolutePath()
-    {
-        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath());
-    }
-
-    public function testHelperForMediaOutputPath()
-    {
-        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
-    }
-
-    public function testHelperForMediaOutputPathReturnsPathToFileWithinTheDirectory()
-    {
-        $this->assertSame(Hyde::path('_site/media/foo.css'), MediaFile::outputPath('foo.css'));
-    }
-
-    public function testGetMediaOutputPathReturnsAbsolutePath()
-    {
-        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
-    }
-
-    public function testCanGetSiteMediaOutputDirectory()
-    {
-        $this->assertSame(Hyde::path('_site/media'), MediaFile::outputPath());
-    }
-
-    public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
-    {
-        Hyde::setMediaDirectory('_foo');
-        $this->assertSame(Hyde::path('_site/foo'), MediaFile::outputPath());
-    }
-
-    public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
-    {
-        Hyde::setOutputDirectory(Hyde::path('foo'));
-        Hyde::setMediaDirectory('bar');
-
-        $this->assertSame(Hyde::path('foo/bar'), MediaFile::outputPath());
-
-        Hyde::setOutputDirectory(Hyde::path('_site'));
-        Hyde::setMediaDirectory('_media');
-    }
-
-    public function testGetHash()
-    {
-        $this->file('_media/foo.txt', 'Hello World!');
+        $this->mockFilesystem->shouldReceive('hash')
+            ->with(Hyde::path('_media/foo.txt'), 'crc32')
+            ->andReturn(hash('crc32', 'Hello World!'));
 
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
@@ -320,6 +228,10 @@ public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
     {
         MediaFile::$validateExistence = true;
 
+        $this->mockFilesystem->shouldReceive('missing')
+            ->with(Hyde::path('_media/foo'))
+            ->andReturn(true);
+
         $this->expectException(FileNotFoundException::class);
         $this->expectExceptionMessage('File [_media/foo] not found.');
 
@@ -330,13 +242,10 @@ public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
     {
         MediaFile::$validateExistence = true;
 
-        $this->file('_media/foo', 'Hello World!');
+        $this->mockFilesystem->shouldReceive('missing')
+            ->with(Hyde::path('_media/foo'))
+            ->andReturn(false);
 
         $this->assertInstanceOf(MediaFile::class, MediaFile::make('foo'));
     }
-
-    protected function mockFilesystem(array $methods): void
-    {
-        app()->instance(BaseFilesystem::class, Mockery::mock(BaseFilesystem::class, $methods));
-    }
 }

From cbdf54069bfc9cb20c7a038cf980285e979ed9c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 29 Jul 2024 22:43:11 +0200
Subject: [PATCH 2978/4023] Fix failing unit test

---
 packages/framework/tests/Unit/Support/MediaFileUnitTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index cebc5c29fe4..32652ad4537 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -142,8 +142,8 @@ public function testGetAbsolutePathReturnsAbsolutePathOfFile()
     public function testGetContentsReturnsContentsOfFile()
     {
         $this->mockFilesystem->shouldReceive('get')
-            ->with(Hyde::path('_media/foo.txt'))
-            ->andReturn('foo bar');
+            ->andReturn('foo bar')
+            ->once();
 
         $this->assertSame('foo bar', MediaFile::make('foo.txt')->getContents());
     }

From 51b604ad55e819515a4912730160946fb4998ae6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 13:11:40 +0200
Subject: [PATCH 2979/4023] Bind the MarkdownService class in the Hyde service
 provider

---
 .../src/Framework/HydeServiceProvider.php      |  2 ++
 .../tests/Feature/HydeServiceProviderTest.php  | 18 ++++++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/packages/framework/src/Framework/HydeServiceProvider.php b/packages/framework/src/Framework/HydeServiceProvider.php
index c2896efdc9b..df67c1785df 100644
--- a/packages/framework/src/Framework/HydeServiceProvider.php
+++ b/packages/framework/src/Framework/HydeServiceProvider.php
@@ -11,6 +11,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Services\AssetService;
+use Hyde\Framework\Services\MarkdownService;
 use Hyde\Framework\Services\BuildTaskService;
 use Hyde\Framework\Concerns\RegistersFileLocations;
 use Illuminate\Support\ServiceProvider;
@@ -31,6 +32,7 @@ public function register(): void
 
         $this->app->singleton(AssetService::class, AssetService::class);
         $this->app->singleton(BuildTaskService::class, BuildTaskService::class);
+        $this->app->bind(MarkdownService::class, MarkdownService::class);
 
         $this->kernel->setSourceRoot(Config::getString('hyde.source_root', ''));
 
diff --git a/packages/framework/tests/Feature/HydeServiceProviderTest.php b/packages/framework/tests/Feature/HydeServiceProviderTest.php
index 6904c5b11d6..adbd5a04812 100644
--- a/packages/framework/tests/Feature/HydeServiceProviderTest.php
+++ b/packages/framework/tests/Feature/HydeServiceProviderTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Framework\Services\MarkdownService;
 use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Illuminate\Contracts\Container\BindingResolutionException;
@@ -68,6 +69,23 @@ public function testProviderRegistersBuildTaskServiceAsSingleton()
         $this->assertSame($this->app->make(BuildTaskService::class), $this->app->make(BuildTaskService::class));
     }
 
+    public function testProviderRegistersMarkdownServiceAsBasicBinding()
+    {
+        $args = ['markdown' => 'foo'];
+
+        $this->assertTrue($this->app->bound(MarkdownService::class));
+        $this->assertInstanceOf(MarkdownService::class, $this->app->make(MarkdownService::class, $args));
+        $this->assertNotSame($this->app->make(MarkdownService::class, $args), $this->app->make(MarkdownService::class, $args));
+    }
+
+    public function testCanSwapMarkdownServiceBinding()
+    {
+        $this->app->bind(MarkdownService::class, fn () => 'foo');
+
+        $this->assertTrue($this->app->bound(MarkdownService::class));
+        $this->assertSame('foo', $this->app->make(MarkdownService::class));
+    }
+
     public function testProviderRegistersSourceDirectories()
     {
         BladePage::setSourceDirectory('');

From aa76b40edc6f3aeb4882e24a112f5399df11abfa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 13:32:22 +0200
Subject: [PATCH 2980/4023] Improve Markdown document testing

---
 .../tests/Unit/MarkdownDocumentTest.php       | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/packages/framework/tests/Unit/MarkdownDocumentTest.php b/packages/framework/tests/Unit/MarkdownDocumentTest.php
index ae88a4a464c..9fcd32d572f 100644
--- a/packages/framework/tests/Unit/MarkdownDocumentTest.php
+++ b/packages/framework/tests/Unit/MarkdownDocumentTest.php
@@ -108,4 +108,30 @@ public function testCarriageReturnsAreNormalized()
         $markdown = new Markdown("foo\nbar");
         $this->assertSame("foo\nbar", $markdown->body());
     }
+
+    public function testRender(): void
+    {
+        $html = Markdown::render('# Hello World!');
+
+        $this->assertIsString($html);
+        $this->assertSame("<h1>Hello World!</h1>\n", $html);
+    }
+
+    public function testRenderWithCustomHydeMarkdownFeatures()
+    {
+        $html = Markdown::render(<<<'MARKDOWN'
+        # Hello World
+        
+        >info Colored blockquote
+        
+        [Home](/_pages/index.blade.php)
+        MARKDOWN);
+
+        $this->assertSame(<<<'HTML'
+        <h1>Hello World</h1>
+        <blockquote class="info"><p>Colored blockquote</p></blockquote>
+        <p><a href="index.html">Home</a></p>
+
+        HTML, $html);
+    }
 }

From 45050ba1f451c154af84d3cbfda866ecda58154a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 13:36:46 +0200
Subject: [PATCH 2981/4023] Rename test to be more generic to match dual usage

Doesn't feel worth it to split out this test into two, so rename is better
---
 .../Unit/{MarkdownDocumentTest.php => MarkdownHelpersTest.php}  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Unit/{MarkdownDocumentTest.php => MarkdownHelpersTest.php} (98%)

diff --git a/packages/framework/tests/Unit/MarkdownDocumentTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php
similarity index 98%
rename from packages/framework/tests/Unit/MarkdownDocumentTest.php
rename to packages/framework/tests/Unit/MarkdownHelpersTest.php
index 9fcd32d572f..0d3ac1982cc 100644
--- a/packages/framework/tests/Unit/MarkdownDocumentTest.php
+++ b/packages/framework/tests/Unit/MarkdownHelpersTest.php
@@ -15,7 +15,7 @@
  * @covers \Hyde\Markdown\Models\MarkdownDocument
  * @covers \Hyde\Markdown\Models\Markdown
  */
-class MarkdownDocumentTest extends TestCase
+class MarkdownHelpersTest extends TestCase
 {
     public function testConstructorCreatesNewMarkdownDocument()
     {

From cfb8184332606969071bf52b868c6c20fcb8341f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 13:59:43 +0200
Subject: [PATCH 2982/4023] Revert "Rename test to be more generic to match
 dual usage"

This reverts commit 45050ba1f451c154af84d3cbfda866ecda58154a.
---
 .../Unit/{MarkdownHelpersTest.php => MarkdownDocumentTest.php}  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Unit/{MarkdownHelpersTest.php => MarkdownDocumentTest.php} (98%)

diff --git a/packages/framework/tests/Unit/MarkdownHelpersTest.php b/packages/framework/tests/Unit/MarkdownDocumentTest.php
similarity index 98%
rename from packages/framework/tests/Unit/MarkdownHelpersTest.php
rename to packages/framework/tests/Unit/MarkdownDocumentTest.php
index 0d3ac1982cc..9fcd32d572f 100644
--- a/packages/framework/tests/Unit/MarkdownHelpersTest.php
+++ b/packages/framework/tests/Unit/MarkdownDocumentTest.php
@@ -15,7 +15,7 @@
  * @covers \Hyde\Markdown\Models\MarkdownDocument
  * @covers \Hyde\Markdown\Models\Markdown
  */
-class MarkdownHelpersTest extends TestCase
+class MarkdownDocumentTest extends TestCase
 {
     public function testConstructorCreatesNewMarkdownDocument()
     {

From 19b8b14dc3f1cea38091f8218644d70a6e5c3ab3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 13:59:52 +0200
Subject: [PATCH 2983/4023] Update the Markdown render method to get service
 from container

This allows it to be mocked in unit tests
---
 packages/framework/src/Markdown/Models/Markdown.php  |  5 ++++-
 packages/framework/tests/Unit/MarkdownFacadeTest.php | 11 ++++++++---
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Markdown/Models/Markdown.php b/packages/framework/src/Markdown/Models/Markdown.php
index e9c6c80c6a7..1d63f4fb1af 100644
--- a/packages/framework/src/Markdown/Models/Markdown.php
+++ b/packages/framework/src/Markdown/Models/Markdown.php
@@ -90,6 +90,9 @@ public static function fromFile(string $path): static
      */
     public static function render(string $markdown, ?string $pageClass = null): string
     {
-        return (new MarkdownService($markdown, $pageClass))->parse();
+        return app(MarkdownService::class, [
+            'markdown' => $markdown,
+            'pageClass' => $pageClass,
+        ])->parse();
     }
 }
diff --git a/packages/framework/tests/Unit/MarkdownFacadeTest.php b/packages/framework/tests/Unit/MarkdownFacadeTest.php
index 88903630f90..3f6a442e957 100644
--- a/packages/framework/tests/Unit/MarkdownFacadeTest.php
+++ b/packages/framework/tests/Unit/MarkdownFacadeTest.php
@@ -4,22 +4,27 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Mockery;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Markdown\Models\Markdown;
+use Hyde\Framework\Services\MarkdownService;
 
 /**
  * @covers \Hyde\Markdown\Models\Markdown
  */
 class MarkdownFacadeTest extends UnitTestCase
 {
-    protected static bool $needsKernel = true;
-    protected static bool $needsConfig = true;
-
     public function testRender(): void
     {
+        $mock = Mockery::mock(MarkdownService::class);
+        $mock->shouldReceive('parse')->once()->andReturn("<h1>Hello World!</h1>\n");
+        app()->bind(MarkdownService::class, fn () => $mock);
+
         $html = Markdown::render('# Hello World!');
 
         $this->assertIsString($html);
         $this->assertSame("<h1>Hello World!</h1>\n", $html);
+
+        Mockery::close();
     }
 }

From b47ad4a06615bbe1746acbe18f35e31bb18a0b6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 14:14:38 +0200
Subject: [PATCH 2984/4023] Rename test to be more generic to match dual usage

---
 .../Unit/{MarkdownDocumentTest.php => MarkdownHelpersTest.php}  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Unit/{MarkdownDocumentTest.php => MarkdownHelpersTest.php} (98%)

diff --git a/packages/framework/tests/Unit/MarkdownDocumentTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php
similarity index 98%
rename from packages/framework/tests/Unit/MarkdownDocumentTest.php
rename to packages/framework/tests/Unit/MarkdownHelpersTest.php
index 9fcd32d572f..0d3ac1982cc 100644
--- a/packages/framework/tests/Unit/MarkdownDocumentTest.php
+++ b/packages/framework/tests/Unit/MarkdownHelpersTest.php
@@ -15,7 +15,7 @@
  * @covers \Hyde\Markdown\Models\MarkdownDocument
  * @covers \Hyde\Markdown\Models\Markdown
  */
-class MarkdownDocumentTest extends TestCase
+class MarkdownHelpersTest extends TestCase
 {
     public function testConstructorCreatesNewMarkdownDocument()
     {

From 3982f6505fd668540bd85bcea7a7e9cc361a17a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 14:16:37 +0200
Subject: [PATCH 2985/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 86740ca0d9c..0970fc75495 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -59,6 +59,7 @@ This serves two purposes:
 - Moved the sidebar documentation to the documentation pages section for better organization.
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
+- Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
 
 ### Deprecated
 - for soon-to-be removed features.

From 77574224204021374a11c88d49554fdba51ba5a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 12:39:00 +0200
Subject: [PATCH 2986/4023] Reset kernel

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 74818e459e8..3a39dc18873 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -63,6 +63,7 @@ public function assets(): Collection
     protected function tearDown(): void
     {
         Mockery::close();
+        self::resetKernel();
 
         parent::tearDown();
     }

From 160e401dfe3c5d6ffd92733badf48fdb044b45ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 12:58:21 +0200
Subject: [PATCH 2987/4023] Run test without app stylesheet

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 35 ++++++++-----------
 1 file changed, 14 insertions(+), 21 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 3a39dc18873..ae21891d6e0 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,17 +9,12 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
-use Illuminate\Support\Collection;
 use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 use Hyde\Testing\MocksKernelFeatures;
-use Hyde\Foundation\Kernel\FileCollection;
-use Hyde\Foundation\Kernel\PageCollection;
-use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -42,22 +37,6 @@ protected function setUp(): void
         $this->setupTestKernel();
         $this->kernel->setRoutes(collect());
         Render::swap(new RenderData());
-
-        HydeKernel::setInstance(new class extends HydeKernel
-        {
-            // Bypass discovery to isolate test
-            public function boot(): void
-            {
-                $this->files = FileCollection::init($this);
-                $this->pages = PageCollection::init($this);
-                $this->routes = RouteCollection::init($this);
-            }
-
-            public function assets(): Collection
-            {
-                return collect();
-            }
-        });
     }
 
     protected function tearDown(): void
@@ -68,6 +47,20 @@ protected function tearDown(): void
         parent::tearDown();
     }
 
+    public static function setUpBeforeClass(): void
+    {
+        rename('_media/app.css', '_media/app.css.bak');
+
+        parent::setUpBeforeClass();
+    }
+
+    public static function tearDownAfterClass(): void
+    {
+        rename('_media/app.css.bak', '_media/app.css');
+
+        parent::tearDownAfterClass();
+    }
+
     public function testPathReturnsTheIncludesDirectory()
     {
         $this->assertSame(Hyde::path('resources/includes'), Includes::path());

From c585ee330ccc0e0ff9d34a3c464ac5a77e3c484c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 20:20:36 +0200
Subject: [PATCH 2988/4023] Revert "Reset kernel"

This reverts commit 26aa0b1d3559c597a9e15f7483cb5ba50c075ad7.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index ae21891d6e0..4abd3b12054 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -42,7 +42,6 @@ protected function setUp(): void
     protected function tearDown(): void
     {
         Mockery::close();
-        self::resetKernel();
 
         parent::tearDown();
     }

From afc9b012c0362e36e37973126d5764cdcaa10b21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 20:20:39 +0200
Subject: [PATCH 2989/4023] Revert "Run test without app stylesheet"

This reverts commit 28024ed16bb68d21e77f83a270648e20a665dafa.
---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 35 +++++++++++--------
 1 file changed, 21 insertions(+), 14 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 4abd3b12054..74818e459e8 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,12 +9,17 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
+use Illuminate\Support\Collection;
 use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 use Hyde\Testing\MocksKernelFeatures;
+use Hyde\Foundation\Kernel\FileCollection;
+use Hyde\Foundation\Kernel\PageCollection;
+use Hyde\Foundation\Kernel\RouteCollection;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -37,6 +42,22 @@ protected function setUp(): void
         $this->setupTestKernel();
         $this->kernel->setRoutes(collect());
         Render::swap(new RenderData());
+
+        HydeKernel::setInstance(new class extends HydeKernel
+        {
+            // Bypass discovery to isolate test
+            public function boot(): void
+            {
+                $this->files = FileCollection::init($this);
+                $this->pages = PageCollection::init($this);
+                $this->routes = RouteCollection::init($this);
+            }
+
+            public function assets(): Collection
+            {
+                return collect();
+            }
+        });
     }
 
     protected function tearDown(): void
@@ -46,20 +67,6 @@ protected function tearDown(): void
         parent::tearDown();
     }
 
-    public static function setUpBeforeClass(): void
-    {
-        rename('_media/app.css', '_media/app.css.bak');
-
-        parent::setUpBeforeClass();
-    }
-
-    public static function tearDownAfterClass(): void
-    {
-        rename('_media/app.css.bak', '_media/app.css');
-
-        parent::tearDownAfterClass();
-    }
-
     public function testPathReturnsTheIncludesDirectory()
     {
         $this->assertSame(Hyde::path('resources/includes'), Includes::path());

From 025b35e084d85192283b9a4c1e91583e536140ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 12:32:37 +0200
Subject: [PATCH 2990/4023] Update MediaFileUnitTest.php

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 98 ++++++++++++++++---
 1 file changed, 86 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 32652ad4537..b7093bddd45 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -21,8 +21,26 @@ class MediaFileUnitTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected static string $originalBasePath;
+
     protected $mockFilesystem;
 
+    public static function setUpBeforeClass(): void
+    {
+        parent::setUpBeforeClass();
+
+        static::$originalBasePath = Hyde::getBasePath();
+
+        Hyde::setBasePath('/base/path');
+    }
+
+    public static function tearDownAfterClass(): void
+    {
+        Hyde::setBasePath(static::$originalBasePath);
+
+        parent::tearDownAfterClass();
+    }
+
     protected function setUp(): void
     {
         parent::setUp();
@@ -203,18 +221,6 @@ public function testGetMimeType()
         $this->assertSame('text/plain', MediaFile::make('foo.txt')->getMimeType());
     }
 
-    public function testAllHelperReturnsAllMediaFiles()
-    {
-        $this->assertEquals([
-            'app.css' => new MediaFile('_media/app.css'),
-        ], MediaFile::all()->all());
-    }
-
-    public function testFilesHelperReturnsAllMediaFiles()
-    {
-        $this->assertSame(['app.css'], MediaFile::files());
-    }
-
     public function testGetHashReturnsHash()
     {
         $this->mockFilesystem->shouldReceive('hash')
@@ -248,4 +254,72 @@ public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
 
         $this->assertInstanceOf(MediaFile::class, MediaFile::make('foo'));
     }
+
+    public function testGetIdentifierWithSubdirectory()
+    {
+        $this->assertSame('foo/bar', MediaFile::make('foo/bar')->getIdentifier());
+    }
+
+    public function testGetIdentifierReturnsIdentifierWithFileExtension()
+    {
+        $this->assertSame('foo.png', MediaFile::make('foo.png')->getIdentifier());
+    }
+
+    public function testGetIdentifierWithSubdirectoryWithFileExtension()
+    {
+        $this->assertSame('foo/bar.png', MediaFile::make('foo/bar.png')->getIdentifier());
+    }
+
+    public function testHelperForMediaPath()
+    {
+        $this->assertSame('/base/path/_media', MediaFile::sourcePath());
+    }
+
+    public function testHelperForMediaPathReturnsPathToFileWithinTheDirectory()
+    {
+        $this->assertSame('/base/path/_media/foo.css', MediaFile::sourcePath('foo.css'));
+    }
+
+    public function testGetMediaPathReturnsAbsolutePath()
+    {
+        $this->assertSame('/base/path/_media', MediaFile::sourcePath());
+    }
+
+    public function testHelperForMediaOutputPath()
+    {
+        $this->assertSame('/base/path/_site/media', MediaFile::outputPath());
+    }
+
+    public function testHelperForMediaOutputPathReturnsPathToFileWithinTheDirectory()
+    {
+        $this->assertSame('/base/path/_site/media/foo.css', MediaFile::outputPath('foo.css'));
+    }
+
+    public function testGetMediaOutputPathReturnsAbsolutePath()
+    {
+        $this->assertSame('/base/path/_site/media', MediaFile::outputPath());
+    }
+
+    public function testCanGetSiteMediaOutputDirectory()
+    {
+        $this->assertSame('/base/path/_site/media', MediaFile::outputPath());
+    }
+
+    public function testGetSiteMediaOutputDirectoryUsesTrimmedVersionOfMediaSourceDirectory()
+    {
+        Hyde::setMediaDirectory('_foo');
+        $this->assertSame('/base/path/_site/foo', MediaFile::outputPath());
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory()
+    {
+        Hyde::setOutputDirectory('/base/path/foo');
+        Hyde::setMediaDirectory('bar');
+
+        $this->assertSame('/base/path/foo/bar', MediaFile::outputPath());
+
+        Hyde::setOutputDirectory('/base/path/_site'); // Reset to default
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
 }

From 9d288782f0dc51345b3b96e641359f11ddded615 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 30 Jul 2024 20:33:19 +0200
Subject: [PATCH 2991/4023] Swap for a simpler implementation

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 35 ++++++++-----------
 1 file changed, 15 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 74818e459e8..bcf6d47cebe 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -8,18 +8,15 @@
 use Closure;
 use Hyde\Hyde;
 use Hyde\Support\Includes;
+use Illuminate\Support\Str;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
-use Illuminate\Support\Collection;
 use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 use Hyde\Testing\MocksKernelFeatures;
-use Hyde\Foundation\Kernel\FileCollection;
-use Hyde\Foundation\Kernel\PageCollection;
-use Hyde\Foundation\Kernel\RouteCollection;
+use Hyde\Framework\Services\MarkdownService;
 
 /**
  * @covers \Hyde\Support\Includes
@@ -43,21 +40,7 @@ protected function setUp(): void
         $this->kernel->setRoutes(collect());
         Render::swap(new RenderData());
 
-        HydeKernel::setInstance(new class extends HydeKernel
-        {
-            // Bypass discovery to isolate test
-            public function boot(): void
-            {
-                $this->files = FileCollection::init($this);
-                $this->pages = PageCollection::init($this);
-                $this->routes = RouteCollection::init($this);
-            }
-
-            public function assets(): Collection
-            {
-                return collect();
-            }
-        });
+        app()->bind(MarkdownService::class, SimpleMarkdownServiceTestClass::class);
     }
 
     protected function tearDown(): void
@@ -276,3 +259,15 @@ protected function assertHtmlStringIsSame(string|HtmlString $expected, mixed $ac
         $this->assertSame((string) $expected, $actual->toHtml());
     }
 }
+
+class SimpleMarkdownServiceTestClass
+{
+    public function __construct(protected string $markdown = '')
+    {
+    }
+
+    public function parse(): string
+    {
+        return Str::markdown($this->markdown);
+    }
+}

From 3089fbcb41af5f4ff64d246cfa0f67fba62a074f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 12:01:16 +0200
Subject: [PATCH 2992/4023] Use fully qualified class name in PHPDoc

---
 .../partials/hyde-pages-api/hyde-kernel-filesystem-methods.md | 4 ++--
 .../framework/src/Foundation/Concerns/ForwardsFilesystem.php  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
index 9823b18f5f4..fa76f9881e7 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-filesystem-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2024-07-28 12:43:01 in 0.11ms -->
+<!-- Generated by HydePHP DocGen script at 2024-08-01 10:01:06 in 0.13ms -->
 
 #### `filesystem()`
 
@@ -56,7 +56,7 @@ Hyde::pathToRelative(string $path): string
 No description provided.
 
 ```php
-Hyde::assets(): Collection<string, \Hyde\Support\Filesystem\MediaFile>
+Hyde::assets(): \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
 ```
 
 <!-- End generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
index 1f45bc30655..b294170474f 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsFilesystem.php
@@ -44,7 +44,7 @@ public function pathToRelative(string $path): string
         return $this->filesystem->pathToRelative($path);
     }
 
-    /** @return Collection<string, \Hyde\Support\Filesystem\MediaFile> */
+    /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> */
     public function assets(): Collection
     {
         return $this->filesystem->assets();

From e1a39098a1bff028586125525d3ee73bf6dabffe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 12:13:37 +0200
Subject: [PATCH 2993/4023] Clarify existence of internal property

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 24e45f3a5c8..3e584380b97 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -25,7 +25,7 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
-    /** @internal Controls whether to validate the existence of the file. Turning this off may lead to unexpected behavior. */
+    /** @internal Controls whether to validate the existence of the file, intended for unit testing. Turning this off may lead to unexpected behavior. */
     public static bool $validateExistence = true;
 
     protected int $length;

From cc87ff93e62cfed79a545b695b5885c4de5e3a7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 12:25:06 +0200
Subject: [PATCH 2994/4023] Mock base filesystem

---
 .../tests/Unit/Foundation/FilesystemHasMediaFilesTest.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index f55345c8487..e23e7ad8177 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -4,11 +4,13 @@
 
 namespace Hyde\Framework\Testing\Unit\Foundation;
 
+use Mockery;
 use Hyde\Foundation\Kernel\Filesystem;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Support\Collection;
+use Illuminate\Filesystem\Filesystem as BaseFilesystem;
 
 /**
  * @covers \Hyde\Foundation\Kernel\Filesystem
@@ -24,6 +26,12 @@ protected function setUp(): void
     {
         parent::setUp();
         $this->filesystem = new TestableFilesystem(Hyde::getInstance());
+
+        $mock = Mockery::mock(BaseFilesystem::class)->makePartial();
+        $mock->shouldReceive('size')->andReturn(100)->byDefault();
+        $mock->shouldReceive('hash')->andReturn('hash')->byDefault();
+        app()->instance(BaseFilesystem::class, $mock);
+
         MediaFile::$validateExistence = false;
     }
 

From bec2d608e2a3bf1dee22ab75ef44a2540ff3a8c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 12:14:29 +0200
Subject: [PATCH 2995/4023] Remove file existence check before getting data

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3e584380b97..e39d2c1c8f8 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -42,11 +42,9 @@ public function __construct(string $path)
 
         parent::__construct($path);
 
-        if (Filesystem::isFile($this->getPath())) {
-            $this->length = $this->findContentLength();
-            $this->mimeType = $this->findMimeType();
-            $this->hash = $this->findHash();
-        }
+        $this->length = $this->findContentLength();
+        $this->mimeType = $this->findMimeType();
+        $this->hash = $this->findHash();
     }
 
     /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */

From 818f939bec04b2608d62fd6ad1bbb00d5c1526aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:01:38 +0200
Subject: [PATCH 2996/4023] Match method declaration order to the base page
 class

---
 .../framework/src/Support/Filesystem/MediaFile.php   | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e39d2c1c8f8..8d8cb16c279 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -47,18 +47,18 @@ public function __construct(string $path)
         $this->hash = $this->findHash();
     }
 
-    /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
-    public static function all(): Collection
-    {
-        return Hyde::assets();
-    }
-
     /** @return array<string> Array of filenames relative to the _media/ directory */
     public static function files(): array
     {
         return static::all()->keys()->all();
     }
 
+    /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
+    public static function all(): Collection
+    {
+        return Hyde::assets();
+    }
+
     /**
      * Get the absolute path to the media source directory, or a file within it.
      */

From 2471dfaa82b710ea5fccd45e6eb82556b4b6103a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:04:37 +0200
Subject: [PATCH 2997/4023] Add an example return value

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 8d8cb16c279..5266da067c1 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -47,7 +47,11 @@ public function __construct(string $path)
         $this->hash = $this->findHash();
     }
 
-    /** @return array<string> Array of filenames relative to the _media/ directory */
+    /**
+     * @return array<string> Array of filenames relative to the _media/ directory
+     *
+     * @example `['app.css', 'images/logo.svg']`
+     */
     public static function files(): array
     {
         return static::all()->keys()->all();

From 1b85baa8b7462d576b5b56d3414e8facd4cf910c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:10:53 +0200
Subject: [PATCH 2998/4023] Merge example to single line

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5266da067c1..8f4a0cf807a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -48,9 +48,7 @@ public function __construct(string $path)
     }
 
     /**
-     * @return array<string> Array of filenames relative to the _media/ directory
-     *
-     * @example `['app.css', 'images/logo.svg']`
+     * @return array<string> Array of filenames relative to the _media/ directory {@example `['app.css', 'images/logo.svg']`}
      */
     public static function files(): array
     {

From 8c20420636f37a1df1933aa69e79b1af751929b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:10:56 +0200
Subject: [PATCH 2999/4023] Revert "Merge example to single line"

This reverts commit 1b85baa8b7462d576b5b56d3414e8facd4cf910c.
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 8f4a0cf807a..5266da067c1 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -48,7 +48,9 @@ public function __construct(string $path)
     }
 
     /**
-     * @return array<string> Array of filenames relative to the _media/ directory {@example `['app.css', 'images/logo.svg']`}
+     * @return array<string> Array of filenames relative to the _media/ directory
+     *
+     * @example `['app.css', 'images/logo.svg']`
      */
     public static function files(): array
     {

From 814b3eb22f8c5878a3e1c6a10df177d4ca3ee863 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:11:36 +0200
Subject: [PATCH 3000/4023] Add return prefix

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5266da067c1..a913f75c9cf 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -50,7 +50,7 @@ public function __construct(string $path)
     /**
      * @return array<string> Array of filenames relative to the _media/ directory
      *
-     * @example `['app.css', 'images/logo.svg']`
+     * @example `$return = ['app.css', 'images/logo.svg']`
      */
     public static function files(): array
     {

From 2802ae2bf366ae5a9a5a19a05c49ad6a45086a78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:11:39 +0200
Subject: [PATCH 3001/4023] Revert "Add return prefix"

This reverts commit 814b3eb22f8c5878a3e1c6a10df177d4ca3ee863.
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index a913f75c9cf..5266da067c1 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -50,7 +50,7 @@ public function __construct(string $path)
     /**
      * @return array<string> Array of filenames relative to the _media/ directory
      *
-     * @example `$return = ['app.css', 'images/logo.svg']`
+     * @example `['app.css', 'images/logo.svg']`
      */
     public static function files(): array
     {

From 3441c5339b025bf87c6f0553e9af22ae10dbcd4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:13:56 +0200
Subject: [PATCH 3002/4023] Improve the method documentation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5266da067c1..5cb87350239 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -48,9 +48,9 @@ public function __construct(string $path)
     }
 
     /**
-     * @return array<string> Array of filenames relative to the _media/ directory
+     * Get an array of media asset filenames relative to the `_media/` directory.
      *
-     * @example `['app.css', 'images/logo.svg']`
+     * @return array<int, string> {@example `['app.css', 'images/logo.svg']`}
      */
     public static function files(): array
     {

From 067a8058d8778654a1df24827427bce1ca6cb867 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:16:26 +0200
Subject: [PATCH 3003/4023] Improve the method documentation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5cb87350239..3ae480b230c 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -57,7 +57,11 @@ public static function files(): array
         return static::all()->keys()->all();
     }
 
-    /** @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
+    /**
+     * Get a collection of all media files, parsed into MediaFile instances, keyed by the filenames relative to the `_media/` directory.
+     *
+     * @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
+     */
     public static function all(): Collection
     {
         return Hyde::assets();

From 31d8d2ae25f4a23f774a4de66f49df5504235a5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:17:06 +0200
Subject: [PATCH 3004/4023] Format documented class name

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3ae480b230c..e5a2d910455 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -58,7 +58,7 @@ public static function files(): array
     }
 
     /**
-     * Get a collection of all media files, parsed into MediaFile instances, keyed by the filenames relative to the `_media/` directory.
+     * Get a collection of all media files, parsed into `MediaFile` instances, keyed by the filenames relative to the `_media/` directory.
      *
      * @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
      */

From c4dc0f7e9a414843f4085e617046118f1681beae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 13:37:52 +0200
Subject: [PATCH 3005/4023] Generate more unit tests to cover all code paths

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index b7093bddd45..1af72abfcc2 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -322,4 +322,34 @@ public function testGetSiteMediaOutputDirectoryUsesConfiguredSiteOutputDirectory
         Hyde::setOutputDirectory('/base/path/_site'); // Reset to default
         Hyde::setMediaDirectory('_media'); // Reset to default
     }
+
+    public function testSourcePathWithEmptyString()
+    {
+        $this->assertSame(Hyde::path('_media'), MediaFile::sourcePath(''));
+    }
+
+    public function testSourcePathWithSubdirectories()
+    {
+        $this->assertSame(Hyde::path('_media/foo/bar'), MediaFile::sourcePath('foo/bar'));
+    }
+
+    public function testSourcePathWithLeadingSlash()
+    {
+        $this->assertSame(Hyde::path('_media/foo'), MediaFile::sourcePath('/foo'));
+    }
+
+    public function testOutputPathWithEmptyString()
+    {
+        $this->assertSame(Hyde::sitePath('media'), MediaFile::outputPath(''));
+    }
+
+    public function testOutputPathWithSubdirectories()
+    {
+        $this->assertSame(Hyde::sitePath('media/foo/bar'), MediaFile::outputPath('foo/bar'));
+    }
+
+    public function testOutputPathWithLeadingSlash()
+    {
+        $this->assertSame(Hyde::sitePath('media/foo'), MediaFile::outputPath('/foo'));
+    }
 }

From e31458451c1a460ee55bff68712ad2f4e6bbbbd8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 15:11:46 +0200
Subject: [PATCH 3006/4023] Generate more constructor unit tests

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 53 +++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 1af72abfcc2..1585bfb6acd 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -139,6 +139,59 @@ public function testCustomMediaPathsAreNormalizedToRelativeCustomizedMediaPath()
         Hyde::setMediaDirectory('_media');
     }
 
+    public function testConstructorWithVariousInputFormats()
+    {
+        $this->assertSame('_media/foo.txt', MediaFile::make('foo.txt')->path);
+        $this->assertSame('_media/foo.txt', MediaFile::make('_media/foo.txt')->path);
+        $this->assertSame('_media/foo.txt', MediaFile::make(Hyde::path('_media/foo.txt'))->path);
+        $this->assertSame('_media/foo.txt', MediaFile::make('media/foo.txt')->path);
+    }
+
+    public function testConstructorWithValidationDisabled()
+    {
+        MediaFile::$validateExistence = false;
+        $this->mockFilesystem->shouldReceive('missing')->never();
+
+        $file = new MediaFile('non_existent_file.txt');
+        $this->assertInstanceOf(MediaFile::class, $file);
+    }
+
+    public function testConstructorSetsProperties()
+    {
+        $file = new MediaFile('foo.txt');
+        $this->assertNotNull($file->length);
+        $this->assertNotNull($file->mimeType);
+        $this->assertNotNull($file->hash);
+    }
+
+    public function testNormalizePathWithAbsolutePath()
+    {
+        $this->assertSame('_media/foo.txt', MediaFile::make(Hyde::path('_media/foo.txt'))->path);
+    }
+
+    public function testNormalizePathWithRelativePath()
+    {
+        $this->assertSame('_media/foo.txt', MediaFile::make('foo.txt')->path);
+    }
+
+    public function testNormalizePathWithOutputDirectoryPath()
+    {
+        Hyde::setMediaDirectory('_custom_media');
+        $this->assertSame('_custom_media/foo.txt', MediaFile::make('custom_media/foo.txt')->path);
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testNormalizePathWithAlreadyCorrectFormat()
+    {
+        $this->assertSame('_media/foo.txt', MediaFile::make('_media/foo.txt')->path);
+    }
+
+    public function testNormalizePathWithParentDirectoryReferences()
+    {
+        $this->assertSame('_media/foo.txt', MediaFile::make('../_media/foo.txt')->path);
+        $this->assertSame('_media/baz/../bar/foo.txt', MediaFile::make('_media/baz/../bar/foo.txt')->path);
+    }
+
     public function testGetNameReturnsNameOfFile()
     {
         $this->assertSame('foo.txt', MediaFile::make('foo.txt')->getName());

From a6b83a8676efdc75677984ad7e8cdc6e4f899df2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 15:11:58 +0200
Subject: [PATCH 3007/4023] Annotate context

---
 packages/framework/tests/Unit/Support/MediaFileUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 1585bfb6acd..7311819b2db 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -189,7 +189,7 @@ public function testNormalizePathWithAlreadyCorrectFormat()
     public function testNormalizePathWithParentDirectoryReferences()
     {
         $this->assertSame('_media/foo.txt', MediaFile::make('../_media/foo.txt')->path);
-        $this->assertSame('_media/baz/../bar/foo.txt', MediaFile::make('_media/baz/../bar/foo.txt')->path);
+        $this->assertSame('_media/baz/../bar/foo.txt', MediaFile::make('_media/baz/../bar/foo.txt')->path); // We don't do anything about this
     }
 
     public function testGetNameReturnsNameOfFile()

From 53023b5e9653bf919adc8ea827db54075aff22be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 15:13:14 +0200
Subject: [PATCH 3008/4023] Change protected properties to public readonly

These are part of the public interface of the class, but the should be immutable since there is no way to change them (in terms of persisting modified states)
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e5a2d910455..3b8a57a639c 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -28,9 +28,9 @@ class MediaFile extends ProjectFile
     /** @internal Controls whether to validate the existence of the file, intended for unit testing. Turning this off may lead to unexpected behavior. */
     public static bool $validateExistence = true;
 
-    protected int $length;
-    protected string $mimeType;
-    protected string $hash;
+    public readonly int $length;
+    public readonly string $mimeType;
+    public readonly string $hash;
 
     public function __construct(string $path)
     {

From a39ba5be66ec4c06f80c56b0c6d1626860a53f92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 15:15:03 +0200
Subject: [PATCH 3009/4023] Normalize extension access between class structure

---
 packages/framework/src/Support/Filesystem/MediaFile.php   | 2 +-
 packages/framework/src/Support/Filesystem/ProjectFile.php | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3b8a57a639c..5ece5d24400 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -150,7 +150,7 @@ protected function findContentLength(): int
 
     protected function findMimeType(): string
     {
-        $extension = Filesystem::extension($this->getPath());
+        $extension = $this->getExtension();
 
         // See if we can find a mime type for the extension instead of
         // having to rely on a PHP extension and filesystem lookups.
diff --git a/packages/framework/src/Support/Filesystem/ProjectFile.php b/packages/framework/src/Support/Filesystem/ProjectFile.php
index eb29ba893e9..36376fbc14c 100644
--- a/packages/framework/src/Support/Filesystem/ProjectFile.php
+++ b/packages/framework/src/Support/Filesystem/ProjectFile.php
@@ -11,8 +11,6 @@
 use Hyde\Support\Concerns\Serializable;
 use Hyde\Support\Contracts\SerializableContract;
 
-use function pathinfo;
-
 /**
  * Filesystem abstraction for a file stored in the project.
  */
@@ -71,6 +69,6 @@ public function getContents(): string
 
     public function getExtension(): string
     {
-        return pathinfo($this->getAbsolutePath(), PATHINFO_EXTENSION);
+        return Filesystem::extension($this->getPath());
     }
 }

From e077ac615146d125e09640caab4db9f805ecd85c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 1 Aug 2024 21:25:08 +0200
Subject: [PATCH 3010/4023] Remove internal validate existence flag

---
 .../src/Support/Filesystem/MediaFile.php         |  5 +----
 .../Foundation/FilesystemHasMediaFilesTest.php   |  9 +--------
 .../tests/Unit/Support/MediaFileUnitTest.php     | 16 ----------------
 3 files changed, 2 insertions(+), 28 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5ece5d24400..184ea906821 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -25,9 +25,6 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
-    /** @internal Controls whether to validate the existence of the file, intended for unit testing. Turning this off may lead to unexpected behavior. */
-    public static bool $validateExistence = true;
-
     public readonly int $length;
     public readonly string $mimeType;
     public readonly string $hash;
@@ -36,7 +33,7 @@ public function __construct(string $path)
     {
         $path = $this->normalizePath($path);
 
-        if (static::$validateExistence && Filesystem::missing($path)) {
+        if (Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
         }
 
diff --git a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
index e23e7ad8177..d16f987b05a 100644
--- a/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
+++ b/packages/framework/tests/Unit/Foundation/FilesystemHasMediaFilesTest.php
@@ -28,17 +28,10 @@ protected function setUp(): void
         $this->filesystem = new TestableFilesystem(Hyde::getInstance());
 
         $mock = Mockery::mock(BaseFilesystem::class)->makePartial();
+        $mock->shouldReceive('missing')->andReturn(false)->byDefault();
         $mock->shouldReceive('size')->andReturn(100)->byDefault();
         $mock->shouldReceive('hash')->andReturn('hash')->byDefault();
         app()->instance(BaseFilesystem::class, $mock);
-
-        MediaFile::$validateExistence = false;
-    }
-
-    protected function tearDown(): void
-    {
-        parent::tearDown();
-        MediaFile::$validateExistence = true;
     }
 
     public function testAssetsMethodReturnsSameInstanceOnSubsequentCalls()
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 7311819b2db..f07bf42cc61 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -45,8 +45,6 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        MediaFile::$validateExistence = false;
-
         $this->mockFilesystem = Mockery::mock(BaseFilesystem::class);
         app()->instance(BaseFilesystem::class, $this->mockFilesystem);
 
@@ -68,7 +66,6 @@ protected function tearDown(): void
     {
         parent::tearDown();
 
-        MediaFile::$validateExistence = true;
         Mockery::close();
     }
 
@@ -147,15 +144,6 @@ public function testConstructorWithVariousInputFormats()
         $this->assertSame('_media/foo.txt', MediaFile::make('media/foo.txt')->path);
     }
 
-    public function testConstructorWithValidationDisabled()
-    {
-        MediaFile::$validateExistence = false;
-        $this->mockFilesystem->shouldReceive('missing')->never();
-
-        $file = new MediaFile('non_existent_file.txt');
-        $this->assertInstanceOf(MediaFile::class, $file);
-    }
-
     public function testConstructorSetsProperties()
     {
         $file = new MediaFile('foo.txt');
@@ -285,8 +273,6 @@ public function testGetHashReturnsHash()
 
     public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
     {
-        MediaFile::$validateExistence = true;
-
         $this->mockFilesystem->shouldReceive('missing')
             ->with(Hyde::path('_media/foo'))
             ->andReturn(true);
@@ -299,8 +285,6 @@ public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
 
     public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
     {
-        MediaFile::$validateExistence = true;
-
         $this->mockFilesystem->shouldReceive('missing')
             ->with(Hyde::path('_media/foo'))
             ->andReturn(false);

From dbbd957aa568d8b769c300f366bc2845ad893b82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 3 Aug 2024 12:36:10 +0200
Subject: [PATCH 3011/4023] Introduce local variable

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 184ea906821..3f25f8ea2c4 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -137,7 +137,9 @@ protected function normalizePath(string $path): string
             $path = '_'.$path;
         }
 
-        return static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
+        $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
+
+        return $path;
     }
 
     protected function findContentLength(): int

From d3618469c42911a85d6171f53b4b06834ffaab3f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 3 Aug 2024 12:36:31 +0200
Subject: [PATCH 3012/4023] Rename helper method

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3f25f8ea2c4..b1728426a89 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -31,7 +31,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = $this->normalizePath($path);
+        $path = $this->getNormalizedPath($path);
 
         if (Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
@@ -128,7 +128,7 @@ public static function getCacheBustKey(string $file): string
             : '';
     }
 
-    protected function normalizePath(string $path): string
+    protected function getNormalizedPath(string $path): string
     {
         $path = Hyde::pathToRelative($path);
 

From e6ae28dbfc6f1171c280cf92231d09b934e3e05a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 3 Aug 2024 12:37:47 +0200
Subject: [PATCH 3013/4023] Move file existence check to normalizer method

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index b1728426a89..ac2ee5da846 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -33,10 +33,6 @@ public function __construct(string $path)
     {
         $path = $this->getNormalizedPath($path);
 
-        if (Filesystem::missing($path)) {
-            throw new FileNotFoundException($path);
-        }
-
         parent::__construct($path);
 
         $this->length = $this->findContentLength();
@@ -139,6 +135,10 @@ protected function getNormalizedPath(string $path): string
 
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
+        if (Filesystem::missing($path)) {
+            throw new FileNotFoundException($path);
+        }
+
         return $path;
     }
 

From 89feb9c768146fc20f5a9587979cba6866b037a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 3 Aug 2024 13:10:30 +0200
Subject: [PATCH 3014/4023] Document code reasoning

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index ac2ee5da846..67cc69117c2 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -133,6 +133,7 @@ protected function getNormalizedPath(string $path): string
             $path = '_'.$path;
         }
 
+        // Normalize the path to include the media directory
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
         if (Filesystem::missing($path)) {

From c3bcc78b3d6ae286dc2f40fa14eb8f0eb0d7722d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 3 Aug 2024 13:10:54 +0200
Subject: [PATCH 3015/4023] Inline local variable

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 67cc69117c2..2c2835880b8 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -31,9 +31,7 @@ class MediaFile extends ProjectFile
 
     public function __construct(string $path)
     {
-        $path = $this->getNormalizedPath($path);
-
-        parent::__construct($path);
+        parent::__construct($this->getNormalizedPath($path));
 
         $this->length = $this->findContentLength();
         $this->mimeType = $this->findMimeType();

From 96b18565b6b0a049479a37c62f3ed44869dd462b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 12:31:13 +0200
Subject: [PATCH 3016/4023] Add short and concise PHPDoc annotations to the
 public methods

---
 .../src/Support/Filesystem/MediaFile.php      | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 2c2835880b8..50226101da4 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -29,6 +29,13 @@ class MediaFile extends ProjectFile
     public readonly string $mimeType;
     public readonly string $hash;
 
+    /**
+     * Create a new MediaFile instance.
+     *
+     * @param  string  $path  The file path relative to the project root or media source directory.
+     *
+     * @throws FileNotFoundException If the file does not exist in the media source directory.
+     */
     public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
@@ -90,6 +97,11 @@ public function getIdentifier(): string
         return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');
     }
 
+    /**
+     * Get the file information as an array.
+     *
+     * @return array<string, mixed> The file information
+     */
     public function toArray(): array
     {
         return array_merge(parent::toArray(), [
@@ -99,16 +111,31 @@ public function toArray(): array
         ]);
     }
 
+    /**
+     * Get the content length of the file.
+     *
+     * @return int The content length in bytes
+     */
     public function getContentLength(): int
     {
         return $this->length;
     }
 
+    /**
+     * Get the MIME type of the file.
+     *
+     * @return string The MIME type
+     */
     public function getMimeType(): string
     {
         return $this->mimeType;
     }
 
+    /**
+     * Get the hash of the file.
+     *
+     * @return string The file hash
+     */
     public function getHash(): string
     {
         return $this->hash;

From ed428cb9a5c5ff26fadb1ff8b2a6876b1c1f2b20 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 12:36:05 +0200
Subject: [PATCH 3017/4023] Narrow down mixed return type

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 50226101da4..0a00f007823 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -100,7 +100,7 @@ public function getIdentifier(): string
     /**
      * Get the file information as an array.
      *
-     * @return array<string, mixed> The file information
+     * @return array<string, int|string> The file information
      */
     public function toArray(): array
     {

From 7f53ba7102c5748c1792c9412835c2d5fca44869 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 13:25:50 +0200
Subject: [PATCH 3018/4023] Use array shape annotation to match parent

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 0a00f007823..88513d7e5ec 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -100,7 +100,7 @@ public function getIdentifier(): string
     /**
      * Get the file information as an array.
      *
-     * @return array<string, int|string> The file information
+     * @return array{name: string, path: string, length: int, mimeType: string, hash: string}
      */
     public function toArray(): array
     {

From 7c6739fef9d37081f404dbb2e7c241a1caa3a15d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 13:26:25 +0200
Subject: [PATCH 3019/4023] Specify hash type

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 88513d7e5ec..11761f86ee7 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -132,7 +132,7 @@ public function getMimeType(): string
     }
 
     /**
-     * Get the hash of the file.
+     * Get the CRC32 hash of the file.
      *
      * @return string The file hash
      */

From 687b119c21b686b20097390efd6e30d88577d987 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 13:26:41 +0200
Subject: [PATCH 3020/4023] Remove redundant PHPDoc comments

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 11761f86ee7..49e48853d25 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -112,9 +112,7 @@ public function toArray(): array
     }
 
     /**
-     * Get the content length of the file.
-     *
-     * @return int The content length in bytes
+     * Get the content length of the file in bytes.
      */
     public function getContentLength(): int
     {
@@ -123,8 +121,6 @@ public function getContentLength(): int
 
     /**
      * Get the MIME type of the file.
-     *
-     * @return string The MIME type
      */
     public function getMimeType(): string
     {
@@ -133,8 +129,6 @@ public function getMimeType(): string
 
     /**
      * Get the CRC32 hash of the file.
-     *
-     * @return string The file hash
      */
     public function getHash(): string
     {

From 5ba193a37164b7ae51f802b7a2aa870ff4005b2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 13:39:29 +0200
Subject: [PATCH 3021/4023] Add todo

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 2c2835880b8..e05c8b88e38 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -146,6 +146,7 @@ protected function findContentLength(): int
         return Filesystem::size($this->getPath());
     }
 
+    /** @todo Move to Filesystem::findMimeType($path) */
     protected function findMimeType(): string
     {
         $extension = $this->getExtension();

From 5c77557bf254f8a7607fe13bba8c5299b3d780fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 19:32:23 +0200
Subject: [PATCH 3022/4023] Add new helper to get a relative web link to the
 media file

---
 .../src/Support/Filesystem/MediaFile.php      |  8 ++
 .../tests/Unit/Support/MediaFileUnitTest.php  | 93 +++++++++++++++++++
 2 files changed, 101 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 49e48853d25..090a986f5a9 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -135,6 +135,14 @@ public function getHash(): string
         return $this->hash;
     }
 
+    /**
+     * Get a relative web link to the media file.
+     */
+    public function getLink(): string
+    {
+        return Hyde::asset($this->getIdentifier());
+    }
+
     /** @internal */
     public static function getCacheBustKey(string $file): string
     {
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index f07bf42cc61..1713cfba022 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -5,6 +5,9 @@
 namespace Hyde\Framework\Testing\Unit\Support;
 
 use Mockery;
+use Illuminate\View\Factory;
+use Hyde\Support\Facades\Render;
+use Hyde\Support\Models\RenderData;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Support\Filesystem\MediaFile;
@@ -51,6 +54,7 @@ protected function setUp(): void
         // Set up default expectations for commonly called methods
         $this->mockFilesystem->shouldReceive('isFile')->andReturn(true)->byDefault();
         $this->mockFilesystem->shouldReceive('missing')->andReturn(false)->byDefault();
+        $this->mockFilesystem->shouldReceive('exists')->andReturn(true)->byDefault();
         $this->mockFilesystem->shouldReceive('extension')->andReturn('txt')->byDefault();
         $this->mockFilesystem->shouldReceive('size')->andReturn(12)->byDefault();
         $this->mockFilesystem->shouldReceive('mimeType')->andReturn('text/plain')->byDefault();
@@ -60,6 +64,12 @@ protected function setUp(): void
         // Mock Hyde facade
         $hyde = Mockery::mock(Hyde::kernel())->makePartial();
         $hyde->shouldReceive('assets')->andReturn(collect(['app.css' => new MediaFile('_media/app.css')]))->byDefault();
+
+        // Mock render data
+        \Illuminate\Support\Facades\View::swap(Mockery::mock(Factory::class)->makePartial());
+        Render::swap(new RenderData());
+
+        self::mockConfig(['hyde.enable_cache_busting' => false]);
     }
 
     protected function tearDown(): void
@@ -389,4 +399,87 @@ public function testOutputPathWithLeadingSlash()
     {
         $this->assertSame(Hyde::sitePath('media/foo'), MediaFile::outputPath('/foo'));
     }
+
+    public function testGetLink()
+    {
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('media/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('custom_media/foo.txt', $file->getLink());
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testGetLinkWithPrettyUrls()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.pretty_urls' => true]);
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('media/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithNestedFile()
+    {
+        $file = MediaFile::make('subdirectory/foo.txt');
+        $this->assertSame('media/subdirectory/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithBaseUrl()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.url' => 'https://example.com']);
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('https://example.com/media/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithBaseUrlAndPrettyUrls()
+    {
+        self::mockConfig([
+            'hyde.enable_cache_busting' => false,
+            'hyde.url' => 'https://example.com',
+            'hyde.pretty_urls' => true,
+        ]);
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('https://example.com/media/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithCacheBusting()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => true]);
+        $this->mockFilesystem->shouldReceive('hash')
+            ->andReturn('abc123');
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('media/foo.txt?v=abc123', $file->getLink());
+    }
+
+    public function testGetLinkWithCacheBustingDisabled()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false]);
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('media/foo.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithCurrentPageContext()
+    {
+        $this->mockCurrentPage('foo/bar');
+        $file = MediaFile::make('baz.txt');
+        $this->assertSame('../media/baz.txt', $file->getLink());
+    }
+
+    public function testGetLinkWithCurrentPageContextAndCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $this->mockCurrentPage('foo/bar');
+        $file = MediaFile::make('baz.txt');
+        $this->assertSame('../custom_media/baz.txt', $file->getLink());
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    // Helper method to mock the current page
+    protected function mockCurrentPage(string $page): void
+    {
+        Render::shouldReceive('getRouteKey')->andReturn($page);
+    }
 }

From 6f5e5379c7d2a15d465675bb3a0cc3a471adc5f2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 19:44:56 +0200
Subject: [PATCH 3023/4023] Make protected method public static internal

---
 .../framework/src/Foundation/Kernel/Hyperlinks.php     | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 9fc377a9a9f..c6e777cafc8 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -100,7 +100,7 @@ public function mediaLink(string $destination, bool $validate = false): string
             throw new FileNotFoundException($sourcePath);
         }
 
-        return $this->withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
+        return static::withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
     }
 
     /**
@@ -118,10 +118,10 @@ public function asset(string $name): string
         $name = Str::start($name, "{$this->kernel->getMediaOutputDirectory()}/");
 
         if ($this->hasSiteUrl()) {
-            return $this->withCacheBusting($this->url($name), $name);
+            return static::withCacheBusting($this->url($name), $name);
         }
 
-        return $this->withCacheBusting($this->relativeLink($name), $name);
+        return static::withCacheBusting($this->relativeLink($name), $name);
     }
 
     /**
@@ -183,9 +183,9 @@ public static function isRemote(string $url): bool
     }
 
     /**
-     * Apply cache to the URL if enabled in the configuration.
+     * @internal Apply cache to the URL if enabled in the configuration.
      */
-    protected function withCacheBusting(string $url, string $file): string
+    public static function withCacheBusting(string $url, string $file): string
     {
         return $url.MediaFile::getCacheBustKey($file);
     }

From 13affcab0f96f6dbc8db270c15b60630671142be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 20:02:41 +0200
Subject: [PATCH 3024/4023] Convert string interpolation to concatenation

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index c6e777cafc8..b52b944a434 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -96,11 +96,11 @@ public function relativeLink(string $destination): string
      */
     public function mediaLink(string $destination, bool $validate = false): string
     {
-        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
+        if ($validate && ! file_exists($sourcePath = $this->kernel->getMediaDirectory().'/'.$destination)) {
             throw new FileNotFoundException($sourcePath);
         }
 
-        return static::withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
+        return static::withCacheBusting($this->relativeLink($this->kernel->getMediaOutputDirectory().'/'.$destination), $destination);
     }
 
     /**

From b588a8851fda06f4f061eb922bd7e27aaba3d387 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 20:03:08 +0200
Subject: [PATCH 3025/4023] Access kernel using facade

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index b52b944a434..417dac82135 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Foundation\Kernel;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
@@ -96,11 +97,11 @@ public function relativeLink(string $destination): string
      */
     public function mediaLink(string $destination, bool $validate = false): string
     {
-        if ($validate && ! file_exists($sourcePath = $this->kernel->getMediaDirectory().'/'.$destination)) {
+        if ($validate && ! file_exists($sourcePath = Hyde::getMediaDirectory().'/'.$destination)) {
             throw new FileNotFoundException($sourcePath);
         }
 
-        return static::withCacheBusting($this->relativeLink($this->kernel->getMediaOutputDirectory().'/'.$destination), $destination);
+        return static::withCacheBusting($this->relativeLink(Hyde::getMediaOutputDirectory().'/'.$destination), $destination);
     }
 
     /**

From cb98c50e172a6a3b1dffc32365c7617cf4b31bbf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 20:03:32 +0200
Subject: [PATCH 3026/4023] Revert "Access kernel using facade"

This reverts commit b588a8851fda06f4f061eb922bd7e27aaba3d387.
---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 417dac82135..b52b944a434 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Foundation\Kernel;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
@@ -97,11 +96,11 @@ public function relativeLink(string $destination): string
      */
     public function mediaLink(string $destination, bool $validate = false): string
     {
-        if ($validate && ! file_exists($sourcePath = Hyde::getMediaDirectory().'/'.$destination)) {
+        if ($validate && ! file_exists($sourcePath = $this->kernel->getMediaDirectory().'/'.$destination)) {
             throw new FileNotFoundException($sourcePath);
         }
 
-        return static::withCacheBusting($this->relativeLink(Hyde::getMediaOutputDirectory().'/'.$destination), $destination);
+        return static::withCacheBusting($this->relativeLink($this->kernel->getMediaOutputDirectory().'/'.$destination), $destination);
     }
 
     /**

From 78c02f8ce19d2a9d9e8cec1f420b1ebff9e42327 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 4 Aug 2024 20:03:35 +0200
Subject: [PATCH 3027/4023] Revert "Convert string interpolation to
 concatenation"

This reverts commit 13affcab0f96f6dbc8db270c15b60630671142be.
---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index b52b944a434..c6e777cafc8 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -96,11 +96,11 @@ public function relativeLink(string $destination): string
      */
     public function mediaLink(string $destination, bool $validate = false): string
     {
-        if ($validate && ! file_exists($sourcePath = $this->kernel->getMediaDirectory().'/'.$destination)) {
+        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
             throw new FileNotFoundException($sourcePath);
         }
 
-        return static::withCacheBusting($this->relativeLink($this->kernel->getMediaOutputDirectory().'/'.$destination), $destination);
+        return static::withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
     }
 
     /**

From 7aa2d6a5c5aebc43706b875ac2ccc5395ffded16 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:06:38 +0200
Subject: [PATCH 3028/4023] Deprecate the media link helper

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index c6e777cafc8..4b941358a20 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -91,6 +91,8 @@ public function relativeLink(string $destination): string
     /**
      * Gets a relative web link to the given file stored in the _site/media folder.
      *
+     * @deprecated Use the `asset` method instead.
+     *
      * An exception will be thrown if the file does not exist in the _media directory,
      * and the second argument is set to true.
      */

From ab9e7aac8dac4629de2d110a596ff6b351a26df4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:07:23 +0200
Subject: [PATCH 3029/4023] Convert string interpolation to concatenation

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 4b941358a20..6eac49a45e7 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -117,7 +117,7 @@ public function asset(string $name): string
             return $name;
         }
 
-        $name = Str::start($name, "{$this->kernel->getMediaOutputDirectory()}/");
+        $name = Str::start($name, $this->kernel->getMediaOutputDirectory().'/');
 
         if ($this->hasSiteUrl()) {
             return static::withCacheBusting($this->url($name), $name);

From 1814937abf6bd6a3a41dff63f866aa6fd9deb3c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:07:43 +0200
Subject: [PATCH 3030/4023] Access kernel using facade

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 6eac49a45e7..0f4a669f14a 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Foundation\Kernel;
 
+use Hyde\Hyde;
 use Hyde\Facades\Config;
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
@@ -117,7 +118,7 @@ public function asset(string $name): string
             return $name;
         }
 
-        $name = Str::start($name, $this->kernel->getMediaOutputDirectory().'/');
+        $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
         if ($this->hasSiteUrl()) {
             return static::withCacheBusting($this->url($name), $name);

From 1deffbd58a10b5b7a7354a1a3f8a4f94930488b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:10:20 +0200
Subject: [PATCH 3031/4023] Access methods using facade

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 0f4a669f14a..225f93670a9 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -120,11 +120,11 @@ public function asset(string $name): string
 
         $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
-        if ($this->hasSiteUrl()) {
-            return static::withCacheBusting($this->url($name), $name);
+        if (Hyde::hasSiteUrl()) {
+            return static::withCacheBusting(Hyde::url($name), $name);
         }
 
-        return static::withCacheBusting($this->relativeLink($name), $name);
+        return static::withCacheBusting(Hyde::relativeLink($name), $name);
     }
 
     /**

From 6c350f032dcd65e960d7c2b53a3fc57dadb6cbd8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:11:45 +0200
Subject: [PATCH 3032/4023] Call class name instead of static

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 225f93670a9..2dd7d07f4e1 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -114,17 +114,17 @@ public function mediaLink(string $destination, bool $validate = false): string
      */
     public function asset(string $name): string
     {
-        if (static::isRemote($name)) {
+        if (Hyperlinks::isRemote($name)) {
             return $name;
         }
 
         $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
         if (Hyde::hasSiteUrl()) {
-            return static::withCacheBusting(Hyde::url($name), $name);
+            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
         }
 
-        return static::withCacheBusting(Hyde::relativeLink($name), $name);
+        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
     }
 
     /**

From 20a7f113c1f67fce6d7cde9cc263eb4c0dc286c2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:18:10 +0200
Subject: [PATCH 3033/4023] Copy the asset logic to the media file class

---
 .../src/Support/Filesystem/MediaFile.php          | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 090a986f5a9..fb735274def 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -8,6 +8,7 @@
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
+use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -140,7 +141,19 @@ public function getHash(): string
      */
     public function getLink(): string
     {
-        return Hyde::asset($this->getIdentifier());
+        $name = $this->getIdentifier();
+
+        if (Hyperlinks::isRemote($name)) {
+            return $name;
+        }
+
+        $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
+
+        if (Hyde::hasSiteUrl()) {
+            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
+        }
+
+        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
     }
 
     /** @internal */

From eefd67fdc1787371683cb3ab834a55e0487c9cac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 11:18:31 +0200
Subject: [PATCH 3034/4023] Remove unreachable remote check from method

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index fb735274def..1ec1c26e88f 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -143,10 +143,6 @@ public function getLink(): string
     {
         $name = $this->getIdentifier();
 
-        if (Hyperlinks::isRemote($name)) {
-            return $name;
-        }
-
         $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
         if (Hyde::hasSiteUrl()) {

From 5977b8881ed8051cbb3497a737ba4b2a0cf8c51b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 15:46:33 +0200
Subject: [PATCH 3035/4023] Test against accessors

---
 packages/framework/tests/Unit/Support/MediaFileUnitTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index f07bf42cc61..5a0fa4af492 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -147,9 +147,9 @@ public function testConstructorWithVariousInputFormats()
     public function testConstructorSetsProperties()
     {
         $file = new MediaFile('foo.txt');
-        $this->assertNotNull($file->length);
-        $this->assertNotNull($file->mimeType);
-        $this->assertNotNull($file->hash);
+        $this->assertNotNull($file->getContentLength());
+        $this->assertNotNull($file->getMimeType());
+        $this->assertNotNull($file->getHash());
     }
 
     public function testNormalizePathWithAbsolutePath()

From c2bfffcca92ecd6c7b89b090dd20e30e8f8697e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 15:50:44 +0200
Subject: [PATCH 3036/4023] Protect the public readonly metadata properties

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e05c8b88e38..4891cbd6cd2 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -25,9 +25,9 @@ class MediaFile extends ProjectFile
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
 
-    public readonly int $length;
-    public readonly string $mimeType;
-    public readonly string $hash;
+    protected readonly int $length;
+    protected readonly string $mimeType;
+    protected readonly string $hash;
 
     public function __construct(string $path)
     {

From 24ee8e5c595efdc6bd2223d4f71714027670ac59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 15:54:11 +0200
Subject: [PATCH 3037/4023] Extracted protected boot function

---
 .../framework/src/Support/Filesystem/MediaFile.php    | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 4891cbd6cd2..ddb77378c98 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -33,9 +33,7 @@ public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
 
-        $this->length = $this->findContentLength();
-        $this->mimeType = $this->findMimeType();
-        $this->hash = $this->findHash();
+        $this->boot();
     }
 
     /**
@@ -183,4 +181,11 @@ protected function findHash(): string
     {
         return Filesystem::hash($this->getPath(), 'crc32');
     }
+
+    protected function boot(): void
+    {
+        $this->length = $this->findContentLength();
+        $this->mimeType = $this->findMimeType();
+        $this->hash = $this->findHash();
+    }
 }

From 6403d061b28d7df62108463fcf65357de682aeee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 15:57:43 +0200
Subject: [PATCH 3038/4023] Boot all metadata properties when is accessed

---
 .../framework/src/Support/Filesystem/MediaFile.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index ddb77378c98..2564a7eb79a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -32,8 +32,6 @@ class MediaFile extends ProjectFile
     public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
-
-        $this->boot();
     }
 
     /**
@@ -99,16 +97,28 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
+        if (! isset($this->length)) {
+            $this->boot();
+        }
+
         return $this->length;
     }
 
     public function getMimeType(): string
     {
+        if (! isset($this->mimeType)) {
+            $this->boot();
+        }
+
         return $this->mimeType;
     }
 
     public function getHash(): string
     {
+        if (! isset($this->hash)) {
+            $this->boot();
+        }
+
         return $this->hash;
     }
 

From b61d957db7151f99c8572e1fc6256d133bab0d86 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 16:02:48 +0200
Subject: [PATCH 3039/4023] Move file existence validation from constructor to
 boot method

---
 packages/framework/src/Support/Filesystem/MediaFile.php   | 8 ++++----
 .../framework/tests/Feature/Support/MediaFileTest.php     | 2 +-
 .../framework/tests/Unit/Support/MediaFileUnitTest.php    | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 2564a7eb79a..211013012b1 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -142,10 +142,6 @@ protected function getNormalizedPath(string $path): string
         // Normalize the path to include the media directory
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
-        if (Filesystem::missing($path)) {
-            throw new FileNotFoundException($path);
-        }
-
         return $path;
     }
 
@@ -194,6 +190,10 @@ protected function findHash(): string
 
     protected function boot(): void
     {
+        if (Filesystem::missing($this->getPath())) {
+            throw new FileNotFoundException($this->getPath());
+        }
+
         $this->length = $this->findContentLength();
         $this->mimeType = $this->findMimeType();
         $this->hash = $this->findHash();
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index df8756e6551..3a03d1f4bbb 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -81,7 +81,7 @@ public function testMediaFilePathHandling()
     public function testMediaFileExceptionHandling()
     {
         $this->expectException(FileNotFoundException::class);
-        MediaFile::make('non_existent_file.txt');
+        MediaFile::make('non_existent_file.txt')->getContentLength();
     }
 
     public function testMediaDirectoryCustomization()
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 5a0fa4af492..fc5bf7170b4 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -271,7 +271,7 @@ public function testGetHashReturnsHash()
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
 
-    public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
+    public function testExceptionIsThrownWhenBootingFileThatDoesNotExist()
     {
         $this->mockFilesystem->shouldReceive('missing')
             ->with(Hyde::path('_media/foo'))
@@ -280,7 +280,7 @@ public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
         $this->expectException(FileNotFoundException::class);
         $this->expectExceptionMessage('File [_media/foo] not found.');
 
-        MediaFile::make('foo');
+        MediaFile::make('foo')->getContentLength();
     }
 
     public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()

From 0fbbf2d8454dfa52aee1c227397a53ec6cc65479 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 16:06:15 +0200
Subject: [PATCH 3040/4023] Add data provider to test all trigger methods

---
 .../tests/Unit/Support/MediaFileUnitTest.php       | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index fc5bf7170b4..5c8588d2c43 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -271,7 +271,8 @@ public function testGetHashReturnsHash()
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
 
-    public function testExceptionIsThrownWhenBootingFileThatDoesNotExist()
+    /** @dataProvider bootableMethodsProvider */
+    public function testExceptionIsThrownWhenBootingFileThatDoesNotExist(string $bootableMethod)
     {
         $this->mockFilesystem->shouldReceive('missing')
             ->with(Hyde::path('_media/foo'))
@@ -280,7 +281,7 @@ public function testExceptionIsThrownWhenBootingFileThatDoesNotExist()
         $this->expectException(FileNotFoundException::class);
         $this->expectExceptionMessage('File [_media/foo] not found.');
 
-        MediaFile::make('foo')->getContentLength();
+        MediaFile::make('foo')->$bootableMethod();
     }
 
     public function testExceptionIsNotThrownWhenConstructingFileThatDoesExist()
@@ -389,4 +390,13 @@ public function testOutputPathWithLeadingSlash()
     {
         $this->assertSame(Hyde::sitePath('media/foo'), MediaFile::outputPath('/foo'));
     }
+
+    public static function bootableMethodsProvider(): array
+    {
+        return [
+            ['getContentLength'],
+            ['getMimeType'],
+            ['getHash'],
+        ];
+    }
 }

From dbb679ec96eab1d17595196823b4dba1513b9f4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 19:10:37 +0200
Subject: [PATCH 3041/4023] Add code comment

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 211013012b1..dc3ea70f4f0 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -132,6 +132,7 @@ public static function getCacheBustKey(string $file): string
 
     protected function getNormalizedPath(string $path): string
     {
+        // Ensure we are working with a relative project path
         $path = Hyde::pathToRelative($path);
 
         // Normalize paths using output directory to have source directory prefix

From aea81c9cd31b3c7c789e20ff0f0fdace96e87f54 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 5 Aug 2024 19:12:09 +0200
Subject: [PATCH 3042/4023] Extract helper method

---
 .../src/Support/Filesystem/MediaFile.php      | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index dc3ea70f4f0..8385de73118 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -97,27 +97,21 @@ public function toArray(): array
 
     public function getContentLength(): int
     {
-        if (! isset($this->length)) {
-            $this->boot();
-        }
+        $this->ensureInstanceIsBooted('length');
 
         return $this->length;
     }
 
     public function getMimeType(): string
     {
-        if (! isset($this->mimeType)) {
-            $this->boot();
-        }
+        $this->ensureInstanceIsBooted('mimeType');
 
         return $this->mimeType;
     }
 
     public function getHash(): string
     {
-        if (! isset($this->hash)) {
-            $this->boot();
-        }
+        $this->ensureInstanceIsBooted('hash');
 
         return $this->hash;
     }
@@ -189,6 +183,13 @@ protected function findHash(): string
         return Filesystem::hash($this->getPath(), 'crc32');
     }
 
+    protected function ensureInstanceIsBooted(string $property): void
+    {
+        if (! isset($this->$property)) {
+            $this->boot();
+        }
+    }
+
     protected function boot(): void
     {
         if (Filesystem::missing($this->getPath())) {

From 133a7caf78e974cd21e7b8c770395ca969fb894e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 7 Aug 2024 18:59:56 +0200
Subject: [PATCH 3043/4023] Add more unit tests

---
 .../tests/Unit/Support/MediaFileUnitTest.php  | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 5c8588d2c43..d0f7ec5fa9f 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -271,6 +271,45 @@ public function testGetHashReturnsHash()
         $this->assertSame(hash('crc32', 'Hello World!'), MediaFile::make('foo.txt')->getHash());
     }
 
+    public function testGetMimeTypeReturnsLookupValueForKnownExtension()
+    {
+        $this->mockFilesystem->shouldReceive('extension')
+            ->with(Hyde::path('_media/foo.txt'))
+            ->andReturn('txt');
+
+        $this->assertSame('text/plain', MediaFile::make('foo.txt')->getMimeType());
+    }
+
+    public function testGetMimeTypeUsesFileinfoForUnknownExtension()
+    {
+        $this->mockFilesystem->shouldReceive('extension')
+            ->with(Hyde::path('_media/foo.xyz'))
+            ->andReturn('xyz');
+
+        $this->mockFilesystem->shouldReceive('exists')
+            ->with(Hyde::path('_media/foo.xyz'))
+            ->andReturn(true);
+
+        $this->mockFilesystem->shouldReceive('mimeType')
+            ->with(Hyde::path('_media/foo.xyz'))
+            ->andReturn('application/octet-stream');
+
+        $this->assertSame('application/octet-stream', MediaFile::make('foo.xyz')->getMimeType());
+    }
+
+    public function testGetMimeTypeReturnsTextPlainForNonExistentFile()
+    {
+        $this->mockFilesystem->shouldReceive('extension')
+            ->with(Hyde::path('_media/nonexistent.xyz'))
+            ->andReturn('xyz');
+
+        $this->mockFilesystem->shouldReceive('exists')
+            ->with(Hyde::path('_media/nonexistent.xyz'))
+            ->andReturn(false);
+
+        $this->assertSame('text/plain', MediaFile::make('nonexistent.xyz')->getMimeType());
+    }
+
     /** @dataProvider bootableMethodsProvider */
     public function testExceptionIsThrownWhenBootingFileThatDoesNotExist(string $bootableMethod)
     {

From c48a731551c803150c9f84a05d291b40da6bf8d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 12:16:05 +0200
Subject: [PATCH 3044/4023] Begin adding back support for fileless media file
 instances

---
 .../src/Support/Filesystem/MediaFile.php      | 27 ++++++++++++++-----
 .../tests/Feature/Support/MediaFileTest.php   |  9 ++++---
 .../tests/Unit/Support/MediaFileUnitTest.php  |  2 +-
 3 files changed, 27 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1ec1c26e88f..fdd008d049e 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -41,9 +41,13 @@ public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
 
-        $this->length = $this->findContentLength();
-        $this->mimeType = $this->findMimeType();
-        $this->hash = $this->findHash();
+        if (Filesystem::exists($this->getAbsolutePath())) {
+            [$contentLength, $mimeType, $hash] = $this->getMetadata();
+
+            $this->length = $contentLength;
+            $this->mimeType = $mimeType;
+            $this->hash = $hash;
+        }
     }
 
     /**
@@ -172,10 +176,6 @@ protected function getNormalizedPath(string $path): string
         // Normalize the path to include the media directory
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
-        if (Filesystem::missing($path)) {
-            throw new FileNotFoundException($path);
-        }
-
         return $path;
     }
 
@@ -220,4 +220,17 @@ protected function findHash(): string
     {
         return Filesystem::hash($this->getPath(), 'crc32');
     }
+
+    protected function getMetadata(): array
+    {
+        if (Filesystem::missing($this->getAbsolutePath())) {
+            throw new FileNotFoundException($this->getPath(), "Cannot get metadata for a file that does not exist on disk. (File [{$this->getPath()}] not found)");
+        }
+
+        $contentLength = $this->findContentLength();
+        $mimeType = $this->findMimeType();
+        $hash = $this->findHash();
+
+        return [$contentLength, $mimeType, $hash];
+    }
 }
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index df8756e6551..353bec31126 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -78,10 +78,13 @@ public function testMediaFilePathHandling()
         $this->assertSame('_media/subfolder/nested_file.txt', $mediaFile->getPath());
     }
 
-    public function testMediaFileExceptionHandling()
+    public function testCanCreateInMemoryMediaFileInstances()
     {
-        $this->expectException(FileNotFoundException::class);
-        MediaFile::make('non_existent_file.txt');
+        $mediaFile = MediaFile::make('non_existent_file.txt');
+
+        $this->assertInstanceOf(MediaFile::class, $mediaFile);
+
+        $this->assertSame('non_existent_file.txt', $mediaFile->getAbsolutePath());
     }
 
     public function testMediaDirectoryCustomization()
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 1713cfba022..5148fdf5138 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -288,7 +288,7 @@ public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
             ->andReturn(true);
 
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [_media/foo] not found.');
+        $this->expectExceptionMessage('Cannot get metadata for a file that does not exist on disk. (File [_media/foo] not found)');
 
         MediaFile::make('foo');
     }

From d0212c14e7ced90a3d2fd5f4a58faa37b856a622 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 12:16:09 +0200
Subject: [PATCH 3045/4023] Revert "Begin adding back support for fileless
 media file instances"

This reverts commit c48a731551c803150c9f84a05d291b40da6bf8d4.
---
 .../src/Support/Filesystem/MediaFile.php      | 27 +++++--------------
 .../tests/Feature/Support/MediaFileTest.php   |  9 +++----
 .../tests/Unit/Support/MediaFileUnitTest.php  |  2 +-
 3 files changed, 11 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index fdd008d049e..1ec1c26e88f 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -41,13 +41,9 @@ public function __construct(string $path)
     {
         parent::__construct($this->getNormalizedPath($path));
 
-        if (Filesystem::exists($this->getAbsolutePath())) {
-            [$contentLength, $mimeType, $hash] = $this->getMetadata();
-
-            $this->length = $contentLength;
-            $this->mimeType = $mimeType;
-            $this->hash = $hash;
-        }
+        $this->length = $this->findContentLength();
+        $this->mimeType = $this->findMimeType();
+        $this->hash = $this->findHash();
     }
 
     /**
@@ -176,6 +172,10 @@ protected function getNormalizedPath(string $path): string
         // Normalize the path to include the media directory
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
+        if (Filesystem::missing($path)) {
+            throw new FileNotFoundException($path);
+        }
+
         return $path;
     }
 
@@ -220,17 +220,4 @@ protected function findHash(): string
     {
         return Filesystem::hash($this->getPath(), 'crc32');
     }
-
-    protected function getMetadata(): array
-    {
-        if (Filesystem::missing($this->getAbsolutePath())) {
-            throw new FileNotFoundException($this->getPath(), "Cannot get metadata for a file that does not exist on disk. (File [{$this->getPath()}] not found)");
-        }
-
-        $contentLength = $this->findContentLength();
-        $mimeType = $this->findMimeType();
-        $hash = $this->findHash();
-
-        return [$contentLength, $mimeType, $hash];
-    }
 }
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 353bec31126..df8756e6551 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -78,13 +78,10 @@ public function testMediaFilePathHandling()
         $this->assertSame('_media/subfolder/nested_file.txt', $mediaFile->getPath());
     }
 
-    public function testCanCreateInMemoryMediaFileInstances()
+    public function testMediaFileExceptionHandling()
     {
-        $mediaFile = MediaFile::make('non_existent_file.txt');
-
-        $this->assertInstanceOf(MediaFile::class, $mediaFile);
-
-        $this->assertSame('non_existent_file.txt', $mediaFile->getAbsolutePath());
+        $this->expectException(FileNotFoundException::class);
+        MediaFile::make('non_existent_file.txt');
     }
 
     public function testMediaDirectoryCustomization()
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 5148fdf5138..1713cfba022 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -288,7 +288,7 @@ public function testExceptionIsThrownWhenConstructingFileThatDoesNotExist()
             ->andReturn(true);
 
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('Cannot get metadata for a file that does not exist on disk. (File [_media/foo] not found)');
+        $this->expectExceptionMessage('File [_media/foo] not found.');
 
         MediaFile::make('foo');
     }

From b7fc928a4d8930309d49f60955b4c3f7b8817ba7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 12:17:32 +0200
Subject: [PATCH 3046/4023] Document why we must validate file existence

See https://github.com/hydephp/develop/pull/1932#issuecomment-2298498144
---
 packages/framework/src/Support/Filesystem/MediaFile.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1ec1c26e88f..8623548c582 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -172,6 +172,7 @@ protected function getNormalizedPath(string $path): string
         // Normalize the path to include the media directory
         $path = static::sourcePath(trim_slashes(Str::after($path, Hyde::getMediaDirectory())));
 
+        // Since assets need to exist on disk in order to be copied to the built site files we validate that the file is real here.
         if (Filesystem::missing($path)) {
             throw new FileNotFoundException($path);
         }

From 5a569b322653aa3da4166f70cc8605a583fcac49 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 12:43:16 +0200
Subject: [PATCH 3047/4023] Update FileNotFoundException to support appending
 strings

---
 .../src/Framework/Exceptions/FileNotFoundException.php       | 4 ++--
 packages/framework/tests/Unit/CustomExceptionsTest.php       | 5 +++++
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Exceptions/FileNotFoundException.php b/packages/framework/src/Framework/Exceptions/FileNotFoundException.php
index 417a18e3ea7..434c3c582e4 100644
--- a/packages/framework/src/Framework/Exceptions/FileNotFoundException.php
+++ b/packages/framework/src/Framework/Exceptions/FileNotFoundException.php
@@ -17,8 +17,8 @@ class FileNotFoundException extends Exception
     /** @var int */
     protected $code = 404;
 
-    public function __construct(?string $path = null, ?string $customMessage = null)
+    public function __construct(?string $path = null, ?string $customMessage = null, ?string $appendAfterPath = '.')
     {
-        parent::__construct($customMessage ?? ($path ? sprintf('File [%s] not found.', Hyde::pathToRelative($path)) : $this->message));
+        parent::__construct($customMessage ?? ($path ? sprintf('File [%s] not found'.$appendAfterPath, Hyde::pathToRelative($path)) : $this->message));
     }
 }
diff --git a/packages/framework/tests/Unit/CustomExceptionsTest.php b/packages/framework/tests/Unit/CustomExceptionsTest.php
index 97927a1760b..d0ac2ae007d 100644
--- a/packages/framework/tests/Unit/CustomExceptionsTest.php
+++ b/packages/framework/tests/Unit/CustomExceptionsTest.php
@@ -62,6 +62,11 @@ public function testFileNotFoundExceptionWithCustomPath()
         $this->assertSame('foo', (new FileNotFoundException(customMessage: 'foo'))->getMessage());
     }
 
+    public function testFileNotFoundExceptionWithAppendAfterPath()
+    {
+        $this->assertSame('File [foo] not found!', (new FileNotFoundException('foo', null, '!'))->getMessage());
+    }
+
     public function testRouteNotFoundExceptionWithDefaultMessage()
     {
         $this->assertSame('Route not found.', (new RouteNotFoundException())->getMessage());

From 9355134bbb2dbbc47fa9edacb99593f349927782 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 15:13:02 +0200
Subject: [PATCH 3048/4023] Resolve asset links using container to throw when
 they don't exist

---
 .../src/Foundation/Kernel/Hyperlinks.php      | 11 +++--
 .../DynamicMarkdownLinksFeatureTest.php       |  2 +
 .../Feature/Foundation/HyperlinksTest.php     | 47 +++++++++++++++----
 .../framework/tests/Feature/HelpersTest.php   | 24 ++++------
 .../tests/Feature/HydeKernelTest.php          |  7 +++
 .../Markdown/ShortcodeProcessorTest.php       | 13 +++++
 .../Unit/Facades/AssetFacadeUnitTest.php      |  9 +++-
 7 files changed, 82 insertions(+), 31 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 2dd7d07f4e1..6b6c7765346 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -11,7 +11,6 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
-use Illuminate\Support\Str;
 
 use function str_ends_with;
 use function str_starts_with;
@@ -111,6 +110,8 @@ public function mediaLink(string $destination, bool $validate = false): string
      * If the image is already qualified (starts with `http`) it will be returned as is.
      *
      * If a base URL is configured, the image will be returned with a qualified absolute URL.
+     *
+     * @throws FileNotFoundException If the file does not exist in the `_media` directory in order to make the issue clear.
      */
     public function asset(string $name): string
     {
@@ -118,13 +119,13 @@ public function asset(string $name): string
             return $name;
         }
 
-        $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
+        $asset = Hyde::assets()->get($name);
 
-        if (Hyde::hasSiteUrl()) {
-            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
+        if ($asset) {
+            return $asset->getLink();
         }
 
-        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
+        throw new FileNotFoundException(MediaFile::sourcePath($name), appendAfterPath: ' when trying to resolve a media asset.');
     }
 
     /**
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 60208243185..9de203144eb 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -39,6 +39,8 @@ public static function tearDownAfterClass(): void
         unlink('_media/logo.png');
         unlink('_media/image.jpg');
 
+        DynamicMarkdownLinkProcessor::resetAssetMapCache();
+
         parent::tearDownAfterClass();
     }
 
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 88fa946bf24..a26b07be4bd 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -29,10 +29,10 @@ public function testAssetHelperGetsRelativeWebLinkToImageStoredInSiteMediaFolder
     {
         $tests = [
             'test.jpg' => 'media/test.jpg',
-            'foo' => 'media/foo',
             'http://example.com/test.jpg' => 'http://example.com/test.jpg',
             'https://example.com/test.jpg' => 'https://example.com/test.jpg',
         ];
+        $this->file('_media/test.jpg');
 
         foreach ($tests as $input => $expected) {
             $this->assertSame($this->class->asset($input), $expected);
@@ -43,11 +43,12 @@ public function testAssetHelperResolvesPathsForNestedPages()
     {
         $tests = [
             'test.jpg' => '../media/test.jpg',
-            'foo' => '../media/foo',
             'http://example.com/test.jpg' => 'http://example.com/test.jpg',
             'https://example.com/test.jpg' => 'https://example.com/test.jpg',
         ];
 
+        $this->file('_media/test.jpg');
+
         foreach ($tests as $input => $expected) {
             $this->mockCurrentPage('foo/bar');
             $this->assertSame($this->class->asset($input), $expected);
@@ -57,35 +58,61 @@ public function testAssetHelperResolvesPathsForNestedPages()
     public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()
     {
         config(['hyde.url' => 'https://example.org']);
+        $this->file('_media/test.jpg');
         $this->assertSame('https://example.org/media/test.jpg', $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteHasNoBaseUrl()
     {
         $this->withoutSiteUrl();
+        $this->file('_media/test.jpg');
         $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteBaseUrlIsLocalhost()
     {
+        $this->file('_media/test.jpg');
         $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
     }
 
-    public function testAssetHelperReturnsInputWhenImageIsAlreadyQualified()
+    public function testAssetHelperUsesConfiguredMediaDirectory()
     {
-        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
+        Hyde::setMediaDirectory('_assets');
+        $this->file('_assets/test.jpg');
+        $this->assertSame('assets/test.jpg', $this->class->asset('test.jpg'));
     }
 
-    public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardlessOfMatchingTheConfiguredUrl()
+    public function testAssetHelperThrowsExceptionForNonExistentFile()
     {
-        config(['hyde.url' => 'https://example.org']);
-        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
+        $this->expectException(FileNotFoundException::class);
+        $this->class->asset('non_existent_file.jpg');
     }
 
-    public function testAssetHelperUsesConfiguredMediaDirectory()
+    public function testAssetHelperThrowsExceptionFileWithNoExtension()
     {
-        Hyde::setMediaDirectory('_assets');
-        $this->assertSame('assets/test.jpg', $this->class->asset('test.jpg'));
+        $this->file('_media/no_extension');
+        $this->expectException(FileNotFoundException::class);
+        $this->class->asset('no_extension');
+    }
+
+    public function testAssetHelperThrowsExceptionForNonExistentFileNonMediaExtension()
+    {
+        $this->file('_media/test.foo');
+        $this->expectException(FileNotFoundException::class);
+        $this->class->asset('test.foo');
+    }
+
+    public function testAssetHelperThrowsExceptionWithHelpfulMessage()
+    {
+        $this->expectExceptionMessage('File [_media/test.png] not found when trying to resolve a media asset.');
+        $this->expectException(FileNotFoundException::class);
+        $this->class->asset('test.png');
+    }
+
+    public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardlessOfMatchingTheConfiguredUrl()
+    {
+        config(['hyde.url' => 'https://example.org']);
+        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
     }
 
     public function testMediaLinkHelper()
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 3b70f847262..045c6958f15 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -70,15 +70,8 @@ public function testUnslashFunctionTrimsTrailingSlashes()
     /** @covers ::asset */
     public function testAssetFunction()
     {
-        $this->assertSame(Hyde::asset('foo'), asset('foo'));
-        $this->assertSame('media/foo', asset('foo'));
-    }
-
-    /** @covers ::asset */
-    public function testAssetFunctionWithQualifiedUrl()
-    {
-        $this->assertSame(Hyde::asset('foo', true), asset('foo'));
-        $this->assertSame('media/foo', asset('foo'));
+        $this->assertSame(Hyde::asset('app.css'), asset('app.css'));
+        $this->assertSame('media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
@@ -92,21 +85,21 @@ public function testAssetFunctionWithExternalUrl()
     public function testAssetFunctionWithSetBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => 'https://example.com']);
-        $this->assertSame('https://example.com/media/foo', asset('foo'));
+        $this->assertSame('https://example.com/media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithNoBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => null]);
-        $this->assertSame('media/foo', asset('foo'));
+        $this->assertSame('media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithLocalhostBaseUrl()
     {
         $this->app['config']->set(['hyde.url' => 'http://localhost']);
-        $this->assertSame('media/foo', asset('foo'));
+        $this->assertSame('media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
@@ -114,7 +107,7 @@ public function testAssetFunctionFromNestedPage()
     {
         Render::shouldReceive('getRouteKey')->andReturn('foo/bar');
 
-        $this->assertSame('../media/foo', asset('foo'));
+        $this->assertSame('../media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
@@ -122,15 +115,16 @@ public function testAssetFunctionFromDeeplyNestedPage()
     {
         Render::shouldReceive('getRouteKey')->andReturn('foo/bar/baz');
 
-        $this->assertSame('../../media/foo', asset('foo'));
+        $this->assertSame('../../media/app.css', asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithCustomMediaDirectory()
     {
+        $this->file('custom/app.css');
         Hyde::setMediaDirectory('custom');
 
-        $this->assertSame('custom/foo', asset('foo'));
+        $this->assertSame('custom/app.css', asset('app.css'));
     }
 
     /** @covers ::route */
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index f0dac45e3ba..fe452d7756f 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -184,6 +184,8 @@ public function testMediaLinkHelperReturnsRelativeLinkToDestination()
 
     public function testImageHelperReturnsImagePathForGivenName()
     {
+        $this->file('_media/foo.jpg');
+
         Render::share('routeKey', 'foo');
         $this->assertSame('media/foo.jpg', Hyde::asset('foo.jpg'));
         $this->assertSame('https://example.com/foo.jpg', Hyde::asset('https://example.com/foo.jpg'));
@@ -195,11 +197,16 @@ public function testImageHelperReturnsImagePathForGivenName()
 
     public function testImageHelperTrimsMediaPrefix()
     {
+        $this->markTestSkipped('needs to reimplement normalization on the get method');
+        $this->file('_media/foo.jpg');
+
         $this->assertSame('media/foo.jpg', Hyde::asset('media/foo.jpg'));
     }
 
     public function testImageHelperSupportsCustomMediaDirectories()
     {
+        $this->file('_assets/foo.jpg');
+
         Hyde::setMediaDirectory('_assets');
         $this->assertSame('assets/foo.jpg', Hyde::asset('foo.jpg'));
     }
diff --git a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
index 12660727644..2ba7ecaa6e6 100644
--- a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
+use Hyde\Support\Facades\Render;
+use Hyde\Support\Models\RenderData;
 use Hyde\Markdown\Contracts\MarkdownShortcodeContract;
 use Hyde\Markdown\Processing\ShortcodeProcessor;
 use Hyde\Testing\UnitTestCase;
@@ -13,6 +15,17 @@
  */
 class ShortcodeProcessorTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        // Todo: Fix coupling so we don't need to use the Render facade at all here.
+        Render::swap(new RenderData());
+    }
+
     public function testConstructorDiscoversDefaultShortcodes()
     {
         $shortcodes = (new ShortcodeProcessor('foo'))->getShortcodes();
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index f219a8d9318..ceb3949017c 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -10,6 +10,7 @@
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
 use Hyde\Testing\CreatesTemporaryFiles;
+use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**
  * @covers \Hyde\Facades\Asset
@@ -33,7 +34,13 @@ protected function tearDown(): void
 
     public function testGetHelper()
     {
-        $this->assertSame(Hyde::asset('foo'), Asset::get('foo'));
+        $this->assertSame(Hyde::asset('app.css'), Asset::get('app.css'));
+    }
+
+    public function testGetHelperWithNonExistentFile()
+    {
+        $this->expectException(FileNotFoundException::class);
+        Asset::get('styles.css');
     }
 
     public function testHasMediaFileHelper()

From f64bf8437c05b6f9c01f7d454a1cfe52317a935a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 17:37:59 +0200
Subject: [PATCH 3049/4023] Reorder methods

---
 .../src/Support/Filesystem/MediaFile.php      | 40 +++++++++----------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 4d0c52a7ebd..704a9cbf0d1 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -95,17 +95,19 @@ public function getIdentifier(): string
     }
 
     /**
-     * Get the file information as an array.
-     *
-     * @return array{name: string, path: string, length: int, mimeType: string, hash: string}
+     * Get a relative web link to the media file.
      */
-    public function toArray(): array
+    public function getLink(): string
     {
-        return array_merge(parent::toArray(), [
-            'length' => $this->getContentLength(),
-            'mimeType' => $this->getMimeType(),
-            'hash' => $this->getHash(),
-        ]);
+        $name = $this->getIdentifier();
+
+        $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
+
+        if (Hyde::hasSiteUrl()) {
+            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
+        }
+
+        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
     }
 
     /**
@@ -139,19 +141,17 @@ public function getHash(): string
     }
 
     /**
-     * Get a relative web link to the media file.
+     * Get the file information as an array.
+     *
+     * @return array{name: string, path: string, length: int, mimeType: string, hash: string}
      */
-    public function getLink(): string
+    public function toArray(): array
     {
-        $name = $this->getIdentifier();
-
-        $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
-
-        if (Hyde::hasSiteUrl()) {
-            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
-        }
-
-        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
+        return array_merge(parent::toArray(), [
+            'length' => $this->getContentLength(),
+            'mimeType' => $this->getMimeType(),
+            'hash' => $this->getHash(),
+        ]);
     }
 
     /** @internal */

From 23a49e2e4087198c4ce24474e1df54dd0ddb2c82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 20 Aug 2024 18:20:17 +0200
Subject: [PATCH 3050/4023] Make the media file class stringable

---
 .../src/Support/Filesystem/MediaFile.php      | 11 +++-
 .../tests/Unit/Support/MediaFileUnitTest.php  | 57 +++++++++++++++++++
 2 files changed, 67 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 704a9cbf0d1..d322218215a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -5,6 +5,7 @@
 namespace Hyde\Support\Filesystem;
 
 use Hyde\Hyde;
+use Stringable;
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
@@ -21,7 +22,7 @@
 /**
  * File abstraction for a project media file.
  */
-class MediaFile extends ProjectFile
+class MediaFile extends ProjectFile implements Stringable
 {
     /** @var array<string> The default extensions for media types */
     final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
@@ -42,6 +43,14 @@ public function __construct(string $path)
         parent::__construct($this->getNormalizedPath($path));
     }
 
+    /**
+     * Cast the instance to a string which is the resolved web link to the media file.
+     */
+    public function __toString(): string
+    {
+        return $this->getLink();
+    }
+
     /**
      * Get an array of media asset filenames relative to the `_media/` directory.
      *
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 9b1542bbe3d..eb8c945439b 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -517,6 +517,63 @@ public function testGetLinkWithCurrentPageContextAndCustomMediaDirectory()
         Hyde::setMediaDirectory('_media'); // Reset to default
     }
 
+    public function testCanCastToString()
+    {
+        $file = new MediaFile('foo.txt');
+        $this->assertIsString((string) $file);
+        $this->assertSame('media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastReturnsLink()
+    {
+        $file = new MediaFile('foo.txt');
+        $this->assertSame($file->getLink(), (string) $file);
+    }
+
+    public function testStringCastWithCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('custom_media/foo.txt', (string) $file);
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testStringCastWithPrettyUrls()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.pretty_urls' => true]);
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithNestedFile()
+    {
+        $file = new MediaFile('subdirectory/foo.txt');
+        $this->assertSame('media/subdirectory/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithBaseUrl()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.url' => 'https://example.com']);
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('https://example.com/media/foo.txt', (string) $file);
+    }
+
+    public function testStringCastWithCacheBusting()
+    {
+        self::mockConfig(['hyde.enable_cache_busting' => true]);
+        $this->mockFilesystem->shouldReceive('hash')
+            ->andReturn('abc123');
+        $file = new MediaFile('foo.txt');
+        $this->assertSame('media/foo.txt?v=abc123', (string) $file);
+    }
+
+    public function testStringCastWithCurrentPageContext()
+    {
+        $this->mockCurrentPage('foo/bar');
+        $file = new MediaFile('baz.txt');
+        $this->assertSame('../media/baz.txt', (string) $file);
+    }
+
     // Helper method to mock the current page
     protected function mockCurrentPage(string $page): void
     {

From be2e212318cc52a12f83ad9e2ee5c63da85a1e4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 10:58:38 +0200
Subject: [PATCH 3051/4023] Remove qualified URL normalization from the asset
 helper

See https://github.com/hydephp/develop/pull/1932#discussion_r1740182051
---
 .../src/Foundation/Kernel/Hyperlinks.php      |  5 ----
 .../Feature/Foundation/HyperlinksTest.php     | 24 +++++--------------
 .../framework/tests/Feature/HelpersTest.php   |  4 +++-
 .../tests/Feature/HydeKernelTest.php          |  2 --
 4 files changed, 9 insertions(+), 26 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 6b6c7765346..a03e4686f17 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -107,7 +107,6 @@ public function mediaLink(string $destination, bool $validate = false): string
 
     /**
      * Gets a relative web link to the given file stored in the `_site/media` folder.
-     * If the image is already qualified (starts with `http`) it will be returned as is.
      *
      * If a base URL is configured, the image will be returned with a qualified absolute URL.
      *
@@ -115,10 +114,6 @@ public function mediaLink(string $destination, bool $validate = false): string
      */
     public function asset(string $name): string
     {
-        if (Hyperlinks::isRemote($name)) {
-            return $name;
-        }
-
         $asset = Hyde::assets()->get($name);
 
         if ($asset) {
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index a26b07be4bd..9eedeb55782 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -27,32 +27,17 @@ protected function setUp(): void
 
     public function testAssetHelperGetsRelativeWebLinkToImageStoredInSiteMediaFolder()
     {
-        $tests = [
-            'test.jpg' => 'media/test.jpg',
-            'http://example.com/test.jpg' => 'http://example.com/test.jpg',
-            'https://example.com/test.jpg' => 'https://example.com/test.jpg',
-        ];
         $this->file('_media/test.jpg');
 
-        foreach ($tests as $input => $expected) {
-            $this->assertSame($this->class->asset($input), $expected);
-        }
+        $this->assertSame($this->class->asset('test.jpg'), 'media/test.jpg');
     }
 
     public function testAssetHelperResolvesPathsForNestedPages()
     {
-        $tests = [
-            'test.jpg' => '../media/test.jpg',
-            'http://example.com/test.jpg' => 'http://example.com/test.jpg',
-            'https://example.com/test.jpg' => 'https://example.com/test.jpg',
-        ];
-
         $this->file('_media/test.jpg');
 
-        foreach ($tests as $input => $expected) {
-            $this->mockCurrentPage('foo/bar');
-            $this->assertSame($this->class->asset($input), $expected);
-        }
+        $this->mockCurrentPage('foo/bar');
+        $this->assertSame($this->class->asset('test.jpg'), '../media/test.jpg');
     }
 
     public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()
@@ -111,6 +96,9 @@ public function testAssetHelperThrowsExceptionWithHelpfulMessage()
 
     public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardlessOfMatchingTheConfiguredUrl()
     {
+        $this->expectExceptionMessage('File [_media/http://localhost/media/test.jpg] not found when trying to resolve a media asset.');
+        $this->expectException(FileNotFoundException::class);
+
         config(['hyde.url' => 'https://example.org']);
         $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
     }
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 045c6958f15..4610dc52c9a 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -13,6 +13,7 @@
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**
  * Covers the helpers in helpers.php.
@@ -77,7 +78,8 @@ public function testAssetFunction()
     /** @covers ::asset */
     public function testAssetFunctionWithExternalUrl()
     {
-        $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
+        $this->expectException(FileNotFoundException::class);
+        $this->expectExceptionMessage('File [_media/https://example.com/foo] not found when trying to resolve a media asset.');
         $this->assertSame('https://example.com/foo', asset('https://example.com/foo'));
     }
 
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index fe452d7756f..3f0161600f3 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -188,11 +188,9 @@ public function testImageHelperReturnsImagePathForGivenName()
 
         Render::share('routeKey', 'foo');
         $this->assertSame('media/foo.jpg', Hyde::asset('foo.jpg'));
-        $this->assertSame('https://example.com/foo.jpg', Hyde::asset('https://example.com/foo.jpg'));
 
         Render::share('routeKey', 'foo/bar');
         $this->assertSame('../media/foo.jpg', Hyde::asset('foo.jpg'));
-        $this->assertSame('https://example.com/foo.jpg', Hyde::asset('https://example.com/foo.jpg'));
     }
 
     public function testImageHelperTrimsMediaPrefix()

From 0f9cd052f53c25b1eba96d0123ed38fd5519a48e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 12:56:33 +0200
Subject: [PATCH 3052/4023] Fix wrong order of expected and actual

---
 .../framework/tests/Feature/Foundation/HyperlinksTest.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 9eedeb55782..8ed622d6a8c 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -29,7 +29,7 @@ public function testAssetHelperGetsRelativeWebLinkToImageStoredInSiteMediaFolder
     {
         $this->file('_media/test.jpg');
 
-        $this->assertSame($this->class->asset('test.jpg'), 'media/test.jpg');
+        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperResolvesPathsForNestedPages()
@@ -37,7 +37,7 @@ public function testAssetHelperResolvesPathsForNestedPages()
         $this->file('_media/test.jpg');
 
         $this->mockCurrentPage('foo/bar');
-        $this->assertSame($this->class->asset('test.jpg'), '../media/test.jpg');
+        $this->assertSame('../media/test.jpg', $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()

From 32d5dc962e283a5185069c6ee4e5d22ebf975130 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 13:12:56 +0200
Subject: [PATCH 3053/4023] Update outdated test names

---
 packages/framework/tests/Feature/HydeKernelTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 3f0161600f3..7251c81bac5 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -182,7 +182,7 @@ public function testMediaLinkHelperReturnsRelativeLinkToDestination()
         $this->assertSame('../media/foo', Hyde::mediaLink('foo'));
     }
 
-    public function testImageHelperReturnsImagePathForGivenName()
+    public function testAssetHelperReturnsAssetPathForGivenName()
     {
         $this->file('_media/foo.jpg');
 
@@ -193,7 +193,7 @@ public function testImageHelperReturnsImagePathForGivenName()
         $this->assertSame('../media/foo.jpg', Hyde::asset('foo.jpg'));
     }
 
-    public function testImageHelperTrimsMediaPrefix()
+    public function testAssetHelperTrimsMediaPrefix()
     {
         $this->markTestSkipped('needs to reimplement normalization on the get method');
         $this->file('_media/foo.jpg');
@@ -201,7 +201,7 @@ public function testImageHelperTrimsMediaPrefix()
         $this->assertSame('media/foo.jpg', Hyde::asset('media/foo.jpg'));
     }
 
-    public function testImageHelperSupportsCustomMediaDirectories()
+    public function testAssetHelperSupportsCustomMediaDirectories()
     {
         $this->file('_assets/foo.jpg');
 

From 36a2343ecdeab529b9c5d96d4e962034b2f81b2c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 13:18:57 +0200
Subject: [PATCH 3054/4023] Major: Change the asset helper to return MediaFile
 instances

If using strict types, this may cause issues, however the instance is castable to the relative link which is the same value as before.
---
 .../hyde-kernel-hyperlink-methods.md          |  4 +--
 packages/framework/src/Facades/Asset.php      |  2 +-
 .../Concerns/ForwardsHyperlinks.php           |  3 +-
 .../src/Foundation/Kernel/Hyperlinks.php      |  8 +++--
 .../DynamicMarkdownLinkProcessor.php          |  2 +-
 packages/framework/src/helpers.php            | 11 ++++--
 .../Feature/Foundation/HyperlinksTest.php     | 14 ++++----
 .../framework/tests/Feature/HelpersTest.php   | 36 +++++++++++++++----
 .../tests/Feature/HydeKernelTest.php          | 23 +++++++++---
 9 files changed, 74 insertions(+), 29 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
index bd8d609104b..82c400152b2 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-07-26 18:20:22 in 0.13ms -->
+<!-- Generated by HydePHP DocGen script at 2024-09-02 11:18:08 in 0.14ms -->
 
 #### `formatLink()`
 
@@ -32,7 +32,7 @@ Hyde::mediaLink(string $destination, bool $validate): string
 No description provided.
 
 ```php
-Hyde::asset(string $name): string
+Hyde::asset(string $name): Hyde\Support\Filesystem\MediaFile
 ```
 
 #### `url()`
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index d014d1e5ad6..524607e6ebc 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -17,7 +17,7 @@
  */
 class Asset
 {
-    public static function get(string $file): string
+    public static function get(string $file): MediaFile
     {
         return hyde()->asset($file);
     }
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index d797c3cd983..5eae4cd3e4c 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -5,6 +5,7 @@
 namespace Hyde\Foundation\Concerns;
 
 use Hyde\Support\Models\Route;
+use Hyde\Support\Filesystem\MediaFile;
 
 /**
  * @internal Single-use trait for the HydeKernel class.
@@ -28,7 +29,7 @@ public function mediaLink(string $destination, bool $validate = false): string
         return $this->hyperlinks->mediaLink($destination, $validate);
     }
 
-    public function asset(string $name): string
+    public function asset(string $name): MediaFile
     {
         return $this->hyperlinks->asset($name);
     }
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index a03e4686f17..8465cda8377 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -106,18 +106,20 @@ public function mediaLink(string $destination, bool $validate = false): string
     }
 
     /**
-     * Gets a relative web link to the given file stored in the `_site/media` folder.
+     * Gets a MediaAsset instance for the given file stored in the `_site/media` folder.
+     * The returned value can be cast into a string in Blade views to resole the URL.
      *
      * If a base URL is configured, the image will be returned with a qualified absolute URL.
+     * Otherwise, a relative path will be returned based on the rendered page's location.
      *
      * @throws FileNotFoundException If the file does not exist in the `_media` directory in order to make the issue clear.
      */
-    public function asset(string $name): string
+    public function asset(string $name): MediaFile
     {
         $asset = Hyde::assets()->get($name);
 
         if ($asset) {
-            return $asset->getLink();
+            return $asset;
         }
 
         throw new FileNotFoundException(MediaFile::sourcePath($name), appendAfterPath: ' when trying to resolve a media asset.');
diff --git a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
index 7dc220855e0..c14732b2e09 100644
--- a/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
+++ b/packages/framework/src/Markdown/Processing/DynamicMarkdownLinkProcessor.php
@@ -66,7 +66,7 @@ protected static function assetMap(): array
 
     protected static function assetPath(MediaFile $mediaFile): string
     {
-        return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'));
+        return Hyde::asset(Str::after($mediaFile->getPath(), '_media/'))->getLink();
     }
 
     /** @internal Testing helper to reset the asset map cache. */
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 784eb083ac2..07bde2f23e0 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -4,6 +4,8 @@
 
 namespace {
     use Hyde\Foundation\HydeKernel;
+    use Hyde\Support\Filesystem\MediaFile;
+    use Hyde\Framework\Exceptions\FileNotFoundException;
 
     if (! function_exists('hyde')) {
         /**
@@ -20,12 +22,15 @@ function hyde(): HydeKernel
     } else {
         if (! function_exists('asset')) {
             /**
-             * Gets a relative web link to the given file stored in the `_site/media` folder.
-             * If the image is already qualified (starts with `http`) it will be returned as is.
+             * Gets a MediaAsset instance for the given file stored in the `_site/media` folder.
+             * The returned value can be cast into a string in Blade views to resole the URL.
              *
              * If a base URL is configured, the image will be returned with a qualified absolute URL.
+             * Otherwise, a relative path will be returned based on the rendered page's location.
+             *
+             * @throws FileNotFoundException If the file does not exist in the `_media` directory in order to make the issue clear.
              */
-            function asset(string $name): string
+            function asset(string $name): MediaFile
             {
                 return hyde()->asset($name);
             }
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 8ed622d6a8c..24ec78755c6 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -29,7 +29,7 @@ public function testAssetHelperGetsRelativeWebLinkToImageStoredInSiteMediaFolder
     {
         $this->file('_media/test.jpg');
 
-        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperResolvesPathsForNestedPages()
@@ -37,34 +37,34 @@ public function testAssetHelperResolvesPathsForNestedPages()
         $this->file('_media/test.jpg');
 
         $this->mockCurrentPage('foo/bar');
-        $this->assertSame('../media/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('../media/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()
     {
         config(['hyde.url' => 'https://example.org']);
         $this->file('_media/test.jpg');
-        $this->assertSame('https://example.org/media/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('https://example.org/media/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteHasNoBaseUrl()
     {
         $this->withoutSiteUrl();
         $this->file('_media/test.jpg');
-        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteBaseUrlIsLocalhost()
     {
         $this->file('_media/test.jpg');
-        $this->assertSame('media/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperUsesConfiguredMediaDirectory()
     {
         Hyde::setMediaDirectory('_assets');
         $this->file('_assets/test.jpg');
-        $this->assertSame('assets/test.jpg', $this->class->asset('test.jpg'));
+        $this->assertSame('assets/test.jpg', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperThrowsExceptionForNonExistentFile()
@@ -100,7 +100,7 @@ public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardless
         $this->expectException(FileNotFoundException::class);
 
         config(['hyde.url' => 'https://example.org']);
-        $this->assertSame('http://localhost/media/test.jpg', $this->class->asset('http://localhost/media/test.jpg'));
+        $this->assertSame('http://localhost/media/test.jpg', (string) $this->class->asset('http://localhost/media/test.jpg'));
     }
 
     public function testMediaLinkHelper()
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 4610dc52c9a..1cdbabb6c90 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -13,6 +13,7 @@
 use Symfony\Component\Yaml\Yaml;
 use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**
@@ -71,8 +72,11 @@ public function testUnslashFunctionTrimsTrailingSlashes()
     /** @covers ::asset */
     public function testAssetFunction()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         $this->assertSame(Hyde::asset('app.css'), asset('app.css'));
-        $this->assertSame('media/app.css', asset('app.css'));
+        $this->assertSame('media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
@@ -86,38 +90,53 @@ public function testAssetFunctionWithExternalUrl()
     /** @covers ::asset */
     public function testAssetFunctionWithSetBaseUrl()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         $this->app['config']->set(['hyde.url' => 'https://example.com']);
-        $this->assertSame('https://example.com/media/app.css', asset('app.css'));
+        $this->assertSame('https://example.com/media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithNoBaseUrl()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         $this->app['config']->set(['hyde.url' => null]);
-        $this->assertSame('media/app.css', asset('app.css'));
+        $this->assertSame('media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionWithLocalhostBaseUrl()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         $this->app['config']->set(['hyde.url' => 'http://localhost']);
-        $this->assertSame('media/app.css', asset('app.css'));
+        $this->assertSame('media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionFromNestedPage()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         Render::shouldReceive('getRouteKey')->andReturn('foo/bar');
 
-        $this->assertSame('../media/app.css', asset('app.css'));
+        $this->assertSame('../media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
     public function testAssetFunctionFromDeeplyNestedPage()
     {
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
         Render::shouldReceive('getRouteKey')->andReturn('foo/bar/baz');
 
-        $this->assertSame('../../media/app.css', asset('app.css'));
+        $this->assertSame('../../media/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::asset */
@@ -126,7 +145,10 @@ public function testAssetFunctionWithCustomMediaDirectory()
         $this->file('custom/app.css');
         Hyde::setMediaDirectory('custom');
 
-        $this->assertSame('custom/app.css', asset('app.css'));
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('custom/app.css'), asset('app.css'));
+
+        $this->assertSame('custom/app.css', (string) asset('app.css'));
     }
 
     /** @covers ::route */
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 7251c81bac5..518f24db6f1 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -182,15 +182,30 @@ public function testMediaLinkHelperReturnsRelativeLinkToDestination()
         $this->assertSame('../media/foo', Hyde::mediaLink('foo'));
     }
 
+    public function testAssetHelperReturnsMediaFileInstanceForGivenName()
+    {
+        $this->file('_media/foo.jpg');
+
+        $asset = Hyde::asset('foo.jpg');
+
+        $this->assertInstanceOf(MediaFile::class, $asset);
+        $this->assertEquals(new MediaFile('_media/foo.jpg'), $asset);
+
+        $this->assertSame('foo.jpg', $asset->getName());
+        $this->assertSame('_media/foo.jpg', $asset->getPath());
+        $this->assertSame('media/foo.jpg', $asset->getLink());
+        $this->assertSame('media/foo.jpg', (string) $asset);
+    }
+
     public function testAssetHelperReturnsAssetPathForGivenName()
     {
         $this->file('_media/foo.jpg');
 
         Render::share('routeKey', 'foo');
-        $this->assertSame('media/foo.jpg', Hyde::asset('foo.jpg'));
+        $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
 
         Render::share('routeKey', 'foo/bar');
-        $this->assertSame('../media/foo.jpg', Hyde::asset('foo.jpg'));
+        $this->assertSame('../media/foo.jpg', (string) Hyde::asset('foo.jpg'));
     }
 
     public function testAssetHelperTrimsMediaPrefix()
@@ -198,7 +213,7 @@ public function testAssetHelperTrimsMediaPrefix()
         $this->markTestSkipped('needs to reimplement normalization on the get method');
         $this->file('_media/foo.jpg');
 
-        $this->assertSame('media/foo.jpg', Hyde::asset('media/foo.jpg'));
+        $this->assertSame('media/foo.jpg', (string) Hyde::asset('media/foo.jpg'));
     }
 
     public function testAssetHelperSupportsCustomMediaDirectories()
@@ -206,7 +221,7 @@ public function testAssetHelperSupportsCustomMediaDirectories()
         $this->file('_assets/foo.jpg');
 
         Hyde::setMediaDirectory('_assets');
-        $this->assertSame('assets/foo.jpg', Hyde::asset('foo.jpg'));
+        $this->assertSame('assets/foo.jpg', (string) Hyde::asset('foo.jpg'));
     }
 
     public function testAssetsHelperGetsAllSiteAssets()

From 9bb8e6c2f7075f330a59d1a74b43cd2161b6b2e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 13:26:41 +0200
Subject: [PATCH 3055/4023] Create AssetAPIFeatureTest.php

---
 .../framework/tests/Feature/AssetAPIFeatureTest.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 packages/framework/tests/Feature/AssetAPIFeatureTest.php

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
new file mode 100644
index 00000000000..7c39668ffb3
--- /dev/null
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @coversNothing High level test for the Asset API
+ */
+class AssetAPIFeatureTest extends TestCase
+{
+    //
+}

From 001cd3ae42fec6c9278d57a7598f92fcc9be9afb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 13:43:53 +0200
Subject: [PATCH 3056/4023] Test Asset API usages in Blade views

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 34 ++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 7c39668ffb3..4422f8bfcf9 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -2,12 +2,44 @@
 
 declare(strict_types=1);
 
+use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Facades\Blade;
 
 /**
  * @coversNothing High level test for the Asset API
  */
 class AssetAPIFeatureTest extends TestCase
 {
-    //
+    public function testAssetAPIUsagesInBladeViews()
+    {
+        $view = <<<'Blade'
+        @if(Asset::hasMediaFile('app.css'))
+            <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
+            <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
+            <link rel="stylesheet" href="{{ Hyde::asset('app.css') }}">
+            <link rel="stylesheet" href="{{ asset('app.css') }}">
+        @endif
+        
+        @if(Asset::hasMediaFile('missing.png'))
+            Found missing.png
+        @else
+            Missing missing.png
+        @endif
+        Blade;
+
+        $html = Blade::render($view);
+
+        $version = Hyde::assets()->get('app.css')->getHash();
+
+        $this->assertSame(<<<HTML
+        <link rel="stylesheet" href="media/app.css?v=$version">
+            <link rel="stylesheet" href="media/app.css">
+            <link rel="stylesheet" href="media/app.css">
+            <link rel="stylesheet" href="media/app.css">
+        
+            Missing missing.png
+
+        HTML, $html);
+    }
 }

From d7bdc495931f37912881b3f4c093d0f12f39e486 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 13:55:03 +0200
Subject: [PATCH 3057/4023] Swap method declaration order

---
 .../src/Support/Filesystem/MediaFile.php         | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index d322218215a..c58127a6008 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -52,23 +52,23 @@ public function __toString(): string
     }
 
     /**
-     * Get an array of media asset filenames relative to the `_media/` directory.
+     * Get a collection of all media files, parsed into `MediaFile` instances, keyed by the filenames relative to the `_media/` directory.
      *
-     * @return array<int, string> {@example `['app.css', 'images/logo.svg']`}
+     * @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
      */
-    public static function files(): array
+    public static function all(): Collection
     {
-        return static::all()->keys()->all();
+        return Hyde::assets();
     }
 
     /**
-     * Get a collection of all media files, parsed into `MediaFile` instances, keyed by the filenames relative to the `_media/` directory.
+     * Get an array of media asset filenames relative to the `_media/` directory.
      *
-     * @return \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
+     * @return array<int, string> {@example `['app.css', 'images/logo.svg']`}
      */
-    public static function all(): Collection
+    public static function files(): array
     {
-        return Hyde::assets();
+        return static::all()->keys()->all();
     }
 
     /**

From 09243b8d0e87b06dde553a28453823de6e9bbc50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 14:26:49 +0200
Subject: [PATCH 3058/4023] Add `MediaFile::get()` method

---
 packages/framework/src/Support/Filesystem/MediaFile.php   | 8 ++++++++
 packages/framework/tests/Feature/AssetAPIFeatureTest.php  | 4 ++--
 packages/framework/tests/Feature/HydeKernelTest.php       | 7 +++++++
 .../framework/tests/Unit/Support/MediaFileUnitTest.php    | 5 +++++
 4 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index c58127a6008..1dc1478803e 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -51,6 +51,14 @@ public function __toString(): string
         return $this->getLink();
     }
 
+    /**
+     * Get a media file instance from the HydeKernel for the given file.
+     */
+    public static function get(string $file): MediaFile
+    {
+        return Hyde::asset($file);
+    }
+
     /**
      * Get a collection of all media files, parsed into `MediaFile` instances, keyed by the filenames relative to the `_media/` directory.
      *
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 4422f8bfcf9..e3d3cf1fcf4 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Blade;
+use Hyde\Support\Filesystem\MediaFile;
 
 /**
  * @coversNothing High level test for the Asset API
@@ -30,7 +30,7 @@ public function testAssetAPIUsagesInBladeViews()
 
         $html = Blade::render($view);
 
-        $version = Hyde::assets()->get('app.css')->getHash();
+        $version = MediaFile::get('app.css')->getHash();
 
         $this->assertSame(<<<HTML
         <link rel="stylesheet" href="media/app.css?v=$version">
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 518f24db6f1..f6f5a397817 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -224,6 +224,13 @@ public function testAssetHelperSupportsCustomMediaDirectories()
         $this->assertSame('assets/foo.jpg', (string) Hyde::asset('foo.jpg'));
     }
 
+    public function testAssetsHelperGetsAssetsFromKernel()
+    {
+        $this->assertSame(Hyde::kernel()->assets(), Hyde::assets());
+        $this->assertSame(Hyde::asset('app.css'), Hyde::assets()->get('app.css'));
+        $this->assertSame(MediaFile::get('app.css'), Hyde::asset('app.css'));
+    }
+
     public function testAssetsHelperGetsAllSiteAssets()
     {
         $this->assertEquals(new Collection([
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index eb8c945439b..14da69113e3 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -92,6 +92,11 @@ public function testCanMake()
         $this->assertEquals(new MediaFile('foo'), MediaFile::make('foo'));
     }
 
+    public function testCanGet()
+    {
+        $this->assertEquals(new MediaFile('app.css'), MediaFile::get('app.css'));
+    }
+
     public function testCanConstructWithNestedPaths()
     {
         $this->assertSame('_media/path/to/file.txt', MediaFile::make('path/to/file.txt')->path);

From e89b7d5a139e8091d4ac81dc112280688736e59a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:29:33 +0200
Subject: [PATCH 3059/4023] Fall back to make the instance

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1dc1478803e..4766cc63806 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -56,7 +56,7 @@ public function __toString(): string
      */
     public static function get(string $file): MediaFile
     {
-        return Hyde::asset($file);
+        return Hyde::assets()->get($file) ?? static::make($file);
     }
 
     /**

From 17edb9b418e1d0fbc50af2adef1a193fd83a40a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:34:03 +0200
Subject: [PATCH 3060/4023] Inject language reference

---
 packages/framework/tests/Feature/AssetAPIFeatureTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index e3d3cf1fcf4..1914ae73820 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -13,7 +13,7 @@ class AssetAPIFeatureTest extends TestCase
 {
     public function testAssetAPIUsagesInBladeViews()
     {
-        $view = <<<'Blade'
+        $view = /** @lang Blade */ <<<'Blade'
         @if(Asset::hasMediaFile('app.css'))
             <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
             <link rel="stylesheet" href="{{ Asset::get('app.css') }}">

From da1941e89c3ce04fd4957edd8b765b4f06accf90 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:39:36 +0200
Subject: [PATCH 3061/4023] Test Asset API examples

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 1914ae73820..92d8a82f713 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -11,6 +11,31 @@
  */
 class AssetAPIFeatureTest extends TestCase
 {
+    public function testAssetAPIExamples()
+    {
+        $conditions = [
+            'hasMediaFileTrue' => Asset::hasMediaFile('app.css'),
+            'hasMediaFileFalse' => Asset::hasMediaFile('missing.png'),
+            'links' => [
+                Asset::mediaLink('app.css'),
+                Asset::get('app.css'),
+                Hyde::asset('app.css'),
+                asset('app.css'),
+            ],
+        ];
+
+        $this->assertSame([
+            'hasMediaFileTrue' => true,
+            'hasMediaFileFalse' => false,
+            'links' => [
+                'media/app.css?v='.MediaFile::get('app.css')->getHash(),
+                MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
+            ],
+        ], $conditions);
+    }
+
     public function testAssetAPIUsagesInBladeViews()
     {
         $view = /** @lang Blade */ <<<'Blade'

From 7504248536ff02264901ee4b85e39b4e34e16c6c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:42:01 +0200
Subject: [PATCH 3062/4023] Extract helper method

---
 .../framework/tests/Feature/AssetAPIFeatureTest.php   | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 92d8a82f713..d7561351f24 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -28,7 +28,7 @@ public function testAssetAPIExamples()
             'hasMediaFileTrue' => true,
             'hasMediaFileFalse' => false,
             'links' => [
-                'media/app.css?v='.MediaFile::get('app.css')->getHash(),
+                "media/app.css?v={$this->getAppStylesVersion()}",
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
@@ -55,10 +55,8 @@ public function testAssetAPIUsagesInBladeViews()
 
         $html = Blade::render($view);
 
-        $version = MediaFile::get('app.css')->getHash();
-
         $this->assertSame(<<<HTML
-        <link rel="stylesheet" href="media/app.css?v=$version">
+        <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
@@ -67,4 +65,9 @@ public function testAssetAPIUsagesInBladeViews()
 
         HTML, $html);
     }
+
+    protected function getAppStylesVersion(): string
+    {
+        return MediaFile::get('app.css')->getHash();
+    }
 }

From 5a4030f11eb46739c0609c02c66f19297bf52a26 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:58:02 +0200
Subject: [PATCH 3063/4023] Test with all Kernel accessors

---
 .../framework/tests/Feature/AssetAPIFeatureTest.php   | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index d7561351f24..a2223373571 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use Hyde\Testing\TestCase;
+use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\Facades\Blade;
 use Hyde\Support\Filesystem\MediaFile;
 
@@ -19,7 +20,11 @@ public function testAssetAPIExamples()
             'links' => [
                 Asset::mediaLink('app.css'),
                 Asset::get('app.css'),
-                Hyde::asset('app.css'),
+                \Hyde::asset('app.css'),
+                \Hyde\Hyde::asset('app.css'),
+                Hyde::kernel()->asset('app.css'),
+                HydeKernel::getInstance()->asset('app.css'),
+                hyde()->asset('app.css'),
                 asset('app.css'),
             ],
         ];
@@ -32,6 +37,10 @@ public function testAssetAPIExamples()
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
+                MediaFile::get('app.css'),
             ],
         ], $conditions);
     }

From 861b25410b8d1a9b5f7170e0954e4f923861fa4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 16:58:43 +0200
Subject: [PATCH 3064/4023] Provide autocomplete for media file asset getters

---
 ide.json | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/ide.json b/ide.json
index 7fc70f332ac..adc8f317627 100644
--- a/ide.json
+++ b/ide.json
@@ -15,6 +15,29 @@
                 }
             ]
         },
+        {
+            "complete": "directoryFiles",
+            "options": {
+                "directory": "/_media"
+            },
+            "condition": [
+                {
+                    "methodNames": ["get", "mediaLink", "hasMediaFile"],
+                    "place": "parameter",
+                    "classFqn": ["\\Hyde\\Facades\\Asset"],
+                    "parameters": [1]
+                }, {
+                    "methodNames": ["asset"],
+                    "place": "parameter",
+                    "classFqn": ["Hyde\\Foundation\\HydeKernel", "\\Hyde\\Hyde", "Hyde"],
+                    "parameters": [1]
+                }, {
+                    "functionNames": ["asset"],
+                    "place": "parameter",
+                    "parameters": [1]
+                }
+            ]
+        },
         {
             "complete": "configKey",
             "condition": [

From ff439e1d4de693d42832561dce1d299af334d374 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:06:22 +0200
Subject: [PATCH 3065/4023] Provide autocomplete for media file asset accessors

---
 ide.json | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ide.json b/ide.json
index adc8f317627..dcc1dbb9eb3 100644
--- a/ide.json
+++ b/ide.json
@@ -26,6 +26,12 @@
                     "place": "parameter",
                     "classFqn": ["\\Hyde\\Facades\\Asset"],
                     "parameters": [1]
+                },
+                {
+                    "methodNames": ["__construct", "get", "make", "sourcePath", "outputPath"],
+                    "place": "parameter",
+                    "classFqn": ["Hyde\\Support\\Filesystem\\MediaFile"],
+                    "parameters": [1]
                 }, {
                     "methodNames": ["asset"],
                     "place": "parameter",

From bcacc4d49ab6858d58cdf386244c84cee244cb94 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:06:33 +0200
Subject: [PATCH 3066/4023] Update AssetAPIFeatureTest.php

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 22 ++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index a2223373571..31468ac3504 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -14,10 +14,12 @@ class AssetAPIFeatureTest extends TestCase
 {
     public function testAssetAPIExamples()
     {
+        // Tests for the Asset API, can be used to try out the PhpStorm autocompletion
+
         $conditions = [
             'hasMediaFileTrue' => Asset::hasMediaFile('app.css'),
             'hasMediaFileFalse' => Asset::hasMediaFile('missing.png'),
-            'links' => [
+            'getters' => [
                 Asset::mediaLink('app.css'),
                 Asset::get('app.css'),
                 \Hyde::asset('app.css'),
@@ -27,12 +29,19 @@ public function testAssetAPIExamples()
                 hyde()->asset('app.css'),
                 asset('app.css'),
             ],
+            'accessors' => [
+                new MediaFile('app.css'),
+                MediaFile::make('app.css'),
+                MediaFile::get('app.css'),
+                MediaFile::sourcePath('app.css'),
+                MediaFile::outputPath('app.css'),
+            ],
         ];
 
-        $this->assertSame([
+        $this->assertEquals([
             'hasMediaFileTrue' => true,
             'hasMediaFileFalse' => false,
-            'links' => [
+            'getters' => [
                 "media/app.css?v={$this->getAppStylesVersion()}",
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
@@ -42,6 +51,13 @@ public function testAssetAPIExamples()
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
             ],
+            'accessors' => [
+                new MediaFile('app.css'),
+                new MediaFile('app.css'),
+                MediaFile::get('app.css'),
+                Hyde::path('_media/app.css'),
+                Hyde::sitePath('media/app.css'),
+            ],
         ], $conditions);
     }
 

From a6cbbb29fa5073b027f4fc390364bdb5a0a87792 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:10:08 +0200
Subject: [PATCH 3067/4023] Clarify method documentation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 4766cc63806..5cf59551e38 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -52,7 +52,7 @@ public function __toString(): string
     }
 
     /**
-     * Get a media file instance from the HydeKernel for the given file.
+     * Get or create a media file instance from the HydeKernel for the given file.
      */
     public static function get(string $file): MediaFile
     {

From 14a792fbfb91b9f7067f0e50c132a8b41666969b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:10:51 +0200
Subject: [PATCH 3068/4023] Override parent method to get custom child
 documentation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5cf59551e38..326dff207fe 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -51,6 +51,14 @@ public function __toString(): string
         return $this->getLink();
     }
 
+    /**
+     * Create a media file instance for the given file.
+     */
+    public static function make(string $path): static
+    {
+        return parent::make($path);
+    }
+
     /**
      * Get or create a media file instance from the HydeKernel for the given file.
      */

From 81c387e970673124517097fe443578120172c54c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:14:14 +0200
Subject: [PATCH 3069/4023] Normalize parameter name

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 326dff207fe..e2f33c27472 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -62,9 +62,9 @@ public static function make(string $path): static
     /**
      * Get or create a media file instance from the HydeKernel for the given file.
      */
-    public static function get(string $file): MediaFile
+    public static function get(string $path): MediaFile
     {
-        return Hyde::assets()->get($file) ?? static::make($file);
+        return Hyde::assets()->get($path) ?? static::make($path);
     }
 
     /**

From e9baf285e0873b4401d149e3da2c850ab02a6431 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 17:14:39 +0200
Subject: [PATCH 3070/4023] Document base path relation

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index e2f33c27472..2be20c5b457 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -21,6 +21,8 @@
 
 /**
  * File abstraction for a project media file.
+ *
+ * All input paths are relative to the project's media source directory.
  */
 class MediaFile extends ProjectFile implements Stringable
 {

From 48a955151ca785a11240be1a5b425cd03a8a4990 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 20:33:56 +0200
Subject: [PATCH 3071/4023] Normalize exception message

---
 packages/framework/src/Support/Filesystem/MediaFile.php     | 2 +-
 packages/framework/tests/Unit/Support/MediaFileUnitTest.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 2be20c5b457..24739695a0e 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -204,7 +204,7 @@ protected function getNormalizedPath(string $path): string
 
         // Since assets need to exist on disk in order to be copied to the built site files we validate that the file is real here.
         if (Filesystem::missing($path)) {
-            throw new FileNotFoundException($path);
+            throw new FileNotFoundException($path, appendAfterPath: ' when trying to resolve a media asset.');
         }
 
         return $path;
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 14da69113e3..df506517fca 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -333,7 +333,7 @@ public function testExceptionIsThrownWhenBootingFileThatDoesNotExist(string $boo
             ->andReturn(true);
 
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('File [_media/foo] not found.');
+        $this->expectExceptionMessage('File [_media/foo] not found when trying to resolve a media asset.');
 
         MediaFile::make('foo')->$bootableMethod();
     }

From e80e7f31d96bc6fa1c3d04b9eaf29eec629eb5be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 20:42:05 +0200
Subject: [PATCH 3072/4023] Update the kernel asset helper to use the media
 file helper

---
 .../framework/src/Foundation/Kernel/Hyperlinks.php    |  9 +--------
 .../tests/Feature/Foundation/HyperlinksTest.php       | 11 +++++------
 2 files changed, 6 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 8465cda8377..a6edd37ed33 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Foundation\Kernel;
 
-use Hyde\Hyde;
 use Hyde\Facades\Config;
 use BadMethodCallException;
 use Hyde\Support\Models\Route;
@@ -116,13 +115,7 @@ public function mediaLink(string $destination, bool $validate = false): string
      */
     public function asset(string $name): MediaFile
     {
-        $asset = Hyde::assets()->get($name);
-
-        if ($asset) {
-            return $asset;
-        }
-
-        throw new FileNotFoundException(MediaFile::sourcePath($name), appendAfterPath: ' when trying to resolve a media asset.');
+        return MediaFile::get($name);
     }
 
     /**
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 24ec78755c6..724ee8716f5 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -7,6 +7,7 @@
 use Hyde\Foundation\HydeKernel;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Foundation\Kernel\Hyperlinks;
+use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
@@ -73,18 +74,16 @@ public function testAssetHelperThrowsExceptionForNonExistentFile()
         $this->class->asset('non_existent_file.jpg');
     }
 
-    public function testAssetHelperThrowsExceptionFileWithNoExtension()
+    public function testAssetHelperCanGetFileWithNoExtension()
     {
         $this->file('_media/no_extension');
-        $this->expectException(FileNotFoundException::class);
-        $this->class->asset('no_extension');
+        $this->assertInstanceOf(MediaFile::class, $this->class->asset('no_extension'));
     }
 
-    public function testAssetHelperThrowsExceptionForNonExistentFileNonMediaExtension()
+    public function testAssetHelperCanGetFileWithNonMediaExtension()
     {
         $this->file('_media/test.foo');
-        $this->expectException(FileNotFoundException::class);
-        $this->class->asset('test.foo');
+        $this->assertInstanceOf(MediaFile::class, $this->class->asset('test.foo'));
     }
 
     public function testAssetHelperThrowsExceptionWithHelpfulMessage()

From 85bfcc939d04c05914d1cc49421e1bf229e66001 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Sep 2024 20:30:39 +0200
Subject: [PATCH 3073/4023] Replace the `mediaLink` helpers with MediaFile
 getter

Side effects:

Assets included in default views are now qualified if a base URL is set
---
 packages/framework/src/Facades/Asset.php             |  2 +-
 .../framework/tests/Feature/AssetAPIFeatureTest.php  |  6 +++---
 .../tests/Feature/Views/MetadataViewTest.php         | 12 ++++++------
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 524607e6ebc..da8b29138b5 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -24,7 +24,7 @@ public static function get(string $file): MediaFile
 
     public static function mediaLink(string $file): string
     {
-        return hyde()->mediaLink($file);
+        return (string) hyde()->asset($file);
     }
 
     public static function hasMediaFile(string $file): bool
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 31468ac3504..d1007e8392d 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -42,7 +42,7 @@ public function testAssetAPIExamples()
             'hasMediaFileTrue' => true,
             'hasMediaFileFalse' => false,
             'getters' => [
-                "media/app.css?v={$this->getAppStylesVersion()}",
+                MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
@@ -80,8 +80,8 @@ public function testAssetAPIUsagesInBladeViews()
 
         $html = Blade::render($view);
 
-        $this->assertSame(<<<HTML
-        <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
+        $this->assertSame(<<<'HTML'
+        <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
diff --git a/packages/framework/tests/Feature/Views/MetadataViewTest.php b/packages/framework/tests/Feature/Views/MetadataViewTest.php
index b4424aa18c0..68a29eea286 100644
--- a/packages/framework/tests/Feature/Views/MetadataViewTest.php
+++ b/packages/framework/tests/Feature/Views/MetadataViewTest.php
@@ -92,7 +92,7 @@ public function testMetadataTagsInEmptyBladePage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -108,7 +108,7 @@ public function testMetadataTagsInEmptyMarkdownPage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -124,7 +124,7 @@ public function testMetadataTagsInEmptyDocumentationPage()
 
         $assertions = $this->assertSee('docs/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/docs/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -141,7 +141,7 @@ public function testMetadataTagsInEmptyMarkdownPost()
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta name="url" content="https://example.com/posts/test.html">',
@@ -178,7 +178,7 @@ public function testMetadataTagsInMarkdownPostWithFlatFrontMatter()
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My title</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - My title">',
             '<meta name="description" content="My description">',
@@ -285,7 +285,7 @@ public function testMetadataTagsInMarkdownPageWithDescription()
 
         $this->assertSee('test-page', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My Page Title</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<meta name="twitter:title" content="HydePHP - My Page Title">',
             '<meta property="og:title" content="HydePHP - My Page Title">',
             '<meta property="og:description" content="My page description">',

From 29ba2ca2d3d508e861aaef03ecc2704dc8c58fa4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Sep 2024 10:14:26 +0200
Subject: [PATCH 3074/4023] Revert "Replace the `mediaLink` helpers with
 MediaFile getter"

This reverts commit 85bfcc939d04c05914d1cc49421e1bf229e66001.
---
 packages/framework/src/Facades/Asset.php             |  2 +-
 .../framework/tests/Feature/AssetAPIFeatureTest.php  |  6 +++---
 .../tests/Feature/Views/MetadataViewTest.php         | 12 ++++++------
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index da8b29138b5..524607e6ebc 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -24,7 +24,7 @@ public static function get(string $file): MediaFile
 
     public static function mediaLink(string $file): string
     {
-        return (string) hyde()->asset($file);
+        return hyde()->mediaLink($file);
     }
 
     public static function hasMediaFile(string $file): bool
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index d1007e8392d..31468ac3504 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -42,7 +42,7 @@ public function testAssetAPIExamples()
             'hasMediaFileTrue' => true,
             'hasMediaFileFalse' => false,
             'getters' => [
-                MediaFile::get('app.css'),
+                "media/app.css?v={$this->getAppStylesVersion()}",
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
                 MediaFile::get('app.css'),
@@ -80,8 +80,8 @@ public function testAssetAPIUsagesInBladeViews()
 
         $html = Blade::render($view);
 
-        $this->assertSame(<<<'HTML'
-        <link rel="stylesheet" href="media/app.css">
+        $this->assertSame(<<<HTML
+        <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
             <link rel="stylesheet" href="media/app.css">
diff --git a/packages/framework/tests/Feature/Views/MetadataViewTest.php b/packages/framework/tests/Feature/Views/MetadataViewTest.php
index 68a29eea286..b4424aa18c0 100644
--- a/packages/framework/tests/Feature/Views/MetadataViewTest.php
+++ b/packages/framework/tests/Feature/Views/MetadataViewTest.php
@@ -92,7 +92,7 @@ public function testMetadataTagsInEmptyBladePage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -108,7 +108,7 @@ public function testMetadataTagsInEmptyMarkdownPage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -124,7 +124,7 @@ public function testMetadataTagsInEmptyDocumentationPage()
 
         $assertions = $this->assertSee('docs/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="../media/app.css">',
             '<link rel="canonical" href="https://example.com/docs/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -141,7 +141,7 @@ public function testMetadataTagsInEmptyMarkdownPost()
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="../media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta name="url" content="https://example.com/posts/test.html">',
@@ -178,7 +178,7 @@ public function testMetadataTagsInMarkdownPostWithFlatFrontMatter()
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My title</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="../media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - My title">',
             '<meta name="description" content="My description">',
@@ -285,7 +285,7 @@ public function testMetadataTagsInMarkdownPageWithDescription()
 
         $this->assertSee('test-page', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My Page Title</title>',
-            '<link rel="stylesheet" href="https://example.com/media/app.css">',
+            '<link rel="stylesheet" href="media/app.css">',
             '<meta name="twitter:title" content="HydePHP - My Page Title">',
             '<meta property="og:title" content="HydePHP - My Page Title">',
             '<meta property="og:description" content="My page description">',

From 0ffe14fc7bbda426e55e13a4daf63fe87a469c6f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Sep 2024 10:19:46 +0200
Subject: [PATCH 3075/4023] Move internal method to more suitable location

---
 .../framework/src/Foundation/Kernel/Hyperlinks.php     |  2 +-
 .../framework/src/Support/Filesystem/MediaFile.php     | 10 +++++++---
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index a6edd37ed33..45a777d1c03 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -177,7 +177,7 @@ public static function isRemote(string $url): bool
     }
 
     /**
-     * @internal Apply cache to the URL if enabled in the configuration.
+     * @deprecated Use the `MediaFile::getCacheBustKey` method instead.
      */
     public static function withCacheBusting(string $url, string $file): string
     {
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 24739695a0e..4f8203d6401 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -9,7 +9,6 @@
 use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Collection;
-use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Illuminate\Support\Str;
 
@@ -131,10 +130,10 @@ public function getLink(): string
         $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
         if (Hyde::hasSiteUrl()) {
-            return Hyperlinks::withCacheBusting(Hyde::url($name), $name);
+            return static::withCacheBusting(Hyde::url($name), $name);
         }
 
-        return Hyperlinks::withCacheBusting(Hyde::relativeLink($name), $name);
+        return static::withCacheBusting(Hyde::relativeLink($name), $name);
     }
 
     /**
@@ -270,4 +269,9 @@ protected function boot(): void
         $this->mimeType = $this->findMimeType();
         $this->hash = $this->findHash();
     }
+
+    protected static function withCacheBusting(string $url, string $file): string
+    {
+        return $url.MediaFile::getCacheBustKey($file);
+    }
 }

From dd6366c090c39e03aa84dc7e8c917ce1a8b6f6dc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Sep 2024 10:21:31 +0200
Subject: [PATCH 3076/4023] Deprecate internal static method for refactor

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php    | 2 +-
 packages/framework/src/Support/Filesystem/MediaFile.php    | 6 +++---
 packages/framework/tests/Feature/Support/MediaFileTest.php | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 45a777d1c03..197480122ee 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -181,6 +181,6 @@ public static function isRemote(string $url): bool
      */
     public static function withCacheBusting(string $url, string $file): string
     {
-        return $url.MediaFile::getCacheBustKey($file);
+        return $url.MediaFile::legacy_getCacheBustKey($file);
     }
 }
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 4f8203d6401..1380140ba1a 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -180,8 +180,8 @@ public function toArray(): array
         ]);
     }
 
-    /** @internal */
-    public static function getCacheBustKey(string $file): string
+    /** @deprecated Use instance helper */
+    public static function legacy_getCacheBustKey(string $file): string
     {
         return Config::getBool('hyde.enable_cache_busting', true) && Filesystem::exists(static::sourcePath("$file"))
             ? '?v='.static::make($file)->getHash()
@@ -272,6 +272,6 @@ protected function boot(): void
 
     protected static function withCacheBusting(string $url, string $file): string
     {
-        return $url.MediaFile::getCacheBustKey($file);
+        return $url.MediaFile::legacy_getCacheBustKey($file);
     }
 }
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 3a03d1f4bbb..e1b12bb484f 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -113,7 +113,7 @@ public function testMediaFileCacheBusting()
     {
         $this->file('_media/cachebust_test.js', 'console.log("Hello");');
 
-        $cacheBustKey = MediaFile::getCacheBustKey('cachebust_test.js');
+        $cacheBustKey = MediaFile::legacy_getCacheBustKey('cachebust_test.js');
 
         $this->assertStringStartsWith('?v=', $cacheBustKey);
         $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect CRC32 hash

From 2c24add6afdd4dda0e8011641d921454d4dbe686 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Sep 2024 10:28:02 +0200
Subject: [PATCH 3077/4023] Create new instance helper to consistently add
 cache busting keys

---
 .../src/Support/Filesystem/MediaFile.php      | 16 +++---
 .../tests/Feature/AssetAPIFeatureTest.php     |  6 +--
 .../DynamicMarkdownLinksFeatureTest.php       |  7 +++
 .../Feature/Foundation/HyperlinksTest.php     | 14 ++---
 .../framework/tests/Feature/HelpersTest.php   | 22 ++++++++
 .../tests/Feature/HydeKernelTest.php          | 53 ++++++++++++++++---
 .../DynamicMarkdownLinkProcessorTest.php      |  2 +
 7 files changed, 97 insertions(+), 23 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1380140ba1a..3126c34a129 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -130,10 +130,10 @@ public function getLink(): string
         $name = Str::start($name, Hyde::getMediaOutputDirectory().'/');
 
         if (Hyde::hasSiteUrl()) {
-            return static::withCacheBusting(Hyde::url($name), $name);
+            return Hyde::url($name).$this->getCacheBustKey();
         }
 
-        return static::withCacheBusting(Hyde::relativeLink($name), $name);
+        return Hyde::relativeLink($name).$this->getCacheBustKey();
     }
 
     /**
@@ -188,6 +188,13 @@ public static function legacy_getCacheBustKey(string $file): string
             : '';
     }
 
+    protected function getCacheBustKey(): string
+    {
+        return Config::getBool('hyde.enable_cache_busting', true)
+            ? '?v='.$this->getHash()
+            : '';
+    }
+
     protected function getNormalizedPath(string $path): string
     {
         // Ensure we are working with a relative project path
@@ -269,9 +276,4 @@ protected function boot(): void
         $this->mimeType = $this->findMimeType();
         $this->hash = $this->findHash();
     }
-
-    protected static function withCacheBusting(string $url, string $file): string
-    {
-        return $url.MediaFile::legacy_getCacheBustKey($file);
-    }
 }
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 31468ac3504..1f09a7ba721 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -82,9 +82,9 @@ public function testAssetAPIUsagesInBladeViews()
 
         $this->assertSame(<<<HTML
         <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
-            <link rel="stylesheet" href="media/app.css">
-            <link rel="stylesheet" href="media/app.css">
-            <link rel="stylesheet" href="media/app.css">
+            <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
+            <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
+            <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
         
             Missing missing.png
 
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 9de203144eb..97df3a668af 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -44,6 +44,13 @@ public static function tearDownAfterClass(): void
         parent::tearDownAfterClass();
     }
 
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        config(['hyde.enable_cache_busting' => false]);
+    }
+
     public function testBasicDynamicMarkdownLinks()
     {
         $input = <<<'MARKDOWN'
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 724ee8716f5..00b2cb84681 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -30,7 +30,7 @@ public function testAssetHelperGetsRelativeWebLinkToImageStoredInSiteMediaFolder
     {
         $this->file('_media/test.jpg');
 
-        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperResolvesPathsForNestedPages()
@@ -38,34 +38,34 @@ public function testAssetHelperResolvesPathsForNestedPages()
         $this->file('_media/test.jpg');
 
         $this->mockCurrentPage('foo/bar');
-        $this->assertSame('../media/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('../media/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsQualifiedAbsoluteUriWhenSiteHasBaseUrl()
     {
         config(['hyde.url' => 'https://example.org']);
         $this->file('_media/test.jpg');
-        $this->assertSame('https://example.org/media/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('https://example.org/media/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteHasNoBaseUrl()
     {
         $this->withoutSiteUrl();
         $this->file('_media/test.jpg');
-        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperReturnsDefaultRelativePathWhenSiteBaseUrlIsLocalhost()
     {
         $this->file('_media/test.jpg');
-        $this->assertSame('media/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('media/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperUsesConfiguredMediaDirectory()
     {
         Hyde::setMediaDirectory('_assets');
         $this->file('_assets/test.jpg');
-        $this->assertSame('assets/test.jpg', (string) $this->class->asset('test.jpg'));
+        $this->assertSame('assets/test.jpg?v=00000000', (string) $this->class->asset('test.jpg'));
     }
 
     public function testAssetHelperThrowsExceptionForNonExistentFile()
@@ -99,7 +99,7 @@ public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardless
         $this->expectException(FileNotFoundException::class);
 
         config(['hyde.url' => 'https://example.org']);
-        $this->assertSame('http://localhost/media/test.jpg', (string) $this->class->asset('http://localhost/media/test.jpg'));
+        $this->assertSame('http://localhost/media/test.jpg?v=00000000', (string) $this->class->asset('http://localhost/media/test.jpg'));
     }
 
     public function testMediaLinkHelper()
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index 1cdbabb6c90..aefa3b160a4 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -23,6 +23,13 @@
  */
 class HelpersTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        config(['hyde.enable_cache_busting' => false]);
+    }
+
     /** @covers ::hyde */
     public function testHydeFunctionExists()
     {
@@ -79,6 +86,21 @@ public function testAssetFunction()
         $this->assertSame('media/app.css', (string) asset('app.css'));
     }
 
+    /** @covers ::asset */
+    public function testAssetFunctionWithCacheBusting()
+    {
+        config(['hyde.enable_cache_busting' => true]);
+
+        $this->assertInstanceOf(MediaFile::class, asset('app.css'));
+        $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
+
+        $this->assertSame(Hyde::asset('app.css'), asset('app.css'));
+        $this->assertSame(
+            'media/app.css?v='.hash_file('crc32', Hyde::path('_media/app.css')),
+            (string) asset('app.css')
+        );
+    }
+
     /** @covers ::asset */
     public function testAssetFunctionWithExternalUrl()
     {
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index f6f5a397817..423c6c33c44 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -193,8 +193,8 @@ public function testAssetHelperReturnsMediaFileInstanceForGivenName()
 
         $this->assertSame('foo.jpg', $asset->getName());
         $this->assertSame('_media/foo.jpg', $asset->getPath());
-        $this->assertSame('media/foo.jpg', $asset->getLink());
-        $this->assertSame('media/foo.jpg', (string) $asset);
+        $this->assertSame('media/foo.jpg?v=00000000', $asset->getLink());
+        $this->assertSame('media/foo.jpg?v=00000000', (string) $asset);
     }
 
     public function testAssetHelperReturnsAssetPathForGivenName()
@@ -202,10 +202,10 @@ public function testAssetHelperReturnsAssetPathForGivenName()
         $this->file('_media/foo.jpg');
 
         Render::share('routeKey', 'foo');
-        $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
+        $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
 
         Render::share('routeKey', 'foo/bar');
-        $this->assertSame('../media/foo.jpg', (string) Hyde::asset('foo.jpg'));
+        $this->assertSame('../media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
     }
 
     public function testAssetHelperTrimsMediaPrefix()
@@ -213,7 +213,7 @@ public function testAssetHelperTrimsMediaPrefix()
         $this->markTestSkipped('needs to reimplement normalization on the get method');
         $this->file('_media/foo.jpg');
 
-        $this->assertSame('media/foo.jpg', (string) Hyde::asset('media/foo.jpg'));
+        $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('media/foo.jpg'));
     }
 
     public function testAssetHelperSupportsCustomMediaDirectories()
@@ -221,7 +221,48 @@ public function testAssetHelperSupportsCustomMediaDirectories()
         $this->file('_assets/foo.jpg');
 
         Hyde::setMediaDirectory('_assets');
-        $this->assertSame('assets/foo.jpg', (string) Hyde::asset('foo.jpg'));
+        $this->assertSame('assets/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
+    }
+
+    public function testAssetHelperWithoutCacheBusting()
+    {
+        $this->file('_media/foo.jpg');
+
+        Config::set('hyde.enable_cache_busting', false);
+
+        $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
+    }
+
+    public function testAssetHelperWithoutCacheBustingWithChangedSettingInTheSameLifecycle()
+    {
+        $this->file('_media/foo.jpg');
+
+        $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
+
+        Config::set('hyde.enable_cache_busting', false);
+
+        $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
+
+        Config::set('hyde.enable_cache_busting', true);
+
+        $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
+    }
+
+    public function testAssetHelperWithoutCacheBustingWithChangedSettingInTheSameLifecycleForSameInstance()
+    {
+        $this->file('_media/foo.jpg');
+
+        $instance = Hyde::asset('foo.jpg');
+
+        $this->assertSame('media/foo.jpg?v=00000000', (string) $instance);
+
+        Config::set('hyde.enable_cache_busting', false);
+
+        $this->assertSame('media/foo.jpg', (string) $instance);
+
+        Config::set('hyde.enable_cache_busting', true);
+
+        $this->assertSame('media/foo.jpg?v=00000000', (string) $instance);
     }
 
     public function testAssetsHelperGetsAssetsFromKernel()
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 67acd7ffe39..656cd48ca46 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -35,6 +35,8 @@ protected function setUp(): void
         Routes::addRoute(new Route(new MarkdownPost('post')));
 
         // Todo: No way to mock media files, so we are using app.css as a test asset for now.
+
+        self::mockConfig(['hyde.enable_cache_busting' => false]);
     }
 
     public function testRouteReplacement()

From 34d16d9c4a27712fc92f7b67b1281308e35362f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 26 Jul 2024 20:56:28 +0200
Subject: [PATCH 3078/4023] Remove the `validate` parameter from the
 `mediaLink` method

---
 .../framework/src/Foundation/Concerns/ForwardsHyperlinks.php  | 4 ++--
 packages/framework/src/Foundation/Kernel/Hyperlinks.php       | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 5eae4cd3e4c..56d567169bf 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -24,9 +24,9 @@ public function relativeLink(string $destination): string
         return $this->hyperlinks->relativeLink($destination);
     }
 
-    public function mediaLink(string $destination, bool $validate = false): string
+    public function mediaLink(string $destination): string
     {
-        return $this->hyperlinks->mediaLink($destination, $validate);
+        return $this->hyperlinks->mediaLink($destination);
     }
 
     public function asset(string $name): MediaFile
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 197480122ee..552ad334881 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -95,9 +95,9 @@ public function relativeLink(string $destination): string
      * An exception will be thrown if the file does not exist in the _media directory,
      * and the second argument is set to true.
      */
-    public function mediaLink(string $destination, bool $validate = false): string
+    public function mediaLink(string $destination): string
     {
-        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
+        if (false && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
             throw new FileNotFoundException($sourcePath);
         }
 

From d789fda64a01e17cd6d4cd34b3879d8206b74504 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Sep 2024 21:31:43 +0200
Subject: [PATCH 3079/4023] Revert "Remove the `validate` parameter from the
 `mediaLink` method"

This reverts commit 34d16d9c4a27712fc92f7b67b1281308e35362f6.
---
 .../framework/src/Foundation/Concerns/ForwardsHyperlinks.php  | 4 ++--
 packages/framework/src/Foundation/Kernel/Hyperlinks.php       | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 56d567169bf..5eae4cd3e4c 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -24,9 +24,9 @@ public function relativeLink(string $destination): string
         return $this->hyperlinks->relativeLink($destination);
     }
 
-    public function mediaLink(string $destination): string
+    public function mediaLink(string $destination, bool $validate = false): string
     {
-        return $this->hyperlinks->mediaLink($destination);
+        return $this->hyperlinks->mediaLink($destination, $validate);
     }
 
     public function asset(string $name): MediaFile
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 552ad334881..197480122ee 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -95,9 +95,9 @@ public function relativeLink(string $destination): string
      * An exception will be thrown if the file does not exist in the _media directory,
      * and the second argument is set to true.
      */
-    public function mediaLink(string $destination): string
+    public function mediaLink(string $destination, bool $validate = false): string
     {
-        if (false && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
+        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
             throw new FileNotFoundException($sourcePath);
         }
 

From 824ccfb29b3894b92789f1d96c1be4cc032f671c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 10:28:40 +0200
Subject: [PATCH 3080/4023] Add new method to the Filesystem facade to get mime
 types

---
 packages/framework/src/Facades/Filesystem.php | 35 +++++++++++++++++++
 .../tests/Feature/FilesystemFacadeTest.php    | 12 +++++++
 2 files changed, 47 insertions(+)

diff --git a/packages/framework/src/Facades/Filesystem.php b/packages/framework/src/Facades/Filesystem.php
index 3229bc584c3..98f4bfe1dfe 100644
--- a/packages/framework/src/Facades/Filesystem.php
+++ b/packages/framework/src/Facades/Filesystem.php
@@ -129,6 +129,41 @@ public static function putContents(string $path, string $contents, bool $lock =
         return self::put($path, $contents, $lock);
     }
 
+    /**
+     *  Find the MIME type of a file.
+     *
+     * @param  string  $path  The path to the file, relative to the project root or a remote URL.
+     */
+    public static function findMimeType(string $path): string
+    {
+        $extension = self::extension($path);
+
+        $lookup = [
+            'txt' => 'text/plain',
+            'md' => 'text/markdown',
+            'html' => 'text/html',
+            'css' => 'text/css',
+            'svg' => 'image/svg+xml',
+            'png' => 'image/png',
+            'jpg' => 'image/jpeg',
+            'jpeg' => 'image/jpeg',
+            'gif' => 'image/gif',
+            'json' => 'application/json',
+            'js' => 'application/javascript',
+            'xml' => 'application/xml',
+        ];
+
+        if (isset($lookup[$extension])) {
+            return $lookup[$extension];
+        }
+
+        if (extension_loaded('fileinfo') && self::exists($path)) {
+            return self::mimeType($path);
+        }
+
+        return 'text/plain';
+    }
+
     protected static function filesystem(): \Illuminate\Filesystem\Filesystem
     {
         return app(\Illuminate\Filesystem\Filesystem::class);
diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index db00aefc30c..19f22724f9e 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -447,6 +447,18 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
         rmdir(Hyde::path('foo'));
     }
 
+    public function testFindMimeType()
+    {
+        $this->file('test.txt', 'content');
+        $this->assertSame('text/plain', Filesystem::findMimeType('test.txt'));
+
+        $this->file('test.png', 'content');
+        $this->assertSame('image/png', Filesystem::findMimeType('test.png'));
+
+        $this->file('test.unknown', 'content');
+        $this->assertSame('text/plain', Filesystem::findMimeType('test.unknown'));
+    }
+
     protected function createExpectation(string $method, mixed $returns, ...$args): void
     {
         File::shouldReceive($method)->withArgs($args)->once()->andReturn($returns);

From 78fb6d2df3ea1f21e4ee1668978c39a015a078a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 10:33:43 +0200
Subject: [PATCH 3081/4023] Use the new Filesystem helper for mime type
 detection

---
 .../src/Support/Filesystem/MediaFile.php      | 31 +------------------
 1 file changed, 1 insertion(+), 30 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 3126c34a129..1c18444a2da 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -15,7 +15,6 @@
 use function Hyde\unslash;
 use function Hyde\path_join;
 use function Hyde\trim_slashes;
-use function extension_loaded;
 use function array_merge;
 
 /**
@@ -221,37 +220,9 @@ protected function findContentLength(): int
         return Filesystem::size($this->getPath());
     }
 
-    /** @todo Move to Filesystem::findMimeType($path) */
     protected function findMimeType(): string
     {
-        $extension = $this->getExtension();
-
-        // See if we can find a mime type for the extension instead of
-        // having to rely on a PHP extension and filesystem lookups.
-        $lookup = [
-            'txt' => 'text/plain',
-            'md' => 'text/markdown',
-            'html' => 'text/html',
-            'css' => 'text/css',
-            'svg' => 'image/svg+xml',
-            'png' => 'image/png',
-            'jpg' => 'image/jpeg',
-            'jpeg' => 'image/jpeg',
-            'gif' => 'image/gif',
-            'json' => 'application/json',
-            'js' => 'application/javascript',
-            'xml' => 'application/xml',
-        ];
-
-        if (isset($lookup[$extension])) {
-            return $lookup[$extension];
-        }
-
-        if (extension_loaded('fileinfo') && Filesystem::exists($this->getPath())) {
-            return Filesystem::mimeType($this->getPath());
-        }
-
-        return 'text/plain';
+        return Filesystem::findMimeType($this->getPath());
     }
 
     protected function findHash(): string

From 2284cfaa547ca5504f2c6286f9f495787094464e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 10:50:59 +0200
Subject: [PATCH 3082/4023] Improve method documentation

---
 packages/framework/src/Facades/Filesystem.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Filesystem.php b/packages/framework/src/Facades/Filesystem.php
index 98f4bfe1dfe..514a48dfc32 100644
--- a/packages/framework/src/Facades/Filesystem.php
+++ b/packages/framework/src/Facades/Filesystem.php
@@ -130,7 +130,8 @@ public static function putContents(string $path, string $contents, bool $lock =
     }
 
     /**
-     *  Find the MIME type of a file.
+     * Improved mime type detection for the given path that can be relative to the project root,
+     * or a remote URL where this will try to guess the mime type based on the file extension.
      *
      * @param  string  $path  The path to the file, relative to the project root or a remote URL.
      */

From 1da49a29357e5fb493f3ec6c8b2f5b44d9221b15 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 10:51:22 +0200
Subject: [PATCH 3083/4023] Test all cases of the mime type detection method

This is quite important so I want it properly tested
---
 .../tests/Feature/FilesystemFacadeTest.php    | 99 +++++++++++++++++--
 1 file changed, 93 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index 19f22724f9e..7b2aec812bb 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -449,14 +449,101 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
 
     public function testFindMimeType()
     {
-        $this->file('test.txt', 'content');
-        $this->assertSame('text/plain', Filesystem::findMimeType('test.txt'));
+        // Test known extensions
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.txt'));
+        $this->assertSame('text/markdown', Filesystem::findMimeType('file.md'));
+        $this->assertSame('text/html', Filesystem::findMimeType('file.html'));
+        $this->assertSame('text/css', Filesystem::findMimeType('file.css'));
+        $this->assertSame('image/svg+xml', Filesystem::findMimeType('file.svg'));
+        $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpg'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpeg'));
+        $this->assertSame('image/gif', Filesystem::findMimeType('file.gif'));
+        $this->assertSame('application/json', Filesystem::findMimeType('file.json'));
+        $this->assertSame('application/javascript', Filesystem::findMimeType('file.js'));
+        $this->assertSame('application/xml', Filesystem::findMimeType('file.xml'));
 
-        $this->file('test.png', 'content');
-        $this->assertSame('image/png', Filesystem::findMimeType('test.png'));
+        // Test with remote URLs
+        $this->assertSame('text/plain', Filesystem::findMimeType('https://example.com/file.txt'));
+        $this->assertSame('text/markdown', Filesystem::findMimeType('https://example.com/file.md'));
+        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/file.html'));
+        $this->assertSame('text/css', Filesystem::findMimeType('https://example.com/file.css'));
+        $this->assertSame('image/svg+xml', Filesystem::findMimeType('https://example.com/file.svg'));
+        $this->assertSame('image/png', Filesystem::findMimeType('https://example.com/file.png'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpg'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpeg'));
+        $this->assertSame('image/gif', Filesystem::findMimeType('https://example.com/file.gif'));
+        $this->assertSame('application/json', Filesystem::findMimeType('https://example.com/file.json'));
+        $this->assertSame('application/javascript', Filesystem::findMimeType('https://example.com/file.js'));
+        $this->assertSame('application/xml', Filesystem::findMimeType('https://example.com/file.xml'));
 
-        $this->file('test.unknown', 'content');
-        $this->assertSame('text/plain', Filesystem::findMimeType('test.unknown'));
+        // Test unknown extension
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.unknown'));
+
+        // Test file without extension
+        $this->assertSame('text/plain', Filesystem::findMimeType('file'));
+
+        // Test relative path
+        $this->assertSame('text/plain', Filesystem::findMimeType('path/to/file.txt'));
+
+        // Test absolute path
+        $this->assertSame('text/plain', Filesystem::findMimeType('/absolute/path/to/file.txt'));
+
+        // Test URL
+        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/page.html'));
+
+        // Test case sensitivity
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.TXT'));
+
+        // Test fileinfo fallback for existing files where the extension is not in the lookup table
+        $this->file('text.unknown', 'text');
+        $this->assertSame('text/plain', Filesystem::findMimeType('text.unknown'));
+
+        $this->file('blank.unknown', '');
+        $this->assertSame('application/x-empty', Filesystem::findMimeType('blank.unknown'));
+
+        $this->file('empty.unknown');
+        $this->assertSame('application/x-empty', Filesystem::findMimeType('empty.unknown'));
+
+        $this->file('json.unknown', '{"key": "value"}');
+        $this->assertSame('application/json', Filesystem::findMimeType('json.unknown'));
+
+        $this->file('xml.unknown', '<?xml version="1.0" encoding="UTF-8"?><root></root>');
+        $this->assertSame('text/xml', Filesystem::findMimeType('xml.unknown'));
+
+        $this->file('html.unknown', '<!DOCTYPE html><html><head><title>Test</title></head><body></body></html>');
+        $this->assertSame('text/html', Filesystem::findMimeType('html.unknown'));
+
+        $this->file('yaml.unknown', 'key: value');
+        $this->assertSame('text/plain', Filesystem::findMimeType('yaml.unknown')); // YAML is not detected by fileinfo
+
+        $this->file('css.unknown', 'body { color: red; }');
+        $this->assertSame('text/plain', Filesystem::findMimeType('css.unknown')); // CSS is not detected by fileinfo
+
+        $this->file('js.unknown', 'console.log("Hello, World!");');
+        $this->assertSame('text/plain', Filesystem::findMimeType('js.unknown')); // JavaScript is not detected by fileinfo
+
+        $this->file('binary.unknown', "\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0A\x0B\x0C\x0D\x0E\x0F"); // 16 bytes of binary data
+        $this->assertSame('application/octet-stream', Filesystem::findMimeType('binary.unknown'));
+
+        $this->file('png.unknown', base64_decode('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkAAIAAAoAAvM1P4AAAAASUVORK5CYII=')); // 1x1 transparent PNG
+        $this->assertSame('image/png', Filesystem::findMimeType('png.unknown'));
+
+        $this->file('jpeg.unknown', base64_decode('/9j/4AAQSkZJRgABAQEAYABgAAD/4QA6RXhpZgAATU0AKgAAAAgAA1IBAAABAAAAngIBAAABAAAAnwICAAABAAAAnQ==')); // 1x1 JPEG
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('jpeg.unknown'));
+
+        $this->file('gif.unknown', base64_decode('R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=')); // 1x1 GIF
+        $this->assertSame('image/gif', Filesystem::findMimeType('gif.unknown'));
+
+        // Test non-existing file
+        $this->assertSame('text/plain', Filesystem::findMimeType('non_existing_file.txt'));
+
+        // Test it uses lookup before fileinfo (so lookup overrides fileinfo)
+        $this->file('file.png', 'Not PNG content');
+        $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
+
+        $this->file('png.txt', base64_decode('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkAAIAAAoAAvM1P4AAAAASUVORK5CYII=')); // 1x1 transparent PNG
+        $this->assertSame('text/plain', Filesystem::findMimeType('png.txt'));
     }
 
     protected function createExpectation(string $method, mixed $returns, ...$args): void

From 2d4c2d9925d0bafaf779428b1265c60d9249344f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:04:37 +0200
Subject: [PATCH 3084/4023] Extract unit test

---
 .../tests/Feature/FilesystemFacadeTest.php    | 30 +-----------
 ...FilesystemFacadeMimeTypeHelperUnitTest.php | 47 +++++++++++++++++++
 2 files changed, 49 insertions(+), 28 deletions(-)
 create mode 100644 packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php

diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index 7b2aec812bb..0d65c2b4f26 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -15,6 +15,8 @@
  * @covers \Hyde\Facades\Filesystem
  * @covers \Hyde\Foundation\Kernel\Filesystem
  * @covers \Hyde\Framework\Concerns\Internal\ForwardsIlluminateFilesystem
+ *
+ * @see \FilesystemFacadeMimeTypeHelperUnitTest
  */
 class FilesystemFacadeTest extends TestCase
 {
@@ -449,34 +451,6 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
 
     public function testFindMimeType()
     {
-        // Test known extensions
-        $this->assertSame('text/plain', Filesystem::findMimeType('file.txt'));
-        $this->assertSame('text/markdown', Filesystem::findMimeType('file.md'));
-        $this->assertSame('text/html', Filesystem::findMimeType('file.html'));
-        $this->assertSame('text/css', Filesystem::findMimeType('file.css'));
-        $this->assertSame('image/svg+xml', Filesystem::findMimeType('file.svg'));
-        $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpg'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpeg'));
-        $this->assertSame('image/gif', Filesystem::findMimeType('file.gif'));
-        $this->assertSame('application/json', Filesystem::findMimeType('file.json'));
-        $this->assertSame('application/javascript', Filesystem::findMimeType('file.js'));
-        $this->assertSame('application/xml', Filesystem::findMimeType('file.xml'));
-
-        // Test with remote URLs
-        $this->assertSame('text/plain', Filesystem::findMimeType('https://example.com/file.txt'));
-        $this->assertSame('text/markdown', Filesystem::findMimeType('https://example.com/file.md'));
-        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/file.html'));
-        $this->assertSame('text/css', Filesystem::findMimeType('https://example.com/file.css'));
-        $this->assertSame('image/svg+xml', Filesystem::findMimeType('https://example.com/file.svg'));
-        $this->assertSame('image/png', Filesystem::findMimeType('https://example.com/file.png'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpg'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpeg'));
-        $this->assertSame('image/gif', Filesystem::findMimeType('https://example.com/file.gif'));
-        $this->assertSame('application/json', Filesystem::findMimeType('https://example.com/file.json'));
-        $this->assertSame('application/javascript', Filesystem::findMimeType('https://example.com/file.js'));
-        $this->assertSame('application/xml', Filesystem::findMimeType('https://example.com/file.xml'));
-
         // Test unknown extension
         $this->assertSame('text/plain', Filesystem::findMimeType('file.unknown'));
 
diff --git a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
new file mode 100644
index 00000000000..0db2bd6a516
--- /dev/null
+++ b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+use Hyde\Facades\Filesystem;
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Facades\Filesystem
+ *
+ * @see \Hyde\Framework\Testing\Feature\FilesystemFacadeTest
+ */
+class FilesystemFacadeMimeTypeHelperUnitTest extends UnitTestCase
+{
+    protected static bool $needsKernel = true;
+
+    public function testFindMimeType()
+    {
+        // Test known extensions
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.txt'));
+        $this->assertSame('text/markdown', Filesystem::findMimeType('file.md'));
+        $this->assertSame('text/html', Filesystem::findMimeType('file.html'));
+        $this->assertSame('text/css', Filesystem::findMimeType('file.css'));
+        $this->assertSame('image/svg+xml', Filesystem::findMimeType('file.svg'));
+        $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpg'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpeg'));
+        $this->assertSame('image/gif', Filesystem::findMimeType('file.gif'));
+        $this->assertSame('application/json', Filesystem::findMimeType('file.json'));
+        $this->assertSame('application/javascript', Filesystem::findMimeType('file.js'));
+        $this->assertSame('application/xml', Filesystem::findMimeType('file.xml'));
+
+        // Test with remote URLs
+        $this->assertSame('text/plain', Filesystem::findMimeType('https://example.com/file.txt'));
+        $this->assertSame('text/markdown', Filesystem::findMimeType('https://example.com/file.md'));
+        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/file.html'));
+        $this->assertSame('text/css', Filesystem::findMimeType('https://example.com/file.css'));
+        $this->assertSame('image/svg+xml', Filesystem::findMimeType('https://example.com/file.svg'));
+        $this->assertSame('image/png', Filesystem::findMimeType('https://example.com/file.png'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpg'));
+        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpeg'));
+        $this->assertSame('image/gif', Filesystem::findMimeType('https://example.com/file.gif'));
+        $this->assertSame('application/json', Filesystem::findMimeType('https://example.com/file.json'));
+        $this->assertSame('application/javascript', Filesystem::findMimeType('https://example.com/file.js'));
+        $this->assertSame('application/xml', Filesystem::findMimeType('https://example.com/file.xml'));
+    }
+}

From 6ef5d18612e31a7feb177472ee2d12adfe163f8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:05:47 +0200
Subject: [PATCH 3085/4023] Split out to two test methods

---
 .../tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php  | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
index 0db2bd6a516..7f6c27658ec 100644
--- a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
+++ b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
@@ -14,9 +14,8 @@ class FilesystemFacadeMimeTypeHelperUnitTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 
-    public function testFindMimeType()
+    public function testFindMimeTypeWithKnownExtensions()
     {
-        // Test known extensions
         $this->assertSame('text/plain', Filesystem::findMimeType('file.txt'));
         $this->assertSame('text/markdown', Filesystem::findMimeType('file.md'));
         $this->assertSame('text/html', Filesystem::findMimeType('file.html'));
@@ -29,8 +28,10 @@ public function testFindMimeType()
         $this->assertSame('application/json', Filesystem::findMimeType('file.json'));
         $this->assertSame('application/javascript', Filesystem::findMimeType('file.js'));
         $this->assertSame('application/xml', Filesystem::findMimeType('file.xml'));
+    }
 
-        // Test with remote URLs
+    public function testFindMimeTypeWithRemoteUrls()
+    {
         $this->assertSame('text/plain', Filesystem::findMimeType('https://example.com/file.txt'));
         $this->assertSame('text/markdown', Filesystem::findMimeType('https://example.com/file.md'));
         $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/file.html'));

From 935a718d3caf31ef9b8ab08ce1e63d164de946f4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:12:50 +0200
Subject: [PATCH 3086/4023] Use dataproviders for the extensions to test

---
 ...FilesystemFacadeMimeTypeHelperUnitTest.php | 54 ++++++++++---------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
index 7f6c27658ec..89078673ef9 100644
--- a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
+++ b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
@@ -14,35 +14,37 @@ class FilesystemFacadeMimeTypeHelperUnitTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 
-    public function testFindMimeTypeWithKnownExtensions()
+    /**
+     * @dataProvider mimeTypeProvider
+     */
+    public function testFindMimeTypeWithKnownExtensions(string $extension, string $expectedMimeType)
     {
-        $this->assertSame('text/plain', Filesystem::findMimeType('file.txt'));
-        $this->assertSame('text/markdown', Filesystem::findMimeType('file.md'));
-        $this->assertSame('text/html', Filesystem::findMimeType('file.html'));
-        $this->assertSame('text/css', Filesystem::findMimeType('file.css'));
-        $this->assertSame('image/svg+xml', Filesystem::findMimeType('file.svg'));
-        $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpg'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('file.jpeg'));
-        $this->assertSame('image/gif', Filesystem::findMimeType('file.gif'));
-        $this->assertSame('application/json', Filesystem::findMimeType('file.json'));
-        $this->assertSame('application/javascript', Filesystem::findMimeType('file.js'));
-        $this->assertSame('application/xml', Filesystem::findMimeType('file.xml'));
+        $this->assertSame($expectedMimeType, Filesystem::findMimeType("file.$extension"));
     }
 
-    public function testFindMimeTypeWithRemoteUrls()
+    /**
+     * @dataProvider mimeTypeProvider
+     */
+    public function testFindMimeTypeWithRemoteUrls(string $extension, string $expectedMimeType)
     {
-        $this->assertSame('text/plain', Filesystem::findMimeType('https://example.com/file.txt'));
-        $this->assertSame('text/markdown', Filesystem::findMimeType('https://example.com/file.md'));
-        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/file.html'));
-        $this->assertSame('text/css', Filesystem::findMimeType('https://example.com/file.css'));
-        $this->assertSame('image/svg+xml', Filesystem::findMimeType('https://example.com/file.svg'));
-        $this->assertSame('image/png', Filesystem::findMimeType('https://example.com/file.png'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpg'));
-        $this->assertSame('image/jpeg', Filesystem::findMimeType('https://example.com/file.jpeg'));
-        $this->assertSame('image/gif', Filesystem::findMimeType('https://example.com/file.gif'));
-        $this->assertSame('application/json', Filesystem::findMimeType('https://example.com/file.json'));
-        $this->assertSame('application/javascript', Filesystem::findMimeType('https://example.com/file.js'));
-        $this->assertSame('application/xml', Filesystem::findMimeType('https://example.com/file.xml'));
+        $this->assertSame($expectedMimeType, Filesystem::findMimeType("https://example.com/file.$extension"));
+    }
+
+    public static function mimeTypeProvider(): array
+    {
+        return [
+            ['txt', 'text/plain'],
+            ['md', 'text/markdown'],
+            ['html', 'text/html'],
+            ['css', 'text/css'],
+            ['svg', 'image/svg+xml'],
+            ['png', 'image/png'],
+            ['jpg', 'image/jpeg'],
+            ['jpeg', 'image/jpeg'],
+            ['gif', 'image/gif'],
+            ['json', 'application/json'],
+            ['js', 'application/javascript'],
+            ['xml', 'application/xml'],
+        ];
     }
 }

From ebd7be60b1a8d0b933c710eba30fda9b184f5326 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:15:59 +0200
Subject: [PATCH 3087/4023] Move more assertions to the unit test

---
 .../tests/Feature/FilesystemFacadeTest.php    | 18 -----------
 ...FilesystemFacadeMimeTypeHelperUnitTest.php | 30 +++++++++++++++++++
 2 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index 0d65c2b4f26..2470b217abf 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -451,24 +451,6 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
 
     public function testFindMimeType()
     {
-        // Test unknown extension
-        $this->assertSame('text/plain', Filesystem::findMimeType('file.unknown'));
-
-        // Test file without extension
-        $this->assertSame('text/plain', Filesystem::findMimeType('file'));
-
-        // Test relative path
-        $this->assertSame('text/plain', Filesystem::findMimeType('path/to/file.txt'));
-
-        // Test absolute path
-        $this->assertSame('text/plain', Filesystem::findMimeType('/absolute/path/to/file.txt'));
-
-        // Test URL
-        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/page.html'));
-
-        // Test case sensitivity
-        $this->assertSame('text/plain', Filesystem::findMimeType('file.TXT'));
-
         // Test fileinfo fallback for existing files where the extension is not in the lookup table
         $this->file('text.unknown', 'text');
         $this->assertSame('text/plain', Filesystem::findMimeType('text.unknown'));
diff --git a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
index 89078673ef9..d6dbf8d4364 100644
--- a/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
+++ b/packages/framework/tests/Unit/FilesystemFacadeMimeTypeHelperUnitTest.php
@@ -30,6 +30,36 @@ public function testFindMimeTypeWithRemoteUrls(string $extension, string $expect
         $this->assertSame($expectedMimeType, Filesystem::findMimeType("https://example.com/file.$extension"));
     }
 
+    public function testFindMimeTypeWithUnknownExtension()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.unknown'));
+    }
+
+    public function testFindMimeTypeWithFileWithoutExtension()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('file'));
+    }
+
+    public function testFindMimeTypeWithRelativePath()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('path/to/file.txt'));
+    }
+
+    public function testFindMimeTypeWithAbsolutePath()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('/absolute/path/to/file.txt'));
+    }
+
+    public function testFindMimeTypeWithUrl()
+    {
+        $this->assertSame('text/html', Filesystem::findMimeType('https://example.com/page.html'));
+    }
+
+    public function testFindMimeTypeWithCaseSensitivity()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('file.TXT'));
+    }
+
     public static function mimeTypeProvider(): array
     {
         return [

From d7a3a28016c73fdf6bd10eed5eea7b9f6f1dd760 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:17:30 +0200
Subject: [PATCH 3088/4023] Split out each assertion group to its own test
 method

---
 .../tests/Feature/FilesystemFacadeTest.php    | 47 +++++++++++++++++--
 1 file changed, 43 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index 2470b217abf..f46a8694b56 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -449,52 +449,91 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
         rmdir(Hyde::path('foo'));
     }
 
-    public function testFindMimeType()
+    public function testFindMimeTypeWithUnknownExtension()
     {
-        // Test fileinfo fallback for existing files where the extension is not in the lookup table
         $this->file('text.unknown', 'text');
         $this->assertSame('text/plain', Filesystem::findMimeType('text.unknown'));
+    }
 
+    public function testFindMimeTypeWithBlankFile()
+    {
         $this->file('blank.unknown', '');
         $this->assertSame('application/x-empty', Filesystem::findMimeType('blank.unknown'));
+    }
 
+    public function testFindMimeTypeWithEmptyFile()
+    {
         $this->file('empty.unknown');
         $this->assertSame('application/x-empty', Filesystem::findMimeType('empty.unknown'));
+    }
 
+    public function testFindMimeTypeWithJsonFile()
+    {
         $this->file('json.unknown', '{"key": "value"}');
         $this->assertSame('application/json', Filesystem::findMimeType('json.unknown'));
+    }
 
+    public function testFindMimeTypeWithXmlFile()
+    {
         $this->file('xml.unknown', '<?xml version="1.0" encoding="UTF-8"?><root></root>');
         $this->assertSame('text/xml', Filesystem::findMimeType('xml.unknown'));
+    }
 
+    public function testFindMimeTypeWithHtmlFile()
+    {
         $this->file('html.unknown', '<!DOCTYPE html><html><head><title>Test</title></head><body></body></html>');
         $this->assertSame('text/html', Filesystem::findMimeType('html.unknown'));
+    }
 
+    public function testFindMimeTypeWithYamlFile()
+    {
         $this->file('yaml.unknown', 'key: value');
         $this->assertSame('text/plain', Filesystem::findMimeType('yaml.unknown')); // YAML is not detected by fileinfo
+    }
 
+    public function testFindMimeTypeWithCssFile()
+    {
         $this->file('css.unknown', 'body { color: red; }');
         $this->assertSame('text/plain', Filesystem::findMimeType('css.unknown')); // CSS is not detected by fileinfo
+    }
 
+    public function testFindMimeTypeWithJsFile()
+    {
         $this->file('js.unknown', 'console.log("Hello, World!");');
         $this->assertSame('text/plain', Filesystem::findMimeType('js.unknown')); // JavaScript is not detected by fileinfo
+    }
 
+    public function testFindMimeTypeWithBinaryFile()
+    {
         $this->file('binary.unknown', "\x00\x01\x02\x03\x04\x05\x06\x07\x08\x09\x0A\x0B\x0C\x0D\x0E\x0F"); // 16 bytes of binary data
         $this->assertSame('application/octet-stream', Filesystem::findMimeType('binary.unknown'));
+    }
 
+    public function testFindMimeTypeWithPngFile()
+    {
         $this->file('png.unknown', base64_decode('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkAAIAAAoAAvM1P4AAAAASUVORK5CYII=')); // 1x1 transparent PNG
         $this->assertSame('image/png', Filesystem::findMimeType('png.unknown'));
+    }
 
+    public function testFindMimeTypeWithJpegFile()
+    {
         $this->file('jpeg.unknown', base64_decode('/9j/4AAQSkZJRgABAQEAYABgAAD/4QA6RXhpZgAATU0AKgAAAAgAA1IBAAABAAAAngIBAAABAAAAnwICAAABAAAAnQ==')); // 1x1 JPEG
         $this->assertSame('image/jpeg', Filesystem::findMimeType('jpeg.unknown'));
+    }
 
+    public function testFindMimeTypeWithGifFile()
+    {
         $this->file('gif.unknown', base64_decode('R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=')); // 1x1 GIF
         $this->assertSame('image/gif', Filesystem::findMimeType('gif.unknown'));
+    }
 
-        // Test non-existing file
+    public function testFindMimeTypeWithNonExistingFile()
+    {
         $this->assertSame('text/plain', Filesystem::findMimeType('non_existing_file.txt'));
+    }
 
-        // Test it uses lookup before fileinfo (so lookup overrides fileinfo)
+    public function testFindMimeTypeUsesLookupBeforeFileinfo()
+    {
         $this->file('file.png', 'Not PNG content');
         $this->assertSame('image/png', Filesystem::findMimeType('file.png'));
 

From 1a5ed00f300b2eb92e2afb8bd1c7f0e0c68d3e23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 11:18:48 +0200
Subject: [PATCH 3089/4023] Add two initial high level tests

---
 .../framework/tests/Feature/FilesystemFacadeTest.php  | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Feature/FilesystemFacadeTest.php b/packages/framework/tests/Feature/FilesystemFacadeTest.php
index f46a8694b56..94f91d787c2 100644
--- a/packages/framework/tests/Feature/FilesystemFacadeTest.php
+++ b/packages/framework/tests/Feature/FilesystemFacadeTest.php
@@ -449,6 +449,17 @@ public function testMethodWithMixedSequentialAndNamedArgumentsSkippingMiddleOne(
         rmdir(Hyde::path('foo'));
     }
 
+    public function testFindMimeTypeLookup()
+    {
+        $this->assertSame('text/plain', Filesystem::findMimeType('test.txt'));
+    }
+
+    public function testFindMimeTypeWithKnownFile()
+    {
+        $this->file('test.txt', 'This is a test file.');
+        $this->assertSame('text/plain', Filesystem::findMimeType('test.txt'));
+    }
+
     public function testFindMimeTypeWithUnknownExtension()
     {
         $this->file('text.unknown', 'text');

From a3296523fe6b6faa6662d8bfe25f75eaac349a2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 13:47:45 +0200
Subject: [PATCH 3090/4023] Update the RSS feed generator to use the new
 Filesystem facade

---
 .../src/Framework/Features/XmlGenerators/RssFeedGenerator.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Features/XmlGenerators/RssFeedGenerator.php b/packages/framework/src/Framework/Features/XmlGenerators/RssFeedGenerator.php
index b3abfab48d2..c8d6a3340c9 100644
--- a/packages/framework/src/Framework/Features/XmlGenerators/RssFeedGenerator.php
+++ b/packages/framework/src/Framework/Features/XmlGenerators/RssFeedGenerator.php
@@ -12,7 +12,7 @@
 use Hyde\Facades\Site;
 use Hyde\Facades\Config;
 use Hyde\Pages\MarkdownPost;
-use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Facades\Filesystem;
 use Hyde\Framework\Features\Blogging\Models\FeaturedImage;
 
 use function date;
@@ -108,7 +108,7 @@ protected function addAtomLinkItem(): void
 
     protected function getImageType(FeaturedImage $image): string
     {
-        return (new MediaFile($image->getSource()))->getMimeType();
+        return Filesystem::findMimeType($image->getSource());
     }
 
     /** @return numeric-string */

From fdf434143da3144be36ff53dc2d5ecea4b668721 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 14:48:00 +0200
Subject: [PATCH 3091/4023] Get Assets via the Asset API instead of using
 deprecated media links

---
 .../resources/views/layouts/scripts.blade.php |  2 +-
 .../resources/views/layouts/styles.blade.php  |  2 +-
 .../Blogging/Models/FeaturedImage.php         |  2 +-
 .../Feature/FeaturedImageFactoryTest.php      | 26 ++++++++
 .../tests/Feature/FeaturedImageTest.php       | 24 ++++++-
 .../tests/Feature/MarkdownPostTest.php        | 40 ++++++++++++
 .../framework/tests/Feature/MetadataTest.php  | 62 ++++++++++++++-----
 .../StaticSiteBuilderPostModuleTest.php       |  8 ++-
 .../tests/Feature/Views/MetadataViewTest.php  | 20 +++---
 .../Unit/Views/ArticleExcerptViewTest.php     | 27 ++++++--
 .../Unit/Views/FeaturedImageViewTest.php      | 31 +++++++++-
 11 files changed, 201 insertions(+), 43 deletions(-)

diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php
index bdb527f59bb..a5c85b7be1c 100644
--- a/packages/framework/resources/views/layouts/scripts.blade.php
+++ b/packages/framework/resources/views/layouts/scripts.blade.php
@@ -1,6 +1,6 @@
 {{-- The compiled Laravel Mix scripts --}}
 @if(Asset::hasMediaFile('app.js'))
-    <script defer src="{{ Asset::mediaLink('app.js') }}"></script>
+    <script defer src="{{ Asset::get('app.js') }}"></script>
 @endif
 
 {{-- Alpine.js --}}
diff --git a/packages/framework/resources/views/layouts/styles.blade.php b/packages/framework/resources/views/layouts/styles.blade.php
index d1b374d73cf..02ace05e8ef 100644
--- a/packages/framework/resources/views/layouts/styles.blade.php
+++ b/packages/framework/resources/views/layouts/styles.blade.php
@@ -5,7 +5,7 @@
 @if(config('hyde.load_app_styles_from_cdn', false))
     <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
 @elseif(Asset::hasMediaFile('app.css'))
-    <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
+    <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
 @endif
 
 {{-- Dynamic TailwindCSS Play CDN --}}
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index 5c4acef1996..71376cb651f 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -83,7 +83,7 @@ public function getSource(): string
     {
         if ($this->type === self::TYPE_LOCAL) {
             // Return value is always resolvable from a compiled page in the _site directory.
-            return Hyde::mediaLink($this->source);
+            return (string) Hyde::asset($this->source);
         }
 
         return $this->source;
diff --git a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
index 7774e713ed1..2e6ea781049 100644
--- a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
@@ -16,6 +16,15 @@
  */
 class FeaturedImageFactoryTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        config(['hyde.enable_cache_busting' => false]);
+
+        $this->file('_media/foo');
+    }
+
     public function testWithDataFromSchema()
     {
         $array = [
@@ -98,6 +107,8 @@ public function testImagePathsAreNormalizedForCustomizedMediaDirectory()
     {
         Hyde::setMediaDirectory('_assets');
 
+        $this->file('_assets/foo');
+
         $this->assertSourceIsSame('assets/foo', ['image' => 'foo']);
         $this->assertSourceIsSame('assets/foo', ['image' => 'assets/foo']);
         $this->assertSourceIsSame('assets/foo', ['image' => '_assets/foo']);
@@ -111,6 +122,8 @@ public function testImagePathsAreNormalizedForCustomizedMediaDirectoryWithoutUnd
     {
         Hyde::setMediaDirectory('assets');
 
+        $this->file('assets/foo');
+
         $this->assertSourceIsSame('assets/foo', ['image' => 'foo']);
         $this->assertSourceIsSame('assets/foo', ['image' => 'assets/foo']);
         $this->assertSourceIsSame('assets/foo', ['image' => 'assets/foo']);
@@ -120,6 +133,19 @@ public function testImagePathsAreNormalizedForCustomizedMediaDirectoryWithoutUnd
         $this->assertSourceIsSame('assets/foo', ['image' => ['source' => 'assets/foo']]);
     }
 
+    public function testImagePathsWithCacheBusting()
+    {
+        config(['hyde.enable_cache_busting' => true]);
+
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => 'foo']);
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => 'media/foo']);
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => '_media/foo']);
+
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => ['source' => 'foo']]);
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => ['source' => 'media/foo']]);
+        $this->assertSourceIsSame('media/foo?v=00000000', ['image' => ['source' => '_media/foo']]);
+    }
+
     protected function makeFromArray(array $matter): FeaturedImage
     {
         return FeaturedImageFactory::make(new FrontMatter($matter));
diff --git a/packages/framework/tests/Feature/FeaturedImageTest.php b/packages/framework/tests/Feature/FeaturedImageTest.php
index ca252cd7852..47819102cc4 100644
--- a/packages/framework/tests/Feature/FeaturedImageTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageTest.php
@@ -17,6 +17,16 @@
  */
 class FeaturedImageTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        config(['hyde.enable_cache_busting' => false]);
+
+        $this->file('_media/foo', 'test');
+        $this->file('_media/source');
+    }
+
     public function testGetMetadataArray()
     {
         $this->assertSame([
@@ -52,10 +62,8 @@ public function testCanConstructFeaturedImage()
 
     public function testFeaturedImageGetContentLength()
     {
-        $this->file('_media/foo', 'image');
-
         $image = new FeaturedImage('_media/foo', ...$this->defaultArguments());
-        $this->assertSame(5, $image->getContentLength());
+        $this->assertSame(4, $image->getContentLength());
     }
 
     public function testFeaturedImageGetContentLengthWithRemoteSource()
@@ -108,6 +116,16 @@ public function testGetSourceMethod()
         $this->assertSame('http', FeaturedImageFactory::make(new FrontMatter(['image' => 'http']))->getSource());
     }
 
+    public function testImagePathsWithCacheBusting()
+    {
+        config(['hyde.enable_cache_busting' => true]);
+
+        $this->assertSame('media/foo?v=accf8b33', (new FeaturedImage('_media/foo', ...$this->defaultArguments()))->getSource());
+        $this->assertSame('media/foo?v=accf8b33', FeaturedImageFactory::make(new FrontMatter(['image.source' => 'foo']))->getSource());
+        $this->assertSame('media/foo?v=accf8b33', FeaturedImageFactory::make(new FrontMatter(['image.source' => 'media/foo']))->getSource());
+        $this->assertSame('media/foo?v=accf8b33', FeaturedImageFactory::make(new FrontMatter(['image.source' => '_media/foo']))->getSource());
+    }
+
     protected function defaultArguments(): array
     {
         return ['alt', 'title', 'author', 'authorUrl', 'copyright', 'license', 'licenseUrl'];
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index 9716c9c78bf..c266762f1d5 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Hyde;
+use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Framework\Features\Blogging\Models\FeaturedImage;
 use Hyde\Framework\Features\Blogging\Models\PostAuthor;
 use Hyde\Markdown\Models\FrontMatter;
@@ -102,14 +104,28 @@ public function testFeaturedImageCanBeConstructedReturnsNullWhenNoImageIsSetInTh
 
     public function testFeaturedImageCanBeConstructedReturnsImageObjectWithLocalPathWhenMatterIsString()
     {
+        $this->setupMediaFileAndCacheBusting();
+
         $page = MarkdownPost::make(matter: ['image' => 'foo.png']);
         $image = $page->image;
         $this->assertInstanceOf(FeaturedImage::class, $image);
         $this->assertSame('media/foo.png', $image->getSource());
     }
 
+    public function testFeaturedImageCanBeConstructedReturnsImageObjectWithLocalPathAndCacheBusting()
+    {
+        $this->setupMediaFileAndCacheBusting(true);
+
+        $page = MarkdownPost::make(matter: ['image' => 'foo.png']);
+        $image = $page->image;
+        $this->assertInstanceOf(FeaturedImage::class, $image);
+        $this->assertSame('media/foo.png?v=98b41d87', $image->getSource());
+    }
+
     public function testFeaturedImageCanBeConstructedReturnsImageObjectWithRemotePathWhenMatterIsString()
     {
+        $this->setupMediaFileAndCacheBusting(true);
+
         $page = MarkdownPost::make(matter: ['image' => 'https://example.com/foo.png']);
         $image = $page->image;
         $this->assertInstanceOf(FeaturedImage::class, $image);
@@ -118,10 +134,34 @@ public function testFeaturedImageCanBeConstructedReturnsImageObjectWithRemotePat
 
     public function testFeaturedImageCanBeConstructedReturnsImageObjectWithSuppliedDataWhenMatterIsArray()
     {
+        $this->setupMediaFileAndCacheBusting();
         $page = MarkdownPost::make(matter: ['image' => ['source' => 'foo.png', 'titleText' => 'bar']]);
         $image = $page->image;
         $this->assertInstanceOf(FeaturedImage::class, $image);
         $this->assertSame('media/foo.png', $image->getSource());
         $this->assertSame('bar', $image->getTitleText());
     }
+
+    public function testFeaturedImageThrowsExceptionWhenFileDoesNotExist()
+    {
+        $this->expectException(FileNotFoundException::class);
+        $this->expectExceptionMessage('File [_media/nonexistent.png] not found when trying to resolve a media asset.');
+
+        MarkdownPost::make(matter: ['image' => 'nonexistent.png']);
+    }
+
+    public function testFeaturedImageNormalizesPathForDifferentMediaDirectoryConfigurations()
+    {
+        Hyde::setMediaDirectory('assets');
+        $this->file('assets/foo.png', 'test content');
+
+        $page = MarkdownPost::make(matter: ['image' => 'foo.png']);
+        $this->assertSame('assets/foo.png?v=98b41d87', $page->image->getSource());
+    }
+
+    protected function setupMediaFileAndCacheBusting(bool $enableCacheBusting = false): void
+    {
+        $this->file('_media/foo.png', 'test content');
+        config(['hyde.enable_cache_busting' => $enableCacheBusting]);
+    }
 }
diff --git a/packages/framework/tests/Feature/MetadataTest.php b/packages/framework/tests/Feature/MetadataTest.php
index fe6d93b724e..f6c6ce3446d 100644
--- a/packages/framework/tests/Feature/MetadataTest.php
+++ b/packages/framework/tests/Feature/MetadataTest.php
@@ -411,101 +411,129 @@ public function testDoesNotAddPublishedTimePropertyWhenDateIsNotSetInPost()
         $this->assertPageDoesNotHaveMetadata($page, '<meta property="og:article:published_time"');
     }
 
-    public function testAddsImagePropertyWhenImageIsSetInPost()
+    public function testAddsTypePropertyAutomatically()
     {
-        $page = new MarkdownPost(matter: ['image' => 'image.jpg']);
+        $page = new MarkdownPost();
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/image.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:type" content="article">');
     }
 
-    public function testDoesNotAddImagePropertyWhenImageIsNotSetInPost()
+    public function testDynamicPostMetaPropertiesReturnsBaseArrayWhenInitializedWithEmptyFrontMatter()
     {
         $page = new MarkdownPost();
-        $this->assertPageDoesNotHaveMetadata($page, '<meta property="og:image"');
+
+        $this->assertSame('<meta property="og:type" content="article">', $page->metadata->render());
     }
 
-    public function testAddsTypePropertyAutomatically()
+    public function testDoesNotAddImagePropertyWhenImageIsNotSetInPost()
     {
         $page = new MarkdownPost();
-
-        $this->assertPageHasMetadata($page, '<meta property="og:type" content="article">');
+        $this->assertPageDoesNotHaveMetadata($page, '<meta property="og:image"');
     }
 
-    public function testDynamicPostMetaPropertiesReturnsBaseArrayWhenInitializedWithEmptyFrontMatter()
+    public function testAddsImagePropertyWhenImageIsSetInPost()
     {
-        $page = new MarkdownPost();
+        $this->file('_media/image.jpg');
+        $page = new MarkdownPost(matter: ['image' => 'image.jpg']);
 
-        $this->assertSame('<meta property="og:type" content="article">', $page->metadata->render());
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/image.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageMetadataWhenFeaturedImageSetToString()
     {
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost(matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageLinkThatIsAlwaysRelative()
     {
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost(matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageLinkThatIsAlwaysRelativeForNestedPosts()
     {
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost('foo/bar', matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../media/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../media/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageLinkThatIsAlwaysRelativeForNestedOutputDirectories()
     {
         MarkdownPost::setOutputDirectory('_posts/foo');
 
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost(matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../media/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../media/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageLinkThatIsAlwaysRelativeForNestedPostsAndNestedOutputDirectories()
     {
         MarkdownPost::setOutputDirectory('_posts/foo');
 
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost('bar/baz', matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../../media/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../../../media/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageLinkThatUsesTheConfiguredMediaDirectory()
     {
         Hyde::setMediaDirectory('assets');
 
+        $this->file('assets/foo.jpg');
+
         $page = new MarkdownPost(matter: [
             'image' => 'foo.jpg',
         ]);
 
-        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../assets/foo.jpg">');
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../assets/foo.jpg?v=00000000">');
     }
 
     public function testDynamicPostMetaPropertiesContainsImageMetadataWhenFeaturedImageSetToArrayWithPath()
     {
+        $this->file('_media/foo.jpg');
+
         $page = new MarkdownPost(matter: [
             'image' => [
                 'source' => 'foo.jpg',
             ],
         ]);
 
+        $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg?v=00000000">');
+    }
+
+    public function testDynamicPostMetaPropertiesContainsImageLinkWithoutCacheBusting()
+    {
+        config(['hyde.enable_cache_busting' => false]);
+
+        $this->file('_media/foo.jpg');
+
+        $page = new MarkdownPost(matter: [
+            'image' => 'foo.jpg',
+        ]);
+
         $this->assertPageHasMetadata($page, '<meta property="og:image" content="../media/foo.jpg">');
     }
 
diff --git a/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
index 18f4743ecdb..8269e519dc1 100644
--- a/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
+++ b/packages/framework/tests/Feature/StaticSiteBuilderPostModuleTest.php
@@ -23,6 +23,8 @@ protected function setUp(): void
     {
         parent::setUp();
 
+        $this->file('_media/image.png');
+
         $this->post = MarkdownPost::make('test-post', [
             'title' => 'Adventures in Wonderland',
             'description' => 'All in the golden afternoon, full leisurely we glide.',
@@ -119,9 +121,9 @@ public function testPostContainsExpectedAriaSupport()
     public function testPostImageIsResolvedRelatively()
     {
         $this->inspectHtml([
-            '<meta property="og:image" content="../media/image.png">',
-            '<meta itemprop="url" content="../media/image.png">',
-            '<meta itemprop="contentUrl" content="../media/image.png">',
+            '<meta property="og:image" content="../media/image.png?v=00000000">',
+            '<meta itemprop="url" content="../media/image.png?v=00000000">',
+            '<meta itemprop="contentUrl" content="../media/image.png?v=00000000">',
         ]);
     }
 
diff --git a/packages/framework/tests/Feature/Views/MetadataViewTest.php b/packages/framework/tests/Feature/Views/MetadataViewTest.php
index b4424aa18c0..33e0108c7d8 100644
--- a/packages/framework/tests/Feature/Views/MetadataViewTest.php
+++ b/packages/framework/tests/Feature/Views/MetadataViewTest.php
@@ -92,7 +92,7 @@ public function testMetadataTagsInEmptyBladePage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -108,7 +108,7 @@ public function testMetadataTagsInEmptyMarkdownPage()
 
         $assertions = $this->assertSee('test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -124,7 +124,7 @@ public function testMetadataTagsInEmptyDocumentationPage()
 
         $assertions = $this->assertSee('docs/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/docs/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta property="og:title" content="HydePHP - Test">',
@@ -141,7 +141,7 @@ public function testMetadataTagsInEmptyMarkdownPost()
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - Test</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - Test">',
             '<meta name="url" content="https://example.com/posts/test.html">',
@@ -173,12 +173,13 @@ public function testMetadataTagsInMarkdownPostWithFlatFrontMatter()
             Lorem Ipsum Dolor Amet.
             MARKDOWN
         );
+        $this->file('_media/image.jpg');
         $this->build('_posts/test.md');
 
         $assertions = $this->assertSee('posts/test', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My title</title>',
             '<link rel="alternate" href="https://example.com/feed.xml" type="application/rss+xml" title="HydePHP RSS Feed">',
-            '<link rel="stylesheet" href="../media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<link rel="canonical" href="https://example.com/posts/test.html">',
             '<meta name="twitter:title" content="HydePHP - My title">',
             '<meta name="description" content="My description">',
@@ -190,11 +191,11 @@ public function testMetadataTagsInMarkdownPostWithFlatFrontMatter()
             '<meta property="og:url" content="https://example.com/posts/test.html">',
             '<meta property="og:type" content="article">',
             '<meta property="og:article:published_time" content="2022-01-01T00:00:00+00:00">',
-            '<meta property="og:image" content="../media/image.jpg">',
+            '<meta property="og:image" content="https://example.com/media/image.jpg">',
             '<meta itemprop="identifier" content="test">',
             '<meta itemprop="url" content="https://example.com/posts/test.html">',
-            '<meta itemprop="url" content="../media/image.jpg">',
-            '<meta itemprop="contentUrl" content="../media/image.jpg">',
+            '<meta itemprop="url" content="https://example.com/media/image.jpg">',
+            '<meta itemprop="contentUrl" content="https://example.com/media/image.jpg">',
         ]));
 
         $this->assertAllTagsWereCovered('posts/test', $assertions);
@@ -219,6 +220,7 @@ public function testCanonicalUrlTagsAreNotAddedWhenCanonicalUrlIsNotSet()
             Lorem Ipsum Dolor Amet.
             MARKDOWN
         );
+        $this->file('_media/image.jpg');
         $this->build('_posts/test.md');
 
         $assertions = $this->assertSee('posts/test', [
@@ -285,7 +287,7 @@ public function testMetadataTagsInMarkdownPageWithDescription()
 
         $this->assertSee('test-page', array_merge($this->getDefaultTags(), [
             '<title>HydePHP - My Page Title</title>',
-            '<link rel="stylesheet" href="media/app.css">',
+            '<link rel="stylesheet" href="https://example.com/media/app.css">',
             '<meta name="twitter:title" content="HydePHP - My Page Title">',
             '<meta property="og:title" content="HydePHP - My Page Title">',
             '<meta property="og:description" content="My page description">',
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index ea83bdc457a..6b7d49e9ffc 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -96,17 +96,34 @@ public function testItempropImageIsNotAddedWhenThereIsNoImage()
         $this->assertStringNotContainsString('itemprop="image"', $view);
     }
 
-    public function testItempropImageIsAddedWhenThereIsAnImage()
+    public function testItempropImageIsAddedWhenThereIsAnImageWithLocalPath()
     {
-        // Test with local path
+        $this->file('_media/image.jpg');
+
         $viewLocal = $this->renderTestView(MarkdownPost::make(matter: [
-            'image' => 'path/to/local/image.jpg',
+            'image' => 'image.jpg',
         ]));
 
         $this->assertStringContainsString('itemprop="image"', $viewLocal);
-        $this->assertStringContainsString('content="media/path/to/local/image.jpg"', $viewLocal);
+        $this->assertStringContainsString('content="media/image.jpg?v=00000000"', $viewLocal);
+    }
+
+    public function testItempropImageIsAddedWhenThereIsAnImageWithLocalPathNoCache()
+    {
+        $this->file('_media/image.jpg');
+
+        config(['hyde.enable_cache_busting' => false]);
 
-        // Test with remote URL
+        $viewLocalNoCache = $this->renderTestView(MarkdownPost::make(matter: [
+            'image' => 'image.jpg',
+        ]));
+
+        $this->assertStringContainsString('itemprop="image"', $viewLocalNoCache);
+        $this->assertStringContainsString('content="media/image.jpg"', $viewLocalNoCache);
+    }
+
+    public function testItempropImageIsAddedWhenThereIsAnImageWithRemoteUrl()
+    {
         $viewRemote = $this->renderTestView(MarkdownPost::make(matter: [
             'image' => 'https://example.com/image.jpg',
         ]));
diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index 3e6fa630c6c..188f489dc38 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
+use Hyde\Hyde;
 use Hyde\Framework\Factories\FeaturedImageFactory;
 use Hyde\Framework\Features\Blogging\Models\FeaturedImage;
 use Hyde\Markdown\Models\FrontMatter;
@@ -15,6 +16,13 @@
  */
 class FeaturedImageViewTest extends TestCase
 {
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->file('_media/foo.jpg', 'test content');
+        config(['hyde.enable_cache_busting' => false]);
+    }
+
     public function testTheView()
     {
         $component = $this->renderComponent([
@@ -249,6 +257,22 @@ public function testFluentAttributionLogicCreatesFluentMessages7()
         );
     }
 
+    public function testCacheBusting()
+    {
+        config(['hyde.enable_cache_busting' => true]);
+        $component = $this->renderComponent();
+        $this->assertStringContainsString('src="media/foo.jpg?v=98b41d87"', $component);
+    }
+
+    public function testImagePathNormalization()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $this->file('custom_media/bar.png', 'test content');
+
+        $component = $this->renderComponent(['image.source' => 'bar.png']);
+        $this->assertStringContainsString('src="custom_media/bar.png"', $component);
+    }
+
     protected function stripHtml(string $string): string
     {
         return trim($this->stripWhitespace(strip_tags($string)), "\t ");
@@ -259,7 +283,7 @@ protected function stripWhitespace(string $string): string
         return str_replace([' ', "\r", "\n"], '', $string);
     }
 
-    protected function renderComponent(FeaturedImage|array $data = ['image.source' => 'foo']): string
+    protected function renderComponent(FeaturedImage|array $data = ['image.source' => 'foo.jpg']): string
     {
         $image = $data instanceof FeaturedImage ? $data : $this->make($data);
 
@@ -270,9 +294,10 @@ protected function renderComponent(FeaturedImage|array $data = ['image.source' =
         return view('hyde::components.post.image')->render();
     }
 
-    protected function make(array $data = [], string $path = 'foo.png'): FeaturedImage
+    protected function make(array $data = [], string $path = 'foo.jpg'): FeaturedImage
     {
-        $this->file("_media/$path");
+        $mediaDir = config('hyde.media_directory', '_media');
+        $this->file("$mediaDir/$path", 'test content');
 
         return FeaturedImageFactory::make(FrontMatter::fromArray(array_merge(
             ['image.source' => $path],

From 86715b0ca71f03b1b484e2d6aaa25f5b3b19db2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 15:02:18 +0200
Subject: [PATCH 3092/4023] Migrate tests using deprecated media link helper to
 use new Asset API

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 10 +++----
 .../Feature/Foundation/HyperlinksTest.php     | 28 +++++++++----------
 .../tests/Feature/HydeKernelTest.php          |  8 ++++--
 .../Unit/Facades/AssetFacadeUnitTest.php      | 18 ++++++------
 4 files changed, 33 insertions(+), 31 deletions(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 1f09a7ba721..fd78911fc02 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -17,11 +17,11 @@ public function testAssetAPIExamples()
         // Tests for the Asset API, can be used to try out the PhpStorm autocompletion
 
         $conditions = [
-            'hasMediaFileTrue' => Asset::hasMediaFile('app.css'),
-            'hasMediaFileFalse' => Asset::hasMediaFile('missing.png'),
+            'hasMediaFileTrue' => \Hyde\Facades\Asset::hasMediaFile('app.css'),
+            'hasMediaFileFalse' => \Hyde\Facades\Asset::hasMediaFile('missing.png'),
             'getters' => [
-                Asset::mediaLink('app.css'),
-                Asset::get('app.css'),
+                (string) \Hyde\Facades\Asset::get('app.css'),
+                \Hyde\Facades\Asset::get('app.css'),
                 \Hyde::asset('app.css'),
                 \Hyde\Hyde::asset('app.css'),
                 Hyde::kernel()->asset('app.css'),
@@ -65,7 +65,6 @@ public function testAssetAPIUsagesInBladeViews()
     {
         $view = /** @lang Blade */ <<<'Blade'
         @if(Asset::hasMediaFile('app.css'))
-            <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
             <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
             <link rel="stylesheet" href="{{ Hyde::asset('app.css') }}">
             <link rel="stylesheet" href="{{ asset('app.css') }}">
@@ -84,7 +83,6 @@ public function testAssetAPIUsagesInBladeViews()
         <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
-            <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
         
             Missing missing.png
 
diff --git a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
index 00b2cb84681..2b72bf203cb 100644
--- a/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
+++ b/packages/framework/tests/Feature/Foundation/HyperlinksTest.php
@@ -102,33 +102,33 @@ public function testAssetHelperReturnsInputWhenImageIsAlreadyQualifiedRegardless
         $this->assertSame('http://localhost/media/test.jpg?v=00000000', (string) $this->class->asset('http://localhost/media/test.jpg'));
     }
 
-    public function testMediaLinkHelper()
+    public function testAssetHelper()
     {
-        $this->assertSame('media/foo', $this->class->mediaLink('foo'));
+        $this->file('_media/foo', 'test');
+        $class = $this->class;
+        $this->assertSame('media/foo?v=accf8b33', (string) $class->asset('foo'));
     }
 
-    public function testMediaLinkHelperWithRelativePath()
+    public function testAssetHelperWithRelativePath()
     {
         $this->mockCurrentPage('foo/bar');
-        $this->assertSame('../media/foo', $this->class->mediaLink('foo'));
-    }
-
-    public function testMediaLinkHelperUsesConfiguredMediaDirectory()
-    {
-        Hyde::setMediaDirectory('_assets');
-        $this->assertSame('assets/foo', $this->class->mediaLink('foo'));
+        $this->file('_media/foo', 'test');
+        $class = $this->class;
+        $this->assertSame('../media/foo?v=accf8b33', (string) $class->asset('foo'));
     }
 
-    public function testMediaLinkHelperWithValidationAndExistingFile()
+    public function testAssetHelperWithExistingFile()
     {
         $this->file('_media/foo', 'test');
-        $this->assertSame('media/foo?v=accf8b33', $this->class->mediaLink('foo', true));
+        $class = $this->class;
+        $this->assertSame('media/foo?v=accf8b33', (string) $class->asset('foo'));
     }
 
-    public function testMediaLinkHelperWithValidationAndNonExistingFile()
+    public function testAssetHelperWithNonExistingFile()
     {
         $this->expectException(FileNotFoundException::class);
-        $this->class->mediaLink('foo', true);
+        $class = $this->class;
+        (string) $class->asset('foo');
     }
 
     public function testRouteHelper()
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index 423c6c33c44..7579df9ae2a 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -173,13 +173,15 @@ public function testRelativeLinkHelperReturnsRelativeLinkToDestination()
         $this->assertSame('../foo', Hyde::relativeLink('foo'));
     }
 
-    public function testMediaLinkHelperReturnsRelativeLinkToDestination()
+    public function testAssetHelperReturnsRelativeLinkToDestination()
     {
+        $this->file('_media/foo');
+
         Render::share('routeKey', 'bar');
-        $this->assertSame('media/foo', Hyde::mediaLink('foo'));
+        $this->assertSame('media/foo?v=00000000', (string) Hyde::asset('foo'));
 
         Render::share('routeKey', 'foo/bar');
-        $this->assertSame('../media/foo', Hyde::mediaLink('foo'));
+        $this->assertSame('../media/foo?v=00000000', (string) Hyde::asset('foo'));
     }
 
     public function testAssetHelperReturnsMediaFileInstanceForGivenName()
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index ceb3949017c..5a6345fd55e 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -53,30 +53,32 @@ public function testHasMediaFileHelperReturnsTrueForExistingFile()
         $this->assertTrue(Asset::hasMediaFile('app.css'));
     }
 
-    public function testMediaLinkReturnsMediaPathWithCacheKey()
+    public function testAssetReturnsMediaPathWithCacheKey()
     {
-        $this->assertIsString($path = Asset::mediaLink('app.css'));
+        $this->assertIsString($path = (string) Asset::get('app.css'));
         $this->assertSame('media/app.css?v='.hash_file('crc32', Hyde::path('_media/app.css')), $path);
     }
 
-    public function testMediaLinkReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
+    public function testAssetReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
     {
         self::mockConfig(['hyde.enable_cache_busting' => false]);
 
-        $path = Asset::mediaLink('app.css');
+        $path = (string) Asset::get('app.css');
 
         $this->assertIsString($path);
         $this->assertSame('media/app.css', $path);
     }
 
-    public function testMediaLinkSupportsCustomMediaDirectories()
+    public function testAssetSupportsCustomMediaDirectories()
     {
-        $this->directory('_assets');
-        $this->file('_assets/app.css');
+        self::resetKernel();
 
         Hyde::setMediaDirectory('_assets');
 
-        $path = Asset::mediaLink('app.css');
+        $this->directory('_assets');
+        $this->file('_assets/app.css');
+
+        $path = (string) Asset::get('app.css');
 
         $this->assertIsString($path);
         $this->assertSame('assets/app.css?v='.hash_file('crc32', Hyde::path('_assets/app.css')), $path);

From 5ff2550c1d6b35e006f693597badd46b806098bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 15:06:25 +0200
Subject: [PATCH 3093/4023] Breaking: Remove the `mediaLink` helper replaced by
 the Asset API

---
 .../hyde-kernel-hyperlink-methods.md           | 10 +---------
 docs/architecture-concepts/the-hydekernel.md   |  8 --------
 ide.json                                       |  2 +-
 packages/framework/src/Facades/Asset.php       |  5 -----
 .../Foundation/Concerns/ForwardsHyperlinks.php |  5 -----
 .../src/Foundation/Kernel/Hyperlinks.php       | 18 ------------------
 6 files changed, 2 insertions(+), 46 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
index 82c400152b2..102c68dfb7b 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-09-02 11:18:08 in 0.14ms -->
+<!-- Generated by HydePHP DocGen script at 2024-09-04 19:44:45 in 0.10ms -->
 
 #### `formatLink()`
 
@@ -19,14 +19,6 @@ No description provided.
 Hyde::relativeLink(string $destination): string
 ```
 
-#### `mediaLink()`
-
-No description provided.
-
-```php
-Hyde::mediaLink(string $destination, bool $validate): string
-```
-
 #### `asset()`
 
 No description provided.
diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index b4c3dab6dbf..633bb8db889 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -205,14 +205,6 @@ No description provided.
 Hyde::relativeLink(string $destination): string
 ```
 
-#### `mediaLink()`
-
-No description provided.
-
-```php
-Hyde::mediaLink(string $destination, bool $validate): string
-```
-
 #### `asset()`
 
 No description provided.
diff --git a/ide.json b/ide.json
index dcc1dbb9eb3..d6b36b6b45e 100644
--- a/ide.json
+++ b/ide.json
@@ -22,7 +22,7 @@
             },
             "condition": [
                 {
-                    "methodNames": ["get", "mediaLink", "hasMediaFile"],
+                    "methodNames": ["get", "hasMediaFile"],
                     "place": "parameter",
                     "classFqn": ["\\Hyde\\Facades\\Asset"],
                     "parameters": [1]
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 524607e6ebc..4194c27dc66 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -22,11 +22,6 @@ public static function get(string $file): MediaFile
         return hyde()->asset($file);
     }
 
-    public static function mediaLink(string $file): string
-    {
-        return hyde()->mediaLink($file);
-    }
-
     public static function hasMediaFile(string $file): bool
     {
         return file_exists(MediaFile::sourcePath($file));
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 5eae4cd3e4c..6b28b7ea3d4 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -24,11 +24,6 @@ public function relativeLink(string $destination): string
         return $this->hyperlinks->relativeLink($destination);
     }
 
-    public function mediaLink(string $destination, bool $validate = false): string
-    {
-        return $this->hyperlinks->mediaLink($destination, $validate);
-    }
-
     public function asset(string $name): MediaFile
     {
         return $this->hyperlinks->asset($name);
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 197480122ee..28cb7580abd 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -14,7 +14,6 @@
 use function str_ends_with;
 use function str_starts_with;
 use function substr_count;
-use function file_exists;
 use function str_replace;
 use function str_repeat;
 use function substr;
@@ -87,23 +86,6 @@ public function relativeLink(string $destination): string
         return str_replace('//', '/', $route);
     }
 
-    /**
-     * Gets a relative web link to the given file stored in the _site/media folder.
-     *
-     * @deprecated Use the `asset` method instead.
-     *
-     * An exception will be thrown if the file does not exist in the _media directory,
-     * and the second argument is set to true.
-     */
-    public function mediaLink(string $destination, bool $validate = false): string
-    {
-        if ($validate && ! file_exists($sourcePath = "{$this->kernel->getMediaDirectory()}/$destination")) {
-            throw new FileNotFoundException($sourcePath);
-        }
-
-        return static::withCacheBusting($this->relativeLink("{$this->kernel->getMediaOutputDirectory()}/$destination"), $destination);
-    }
-
     /**
      * Gets a MediaAsset instance for the given file stored in the `_site/media` folder.
      * The returned value can be cast into a string in Blade views to resole the URL.

From ff183486d136bc9a8dfc6af5228a2b30ab1f99be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Sep 2024 15:13:16 +0200
Subject: [PATCH 3094/4023] Remove deprecated withCacheBusting method

---
 packages/framework/src/Foundation/Kernel/Hyperlinks.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index 28cb7580abd..fffae96b0d6 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -157,12 +157,4 @@ public static function isRemote(string $url): bool
     {
         return str_starts_with($url, 'http') || str_starts_with($url, '//');
     }
-
-    /**
-     * @deprecated Use the `MediaFile::getCacheBustKey` method instead.
-     */
-    public static function withCacheBusting(string $url, string $file): string
-    {
-        return $url.MediaFile::legacy_getCacheBustKey($file);
-    }
 }

From d8a97fd0295bd5bc94960206136666855dd27331 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 10:58:29 +0200
Subject: [PATCH 3095/4023] Remove already evaluated condition

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 1c18444a2da..eb1004576f6 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -239,10 +239,6 @@ protected function ensureInstanceIsBooted(string $property): void
 
     protected function boot(): void
     {
-        if (Filesystem::missing($this->getPath())) {
-            throw new FileNotFoundException($this->getPath());
-        }
-
         $this->length = $this->findContentLength();
         $this->mimeType = $this->findMimeType();
         $this->hash = $this->findHash();

From c2cf04e4ceff8c7d467ee989ef9f795655c6ff33 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:00:46 +0200
Subject: [PATCH 3096/4023] Remove deprecated legacy helper

---
 packages/framework/src/Support/Filesystem/MediaFile.php   | 8 --------
 .../framework/tests/Feature/Support/MediaFileTest.php     | 3 ++-
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index eb1004576f6..6c095bcc07e 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -179,14 +179,6 @@ public function toArray(): array
         ]);
     }
 
-    /** @deprecated Use instance helper */
-    public static function legacy_getCacheBustKey(string $file): string
-    {
-        return Config::getBool('hyde.enable_cache_busting', true) && Filesystem::exists(static::sourcePath("$file"))
-            ? '?v='.static::make($file)->getHash()
-            : '';
-    }
-
     protected function getCacheBustKey(): string
     {
         return Config::getBool('hyde.enable_cache_busting', true)
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index e1b12bb484f..2752c362f4a 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Support\Str;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 
@@ -113,7 +114,7 @@ public function testMediaFileCacheBusting()
     {
         $this->file('_media/cachebust_test.js', 'console.log("Hello");');
 
-        $cacheBustKey = MediaFile::legacy_getCacheBustKey('cachebust_test.js');
+        $cacheBustKey = Str::after(MediaFile::make('cachebust_test.js')->getLink(), '.js');
 
         $this->assertStringStartsWith('?v=', $cacheBustKey);
         $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect CRC32 hash

From 32b5b6fda1b15e46ae12609971da7718624e414d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:03:58 +0200
Subject: [PATCH 3097/4023] Use fully qualified class names in docblocks

---
 packages/framework/src/Support/Filesystem/MediaFile.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 6c095bcc07e..de4b7867630 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -36,7 +36,7 @@ class MediaFile extends ProjectFile implements Stringable
      *
      * @param  string  $path  The file path relative to the project root or media source directory.
      *
-     * @throws FileNotFoundException If the file does not exist in the media source directory.
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the media source directory.
      */
     public function __construct(string $path)
     {

From 8dfb5ce2f3fa760b9a30b34c135aff9308467664 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:10:36 +0200
Subject: [PATCH 3098/4023] Test it throws exceptions for non existent media
 files

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 5de775575b5..4380f63d097 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -6,6 +6,7 @@
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\Facades\Blade;
 use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**
  * High level test for the Asset API.
@@ -93,6 +94,36 @@ public function testAssetAPIUsagesInBladeViews()
         HTML, $html);
     }
 
+    public function testThrowsExceptionForNonExistentMediaFile()
+    {
+        $nonExistentFile = 'non_existent_file.txt';
+
+        $accessors = [
+            fn () => \Hyde\Facades\Asset::get($nonExistentFile),
+            fn () => \Hyde::asset($nonExistentFile),
+            fn () => \Hyde\Hyde::asset($nonExistentFile),
+            fn () => Hyde::kernel()->asset($nonExistentFile),
+            fn () => HydeKernel::getInstance()->asset($nonExistentFile),
+            fn () => hyde()->asset($nonExistentFile),
+            fn () => asset($nonExistentFile),
+            fn () => new MediaFile($nonExistentFile),
+            fn () => MediaFile::make($nonExistentFile),
+            fn () => MediaFile::get($nonExistentFile),
+        ];
+
+        foreach ($accessors as $test => $accessor) {
+            try {
+                $accessor();
+                $this->fail('Expected exception to be thrown for syntax test #'.$test);
+            } catch (FileNotFoundException $exception) {
+                $this->assertSame('File [_media/non_existent_file.txt] not found when trying to resolve a media asset.', $exception->getMessage());
+            }
+        }
+
+        $this->assertSame(Hyde::path('_media/non_existent_file.txt'), MediaFile::sourcePath($nonExistentFile));
+        $this->assertSame(Hyde::path('_site/media/non_existent_file.txt'), MediaFile::outputPath($nonExistentFile));
+    }
+
     protected function getAppStylesVersion(): string
     {
         return MediaFile::get('app.css')->getHash();

From a897d0dd07f583782a687c1f7f7370021286d339 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:17:08 +0200
Subject: [PATCH 3099/4023] Breaking: Rename `Asset::hasMediaFile` to
 `Asset::exists`

Also considered `has`, but exists is generally better for clarity, as it directly indicates that you're checking for the presence of a file. has can be more ambiguous, as it might imply ownership or possession rather than existence. Therefore, exists is often preferred for methods that check for the presence of an item. It's also what the Laravel Filesystem facade uses
---
 ide.json                                             |  2 +-
 .../resources/views/layouts/scripts.blade.php        |  2 +-
 .../resources/views/layouts/styles.blade.php         |  2 +-
 packages/framework/src/Facades/Asset.php             |  2 +-
 .../framework/tests/Feature/AssetAPIFeatureTest.php  | 12 ++++++------
 .../tests/Unit/Facades/AssetFacadeUnitTest.php       |  4 ++--
 6 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/ide.json b/ide.json
index d6b36b6b45e..08e825f6361 100644
--- a/ide.json
+++ b/ide.json
@@ -22,7 +22,7 @@
             },
             "condition": [
                 {
-                    "methodNames": ["get", "hasMediaFile"],
+                    "methodNames": ["get", "exists"],
                     "place": "parameter",
                     "classFqn": ["\\Hyde\\Facades\\Asset"],
                     "parameters": [1]
diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php
index a5c85b7be1c..abc3a7030b5 100644
--- a/packages/framework/resources/views/layouts/scripts.blade.php
+++ b/packages/framework/resources/views/layouts/scripts.blade.php
@@ -1,5 +1,5 @@
 {{-- The compiled Laravel Mix scripts --}}
-@if(Asset::hasMediaFile('app.js'))
+@if(Asset::exists('app.js'))
     <script defer src="{{ Asset::get('app.js') }}"></script>
 @endif
 
diff --git a/packages/framework/resources/views/layouts/styles.blade.php b/packages/framework/resources/views/layouts/styles.blade.php
index 02ace05e8ef..8bf4d5bcc55 100644
--- a/packages/framework/resources/views/layouts/styles.blade.php
+++ b/packages/framework/resources/views/layouts/styles.blade.php
@@ -4,7 +4,7 @@
 {{-- The compiled Tailwind/App styles --}}
 @if(config('hyde.load_app_styles_from_cdn', false))
     <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
-@elseif(Asset::hasMediaFile('app.css'))
+@elseif(Asset::exists('app.css'))
     <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
 @endif
 
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 4194c27dc66..92b2ee30097 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -22,7 +22,7 @@ public static function get(string $file): MediaFile
         return hyde()->asset($file);
     }
 
-    public static function hasMediaFile(string $file): bool
+    public static function exists(string $file): bool
     {
         return file_exists(MediaFile::sourcePath($file));
     }
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 4380f63d097..8961c16cd5f 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -22,8 +22,8 @@ public function testAssetAPIExamples()
         // Tests for the Asset API, can be used to try out the PhpStorm autocompletion
 
         $conditions = [
-            'hasMediaFileTrue' => \Hyde\Facades\Asset::hasMediaFile('app.css'),
-            'hasMediaFileFalse' => \Hyde\Facades\Asset::hasMediaFile('missing.png'),
+            'existsTrue' => \Hyde\Facades\Asset::exists('app.css'),
+            'existsFalse' => \Hyde\Facades\Asset::exists('missing.png'),
             'getters' => [
                 (string) \Hyde\Facades\Asset::get('app.css'),
                 \Hyde\Facades\Asset::get('app.css'),
@@ -44,8 +44,8 @@ public function testAssetAPIExamples()
         ];
 
         $this->assertEquals([
-            'hasMediaFileTrue' => true,
-            'hasMediaFileFalse' => false,
+            'existsTrue' => true,
+            'existsFalse' => false,
             'getters' => [
                 "media/app.css?v={$this->getAppStylesVersion()}",
                 MediaFile::get('app.css'),
@@ -69,13 +69,13 @@ public function testAssetAPIExamples()
     public function testAssetAPIUsagesInBladeViews()
     {
         $view = /** @lang Blade */ <<<'Blade'
-        @if(Asset::hasMediaFile('app.css'))
+        @if(Asset::exists('app.css'))
             <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
             <link rel="stylesheet" href="{{ Hyde::asset('app.css') }}">
             <link rel="stylesheet" href="{{ asset('app.css') }}">
         @endif
         
-        @if(Asset::hasMediaFile('missing.png'))
+        @if(Asset::exists('missing.png'))
             Found missing.png
         @else
             Missing missing.png
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 5a6345fd55e..2befc96d34b 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -45,12 +45,12 @@ public function testGetHelperWithNonExistentFile()
 
     public function testHasMediaFileHelper()
     {
-        $this->assertFalse(Asset::hasMediaFile('styles.css'));
+        $this->assertFalse(Asset::exists('styles.css'));
     }
 
     public function testHasMediaFileHelperReturnsTrueForExistingFile()
     {
-        $this->assertTrue(Asset::hasMediaFile('app.css'));
+        $this->assertTrue(Asset::exists('app.css'));
     }
 
     public function testAssetReturnsMediaPathWithCacheKey()

From b99f1d214f851baeee160326592a81c83e28985f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:31:55 +0200
Subject: [PATCH 3100/4023] Refactor featured image helper to use the Asset API

---
 .../Features/Blogging/Models/FeaturedImage.php       | 12 +-----------
 .../framework/tests/Unit/FeaturedImageUnitTest.php   | 12 +++++++++++-
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index 71376cb651f..bb789f8d637 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -12,14 +12,10 @@
 use Illuminate\Support\Facades\Http;
 use Hyde\Foundation\Kernel\Hyperlinks;
 use Hyde\Support\Filesystem\MediaFile;
-use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Markdown\Contracts\FrontMatter\SubSchemas\FeaturedImageSchema;
 
 use function array_key_exists;
 use function array_flip;
-use function file_exists;
-use function filesize;
-use function sprintf;
 use function key;
 
 /**
@@ -214,13 +210,7 @@ protected function has(string $property): bool
 
     protected function getContentLengthForLocalImage(): int
     {
-        $storagePath = MediaFile::sourcePath($this->source);
-
-        if (! file_exists($storagePath)) {
-            throw new FileNotFoundException(customMessage: sprintf('Featured image [%s] not found.', Hyde::pathToRelative($storagePath)));
-        }
-
-        return filesize($storagePath);
+        return MediaFile::get($this->source)->getContentLength();
     }
 
     protected function getContentLengthForRemoteImage(): int
diff --git a/packages/framework/tests/Unit/FeaturedImageUnitTest.php b/packages/framework/tests/Unit/FeaturedImageUnitTest.php
index 5ea286739a7..26ab3ffca70 100644
--- a/packages/framework/tests/Unit/FeaturedImageUnitTest.php
+++ b/packages/framework/tests/Unit/FeaturedImageUnitTest.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Foundation\HydeKernel;
+use Illuminate\Support\Collection;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 use Hyde\Framework\Features\Blogging\Models\FeaturedImage;
 use Hyde\Testing\UnitTestCase;
@@ -182,8 +184,16 @@ public function testGetContentLength()
 
     public function testFeaturedImageGetContentLengthWithNoSource()
     {
+        HydeKernel::setInstance(new class extends HydeKernel
+        {
+            public function assets(): Collection
+            {
+                return new Collection();
+            }
+        });
+
         $this->expectException(FileNotFoundException::class);
-        $this->expectExceptionMessage('Featured image [_media/foo] not found.');
+        $this->expectExceptionMessage('File [_media/foo] not found when trying to resolve a media asset.');
 
         $image = new FeaturedImage('_media/foo', ...self::ARGUMENTS);
         $this->assertSame(0, $image->getContentLength());

From 541e62a80654abd9af4dcbc6a4786b2da0010a14 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:50:45 +0200
Subject: [PATCH 3101/4023] Rename `MediaFile` method `getContentLength` to
 `getLength`

---
 .../Framework/Features/Blogging/Models/FeaturedImage.php  | 2 +-
 packages/framework/src/Support/Filesystem/MediaFile.php   | 8 ++++----
 .../framework/tests/Feature/Support/MediaFileTest.php     | 4 ++--
 .../framework/tests/Unit/Support/MediaFileUnitTest.php    | 8 ++++----
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index bb789f8d637..e1cb2d34ea6 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -210,7 +210,7 @@ protected function has(string $property): bool
 
     protected function getContentLengthForLocalImage(): int
     {
-        return MediaFile::get($this->source)->getContentLength();
+        return MediaFile::get($this->source)->getLength();
     }
 
     protected function getContentLengthForRemoteImage(): int
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index de4b7867630..258bbbbadd0 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -138,7 +138,7 @@ public function getLink(): string
     /**
      * Get the content length of the file in bytes.
      */
-    public function getContentLength(): int
+    public function getLength(): int
     {
         $this->ensureInstanceIsBooted('length');
 
@@ -173,7 +173,7 @@ public function getHash(): string
     public function toArray(): array
     {
         return array_merge(parent::toArray(), [
-            'length' => $this->getContentLength(),
+            'length' => $this->getLength(),
             'mimeType' => $this->getMimeType(),
             'hash' => $this->getHash(),
         ]);
@@ -207,7 +207,7 @@ protected function getNormalizedPath(string $path): string
         return $path;
     }
 
-    protected function findContentLength(): int
+    protected function findLength(): int
     {
         return Filesystem::size($this->getPath());
     }
@@ -231,7 +231,7 @@ protected function ensureInstanceIsBooted(string $property): void
 
     protected function boot(): void
     {
-        $this->length = $this->findContentLength();
+        $this->length = $this->findLength();
         $this->mimeType = $this->findMimeType();
         $this->hash = $this->findHash();
     }
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index 2752c362f4a..c088dac91d8 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -64,7 +64,7 @@ public function testMediaFileProperties()
 
         $mediaFile = MediaFile::make('large_file.txt');
 
-        $this->assertSame(1024, $mediaFile->getContentLength());
+        $this->assertSame(1024, $mediaFile->getLength());
         $this->assertSame('text/plain', $mediaFile->getMimeType());
         $this->assertSame(hash('crc32', $content), $mediaFile->getHash());
     }
@@ -82,7 +82,7 @@ public function testMediaFilePathHandling()
     public function testMediaFileExceptionHandling()
     {
         $this->expectException(FileNotFoundException::class);
-        MediaFile::make('non_existent_file.txt')->getContentLength();
+        MediaFile::make('non_existent_file.txt')->getLength();
     }
 
     public function testMediaDirectoryCustomization()
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index df506517fca..a7176e0e464 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -162,7 +162,7 @@ public function testConstructorWithVariousInputFormats()
     public function testConstructorSetsProperties()
     {
         $file = new MediaFile('foo.txt');
-        $this->assertNotNull($file->getContentLength());
+        $this->assertNotNull($file->getLength());
         $this->assertNotNull($file->getMimeType());
         $this->assertNotNull($file->getHash());
     }
@@ -259,13 +259,13 @@ public function testToArrayReturnsArrayOfFileProperties()
         ], MediaFile::make('foo.txt')->toArray());
     }
 
-    public function testGetContentLength()
+    public function testGetLength()
     {
         $this->mockFilesystem->shouldReceive('size')
             ->with(Hyde::path('_media/foo'))
             ->andReturn(12);
 
-        $this->assertSame(12, MediaFile::make('foo')->getContentLength());
+        $this->assertSame(12, MediaFile::make('foo')->getLength());
     }
 
     public function testGetMimeType()
@@ -588,7 +588,7 @@ protected function mockCurrentPage(string $page): void
     public static function bootableMethodsProvider(): array
     {
         return [
-            ['getContentLength'],
+            ['getLength'],
             ['getMimeType'],
             ['getHash'],
         ];

From 96263b5da47818d755be285a42ba34648c10a6ec Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:06:33 +0200
Subject: [PATCH 3102/4023] Fix mock setup

---
 .../tests/Unit/Support/MediaFileUnitTest.php       | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index a7176e0e464..d10db2e3916 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -6,6 +6,7 @@
 
 use Mockery;
 use Illuminate\View\Factory;
+use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
 use Hyde\Framework\Exceptions\FileNotFoundException;
@@ -61,10 +62,6 @@ protected function setUp(): void
         $this->mockFilesystem->shouldReceive('hash')->andReturn(hash('crc32', 'Hello World!'))->byDefault();
         $this->mockFilesystem->shouldReceive('get')->andReturn('Hello World!')->byDefault();
 
-        // Mock Hyde facade
-        $hyde = Mockery::mock(Hyde::kernel())->makePartial();
-        $hyde->shouldReceive('assets')->andReturn(collect(['app.css' => new MediaFile('_media/app.css')]))->byDefault();
-
         // Mock render data
         \Illuminate\Support\Facades\View::swap(Mockery::mock(Factory::class)->makePartial());
         Render::swap(new RenderData());
@@ -94,7 +91,16 @@ public function testCanMake()
 
     public function testCanGet()
     {
+        $kernel = HydeKernel::getInstance();
+
+        $hyde = Mockery::mock(Hyde::kernel())->makePartial();
+        $hyde->shouldReceive('assets')->andReturn(collect(['app.css' => new MediaFile('_media/app.css')]));
+
+        HydeKernel::setInstance($hyde);
+
         $this->assertEquals(new MediaFile('app.css'), MediaFile::get('app.css'));
+
+        HydeKernel::setInstance($kernel);
     }
 
     public function testCanConstructWithNestedPaths()

From 126f4440eec3787f41cff47f755103d1d995eb57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 11:59:52 +0200
Subject: [PATCH 3103/4023] Use the filesystem glob helper

---
 packages/framework/src/Foundation/Concerns/HasMediaFiles.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
index 3dff8db788d..5fb387be696 100644
--- a/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
+++ b/packages/framework/src/Foundation/Concerns/HasMediaFiles.php
@@ -6,13 +6,13 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Hyde\Facades\Filesystem;
 use Hyde\Support\Filesystem\MediaFile;
 use Illuminate\Support\Collection;
 
 use function implode;
 use function collect;
 use function sprintf;
-use function glob;
 
 /**
  * @internal Single-use trait for the Filesystem class.
@@ -45,7 +45,7 @@ protected static function discoverMediaFiles(): Collection
 
     protected static function getMediaFiles(): array
     {
-        return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
+        return Filesystem::glob(static::getMediaGlobPattern(), GLOB_BRACE) ?: [];
     }
 
     protected static function getMediaGlobPattern(): string

From 9aa9a8bccf176884c16521236f3904e194104761 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:09:51 +0200
Subject: [PATCH 3104/4023] Move test to more suitable location

---
 .../tests/Feature/AssetAPIFeatureTest.php     | 15 ++++++++++++
 .../Unit/Facades/AssetFacadeUnitTest.php      | 23 -------------------
 2 files changed, 15 insertions(+), 23 deletions(-)

diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index 8961c16cd5f..c80f9a75814 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+use Hyde\Hyde;
+use Hyde\Facades\Asset;
 use Hyde\Testing\TestCase;
 use Hyde\Foundation\HydeKernel;
 use Illuminate\Support\Facades\Blade;
@@ -124,6 +126,19 @@ public function testThrowsExceptionForNonExistentMediaFile()
         $this->assertSame(Hyde::path('_site/media/non_existent_file.txt'), MediaFile::outputPath($nonExistentFile));
     }
 
+    public function testAssetSupportsCustomMediaDirectories()
+    {
+        Hyde::setMediaDirectory('_assets');
+
+        $this->directory('_assets');
+        $this->file('_assets/app.css');
+
+        $path = (string) Asset::get('app.css');
+
+        $this->assertIsString($path);
+        $this->assertSame('assets/app.css?v='.hash_file('crc32', Hyde::path('_assets/app.css')), $path);
+    }
+
     protected function getAppStylesVersion(): string
     {
         return MediaFile::get('app.css')->getHash();
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 2befc96d34b..bcbe1f5f171 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -9,7 +9,6 @@
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Facades\Render;
 use Hyde\Support\Models\RenderData;
-use Hyde\Testing\CreatesTemporaryFiles;
 use Hyde\Framework\Exceptions\FileNotFoundException;
 
 /**
@@ -17,8 +16,6 @@
  */
 class AssetFacadeUnitTest extends UnitTestCase
 {
-    use CreatesTemporaryFiles;
-
     protected function setUp(): void
     {
         self::needsKernel();
@@ -27,11 +24,6 @@ protected function setUp(): void
         Render::swap(new RenderData());
     }
 
-    protected function tearDown(): void
-    {
-        $this->cleanUpFilesystem();
-    }
-
     public function testGetHelper()
     {
         $this->assertSame(Hyde::asset('app.css'), Asset::get('app.css'));
@@ -68,19 +60,4 @@ public function testAssetReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled
         $this->assertIsString($path);
         $this->assertSame('media/app.css', $path);
     }
-
-    public function testAssetSupportsCustomMediaDirectories()
-    {
-        self::resetKernel();
-
-        Hyde::setMediaDirectory('_assets');
-
-        $this->directory('_assets');
-        $this->file('_assets/app.css');
-
-        $path = (string) Asset::get('app.css');
-
-        $this->assertIsString($path);
-        $this->assertSame('assets/app.css?v='.hash_file('crc32', Hyde::path('_assets/app.css')), $path);
-    }
 }

From bdbf7dcc06058bdd80eb637b76d1b28f11483747 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:13:26 +0200
Subject: [PATCH 3105/4023] Unwrap method redirection chain to call destination
 method directly

---
 packages/framework/src/Facades/Asset.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 92b2ee30097..504a28a62e0 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -6,7 +6,6 @@
 
 use Hyde\Support\Filesystem\MediaFile;
 
-use function hyde;
 use function file_exists;
 
 /**
@@ -19,7 +18,7 @@ class Asset
 {
     public static function get(string $file): MediaFile
     {
-        return hyde()->asset($file);
+        return MediaFile::get($file);
     }
 
     public static function exists(string $file): bool

From 7342f72fd81c377174d00265b468b224c9d95cc4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:15:42 +0200
Subject: [PATCH 3106/4023] Use the filesystem facade

---
 packages/framework/src/Facades/Asset.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 504a28a62e0..24fdc1fad89 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -6,8 +6,6 @@
 
 use Hyde\Support\Filesystem\MediaFile;
 
-use function file_exists;
-
 /**
  * Handles the retrieval of core asset files, either from the HydeFront CDN or from the local media folder.
  *
@@ -23,6 +21,6 @@ public static function get(string $file): MediaFile
 
     public static function exists(string $file): bool
     {
-        return file_exists(MediaFile::sourcePath($file));
+        return Filesystem::exists(MediaFile::sourcePath($file));
     }
 }

From aaa928066c095e55a72094484f87acc01f6c0b2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:18:59 +0200
Subject: [PATCH 3107/4023] Update outdated facade documentation

---
 packages/framework/src/Facades/Asset.php | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index 24fdc1fad89..c6392fc0fc3 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -7,18 +7,23 @@
 use Hyde\Support\Filesystem\MediaFile;
 
 /**
- * Handles the retrieval of core asset files, either from the HydeFront CDN or from the local media folder.
+ * Simplified facade to interact with media files.
  *
- * This class provides static methods for interacting with versioned files,
- * as well as the HydeFront CDN service and the media directories.
+ * @see \Hyde\Support\Filesystem\MediaFile
  */
 class Asset
 {
+    /**
+     * Get a MediaFile instance for the given filename in the media source directory.
+     */
     public static function get(string $file): MediaFile
     {
         return MediaFile::get($file);
     }
 
+    /**
+     * Check if a media file exists in the source directory.
+     */
     public static function exists(string $file): bool
     {
         return Filesystem::exists(MediaFile::sourcePath($file));

From 7a77de6c96abe566fe1980d8ca31d2fa084e890f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 12:22:20 +0200
Subject: [PATCH 3108/4023] Normalize throws tags

---
 .../partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md  | 4 +++-
 packages/framework/src/Facades/Asset.php                      | 2 ++
 .../framework/src/Foundation/Concerns/ForwardsHyperlinks.php  | 1 +
 packages/framework/src/Foundation/Kernel/Hyperlinks.php       | 3 +--
 packages/framework/src/Support/Filesystem/MediaFile.php       | 2 ++
 packages/framework/src/helpers.php                            | 3 +--
 6 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
index 102c68dfb7b..d3d7e31ab61 100644
--- a/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
+++ b/docs/_data/partials/hyde-pages-api/hyde-kernel-hyperlink-methods.md
@@ -1,7 +1,7 @@
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-09-04 19:44:45 in 0.10ms -->
+<!-- Generated by HydePHP DocGen script at 2024-09-08 10:25:34 in 0.11ms -->
 
 #### `formatLink()`
 
@@ -27,6 +27,8 @@ No description provided.
 Hyde::asset(string $name): Hyde\Support\Filesystem\MediaFile
 ```
 
+- **Throws:** \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
+
 #### `url()`
 
 No description provided.
diff --git a/packages/framework/src/Facades/Asset.php b/packages/framework/src/Facades/Asset.php
index c6392fc0fc3..3bc01acfa1c 100644
--- a/packages/framework/src/Facades/Asset.php
+++ b/packages/framework/src/Facades/Asset.php
@@ -15,6 +15,8 @@ class Asset
 {
     /**
      * Get a MediaFile instance for the given filename in the media source directory.
+     *
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
      */
     public static function get(string $file): MediaFile
     {
diff --git a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
index 6b28b7ea3d4..9c7cd2aded7 100644
--- a/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
+++ b/packages/framework/src/Foundation/Concerns/ForwardsHyperlinks.php
@@ -24,6 +24,7 @@ public function relativeLink(string $destination): string
         return $this->hyperlinks->relativeLink($destination);
     }
 
+    /** @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory. */
     public function asset(string $name): MediaFile
     {
         return $this->hyperlinks->asset($name);
diff --git a/packages/framework/src/Foundation/Kernel/Hyperlinks.php b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
index fffae96b0d6..c23498ebae3 100644
--- a/packages/framework/src/Foundation/Kernel/Hyperlinks.php
+++ b/packages/framework/src/Foundation/Kernel/Hyperlinks.php
@@ -9,7 +9,6 @@
 use Hyde\Support\Models\Route;
 use Hyde\Foundation\HydeKernel;
 use Hyde\Support\Filesystem\MediaFile;
-use Hyde\Framework\Exceptions\FileNotFoundException;
 
 use function str_ends_with;
 use function str_starts_with;
@@ -93,7 +92,7 @@ public function relativeLink(string $destination): string
      * If a base URL is configured, the image will be returned with a qualified absolute URL.
      * Otherwise, a relative path will be returned based on the rendered page's location.
      *
-     * @throws FileNotFoundException If the file does not exist in the `_media` directory in order to make the issue clear.
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
      */
     public function asset(string $name): MediaFile
     {
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 258bbbbadd0..07827626abe 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -61,6 +61,8 @@ public static function make(string $path): static
 
     /**
      * Get or create a media file instance from the HydeKernel for the given file.
+     *
+     * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
      */
     public static function get(string $path): MediaFile
     {
diff --git a/packages/framework/src/helpers.php b/packages/framework/src/helpers.php
index 07bde2f23e0..ddc0bf27f48 100644
--- a/packages/framework/src/helpers.php
+++ b/packages/framework/src/helpers.php
@@ -5,7 +5,6 @@
 namespace {
     use Hyde\Foundation\HydeKernel;
     use Hyde\Support\Filesystem\MediaFile;
-    use Hyde\Framework\Exceptions\FileNotFoundException;
 
     if (! function_exists('hyde')) {
         /**
@@ -28,7 +27,7 @@ function hyde(): HydeKernel
              * If a base URL is configured, the image will be returned with a qualified absolute URL.
              * Otherwise, a relative path will be returned based on the rendered page's location.
              *
-             * @throws FileNotFoundException If the file does not exist in the `_media` directory in order to make the issue clear.
+             * @throws \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
              */
             function asset(string $name): MediaFile
             {

From 5ea05006d32f07ed7ede68014ac8f867ec62a35c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 13:17:43 +0200
Subject: [PATCH 3109/4023] Fix coupling so we don't need to use the Render
 facade in test

---
 .../Feature/Services/Markdown/ShortcodeProcessorTest.php     | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
index 2ba7ecaa6e6..b8b1f3ab48f 100644
--- a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Framework\Testing\Feature\Services\Markdown;
 
-use Hyde\Support\Facades\Render;
-use Hyde\Support\Models\RenderData;
 use Hyde\Markdown\Contracts\MarkdownShortcodeContract;
 use Hyde\Markdown\Processing\ShortcodeProcessor;
 use Hyde\Testing\UnitTestCase;
@@ -22,8 +20,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        // Todo: Fix coupling so we don't need to use the Render facade at all here.
-        Render::swap(new RenderData());
+        self::mockCurrentRouteKey('foo');
     }
 
     public function testConstructorDiscoversDefaultShortcodes()

From be59948e073b6f0137e9ce1cd8447108ece58392 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 17:26:09 +0200
Subject: [PATCH 3110/4023] Update tests to use new render mocking helpers

---
 .../Services/Markdown/DynamicMarkdownLinkProcessorTest.php   | 5 +----
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php     | 4 +---
 packages/framework/tests/Unit/NavigationItemTest.php         | 2 +-
 packages/framework/tests/Unit/RenderHelperTest.php           | 3 +--
 4 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 67acd7ffe39..3d9c2f60769 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -10,9 +10,7 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Support\Models\Route;
-use Hyde\Support\Facades\Render;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Support\Models\RenderData;
 use Hyde\Markdown\Processing\DynamicMarkdownLinkProcessor;
 
 /**
@@ -24,13 +22,12 @@ class DynamicMarkdownLinkProcessorTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
     protected static bool $needsKernel = true;
+    protected static bool $needsRender = true;
 
     protected function setUp(): void
     {
         parent::setUp();
 
-        Render::swap(new RenderData());
-
         Routes::addRoute(new Route(new BladePage('index')));
         Routes::addRoute(new Route(new MarkdownPost('post')));
 
diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 6dac17db2f5..d7d8efb0032 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -9,9 +9,7 @@
 use Hyde\Hyde;
 use Hyde\Support\Includes;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Support\Facades\Render;
 use Illuminate\Support\HtmlString;
-use Hyde\Support\Models\RenderData;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Filesystem\Filesystem;
 use Hyde\Testing\MocksKernelFeatures;
@@ -27,6 +25,7 @@ class IncludesFacadeUnitTest extends UnitTestCase
 
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
+    protected static bool $needsRender = true;
 
     protected function setUp(): void
     {
@@ -36,7 +35,6 @@ protected function setUp(): void
 
         $this->setupTestKernel();
         $this->kernel->setRoutes(collect());
-        Render::swap(new RenderData());
     }
 
     protected function tearDown(): void
diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 22742802644..f9ac63f692b 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -35,7 +35,7 @@ public static function setUpBeforeClass(): void
 
     protected function setUp(): void
     {
-        Render::swap(new RenderData());
+        self::mockRender();
     }
 
     public function testConstruct()
diff --git a/packages/framework/tests/Unit/RenderHelperTest.php b/packages/framework/tests/Unit/RenderHelperTest.php
index ee0cc280ecb..be9d14076af 100644
--- a/packages/framework/tests/Unit/RenderHelperTest.php
+++ b/packages/framework/tests/Unit/RenderHelperTest.php
@@ -26,9 +26,8 @@ class RenderHelperTest extends UnitTestCase
 
     protected function setUp(): void
     {
-        parent::setUp();
+        self::mockRender();
 
-        Render::swap(new RenderData());
         View::swap(Mockery::mock(Factory::class)->makePartial());
     }
 

From cba42be989afdb272b906a4fb543dd0ed444ed97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 17:35:29 +0200
Subject: [PATCH 3111/4023] Refactor testing helper to be fluent

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 3 +--
 packages/testing/src/MocksKernelFeatures.php             | 4 +++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index d7d8efb0032..f5536bd42f3 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -33,8 +33,7 @@ protected function setUp(): void
 
         Blade::swap(Mockery::mock());
 
-        $this->setupTestKernel();
-        $this->kernel->setRoutes(collect());
+        $this->setupTestKernel()->setRoutes(collect());
     }
 
     protected function tearDown(): void
diff --git a/packages/testing/src/MocksKernelFeatures.php b/packages/testing/src/MocksKernelFeatures.php
index 3f89d509021..3e942a12419 100644
--- a/packages/testing/src/MocksKernelFeatures.php
+++ b/packages/testing/src/MocksKernelFeatures.php
@@ -42,11 +42,13 @@ protected function withPages(array $pages): static
         return $this;
     }
 
-    protected function setupTestKernel(): void
+    protected function setupTestKernel(): TestKernel
     {
         $this->kernel = new TestKernel();
 
         HydeKernel::setInstance($this->kernel);
+
+        return $this->kernel;
     }
 }
 

From 46f1c9e2615bb318f765ca643c0aa334837a234c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 17:35:51 +0200
Subject: [PATCH 3112/4023] Simplify test setup

---
 packages/framework/tests/Unit/NavigationItemTest.php | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index f9ac63f692b..cc60362d26f 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -25,16 +25,11 @@
  */
 class NavigationItemTest extends UnitTestCase
 {
-    public static function setUpBeforeClass(): void
+    protected function setUp(): void
     {
-        self::$hasSetUpKernel = false;
 
         self::needsKernel();
         self::mockConfig();
-    }
-
-    protected function setUp(): void
-    {
         self::mockRender();
     }
 

From f41615df4fddd1be9bfdb93f3368ab1933422e98 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 17:38:00 +0200
Subject: [PATCH 3113/4023] Update NavigationItemTest.php

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index cc60362d26f..d1da9d90355 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -27,6 +27,8 @@ class NavigationItemTest extends UnitTestCase
 {
     protected function setUp(): void
     {
+        // Todo: Figure out why in the world we need this
+        self::$hasSetUpKernel = false;
 
         self::needsKernel();
         self::mockConfig();

From 4005b75896c1fb1b04eb5f18dbcbabaae5b60f8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 20:12:31 +0200
Subject: [PATCH 3114/4023] Try static

---
 packages/framework/tests/Unit/NavigationItemTest.php | 2 +-
 packages/testing/src/UnitTestCase.php                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index d1da9d90355..07e929f99c6 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -28,7 +28,7 @@ class NavigationItemTest extends UnitTestCase
     protected function setUp(): void
     {
         // Todo: Figure out why in the world we need this
-        self::$hasSetUpKernel = false;
+        static::$hasSetUpKernel = false;
 
         self::needsKernel();
         self::mockConfig();
diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index 764334bec74..3453e3a5267 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -21,7 +21,7 @@ abstract class UnitTestCase extends BaseTestCase
 
     protected static function needsKernel(): void
     {
-        if (! self::$hasSetUpKernel) {
+        if (! static::$hasSetUpKernel) {
             self::setupKernel();
         }
     }

From 1af6bca96d66bb0b8eba409cc75d62879b1b67a3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Sep 2024 20:15:17 +0200
Subject: [PATCH 3115/4023] Always reset kernel

---
 packages/framework/tests/Unit/NavigationItemTest.php | 4 +---
 packages/testing/src/UnitTestCase.php                | 2 --
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index 07e929f99c6..c0893b864bc 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Hyde;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
@@ -27,9 +28,6 @@ class NavigationItemTest extends UnitTestCase
 {
     protected function setUp(): void
     {
-        // Todo: Figure out why in the world we need this
-        static::$hasSetUpKernel = false;
-
         self::needsKernel();
         self::mockConfig();
         self::mockRender();
diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index 3453e3a5267..76476a58935 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -21,9 +21,7 @@ abstract class UnitTestCase extends BaseTestCase
 
     protected static function needsKernel(): void
     {
-        if (! static::$hasSetUpKernel) {
             self::setupKernel();
-        }
     }
 
     public static function setUpBeforeClass(): void

From 9979c8479d0b268d05b36b9b668e1a72d0d96d1d Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 8 Sep 2024 18:15:28 +0000
Subject: [PATCH 3116/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Unit/NavigationItemTest.php | 1 -
 packages/testing/src/UnitTestCase.php                | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationItemTest.php b/packages/framework/tests/Unit/NavigationItemTest.php
index c0893b864bc..aab63b955cb 100644
--- a/packages/framework/tests/Unit/NavigationItemTest.php
+++ b/packages/framework/tests/Unit/NavigationItemTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Hyde;
 use Hyde\Foundation\Facades\Routes;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Pages\InMemoryPage;
diff --git a/packages/testing/src/UnitTestCase.php b/packages/testing/src/UnitTestCase.php
index 76476a58935..cc0bb811e34 100644
--- a/packages/testing/src/UnitTestCase.php
+++ b/packages/testing/src/UnitTestCase.php
@@ -21,7 +21,7 @@ abstract class UnitTestCase extends BaseTestCase
 
     protected static function needsKernel(): void
     {
-            self::setupKernel();
+        self::setupKernel();
     }
 
     public static function setUpBeforeClass(): void

From a0ca7f22eef5fb52b1704b406ec0144c65e3132f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Sep 2024 18:05:34 +0200
Subject: [PATCH 3117/4023] Tear down using helper method

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 +-
 packages/framework/tests/Unit/MarkdownFacadeTest.php     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index f17d296a87e..072e6e710f7 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -38,7 +38,7 @@ protected function setUp(): void
 
     protected function tearDown(): void
     {
-        Mockery::close();
+        $this->verifyMockeryExpectations();
     }
 
     public function testPathReturnsTheIncludesDirectory()
diff --git a/packages/framework/tests/Unit/MarkdownFacadeTest.php b/packages/framework/tests/Unit/MarkdownFacadeTest.php
index 3f6a442e957..654a3e7f207 100644
--- a/packages/framework/tests/Unit/MarkdownFacadeTest.php
+++ b/packages/framework/tests/Unit/MarkdownFacadeTest.php
@@ -25,6 +25,6 @@ public function testRender(): void
         $this->assertIsString($html);
         $this->assertSame("<h1>Hello World!</h1>\n", $html);
 
-        Mockery::close();
+        $this->verifyMockeryExpectations();
     }
 }

From 3bbd7efabd7bf0312f5085769264b6886a82d0ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 4 Oct 2024 14:14:12 +0200
Subject: [PATCH 3118/4023] Delete spec.md

This is pretty outdated now
---
 spec.md | 895 --------------------------------------------------------
 1 file changed, 895 deletions(-)
 delete mode 100644 spec.md

diff --git a/spec.md b/spec.md
deleted file mode 100644
index cb78e76674c..00000000000
--- a/spec.md
+++ /dev/null
@@ -1,895 +0,0 @@
-# Asset API Overview
-
-## Abstract
-
-In order to rework the Asset API, we need to analyze the current state of the API, to find what can be improved.
-
-### Background
-
-Remember the original problem: The current system is confusing and unintuitive with multiple and inconsistent ways to access assets.
-
-Additionally, keep in mind that most ways users will commonly use this API is to link to assets in the `_media` directory, and to check if they exist.
-
-For example: Consider these Blade snippets from the default views, showing common usages that actual end users may use:
-
-```blade
-{{-- The compiled Tailwind/App styles --}}
-@if(config('hyde.load_app_styles_from_cdn', false))
-    <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
-@elseif(Asset::hasMediaFile('app.css'))
-    <link rel="stylesheet" href="{{ Asset::mediaLink('app.css') }}">
-@endif
-
-{{-- The compiled Laravel Mix scripts --}}
-@if(Asset::hasMediaFile('app.js'))
-    <script defer src="{{ Asset::mediaLink('app.js') }}"></script>
-@endif
-
-@if (file_exists(Hyde::mediaPath('favicon.ico')))
-    <link rel="shortcut icon" href="{{ Hyde::relativeLink('media/favicon.ico') }}" type="image/x-icon">
-@endif
-```
-
-Some other example usages could be things like:
-
-```blade
-<img src="{{ asset('images/logo.png') }}" alt="Logo">
-```
-
-We also use the Asset API helpers in the internal codebase that actually powers the static site generator. These kinds of usages would usually only be used by us, package developers, and serious power users. They have an important, but secondary role in the API design. Here are some examples from our codebase:
-
-```php
-// Code that transfers media assets from the source directory to the site output directory
-$this->createDirectoryifItDoesNotExist(Hyde::siteMediaPath());
-$this->mapWithProgressBar(MediaFile::files(), function (string $identifier): void {
-   copy(Hyde::mediaPath($identifier), Hyde::siteMediaPath($identifier));
-});
-
-// Helpers in the featured image class
-public function getSource(): string {
-    return Hyde::mediaLink($this->source);
-}
-
-protected function setSource(string $source): string {
-   // Normalize away any leading media path prefixes.
-   return Str::after($source, Hyde::getMediaDirectory().'/');
-}
-```
-
-## Current State
-
-### Asset Facade
-
-```php
-HydeFront::cdnLink(string $file) // Gets remote URL to any file in /dist/ in the HydeFront version
-Asset::mediaLink(string $file) // Returns Hyde::mediaLink but with a cache buster
-Asset::hasMediaFile(string $file) // Returns file_exists(Hyde::mediaPath($file))
-
-/**
- * Real implementations of the facade methods:
- * 
- * @see \Hyde\Framework\Services\AssetService::cdnLink
- * @see \Hyde\Framework\Services\AssetService::mediaLink
- * @see \Hyde\Framework\Services\AssetService::hasMediaFile
- */
-```
-
-### Hyde Facade
-
-```php
-Hyde::mediaPath() // Get the absolute path to the media source directory, or a file within it. (Intended as a sibling to Hyde::path and Hyde::sitePath helpers, and the HydePage::path methods)
-Hyde::siteMediaPath() //  Get the absolute path to the compiled site's media directory, or a file within it. (Intended as a sibling to Hyde::sitePath)
-Hyde::mediaLink() // Gets a relative web link to the given file stored in the _site/media folder. (Intended as a sibling to Hyde::relativeLink, which is called by this) (A second $validate parameter will return throw an exception if the file does not exist)
-Hyde::asset() // Gets a relative web link to the given image stored in the _site/media folder. (But leaves remote URLs alone) (A second $preferQualifiedUrl parameter will return a fully qualified URL if a site URL is set)
-
-/**
- * Real implementations of the facade methods:
- * 
- * @see \Hyde\Foundation\HydeKernel::mediaPath {@see \Hyde\Foundation\Kernel\Filesystem::mediaPath}
- * @see \Hyde\Foundation\HydeKernel::siteMediaPath {@see \Hyde\Foundation\Kernel\Filesystem::siteMediaPath}
- * @see \Hyde\Foundation\HydeKernel::mediaLink {@see \Hyde\Foundation\Kernel\Hyperlinks::mediaLink}
- * @see \Hyde\Foundation\HydeKernel::asset {@see \Hyde\Foundation\Kernel\Hyperlinks::asset}
- */
-```
-
-### Helper Functions
-
-```php
-asset() // Calls Hyde::asset 
-```
-
-## AI Context
-
-Please provide feedback on how we for HydePHP v2 can improve the Asset API, designed to make it easy to interact with Asset files stored in the `_media` directory.
-
-For context: This is for static site generator HydePHP, based on Laravel.
-
-Motto: "Simplicity first. Power when you need it. Quality always."
-Tagline: Create static websites with the tools you already know and love with HydePHP.
-
-The Hyde Philosophy:
-> Developing Hyde sites, and contributing to the framework should be a joy. Great Developer Experience (DX) is our top priority.
-> Code should make sense and be intuitive, especially user-facing APIs. Convention over configuration, but not at the expense of flexibility.
-> Making sites should not be boring and repetitive - Hyde is all about taking focus away from boilerplate, and letting users focus on the content.
-
-Considerations: While HydePHP targets developers, not all users necessarily are familiar with Laravel, or PHP. So while we want to provide a familiar interface for Laravel/PHP users, we also want to make sure that the API is intuitive and easy to use for all users.
-
-For additional context on the naming conventions, here is the entire Hyde facade methods:
-
-```php
- * @method static string path(string $path = '')
- * @method static string vendorPath(string $path = '', string $package = 'framework')
- * @method static string pathToAbsolute(string $path)
- * @method static string pathToRelative(string $path)
- * @method static string sitePath(string $path = '')
- * @method static string mediaPath(string $path = '')
- * @method static string siteMediaPath(string $path = '')
- * @method static string formatLink(string $destination)
- * @method static string relativeLink(string $destination)
- * @method static string mediaLink(string $destination, bool $validate = false)
- * @method static string asset(string $name, bool $preferQualifiedUrl = false)
- * @method static string url(string $path = '')
- * @method static Route|null route(string $key)
- * @method static string makeTitle(string $value)
- * @method static string normalizeNewlines(string $string)
- * @method static string stripNewlines(string $string)
- * @method static string trimSlashes(string $string)
- * @method static HtmlString markdown(string $text, bool $stripIndentation = false)
- * @method static string currentPage()
- * @method static string currentRouteKey()
- * @method static string getBasePath()
- * @method static string getSourceRoot()
- * @method static string getOutputDirectory()
- * @method static string getMediaDirectory()
- * @method static string getMediaOutputDirectory()
- * @method static Features features()
- * @method static Collection<string, PostAuthor> authors()
- * @method static FileCollection files()
- * @method static PageCollection pages()
- * @method static RouteCollection routes()
- * @method static Route|null currentRoute()
- * @method static HydeKernel getInstance()
- * @method static Filesystem filesystem()
- * @method static array getRegisteredExtensions()
- * @method static bool hasFeature(Feature $feature)
- * @method static bool hasSiteUrl()
- * @method static void setInstance(HydeKernel $instance)
- * @method static void setBasePath(string $basePath)
- * @method static void setOutputDirectory(string $outputDirectory)
- * @method static void setMediaDirectory(string $mediaDirectory)
- * @method static void setSourceRoot(string $sourceRoot)
- * @method static void shareViewData(HydePage $page)
- * @method static array toArray()
- * @method static bool isBooted()
- * @method static void boot()
-```
-
-We also have a MediaFile class that looks like this, maybe we can unify this as well:
-
-```php
-/**
- * File abstraction for a project media file.
- */
-class MediaFile extends ProjectFile
-{
-    /** @var array<string> The default extensions for media types */
-    final public const EXTENSIONS = ['png', 'svg', 'jpg', 'jpeg', 'gif', 'ico', 'css', 'js'];
-
-    /** @return array<string, \Hyde\Support\Filesystem\MediaFile> The array keys are the filenames relative to the _media/ directory */
-    public static function all(): array
-    {
-        return static::discoverMediaAssetFiles();
-    }
-
-    /** @return array<string> Array of filenames relative to the _media/ directory */
-    public static function files(): array
-    {
-        return array_keys(static::all());
-    }
-
-    public function getIdentifier(): string
-    {
-        return Str::after($this->getPath(), Hyde::getMediaDirectory().'/');
-    }
-
-    public function toArray(): array
-    {
-        return array_merge(parent::toArray(), [
-            'length' => $this->getContentLength(),
-            'mimeType' => $this->getMimeType(),
-        ]);
-    }
-
-    public function getContentLength(): int
-    {
-        if (! is_file($this->getAbsolutePath())) {
-            throw new FileNotFoundException($this->path);
-        }
-
-        return filesize($this->getAbsolutePath());
-    }
-
-    public function getMimeType(): string
-    {
-        return mime_content_type($this->getAbsolutePath());
-    }
-
-    protected static function discoverMediaAssetFiles(): array
-    {
-        return collect(static::getMediaAssetFiles())->mapWithKeys(function (string $path): array {
-            $file = static::make($path);
-
-            return [$file->getIdentifier() => $file];
-        })->all();
-    }
-
-    protected static function getMediaAssetFiles(): array
-    {
-        return glob(Hyde::path(static::getMediaGlobPattern()), GLOB_BRACE) ?: [];
-    }
-
-    protected static function getMediaGlobPattern(): string
-    {
-        return sprintf(Hyde::getMediaDirectory().'/{*,**/*,**/*/*}.{%s}', implode(',',
-            Config::getArray('hyde.media_extensions', self::EXTENSIONS)
-        ));
-    }
-}
-```
-
-### AI Example Prompt
-
-```markdown
-Task: Split out the HydeFront related parts of the AssetService to a new facade class.
-Motivation: We are simplifying the Asset API in https://github.com/hydephp/develop/pull/1904, and most users won't need the HydeFront related parts of the AssetService. Later, we will be able to merge the simplified AssetService into the other Asset helpers.
-Implementation: Make the necessary changes to the code and tests. Also update the release notes to detail all breaking changes and the upgrade path. Make sure the release notes contains all necessary information, but is not too verbose and should not contain any fluff. Also write a brief pull request description detailing the changes made and why they were made.
-Context: This is for v2 of static site generator HydePHP. Remember to match the code style of the existing codebase.
-```
-
-## Proposals
-
-### Fluent Asset API
-
-Author: Claude 3.5 Sonnet
-Link: https://claude.ai/chat/3b4529e1-79f5-48b9-ac8f-d35fa705a377
-
-Based on the provided information and the goals of HydePHP, here are some suggestions to improve the Asset API for version 2:
-
-1. Consolidate and simplify the API:
-   The current API is spread across multiple facades (Asset, Hyde) and helper functions. To improve clarity and ease of use, consider consolidating these into a single, intuitive API.
-
-
-
-```php
-class Asset
-{
-    // Get the absolute path to a media file
-    public static function path(string $file = ''): string
-    {
-        // Implementation
-    }
-
-    // Get a relative web link to a media file
-    public static function link(string $file, bool $validate = false): string
-    {
-        // Implementation
-    }
-
-    // Get a CDN link for a file
-    public static function cdnLink(string $file): string
-    {
-        // Implementation
-    }
-
-    // Check if a media file exists
-    public static function exists(string $file): bool
-    {
-        // Implementation
-    }
-
-    // Get all media files
-    public static function all(): array
-    {
-        // Implementation using MediaFile::all()
-    }
-
-    // Get a MediaFile instance
-    public static function file(string $file): MediaFile
-    {
-        // Implementation
-    }
-}
-
-```
-
-This consolidated API provides a cleaner, more intuitive interface for working with assets. It combines functionality from the current Asset and Hyde facades, making it easier for developers to find and use the methods they need.
-
-2. Improve method naming:
-   Some current method names like `cdnLink` and `mediaLink` might be confusing. Consider using more descriptive names that clearly indicate their purpose.
-
-3. Consistent return types:
-   Ensure that all methods have consistent return types. For example, always return strings for paths and links, and use type hinting to make the API more predictable.
-
-4. Fluent interface:
-   Consider implementing a fluent interface for chaining operations on assets. This can make the API more flexible and expressive.
-
-
-
-```php
-class AssetFile
-{
-    protected $file;
-
-    public function __construct(string $file)
-    {
-        $this->file = $file;
-    }
-
-    public function path(): string
-    {
-        // Implementation
-    }
-
-    public function link(bool $validate = false): string
-    {
-        // Implementation
-    }
-
-    public function cdnLink(): string
-    {
-        // Implementation
-    }
-
-    public function exists(): bool
-    {
-        // Implementation
-    }
-
-    public function content(): string
-    {
-        // Implementation
-    }
-}
-
-class Asset
-{
-    public static function file(string $file): AssetFile
-    {
-        return new AssetFile($file);
-    }
-
-    // Other static methods...
-}
-
-// Usage example
-$assetUrl = Asset::file('image.jpg')->cdnLink();
-$assetContent = Asset::file('styles.css')->content();
-
-```
-
-5. Better integration with MediaFile:
-   Leverage the existing MediaFile class more prominently in the API. This can provide a richer set of operations on individual files.
-
-6. Consistent error handling:
-   Implement a consistent approach to error handling. Consider using custom exceptions that provide clear, actionable error messages.
-
-7. Caching:
-   Implement intelligent caching for asset operations to improve performance, especially for repeated operations.
-
-8. Configuration:
-   Provide a clear way to configure asset-related settings, such as CDN URLs or custom media directories, through a dedicated configuration file or section.
-
-These improvements aim to create a more intuitive, powerful, and flexible Asset API that aligns with HydePHP's philosophy and goals. The consolidated and fluent interfaces should make it easier for both Laravel-familiar and new users to work with assets effectively.
-
-### Fluent Asset API (Refined)
-
-Author: Claude 3.5 Sonnet
-Link: https://claude.ai/chat/3b4529e1-79f5-48b9-ac8f-d35fa705a377
-
-Thank you for providing those additional considerations and the detailed API reference. Let's refine the proposal based on this new information. We'll focus on merging with MediaFiles, adjusting for the limited CDN use case, and aligning with the existing Hyde page classes API structure.
-
-
-
-```php
-abstract class Asset
-{
-    protected string $identifier;
-    protected string $sourceDirectory = '_media';
-    protected string $outputDirectory = 'media';
-    protected string $fileExtension;
-
-    public function __construct(string $identifier)
-    {
-        $this->identifier = $identifier;
-        $this->fileExtension = pathinfo($identifier, PATHINFO_EXTENSION);
-    }
-
-    public static function make(string $identifier): static
-    {
-        return new static($identifier);
-    }
-
-    public static function isDiscoverable(): bool
-    {
-        return true;
-    }
-
-    public static function get(string $identifier): static
-    {
-        if (!static::exists($identifier)) {
-            throw new FileNotFoundException("Asset not found: {$identifier}");
-        }
-        return new static($identifier);
-    }
-
-    public static function parse(string $identifier): static
-    {
-        return static::get($identifier);
-    }
-
-    public static function files(): array
-    {
-        // Implementation to get all asset file identifiers
-    }
-
-    public static function all(): AssetCollection
-    {
-        // Implementation to get all assets as a collection
-    }
-
-    public static function sourceDirectory(): string
-    {
-        return (new static(''))->sourceDirectory;
-    }
-
-    public static function outputDirectory(): string
-    {
-        return (new static(''))->outputDirectory;
-    }
-
-    public static function setSourceDirectory(string $sourceDirectory): void
-    {
-        (new static(''))->sourceDirectory = $sourceDirectory;
-    }
-
-    public static function setOutputDirectory(string $outputDirectory): void
-    {
-        (new static(''))->outputDirectory = $outputDirectory;
-    }
-
-    public function sourcePath(): string
-    {
-        return Hyde::path($this->sourceDirectory . '/' . $this->identifier);
-    }
-
-    public function outputPath(): string
-    {
-        return Hyde::sitePath($this->outputDirectory . '/' . $this->identifier);
-    }
-
-    public static function exists(string $identifier): bool
-    {
-        return file_exists((new static($identifier))->sourcePath());
-    }
-
-    public function getIdentifier(): string
-    {
-        return $this->identifier;
-    }
-
-    public function getLink(): string
-    {
-        return '/' . $this->outputDirectory . '/' . $this->identifier;
-    }
-
-    public function getContents(): string
-    {
-        return file_get_contents($this->sourcePath());
-    }
-
-    public function getMimeType(): string
-    {
-        return mime_content_type($this->sourcePath());
-    }
-
-    public function getSize(): int
-    {
-        return filesize($this->sourcePath());
-    }
-
-    public function copy(): bool
-    {
-        return copy($this->sourcePath(), $this->outputPath());
-    }
-
-    // HydeFront specific method
-    public static function cdnLink(string $file): string
-    {
-        // Implementation for HydeFront CDN links
-    }
-
-    public function toArray(): array
-    {
-        return [
-            'identifier' => $this->getIdentifier(),
-            'sourcePath' => $this->sourcePath(),
-            'outputPath' => $this->outputPath(),
-            'link' => $this->getLink(),
-            'mimeType' => $this->getMimeType(),
-            'size' => $this->getSize(),
-        ];
-    }
-}
-
-class AssetCollection extends Collection
-{
-    // Implement any asset-specific collection methods here
-}
-
-```
-
-This refined Asset API proposal addresses the considerations you mentioned:
-
-1. Merging with MediaFiles:
-   The new `Asset` class incorporates functionality from both the current Asset facade and the MediaFile class. It provides methods for working with individual assets as well as collections of assets.
-
-2. CDN links:
-   The `cdnLink` method is retained but as a static method, reflecting its specific use for HydeFront files. This keeps the functionality available without overemphasizing its importance for general asset handling.
-
-3. Alignment with Hyde page classes:
-   The API structure closely follows the pattern established by the Hyde page classes. It includes similar static methods for file discovery and management, as well as instance methods for working with individual assets.
-
-Key improvements and features:
-
-1. Consistent API:
-   The new API provides a consistent interface for working with assets, following patterns familiar to users of other Hyde classes.
-
-2. Flexible file handling:
-   Methods like `sourcePath()`, `outputPath()`, `getLink()`, and `copy()` provide flexible ways to work with asset files throughout the build process.
-
-3. Asset information:
-   Methods like `getMimeType()`, `getSize()`, and `getContents()` provide easy access to important asset information.
-
-4. Collection support:
-   The `AssetCollection` class allows for easy management and manipulation of multiple assets.
-
-5. Extensibility:
-   As an abstract class, `Asset` can be extended for specific asset types if needed in the future.
-
-Usage examples:
-
-```php
-// Get all assets
-$assets = Asset::all();
-
-// Get a specific asset
-$logo = Asset::get('images/logo.png');
-
-// Get the web-accessible link to an asset
-$logoUrl = $logo->getLink();
-
-// Copy an asset to the output directory
-$logo->copy();
-
-// Get asset information
-$size = $logo->getSize();
-$mimeType = $logo->getMimeType();
-
-// HydeFront CDN link (for app.js or app.css)
-$appJsUrl = HydeFront::cdnLink('app.js');
-```
-
-This API maintains the simplicity-first approach of Hyde while providing power when needed. It should be intuitive for both Laravel-familiar developers and those new to the framework, aligning well with Hyde's philosophy and goals.
-
-### Unified Asset API
-
-Author: Claude 3.5 Sonnet
-Link: https://claude.ai/chat/9c1c98cc-db92-41cc-9a8e-1f51fd9a04d5
-
-Certainly, I'd be happy to help you improve the Asset API for HydePHP v2. Based on your requirements and the HydePHP philosophy, I've come up with a proposal for a new, more unified Asset API. Here's the proposed new API and implementation plan:
-
-```php
-<?php
-
-namespace Hyde\Framework\Facades;
-
-use Hyde\Framework\Contracts\AssetContract;
-use Hyde\Framework\Services\AssetService;
-
-/**
- * @method static string get(string $path, bool $absolute = false)
- * @method static string url(string $path)
- * @method static bool exists(string $path)
- * @method static int size(string $path)
- * @method static string mime(string $path)
- * @method static string|null hash(string $path)
- * @method static AssetContract instance(string $path)
- */
-class Asset extends Facade
-{
-    protected static function getFacadeAccessor()
-    {
-        return AssetService::class;
-    }
-}
-
-// AssetService.php
-class AssetService implements AssetContract
-{
-    protected $validateExistence;
-
-    public function __construct(bool $validateExistence = false)
-    {
-        $this->validateExistence = $validateExistence;
-    }
-
-    public function get(string $path, bool $absolute = false): string
-    {
-        if ($this->validateExistence && !$this->exists($path)) {
-            throw new AssetNotFoundException("Asset not found: {$path}");
-        }
-
-        return $absolute ? $this->getAbsolutePath($path) : $this->getRelativePath($path);
-    }
-
-    public function url(string $path): string
-    {
-        if (filter_var($path, FILTER_VALIDATE_URL)) {
-            return $path;
-        }
-
-        return Hyde::url($this->get($path));
-    }
-
-    public function exists(string $path): bool
-    {
-        return file_exists($this->getAbsolutePath($path));
-    }
-
-    public function size(string $path): int
-    {
-        return filesize($this->getAbsolutePath($path));
-    }
-
-    public function mime(string $path): string
-    {
-        return mime_content_type($this->getAbsolutePath($path));
-    }
-
-    public function hash(string $path): ?string
-    {
-        $file = $this->getAbsolutePath($path);
-        return file_exists($file) ? md5_file($file) : null;
-    }
-
-    public function instance(string $path): AssetContract
-    {
-        return new Asset($path);
-    }
-
-    protected function getAbsolutePath(string $path): string
-    {
-        return Hyde::mediaPath($path);
-    }
-
-    protected function getRelativePath(string $path): string
-    {
-        return Hyde::mediaLink($path);
-    }
-}
-
-// Asset.php (implements AssetContract)
-class Asset implements AssetContract
-{
-    protected $path;
-
-    public function __construct(string $path)
-    {
-        $this->path = $path;
-    }
-
-    public function get(bool $absolute = false): string
-    {
-        return app(AssetService::class)->get($this->path, $absolute);
-    }
-
-    public function url(): string
-    {
-        return app(AssetService::class)->url($this->path);
-    }
-
-    public function exists(): bool
-    {
-        return app(AssetService::class)->exists($this->path);
-    }
-
-    public function size(): int
-    {
-        return app(AssetService::class)->size($this->path);
-    }
-
-    public function mime(): string
-    {
-        return app(AssetService::class)->mime($this->path);
-    }
-
-    public function hash(): ?string
-    {
-        return app(AssetService::class)->hash($this->path);
-    }
-}
-
-// Helper function
-function asset(string $path, bool $absolute = false): string
-{
-    return Asset::get($path, $absolute);
-}
-
-```
-
-This new API proposal aims to simplify and unify the asset-related functions while maintaining flexibility and adhering to the HydePHP philosophy. Here's a breakdown of the changes and the implementation plan:
-
-1. Unified API:
-   - All asset-related functions are now under the `Asset` facade.
-   - The `get()` method replaces both `mediaLink()` and `asset()`, with an optional parameter for absolute paths.
-   - Added `url()` method to handle both local and remote URLs.
-   - Included utility methods like `exists()`, `size()`, `mime()`, and `hash()` for common operations.
-
-2. Validation:
-   - Instead of a parameter to validate, we've added a constructor parameter in the `AssetService` that can be set via configuration or environment variable.
-
-3. Flexibility:
-   - The `instance()` method allows for object-oriented usage when needed.
-
-Implementation Plan:
-
-1. Deprecation process in v1:
-   - Add deprecation notices to the existing methods in the `Asset` and `Hyde` facades.
-   - Introduce the new `Asset` facade with the proposed methods, marking them as `@since 1.x`.
-   - Update the documentation to recommend using the new `Asset` facade.
-
-2. Implementation in v2:
-   - Remove the deprecated methods from the `Asset` and `Hyde` facades.
-   - Fully implement the new `AssetService` and `Asset` classes.
-   - Update all internal usage to use the new API.
-
-3. Configuration:
-   - Add a new configuration option in `config/hyde.php`:
-     ```php
-     'assets' => [
-         'validate_existence' => env('HYDE_VALIDATE_ASSETS', false),
-     ],
-     ```
-
-4. Release Notes:
-   ```markdown
-   # HydePHP v2.0 Release Notes
-
-   ## Asset API Overhaul
-
-   We've completely revamped the Asset API to provide a more intuitive and unified interface for handling media files. Key changes include:
-
-   - New `Asset` facade with streamlined methods
-   - Simplified asset retrieval with `Asset::get()`
-   - Built-in URL handling with `Asset::url()`
-   - Additional utility methods: `exists()`, `size()`, `mime()`, `hash()`
-   - Object-oriented usage available through `Asset::instance()`
-   - Global `asset()` helper function updated
-
-   These changes aim to improve developer experience and make asset handling more straightforward and consistent.
-   ```
-
-5. Upgrade Guide:
-   ```markdown
-   # Upgrading to HydePHP v2.0
-
-   ## Asset API Changes
-
-   1. Replace all usage of `Hyde::mediaLink()`, `Hyde::asset()`, and `Asset::mediaLink()` with `Asset::get()`:
-
-      ```php
-      // Old
-      $path = Hyde::mediaLink('image.jpg');
-      $path = Hyde::asset('image.jpg');
-      $path = Asset::mediaLink('image.jpg');
-
-      // New
-      $path = Asset::get('image.jpg');
-      ```
-
-   2. For absolute paths, use the second parameter of `Asset::get()`:
-
-      ```php
-      $absolutePath = Asset::get('image.jpg', true);
-      ```
-
-   3. Use `Asset::url()` for handling both local and remote URLs:
-
-      ```php
-      $url = Asset::url('image.jpg');
-      $url = Asset::url('https://example.com/image.jpg');
-      ```
-
-   4. Take advantage of new utility methods:
-
-      ```php
-      if (Asset::exists('image.jpg')) {
-          $size = Asset::size('image.jpg');
-          $mime = Asset::mime('image.jpg');
-          $hash = Asset::hash('image.jpg');
-      }
-      ```
-
-   5. For object-oriented usage, use `Asset::instance()`:
-
-      ```php
-      $asset = Asset::instance('image.jpg');
-      $path = $asset->get();
-      $exists = $asset->exists();
-      ```
-
-   6. Update your configuration file to include the new asset validation option:
-
-      ```php
-      // config/hyde.php
-      'assets' => [
-          'validate_existence' => env('HYDE_VALIDATE_ASSETS', false),
-      ],
-      ```
-
-   These changes will ensure your project is compatible with HydePHP v2.0 and takes full advantage of the new Asset API.
-
-This proposal aims to simplify the Asset API while maintaining flexibility and power. It adheres to the HydePHP philosophy by providing an intuitive interface that should be easy to use for both Laravel developers and those less familiar with the framework. The implementation plan ensures a smooth transition from v1 to v2, with clear deprecation notices and comprehensive upgrade instructions.
-
-### Proposal Summary and Analysis
-
-Independent Claude 3.5 Sonnet executive summary of the three proposals for improving the Asset API in HydePHP v2:
-
-1. Fluent Asset API
-
-This proposal introduces a consolidated `Asset` class with both static and instance methods, integrating functionality from the current Asset and Hyde facades. It offers a fluent interface for chaining operations on assets.
-
-Benefits:
-- Simplified, intuitive API
-- Fluent interface for expressive chaining
-- Consistent with Laravel patterns
-
-Drawbacks:
-- Significant departure from current API, potentially high upgrade friction
-- Increased complexity with new classes (AssetFile, AssetCollection)
-
-2. Fluent Asset API (Refined)
-
-This refined proposal merges functionality from the Asset facade and MediaFile class into an abstract `Asset` class. It aligns more closely with existing Hyde page classes and retains some current naming conventions.
-
-Benefits:
-- Better alignment with existing Hyde patterns
-- Comprehensive asset handling (discovery, manipulation, information)
-- Extensibility through abstract class
-
-Drawbacks:
-- Still represents a major change from current API
-- Potential learning curve for users unfamiliar with Hyde patterns
-
-3. Unified Asset API
-
-This proposal focuses on unifying asset-related functions under a single `Asset` facade, with a backing `AssetService`. It aims for a balance between simplification and maintaining familiarity.
-
-Benefits:
-- Maintains facade pattern, reducing upgrade friction
-- Simplifies API while retaining familiar method names
-- Includes a clear deprecation and upgrade path
-
-Drawbacks:
-- Less dramatic improvement in DX compared to fluent proposals
-- Retains some potential for confusion with multiple ways to access assets
-
-#### Final Recommendation:
-
-Based on the analysis, the Unified Asset API (Proposal 3) appears to be the most balanced approach. It offers significant improvements in developer experience and API consistency while minimizing upgrade friction and implementation complexity. The clear deprecation process and upgrade path will ease the transition for existing users.
-
-This proposal aligns well with HydePHP's philosophy of "Simplicity first. Power when you need it." It provides a more intuitive API without a complete overhaul, allowing for gradual adoption of new features. The retained facade pattern and familiar method names will help maintain accessibility for developers of varying experience levels.
-
-While the fluent API proposals offer more dramatic improvements in expressiveness, the associated increase in complexity and potential for confusion may outweigh these benefits. The Unified Asset API strikes a good balance between enhancing DX and maintaining continuity with the current system.
-
-Recommendation: Proceed with implementing the Unified Asset API (Proposal 3), ensuring thorough documentation and clear upgrade guides to support users through the transition.

From 50327f8baa9a6cef16bb530f86d04e60ea8957e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 12:00:50 +0200
Subject: [PATCH 3119/4023] Update release notes for the new Asset API

---
 RELEASE_NOTES.md | 111 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0970fc75495..154a87f9eee 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -23,6 +23,11 @@ This serves two purposes:
 - You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
 - Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
+- **Added a new consolidated Asset API to better handle media files.**
+  - Added several new methods to the `MediaFile` class with methods like `getLink()`, `getLength()`, `getMimeType()`, etc.
+  - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
+  - Added method `Asset::exists()` has to check if a media file exists.
+
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
@@ -60,6 +65,19 @@ This serves two purposes:
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
+- **Many MediaFile related helpers has been changed or completely rewritten** to provide a simplified API for interacting with media files.
+  - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
+  - The `Asset` facade has been e restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
+  - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
+  - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
+  - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904
+  - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911
+  - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in https://github.com/hydephp/develop/pull/1911
+  - We will now throw an exception if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in https://github.com/hydephp/develop/pull/1932
+- **MediaFile performance improvements:**
+  - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
+  - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
+  - We now use the much faster `CRC32` hashing algoritm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -72,6 +90,11 @@ This serves two purposes:
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 - Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
+- **With the new Asset API, a few features had to be moved/removed:**
+  - `AssetService` class has been removed (was merged into the `Asset` facade) in https://github.com/hydephp/develop/pull/1908
+  - Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907
+  - The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)
+  - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
 
 ### Fixed
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
@@ -240,6 +263,94 @@ The following methods in the `Features` class have been renamed to follow a more
 
 Note that this class was previously marked as internal in v1, but the change is logged here in case it was used in configuration files or custom code.
 
+### Asset API Changes
+
+#### Overview
+For most end users, the changes to the Asset API in HydePHP 2.x will have minimal direct impact. However, if you have custom code that interacts with media files, you may need to update it.
+
+The most important thing to note is that all asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
+
+#### Side effects to consider
+
+Regardless of if you need to make changes to your code, there are a few side effects to consider:
+
+- All cache busting keys will have changed since we changed the hashing algorithm from `MD5` to `CRC32`.
+- Media file getters now return MediaFile instances instead of strings. But these can still be used the same way in Blade `{{ }}` tags, as they can be cast to strings.
+- Due to the internal normalizations, we will consistently use cache busting keys and use qualified paths when site URLs are set.
+- An exception will be thrown if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed.
+
+These side effects should not have any negative impact on your site, but may cause the generated HTML to look slightly different.
+
+#### Impact on Your Code
+
+If you are using strict type declarations, you may need to update your code to expect a `MediaFile` instance instead of a string path; or you should cast the `MediaFile` instance to a string when needed.
+
+Most changes were made in https://github.com/hydephp/develop/pull/1904 which contains extra information and the reasoning behind the changes.
+
+#### Updating Your Code
+
+Once you have determined that you need to update your code, here are the steps you should take:
+
+1. Replace usages of `Asset::mediaLink()` with `Asset::get()`:
+
+   ```php
+   // Before (returns a string)
+   Asset::mediaLink('image.jpg');
+   
+   // After (returns a MediaFile instance that can be cast to a string)
+   Asset::get('image.jpg');
+   ```
+
+2. Replace `Hyde::mediaLink()` with `Hyde::asset()`:
+
+   ```php
+   // Before
+   $link = Hyde::mediaLink('image.jpg');
+   
+   // After
+   $link = Hyde::asset('image.jpg');
+   ```
+
+3. Update CDN link generation:
+
+   ```php
+   // Before
+   $cdnLink = Asset::cdnLink('app.css');
+   
+   // After
+   $cdnLink = HydeFront::cdnLink('app.css');
+   ```
+
+4. Replace `Asset::hasMediaFile()` with `Asset::exists()`:
+
+   ```php
+   // Before
+   if (Asset::hasMediaFile('image.jpg')) {
+       // ...
+   }
+   
+   // After
+   if (Asset::exists('image.jpg')) {
+       // ...
+   }
+   ```
+
+5. Update Tailwind config injection:
+
+   ```php
+   // Before
+   $config = Asset::injectTailwindConfig();
+   
+   // After
+   $config = HydeFront::injectTailwindConfig();
+   ```
+
+6. Remove any references to `hyde.hydefront_version` and `hyde.hydefront_cdn_url` in your config files as these options have been removed.
+
+7. If you were using `AssetService` directly, refactor your code to use the new `Asset` facade, `MediaFile` class, or `HydeFront` facade as appropriate.
+
+These changes simplify the Asset API and provide more robust handling of media files. The new `MediaFile` class offers additional functionality for working with assets.
+
 ## Low impact
 
 ### Navigation internal changes

From 79f309171abd7c4d2a57ec4e7561a7509d0f919f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 12:08:51 +0200
Subject: [PATCH 3120/4023] Delete V1Compatibility.php

---
 .../framework/src/Support/V1Compatibility.php | 38 -------------------
 1 file changed, 38 deletions(-)
 delete mode 100644 packages/framework/src/Support/V1Compatibility.php

diff --git a/packages/framework/src/Support/V1Compatibility.php b/packages/framework/src/Support/V1Compatibility.php
deleted file mode 100644
index 3d8f5b5cd0c..00000000000
--- a/packages/framework/src/Support/V1Compatibility.php
+++ /dev/null
@@ -1,38 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Support;
-
-use JetBrains\PhpStorm\Deprecated;
-use Hyde\Support\Filesystem\MediaFile;
-
-/**
- * @internal Hyde Facade support to aid in the v1 to v2 transition.
- *
- * @deprecated All code here is deprecated, and exists to help you transition.
- *
- * @codeCoverageIgnore This class is ignored from code coverage.
- */
-trait V1Compatibility
-{
-    /**
-     * @deprecated Use MediaFile::sourcePath() instead.
-     * @see \Hyde\Support\Filesystem\MediaFile::sourcePath()
-     */
-    #[Deprecated(reason: 'Use MediaFile::sourcePath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::sourcePath(%parametersList%)')]
-    public static function mediaPath(string $path = ''): string
-    {
-        return MediaFile::sourcePath($path);
-    }
-
-    /**
-     * @deprecated Use MediaFile::outputPath() instead.
-     * @see \Hyde\Support\Filesystem\MediaFile::outputPath()
-     */
-    #[Deprecated(reason: 'Use MediaFile::outputPath() instead', replacement: '\Hyde\Support\Filesystem\MediaFile::outputPath(%parametersList%)')]
-    public static function siteMediaPath(string $path = ''): string
-    {
-        return MediaFile::outputPath($path);
-    }
-}

From 10256c78e77156a880bb6afb33463a205e1f6dfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 12:44:10 +0200
Subject: [PATCH 3121/4023] Update wording in comments

---
 packages/framework/src/Facades/HydeFront.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index ed2def95db9..7a49771936c 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -16,10 +16,10 @@
  */
 class HydeFront
 {
-    /** @var string The default HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
+    /** @var string The HydeFront SemVer tag to load. This constant is set to match the styles used for the installed framework version. */
     protected const HYDEFRONT_VERSION = 'v3.4';
 
-    /** @var string The default HydeFront CDN path pattern used to assemble CDN links. */
+    /** @var string The HydeFront CDN path pattern used to assemble CDN links. */
     protected const HYDEFRONT_CDN_URL = 'https://cdn.jsdelivr.net/npm/hydefront@%s/dist/%s';
 
     /**

From 95bd78cb88b34ba571b85c550af5706b7dd6d467 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 12:45:57 +0200
Subject: [PATCH 3122/4023] Improve facade documentation

---
 packages/framework/src/Facades/HydeFront.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 7a49771936c..9f3c4135ff6 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -36,13 +36,15 @@ public static function version(): string
      * Get the CDN link for a specific file.
      *
      * @param  'app.css'|'hyde.css'|'hyde.css.map'  $file
+     *
+     * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
      */
     public static function cdnLink(string $file): string
     {
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
     }
 
-    /** This method is used to inject the Tailwind CSS configuration into the Play CDN integration. */
+    /** This method is used to inject the project's Tailwind CSS configuration into the Play CDN integration so it can match the styles. */
     public static function injectTailwindConfig(): string
     {
         if (! file_exists(Hyde::path('tailwind.config.js'))) {
@@ -51,7 +53,7 @@ public static function injectTailwindConfig(): string
 
         $config = Str::between(file_get_contents(Hyde::path('tailwind.config.js')), '{', '}');
 
-        // Remove the plugins array, as it is not used in the frontend.
+        // Remove the plugins array, as it is not used in the frontend build.
         if (str_contains($config, 'plugins: [')) {
             $tokens = explode('plugins: [', $config, 2);
             $tokens[1] = Str::after($tokens[1], ']');

From ebb9db82881c3fd9cf89bd81e5fad37ebb4790c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 13:14:04 +0200
Subject: [PATCH 3123/4023] Rebuild documentation

---
 docs/architecture-concepts/the-hydekernel.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index 9f470ed3835..4921cb88a37 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -58,7 +58,7 @@ But you could just as well chain the methods on the accessed kernel singleton in
 <section id="hyde-kernel-base-methods">
 
 <!-- Start generated docs for Hyde\Foundation\HydeKernel -->
-<!-- Generated by HydePHP DocGen script at 2024-07-08 20:47:38 in 2.89ms -->
+<!-- Generated by HydePHP DocGen script at 2024-07-09 07:44:59 in 3.36ms -->
 
 #### `version()`
 
@@ -89,7 +89,7 @@ Hyde::features(): Hyde\Facades\Features
 No description provided.
 
 ```php
-Hyde::hasFeature(Hyde\Enums\Feature|string $feature): bool
+Hyde::hasFeature(Hyde\Enums\Feature $feature): bool
 ```
 
 #### `toArray()`

From 319a2fc9a386f6b83dafa74908897fd0a14ce5bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 13:14:31 +0200
Subject: [PATCH 3124/4023] Rebuild documentation

---
 docs/architecture-concepts/the-hydekernel.md | 28 ++++++++------------
 1 file changed, 11 insertions(+), 17 deletions(-)

diff --git a/docs/architecture-concepts/the-hydekernel.md b/docs/architecture-concepts/the-hydekernel.md
index af2f6f97d21..2c266bbecd3 100644
--- a/docs/architecture-concepts/the-hydekernel.md
+++ b/docs/architecture-concepts/the-hydekernel.md
@@ -189,7 +189,7 @@ Hyde::markdown(string $text, bool $normalizeIndentation): Illuminate\Support\Htm
 <section id="hyde-kernel-hyperlink-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsHyperlinks -->
-<!-- Generated by HydePHP DocGen script at 2024-02-25 19:02:29 in 0.09ms -->
+<!-- Generated by HydePHP DocGen script at 2024-09-08 10:25:34 in 0.11ms -->
 
 #### `formatLink()`
 
@@ -212,9 +212,11 @@ Hyde::relativeLink(string $destination): string
 No description provided.
 
 ```php
-Hyde::asset(string $name): string
+Hyde::asset(string $name): Hyde\Support\Filesystem\MediaFile
 ```
 
+- **Throws:** \Hyde\Framework\Exceptions\FileNotFoundException If the file does not exist in the `_media` source directory.
+
 #### `url()`
 
 No description provided.
@@ -246,7 +248,7 @@ Hyde::hasSiteUrl(): bool
 <section id="hyde-kernel-filesystem-methods">
 
 <!-- Start generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->
-<!-- Generated by HydePHP DocGen script at 2023-03-11 11:17:34 in 0.10ms -->
+<!-- Generated by HydePHP DocGen script at 2024-08-01 10:01:06 in 0.13ms -->
 
 #### `filesystem()`
 
@@ -272,14 +274,6 @@ No description provided.
 Hyde::vendorPath(string $path, string $package): string
 ```
 
-#### `mediaPath()`
-
-No description provided.
-
-```php
-Hyde::mediaPath(string $path): string
-```
-
 #### `sitePath()`
 
 No description provided.
@@ -288,28 +282,28 @@ No description provided.
 Hyde::sitePath(string $path): string
 ```
 
-#### `siteMediaPath()`
+#### `pathToAbsolute()`
 
 No description provided.
 
 ```php
-Hyde::siteMediaPath(string $path): string
+Hyde::pathToAbsolute(array|string $path): array|string
 ```
 
-#### `pathToAbsolute()`
+#### `pathToRelative()`
 
 No description provided.
 
 ```php
-Hyde::pathToAbsolute(array|string $path): array|string
+Hyde::pathToRelative(string $path): string
 ```
 
-#### `pathToRelative()`
+#### `assets()`
 
 No description provided.
 
 ```php
-Hyde::pathToRelative(string $path): string
+Hyde::assets(): \Illuminate\Support\Collection<string, \Hyde\Support\Filesystem\MediaFile>
 ```
 
 <!-- End generated docs for Hyde\Foundation\Concerns\ForwardsFilesystem -->

From eda2c12298d179f74708cbd177d93f9a2a02ff19 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 13:47:17 +0200
Subject: [PATCH 3125/4023] Test version returns correct HydeFront version

---
 .../tests/Unit/Facades/HydeFrontFacadeTest.php      | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index 3bcdf3a096d..2ac04884afe 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -15,7 +15,18 @@ class HydeFrontFacadeTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
 
-    // Todo: Check the version is correct? (When running in monorepo)
+    public function testVersionReturnsCorrectHydeFrontVersion()
+    {
+        if (file_exists(Hyde::path('README.md')) && ! str_contains(file_get_contents(Hyde::path('README.md')), 'HydePHP - Source Code Monorepo')) {
+            $this->markTestSkipped('Test skipped when not running in the monorepo.');
+        }
+
+        $package = json_decode(file_get_contents(Hyde::path('packages/hydefront/package.json')), true);
+
+        [$major, $minor] = explode('.', $package['version']);
+
+        $this->assertSame("v$major.$minor", HydeFront::version());
+    }
 
     public function testVersionReturnsString()
     {

From 532e35fbcffc2336648c3ab72292881d5c889a5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 14:11:49 +0200
Subject: [PATCH 3126/4023] Update head layout to use the Asset API

---
 .../resources/views/layouts/head.blade.php    |  4 ++--
 .../Unit/Views/HeadComponentViewTest.php      | 22 ++++++++++++++++++-
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/layouts/head.blade.php b/packages/framework/resources/views/layouts/head.blade.php
index 111aced665b..861eadfc8ff 100644
--- a/packages/framework/resources/views/layouts/head.blade.php
+++ b/packages/framework/resources/views/layouts/head.blade.php
@@ -2,8 +2,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>{{ $page->title() }}</title>
 
-@if (file_exists(MediaFile::sourcePath('favicon.ico')))
-    <link rel="shortcut icon" href="{{ Hyde::relativeLink('media/favicon.ico') }}" type="image/x-icon">
+@if (Asset::exists('favicon.ico'))
+    <link rel="shortcut icon" href="{{ Asset::get('media/favicon.ico') }}" type="image/x-icon">
 @endif
 
 {{-- App Meta Tags --}}
diff --git a/packages/framework/tests/Unit/Views/HeadComponentViewTest.php b/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
index 3678fd3a04f..a43865ad60a 100644
--- a/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
@@ -51,7 +51,7 @@ public function testLinkToFaviconIsAddedWhenFileExists()
         $this->mockPage();
         $this->file('_media/favicon.ico');
 
-        $this->assertStringContainsString('<link rel="shortcut icon" href="media/favicon.ico" type="image/x-icon">', $this->renderTestView());
+        $this->assertStringContainsString('<link rel="shortcut icon" href="media/favicon.ico?v=00000000" type="image/x-icon">', $this->renderTestView());
     }
 
     public function testLinkToFaviconUsesRelativeUrl()
@@ -59,6 +59,26 @@ public function testLinkToFaviconUsesRelativeUrl()
         $this->file('_media/favicon.ico');
         $this->mockPage(currentPage: 'foo/bar');
 
+        $this->assertStringContainsString('<link rel="shortcut icon" href="../media/favicon.ico?v=00000000" type="image/x-icon">', $this->renderTestView());
+    }
+
+    public function testLinkToFaviconUsesAbsoluteBaseUrl()
+    {
+        $this->file('_media/favicon.ico');
+        $this->mockPage(currentPage: 'foo/bar');
+
+        config(['hyde.url' => 'https://example.com']);
+
+        $this->assertStringContainsString('<link rel="shortcut icon" href="https://example.com/media/favicon.ico?v=00000000" type="image/x-icon">', $this->renderTestView());
+    }
+
+    public function testLinkToFaviconDoesNotUseCacheBustingWhenDisabled()
+    {
+        $this->file('_media/favicon.ico');
+        $this->mockPage(currentPage: 'foo/bar');
+
+        config(['hyde.enable_cache_busting' => false]);
+
         $this->assertStringContainsString('<link rel="shortcut icon" href="../media/favicon.ico" type="image/x-icon">', $this->renderTestView());
     }
 

From d4d8af37cb6309d65b07dde742857ba3982ba9f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 14:17:50 +0200
Subject: [PATCH 3127/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 154a87f9eee..a2d1ef726a7 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -24,9 +24,10 @@ This serves two purposes:
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
 - Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
 - **Added a new consolidated Asset API to better handle media files.**
-  - Added several new methods to the `MediaFile` class with methods like `getLink()`, `getLength()`, `getMimeType()`, etc.
+  - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
   - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
   - Added method `Asset::exists()` has to check if a media file exists.
+  - Added a `Hyde::assets()` method to get all media file instancess in the site.
 
 
 ### Changed
@@ -69,6 +70,7 @@ This serves two purposes:
   - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
   - The `Asset` facade has been e restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
   - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
+  - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.
   - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
   - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904
   - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911
@@ -95,6 +97,8 @@ This serves two purposes:
   - Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907
   - The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)
   - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
+  - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
+  - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
 
 ### Fixed
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784

From 1affcbb10c77d23395a7d989e61f881e05fe0ebe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 14:26:36 +0200
Subject: [PATCH 3128/4023] Breaking: Rename config option
 `enable_cache_busting` to `cache_busting`

This option is best because it:

1.  Maintains consistency with the rest of the configuration file.
2.  Aligns with the explanatory comment.
3.  Is clear and concise.

It is part of the HydePHP v2 Asset API refactors https://github.com/hydephp/develop/pull/1904
---
 config/hyde.php                                |  2 +-
 packages/framework/config/hyde.php             |  2 +-
 .../src/Support/Filesystem/MediaFile.php       |  2 +-
 .../DynamicMarkdownLinksFeatureTest.php        |  2 +-
 .../tests/Feature/FeaturedImageFactoryTest.php |  4 ++--
 .../tests/Feature/FeaturedImageTest.php        |  4 ++--
 .../framework/tests/Feature/HelpersTest.php    |  4 ++--
 .../framework/tests/Feature/HydeKernelTest.php | 10 +++++-----
 .../tests/Feature/MarkdownPostTest.php         |  2 +-
 .../framework/tests/Feature/MetadataTest.php   |  2 +-
 .../DynamicMarkdownLinkProcessorTest.php       |  2 +-
 .../Feature/Services/RssFeedServiceTest.php    |  2 +-
 .../tests/Feature/Views/MetadataViewTest.php   |  2 +-
 .../tests/Unit/Facades/AssetFacadeUnitTest.php |  2 +-
 ...iveLinksAcrossPagesRetainsIntegrityTest.php |  2 +-
 .../tests/Unit/Support/MediaFileUnitTest.php   | 18 +++++++++---------
 .../Unit/Views/ArticleExcerptViewTest.php      |  2 +-
 .../tests/Unit/Views/FeaturedImageViewTest.php |  4 ++--
 .../tests/Unit/Views/HeadComponentViewTest.php |  2 +-
 .../Unit/Views/ScriptsComponentViewTest.php    |  2 +-
 .../Unit/Views/StylesComponentViewTest.php     |  2 +-
 21 files changed, 37 insertions(+), 37 deletions(-)

diff --git a/config/hyde.php b/config/hyde.php
index e601ff0a912..92163827958 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -364,7 +364,7 @@
     |
     */
 
-    'enable_cache_busting' => true,
+    'cache_busting' => true,
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index e601ff0a912..92163827958 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -364,7 +364,7 @@
     |
     */
 
-    'enable_cache_busting' => true,
+    'cache_busting' => true,
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 07827626abe..5afdf429797 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -183,7 +183,7 @@ public function toArray(): array
 
     protected function getCacheBustKey(): string
     {
-        return Config::getBool('hyde.enable_cache_busting', true)
+        return Config::getBool('hyde.cache_busting', true)
             ? '?v='.$this->getHash()
             : '';
     }
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 97df3a668af..e0981f7cabb 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -48,7 +48,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
     }
 
     public function testBasicDynamicMarkdownLinks()
diff --git a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
index 2e6ea781049..b38f0b77bd3 100644
--- a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
@@ -20,7 +20,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         $this->file('_media/foo');
     }
@@ -135,7 +135,7 @@ public function testImagePathsAreNormalizedForCustomizedMediaDirectoryWithoutUnd
 
     public function testImagePathsWithCacheBusting()
     {
-        config(['hyde.enable_cache_busting' => true]);
+        config(['hyde.cache_busting' => true]);
 
         $this->assertSourceIsSame('media/foo?v=00000000', ['image' => 'foo']);
         $this->assertSourceIsSame('media/foo?v=00000000', ['image' => 'media/foo']);
diff --git a/packages/framework/tests/Feature/FeaturedImageTest.php b/packages/framework/tests/Feature/FeaturedImageTest.php
index 47819102cc4..031018a0d22 100644
--- a/packages/framework/tests/Feature/FeaturedImageTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageTest.php
@@ -21,7 +21,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         $this->file('_media/foo', 'test');
         $this->file('_media/source');
@@ -118,7 +118,7 @@ public function testGetSourceMethod()
 
     public function testImagePathsWithCacheBusting()
     {
-        config(['hyde.enable_cache_busting' => true]);
+        config(['hyde.cache_busting' => true]);
 
         $this->assertSame('media/foo?v=accf8b33', (new FeaturedImage('_media/foo', ...$this->defaultArguments()))->getSource());
         $this->assertSame('media/foo?v=accf8b33', FeaturedImageFactory::make(new FrontMatter(['image.source' => 'foo']))->getSource());
diff --git a/packages/framework/tests/Feature/HelpersTest.php b/packages/framework/tests/Feature/HelpersTest.php
index aefa3b160a4..9efbfb6532b 100644
--- a/packages/framework/tests/Feature/HelpersTest.php
+++ b/packages/framework/tests/Feature/HelpersTest.php
@@ -27,7 +27,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
     }
 
     /** @covers ::hyde */
@@ -89,7 +89,7 @@ public function testAssetFunction()
     /** @covers ::asset */
     public function testAssetFunctionWithCacheBusting()
     {
-        config(['hyde.enable_cache_busting' => true]);
+        config(['hyde.cache_busting' => true]);
 
         $this->assertInstanceOf(MediaFile::class, asset('app.css'));
         $this->assertEquals(new MediaFile('media/app.css'), asset('app.css'));
diff --git a/packages/framework/tests/Feature/HydeKernelTest.php b/packages/framework/tests/Feature/HydeKernelTest.php
index c34cbc792f2..bc4591539dc 100644
--- a/packages/framework/tests/Feature/HydeKernelTest.php
+++ b/packages/framework/tests/Feature/HydeKernelTest.php
@@ -230,7 +230,7 @@ public function testAssetHelperWithoutCacheBusting()
     {
         $this->file('_media/foo.jpg');
 
-        Config::set('hyde.enable_cache_busting', false);
+        Config::set('hyde.cache_busting', false);
 
         $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
     }
@@ -241,11 +241,11 @@ public function testAssetHelperWithoutCacheBustingWithChangedSettingInTheSameLif
 
         $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
 
-        Config::set('hyde.enable_cache_busting', false);
+        Config::set('hyde.cache_busting', false);
 
         $this->assertSame('media/foo.jpg', (string) Hyde::asset('foo.jpg'));
 
-        Config::set('hyde.enable_cache_busting', true);
+        Config::set('hyde.cache_busting', true);
 
         $this->assertSame('media/foo.jpg?v=00000000', (string) Hyde::asset('foo.jpg'));
     }
@@ -258,11 +258,11 @@ public function testAssetHelperWithoutCacheBustingWithChangedSettingInTheSameLif
 
         $this->assertSame('media/foo.jpg?v=00000000', (string) $instance);
 
-        Config::set('hyde.enable_cache_busting', false);
+        Config::set('hyde.cache_busting', false);
 
         $this->assertSame('media/foo.jpg', (string) $instance);
 
-        Config::set('hyde.enable_cache_busting', true);
+        Config::set('hyde.cache_busting', true);
 
         $this->assertSame('media/foo.jpg?v=00000000', (string) $instance);
     }
diff --git a/packages/framework/tests/Feature/MarkdownPostTest.php b/packages/framework/tests/Feature/MarkdownPostTest.php
index 1166f2162be..cc4109d85fa 100644
--- a/packages/framework/tests/Feature/MarkdownPostTest.php
+++ b/packages/framework/tests/Feature/MarkdownPostTest.php
@@ -195,6 +195,6 @@ public function testBlogPostFeedCanBeRenderedWhenPostHasNoFrontMatter()
     protected function setupMediaFileAndCacheBusting(bool $enableCacheBusting = false): void
     {
         $this->file('_media/foo.png', 'test content');
-        config(['hyde.enable_cache_busting' => $enableCacheBusting]);
+        config(['hyde.cache_busting' => $enableCacheBusting]);
     }
 }
diff --git a/packages/framework/tests/Feature/MetadataTest.php b/packages/framework/tests/Feature/MetadataTest.php
index f6c6ce3446d..e1220f8fbe2 100644
--- a/packages/framework/tests/Feature/MetadataTest.php
+++ b/packages/framework/tests/Feature/MetadataTest.php
@@ -526,7 +526,7 @@ public function testDynamicPostMetaPropertiesContainsImageMetadataWhenFeaturedIm
 
     public function testDynamicPostMetaPropertiesContainsImageLinkWithoutCacheBusting()
     {
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         $this->file('_media/foo.jpg');
 
diff --git a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
index 86cd30871ac..a0736900cb2 100644
--- a/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/DynamicMarkdownLinkProcessorTest.php
@@ -34,7 +34,7 @@ protected function setUp(): void
 
         // Todo: No way to mock media files, so we are using app.css as a test asset for now.
 
-        self::mockConfig(['hyde.enable_cache_busting' => false]);
+        self::mockConfig(['hyde.cache_busting' => false]);
     }
 
     public function testRouteReplacement()
diff --git a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
index 96b9b9afcf9..72f291eaaa4 100644
--- a/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
+++ b/packages/framework/tests/Feature/Services/RssFeedServiceTest.php
@@ -86,7 +86,7 @@ public function testXmlChannelDataCanBeCustomized()
 
     public function testMarkdownBlogPostsAreAddedToRssFeedThroughAutodiscovery()
     {
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         file_put_contents(Hyde::path('_posts/rss.md'), <<<'MD'
             ---
diff --git a/packages/framework/tests/Feature/Views/MetadataViewTest.php b/packages/framework/tests/Feature/Views/MetadataViewTest.php
index 33e0108c7d8..1e517e8e0e1 100644
--- a/packages/framework/tests/Feature/Views/MetadataViewTest.php
+++ b/packages/framework/tests/Feature/Views/MetadataViewTest.php
@@ -26,7 +26,7 @@ protected function setUp(): void
         parent::setUp();
 
         $this->withSiteUrl();
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
     }
 
     protected function build(?string $page = null): void
diff --git a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
index 807aee54226..da5b1573138 100644
--- a/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/Facades/AssetFacadeUnitTest.php
@@ -53,7 +53,7 @@ public function testAssetReturnsMediaPathWithCacheKey()
 
     public function testAssetReturnsMediaPathWithoutCacheKeyIfCacheBustingIsDisabled()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false]);
+        self::mockConfig(['hyde.cache_busting' => false]);
 
         $path = (string) Asset::get('app.css');
 
diff --git a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
index e8f9f8c1f66..d15f0d9cbcc 100644
--- a/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
+++ b/packages/framework/tests/Unit/RelativeLinksAcrossPagesRetainsIntegrityTest.php
@@ -22,7 +22,7 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
         config(['hyde.navigation.subdirectory_display' => 'flat']);
 
         $this->needsDirectory('_pages/nested');
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index c5a5761a3bd..10d0818b411 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -64,7 +64,7 @@ protected function setUp(): void
         \Illuminate\Support\Facades\View::swap(Mockery::mock(Factory::class)->makePartial());
         Render::swap(new RenderData());
 
-        self::mockConfig(['hyde.enable_cache_busting' => false]);
+        self::mockConfig(['hyde.cache_busting' => false]);
     }
 
     protected function tearDown(): void
@@ -463,7 +463,7 @@ public function testGetLinkWithCustomMediaDirectory()
 
     public function testGetLinkWithPrettyUrls()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.pretty_urls' => true]);
+        self::mockConfig(['hyde.cache_busting' => false, 'hyde.pretty_urls' => true]);
         $file = MediaFile::make('foo.txt');
         $this->assertSame('media/foo.txt', $file->getLink());
     }
@@ -476,7 +476,7 @@ public function testGetLinkWithNestedFile()
 
     public function testGetLinkWithBaseUrl()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.url' => 'https://example.com']);
+        self::mockConfig(['hyde.cache_busting' => false, 'hyde.url' => 'https://example.com']);
         $file = MediaFile::make('foo.txt');
         $this->assertSame('https://example.com/media/foo.txt', $file->getLink());
     }
@@ -484,7 +484,7 @@ public function testGetLinkWithBaseUrl()
     public function testGetLinkWithBaseUrlAndPrettyUrls()
     {
         self::mockConfig([
-            'hyde.enable_cache_busting' => false,
+            'hyde.cache_busting' => false,
             'hyde.url' => 'https://example.com',
             'hyde.pretty_urls' => true,
         ]);
@@ -494,7 +494,7 @@ public function testGetLinkWithBaseUrlAndPrettyUrls()
 
     public function testGetLinkWithCacheBusting()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => true]);
+        self::mockConfig(['hyde.cache_busting' => true]);
         $this->mockFilesystem->shouldReceive('hash')
             ->andReturn('abc123');
         $file = MediaFile::make('foo.txt');
@@ -503,7 +503,7 @@ public function testGetLinkWithCacheBusting()
 
     public function testGetLinkWithCacheBustingDisabled()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false]);
+        self::mockConfig(['hyde.cache_busting' => false]);
         $file = MediaFile::make('foo.txt');
         $this->assertSame('media/foo.txt', $file->getLink());
     }
@@ -547,7 +547,7 @@ public function testStringCastWithCustomMediaDirectory()
 
     public function testStringCastWithPrettyUrls()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.pretty_urls' => true]);
+        self::mockConfig(['hyde.cache_busting' => false, 'hyde.pretty_urls' => true]);
         $file = new MediaFile('foo.txt');
         $this->assertSame('media/foo.txt', (string) $file);
     }
@@ -560,14 +560,14 @@ public function testStringCastWithNestedFile()
 
     public function testStringCastWithBaseUrl()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => false, 'hyde.url' => 'https://example.com']);
+        self::mockConfig(['hyde.cache_busting' => false, 'hyde.url' => 'https://example.com']);
         $file = new MediaFile('foo.txt');
         $this->assertSame('https://example.com/media/foo.txt', (string) $file);
     }
 
     public function testStringCastWithCacheBusting()
     {
-        self::mockConfig(['hyde.enable_cache_busting' => true]);
+        self::mockConfig(['hyde.cache_busting' => true]);
         $this->mockFilesystem->shouldReceive('hash')
             ->andReturn('abc123');
         $file = new MediaFile('foo.txt');
diff --git a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
index 6b7d49e9ffc..062bd3f4b2d 100644
--- a/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
+++ b/packages/framework/tests/Unit/Views/ArticleExcerptViewTest.php
@@ -112,7 +112,7 @@ public function testItempropImageIsAddedWhenThereIsAnImageWithLocalPathNoCache()
     {
         $this->file('_media/image.jpg');
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         $viewLocalNoCache = $this->renderTestView(MarkdownPost::make(matter: [
             'image' => 'image.jpg',
diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index 188f489dc38..a15ade44528 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -20,7 +20,7 @@ protected function setUp(): void
     {
         parent::setUp();
         $this->file('_media/foo.jpg', 'test content');
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
     }
 
     public function testTheView()
@@ -259,7 +259,7 @@ public function testFluentAttributionLogicCreatesFluentMessages7()
 
     public function testCacheBusting()
     {
-        config(['hyde.enable_cache_busting' => true]);
+        config(['hyde.cache_busting' => true]);
         $component = $this->renderComponent();
         $this->assertStringContainsString('src="media/foo.jpg?v=98b41d87"', $component);
     }
diff --git a/packages/framework/tests/Unit/Views/HeadComponentViewTest.php b/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
index a43865ad60a..d16df103f5f 100644
--- a/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/HeadComponentViewTest.php
@@ -77,7 +77,7 @@ public function testLinkToFaviconDoesNotUseCacheBustingWhenDisabled()
         $this->file('_media/favicon.ico');
         $this->mockPage(currentPage: 'foo/bar');
 
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
 
         $this->assertStringContainsString('<link rel="shortcut icon" href="../media/favicon.ico" type="image/x-icon">', $this->renderTestView());
     }
diff --git a/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php b/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
index 63abb92a8a9..d16027a70b0 100644
--- a/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
@@ -18,7 +18,7 @@ class ScriptsComponentViewTest extends TestCase
 
     protected function renderTestView(): string
     {
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
         $this->mockCurrentPage($this->mockCurrentPage ?? '');
 
         return Blade::render(file_get_contents(
diff --git a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
index bb5358f9e08..95fb7a2ee09 100644
--- a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
@@ -20,7 +20,7 @@ class StylesComponentViewTest extends TestCase
 
     protected function renderTestView(): string
     {
-        config(['hyde.enable_cache_busting' => false]);
+        config(['hyde.cache_busting' => false]);
         $this->mockCurrentPage($this->mockCurrentPage ?? '');
 
         return Blade::render(file_get_contents(

From 9c3f9f8b1a6513e131622ddbc74066d99d0fe7d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 14:29:22 +0200
Subject: [PATCH 3129/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a2d1ef726a7..22092c8c085 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,6 +39,7 @@ This serves two purposes:
 - **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
 - **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
 - **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
+- **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in https://github.com/hydephp/develop/pull/1980
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
@@ -349,9 +350,11 @@ Once you have determined that you need to update your code, here are the steps y
    $config = HydeFront::injectTailwindConfig();
    ```
 
-6. Remove any references to `hyde.hydefront_version` and `hyde.hydefront_cdn_url` in your config files as these options have been removed.
+6. Rename the option `hyde.enable_cache_busting` to `hyde.cache_busting` in your configuration file.
 
-7. If you were using `AssetService` directly, refactor your code to use the new `Asset` facade, `MediaFile` class, or `HydeFront` facade as appropriate.
+7. Remove any references to `hyde.hydefront_version` and `hyde.hydefront_cdn_url` in your config files as these options have been removed.
+
+8. If you were using `AssetService` directly, refactor your code to use the new `Asset` facade, `MediaFile` class, or `HydeFront` facade as appropriate.
 
 These changes simplify the Asset API and provide more robust handling of media files. The new `MediaFile` class offers additional functionality for working with assets.
 

From 269f0fbbdb93030f7076aa43bb253f6856859949 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 5 Oct 2024 14:36:28 +0200
Subject: [PATCH 3130/4023] Merge update steps for renamed methos

---
 RELEASE_NOTES.md | 65 ++++++++----------------------------------------
 1 file changed, 11 insertions(+), 54 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 22092c8c085..f9e545109eb 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -296,65 +296,22 @@ Most changes were made in https://github.com/hydephp/develop/pull/1904 which con
 
 Once you have determined that you need to update your code, here are the steps you should take:
 
-1. Replace usages of `Asset::mediaLink()` with `Asset::get()`:
-
-   ```php
-   // Before (returns a string)
-   Asset::mediaLink('image.jpg');
-   
-   // After (returns a MediaFile instance that can be cast to a string)
-   Asset::get('image.jpg');
-   ```
-
-2. Replace `Hyde::mediaLink()` with `Hyde::asset()`:
-
-   ```php
-   // Before
-   $link = Hyde::mediaLink('image.jpg');
-   
-   // After
-   $link = Hyde::asset('image.jpg');
-   ```
-
-3. Update CDN link generation:
-
-   ```php
-   // Before
-   $cdnLink = Asset::cdnLink('app.css');
-   
-   // After
-   $cdnLink = HydeFront::cdnLink('app.css');
-   ```
-
-4. Replace `Asset::hasMediaFile()` with `Asset::exists()`:
-
-   ```php
-   // Before
-   if (Asset::hasMediaFile('image.jpg')) {
-       // ...
-   }
-   
-   // After
-   if (Asset::exists('image.jpg')) {
-       // ...
-   }
-   ```
-
-5. Update Tailwind config injection:
-
+1. Update calls to renamed methods:
    ```php
-   // Before
-   $config = Asset::injectTailwindConfig();
-   
-   // After
-   $config = HydeFront::injectTailwindConfig();
+   // Replace this:                      With this:
+   Hyde::mediaLink('image.png')      =>  Hyde::asset('image.png');
+   Asset::mediaLink('image.png')     =>  Asset::get('image.png');
+   Asset::hasMediaFile('image.png')  =>  Asset::exists('image.png');
+   Asset::cdnLink('app.css')         =>  HydeFront::cdnLink('app.css');
+   Asset::injectTailwindConfig()     =>  HydeFront::injectTailwindConfig();
+   FeaturedImage::isRemote($source)  =>  Hyperlinks::isRemote($source);
    ```
 
-6. Rename the option `hyde.enable_cache_busting` to `hyde.cache_busting` in your configuration file.
+2. Rename the option `hyde.enable_cache_busting` to `hyde.cache_busting` in your configuration file.
 
-7. Remove any references to `hyde.hydefront_version` and `hyde.hydefront_cdn_url` in your config files as these options have been removed.
+3. Remove any references to `hyde.hydefront_version` and `hyde.hydefront_cdn_url` in your config files as these options have been removed.
 
-8. If you were using `AssetService` directly, refactor your code to use the new `Asset` facade, `MediaFile` class, or `HydeFront` facade as appropriate.
+4. If you were using `AssetService` directly, refactor your code to use the new `Asset` facade, `MediaFile` class, or `HydeFront` facade as appropriate.
 
 These changes simplify the Asset API and provide more robust handling of media files. The new `MediaFile` class offers additional functionality for working with assets.
 

From c936cbea4daf00c0cb6e48c9cba0634c4b91eddc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:06:05 +0200
Subject: [PATCH 3131/4023] Clean up and improve test

---
 .../tests/Feature/StaticSiteServiceTest.php   | 35 ++++++++++++-------
 1 file changed, 23 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 8c740d851c5..6127b9c23a5 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -59,10 +59,12 @@ public function testBuildCommandCreatesHtmlFiles()
 
     public function testBuildCommandTransfersMediaAssetFiles()
     {
-        file_put_contents(Hyde::path('_media/test-image.png'), 'foo');
-        $this->artisan('build');
+        $this->file('_media/test-image.png', 'foo');
+        $this->artisan('build')
+            ->expectsOutputToContain('Transferring Media Assets...');
+
         $this->assertFileEquals(Hyde::path('_media/test-image.png'), Hyde::path('_site/media/test-image.png'));
-        Filesystem::unlink('_media/test-image.png');
+
         Filesystem::unlink('_site/media/test-image.png');
     }
 
@@ -70,11 +72,28 @@ public function testBuildCommandTransfersMediaAssetFilesRecursively()
     {
         $this->directory('_media/foo');
 
-        file_put_contents(Hyde::path('_media/foo/img.png'), 'foo');
+        $this->file('_media/foo/img.png', 'foo');
         $this->artisan('build')->assertSuccessful();
         $this->assertFileEquals(Hyde::path('_media/foo/img.png'), Hyde::path('_site/media/foo/img.png'));
     }
 
+    public function testBuildCommandCreatesNeededDirectoriesRecursively()
+    {
+        $this->directory('_media/foo/bar');
+        $this->file('_media/1.png');
+        $this->file('_media/foo/2.png');
+        $this->file('_media/foo/bar/3.png');
+
+        Filesystem::deleteDirectory('_site');
+
+        $this->artisan('build')
+            ->assertExitCode(0);
+
+        $this->assertFileExists(Hyde::path('_site/media/1.png'));
+        $this->assertFileExists(Hyde::path('_site/media/foo/2.png'));
+        $this->assertFileExists(Hyde::path('_site/media/foo/bar/3.png'));
+    }
+
     public function testAllPageTypesCanBeCompiled()
     {
         $this->file('_pages/html.html');
@@ -96,12 +115,6 @@ public function testAllPageTypesCanBeCompiled()
         $this->assertFileExists(Hyde::path('_site/markdown.html'));
         $this->assertFileExists(Hyde::path('_site/posts/post.html'));
         $this->assertFileExists(Hyde::path('_site/docs/docs.html'));
-
-        Filesystem::unlink('_site/html.html');
-        Filesystem::unlink('_site/blade.html');
-        Filesystem::unlink('_site/markdown.html');
-        Filesystem::unlink('_site/posts/post.html');
-        Filesystem::unlink('_site/docs/docs.html');
     }
 
     public function testOnlyProgressBarsForTypesWithPagesAreShown()
@@ -120,8 +133,6 @@ public function testOnlyProgressBarsForTypesWithPagesAreShown()
 
         $this->assertFileExists(Hyde::path('_site/blade.html'));
         $this->assertFileExists(Hyde::path('_site/markdown.html'));
-        Filesystem::unlink('_site/blade.html');
-        Filesystem::unlink('_site/markdown.html');
     }
 
     public function testPrintInitialInformationAllowsApiToBeDisabled()

From 84672f1507d9cc9385fcfab273311fee190108cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:22:35 +0200
Subject: [PATCH 3132/4023] Add instance helper to get media file output path

---
 .../src/Support/Filesystem/MediaFile.php      |  8 ++++
 .../tests/Feature/Support/MediaFileTest.php   | 44 ++++++++++++++++++-
 .../tests/Unit/Support/MediaFileUnitTest.php  | 28 ++++++++++++
 3 files changed, 79 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Support/Filesystem/MediaFile.php b/packages/framework/src/Support/Filesystem/MediaFile.php
index 5afdf429797..82eadc79b9b 100644
--- a/packages/framework/src/Support/Filesystem/MediaFile.php
+++ b/packages/framework/src/Support/Filesystem/MediaFile.php
@@ -137,6 +137,14 @@ public function getLink(): string
         return Hyde::relativeLink($name).$this->getCacheBustKey();
     }
 
+    /**
+     * Get the absolute path to the media file in the compiled site.
+     */
+    public function getOutputPath(): string
+    {
+        return static::outputPath($this->getIdentifier());
+    }
+
     /**
      * Get the content length of the file in bytes.
      */
diff --git a/packages/framework/tests/Feature/Support/MediaFileTest.php b/packages/framework/tests/Feature/Support/MediaFileTest.php
index c088dac91d8..9ed44ccd8e8 100644
--- a/packages/framework/tests/Feature/Support/MediaFileTest.php
+++ b/packages/framework/tests/Feature/Support/MediaFileTest.php
@@ -54,7 +54,7 @@ public function testMediaFileDiscovery()
         $this->assertArrayHasKey('script.js', $allFiles);
 
         $fileNames = MediaFile::files();
-        $this->assertSame(['image.png', 'app.css', 'style.css', 'script.js'], $fileNames);
+        $this->assertEqualsCanonicalizing(['image.png', 'app.css', 'style.css', 'script.js'], $fileNames);
     }
 
     public function testMediaFileProperties()
@@ -119,4 +119,46 @@ public function testMediaFileCacheBusting()
         $this->assertStringStartsWith('?v=', $cacheBustKey);
         $this->assertSame('?v=cd5de5e7', $cacheBustKey); // Expect CRC32 hash
     }
+
+    public function testGetOutputPath()
+    {
+        $this->file('_media/test.txt', 'Hello, World!');
+        $mediaFile = MediaFile::make('test.txt');
+
+        $expectedPath = Hyde::path('_site/media/test.txt');
+        $this->assertSame($expectedPath, $mediaFile->getOutputPath());
+    }
+
+    public function testGetOutputPathWithNestedFile()
+    {
+        $this->file('_media/subfolder/nested_file.txt', 'Nested content');
+        $mediaFile = MediaFile::make('subfolder/nested_file.txt');
+
+        $expectedPath = Hyde::path('_site/media/subfolder/nested_file.txt');
+        $this->assertSame($expectedPath, $mediaFile->getOutputPath());
+    }
+
+    public function testGetOutputPathWithCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $this->file('custom_media/custom_file.txt', 'Custom content');
+        $mediaFile = MediaFile::make('custom_file.txt');
+
+        $expectedPath = Hyde::path('_site/custom_media/custom_file.txt');
+        $this->assertSame($expectedPath, $mediaFile->getOutputPath());
+
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testGetOutputPathWithCustomOutputDirectory()
+    {
+        Hyde::setOutputDirectory('custom_output');
+        $this->file('_media/test.txt', 'Hello, World!');
+        $mediaFile = MediaFile::make('test.txt');
+
+        $expectedPath = Hyde::path('custom_output/media/test.txt');
+        $this->assertSame($expectedPath, $mediaFile->getOutputPath());
+
+        Hyde::setOutputDirectory('_site'); // Reset to default
+    }
 }
diff --git a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
index 10d0818b411..1be4b464f59 100644
--- a/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
+++ b/packages/framework/tests/Unit/Support/MediaFileUnitTest.php
@@ -581,6 +581,34 @@ public function testStringCastWithCurrentPageContext()
         $this->assertSame('../media/baz.txt', (string) $file);
     }
 
+    public function testGetOutputPath()
+    {
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('/base/path/_site/media/foo.txt', $file->getOutputPath());
+    }
+
+    public function testGetOutputPathWithNestedFile()
+    {
+        $file = MediaFile::make('subdirectory/foo.txt');
+        $this->assertSame('/base/path/_site/media/subdirectory/foo.txt', $file->getOutputPath());
+    }
+
+    public function testGetOutputPathWithCustomMediaDirectory()
+    {
+        Hyde::setMediaDirectory('custom_media');
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('/base/path/_site/custom_media/foo.txt', $file->getOutputPath());
+        Hyde::setMediaDirectory('_media'); // Reset to default
+    }
+
+    public function testGetOutputPathWithCustomOutputDirectory()
+    {
+        Hyde::setOutputDirectory('/base/path/custom_output');
+        $file = MediaFile::make('foo.txt');
+        $this->assertSame('/base/path/custom_output/media/foo.txt', $file->getOutputPath());
+        Hyde::setOutputDirectory('/base/path/_site'); // Reset to default
+    }
+
     // Helper method to mock the current page
     protected function mockCurrentPage(string $page): void
     {

From bdf0cc1fb1927f71e5a72de0eada06781e17e7db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:25:44 +0200
Subject: [PATCH 3133/4023] Update media asset transfer task to use the Asset
 API

---
 .../Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 3acb112ea9d..86fe084a470 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -20,10 +20,10 @@ public function handle(): void
 
         $this->newLine();
 
-        $this->withProgressBar(MediaFile::files(), function (string $identifier): void {
-            $sitePath = MediaFile::outputPath($identifier);
+        $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {
+            $sitePath = $file->getOutputPath();
             $this->needsParentDirectory($sitePath);
-            copy(MediaFile::sourcePath($identifier), $sitePath);
+            copy($file->getAbsolutePath(), $sitePath);
         });
 
         $this->newLine();

From 6b3d54cb1a71aeebcff7eec7fec26a5935f2d870 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:28:56 +0200
Subject: [PATCH 3134/4023] Remove unnecessary method call

---
 .../src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 86fe084a470..e7a3e7bc160 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -16,8 +16,6 @@ class TransferMediaAssets extends PreBuildTask
 
     public function handle(): void
     {
-        $this->needsDirectory(MediaFile::outputPath());
-
         $this->newLine();
 
         $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {

From 704bc273ebc9f4741c1970cb24d1ddee05dad5d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:39:53 +0200
Subject: [PATCH 3135/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index f9e545109eb..85b9078ec4e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -67,6 +67,7 @@ This serves two purposes:
 - The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
+- Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
 - **Many MediaFile related helpers has been changed or completely rewritten** to provide a simplified API for interacting with media files.
   - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
   - The `Asset` facade has been e restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.

From 5de7fce5ce5b64575ca9eee68012999078bba700 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:39:59 +0200
Subject: [PATCH 3136/4023] Cover the task

---
 packages/framework/tests/Feature/StaticSiteServiceTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 6127b9c23a5..a3d0780c609 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -18,6 +18,7 @@
  * @covers \Hyde\Console\Commands\BuildSiteCommand
  * @covers \Hyde\Framework\Services\BuildService
  * @covers \Hyde\Framework\Actions\PreBuildTasks\CleanSiteDirectory
+ * @covers \Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets
  */
 class StaticSiteServiceTest extends TestCase
 {

From 2e49a6c337b8322ccba7294c555c4e5e13327e4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:42:05 +0200
Subject: [PATCH 3137/4023] Clarify test name

---
 packages/framework/tests/Feature/StaticSiteServiceTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index a3d0780c609..9172495f20b 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -78,7 +78,7 @@ public function testBuildCommandTransfersMediaAssetFilesRecursively()
         $this->assertFileEquals(Hyde::path('_media/foo/img.png'), Hyde::path('_site/media/foo/img.png'));
     }
 
-    public function testBuildCommandCreatesNeededDirectoriesRecursively()
+    public function testBuildCommandCreatesNeededMediaDirectoriesRecursively()
     {
         $this->directory('_media/foo/bar');
         $this->file('_media/1.png');

From 0909f304fe8da491164cd92d93262b107c6dd6a5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:46:18 +0200
Subject: [PATCH 3138/4023] Skip when there are no media files to transfer

---
 .../Actions/PreBuildTasks/TransferMediaAssets.php   |  4 ++++
 .../tests/Feature/StaticSiteServiceTest.php         | 13 +++++++++++++
 2 files changed, 17 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index e7a3e7bc160..d694e93999a 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -18,6 +18,10 @@ public function handle(): void
     {
         $this->newLine();
 
+        if (MediaFile::all()->isEmpty()) {
+            $this->skip("No media files to transfer.\n");
+        }
+
         $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {
             $sitePath = $file->getOutputPath();
             $this->needsParentDirectory($sitePath);
diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 9172495f20b..580139033ba 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -95,6 +95,19 @@ public function testBuildCommandCreatesNeededMediaDirectoriesRecursively()
         $this->assertFileExists(Hyde::path('_site/media/foo/bar/3.png'));
     }
 
+    public function testBuildCommandSkipsMediaTransferWhenThereAreNoAssets()
+    {
+        rename(Hyde::path('_media/app.css'), Hyde::path('_media/app.css.bak'));
+
+        $this->artisan('build')
+            ->expectsOutputToContain('Transferring Media Assets... ')
+            ->expectsOutputToContain('Skipped')
+            ->expectsOutputToContain('> No media files to transfer.')
+            ->assertExitCode(0);
+
+        rename(Hyde::path('_media/app.css.bak'), Hyde::path('_media/app.css'));
+    }
+
     public function testAllPageTypesCanBeCompiled()
     {
         $this->file('_pages/html.html');

From 1a7785439f1e1e5f5c8eab6627602bacba2023b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 6 Oct 2024 21:53:43 +0200
Subject: [PATCH 3139/4023] Add experimental way to customize the written asset
 contents

See https://github.com/hydephp/develop/pull/1904#issuecomment-2394582406
---
 .../Framework/Actions/PreBuildTasks/TransferMediaAssets.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index d694e93999a..05dda5e7c00 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Actions\PreBuildTasks;
 
+use Hyde\Facades\Filesystem;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
 use Hyde\Framework\Concerns\InteractsWithDirectories;
@@ -25,7 +26,7 @@ public function handle(): void
         $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {
             $sitePath = $file->getOutputPath();
             $this->needsParentDirectory($sitePath);
-            copy($file->getAbsolutePath(), $sitePath);
+            Filesystem::putContents($sitePath, $file->getContents());
         });
 
         $this->newLine();

From c58c7dc06d23095a8f11f0936734dac04017070d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 14:39:57 +0100
Subject: [PATCH 3140/4023] Update default configuration to no longer save
 previewed pages

---
 RELEASE_NOTES.md                                     |  1 +
 config/hyde.php                                      |  2 +-
 docs/extensions/realtime-compiler.md                 |  2 +-
 packages/framework/config/hyde.php                   |  2 +-
 .../realtime-compiler/tests/RealtimeCompilerTest.php | 12 ------------
 5 files changed, 4 insertions(+), 15 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 85b9078ec4e..27de4fcddba 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -51,6 +51,7 @@ This serves two purposes:
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760 and https://github.com/hydephp/develop/pull/1890
 - Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
+- Updated default configuration to no longer save previewed pages in https://github.com/hydephp/develop/pull/1995
 - Added more rich markup data to blog post components in https://github.com/hydephp/develop/pull/1888 (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
 - Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
 - Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
diff --git a/config/hyde.php b/config/hyde.php
index 92163827958..010d9b26b11 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -423,7 +423,7 @@
         'host' => env('SERVER_HOST', 'localhost'),
 
         // Should preview pages be saved to the output directory?
-        'save_preview' => true,
+        'save_preview' => false,
 
         // Should the live edit feature be enabled?
         'live_edit' => env('SERVER_LIVE_EDIT', true),
diff --git a/docs/extensions/realtime-compiler.md b/docs/extensions/realtime-compiler.md
index b20f2fb3928..009e283ef04 100644
--- a/docs/extensions/realtime-compiler.md
+++ b/docs/extensions/realtime-compiler.md
@@ -31,7 +31,7 @@ The server can be configured in the `config/hyde.php` file to change the port, h
 'server' => [
     'port' => env('SERVER_PORT', 8080),
     'host' => env('SERVER_HOST', 'localhost'),
-    'save_preview' => true,
+    'save_preview' => false,
 ],
 ```
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 92163827958..010d9b26b11 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -423,7 +423,7 @@
         'host' => env('SERVER_HOST', 'localhost'),
 
         // Should preview pages be saved to the output directory?
-        'save_preview' => true,
+        'save_preview' => false,
 
         // Should the live edit feature be enabled?
         'live_edit' => env('SERVER_LIVE_EDIT', true),
diff --git a/packages/realtime-compiler/tests/RealtimeCompilerTest.php b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
index c6fcf9d631a..45e78abd550 100644
--- a/packages/realtime-compiler/tests/RealtimeCompilerTest.php
+++ b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
@@ -49,11 +49,6 @@ public function testHandlesRoutesIndexPage()
         $this->assertEquals(200, $response->statusCode);
         $this->assertEquals('OK', $response->statusMessage);
         $this->assertStringContainsString('<title>Welcome to HydePHP!</title>', $response->body);
-
-        $this->assertFileExists(hyde()->path('_site/index.html'));
-        $this->assertEquals($response->body, Filesystem::get('_site/index.html'));
-
-        Filesystem::unlink('_site/index.html');
     }
 
     public function testHandlesRoutesCustomPages()
@@ -71,13 +66,10 @@ public function testHandlesRoutesCustomPages()
         $this->assertStringContainsString('<h1>Hello World!</h1>', $response->body);
 
         Filesystem::unlink('_pages/foo.md');
-        Filesystem::unlink('_site/foo.html');
     }
 
     public function testHandlesRoutesPagesWithHtmlExtension()
     {
-        $this->mockRoute('foo.html');
-
         Filesystem::put('_pages/foo.md', '# Hello World!');
 
         $kernel = new HttpKernel();
@@ -89,7 +81,6 @@ public function testHandlesRoutesPagesWithHtmlExtension()
         $this->assertStringContainsString('<h1>Hello World!</h1>', $response->body);
 
         Filesystem::unlink('_pages/foo.md');
-        Filesystem::unlink('_site/foo.html');
     }
 
     public function testHandlesRoutesStaticAssets()
@@ -144,7 +135,6 @@ public function testTrailingSlashesAreNormalizedFromRoute()
         $this->assertStringContainsString('<h1>Hello World!</h1>', $response->body);
 
         Filesystem::unlink('_pages/foo.md');
-        Filesystem::unlink('_site/foo.html');
     }
 
     public function testDocsUriPathIsReroutedToDocsIndex()
@@ -162,7 +152,6 @@ public function testDocsUriPathIsReroutedToDocsIndex()
         $this->assertStringContainsString('HydePHP Docs', $response->body);
 
         Filesystem::unlink('_docs/index.md');
-        Filesystem::unlink('_site/docs/index.html');
     }
 
     public function testDocsSearchRendersSearchPage()
@@ -179,7 +168,6 @@ public function testDocsSearchRendersSearchPage()
         $this->assertStringContainsString('Search the documentation site', $response->body);
 
         Filesystem::unlink('_docs/index.md');
-        Filesystem::unlink('_site/docs/search.html');
     }
 
     public function testPingRouteReturnsPingResponse()

From 0a8b0a1737b00aed771b509f090b9eb25b678a17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:05:57 +0100
Subject: [PATCH 3141/4023] Proofread and format release notes

---
 RELEASE_NOTES.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 85b9078ec4e..0318b7977a4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -27,8 +27,7 @@ This serves two purposes:
   - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
   - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
   - Added method `Asset::exists()` has to check if a media file exists.
-  - Added a `Hyde::assets()` method to get all media file instancess in the site.
-
+  - Added a `Hyde::assets()` method to get all media file instances in the site.
 
 ### Changed
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
@@ -47,7 +46,7 @@ This serves two purposes:
 - Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
-- Minor: `Includes::path()` and  `Includes::get()` methods now normalizes paths to be basenames to match the behaviour of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
+- Minor: `Includes::path()` and  `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760 and https://github.com/hydephp/develop/pull/1890
 - Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
@@ -68,9 +67,9 @@ This serves two purposes:
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
 - Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
-- **Many MediaFile related helpers has been changed or completely rewritten** to provide a simplified API for interacting with media files.
+- **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.
   - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
-  - The `Asset` facade has been e restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
+  - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
   - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
   - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.
   - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
@@ -81,7 +80,7 @@ This serves two purposes:
 - **MediaFile performance improvements:**
   - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
   - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
-  - We now use the much faster `CRC32` hashing algoritm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
+  - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
 
 ### Deprecated
 - for soon-to-be removed features.
@@ -89,7 +88,7 @@ This serves two purposes:
 ### Removed
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
-- Removed the deprecated global`unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
+- Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569

From bb6e45e4e24d14253d5318f0491930842ce1d6c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:10:10 +0100
Subject: [PATCH 3142/4023] Save preview during test

---
 tests/Browser/HighLevelViewTest.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tests/Browser/HighLevelViewTest.php b/tests/Browser/HighLevelViewTest.php
index 9cfcaf9c155..d9c5e73939c 100644
--- a/tests/Browser/HighLevelViewTest.php
+++ b/tests/Browser/HighLevelViewTest.php
@@ -21,6 +21,13 @@ class HighLevelViewTest extends DuskTestCase
 {
     public $mockConsoleOutput = false;
 
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        config(['hyde.server.save_preview' => true]);
+    }
+
     protected function tearDown(): void
     {
         parent::tearDown();

From a306fb9eb5604315cedaf2bd7fc023d1d525354a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:18:39 +0100
Subject: [PATCH 3143/4023] Revert "Save preview during test"

This reverts commit bb6e45e4e24d14253d5318f0491930842ce1d6c1.
---
 tests/Browser/HighLevelViewTest.php | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/tests/Browser/HighLevelViewTest.php b/tests/Browser/HighLevelViewTest.php
index d9c5e73939c..9cfcaf9c155 100644
--- a/tests/Browser/HighLevelViewTest.php
+++ b/tests/Browser/HighLevelViewTest.php
@@ -21,13 +21,6 @@ class HighLevelViewTest extends DuskTestCase
 {
     public $mockConsoleOutput = false;
 
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        config(['hyde.server.save_preview' => true]);
-    }
-
     protected function tearDown(): void
     {
         parent::tearDown();

From 800b0769ec96401060b2cd32e9573304ea92ccb4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:27:17 +0100
Subject: [PATCH 3144/4023] Add environment variable support for saving
 previews

---
 RELEASE_NOTES.md                     | 1 +
 config/hyde.php                      | 2 +-
 docs/extensions/realtime-compiler.md | 2 +-
 packages/framework/config/hyde.php   | 2 +-
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d0468f9196e..43ff44ee7d8 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -22,6 +22,7 @@ This serves two purposes:
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
 - You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
+- Added environment variable support for saving previews in https://github.com/hydephp/develop/pull/1996
 - Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
 - **Added a new consolidated Asset API to better handle media files.**
   - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
diff --git a/config/hyde.php b/config/hyde.php
index 010d9b26b11..4b4a74ce65e 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -423,7 +423,7 @@
         'host' => env('SERVER_HOST', 'localhost'),
 
         // Should preview pages be saved to the output directory?
-        'save_preview' => false,
+        'save_preview' => env('SERVER_SAVE_PREVIEW', false),
 
         // Should the live edit feature be enabled?
         'live_edit' => env('SERVER_LIVE_EDIT', true),
diff --git a/docs/extensions/realtime-compiler.md b/docs/extensions/realtime-compiler.md
index 009e283ef04..534588803f7 100644
--- a/docs/extensions/realtime-compiler.md
+++ b/docs/extensions/realtime-compiler.md
@@ -31,7 +31,7 @@ The server can be configured in the `config/hyde.php` file to change the port, h
 'server' => [
     'port' => env('SERVER_PORT', 8080),
     'host' => env('SERVER_HOST', 'localhost'),
-    'save_preview' => false,
+    'save_preview' => env('SERVER_SAVE_PREVIEW', false),
 ],
 ```
 
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 010d9b26b11..4b4a74ce65e 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -423,7 +423,7 @@
         'host' => env('SERVER_HOST', 'localhost'),
 
         // Should preview pages be saved to the output directory?
-        'save_preview' => false,
+        'save_preview' => env('SERVER_SAVE_PREVIEW', false),
 
         // Should the live edit feature be enabled?
         'live_edit' => env('SERVER_LIVE_EDIT', true),

From 7a713a403881a5c00adf425a571b7ce2ad73ff7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:28:38 +0100
Subject: [PATCH 3145/4023] Update RealtimeCompilerTest.php

---
 packages/realtime-compiler/tests/RealtimeCompilerTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/realtime-compiler/tests/RealtimeCompilerTest.php b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
index 45e78abd550..8ee16c74409 100644
--- a/packages/realtime-compiler/tests/RealtimeCompilerTest.php
+++ b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
@@ -17,6 +17,7 @@ class RealtimeCompilerTest extends UnitTestCase
     public static function setUpBeforeClass(): void
     {
         putenv('SERVER_LIVE_EDIT=false');
+        putenv('SERVER_SAVE_PREVIEW=true');
 
         define('BASE_PATH', realpath(__DIR__.'/../../../'));
 

From fe8846ba81e80222fb4de19fc1beed37282cb958 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 15:36:49 +0100
Subject: [PATCH 3146/4023] Set environment variable in test

---
 .github/workflows/end-to-end-tests.yml                    | 2 +-
 packages/realtime-compiler/tests/RealtimeCompilerTest.php | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/end-to-end-tests.yml b/.github/workflows/end-to-end-tests.yml
index 057ae4a1e76..2ec8a249556 100644
--- a/.github/workflows/end-to-end-tests.yml
+++ b/.github/workflows/end-to-end-tests.yml
@@ -30,7 +30,7 @@ jobs:
         run: vendor/bin/pest --stop-on-failure
 
       - name: Prepare the Environment
-        run: echo -e "APP_URL=http://localhost:8080 \nDUSK_ENABLED=true\nSERVER_DASHBOARD=false" > .env
+        run: echo -e "APP_URL=http://localhost:8080 \nDUSK_ENABLED=true\nSERVER_DASHBOARD=false\nSERVER_SAVE_PREVIEW=true" > .env
 
       - name: Upgrade Chrome Driver
         run: php hyde dusk:chrome-driver `/opt/google/chrome/chrome --version | cut -d " " -f3 | cut -d "." -f1`
diff --git a/packages/realtime-compiler/tests/RealtimeCompilerTest.php b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
index 8ee16c74409..45e78abd550 100644
--- a/packages/realtime-compiler/tests/RealtimeCompilerTest.php
+++ b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
@@ -17,7 +17,6 @@ class RealtimeCompilerTest extends UnitTestCase
     public static function setUpBeforeClass(): void
     {
         putenv('SERVER_LIVE_EDIT=false');
-        putenv('SERVER_SAVE_PREVIEW=true');
 
         define('BASE_PATH', realpath(__DIR__.'/../../../'));
 

From b691235662bd2476897627ef1e908b2201f73732 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 18:56:46 +0100
Subject: [PATCH 3147/4023] Fix Markdown formatting

---
 RELEASE_NOTES.md | 86 +++++++++++++++++++++++++++---------------------
 1 file changed, 49 insertions(+), 37 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 43ff44ee7d8..8906430b242 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -10,6 +10,7 @@ This serves two purposes:
 2. At release time, you can move the Unreleased section changes into a new release version section.
 
 ### Added
+
 - You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
 - Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
@@ -25,12 +26,13 @@ This serves two purposes:
 - Added environment variable support for saving previews in https://github.com/hydephp/develop/pull/1996
 - Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
 - **Added a new consolidated Asset API to better handle media files.**
-  - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
-  - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
-  - Added method `Asset::exists()` has to check if a media file exists.
-  - Added a `Hyde::assets()` method to get all media file instances in the site.
+    - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
+    - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
+    - Added method `Asset::exists()` has to check if a media file exists.
+    - Added a `Hyde::assets()` method to get all media file instances in the site.
 
 ### Changed
+
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
@@ -47,7 +49,7 @@ This serves two purposes:
 - Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
 - Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
 - Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
-- Minor: `Includes::path()` and  `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
+- Minor: `Includes::path()` and `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
 - Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
 - Minor: Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760 and https://github.com/hydephp/develop/pull/1890
 - Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
@@ -70,24 +72,26 @@ This serves two purposes:
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
 - Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
 - **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.
-  - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
-  - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
-  - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
-  - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.
-  - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
-  - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904
-  - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911
-  - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in https://github.com/hydephp/develop/pull/1911
-  - We will now throw an exception if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in https://github.com/hydephp/develop/pull/1932
+    - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
+    - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
+    - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
+    - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.
+    - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
+    - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904
+    - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911
+    - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in https://github.com/hydephp/develop/pull/1911
+    - We will now throw an exception if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in https://github.com/hydephp/develop/pull/1932
 - **MediaFile performance improvements:**
-  - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
-  - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
-  - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
+    - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
+    - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
+    - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
 
 ### Deprecated
+
 - for soon-to-be removed features.
 
 ### Removed
+
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
@@ -96,17 +100,19 @@ This serves two purposes:
 - Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
 - Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
 - **With the new Asset API, a few features had to be moved/removed:**
-  - `AssetService` class has been removed (was merged into the `Asset` facade) in https://github.com/hydephp/develop/pull/1908
-  - Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907
-  - The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)
-  - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
-  - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
-  - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
+    - `AssetService` class has been removed (was merged into the `Asset` facade) in https://github.com/hydephp/develop/pull/1908
+    - Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907
+    - The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)
+    - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
+    - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
+    - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
 
 ### Fixed
+
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
 
 ### Security
+
 - in case of vulnerabilities.
 
 ### Upgrade Guide
@@ -142,11 +148,11 @@ The easiest way to upgrade is to publish updated configuration files (`hyde.php`
 
 The following configuration entries have been updated:
 
--  Changed configuration option `docs.sidebar_order` to `docs.sidebar.order` in https://github.com/hydephp/develop/pull/1583
--  Upgrade path: Move the `sidebar_order` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
+- Changed configuration option `docs.sidebar_order` to `docs.sidebar.order` in https://github.com/hydephp/develop/pull/1583
+- Upgrade path: Move the `sidebar_order` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
 
--  Changed configuration option `docs.table_of_contents` to `docs.sidebar.table_of_contents` in https://github.com/hydephp/develop/pull/1584
--  Upgrade path: Move the `table_of_contents` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
+- Changed configuration option `docs.table_of_contents` to `docs.sidebar.table_of_contents` in https://github.com/hydephp/develop/pull/1584
+- Upgrade path: Move the `table_of_contents` option's array in the `config/docs.php` file into the `sidebar` array in the same file.
 
 ### Features configuration changes
 
@@ -164,11 +170,11 @@ The `hyde.features` configuration format has changed to use Enums instead of sta
     Features::bladePages(),
     Features::markdownPages(),
     Features::documentationPages(),
-    
+
     // Frontend Features
     Features::darkmode(),
     Features::documentationSearch(),
-    
+
     // Integrations
     Features::torchlight(),
 ],
@@ -221,6 +227,7 @@ Here is the full list of changes:
 #### Upgrade guide:
 
 1. Update your `config/hyde.php` file to use the new author configuration format:
+
    ```php
    'authors' => [
        'username' => Author::create(
@@ -234,14 +241,16 @@ Here is the full list of changes:
    ```
 
 2. Review and update any code that uses the `Author` facade:
-  - The `create()` method now returns an array instead of a `PostAuthor` instance.
-  - The `get()` method may return `null`, so handle this case in your code.
+
+- The `create()` method now returns an array instead of a `PostAuthor` instance.
+- The `get()` method may return `null`, so handle this case in your code.
 
 3. Check your blog post front matter and ensure that `author` fields match the new username keys in your configuration.
 
 4. If you have custom templates that use author data, update them to:
-  - Optional: Feel free to use the new available fields: `bio`, `avatar`, and `socials`.
-  - Account for usernames now being lowercase with underscores which may lead to changed HTML or URL paths.
+
+- Optional: Feel free to use the new available fields: `bio`, `avatar`, and `socials`.
+- Account for usernames now being lowercase with underscores which may lead to changed HTML or URL paths.
 
 5. If you were relying on `Author::get()` to create new authors on the fly, update your code to handle `null` returns or create authors explicitly.
 
@@ -273,6 +282,7 @@ Note that this class was previously marked as internal in v1, but the change is
 ### Asset API Changes
 
 #### Overview
+
 For most end users, the changes to the Asset API in HydePHP 2.x will have minimal direct impact. However, if you have custom code that interacts with media files, you may need to update it.
 
 The most important thing to note is that all asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
@@ -299,6 +309,7 @@ Most changes were made in https://github.com/hydephp/develop/pull/1904 which con
 Once you have determined that you need to update your code, here are the steps you should take:
 
 1. Update calls to renamed methods:
+
    ```php
    // Replace this:                      With this:
    Hyde::mediaLink('image.png')      =>  Hyde::asset('image.png');
@@ -324,11 +335,11 @@ These changes simplify the Asset API and provide more robust handling of media f
 The navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations.
 
 If you have previously in your custom code done any of the following, or similar, you will need to adapt your code to use the new Navigation API:
+
 - Created custom navigation menus or Blade components
 - Extended or called the navigation related classes directly
 - Customized the navigation system in any way beyond the standard configuration
 
-
 #### Upgrade guide
 
 Due to the scope of the rewrite, the easiest and fastest way to upgrade your code is to recreate it using the new Navigation API.
@@ -344,11 +355,11 @@ Some HTML IDs have been renamed to follow a more consistent naming convention.
 If you have used any of the following selectors in custom code you wrote yourself, you will need to update to use the new changed IDs.
 
 #### https://github.com/hydephp/develop/pull/1622
+
 - Rename HTML ID `#searchMenu` to `#search-menu`
 - Rename HTML ID `#searchMenuButton` to `#search-menu-button`
 - Rename HTML ID `#searchMenuButtonMobile` to `#search-menu-button-mobile`
 
-
 ### New documentation search implementation
 
 As the new documentation search implementation brings changes to their code API you may need to adapt your code
@@ -397,6 +408,7 @@ The RFC was implemented in https://github.com/hydephp/develop/pull/1738
 #### Remember to escape output if necessary
 
 **Note:** Remember that this means that includes are **no longer escaped** by default, so make sure to escape the output if necessary, for example if the content is user-generated.
+
 - (Use `{{ e(Includes::html('foo')) }}` instead of `{{ Includes::html('foo') }}` to escape the output, matching the previous behavior.)
 
 ### DataCollection API changes
@@ -417,11 +429,11 @@ Unfortunately, this means that existing setups may need to be adjusted to work w
 #### Issues that may arise
 
 If you start getting a `ParseException` when using the `DataCollection` class, it may be due to malformed data collection files.
-Starting from this version, we validate the syntax of JSON and YAML in data files during discovery, including any front matter in Markdown data files. 
+Starting from this version, we validate the syntax of JSON and YAML in data files during discovery, including any front matter in Markdown data files.
 We do this to help you catch errors early. See https://github.com/hydephp/develop/issues/1736 for more information.
 
 For example, an empty or malformed JSON file will now throw an exception like this:
- 
+
 ```php
 \Hyde\Framework\Exceptions\ParseException: Invalid JSON in file: 'foo/baz.json' (Syntax error)
 ```

From fbf98ec62981c8a2732ee2d1268f3f9e5ba153ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:09:31 +0100
Subject: [PATCH 3148/4023] Remove documentation for global numerical page
 ordering

---
 docs/digging-deeper/navigation.md | 39 -------------------------------
 1 file changed, 39 deletions(-)

diff --git a/docs/digging-deeper/navigation.md b/docs/digging-deeper/navigation.md
index ffef925624d..c378b081b85 100644
--- a/docs/digging-deeper/navigation.md
+++ b/docs/digging-deeper/navigation.md
@@ -236,45 +236,6 @@ Now if you create a page called `_pages/about/contact.md`, it will automatically
 - Dropdowns take priority over standard items. If you have a dropdown with the key `about` and a page with the key `about`, the dropdown will be created, and the page won't be in the menu.
 - Example: With this file structure: `_pages/foo.md`, `_pages/foo/bar.md`, `_pages/foo/baz.md`, the link to `foo` will be lost, so please keep this in mind when using this feature.
 
-## Numerical Prefix Navigation Ordering
-
-HydePHP v2 introduces navigation item ordering based on numerical prefixes in filenames. This feature works for the primary navigation menu.
-
-This has the great benefit of matching the navigation menu layout with the file structure view. It also works especially well with subdirectory-based navigation grouping.
-
-```shell
-_pages/
-  01-home.md     # Priority: 1 (saved to _site/index.html)
-  02-about.md    # Priority: 2 (saved to _site/about.html)
-  03-contact.md  # Priority: 3 (saved to _site/contact.html)
-```
-
-As you can see, Hyde parses the number from the filename and uses it as the priority for the page in navigation menus, while stripping the prefix from the route key.
-
-### Important Notes
-
-1. The numerical prefix remains part of the page identifier but is stripped from the route key.
-   For example: `_pages/01-home.md` has route key `home` and page identifier `01-home`.
-2. You can delimit the numerical prefix with either a dash or an underscore.
-   For example: Both `_pages/01-home.md` and `_pages/01_home.md` are valid.
-3. Leading zeros are optional. `_pages/1-home.md` is equally valid.
-
-### Using Numerical Prefix Ordering in Subdirectories
-
-This feature integrates well with automatic subdirectory-based navigation grouping. Here are two useful tips:
-
-1. You can use numerical prefixes in subdirectories to control the dropdown order.
-2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
-
-### Customization
-
-If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
-
-```php
-// filepath: config/hyde.php
-'numerical_page_ordering' => false,
-```
-
 ## Digging Deeper Into the Internals
 
 While not essential, understanding the internal workings of the navigation system can be as beneficial as it's interesting. Here's a quick high-level overview of the [Navigation API](navigation-api).

From b59219f8da0324ccdf25c84051e1146141b4be03 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:12:48 +0100
Subject: [PATCH 3149/4023] Remove tests for global numerical page ordering

---
 .../NumericalPageOrderingHelperTest.php       | 60 -------------------
 1 file changed, 60 deletions(-)

diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index 82137389905..7324a1ecf7b 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -111,66 +111,6 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
         $this->assertSame("$identifier.html", $page->getOutputPath());
     }
 
-    public function testFlatMainNavigationOrdering()
-    {
-        $this->setupFixture([
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-        ]);
-
-        $this->assertOrder(['home', 'about', 'contact']);
-    }
-
-    public function testReverseOrderOfFlatMainNavigation()
-    {
-        // This is just a sanity check to make sure the helper is working, so we only need one of these.
-        $this->setupFixture(array_reverse([
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-        ]));
-
-        $this->assertOrder(['home', 'about', 'contact']);
-    }
-
-    public function testGroupedMainNavigationOrdering()
-    {
-        $this->setupFixture([
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-            '04-api' => [
-                '01-readme.md',
-                '02-installation.md',
-                '03-getting-started.md',
-            ],
-        ]);
-
-        $this->assertOrder(['home', 'about', 'contact', 'api' => [
-            'readme', 'installation', 'getting-started',
-        ]]);
-    }
-
-    public function testReverseOrderOfGroupedMainNavigation()
-    {
-        // Also a sanity check but for the inner group as well.
-        $this->setupFixture($this->arrayReverseRecursive([
-            '01-home.md',
-            '02-about.md',
-            '03-contact.md',
-            '04-api' => [
-                '01-readme.md',
-                '02-installation.md',
-                '03-getting-started.md',
-            ],
-        ]));
-
-        $this->assertOrder(['home', 'about', 'contact', 'api' => [
-            'readme', 'installation', 'getting-started',
-        ]]);
-    }
-
     public function testFlatSidebarNavigationOrdering()
     {
         $this->setUpSidebarFixture([

From fad8c8424fd39ee204ca2e4d836198584a0c3ef1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:10:04 +0100
Subject: [PATCH 3150/4023] Only check documentation file prefixes for orders

---
 .../src/Framework/Factories/NavigationDataFactory.php         | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index 61526679f33..cd1698bce35 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -245,6 +245,10 @@ private function parseNavigationPriorityConfig(array $config, string $pageKeyNam
 
     private function checkFilePrefixForOrder(): ?int
     {
+        if (! $this->isInstanceOf(DocumentationPage::class)) {
+            return null;
+        }
+
         if (! NumericalPageOrderingHelper::enabled()) {
             return null;
         }

From 0aee9a9041e86491c54d08dd1fc7d99370e72dd0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:15:00 +0100
Subject: [PATCH 3151/4023] Test on documentation page classes only

---
 .../Unit/NavigationDataFactoryUnitTest.php    | 40 +++++++++----------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index f60404da717..e6bcb18c3f8 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -269,7 +269,7 @@ public function testMakeGroupDefaultsToNullIfFrontMatterGroupNotSetAndSubdirecto
 
     public function testItExtractsPriorityFromNumericalFilenamePrefix()
     {
-        $coreDataObject = $this->makeCoreDataObject('01-test.md');
+        $coreDataObject = $this->makeCoreDataObject('01-test.md', pageClass: DocumentationPage::class);
         $factory = new NavigationConfigTestClass($coreDataObject);
 
         $this->assertSame(1, $factory->makePriority());
@@ -277,47 +277,47 @@ public function testItExtractsPriorityFromNumericalFilenamePrefix()
 
     public function testItExtractsPriorityFromNumericalFilenamePrefixWithKebabCaseSyntax()
     {
-        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01-foo.md')))->makePriority());
-        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02-bar.md')))->makePriority());
-        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03-baz.md')))->makePriority());
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01-foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02-bar.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03-baz.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testItExtractsPriorityFromNumericalFilenamePrefixWithSnakeCaseSyntax()
     {
-        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01_foo.md')))->makePriority());
-        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02_bar.md')))->makePriority());
-        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03_baz.md')))->makePriority());
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('01_foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('02_bar.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('03_baz.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testItExtractsPriorityFromNumericalFilenamePrefixRegardlessOfLeadingZeroes()
     {
-        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('123-foo.md')))->makePriority());
-        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0123-foo.md')))->makePriority());
-        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('00123-foo.md')))->makePriority());
-        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('000123-foo.md')))->makePriority());
-        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0000123-foo.md')))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('123-foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0123-foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('00123-foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('000123-foo.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(123, (new NavigationConfigTestClass($this->makeCoreDataObject('0000123-foo.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testItExtractsPriorityFromNumericalFilenamePrefixForNestedIdentifiers()
     {
-        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar.md')))->makePriority());
-        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/bar/02-baz.md')))->makePriority());
-        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar/03-baz.md')))->makePriority());
+        $this->assertSame(1, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(2, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/bar/02-baz.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar/03-baz.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()
     {
         self::mockConfig(['hyde.numerical_page_ordering' => false]);
 
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-test.md')))->makePriority());
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-home.md')))->makePriority());
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-404.md')))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-test.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-home.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-404.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('foo-bar.md')))->makePriority());
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('abc-bar.md')))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('foo-bar.md', pageClass: DocumentationPage::class)))->makePriority());
+        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('abc-bar.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
     public function testFrontMatterValueOverridesFilenamePrefixPriority()

From 0867ea73ca52ff55b43aca8364de013449a38361 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:35:27 +0100
Subject: [PATCH 3152/4023] Only split numerical prefixes from identifiers for
 documentation pages

---
 .../framework/src/Support/Models/RouteKey.php |  5 +-
 .../NumericalPageOrderingHelperTest.php       | 71 +++++++++----------
 .../framework/tests/Unit/RouteKeyTest.php     | 40 +++++------
 3 files changed, 58 insertions(+), 58 deletions(-)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 644d83432c9..59fced81cbc 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -5,6 +5,7 @@
 namespace Hyde\Support\Models;
 
 use Stringable;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
 
 use function Hyde\unslash;
@@ -48,7 +49,9 @@ public function get(): string
     /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     public static function fromPage(string $pageClass, string $identifier): self
     {
-        $identifier = self::splitNumberedIdentifiersIfNeeded($identifier);
+        if (is_a($pageClass, DocumentationPage::class, true)) {
+            $identifier = self::splitNumberedIdentifiersIfNeeded($identifier);
+        }
 
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }
diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index 7324a1ecf7b..a9c4ce98874 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -8,22 +8,19 @@
 use Hyde\Facades\Config;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Str;
-use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Framework\Features\Navigation\NavigationItem;
 use Hyde\Framework\Features\Navigation\NavigationGroup;
-use Hyde\Framework\Features\Navigation\MainNavigationMenu;
 use Hyde\Framework\Features\Navigation\DocumentationSidebar;
 use Hyde\Framework\Features\Navigation\NavigationMenuGenerator;
 
 /**
- * High level test for the feature that allows navigation items to be sorted by filename prefix.
+ * High level test for the feature that allows sidebar items to be sorted by filename prefix.
  *
  * The feature can be disabled in the config. It also works within sidebar groups,
  * so that multiple groups can have the same prefix independent of other groups.
  *
  * @covers \Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper
- * @covers \Hyde\Framework\Features\Navigation\MainNavigationMenu
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
  * @covers \Hyde\Framework\Factories\NavigationDataFactory
  * @covers \Hyde\Support\Models\RouteKey
@@ -51,18 +48,18 @@ protected function tearDown(): void
         parent::tearDown();
     }
 
-    public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
+    public function testDocumentationPageSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
     {
-        $this->file('_pages/01-home.md');
+        $this->file('_docs/01-readme.md');
 
-        $identifier = '01-home';
+        $identifier = '01-readme';
 
         // Assert it is discovered.
-        $discovered = MarkdownPage::get($identifier);
+        $discovered = DocumentationPage::get($identifier);
         $this->assertNotNull($discovered, 'The page was not discovered.');
 
         // Assert it is parsable
-        $parsed = MarkdownPage::parse($identifier);
+        $parsed = DocumentationPage::parse($identifier);
         $this->assertNotNull($parsed, 'The page was not parsable.');
 
         // Sanity check
@@ -74,26 +71,26 @@ public function testSourceFilesHaveTheirNumericalPrefixTrimmedFromRouteKeys()
         $this->assertSame($identifier, $page->getIdentifier());
 
         // Assert the route key is trimmed.
-        $this->assertSame('home', $page->getRouteKey());
+        $this->assertSame('docs/readme', $page->getRouteKey());
 
         // Assert route key dependents are trimmed.
-        $this->assertSame('home.html', $page->getOutputPath());
+        $this->assertSame('docs/readme.html', $page->getOutputPath());
     }
 
     public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeysWhenFeatureIsDisabled()
     {
         Config::set('hyde.numerical_page_ordering', false);
 
-        $this->file('_pages/01-home.md');
+        $this->file('_docs/01-readme.md');
 
-        $identifier = '01-home';
+        $identifier = '01-readme';
 
         // Assert it is discovered.
-        $discovered = MarkdownPage::get($identifier);
+        $discovered = DocumentationPage::get($identifier);
         $this->assertNotNull($discovered, 'The page was not discovered.');
 
         // Assert it is parsable
-        $parsed = MarkdownPage::parse($identifier);
+        $parsed = DocumentationPage::parse($identifier);
         $this->assertNotNull($parsed, 'The page was not parsable.');
 
         // Sanity check
@@ -104,11 +101,11 @@ public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeys
         // Assert identifier is the same.
         $this->assertSame($identifier, $page->getIdentifier());
 
-        // Assert the route key is trimmed.
-        $this->assertSame($identifier, $page->getRouteKey());
+        // Assert the route key is not trimmed.
+        $this->assertSame('docs/'.$identifier, $page->getRouteKey());
 
         // Assert route key dependents are trimmed.
-        $this->assertSame("$identifier.html", $page->getOutputPath());
+        $this->assertSame("docs/$identifier.html", $page->getOutputPath());
     }
 
     public function testFlatSidebarNavigationOrdering()
@@ -219,24 +216,24 @@ public function testSidebarGroupPrioritiesCanBeSetWithNumericalPrefixWithoutFlat
 
     protected function setUpSidebarFixture(array $files): self
     {
-        return $this->setupFixture($files, sidebar: true);
+        return $this->setupFixture($files);
     }
 
-    protected function setupFixture(array $files, bool $sidebar = false): self
+    protected function setupFixture(array $files): self
     {
-        $this->helper->setupFixture($files, $sidebar);
+        $this->helper->setupFixture($files);
 
         return $this;
     }
 
     protected function assertSidebarOrder(array $expected): void
     {
-        $this->assertOrder($expected, sidebar: true);
+        $this->assertOrder($expected);
     }
 
-    protected function assertOrder(array $expected, bool $sidebar = false): void
+    protected function assertOrder(array $expected): void
     {
-        $actual = $this->helper->createComparisonFormat($sidebar);
+        $actual = $this->helper->createComparisonFormat();
 
         $this->assertSame($expected, $actual);
     }
@@ -264,10 +261,10 @@ public function __construct(NumericalPageOrderingHelperTest $test)
         $this->test = $test;
     }
 
-    public function setupFixture(array $files, bool $sidebar = false): void
+    public function setupFixture(array $files): void
     {
         foreach ($files as $key => $file) {
-            $class = $sidebar ? DocumentationPage::class : MarkdownPage::class;
+            $class = DocumentationPage::class;
 
             is_string($file)
                 ? $this->setupFixtureItem($class, $file)
@@ -297,30 +294,30 @@ protected function generateMarkdown(string $file): string
         return sprintf("# %s\n\nHello, world!\n", str($file)->after('-')->before('.')->ucfirst());
     }
 
-    public function createComparisonFormat(bool $sidebar): array
+    public function createComparisonFormat(): array
     {
-        $type = $sidebar ? DocumentationSidebar::class : MainNavigationMenu::class;
+        $type = DocumentationSidebar::class;
         $menu = NavigationMenuGenerator::handle($type);
 
-        return $this->mapItemsToStrings($menu, $sidebar)->all();
+        return $this->mapItemsToStrings($menu)->all();
     }
 
-    protected function mapItemsToStrings(MainNavigationMenu|DocumentationSidebar $menu, bool $sidebar)
+    protected function mapItemsToStrings(DocumentationSidebar $menu)
     {
         return $menu->getItems()->mapWithKeys(fn ($item, $key) => $item instanceof NavigationItem
-            ? [$key => $this->formatRouteKey($item->getPage()->getRouteKey(), $sidebar)]
-            : [$item->getGroupKey() => $this->mapChildItems($item, $sidebar)]);
+            ? [$key => $this->formatRouteKey($item->getPage()->getRouteKey())]
+            : [$item->getGroupKey() => $this->mapChildItems($item)]);
     }
 
-    protected function mapChildItems(NavigationGroup $item, bool $sidebar)
+    protected function mapChildItems(NavigationGroup $item)
     {
-        return $item->getItems()->map(function (NavigationItem $item) use ($sidebar) {
-            return basename($this->formatRouteKey($item->getPage()->getRouteKey(), $sidebar));
+        return $item->getItems()->map(function (NavigationItem $item) {
+            return basename($this->formatRouteKey($item->getPage()->getRouteKey()));
         })->all();
     }
 
-    protected function formatRouteKey(string $routeKey, bool $sidebar): string
+    protected function formatRouteKey(string $routeKey): string
     {
-        return $sidebar ? Str::after($routeKey, 'docs/') : $routeKey;
+        return Str::after($routeKey, 'docs/');
     }
 }
diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index 6fe51cc403c..9f16941fdf8 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -99,51 +99,51 @@ public function testFromPageWithCustomNestedOutputDirectory()
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefix()
     {
-        $this->assertSame('test', RouteKey::fromPage(MarkdownPage::class, '01-test')->get());
+        $this->assertSame('docs/test', RouteKey::fromPage(DocumentationPage::class, '01-test')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithKebabCaseSyntax()
     {
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '01-foo')->get());
-        $this->assertSame('bar', RouteKey::fromPage(MarkdownPage::class, '02-bar')->get());
-        $this->assertSame('baz', RouteKey::fromPage(MarkdownPage::class, '03-baz')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '01-foo')->get());
+        $this->assertSame('docs/bar', RouteKey::fromPage(DocumentationPage::class, '02-bar')->get());
+        $this->assertSame('docs/baz', RouteKey::fromPage(DocumentationPage::class, '03-baz')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixWithSnakeCaseSyntax()
     {
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '01_foo')->get());
-        $this->assertSame('bar', RouteKey::fromPage(MarkdownPage::class, '02_bar')->get());
-        $this->assertSame('baz', RouteKey::fromPage(MarkdownPage::class, '03_baz')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '01_foo')->get());
+        $this->assertSame('docs/bar', RouteKey::fromPage(DocumentationPage::class, '02_bar')->get());
+        $this->assertSame('docs/baz', RouteKey::fromPage(DocumentationPage::class, '03_baz')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixRegardlessOfLeadingZeroes()
     {
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '0123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '00123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '000123-foo')->get());
-        $this->assertSame('foo', RouteKey::fromPage(MarkdownPage::class, '0000123-foo')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '123-foo')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '0123-foo')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '00123-foo')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '000123-foo')->get());
+        $this->assertSame('docs/foo', RouteKey::fromPage(DocumentationPage::class, '0000123-foo')->get());
     }
 
     public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixForNestedIdentifiers()
     {
-        $this->assertSame('foo/bar', RouteKey::fromPage(MarkdownPage::class, 'foo/01-bar')->get());
-        $this->assertSame('foo/bar/baz', RouteKey::fromPage(MarkdownPage::class, 'foo/bar/02-baz')->get());
-        $this->assertSame('foo/bar/baz', RouteKey::fromPage(MarkdownPage::class, 'foo/01-bar/03-baz')->get());
+        $this->assertSame('docs/foo/bar', RouteKey::fromPage(DocumentationPage::class, 'foo/01-bar')->get());
+        $this->assertSame('docs/foo/bar/baz', RouteKey::fromPage(DocumentationPage::class, 'foo/bar/02-baz')->get());
+        $this->assertSame('docs/foo/bar/baz', RouteKey::fromPage(DocumentationPage::class, 'foo/01-bar/03-baz')->get());
     }
 
     public function testItDoesNotExtractCoreIdentifierPartFromNumericalFilenamePrefixWhenFeatureIsDisabled()
     {
         self::mockConfig(['hyde.numerical_page_ordering' => false]);
 
-        $this->assertSame('01-test', RouteKey::fromPage(MarkdownPage::class, '01-test')->get());
-        $this->assertSame('01-home', RouteKey::fromPage(MarkdownPage::class, '01-home')->get());
-        $this->assertSame('01-404', RouteKey::fromPage(MarkdownPage::class, '01-404')->get());
+        $this->assertSame('docs/01-test', RouteKey::fromPage(DocumentationPage::class, '01-test')->get());
+        $this->assertSame('docs/01-home', RouteKey::fromPage(DocumentationPage::class, '01-home')->get());
+        $this->assertSame('docs/01-404', RouteKey::fromPage(DocumentationPage::class, '01-404')->get());
     }
 
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
-        $this->assertSame('foo-bar', RouteKey::fromPage(MarkdownPage::class, 'foo-bar')->get());
-        $this->assertSame('abc-bar', RouteKey::fromPage(MarkdownPage::class, 'abc-bar')->get());
+        $this->assertSame('docs/foo-bar', RouteKey::fromPage(DocumentationPage::class, 'foo-bar')->get());
+        $this->assertSame('docs/abc-bar', RouteKey::fromPage(DocumentationPage::class, 'abc-bar')->get());
     }
 }

From 7a12b81ce9ce3820ec2713df74bc09ac1909d640 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:53:36 +0100
Subject: [PATCH 3153/4023] Remove the numerical page ordering config option

See https://github.com/hydephp/develop/issues/1997#issuecomment-2457849286
---
 docs/creating-content/documentation-pages.md  |  9 -----
 .../Factories/NavigationDataFactory.php       |  4 ---
 .../NumericalPageOrderingHelper.php           |  7 ----
 .../framework/src/Support/Models/RouteKey.php |  2 +-
 .../NumericalPageOrderingHelperTest.php       | 34 +------------------
 .../Feature/Services/SitemapServiceTest.php   |  3 --
 .../Unit/NavigationDataFactoryUnitTest.php    |  9 -----
 .../NumericalPageOrderingHelperUnitTest.php   | 19 -----------
 .../framework/tests/Unit/RouteKeyTest.php     |  9 -----
 9 files changed, 2 insertions(+), 94 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 2238f6777d9..a79d11889f2 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -320,15 +320,6 @@ Here are two useful tips:
 1. You can use numerical prefixes in subdirectories to control the sidebar group order.
 2. The numbering within a subdirectory works independently of its siblings, so you can start from one in each subdirectory.
 
-#### Customization
-
-If you're not interested in using numerical prefix ordering, you can disable it in the Hyde config file. Hyde will then no longer extract the priority and will no longer strip the prefix from the route key.
-
-```php
-// filepath: config/hyde.php
-'numerical_page_ordering' => false,
-```
-
 ### Table of Contents Settings
 
 Hyde automatically generates a table of contents for the page and adds it to the sidebar.
diff --git a/packages/framework/src/Framework/Factories/NavigationDataFactory.php b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
index cd1698bce35..564fa383926 100644
--- a/packages/framework/src/Framework/Factories/NavigationDataFactory.php
+++ b/packages/framework/src/Framework/Factories/NavigationDataFactory.php
@@ -249,10 +249,6 @@ private function checkFilePrefixForOrder(): ?int
             return null;
         }
 
-        if (! NumericalPageOrderingHelper::enabled()) {
-            return null;
-        }
-
         if (! NumericalPageOrderingHelper::hasNumericalPrefix($this->identifier)) {
             return null;
         }
diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index 658c779b74f..c5969e482f7 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Features\Navigation;
 
-use Hyde\Facades\Config;
 use Illuminate\Support\Str;
 
 use function ltrim;
@@ -24,12 +23,6 @@ class NumericalPageOrderingHelper
     /** @var array<string> The delimiters that are used to separate the numerical prefix from the rest of the identifier. */
     protected const DELIMITERS = ['-', '_'];
 
-    /** Check if the feature is enabled. */
-    public static function enabled(): bool
-    {
-        return Config::getBool('hyde.numerical_page_ordering', true);
-    }
-
     /** Determines if a given identifier has a numerical prefix. */
     public static function hasNumericalPrefix(string $identifier): bool
     {
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 59fced81cbc..711a53a4869 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -59,7 +59,7 @@ public static function fromPage(string $pageClass, string $identifier): self
     /** @experimental */
     protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
     {
-        if (NumericalPageOrderingHelper::enabled() && NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
+        if (NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
             return NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
         }
 
diff --git a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
index a9c4ce98874..9e344bb26bd 100644
--- a/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
+++ b/packages/framework/tests/Feature/NumericalPageOrderingHelperTest.php
@@ -17,8 +17,7 @@
 /**
  * High level test for the feature that allows sidebar items to be sorted by filename prefix.
  *
- * The feature can be disabled in the config. It also works within sidebar groups,
- * so that multiple groups can have the same prefix independent of other groups.
+ * It also works within sidebar groups, so that multiple groups can have the same prefix independent of other groups.
  *
  * @covers \Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper
  * @covers \Hyde\Framework\Features\Navigation\DocumentationSidebar
@@ -77,37 +76,6 @@ public function testDocumentationPageSourceFilesHaveTheirNumericalPrefixTrimmedF
         $this->assertSame('docs/readme.html', $page->getOutputPath());
     }
 
-    public function testSourceFilesDoNotHaveTheirNumericalPrefixTrimmedFromRouteKeysWhenFeatureIsDisabled()
-    {
-        Config::set('hyde.numerical_page_ordering', false);
-
-        $this->file('_docs/01-readme.md');
-
-        $identifier = '01-readme';
-
-        // Assert it is discovered.
-        $discovered = DocumentationPage::get($identifier);
-        $this->assertNotNull($discovered, 'The page was not discovered.');
-
-        // Assert it is parsable
-        $parsed = DocumentationPage::parse($identifier);
-        $this->assertNotNull($parsed, 'The page was not parsable.');
-
-        // Sanity check
-        $this->assertEquals($discovered, $parsed);
-
-        $page = $discovered;
-
-        // Assert identifier is the same.
-        $this->assertSame($identifier, $page->getIdentifier());
-
-        // Assert the route key is not trimmed.
-        $this->assertSame('docs/'.$identifier, $page->getRouteKey());
-
-        // Assert route key dependents are trimmed.
-        $this->assertSame("docs/$identifier.html", $page->getOutputPath());
-    }
-
     public function testFlatSidebarNavigationOrdering()
     {
         $this->setUpSidebarFixture([
diff --git a/packages/framework/tests/Feature/Services/SitemapServiceTest.php b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
index 80bd0556098..c19d8a0055a 100644
--- a/packages/framework/tests/Feature/Services/SitemapServiceTest.php
+++ b/packages/framework/tests/Feature/Services/SitemapServiceTest.php
@@ -7,7 +7,6 @@
 namespace Hyde\Framework\Testing\Feature\Services;
 
 use SimpleXMLElement;
-use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Hyde\Framework\Features\XmlGenerators\SitemapGenerator;
 use Hyde\Hyde;
@@ -29,8 +28,6 @@ protected function setUp(): void
 
         copy(Hyde::vendorPath('resources/views/homepages/welcome.blade.php'), Hyde::path('_pages/index.blade.php'));
         copy(Hyde::vendorPath('resources/views/pages/404.blade.php'), Hyde::path('_pages/404.blade.php'));
-
-        Config::set(['hyde.numerical_page_ordering' => false]);
     }
 
     public function testServiceInstantiatesXmlElement()
diff --git a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
index e6bcb18c3f8..f6ffc8e32a3 100644
--- a/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
+++ b/packages/framework/tests/Unit/NavigationDataFactoryUnitTest.php
@@ -305,15 +305,6 @@ public function testItExtractsPriorityFromNumericalFilenamePrefixForNestedIdenti
         $this->assertSame(3, (new NavigationConfigTestClass($this->makeCoreDataObject('foo/01-bar/03-baz.md', pageClass: DocumentationPage::class)))->makePriority());
     }
 
-    public function testItDoesNotExtractPriorityFromNumericalFilenamePrefixWhenFeatureIsDisabled()
-    {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
-
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-test.md', pageClass: DocumentationPage::class)))->makePriority());
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-home.md', pageClass: DocumentationPage::class)))->makePriority());
-        $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('01-404.md', pageClass: DocumentationPage::class)))->makePriority());
-    }
-
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
         $this->assertSame(999, (new NavigationConfigTestClass($this->makeCoreDataObject('foo-bar.md', pageClass: DocumentationPage::class)))->makePriority());
diff --git a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
index e9aedb62394..b9fb20738cb 100644
--- a/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
+++ b/packages/framework/tests/Unit/NumericalPageOrderingHelperUnitTest.php
@@ -17,25 +17,6 @@ class NumericalPageOrderingHelperUnitTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
 
-    public function testEnabledReturnsTrueWhenEnabled()
-    {
-        $this->assertTrue(NumericalPageOrderingHelper::enabled());
-    }
-
-    public function testFeatureIsEnabledByDefault()
-    {
-        self::mockConfig(['hyde' => []]);
-
-        $this->assertTrue(NumericalPageOrderingHelper::enabled());
-    }
-
-    public function testEnabledReturnsFalseWhenDisabled()
-    {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
-
-        $this->assertFalse(NumericalPageOrderingHelper::enabled());
-    }
-
     public function testIdentifiersWithNumericalPrefixesAreDetected()
     {
         $this->assertTrue(NumericalPageOrderingHelper::hasNumericalPrefix('01-home.md'));
diff --git a/packages/framework/tests/Unit/RouteKeyTest.php b/packages/framework/tests/Unit/RouteKeyTest.php
index 9f16941fdf8..7a0c107f48b 100644
--- a/packages/framework/tests/Unit/RouteKeyTest.php
+++ b/packages/framework/tests/Unit/RouteKeyTest.php
@@ -132,15 +132,6 @@ public function testItExtractsCoreIdentifierPartFromNumericalFilenamePrefixForNe
         $this->assertSame('docs/foo/bar/baz', RouteKey::fromPage(DocumentationPage::class, 'foo/01-bar/03-baz')->get());
     }
 
-    public function testItDoesNotExtractCoreIdentifierPartFromNumericalFilenamePrefixWhenFeatureIsDisabled()
-    {
-        self::mockConfig(['hyde.numerical_page_ordering' => false]);
-
-        $this->assertSame('docs/01-test', RouteKey::fromPage(DocumentationPage::class, '01-test')->get());
-        $this->assertSame('docs/01-home', RouteKey::fromPage(DocumentationPage::class, '01-home')->get());
-        $this->assertSame('docs/01-404', RouteKey::fromPage(DocumentationPage::class, '01-404')->get());
-    }
-
     public function testItDoesNotExtractNonNumericalFilenamePrefixes()
     {
         $this->assertSame('docs/foo-bar', RouteKey::fromPage(DocumentationPage::class, 'foo-bar')->get());

From cd3547ec484289d1aaa12d89147f9407b58093f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:56:31 +0100
Subject: [PATCH 3154/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 8906430b242..efaa0ddb97e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,7 +11,7 @@ This serves two purposes:
 
 ### Added
 
-- You can now specify navigation priorities by adding a numeric prefix to the source file names in https://github.com/hydephp/develop/pull/1709
+- You can now specify sidebar item priorities by adding a numeric prefix to doc umentation page source file names in https://github.com/hydephp/develop/pull/1709
 - Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
 - Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732

From f1371b7fc4b6fe83eff1be6f5a2ea137088d0456 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 19:59:27 +0100
Subject: [PATCH 3155/4023] Clarify reduced scope

---
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index c5969e482f7..f3b363238c9 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -15,7 +15,7 @@
 use function preg_match;
 
 /**
- * @internal This class contains shared helper code for the framework to provide numerical page ordering.
+ * @internal This class contains shared helper code for the framework to provide numerical page ordering for documentation sidebars.
  *           It is not intended to be used outside the framework code internals.
  */
 class NumericalPageOrderingHelper

From ffb78df2d614b168e8f13abd8694d1800d4dbdaf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:19:40 +0100
Subject: [PATCH 3156/4023] Create DatePrefixHelper.php

---
 .../Features/Blogging/DatePrefixHelper.php    | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
new file mode 100644
index 00000000000..c60337fd12f
--- /dev/null
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Features\Blogging;
+
+use DateTime;
+use DateTimeInterface;
+use Hyde\Support\Models\DateString;
+
+/**
+ * @internal Helper class for handling date prefixes in blog post filenames
+ */
+class DatePrefixHelper
+{
+    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
+    
+    public static function hasDatePrefix(string $identifier): bool
+    {
+        return preg_match(static::DATE_PATTERN, $identifier) === 1;
+    }
+    
+    public static function extractDate(string $identifier): ?DateTimeInterface
+    {
+        if (! preg_match(static::DATE_PATTERN, $identifier, $matches)) {
+            return null;
+        }
+        
+        $dateString = $matches[1];
+        if (isset($matches[2])) {
+            $dateString .= ' ' . str_replace('-', ':', $matches[2]);
+        }
+        
+        return new DateTime($dateString);
+    }
+    
+    public static function stripDatePrefix(string $identifier): string
+    {
+        return preg_replace(static::DATE_PATTERN, '', $identifier);
+    }
+    
+    public static function createDateString(DateTimeInterface $date): DateString
+    {
+        return new DateString($date->format('Y-m-d H:i'));
+    }
+}

From 91a8a0a1c649a9c774edab9e5ef1b3d97f3d2b49 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:19:42 +0100
Subject: [PATCH 3157/4023] Create BlogPostDatePrefixTest.php

---
 .../Features/Blogging/DatePrefixHelper.php    | 12 ++--
 .../tests/Feature/BlogPostDatePrefixTest.php  | 57 +++++++++++++++++++
 2 files changed, 63 insertions(+), 6 deletions(-)
 create mode 100644 packages/framework/tests/Feature/BlogPostDatePrefixTest.php

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index c60337fd12f..fa7e2fb6444 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -14,31 +14,31 @@
 class DatePrefixHelper
 {
     protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
-    
+
     public static function hasDatePrefix(string $identifier): bool
     {
         return preg_match(static::DATE_PATTERN, $identifier) === 1;
     }
-    
+
     public static function extractDate(string $identifier): ?DateTimeInterface
     {
         if (! preg_match(static::DATE_PATTERN, $identifier, $matches)) {
             return null;
         }
-        
+
         $dateString = $matches[1];
         if (isset($matches[2])) {
             $dateString .= ' ' . str_replace('-', ':', $matches[2]);
         }
-        
+
         return new DateTime($dateString);
     }
-    
+
     public static function stripDatePrefix(string $identifier): string
     {
         return preg_replace(static::DATE_PATTERN, '', $identifier);
     }
-    
+
     public static function createDateString(DateTimeInterface $date): DateString
     {
         return new DateString($date->format('Y-m-d H:i'));
diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
new file mode 100644
index 00000000000..7b61d36b4f6
--- /dev/null
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Framework\Features\Blogging\DatePrefixHelper;
+use Hyde\Pages\MarkdownPost;
+use Hyde\Testing\TestCase;
+
+class BlogPostDatePrefixTest extends TestCase
+{
+    public function testCanDetectDatePrefix()
+    {
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post'));
+    }
+
+    public function testCanExtractDateFromPrefix()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-my-post');
+        $this->assertNotNull($date);
+        $this->assertEquals('2024-11-05', $date->format('Y-m-d'));
+
+        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post');
+        $this->assertNotNull($date);
+        $this->assertEquals('2024-11-05 10:30', $date->format('Y-m-d H:i'));
+    }
+
+    public function testDatePrefixIsStrippedFromRouteKey()
+    {
+        $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
+        $post = MarkdownPost::parse('2024-11-05-my-post');
+        
+        $this->assertEquals('posts/my-post', $post->getRouteKey());
+    }
+
+    public function testDateFromPrefixIsUsedWhenNoFrontMatterDate()
+    {
+        $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
+        $post = MarkdownPost::parse('2024-11-05-my-post');
+        
+        $this->assertEquals('2024-11-05 00:00', $post->date->format('Y-m-d H:i'));
+    }
+
+    public function testFrontMatterDateTakesPrecedenceOverPrefix()
+    {
+        $this->file('_posts/2024-11-05-my-post.md', <<<MD
+        ---
+        date: 2024-12-25
+        ---
+        # Hello World
+        MD);
+        
+        $post = MarkdownPost::parse('2024-11-05-my-post');
+        $this->assertEquals('2024-12-25', $post->date->format('Y-m-d'));
+    }
+}

From 10cadd0633d9608a6a38b4db03c9908da56364cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:24:02 +0100
Subject: [PATCH 3158/4023] Add base test

---
 .../framework/tests/Feature/BlogPostDatePrefixTest.php    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 7b61d36b4f6..75d74c3d3a0 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -26,6 +26,14 @@ public function testCanExtractDateFromPrefix()
         $this->assertEquals('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }
 
+    public function testCanGetDateFromBlogPostFilename()
+    {
+        $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
+        $post = MarkdownPost::parse('2024-11-05-my-post');
+
+        $this->assertInstanceOf(\DateTimeInterface::class, $post->date);
+    }
+
     public function testDatePrefixIsStrippedFromRouteKey()
     {
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');

From 8e0a460fbcd78b657e176e93c3364bddacc6b961 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:24:08 +0100
Subject: [PATCH 3159/4023] More realistic fixtures

---
 .../framework/tests/Feature/BlogPostDatePrefixTest.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 75d74c3d3a0..dbef15f3a63 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -10,18 +10,18 @@ class BlogPostDatePrefixTest extends TestCase
 {
     public function testCanDetectDatePrefix()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
     public function testCanExtractDateFromPrefix()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-my-post');
+        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertNotNull($date);
         $this->assertEquals('2024-11-05', $date->format('Y-m-d'));
 
-        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post');
+        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
         $this->assertNotNull($date);
         $this->assertEquals('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }

From 88bdd7af9b13eb5abfdc09204c41672696cb1b7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:26:22 +0100
Subject: [PATCH 3160/4023] Compare basenames of filepaths

---
 .../Framework/Features/Blogging/DatePrefixHelper.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index fa7e2fb6444..98760c25bd3 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -15,14 +15,14 @@ class DatePrefixHelper
 {
     protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
 
-    public static function hasDatePrefix(string $identifier): bool
+    public static function hasDatePrefix(string $filepath): bool
     {
-        return preg_match(static::DATE_PATTERN, $identifier) === 1;
+        return preg_match(static::DATE_PATTERN, basename($filepath)) === 1;
     }
 
-    public static function extractDate(string $identifier): ?DateTimeInterface
+    public static function extractDate(string $filepath): ?DateTimeInterface
     {
-        if (! preg_match(static::DATE_PATTERN, $identifier, $matches)) {
+        if (! preg_match(static::DATE_PATTERN, basename($filepath), $matches)) {
             return null;
         }
 
@@ -34,9 +34,9 @@ public static function extractDate(string $identifier): ?DateTimeInterface
         return new DateTime($dateString);
     }
 
-    public static function stripDatePrefix(string $identifier): string
+    public static function stripDatePrefix(string $filepath): string
     {
-        return preg_replace(static::DATE_PATTERN, '', $identifier);
+        return preg_replace(static::DATE_PATTERN, '', basename($filepath));
     }
 
     public static function createDateString(DateTimeInterface $date): DateString

From 8d6e7a708bc5e780c42af4a77523ea05d99711e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:28:27 +0100
Subject: [PATCH 3161/4023] Parse date from filenames

---
 .../src/Framework/Factories/BlogPostDataFactory.php      | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 2a1f781e7b8..98ce28889cb 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -13,6 +13,7 @@
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\Markdown;
 use Hyde\Support\Models\DateString;
+use Hyde\Framework\Features\Blogging\DatePrefixHelper;
 
 use function is_string;
 
@@ -87,6 +88,14 @@ protected function makeDate(): ?DateString
             return new DateString($this->getMatter('date'));
         }
 
+        if (DatePrefixHelper::hasDatePrefix($this->filePath)) {
+            $date = DatePrefixHelper::extractDate($this->filePath);
+
+            if ($date !== null) {
+                return new DateString($date->format('Y-m-d H:i'));
+            }
+        }
+
         return null;
     }
 

From 586b2a6416c0b1ae259e696286a811bb26bff50c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:28:51 +0100
Subject: [PATCH 3162/4023] Throw exception to ensure valid states

---
 .../src/Framework/Factories/BlogPostDataFactory.php          | 4 +---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php     | 5 +++--
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 98ce28889cb..2e75ed4554a 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -91,9 +91,7 @@ protected function makeDate(): ?DateString
         if (DatePrefixHelper::hasDatePrefix($this->filePath)) {
             $date = DatePrefixHelper::extractDate($this->filePath);
 
-            if ($date !== null) {
-                return new DateString($date->format('Y-m-d H:i'));
-            }
+            return new DateString($date->format('Y-m-d H:i'));
         }
 
         return null;
diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index 98760c25bd3..d697ede4b41 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -6,6 +6,7 @@
 
 use DateTime;
 use DateTimeInterface;
+use InvalidArgumentException;
 use Hyde\Support\Models\DateString;
 
 /**
@@ -20,10 +21,10 @@ public static function hasDatePrefix(string $filepath): bool
         return preg_match(static::DATE_PATTERN, basename($filepath)) === 1;
     }
 
-    public static function extractDate(string $filepath): ?DateTimeInterface
+    public static function extractDate(string $filepath): DateTimeInterface
     {
         if (! preg_match(static::DATE_PATTERN, basename($filepath), $matches)) {
-            return null;
+            throw new InvalidArgumentException('The given filepath does not contain a valid ISO 8601 date prefix.');
         }
 
         $dateString = $matches[1];

From 51d9327ebee1cee68bfc8e166a173581c5d4bc71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:29:55 +0100
Subject: [PATCH 3163/4023] Document date pattern format

---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php     | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index d697ede4b41..eb51d2f2816 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -14,6 +14,11 @@
  */
 class DatePrefixHelper
 {
+    /**
+     * We accept ISO 8601 dates in the format 'YYYY-MM-DD' and optionally a time in the format 'HH-MM', separated by a hyphen.
+     *
+     * @var string The regular expression pattern for matching a date prefix in a filename
+     */
     protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
 
     public static function hasDatePrefix(string $filepath): bool

From 8ffc91c897b3b6976b267a37c34335147cc6e5af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:30:21 +0100
Subject: [PATCH 3164/4023] Expect date string

---
 packages/framework/tests/Feature/BlogPostDatePrefixTest.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index dbef15f3a63..2db4c5e6196 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -2,6 +2,7 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Support\Models\DateString;
 use Hyde\Framework\Features\Blogging\DatePrefixHelper;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
@@ -31,7 +32,7 @@ public function testCanGetDateFromBlogPostFilename()
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
 
-        $this->assertInstanceOf(\DateTimeInterface::class, $post->date);
+        $this->assertInstanceOf(DateString::class, $post->date);
     }
 
     public function testDatePrefixIsStrippedFromRouteKey()

From 18c51c2fe45c6656d1d6e5a2f34068163d0c230c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:31:36 +0100
Subject: [PATCH 3165/4023] Add more tests

---
 .../framework/tests/Feature/BlogPostDatePrefixTest.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 2db4c5e6196..230ff88f8a7 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -33,6 +33,16 @@ public function testCanGetDateFromBlogPostFilename()
         $post = MarkdownPost::parse('2024-11-05-my-post');
 
         $this->assertInstanceOf(DateString::class, $post->date);
+        $this->assertEquals('2024-11-05 00:00', $post->date->string);
+    }
+
+    public function testCanGetDateFromBlogPostFilenameWithTime()
+    {
+        $this->file('_posts/2024-11-05-10-30-my-post.md', '# Hello World');
+        $post = MarkdownPost::parse('2024-11-05-10-30-my-post');
+
+        $this->assertInstanceOf(DateString::class, $post->date);
+        $this->assertEquals('2024-11-05 10:30', $post->date->string);
     }
 
     public function testDatePrefixIsStrippedFromRouteKey()

From a09fafa1d561b780a403c70e66376c68ee5c418c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:31:49 +0100
Subject: [PATCH 3166/4023] Use assert same for scalar types

---
 .../tests/Feature/BlogPostDatePrefixTest.php       | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 230ff88f8a7..88608666a16 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -20,11 +20,11 @@ public function testCanExtractDateFromPrefix()
     {
         $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertNotNull($date);
-        $this->assertEquals('2024-11-05', $date->format('Y-m-d'));
+        $this->assertSame('2024-11-05', $date->format('Y-m-d'));
 
         $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
         $this->assertNotNull($date);
-        $this->assertEquals('2024-11-05 10:30', $date->format('Y-m-d H:i'));
+        $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }
 
     public function testCanGetDateFromBlogPostFilename()
@@ -33,7 +33,7 @@ public function testCanGetDateFromBlogPostFilename()
         $post = MarkdownPost::parse('2024-11-05-my-post');
 
         $this->assertInstanceOf(DateString::class, $post->date);
-        $this->assertEquals('2024-11-05 00:00', $post->date->string);
+        $this->assertSame('2024-11-05 00:00', $post->date->string);
     }
 
     public function testCanGetDateFromBlogPostFilenameWithTime()
@@ -42,7 +42,7 @@ public function testCanGetDateFromBlogPostFilenameWithTime()
         $post = MarkdownPost::parse('2024-11-05-10-30-my-post');
 
         $this->assertInstanceOf(DateString::class, $post->date);
-        $this->assertEquals('2024-11-05 10:30', $post->date->string);
+        $this->assertSame('2024-11-05 10:30', $post->date->string);
     }
 
     public function testDatePrefixIsStrippedFromRouteKey()
@@ -50,7 +50,7 @@ public function testDatePrefixIsStrippedFromRouteKey()
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
         
-        $this->assertEquals('posts/my-post', $post->getRouteKey());
+        $this->assertSame('posts/my-post', $post->getRouteKey());
     }
 
     public function testDateFromPrefixIsUsedWhenNoFrontMatterDate()
@@ -58,7 +58,7 @@ public function testDateFromPrefixIsUsedWhenNoFrontMatterDate()
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
         
-        $this->assertEquals('2024-11-05 00:00', $post->date->format('Y-m-d H:i'));
+        $this->assertSame('2024-11-05 00:00', $post->date->format('Y-m-d H:i'));
     }
 
     public function testFrontMatterDateTakesPrecedenceOverPrefix()
@@ -71,6 +71,6 @@ public function testFrontMatterDateTakesPrecedenceOverPrefix()
         MD);
         
         $post = MarkdownPost::parse('2024-11-05-my-post');
-        $this->assertEquals('2024-12-25', $post->date->format('Y-m-d'));
+        $this->assertSame('2024-12-25', $post->date->format('Y-m-d'));
     }
 }

From 47e1e3c1c583e44c1f46a2594ab50cba42081127 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:49:54 +0100
Subject: [PATCH 3167/4023] Split the date prefix from the route key

---
 .../framework/src/Support/Models/RouteKey.php | 26 ++++++++++++++-----
 1 file changed, 19 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 711a53a4869..809598e6784 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -6,7 +6,9 @@
 
 use Stringable;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\MarkdownPost;
 use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
+use Hyde\Framework\Features\Blogging\DatePrefixHelper;
 
 use function Hyde\unslash;
 
@@ -49,18 +51,28 @@ public function get(): string
     /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
     public static function fromPage(string $pageClass, string $identifier): self
     {
-        if (is_a($pageClass, DocumentationPage::class, true)) {
-            $identifier = self::splitNumberedIdentifiersIfNeeded($identifier);
-        }
+        $identifier = self::stripPrefixIfNeeded($pageClass, $identifier);
 
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }
 
-    /** @experimental */
-    protected static function splitNumberedIdentifiersIfNeeded(string $identifier): string
+    /** 
+     * @experimental
+     *
+     * @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass 
+     * */
+    protected static function stripPrefixIfNeeded(string $pageClass, string $identifier): string
     {
-        if (NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
-            return NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
+        if (is_a($pageClass, DocumentationPage::class, true)) {
+            if (NumericalPageOrderingHelper::hasNumericalPrefix($identifier)) {
+                return NumericalPageOrderingHelper::splitNumericPrefix($identifier)[1];
+            }
+        }
+
+        if (is_a($pageClass, MarkdownPost::class, true)) {
+            if (DatePrefixHelper::hasDatePrefix($identifier)) {
+                return DatePrefixHelper::stripDatePrefix($identifier);
+            }
         }
 
         return $identifier;

From cc6455d53e86aeadda81baf3650c130f9cae8aaf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:50:03 +0100
Subject: [PATCH 3168/4023] Fix formatting

---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php  | 2 +-
 packages/framework/src/Support/Models/RouteKey.php        | 4 ++--
 .../framework/tests/Feature/BlogPostDatePrefixTest.php    | 8 ++++----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index eb51d2f2816..d4a84779224 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -34,7 +34,7 @@ public static function extractDate(string $filepath): DateTimeInterface
 
         $dateString = $matches[1];
         if (isset($matches[2])) {
-            $dateString .= ' ' . str_replace('-', ':', $matches[2]);
+            $dateString .= ' '.str_replace('-', ':', $matches[2]);
         }
 
         return new DateTime($dateString);
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index 809598e6784..d808345ebe2 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -56,10 +56,10 @@ public static function fromPage(string $pageClass, string $identifier): self
         return new self(unslash("{$pageClass::baseRouteKey()}/$identifier"));
     }
 
-    /** 
+    /**
      * @experimental
      *
-     * @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass 
+     * @param  class-string<\Hyde\Pages\Concerns\HydePage>  $pageClass
      * */
     protected static function stripPrefixIfNeeded(string $pageClass, string $identifier): string
     {
diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 88608666a16..b6d2aea4830 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -49,7 +49,7 @@ public function testDatePrefixIsStrippedFromRouteKey()
     {
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
-        
+
         $this->assertSame('posts/my-post', $post->getRouteKey());
     }
 
@@ -57,19 +57,19 @@ public function testDateFromPrefixIsUsedWhenNoFrontMatterDate()
     {
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
-        
+
         $this->assertSame('2024-11-05 00:00', $post->date->format('Y-m-d H:i'));
     }
 
     public function testFrontMatterDateTakesPrecedenceOverPrefix()
     {
-        $this->file('_posts/2024-11-05-my-post.md', <<<MD
+        $this->file('_posts/2024-11-05-my-post.md', <<<'MD'
         ---
         date: 2024-12-25
         ---
         # Hello World
         MD);
-        
+
         $post = MarkdownPost::parse('2024-11-05-my-post');
         $this->assertSame('2024-12-25', $post->date->format('Y-m-d'));
     }

From dd32a53756dcaef63c2ffbe253017f15f912dda6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:53:34 +0100
Subject: [PATCH 3169/4023] Fix syntax

---
 packages/framework/tests/Feature/BlogPostDatePrefixTest.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index b6d2aea4830..d02fd4f6949 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -58,19 +58,19 @@ public function testDateFromPrefixIsUsedWhenNoFrontMatterDate()
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');
         $post = MarkdownPost::parse('2024-11-05-my-post');
 
-        $this->assertSame('2024-11-05 00:00', $post->date->format('Y-m-d H:i'));
+        $this->assertSame('2024-11-05 00:00', $post->date->string);
     }
 
     public function testFrontMatterDateTakesPrecedenceOverPrefix()
     {
         $this->file('_posts/2024-11-05-my-post.md', <<<'MD'
         ---
-        date: 2024-12-25
+        date: "2024-12-25"
         ---
         # Hello World
         MD);
 
         $post = MarkdownPost::parse('2024-11-05-my-post');
-        $this->assertSame('2024-12-25', $post->date->format('Y-m-d'));
+        $this->assertSame('2024-12-25', $post->date->string);
     }
 }

From 677f2bcb4d44f4e708c0de402156eb26d5b8e761 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 20:57:03 +0100
Subject: [PATCH 3170/4023] Remove unused method

---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php    | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index d4a84779224..2eb68326f17 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -7,7 +7,6 @@
 use DateTime;
 use DateTimeInterface;
 use InvalidArgumentException;
-use Hyde\Support\Models\DateString;
 
 /**
  * @internal Helper class for handling date prefixes in blog post filenames
@@ -44,9 +43,4 @@ public static function stripDatePrefix(string $filepath): string
     {
         return preg_replace(static::DATE_PATTERN, '', basename($filepath));
     }
-
-    public static function createDateString(DateTimeInterface $date): DateString
-    {
-        return new DateString($date->format('Y-m-d H:i'));
-    }
 }

From a59dc7c4aa07d234aeedb0d11acb67d7374314b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:06:30 +0100
Subject: [PATCH 3171/4023] Remove support for timestamped date prefixes

---
 .../Features/Blogging/DatePrefixHelper.php        | 11 +++--------
 .../tests/Feature/BlogPostDatePrefixTest.php      | 15 +--------------
 2 files changed, 4 insertions(+), 22 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index 2eb68326f17..b49341f8b9c 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -14,11 +14,11 @@
 class DatePrefixHelper
 {
     /**
-     * We accept ISO 8601 dates in the format 'YYYY-MM-DD' and optionally a time in the format 'HH-MM', separated by a hyphen.
+     * We accept ISO 8601 dates in the format 'YYYY-MM-DD'.
      *
      * @var string The regular expression pattern for matching a date prefix in a filename
      */
-    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
+    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})-/';
 
     public static function hasDatePrefix(string $filepath): bool
     {
@@ -31,12 +31,7 @@ public static function extractDate(string $filepath): DateTimeInterface
             throw new InvalidArgumentException('The given filepath does not contain a valid ISO 8601 date prefix.');
         }
 
-        $dateString = $matches[1];
-        if (isset($matches[2])) {
-            $dateString .= ' '.str_replace('-', ':', $matches[2]);
-        }
-
-        return new DateTime($dateString);
+        return new DateTime($matches[1].' 00:00');
     }
 
     public static function stripDatePrefix(string $filepath): string
diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index d02fd4f6949..343f57974ef 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -12,7 +12,6 @@ class BlogPostDatePrefixTest extends TestCase
     public function testCanDetectDatePrefix()
     {
         $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
@@ -21,10 +20,7 @@ public function testCanExtractDateFromPrefix()
         $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertNotNull($date);
         $this->assertSame('2024-11-05', $date->format('Y-m-d'));
-
-        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
-        $this->assertNotNull($date);
-        $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
+        $this->assertSame('00:00', $date->format('H:i'));
     }
 
     public function testCanGetDateFromBlogPostFilename()
@@ -36,15 +32,6 @@ public function testCanGetDateFromBlogPostFilename()
         $this->assertSame('2024-11-05 00:00', $post->date->string);
     }
 
-    public function testCanGetDateFromBlogPostFilenameWithTime()
-    {
-        $this->file('_posts/2024-11-05-10-30-my-post.md', '# Hello World');
-        $post = MarkdownPost::parse('2024-11-05-10-30-my-post');
-
-        $this->assertInstanceOf(DateString::class, $post->date);
-        $this->assertSame('2024-11-05 10:30', $post->date->string);
-    }
-
     public function testDatePrefixIsStrippedFromRouteKey()
     {
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');

From ed5a497f896ae948ea025d213e8834fec0f8bc3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:06:33 +0100
Subject: [PATCH 3172/4023] Revert "Remove support for timestamped date
 prefixes"

This reverts commit f4d35a85f81673044a976582cf5d512ed5062662.
---
 .../Features/Blogging/DatePrefixHelper.php        | 11 ++++++++---
 .../tests/Feature/BlogPostDatePrefixTest.php      | 15 ++++++++++++++-
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index b49341f8b9c..2eb68326f17 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -14,11 +14,11 @@
 class DatePrefixHelper
 {
     /**
-     * We accept ISO 8601 dates in the format 'YYYY-MM-DD'.
+     * We accept ISO 8601 dates in the format 'YYYY-MM-DD' and optionally a time in the format 'HH-MM', separated by a hyphen.
      *
      * @var string The regular expression pattern for matching a date prefix in a filename
      */
-    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})-/';
+    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
 
     public static function hasDatePrefix(string $filepath): bool
     {
@@ -31,7 +31,12 @@ public static function extractDate(string $filepath): DateTimeInterface
             throw new InvalidArgumentException('The given filepath does not contain a valid ISO 8601 date prefix.');
         }
 
-        return new DateTime($matches[1].' 00:00');
+        $dateString = $matches[1];
+        if (isset($matches[2])) {
+            $dateString .= ' '.str_replace('-', ':', $matches[2]);
+        }
+
+        return new DateTime($dateString);
     }
 
     public static function stripDatePrefix(string $filepath): string
diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
index 343f57974ef..d02fd4f6949 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
@@ -12,6 +12,7 @@ class BlogPostDatePrefixTest extends TestCase
     public function testCanDetectDatePrefix()
     {
         $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
@@ -20,7 +21,10 @@ public function testCanExtractDateFromPrefix()
         $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertNotNull($date);
         $this->assertSame('2024-11-05', $date->format('Y-m-d'));
-        $this->assertSame('00:00', $date->format('H:i'));
+
+        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
+        $this->assertNotNull($date);
+        $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }
 
     public function testCanGetDateFromBlogPostFilename()
@@ -32,6 +36,15 @@ public function testCanGetDateFromBlogPostFilename()
         $this->assertSame('2024-11-05 00:00', $post->date->string);
     }
 
+    public function testCanGetDateFromBlogPostFilenameWithTime()
+    {
+        $this->file('_posts/2024-11-05-10-30-my-post.md', '# Hello World');
+        $post = MarkdownPost::parse('2024-11-05-10-30-my-post');
+
+        $this->assertInstanceOf(DateString::class, $post->date);
+        $this->assertSame('2024-11-05 10:30', $post->date->string);
+    }
+
     public function testDatePrefixIsStrippedFromRouteKey()
     {
         $this->file('_posts/2024-11-05-my-post.md', '# Hello World');

From 2ec0782ce26456f80163222c2396a3fd9d363e71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:12:31 +0100
Subject: [PATCH 3173/4023] Normalize test name

---
 ...gPostDatePrefixTest.php => BlogPostDatePrefixHelperTest.php} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/Feature/{BlogPostDatePrefixTest.php => BlogPostDatePrefixHelperTest.php} (97%)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
similarity index 97%
rename from packages/framework/tests/Feature/BlogPostDatePrefixTest.php
rename to packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index d02fd4f6949..899e7a28745 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -7,7 +7,7 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
 
-class BlogPostDatePrefixTest extends TestCase
+class BlogPostDatePrefixHelperTest extends TestCase
 {
     public function testCanDetectDatePrefix()
     {

From 1a2701bc3a3d975018a67050531c0f3a24ec3b21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:12:37 +0100
Subject: [PATCH 3174/4023] Add strict types declaration

---
 .../framework/tests/Feature/BlogPostDatePrefixHelperTest.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index 899e7a28745..bc28c73eed4 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Support\Models\DateString;

From ecf936158bcbb85f904e400f927e158092660b16 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:13:54 +0100
Subject: [PATCH 3175/4023] Document test class

---
 .../framework/tests/Feature/BlogPostDatePrefixHelperTest.php   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index bc28c73eed4..865d4ca5a2d 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -9,6 +9,9 @@
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
 
+/**
+ * High level test for the feature that allows dates to be set using prefixes in blog post filenames.
+ */
 class BlogPostDatePrefixHelperTest extends TestCase
 {
     public function testCanDetectDatePrefix()

From 519d49704faf463b830b0957a0e7be528bd48492 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:14:06 +0100
Subject: [PATCH 3176/4023] Annotate coverage

---
 .../framework/tests/Feature/BlogPostDatePrefixHelperTest.php  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index 865d4ca5a2d..41b274fe549 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -11,6 +11,10 @@
 
 /**
  * High level test for the feature that allows dates to be set using prefixes in blog post filenames.
+ *
+ * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
+ * @covers \Hyde\Framework\Factories\BlogPostDataFactory
+ * @covers \Hyde\Support\Models\RouteKey
  */
 class BlogPostDatePrefixHelperTest extends TestCase
 {

From 2d67433e7c16541f51dd7b572c663134a4724067 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:15:39 +0100
Subject: [PATCH 3177/4023] Create BlogPostDatePrefixHelperUnitTest.php

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
new file mode 100644
index 00000000000..0ddc04171c6
--- /dev/null
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
+ *
+ * @see \Hyde\Framework\Testing\Feature\BlogPostDatePrefixHelperTest
+ */
+class BlogPostDatePrefixHelperUnitTest extends UnitTestCase
+{
+    protected static bool $needsConfig = true;
+}

From 001f5423b86e336b49858af35a25485ce36a7575 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:15:42 +0100
Subject: [PATCH 3178/4023] Link to test

---
 .../framework/tests/Feature/BlogPostDatePrefixHelperTest.php    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index 41b274fe549..b07fac03108 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -15,6 +15,8 @@
  * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
  * @covers \Hyde\Framework\Factories\BlogPostDataFactory
  * @covers \Hyde\Support\Models\RouteKey
+ *
+ * @see \Hyde\Framework\Testing\Unit\BlogPostDatePrefixHelperUnitTest
  */
 class BlogPostDatePrefixHelperTest extends TestCase
 {

From 20f8a6fcafa5d70144ee4d5d2c83f85859e49f42 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:18:37 +0100
Subject: [PATCH 3179/4023] Generate unit test

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php | 97 +++++++++++++++++++
 1 file changed, 97 insertions(+)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 0ddc04171c6..9a054a1044c 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -3,6 +3,7 @@
 declare(strict_types=1);
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Framework\Features\Blogging\DatePrefixHelper;
 
 /**
  * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
@@ -12,4 +13,100 @@
 class BlogPostDatePrefixHelperUnitTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
+
+    public function testHasDatePrefixWithValidDateOnly()
+    {
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
+    }
+
+    public function testHasDatePrefixWithValidDateAndTime()
+    {
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
+    }
+
+    public function testHasDatePrefixWithoutDatePrefix()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
+    }
+
+    public function testExtractDateWithValidDateOnly()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
+        $this->assertInstanceOf(DateTime::class, $date);
+        $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testExtractDateWithValidDateAndTime()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
+        $this->assertInstanceOf(DateTime::class, $date);
+        $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
+    }
+
+    public function testExtractDateWithoutDatePrefix()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        DatePrefixHelper::extractDate('my-post.md');
+    }
+
+    public function testExtractDateWithInvalidDatePrefixFormat()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        DatePrefixHelper::extractDate('2024-11-XX-my-post.md');
+    }
+
+    public function testExtractDateWithMalformedTime()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        DatePrefixHelper::extractDate('2024-11-05-25-99-my-post.md');
+    }
+
+    public function testExtractDateWithMinimalPadding()
+    {
+        $date = DatePrefixHelper::extractDate('2024-1-5-my-post.md');
+        $this->assertInstanceOf(DateTime::class, $date);
+        $this->assertSame('2024-01-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testStripDatePrefixWithDateOnly()
+    {
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
+        $this->assertSame('my-post.md', $result);
+    }
+
+    public function testStripDatePrefixWithDateAndTime()
+    {
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-10-30-my-post.md');
+        $this->assertSame('my-post.md', $result);
+    }
+
+    public function testStripDatePrefixWithoutDatePrefix()
+    {
+        $result = DatePrefixHelper::stripDatePrefix('my-post.md');
+        $this->assertSame('my-post.md', $result);
+    }
+
+    public function testExtractDateWithUnusualCharactersInFilename()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-special_chars-#post.md');
+        $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testExtractDateWithAlternativeExtensions()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.markdown');
+        $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testEdgeCaseWithExtraHyphens()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-extra-hyphens-in-title.md');
+        $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testStripDatePrefixRetainsHyphensInTitle()
+    {
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-extra-hyphens-in-title.md');
+        $this->assertSame('extra-hyphens-in-title.md', $result);
+    }
 }

From 61d79faf397001aebd8c5dda02d64bd142eea2c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:19:38 +0100
Subject: [PATCH 3180/4023] Remove support for unpadded times in filenames

---
 .../tests/Unit/BlogPostDatePrefixHelperUnitTest.php        | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 9a054a1044c..28de384299d 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -61,13 +61,6 @@ public function testExtractDateWithMalformedTime()
         DatePrefixHelper::extractDate('2024-11-05-25-99-my-post.md');
     }
 
-    public function testExtractDateWithMinimalPadding()
-    {
-        $date = DatePrefixHelper::extractDate('2024-1-5-my-post.md');
-        $this->assertInstanceOf(DateTime::class, $date);
-        $this->assertSame('2024-01-05 00:00', $date->format('Y-m-d H:i'));
-    }
-
     public function testStripDatePrefixWithDateOnly()
     {
         $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');

From 4023ad41d23e39f967e8133c76a1b6a68279b06d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:24:49 +0100
Subject: [PATCH 3181/4023] Update regex to prevent out of bounds times

---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index 2eb68326f17..8062f95a49b 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -18,7 +18,7 @@ class DatePrefixHelper
      *
      * @var string The regular expression pattern for matching a date prefix in a filename
      */
-    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
+    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(2[0-3]|[01]\d)-([0-5]\d))?-/';
 
     public static function hasDatePrefix(string $filepath): bool
     {

From 7c1aa2366fe489a94b71cbb2f673db3761d43287 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:24:51 +0100
Subject: [PATCH 3182/4023] Revert "Update regex to prevent out of bounds
 times"

This reverts commit 4023ad41d23e39f967e8133c76a1b6a68279b06d.
---
 .../src/Framework/Features/Blogging/DatePrefixHelper.php        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
index 8062f95a49b..2eb68326f17 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
@@ -18,7 +18,7 @@ class DatePrefixHelper
      *
      * @var string The regular expression pattern for matching a date prefix in a filename
      */
-    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(2[0-3]|[01]\d)-([0-5]\d))?-/';
+    protected const DATE_PATTERN = '/^(\d{4}-\d{2}-\d{2})(?:-(\d{2}-\d{2}))?-/';
 
     public static function hasDatePrefix(string $filepath): bool
     {

From 779c91822ff8251b890ed19c7d75ba7e93507a50 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:26:20 +0100
Subject: [PATCH 3183/4023] Expect exception messages

---
 .../framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 28de384299d..267f5531f25 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -46,12 +46,16 @@ public function testExtractDateWithValidDateAndTime()
     public function testExtractDateWithoutDatePrefix()
     {
         $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The given filepath does not contain a valid ISO 8601 date prefix.');
+
         DatePrefixHelper::extractDate('my-post.md');
     }
 
     public function testExtractDateWithInvalidDatePrefixFormat()
     {
         $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The given filepath does not contain a valid ISO 8601 date prefix.');
+
         DatePrefixHelper::extractDate('2024-11-XX-my-post.md');
     }
 

From f880da09dfc0b2048782285eaa527bd9b3c7a728 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:26:37 +0100
Subject: [PATCH 3184/4023] Expect implicit exception handling

---
 .../framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 267f5531f25..cf1ce59e5a1 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -61,7 +61,9 @@ public function testExtractDateWithInvalidDatePrefixFormat()
 
     public function testExtractDateWithMalformedTime()
     {
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Failed to parse time string (2024-11-05 25:99)');
+
         DatePrefixHelper::extractDate('2024-11-05-25-99-my-post.md');
     }
 

From be2ef2496dc964c86b7fa8b2a06a06bf794483cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:27:04 +0100
Subject: [PATCH 3185/4023] Test does not need config

---
 .../framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php   | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index cf1ce59e5a1..c13a01dde9f 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -12,8 +12,6 @@
  */
 class BlogPostDatePrefixHelperUnitTest extends UnitTestCase
 {
-    protected static bool $needsConfig = true;
-
     public function testHasDatePrefixWithValidDateOnly()
     {
         $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));

From e9d994d04c322464d7f2c9b634c7d01dd5e7835c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:29:18 +0100
Subject: [PATCH 3186/4023] Test inverse matching for varied formats

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index c13a01dde9f..40e247dc2f5 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -27,6 +27,36 @@ public function testHasDatePrefixWithoutDatePrefix()
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
+    public function testHasDatePrefixWithInvalidDateFormat()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-13-05-my-post.md')); // Invalid month
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-32-my-post.md')); // Invalid day
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-my-post.md')); // Missing day
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('202-11-05-my-post.md')); // Invalid year format
+    }
+
+    public function testHasDatePrefixWithInvalidTimeFormat()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-99-00-my-post.md')); // Invalid hour
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-10-99-my-post.md')); // Invalid minute
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md')); // Missing hyphen between hour and minute
+    }
+
+    public function testHasDatePrefixWithNoDatePrefixButSimilarPattern()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('hello-2024-11-05.md')); // Date-like pattern in the middle
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024/11/05-my-post.md')); // Date separated by slashes
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('11-05-2024-my-post.md')); // Date in non-ISO format
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('post-2024-11-05.md')); // Date-like pattern at the end
+    }
+
+    public function testHasDatePrefixWithExtraCharactersAroundDate()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md')); // Extra character at start
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md')); // Extra hyphen at end
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md')); // Extra numbers after filename
+    }
+
     public function testExtractDateWithValidDateOnly()
     {
         $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');

From 4c6cbb2ea25fd8be1d25c5fe3cdad9e0962ff61a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:31:59 +0100
Subject: [PATCH 3187/4023] Change redundant checks for implicitly handled
 faults

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php     | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 40e247dc2f5..f268330f715 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -29,17 +29,18 @@ public function testHasDatePrefixWithoutDatePrefix()
 
     public function testHasDatePrefixWithInvalidDateFormat()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-13-05-my-post.md')); // Invalid month
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-32-my-post.md')); // Invalid day
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-123-05-my-post.md')); // Invalid month
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-123-my-post.md')); // Invalid day
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-my-post.md')); // Missing day
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('202-11-05-my-post.md')); // Invalid year format
     }
 
     public function testHasDatePrefixWithInvalidTimeFormat()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-99-00-my-post.md')); // Invalid hour
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-10-99-my-post.md')); // Invalid minute
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md')); // Missing hyphen between hour and minute
+        // These are all true, because the parser will think that the time is part of the slug, so we can't reliably detect these cases, as there is technically a *date* prefix
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-123-00-my-post.md')); // Invalid hour
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-123-my-post.md')); // Invalid minute
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md')); // Missing hyphen between hour and minute
     }
 
     public function testHasDatePrefixWithNoDatePrefixButSimilarPattern()
@@ -53,8 +54,8 @@ public function testHasDatePrefixWithNoDatePrefixButSimilarPattern()
     public function testHasDatePrefixWithExtraCharactersAroundDate()
     {
         $this->assertFalse(DatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md')); // Extra character at start
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md')); // Extra hyphen at end
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md')); // Extra numbers after filename
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md')); // Extra hyphen at end
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md')); // Extra numbers after filename
     }
 
     public function testExtractDateWithValidDateOnly()

From b9d83d3f366e1ada6076fbbe21ee1f1125ce86be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:39:01 +0100
Subject: [PATCH 3188/4023] Cover more edge cases

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index f268330f715..74d17ea64d2 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -137,4 +137,53 @@ public function testStripDatePrefixRetainsHyphensInTitle()
         $result = DatePrefixHelper::stripDatePrefix('2024-11-05-extra-hyphens-in-title.md');
         $this->assertSame('extra-hyphens-in-title.md', $result);
     }
+
+    public function testInvalidSingleDigitMonthOrDay()
+    {
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-1-5-my-post.md')); // Single-digit month and day
+    }
+
+    public function testFileWithValidDatePrefixButInvalidExtension()
+    {
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.txt')); // Unsupported file extension
+    }
+
+    public function testTimePrefixWithLeadingZeroInHourOrMinute()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-00-30-my-post.md');
+        $this->assertSame('2024-11-05 00:30', $date->format('Y-m-d H:i'));
+
+        $date = DatePrefixHelper::extractDate('2024-11-05-10-00-my-post.md');
+        $this->assertSame('2024-11-05 10:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testFilenameWithPotentiallyMisleadingHyphens()
+    {
+        $date = DatePrefixHelper::extractDate('2024-11-05-extra-hyphens---title.md');
+        $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testLeapYearDate()
+    {
+        $date = DatePrefixHelper::extractDate('2024-02-29-my-leap-year-post.md');
+        $this->assertSame('2024-02-29 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testInvalidDates()
+    {
+        $date = DatePrefixHelper::extractDate('2024-04-31-my-post.md');
+        $this->assertSame('2024-05-01 00:00', $date->format('Y-m-d H:i'));
+    }
+
+    public function testStripDateWithVariousUnconventionalExtensions()
+    {
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
+        $this->assertSame('my-post.md', $result);
+
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.markdown');
+        $this->assertSame('my-post.markdown', $result);
+
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.txt'); // Should still strip but ignore extension
+        $this->assertSame('my-post.txt', $result);
+    }
 }

From 0504b6b56fd8660888b671981d51d13ceeb87069 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:40:17 +0100
Subject: [PATCH 3189/4023] Remove redundant code comments

---
 .../Unit/BlogPostDatePrefixHelperUnitTest.php | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index 74d17ea64d2..f63c20d28be 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -29,33 +29,33 @@ public function testHasDatePrefixWithoutDatePrefix()
 
     public function testHasDatePrefixWithInvalidDateFormat()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-123-05-my-post.md')); // Invalid month
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-123-my-post.md')); // Invalid day
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-my-post.md')); // Missing day
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('202-11-05-my-post.md')); // Invalid year format
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-123-05-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-123-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('202-11-05-my-post.md'));
     }
 
     public function testHasDatePrefixWithInvalidTimeFormat()
     {
         // These are all true, because the parser will think that the time is part of the slug, so we can't reliably detect these cases, as there is technically a *date* prefix
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-123-00-my-post.md')); // Invalid hour
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-123-my-post.md')); // Invalid minute
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md')); // Missing hyphen between hour and minute
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-123-00-my-post.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-123-my-post.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md'));
     }
 
     public function testHasDatePrefixWithNoDatePrefixButSimilarPattern()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('hello-2024-11-05.md')); // Date-like pattern in the middle
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024/11/05-my-post.md')); // Date separated by slashes
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('11-05-2024-my-post.md')); // Date in non-ISO format
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('post-2024-11-05.md')); // Date-like pattern at the end
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('hello-2024-11-05.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024/11/05-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('11-05-2024-my-post.md'));
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('post-2024-11-05.md'));
     }
 
     public function testHasDatePrefixWithExtraCharactersAroundDate()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md')); // Extra character at start
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md')); // Extra hyphen at end
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md')); // Extra numbers after filename
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md'));
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md'));
     }
 
     public function testExtractDateWithValidDateOnly()
@@ -140,12 +140,12 @@ public function testStripDatePrefixRetainsHyphensInTitle()
 
     public function testInvalidSingleDigitMonthOrDay()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-1-5-my-post.md')); // Single-digit month and day
+        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-1-5-my-post.md'));
     }
 
     public function testFileWithValidDatePrefixButInvalidExtension()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.txt')); // Unsupported file extension
+        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.txt'));
     }
 
     public function testTimePrefixWithLeadingZeroInHourOrMinute()
@@ -183,7 +183,7 @@ public function testStripDateWithVariousUnconventionalExtensions()
         $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.markdown');
         $this->assertSame('my-post.markdown', $result);
 
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.txt'); // Should still strip but ignore extension
+        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.txt');
         $this->assertSame('my-post.txt', $result);
     }
 }

From c82cd26ebc52bba7f53ab40e80162f3310b0a676 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:44:21 +0100
Subject: [PATCH 3190/4023] Rename added internal class

---
 .../Factories/BlogPostDataFactory.php         |  6 +-
 ...elper.php => BlogPostDatePrefixHelper.php} |  2 +-
 .../framework/src/Support/Models/RouteKey.php |  6 +-
 .../Feature/BlogPostDatePrefixHelperTest.php  | 14 ++--
 .../Unit/BlogPostDatePrefixHelperUnitTest.php | 82 +++++++++----------
 5 files changed, 55 insertions(+), 55 deletions(-)
 rename packages/framework/src/Framework/Features/Blogging/{DatePrefixHelper.php => BlogPostDatePrefixHelper.php} (97%)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 2e75ed4554a..5704a4f72b7 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -13,7 +13,7 @@
 use Hyde\Markdown\Models\FrontMatter;
 use Hyde\Markdown\Models\Markdown;
 use Hyde\Support\Models\DateString;
-use Hyde\Framework\Features\Blogging\DatePrefixHelper;
+use Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper;
 
 use function is_string;
 
@@ -88,8 +88,8 @@ protected function makeDate(): ?DateString
             return new DateString($this->getMatter('date'));
         }
 
-        if (DatePrefixHelper::hasDatePrefix($this->filePath)) {
-            $date = DatePrefixHelper::extractDate($this->filePath);
+        if (BlogPostDatePrefixHelper::hasDatePrefix($this->filePath)) {
+            $date = BlogPostDatePrefixHelper::extractDate($this->filePath);
 
             return new DateString($date->format('Y-m-d H:i'));
         }
diff --git a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
similarity index 97%
rename from packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
rename to packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
index 2eb68326f17..6bd6afa4839 100644
--- a/packages/framework/src/Framework/Features/Blogging/DatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
@@ -11,7 +11,7 @@
 /**
  * @internal Helper class for handling date prefixes in blog post filenames
  */
-class DatePrefixHelper
+class BlogPostDatePrefixHelper
 {
     /**
      * We accept ISO 8601 dates in the format 'YYYY-MM-DD' and optionally a time in the format 'HH-MM', separated by a hyphen.
diff --git a/packages/framework/src/Support/Models/RouteKey.php b/packages/framework/src/Support/Models/RouteKey.php
index d808345ebe2..ab2dcf59d29 100644
--- a/packages/framework/src/Support/Models/RouteKey.php
+++ b/packages/framework/src/Support/Models/RouteKey.php
@@ -8,7 +8,7 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Framework\Features\Navigation\NumericalPageOrderingHelper;
-use Hyde\Framework\Features\Blogging\DatePrefixHelper;
+use Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper;
 
 use function Hyde\unslash;
 
@@ -70,8 +70,8 @@ protected static function stripPrefixIfNeeded(string $pageClass, string $identif
         }
 
         if (is_a($pageClass, MarkdownPost::class, true)) {
-            if (DatePrefixHelper::hasDatePrefix($identifier)) {
-                return DatePrefixHelper::stripDatePrefix($identifier);
+            if (BlogPostDatePrefixHelper::hasDatePrefix($identifier)) {
+                return BlogPostDatePrefixHelper::stripDatePrefix($identifier);
             }
         }
 
diff --git a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
index b07fac03108..9a3cd077bfa 100644
--- a/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
+++ b/packages/framework/tests/Feature/BlogPostDatePrefixHelperTest.php
@@ -5,14 +5,14 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Support\Models\DateString;
-use Hyde\Framework\Features\Blogging\DatePrefixHelper;
+use Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Testing\TestCase;
 
 /**
  * High level test for the feature that allows dates to be set using prefixes in blog post filenames.
  *
- * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
+ * @covers \Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper
  * @covers \Hyde\Framework\Factories\BlogPostDataFactory
  * @covers \Hyde\Support\Models\RouteKey
  *
@@ -22,18 +22,18 @@ class BlogPostDatePrefixHelperTest extends TestCase
 {
     public function testCanDetectDatePrefix()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
     public function testCanExtractDateFromPrefix()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertNotNull($date);
         $this->assertSame('2024-11-05', $date->format('Y-m-d'));
 
-        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
         $this->assertNotNull($date);
         $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }
diff --git a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
index f63c20d28be..b3fb3c540bc 100644
--- a/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
+++ b/packages/framework/tests/Unit/BlogPostDatePrefixHelperUnitTest.php
@@ -3,10 +3,10 @@
 declare(strict_types=1);
 
 use Hyde\Testing\UnitTestCase;
-use Hyde\Framework\Features\Blogging\DatePrefixHelper;
+use Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper;
 
 /**
- * @covers \Hyde\Framework\Features\Blogging\DatePrefixHelper
+ * @covers \Hyde\Framework\Features\Blogging\BlogPostDatePrefixHelper
  *
  * @see \Hyde\Framework\Testing\Feature\BlogPostDatePrefixHelperTest
  */
@@ -14,60 +14,60 @@ class BlogPostDatePrefixHelperUnitTest extends UnitTestCase
 {
     public function testHasDatePrefixWithValidDateOnly()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-my-post.md'));
     }
 
     public function testHasDatePrefixWithValidDateAndTime()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-10-30-my-post.md'));
     }
 
     public function testHasDatePrefixWithoutDatePrefix()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('my-post.md'));
     }
 
     public function testHasDatePrefixWithInvalidDateFormat()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-123-05-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-123-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-11-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('202-11-05-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('2024-123-05-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-123-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('202-11-05-my-post.md'));
     }
 
     public function testHasDatePrefixWithInvalidTimeFormat()
     {
         // These are all true, because the parser will think that the time is part of the slug, so we can't reliably detect these cases, as there is technically a *date* prefix
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-123-00-my-post.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-10-123-my-post.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-123-00-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-10-123-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-1030-my-post.md'));
     }
 
     public function testHasDatePrefixWithNoDatePrefixButSimilarPattern()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('hello-2024-11-05.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024/11/05-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('11-05-2024-my-post.md'));
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('post-2024-11-05.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('hello-2024-11-05.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('2024/11/05-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('11-05-2024-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('post-2024-11-05.md'));
     }
 
     public function testHasDatePrefixWithExtraCharactersAroundDate()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md'));
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('x2024-11-05-my-post.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-my-post-.md'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-my-post123.md'));
     }
 
     public function testExtractDateWithValidDateOnly()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-my-post.md');
         $this->assertInstanceOf(DateTime::class, $date);
         $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testExtractDateWithValidDateAndTime()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-10-30-my-post.md');
         $this->assertInstanceOf(DateTime::class, $date);
         $this->assertSame('2024-11-05 10:30', $date->format('Y-m-d H:i'));
     }
@@ -77,7 +77,7 @@ public function testExtractDateWithoutDatePrefix()
         $this->expectException(InvalidArgumentException::class);
         $this->expectExceptionMessage('The given filepath does not contain a valid ISO 8601 date prefix.');
 
-        DatePrefixHelper::extractDate('my-post.md');
+        BlogPostDatePrefixHelper::extractDate('my-post.md');
     }
 
     public function testExtractDateWithInvalidDatePrefixFormat()
@@ -85,7 +85,7 @@ public function testExtractDateWithInvalidDatePrefixFormat()
         $this->expectException(InvalidArgumentException::class);
         $this->expectExceptionMessage('The given filepath does not contain a valid ISO 8601 date prefix.');
 
-        DatePrefixHelper::extractDate('2024-11-XX-my-post.md');
+        BlogPostDatePrefixHelper::extractDate('2024-11-XX-my-post.md');
     }
 
     public function testExtractDateWithMalformedTime()
@@ -93,97 +93,97 @@ public function testExtractDateWithMalformedTime()
         $this->expectException(Exception::class);
         $this->expectExceptionMessage('Failed to parse time string (2024-11-05 25:99)');
 
-        DatePrefixHelper::extractDate('2024-11-05-25-99-my-post.md');
+        BlogPostDatePrefixHelper::extractDate('2024-11-05-25-99-my-post.md');
     }
 
     public function testStripDatePrefixWithDateOnly()
     {
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
         $this->assertSame('my-post.md', $result);
     }
 
     public function testStripDatePrefixWithDateAndTime()
     {
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-10-30-my-post.md');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-10-30-my-post.md');
         $this->assertSame('my-post.md', $result);
     }
 
     public function testStripDatePrefixWithoutDatePrefix()
     {
-        $result = DatePrefixHelper::stripDatePrefix('my-post.md');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('my-post.md');
         $this->assertSame('my-post.md', $result);
     }
 
     public function testExtractDateWithUnusualCharactersInFilename()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-special_chars-#post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-special_chars-#post.md');
         $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testExtractDateWithAlternativeExtensions()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-my-post.markdown');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-my-post.markdown');
         $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testEdgeCaseWithExtraHyphens()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-extra-hyphens-in-title.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-extra-hyphens-in-title.md');
         $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testStripDatePrefixRetainsHyphensInTitle()
     {
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-extra-hyphens-in-title.md');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-extra-hyphens-in-title.md');
         $this->assertSame('extra-hyphens-in-title.md', $result);
     }
 
     public function testInvalidSingleDigitMonthOrDay()
     {
-        $this->assertFalse(DatePrefixHelper::hasDatePrefix('2024-1-5-my-post.md'));
+        $this->assertFalse(BlogPostDatePrefixHelper::hasDatePrefix('2024-1-5-my-post.md'));
     }
 
     public function testFileWithValidDatePrefixButInvalidExtension()
     {
-        $this->assertTrue(DatePrefixHelper::hasDatePrefix('2024-11-05-my-post.txt'));
+        $this->assertTrue(BlogPostDatePrefixHelper::hasDatePrefix('2024-11-05-my-post.txt'));
     }
 
     public function testTimePrefixWithLeadingZeroInHourOrMinute()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-00-30-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-00-30-my-post.md');
         $this->assertSame('2024-11-05 00:30', $date->format('Y-m-d H:i'));
 
-        $date = DatePrefixHelper::extractDate('2024-11-05-10-00-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-10-00-my-post.md');
         $this->assertSame('2024-11-05 10:00', $date->format('Y-m-d H:i'));
     }
 
     public function testFilenameWithPotentiallyMisleadingHyphens()
     {
-        $date = DatePrefixHelper::extractDate('2024-11-05-extra-hyphens---title.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-11-05-extra-hyphens---title.md');
         $this->assertSame('2024-11-05 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testLeapYearDate()
     {
-        $date = DatePrefixHelper::extractDate('2024-02-29-my-leap-year-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-02-29-my-leap-year-post.md');
         $this->assertSame('2024-02-29 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testInvalidDates()
     {
-        $date = DatePrefixHelper::extractDate('2024-04-31-my-post.md');
+        $date = BlogPostDatePrefixHelper::extractDate('2024-04-31-my-post.md');
         $this->assertSame('2024-05-01 00:00', $date->format('Y-m-d H:i'));
     }
 
     public function testStripDateWithVariousUnconventionalExtensions()
     {
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-my-post.md');
         $this->assertSame('my-post.md', $result);
 
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.markdown');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-my-post.markdown');
         $this->assertSame('my-post.markdown', $result);
 
-        $result = DatePrefixHelper::stripDatePrefix('2024-11-05-my-post.txt');
+        $result = BlogPostDatePrefixHelper::stripDatePrefix('2024-11-05-my-post.txt');
         $this->assertSame('my-post.txt', $result);
     }
 }

From 2979dbb3059e92c4f8998f08ffc129252c572816 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:44:28 +0100
Subject: [PATCH 3191/4023] Formatting

---
 .../src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php b/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
index 6bd6afa4839..9828542fb3a 100644
--- a/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
+++ b/packages/framework/src/Framework/Features/Blogging/BlogPostDatePrefixHelper.php
@@ -32,6 +32,7 @@ public static function extractDate(string $filepath): DateTimeInterface
         }
 
         $dateString = $matches[1];
+
         if (isset($matches[2])) {
             $dateString .= ' '.str_replace('-', ':', $matches[2]);
         }

From e22bb4b83ef834ce399a8169e6048fb1205fa1be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:52:24 +0100
Subject: [PATCH 3192/4023] Document blog post date prefixes

---
 docs/creating-content/blog-posts.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index ae5eaef27fa..0fce218a810 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -42,6 +42,31 @@ to keep in mind when creating blog posts so that you don't get unexpected result
 ✔ _posts/hello-world.md # Valid and will be compiled to _site/posts/hello-world.html
 ```
 
+#### Date Prefixes
+
+You **optionally** can set a blog post's publication date by prefixing the filename with a date in ISO 8601 format (`YYYY-MM-DD`). Optionally, you can also include the time (`HH-MM`).
+
+```bash
+# Basic date prefix (sets date to 2024-11-05 00:00)
+2024-11-05-my-first-post.md
+
+# Date and time prefix (sets date to 2024-11-05 10:30)
+2024-11-05-10-30-my-first-post.md
+```
+
+**The date prefix will be:**
+1. Stripped from the route key (resulting in clean URLs like `posts/my-first-post`)
+2. Used to set the post's publication date (unless explicitly defined in front matter)
+
+**Important notes:**
+- Dates must be in ISO 8601 format (`YYYY-MM-DD` or `YYYY-MM-DD-HH-MM`)
+- Days and months must use leading zeros (e.g., `2024-01-05` not `2024-1-5`)
+- Time is optional and uses 24-hour format with a hyphen separator (`HH-MM`)
+- Front matter dates take precedence over filename dates
+- Using date prefixes is entirely optional!
+
+This feature provides an intuitive way to organize your blog posts chronologically while maintaining clean URLs, and matches the behavior of many popular static site generators for interoperability.
+
 ### Front Matter
 
 Front matter is optional, but highly recommended for blog posts as the front matter is used to construct dynamic HTML

From 54bb55c02eee26c20dd2a37efff3d3d401687668 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 5 Nov 2024 21:53:18 +0100
Subject: [PATCH 3193/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index efaa0ddb97e..d922146fc24 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -20,6 +20,7 @@ This serves two purposes:
 - Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily in https://github.com/hydephp/develop/pull/1847
 - Added support for setting custom navigation items in the YAML configuration in https://github.com/hydephp/develop/pull/1818
 - Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
+- Added support for setting the blog post publishing date as a prefix in the source file name in https://github.com/hydephp/develop/pull/2000
 - Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
 - You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895

From b8e0e3497826bcc19079f3b85a5ed87b3e929bfc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:50:15 +0100
Subject: [PATCH 3194/4023] Replace Laravel Mix dependencies with Vite

---
 package-lock.json | 18214 ++++++--------------------------------------
 package.json      |    10 +-
 2 files changed, 2314 insertions(+), 15910 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 2c72f4d15ad..244c4addf18 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,5 @@
 {
     "name": "monorepo",
-    "version": "1.1.0",
     "lockfileVersion": 2,
     "requires": true,
     "packages": {
@@ -9,17 +8,16 @@
                 "@tailwindcss/typography": "^0.5.15",
                 "autoprefixer": "^10.4.20",
                 "hydefront": "^3.3.0",
-                "laravel-mix": "^6.0.49",
                 "postcss": "^8.4.47",
                 "prettier": "3.3.3",
-                "tailwindcss": "^3.4.14"
+                "tailwindcss": "^3.4.14",
+                "vite": "^5.0.0"
             }
         },
         "node_modules/@alloc/quick-lru": {
             "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
-            "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
             "dev": true,
+            "license": "MIT",
             "engines": {
                 "node": ">=10"
             },
@@ -27,15992 +25,3240 @@
                 "url": "https://github.com/sponsors/sindresorhus"
             }
         },
-        "node_modules/@ampproject/remapping": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.2.0.tgz",
-            "integrity": "sha512-qRmjj8nj9qmLTQXXmaR1cck3UXSRMPrbsLJAasZpF+t3riI71BXed5ebIOYwQntykeZuhjsdweEc9BxH5Jc26w==",
+        "node_modules/@esbuild/aix-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+            "cpu": [
+                "ppc64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@jridgewell/gen-mapping": "^0.1.0",
-                "@jridgewell/trace-mapping": "^0.3.9"
-            },
+            "optional": true,
+            "os": [
+                "aix"
+            ],
             "engines": {
-                "node": ">=6.0.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/code-frame": {
-            "version": "7.22.13",
-            "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.22.13.tgz",
-            "integrity": "sha512-XktuhWlJ5g+3TJXc5upd9Ks1HutSArik6jf2eAjYFyIOf4ej3RN+184cZbzDvbPnuTJIUhPKKJE3cIsYTiAT3w==",
+        "node_modules/@esbuild/android-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+            "cpu": [
+                "arm"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/highlight": "^7.22.13",
-                "chalk": "^2.4.2"
-            },
+            "optional": true,
+            "os": [
+                "android"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/code-frame/node_modules/ansi-styles": {
-            "version": "3.2.1",
-            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
-            "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+        "node_modules/@esbuild/android-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "color-convert": "^1.9.0"
-            },
+            "optional": true,
+            "os": [
+                "android"
+            ],
             "engines": {
-                "node": ">=4"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/code-frame/node_modules/chalk": {
-            "version": "2.4.2",
-            "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
-            "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+        "node_modules/@esbuild/android-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "ansi-styles": "^3.2.1",
-                "escape-string-regexp": "^1.0.5",
-                "supports-color": "^5.3.0"
-            },
+            "optional": true,
+            "os": [
+                "android"
+            ],
             "engines": {
-                "node": ">=4"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/code-frame/node_modules/supports-color": {
-            "version": "5.5.0",
-            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
-            "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+        "node_modules/@esbuild/darwin-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "has-flag": "^3.0.0"
-            },
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
             "engines": {
-                "node": ">=4"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/compat-data": {
-            "version": "7.17.10",
-            "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.17.10.tgz",
-            "integrity": "sha512-GZt/TCsG70Ms19gfZO1tM4CVnXsPgEPBCpJu+Qz3L0LUDsY5nZqFZglIoPC1kIYOtNBZlrnFT+klg12vFGZXrw==",
+        "node_modules/@esbuild/darwin-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/core": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.18.2.tgz",
-            "integrity": "sha512-A8pri1YJiC5UnkdrWcmfZTJTV85b4UXTAfImGmCfYmax4TR9Cw8sDS0MOk++Gp2mE/BefVJ5nwy5yzqNJbP/DQ==",
+        "node_modules/@esbuild/freebsd-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@ampproject/remapping": "^2.1.0",
-                "@babel/code-frame": "^7.16.7",
-                "@babel/generator": "^7.18.2",
-                "@babel/helper-compilation-targets": "^7.18.2",
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helpers": "^7.18.2",
-                "@babel/parser": "^7.18.0",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2",
-                "convert-source-map": "^1.7.0",
-                "debug": "^4.1.0",
-                "gensync": "^1.0.0-beta.2",
-                "json5": "^2.2.1",
-                "semver": "^6.3.0"
-            },
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/babel"
-            }
-        },
-        "node_modules/@babel/core/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-            "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/generator": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.23.0.tgz",
-            "integrity": "sha512-lN85QRR+5IbYrMWM6Y4pE/noaQtg4pNiqeNGX60eqOfo6gtEj6uw/JagelB8vVztSd7R6M5n1+PQkDbHbBRU4g==",
+        "node_modules/@esbuild/freebsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.23.0",
-                "@jridgewell/gen-mapping": "^0.3.2",
-                "@jridgewell/trace-mapping": "^0.3.17",
-                "jsesc": "^2.5.1"
-            },
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/generator/node_modules/@jridgewell/gen-mapping": {
-            "version": "0.3.3",
-            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.3.tgz",
-            "integrity": "sha512-HLhSWOLRi875zjjMG/r+Nv0oCW8umGb0BgEhyX3dDX3egwZtB8PqLnjz3yedt8R5StBrzcg4aBpnh8UA9D1BoQ==",
+        "node_modules/@esbuild/linux-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "cpu": [
+                "arm"
+            ],
             "dev": true,
-            "dependencies": {
-                "@jridgewell/set-array": "^1.0.1",
-                "@jridgewell/sourcemap-codec": "^1.4.10",
-                "@jridgewell/trace-mapping": "^0.3.9"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.0.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-annotate-as-pure": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.16.7.tgz",
-            "integrity": "sha512-s6t2w/IPQVTAET1HitoowRGXooX8mCgtuP5195wD/QJPV6wYjpujCGF7JuMODVX2ZAJOf1GT6DT9MHEZvLOFSw==",
+        "node_modules/@esbuild/linux-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.16.7"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-builder-binary-assignment-operator-visitor": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-builder-binary-assignment-operator-visitor/-/helper-builder-binary-assignment-operator-visitor-7.16.7.tgz",
-            "integrity": "sha512-C6FdbRaxYjwVu/geKW4ZeQ0Q31AftgRcdSnZ5/jsH6BzCJbtvXvhpfkbkThYSuutZA7nCXpPR6AD9zd1dprMkA==",
+        "node_modules/@esbuild/linux-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "cpu": [
+                "ia32"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-explode-assignable-expression": "^7.16.7",
-                "@babel/types": "^7.16.7"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-compilation-targets": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.18.2.tgz",
-            "integrity": "sha512-s1jnPotJS9uQnzFtiZVBUxe67CuBa679oWFHpxYYnTpRL/1ffhyX44R9uYiXoa/pLXcY9H2moJta0iaanlk/rQ==",
+        "node_modules/@esbuild/linux-loong64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "cpu": [
+                "loong64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-validator-option": "^7.16.7",
-                "browserslist": "^4.20.2",
-                "semver": "^6.3.0"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-compilation-targets/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+        "node_modules/@esbuild/linux-mips64el": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+            "cpu": [
+                "mips64el"
+            ],
             "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-create-class-features-plugin": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.18.0.tgz",
-            "integrity": "sha512-Kh8zTGR9de3J63e5nS0rQUdRs/kbtwoeQQ0sriS0lItjC96u8XXZN6lKpuyWd2coKSU13py/y+LTmThLuVX0Pg==",
+        "node_modules/@esbuild/linux-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+            "cpu": [
+                "ppc64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-environment-visitor": "^7.16.7",
-                "@babel/helper-function-name": "^7.17.9",
-                "@babel/helper-member-expression-to-functions": "^7.17.7",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/helper-replace-supers": "^7.16.7",
-                "@babel/helper-split-export-declaration": "^7.16.7"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-create-regexp-features-plugin": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.17.12.tgz",
-            "integrity": "sha512-b2aZrV4zvutr9AIa6/gA3wsZKRwTKYoDxYiFKcESS3Ug2GTXzwBEvMuuFLhCQpEnRXs1zng4ISAXSUxxKBIcxw==",
+        "node_modules/@esbuild/linux-riscv64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+            "cpu": [
+                "riscv64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "regexpu-core": "^5.0.1"
-            },
+            "optional": true,
+            "os": [
+                "linux"
+            ],
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-define-polyfill-provider": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.3.1.tgz",
-            "integrity": "sha512-J9hGMpJQmtWmj46B3kBHmL38UhJGhYX7eqkcq+2gsstyYt341HmPeWspihX43yVRA0mS+8GGk2Gckc7bY/HCmA==",
+        "node_modules/@esbuild/linux-s390x": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+            "cpu": [
+                "s390x"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-compilation-targets": "^7.13.0",
-                "@babel/helper-module-imports": "^7.12.13",
-                "@babel/helper-plugin-utils": "^7.13.0",
-                "@babel/traverse": "^7.13.0",
-                "debug": "^4.1.1",
-                "lodash.debounce": "^4.0.8",
-                "resolve": "^1.14.2",
-                "semver": "^6.1.2"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.4.0-0"
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-define-polyfill-provider/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+        "node_modules/@esbuild/linux-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-environment-visitor": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/helper-environment-visitor/-/helper-environment-visitor-7.22.20.tgz",
-            "integrity": "sha512-zfedSIzFhat/gFhWfHtgWvlec0nqB9YEIVrpuwjruLlXfUSnA8cJB0miHKwqDnQ7d32aKo2xt88/xZptwxbfhA==",
+        "node_modules/@esbuild/netbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-explode-assignable-expression": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-explode-assignable-expression/-/helper-explode-assignable-expression-7.16.7.tgz",
-            "integrity": "sha512-KyUenhWMC8VrxzkGP0Jizjo4/Zx+1nNZhgocs+gLzyZyB8SHidhoq9KK/8Ato4anhwsivfkBLftky7gvzbZMtQ==",
+        "node_modules/@esbuild/openbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.16.7"
-            },
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-function-name": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.23.0.tgz",
-            "integrity": "sha512-OErEqsrxjZTJciZ4Oo+eoZqeW9UIiOcuYKRJA4ZAgV9myA+pOXhhmpfNCKjEH/auVfEYVFJ6y1Tc4r0eIApqiw==",
+        "node_modules/@esbuild/sunos-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/template": "^7.22.15",
-                "@babel/types": "^7.23.0"
-            },
+            "optional": true,
+            "os": [
+                "sunos"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-hoist-variables": {
-            "version": "7.22.5",
-            "resolved": "https://registry.npmjs.org/@babel/helper-hoist-variables/-/helper-hoist-variables-7.22.5.tgz",
-            "integrity": "sha512-wGjk9QZVzvknA6yKIUURb8zY3grXCcOZt+/7Wcy8O2uctxhplmUPkOdlgoNhmdVee2c92JXbf1xpMtVNbfoxRw==",
+        "node_modules/@esbuild/win32-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.22.5"
-            },
+            "optional": true,
+            "os": [
+                "win32"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-member-expression-to-functions": {
-            "version": "7.17.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.17.7.tgz",
-            "integrity": "sha512-thxXgnQ8qQ11W2wVUObIqDL4p148VMxkt5T/qpN5k2fboRyzFGFmKsTGViquyM5QHKUy48OZoca8kw4ajaDPyw==",
+        "node_modules/@esbuild/win32-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "cpu": [
+                "ia32"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.17.0"
-            },
+            "optional": true,
+            "os": [
+                "win32"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-module-imports": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.16.7.tgz",
-            "integrity": "sha512-LVtS6TqjJHFc+nYeITRo6VLXve70xmq7wPhWTqDJusJEgGmkAACWwMiTNrvfoQo6hEhFwAIixNkvB0jPXDL8Wg==",
+        "node_modules/@esbuild/win32-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.16.7"
-            },
+            "optional": true,
+            "os": [
+                "win32"
+            ],
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-module-transforms": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.18.0.tgz",
-            "integrity": "sha512-kclUYSUBIjlvnzN2++K9f2qzYKFgjmnmjwL4zlmU5f8ZtzgWe8s0rUPSTGy2HmK4P8T52MQsS+HTQAgZd3dMEA==",
+        "node_modules/@isaacs/cliui": {
+            "version": "8.0.2",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/helper-environment-visitor": "^7.16.7",
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-simple-access": "^7.17.7",
-                "@babel/helper-split-export-declaration": "^7.16.7",
-                "@babel/helper-validator-identifier": "^7.16.7",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.0",
-                "@babel/types": "^7.18.0"
+                "string-width": "^5.1.2",
+                "string-width-cjs": "npm:string-width@^4.2.0",
+                "strip-ansi": "^7.0.1",
+                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+                "wrap-ansi": "^8.1.0",
+                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             }
         },
-        "node_modules/@babel/helper-optimise-call-expression": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.16.7.tgz",
-            "integrity": "sha512-EtgBhg7rd/JcnpZFXpBy0ze1YRfdm7BnBX4uKMBd3ixa3RGAE002JZB66FJyNH7g0F38U05pXmA5P8cBh7z+1w==",
+        "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
+            "version": "6.1.0",
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.16.7"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/ansi-regex?sponsor=1"
             }
         },
-        "node_modules/@babel/helper-plugin-utils": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.17.12.tgz",
-            "integrity": "sha512-JDkf04mqtN3y4iAbO1hv9U2ARpPyPL1zqyWs/2WG1pgSq9llHFjStX5jdxb84himgJm+8Ng+x0oiWF/nw/XQKA==",
+        "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
+            "version": "6.2.1",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
             }
         },
-        "node_modules/@babel/helper-remap-async-to-generator": {
-            "version": "7.16.8",
-            "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.16.8.tgz",
-            "integrity": "sha512-fm0gH7Flb8H51LqJHy3HJ3wnE1+qtYR2A99K06ahwrawLdOFsCEWjZOrYricXJHoPSudNKxrMBUPEIPxiIIvBw==",
+        "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
+            "version": "9.2.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-wrap-function": "^7.16.8",
-                "@babel/types": "^7.16.8"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/helper-replace-supers": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.18.2.tgz",
-            "integrity": "sha512-XzAIyxx+vFnrOxiQrToSUOzUOn0e1J2Li40ntddek1Y69AXUTXoDJ40/D5RdjFu7s7qHiaeoTiempZcbuVXh2Q==",
+        "node_modules/@isaacs/cliui/node_modules/string-width": {
+            "version": "5.1.2",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-environment-visitor": "^7.18.2",
-                "@babel/helper-member-expression-to-functions": "^7.17.7",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2"
+                "eastasianwidth": "^0.2.0",
+                "emoji-regex": "^9.2.2",
+                "strip-ansi": "^7.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
             }
         },
-        "node_modules/@babel/helper-simple-access": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-simple-access/-/helper-simple-access-7.18.2.tgz",
-            "integrity": "sha512-7LIrjYzndorDY88MycupkpQLKS1AFfsVRm2k/9PtKScSy5tZq0McZTj+DiMRynboZfIqOKvo03pmhTaUgiD6fQ==",
+        "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
+            "version": "7.1.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/types": "^7.18.2"
+                "ansi-regex": "^6.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/strip-ansi?sponsor=1"
             }
         },
-        "node_modules/@babel/helper-skip-transparent-expression-wrappers": {
-            "version": "7.16.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.16.0.tgz",
-            "integrity": "sha512-+il1gTy0oHwUsBQZyJvukbB4vPMdcYBrFHa0Uc4AizLxbq6BOYC51Rv4tWocX9BLBDLZ4kc6qUFpQ6HRgL+3zw==",
+        "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
+            "version": "8.1.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/types": "^7.16.0"
+                "ansi-styles": "^6.1.0",
+                "string-width": "^5.0.1",
+                "strip-ansi": "^7.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
             }
         },
-        "node_modules/@babel/helper-split-export-declaration": {
-            "version": "7.22.6",
-            "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.22.6.tgz",
-            "integrity": "sha512-AsUnxuLhRYsisFiaJwvp1QF+I3KjD5FOxut14q/GzovUe6orHLesW2C7d754kRm53h5gqrz6sFl6sxc4BVtE/g==",
+        "node_modules/@jridgewell/gen-mapping": {
+            "version": "0.3.5",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/types": "^7.22.5"
+                "@jridgewell/set-array": "^1.2.1",
+                "@jridgewell/sourcemap-codec": "^1.4.10",
+                "@jridgewell/trace-mapping": "^0.3.24"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=6.0.0"
             }
         },
-        "node_modules/@babel/helper-string-parser": {
-            "version": "7.22.5",
-            "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.22.5.tgz",
-            "integrity": "sha512-mM4COjgZox8U+JcXQwPijIZLElkgEpO5rsERVDJTc2qfCDfERyob6k5WegS14SX18IIjv+XD+GrqNumY5JRCDw==",
+        "node_modules/@jridgewell/resolve-uri": {
+            "version": "3.1.2",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=6.0.0"
             }
         },
-        "node_modules/@babel/helper-validator-identifier": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.20.tgz",
-            "integrity": "sha512-Y4OZ+ytlatR8AI+8KZfKuL5urKp7qey08ha31L8b3BwewJAoJamTzyvxPR/5D+KkdJCGPq/+8TukHBlY10FX9A==",
+        "node_modules/@jridgewell/set-array": {
+            "version": "1.2.1",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=6.0.0"
             }
         },
-        "node_modules/@babel/helper-validator-option": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.16.7.tgz",
-            "integrity": "sha512-TRtenOuRUVo9oIQGPC5G9DgK4743cdxvtOw0weQNpZXaS16SCBi5MNjZF8vba3ETURjZpTbVn7Vvcf2eAwFozQ==",
+        "node_modules/@jridgewell/source-map": {
+            "version": "0.3.6",
             "dev": true,
-            "engines": {
-                "node": ">=6.9.0"
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
+            "dependencies": {
+                "@jridgewell/gen-mapping": "^0.3.5",
+                "@jridgewell/trace-mapping": "^0.3.25"
             }
         },
-        "node_modules/@babel/helper-wrap-function": {
-            "version": "7.16.8",
-            "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.16.8.tgz",
-            "integrity": "sha512-8RpyRVIAW1RcDDGTA+GpPAwV22wXCfKOoM9bet6TLkGIFTkRQSkH1nMQ5Yet4MpoXe1ZwHPVtNasc2w0uZMqnw==",
+        "node_modules/@jridgewell/sourcemap-codec": {
+            "version": "1.5.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-function-name": "^7.16.7",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.16.8",
-                "@babel/types": "^7.16.8"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/helpers": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.18.2.tgz",
-            "integrity": "sha512-j+d+u5xT5utcQSzrh9p+PaJX94h++KN+ng9b9WEJq7pkUPAd61FGqhjuUEdfknb3E/uDBb7ruwEeKkIxNJPIrg==",
+        "node_modules/@jridgewell/trace-mapping": {
+            "version": "0.3.25",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2"
-            },
-            "engines": {
-                "node": ">=6.9.0"
+                "@jridgewell/resolve-uri": "^3.1.0",
+                "@jridgewell/sourcemap-codec": "^1.4.14"
             }
         },
-        "node_modules/@babel/highlight": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.22.20.tgz",
-            "integrity": "sha512-dkdMCN3py0+ksCgYmGG8jKeGA/8Tk+gJwSYYlFGxG5lmhfKNoAy004YpLxpS1W2J8m/EK2Ew+yOs9pVRwO89mg==",
+        "node_modules/@nodelib/fs.scandir": {
+            "version": "2.1.5",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-validator-identifier": "^7.22.20",
-                "chalk": "^2.4.2",
-                "js-tokens": "^4.0.0"
+                "@nodelib/fs.stat": "2.0.5",
+                "run-parallel": "^1.1.9"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/highlight/node_modules/ansi-styles": {
-            "version": "3.2.1",
-            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
-            "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+        "node_modules/@nodelib/fs.stat": {
+            "version": "2.0.5",
             "dev": true,
-            "dependencies": {
-                "color-convert": "^1.9.0"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=4"
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/highlight/node_modules/chalk": {
-            "version": "2.4.2",
-            "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
-            "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+        "node_modules/@nodelib/fs.walk": {
+            "version": "1.2.8",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "ansi-styles": "^3.2.1",
-                "escape-string-regexp": "^1.0.5",
-                "supports-color": "^5.3.0"
+                "@nodelib/fs.scandir": "2.1.5",
+                "fastq": "^1.6.0"
             },
             "engines": {
-                "node": ">=4"
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/highlight/node_modules/supports-color": {
-            "version": "5.5.0",
-            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
-            "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+        "node_modules/@pkgjs/parseargs": {
+            "version": "0.11.0",
             "dev": true,
-            "dependencies": {
-                "has-flag": "^3.0.0"
-            },
+            "license": "MIT",
+            "optional": true,
             "engines": {
-                "node": ">=4"
+                "node": ">=14"
             }
         },
-        "node_modules/@babel/parser": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.23.0.tgz",
-            "integrity": "sha512-vvPKKdMemU85V9WE/l5wZEmImpCtLqbnTvqDS2U1fJ96KrxoW7KrXhNsNCblQlg8Ck4b85yxdTyelsMUgFUXiw==",
+        "node_modules/@rollup/rollup-android-arm-eabi": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
+            "integrity": "sha512-CC/ZqFZwlAIbU1wUPisHyV/XRc5RydFrNLtgl3dGYskdwPZdt4HERtKm50a/+DtTlKeCq9IXFEWR+P6blwjqBA==",
+            "cpu": [
+                "arm"
+            ],
             "dev": true,
-            "bin": {
-                "parser": "bin/babel-parser.js"
-            },
-            "engines": {
-                "node": ">=6.0.0"
-            }
+            "optional": true,
+            "os": [
+                "android"
+            ]
         },
-        "node_modules/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.17.12.tgz",
-            "integrity": "sha512-xCJQXl4EeQ3J9C4yOmpTrtVGmzpm2iSzyxbkZHw7UCnZBftHpF/hpII80uWVyVrc40ytIClHjgWGTG1g/yB+aw==",
+        "node_modules/@rollup/rollup-android-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.25.0.tgz",
+            "integrity": "sha512-/Y76tmLGUJqVBXXCfVS8Q8FJqYGhgH4wl4qTA24E9v/IJM0XvJCGQVSW1QZ4J+VURO9h8YCa28sTFacZXwK7Rg==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0"
-            }
+            "optional": true,
+            "os": [
+                "android"
+            ]
         },
-        "node_modules/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.17.12.tgz",
-            "integrity": "sha512-/vt0hpIw0x4b6BLKUkwlvEoiGZYYLNZ96CzyHYPbtG2jZGz6LBe7/V+drYrc/d+ovrF9NBi0pmtvmNb/FsWtRQ==",
+        "node_modules/@rollup/rollup-darwin-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.25.0.tgz",
+            "integrity": "sha512-YVT6L3UrKTlC0FpCZd0MGA7NVdp7YNaEqkENbWQ7AOVOqd/7VzyHpgIpc1mIaxRAo1ZsJRH45fq8j4N63I/vvg==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0",
-                "@babel/plugin-proposal-optional-chaining": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.13.0"
-            }
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-async-generator-functions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-async-generator-functions/-/plugin-proposal-async-generator-functions-7.17.12.tgz",
-            "integrity": "sha512-RWVvqD1ooLKP6IqWTA5GyFVX2isGEgC5iFxKzfYOIy/QEFdxYyCybBDtIGjipHpb9bDWHzcqGqFakf+mVmBTdQ==",
+        "node_modules/@rollup/rollup-darwin-x64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.25.0.tgz",
+            "integrity": "sha512-ZRL+gexs3+ZmmWmGKEU43Bdn67kWnMeWXLFhcVv5Un8FQcx38yulHBA7XR2+KQdYIOtD0yZDWBCudmfj6lQJoA==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-remap-async-to-generator": "^7.16.8",
-                "@babel/plugin-syntax-async-generators": "^7.8.4"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "darwin"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-class-properties": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-properties/-/plugin-proposal-class-properties-7.17.12.tgz",
-            "integrity": "sha512-U0mI9q8pW5Q9EaTHFPwSVusPMV/DV9Mm8p7csqROFLtIE9rBF5piLqyrBGigftALrBcsBGu4m38JneAe7ZDLXw==",
+        "node_modules/@rollup/rollup-freebsd-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.25.0.tgz",
+            "integrity": "sha512-xpEIXhiP27EAylEpreCozozsxWQ2TJbOLSivGfXhU4G1TBVEYtUPi2pOZBnvGXHyOdLAUUhPnJzH3ah5cqF01g==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-class-static-block": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-static-block/-/plugin-proposal-class-static-block-7.18.0.tgz",
-            "integrity": "sha512-t+8LsRMMDE74c6sV7KShIw13sqbqd58tlqNrsWoWBTIMw7SVQ0cZ905wLNS/FBCy/3PyooRHLFFlfrUNyyz5lA==",
+        "node_modules/@rollup/rollup-freebsd-x64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.25.0.tgz",
+            "integrity": "sha512-sC5FsmZGlJv5dOcURrsnIK7ngc3Kirnx3as2XU9uER+zjfyqIjdcMVgzy4cOawhsssqzoAX19qmxgJ8a14Qrqw==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-class-features-plugin": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-class-static-block": "^7.14.5"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.12.0"
-            }
+            "optional": true,
+            "os": [
+                "freebsd"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-dynamic-import": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-dynamic-import/-/plugin-proposal-dynamic-import-7.16.7.tgz",
-            "integrity": "sha512-I8SW9Ho3/8DRSdmDdH3gORdyUuYnk1m4cMxUAdu5oy4n3OfN8flDEH+d60iG7dUfi0KkYwSvoalHzzdRzpWHTg==",
+        "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.25.0.tgz",
+            "integrity": "sha512-uD/dbLSs1BEPzg564TpRAQ/YvTnCds2XxyOndAO8nJhaQcqQGFgv/DAVko/ZHap3boCvxnzYMa3mTkV/B/3SWA==",
+            "cpu": [
+                "arm"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-export-namespace-from": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-export-namespace-from/-/plugin-proposal-export-namespace-from-7.17.12.tgz",
-            "integrity": "sha512-j7Ye5EWdwoXOpRmo5QmRyHPsDIe6+u70ZYZrd7uz+ebPYFKfRcLcNu3Ro0vOlJ5zuv8rU7xa+GttNiRzX56snQ==",
+        "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.25.0.tgz",
+            "integrity": "sha512-ZVt/XkrDlQWegDWrwyC3l0OfAF7yeJUF4fq5RMS07YM72BlSfn2fQQ6lPyBNjt+YbczMguPiJoCfaQC2dnflpQ==",
+            "cpu": [
+                "arm"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-export-namespace-from": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-json-strings": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-json-strings/-/plugin-proposal-json-strings-7.17.12.tgz",
-            "integrity": "sha512-rKJ+rKBoXwLnIn7n6o6fulViHMrOThz99ybH+hKHcOZbnN14VuMnH9fo2eHE69C8pO4uX1Q7t2HYYIDmv8VYkg==",
+        "node_modules/@rollup/rollup-linux-arm64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.25.0.tgz",
+            "integrity": "sha512-qboZ+T0gHAW2kkSDPHxu7quaFaaBlynODXpBVnPxUgvWYaE84xgCKAPEYE+fSMd3Zv5PyFZR+L0tCdYCMAtG0A==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-json-strings": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-logical-assignment-operators": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-logical-assignment-operators/-/plugin-proposal-logical-assignment-operators-7.17.12.tgz",
-            "integrity": "sha512-EqFo2s1Z5yy+JeJu7SFfbIUtToJTVlC61/C7WLKDntSw4Sz6JNAIfL7zQ74VvirxpjB5kz/kIx0gCcb+5OEo2Q==",
+        "node_modules/@rollup/rollup-linux-arm64-musl": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.25.0.tgz",
+            "integrity": "sha512-ndWTSEmAaKr88dBuogGH2NZaxe7u2rDoArsejNslugHZ+r44NfWiwjzizVS1nUOHo+n1Z6qV3X60rqE/HlISgw==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-nullish-coalescing-operator": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-nullish-coalescing-operator/-/plugin-proposal-nullish-coalescing-operator-7.17.12.tgz",
-            "integrity": "sha512-ws/g3FSGVzv+VH86+QvgtuJL/kR67xaEIF2x0iPqdDfYW6ra6JF3lKVBkWynRLcNtIC1oCTfDRVxmm2mKzy+ag==",
+        "node_modules/@rollup/rollup-linux-powerpc64le-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.25.0.tgz",
+            "integrity": "sha512-BVSQvVa2v5hKwJSy6X7W1fjDex6yZnNKy3Kx1JGimccHft6HV0THTwNtC2zawtNXKUu+S5CjXslilYdKBAadzA==",
+            "cpu": [
+                "ppc64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-numeric-separator": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-numeric-separator/-/plugin-proposal-numeric-separator-7.16.7.tgz",
-            "integrity": "sha512-vQgPMknOIgiuVqbokToyXbkY/OmmjAzr/0lhSIbG/KmnzXPGwW/AdhdKpi+O4X/VkWiWjnkKOBiqJrTaC98VKw==",
+        "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.25.0.tgz",
+            "integrity": "sha512-G4hTREQrIdeV0PE2JruzI+vXdRnaK1pg64hemHq2v5fhv8C7WjVaeXc9P5i4Q5UC06d/L+zA0mszYIKl+wY8oA==",
+            "cpu": [
+                "riscv64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-numeric-separator": "^7.10.4"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-object-rest-spread": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-object-rest-spread/-/plugin-proposal-object-rest-spread-7.18.0.tgz",
-            "integrity": "sha512-nbTv371eTrFabDfHLElkn9oyf9VG+VKK6WMzhY2o4eHKaG19BToD9947zzGMO6I/Irstx9d8CwX6njPNIAR/yw==",
+        "node_modules/@rollup/rollup-linux-s390x-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.25.0.tgz",
+            "integrity": "sha512-9T/w0kQ+upxdkFL9zPVB6zy9vWW1deA3g8IauJxojN4bnz5FwSsUAD034KpXIVX5j5p/rn6XqumBMxfRkcHapQ==",
+            "cpu": [
+                "s390x"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-compilation-targets": "^7.17.10",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
-                "@babel/plugin-transform-parameters": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-optional-catch-binding": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-catch-binding/-/plugin-proposal-optional-catch-binding-7.16.7.tgz",
-            "integrity": "sha512-eMOH/L4OvWSZAE1VkHbr1vckLG1WUcHGJSLqqQwl2GaUqG6QjddvrOaTUMNYiv77H5IKPMZ9U9P7EaHwvAShfA==",
+        "node_modules/@rollup/rollup-linux-x64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.25.0.tgz",
+            "integrity": "sha512-ThcnU0EcMDn+J4B9LD++OgBYxZusuA7iemIIiz5yzEcFg04VZFzdFjuwPdlURmYPZw+fgVrFzj4CA64jSTG4Ig==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-optional-catch-binding": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-optional-chaining": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-chaining/-/plugin-proposal-optional-chaining-7.17.12.tgz",
-            "integrity": "sha512-7wigcOs/Z4YWlK7xxjkvaIw84vGhDv/P1dFGQap0nHkc8gFKY/r+hXc8Qzf5k1gY7CvGIcHqAnOagVKJJ1wVOQ==",
+        "node_modules/@rollup/rollup-linux-x64-musl": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.25.0.tgz",
+            "integrity": "sha512-zx71aY2oQxGxAT1JShfhNG79PnjYhMC6voAjzpu/xmMjDnKNf6Nl/xv7YaB/9SIa9jDYf8RBPWEnjcdlhlv1rQ==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0",
-                "@babel/plugin-syntax-optional-chaining": "^7.8.3"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "linux"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-private-methods": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-methods/-/plugin-proposal-private-methods-7.17.12.tgz",
-            "integrity": "sha512-SllXoxo19HmxhDWm3luPz+cPhtoTSKLJE9PXshsfrOzBqs60QP0r8OaJItrPhAj0d7mZMnNF0Y1UUggCDgMz1A==",
+        "node_modules/@rollup/rollup-win32-arm64-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.25.0.tgz",
+            "integrity": "sha512-JT8tcjNocMs4CylWY/CxVLnv8e1lE7ff1fi6kbGocWwxDq9pj30IJ28Peb+Y8yiPNSF28oad42ApJB8oUkwGww==",
+            "cpu": [
+                "arm64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "win32"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-private-property-in-object": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.17.12.tgz",
-            "integrity": "sha512-/6BtVi57CJfrtDNKfK5b66ydK2J5pXUKBKSPD2G1whamMuEnZWgoOIfO8Vf9F/DoD4izBLD/Au4NMQfruzzykg==",
+        "node_modules/@rollup/rollup-win32-ia32-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.25.0.tgz",
+            "integrity": "sha512-dRLjLsO3dNOfSN6tjyVlG+Msm4IiZnGkuZ7G5NmpzwF9oOc582FZG05+UdfTbz5Jd4buK/wMb6UeHFhG18+OEg==",
+            "cpu": [
+                "ia32"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-private-property-in-object": "^7.14.5"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "win32"
+            ]
         },
-        "node_modules/@babel/plugin-proposal-unicode-property-regex": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-unicode-property-regex/-/plugin-proposal-unicode-property-regex-7.17.12.tgz",
-            "integrity": "sha512-Wb9qLjXf3ZazqXA7IvI7ozqRIXIGPtSo+L5coFmEkhTQK18ao4UDDD0zdTGAarmbLj2urpRwrc6893cu5Bfh0A==",
+        "node_modules/@rollup/rollup-win32-x64-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.25.0.tgz",
+            "integrity": "sha512-/RqrIFtLB926frMhZD0a5oDa4eFIbyNEwLLloMTEjmqfwZWXywwVVOVmwTsuyhC9HKkVEZcOOi+KV4U9wmOdlg==",
+            "cpu": [
+                "x64"
+            ],
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-regexp-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=4"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "optional": true,
+            "os": [
+                "win32"
+            ]
         },
-        "node_modules/@babel/plugin-syntax-async-generators": {
-            "version": "7.8.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz",
-            "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==",
+        "node_modules/@tailwindcss/typography": {
+            "version": "0.5.15",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
+                "lodash.castarray": "^4.4.0",
+                "lodash.isplainobject": "^4.0.6",
+                "lodash.merge": "^4.6.2",
+                "postcss-selector-parser": "6.0.10"
             },
             "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "tailwindcss": ">=3.0.0 || insiders || >=4.0.0-alpha.20"
             }
         },
-        "node_modules/@babel/plugin-syntax-class-properties": {
-            "version": "7.12.13",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz",
-            "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==",
+        "node_modules/@types/estree": {
+            "version": "1.0.6",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.12.13"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/plugin-syntax-class-static-block": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz",
-            "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==",
+        "node_modules/@types/node": {
+            "version": "22.9.0",
             "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.14.5"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "undici-types": "~6.19.8"
             }
         },
-        "node_modules/@babel/plugin-syntax-dynamic-import": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-dynamic-import/-/plugin-syntax-dynamic-import-7.8.3.tgz",
-            "integrity": "sha512-5gdGbFon+PszYzqs83S3E5mpi7/y/8M9eC90MRTZfduQOYW76ig6SOSPNe41IG5LoP3FGBn2N0RjVDSQiS94kQ==",
+        "node_modules/acorn": {
+            "version": "8.14.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
+            "bin": {
+                "acorn": "bin/acorn"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "engines": {
+                "node": ">=0.4.0"
             }
         },
-        "node_modules/@babel/plugin-syntax-export-namespace-from": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-export-namespace-from/-/plugin-syntax-export-namespace-from-7.8.3.tgz",
-            "integrity": "sha512-MXf5laXo6c1IbEbegDmzGPwGNTsHZmEy6QGznu5Sh2UCWvueywb2ee+CCE4zQiZstxU9BMoQO9i6zUFSY0Kj0Q==",
+        "node_modules/ansi-regex": {
+            "version": "5.0.1",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.3"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "license": "MIT",
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@babel/plugin-syntax-import-assertions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.17.12.tgz",
-            "integrity": "sha512-n/loy2zkq9ZEM8tEOwON9wTQSTNDTDEz6NujPtJGLU7qObzT1N4c4YZZf8E6ATB2AjNQg/Ib2AIpO03EZaCehw==",
+        "node_modules/ansi-styles": {
+            "version": "4.3.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "color-convert": "^2.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=8"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
-        },
-        "node_modules/@babel/plugin-syntax-json-strings": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz",
-            "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==",
-            "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
             }
         },
-        "node_modules/@babel/plugin-syntax-logical-assignment-operators": {
-            "version": "7.10.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz",
-            "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==",
+        "node_modules/any-promise": {
+            "version": "1.3.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.10.4"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/plugin-syntax-nullish-coalescing-operator": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz",
-            "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==",
+        "node_modules/anymatch": {
+            "version": "3.1.3",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
+                "normalize-path": "^3.0.0",
+                "picomatch": "^2.0.4"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "engines": {
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/plugin-syntax-numeric-separator": {
-            "version": "7.10.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz",
-            "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==",
+        "node_modules/arg": {
+            "version": "5.0.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.10.4"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/plugin-syntax-object-rest-spread": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz",
-            "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==",
+        "node_modules/autoprefixer": {
+            "version": "10.4.20",
             "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/autoprefixer"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
+                "browserslist": "^4.23.3",
+                "caniuse-lite": "^1.0.30001646",
+                "fraction.js": "^4.3.7",
+                "normalize-range": "^0.1.2",
+                "picocolors": "^1.0.1",
+                "postcss-value-parser": "^4.2.0"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
-        },
-        "node_modules/@babel/plugin-syntax-optional-catch-binding": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz",
-            "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==",
-            "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
+            "bin": {
+                "autoprefixer": "bin/autoprefixer"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14"
             },
             "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "postcss": "^8.1.0"
             }
         },
-        "node_modules/@babel/plugin-syntax-optional-chaining": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz",
-            "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==",
+        "node_modules/balanced-match": {
+            "version": "1.0.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/plugin-syntax-private-property-in-object": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz",
-            "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==",
+        "node_modules/binary-extensions": {
+            "version": "2.3.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.14.5"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=8"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
             }
         },
-        "node_modules/@babel/plugin-syntax-top-level-await": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz",
-            "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==",
+        "node_modules/braces": {
+            "version": "3.0.3",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.14.5"
+                "fill-range": "^7.1.1"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=8"
             }
         },
-        "node_modules/@babel/plugin-transform-arrow-functions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.17.12.tgz",
-            "integrity": "sha512-PHln3CNi/49V+mza4xMwrg+WGYevSF1oaiXaC2EQfdp4HWlSjRsrDXWJiQBKpP7749u6vQ9mcry2uuFOv5CXvA==",
+        "node_modules/browserslist": {
+            "version": "4.24.2",
             "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/browserslist"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/browserslist"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "caniuse-lite": "^1.0.30001669",
+                "electron-to-chromium": "^1.5.41",
+                "node-releases": "^2.0.18",
+                "update-browserslist-db": "^1.1.1"
             },
-            "engines": {
-                "node": ">=6.9.0"
+            "bin": {
+                "browserslist": "cli.js"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "engines": {
+                "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
             }
         },
-        "node_modules/@babel/plugin-transform-async-to-generator": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.17.12.tgz",
-            "integrity": "sha512-J8dbrWIOO3orDzir57NRsjg4uxucvhby0L/KZuGsWDj0g7twWK3g7JhJhOrXtuXiw8MeiSdJ3E0OW9H8LYEzLQ==",
+        "node_modules/buffer-from": {
+            "version": "1.1.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-remap-async-to-generator": "^7.16.8"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT",
+            "optional": true,
+            "peer": true
         },
-        "node_modules/@babel/plugin-transform-block-scoped-functions": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.16.7.tgz",
-            "integrity": "sha512-JUuzlzmF40Z9cXyytcbZEZKckgrQzChbQJw/5PuEHYeqzCsvebDx0K0jWnIIVcmmDOAVctCgnYs0pMcrYj2zJg==",
+        "node_modules/camelcase-css": {
+            "version": "2.0.1",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">= 6"
             }
         },
-        "node_modules/@babel/plugin-transform-block-scoping": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.18.4.tgz",
-            "integrity": "sha512-+Hq10ye+jlvLEogSOtq4mKvtk7qwcUQ1f0Mrueai866C82f844Yom2cttfJdMdqRLTxWpsbfbkIkOIfovyUQXw==",
+        "node_modules/caniuse-lite": {
+            "version": "1.0.30001679",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/browserslist"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "CC-BY-4.0"
         },
-        "node_modules/@babel/plugin-transform-classes": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.18.4.tgz",
-            "integrity": "sha512-e42NSG2mlKWgxKUAD9EJJSkZxR67+wZqzNxLSpc51T8tRU5SLFHsPmgYR5yr7sdgX4u+iHA1C5VafJ6AyImV3A==",
+        "node_modules/chokidar": {
+            "version": "3.6.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-environment-visitor": "^7.18.2",
-                "@babel/helper-function-name": "^7.17.9",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-replace-supers": "^7.18.2",
-                "@babel/helper-split-export-declaration": "^7.16.7",
-                "globals": "^11.1.0"
+                "anymatch": "~3.1.2",
+                "braces": "~3.0.2",
+                "glob-parent": "~5.1.2",
+                "is-binary-path": "~2.1.0",
+                "is-glob": "~4.0.1",
+                "normalize-path": "~3.0.0",
+                "readdirp": "~3.6.0"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">= 8.10.0"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://paulmillr.com/funding/"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.2"
             }
         },
-        "node_modules/@babel/plugin-transform-computed-properties": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.17.12.tgz",
-            "integrity": "sha512-a7XINeplB5cQUWMg1E/GI1tFz3LfK021IjV1rj1ypE+R7jHm+pIHmHl25VNkZxtx9uuYp7ThGk8fur1HHG7PgQ==",
+        "node_modules/color-convert": {
+            "version": "2.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "color-name": "~1.1.4"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=7.0.0"
             }
         },
-        "node_modules/@babel/plugin-transform-destructuring": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.18.0.tgz",
-            "integrity": "sha512-Mo69klS79z6KEfrLg/1WkmVnB8javh75HX4pi2btjvlIoasuxilEyjtsQW6XPrubNd7AQy0MMaNIaQE4e7+PQw==",
+        "node_modules/color-name": {
+            "version": "1.1.4",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/cross-spawn": {
+            "version": "7.0.5",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "path-key": "^3.1.0",
+                "shebang-command": "^2.0.0",
+                "which": "^2.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/plugin-transform-dotall-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.16.7.tgz",
-            "integrity": "sha512-Lyttaao2SjZF6Pf4vk1dVKv8YypMpomAbygW+mU5cYP3S5cWTfCJjG8xV6CFdzGFlfWK81IjL9viiTvpb6G7gQ==",
+        "node_modules/cssesc": {
+            "version": "3.0.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-regexp-features-plugin": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
+            "license": "MIT",
+            "bin": {
+                "cssesc": "bin/cssesc"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=4"
             }
         },
-        "node_modules/@babel/plugin-transform-duplicate-keys": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.17.12.tgz",
-            "integrity": "sha512-EA5eYFUG6xeerdabina/xIoB95jJ17mAkR8ivx6ZSu9frKShBjpOGZPn511MTDTkiCO+zXnzNczvUM69YSf3Zw==",
+        "node_modules/didyoumean": {
+            "version": "1.2.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "Apache-2.0"
         },
-        "node_modules/@babel/plugin-transform-exponentiation-operator": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.16.7.tgz",
-            "integrity": "sha512-8UYLSlyLgRixQvlYH3J2ekXFHDFLQutdy7FfFAMm3CPZ6q9wHCwnUyiXpQCe3gVVnQlHc5nsuiEVziteRNTXEA==",
+        "node_modules/dlv": {
+            "version": "1.1.3",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-builder-binary-assignment-operator-visitor": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
+            "license": "MIT"
+        },
+        "node_modules/eastasianwidth": {
+            "version": "0.2.0",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/electron-to-chromium": {
+            "version": "1.5.55",
+            "dev": true,
+            "license": "ISC"
+        },
+        "node_modules/emoji-regex": {
+            "version": "8.0.0",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/esbuild": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "bin": {
+                "esbuild": "bin/esbuild"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=12"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "optionalDependencies": {
+                "@esbuild/aix-ppc64": "0.21.5",
+                "@esbuild/android-arm": "0.21.5",
+                "@esbuild/android-arm64": "0.21.5",
+                "@esbuild/android-x64": "0.21.5",
+                "@esbuild/darwin-arm64": "0.21.5",
+                "@esbuild/darwin-x64": "0.21.5",
+                "@esbuild/freebsd-arm64": "0.21.5",
+                "@esbuild/freebsd-x64": "0.21.5",
+                "@esbuild/linux-arm": "0.21.5",
+                "@esbuild/linux-arm64": "0.21.5",
+                "@esbuild/linux-ia32": "0.21.5",
+                "@esbuild/linux-loong64": "0.21.5",
+                "@esbuild/linux-mips64el": "0.21.5",
+                "@esbuild/linux-ppc64": "0.21.5",
+                "@esbuild/linux-riscv64": "0.21.5",
+                "@esbuild/linux-s390x": "0.21.5",
+                "@esbuild/linux-x64": "0.21.5",
+                "@esbuild/netbsd-x64": "0.21.5",
+                "@esbuild/openbsd-x64": "0.21.5",
+                "@esbuild/sunos-x64": "0.21.5",
+                "@esbuild/win32-arm64": "0.21.5",
+                "@esbuild/win32-ia32": "0.21.5",
+                "@esbuild/win32-x64": "0.21.5"
             }
         },
-        "node_modules/@babel/plugin-transform-for-of": {
-            "version": "7.18.1",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.18.1.tgz",
-            "integrity": "sha512-+TTB5XwvJ5hZbO8xvl2H4XaMDOAK57zF4miuC9qQJgysPNEAZZ9Z69rdF5LJkozGdZrjBIUAIyKUWRMmebI7vg==",
+        "node_modules/escalade": {
+            "version": "3.2.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=6"
             }
         },
-        "node_modules/@babel/plugin-transform-function-name": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.16.7.tgz",
-            "integrity": "sha512-SU/C68YVwTRxqWj5kgsbKINakGag0KTgq9f2iZEXdStoAbOzLHEBRYzImmA6yFo8YZhJVflvXmIHUO7GWHmxxA==",
+        "node_modules/fast-glob": {
+            "version": "3.3.2",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-compilation-targets": "^7.16.7",
-                "@babel/helper-function-name": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
+                "@nodelib/fs.stat": "^2.0.2",
+                "@nodelib/fs.walk": "^1.2.3",
+                "glob-parent": "^5.1.2",
+                "merge2": "^1.3.0",
+                "micromatch": "^4.0.4"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=8.6.0"
             }
         },
-        "node_modules/@babel/plugin-transform-literals": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.17.12.tgz",
-            "integrity": "sha512-8iRkvaTjJciWycPIZ9k9duu663FT7VrBdNqNgxnVXEFwOIp55JWcZd23VBRySYbnS3PwQ3rGiabJBBBGj5APmQ==",
+        "node_modules/fastq": {
+            "version": "1.17.1",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "reusify": "^1.0.4"
             }
         },
-        "node_modules/@babel/plugin-transform-member-expression-literals": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.16.7.tgz",
-            "integrity": "sha512-mBruRMbktKQwbxaJof32LT9KLy2f3gH+27a5XSuXo6h7R3vqltl0PgZ80C8ZMKw98Bf8bqt6BEVi3svOh2PzMw==",
+        "node_modules/fill-range": {
+            "version": "7.1.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
+                "to-regex-range": "^5.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=8"
             }
         },
-        "node_modules/@babel/plugin-transform-modules-amd": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.18.0.tgz",
-            "integrity": "sha512-h8FjOlYmdZwl7Xm2Ug4iX2j7Qy63NANI+NQVWQzv6r25fqgg7k2dZl03p95kvqNclglHs4FZ+isv4p1uXMA+QA==",
+        "node_modules/foreground-child": {
+            "version": "3.3.0",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
+                "cross-spawn": "^7.0.0",
+                "signal-exit": "^4.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=14"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
             }
         },
-        "node_modules/@babel/plugin-transform-modules-commonjs": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.18.2.tgz",
-            "integrity": "sha512-f5A865gFPAJAEE0K7F/+nm5CmAE3y8AWlMBG9unu5j9+tk50UQVK0QS8RNxSp7MJf0wh97uYyLWt3Zvu71zyOQ==",
+        "node_modules/foreground-child/node_modules/signal-exit": {
+            "version": "4.1.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-simple-access": "^7.18.2",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
-            },
+            "license": "ISC",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=14"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
             }
         },
-        "node_modules/@babel/plugin-transform-modules-systemjs": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.18.4.tgz",
-            "integrity": "sha512-lH2UaQaHVOAeYrUUuZ8i38o76J/FnO8vu21OE+tD1MyP9lxdZoSfz+pDbWkq46GogUrdrMz3tiz/FYGB+bVThg==",
+        "node_modules/fraction.js": {
+            "version": "4.3.7",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-hoist-variables": "^7.16.7",
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-validator-identifier": "^7.16.7",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
+                "node": "*"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "type": "patreon",
+                "url": "https://github.com/sponsors/rawify"
             }
         },
-        "node_modules/@babel/plugin-transform-modules-umd": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.18.0.tgz",
-            "integrity": "sha512-d/zZ8I3BWli1tmROLxXLc9A6YXvGK8egMxHp+E/rRwMh1Kip0AP77VwZae3snEJ33iiWwvNv2+UIIhfalqhzZA==",
+        "node_modules/fsevents": {
+            "version": "2.3.3",
+            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+            "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
+            "hasInstallScript": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
             }
         },
-        "node_modules/@babel/plugin-transform-named-capturing-groups-regex": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.17.12.tgz",
-            "integrity": "sha512-vWoWFM5CKaTeHrdUJ/3SIOTRV+MBVGybOC9mhJkaprGNt5demMymDW24yC74avb915/mIRe3TgNb/d8idvnCRA==",
+        "node_modules/function-bind": {
+            "version": "1.1.2",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-regexp-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0"
+            "license": "MIT",
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
             }
         },
-        "node_modules/@babel/plugin-transform-new-target": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.17.12.tgz",
-            "integrity": "sha512-CaOtzk2fDYisbjAD4Sd1MTKGVIpRtx9bWLyj24Y/k6p4s4gQ3CqDGJauFJxt8M/LEx003d0i3klVqnN73qvK3w==",
+        "node_modules/glob-parent": {
+            "version": "5.1.2",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "is-glob": "^4.0.1"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">= 6"
             }
         },
-        "node_modules/@babel/plugin-transform-object-super": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.16.7.tgz",
-            "integrity": "sha512-14J1feiQVWaGvRxj2WjyMuXS2jsBkgB3MdSN5HuC2G5nRspa5RK9COcs82Pwy5BuGcjb+fYaUj94mYcOj7rCvw==",
+        "node_modules/hasown": {
+            "version": "2.0.2",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/helper-replace-supers": "^7.16.7"
+                "function-bind": "^1.1.2"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">= 0.4"
             }
         },
-        "node_modules/@babel/plugin-transform-parameters": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.17.12.tgz",
-            "integrity": "sha512-6qW4rWo1cyCdq1FkYri7AHpauchbGLXpdwnYsfxFb+KtddHENfsY5JZb35xUwkK5opOLcJ3BNd2l7PhRYGlwIA==",
+        "node_modules/hydefront": {
+            "version": "3.4.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/plugin-transform-property-literals": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.16.7.tgz",
-            "integrity": "sha512-z4FGr9NMGdoIl1RqavCqGG+ZuYjfZ/hkCIeuH6Do7tXmSm0ls11nYVSJqFEUOSJbDab5wC6lRE/w6YjVcr6Hqw==",
+        "node_modules/is-binary-path": {
+            "version": "2.1.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
+                "binary-extensions": "^2.0.0"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=8"
             }
         },
-        "node_modules/@babel/plugin-transform-regenerator": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.18.0.tgz",
-            "integrity": "sha512-C8YdRw9uzx25HSIzwA7EM7YP0FhCe5wNvJbZzjVNHHPGVcDJ3Aie+qGYYdS1oVQgn+B3eAIJbWFLrJ4Jipv7nw==",
+        "node_modules/is-core-module": {
+            "version": "2.15.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "regenerator-transform": "^0.15.0"
+                "hasown": "^2.0.2"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">= 0.4"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
             }
         },
-        "node_modules/@babel/plugin-transform-reserved-words": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.17.12.tgz",
-            "integrity": "sha512-1KYqwbJV3Co03NIi14uEHW8P50Md6KqFgt0FfpHdK6oyAHQVTosgPuPSiWud1HX0oYJ1hGRRlk0fP87jFpqXZA==",
+        "node_modules/is-extglob": {
+            "version": "2.1.1",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@babel/plugin-transform-runtime": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.18.2.tgz",
-            "integrity": "sha512-mr1ufuRMfS52ttq+1G1PD8OJNqgcTFjq3hwn8SZ5n1x1pBhi0E36rYMdTK0TsKtApJ4lDEdfXJwtGobQMHSMPg==",
+        "node_modules/is-fullwidth-code-point": {
+            "version": "3.0.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "babel-plugin-polyfill-corejs2": "^0.3.0",
-                "babel-plugin-polyfill-corejs3": "^0.5.0",
-                "babel-plugin-polyfill-regenerator": "^0.3.0",
-                "semver": "^6.3.0"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
-        },
-        "node_modules/@babel/plugin-transform-runtime/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-            "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
+                "node": ">=8"
             }
         },
-        "node_modules/@babel/plugin-transform-shorthand-properties": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.16.7.tgz",
-            "integrity": "sha512-hah2+FEnoRoATdIb05IOXf+4GzXYTq75TVhIn1PewihbpyrNWUt2JbudKQOETWw6QpLe+AIUpJ5MVLYTQbeeUg==",
+        "node_modules/is-glob": {
+            "version": "4.0.3",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
+                "is-extglob": "^2.1.1"
             },
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@babel/plugin-transform-spread": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.17.12.tgz",
-            "integrity": "sha512-9pgmuQAtFi3lpNUstvG9nGfk9DkrdmWNp9KeKPFmuZCpEnxRzYlS8JgwPjYj+1AWDOSvoGN0H30p1cBOmT/Svg==",
+        "node_modules/is-number": {
+            "version": "7.0.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=0.12.0"
             }
         },
-        "node_modules/@babel/plugin-transform-sticky-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.16.7.tgz",
-            "integrity": "sha512-NJa0Bd/87QV5NZZzTuZG5BPJjLYadeSZ9fO6oOUoL4iQx+9EEuw/eEM92SrsT19Yc2jgB1u1hsjqDtH02c3Drw==",
+        "node_modules/isexe": {
+            "version": "2.0.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "ISC"
         },
-        "node_modules/@babel/plugin-transform-template-literals": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.18.2.tgz",
-            "integrity": "sha512-/cmuBVw9sZBGZVOMkpAEaVLwm4JmK2GZ1dFKOGGpMzEHWFmyZZ59lUU0PdRr8YNYeQdNzTDwuxP2X2gzydTc9g==",
+        "node_modules/jackspeak": {
+            "version": "3.4.3",
             "dev": true,
+            "license": "BlueOak-1.0.0",
             "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
+                "@isaacs/cliui": "^8.0.2"
             },
-            "engines": {
-                "node": ">=6.9.0"
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "optionalDependencies": {
+                "@pkgjs/parseargs": "^0.11.0"
             }
         },
-        "node_modules/@babel/plugin-transform-typeof-symbol": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.17.12.tgz",
-            "integrity": "sha512-Q8y+Jp7ZdtSPXCThB6zjQ74N3lj0f6TDh1Hnf5B+sYlzQ8i5Pjp8gW0My79iekSpT4WnI06blqP6DT0OmaXXmw==",
+        "node_modules/jiti": {
+            "version": "1.21.6",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "license": "MIT",
+            "bin": {
+                "jiti": "bin/jiti.js"
             }
         },
-        "node_modules/@babel/plugin-transform-unicode-escapes": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.16.7.tgz",
-            "integrity": "sha512-TAV5IGahIz3yZ9/Hfv35TV2xEm+kaBDaZQCn2S/hG9/CZ0DktxJv9eKfPc7yYCvOYR4JGx1h8C+jcSOvgaaI/Q==",
+        "node_modules/lilconfig": {
+            "version": "2.1.0",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+                "node": ">=10"
             }
         },
-        "node_modules/@babel/plugin-transform-unicode-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.16.7.tgz",
-            "integrity": "sha512-oC5tYYKw56HO75KZVLQ+R/Nl3Hro9kf8iG0hXoaHP7tjAyCpvqBiSNe6vGrZni1Z6MggmUOC6A7VP7AVmw225Q==",
+        "node_modules/lines-and-columns": {
+            "version": "1.2.4",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-create-regexp-features-plugin": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
+        },
+        "node_modules/lodash.castarray": {
+            "version": "4.4.0",
+            "dev": true,
+            "license": "MIT"
         },
-        "node_modules/@babel/preset-env": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.18.2.tgz",
-            "integrity": "sha512-PfpdxotV6afmXMU47S08F9ZKIm2bJIQ0YbAAtDfIENX7G1NUAXigLREh69CWDjtgUy7dYn7bsMzkgdtAlmS68Q==",
+        "node_modules/lodash.isplainobject": {
+            "version": "4.0.6",
             "dev": true,
-            "dependencies": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-compilation-targets": "^7.18.2",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-validator-option": "^7.16.7",
-                "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.17.12",
-                "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.17.12",
-                "@babel/plugin-proposal-async-generator-functions": "^7.17.12",
-                "@babel/plugin-proposal-class-properties": "^7.17.12",
-                "@babel/plugin-proposal-class-static-block": "^7.18.0",
-                "@babel/plugin-proposal-dynamic-import": "^7.16.7",
-                "@babel/plugin-proposal-export-namespace-from": "^7.17.12",
-                "@babel/plugin-proposal-json-strings": "^7.17.12",
-                "@babel/plugin-proposal-logical-assignment-operators": "^7.17.12",
-                "@babel/plugin-proposal-nullish-coalescing-operator": "^7.17.12",
-                "@babel/plugin-proposal-numeric-separator": "^7.16.7",
-                "@babel/plugin-proposal-object-rest-spread": "^7.18.0",
-                "@babel/plugin-proposal-optional-catch-binding": "^7.16.7",
-                "@babel/plugin-proposal-optional-chaining": "^7.17.12",
-                "@babel/plugin-proposal-private-methods": "^7.17.12",
-                "@babel/plugin-proposal-private-property-in-object": "^7.17.12",
-                "@babel/plugin-proposal-unicode-property-regex": "^7.17.12",
-                "@babel/plugin-syntax-async-generators": "^7.8.4",
-                "@babel/plugin-syntax-class-properties": "^7.12.13",
-                "@babel/plugin-syntax-class-static-block": "^7.14.5",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-                "@babel/plugin-syntax-export-namespace-from": "^7.8.3",
-                "@babel/plugin-syntax-import-assertions": "^7.17.12",
-                "@babel/plugin-syntax-json-strings": "^7.8.3",
-                "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4",
-                "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3",
-                "@babel/plugin-syntax-numeric-separator": "^7.10.4",
-                "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
-                "@babel/plugin-syntax-optional-catch-binding": "^7.8.3",
-                "@babel/plugin-syntax-optional-chaining": "^7.8.3",
-                "@babel/plugin-syntax-private-property-in-object": "^7.14.5",
-                "@babel/plugin-syntax-top-level-await": "^7.14.5",
-                "@babel/plugin-transform-arrow-functions": "^7.17.12",
-                "@babel/plugin-transform-async-to-generator": "^7.17.12",
-                "@babel/plugin-transform-block-scoped-functions": "^7.16.7",
-                "@babel/plugin-transform-block-scoping": "^7.17.12",
-                "@babel/plugin-transform-classes": "^7.17.12",
-                "@babel/plugin-transform-computed-properties": "^7.17.12",
-                "@babel/plugin-transform-destructuring": "^7.18.0",
-                "@babel/plugin-transform-dotall-regex": "^7.16.7",
-                "@babel/plugin-transform-duplicate-keys": "^7.17.12",
-                "@babel/plugin-transform-exponentiation-operator": "^7.16.7",
-                "@babel/plugin-transform-for-of": "^7.18.1",
-                "@babel/plugin-transform-function-name": "^7.16.7",
-                "@babel/plugin-transform-literals": "^7.17.12",
-                "@babel/plugin-transform-member-expression-literals": "^7.16.7",
-                "@babel/plugin-transform-modules-amd": "^7.18.0",
-                "@babel/plugin-transform-modules-commonjs": "^7.18.2",
-                "@babel/plugin-transform-modules-systemjs": "^7.18.0",
-                "@babel/plugin-transform-modules-umd": "^7.18.0",
-                "@babel/plugin-transform-named-capturing-groups-regex": "^7.17.12",
-                "@babel/plugin-transform-new-target": "^7.17.12",
-                "@babel/plugin-transform-object-super": "^7.16.7",
-                "@babel/plugin-transform-parameters": "^7.17.12",
-                "@babel/plugin-transform-property-literals": "^7.16.7",
-                "@babel/plugin-transform-regenerator": "^7.18.0",
-                "@babel/plugin-transform-reserved-words": "^7.17.12",
-                "@babel/plugin-transform-shorthand-properties": "^7.16.7",
-                "@babel/plugin-transform-spread": "^7.17.12",
-                "@babel/plugin-transform-sticky-regex": "^7.16.7",
-                "@babel/plugin-transform-template-literals": "^7.18.2",
-                "@babel/plugin-transform-typeof-symbol": "^7.17.12",
-                "@babel/plugin-transform-unicode-escapes": "^7.16.7",
-                "@babel/plugin-transform-unicode-regex": "^7.16.7",
-                "@babel/preset-modules": "^0.1.5",
-                "@babel/types": "^7.18.2",
-                "babel-plugin-polyfill-corejs2": "^0.3.0",
-                "babel-plugin-polyfill-corejs3": "^0.5.0",
-                "babel-plugin-polyfill-regenerator": "^0.3.0",
-                "core-js-compat": "^3.22.1",
-                "semver": "^6.3.0"
-            },
-            "engines": {
-                "node": ">=6.9.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/preset-env/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+        "node_modules/lodash.merge": {
+            "version": "4.6.2",
             "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
-            }
+            "license": "MIT"
         },
-        "node_modules/@babel/preset-modules": {
-            "version": "0.1.5",
-            "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.5.tgz",
-            "integrity": "sha512-A57th6YRG7oR3cq/yt/Y84MvGgE0eJG2F1JLhKuyG+jFxEgrd/HAMJatiFtmOiZurz+0DkrvbheCLaV5f2JfjA==",
+        "node_modules/merge2": {
+            "version": "1.4.1",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-plugin-utils": "^7.0.0",
-                "@babel/plugin-proposal-unicode-property-regex": "^7.4.4",
-                "@babel/plugin-transform-dotall-regex": "^7.4.4",
-                "@babel/types": "^7.4.4",
-                "esutils": "^2.0.2"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "license": "MIT",
+            "engines": {
+                "node": ">= 8"
             }
         },
-        "node_modules/@babel/runtime": {
-            "version": "7.18.3",
-            "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.18.3.tgz",
-            "integrity": "sha512-38Y8f7YUhce/K7RMwTp7m0uCumpv9hZkitCbBClqQIow1qSbCvGkcegKOXpEWCQLfWmevgRiWokZ1GkpfhbZug==",
+        "node_modules/micromatch": {
+            "version": "4.0.8",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "regenerator-runtime": "^0.13.4"
+                "braces": "^3.0.3",
+                "picomatch": "^2.3.1"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=8.6"
             }
         },
-        "node_modules/@babel/template": {
-            "version": "7.22.15",
-            "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.22.15.tgz",
-            "integrity": "sha512-QPErUVm4uyJa60rkI73qneDacvdvzxshT3kksGqlGWYdOTIUOwJ7RDUL8sGqslY1uXWSL6xMFKEXDS3ox2uF0w==",
+        "node_modules/minipass": {
+            "version": "7.1.2",
             "dev": true,
-            "dependencies": {
-                "@babel/code-frame": "^7.22.13",
-                "@babel/parser": "^7.22.15",
-                "@babel/types": "^7.22.15"
-            },
+            "license": "ISC",
             "engines": {
-                "node": ">=6.9.0"
+                "node": ">=16 || 14 >=14.17"
             }
         },
-        "node_modules/@babel/traverse": {
-            "version": "7.23.2",
-            "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.23.2.tgz",
-            "integrity": "sha512-azpe59SQ48qG6nu2CzcMLbxUudtN+dOM9kDbUqGq3HXUJRlo7i8fvPoxQUzYgLZ4cMVmuZgm8vvBpNeRhd6XSw==",
+        "node_modules/mz": {
+            "version": "2.7.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/code-frame": "^7.22.13",
-                "@babel/generator": "^7.23.0",
-                "@babel/helper-environment-visitor": "^7.22.20",
-                "@babel/helper-function-name": "^7.23.0",
-                "@babel/helper-hoist-variables": "^7.22.5",
-                "@babel/helper-split-export-declaration": "^7.22.6",
-                "@babel/parser": "^7.23.0",
-                "@babel/types": "^7.23.0",
-                "debug": "^4.1.0",
-                "globals": "^11.1.0"
-            },
-            "engines": {
-                "node": ">=6.9.0"
+                "any-promise": "^1.0.0",
+                "object-assign": "^4.0.1",
+                "thenify-all": "^1.0.0"
             }
         },
-        "node_modules/@babel/types": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.23.0.tgz",
-            "integrity": "sha512-0oIyUfKoI3mSqMvsxBdclDwxXKXAUA8v/apZbc+iSyARYou1o8ZGDxbUYyLFoW2arqS2jDGqJuZvv1d/io1axg==",
+        "node_modules/nanoid": {
+            "version": "3.3.7",
             "dev": true,
-            "dependencies": {
-                "@babel/helper-string-parser": "^7.22.5",
-                "@babel/helper-validator-identifier": "^7.22.20",
-                "to-fast-properties": "^2.0.0"
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "bin": {
+                "nanoid": "bin/nanoid.cjs"
             },
             "engines": {
-                "node": ">=6.9.0"
+                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
             }
         },
-        "node_modules/@colors/colors": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
-            "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
+        "node_modules/node-releases": {
+            "version": "2.0.18",
             "dev": true,
-            "optional": true,
+            "license": "MIT"
+        },
+        "node_modules/normalize-path": {
+            "version": "3.0.0",
+            "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=0.1.90"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@discoveryjs/json-ext": {
-            "version": "0.5.7",
-            "resolved": "https://registry.npmjs.org/@discoveryjs/json-ext/-/json-ext-0.5.7.tgz",
-            "integrity": "sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw==",
+        "node_modules/normalize-range": {
+            "version": "0.1.2",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=10.0.0"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@isaacs/cliui": {
-            "version": "8.0.2",
-            "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
-            "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+        "node_modules/object-assign": {
+            "version": "4.1.1",
             "dev": true,
-            "dependencies": {
-                "string-width": "^5.1.2",
-                "string-width-cjs": "npm:string-width@^4.2.0",
-                "strip-ansi": "^7.0.1",
-                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
-                "wrap-ansi": "^8.1.0",
-                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=12"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz",
-            "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==",
+        "node_modules/object-hash": {
+            "version": "3.0.0",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+                "node": ">= 6"
             }
         },
-        "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
-            "version": "6.2.1",
-            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
-            "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+        "node_modules/package-json-from-dist": {
+            "version": "1.0.1",
+            "dev": true,
+            "license": "BlueOak-1.0.0"
+        },
+        "node_modules/path-key": {
+            "version": "3.1.1",
             "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+                "node": ">=8"
             }
         },
-        "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
-            "version": "9.2.2",
-            "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
-            "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
-            "dev": true
+        "node_modules/path-parse": {
+            "version": "1.0.7",
+            "dev": true,
+            "license": "MIT"
         },
-        "node_modules/@isaacs/cliui/node_modules/string-width": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
-            "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+        "node_modules/path-scurry": {
+            "version": "1.11.1",
             "dev": true,
+            "license": "BlueOak-1.0.0",
             "dependencies": {
-                "eastasianwidth": "^0.2.0",
-                "emoji-regex": "^9.2.2",
-                "strip-ansi": "^7.0.1"
+                "lru-cache": "^10.2.0",
+                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
             },
             "engines": {
-                "node": ">=12"
+                "node": ">=16 || 14 >=14.18"
             },
             "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
+                "url": "https://github.com/sponsors/isaacs"
             }
         },
-        "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
-            "version": "7.1.0",
-            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
-            "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+        "node_modules/path-scurry/node_modules/lru-cache": {
+            "version": "10.4.3",
             "dev": true,
-            "dependencies": {
-                "ansi-regex": "^6.0.1"
-            },
+            "license": "ISC"
+        },
+        "node_modules/picocolors": {
+            "version": "1.1.1",
+            "dev": true,
+            "license": "ISC"
+        },
+        "node_modules/picomatch": {
+            "version": "2.3.1",
+            "dev": true,
+            "license": "MIT",
             "engines": {
-                "node": ">=12"
+                "node": ">=8.6"
             },
             "funding": {
-                "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+                "url": "https://github.com/sponsors/jonschlinkert"
             }
         },
-        "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
-            "version": "8.1.0",
-            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
-            "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+        "node_modules/pify": {
+            "version": "2.3.0",
             "dev": true,
-            "dependencies": {
-                "ansi-styles": "^6.1.0",
-                "string-width": "^5.0.1",
-                "strip-ansi": "^7.0.1"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@jridgewell/gen-mapping": {
-            "version": "0.1.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.1.1.tgz",
-            "integrity": "sha512-sQXCasFk+U8lWYEe66WxRDOE9PjVz4vSM51fTu3Hw+ClTpUSQb718772vH3pyS5pShp6lvQM7SxgIDXXXmOX7w==",
+        "node_modules/pirates": {
+            "version": "4.0.6",
             "dev": true,
-            "dependencies": {
-                "@jridgewell/set-array": "^1.0.0",
-                "@jridgewell/sourcemap-codec": "^1.4.10"
-            },
+            "license": "MIT",
             "engines": {
-                "node": ">=6.0.0"
+                "node": ">= 6"
             }
         },
-        "node_modules/@jridgewell/resolve-uri": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.1.tgz",
-            "integrity": "sha512-dSYZh7HhCDtCKm4QakX0xFpsRDqjjtZf/kjI/v3T3Nwt5r8/qz/M19F9ySyOqU94SXBmeG9ttTul+YnR4LOxFA==",
+        "node_modules/postcss": {
+            "version": "8.4.48",
             "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/postcss"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
+            "dependencies": {
+                "nanoid": "^3.3.7",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
+            },
             "engines": {
-                "node": ">=6.0.0"
+                "node": "^10 || ^12 || >=14"
             }
         },
-        "node_modules/@jridgewell/set-array": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz",
-            "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==",
+        "node_modules/postcss-import": {
+            "version": "15.1.0",
             "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "postcss-value-parser": "^4.0.0",
+                "read-cache": "^1.0.0",
+                "resolve": "^1.1.7"
+            },
             "engines": {
-                "node": ">=6.0.0"
+                "node": ">=14.0.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.0.0"
             }
         },
-        "node_modules/@jridgewell/source-map": {
-            "version": "0.3.6",
-            "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.6.tgz",
-            "integrity": "sha512-1ZJTZebgqllO79ue2bm3rIGud/bOe0pP5BjSRCRxxYkEZS8STV7zN84UBbiYu7jy+eCKSnVIUgoWWE/tt+shMQ==",
+        "node_modules/postcss-js": {
+            "version": "4.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@jridgewell/gen-mapping": "^0.3.5",
-                "@jridgewell/trace-mapping": "^0.3.25"
+                "camelcase-css": "^2.0.1"
+            },
+            "engines": {
+                "node": "^12 || ^14 || >= 16"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/postcss/"
+            },
+            "peerDependencies": {
+                "postcss": "^8.4.21"
             }
         },
-        "node_modules/@jridgewell/source-map/node_modules/@jridgewell/gen-mapping": {
-            "version": "0.3.5",
-            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz",
-            "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==",
+        "node_modules/postcss-nested": {
+            "version": "6.2.0",
             "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
             "dependencies": {
-                "@jridgewell/set-array": "^1.2.1",
-                "@jridgewell/sourcemap-codec": "^1.4.10",
-                "@jridgewell/trace-mapping": "^0.3.24"
+                "postcss-selector-parser": "^6.1.1"
             },
             "engines": {
-                "node": ">=6.0.0"
+                "node": ">=12.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.14"
             }
         },
-        "node_modules/@jridgewell/sourcemap-codec": {
-            "version": "1.4.15",
-            "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz",
-            "integrity": "sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg==",
-            "dev": true
-        },
-        "node_modules/@jridgewell/trace-mapping": {
-            "version": "0.3.25",
-            "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz",
-            "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==",
+        "node_modules/postcss-nested/node_modules/postcss-selector-parser": {
+            "version": "6.1.2",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@jridgewell/resolve-uri": "^3.1.0",
-                "@jridgewell/sourcemap-codec": "^1.4.14"
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
             }
         },
-        "node_modules/@leichtgewicht/ip-codec": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/@leichtgewicht/ip-codec/-/ip-codec-2.0.4.tgz",
-            "integrity": "sha512-Hcv+nVC0kZnQ3tD9GVu5xSMR4VVYOteQIr/hwFPVEvPdlXqgGEuRjiheChHgdM+JyqdgNcmzZOX/tnl0JOiI7A==",
-            "dev": true
-        },
-        "node_modules/@nodelib/fs.scandir": {
-            "version": "2.1.5",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
-            "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+        "node_modules/postcss-selector-parser": {
+            "version": "6.0.10",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@nodelib/fs.stat": "2.0.5",
-                "run-parallel": "^1.1.9"
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
             },
             "engines": {
-                "node": ">= 8"
+                "node": ">=4"
             }
         },
-        "node_modules/@nodelib/fs.stat": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
-            "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+        "node_modules/postcss-value-parser": {
+            "version": "4.2.0",
             "dev": true,
-            "engines": {
-                "node": ">= 8"
-            }
+            "license": "MIT"
         },
-        "node_modules/@nodelib/fs.walk": {
-            "version": "1.2.8",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
-            "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+        "node_modules/prettier": {
+            "version": "3.3.3",
             "dev": true,
-            "dependencies": {
-                "@nodelib/fs.scandir": "2.1.5",
-                "fastq": "^1.6.0"
+            "license": "MIT",
+            "bin": {
+                "prettier": "bin/prettier.cjs"
             },
             "engines": {
-                "node": ">= 8"
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/prettier/prettier?sponsor=1"
             }
         },
-        "node_modules/@pkgjs/parseargs": {
-            "version": "0.11.0",
-            "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
-            "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+        "node_modules/queue-microtask": {
+            "version": "1.2.3",
             "dev": true,
-            "optional": true,
-            "engines": {
-                "node": ">=14"
-            }
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ],
+            "license": "MIT"
         },
-        "node_modules/@tailwindcss/typography": {
-            "version": "0.5.15",
-            "resolved": "https://registry.npmjs.org/@tailwindcss/typography/-/typography-0.5.15.tgz",
-            "integrity": "sha512-AqhlCXl+8grUz8uqExv5OTtgpjuVIwFTSXTrh8y9/pw6q2ek7fJ+Y8ZEVw7EB2DCcuCOtEjf9w3+J3rzts01uA==",
+        "node_modules/read-cache": {
+            "version": "1.0.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "lodash.castarray": "^4.4.0",
-                "lodash.isplainobject": "^4.0.6",
-                "lodash.merge": "^4.6.2",
-                "postcss-selector-parser": "6.0.10"
-            },
-            "peerDependencies": {
-                "tailwindcss": ">=3.0.0 || insiders || >=4.0.0-alpha.20"
+                "pify": "^2.3.0"
             }
         },
-        "node_modules/@trysound/sax": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/@trysound/sax/-/sax-0.2.0.tgz",
-            "integrity": "sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA==",
+        "node_modules/readdirp": {
+            "version": "3.6.0",
             "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "picomatch": "^2.2.1"
+            },
             "engines": {
-                "node": ">=10.13.0"
+                "node": ">=8.10.0"
             }
         },
-        "node_modules/@types/babel__core": {
-            "version": "7.1.19",
-            "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.1.19.tgz",
-            "integrity": "sha512-WEOTgRsbYkvA/KCsDwVEGkd7WAr1e3g31VHQ8zy5gul/V1qKullU/BU5I68X5v7V3GnB9eotmom4v5a5gjxorw==",
+        "node_modules/resolve": {
+            "version": "1.22.8",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/parser": "^7.1.0",
-                "@babel/types": "^7.0.0",
-                "@types/babel__generator": "*",
-                "@types/babel__template": "*",
-                "@types/babel__traverse": "*"
+                "is-core-module": "^2.13.0",
+                "path-parse": "^1.0.7",
+                "supports-preserve-symlinks-flag": "^1.0.0"
+            },
+            "bin": {
+                "resolve": "bin/resolve"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
             }
         },
-        "node_modules/@types/babel__generator": {
-            "version": "7.6.4",
-            "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.4.tgz",
-            "integrity": "sha512-tFkciB9j2K755yrTALxD44McOrk+gfpIpvC3sxHjRawj6PfnQxrse4Clq5y/Rq+G3mrBurMax/lG8Qn2t9mSsg==",
+        "node_modules/reusify": {
+            "version": "1.0.4",
             "dev": true,
-            "dependencies": {
-                "@babel/types": "^7.0.0"
+            "license": "MIT",
+            "engines": {
+                "iojs": ">=1.0.0",
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@types/babel__template": {
-            "version": "7.4.1",
-            "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.1.tgz",
-            "integrity": "sha512-azBFKemX6kMg5Io+/rdGT0dkGreboUVR0Cdm3fz9QJWpaQGJRQXl7C+6hOTCZcMll7KFyEQpgbYI2lHdsS4U7g==",
+        "node_modules/rollup": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
+            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
             "dev": true,
             "dependencies": {
-                "@babel/parser": "^7.1.0",
-                "@babel/types": "^7.0.0"
+                "@types/estree": "1.0.6"
+            },
+            "bin": {
+                "rollup": "dist/bin/rollup"
+            },
+            "engines": {
+                "node": ">=18.0.0",
+                "npm": ">=8.0.0"
+            },
+            "optionalDependencies": {
+                "@rollup/rollup-android-arm-eabi": "4.25.0",
+                "@rollup/rollup-android-arm64": "4.25.0",
+                "@rollup/rollup-darwin-arm64": "4.25.0",
+                "@rollup/rollup-darwin-x64": "4.25.0",
+                "@rollup/rollup-freebsd-arm64": "4.25.0",
+                "@rollup/rollup-freebsd-x64": "4.25.0",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
+                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
+                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
+                "@rollup/rollup-linux-arm64-musl": "4.25.0",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
+                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
+                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-musl": "4.25.0",
+                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
+                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
+                "@rollup/rollup-win32-x64-msvc": "4.25.0",
+                "fsevents": "~2.3.2"
             }
         },
-        "node_modules/@types/babel__traverse": {
-            "version": "7.17.1",
-            "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.17.1.tgz",
-            "integrity": "sha512-kVzjari1s2YVi77D3w1yuvohV2idweYXMCDzqBiVNN63TcDWrIlTVOYpqVrvbbyOE/IyzBoTKF0fdnLPEORFxA==",
+        "node_modules/run-parallel": {
+            "version": "1.2.0",
             "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ],
+            "license": "MIT",
             "dependencies": {
-                "@babel/types": "^7.3.0"
+                "queue-microtask": "^1.2.2"
             }
         },
-        "node_modules/@types/body-parser": {
-            "version": "1.19.2",
-            "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.2.tgz",
-            "integrity": "sha512-ALYone6pm6QmwZoAgeyNksccT9Q4AWZQ6PvfwR37GT6r6FWUPguq6sUmNGSMV2Wr761oQoBxwGGa6DR5o1DC9g==",
+        "node_modules/shebang-command": {
+            "version": "2.0.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/connect": "*",
-                "@types/node": "*"
+                "shebang-regex": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/bonjour": {
-            "version": "3.5.10",
-            "resolved": "https://registry.npmjs.org/@types/bonjour/-/bonjour-3.5.10.tgz",
-            "integrity": "sha512-p7ienRMiS41Nu2/igbJxxLDWrSZ0WxM8UQgCeO9KhoVF7cOVFkrKsiDr1EsJIla8vV3oEEjGcz11jc5yimhzZw==",
+        "node_modules/shebang-regex": {
+            "version": "3.0.0",
             "dev": true,
-            "dependencies": {
-                "@types/node": "*"
+            "license": "MIT",
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/clean-css": {
-            "version": "4.2.5",
-            "resolved": "https://registry.npmjs.org/@types/clean-css/-/clean-css-4.2.5.tgz",
-            "integrity": "sha512-NEzjkGGpbs9S9fgC4abuBvTpVwE3i+Acu9BBod3PUyjDVZcNsGx61b8r2PphR61QGPnn0JHVs5ey6/I4eTrkxw==",
+        "node_modules/source-map": {
+            "version": "0.6.1",
             "dev": true,
-            "dependencies": {
-                "@types/node": "*",
-                "source-map": "^0.6.0"
+            "license": "BSD-3-Clause",
+            "optional": true,
+            "peer": true,
+            "engines": {
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@types/connect": {
-            "version": "3.4.35",
-            "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.35.tgz",
-            "integrity": "sha512-cdeYyv4KWoEgpBISTxWvqYsVy444DOqehiF3fM3ne10AmJ62RSyNkUnxMJXHQWRQQX2eR94m5y1IZyDwBjV9FQ==",
+        "node_modules/source-map-js": {
+            "version": "1.2.1",
             "dev": true,
-            "dependencies": {
-                "@types/node": "*"
+            "license": "BSD-3-Clause",
+            "engines": {
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/@types/connect-history-api-fallback": {
-            "version": "1.3.5",
-            "resolved": "https://registry.npmjs.org/@types/connect-history-api-fallback/-/connect-history-api-fallback-1.3.5.tgz",
-            "integrity": "sha512-h8QJa8xSb1WD4fpKBDcATDNGXghFj6/3GRWG6dhmRcu0RX1Ubasur2Uvx5aeEwlf0MwblEC2bMzzMQntxnw/Cw==",
+        "node_modules/source-map-support": {
+            "version": "0.5.21",
             "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
             "dependencies": {
-                "@types/express-serve-static-core": "*",
-                "@types/node": "*"
+                "buffer-from": "^1.0.0",
+                "source-map": "^0.6.0"
             }
         },
-        "node_modules/@types/estree": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.5.tgz",
-            "integrity": "sha512-/kYRxGDLWzHOB7q+wtSUQlFrtcdUccpfy+X+9iMBpHK8QLLhx2wIPYuS5DYtR9Wa/YlZAbIovy7qVdB1Aq6Lyw==",
-            "dev": true
-        },
-        "node_modules/@types/express": {
-            "version": "4.17.13",
-            "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.13.tgz",
-            "integrity": "sha512-6bSZTPaTIACxn48l50SR+axgrqm6qXFIxrdAKaG6PaJk3+zuUr35hBlgT7vOmJcum+OEaIBLtHV/qloEAFITeA==",
-            "dev": true,
-            "dependencies": {
-                "@types/body-parser": "*",
-                "@types/express-serve-static-core": "^4.17.18",
-                "@types/qs": "*",
-                "@types/serve-static": "*"
-            }
-        },
-        "node_modules/@types/express-serve-static-core": {
-            "version": "4.17.29",
-            "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.17.29.tgz",
-            "integrity": "sha512-uMd++6dMKS32EOuw1Uli3e3BPgdLIXmezcfHv7N4c1s3gkhikBplORPpMq3fuWkxncZN1reb16d5n8yhQ80x7Q==",
-            "dev": true,
-            "dependencies": {
-                "@types/node": "*",
-                "@types/qs": "*",
-                "@types/range-parser": "*"
-            }
-        },
-        "node_modules/@types/glob": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/@types/glob/-/glob-7.2.0.tgz",
-            "integrity": "sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==",
+        "node_modules/string-width": {
+            "version": "4.2.3",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/minimatch": "*",
-                "@types/node": "*"
+                "emoji-regex": "^8.0.0",
+                "is-fullwidth-code-point": "^3.0.0",
+                "strip-ansi": "^6.0.1"
+            },
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/http-proxy": {
-            "version": "1.17.9",
-            "resolved": "https://registry.npmjs.org/@types/http-proxy/-/http-proxy-1.17.9.tgz",
-            "integrity": "sha512-QsbSjA/fSk7xB+UXlCT3wHBy5ai9wOcNDWwZAtud+jXhwOM3l+EYZh8Lng4+/6n8uar0J7xILzqftJdJ/Wdfkw==",
+        "node_modules/string-width-cjs": {
+            "name": "string-width",
+            "version": "4.2.3",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/node": "*"
+                "emoji-regex": "^8.0.0",
+                "is-fullwidth-code-point": "^3.0.0",
+                "strip-ansi": "^6.0.1"
+            },
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/imagemin": {
-            "version": "8.0.0",
-            "resolved": "https://registry.npmjs.org/@types/imagemin/-/imagemin-8.0.0.tgz",
-            "integrity": "sha512-B9X2CUeDv/uUeY9CqkzSTfmsLkeJP6PkmXlh4lODBbf9SwpmNuLS30WzUOi863dgsjY3zt3gY5q2F+UdifRi1A==",
+        "node_modules/strip-ansi": {
+            "version": "6.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/node": "*"
+                "ansi-regex": "^5.0.1"
+            },
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/imagemin-gifsicle": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-gifsicle/-/imagemin-gifsicle-7.0.1.tgz",
-            "integrity": "sha512-kUz6sUh0P95JOS0RGEaaemWUrASuw+dLsWIveK2UZJx74id/B9epgblMkCk/r5MjUWbZ83wFvacG5Rb/f97gyA==",
+        "node_modules/strip-ansi-cjs": {
+            "name": "strip-ansi",
+            "version": "6.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/imagemin": "*"
+                "ansi-regex": "^5.0.1"
+            },
+            "engines": {
+                "node": ">=8"
             }
         },
-        "node_modules/@types/imagemin-mozjpeg": {
-            "version": "8.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-mozjpeg/-/imagemin-mozjpeg-8.0.1.tgz",
-            "integrity": "sha512-kMQWEoKxxhlnH4POI3qfW9DjXlQfi80ux3l2b3j5R3eudSCoUIzKQLkfMjNJ6eMYnMWBcB+rfQOWqIzdIwFGKw==",
+        "node_modules/sucrase": {
+            "version": "3.35.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/imagemin": "*"
+                "@jridgewell/gen-mapping": "^0.3.2",
+                "commander": "^4.0.0",
+                "glob": "^10.3.10",
+                "lines-and-columns": "^1.1.6",
+                "mz": "^2.7.0",
+                "pirates": "^4.0.1",
+                "ts-interface-checker": "^0.1.9"
+            },
+            "bin": {
+                "sucrase": "bin/sucrase",
+                "sucrase-node": "bin/sucrase-node"
+            },
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
             }
         },
-        "node_modules/@types/imagemin-optipng": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-optipng/-/imagemin-optipng-5.2.1.tgz",
-            "integrity": "sha512-XCM/3q+HUL7v4zOqMI+dJ5dTxT+MUukY9KU49DSnYb/4yWtSMHJyADP+WHSMVzTR63J2ZvfUOzSilzBNEQW78g==",
+        "node_modules/sucrase/node_modules/brace-expansion": {
+            "version": "2.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/imagemin": "*"
+                "balanced-match": "^1.0.0"
             }
         },
-        "node_modules/@types/imagemin-svgo": {
-            "version": "8.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-svgo/-/imagemin-svgo-8.0.1.tgz",
-            "integrity": "sha512-YafkdrVAcr38U0Ln1C+L1n4SIZqC47VBHTyxCq7gTUSd1R9MdIvMcrljWlgU1M9O68WZDeQWUrKipKYfEOCOvQ==",
+        "node_modules/sucrase/node_modules/commander": {
+            "version": "4.1.1",
             "dev": true,
-            "dependencies": {
-                "@types/imagemin": "*",
-                "@types/svgo": "^1"
+            "license": "MIT",
+            "engines": {
+                "node": ">= 6"
             }
         },
-        "node_modules/@types/json-schema": {
-            "version": "7.0.11",
-            "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.11.tgz",
-            "integrity": "sha512-wOuvG1SN4Us4rez+tylwwwCV1psiNVOkJeM3AUWUNWg/jDQY2+HE/444y5gc+jBmRqASOm2Oeh5c1axHobwRKQ==",
-            "dev": true
-        },
-        "node_modules/@types/mime": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.2.tgz",
-            "integrity": "sha512-YATxVxgRqNH6nHEIsvg6k2Boc1JHI9ZbH5iWFFv/MTkchz3b1ieGDa5T0a9RznNdI0KhVbdbWSN+KWWrQZRxTw==",
-            "dev": true
-        },
-        "node_modules/@types/minimatch": {
-            "version": "3.0.5",
-            "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-3.0.5.tgz",
-            "integrity": "sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ==",
-            "dev": true
-        },
-        "node_modules/@types/node": {
-            "version": "18.0.6",
-            "resolved": "https://registry.npmjs.org/@types/node/-/node-18.0.6.tgz",
-            "integrity": "sha512-/xUq6H2aQm261exT6iZTMifUySEt4GR5KX8eYyY+C4MSNPqSh9oNIP7tz2GLKTlFaiBbgZNxffoR3CVRG+cljw==",
-            "dev": true
-        },
-        "node_modules/@types/parse-json": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/@types/parse-json/-/parse-json-4.0.0.tgz",
-            "integrity": "sha512-//oorEZjL6sbPcKUaCdIGlIUeH26mgzimjBB77G6XRgnDl/L5wOnpyBGRe/Mmf5CVW3PwEBE1NjiMZ/ssFh4wA==",
-            "dev": true
-        },
-        "node_modules/@types/qs": {
-            "version": "6.9.7",
-            "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.7.tgz",
-            "integrity": "sha512-FGa1F62FT09qcrueBA6qYTrJPVDzah9a+493+o2PCXsesWHIn27G98TsSMs3WPNbZIEj4+VJf6saSFpvD+3Zsw==",
-            "dev": true
-        },
-        "node_modules/@types/range-parser": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.4.tgz",
-            "integrity": "sha512-EEhsLsD6UsDM1yFhAvy0Cjr6VwmpMWqFBCb9w07wVugF7w9nfajxLuVmngTIpgS6svCnm6Vaw+MZhoDCKnOfsw==",
-            "dev": true
-        },
-        "node_modules/@types/retry": {
-            "version": "0.12.0",
-            "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",
-            "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",
-            "dev": true
-        },
-        "node_modules/@types/serve-index": {
-            "version": "1.9.1",
-            "resolved": "https://registry.npmjs.org/@types/serve-index/-/serve-index-1.9.1.tgz",
-            "integrity": "sha512-d/Hs3nWDxNL2xAczmOVZNj92YZCS6RGxfBPjKzuu/XirCgXdpKEb88dYNbrYGint6IVWLNP+yonwVAuRC0T2Dg==",
+        "node_modules/sucrase/node_modules/glob": {
+            "version": "10.4.5",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@types/express": "*"
+                "foreground-child": "^3.1.0",
+                "jackspeak": "^3.1.2",
+                "minimatch": "^9.0.4",
+                "minipass": "^7.1.2",
+                "package-json-from-dist": "^1.0.0",
+                "path-scurry": "^1.11.1"
+            },
+            "bin": {
+                "glob": "dist/esm/bin.mjs"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
             }
         },
-        "node_modules/@types/serve-static": {
-            "version": "1.13.10",
-            "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.13.10.tgz",
-            "integrity": "sha512-nCkHGI4w7ZgAdNkrEu0bv+4xNV/XDqW+DydknebMOQwkpDGx8G+HTlj7R7ABI8i8nKxVw0wtKPi1D+lPOkh4YQ==",
+        "node_modules/sucrase/node_modules/minimatch": {
+            "version": "9.0.5",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@types/mime": "^1",
-                "@types/node": "*"
+                "brace-expansion": "^2.0.1"
+            },
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
             }
         },
-        "node_modules/@types/sockjs": {
-            "version": "0.3.33",
-            "resolved": "https://registry.npmjs.org/@types/sockjs/-/sockjs-0.3.33.tgz",
-            "integrity": "sha512-f0KEEe05NvUnat+boPTZ0dgaLZ4SfSouXUgv5noUiefG2ajgKjmETo9ZJyuqsl7dfl2aHlLJUiki6B4ZYldiiw==",
+        "node_modules/supports-preserve-symlinks-flag": {
+            "version": "1.0.0",
             "dev": true,
-            "dependencies": {
-                "@types/node": "*"
+            "license": "MIT",
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
             }
         },
-        "node_modules/@types/svgo": {
-            "version": "1.3.6",
-            "resolved": "https://registry.npmjs.org/@types/svgo/-/svgo-1.3.6.tgz",
-            "integrity": "sha512-AZU7vQcy/4WFEuwnwsNsJnFwupIpbllH1++LXScN6uxT1Z4zPzdrWG97w4/I7eFKFTvfy/bHFStWjdBAg2Vjug==",
-            "dev": true
-        },
-        "node_modules/@types/ws": {
-            "version": "8.5.3",
-            "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.5.3.tgz",
-            "integrity": "sha512-6YOoWjruKj1uLf3INHH7D3qTXwFfEsg1kf3c0uDdSBJwfa/llkwIjrAGV7j7mVgGNbzTQ3HiHKKDXl6bJPD97w==",
+        "node_modules/tailwindcss": {
+            "version": "3.4.14",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@types/node": "*"
+                "@alloc/quick-lru": "^5.2.0",
+                "arg": "^5.0.2",
+                "chokidar": "^3.5.3",
+                "didyoumean": "^1.2.2",
+                "dlv": "^1.1.3",
+                "fast-glob": "^3.3.0",
+                "glob-parent": "^6.0.2",
+                "is-glob": "^4.0.3",
+                "jiti": "^1.21.0",
+                "lilconfig": "^2.1.0",
+                "micromatch": "^4.0.5",
+                "normalize-path": "^3.0.0",
+                "object-hash": "^3.0.0",
+                "picocolors": "^1.0.0",
+                "postcss": "^8.4.23",
+                "postcss-import": "^15.1.0",
+                "postcss-js": "^4.0.1",
+                "postcss-load-config": "^4.0.1",
+                "postcss-nested": "^6.0.1",
+                "postcss-selector-parser": "^6.0.11",
+                "resolve": "^1.22.2",
+                "sucrase": "^3.32.0"
+            },
+            "bin": {
+                "tailwind": "lib/cli.js",
+                "tailwindcss": "lib/cli.js"
+            },
+            "engines": {
+                "node": ">=14.0.0"
             }
         },
-        "node_modules/@webassemblyjs/ast": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.12.1.tgz",
-            "integrity": "sha512-EKfMUOPRRUTy5UII4qJDGPpqfwjOmZ5jeGFwid9mnoqIFK+e0vqoi1qH56JpmZSzEL53jKnNzScdmftJyG5xWg==",
+        "node_modules/tailwindcss/node_modules/glob-parent": {
+            "version": "6.0.2",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@webassemblyjs/helper-numbers": "1.11.6",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6"
+                "is-glob": "^4.0.3"
+            },
+            "engines": {
+                "node": ">=10.13.0"
             }
         },
-        "node_modules/@webassemblyjs/floating-point-hex-parser": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.11.6.tgz",
-            "integrity": "sha512-ejAj9hfRJ2XMsNHk/v6Fu2dGS+i4UaXBXGemOfQ/JfQ6mdQg/WXtwleQRLLS4OvfDhv8rYnVwH27YJLMyYsxhw==",
-            "dev": true
-        },
-        "node_modules/@webassemblyjs/helper-api-error": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.11.6.tgz",
-            "integrity": "sha512-o0YkoP4pVu4rN8aTJgAyj9hC2Sv5UlkzCHhxqWj8butaLvnpdc2jOwh4ewE6CX0txSfLn/UYaV/pheS2Txg//Q==",
-            "dev": true
-        },
-        "node_modules/@webassemblyjs/helper-buffer": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.12.1.tgz",
-            "integrity": "sha512-nzJwQw99DNDKr9BVCOZcLuJJUlqkJh+kVzVl6Fmq/tI5ZtEyWT1KZMyOXltXLZJmDtvLCDgwsyrkohEtopTXCw==",
-            "dev": true
-        },
-        "node_modules/@webassemblyjs/helper-numbers": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.11.6.tgz",
-            "integrity": "sha512-vUIhZ8LZoIWHBohiEObxVm6hwP034jwmc9kuq5GdHZH0wiLVLIPcMCdpJzG4C11cHoQ25TFIQj9kaVADVX7N3g==",
+        "node_modules/tailwindcss/node_modules/postcss-load-config": {
+            "version": "4.0.2",
             "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "license": "MIT",
             "dependencies": {
-                "@webassemblyjs/floating-point-hex-parser": "1.11.6",
-                "@webassemblyjs/helper-api-error": "1.11.6",
-                "@xtuc/long": "4.2.2"
+                "lilconfig": "^3.0.0",
+                "yaml": "^2.3.4"
+            },
+            "engines": {
+                "node": ">= 14"
+            },
+            "peerDependencies": {
+                "postcss": ">=8.0.9",
+                "ts-node": ">=9.0.0"
+            },
+            "peerDependenciesMeta": {
+                "postcss": {
+                    "optional": true
+                },
+                "ts-node": {
+                    "optional": true
+                }
             }
         },
-        "node_modules/@webassemblyjs/helper-wasm-bytecode": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.11.6.tgz",
-            "integrity": "sha512-sFFHKwcmBprO9e7Icf0+gddyWYDViL8bpPjJJl0WHxCdETktXdmtWLGVzoHbqUcY4Be1LkNfwTmXOJUFZYSJdA==",
-            "dev": true
-        },
-        "node_modules/@webassemblyjs/helper-wasm-section": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.12.1.tgz",
-            "integrity": "sha512-Jif4vfB6FJlUlSbgEMHUyk1j234GTNG9dBJ4XJdOySoj518Xj0oGsNi59cUQF4RRMS9ouBUxDDdyBVfPTypa5g==",
+        "node_modules/tailwindcss/node_modules/postcss-load-config/node_modules/lilconfig": {
+            "version": "3.1.2",
             "dev": true,
-            "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/wasm-gen": "1.12.1"
+            "license": "MIT",
+            "engines": {
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/antonk52"
             }
         },
-        "node_modules/@webassemblyjs/ieee754": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.11.6.tgz",
-            "integrity": "sha512-LM4p2csPNvbij6U1f19v6WR56QZ8JcHg3QIJTlSwzFcmx6WSORicYj6I63f9yU1kEUtrpG+kjkiIAkevHpDXrg==",
+        "node_modules/tailwindcss/node_modules/postcss-selector-parser": {
+            "version": "6.1.2",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@xtuc/ieee754": "^1.2.0"
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
             }
         },
-        "node_modules/@webassemblyjs/leb128": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.11.6.tgz",
-            "integrity": "sha512-m7a0FhE67DQXgouf1tbN5XQcdWoNgaAuoULHIfGFIEVKA6tu/edls6XnIlkmS6FrXAquJRPni3ZZKjw6FSPjPQ==",
+        "node_modules/tailwindcss/node_modules/yaml": {
+            "version": "2.6.0",
             "dev": true,
-            "dependencies": {
-                "@xtuc/long": "4.2.2"
+            "license": "ISC",
+            "bin": {
+                "yaml": "bin.mjs"
+            },
+            "engines": {
+                "node": ">= 14"
             }
         },
-        "node_modules/@webassemblyjs/utf8": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.11.6.tgz",
-            "integrity": "sha512-vtXf2wTQ3+up9Zsg8sa2yWiQpzSsMyXj0qViVP6xKGCUT8p8YJ6HqI7l5eCnWx1T/FYdsv07HQs2wTFbbof/RA==",
-            "dev": true
-        },
-        "node_modules/@webassemblyjs/wasm-edit": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.12.1.tgz",
-            "integrity": "sha512-1DuwbVvADvS5mGnXbE+c9NfA8QRcZ6iKquqjjmR10k6o+zzsRVesil54DKexiowcFCPdr/Q0qaMgB01+SQ1u6g==",
+        "node_modules/terser": {
+            "version": "5.36.0",
             "dev": true,
+            "license": "BSD-2-Clause",
+            "optional": true,
+            "peer": true,
             "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/helper-wasm-section": "1.12.1",
-                "@webassemblyjs/wasm-gen": "1.12.1",
-                "@webassemblyjs/wasm-opt": "1.12.1",
-                "@webassemblyjs/wasm-parser": "1.12.1",
-                "@webassemblyjs/wast-printer": "1.12.1"
+                "@jridgewell/source-map": "^0.3.3",
+                "acorn": "^8.8.2",
+                "commander": "^2.20.0",
+                "source-map-support": "~0.5.20"
+            },
+            "bin": {
+                "terser": "bin/terser"
+            },
+            "engines": {
+                "node": ">=10"
             }
         },
-        "node_modules/@webassemblyjs/wasm-gen": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.12.1.tgz",
-            "integrity": "sha512-TDq4Ojh9fcohAw6OIMXqiIcTq5KUXTGRkVxbSo1hQnSy6lAM5GSdfwWeSxpAo0YzgsgF182E/U0mDNhuA0tW7w==",
+        "node_modules/terser/node_modules/commander": {
+            "version": "2.20.3",
             "dev": true,
-            "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/ieee754": "1.11.6",
-                "@webassemblyjs/leb128": "1.11.6",
-                "@webassemblyjs/utf8": "1.11.6"
-            }
+            "license": "MIT",
+            "optional": true,
+            "peer": true
         },
-        "node_modules/@webassemblyjs/wasm-opt": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.12.1.tgz",
-            "integrity": "sha512-Jg99j/2gG2iaz3hijw857AVYekZe2SAskcqlWIZXjji5WStnOpVoat3gQfT/Q5tb2djnCjBtMocY/Su1GfxPBg==",
+        "node_modules/thenify": {
+            "version": "3.3.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/wasm-gen": "1.12.1",
-                "@webassemblyjs/wasm-parser": "1.12.1"
+                "any-promise": "^1.0.0"
             }
         },
-        "node_modules/@webassemblyjs/wasm-parser": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.12.1.tgz",
-            "integrity": "sha512-xikIi7c2FHXysxXe3COrVUPSheuBtpcfhbpFj4gmu7KRLYOzANztwUU0IbsqvMqzuNK2+glRGWCEqZo1WCLyAQ==",
+        "node_modules/thenify-all": {
+            "version": "1.6.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-api-error": "1.11.6",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/ieee754": "1.11.6",
-                "@webassemblyjs/leb128": "1.11.6",
-                "@webassemblyjs/utf8": "1.11.6"
+                "thenify": ">= 3.1.0 < 4"
+            },
+            "engines": {
+                "node": ">=0.8"
             }
         },
-        "node_modules/@webassemblyjs/wast-printer": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.12.1.tgz",
-            "integrity": "sha512-+X4WAlOisVWQMikjbcvY2e0rwPsKQ9F688lksZhBcPycBBuii3O7m8FACbDMWDojpAqvjIncrG8J0XHKyQfVeA==",
+        "node_modules/to-regex-range": {
+            "version": "5.0.1",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@xtuc/long": "4.2.2"
+                "is-number": "^7.0.0"
+            },
+            "engines": {
+                "node": ">=8.0"
             }
         },
-        "node_modules/@webpack-cli/configtest": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/configtest/-/configtest-1.2.0.tgz",
-            "integrity": "sha512-4FB8Tj6xyVkyqjj1OaTqCjXYULB9FMkqQ8yGrZjRDrYh0nOE+7Lhs45WioWQQMV+ceFlE368Ukhe6xdvJM9Egg==",
+        "node_modules/ts-interface-checker": {
+            "version": "0.1.13",
             "dev": true,
-            "peerDependencies": {
-                "webpack": "4.x.x || 5.x.x",
-                "webpack-cli": "4.x.x"
-            }
+            "license": "Apache-2.0"
         },
-        "node_modules/@webpack-cli/info": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/info/-/info-1.5.0.tgz",
-            "integrity": "sha512-e8tSXZpw2hPl2uMJY6fsMswaok5FdlGNRTktvFk2sD8RjH0hE2+XistawJx1vmKteh4NmGmNUrp+Tb2w+udPcQ==",
+        "node_modules/undici-types": {
+            "version": "6.19.8",
             "dev": true,
-            "dependencies": {
-                "envinfo": "^7.7.3"
-            },
-            "peerDependencies": {
-                "webpack-cli": "4.x.x"
-            }
+            "license": "MIT",
+            "optional": true,
+            "peer": true
         },
-        "node_modules/@webpack-cli/serve": {
-            "version": "1.7.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/serve/-/serve-1.7.0.tgz",
-            "integrity": "sha512-oxnCNGj88fL+xzV+dacXs44HcDwf1ovs3AuEzvP7mqXw7fQntqIhQ1BRmynh4qEKQSSSRSWVyXRjmTbZIX9V2Q==",
-            "dev": true,
-            "peerDependencies": {
-                "webpack-cli": "4.x.x"
-            },
-            "peerDependenciesMeta": {
-                "webpack-dev-server": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/@xtuc/ieee754": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz",
-            "integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==",
-            "dev": true
-        },
-        "node_modules/@xtuc/long": {
-            "version": "4.2.2",
-            "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz",
-            "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==",
-            "dev": true
-        },
-        "node_modules/accepts": {
-            "version": "1.3.8",
-            "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
-            "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
-            "dev": true,
-            "dependencies": {
-                "mime-types": "~2.1.34",
-                "negotiator": "0.6.3"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/acorn": {
-            "version": "8.12.1",
-            "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.12.1.tgz",
-            "integrity": "sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==",
-            "dev": true,
-            "bin": {
-                "acorn": "bin/acorn"
-            },
-            "engines": {
-                "node": ">=0.4.0"
-            }
-        },
-        "node_modules/acorn-import-attributes": {
-            "version": "1.9.5",
-            "resolved": "https://registry.npmjs.org/acorn-import-attributes/-/acorn-import-attributes-1.9.5.tgz",
-            "integrity": "sha512-n02Vykv5uA3eHGM/Z2dQrcD56kL8TyDb2p1+0P83PClMnC/nc+anbQRhIOWnSq4Ke/KvDPrY3C9hDtC/A3eHnQ==",
-            "dev": true,
-            "peerDependencies": {
-                "acorn": "^8"
-            }
-        },
-        "node_modules/ajv": {
-            "version": "6.12.6",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
-            "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.1",
-                "fast-json-stable-stringify": "^2.0.0",
-                "json-schema-traverse": "^0.4.1",
-                "uri-js": "^4.2.2"
-            },
-            "funding": {
-                "type": "github",
-                "url": "https://github.com/sponsors/epoberezkin"
-            }
-        },
-        "node_modules/ajv-formats": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz",
-            "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==",
-            "dev": true,
-            "dependencies": {
-                "ajv": "^8.0.0"
-            },
-            "peerDependencies": {
-                "ajv": "^8.0.0"
-            },
-            "peerDependenciesMeta": {
-                "ajv": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/ajv-formats/node_modules/ajv": {
-            "version": "8.11.0",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-            "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.1",
-                "json-schema-traverse": "^1.0.0",
-                "require-from-string": "^2.0.2",
-                "uri-js": "^4.2.2"
-            },
-            "funding": {
-                "type": "github",
-                "url": "https://github.com/sponsors/epoberezkin"
-            }
-        },
-        "node_modules/ajv-formats/node_modules/json-schema-traverse": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-            "dev": true
-        },
-        "node_modules/ajv-keywords": {
-            "version": "3.5.2",
-            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.5.2.tgz",
-            "integrity": "sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==",
-            "dev": true,
-            "peerDependencies": {
-                "ajv": "^6.9.1"
-            }
-        },
-        "node_modules/ansi-html-community": {
-            "version": "0.0.8",
-            "resolved": "https://registry.npmjs.org/ansi-html-community/-/ansi-html-community-0.0.8.tgz",
-            "integrity": "sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw==",
-            "dev": true,
-            "engines": [
-                "node >= 0.8.0"
-            ],
-            "bin": {
-                "ansi-html": "bin/ansi-html"
-            }
-        },
-        "node_modules/ansi-regex": {
-            "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-            "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/ansi-styles": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-            "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-            "dev": true,
-            "dependencies": {
-                "color-convert": "^2.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-            }
-        },
-        "node_modules/ansi-styles/node_modules/color-convert": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-            "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-            "dev": true,
-            "dependencies": {
-                "color-name": "~1.1.4"
-            },
-            "engines": {
-                "node": ">=7.0.0"
-            }
-        },
-        "node_modules/any-promise": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
-            "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==",
-            "dev": true
-        },
-        "node_modules/anymatch": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.2.tgz",
-            "integrity": "sha512-P43ePfOAIupkguHUycrc4qJ9kz8ZiuOUijaETwX7THt0Y/GNK7v0aa8rY816xWjZ7rJdA5XdMcpVFTKMq+RvWg==",
-            "dev": true,
-            "dependencies": {
-                "normalize-path": "^3.0.0",
-                "picomatch": "^2.0.4"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/arg": {
-            "version": "5.0.2",
-            "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
-            "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
-            "dev": true
-        },
-        "node_modules/array-flatten": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-2.1.2.tgz",
-            "integrity": "sha512-hNfzcOV8W4NdualtqBFPyVO+54DSJuZGY9qT4pRroB6S9e3iiido2ISIC5h9R2sPJ8H3FHCIiEnsv1lPXO3KtQ==",
-            "dev": true
-        },
-        "node_modules/array-union": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
-            "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/asn1.js": {
-            "version": "5.4.1",
-            "resolved": "https://registry.npmjs.org/asn1.js/-/asn1.js-5.4.1.tgz",
-            "integrity": "sha512-+I//4cYPccV8LdmBLiX8CYvf9Sp3vQsrqu2QNXRcrbiWvcx/UdlFiqUJJzxRQxgsZmvhXhn4cSKeSmoFjVdupA==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.0.0",
-                "inherits": "^2.0.1",
-                "minimalistic-assert": "^1.0.0",
-                "safer-buffer": "^2.1.0"
-            }
-        },
-        "node_modules/asn1.js/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/assert": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/assert/-/assert-1.5.0.tgz",
-            "integrity": "sha512-EDsgawzwoun2CZkCgtxJbv392v4nbk9XDD06zI+kQYoBM/3RBWLlEyJARDOmhAAosBjWACEkKL6S+lIZtcAubA==",
-            "dev": true,
-            "dependencies": {
-                "object-assign": "^4.1.1",
-                "util": "0.10.3"
-            }
-        },
-        "node_modules/assert/node_modules/inherits": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.1.tgz",
-            "integrity": "sha512-8nWq2nLTAwd02jTqJExUYFSD/fKq6VH9Y/oG2accc/kdI0V98Bag8d5a4gi3XHz73rDWa2PvTtvcWYquKqSENA==",
-            "dev": true
-        },
-        "node_modules/assert/node_modules/util": {
-            "version": "0.10.3",
-            "resolved": "https://registry.npmjs.org/util/-/util-0.10.3.tgz",
-            "integrity": "sha512-5KiHfsmkqacuKjkRkdV7SsfDJ2EGiPsK92s2MhNSY0craxjTdKTtqKsJaCWp4LW33ZZ0OPUv1WO/TFvNQRiQxQ==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "2.0.1"
-            }
-        },
-        "node_modules/autoprefixer": {
-            "version": "10.4.20",
-            "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.20.tgz",
-            "integrity": "sha512-XY25y5xSv/wEoqzDyXXME4AFfkZI0P23z6Fs3YgymDnKJkCGOnkL0iTxCa85UTqaSgfcqyf3UA6+c7wUvx/16g==",
+        "node_modules/update-browserslist-db": {
+            "version": "1.1.1",
             "dev": true,
             "funding": [
                 {
                     "type": "opencollective",
-                    "url": "https://opencollective.com/postcss/"
+                    "url": "https://opencollective.com/browserslist"
                 },
                 {
                     "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/autoprefixer"
+                    "url": "https://tidelift.com/funding/github/npm/browserslist"
                 },
                 {
                     "type": "github",
                     "url": "https://github.com/sponsors/ai"
                 }
             ],
+            "license": "MIT",
             "dependencies": {
-                "browserslist": "^4.23.3",
-                "caniuse-lite": "^1.0.30001646",
-                "fraction.js": "^4.3.7",
-                "normalize-range": "^0.1.2",
-                "picocolors": "^1.0.1",
-                "postcss-value-parser": "^4.2.0"
+                "escalade": "^3.2.0",
+                "picocolors": "^1.1.0"
             },
             "bin": {
-                "autoprefixer": "bin/autoprefixer"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14"
+                "update-browserslist-db": "cli.js"
             },
             "peerDependencies": {
-                "postcss": "^8.1.0"
+                "browserslist": ">= 4.21.0"
             }
         },
-        "node_modules/babel-loader": {
-            "version": "8.2.5",
-            "resolved": "https://registry.npmjs.org/babel-loader/-/babel-loader-8.2.5.tgz",
-            "integrity": "sha512-OSiFfH89LrEMiWd4pLNqGz4CwJDtbs2ZVc+iGu2HrkRfPxId9F2anQj38IxWpmRfsUY0aBZYi1EFcd3mhtRMLQ==",
+        "node_modules/util-deprecate": {
+            "version": "1.0.2",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/vite": {
+            "version": "5.4.10",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.10.tgz",
+            "integrity": "sha512-1hvaPshuPUtxeQ0hsVH3Mud0ZanOLwVTneA1EgbAM5LhaZEqyPWGRQ7BtaMvUrTDeEaC8pxtj6a6jku3x4z6SQ==",
             "dev": true,
             "dependencies": {
-                "find-cache-dir": "^3.3.1",
-                "loader-utils": "^2.0.0",
-                "make-dir": "^3.1.0",
-                "schema-utils": "^2.6.5"
+                "esbuild": "^0.21.3",
+                "postcss": "^8.4.43",
+                "rollup": "^4.20.0"
+            },
+            "bin": {
+                "vite": "bin/vite.js"
             },
             "engines": {
-                "node": ">= 8.9"
+                "node": "^18.0.0 || >=20.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/vitejs/vite?sponsor=1"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.3"
             },
             "peerDependencies": {
-                "@babel/core": "^7.0.0",
-                "webpack": ">=2"
-            }
-        },
-        "node_modules/babel-plugin-dynamic-import-node": {
-            "version": "2.3.3",
-            "resolved": "https://registry.npmjs.org/babel-plugin-dynamic-import-node/-/babel-plugin-dynamic-import-node-2.3.3.tgz",
-            "integrity": "sha512-jZVI+s9Zg3IqA/kdi0i6UDCybUI3aSBLnglhYbSSjKlV7yF1F/5LWv8MakQmvYpnbJDS6fcBL2KzHSxNCMtWSQ==",
-            "dev": true,
-            "dependencies": {
-                "object.assign": "^4.1.0"
+                "@types/node": "^18.0.0 || >=20.0.0",
+                "less": "*",
+                "lightningcss": "^1.21.0",
+                "sass": "*",
+                "sass-embedded": "*",
+                "stylus": "*",
+                "sugarss": "*",
+                "terser": "^5.4.0"
+            },
+            "peerDependenciesMeta": {
+                "@types/node": {
+                    "optional": true
+                },
+                "less": {
+                    "optional": true
+                },
+                "lightningcss": {
+                    "optional": true
+                },
+                "sass": {
+                    "optional": true
+                },
+                "sass-embedded": {
+                    "optional": true
+                },
+                "stylus": {
+                    "optional": true
+                },
+                "sugarss": {
+                    "optional": true
+                },
+                "terser": {
+                    "optional": true
+                }
             }
         },
-        "node_modules/babel-plugin-polyfill-corejs2": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.3.1.tgz",
-            "integrity": "sha512-v7/T6EQcNfVLfcN2X8Lulb7DjprieyLWJK/zOWH5DUYcAgex9sP3h25Q+DLsX9TloXe3y1O8l2q2Jv9q8UVB9w==",
+        "node_modules/which": {
+            "version": "2.0.2",
             "dev": true,
+            "license": "ISC",
             "dependencies": {
-                "@babel/compat-data": "^7.13.11",
-                "@babel/helper-define-polyfill-provider": "^0.3.1",
-                "semver": "^6.1.1"
+                "isexe": "^2.0.0"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
-            }
-        },
-        "node_modules/babel-plugin-polyfill-corejs2/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-            "dev": true,
             "bin": {
-                "semver": "bin/semver.js"
-            }
-        },
-        "node_modules/babel-plugin-polyfill-corejs3": {
-            "version": "0.5.2",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.5.2.tgz",
-            "integrity": "sha512-G3uJih0XWiID451fpeFaYGVuxHEjzKTHtc9uGFEjR6hHrvNzeS/PX+LLLcetJcytsB5m4j+K3o/EpXJNb/5IEQ==",
-            "dev": true,
-            "dependencies": {
-                "@babel/helper-define-polyfill-provider": "^0.3.1",
-                "core-js-compat": "^3.21.0"
+                "node-which": "bin/node-which"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "engines": {
+                "node": ">= 8"
             }
         },
-        "node_modules/babel-plugin-polyfill-regenerator": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.3.1.tgz",
-            "integrity": "sha512-Y2B06tvgHYt1x0yz17jGkGeeMr5FeKUu+ASJ+N6nB5lQ8Dapfg42i0OVrf8PNGJ3zKL4A23snMi1IRwrqqND7A==",
+        "node_modules/wrap-ansi-cjs": {
+            "name": "wrap-ansi",
+            "version": "7.0.0",
             "dev": true,
+            "license": "MIT",
             "dependencies": {
-                "@babel/helper-define-polyfill-provider": "^0.3.1"
+                "ansi-styles": "^4.0.0",
+                "string-width": "^4.1.0",
+                "strip-ansi": "^6.0.0"
             },
-            "peerDependencies": {
-                "@babel/core": "^7.0.0-0"
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
             }
-        },
-        "node_modules/balanced-match": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-            "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+        }
+    },
+    "dependencies": {
+        "@alloc/quick-lru": {
+            "version": "5.2.0",
             "dev": true
         },
-        "node_modules/base64-js": {
-            "version": "1.5.1",
-            "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
-            "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+        "@esbuild/aix-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
             "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/batch": {
-            "version": "0.6.1",
-            "resolved": "https://registry.npmjs.org/batch/-/batch-0.6.1.tgz",
-            "integrity": "sha512-x+VAiMRL6UPkx+kudNvxTl6hB2XNNCG2r+7wixVfIYwu/2HKRXimwQyaumLjMveWvT2Hkd/cAJw+QBMfJ/EKVw==",
-            "dev": true
+            "optional": true
         },
-        "node_modules/big.js": {
-            "version": "5.2.2",
-            "resolved": "https://registry.npmjs.org/big.js/-/big.js-5.2.2.tgz",
-            "integrity": "sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ==",
+        "@esbuild/android-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
             "dev": true,
-            "engines": {
-                "node": "*"
-            }
+            "optional": true
         },
-        "node_modules/binary-extensions": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.2.0.tgz",
-            "integrity": "sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==",
+        "@esbuild/android-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
             "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/bn.js": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.1.tgz",
-            "integrity": "sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==",
-            "dev": true
+            "optional": true
         },
-        "node_modules/body-parser": {
-            "version": "1.20.3",
-            "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz",
-            "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==",
-            "dev": true,
-            "dependencies": {
-                "bytes": "3.1.2",
-                "content-type": "~1.0.5",
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "destroy": "1.2.0",
-                "http-errors": "2.0.0",
-                "iconv-lite": "0.4.24",
-                "on-finished": "2.4.1",
-                "qs": "6.13.0",
-                "raw-body": "2.5.2",
-                "type-is": "~1.6.18",
-                "unpipe": "1.0.0"
-            },
-            "engines": {
-                "node": ">= 0.8",
-                "npm": "1.2.8000 || >= 1.4.16"
-            }
-        },
-        "node_modules/body-parser/node_modules/bytes": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
-            "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/body-parser/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/body-parser/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/bonjour-service": {
-            "version": "1.0.13",
-            "resolved": "https://registry.npmjs.org/bonjour-service/-/bonjour-service-1.0.13.tgz",
-            "integrity": "sha512-LWKRU/7EqDUC9CTAQtuZl5HzBALoCYwtLhffW3et7vZMwv3bWLpJf8bRYlMD5OCcDpTfnPgNCV4yo9ZIaJGMiA==",
-            "dev": true,
-            "dependencies": {
-                "array-flatten": "^2.1.2",
-                "dns-equal": "^1.0.0",
-                "fast-deep-equal": "^3.1.3",
-                "multicast-dns": "^7.2.5"
-            }
-        },
-        "node_modules/boolbase": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
-            "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
-            "dev": true
-        },
-        "node_modules/brace-expansion": {
-            "version": "1.1.11",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
-            "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
-            "dev": true,
-            "dependencies": {
-                "balanced-match": "^1.0.0",
-                "concat-map": "0.0.1"
-            }
-        },
-        "node_modules/braces": {
-            "version": "3.0.3",
-            "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-            "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-            "dev": true,
-            "dependencies": {
-                "fill-range": "^7.1.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/brorand": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
-            "integrity": "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==",
-            "dev": true
-        },
-        "node_modules/browserify-aes": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
-            "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
-            "dev": true,
-            "dependencies": {
-                "buffer-xor": "^1.0.3",
-                "cipher-base": "^1.0.0",
-                "create-hash": "^1.1.0",
-                "evp_bytestokey": "^1.0.3",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
-            }
-        },
-        "node_modules/browserify-cipher": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/browserify-cipher/-/browserify-cipher-1.0.1.tgz",
-            "integrity": "sha512-sPhkz0ARKbf4rRQt2hTpAHqn47X3llLkUGn+xEJzLjwY8LRs2p0v7ljvI5EyoRO/mexrNunNECisZs+gw2zz1w==",
-            "dev": true,
-            "dependencies": {
-                "browserify-aes": "^1.0.4",
-                "browserify-des": "^1.0.0",
-                "evp_bytestokey": "^1.0.0"
-            }
-        },
-        "node_modules/browserify-des": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.2.tgz",
-            "integrity": "sha512-BioO1xf3hFwz4kc6iBhI3ieDFompMhrMlnDFC4/0/vd5MokpuAc3R+LYbwTA9A5Yc9pq9UYPqffKpW2ObuwX5A==",
-            "dev": true,
-            "dependencies": {
-                "cipher-base": "^1.0.1",
-                "des.js": "^1.0.0",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            }
-        },
-        "node_modules/browserify-rsa": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/browserify-rsa/-/browserify-rsa-4.1.0.tgz",
-            "integrity": "sha512-AdEER0Hkspgno2aR97SAf6vi0y0k8NuOpGnVH3O99rcA5Q6sh8QxcngtHuJ6uXwnfAXNM4Gn1Gb7/MV1+Ymbog==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^5.0.0",
-                "randombytes": "^2.0.1"
-            }
-        },
-        "node_modules/browserify-sign": {
-            "version": "4.2.2",
-            "resolved": "https://registry.npmjs.org/browserify-sign/-/browserify-sign-4.2.2.tgz",
-            "integrity": "sha512-1rudGyeYY42Dk6texmv7c4VcQ0EsvVbLwZkA+AQB7SxvXxmcD93jcHie8bzecJ+ChDlmAm2Qyu0+Ccg5uhZXCg==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^5.2.1",
-                "browserify-rsa": "^4.1.0",
-                "create-hash": "^1.2.0",
-                "create-hmac": "^1.1.7",
-                "elliptic": "^6.5.4",
-                "inherits": "^2.0.4",
-                "parse-asn1": "^5.1.6",
-                "readable-stream": "^3.6.2",
-                "safe-buffer": "^5.2.1"
-            },
-            "engines": {
-                "node": ">= 4"
-            }
-        },
-        "node_modules/browserify-sign/node_modules/readable-stream": {
-            "version": "3.6.2",
-            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
-            "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.3",
-                "string_decoder": "^1.1.1",
-                "util-deprecate": "^1.0.1"
-            },
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/browserify-sign/node_modules/safe-buffer": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-            "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/browserify-zlib": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/browserify-zlib/-/browserify-zlib-0.2.0.tgz",
-            "integrity": "sha512-Z942RysHXmJrhqk88FmKBVq/v5tqmSkDz7p54G/MGyjMnCFFnC79XWNbg+Vta8W6Wb2qtSZTSxIGkJrRpCFEiA==",
-            "dev": true,
-            "dependencies": {
-                "pako": "~1.0.5"
-            }
-        },
-        "node_modules/browserslist": {
-            "version": "4.23.3",
-            "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.23.3.tgz",
-            "integrity": "sha512-btwCFJVjI4YWDNfau8RhZ+B1Q/VLoUITrm3RlP6y1tYGWIOa+InuYiRGXUBXo8nA1qKmHMyLB/iVQg5TT4eFoA==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/browserslist"
-                },
-                {
-                    "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/browserslist"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "dependencies": {
-                "caniuse-lite": "^1.0.30001646",
-                "electron-to-chromium": "^1.5.4",
-                "node-releases": "^2.0.18",
-                "update-browserslist-db": "^1.1.0"
-            },
-            "bin": {
-                "browserslist": "cli.js"
-            },
-            "engines": {
-                "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
-            }
-        },
-        "node_modules/buffer": {
-            "version": "4.9.2",
-            "resolved": "https://registry.npmjs.org/buffer/-/buffer-4.9.2.tgz",
-            "integrity": "sha512-xq+q3SRMOxGivLhBNaUdC64hDTQwejJ+H0T/NB1XMtTVEwNTrfFF3gAxiyW0Bu/xWEGhjVKgUcMhCrUy2+uCWg==",
-            "dev": true,
-            "dependencies": {
-                "base64-js": "^1.0.2",
-                "ieee754": "^1.1.4",
-                "isarray": "^1.0.0"
-            }
-        },
-        "node_modules/buffer-from": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
-            "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
-            "dev": true
-        },
-        "node_modules/buffer-xor": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
-            "integrity": "sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==",
-            "dev": true
-        },
-        "node_modules/builtin-status-codes": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/builtin-status-codes/-/builtin-status-codes-3.0.0.tgz",
-            "integrity": "sha512-HpGFw18DgFWlncDfjTa2rcQ4W88O1mC8e8yZ2AvQY5KDaktSTwo+KRf6nHK6FRI5FyRyb/5T6+TSxfP7QyGsmQ==",
-            "dev": true
-        },
-        "node_modules/bytes": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.0.0.tgz",
-            "integrity": "sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/call-bind": {
-            "version": "1.0.7",
-            "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.7.tgz",
-            "integrity": "sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==",
-            "dev": true,
-            "dependencies": {
-                "es-define-property": "^1.0.0",
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "get-intrinsic": "^1.2.4",
-                "set-function-length": "^1.2.1"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/callsites": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
-            "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/camel-case": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/camel-case/-/camel-case-4.1.2.tgz",
-            "integrity": "sha512-gxGWBrTT1JuMx6R+o5PTXMmUnhnVzLQ9SNutD4YqKtI6ap897t3tKECYla6gCWEkplXnlNybEkZg9GEGxKFCgw==",
-            "dev": true,
-            "dependencies": {
-                "pascal-case": "^3.1.2",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/camelcase-css": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz",
-            "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/caniuse-api": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-3.0.0.tgz",
-            "integrity": "sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.0.0",
-                "caniuse-lite": "^1.0.0",
-                "lodash.memoize": "^4.1.2",
-                "lodash.uniq": "^4.5.0"
-            }
-        },
-        "node_modules/caniuse-lite": {
-            "version": "1.0.30001646",
-            "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001646.tgz",
-            "integrity": "sha512-dRg00gudiBDDTmUhClSdv3hqRfpbOnU28IpI1T6PBTLWa+kOj0681C8uML3PifYfREuBrVjDGhL3adYpBT6spw==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/browserslist"
-                },
-                {
-                    "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ]
-        },
-        "node_modules/chalk": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-            "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-            "dev": true,
-            "dependencies": {
-                "ansi-styles": "^4.1.0",
-                "supports-color": "^7.1.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/chalk?sponsor=1"
-            }
-        },
-        "node_modules/charenc": {
-            "version": "0.0.2",
-            "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
-            "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==",
-            "dev": true,
-            "engines": {
-                "node": "*"
-            }
-        },
-        "node_modules/chokidar": {
-            "version": "3.5.3",
-            "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz",
-            "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "individual",
-                    "url": "https://paulmillr.com/funding/"
-                }
-            ],
-            "dependencies": {
-                "anymatch": "~3.1.2",
-                "braces": "~3.0.2",
-                "glob-parent": "~5.1.2",
-                "is-binary-path": "~2.1.0",
-                "is-glob": "~4.0.1",
-                "normalize-path": "~3.0.0",
-                "readdirp": "~3.6.0"
-            },
-            "engines": {
-                "node": ">= 8.10.0"
-            },
-            "optionalDependencies": {
-                "fsevents": "~2.3.2"
-            }
-        },
-        "node_modules/chrome-trace-event": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.3.tgz",
-            "integrity": "sha512-p3KULyQg4S7NIHixdwbGX+nFHkoBiA4YQmyWtjb8XngSKV124nJmRysgAeujbUVb15vh+RvFUfCPqU7rXk+hZg==",
-            "dev": true,
-            "engines": {
-                "node": ">=6.0"
-            }
-        },
-        "node_modules/cipher-base": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.4.tgz",
-            "integrity": "sha512-Kkht5ye6ZGmwv40uUDZztayT2ThLQGfnj/T71N/XzeZeo3nf8foyW7zGTsPYkEya3m5f3cAypH+qe7YOrM1U2Q==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
-            }
-        },
-        "node_modules/clean-css": {
-            "version": "5.3.1",
-            "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-5.3.1.tgz",
-            "integrity": "sha512-lCr8OHhiWCTw4v8POJovCoh4T7I9U11yVsPjMWWnnMmp9ZowCxyad1Pathle/9HjaDp+fdQKjO9fQydE6RHTZg==",
-            "dev": true,
-            "dependencies": {
-                "source-map": "~0.6.0"
-            },
-            "engines": {
-                "node": ">= 10.0"
-            }
-        },
-        "node_modules/cli-table3": {
-            "version": "0.6.2",
-            "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.2.tgz",
-            "integrity": "sha512-QyavHCaIC80cMivimWu4aWHilIpiDpfm3hGmqAmXVL1UsnbLuBSMd21hTX6VY4ZSDSM73ESLeF8TOYId3rBTbw==",
-            "dev": true,
-            "dependencies": {
-                "string-width": "^4.2.0"
-            },
-            "engines": {
-                "node": "10.* || >= 12.*"
-            },
-            "optionalDependencies": {
-                "@colors/colors": "1.5.0"
-            }
-        },
-        "node_modules/cliui": {
-            "version": "7.0.4",
-            "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
-            "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==",
-            "dev": true,
-            "dependencies": {
-                "string-width": "^4.2.0",
-                "strip-ansi": "^6.0.0",
-                "wrap-ansi": "^7.0.0"
-            }
-        },
-        "node_modules/clone-deep": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/clone-deep/-/clone-deep-4.0.1.tgz",
-            "integrity": "sha512-neHB9xuzh/wk0dIHweyAXv2aPGZIVk3pLMe+/RNzINf17fe0OG96QroktYAUm7SM1PBnzTabaLboqqxDyMU+SQ==",
-            "dev": true,
-            "dependencies": {
-                "is-plain-object": "^2.0.4",
-                "kind-of": "^6.0.2",
-                "shallow-clone": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/collect.js": {
-            "version": "4.34.3",
-            "resolved": "https://registry.npmjs.org/collect.js/-/collect.js-4.34.3.tgz",
-            "integrity": "sha512-aFr67xDazPwthsGm729mnClgNuh15JEagU6McKBKqxuHOkWL7vMFzGbhsXDdPZ+H6ia5QKIMGYuGOMENBHnVpg==",
-            "dev": true
-        },
-        "node_modules/color-convert": {
-            "version": "1.9.3",
-            "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
-            "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
-            "dev": true,
-            "dependencies": {
-                "color-name": "1.1.3"
-            }
-        },
-        "node_modules/color-convert/node_modules/color-name": {
-            "version": "1.1.3",
-            "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
-            "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
-            "dev": true
-        },
-        "node_modules/color-name": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-            "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-            "dev": true
-        },
-        "node_modules/colord": {
-            "version": "2.9.2",
-            "resolved": "https://registry.npmjs.org/colord/-/colord-2.9.2.tgz",
-            "integrity": "sha512-Uqbg+J445nc1TKn4FoDPS6ZZqAvEDnwrH42yo8B40JSOgSLxMZ/gt3h4nmCtPLQeXhjJJkqBx7SCY35WnIixaQ==",
-            "dev": true
-        },
-        "node_modules/colorette": {
-            "version": "2.0.19",
-            "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.19.tgz",
-            "integrity": "sha512-3tlv/dIP7FWvj3BsbHrGLJ6l/oKh1O3TcgBqMn+yyCagOxc23fyzDS6HypQbgxWbkpDnf52p1LuR4eWDQ/K9WQ==",
-            "dev": true
-        },
-        "node_modules/commander": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz",
-            "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 10"
-            }
-        },
-        "node_modules/commondir": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz",
-            "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==",
-            "dev": true
-        },
-        "node_modules/compressible": {
-            "version": "2.0.18",
-            "resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz",
-            "integrity": "sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==",
-            "dev": true,
-            "dependencies": {
-                "mime-db": ">= 1.43.0 < 2"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/compression": {
-            "version": "1.7.4",
-            "resolved": "https://registry.npmjs.org/compression/-/compression-1.7.4.tgz",
-            "integrity": "sha512-jaSIDzP9pZVS4ZfQ+TzvtiWhdpFhE2RDHz8QJkpX9SIpLq88VueF5jJw6t+6CUQcAoA6t+x89MLrWAqpfDE8iQ==",
-            "dev": true,
-            "dependencies": {
-                "accepts": "~1.3.5",
-                "bytes": "3.0.0",
-                "compressible": "~2.0.16",
-                "debug": "2.6.9",
-                "on-headers": "~1.0.2",
-                "safe-buffer": "5.1.2",
-                "vary": "~1.1.2"
-            },
-            "engines": {
-                "node": ">= 0.8.0"
-            }
-        },
-        "node_modules/compression/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/compression/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/concat": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/concat/-/concat-1.0.3.tgz",
-            "integrity": "sha512-f/ZaH1aLe64qHgTILdldbvyfGiGF4uzeo9IuXUloIOLQzFmIPloy9QbZadNsuVv0j5qbKQvQb/H/UYf2UsKTpw==",
-            "dev": true,
-            "dependencies": {
-                "commander": "^2.9.0"
-            },
-            "bin": {
-                "concat": "bin/concat"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/concat-map": {
-            "version": "0.0.1",
-            "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-            "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
-            "dev": true
-        },
-        "node_modules/concat/node_modules/commander": {
-            "version": "2.20.3",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-            "dev": true
-        },
-        "node_modules/connect-history-api-fallback": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/connect-history-api-fallback/-/connect-history-api-fallback-2.0.0.tgz",
-            "integrity": "sha512-U73+6lQFmfiNPrYbXqr6kZ1i1wiRqXnp2nhMsINseWXO8lDau0LGEffJ8kQi4EjLZympVgRdvqjAgiZ1tgzDDA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.8"
-            }
-        },
-        "node_modules/consola": {
-            "version": "2.15.3",
-            "resolved": "https://registry.npmjs.org/consola/-/consola-2.15.3.tgz",
-            "integrity": "sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==",
-            "dev": true
-        },
-        "node_modules/console-browserify": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/console-browserify/-/console-browserify-1.2.0.tgz",
-            "integrity": "sha512-ZMkYO/LkF17QvCPqM0gxw8yUzigAOZOSWSHg91FH6orS7vcEj5dVZTidN2fQ14yBSdg97RqhSNwLUXInd52OTA==",
-            "dev": true
-        },
-        "node_modules/constants-browserify": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/constants-browserify/-/constants-browserify-1.0.0.tgz",
-            "integrity": "sha512-xFxOwqIzR/e1k1gLiWEophSCMqXcwVHIH7akf7b/vxcUeGunlj3hvZaaqxwHsTgn+IndtkQJgSztIDWeumWJDQ==",
-            "dev": true
-        },
-        "node_modules/content-disposition": {
-            "version": "0.5.4",
-            "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
-            "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
-            "dev": true,
-            "dependencies": {
-                "safe-buffer": "5.2.1"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/content-disposition/node_modules/safe-buffer": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-            "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/content-type": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
-            "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/convert-source-map": {
-            "version": "1.8.0",
-            "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.8.0.tgz",
-            "integrity": "sha512-+OQdjP49zViI/6i7nIJpA8rAl4sV/JdPfU9nZs3VqOwGIgizICvuN2ru6fMd+4llL0tar18UYJXfZ/TWtmhUjA==",
-            "dev": true,
-            "dependencies": {
-                "safe-buffer": "~5.1.1"
-            }
-        },
-        "node_modules/cookie": {
-            "version": "0.7.1",
-            "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz",
-            "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/cookie-signature": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz",
-            "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==",
-            "dev": true
-        },
-        "node_modules/core-js-compat": {
-            "version": "3.33.2",
-            "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.33.2.tgz",
-            "integrity": "sha512-axfo+wxFVxnqf8RvxTzoAlzW4gRoacrHeoFlc9n0x50+7BEyZL/Rt3hicaED1/CEd7I6tPCPVUYcJwCMO5XUYw==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.22.1"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/core-js"
-            }
-        },
-        "node_modules/core-util-is": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
-            "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
-            "dev": true
-        },
-        "node_modules/cosmiconfig": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-7.0.1.tgz",
-            "integrity": "sha512-a1YWNUV2HwGimB7dU2s1wUMurNKjpx60HxBB6xUM8Re+2s1g1IIfJvFR0/iCF+XHdE0GMTKTuLR32UQff4TEyQ==",
-            "dev": true,
-            "dependencies": {
-                "@types/parse-json": "^4.0.0",
-                "import-fresh": "^3.2.1",
-                "parse-json": "^5.0.0",
-                "path-type": "^4.0.0",
-                "yaml": "^1.10.0"
-            },
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/create-ecdh": {
-            "version": "4.0.4",
-            "resolved": "https://registry.npmjs.org/create-ecdh/-/create-ecdh-4.0.4.tgz",
-            "integrity": "sha512-mf+TCx8wWc9VpuxfP2ht0iSISLZnt0JgWlrOKZiNqyUZWnjIaCIVNQArMHnCZKfEYRg6IM7A+NeJoN8gf/Ws0A==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.1.0",
-                "elliptic": "^6.5.3"
-            }
-        },
-        "node_modules/create-ecdh/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/create-hash": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
-            "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
-            "dev": true,
-            "dependencies": {
-                "cipher-base": "^1.0.1",
-                "inherits": "^2.0.1",
-                "md5.js": "^1.3.4",
-                "ripemd160": "^2.0.1",
-                "sha.js": "^2.4.0"
-            }
-        },
-        "node_modules/create-hmac": {
-            "version": "1.1.7",
-            "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
-            "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
-            "dev": true,
-            "dependencies": {
-                "cipher-base": "^1.0.3",
-                "create-hash": "^1.1.0",
-                "inherits": "^2.0.1",
-                "ripemd160": "^2.0.0",
-                "safe-buffer": "^5.0.1",
-                "sha.js": "^2.4.8"
-            }
-        },
-        "node_modules/cross-spawn": {
-            "version": "7.0.3",
-            "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",
-            "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==",
-            "dev": true,
-            "dependencies": {
-                "path-key": "^3.1.0",
-                "shebang-command": "^2.0.0",
-                "which": "^2.0.1"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/crypt": {
-            "version": "0.0.2",
-            "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
-            "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==",
-            "dev": true,
-            "engines": {
-                "node": "*"
-            }
-        },
-        "node_modules/crypto-browserify": {
-            "version": "3.12.0",
-            "resolved": "https://registry.npmjs.org/crypto-browserify/-/crypto-browserify-3.12.0.tgz",
-            "integrity": "sha512-fz4spIh+znjO2VjL+IdhEpRJ3YN6sMzITSBijk6FK2UvTqruSQW+/cCZTSNsMiZNvUeq0CqurF+dAbyiGOY6Wg==",
-            "dev": true,
-            "dependencies": {
-                "browserify-cipher": "^1.0.0",
-                "browserify-sign": "^4.0.0",
-                "create-ecdh": "^4.0.0",
-                "create-hash": "^1.1.0",
-                "create-hmac": "^1.1.0",
-                "diffie-hellman": "^5.0.0",
-                "inherits": "^2.0.1",
-                "pbkdf2": "^3.0.3",
-                "public-encrypt": "^4.0.0",
-                "randombytes": "^2.0.0",
-                "randomfill": "^1.0.3"
-            },
-            "engines": {
-                "node": "*"
-            }
-        },
-        "node_modules/css-declaration-sorter": {
-            "version": "6.3.0",
-            "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-6.3.0.tgz",
-            "integrity": "sha512-OGT677UGHJTAVMRhPO+HJ4oKln3wkBTwtDFH0ojbqm+MJm6xuDMHp2nkhh/ThaBqq20IbraBQSWKfSLNHQO9Og==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.0.9"
-            }
-        },
-        "node_modules/css-loader": {
-            "version": "5.2.7",
-            "resolved": "https://registry.npmjs.org/css-loader/-/css-loader-5.2.7.tgz",
-            "integrity": "sha512-Q7mOvpBNBG7YrVGMxRxcBJZFL75o+cH2abNASdibkj/fffYD8qWbInZrD0S9ccI6vZclF3DsHE7njGlLtaHbhg==",
-            "dev": true,
-            "dependencies": {
-                "icss-utils": "^5.1.0",
-                "loader-utils": "^2.0.0",
-                "postcss": "^8.2.15",
-                "postcss-modules-extract-imports": "^3.0.0",
-                "postcss-modules-local-by-default": "^4.0.0",
-                "postcss-modules-scope": "^3.0.0",
-                "postcss-modules-values": "^4.0.0",
-                "postcss-value-parser": "^4.1.0",
-                "schema-utils": "^3.0.0",
-                "semver": "^7.3.5"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.27.0 || ^5.0.0"
-            }
-        },
-        "node_modules/css-loader/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/css-select": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/css-select/-/css-select-4.3.0.tgz",
-            "integrity": "sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ==",
-            "dev": true,
-            "dependencies": {
-                "boolbase": "^1.0.0",
-                "css-what": "^6.0.1",
-                "domhandler": "^4.3.1",
-                "domutils": "^2.8.0",
-                "nth-check": "^2.0.1"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/fb55"
-            }
-        },
-        "node_modules/css-select/node_modules/domhandler": {
-            "version": "4.3.1",
-            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.2.0"
-            },
-            "engines": {
-                "node": ">= 4"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/domhandler?sponsor=1"
-            }
-        },
-        "node_modules/css-tree": {
-            "version": "1.1.3",
-            "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.1.3.tgz",
-            "integrity": "sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q==",
-            "dev": true,
-            "dependencies": {
-                "mdn-data": "2.0.14",
-                "source-map": "^0.6.1"
-            },
-            "engines": {
-                "node": ">=8.0.0"
-            }
-        },
-        "node_modules/css-what": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.1.0.tgz",
-            "integrity": "sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/fb55"
-            }
-        },
-        "node_modules/cssesc": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
-            "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
-            "dev": true,
-            "bin": {
-                "cssesc": "bin/cssesc"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/cssnano": {
-            "version": "5.1.12",
-            "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-5.1.12.tgz",
-            "integrity": "sha512-TgvArbEZu0lk/dvg2ja+B7kYoD7BBCmn3+k58xD0qjrGHsFzXY/wKTo9M5egcUCabPol05e/PVoIu79s2JN4WQ==",
-            "dev": true,
-            "dependencies": {
-                "cssnano-preset-default": "^5.2.12",
-                "lilconfig": "^2.0.3",
-                "yaml": "^1.10.2"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/cssnano"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/cssnano-preset-default": {
-            "version": "5.2.12",
-            "resolved": "https://registry.npmjs.org/cssnano-preset-default/-/cssnano-preset-default-5.2.12.tgz",
-            "integrity": "sha512-OyCBTZi+PXgylz9HAA5kHyoYhfGcYdwFmyaJzWnzxuGRtnMw/kR6ilW9XzlzlRAtB6PLT/r+prYgkef7hngFew==",
-            "dev": true,
-            "dependencies": {
-                "css-declaration-sorter": "^6.3.0",
-                "cssnano-utils": "^3.1.0",
-                "postcss-calc": "^8.2.3",
-                "postcss-colormin": "^5.3.0",
-                "postcss-convert-values": "^5.1.2",
-                "postcss-discard-comments": "^5.1.2",
-                "postcss-discard-duplicates": "^5.1.0",
-                "postcss-discard-empty": "^5.1.1",
-                "postcss-discard-overridden": "^5.1.0",
-                "postcss-merge-longhand": "^5.1.6",
-                "postcss-merge-rules": "^5.1.2",
-                "postcss-minify-font-values": "^5.1.0",
-                "postcss-minify-gradients": "^5.1.1",
-                "postcss-minify-params": "^5.1.3",
-                "postcss-minify-selectors": "^5.2.1",
-                "postcss-normalize-charset": "^5.1.0",
-                "postcss-normalize-display-values": "^5.1.0",
-                "postcss-normalize-positions": "^5.1.1",
-                "postcss-normalize-repeat-style": "^5.1.1",
-                "postcss-normalize-string": "^5.1.0",
-                "postcss-normalize-timing-functions": "^5.1.0",
-                "postcss-normalize-unicode": "^5.1.0",
-                "postcss-normalize-url": "^5.1.0",
-                "postcss-normalize-whitespace": "^5.1.1",
-                "postcss-ordered-values": "^5.1.3",
-                "postcss-reduce-initial": "^5.1.0",
-                "postcss-reduce-transforms": "^5.1.0",
-                "postcss-svgo": "^5.1.0",
-                "postcss-unique-selectors": "^5.1.1"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/cssnano-utils": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/cssnano-utils/-/cssnano-utils-3.1.0.tgz",
-            "integrity": "sha512-JQNR19/YZhz4psLX/rQ9M83e3z2Wf/HdJbryzte4a3NSuafyp9w/I4U+hx5C2S9g41qlstH7DEWnZaaj83OuEA==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/csso": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/csso/-/csso-4.2.0.tgz",
-            "integrity": "sha512-wvlcdIbf6pwKEk7vHj8/Bkc0B4ylXZruLvOgs9doS5eOsOpuodOV2zJChSpkp+pRpYQLQMeF04nr3Z68Sta9jA==",
-            "dev": true,
-            "dependencies": {
-                "css-tree": "^1.1.2"
-            },
-            "engines": {
-                "node": ">=8.0.0"
-            }
-        },
-        "node_modules/debug": {
-            "version": "4.3.4",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz",
-            "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.1.2"
-            },
-            "engines": {
-                "node": ">=6.0"
-            },
-            "peerDependenciesMeta": {
-                "supports-color": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/default-gateway": {
-            "version": "6.0.3",
-            "resolved": "https://registry.npmjs.org/default-gateway/-/default-gateway-6.0.3.tgz",
-            "integrity": "sha512-fwSOJsbbNzZ/CUFpqFBqYfYNLj1NbMPm8MMCIzHjC83iSJRBEGmDUxU+WP661BaBQImeC2yHwXtz+P/O9o+XEg==",
-            "dev": true,
-            "dependencies": {
-                "execa": "^5.0.0"
-            },
-            "engines": {
-                "node": ">= 10"
-            }
-        },
-        "node_modules/define-data-property": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
-            "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
-            "dev": true,
-            "dependencies": {
-                "es-define-property": "^1.0.0",
-                "es-errors": "^1.3.0",
-                "gopd": "^1.0.1"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/define-lazy-prop": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz",
-            "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/define-properties": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.1.4.tgz",
-            "integrity": "sha512-uckOqKcfaVvtBdsVkdPv3XjveQJsNQqmhXgRi8uhvWWuPYZCNlzT8qAyblUgNoXdHdjMTzAqeGjAoli8f+bzPA==",
-            "dev": true,
-            "dependencies": {
-                "has-property-descriptors": "^1.0.0",
-                "object-keys": "^1.1.1"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/depd": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
-            "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/des.js": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.1.tgz",
-            "integrity": "sha512-Q0I4pfFrv2VPd34/vfLrFOoRmlYj3OV50i7fskps1jZWK1kApMWWT9G6RRUeYedLcBDIhnSDaUvJMb3AhUlaEA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.1",
-                "minimalistic-assert": "^1.0.0"
-            }
-        },
-        "node_modules/destroy": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
-            "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8",
-                "npm": "1.2.8000 || >= 1.4.16"
-            }
-        },
-        "node_modules/detect-node": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
-            "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
-            "dev": true
-        },
-        "node_modules/didyoumean": {
-            "version": "1.2.2",
-            "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz",
-            "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==",
-            "dev": true
-        },
-        "node_modules/diffie-hellman": {
-            "version": "5.0.3",
-            "resolved": "https://registry.npmjs.org/diffie-hellman/-/diffie-hellman-5.0.3.tgz",
-            "integrity": "sha512-kqag/Nl+f3GwyK25fhUMYj81BUOrZ9IuJsjIcDE5icNM9FJHAVm3VcUDxdLPoQtTuUylWm6ZIknYJwwaPxsUzg==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.1.0",
-                "miller-rabin": "^4.0.0",
-                "randombytes": "^2.0.0"
-            }
-        },
-        "node_modules/diffie-hellman/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/dir-glob": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",
-            "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",
-            "dev": true,
-            "dependencies": {
-                "path-type": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/dlv": {
-            "version": "1.1.3",
-            "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",
-            "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==",
-            "dev": true
-        },
-        "node_modules/dns-equal": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/dns-equal/-/dns-equal-1.0.0.tgz",
-            "integrity": "sha512-z+paD6YUQsk+AbGCEM4PrOXSss5gd66QfcVBFTKR/HpFL9jCqikS94HYwKww6fQyO7IxrIIyUu+g0Ka9tUS2Cg==",
-            "dev": true
-        },
-        "node_modules/dns-packet": {
-            "version": "5.4.0",
-            "resolved": "https://registry.npmjs.org/dns-packet/-/dns-packet-5.4.0.tgz",
-            "integrity": "sha512-EgqGeaBB8hLiHLZtp/IbaDQTL8pZ0+IvwzSHA6d7VyMDM+B9hgddEMa9xjK5oYnw0ci0JQ6g2XCD7/f6cafU6g==",
-            "dev": true,
-            "dependencies": {
-                "@leichtgewicht/ip-codec": "^2.0.1"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/dom-serializer": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz",
-            "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.0.1",
-                "domhandler": "^4.2.0",
-                "entities": "^2.0.0"
-            },
-            "funding": {
-                "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
-            }
-        },
-        "node_modules/dom-serializer/node_modules/domhandler": {
-            "version": "4.3.1",
-            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.2.0"
-            },
-            "engines": {
-                "node": ">= 4"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/domhandler?sponsor=1"
-            }
-        },
-        "node_modules/domain-browser": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/domain-browser/-/domain-browser-1.2.0.tgz",
-            "integrity": "sha512-jnjyiM6eRyZl2H+W8Q/zLMA481hzi0eszAaBUzIVnmYVDBbnLxVNnfu1HgEBvCbL+71FrxMl3E6lpKH7Ge3OXA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.4",
-                "npm": ">=1.2"
-            }
-        },
-        "node_modules/domelementtype": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
-            "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/fb55"
-                }
-            ]
-        },
-        "node_modules/domhandler": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-3.3.0.tgz",
-            "integrity": "sha512-J1C5rIANUbuYK+FuFL98650rihynUOEzRLxW+90bKZRWB6A1X1Tf82GxR1qAWLyfNPRvjqfip3Q5tdYlmAa9lA==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.0.1"
-            },
-            "engines": {
-                "node": ">= 4"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/domhandler?sponsor=1"
-            }
-        },
-        "node_modules/domutils": {
-            "version": "2.8.0",
-            "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz",
-            "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==",
-            "dev": true,
-            "dependencies": {
-                "dom-serializer": "^1.0.1",
-                "domelementtype": "^2.2.0",
-                "domhandler": "^4.2.0"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/domutils?sponsor=1"
-            }
-        },
-        "node_modules/domutils/node_modules/domhandler": {
-            "version": "4.3.1",
-            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.2.0"
-            },
-            "engines": {
-                "node": ">= 4"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/domhandler?sponsor=1"
-            }
-        },
-        "node_modules/dot-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/dot-case/-/dot-case-3.0.4.tgz",
-            "integrity": "sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w==",
-            "dev": true,
-            "dependencies": {
-                "no-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/dotenv": {
-            "version": "10.0.0",
-            "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-10.0.0.tgz",
-            "integrity": "sha512-rlBi9d8jpv9Sf1klPjNfFAuWDjKLwTIJJ/VxtoTwIR6hnZxcEOQCZg2oIL3MWBYw5GpUDKOEnND7LXTbIpQ03Q==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/dotenv-expand": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-5.1.0.tgz",
-            "integrity": "sha512-YXQl1DSa4/PQyRfgrv6aoNjhasp/p4qs9FjJ4q4cQk+8m4r6k4ZSiEyytKG8f8W9gi8WsQtIObNmKd+tMzNTmA==",
-            "dev": true
-        },
-        "node_modules/eastasianwidth": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
-            "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
-            "dev": true
-        },
-        "node_modules/ee-first": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
-            "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
-            "dev": true
-        },
-        "node_modules/electron-to-chromium": {
-            "version": "1.5.4",
-            "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.4.tgz",
-            "integrity": "sha512-orzA81VqLyIGUEA77YkVA1D+N+nNfl2isJVjjmOyrlxuooZ19ynb+dOlaDTqd/idKRS9lDCSBmtzM+kyCsMnkA==",
-            "dev": true
-        },
-        "node_modules/elliptic": {
-            "version": "6.6.0",
-            "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.6.0.tgz",
-            "integrity": "sha512-dpwoQcLc/2WLQvJvLRHKZ+f9FgOdjnq11rurqwekGQygGPsYSK29OMMD2WalatiqQ+XGFDglTNixpPfI+lpaAA==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.11.9",
-                "brorand": "^1.1.0",
-                "hash.js": "^1.0.0",
-                "hmac-drbg": "^1.0.1",
-                "inherits": "^2.0.4",
-                "minimalistic-assert": "^1.0.1",
-                "minimalistic-crypto-utils": "^1.0.1"
-            }
-        },
-        "node_modules/elliptic/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/emoji-regex": {
-            "version": "8.0.0",
-            "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
-            "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
-            "dev": true
-        },
-        "node_modules/emojis-list": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/emojis-list/-/emojis-list-3.0.0.tgz",
-            "integrity": "sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q==",
-            "dev": true,
-            "engines": {
-                "node": ">= 4"
-            }
-        },
-        "node_modules/encodeurl": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
-            "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/enhanced-resolve": {
-            "version": "5.17.1",
-            "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.1.tgz",
-            "integrity": "sha512-LMHl3dXhTcfv8gM4kEzIUeTQ+7fpdA0l2tUf34BddXPkz2A5xJ5L/Pchd5BL6rdccM9QGvu0sWZzK1Z1t4wwyg==",
-            "dev": true,
-            "dependencies": {
-                "graceful-fs": "^4.2.4",
-                "tapable": "^2.2.0"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            }
-        },
-        "node_modules/entities": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz",
-            "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==",
-            "dev": true,
-            "funding": {
-                "url": "https://github.com/fb55/entities?sponsor=1"
-            }
-        },
-        "node_modules/envinfo": {
-            "version": "7.8.1",
-            "resolved": "https://registry.npmjs.org/envinfo/-/envinfo-7.8.1.tgz",
-            "integrity": "sha512-/o+BXHmB7ocbHEAs6F2EnG0ogybVVUdkRunTT2glZU9XAaGmhqskrvKwqXuDfNjEO0LZKWdejEEpnq8aM0tOaw==",
-            "dev": true,
-            "bin": {
-                "envinfo": "dist/cli.js"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/error-ex": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
-            "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
-            "dev": true,
-            "dependencies": {
-                "is-arrayish": "^0.2.1"
-            }
-        },
-        "node_modules/es-define-property": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.0.tgz",
-            "integrity": "sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==",
-            "dev": true,
-            "dependencies": {
-                "get-intrinsic": "^1.2.4"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            }
-        },
-        "node_modules/es-errors": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
-            "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            }
-        },
-        "node_modules/es-module-lexer": {
-            "version": "1.5.4",
-            "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.5.4.tgz",
-            "integrity": "sha512-MVNK56NiMrOwitFB7cqDwq0CQutbw+0BvLshJSse0MUNU+y1FC3bUS/AQg7oUng+/wKrrki7JfmwtVHkVfPLlw==",
-            "dev": true
-        },
-        "node_modules/escalade": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.2.tgz",
-            "integrity": "sha512-ErCHMCae19vR8vQGe50xIsVomy19rg6gFu3+r3jkEO46suLMWBksvVyoGgQV+jOfl84ZSOSlmv6Gxa89PmTGmA==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/escape-html": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
-            "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
-            "dev": true
-        },
-        "node_modules/escape-string-regexp": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
-            "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.8.0"
-            }
-        },
-        "node_modules/eslint-scope": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz",
-            "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==",
-            "dev": true,
-            "dependencies": {
-                "esrecurse": "^4.3.0",
-                "estraverse": "^4.1.1"
-            },
-            "engines": {
-                "node": ">=8.0.0"
-            }
-        },
-        "node_modules/esrecurse": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
-            "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
-            "dev": true,
-            "dependencies": {
-                "estraverse": "^5.2.0"
-            },
-            "engines": {
-                "node": ">=4.0"
-            }
-        },
-        "node_modules/esrecurse/node_modules/estraverse": {
-            "version": "5.3.0",
-            "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
-            "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
-            "dev": true,
-            "engines": {
-                "node": ">=4.0"
-            }
-        },
-        "node_modules/estraverse": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz",
-            "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==",
-            "dev": true,
-            "engines": {
-                "node": ">=4.0"
-            }
-        },
-        "node_modules/esutils": {
-            "version": "2.0.3",
-            "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
-            "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/etag": {
-            "version": "1.8.1",
-            "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
-            "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/eventemitter3": {
-            "version": "4.0.7",
-            "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz",
-            "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==",
-            "dev": true
-        },
-        "node_modules/events": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
-            "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.8.x"
-            }
-        },
-        "node_modules/evp_bytestokey": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
-            "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
-            "dev": true,
-            "dependencies": {
-                "md5.js": "^1.3.4",
-                "safe-buffer": "^5.1.1"
-            }
-        },
-        "node_modules/execa": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
-            "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
-            "dev": true,
-            "dependencies": {
-                "cross-spawn": "^7.0.3",
-                "get-stream": "^6.0.0",
-                "human-signals": "^2.1.0",
-                "is-stream": "^2.0.0",
-                "merge-stream": "^2.0.0",
-                "npm-run-path": "^4.0.1",
-                "onetime": "^5.1.2",
-                "signal-exit": "^3.0.3",
-                "strip-final-newline": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/sindresorhus/execa?sponsor=1"
-            }
-        },
-        "node_modules/express": {
-            "version": "4.21.1",
-            "resolved": "https://registry.npmjs.org/express/-/express-4.21.1.tgz",
-            "integrity": "sha512-YSFlK1Ee0/GC8QaO91tHcDxJiE/X4FbpAyQWkxAvG6AXCuR65YzK8ua6D9hvi/TzUfZMpc+BwuM1IPw8fmQBiQ==",
-            "dev": true,
-            "dependencies": {
-                "accepts": "~1.3.8",
-                "array-flatten": "1.1.1",
-                "body-parser": "1.20.3",
-                "content-disposition": "0.5.4",
-                "content-type": "~1.0.4",
-                "cookie": "0.7.1",
-                "cookie-signature": "1.0.6",
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "etag": "~1.8.1",
-                "finalhandler": "1.3.1",
-                "fresh": "0.5.2",
-                "http-errors": "2.0.0",
-                "merge-descriptors": "1.0.3",
-                "methods": "~1.1.2",
-                "on-finished": "2.4.1",
-                "parseurl": "~1.3.3",
-                "path-to-regexp": "0.1.10",
-                "proxy-addr": "~2.0.7",
-                "qs": "6.13.0",
-                "range-parser": "~1.2.1",
-                "safe-buffer": "5.2.1",
-                "send": "0.19.0",
-                "serve-static": "1.16.2",
-                "setprototypeof": "1.2.0",
-                "statuses": "2.0.1",
-                "type-is": "~1.6.18",
-                "utils-merge": "1.0.1",
-                "vary": "~1.1.2"
-            },
-            "engines": {
-                "node": ">= 0.10.0"
-            }
-        },
-        "node_modules/express/node_modules/array-flatten": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
-            "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
-            "dev": true
-        },
-        "node_modules/express/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/express/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/express/node_modules/safe-buffer": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-            "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/fast-deep-equal": {
-            "version": "3.1.3",
-            "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
-            "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-            "dev": true
-        },
-        "node_modules/fast-glob": {
-            "version": "3.3.2",
-            "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.2.tgz",
-            "integrity": "sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==",
-            "dev": true,
-            "dependencies": {
-                "@nodelib/fs.stat": "^2.0.2",
-                "@nodelib/fs.walk": "^1.2.3",
-                "glob-parent": "^5.1.2",
-                "merge2": "^1.3.0",
-                "micromatch": "^4.0.4"
-            },
-            "engines": {
-                "node": ">=8.6.0"
-            }
-        },
-        "node_modules/fast-json-stable-stringify": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-            "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
-            "dev": true
-        },
-        "node_modules/fastest-levenshtein": {
-            "version": "1.0.14",
-            "resolved": "https://registry.npmjs.org/fastest-levenshtein/-/fastest-levenshtein-1.0.14.tgz",
-            "integrity": "sha512-tFfWHjnuUfKE186Tfgr+jtaFc0mZTApEgKDOeyN+FwOqRkO/zK/3h1AiRd8u8CY53owL3CUmGr/oI9p/RdyLTA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 4.9.1"
-            }
-        },
-        "node_modules/fastq": {
-            "version": "1.13.0",
-            "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.13.0.tgz",
-            "integrity": "sha512-YpkpUnK8od0o1hmeSc7UUs/eB/vIPWJYjKck2QKIzAf71Vm1AAQ3EbuZB3g2JIy+pg+ERD0vqI79KyZiB2e2Nw==",
-            "dev": true,
-            "dependencies": {
-                "reusify": "^1.0.4"
-            }
-        },
-        "node_modules/faye-websocket": {
-            "version": "0.11.4",
-            "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz",
-            "integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==",
-            "dev": true,
-            "dependencies": {
-                "websocket-driver": ">=0.5.1"
-            },
-            "engines": {
-                "node": ">=0.8.0"
-            }
-        },
-        "node_modules/file-loader": {
-            "version": "6.2.0",
-            "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-6.2.0.tgz",
-            "integrity": "sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw==",
-            "dev": true,
-            "dependencies": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.0.0 || ^5.0.0"
-            }
-        },
-        "node_modules/file-loader/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/file-type": {
-            "version": "12.4.2",
-            "resolved": "https://registry.npmjs.org/file-type/-/file-type-12.4.2.tgz",
-            "integrity": "sha512-UssQP5ZgIOKelfsaB5CuGAL+Y+q7EmONuiwF3N5HAH0t27rvrttgi6Ra9k/+DVaY9UF6+ybxu5pOXLUdA8N7Vg==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/fill-range": {
-            "version": "7.1.1",
-            "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-            "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-            "dev": true,
-            "dependencies": {
-                "to-regex-range": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/finalhandler": {
-            "version": "1.3.1",
-            "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz",
-            "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==",
-            "dev": true,
-            "dependencies": {
-                "debug": "2.6.9",
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "on-finished": "2.4.1",
-                "parseurl": "~1.3.3",
-                "statuses": "2.0.1",
-                "unpipe": "~1.0.0"
-            },
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/finalhandler/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/finalhandler/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/find-cache-dir": {
-            "version": "3.3.2",
-            "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-3.3.2.tgz",
-            "integrity": "sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig==",
-            "dev": true,
-            "dependencies": {
-                "commondir": "^1.0.1",
-                "make-dir": "^3.0.2",
-                "pkg-dir": "^4.1.0"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/avajs/find-cache-dir?sponsor=1"
-            }
-        },
-        "node_modules/find-up": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
-            "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
-            "dev": true,
-            "dependencies": {
-                "locate-path": "^5.0.0",
-                "path-exists": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/follow-redirects": {
-            "version": "1.15.6",
-            "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.6.tgz",
-            "integrity": "sha512-wWN62YITEaOpSK584EZXJafH1AGpO8RVgElfkuXbTOrPX4fIfOyEpW/CsiNd8JdYrAoOvafRTOEnvsO++qCqFA==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "individual",
-                    "url": "https://github.com/sponsors/RubenVerborgh"
-                }
-            ],
-            "engines": {
-                "node": ">=4.0"
-            },
-            "peerDependenciesMeta": {
-                "debug": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/foreground-child": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.1.1.tgz",
-            "integrity": "sha512-TMKDUnIte6bfb5nWv7V/caI169OHgvwjb7V4WkeUvbQQdjr5rWKqHFiKWb/fcOwB+CzBT+qbWjvj+DVwRskpIg==",
-            "dev": true,
-            "dependencies": {
-                "cross-spawn": "^7.0.0",
-                "signal-exit": "^4.0.1"
-            },
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/foreground-child/node_modules/signal-exit": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
-            "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
-            "dev": true,
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/forwarded": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
-            "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/fraction.js": {
-            "version": "4.3.7",
-            "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.3.7.tgz",
-            "integrity": "sha512-ZsDfxO51wGAXREY55a7la9LScWpwv9RxIrYABrlvOFBlH/ShPnrtsXeuUIfXKKOVicNxQ+o8JTbJvjS4M89yew==",
-            "dev": true,
-            "engines": {
-                "node": "*"
-            },
-            "funding": {
-                "type": "patreon",
-                "url": "https://github.com/sponsors/rawify"
-            }
-        },
-        "node_modules/fresh": {
-            "version": "0.5.2",
-            "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
-            "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/fs-extra": {
-            "version": "10.1.0",
-            "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
-            "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
-            "dev": true,
-            "dependencies": {
-                "graceful-fs": "^4.2.0",
-                "jsonfile": "^6.0.1",
-                "universalify": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=12"
-            }
-        },
-        "node_modules/fs-monkey": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/fs-monkey/-/fs-monkey-1.0.3.tgz",
-            "integrity": "sha512-cybjIfiiE+pTWicSCLFHSrXZ6EilF30oh91FDP9S2B051prEa7QWfrVTQm10/dDpswBDXZugPa1Ogu8Yh+HV0Q==",
-            "dev": true
-        },
-        "node_modules/fs.realpath": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
-            "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
-            "dev": true
-        },
-        "node_modules/fsevents": {
-            "version": "2.3.2",
-            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",
-            "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",
-            "dev": true,
-            "hasInstallScript": true,
-            "optional": true,
-            "os": [
-                "darwin"
-            ],
-            "engines": {
-                "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
-            }
-        },
-        "node_modules/function-bind": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
-            "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-            "dev": true,
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/gensync": {
-            "version": "1.0.0-beta.2",
-            "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
-            "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
-            "dev": true,
-            "engines": {
-                "node": ">=6.9.0"
-            }
-        },
-        "node_modules/get-caller-file": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
-            "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
-            "dev": true,
-            "engines": {
-                "node": "6.* || 8.* || >= 10.*"
-            }
-        },
-        "node_modules/get-intrinsic": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.4.tgz",
-            "integrity": "sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==",
-            "dev": true,
-            "dependencies": {
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "has-proto": "^1.0.1",
-                "has-symbols": "^1.0.3",
-                "hasown": "^2.0.0"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/get-stream": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
-            "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/glob": {
-            "version": "7.2.3",
-            "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
-            "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
-            "dev": true,
-            "dependencies": {
-                "fs.realpath": "^1.0.0",
-                "inflight": "^1.0.4",
-                "inherits": "2",
-                "minimatch": "^3.1.1",
-                "once": "^1.3.0",
-                "path-is-absolute": "^1.0.0"
-            },
-            "engines": {
-                "node": "*"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/glob-parent": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-            "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-            "dev": true,
-            "dependencies": {
-                "is-glob": "^4.0.1"
-            },
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/glob-to-regexp": {
-            "version": "0.4.1",
-            "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz",
-            "integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==",
-            "dev": true
-        },
-        "node_modules/globals": {
-            "version": "11.12.0",
-            "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz",
-            "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/globby": {
-            "version": "10.0.2",
-            "resolved": "https://registry.npmjs.org/globby/-/globby-10.0.2.tgz",
-            "integrity": "sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==",
-            "dev": true,
-            "dependencies": {
-                "@types/glob": "^7.1.1",
-                "array-union": "^2.1.0",
-                "dir-glob": "^3.0.1",
-                "fast-glob": "^3.0.3",
-                "glob": "^7.1.3",
-                "ignore": "^5.1.1",
-                "merge2": "^1.2.3",
-                "slash": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/gopd": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.0.1.tgz",
-            "integrity": "sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==",
-            "dev": true,
-            "dependencies": {
-                "get-intrinsic": "^1.1.3"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/graceful-fs": {
-            "version": "4.2.11",
-            "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
-            "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
-            "dev": true
-        },
-        "node_modules/growly": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/growly/-/growly-1.3.0.tgz",
-            "integrity": "sha512-+xGQY0YyAWCnqy7Cd++hc2JqMYzlm0dG30Jd0beaA64sROr8C4nt8Yc9V5Ro3avlSUDTN0ulqP/VBKi1/lLygw==",
-            "dev": true
-        },
-        "node_modules/handle-thing": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/handle-thing/-/handle-thing-2.0.1.tgz",
-            "integrity": "sha512-9Qn4yBxelxoh2Ow62nP+Ka/kMnOXRi8BXnRaUwezLNhqelnN49xKz4F/dPP8OYLxLxq6JDtZb2i9XznUQbNPTg==",
-            "dev": true
-        },
-        "node_modules/has-flag": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
-            "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/has-property-descriptors": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
-            "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
-            "dev": true,
-            "dependencies": {
-                "es-define-property": "^1.0.0"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/has-proto": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.3.tgz",
-            "integrity": "sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/has-symbols": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz",
-            "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/hash-base": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.1.0.tgz",
-            "integrity": "sha512-1nmYp/rhMDiE7AYkDw+lLwlAzz0AntGIe51F3RfFfEqyQ3feY2eI/NcwC6umIQVOASPMsWJLJScWKSSvzL9IVA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.4",
-                "readable-stream": "^3.6.0",
-                "safe-buffer": "^5.2.0"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/hash-base/node_modules/readable-stream": {
-            "version": "3.6.0",
-            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
-            "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.3",
-                "string_decoder": "^1.1.1",
-                "util-deprecate": "^1.0.1"
-            },
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/hash-base/node_modules/safe-buffer": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-            "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/hash-sum": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/hash-sum/-/hash-sum-1.0.2.tgz",
-            "integrity": "sha512-fUs4B4L+mlt8/XAtSOGMUO1TXmAelItBPtJG7CyHJfYTdDjwisntGO2JQz7oUsatOY9o68+57eziUVNw/mRHmA==",
-            "dev": true
-        },
-        "node_modules/hash.js": {
-            "version": "1.1.7",
-            "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
-            "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.3",
-                "minimalistic-assert": "^1.0.1"
-            }
-        },
-        "node_modules/hasown": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-            "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-            "dev": true,
-            "dependencies": {
-                "function-bind": "^1.1.2"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            }
-        },
-        "node_modules/he": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
-            "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
-            "dev": true,
-            "bin": {
-                "he": "bin/he"
-            }
-        },
-        "node_modules/hmac-drbg": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
-            "integrity": "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==",
-            "dev": true,
-            "dependencies": {
-                "hash.js": "^1.0.3",
-                "minimalistic-assert": "^1.0.0",
-                "minimalistic-crypto-utils": "^1.0.1"
-            }
-        },
-        "node_modules/hpack.js": {
-            "version": "2.1.6",
-            "resolved": "https://registry.npmjs.org/hpack.js/-/hpack.js-2.1.6.tgz",
-            "integrity": "sha512-zJxVehUdMGIKsRaNt7apO2Gqp0BdqW5yaiGHXXmbpvxgBYVZnAql+BJb4RO5ad2MgpbZKn5G6nMnegrH1FcNYQ==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.1",
-                "obuf": "^1.0.0",
-                "readable-stream": "^2.0.1",
-                "wbuf": "^1.1.0"
-            }
-        },
-        "node_modules/html-entities": {
-            "version": "2.3.3",
-            "resolved": "https://registry.npmjs.org/html-entities/-/html-entities-2.3.3.tgz",
-            "integrity": "sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==",
-            "dev": true
-        },
-        "node_modules/html-loader": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/html-loader/-/html-loader-1.3.2.tgz",
-            "integrity": "sha512-DEkUwSd0sijK5PF3kRWspYi56XP7bTNkyg5YWSzBdjaSDmvCufep5c4Vpb3PBf6lUL0YPtLwBfy9fL0t5hBAGA==",
-            "dev": true,
-            "dependencies": {
-                "html-minifier-terser": "^5.1.1",
-                "htmlparser2": "^4.1.0",
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.0.0 || ^5.0.0"
-            }
-        },
-        "node_modules/html-loader/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/html-minifier-terser": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/html-minifier-terser/-/html-minifier-terser-5.1.1.tgz",
-            "integrity": "sha512-ZPr5MNObqnV/T9akshPKbVgyOqLmy+Bxo7juKCfTfnjNniTAMdy4hz21YQqoofMBJD2kdREaqPPdThoR78Tgxg==",
-            "dev": true,
-            "dependencies": {
-                "camel-case": "^4.1.1",
-                "clean-css": "^4.2.3",
-                "commander": "^4.1.1",
-                "he": "^1.2.0",
-                "param-case": "^3.0.3",
-                "relateurl": "^0.2.7",
-                "terser": "^4.6.3"
-            },
-            "bin": {
-                "html-minifier-terser": "cli.js"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/html-minifier-terser/node_modules/clean-css": {
-            "version": "4.2.4",
-            "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-4.2.4.tgz",
-            "integrity": "sha512-EJUDT7nDVFDvaQgAo2G/PJvxmp1o/c6iXLbswsBbUFXi1Nr+AjA2cKmfbKDMjMvzEe75g3P6JkaDDAKk96A85A==",
-            "dev": true,
-            "dependencies": {
-                "source-map": "~0.6.0"
-            },
-            "engines": {
-                "node": ">= 4.0"
-            }
-        },
-        "node_modules/html-minifier-terser/node_modules/commander": {
-            "version": "4.1.1",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
-            "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/html-minifier-terser/node_modules/terser": {
-            "version": "4.8.1",
-            "resolved": "https://registry.npmjs.org/terser/-/terser-4.8.1.tgz",
-            "integrity": "sha512-4GnLC0x667eJG0ewJTa6z/yXrbLGv80D9Ru6HIpCQmO+Q4PfEtBFi0ObSckqwL6VyQv/7ENJieXHo2ANmdQwgw==",
-            "dev": true,
-            "dependencies": {
-                "commander": "^2.20.0",
-                "source-map": "~0.6.1",
-                "source-map-support": "~0.5.12"
-            },
-            "bin": {
-                "terser": "bin/terser"
-            },
-            "engines": {
-                "node": ">=6.0.0"
-            }
-        },
-        "node_modules/html-minifier-terser/node_modules/terser/node_modules/commander": {
-            "version": "2.20.3",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-            "dev": true
-        },
-        "node_modules/htmlparser2": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-4.1.0.tgz",
-            "integrity": "sha512-4zDq1a1zhE4gQso/c5LP1OtrhYTncXNSpvJYtWJBtXAETPlMfi3IFNjGuQbYLuVY4ZR0QMqRVvo4Pdy9KLyP8Q==",
-            "dev": true,
-            "dependencies": {
-                "domelementtype": "^2.0.1",
-                "domhandler": "^3.0.0",
-                "domutils": "^2.0.0",
-                "entities": "^2.0.0"
-            }
-        },
-        "node_modules/http-deceiver": {
-            "version": "1.2.7",
-            "resolved": "https://registry.npmjs.org/http-deceiver/-/http-deceiver-1.2.7.tgz",
-            "integrity": "sha512-LmpOGxTfbpgtGVxJrj5k7asXHCgNZp5nLfp+hWc8QQRqtb7fUy6kRY3BO1h9ddF6yIPYUARgxGOwB42DnxIaNw==",
-            "dev": true
-        },
-        "node_modules/http-errors": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
-            "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
-            "dev": true,
-            "dependencies": {
-                "depd": "2.0.0",
-                "inherits": "2.0.4",
-                "setprototypeof": "1.2.0",
-                "statuses": "2.0.1",
-                "toidentifier": "1.0.1"
-            },
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/http-parser-js": {
-            "version": "0.5.8",
-            "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.5.8.tgz",
-            "integrity": "sha512-SGeBX54F94Wgu5RH3X5jsDtf4eHyRogWX1XGT3b4HuW3tQPM4AaBzoUji/4AAJNXCEOWZ5O0DgZmJw1947gD5Q==",
-            "dev": true
-        },
-        "node_modules/http-proxy": {
-            "version": "1.18.1",
-            "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz",
-            "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==",
-            "dev": true,
-            "dependencies": {
-                "eventemitter3": "^4.0.0",
-                "follow-redirects": "^1.0.0",
-                "requires-port": "^1.0.0"
-            },
-            "engines": {
-                "node": ">=8.0.0"
-            }
-        },
-        "node_modules/http-proxy-middleware": {
-            "version": "2.0.6",
-            "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-2.0.6.tgz",
-            "integrity": "sha512-ya/UeJ6HVBYxrgYotAZo1KvPWlgB48kUJLDePFeneHsVujFaW5WNj2NgWCAE//B1Dl02BIfYlpNgBy8Kf8Rjmw==",
-            "dev": true,
-            "dependencies": {
-                "@types/http-proxy": "^1.17.8",
-                "http-proxy": "^1.18.1",
-                "is-glob": "^4.0.1",
-                "is-plain-obj": "^3.0.0",
-                "micromatch": "^4.0.2"
-            },
-            "engines": {
-                "node": ">=12.0.0"
-            },
-            "peerDependencies": {
-                "@types/express": "^4.17.13"
-            },
-            "peerDependenciesMeta": {
-                "@types/express": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/https-browserify": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/https-browserify/-/https-browserify-1.0.0.tgz",
-            "integrity": "sha512-J+FkSdyD+0mA0N+81tMotaRMfSL9SGi+xpD3T6YApKsc3bGSXJlfXri3VyFOeYkfLRQisDk1W+jIFFKBeUBbBg==",
-            "dev": true
-        },
-        "node_modules/human-signals": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
-            "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
-            "dev": true,
-            "engines": {
-                "node": ">=10.17.0"
-            }
-        },
-        "node_modules/hydefront": {
-            "version": "3.4.0",
-            "resolved": "https://registry.npmjs.org/hydefront/-/hydefront-3.4.0.tgz",
-            "integrity": "sha512-Au1s9Yfw57r0It8lmUjpTMlYuCnwob9zK1TWxOR5ruuvZf8ESDbAuTutrzQfpxnb7yC2KxFt2RKOBpJnjjAveQ==",
-            "dev": true
-        },
-        "node_modules/iconv-lite": {
-            "version": "0.4.24",
-            "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
-            "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
-            "dev": true,
-            "dependencies": {
-                "safer-buffer": ">= 2.1.2 < 3"
-            },
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/icss-utils": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-5.1.0.tgz",
-            "integrity": "sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >= 14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.1.0"
-            }
-        },
-        "node_modules/ieee754": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
-            "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/ignore": {
-            "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.2.0.tgz",
-            "integrity": "sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 4"
-            }
-        },
-        "node_modules/imagemin": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/imagemin/-/imagemin-7.0.1.tgz",
-            "integrity": "sha512-33AmZ+xjZhg2JMCe+vDf6a9mzWukE7l+wAtesjE7KyteqqKjzxv7aVQeWnul1Ve26mWvEQqyPwl0OctNBfSR9w==",
-            "dev": true,
-            "dependencies": {
-                "file-type": "^12.0.0",
-                "globby": "^10.0.0",
-                "graceful-fs": "^4.2.2",
-                "junk": "^3.1.0",
-                "make-dir": "^3.0.0",
-                "p-pipe": "^3.0.0",
-                "replace-ext": "^1.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/img-loader": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/img-loader/-/img-loader-4.0.0.tgz",
-            "integrity": "sha512-UwRcPQdwdOyEHyCxe1V9s9YFwInwEWCpoO+kJGfIqDrBDqA8jZUsEZTxQ0JteNPGw/Gupmwesk2OhLTcnw6tnQ==",
-            "dev": true,
-            "dependencies": {
-                "loader-utils": "^1.1.0"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "peerDependencies": {
-                "imagemin": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
-            }
-        },
-        "node_modules/img-loader/node_modules/json5": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
-            "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
-            "dev": true,
-            "dependencies": {
-                "minimist": "^1.2.0"
-            },
-            "bin": {
-                "json5": "lib/cli.js"
-            }
-        },
-        "node_modules/img-loader/node_modules/loader-utils": {
-            "version": "1.4.2",
-            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
-            "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
-            "dev": true,
-            "dependencies": {
-                "big.js": "^5.2.2",
-                "emojis-list": "^3.0.0",
-                "json5": "^1.0.1"
-            },
-            "engines": {
-                "node": ">=4.0.0"
-            }
-        },
-        "node_modules/import-fresh": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.0.tgz",
-            "integrity": "sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==",
-            "dev": true,
-            "dependencies": {
-                "parent-module": "^1.0.0",
-                "resolve-from": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/import-local": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.1.0.tgz",
-            "integrity": "sha512-ASB07uLtnDs1o6EHjKpX34BKYDSqnFerfTOJL2HvMqF70LnxpjkzDB8J44oT9pu4AMPkQwf8jl6szgvNd2tRIg==",
-            "dev": true,
-            "dependencies": {
-                "pkg-dir": "^4.2.0",
-                "resolve-cwd": "^3.0.0"
-            },
-            "bin": {
-                "import-local-fixture": "fixtures/cli.js"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/inflight": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
-            "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
-            "dev": true,
-            "dependencies": {
-                "once": "^1.3.0",
-                "wrappy": "1"
-            }
-        },
-        "node_modules/inherits": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
-            "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
-            "dev": true
-        },
-        "node_modules/interpret": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/interpret/-/interpret-2.2.0.tgz",
-            "integrity": "sha512-Ju0Bz/cEia55xDwUWEa8+olFpCiQoypjnQySseKtmjNrnps3P+xfpUmGr90T7yjlVJmOtybRvPXhKMbHr+fWnw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/ipaddr.js": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.0.1.tgz",
-            "integrity": "sha512-1qTgH9NG+IIJ4yfKs2e6Pp1bZg8wbDbKHT21HrLIeYBTRLgMYKnMTPAuI3Lcs61nfx5h1xlXnbJtH1kX5/d/ng==",
-            "dev": true,
-            "engines": {
-                "node": ">= 10"
-            }
-        },
-        "node_modules/is-arrayish": {
-            "version": "0.2.1",
-            "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
-            "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
-            "dev": true
-        },
-        "node_modules/is-binary-path": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
-            "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
-            "dev": true,
-            "dependencies": {
-                "binary-extensions": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/is-buffer": {
-            "version": "1.1.6",
-            "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
-            "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
-            "dev": true
-        },
-        "node_modules/is-core-module": {
-            "version": "2.13.1",
-            "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.13.1.tgz",
-            "integrity": "sha512-hHrIjvZsftOsvKSn2TRYl63zvxsgE0K+0mYMoH6gD4omR5IWB2KynivBQczo3+wF1cCkjzvptnI9Q0sPU66ilw==",
-            "dev": true,
-            "dependencies": {
-                "hasown": "^2.0.0"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/is-docker": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
-            "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
-            "dev": true,
-            "bin": {
-                "is-docker": "cli.js"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/is-extglob": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
-            "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/is-fullwidth-code-point": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
-            "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/is-glob": {
-            "version": "4.0.3",
-            "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
-            "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-            "dev": true,
-            "dependencies": {
-                "is-extglob": "^2.1.1"
-            },
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/is-number": {
-            "version": "7.0.0",
-            "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-            "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.12.0"
-            }
-        },
-        "node_modules/is-plain-obj": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-3.0.0.tgz",
-            "integrity": "sha512-gwsOE28k+23GP1B6vFl1oVh/WOzmawBrKwo5Ev6wMKzPkaXaCDIQKzLnvsA42DRlbVTWorkgTKIviAKCWkfUwA==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/is-plain-object": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz",
-            "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==",
-            "dev": true,
-            "dependencies": {
-                "isobject": "^3.0.1"
-            },
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/is-stream": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
-            "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/is-wsl": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
-            "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
-            "dev": true,
-            "dependencies": {
-                "is-docker": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/isarray": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-            "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
-            "dev": true
-        },
-        "node_modules/isexe": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-            "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-            "dev": true
-        },
-        "node_modules/isobject": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz",
-            "integrity": "sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/jackspeak": {
-            "version": "2.3.6",
-            "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-2.3.6.tgz",
-            "integrity": "sha512-N3yCS/NegsOBokc8GAdM8UcmfsKiSS8cipheD/nivzr700H+nsMOxJjQnvwOcRYVuFkdH0wGUvW2WbXGmrZGbQ==",
-            "dev": true,
-            "dependencies": {
-                "@isaacs/cliui": "^8.0.2"
-            },
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            },
-            "optionalDependencies": {
-                "@pkgjs/parseargs": "^0.11.0"
-            }
-        },
-        "node_modules/jest-worker": {
-            "version": "27.5.1",
-            "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-27.5.1.tgz",
-            "integrity": "sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==",
-            "dev": true,
-            "dependencies": {
-                "@types/node": "*",
-                "merge-stream": "^2.0.0",
-                "supports-color": "^8.0.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            }
-        },
-        "node_modules/jest-worker/node_modules/has-flag": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-            "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/jest-worker/node_modules/supports-color": {
-            "version": "8.1.1",
-            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
-            "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
-            "dev": true,
-            "dependencies": {
-                "has-flag": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/supports-color?sponsor=1"
-            }
-        },
-        "node_modules/jiti": {
-            "version": "1.21.0",
-            "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.0.tgz",
-            "integrity": "sha512-gFqAIbuKyyso/3G2qhiO2OM6shY6EPP/R0+mkDbyspxKazh8BXDC5FiFsUjlczgdNz/vfra0da2y+aHrusLG/Q==",
-            "dev": true,
-            "bin": {
-                "jiti": "bin/jiti.js"
-            }
-        },
-        "node_modules/js-tokens": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-            "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-            "dev": true
-        },
-        "node_modules/jsesc": {
-            "version": "2.5.2",
-            "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz",
-            "integrity": "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==",
-            "dev": true,
-            "bin": {
-                "jsesc": "bin/jsesc"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/json-parse-even-better-errors": {
-            "version": "2.3.1",
-            "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
-            "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
-            "dev": true
-        },
-        "node_modules/json-schema-traverse": {
-            "version": "0.4.1",
-            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-            "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
-            "dev": true
-        },
-        "node_modules/json5": {
-            "version": "2.2.3",
-            "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
-            "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
-            "dev": true,
-            "bin": {
-                "json5": "lib/cli.js"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/jsonfile": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz",
-            "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==",
-            "dev": true,
-            "dependencies": {
-                "universalify": "^2.0.0"
-            },
-            "optionalDependencies": {
-                "graceful-fs": "^4.1.6"
-            }
-        },
-        "node_modules/junk": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/junk/-/junk-3.1.0.tgz",
-            "integrity": "sha512-pBxcB3LFc8QVgdggvZWyeys+hnrNWg4OcZIU/1X59k5jQdLBlCsYGRQaz234SqoRLTCgMH00fY0xRJH+F9METQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/kind-of": {
-            "version": "6.0.3",
-            "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
-            "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/klona": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.5.tgz",
-            "integrity": "sha512-pJiBpiXMbt7dkzXe8Ghj/u4FfXOOa98fPW+bihOJ4SjnoijweJrNThJfd3ifXpXhREjpoF2mZVH1GfS9LV3kHQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/laravel-mix": {
-            "version": "6.0.49",
-            "resolved": "https://registry.npmjs.org/laravel-mix/-/laravel-mix-6.0.49.tgz",
-            "integrity": "sha512-bBMFpFjp26XfijPvY5y9zGKud7VqlyOE0OWUcPo3vTBY5asw8LTjafAbee1dhfLz6PWNqDziz69CP78ELSpfKw==",
-            "dev": true,
-            "dependencies": {
-                "@babel/core": "^7.15.8",
-                "@babel/plugin-proposal-object-rest-spread": "^7.15.6",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-                "@babel/plugin-transform-runtime": "^7.15.8",
-                "@babel/preset-env": "^7.15.8",
-                "@babel/runtime": "^7.15.4",
-                "@types/babel__core": "^7.1.16",
-                "@types/clean-css": "^4.2.5",
-                "@types/imagemin-gifsicle": "^7.0.1",
-                "@types/imagemin-mozjpeg": "^8.0.1",
-                "@types/imagemin-optipng": "^5.2.1",
-                "@types/imagemin-svgo": "^8.0.0",
-                "autoprefixer": "^10.4.0",
-                "babel-loader": "^8.2.3",
-                "chalk": "^4.1.2",
-                "chokidar": "^3.5.2",
-                "clean-css": "^5.2.4",
-                "cli-table3": "^0.6.0",
-                "collect.js": "^4.28.5",
-                "commander": "^7.2.0",
-                "concat": "^1.0.3",
-                "css-loader": "^5.2.6",
-                "cssnano": "^5.0.8",
-                "dotenv": "^10.0.0",
-                "dotenv-expand": "^5.1.0",
-                "file-loader": "^6.2.0",
-                "fs-extra": "^10.0.0",
-                "glob": "^7.2.0",
-                "html-loader": "^1.3.2",
-                "imagemin": "^7.0.1",
-                "img-loader": "^4.0.0",
-                "lodash": "^4.17.21",
-                "md5": "^2.3.0",
-                "mini-css-extract-plugin": "^1.6.2",
-                "node-libs-browser": "^2.2.1",
-                "postcss-load-config": "^3.1.0",
-                "postcss-loader": "^6.2.0",
-                "semver": "^7.3.5",
-                "strip-ansi": "^6.0.0",
-                "style-loader": "^2.0.0",
-                "terser": "^5.9.0",
-                "terser-webpack-plugin": "^5.2.4",
-                "vue-style-loader": "^4.1.3",
-                "webpack": "^5.60.0",
-                "webpack-cli": "^4.9.1",
-                "webpack-dev-server": "^4.7.3",
-                "webpack-merge": "^5.8.0",
-                "webpack-notifier": "^1.14.1",
-                "webpackbar": "^5.0.0-3",
-                "yargs": "^17.2.1"
-            },
-            "bin": {
-                "laravel-mix": "bin/cli.js",
-                "mix": "bin/cli.js"
-            },
-            "engines": {
-                "node": ">=12.14.0"
-            },
-            "peerDependencies": {
-                "@babel/core": "^7.15.8",
-                "@babel/plugin-proposal-object-rest-spread": "^7.15.6",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-                "@babel/plugin-transform-runtime": "^7.15.8",
-                "@babel/preset-env": "^7.15.8",
-                "postcss": "^8.3.11",
-                "webpack": "^5.60.0",
-                "webpack-cli": "^4.9.1"
-            }
-        },
-        "node_modules/lilconfig": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-2.1.0.tgz",
-            "integrity": "sha512-utWOt/GHzuUxnLKxB6dk81RoOeoNeHgbrXiuGk4yyF5qlRz+iIVWu56E2fqGHFrXz0QNUhLB/8nKqvRH66JKGQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/lines-and-columns": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
-            "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
-            "dev": true
-        },
-        "node_modules/loader-runner": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.0.tgz",
-            "integrity": "sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==",
-            "dev": true,
-            "engines": {
-                "node": ">=6.11.5"
-            }
-        },
-        "node_modules/loader-utils": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.4.tgz",
-            "integrity": "sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw==",
-            "dev": true,
-            "dependencies": {
-                "big.js": "^5.2.2",
-                "emojis-list": "^3.0.0",
-                "json5": "^2.1.2"
-            },
-            "engines": {
-                "node": ">=8.9.0"
-            }
-        },
-        "node_modules/locate-path": {
-            "version": "5.0.0",
-            "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
-            "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
-            "dev": true,
-            "dependencies": {
-                "p-locate": "^4.1.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/lodash": {
-            "version": "4.17.21",
-            "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
-            "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
-            "dev": true
-        },
-        "node_modules/lodash.castarray": {
-            "version": "4.4.0",
-            "resolved": "https://registry.npmjs.org/lodash.castarray/-/lodash.castarray-4.4.0.tgz",
-            "integrity": "sha512-aVx8ztPv7/2ULbArGJ2Y42bG1mEQ5mGjpdvrbJcJFU3TbYybe+QlLS4pst9zV52ymy2in1KpFPiZnAOATxD4+Q==",
-            "dev": true
-        },
-        "node_modules/lodash.debounce": {
-            "version": "4.0.8",
-            "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
-            "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==",
-            "dev": true
-        },
-        "node_modules/lodash.isplainobject": {
-            "version": "4.0.6",
-            "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
-            "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
-            "dev": true
-        },
-        "node_modules/lodash.memoize": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
-            "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
-            "dev": true
-        },
-        "node_modules/lodash.merge": {
-            "version": "4.6.2",
-            "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
-            "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
-            "dev": true
-        },
-        "node_modules/lodash.uniq": {
-            "version": "4.5.0",
-            "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz",
-            "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==",
-            "dev": true
-        },
-        "node_modules/lower-case": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/lower-case/-/lower-case-2.0.2.tgz",
-            "integrity": "sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg==",
-            "dev": true,
-            "dependencies": {
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/lru-cache": {
-            "version": "6.0.0",
-            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz",
-            "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==",
-            "dev": true,
-            "dependencies": {
-                "yallist": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/make-dir": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz",
-            "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==",
-            "dev": true,
-            "dependencies": {
-                "semver": "^6.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/make-dir/node_modules/semver": {
-            "version": "6.3.1",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-            "dev": true,
-            "bin": {
-                "semver": "bin/semver.js"
-            }
-        },
-        "node_modules/md5": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz",
-            "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==",
-            "dev": true,
-            "dependencies": {
-                "charenc": "0.0.2",
-                "crypt": "0.0.2",
-                "is-buffer": "~1.1.6"
-            }
-        },
-        "node_modules/md5.js": {
-            "version": "1.3.5",
-            "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.5.tgz",
-            "integrity": "sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==",
-            "dev": true,
-            "dependencies": {
-                "hash-base": "^3.0.0",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            }
-        },
-        "node_modules/mdn-data": {
-            "version": "2.0.14",
-            "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.14.tgz",
-            "integrity": "sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==",
-            "dev": true
-        },
-        "node_modules/media-typer": {
-            "version": "0.3.0",
-            "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
-            "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/memfs": {
-            "version": "3.4.7",
-            "resolved": "https://registry.npmjs.org/memfs/-/memfs-3.4.7.tgz",
-            "integrity": "sha512-ygaiUSNalBX85388uskeCyhSAoOSgzBbtVCr9jA2RROssFL9Q19/ZXFqS+2Th2sr1ewNIWgFdLzLC3Yl1Zv+lw==",
-            "dev": true,
-            "dependencies": {
-                "fs-monkey": "^1.0.3"
-            },
-            "engines": {
-                "node": ">= 4.0.0"
-            }
-        },
-        "node_modules/merge-descriptors": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
-            "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
-            "dev": true,
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/merge-stream": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
-            "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
-            "dev": true
-        },
-        "node_modules/merge2": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
-            "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/methods": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
-            "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/micromatch": {
-            "version": "4.0.5",
-            "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.5.tgz",
-            "integrity": "sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==",
-            "dev": true,
-            "dependencies": {
-                "braces": "^3.0.2",
-                "picomatch": "^2.3.1"
-            },
-            "engines": {
-                "node": ">=8.6"
-            }
-        },
-        "node_modules/miller-rabin": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/miller-rabin/-/miller-rabin-4.0.1.tgz",
-            "integrity": "sha512-115fLhvZVqWwHPbClyntxEVfVDfl9DLLTuJvq3g2O/Oxi8AiNouAHvDSzHS0viUJc+V5vm3eq91Xwqn9dp4jRA==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.0.0",
-                "brorand": "^1.0.1"
-            },
-            "bin": {
-                "miller-rabin": "bin/miller-rabin"
-            }
-        },
-        "node_modules/miller-rabin/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/mime": {
-            "version": "1.6.0",
-            "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
-            "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
-            "dev": true,
-            "bin": {
-                "mime": "cli.js"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/mime-db": {
-            "version": "1.52.0",
-            "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
-            "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/mime-types": {
-            "version": "2.1.35",
-            "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
-            "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
-            "dev": true,
-            "dependencies": {
-                "mime-db": "1.52.0"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/mimic-fn": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
-            "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/mini-css-extract-plugin": {
-            "version": "1.6.2",
-            "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-1.6.2.tgz",
-            "integrity": "sha512-WhDvO3SjGm40oV5y26GjMJYjd2UMqrLAGKy5YS2/3QKJy2F7jgynuHTir/tgUUOiNQu5saXHdc8reo7YuhhT4Q==",
-            "dev": true,
-            "dependencies": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0",
-                "webpack-sources": "^1.1.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.4.0 || ^5.0.0"
-            }
-        },
-        "node_modules/mini-css-extract-plugin/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/minimalistic-assert": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
-            "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
-            "dev": true
-        },
-        "node_modules/minimalistic-crypto-utils": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
-            "integrity": "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==",
-            "dev": true
-        },
-        "node_modules/minimatch": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-            "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
-            "dev": true,
-            "dependencies": {
-                "brace-expansion": "^1.1.7"
-            },
-            "engines": {
-                "node": "*"
-            }
-        },
-        "node_modules/minimist": {
-            "version": "1.2.6",
-            "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.6.tgz",
-            "integrity": "sha512-Jsjnk4bw3YJqYzbdyBiNsPWHPfO++UGG749Cxs6peCu5Xg4nrena6OVxOYxrQTqww0Jmwt+Ref8rggumkTLz9Q==",
-            "dev": true
-        },
-        "node_modules/minipass": {
-            "version": "7.0.4",
-            "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.0.4.tgz",
-            "integrity": "sha512-jYofLM5Dam9279rdkWzqHozUo4ybjdZmCsDHePy5V/PbBcVMiSZR97gmAy45aqi8CK1lG2ECd356FU86avfwUQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            }
-        },
-        "node_modules/ms": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz",
-            "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==",
-            "dev": true
-        },
-        "node_modules/multicast-dns": {
-            "version": "7.2.5",
-            "resolved": "https://registry.npmjs.org/multicast-dns/-/multicast-dns-7.2.5.tgz",
-            "integrity": "sha512-2eznPJP8z2BFLX50tf0LuODrpINqP1RVIm/CObbTcBRITQgmC/TjcREF1NeTBzIcR5XO/ukWo+YHOjBbFwIupg==",
-            "dev": true,
-            "dependencies": {
-                "dns-packet": "^5.2.2",
-                "thunky": "^1.0.2"
-            },
-            "bin": {
-                "multicast-dns": "cli.js"
-            }
-        },
-        "node_modules/mz": {
-            "version": "2.7.0",
-            "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
-            "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==",
-            "dev": true,
-            "dependencies": {
-                "any-promise": "^1.0.0",
-                "object-assign": "^4.0.1",
-                "thenify-all": "^1.0.0"
-            }
-        },
-        "node_modules/nanoid": {
-            "version": "3.3.7",
-            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.7.tgz",
-            "integrity": "sha512-eSRppjcPIatRIMC1U6UngP8XFcz8MQWGQdt1MTBQ7NaAmvXDfvNxbvWV3x2y6CdEUciCSsDHDQZbhYaB8QEo2g==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "bin": {
-                "nanoid": "bin/nanoid.cjs"
-            },
-            "engines": {
-                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
-            }
-        },
-        "node_modules/negotiator": {
-            "version": "0.6.3",
-            "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
-            "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/neo-async": {
-            "version": "2.6.2",
-            "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
-            "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
-            "dev": true
-        },
-        "node_modules/no-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/no-case/-/no-case-3.0.4.tgz",
-            "integrity": "sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg==",
-            "dev": true,
-            "dependencies": {
-                "lower-case": "^2.0.2",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/node-forge": {
-            "version": "1.3.1",
-            "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.3.1.tgz",
-            "integrity": "sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6.13.0"
-            }
-        },
-        "node_modules/node-libs-browser": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/node-libs-browser/-/node-libs-browser-2.2.1.tgz",
-            "integrity": "sha512-h/zcD8H9kaDZ9ALUWwlBUDo6TKF8a7qBSCSEGfjTVIYeqsioSKaAX+BN7NgiMGp6iSIXZ3PxgCu8KS3b71YK5Q==",
-            "dev": true,
-            "dependencies": {
-                "assert": "^1.1.1",
-                "browserify-zlib": "^0.2.0",
-                "buffer": "^4.3.0",
-                "console-browserify": "^1.1.0",
-                "constants-browserify": "^1.0.0",
-                "crypto-browserify": "^3.11.0",
-                "domain-browser": "^1.1.1",
-                "events": "^3.0.0",
-                "https-browserify": "^1.0.0",
-                "os-browserify": "^0.3.0",
-                "path-browserify": "0.0.1",
-                "process": "^0.11.10",
-                "punycode": "^1.2.4",
-                "querystring-es3": "^0.2.0",
-                "readable-stream": "^2.3.3",
-                "stream-browserify": "^2.0.1",
-                "stream-http": "^2.7.2",
-                "string_decoder": "^1.0.0",
-                "timers-browserify": "^2.0.4",
-                "tty-browserify": "0.0.0",
-                "url": "^0.11.0",
-                "util": "^0.11.0",
-                "vm-browserify": "^1.0.1"
-            }
-        },
-        "node_modules/node-notifier": {
-            "version": "9.0.1",
-            "resolved": "https://registry.npmjs.org/node-notifier/-/node-notifier-9.0.1.tgz",
-            "integrity": "sha512-fPNFIp2hF/Dq7qLDzSg4vZ0J4e9v60gJR+Qx7RbjbWqzPDdEqeVpEx5CFeDAELIl+A/woaaNn1fQ5nEVerMxJg==",
-            "dev": true,
-            "dependencies": {
-                "growly": "^1.3.0",
-                "is-wsl": "^2.2.0",
-                "semver": "^7.3.2",
-                "shellwords": "^0.1.1",
-                "uuid": "^8.3.0",
-                "which": "^2.0.2"
-            }
-        },
-        "node_modules/node-releases": {
-            "version": "2.0.18",
-            "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.18.tgz",
-            "integrity": "sha512-d9VeXT4SJ7ZeOqGX6R5EM022wpL+eWPooLI+5UpWn2jCT1aosUQEhQP214x33Wkwx3JQMvIm+tIoVOdodFS40g==",
-            "dev": true
-        },
-        "node_modules/normalize-path": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
-            "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/normalize-range": {
-            "version": "0.1.2",
-            "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",
-            "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/normalize-url": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
-            "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/npm-run-path": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
-            "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
-            "dev": true,
-            "dependencies": {
-                "path-key": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/nth-check": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
-            "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
-            "dev": true,
-            "dependencies": {
-                "boolbase": "^1.0.0"
-            },
-            "funding": {
-                "url": "https://github.com/fb55/nth-check?sponsor=1"
-            }
-        },
-        "node_modules/object-assign": {
-            "version": "4.1.1",
-            "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-            "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/object-hash": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
-            "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/object-inspect": {
-            "version": "1.13.2",
-            "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.2.tgz",
-            "integrity": "sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/object-keys": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
-            "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            }
-        },
-        "node_modules/object.assign": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.2.tgz",
-            "integrity": "sha512-ixT2L5THXsApyiUPYKmW+2EHpXXe5Ii3M+f4e+aJFAHao5amFRW6J0OO6c/LU8Be47utCx2GL89hxGB6XSmKuQ==",
-            "dev": true,
-            "dependencies": {
-                "call-bind": "^1.0.0",
-                "define-properties": "^1.1.3",
-                "has-symbols": "^1.0.1",
-                "object-keys": "^1.1.1"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/obuf": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/obuf/-/obuf-1.1.2.tgz",
-            "integrity": "sha512-PX1wu0AmAdPqOL1mWhqmlOd8kOIZQwGZw6rh7uby9fTc5lhaOWFLX3I6R1hrF9k3zUY40e6igsLGkDXK92LJNg==",
-            "dev": true
-        },
-        "node_modules/on-finished": {
-            "version": "2.4.1",
-            "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
-            "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
-            "dev": true,
-            "dependencies": {
-                "ee-first": "1.1.1"
-            },
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/on-headers": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.0.2.tgz",
-            "integrity": "sha512-pZAE+FJLoyITytdqK0U5s+FIpjN0JP3OzFi/u8Rx+EV5/W+JTWGXG8xFzevE7AjBfDqHv/8vL8qQsIhHnqRkrA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/once": {
-            "version": "1.4.0",
-            "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-            "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
-            "dev": true,
-            "dependencies": {
-                "wrappy": "1"
-            }
-        },
-        "node_modules/onetime": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
-            "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
-            "dev": true,
-            "dependencies": {
-                "mimic-fn": "^2.1.0"
-            },
-            "engines": {
-                "node": ">=6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/open": {
-            "version": "8.4.0",
-            "resolved": "https://registry.npmjs.org/open/-/open-8.4.0.tgz",
-            "integrity": "sha512-XgFPPM+B28FtCCgSb9I+s9szOC1vZRSwgWsRUA5ylIxRTgKozqjOCrVOqGsYABPYK5qnfqClxZTFBa8PKt2v6Q==",
-            "dev": true,
-            "dependencies": {
-                "define-lazy-prop": "^2.0.0",
-                "is-docker": "^2.1.1",
-                "is-wsl": "^2.2.0"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/os-browserify": {
-            "version": "0.3.0",
-            "resolved": "https://registry.npmjs.org/os-browserify/-/os-browserify-0.3.0.tgz",
-            "integrity": "sha512-gjcpUc3clBf9+210TRaDWbf+rZZZEshZ+DlXMRCeAjp0xhTrnQsKHypIy1J3d5hKdUzj69t708EHtU8P6bUn0A==",
-            "dev": true
-        },
-        "node_modules/p-limit": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
-            "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
-            "dev": true,
-            "dependencies": {
-                "p-try": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/p-locate": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
-            "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
-            "dev": true,
-            "dependencies": {
-                "p-limit": "^2.2.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/p-pipe": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/p-pipe/-/p-pipe-3.1.0.tgz",
-            "integrity": "sha512-08pj8ATpzMR0Y80x50yJHn37NF6vjrqHutASaX5LiH5npS9XPvrUmscd9MF5R4fuYRHOxQR1FfMIlF7AzwoPqw==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/p-retry": {
-            "version": "4.6.2",
-            "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",
-            "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",
-            "dev": true,
-            "dependencies": {
-                "@types/retry": "0.12.0",
-                "retry": "^0.13.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/p-try": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
-            "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/pako": {
-            "version": "1.0.11",
-            "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
-            "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
-            "dev": true
-        },
-        "node_modules/param-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/param-case/-/param-case-3.0.4.tgz",
-            "integrity": "sha512-RXlj7zCYokReqWpOPH9oYivUzLYZ5vAPIfEmCTNViosC78F8F0H9y7T7gG2M39ymgutxF5gcFEsyZQSph9Bp3A==",
-            "dev": true,
-            "dependencies": {
-                "dot-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/parent-module": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
-            "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
-            "dev": true,
-            "dependencies": {
-                "callsites": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/parse-asn1": {
-            "version": "5.1.6",
-            "resolved": "https://registry.npmjs.org/parse-asn1/-/parse-asn1-5.1.6.tgz",
-            "integrity": "sha512-RnZRo1EPU6JBnra2vGHj0yhp6ebyjBZpmUCLHWiFhxlzvBCCpAuZ7elsBp1PVAbQN0/04VD/19rfzlBSwLstMw==",
-            "dev": true,
-            "dependencies": {
-                "asn1.js": "^5.2.0",
-                "browserify-aes": "^1.0.0",
-                "evp_bytestokey": "^1.0.0",
-                "pbkdf2": "^3.0.3",
-                "safe-buffer": "^5.1.1"
-            }
-        },
-        "node_modules/parse-json": {
-            "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
-            "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
-            "dev": true,
-            "dependencies": {
-                "@babel/code-frame": "^7.0.0",
-                "error-ex": "^1.3.1",
-                "json-parse-even-better-errors": "^2.3.0",
-                "lines-and-columns": "^1.1.6"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/parseurl": {
-            "version": "1.3.3",
-            "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
-            "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/pascal-case": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/pascal-case/-/pascal-case-3.1.2.tgz",
-            "integrity": "sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g==",
-            "dev": true,
-            "dependencies": {
-                "no-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node_modules/path-browserify": {
-            "version": "0.0.1",
-            "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-0.0.1.tgz",
-            "integrity": "sha512-BapA40NHICOS+USX9SN4tyhq+A2RrN/Ws5F0Z5aMHDp98Fl86lX8Oti8B7uN93L4Ifv4fHOEA+pQw87gmMO/lQ==",
-            "dev": true
-        },
-        "node_modules/path-exists": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
-            "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/path-is-absolute": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
-            "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/path-key": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-            "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/path-parse": {
-            "version": "1.0.7",
-            "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
-            "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
-            "dev": true
-        },
-        "node_modules/path-scurry": {
-            "version": "1.10.2",
-            "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.10.2.tgz",
-            "integrity": "sha512-7xTavNy5RQXnsjANvVvMkEjvloOinkAjv/Z6Ildz9v2RinZ4SBKTWFOVRbaF8p0vpHnyjV/UwNDdKuUv6M5qcA==",
-            "dev": true,
-            "dependencies": {
-                "lru-cache": "^10.2.0",
-                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/path-scurry/node_modules/lru-cache": {
-            "version": "10.2.1",
-            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.2.1.tgz",
-            "integrity": "sha512-tS24spDe/zXhWbNPErCHs/AGOzbKGHT+ybSBqmdLm8WZ1xXLWvH8Qn71QPAlqVhd0qUTWjy+Kl9JmISgDdEjsA==",
-            "dev": true,
-            "engines": {
-                "node": "14 || >=16.14"
-            }
-        },
-        "node_modules/path-to-regexp": {
-            "version": "0.1.10",
-            "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.10.tgz",
-            "integrity": "sha512-7lf7qcQidTku0Gu3YDPc8DJ1q7OOucfa/BSsIwjuh56VU7katFvuM8hULfkwB3Fns/rsVF7PwPKVw1sl5KQS9w==",
-            "dev": true
-        },
-        "node_modules/path-type": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
-            "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/pbkdf2": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.1.2.tgz",
-            "integrity": "sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==",
-            "dev": true,
-            "dependencies": {
-                "create-hash": "^1.1.2",
-                "create-hmac": "^1.1.4",
-                "ripemd160": "^2.0.1",
-                "safe-buffer": "^5.0.1",
-                "sha.js": "^2.4.8"
-            },
-            "engines": {
-                "node": ">=0.12"
-            }
-        },
-        "node_modules/picocolors": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.0.tgz",
-            "integrity": "sha512-TQ92mBOW0l3LeMeyLV6mzy/kWr8lkd/hp3mTg7wYK7zJhuBStmGMBG0BdeDZS/dZx1IukaX6Bk11zcln25o1Aw==",
-            "dev": true
-        },
-        "node_modules/picomatch": {
-            "version": "2.3.1",
-            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-            "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-            "dev": true,
-            "engines": {
-                "node": ">=8.6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/jonschlinkert"
-            }
-        },
-        "node_modules/pify": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
-            "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/pirates": {
-            "version": "4.0.6",
-            "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz",
-            "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/pkg-dir": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz",
-            "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==",
-            "dev": true,
-            "dependencies": {
-                "find-up": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/postcss": {
-            "version": "8.4.47",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.47.tgz",
-            "integrity": "sha512-56rxCq7G/XfB4EkXq9Egn5GCqugWvDFjafDOThIdMBsI15iqPqR5r15TfSr1YPYeEI19YeaXMCbY6u88Y76GLQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/postcss/"
-                },
-                {
-                    "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/postcss"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "dependencies": {
-                "nanoid": "^3.3.7",
-                "picocolors": "^1.1.0",
-                "source-map-js": "^1.2.1"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14"
-            }
-        },
-        "node_modules/postcss-calc": {
-            "version": "8.2.4",
-            "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-8.2.4.tgz",
-            "integrity": "sha512-SmWMSJmB8MRnnULldx0lQIyhSNvuDl9HfrZkaqqE/WHAhToYsAvDq+yAsA/kIyINDszOp3Rh0GFoNuH5Ypsm3Q==",
-            "dev": true,
-            "dependencies": {
-                "postcss-selector-parser": "^6.0.9",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.2"
-            }
-        },
-        "node_modules/postcss-colormin": {
-            "version": "5.3.0",
-            "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-5.3.0.tgz",
-            "integrity": "sha512-WdDO4gOFG2Z8n4P8TWBpshnL3JpmNmJwdnfP2gbk2qBA8PWwOYcmjmI/t3CmMeL72a7Hkd+x/Mg9O2/0rD54Pg==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0",
-                "colord": "^2.9.1",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-convert-values": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-5.1.2.tgz",
-            "integrity": "sha512-c6Hzc4GAv95B7suy4udszX9Zy4ETyMCgFPUDtWjdFTKH1SE9eFY/jEpHSwTH1QPuwxHpWslhckUQWbNRM4ho5g==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.20.3",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-discard-comments": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-5.1.2.tgz",
-            "integrity": "sha512-+L8208OVbHVF2UQf1iDmRcbdjJkuBF6IS29yBDSiWUIzpYaAhtNl6JYnYm12FnkeCwQqF5LeklOu6rAqgfBZqQ==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-discard-duplicates": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-5.1.0.tgz",
-            "integrity": "sha512-zmX3IoSI2aoenxHV6C7plngHWWhUOV3sP1T8y2ifzxzbtnuhk1EdPwm0S1bIUNaJ2eNbWeGLEwzw8huPD67aQw==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-discard-empty": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-5.1.1.tgz",
-            "integrity": "sha512-zPz4WljiSuLWsI0ir4Mcnr4qQQ5e1Ukc3i7UfE2XcrwKK2LIPIqE5jxMRxO6GbI3cv//ztXDsXwEWT3BHOGh3A==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-discard-overridden": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-5.1.0.tgz",
-            "integrity": "sha512-21nOL7RqWR1kasIVdKs8HNqQJhFxLsyRfAnUDm4Fe4t4mCWL9OJiHvlHPjcd8zc5Myu89b/7wZDnOSjFgeWRtw==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-import": {
-            "version": "15.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-15.1.0.tgz",
-            "integrity": "sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.0.0",
-                "read-cache": "^1.0.0",
-                "resolve": "^1.1.7"
-            },
-            "engines": {
-                "node": ">=14.0.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.0.0"
-            }
-        },
-        "node_modules/postcss-js": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.0.1.tgz",
-            "integrity": "sha512-dDLF8pEO191hJMtlHFPRa8xsizHaM82MLfNkUHdUtVEV3tgTp5oj+8qbEqYM57SLfc74KSbw//4SeJma2LRVIw==",
-            "dev": true,
-            "dependencies": {
-                "camelcase-css": "^2.0.1"
-            },
-            "engines": {
-                "node": "^12 || ^14 || >= 16"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/postcss/"
-            },
-            "peerDependencies": {
-                "postcss": "^8.4.21"
-            }
-        },
-        "node_modules/postcss-load-config": {
-            "version": "3.1.4",
-            "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-3.1.4.tgz",
-            "integrity": "sha512-6DiM4E7v4coTE4uzA8U//WhtPwyhiim3eyjEMFCnUpzbrkK9wJHgKDT2mR+HbtSrd/NubVaYTOpSpjUl8NQeRg==",
-            "dev": true,
-            "dependencies": {
-                "lilconfig": "^2.0.5",
-                "yaml": "^1.10.2"
-            },
-            "engines": {
-                "node": ">= 10"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/postcss/"
-            },
-            "peerDependencies": {
-                "postcss": ">=8.0.9",
-                "ts-node": ">=9.0.0"
-            },
-            "peerDependenciesMeta": {
-                "postcss": {
-                    "optional": true
-                },
-                "ts-node": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/postcss-loader": {
-            "version": "6.2.1",
-            "resolved": "https://registry.npmjs.org/postcss-loader/-/postcss-loader-6.2.1.tgz",
-            "integrity": "sha512-WbbYpmAaKcux/P66bZ40bpWsBucjx/TTgVVzRZ9yUO8yQfVBlameJ0ZGVaPfH64hNSBh63a+ICP5nqOpBA0w+Q==",
-            "dev": true,
-            "dependencies": {
-                "cosmiconfig": "^7.0.0",
-                "klona": "^2.0.5",
-                "semver": "^7.3.5"
-            },
-            "engines": {
-                "node": ">= 12.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "postcss": "^7.0.0 || ^8.0.1",
-                "webpack": "^5.0.0"
-            }
-        },
-        "node_modules/postcss-merge-longhand": {
-            "version": "5.1.6",
-            "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-5.1.6.tgz",
-            "integrity": "sha512-6C/UGF/3T5OE2CEbOuX7iNO63dnvqhGZeUnKkDeifebY0XqkkvrctYSZurpNE902LDf2yKwwPFgotnfSoPhQiw==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0",
-                "stylehacks": "^5.1.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-merge-rules": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-5.1.2.tgz",
-            "integrity": "sha512-zKMUlnw+zYCWoPN6yhPjtcEdlJaMUZ0WyVcxTAmw3lkkN/NDMRkOkiuctQEoWAOvH7twaxUUdvBWl0d4+hifRQ==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0",
-                "cssnano-utils": "^3.1.0",
-                "postcss-selector-parser": "^6.0.5"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-minify-font-values": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-5.1.0.tgz",
-            "integrity": "sha512-el3mYTgx13ZAPPirSVsHqFzl+BBBDrXvbySvPGFnQcTI4iNslrPaFq4muTkLZmKlGk4gyFAYUBMH30+HurREyA==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-minify-gradients": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-5.1.1.tgz",
-            "integrity": "sha512-VGvXMTpCEo4qHTNSa9A0a3D+dxGFZCYwR6Jokk+/3oB6flu2/PnPXAh2x7x52EkY5xlIHLm+Le8tJxe/7TNhzw==",
-            "dev": true,
-            "dependencies": {
-                "colord": "^2.9.1",
-                "cssnano-utils": "^3.1.0",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-minify-params": {
-            "version": "5.1.3",
-            "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-5.1.3.tgz",
-            "integrity": "sha512-bkzpWcjykkqIujNL+EVEPOlLYi/eZ050oImVtHU7b4lFS82jPnsCb44gvC6pxaNt38Els3jWYDHTjHKf0koTgg==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "cssnano-utils": "^3.1.0",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-minify-selectors": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-5.2.1.tgz",
-            "integrity": "sha512-nPJu7OjZJTsVUmPdm2TcaiohIwxP+v8ha9NehQ2ye9szv4orirRU3SDdtUmKH+10nzn0bAyOXZ0UEr7OpvLehg==",
-            "dev": true,
-            "dependencies": {
-                "postcss-selector-parser": "^6.0.5"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-modules-extract-imports": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.0.0.tgz",
-            "integrity": "sha512-bdHleFnP3kZ4NYDhuGlVK+CMrQ/pqUm8bx/oGL93K6gVwiclvX5x0n76fYMKuIGKzlABOy13zsvqjb0f92TEXw==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >= 14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.1.0"
-            }
-        },
-        "node_modules/postcss-modules-local-by-default": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.0.0.tgz",
-            "integrity": "sha512-sT7ihtmGSF9yhm6ggikHdV0hlziDTX7oFoXtuVWeDd3hHObNkcHRo9V3yg7vCAY7cONyxJC/XXCmmiHHcvX7bQ==",
-            "dev": true,
-            "dependencies": {
-                "icss-utils": "^5.0.0",
-                "postcss-selector-parser": "^6.0.2",
-                "postcss-value-parser": "^4.1.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >= 14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.1.0"
-            }
-        },
-        "node_modules/postcss-modules-scope": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-scope/-/postcss-modules-scope-3.0.0.tgz",
-            "integrity": "sha512-hncihwFA2yPath8oZ15PZqvWGkWf+XUfQgUGamS4LqoP1anQLOsOJw0vr7J7IwLpoY9fatA2qiGUGmuZL0Iqlg==",
-            "dev": true,
-            "dependencies": {
-                "postcss-selector-parser": "^6.0.4"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >= 14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.1.0"
-            }
-        },
-        "node_modules/postcss-modules-values": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz",
-            "integrity": "sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==",
-            "dev": true,
-            "dependencies": {
-                "icss-utils": "^5.0.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >= 14"
-            },
-            "peerDependencies": {
-                "postcss": "^8.1.0"
-            }
-        },
-        "node_modules/postcss-nested": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.0.1.tgz",
-            "integrity": "sha512-mEp4xPMi5bSWiMbsgoPfcP74lsWLHkQbZc3sY+jWYd65CUwXrUaTp0fmNpa01ZcETKlIgUdFN/MpS2xZtqL9dQ==",
-            "dev": true,
-            "dependencies": {
-                "postcss-selector-parser": "^6.0.11"
-            },
-            "engines": {
-                "node": ">=12.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/postcss/"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.14"
-            }
-        },
-        "node_modules/postcss-nested/node_modules/postcss-selector-parser": {
-            "version": "6.0.16",
-            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.16.tgz",
-            "integrity": "sha512-A0RVJrX+IUkVZbW3ClroRWurercFhieevHB38sr2+l9eUClMqome3LmEmnhlNy+5Mr2EYN6B2Kaw9wYdd+VHiw==",
-            "dev": true,
-            "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/postcss-normalize-charset": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-5.1.0.tgz",
-            "integrity": "sha512-mSgUJ+pd/ldRGVx26p2wz9dNZ7ji6Pn8VWBajMXFf8jk7vUoSrZ2lt/wZR7DtlZYKesmZI680qjr2CeFF2fbUg==",
-            "dev": true,
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-display-values": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-display-values/-/postcss-normalize-display-values-5.1.0.tgz",
-            "integrity": "sha512-WP4KIM4o2dazQXWmFaqMmcvsKmhdINFblgSeRgn8BJ6vxaMyaJkwAzpPpuvSIoG/rmX3M+IrRZEz2H0glrQNEA==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-positions": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-positions/-/postcss-normalize-positions-5.1.1.tgz",
-            "integrity": "sha512-6UpCb0G4eofTCQLFVuI3EVNZzBNPiIKcA1AKVka+31fTVySphr3VUgAIULBhxZkKgwLImhzMR2Bw1ORK+37INg==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-repeat-style": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-5.1.1.tgz",
-            "integrity": "sha512-mFpLspGWkQtBcWIRFLmewo8aC3ImN2i/J3v8YCFUwDnPu3Xz4rLohDO26lGjwNsQxB3YF0KKRwspGzE2JEuS0g==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-string": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-string/-/postcss-normalize-string-5.1.0.tgz",
-            "integrity": "sha512-oYiIJOf4T9T1N4i+abeIc7Vgm/xPCGih4bZz5Nm0/ARVJ7K6xrDlLwvwqOydvyL3RHNf8qZk6vo3aatiw/go3w==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-timing-functions": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-5.1.0.tgz",
-            "integrity": "sha512-DOEkzJ4SAXv5xkHl0Wa9cZLF3WCBhF3o1SKVxKQAa+0pYKlueTpCgvkFAHfk+Y64ezX9+nITGrDZeVGgITJXjg==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-unicode": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-unicode/-/postcss-normalize-unicode-5.1.0.tgz",
-            "integrity": "sha512-J6M3MizAAZ2dOdSjy2caayJLQT8E8K9XjLce8AUQMwOrCvjCHv24aLC/Lps1R1ylOfol5VIDMaM/Lo9NGlk1SQ==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-url": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-5.1.0.tgz",
-            "integrity": "sha512-5upGeDO+PVthOxSmds43ZeMeZfKH+/DKgGRD7TElkkyS46JXAUhMzIKiCa7BabPeIy3AQcTkXwVVN7DbqsiCew==",
-            "dev": true,
-            "dependencies": {
-                "normalize-url": "^6.0.1",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-normalize-whitespace": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-whitespace/-/postcss-normalize-whitespace-5.1.1.tgz",
-            "integrity": "sha512-83ZJ4t3NUDETIHTa3uEg6asWjSBYL5EdkVB0sDncx9ERzOKBVJIUeDO9RyA9Zwtig8El1d79HBp0JEi8wvGQnA==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-ordered-values": {
-            "version": "5.1.3",
-            "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-5.1.3.tgz",
-            "integrity": "sha512-9UO79VUhPwEkzbb3RNpqqghc6lcYej1aveQteWY+4POIwlqkYE21HKWaLDF6lWNuqCobEAyTovVhtI32Rbv2RQ==",
-            "dev": true,
-            "dependencies": {
-                "cssnano-utils": "^3.1.0",
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-reduce-initial": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-5.1.0.tgz",
-            "integrity": "sha512-5OgTUviz0aeH6MtBjHfbr57tml13PuedK/Ecg8szzd4XRMbYxH4572JFG067z+FqBIf6Zp/d+0581glkvvWMFw==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-reduce-transforms": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-5.1.0.tgz",
-            "integrity": "sha512-2fbdbmgir5AvpW9RLtdONx1QoYG2/EtqpNQbFASDlixBbAYuTcJ0dECwlqNqH7VbaUnEnh8SrxOe2sRIn24XyQ==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-selector-parser": {
-            "version": "6.0.10",
-            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz",
-            "integrity": "sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==",
-            "dev": true,
-            "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/postcss-svgo": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-5.1.0.tgz",
-            "integrity": "sha512-D75KsH1zm5ZrHyxPakAxJWtkyXew5qwS70v56exwvw542d9CRtTo78K0WeFxZB4G7JXKKMbEZtZayTGdIky/eA==",
-            "dev": true,
-            "dependencies": {
-                "postcss-value-parser": "^4.2.0",
-                "svgo": "^2.7.0"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-unique-selectors": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-5.1.1.tgz",
-            "integrity": "sha512-5JiODlELrz8L2HwxfPnhOWZYWDxVHWL83ufOv84NrcgipI7TaeRsatAhK4Tr2/ZiYldpK/wBvw5BD3qfaK96GA==",
-            "dev": true,
-            "dependencies": {
-                "postcss-selector-parser": "^6.0.5"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/postcss-value-parser": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
-            "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
-            "dev": true
-        },
-        "node_modules/prettier": {
-            "version": "3.3.3",
-            "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.3.3.tgz",
-            "integrity": "sha512-i2tDNA0O5IrMO757lfrdQZCc2jPNDVntV0m/+4whiDfWaTKfMNgR7Qz0NAeGz/nRqF4m5/6CLzbP4/liHt12Ew==",
-            "dev": true,
-            "bin": {
-                "prettier": "bin/prettier.cjs"
-            },
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/prettier/prettier?sponsor=1"
-            }
-        },
-        "node_modules/pretty-time": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/pretty-time/-/pretty-time-1.1.0.tgz",
-            "integrity": "sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/process": {
-            "version": "0.11.10",
-            "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
-            "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6.0"
-            }
-        },
-        "node_modules/process-nextick-args": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
-            "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
-            "dev": true
-        },
-        "node_modules/proxy-addr": {
-            "version": "2.0.7",
-            "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
-            "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
-            "dev": true,
-            "dependencies": {
-                "forwarded": "0.2.0",
-                "ipaddr.js": "1.9.1"
-            },
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/proxy-addr/node_modules/ipaddr.js": {
-            "version": "1.9.1",
-            "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
-            "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/public-encrypt": {
-            "version": "4.0.3",
-            "resolved": "https://registry.npmjs.org/public-encrypt/-/public-encrypt-4.0.3.tgz",
-            "integrity": "sha512-zVpa8oKZSz5bTMTFClc1fQOnyyEzpl5ozpi1B5YcvBrdohMjH2rfsBtyXcuNuwjsDIXmBYlF2N5FlJYhR29t8Q==",
-            "dev": true,
-            "dependencies": {
-                "bn.js": "^4.1.0",
-                "browserify-rsa": "^4.0.0",
-                "create-hash": "^1.1.0",
-                "parse-asn1": "^5.0.0",
-                "randombytes": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            }
-        },
-        "node_modules/public-encrypt/node_modules/bn.js": {
-            "version": "4.12.0",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-            "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-            "dev": true
-        },
-        "node_modules/punycode": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz",
-            "integrity": "sha512-jmYNElW7yvO7TV33CjSmvSiE2yco3bV2czu/OzDKdMNVZQWfxCblURLhf+47syQRBntjfLdd/H0egrzIG+oaFQ==",
-            "dev": true
-        },
-        "node_modules/qs": {
-            "version": "6.13.0",
-            "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz",
-            "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==",
-            "dev": true,
-            "dependencies": {
-                "side-channel": "^1.0.6"
-            },
-            "engines": {
-                "node": ">=0.6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/querystring": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/querystring/-/querystring-0.2.0.tgz",
-            "integrity": "sha512-X/xY82scca2tau62i9mDyU9K+I+djTMUsvwf7xnUX5GLvVzgJybOJf4Y6o9Zx3oJK/LSXg5tTZBjwzqVPaPO2g==",
-            "deprecated": "The querystring API is considered Legacy. new code should use the URLSearchParams API instead.",
-            "dev": true,
-            "engines": {
-                "node": ">=0.4.x"
-            }
-        },
-        "node_modules/querystring-es3": {
-            "version": "0.2.1",
-            "resolved": "https://registry.npmjs.org/querystring-es3/-/querystring-es3-0.2.1.tgz",
-            "integrity": "sha512-773xhDQnZBMFobEiztv8LIl70ch5MSF/jUQVlhwFyBILqq96anmoctVIYz+ZRp0qbCKATTn6ev02M3r7Ga5vqA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.4.x"
-            }
-        },
-        "node_modules/queue-microtask": {
-            "version": "1.2.3",
-            "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
-            "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ]
-        },
-        "node_modules/randombytes": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
-            "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
-            "dev": true,
-            "dependencies": {
-                "safe-buffer": "^5.1.0"
-            }
-        },
-        "node_modules/randomfill": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/randomfill/-/randomfill-1.0.4.tgz",
-            "integrity": "sha512-87lcbR8+MhcWcUiQ+9e+Rwx8MyR2P7qnt15ynUlbm3TU/fjbgz4GsvfSUDTemtCCtVCqb4ZcEFlyPNTh9bBTLw==",
-            "dev": true,
-            "dependencies": {
-                "randombytes": "^2.0.5",
-                "safe-buffer": "^5.1.0"
-            }
-        },
-        "node_modules/range-parser": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
-            "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/raw-body": {
-            "version": "2.5.2",
-            "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz",
-            "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==",
-            "dev": true,
-            "dependencies": {
-                "bytes": "3.1.2",
-                "http-errors": "2.0.0",
-                "iconv-lite": "0.4.24",
-                "unpipe": "1.0.0"
-            },
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/raw-body/node_modules/bytes": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
-            "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/read-cache": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz",
-            "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==",
-            "dev": true,
-            "dependencies": {
-                "pify": "^2.3.0"
-            }
-        },
-        "node_modules/readable-stream": {
-            "version": "2.3.7",
-            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.7.tgz",
-            "integrity": "sha512-Ebho8K4jIbHAxnuxi7o42OrZgF/ZTNcsZj6nRKyUmkhLFq8CHItp/fy6hQZuZmP/n3yZ9VBUbp4zz/mX8hmYPw==",
-            "dev": true,
-            "dependencies": {
-                "core-util-is": "~1.0.0",
-                "inherits": "~2.0.3",
-                "isarray": "~1.0.0",
-                "process-nextick-args": "~2.0.0",
-                "safe-buffer": "~5.1.1",
-                "string_decoder": "~1.1.1",
-                "util-deprecate": "~1.0.1"
-            }
-        },
-        "node_modules/readdirp": {
-            "version": "3.6.0",
-            "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
-            "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
-            "dev": true,
-            "dependencies": {
-                "picomatch": "^2.2.1"
-            },
-            "engines": {
-                "node": ">=8.10.0"
-            }
-        },
-        "node_modules/rechoir": {
-            "version": "0.7.1",
-            "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.7.1.tgz",
-            "integrity": "sha512-/njmZ8s1wVeR6pjTZ+0nCnv8SpZNRMT2D1RLOJQESlYFDBvwpTA4KWJpZ+sBJ4+vhjILRcK7JIFdGCdxEAAitg==",
-            "dev": true,
-            "dependencies": {
-                "resolve": "^1.9.0"
-            },
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/regenerate": {
-            "version": "1.4.2",
-            "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz",
-            "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==",
-            "dev": true
-        },
-        "node_modules/regenerate-unicode-properties": {
-            "version": "10.0.1",
-            "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.0.1.tgz",
-            "integrity": "sha512-vn5DU6yg6h8hP/2OkQo3K7uVILvY4iu0oI4t3HFa81UPkhGJwkRwM10JEc3upjdhHjs/k8GJY1sRBhk5sr69Bw==",
-            "dev": true,
-            "dependencies": {
-                "regenerate": "^1.4.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/regenerator-runtime": {
-            "version": "0.13.9",
-            "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.9.tgz",
-            "integrity": "sha512-p3VT+cOEgxFsRRA9X4lkI1E+k2/CtnKtU4gcxyaCUreilL/vqI6CdZ3wxVUx3UOUg+gnUOQQcRI7BmSI656MYA==",
-            "dev": true
-        },
-        "node_modules/regenerator-transform": {
-            "version": "0.15.0",
-            "resolved": "https://registry.npmjs.org/regenerator-transform/-/regenerator-transform-0.15.0.tgz",
-            "integrity": "sha512-LsrGtPmbYg19bcPHwdtmXwbW+TqNvtY4riE3P83foeHRroMbH6/2ddFBfab3t7kbzc7v7p4wbkIecHImqt0QNg==",
-            "dev": true,
-            "dependencies": {
-                "@babel/runtime": "^7.8.4"
-            }
-        },
-        "node_modules/regexpu-core": {
-            "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-5.0.1.tgz",
-            "integrity": "sha512-CriEZlrKK9VJw/xQGJpQM5rY88BtuL8DM+AEwvcThHilbxiTAy8vq4iJnd2tqq8wLmjbGZzP7ZcKFjbGkmEFrw==",
-            "dev": true,
-            "dependencies": {
-                "regenerate": "^1.4.2",
-                "regenerate-unicode-properties": "^10.0.1",
-                "regjsgen": "^0.6.0",
-                "regjsparser": "^0.8.2",
-                "unicode-match-property-ecmascript": "^2.0.0",
-                "unicode-match-property-value-ecmascript": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/regjsgen": {
-            "version": "0.6.0",
-            "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.6.0.tgz",
-            "integrity": "sha512-ozE883Uigtqj3bx7OhL1KNbCzGyW2NQZPl6Hs09WTvCuZD5sTI4JY58bkbQWa/Y9hxIsvJ3M8Nbf7j54IqeZbA==",
-            "dev": true
-        },
-        "node_modules/regjsparser": {
-            "version": "0.8.4",
-            "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.8.4.tgz",
-            "integrity": "sha512-J3LABycON/VNEu3abOviqGHuB/LOtOQj8SKmfP9anY5GfAVw/SPjwzSjxGjbZXIxbGfqTHtJw58C2Li/WkStmA==",
-            "dev": true,
-            "dependencies": {
-                "jsesc": "~0.5.0"
-            },
-            "bin": {
-                "regjsparser": "bin/parser"
-            }
-        },
-        "node_modules/regjsparser/node_modules/jsesc": {
-            "version": "0.5.0",
-            "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz",
-            "integrity": "sha512-uZz5UnB7u4T9LvwmFqXii7pZSouaRPorGs5who1Ip7VO0wxanFvBL7GkM6dTHlgX+jhBApRetaWpnDabOeTcnA==",
-            "dev": true,
-            "bin": {
-                "jsesc": "bin/jsesc"
-            }
-        },
-        "node_modules/relateurl": {
-            "version": "0.2.7",
-            "resolved": "https://registry.npmjs.org/relateurl/-/relateurl-0.2.7.tgz",
-            "integrity": "sha512-G08Dxvm4iDN3MLM0EsP62EDV9IuhXPR6blNz6Utcp7zyV3tr4HVNINt6MpaRWbxoOHT3Q7YN2P+jaHX8vUbgog==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/replace-ext": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/replace-ext/-/replace-ext-1.0.1.tgz",
-            "integrity": "sha512-yD5BHCe7quCgBph4rMQ+0KkIRKwWCrHDOX1p1Gp6HwjPM5kVoCdKGNhN7ydqqsX6lJEnQDKZ/tFMiEdQ1dvPEw==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.10"
-            }
-        },
-        "node_modules/require-directory": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
-            "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/require-from-string": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
-            "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/requires-port": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
-            "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==",
-            "dev": true
-        },
-        "node_modules/resolve": {
-            "version": "1.22.8",
-            "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz",
-            "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==",
-            "dev": true,
-            "dependencies": {
-                "is-core-module": "^2.13.0",
-                "path-parse": "^1.0.7",
-                "supports-preserve-symlinks-flag": "^1.0.0"
-            },
-            "bin": {
-                "resolve": "bin/resolve"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/resolve-cwd": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz",
-            "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==",
-            "dev": true,
-            "dependencies": {
-                "resolve-from": "^5.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/resolve-cwd/node_modules/resolve-from": {
-            "version": "5.0.0",
-            "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
-            "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/resolve-from": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
-            "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/retry": {
-            "version": "0.13.1",
-            "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
-            "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 4"
-            }
-        },
-        "node_modules/reusify": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.0.4.tgz",
-            "integrity": "sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==",
-            "dev": true,
-            "engines": {
-                "iojs": ">=1.0.0",
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/rimraf": {
-            "version": "3.0.2",
-            "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
-            "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==",
-            "dev": true,
-            "dependencies": {
-                "glob": "^7.1.3"
-            },
-            "bin": {
-                "rimraf": "bin.js"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/ripemd160": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
-            "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
-            "dev": true,
-            "dependencies": {
-                "hash-base": "^3.0.0",
-                "inherits": "^2.0.1"
-            }
-        },
-        "node_modules/run-parallel": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
-            "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ],
-            "dependencies": {
-                "queue-microtask": "^1.2.2"
-            }
-        },
-        "node_modules/safe-buffer": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
-            "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
-            "dev": true
-        },
-        "node_modules/safer-buffer": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
-            "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
-            "dev": true
-        },
-        "node_modules/schema-utils": {
-            "version": "2.7.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-2.7.1.tgz",
-            "integrity": "sha512-SHiNtMOUGWBQJwzISiVYKu82GiV4QYGePp3odlY1tuKO7gPtphAT5R/py0fA6xtbgLL/RvtJZnU9b8s0F1q0Xg==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.5",
-                "ajv": "^6.12.4",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 8.9.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/select-hose": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/select-hose/-/select-hose-2.0.0.tgz",
-            "integrity": "sha512-mEugaLK+YfkijB4fx0e6kImuJdCIt2LxCRcbEYPqRGCs4F2ogyfZU5IAZRdjCP8JPq2AtdNoC/Dux63d9Kiryg==",
-            "dev": true
-        },
-        "node_modules/selfsigned": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/selfsigned/-/selfsigned-2.0.1.tgz",
-            "integrity": "sha512-LmME957M1zOsUhG+67rAjKfiWFox3SBxE/yymatMZsAx+oMrJ0YQ8AToOnyCm7xbeg2ep37IHLxdu0o2MavQOQ==",
-            "dev": true,
-            "dependencies": {
-                "node-forge": "^1"
-            },
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/semver": {
-            "version": "7.5.4",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz",
-            "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==",
-            "dev": true,
-            "dependencies": {
-                "lru-cache": "^6.0.0"
-            },
-            "bin": {
-                "semver": "bin/semver.js"
-            },
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/send": {
-            "version": "0.19.0",
-            "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz",
-            "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==",
-            "dev": true,
-            "dependencies": {
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "destroy": "1.2.0",
-                "encodeurl": "~1.0.2",
-                "escape-html": "~1.0.3",
-                "etag": "~1.8.1",
-                "fresh": "0.5.2",
-                "http-errors": "2.0.0",
-                "mime": "1.6.0",
-                "ms": "2.1.3",
-                "on-finished": "2.4.1",
-                "range-parser": "~1.2.1",
-                "statuses": "2.0.1"
-            },
-            "engines": {
-                "node": ">= 0.8.0"
-            }
-        },
-        "node_modules/send/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/send/node_modules/debug/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/send/node_modules/encodeurl": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz",
-            "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/send/node_modules/ms": {
-            "version": "2.1.3",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-            "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-            "dev": true
-        },
-        "node_modules/serialize-javascript": {
-            "version": "6.0.2",
-            "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
-            "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
-            "dev": true,
-            "dependencies": {
-                "randombytes": "^2.1.0"
-            }
-        },
-        "node_modules/serve-index": {
-            "version": "1.9.1",
-            "resolved": "https://registry.npmjs.org/serve-index/-/serve-index-1.9.1.tgz",
-            "integrity": "sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw==",
-            "dev": true,
-            "dependencies": {
-                "accepts": "~1.3.4",
-                "batch": "0.6.1",
-                "debug": "2.6.9",
-                "escape-html": "~1.0.3",
-                "http-errors": "~1.6.2",
-                "mime-types": "~2.1.17",
-                "parseurl": "~1.3.2"
-            },
-            "engines": {
-                "node": ">= 0.8.0"
-            }
-        },
-        "node_modules/serve-index/node_modules/debug": {
-            "version": "2.6.9",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-            "dev": true,
-            "dependencies": {
-                "ms": "2.0.0"
-            }
-        },
-        "node_modules/serve-index/node_modules/depd": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/depd/-/depd-1.1.2.tgz",
-            "integrity": "sha512-7emPTl6Dpo6JRXOXjLRxck+FlLRX5847cLKEn00PLAgc3g2hTZZgr+e4c2v6QpSmLeFP3n5yUo7ft6avBK/5jQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/serve-index/node_modules/http-errors": {
-            "version": "1.6.3",
-            "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-1.6.3.tgz",
-            "integrity": "sha512-lks+lVC8dgGyh97jxvxeYTWQFvh4uw4yC12gVl63Cg30sjPX4wuGcdkICVXDAESr6OJGjqGA8Iz5mkeN6zlD7A==",
-            "dev": true,
-            "dependencies": {
-                "depd": "~1.1.2",
-                "inherits": "2.0.3",
-                "setprototypeof": "1.1.0",
-                "statuses": ">= 1.4.0 < 2"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/serve-index/node_modules/inherits": {
-            "version": "2.0.3",
-            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-            "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
-            "dev": true
-        },
-        "node_modules/serve-index/node_modules/ms": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-            "dev": true
-        },
-        "node_modules/serve-index/node_modules/setprototypeof": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.1.0.tgz",
-            "integrity": "sha512-BvE/TwpZX4FXExxOxZyRGQQv651MSwmWKZGqvmPcRIjDqWub67kTKuIMx43cZZrS/cBBzwBcNDWoFxt2XEFIpQ==",
-            "dev": true
-        },
-        "node_modules/serve-index/node_modules/statuses": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/statuses/-/statuses-1.5.0.tgz",
-            "integrity": "sha512-OpZ3zP+jT1PI7I8nemJX4AKmAX070ZkYPVWV/AaKTJl+tXCTGyVdC1a4SL8RUQYEwk/f34ZX8UTykN68FwrqAA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/serve-static": {
-            "version": "1.16.2",
-            "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz",
-            "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==",
-            "dev": true,
-            "dependencies": {
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "parseurl": "~1.3.3",
-                "send": "0.19.0"
-            },
-            "engines": {
-                "node": ">= 0.8.0"
-            }
-        },
-        "node_modules/set-function-length": {
-            "version": "1.2.2",
-            "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
-            "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
-            "dev": true,
-            "dependencies": {
-                "define-data-property": "^1.1.4",
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "get-intrinsic": "^1.2.4",
-                "gopd": "^1.0.1",
-                "has-property-descriptors": "^1.0.2"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            }
-        },
-        "node_modules/setimmediate": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
-            "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
-            "dev": true
-        },
-        "node_modules/setprototypeof": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
-            "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
-            "dev": true
-        },
-        "node_modules/sha.js": {
-            "version": "2.4.11",
-            "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
-            "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
-            },
-            "bin": {
-                "sha.js": "bin.js"
-            }
-        },
-        "node_modules/shallow-clone": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/shallow-clone/-/shallow-clone-3.0.1.tgz",
-            "integrity": "sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA==",
-            "dev": true,
-            "dependencies": {
-                "kind-of": "^6.0.2"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/shebang-command": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-            "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-            "dev": true,
-            "dependencies": {
-                "shebang-regex": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/shebang-regex": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-            "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/shellwords": {
-            "version": "0.1.1",
-            "resolved": "https://registry.npmjs.org/shellwords/-/shellwords-0.1.1.tgz",
-            "integrity": "sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==",
-            "dev": true
-        },
-        "node_modules/side-channel": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz",
-            "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==",
-            "dev": true,
-            "dependencies": {
-                "call-bind": "^1.0.7",
-                "es-errors": "^1.3.0",
-                "get-intrinsic": "^1.2.4",
-                "object-inspect": "^1.13.1"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/signal-exit": {
-            "version": "3.0.7",
-            "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
-            "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
-            "dev": true
-        },
-        "node_modules/slash": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
-            "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/sockjs": {
-            "version": "0.3.24",
-            "resolved": "https://registry.npmjs.org/sockjs/-/sockjs-0.3.24.tgz",
-            "integrity": "sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ==",
-            "dev": true,
-            "dependencies": {
-                "faye-websocket": "^0.11.3",
-                "uuid": "^8.3.2",
-                "websocket-driver": "^0.7.4"
-            }
-        },
-        "node_modules/source-list-map": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/source-list-map/-/source-list-map-2.0.1.tgz",
-            "integrity": "sha512-qnQ7gVMxGNxsiL4lEuJwe/To8UnK7fAnmbGEEH8RpLouuKbeEm0lhbQVFIrNSuB+G7tVrAlVsZgETT5nljf+Iw==",
-            "dev": true
-        },
-        "node_modules/source-map": {
-            "version": "0.6.1",
-            "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
-            "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/source-map-js": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-            "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/source-map-support": {
-            "version": "0.5.21",
-            "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
-            "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
-            "dev": true,
-            "dependencies": {
-                "buffer-from": "^1.0.0",
-                "source-map": "^0.6.0"
-            }
-        },
-        "node_modules/spdy": {
-            "version": "4.0.2",
-            "resolved": "https://registry.npmjs.org/spdy/-/spdy-4.0.2.tgz",
-            "integrity": "sha512-r46gZQZQV+Kl9oItvl1JZZqJKGr+oEkB08A6BzkiR7593/7IbtuncXHd2YoYeTsG4157ZssMu9KYvUHLcjcDoA==",
-            "dev": true,
-            "dependencies": {
-                "debug": "^4.1.0",
-                "handle-thing": "^2.0.0",
-                "http-deceiver": "^1.2.7",
-                "select-hose": "^2.0.0",
-                "spdy-transport": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=6.0.0"
-            }
-        },
-        "node_modules/spdy-transport": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/spdy-transport/-/spdy-transport-3.0.0.tgz",
-            "integrity": "sha512-hsLVFE5SjA6TCisWeJXFKniGGOpBgMLmerfO2aCyCU5s7nJ/rpAepqmFifv/GCbSbueEeAJJnmSQ2rKC/g8Fcw==",
-            "dev": true,
-            "dependencies": {
-                "debug": "^4.1.0",
-                "detect-node": "^2.0.4",
-                "hpack.js": "^2.1.6",
-                "obuf": "^1.1.2",
-                "readable-stream": "^3.0.6",
-                "wbuf": "^1.7.3"
-            }
-        },
-        "node_modules/spdy-transport/node_modules/readable-stream": {
-            "version": "3.6.0",
-            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
-            "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "^2.0.3",
-                "string_decoder": "^1.1.1",
-                "util-deprecate": "^1.0.1"
-            },
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/stable": {
-            "version": "0.1.8",
-            "resolved": "https://registry.npmjs.org/stable/-/stable-0.1.8.tgz",
-            "integrity": "sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w==",
-            "deprecated": "Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility",
-            "dev": true
-        },
-        "node_modules/statuses": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
-            "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/std-env": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.1.1.tgz",
-            "integrity": "sha512-/c645XdExBypL01TpFKiG/3RAa/Qmu+zRi0MwAmrdEkwHNuN0ebo8ccAXBBDa5Z0QOJgBskUIbuCK91x0sCVEw==",
-            "dev": true
-        },
-        "node_modules/stream-browserify": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/stream-browserify/-/stream-browserify-2.0.2.tgz",
-            "integrity": "sha512-nX6hmklHs/gr2FuxYDltq8fJA1GDlxKQCz8O/IM4atRqBH8OORmBNgfvW5gG10GT/qQ9u0CzIvr2X5Pkt6ntqg==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "~2.0.1",
-                "readable-stream": "^2.0.2"
-            }
-        },
-        "node_modules/stream-http": {
-            "version": "2.8.3",
-            "resolved": "https://registry.npmjs.org/stream-http/-/stream-http-2.8.3.tgz",
-            "integrity": "sha512-+TSkfINHDo4J+ZobQLWiMouQYB+UVYFttRA94FpEzzJ7ZdqcL4uUUQ7WkdkI4DSozGmgBUE/a47L+38PenXhUw==",
-            "dev": true,
-            "dependencies": {
-                "builtin-status-codes": "^3.0.0",
-                "inherits": "^2.0.1",
-                "readable-stream": "^2.3.6",
-                "to-arraybuffer": "^1.0.0",
-                "xtend": "^4.0.0"
-            }
-        },
-        "node_modules/string_decoder": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
-            "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
-            "dev": true,
-            "dependencies": {
-                "safe-buffer": "~5.1.0"
-            }
-        },
-        "node_modules/string-width": {
-            "version": "4.2.3",
-            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
-            "dev": true,
-            "dependencies": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/string-width-cjs": {
-            "name": "string-width",
-            "version": "4.2.3",
-            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
-            "dev": true,
-            "dependencies": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/strip-ansi": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-            "dev": true,
-            "dependencies": {
-                "ansi-regex": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/strip-ansi-cjs": {
-            "name": "strip-ansi",
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-            "dev": true,
-            "dependencies": {
-                "ansi-regex": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/strip-final-newline": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
-            "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/style-loader": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-2.0.0.tgz",
-            "integrity": "sha512-Z0gYUJmzZ6ZdRUqpg1r8GsaFKypE+3xAzuFeMuoHgjc9KZv3wMyCRjQIWEbhoFSq7+7yoHXySDJyyWQaPajeiQ==",
-            "dev": true,
-            "dependencies": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.0.0 || ^5.0.0"
-            }
-        },
-        "node_modules/style-loader/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/stylehacks": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/stylehacks/-/stylehacks-5.1.0.tgz",
-            "integrity": "sha512-SzLmvHQTrIWfSgljkQCw2++C9+Ne91d/6Sp92I8c5uHTcy/PgeHamwITIbBW9wnFTY/3ZfSXR9HIL6Ikqmcu6Q==",
-            "dev": true,
-            "dependencies": {
-                "browserslist": "^4.16.6",
-                "postcss-selector-parser": "^6.0.4"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.15"
-            }
-        },
-        "node_modules/sucrase": {
-            "version": "3.35.0",
-            "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.0.tgz",
-            "integrity": "sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==",
-            "dev": true,
-            "dependencies": {
-                "@jridgewell/gen-mapping": "^0.3.2",
-                "commander": "^4.0.0",
-                "glob": "^10.3.10",
-                "lines-and-columns": "^1.1.6",
-                "mz": "^2.7.0",
-                "pirates": "^4.0.1",
-                "ts-interface-checker": "^0.1.9"
-            },
-            "bin": {
-                "sucrase": "bin/sucrase",
-                "sucrase-node": "bin/sucrase-node"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            }
-        },
-        "node_modules/sucrase/node_modules/@jridgewell/gen-mapping": {
-            "version": "0.3.5",
-            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz",
-            "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==",
-            "dev": true,
-            "dependencies": {
-                "@jridgewell/set-array": "^1.2.1",
-                "@jridgewell/sourcemap-codec": "^1.4.10",
-                "@jridgewell/trace-mapping": "^0.3.24"
-            },
-            "engines": {
-                "node": ">=6.0.0"
-            }
-        },
-        "node_modules/sucrase/node_modules/brace-expansion": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
-            "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
-            "dev": true,
-            "dependencies": {
-                "balanced-match": "^1.0.0"
-            }
-        },
-        "node_modules/sucrase/node_modules/commander": {
-            "version": "4.1.1",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
-            "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/sucrase/node_modules/glob": {
-            "version": "10.3.12",
-            "resolved": "https://registry.npmjs.org/glob/-/glob-10.3.12.tgz",
-            "integrity": "sha512-TCNv8vJ+xz4QiqTpfOJA7HvYv+tNIRHKfUWw/q+v2jdgN4ebz+KY9tGx5J4rHP0o84mNP+ApH66HRX8us3Khqg==",
-            "dev": true,
-            "dependencies": {
-                "foreground-child": "^3.1.0",
-                "jackspeak": "^2.3.6",
-                "minimatch": "^9.0.1",
-                "minipass": "^7.0.4",
-                "path-scurry": "^1.10.2"
-            },
-            "bin": {
-                "glob": "dist/esm/bin.mjs"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/sucrase/node_modules/minimatch": {
-            "version": "9.0.4",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.4.tgz",
-            "integrity": "sha512-KqWh+VchfxcMNRAJjj2tnsSJdNbHsVgnkBhTNrW7AjVo6OvLtxw8zfT9oLw1JSohlFzJ8jCoTgaoXvJ+kHt6fw==",
-            "dev": true,
-            "dependencies": {
-                "brace-expansion": "^2.0.1"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/supports-color": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
-            "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
-            "dev": true,
-            "dependencies": {
-                "has-flag": "^4.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/supports-color/node_modules/has-flag": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-            "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/supports-preserve-symlinks-flag": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
-            "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/svgo": {
-            "version": "2.8.0",
-            "resolved": "https://registry.npmjs.org/svgo/-/svgo-2.8.0.tgz",
-            "integrity": "sha512-+N/Q9kV1+F+UeWYoSiULYo4xYSDQlTgb+ayMobAXPwMnLvop7oxKMo9OzIrX5x3eS4L4f2UHhc9axXwY8DpChg==",
-            "dev": true,
-            "dependencies": {
-                "@trysound/sax": "0.2.0",
-                "commander": "^7.2.0",
-                "css-select": "^4.1.3",
-                "css-tree": "^1.1.3",
-                "csso": "^4.2.0",
-                "picocolors": "^1.0.0",
-                "stable": "^0.1.8"
-            },
-            "bin": {
-                "svgo": "bin/svgo"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            }
-        },
-        "node_modules/tailwindcss": {
-            "version": "3.4.14",
-            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.14.tgz",
-            "integrity": "sha512-IcSvOcTRcUtQQ7ILQL5quRDg7Xs93PdJEk1ZLbhhvJc7uj/OAhYOnruEiwnGgBvUtaUAJ8/mhSw1o8L2jCiENA==",
-            "dev": true,
-            "dependencies": {
-                "@alloc/quick-lru": "^5.2.0",
-                "arg": "^5.0.2",
-                "chokidar": "^3.5.3",
-                "didyoumean": "^1.2.2",
-                "dlv": "^1.1.3",
-                "fast-glob": "^3.3.0",
-                "glob-parent": "^6.0.2",
-                "is-glob": "^4.0.3",
-                "jiti": "^1.21.0",
-                "lilconfig": "^2.1.0",
-                "micromatch": "^4.0.5",
-                "normalize-path": "^3.0.0",
-                "object-hash": "^3.0.0",
-                "picocolors": "^1.0.0",
-                "postcss": "^8.4.23",
-                "postcss-import": "^15.1.0",
-                "postcss-js": "^4.0.1",
-                "postcss-load-config": "^4.0.1",
-                "postcss-nested": "^6.0.1",
-                "postcss-selector-parser": "^6.0.11",
-                "resolve": "^1.22.2",
-                "sucrase": "^3.32.0"
-            },
-            "bin": {
-                "tailwind": "lib/cli.js",
-                "tailwindcss": "lib/cli.js"
-            },
-            "engines": {
-                "node": ">=14.0.0"
-            }
-        },
-        "node_modules/tailwindcss/node_modules/glob-parent": {
-            "version": "6.0.2",
-            "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
-            "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
-            "dev": true,
-            "dependencies": {
-                "is-glob": "^4.0.3"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            }
-        },
-        "node_modules/tailwindcss/node_modules/postcss-load-config": {
-            "version": "4.0.2",
-            "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-4.0.2.tgz",
-            "integrity": "sha512-bSVhyJGL00wMVoPUzAVAnbEoWyqRxkjv64tUl427SKnPrENtq6hJwUojroMz2VB+Q1edmi4IfrAPpami5VVgMQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/postcss/"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "dependencies": {
-                "lilconfig": "^3.0.0",
-                "yaml": "^2.3.4"
-            },
-            "engines": {
-                "node": ">= 14"
-            },
-            "peerDependencies": {
-                "postcss": ">=8.0.9",
-                "ts-node": ">=9.0.0"
-            },
-            "peerDependenciesMeta": {
-                "postcss": {
-                    "optional": true
-                },
-                "ts-node": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/tailwindcss/node_modules/postcss-load-config/node_modules/lilconfig": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.1.tgz",
-            "integrity": "sha512-O18pf7nyvHTckunPWCV1XUNXU1piu01y2b7ATJ0ppkUkk8ocqVWBrYjJBCwHDjD/ZWcfyrA0P4gKhzWGi5EINQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/antonk52"
-            }
-        },
-        "node_modules/tailwindcss/node_modules/postcss-selector-parser": {
-            "version": "6.0.16",
-            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.16.tgz",
-            "integrity": "sha512-A0RVJrX+IUkVZbW3ClroRWurercFhieevHB38sr2+l9eUClMqome3LmEmnhlNy+5Mr2EYN6B2Kaw9wYdd+VHiw==",
-            "dev": true,
-            "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/tailwindcss/node_modules/yaml": {
-            "version": "2.4.1",
-            "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.4.1.tgz",
-            "integrity": "sha512-pIXzoImaqmfOrL7teGUBt/T7ZDnyeGBWyXQBvOVhLkWLN37GXv8NMLK406UY6dS51JfcQHsmcW5cJ441bHg6Lg==",
-            "dev": true,
-            "bin": {
-                "yaml": "bin.mjs"
-            },
-            "engines": {
-                "node": ">= 14"
-            }
-        },
-        "node_modules/tapable": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz",
-            "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/terser": {
-            "version": "5.31.6",
-            "resolved": "https://registry.npmjs.org/terser/-/terser-5.31.6.tgz",
-            "integrity": "sha512-PQ4DAriWzKj+qgehQ7LK5bQqCFNMmlhjR2PFFLuqGCpuCAauxemVBWwWOxo3UIwWQx8+Pr61Df++r76wDmkQBg==",
-            "dev": true,
-            "dependencies": {
-                "@jridgewell/source-map": "^0.3.3",
-                "acorn": "^8.8.2",
-                "commander": "^2.20.0",
-                "source-map-support": "~0.5.20"
-            },
-            "bin": {
-                "terser": "bin/terser"
-            },
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/terser-webpack-plugin": {
-            "version": "5.3.10",
-            "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.10.tgz",
-            "integrity": "sha512-BKFPWlPDndPs+NGGCr1U59t0XScL5317Y0UReNrHaw9/FwhPENlq6bfgs+4yPfyP51vqC1bQ4rp1EfXW5ZSH9w==",
-            "dev": true,
-            "dependencies": {
-                "@jridgewell/trace-mapping": "^0.3.20",
-                "jest-worker": "^27.4.5",
-                "schema-utils": "^3.1.1",
-                "serialize-javascript": "^6.0.1",
-                "terser": "^5.26.0"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^5.1.0"
-            },
-            "peerDependenciesMeta": {
-                "@swc/core": {
-                    "optional": true
-                },
-                "esbuild": {
-                    "optional": true
-                },
-                "uglify-js": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/terser-webpack-plugin/node_modules/schema-utils": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-            "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/terser/node_modules/commander": {
-            "version": "2.20.3",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-            "dev": true
-        },
-        "node_modules/thenify": {
-            "version": "3.3.1",
-            "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
-            "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==",
-            "dev": true,
-            "dependencies": {
-                "any-promise": "^1.0.0"
-            }
-        },
-        "node_modules/thenify-all": {
-            "version": "1.6.0",
-            "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz",
-            "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==",
-            "dev": true,
-            "dependencies": {
-                "thenify": ">= 3.1.0 < 4"
-            },
-            "engines": {
-                "node": ">=0.8"
-            }
-        },
-        "node_modules/thunky": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/thunky/-/thunky-1.1.0.tgz",
-            "integrity": "sha512-eHY7nBftgThBqOyHGVN+l8gF0BucP09fMo0oO/Lb0w1OF80dJv+lDVpXG60WMQvkcxAkNybKsrEIE3ZtKGmPrA==",
-            "dev": true
-        },
-        "node_modules/timers-browserify": {
-            "version": "2.0.12",
-            "resolved": "https://registry.npmjs.org/timers-browserify/-/timers-browserify-2.0.12.tgz",
-            "integrity": "sha512-9phl76Cqm6FhSX9Xe1ZUAMLtm1BLkKj2Qd5ApyWkXzsMRaA7dgr81kf4wJmQf/hAvg8EEyJxDo3du/0KlhPiKQ==",
-            "dev": true,
-            "dependencies": {
-                "setimmediate": "^1.0.4"
-            },
-            "engines": {
-                "node": ">=0.6.0"
-            }
-        },
-        "node_modules/to-arraybuffer": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",
-            "integrity": "sha512-okFlQcoGTi4LQBG/PgSYblw9VOyptsz2KJZqc6qtgGdes8VktzUQkj4BI2blit072iS8VODNcMA+tvnS9dnuMA==",
-            "dev": true
-        },
-        "node_modules/to-fast-properties": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz",
-            "integrity": "sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/to-regex-range": {
-            "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-            "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
-            "dev": true,
-            "dependencies": {
-                "is-number": "^7.0.0"
-            },
-            "engines": {
-                "node": ">=8.0"
-            }
-        },
-        "node_modules/toidentifier": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
-            "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.6"
-            }
-        },
-        "node_modules/ts-interface-checker": {
-            "version": "0.1.13",
-            "resolved": "https://registry.npmjs.org/ts-interface-checker/-/ts-interface-checker-0.1.13.tgz",
-            "integrity": "sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==",
-            "dev": true
-        },
-        "node_modules/tslib": {
-            "version": "2.4.0",
-            "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz",
-            "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==",
-            "dev": true
-        },
-        "node_modules/tty-browserify": {
-            "version": "0.0.0",
-            "resolved": "https://registry.npmjs.org/tty-browserify/-/tty-browserify-0.0.0.tgz",
-            "integrity": "sha512-JVa5ijo+j/sOoHGjw0sxw734b1LhBkQ3bvUGNdxnVXDCX81Yx7TFgnZygxrIIWn23hbfTaMYLwRmAxFyDuFmIw==",
-            "dev": true
-        },
-        "node_modules/type-is": {
-            "version": "1.6.18",
-            "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
-            "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
-            "dev": true,
-            "dependencies": {
-                "media-typer": "0.3.0",
-                "mime-types": "~2.1.24"
-            },
-            "engines": {
-                "node": ">= 0.6"
-            }
-        },
-        "node_modules/unicode-canonical-property-names-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-yY5PpDlfVIU5+y/BSCxAJRBIS1Zc2dDG3Ujq+sR0U+JjUevW2JhocOF+soROYDSaAezOzOKuyyixhD6mBknSmQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/unicode-match-property-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==",
-            "dev": true,
-            "dependencies": {
-                "unicode-canonical-property-names-ecmascript": "^2.0.0",
-                "unicode-property-aliases-ecmascript": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/unicode-match-property-value-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-7Yhkc0Ye+t4PNYzOGKedDhXbYIBe1XEQYQxOPyhcXNMJ0WCABqqj6ckydd6pWRZTHV4GuCPKdBAUiMc60tsKVw==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/unicode-property-aliases-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-5Zfuy9q/DFr4tfO7ZPeVXb1aPoeQSdeFMLpYuFebehDAhbuevLs5yxSZmIFN1tP5F9Wl4IpJrYojg85/zgyZHQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/universalify": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.0.tgz",
-            "integrity": "sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 10.0.0"
-            }
-        },
-        "node_modules/unpipe": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
-            "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/update-browserslist-db": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.0.tgz",
-            "integrity": "sha512-EdRAaAyk2cUE1wOf2DkEhzxqOQvFOoRJFNS6NeyJ01Gp2beMRpBAINjM2iDXE3KCuKhwnvHIQCJm6ThL2Z+HzQ==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/browserslist"
-                },
-                {
-                    "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/browserslist"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "dependencies": {
-                "escalade": "^3.1.2",
-                "picocolors": "^1.0.1"
-            },
-            "bin": {
-                "update-browserslist-db": "cli.js"
-            },
-            "peerDependencies": {
-                "browserslist": ">= 4.21.0"
-            }
-        },
-        "node_modules/uri-js": {
-            "version": "4.4.1",
-            "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
-            "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
-            "dev": true,
-            "dependencies": {
-                "punycode": "^2.1.0"
-            }
-        },
-        "node_modules/uri-js/node_modules/punycode": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz",
-            "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==",
-            "dev": true,
-            "engines": {
-                "node": ">=6"
-            }
-        },
-        "node_modules/url": {
-            "version": "0.11.0",
-            "resolved": "https://registry.npmjs.org/url/-/url-0.11.0.tgz",
-            "integrity": "sha512-kbailJa29QrtXnxgq+DdCEGlbTeYM2eJUxsz6vjZavrCYPMIFHMKQmSKYAIuUK2i7hgPm28a8piX5NTUtM/LKQ==",
-            "dev": true,
-            "dependencies": {
-                "punycode": "1.3.2",
-                "querystring": "0.2.0"
-            }
-        },
-        "node_modules/url/node_modules/punycode": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.3.2.tgz",
-            "integrity": "sha512-RofWgt/7fL5wP1Y7fxE7/EmTLzQVnB0ycyibJ0OOHIlJqTNzglYFxVwETOcIoJqJmpDXJ9xImDv+Fq34F/d4Dw==",
-            "dev": true
-        },
-        "node_modules/util": {
-            "version": "0.11.1",
-            "resolved": "https://registry.npmjs.org/util/-/util-0.11.1.tgz",
-            "integrity": "sha512-HShAsny+zS2TZfaXxD9tYj4HQGlBezXZMZuM/S5PKLLoZkShZiGk9o5CzukI1LVHZvjdvZ2Sj1aW/Ndn2NB/HQ==",
-            "dev": true,
-            "dependencies": {
-                "inherits": "2.0.3"
-            }
-        },
-        "node_modules/util-deprecate": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-            "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=",
-            "dev": true
-        },
-        "node_modules/util/node_modules/inherits": {
-            "version": "2.0.3",
-            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-            "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
-            "dev": true
-        },
-        "node_modules/utils-merge": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
-            "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.4.0"
-            }
-        },
-        "node_modules/uuid": {
-            "version": "8.3.2",
-            "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
-            "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
-            "dev": true,
-            "bin": {
-                "uuid": "dist/bin/uuid"
-            }
-        },
-        "node_modules/vary": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
-            "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 0.8"
-            }
-        },
-        "node_modules/vm-browserify": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/vm-browserify/-/vm-browserify-1.1.2.tgz",
-            "integrity": "sha512-2ham8XPWTONajOR0ohOKOHXkm3+gaBmGut3SRuu75xLd/RRaY6vqgh8NBYYk7+RW3u5AtzPQZG8F10LHkl0lAQ==",
-            "dev": true
-        },
-        "node_modules/vue-style-loader": {
-            "version": "4.1.3",
-            "resolved": "https://registry.npmjs.org/vue-style-loader/-/vue-style-loader-4.1.3.tgz",
-            "integrity": "sha512-sFuh0xfbtpRlKfm39ss/ikqs9AbKCoXZBpHeVZ8Tx650o0k0q/YCM7FRvigtxpACezfq6af+a7JeqVTWvncqDg==",
-            "dev": true,
-            "dependencies": {
-                "hash-sum": "^1.0.2",
-                "loader-utils": "^1.0.2"
-            }
-        },
-        "node_modules/vue-style-loader/node_modules/json5": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
-            "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
-            "dev": true,
-            "dependencies": {
-                "minimist": "^1.2.0"
-            },
-            "bin": {
-                "json5": "lib/cli.js"
-            }
-        },
-        "node_modules/vue-style-loader/node_modules/loader-utils": {
-            "version": "1.4.2",
-            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
-            "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
-            "dev": true,
-            "dependencies": {
-                "big.js": "^5.2.2",
-                "emojis-list": "^3.0.0",
-                "json5": "^1.0.1"
-            },
-            "engines": {
-                "node": ">=4.0.0"
-            }
-        },
-        "node_modules/watchpack": {
-            "version": "2.4.2",
-            "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.2.tgz",
-            "integrity": "sha512-TnbFSbcOCcDgjZ4piURLCbJ3nJhznVh9kw6F6iokjiFPl8ONxe9A6nMDVXDiNbrSfLILs6vB07F7wLBrwPYzJw==",
-            "dev": true,
-            "dependencies": {
-                "glob-to-regexp": "^0.4.1",
-                "graceful-fs": "^4.1.2"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            }
-        },
-        "node_modules/wbuf": {
-            "version": "1.7.3",
-            "resolved": "https://registry.npmjs.org/wbuf/-/wbuf-1.7.3.tgz",
-            "integrity": "sha512-O84QOnr0icsbFGLS0O3bI5FswxzRr8/gHwWkDlQFskhSPryQXvrTMxjxGP4+iWYoauLoBvfDpkrOauZ+0iZpDA==",
-            "dev": true,
-            "dependencies": {
-                "minimalistic-assert": "^1.0.0"
-            }
-        },
-        "node_modules/webpack": {
-            "version": "5.94.0",
-            "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.94.0.tgz",
-            "integrity": "sha512-KcsGn50VT+06JH/iunZJedYGUJS5FGjow8wb9c0v5n1Om8O1g4L6LjtfxwlXIATopoQu+vOXXa7gYisWxCoPyg==",
-            "dev": true,
-            "dependencies": {
-                "@types/estree": "^1.0.5",
-                "@webassemblyjs/ast": "^1.12.1",
-                "@webassemblyjs/wasm-edit": "^1.12.1",
-                "@webassemblyjs/wasm-parser": "^1.12.1",
-                "acorn": "^8.7.1",
-                "acorn-import-attributes": "^1.9.5",
-                "browserslist": "^4.21.10",
-                "chrome-trace-event": "^1.0.2",
-                "enhanced-resolve": "^5.17.1",
-                "es-module-lexer": "^1.2.1",
-                "eslint-scope": "5.1.1",
-                "events": "^3.2.0",
-                "glob-to-regexp": "^0.4.1",
-                "graceful-fs": "^4.2.11",
-                "json-parse-even-better-errors": "^2.3.1",
-                "loader-runner": "^4.2.0",
-                "mime-types": "^2.1.27",
-                "neo-async": "^2.6.2",
-                "schema-utils": "^3.2.0",
-                "tapable": "^2.1.1",
-                "terser-webpack-plugin": "^5.3.10",
-                "watchpack": "^2.4.1",
-                "webpack-sources": "^3.2.3"
-            },
-            "bin": {
-                "webpack": "bin/webpack.js"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependenciesMeta": {
-                "webpack-cli": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/webpack-cli": {
-            "version": "4.10.0",
-            "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-4.10.0.tgz",
-            "integrity": "sha512-NLhDfH/h4O6UOy+0LSso42xvYypClINuMNBVVzX4vX98TmTaTUxwRbXdhucbFMd2qLaCTcLq/PdYrvi8onw90w==",
-            "dev": true,
-            "dependencies": {
-                "@discoveryjs/json-ext": "^0.5.0",
-                "@webpack-cli/configtest": "^1.2.0",
-                "@webpack-cli/info": "^1.5.0",
-                "@webpack-cli/serve": "^1.7.0",
-                "colorette": "^2.0.14",
-                "commander": "^7.0.0",
-                "cross-spawn": "^7.0.3",
-                "fastest-levenshtein": "^1.0.12",
-                "import-local": "^3.0.2",
-                "interpret": "^2.2.0",
-                "rechoir": "^0.7.0",
-                "webpack-merge": "^5.7.3"
-            },
-            "bin": {
-                "webpack-cli": "bin/cli.js"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "4.x.x || 5.x.x"
-            },
-            "peerDependenciesMeta": {
-                "@webpack-cli/generators": {
-                    "optional": true
-                },
-                "@webpack-cli/migrate": {
-                    "optional": true
-                },
-                "webpack-bundle-analyzer": {
-                    "optional": true
-                },
-                "webpack-dev-server": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/webpack-dev-middleware": {
-            "version": "5.3.4",
-            "resolved": "https://registry.npmjs.org/webpack-dev-middleware/-/webpack-dev-middleware-5.3.4.tgz",
-            "integrity": "sha512-BVdTqhhs+0IfoeAf7EoH5WE+exCmqGerHfDM0IL096Px60Tq2Mn9MAbnaGUe6HiMa41KMCYF19gyzZmBcq/o4Q==",
-            "dev": true,
-            "dependencies": {
-                "colorette": "^2.0.10",
-                "memfs": "^3.4.3",
-                "mime-types": "^2.1.31",
-                "range-parser": "^1.2.1",
-                "schema-utils": "^4.0.0"
-            },
-            "engines": {
-                "node": ">= 12.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.0.0 || ^5.0.0"
-            }
-        },
-        "node_modules/webpack-dev-middleware/node_modules/ajv": {
-            "version": "8.11.0",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-            "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.1",
-                "json-schema-traverse": "^1.0.0",
-                "require-from-string": "^2.0.2",
-                "uri-js": "^4.2.2"
-            },
-            "funding": {
-                "type": "github",
-                "url": "https://github.com/sponsors/epoberezkin"
-            }
-        },
-        "node_modules/webpack-dev-middleware/node_modules/ajv-keywords": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
-            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.3"
-            },
-            "peerDependencies": {
-                "ajv": "^8.8.2"
-            }
-        },
-        "node_modules/webpack-dev-middleware/node_modules/json-schema-traverse": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-            "dev": true
-        },
-        "node_modules/webpack-dev-middleware/node_modules/schema-utils": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz",
-            "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.9",
-                "ajv": "^8.8.0",
-                "ajv-formats": "^2.1.1",
-                "ajv-keywords": "^5.0.0"
-            },
-            "engines": {
-                "node": ">= 12.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/webpack-dev-server": {
-            "version": "4.9.3",
-            "resolved": "https://registry.npmjs.org/webpack-dev-server/-/webpack-dev-server-4.9.3.tgz",
-            "integrity": "sha512-3qp/eoboZG5/6QgiZ3llN8TUzkSpYg1Ko9khWX1h40MIEUNS2mDoIa8aXsPfskER+GbTvs/IJZ1QTBBhhuetSw==",
-            "dev": true,
-            "dependencies": {
-                "@types/bonjour": "^3.5.9",
-                "@types/connect-history-api-fallback": "^1.3.5",
-                "@types/express": "^4.17.13",
-                "@types/serve-index": "^1.9.1",
-                "@types/serve-static": "^1.13.10",
-                "@types/sockjs": "^0.3.33",
-                "@types/ws": "^8.5.1",
-                "ansi-html-community": "^0.0.8",
-                "bonjour-service": "^1.0.11",
-                "chokidar": "^3.5.3",
-                "colorette": "^2.0.10",
-                "compression": "^1.7.4",
-                "connect-history-api-fallback": "^2.0.0",
-                "default-gateway": "^6.0.3",
-                "express": "^4.17.3",
-                "graceful-fs": "^4.2.6",
-                "html-entities": "^2.3.2",
-                "http-proxy-middleware": "^2.0.3",
-                "ipaddr.js": "^2.0.1",
-                "open": "^8.0.9",
-                "p-retry": "^4.5.0",
-                "rimraf": "^3.0.2",
-                "schema-utils": "^4.0.0",
-                "selfsigned": "^2.0.1",
-                "serve-index": "^1.9.1",
-                "sockjs": "^0.3.24",
-                "spdy": "^4.0.2",
-                "webpack-dev-middleware": "^5.3.1",
-                "ws": "^8.4.2"
-            },
-            "bin": {
-                "webpack-dev-server": "bin/webpack-dev-server.js"
-            },
-            "engines": {
-                "node": ">= 12.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            },
-            "peerDependencies": {
-                "webpack": "^4.37.0 || ^5.0.0"
-            },
-            "peerDependenciesMeta": {
-                "webpack-cli": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/webpack-dev-server/node_modules/ajv": {
-            "version": "8.11.0",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-            "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.1",
-                "json-schema-traverse": "^1.0.0",
-                "require-from-string": "^2.0.2",
-                "uri-js": "^4.2.2"
-            },
-            "funding": {
-                "type": "github",
-                "url": "https://github.com/sponsors/epoberezkin"
-            }
-        },
-        "node_modules/webpack-dev-server/node_modules/ajv-keywords": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
-            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
-            "dev": true,
-            "dependencies": {
-                "fast-deep-equal": "^3.1.3"
-            },
-            "peerDependencies": {
-                "ajv": "^8.8.2"
-            }
-        },
-        "node_modules/webpack-dev-server/node_modules/json-schema-traverse": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-            "dev": true
-        },
-        "node_modules/webpack-dev-server/node_modules/schema-utils": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz",
-            "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.9",
-                "ajv": "^8.8.0",
-                "ajv-formats": "^2.1.1",
-                "ajv-keywords": "^5.0.0"
-            },
-            "engines": {
-                "node": ">= 12.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/webpack-merge": {
-            "version": "5.8.0",
-            "resolved": "https://registry.npmjs.org/webpack-merge/-/webpack-merge-5.8.0.tgz",
-            "integrity": "sha512-/SaI7xY0831XwP6kzuwhKWVKDP9t1QY1h65lAFLbZqMPIuYcD9QAW4u9STIbU9kaJbPBB/geU/gLr1wDjOhQ+Q==",
-            "dev": true,
-            "dependencies": {
-                "clone-deep": "^4.0.1",
-                "wildcard": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=10.0.0"
-            }
-        },
-        "node_modules/webpack-notifier": {
-            "version": "1.15.0",
-            "resolved": "https://registry.npmjs.org/webpack-notifier/-/webpack-notifier-1.15.0.tgz",
-            "integrity": "sha512-N2V8UMgRB5komdXQRavBsRpw0hPhJq2/SWNOGuhrXpIgRhcMexzkGQysUyGStHLV5hkUlgpRiF7IUXoBqyMmzQ==",
-            "dev": true,
-            "dependencies": {
-                "node-notifier": "^9.0.0",
-                "strip-ansi": "^6.0.0"
-            },
-            "peerDependencies": {
-                "@types/webpack": ">4.41.31"
-            },
-            "peerDependenciesMeta": {
-                "@types/webpack": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/webpack-sources": {
-            "version": "1.4.3",
-            "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-1.4.3.tgz",
-            "integrity": "sha512-lgTS3Xhv1lCOKo7SA5TjKXMjpSM4sBjNV5+q2bqesbSPs5FjGmU6jjtBSkX9b4qW87vDIsCIlUPOEhbZrMdjeQ==",
-            "dev": true,
-            "dependencies": {
-                "source-list-map": "^2.0.0",
-                "source-map": "~0.6.1"
-            }
-        },
-        "node_modules/webpack/node_modules/schema-utils": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
-            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
-            "dev": true,
-            "dependencies": {
-                "@types/json-schema": "^7.0.8",
-                "ajv": "^6.12.5",
-                "ajv-keywords": "^3.5.2"
-            },
-            "engines": {
-                "node": ">= 10.13.0"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/webpack"
-            }
-        },
-        "node_modules/webpack/node_modules/webpack-sources": {
-            "version": "3.2.3",
-            "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.2.3.tgz",
-            "integrity": "sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w==",
-            "dev": true,
-            "engines": {
-                "node": ">=10.13.0"
-            }
-        },
-        "node_modules/webpackbar": {
-            "version": "5.0.2",
-            "resolved": "https://registry.npmjs.org/webpackbar/-/webpackbar-5.0.2.tgz",
-            "integrity": "sha512-BmFJo7veBDgQzfWXl/wwYXr/VFus0614qZ8i9znqcl9fnEdiVkdbi0TedLQ6xAK92HZHDJ0QmyQ0fmuZPAgCYQ==",
-            "dev": true,
-            "dependencies": {
-                "chalk": "^4.1.0",
-                "consola": "^2.15.3",
-                "pretty-time": "^1.1.0",
-                "std-env": "^3.0.1"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "peerDependencies": {
-                "webpack": "3 || 4 || 5"
-            }
-        },
-        "node_modules/websocket-driver": {
-            "version": "0.7.4",
-            "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz",
-            "integrity": "sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg==",
-            "dev": true,
-            "dependencies": {
-                "http-parser-js": ">=0.5.1",
-                "safe-buffer": ">=5.1.0",
-                "websocket-extensions": ">=0.1.1"
-            },
-            "engines": {
-                "node": ">=0.8.0"
-            }
-        },
-        "node_modules/websocket-extensions": {
-            "version": "0.1.4",
-            "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz",
-            "integrity": "sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.8.0"
-            }
-        },
-        "node_modules/which": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-            "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-            "dev": true,
-            "dependencies": {
-                "isexe": "^2.0.0"
-            },
-            "bin": {
-                "node-which": "bin/node-which"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/wildcard": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/wildcard/-/wildcard-2.0.0.tgz",
-            "integrity": "sha512-JcKqAHLPxcdb9KM49dufGXn2x3ssnfjbcaQdLlfZsL9rH9wgDQjUtDxbo8NE0F6SFvydeu1VhZe7hZuHsB2/pw==",
-            "dev": true
-        },
-        "node_modules/wrap-ansi": {
-            "version": "7.0.0",
-            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
-            "dev": true,
-            "dependencies": {
-                "ansi-styles": "^4.0.0",
-                "string-width": "^4.1.0",
-                "strip-ansi": "^6.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-            }
-        },
-        "node_modules/wrap-ansi-cjs": {
-            "name": "wrap-ansi",
-            "version": "7.0.0",
-            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
-            "dev": true,
-            "dependencies": {
-                "ansi-styles": "^4.0.0",
-                "string-width": "^4.1.0",
-                "strip-ansi": "^6.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-            }
-        },
-        "node_modules/wrappy": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-            "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
-            "dev": true
-        },
-        "node_modules/ws": {
-            "version": "8.17.1",
-            "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
-            "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=10.0.0"
-            },
-            "peerDependencies": {
-                "bufferutil": "^4.0.1",
-                "utf-8-validate": ">=5.0.2"
-            },
-            "peerDependenciesMeta": {
-                "bufferutil": {
-                    "optional": true
-                },
-                "utf-8-validate": {
-                    "optional": true
-                }
-            }
-        },
-        "node_modules/xtend": {
-            "version": "4.0.2",
-            "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
-            "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
-            "dev": true,
-            "engines": {
-                "node": ">=0.4"
-            }
-        },
-        "node_modules/y18n": {
-            "version": "5.0.8",
-            "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
-            "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
-            "dev": true,
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/yallist": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
-            "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==",
-            "dev": true
-        },
-        "node_modules/yaml": {
-            "version": "1.10.2",
-            "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz",
-            "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==",
-            "dev": true,
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/yargs": {
-            "version": "17.5.1",
-            "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.5.1.tgz",
-            "integrity": "sha512-t6YAJcxDkNX7NFYiVtKvWUz8l+PaKTLiL63mJYWR2GnHq2gjEWISzsLp9wg3aY36dY1j+gfIEL3pIF+XlJJfbA==",
-            "dev": true,
-            "dependencies": {
-                "cliui": "^7.0.2",
-                "escalade": "^3.1.1",
-                "get-caller-file": "^2.0.5",
-                "require-directory": "^2.1.1",
-                "string-width": "^4.2.3",
-                "y18n": "^5.0.5",
-                "yargs-parser": "^21.0.0"
-            },
-            "engines": {
-                "node": ">=12"
-            }
-        },
-        "node_modules/yargs-parser": {
-            "version": "21.0.1",
-            "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.0.1.tgz",
-            "integrity": "sha512-9BK1jFpLzJROCI5TzwZL/TU4gqjK5xiHV/RfWLOahrjAko/e4DJkRDZQXfvqAsiZzzYhgAzbgz6lg48jcm4GLg==",
-            "dev": true,
-            "engines": {
-                "node": ">=12"
-            }
-        }
-    },
-    "dependencies": {
-        "@alloc/quick-lru": {
-            "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
-            "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
-            "dev": true
-        },
-        "@ampproject/remapping": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.2.0.tgz",
-            "integrity": "sha512-qRmjj8nj9qmLTQXXmaR1cck3UXSRMPrbsLJAasZpF+t3riI71BXed5ebIOYwQntykeZuhjsdweEc9BxH5Jc26w==",
-            "dev": true,
-            "requires": {
-                "@jridgewell/gen-mapping": "^0.1.0",
-                "@jridgewell/trace-mapping": "^0.3.9"
-            }
-        },
-        "@babel/code-frame": {
-            "version": "7.22.13",
-            "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.22.13.tgz",
-            "integrity": "sha512-XktuhWlJ5g+3TJXc5upd9Ks1HutSArik6jf2eAjYFyIOf4ej3RN+184cZbzDvbPnuTJIUhPKKJE3cIsYTiAT3w==",
-            "dev": true,
-            "requires": {
-                "@babel/highlight": "^7.22.13",
-                "chalk": "^2.4.2"
-            },
-            "dependencies": {
-                "ansi-styles": {
-                    "version": "3.2.1",
-                    "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
-                    "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
-                    "dev": true,
-                    "requires": {
-                        "color-convert": "^1.9.0"
-                    }
-                },
-                "chalk": {
-                    "version": "2.4.2",
-                    "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
-                    "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
-                    "dev": true,
-                    "requires": {
-                        "ansi-styles": "^3.2.1",
-                        "escape-string-regexp": "^1.0.5",
-                        "supports-color": "^5.3.0"
-                    }
-                },
-                "supports-color": {
-                    "version": "5.5.0",
-                    "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
-                    "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
-                    "dev": true,
-                    "requires": {
-                        "has-flag": "^3.0.0"
-                    }
-                }
-            }
-        },
-        "@babel/compat-data": {
-            "version": "7.17.10",
-            "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.17.10.tgz",
-            "integrity": "sha512-GZt/TCsG70Ms19gfZO1tM4CVnXsPgEPBCpJu+Qz3L0LUDsY5nZqFZglIoPC1kIYOtNBZlrnFT+klg12vFGZXrw==",
-            "dev": true
-        },
-        "@babel/core": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.18.2.tgz",
-            "integrity": "sha512-A8pri1YJiC5UnkdrWcmfZTJTV85b4UXTAfImGmCfYmax4TR9Cw8sDS0MOk++Gp2mE/BefVJ5nwy5yzqNJbP/DQ==",
-            "dev": true,
-            "requires": {
-                "@ampproject/remapping": "^2.1.0",
-                "@babel/code-frame": "^7.16.7",
-                "@babel/generator": "^7.18.2",
-                "@babel/helper-compilation-targets": "^7.18.2",
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helpers": "^7.18.2",
-                "@babel/parser": "^7.18.0",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2",
-                "convert-source-map": "^1.7.0",
-                "debug": "^4.1.0",
-                "gensync": "^1.0.0-beta.2",
-                "json5": "^2.2.1",
-                "semver": "^6.3.0"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "@babel/generator": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.23.0.tgz",
-            "integrity": "sha512-lN85QRR+5IbYrMWM6Y4pE/noaQtg4pNiqeNGX60eqOfo6gtEj6uw/JagelB8vVztSd7R6M5n1+PQkDbHbBRU4g==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.23.0",
-                "@jridgewell/gen-mapping": "^0.3.2",
-                "@jridgewell/trace-mapping": "^0.3.17",
-                "jsesc": "^2.5.1"
-            },
-            "dependencies": {
-                "@jridgewell/gen-mapping": {
-                    "version": "0.3.3",
-                    "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.3.tgz",
-                    "integrity": "sha512-HLhSWOLRi875zjjMG/r+Nv0oCW8umGb0BgEhyX3dDX3egwZtB8PqLnjz3yedt8R5StBrzcg4aBpnh8UA9D1BoQ==",
-                    "dev": true,
-                    "requires": {
-                        "@jridgewell/set-array": "^1.0.1",
-                        "@jridgewell/sourcemap-codec": "^1.4.10",
-                        "@jridgewell/trace-mapping": "^0.3.9"
-                    }
-                }
-            }
-        },
-        "@babel/helper-annotate-as-pure": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.16.7.tgz",
-            "integrity": "sha512-s6t2w/IPQVTAET1HitoowRGXooX8mCgtuP5195wD/QJPV6wYjpujCGF7JuMODVX2ZAJOf1GT6DT9MHEZvLOFSw==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.16.7"
-            }
-        },
-        "@babel/helper-builder-binary-assignment-operator-visitor": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-builder-binary-assignment-operator-visitor/-/helper-builder-binary-assignment-operator-visitor-7.16.7.tgz",
-            "integrity": "sha512-C6FdbRaxYjwVu/geKW4ZeQ0Q31AftgRcdSnZ5/jsH6BzCJbtvXvhpfkbkThYSuutZA7nCXpPR6AD9zd1dprMkA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-explode-assignable-expression": "^7.16.7",
-                "@babel/types": "^7.16.7"
-            }
-        },
-        "@babel/helper-compilation-targets": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.18.2.tgz",
-            "integrity": "sha512-s1jnPotJS9uQnzFtiZVBUxe67CuBa679oWFHpxYYnTpRL/1ffhyX44R9uYiXoa/pLXcY9H2moJta0iaanlk/rQ==",
-            "dev": true,
-            "requires": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-validator-option": "^7.16.7",
-                "browserslist": "^4.20.2",
-                "semver": "^6.3.0"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "@babel/helper-create-class-features-plugin": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.18.0.tgz",
-            "integrity": "sha512-Kh8zTGR9de3J63e5nS0rQUdRs/kbtwoeQQ0sriS0lItjC96u8XXZN6lKpuyWd2coKSU13py/y+LTmThLuVX0Pg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-environment-visitor": "^7.16.7",
-                "@babel/helper-function-name": "^7.17.9",
-                "@babel/helper-member-expression-to-functions": "^7.17.7",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/helper-replace-supers": "^7.16.7",
-                "@babel/helper-split-export-declaration": "^7.16.7"
-            }
-        },
-        "@babel/helper-create-regexp-features-plugin": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.17.12.tgz",
-            "integrity": "sha512-b2aZrV4zvutr9AIa6/gA3wsZKRwTKYoDxYiFKcESS3Ug2GTXzwBEvMuuFLhCQpEnRXs1zng4ISAXSUxxKBIcxw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "regexpu-core": "^5.0.1"
-            }
-        },
-        "@babel/helper-define-polyfill-provider": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.3.1.tgz",
-            "integrity": "sha512-J9hGMpJQmtWmj46B3kBHmL38UhJGhYX7eqkcq+2gsstyYt341HmPeWspihX43yVRA0mS+8GGk2Gckc7bY/HCmA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-compilation-targets": "^7.13.0",
-                "@babel/helper-module-imports": "^7.12.13",
-                "@babel/helper-plugin-utils": "^7.13.0",
-                "@babel/traverse": "^7.13.0",
-                "debug": "^4.1.1",
-                "lodash.debounce": "^4.0.8",
-                "resolve": "^1.14.2",
-                "semver": "^6.1.2"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "@babel/helper-environment-visitor": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/helper-environment-visitor/-/helper-environment-visitor-7.22.20.tgz",
-            "integrity": "sha512-zfedSIzFhat/gFhWfHtgWvlec0nqB9YEIVrpuwjruLlXfUSnA8cJB0miHKwqDnQ7d32aKo2xt88/xZptwxbfhA==",
-            "dev": true
-        },
-        "@babel/helper-explode-assignable-expression": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-explode-assignable-expression/-/helper-explode-assignable-expression-7.16.7.tgz",
-            "integrity": "sha512-KyUenhWMC8VrxzkGP0Jizjo4/Zx+1nNZhgocs+gLzyZyB8SHidhoq9KK/8Ato4anhwsivfkBLftky7gvzbZMtQ==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.16.7"
-            }
-        },
-        "@babel/helper-function-name": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.23.0.tgz",
-            "integrity": "sha512-OErEqsrxjZTJciZ4Oo+eoZqeW9UIiOcuYKRJA4ZAgV9myA+pOXhhmpfNCKjEH/auVfEYVFJ6y1Tc4r0eIApqiw==",
-            "dev": true,
-            "requires": {
-                "@babel/template": "^7.22.15",
-                "@babel/types": "^7.23.0"
-            }
-        },
-        "@babel/helper-hoist-variables": {
-            "version": "7.22.5",
-            "resolved": "https://registry.npmjs.org/@babel/helper-hoist-variables/-/helper-hoist-variables-7.22.5.tgz",
-            "integrity": "sha512-wGjk9QZVzvknA6yKIUURb8zY3grXCcOZt+/7Wcy8O2uctxhplmUPkOdlgoNhmdVee2c92JXbf1xpMtVNbfoxRw==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.22.5"
-            }
-        },
-        "@babel/helper-member-expression-to-functions": {
-            "version": "7.17.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.17.7.tgz",
-            "integrity": "sha512-thxXgnQ8qQ11W2wVUObIqDL4p148VMxkt5T/qpN5k2fboRyzFGFmKsTGViquyM5QHKUy48OZoca8kw4ajaDPyw==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.17.0"
-            }
-        },
-        "@babel/helper-module-imports": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.16.7.tgz",
-            "integrity": "sha512-LVtS6TqjJHFc+nYeITRo6VLXve70xmq7wPhWTqDJusJEgGmkAACWwMiTNrvfoQo6hEhFwAIixNkvB0jPXDL8Wg==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.16.7"
-            }
-        },
-        "@babel/helper-module-transforms": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.18.0.tgz",
-            "integrity": "sha512-kclUYSUBIjlvnzN2++K9f2qzYKFgjmnmjwL4zlmU5f8ZtzgWe8s0rUPSTGy2HmK4P8T52MQsS+HTQAgZd3dMEA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-environment-visitor": "^7.16.7",
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-simple-access": "^7.17.7",
-                "@babel/helper-split-export-declaration": "^7.16.7",
-                "@babel/helper-validator-identifier": "^7.16.7",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.0",
-                "@babel/types": "^7.18.0"
-            }
-        },
-        "@babel/helper-optimise-call-expression": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.16.7.tgz",
-            "integrity": "sha512-EtgBhg7rd/JcnpZFXpBy0ze1YRfdm7BnBX4uKMBd3ixa3RGAE002JZB66FJyNH7g0F38U05pXmA5P8cBh7z+1w==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.16.7"
-            }
-        },
-        "@babel/helper-plugin-utils": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.17.12.tgz",
-            "integrity": "sha512-JDkf04mqtN3y4iAbO1hv9U2ARpPyPL1zqyWs/2WG1pgSq9llHFjStX5jdxb84himgJm+8Ng+x0oiWF/nw/XQKA==",
-            "dev": true
-        },
-        "@babel/helper-remap-async-to-generator": {
-            "version": "7.16.8",
-            "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.16.8.tgz",
-            "integrity": "sha512-fm0gH7Flb8H51LqJHy3HJ3wnE1+qtYR2A99K06ahwrawLdOFsCEWjZOrYricXJHoPSudNKxrMBUPEIPxiIIvBw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-wrap-function": "^7.16.8",
-                "@babel/types": "^7.16.8"
-            }
-        },
-        "@babel/helper-replace-supers": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.18.2.tgz",
-            "integrity": "sha512-XzAIyxx+vFnrOxiQrToSUOzUOn0e1J2Li40ntddek1Y69AXUTXoDJ40/D5RdjFu7s7qHiaeoTiempZcbuVXh2Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-environment-visitor": "^7.18.2",
-                "@babel/helper-member-expression-to-functions": "^7.17.7",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2"
-            }
-        },
-        "@babel/helper-simple-access": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helper-simple-access/-/helper-simple-access-7.18.2.tgz",
-            "integrity": "sha512-7LIrjYzndorDY88MycupkpQLKS1AFfsVRm2k/9PtKScSy5tZq0McZTj+DiMRynboZfIqOKvo03pmhTaUgiD6fQ==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.18.2"
-            }
-        },
-        "@babel/helper-skip-transparent-expression-wrappers": {
-            "version": "7.16.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.16.0.tgz",
-            "integrity": "sha512-+il1gTy0oHwUsBQZyJvukbB4vPMdcYBrFHa0Uc4AizLxbq6BOYC51Rv4tWocX9BLBDLZ4kc6qUFpQ6HRgL+3zw==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.16.0"
-            }
-        },
-        "@babel/helper-split-export-declaration": {
-            "version": "7.22.6",
-            "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.22.6.tgz",
-            "integrity": "sha512-AsUnxuLhRYsisFiaJwvp1QF+I3KjD5FOxut14q/GzovUe6orHLesW2C7d754kRm53h5gqrz6sFl6sxc4BVtE/g==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.22.5"
-            }
-        },
-        "@babel/helper-string-parser": {
-            "version": "7.22.5",
-            "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.22.5.tgz",
-            "integrity": "sha512-mM4COjgZox8U+JcXQwPijIZLElkgEpO5rsERVDJTc2qfCDfERyob6k5WegS14SX18IIjv+XD+GrqNumY5JRCDw==",
-            "dev": true
-        },
-        "@babel/helper-validator-identifier": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.20.tgz",
-            "integrity": "sha512-Y4OZ+ytlatR8AI+8KZfKuL5urKp7qey08ha31L8b3BwewJAoJamTzyvxPR/5D+KkdJCGPq/+8TukHBlY10FX9A==",
-            "dev": true
-        },
-        "@babel/helper-validator-option": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.16.7.tgz",
-            "integrity": "sha512-TRtenOuRUVo9oIQGPC5G9DgK4743cdxvtOw0weQNpZXaS16SCBi5MNjZF8vba3ETURjZpTbVn7Vvcf2eAwFozQ==",
-            "dev": true
-        },
-        "@babel/helper-wrap-function": {
-            "version": "7.16.8",
-            "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.16.8.tgz",
-            "integrity": "sha512-8RpyRVIAW1RcDDGTA+GpPAwV22wXCfKOoM9bet6TLkGIFTkRQSkH1nMQ5Yet4MpoXe1ZwHPVtNasc2w0uZMqnw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-function-name": "^7.16.7",
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.16.8",
-                "@babel/types": "^7.16.8"
-            }
-        },
-        "@babel/helpers": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.18.2.tgz",
-            "integrity": "sha512-j+d+u5xT5utcQSzrh9p+PaJX94h++KN+ng9b9WEJq7pkUPAd61FGqhjuUEdfknb3E/uDBb7ruwEeKkIxNJPIrg==",
-            "dev": true,
-            "requires": {
-                "@babel/template": "^7.16.7",
-                "@babel/traverse": "^7.18.2",
-                "@babel/types": "^7.18.2"
-            }
-        },
-        "@babel/highlight": {
-            "version": "7.22.20",
-            "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.22.20.tgz",
-            "integrity": "sha512-dkdMCN3py0+ksCgYmGG8jKeGA/8Tk+gJwSYYlFGxG5lmhfKNoAy004YpLxpS1W2J8m/EK2Ew+yOs9pVRwO89mg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-validator-identifier": "^7.22.20",
-                "chalk": "^2.4.2",
-                "js-tokens": "^4.0.0"
-            },
-            "dependencies": {
-                "ansi-styles": {
-                    "version": "3.2.1",
-                    "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
-                    "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
-                    "dev": true,
-                    "requires": {
-                        "color-convert": "^1.9.0"
-                    }
-                },
-                "chalk": {
-                    "version": "2.4.2",
-                    "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
-                    "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
-                    "dev": true,
-                    "requires": {
-                        "ansi-styles": "^3.2.1",
-                        "escape-string-regexp": "^1.0.5",
-                        "supports-color": "^5.3.0"
-                    }
-                },
-                "supports-color": {
-                    "version": "5.5.0",
-                    "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
-                    "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
-                    "dev": true,
-                    "requires": {
-                        "has-flag": "^3.0.0"
-                    }
-                }
-            }
-        },
-        "@babel/parser": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.23.0.tgz",
-            "integrity": "sha512-vvPKKdMemU85V9WE/l5wZEmImpCtLqbnTvqDS2U1fJ96KrxoW7KrXhNsNCblQlg8Ck4b85yxdTyelsMUgFUXiw==",
-            "dev": true
-        },
-        "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.17.12.tgz",
-            "integrity": "sha512-xCJQXl4EeQ3J9C4yOmpTrtVGmzpm2iSzyxbkZHw7UCnZBftHpF/hpII80uWVyVrc40ytIClHjgWGTG1g/yB+aw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.17.12.tgz",
-            "integrity": "sha512-/vt0hpIw0x4b6BLKUkwlvEoiGZYYLNZ96CzyHYPbtG2jZGz6LBe7/V+drYrc/d+ovrF9NBi0pmtvmNb/FsWtRQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0",
-                "@babel/plugin-proposal-optional-chaining": "^7.17.12"
-            }
-        },
-        "@babel/plugin-proposal-async-generator-functions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-async-generator-functions/-/plugin-proposal-async-generator-functions-7.17.12.tgz",
-            "integrity": "sha512-RWVvqD1ooLKP6IqWTA5GyFVX2isGEgC5iFxKzfYOIy/QEFdxYyCybBDtIGjipHpb9bDWHzcqGqFakf+mVmBTdQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-remap-async-to-generator": "^7.16.8",
-                "@babel/plugin-syntax-async-generators": "^7.8.4"
-            }
-        },
-        "@babel/plugin-proposal-class-properties": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-properties/-/plugin-proposal-class-properties-7.17.12.tgz",
-            "integrity": "sha512-U0mI9q8pW5Q9EaTHFPwSVusPMV/DV9Mm8p7csqROFLtIE9rBF5piLqyrBGigftALrBcsBGu4m38JneAe7ZDLXw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-proposal-class-static-block": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-class-static-block/-/plugin-proposal-class-static-block-7.18.0.tgz",
-            "integrity": "sha512-t+8LsRMMDE74c6sV7KShIw13sqbqd58tlqNrsWoWBTIMw7SVQ0cZ905wLNS/FBCy/3PyooRHLFFlfrUNyyz5lA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-class-features-plugin": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-class-static-block": "^7.14.5"
-            }
-        },
-        "@babel/plugin-proposal-dynamic-import": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-dynamic-import/-/plugin-proposal-dynamic-import-7.16.7.tgz",
-            "integrity": "sha512-I8SW9Ho3/8DRSdmDdH3gORdyUuYnk1m4cMxUAdu5oy4n3OfN8flDEH+d60iG7dUfi0KkYwSvoalHzzdRzpWHTg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-export-namespace-from": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-export-namespace-from/-/plugin-proposal-export-namespace-from-7.17.12.tgz",
-            "integrity": "sha512-j7Ye5EWdwoXOpRmo5QmRyHPsDIe6+u70ZYZrd7uz+ebPYFKfRcLcNu3Ro0vOlJ5zuv8rU7xa+GttNiRzX56snQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-export-namespace-from": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-json-strings": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-json-strings/-/plugin-proposal-json-strings-7.17.12.tgz",
-            "integrity": "sha512-rKJ+rKBoXwLnIn7n6o6fulViHMrOThz99ybH+hKHcOZbnN14VuMnH9fo2eHE69C8pO4uX1Q7t2HYYIDmv8VYkg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-json-strings": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-logical-assignment-operators": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-logical-assignment-operators/-/plugin-proposal-logical-assignment-operators-7.17.12.tgz",
-            "integrity": "sha512-EqFo2s1Z5yy+JeJu7SFfbIUtToJTVlC61/C7WLKDntSw4Sz6JNAIfL7zQ74VvirxpjB5kz/kIx0gCcb+5OEo2Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4"
-            }
-        },
-        "@babel/plugin-proposal-nullish-coalescing-operator": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-nullish-coalescing-operator/-/plugin-proposal-nullish-coalescing-operator-7.17.12.tgz",
-            "integrity": "sha512-ws/g3FSGVzv+VH86+QvgtuJL/kR67xaEIF2x0iPqdDfYW6ra6JF3lKVBkWynRLcNtIC1oCTfDRVxmm2mKzy+ag==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-numeric-separator": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-numeric-separator/-/plugin-proposal-numeric-separator-7.16.7.tgz",
-            "integrity": "sha512-vQgPMknOIgiuVqbokToyXbkY/OmmjAzr/0lhSIbG/KmnzXPGwW/AdhdKpi+O4X/VkWiWjnkKOBiqJrTaC98VKw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-numeric-separator": "^7.10.4"
-            }
-        },
-        "@babel/plugin-proposal-object-rest-spread": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-object-rest-spread/-/plugin-proposal-object-rest-spread-7.18.0.tgz",
-            "integrity": "sha512-nbTv371eTrFabDfHLElkn9oyf9VG+VKK6WMzhY2o4eHKaG19BToD9947zzGMO6I/Irstx9d8CwX6njPNIAR/yw==",
-            "dev": true,
-            "requires": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-compilation-targets": "^7.17.10",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
-                "@babel/plugin-transform-parameters": "^7.17.12"
-            }
-        },
-        "@babel/plugin-proposal-optional-catch-binding": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-catch-binding/-/plugin-proposal-optional-catch-binding-7.16.7.tgz",
-            "integrity": "sha512-eMOH/L4OvWSZAE1VkHbr1vckLG1WUcHGJSLqqQwl2GaUqG6QjddvrOaTUMNYiv77H5IKPMZ9U9P7EaHwvAShfA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/plugin-syntax-optional-catch-binding": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-optional-chaining": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-optional-chaining/-/plugin-proposal-optional-chaining-7.17.12.tgz",
-            "integrity": "sha512-7wigcOs/Z4YWlK7xxjkvaIw84vGhDv/P1dFGQap0nHkc8gFKY/r+hXc8Qzf5k1gY7CvGIcHqAnOagVKJJ1wVOQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0",
-                "@babel/plugin-syntax-optional-chaining": "^7.8.3"
-            }
-        },
-        "@babel/plugin-proposal-private-methods": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-methods/-/plugin-proposal-private-methods-7.17.12.tgz",
-            "integrity": "sha512-SllXoxo19HmxhDWm3luPz+cPhtoTSKLJE9PXshsfrOzBqs60QP0r8OaJItrPhAj0d7mZMnNF0Y1UUggCDgMz1A==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-proposal-private-property-in-object": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.17.12.tgz",
-            "integrity": "sha512-/6BtVi57CJfrtDNKfK5b66ydK2J5pXUKBKSPD2G1whamMuEnZWgoOIfO8Vf9F/DoD4izBLD/Au4NMQfruzzykg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-create-class-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/plugin-syntax-private-property-in-object": "^7.14.5"
-            }
-        },
-        "@babel/plugin-proposal-unicode-property-regex": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-unicode-property-regex/-/plugin-proposal-unicode-property-regex-7.17.12.tgz",
-            "integrity": "sha512-Wb9qLjXf3ZazqXA7IvI7ozqRIXIGPtSo+L5coFmEkhTQK18ao4UDDD0zdTGAarmbLj2urpRwrc6893cu5Bfh0A==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-regexp-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-syntax-async-generators": {
-            "version": "7.8.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz",
-            "integrity": "sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-class-properties": {
-            "version": "7.12.13",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz",
-            "integrity": "sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.12.13"
-            }
-        },
-        "@babel/plugin-syntax-class-static-block": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz",
-            "integrity": "sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.14.5"
-            }
-        },
-        "@babel/plugin-syntax-dynamic-import": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-dynamic-import/-/plugin-syntax-dynamic-import-7.8.3.tgz",
-            "integrity": "sha512-5gdGbFon+PszYzqs83S3E5mpi7/y/8M9eC90MRTZfduQOYW76ig6SOSPNe41IG5LoP3FGBn2N0RjVDSQiS94kQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-export-namespace-from": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-export-namespace-from/-/plugin-syntax-export-namespace-from-7.8.3.tgz",
-            "integrity": "sha512-MXf5laXo6c1IbEbegDmzGPwGNTsHZmEy6QGznu5Sh2UCWvueywb2ee+CCE4zQiZstxU9BMoQO9i6zUFSY0Kj0Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.3"
-            }
-        },
-        "@babel/plugin-syntax-import-assertions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.17.12.tgz",
-            "integrity": "sha512-n/loy2zkq9ZEM8tEOwON9wTQSTNDTDEz6NujPtJGLU7qObzT1N4c4YZZf8E6ATB2AjNQg/Ib2AIpO03EZaCehw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-syntax-json-strings": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz",
-            "integrity": "sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-logical-assignment-operators": {
-            "version": "7.10.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz",
-            "integrity": "sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.10.4"
-            }
-        },
-        "@babel/plugin-syntax-nullish-coalescing-operator": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz",
-            "integrity": "sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-numeric-separator": {
-            "version": "7.10.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz",
-            "integrity": "sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.10.4"
-            }
-        },
-        "@babel/plugin-syntax-object-rest-spread": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz",
-            "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-optional-catch-binding": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz",
-            "integrity": "sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-optional-chaining": {
-            "version": "7.8.3",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz",
-            "integrity": "sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.8.0"
-            }
-        },
-        "@babel/plugin-syntax-private-property-in-object": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz",
-            "integrity": "sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.14.5"
-            }
-        },
-        "@babel/plugin-syntax-top-level-await": {
-            "version": "7.14.5",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz",
-            "integrity": "sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.14.5"
-            }
-        },
-        "@babel/plugin-transform-arrow-functions": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.17.12.tgz",
-            "integrity": "sha512-PHln3CNi/49V+mza4xMwrg+WGYevSF1oaiXaC2EQfdp4HWlSjRsrDXWJiQBKpP7749u6vQ9mcry2uuFOv5CXvA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-async-to-generator": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.17.12.tgz",
-            "integrity": "sha512-J8dbrWIOO3orDzir57NRsjg4uxucvhby0L/KZuGsWDj0g7twWK3g7JhJhOrXtuXiw8MeiSdJ3E0OW9H8LYEzLQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-remap-async-to-generator": "^7.16.8"
-            }
-        },
-        "@babel/plugin-transform-block-scoped-functions": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.16.7.tgz",
-            "integrity": "sha512-JUuzlzmF40Z9cXyytcbZEZKckgrQzChbQJw/5PuEHYeqzCsvebDx0K0jWnIIVcmmDOAVctCgnYs0pMcrYj2zJg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-block-scoping": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.18.4.tgz",
-            "integrity": "sha512-+Hq10ye+jlvLEogSOtq4mKvtk7qwcUQ1f0Mrueai866C82f844Yom2cttfJdMdqRLTxWpsbfbkIkOIfovyUQXw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-classes": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.18.4.tgz",
-            "integrity": "sha512-e42NSG2mlKWgxKUAD9EJJSkZxR67+wZqzNxLSpc51T8tRU5SLFHsPmgYR5yr7sdgX4u+iHA1C5VafJ6AyImV3A==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-annotate-as-pure": "^7.16.7",
-                "@babel/helper-environment-visitor": "^7.18.2",
-                "@babel/helper-function-name": "^7.17.9",
-                "@babel/helper-optimise-call-expression": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-replace-supers": "^7.18.2",
-                "@babel/helper-split-export-declaration": "^7.16.7",
-                "globals": "^11.1.0"
-            }
-        },
-        "@babel/plugin-transform-computed-properties": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.17.12.tgz",
-            "integrity": "sha512-a7XINeplB5cQUWMg1E/GI1tFz3LfK021IjV1rj1ypE+R7jHm+pIHmHl25VNkZxtx9uuYp7ThGk8fur1HHG7PgQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-destructuring": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.18.0.tgz",
-            "integrity": "sha512-Mo69klS79z6KEfrLg/1WkmVnB8javh75HX4pi2btjvlIoasuxilEyjtsQW6XPrubNd7AQy0MMaNIaQE4e7+PQw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-dotall-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.16.7.tgz",
-            "integrity": "sha512-Lyttaao2SjZF6Pf4vk1dVKv8YypMpomAbygW+mU5cYP3S5cWTfCJjG8xV6CFdzGFlfWK81IjL9viiTvpb6G7gQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-regexp-features-plugin": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-duplicate-keys": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.17.12.tgz",
-            "integrity": "sha512-EA5eYFUG6xeerdabina/xIoB95jJ17mAkR8ivx6ZSu9frKShBjpOGZPn511MTDTkiCO+zXnzNczvUM69YSf3Zw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-exponentiation-operator": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.16.7.tgz",
-            "integrity": "sha512-8UYLSlyLgRixQvlYH3J2ekXFHDFLQutdy7FfFAMm3CPZ6q9wHCwnUyiXpQCe3gVVnQlHc5nsuiEVziteRNTXEA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-builder-binary-assignment-operator-visitor": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-for-of": {
-            "version": "7.18.1",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.18.1.tgz",
-            "integrity": "sha512-+TTB5XwvJ5hZbO8xvl2H4XaMDOAK57zF4miuC9qQJgysPNEAZZ9Z69rdF5LJkozGdZrjBIUAIyKUWRMmebI7vg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-function-name": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.16.7.tgz",
-            "integrity": "sha512-SU/C68YVwTRxqWj5kgsbKINakGag0KTgq9f2iZEXdStoAbOzLHEBRYzImmA6yFo8YZhJVflvXmIHUO7GWHmxxA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-compilation-targets": "^7.16.7",
-                "@babel/helper-function-name": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-literals": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.17.12.tgz",
-            "integrity": "sha512-8iRkvaTjJciWycPIZ9k9duu663FT7VrBdNqNgxnVXEFwOIp55JWcZd23VBRySYbnS3PwQ3rGiabJBBBGj5APmQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-member-expression-literals": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.16.7.tgz",
-            "integrity": "sha512-mBruRMbktKQwbxaJof32LT9KLy2f3gH+27a5XSuXo6h7R3vqltl0PgZ80C8ZMKw98Bf8bqt6BEVi3svOh2PzMw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-modules-amd": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.18.0.tgz",
-            "integrity": "sha512-h8FjOlYmdZwl7Xm2Ug4iX2j7Qy63NANI+NQVWQzv6r25fqgg7k2dZl03p95kvqNclglHs4FZ+isv4p1uXMA+QA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
-            }
-        },
-        "@babel/plugin-transform-modules-commonjs": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.18.2.tgz",
-            "integrity": "sha512-f5A865gFPAJAEE0K7F/+nm5CmAE3y8AWlMBG9unu5j9+tk50UQVK0QS8RNxSp7MJf0wh97uYyLWt3Zvu71zyOQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-simple-access": "^7.18.2",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
-            }
-        },
-        "@babel/plugin-transform-modules-systemjs": {
-            "version": "7.18.4",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.18.4.tgz",
-            "integrity": "sha512-lH2UaQaHVOAeYrUUuZ8i38o76J/FnO8vu21OE+tD1MyP9lxdZoSfz+pDbWkq46GogUrdrMz3tiz/FYGB+bVThg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-hoist-variables": "^7.16.7",
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-validator-identifier": "^7.16.7",
-                "babel-plugin-dynamic-import-node": "^2.3.3"
-            }
-        },
-        "@babel/plugin-transform-modules-umd": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.18.0.tgz",
-            "integrity": "sha512-d/zZ8I3BWli1tmROLxXLc9A6YXvGK8egMxHp+E/rRwMh1Kip0AP77VwZae3snEJ33iiWwvNv2+UIIhfalqhzZA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-module-transforms": "^7.18.0",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-named-capturing-groups-regex": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.17.12.tgz",
-            "integrity": "sha512-vWoWFM5CKaTeHrdUJ/3SIOTRV+MBVGybOC9mhJkaprGNt5demMymDW24yC74avb915/mIRe3TgNb/d8idvnCRA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-regexp-features-plugin": "^7.17.12",
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-new-target": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.17.12.tgz",
-            "integrity": "sha512-CaOtzk2fDYisbjAD4Sd1MTKGVIpRtx9bWLyj24Y/k6p4s4gQ3CqDGJauFJxt8M/LEx003d0i3klVqnN73qvK3w==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-object-super": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.16.7.tgz",
-            "integrity": "sha512-14J1feiQVWaGvRxj2WjyMuXS2jsBkgB3MdSN5HuC2G5nRspa5RK9COcs82Pwy5BuGcjb+fYaUj94mYcOj7rCvw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7",
-                "@babel/helper-replace-supers": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-parameters": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.17.12.tgz",
-            "integrity": "sha512-6qW4rWo1cyCdq1FkYri7AHpauchbGLXpdwnYsfxFb+KtddHENfsY5JZb35xUwkK5opOLcJ3BNd2l7PhRYGlwIA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-property-literals": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.16.7.tgz",
-            "integrity": "sha512-z4FGr9NMGdoIl1RqavCqGG+ZuYjfZ/hkCIeuH6Do7tXmSm0ls11nYVSJqFEUOSJbDab5wC6lRE/w6YjVcr6Hqw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-regenerator": {
-            "version": "7.18.0",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.18.0.tgz",
-            "integrity": "sha512-C8YdRw9uzx25HSIzwA7EM7YP0FhCe5wNvJbZzjVNHHPGVcDJ3Aie+qGYYdS1oVQgn+B3eAIJbWFLrJ4Jipv7nw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "regenerator-transform": "^0.15.0"
-            }
-        },
-        "@babel/plugin-transform-reserved-words": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.17.12.tgz",
-            "integrity": "sha512-1KYqwbJV3Co03NIi14uEHW8P50Md6KqFgt0FfpHdK6oyAHQVTosgPuPSiWud1HX0oYJ1hGRRlk0fP87jFpqXZA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-runtime": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.18.2.tgz",
-            "integrity": "sha512-mr1ufuRMfS52ttq+1G1PD8OJNqgcTFjq3hwn8SZ5n1x1pBhi0E36rYMdTK0TsKtApJ4lDEdfXJwtGobQMHSMPg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-module-imports": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "babel-plugin-polyfill-corejs2": "^0.3.0",
-                "babel-plugin-polyfill-corejs3": "^0.5.0",
-                "babel-plugin-polyfill-regenerator": "^0.3.0",
-                "semver": "^6.3.0"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "@babel/plugin-transform-shorthand-properties": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.16.7.tgz",
-            "integrity": "sha512-hah2+FEnoRoATdIb05IOXf+4GzXYTq75TVhIn1PewihbpyrNWUt2JbudKQOETWw6QpLe+AIUpJ5MVLYTQbeeUg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-spread": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.17.12.tgz",
-            "integrity": "sha512-9pgmuQAtFi3lpNUstvG9nGfk9DkrdmWNp9KeKPFmuZCpEnxRzYlS8JgwPjYj+1AWDOSvoGN0H30p1cBOmT/Svg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-skip-transparent-expression-wrappers": "^7.16.0"
-            }
-        },
-        "@babel/plugin-transform-sticky-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.16.7.tgz",
-            "integrity": "sha512-NJa0Bd/87QV5NZZzTuZG5BPJjLYadeSZ9fO6oOUoL4iQx+9EEuw/eEM92SrsT19Yc2jgB1u1hsjqDtH02c3Drw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-template-literals": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.18.2.tgz",
-            "integrity": "sha512-/cmuBVw9sZBGZVOMkpAEaVLwm4JmK2GZ1dFKOGGpMzEHWFmyZZ59lUU0PdRr8YNYeQdNzTDwuxP2X2gzydTc9g==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-typeof-symbol": {
-            "version": "7.17.12",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.17.12.tgz",
-            "integrity": "sha512-Q8y+Jp7ZdtSPXCThB6zjQ74N3lj0f6TDh1Hnf5B+sYlzQ8i5Pjp8gW0My79iekSpT4WnI06blqP6DT0OmaXXmw==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.17.12"
-            }
-        },
-        "@babel/plugin-transform-unicode-escapes": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.16.7.tgz",
-            "integrity": "sha512-TAV5IGahIz3yZ9/Hfv35TV2xEm+kaBDaZQCn2S/hG9/CZ0DktxJv9eKfPc7yYCvOYR4JGx1h8C+jcSOvgaaI/Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/plugin-transform-unicode-regex": {
-            "version": "7.16.7",
-            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.16.7.tgz",
-            "integrity": "sha512-oC5tYYKw56HO75KZVLQ+R/Nl3Hro9kf8iG0hXoaHP7tjAyCpvqBiSNe6vGrZni1Z6MggmUOC6A7VP7AVmw225Q==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-create-regexp-features-plugin": "^7.16.7",
-                "@babel/helper-plugin-utils": "^7.16.7"
-            }
-        },
-        "@babel/preset-env": {
-            "version": "7.18.2",
-            "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.18.2.tgz",
-            "integrity": "sha512-PfpdxotV6afmXMU47S08F9ZKIm2bJIQ0YbAAtDfIENX7G1NUAXigLREh69CWDjtgUy7dYn7bsMzkgdtAlmS68Q==",
-            "dev": true,
-            "requires": {
-                "@babel/compat-data": "^7.17.10",
-                "@babel/helper-compilation-targets": "^7.18.2",
-                "@babel/helper-plugin-utils": "^7.17.12",
-                "@babel/helper-validator-option": "^7.16.7",
-                "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.17.12",
-                "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.17.12",
-                "@babel/plugin-proposal-async-generator-functions": "^7.17.12",
-                "@babel/plugin-proposal-class-properties": "^7.17.12",
-                "@babel/plugin-proposal-class-static-block": "^7.18.0",
-                "@babel/plugin-proposal-dynamic-import": "^7.16.7",
-                "@babel/plugin-proposal-export-namespace-from": "^7.17.12",
-                "@babel/plugin-proposal-json-strings": "^7.17.12",
-                "@babel/plugin-proposal-logical-assignment-operators": "^7.17.12",
-                "@babel/plugin-proposal-nullish-coalescing-operator": "^7.17.12",
-                "@babel/plugin-proposal-numeric-separator": "^7.16.7",
-                "@babel/plugin-proposal-object-rest-spread": "^7.18.0",
-                "@babel/plugin-proposal-optional-catch-binding": "^7.16.7",
-                "@babel/plugin-proposal-optional-chaining": "^7.17.12",
-                "@babel/plugin-proposal-private-methods": "^7.17.12",
-                "@babel/plugin-proposal-private-property-in-object": "^7.17.12",
-                "@babel/plugin-proposal-unicode-property-regex": "^7.17.12",
-                "@babel/plugin-syntax-async-generators": "^7.8.4",
-                "@babel/plugin-syntax-class-properties": "^7.12.13",
-                "@babel/plugin-syntax-class-static-block": "^7.14.5",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-                "@babel/plugin-syntax-export-namespace-from": "^7.8.3",
-                "@babel/plugin-syntax-import-assertions": "^7.17.12",
-                "@babel/plugin-syntax-json-strings": "^7.8.3",
-                "@babel/plugin-syntax-logical-assignment-operators": "^7.10.4",
-                "@babel/plugin-syntax-nullish-coalescing-operator": "^7.8.3",
-                "@babel/plugin-syntax-numeric-separator": "^7.10.4",
-                "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
-                "@babel/plugin-syntax-optional-catch-binding": "^7.8.3",
-                "@babel/plugin-syntax-optional-chaining": "^7.8.3",
-                "@babel/plugin-syntax-private-property-in-object": "^7.14.5",
-                "@babel/plugin-syntax-top-level-await": "^7.14.5",
-                "@babel/plugin-transform-arrow-functions": "^7.17.12",
-                "@babel/plugin-transform-async-to-generator": "^7.17.12",
-                "@babel/plugin-transform-block-scoped-functions": "^7.16.7",
-                "@babel/plugin-transform-block-scoping": "^7.17.12",
-                "@babel/plugin-transform-classes": "^7.17.12",
-                "@babel/plugin-transform-computed-properties": "^7.17.12",
-                "@babel/plugin-transform-destructuring": "^7.18.0",
-                "@babel/plugin-transform-dotall-regex": "^7.16.7",
-                "@babel/plugin-transform-duplicate-keys": "^7.17.12",
-                "@babel/plugin-transform-exponentiation-operator": "^7.16.7",
-                "@babel/plugin-transform-for-of": "^7.18.1",
-                "@babel/plugin-transform-function-name": "^7.16.7",
-                "@babel/plugin-transform-literals": "^7.17.12",
-                "@babel/plugin-transform-member-expression-literals": "^7.16.7",
-                "@babel/plugin-transform-modules-amd": "^7.18.0",
-                "@babel/plugin-transform-modules-commonjs": "^7.18.2",
-                "@babel/plugin-transform-modules-systemjs": "^7.18.0",
-                "@babel/plugin-transform-modules-umd": "^7.18.0",
-                "@babel/plugin-transform-named-capturing-groups-regex": "^7.17.12",
-                "@babel/plugin-transform-new-target": "^7.17.12",
-                "@babel/plugin-transform-object-super": "^7.16.7",
-                "@babel/plugin-transform-parameters": "^7.17.12",
-                "@babel/plugin-transform-property-literals": "^7.16.7",
-                "@babel/plugin-transform-regenerator": "^7.18.0",
-                "@babel/plugin-transform-reserved-words": "^7.17.12",
-                "@babel/plugin-transform-shorthand-properties": "^7.16.7",
-                "@babel/plugin-transform-spread": "^7.17.12",
-                "@babel/plugin-transform-sticky-regex": "^7.16.7",
-                "@babel/plugin-transform-template-literals": "^7.18.2",
-                "@babel/plugin-transform-typeof-symbol": "^7.17.12",
-                "@babel/plugin-transform-unicode-escapes": "^7.16.7",
-                "@babel/plugin-transform-unicode-regex": "^7.16.7",
-                "@babel/preset-modules": "^0.1.5",
-                "@babel/types": "^7.18.2",
-                "babel-plugin-polyfill-corejs2": "^0.3.0",
-                "babel-plugin-polyfill-corejs3": "^0.5.0",
-                "babel-plugin-polyfill-regenerator": "^0.3.0",
-                "core-js-compat": "^3.22.1",
-                "semver": "^6.3.0"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "@babel/preset-modules": {
-            "version": "0.1.5",
-            "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.5.tgz",
-            "integrity": "sha512-A57th6YRG7oR3cq/yt/Y84MvGgE0eJG2F1JLhKuyG+jFxEgrd/HAMJatiFtmOiZurz+0DkrvbheCLaV5f2JfjA==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-plugin-utils": "^7.0.0",
-                "@babel/plugin-proposal-unicode-property-regex": "^7.4.4",
-                "@babel/plugin-transform-dotall-regex": "^7.4.4",
-                "@babel/types": "^7.4.4",
-                "esutils": "^2.0.2"
-            }
-        },
-        "@babel/runtime": {
-            "version": "7.18.3",
-            "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.18.3.tgz",
-            "integrity": "sha512-38Y8f7YUhce/K7RMwTp7m0uCumpv9hZkitCbBClqQIow1qSbCvGkcegKOXpEWCQLfWmevgRiWokZ1GkpfhbZug==",
-            "dev": true,
-            "requires": {
-                "regenerator-runtime": "^0.13.4"
-            }
-        },
-        "@babel/template": {
-            "version": "7.22.15",
-            "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.22.15.tgz",
-            "integrity": "sha512-QPErUVm4uyJa60rkI73qneDacvdvzxshT3kksGqlGWYdOTIUOwJ7RDUL8sGqslY1uXWSL6xMFKEXDS3ox2uF0w==",
-            "dev": true,
-            "requires": {
-                "@babel/code-frame": "^7.22.13",
-                "@babel/parser": "^7.22.15",
-                "@babel/types": "^7.22.15"
-            }
-        },
-        "@babel/traverse": {
-            "version": "7.23.2",
-            "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.23.2.tgz",
-            "integrity": "sha512-azpe59SQ48qG6nu2CzcMLbxUudtN+dOM9kDbUqGq3HXUJRlo7i8fvPoxQUzYgLZ4cMVmuZgm8vvBpNeRhd6XSw==",
-            "dev": true,
-            "requires": {
-                "@babel/code-frame": "^7.22.13",
-                "@babel/generator": "^7.23.0",
-                "@babel/helper-environment-visitor": "^7.22.20",
-                "@babel/helper-function-name": "^7.23.0",
-                "@babel/helper-hoist-variables": "^7.22.5",
-                "@babel/helper-split-export-declaration": "^7.22.6",
-                "@babel/parser": "^7.23.0",
-                "@babel/types": "^7.23.0",
-                "debug": "^4.1.0",
-                "globals": "^11.1.0"
-            }
-        },
-        "@babel/types": {
-            "version": "7.23.0",
-            "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.23.0.tgz",
-            "integrity": "sha512-0oIyUfKoI3mSqMvsxBdclDwxXKXAUA8v/apZbc+iSyARYou1o8ZGDxbUYyLFoW2arqS2jDGqJuZvv1d/io1axg==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-string-parser": "^7.22.5",
-                "@babel/helper-validator-identifier": "^7.22.20",
-                "to-fast-properties": "^2.0.0"
-            }
-        },
-        "@colors/colors": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
-            "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
-            "dev": true,
-            "optional": true
-        },
-        "@discoveryjs/json-ext": {
-            "version": "0.5.7",
-            "resolved": "https://registry.npmjs.org/@discoveryjs/json-ext/-/json-ext-0.5.7.tgz",
-            "integrity": "sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw==",
-            "dev": true
-        },
-        "@isaacs/cliui": {
-            "version": "8.0.2",
-            "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
-            "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
-            "dev": true,
-            "requires": {
-                "string-width": "^5.1.2",
-                "string-width-cjs": "npm:string-width@^4.2.0",
-                "strip-ansi": "^7.0.1",
-                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
-                "wrap-ansi": "^8.1.0",
-                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
-            },
-            "dependencies": {
-                "ansi-regex": {
-                    "version": "6.0.1",
-                    "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.0.1.tgz",
-                    "integrity": "sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA==",
-                    "dev": true
-                },
-                "ansi-styles": {
-                    "version": "6.2.1",
-                    "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
-                    "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
-                    "dev": true
-                },
-                "emoji-regex": {
-                    "version": "9.2.2",
-                    "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
-                    "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
-                    "dev": true
-                },
-                "string-width": {
-                    "version": "5.1.2",
-                    "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
-                    "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
-                    "dev": true,
-                    "requires": {
-                        "eastasianwidth": "^0.2.0",
-                        "emoji-regex": "^9.2.2",
-                        "strip-ansi": "^7.0.1"
-                    }
-                },
-                "strip-ansi": {
-                    "version": "7.1.0",
-                    "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
-                    "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
-                    "dev": true,
-                    "requires": {
-                        "ansi-regex": "^6.0.1"
-                    }
-                },
-                "wrap-ansi": {
-                    "version": "8.1.0",
-                    "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
-                    "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
-                    "dev": true,
-                    "requires": {
-                        "ansi-styles": "^6.1.0",
-                        "string-width": "^5.0.1",
-                        "strip-ansi": "^7.0.1"
-                    }
-                }
-            }
-        },
-        "@jridgewell/gen-mapping": {
-            "version": "0.1.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.1.1.tgz",
-            "integrity": "sha512-sQXCasFk+U8lWYEe66WxRDOE9PjVz4vSM51fTu3Hw+ClTpUSQb718772vH3pyS5pShp6lvQM7SxgIDXXXmOX7w==",
-            "dev": true,
-            "requires": {
-                "@jridgewell/set-array": "^1.0.0",
-                "@jridgewell/sourcemap-codec": "^1.4.10"
-            }
-        },
-        "@jridgewell/resolve-uri": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.1.tgz",
-            "integrity": "sha512-dSYZh7HhCDtCKm4QakX0xFpsRDqjjtZf/kjI/v3T3Nwt5r8/qz/M19F9ySyOqU94SXBmeG9ttTul+YnR4LOxFA==",
-            "dev": true
-        },
-        "@jridgewell/set-array": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz",
-            "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==",
-            "dev": true
-        },
-        "@jridgewell/source-map": {
-            "version": "0.3.6",
-            "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.6.tgz",
-            "integrity": "sha512-1ZJTZebgqllO79ue2bm3rIGud/bOe0pP5BjSRCRxxYkEZS8STV7zN84UBbiYu7jy+eCKSnVIUgoWWE/tt+shMQ==",
-            "dev": true,
-            "requires": {
-                "@jridgewell/gen-mapping": "^0.3.5",
-                "@jridgewell/trace-mapping": "^0.3.25"
-            },
-            "dependencies": {
-                "@jridgewell/gen-mapping": {
-                    "version": "0.3.5",
-                    "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz",
-                    "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==",
-                    "dev": true,
-                    "requires": {
-                        "@jridgewell/set-array": "^1.2.1",
-                        "@jridgewell/sourcemap-codec": "^1.4.10",
-                        "@jridgewell/trace-mapping": "^0.3.24"
-                    }
-                }
-            }
-        },
-        "@jridgewell/sourcemap-codec": {
-            "version": "1.4.15",
-            "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz",
-            "integrity": "sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg==",
-            "dev": true
-        },
-        "@jridgewell/trace-mapping": {
-            "version": "0.3.25",
-            "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz",
-            "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==",
-            "dev": true,
-            "requires": {
-                "@jridgewell/resolve-uri": "^3.1.0",
-                "@jridgewell/sourcemap-codec": "^1.4.14"
-            }
-        },
-        "@leichtgewicht/ip-codec": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/@leichtgewicht/ip-codec/-/ip-codec-2.0.4.tgz",
-            "integrity": "sha512-Hcv+nVC0kZnQ3tD9GVu5xSMR4VVYOteQIr/hwFPVEvPdlXqgGEuRjiheChHgdM+JyqdgNcmzZOX/tnl0JOiI7A==",
-            "dev": true
-        },
-        "@nodelib/fs.scandir": {
-            "version": "2.1.5",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
-            "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.stat": "2.0.5",
-                "run-parallel": "^1.1.9"
-            }
-        },
-        "@nodelib/fs.stat": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
-            "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
-            "dev": true
-        },
-        "@nodelib/fs.walk": {
-            "version": "1.2.8",
-            "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
-            "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.scandir": "2.1.5",
-                "fastq": "^1.6.0"
-            }
-        },
-        "@pkgjs/parseargs": {
-            "version": "0.11.0",
-            "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
-            "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
-            "dev": true,
-            "optional": true
-        },
-        "@tailwindcss/typography": {
-            "version": "0.5.15",
-            "resolved": "https://registry.npmjs.org/@tailwindcss/typography/-/typography-0.5.15.tgz",
-            "integrity": "sha512-AqhlCXl+8grUz8uqExv5OTtgpjuVIwFTSXTrh8y9/pw6q2ek7fJ+Y8ZEVw7EB2DCcuCOtEjf9w3+J3rzts01uA==",
-            "dev": true,
-            "requires": {
-                "lodash.castarray": "^4.4.0",
-                "lodash.isplainobject": "^4.0.6",
-                "lodash.merge": "^4.6.2",
-                "postcss-selector-parser": "6.0.10"
-            }
-        },
-        "@trysound/sax": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/@trysound/sax/-/sax-0.2.0.tgz",
-            "integrity": "sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA==",
-            "dev": true
-        },
-        "@types/babel__core": {
-            "version": "7.1.19",
-            "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.1.19.tgz",
-            "integrity": "sha512-WEOTgRsbYkvA/KCsDwVEGkd7WAr1e3g31VHQ8zy5gul/V1qKullU/BU5I68X5v7V3GnB9eotmom4v5a5gjxorw==",
-            "dev": true,
-            "requires": {
-                "@babel/parser": "^7.1.0",
-                "@babel/types": "^7.0.0",
-                "@types/babel__generator": "*",
-                "@types/babel__template": "*",
-                "@types/babel__traverse": "*"
-            }
-        },
-        "@types/babel__generator": {
-            "version": "7.6.4",
-            "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.6.4.tgz",
-            "integrity": "sha512-tFkciB9j2K755yrTALxD44McOrk+gfpIpvC3sxHjRawj6PfnQxrse4Clq5y/Rq+G3mrBurMax/lG8Qn2t9mSsg==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.0.0"
-            }
-        },
-        "@types/babel__template": {
-            "version": "7.4.1",
-            "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.1.tgz",
-            "integrity": "sha512-azBFKemX6kMg5Io+/rdGT0dkGreboUVR0Cdm3fz9QJWpaQGJRQXl7C+6hOTCZcMll7KFyEQpgbYI2lHdsS4U7g==",
-            "dev": true,
-            "requires": {
-                "@babel/parser": "^7.1.0",
-                "@babel/types": "^7.0.0"
-            }
-        },
-        "@types/babel__traverse": {
-            "version": "7.17.1",
-            "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.17.1.tgz",
-            "integrity": "sha512-kVzjari1s2YVi77D3w1yuvohV2idweYXMCDzqBiVNN63TcDWrIlTVOYpqVrvbbyOE/IyzBoTKF0fdnLPEORFxA==",
-            "dev": true,
-            "requires": {
-                "@babel/types": "^7.3.0"
-            }
-        },
-        "@types/body-parser": {
-            "version": "1.19.2",
-            "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.2.tgz",
-            "integrity": "sha512-ALYone6pm6QmwZoAgeyNksccT9Q4AWZQ6PvfwR37GT6r6FWUPguq6sUmNGSMV2Wr761oQoBxwGGa6DR5o1DC9g==",
-            "dev": true,
-            "requires": {
-                "@types/connect": "*",
-                "@types/node": "*"
-            }
-        },
-        "@types/bonjour": {
-            "version": "3.5.10",
-            "resolved": "https://registry.npmjs.org/@types/bonjour/-/bonjour-3.5.10.tgz",
-            "integrity": "sha512-p7ienRMiS41Nu2/igbJxxLDWrSZ0WxM8UQgCeO9KhoVF7cOVFkrKsiDr1EsJIla8vV3oEEjGcz11jc5yimhzZw==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@types/clean-css": {
-            "version": "4.2.5",
-            "resolved": "https://registry.npmjs.org/@types/clean-css/-/clean-css-4.2.5.tgz",
-            "integrity": "sha512-NEzjkGGpbs9S9fgC4abuBvTpVwE3i+Acu9BBod3PUyjDVZcNsGx61b8r2PphR61QGPnn0JHVs5ey6/I4eTrkxw==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*",
-                "source-map": "^0.6.0"
-            }
-        },
-        "@types/connect": {
-            "version": "3.4.35",
-            "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.35.tgz",
-            "integrity": "sha512-cdeYyv4KWoEgpBISTxWvqYsVy444DOqehiF3fM3ne10AmJ62RSyNkUnxMJXHQWRQQX2eR94m5y1IZyDwBjV9FQ==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@types/connect-history-api-fallback": {
-            "version": "1.3.5",
-            "resolved": "https://registry.npmjs.org/@types/connect-history-api-fallback/-/connect-history-api-fallback-1.3.5.tgz",
-            "integrity": "sha512-h8QJa8xSb1WD4fpKBDcATDNGXghFj6/3GRWG6dhmRcu0RX1Ubasur2Uvx5aeEwlf0MwblEC2bMzzMQntxnw/Cw==",
-            "dev": true,
-            "requires": {
-                "@types/express-serve-static-core": "*",
-                "@types/node": "*"
-            }
-        },
-        "@types/estree": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.5.tgz",
-            "integrity": "sha512-/kYRxGDLWzHOB7q+wtSUQlFrtcdUccpfy+X+9iMBpHK8QLLhx2wIPYuS5DYtR9Wa/YlZAbIovy7qVdB1Aq6Lyw==",
-            "dev": true
-        },
-        "@types/express": {
-            "version": "4.17.13",
-            "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.13.tgz",
-            "integrity": "sha512-6bSZTPaTIACxn48l50SR+axgrqm6qXFIxrdAKaG6PaJk3+zuUr35hBlgT7vOmJcum+OEaIBLtHV/qloEAFITeA==",
-            "dev": true,
-            "requires": {
-                "@types/body-parser": "*",
-                "@types/express-serve-static-core": "^4.17.18",
-                "@types/qs": "*",
-                "@types/serve-static": "*"
-            }
-        },
-        "@types/express-serve-static-core": {
-            "version": "4.17.29",
-            "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.17.29.tgz",
-            "integrity": "sha512-uMd++6dMKS32EOuw1Uli3e3BPgdLIXmezcfHv7N4c1s3gkhikBplORPpMq3fuWkxncZN1reb16d5n8yhQ80x7Q==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*",
-                "@types/qs": "*",
-                "@types/range-parser": "*"
-            }
-        },
-        "@types/glob": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/@types/glob/-/glob-7.2.0.tgz",
-            "integrity": "sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==",
-            "dev": true,
-            "requires": {
-                "@types/minimatch": "*",
-                "@types/node": "*"
-            }
-        },
-        "@types/http-proxy": {
-            "version": "1.17.9",
-            "resolved": "https://registry.npmjs.org/@types/http-proxy/-/http-proxy-1.17.9.tgz",
-            "integrity": "sha512-QsbSjA/fSk7xB+UXlCT3wHBy5ai9wOcNDWwZAtud+jXhwOM3l+EYZh8Lng4+/6n8uar0J7xILzqftJdJ/Wdfkw==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@types/imagemin": {
-            "version": "8.0.0",
-            "resolved": "https://registry.npmjs.org/@types/imagemin/-/imagemin-8.0.0.tgz",
-            "integrity": "sha512-B9X2CUeDv/uUeY9CqkzSTfmsLkeJP6PkmXlh4lODBbf9SwpmNuLS30WzUOi863dgsjY3zt3gY5q2F+UdifRi1A==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@types/imagemin-gifsicle": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-gifsicle/-/imagemin-gifsicle-7.0.1.tgz",
-            "integrity": "sha512-kUz6sUh0P95JOS0RGEaaemWUrASuw+dLsWIveK2UZJx74id/B9epgblMkCk/r5MjUWbZ83wFvacG5Rb/f97gyA==",
-            "dev": true,
-            "requires": {
-                "@types/imagemin": "*"
-            }
-        },
-        "@types/imagemin-mozjpeg": {
-            "version": "8.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-mozjpeg/-/imagemin-mozjpeg-8.0.1.tgz",
-            "integrity": "sha512-kMQWEoKxxhlnH4POI3qfW9DjXlQfi80ux3l2b3j5R3eudSCoUIzKQLkfMjNJ6eMYnMWBcB+rfQOWqIzdIwFGKw==",
-            "dev": true,
-            "requires": {
-                "@types/imagemin": "*"
-            }
-        },
-        "@types/imagemin-optipng": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-optipng/-/imagemin-optipng-5.2.1.tgz",
-            "integrity": "sha512-XCM/3q+HUL7v4zOqMI+dJ5dTxT+MUukY9KU49DSnYb/4yWtSMHJyADP+WHSMVzTR63J2ZvfUOzSilzBNEQW78g==",
-            "dev": true,
-            "requires": {
-                "@types/imagemin": "*"
-            }
-        },
-        "@types/imagemin-svgo": {
-            "version": "8.0.1",
-            "resolved": "https://registry.npmjs.org/@types/imagemin-svgo/-/imagemin-svgo-8.0.1.tgz",
-            "integrity": "sha512-YafkdrVAcr38U0Ln1C+L1n4SIZqC47VBHTyxCq7gTUSd1R9MdIvMcrljWlgU1M9O68WZDeQWUrKipKYfEOCOvQ==",
-            "dev": true,
-            "requires": {
-                "@types/imagemin": "*",
-                "@types/svgo": "^1"
-            }
-        },
-        "@types/json-schema": {
-            "version": "7.0.11",
-            "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.11.tgz",
-            "integrity": "sha512-wOuvG1SN4Us4rez+tylwwwCV1psiNVOkJeM3AUWUNWg/jDQY2+HE/444y5gc+jBmRqASOm2Oeh5c1axHobwRKQ==",
-            "dev": true
-        },
-        "@types/mime": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.2.tgz",
-            "integrity": "sha512-YATxVxgRqNH6nHEIsvg6k2Boc1JHI9ZbH5iWFFv/MTkchz3b1ieGDa5T0a9RznNdI0KhVbdbWSN+KWWrQZRxTw==",
-            "dev": true
-        },
-        "@types/minimatch": {
-            "version": "3.0.5",
-            "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-3.0.5.tgz",
-            "integrity": "sha512-Klz949h02Gz2uZCMGwDUSDS1YBlTdDDgbWHi+81l29tQALUtvz4rAYi5uoVhE5Lagoq6DeqAUlbrHvW/mXDgdQ==",
-            "dev": true
-        },
-        "@types/node": {
-            "version": "18.0.6",
-            "resolved": "https://registry.npmjs.org/@types/node/-/node-18.0.6.tgz",
-            "integrity": "sha512-/xUq6H2aQm261exT6iZTMifUySEt4GR5KX8eYyY+C4MSNPqSh9oNIP7tz2GLKTlFaiBbgZNxffoR3CVRG+cljw==",
-            "dev": true
-        },
-        "@types/parse-json": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/@types/parse-json/-/parse-json-4.0.0.tgz",
-            "integrity": "sha512-//oorEZjL6sbPcKUaCdIGlIUeH26mgzimjBB77G6XRgnDl/L5wOnpyBGRe/Mmf5CVW3PwEBE1NjiMZ/ssFh4wA==",
-            "dev": true
-        },
-        "@types/qs": {
-            "version": "6.9.7",
-            "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.7.tgz",
-            "integrity": "sha512-FGa1F62FT09qcrueBA6qYTrJPVDzah9a+493+o2PCXsesWHIn27G98TsSMs3WPNbZIEj4+VJf6saSFpvD+3Zsw==",
-            "dev": true
-        },
-        "@types/range-parser": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.4.tgz",
-            "integrity": "sha512-EEhsLsD6UsDM1yFhAvy0Cjr6VwmpMWqFBCb9w07wVugF7w9nfajxLuVmngTIpgS6svCnm6Vaw+MZhoDCKnOfsw==",
-            "dev": true
-        },
-        "@types/retry": {
-            "version": "0.12.0",
-            "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",
-            "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",
-            "dev": true
-        },
-        "@types/serve-index": {
-            "version": "1.9.1",
-            "resolved": "https://registry.npmjs.org/@types/serve-index/-/serve-index-1.9.1.tgz",
-            "integrity": "sha512-d/Hs3nWDxNL2xAczmOVZNj92YZCS6RGxfBPjKzuu/XirCgXdpKEb88dYNbrYGint6IVWLNP+yonwVAuRC0T2Dg==",
-            "dev": true,
-            "requires": {
-                "@types/express": "*"
-            }
-        },
-        "@types/serve-static": {
-            "version": "1.13.10",
-            "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.13.10.tgz",
-            "integrity": "sha512-nCkHGI4w7ZgAdNkrEu0bv+4xNV/XDqW+DydknebMOQwkpDGx8G+HTlj7R7ABI8i8nKxVw0wtKPi1D+lPOkh4YQ==",
-            "dev": true,
-            "requires": {
-                "@types/mime": "^1",
-                "@types/node": "*"
-            }
-        },
-        "@types/sockjs": {
-            "version": "0.3.33",
-            "resolved": "https://registry.npmjs.org/@types/sockjs/-/sockjs-0.3.33.tgz",
-            "integrity": "sha512-f0KEEe05NvUnat+boPTZ0dgaLZ4SfSouXUgv5noUiefG2ajgKjmETo9ZJyuqsl7dfl2aHlLJUiki6B4ZYldiiw==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@types/svgo": {
-            "version": "1.3.6",
-            "resolved": "https://registry.npmjs.org/@types/svgo/-/svgo-1.3.6.tgz",
-            "integrity": "sha512-AZU7vQcy/4WFEuwnwsNsJnFwupIpbllH1++LXScN6uxT1Z4zPzdrWG97w4/I7eFKFTvfy/bHFStWjdBAg2Vjug==",
-            "dev": true
-        },
-        "@types/ws": {
-            "version": "8.5.3",
-            "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.5.3.tgz",
-            "integrity": "sha512-6YOoWjruKj1uLf3INHH7D3qTXwFfEsg1kf3c0uDdSBJwfa/llkwIjrAGV7j7mVgGNbzTQ3HiHKKDXl6bJPD97w==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*"
-            }
-        },
-        "@webassemblyjs/ast": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.12.1.tgz",
-            "integrity": "sha512-EKfMUOPRRUTy5UII4qJDGPpqfwjOmZ5jeGFwid9mnoqIFK+e0vqoi1qH56JpmZSzEL53jKnNzScdmftJyG5xWg==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/helper-numbers": "1.11.6",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6"
-            }
-        },
-        "@webassemblyjs/floating-point-hex-parser": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.11.6.tgz",
-            "integrity": "sha512-ejAj9hfRJ2XMsNHk/v6Fu2dGS+i4UaXBXGemOfQ/JfQ6mdQg/WXtwleQRLLS4OvfDhv8rYnVwH27YJLMyYsxhw==",
-            "dev": true
-        },
-        "@webassemblyjs/helper-api-error": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.11.6.tgz",
-            "integrity": "sha512-o0YkoP4pVu4rN8aTJgAyj9hC2Sv5UlkzCHhxqWj8butaLvnpdc2jOwh4ewE6CX0txSfLn/UYaV/pheS2Txg//Q==",
-            "dev": true
-        },
-        "@webassemblyjs/helper-buffer": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.12.1.tgz",
-            "integrity": "sha512-nzJwQw99DNDKr9BVCOZcLuJJUlqkJh+kVzVl6Fmq/tI5ZtEyWT1KZMyOXltXLZJmDtvLCDgwsyrkohEtopTXCw==",
-            "dev": true
-        },
-        "@webassemblyjs/helper-numbers": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.11.6.tgz",
-            "integrity": "sha512-vUIhZ8LZoIWHBohiEObxVm6hwP034jwmc9kuq5GdHZH0wiLVLIPcMCdpJzG4C11cHoQ25TFIQj9kaVADVX7N3g==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/floating-point-hex-parser": "1.11.6",
-                "@webassemblyjs/helper-api-error": "1.11.6",
-                "@xtuc/long": "4.2.2"
-            }
-        },
-        "@webassemblyjs/helper-wasm-bytecode": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.11.6.tgz",
-            "integrity": "sha512-sFFHKwcmBprO9e7Icf0+gddyWYDViL8bpPjJJl0WHxCdETktXdmtWLGVzoHbqUcY4Be1LkNfwTmXOJUFZYSJdA==",
-            "dev": true
-        },
-        "@webassemblyjs/helper-wasm-section": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.12.1.tgz",
-            "integrity": "sha512-Jif4vfB6FJlUlSbgEMHUyk1j234GTNG9dBJ4XJdOySoj518Xj0oGsNi59cUQF4RRMS9ouBUxDDdyBVfPTypa5g==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/wasm-gen": "1.12.1"
-            }
-        },
-        "@webassemblyjs/ieee754": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.11.6.tgz",
-            "integrity": "sha512-LM4p2csPNvbij6U1f19v6WR56QZ8JcHg3QIJTlSwzFcmx6WSORicYj6I63f9yU1kEUtrpG+kjkiIAkevHpDXrg==",
-            "dev": true,
-            "requires": {
-                "@xtuc/ieee754": "^1.2.0"
-            }
-        },
-        "@webassemblyjs/leb128": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.11.6.tgz",
-            "integrity": "sha512-m7a0FhE67DQXgouf1tbN5XQcdWoNgaAuoULHIfGFIEVKA6tu/edls6XnIlkmS6FrXAquJRPni3ZZKjw6FSPjPQ==",
-            "dev": true,
-            "requires": {
-                "@xtuc/long": "4.2.2"
-            }
-        },
-        "@webassemblyjs/utf8": {
-            "version": "1.11.6",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.11.6.tgz",
-            "integrity": "sha512-vtXf2wTQ3+up9Zsg8sa2yWiQpzSsMyXj0qViVP6xKGCUT8p8YJ6HqI7l5eCnWx1T/FYdsv07HQs2wTFbbof/RA==",
-            "dev": true
-        },
-        "@webassemblyjs/wasm-edit": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.12.1.tgz",
-            "integrity": "sha512-1DuwbVvADvS5mGnXbE+c9NfA8QRcZ6iKquqjjmR10k6o+zzsRVesil54DKexiowcFCPdr/Q0qaMgB01+SQ1u6g==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/helper-wasm-section": "1.12.1",
-                "@webassemblyjs/wasm-gen": "1.12.1",
-                "@webassemblyjs/wasm-opt": "1.12.1",
-                "@webassemblyjs/wasm-parser": "1.12.1",
-                "@webassemblyjs/wast-printer": "1.12.1"
-            }
-        },
-        "@webassemblyjs/wasm-gen": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.12.1.tgz",
-            "integrity": "sha512-TDq4Ojh9fcohAw6OIMXqiIcTq5KUXTGRkVxbSo1hQnSy6lAM5GSdfwWeSxpAo0YzgsgF182E/U0mDNhuA0tW7w==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/ieee754": "1.11.6",
-                "@webassemblyjs/leb128": "1.11.6",
-                "@webassemblyjs/utf8": "1.11.6"
-            }
-        },
-        "@webassemblyjs/wasm-opt": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.12.1.tgz",
-            "integrity": "sha512-Jg99j/2gG2iaz3hijw857AVYekZe2SAskcqlWIZXjji5WStnOpVoat3gQfT/Q5tb2djnCjBtMocY/Su1GfxPBg==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-buffer": "1.12.1",
-                "@webassemblyjs/wasm-gen": "1.12.1",
-                "@webassemblyjs/wasm-parser": "1.12.1"
-            }
-        },
-        "@webassemblyjs/wasm-parser": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.12.1.tgz",
-            "integrity": "sha512-xikIi7c2FHXysxXe3COrVUPSheuBtpcfhbpFj4gmu7KRLYOzANztwUU0IbsqvMqzuNK2+glRGWCEqZo1WCLyAQ==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@webassemblyjs/helper-api-error": "1.11.6",
-                "@webassemblyjs/helper-wasm-bytecode": "1.11.6",
-                "@webassemblyjs/ieee754": "1.11.6",
-                "@webassemblyjs/leb128": "1.11.6",
-                "@webassemblyjs/utf8": "1.11.6"
-            }
-        },
-        "@webassemblyjs/wast-printer": {
-            "version": "1.12.1",
-            "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.12.1.tgz",
-            "integrity": "sha512-+X4WAlOisVWQMikjbcvY2e0rwPsKQ9F688lksZhBcPycBBuii3O7m8FACbDMWDojpAqvjIncrG8J0XHKyQfVeA==",
-            "dev": true,
-            "requires": {
-                "@webassemblyjs/ast": "1.12.1",
-                "@xtuc/long": "4.2.2"
-            }
-        },
-        "@webpack-cli/configtest": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/configtest/-/configtest-1.2.0.tgz",
-            "integrity": "sha512-4FB8Tj6xyVkyqjj1OaTqCjXYULB9FMkqQ8yGrZjRDrYh0nOE+7Lhs45WioWQQMV+ceFlE368Ukhe6xdvJM9Egg==",
-            "dev": true,
-            "requires": {}
-        },
-        "@webpack-cli/info": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/info/-/info-1.5.0.tgz",
-            "integrity": "sha512-e8tSXZpw2hPl2uMJY6fsMswaok5FdlGNRTktvFk2sD8RjH0hE2+XistawJx1vmKteh4NmGmNUrp+Tb2w+udPcQ==",
-            "dev": true,
-            "requires": {
-                "envinfo": "^7.7.3"
-            }
-        },
-        "@webpack-cli/serve": {
-            "version": "1.7.0",
-            "resolved": "https://registry.npmjs.org/@webpack-cli/serve/-/serve-1.7.0.tgz",
-            "integrity": "sha512-oxnCNGj88fL+xzV+dacXs44HcDwf1ovs3AuEzvP7mqXw7fQntqIhQ1BRmynh4qEKQSSSRSWVyXRjmTbZIX9V2Q==",
-            "dev": true,
-            "requires": {}
-        },
-        "@xtuc/ieee754": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz",
-            "integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==",
-            "dev": true
-        },
-        "@xtuc/long": {
-            "version": "4.2.2",
-            "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz",
-            "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==",
-            "dev": true
-        },
-        "accepts": {
-            "version": "1.3.8",
-            "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
-            "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
-            "dev": true,
-            "requires": {
-                "mime-types": "~2.1.34",
-                "negotiator": "0.6.3"
-            }
-        },
-        "acorn": {
-            "version": "8.12.1",
-            "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.12.1.tgz",
-            "integrity": "sha512-tcpGyI9zbizT9JbV6oYE477V6mTlXvvi0T0G3SNIYE2apm/G5huBa1+K89VGeovbg+jycCrfhl3ADxErOuO6Jg==",
-            "dev": true
-        },
-        "acorn-import-attributes": {
-            "version": "1.9.5",
-            "resolved": "https://registry.npmjs.org/acorn-import-attributes/-/acorn-import-attributes-1.9.5.tgz",
-            "integrity": "sha512-n02Vykv5uA3eHGM/Z2dQrcD56kL8TyDb2p1+0P83PClMnC/nc+anbQRhIOWnSq4Ke/KvDPrY3C9hDtC/A3eHnQ==",
-            "dev": true,
-            "requires": {}
-        },
-        "ajv": {
-            "version": "6.12.6",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
-            "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
-            "dev": true,
-            "requires": {
-                "fast-deep-equal": "^3.1.1",
-                "fast-json-stable-stringify": "^2.0.0",
-                "json-schema-traverse": "^0.4.1",
-                "uri-js": "^4.2.2"
-            }
-        },
-        "ajv-formats": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz",
-            "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==",
-            "dev": true,
-            "requires": {
-                "ajv": "^8.0.0"
-            },
-            "dependencies": {
-                "ajv": {
-                    "version": "8.11.0",
-                    "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-                    "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-                    "dev": true,
-                    "requires": {
-                        "fast-deep-equal": "^3.1.1",
-                        "json-schema-traverse": "^1.0.0",
-                        "require-from-string": "^2.0.2",
-                        "uri-js": "^4.2.2"
-                    }
-                },
-                "json-schema-traverse": {
-                    "version": "1.0.0",
-                    "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-                    "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-                    "dev": true
-                }
-            }
-        },
-        "ajv-keywords": {
-            "version": "3.5.2",
-            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.5.2.tgz",
-            "integrity": "sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==",
-            "dev": true,
-            "requires": {}
-        },
-        "ansi-html-community": {
-            "version": "0.0.8",
-            "resolved": "https://registry.npmjs.org/ansi-html-community/-/ansi-html-community-0.0.8.tgz",
-            "integrity": "sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw==",
-            "dev": true
-        },
-        "ansi-regex": {
-            "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
-            "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
-            "dev": true
-        },
-        "ansi-styles": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
-            "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
-            "dev": true,
-            "requires": {
-                "color-convert": "^2.0.1"
-            },
-            "dependencies": {
-                "color-convert": {
-                    "version": "2.0.1",
-                    "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
-                    "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
-                    "dev": true,
-                    "requires": {
-                        "color-name": "~1.1.4"
-                    }
-                }
-            }
-        },
-        "any-promise": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
-            "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==",
-            "dev": true
-        },
-        "anymatch": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.2.tgz",
-            "integrity": "sha512-P43ePfOAIupkguHUycrc4qJ9kz8ZiuOUijaETwX7THt0Y/GNK7v0aa8rY816xWjZ7rJdA5XdMcpVFTKMq+RvWg==",
-            "dev": true,
-            "requires": {
-                "normalize-path": "^3.0.0",
-                "picomatch": "^2.0.4"
-            }
-        },
-        "arg": {
-            "version": "5.0.2",
-            "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
-            "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
-            "dev": true
-        },
-        "array-flatten": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-2.1.2.tgz",
-            "integrity": "sha512-hNfzcOV8W4NdualtqBFPyVO+54DSJuZGY9qT4pRroB6S9e3iiido2ISIC5h9R2sPJ8H3FHCIiEnsv1lPXO3KtQ==",
-            "dev": true
-        },
-        "array-union": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
-            "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
-            "dev": true
-        },
-        "asn1.js": {
-            "version": "5.4.1",
-            "resolved": "https://registry.npmjs.org/asn1.js/-/asn1.js-5.4.1.tgz",
-            "integrity": "sha512-+I//4cYPccV8LdmBLiX8CYvf9Sp3vQsrqu2QNXRcrbiWvcx/UdlFiqUJJzxRQxgsZmvhXhn4cSKeSmoFjVdupA==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^4.0.0",
-                "inherits": "^2.0.1",
-                "minimalistic-assert": "^1.0.0",
-                "safer-buffer": "^2.1.0"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
-            }
-        },
-        "assert": {
-            "version": "1.5.0",
-            "resolved": "https://registry.npmjs.org/assert/-/assert-1.5.0.tgz",
-            "integrity": "sha512-EDsgawzwoun2CZkCgtxJbv392v4nbk9XDD06zI+kQYoBM/3RBWLlEyJARDOmhAAosBjWACEkKL6S+lIZtcAubA==",
-            "dev": true,
-            "requires": {
-                "object-assign": "^4.1.1",
-                "util": "0.10.3"
-            },
-            "dependencies": {
-                "inherits": {
-                    "version": "2.0.1",
-                    "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.1.tgz",
-                    "integrity": "sha512-8nWq2nLTAwd02jTqJExUYFSD/fKq6VH9Y/oG2accc/kdI0V98Bag8d5a4gi3XHz73rDWa2PvTtvcWYquKqSENA==",
-                    "dev": true
-                },
-                "util": {
-                    "version": "0.10.3",
-                    "resolved": "https://registry.npmjs.org/util/-/util-0.10.3.tgz",
-                    "integrity": "sha512-5KiHfsmkqacuKjkRkdV7SsfDJ2EGiPsK92s2MhNSY0craxjTdKTtqKsJaCWp4LW33ZZ0OPUv1WO/TFvNQRiQxQ==",
-                    "dev": true,
-                    "requires": {
-                        "inherits": "2.0.1"
-                    }
-                }
-            }
-        },
-        "autoprefixer": {
-            "version": "10.4.20",
-            "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.20.tgz",
-            "integrity": "sha512-XY25y5xSv/wEoqzDyXXME4AFfkZI0P23z6Fs3YgymDnKJkCGOnkL0iTxCa85UTqaSgfcqyf3UA6+c7wUvx/16g==",
-            "dev": true,
-            "requires": {
-                "browserslist": "^4.23.3",
-                "caniuse-lite": "^1.0.30001646",
-                "fraction.js": "^4.3.7",
-                "normalize-range": "^0.1.2",
-                "picocolors": "^1.0.1",
-                "postcss-value-parser": "^4.2.0"
-            }
-        },
-        "babel-loader": {
-            "version": "8.2.5",
-            "resolved": "https://registry.npmjs.org/babel-loader/-/babel-loader-8.2.5.tgz",
-            "integrity": "sha512-OSiFfH89LrEMiWd4pLNqGz4CwJDtbs2ZVc+iGu2HrkRfPxId9F2anQj38IxWpmRfsUY0aBZYi1EFcd3mhtRMLQ==",
-            "dev": true,
-            "requires": {
-                "find-cache-dir": "^3.3.1",
-                "loader-utils": "^2.0.0",
-                "make-dir": "^3.1.0",
-                "schema-utils": "^2.6.5"
-            }
-        },
-        "babel-plugin-dynamic-import-node": {
-            "version": "2.3.3",
-            "resolved": "https://registry.npmjs.org/babel-plugin-dynamic-import-node/-/babel-plugin-dynamic-import-node-2.3.3.tgz",
-            "integrity": "sha512-jZVI+s9Zg3IqA/kdi0i6UDCybUI3aSBLnglhYbSSjKlV7yF1F/5LWv8MakQmvYpnbJDS6fcBL2KzHSxNCMtWSQ==",
-            "dev": true,
-            "requires": {
-                "object.assign": "^4.1.0"
-            }
-        },
-        "babel-plugin-polyfill-corejs2": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.3.1.tgz",
-            "integrity": "sha512-v7/T6EQcNfVLfcN2X8Lulb7DjprieyLWJK/zOWH5DUYcAgex9sP3h25Q+DLsX9TloXe3y1O8l2q2Jv9q8UVB9w==",
-            "dev": true,
-            "requires": {
-                "@babel/compat-data": "^7.13.11",
-                "@babel/helper-define-polyfill-provider": "^0.3.1",
-                "semver": "^6.1.1"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "babel-plugin-polyfill-corejs3": {
-            "version": "0.5.2",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.5.2.tgz",
-            "integrity": "sha512-G3uJih0XWiID451fpeFaYGVuxHEjzKTHtc9uGFEjR6hHrvNzeS/PX+LLLcetJcytsB5m4j+K3o/EpXJNb/5IEQ==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-define-polyfill-provider": "^0.3.1",
-                "core-js-compat": "^3.21.0"
-            }
-        },
-        "babel-plugin-polyfill-regenerator": {
-            "version": "0.3.1",
-            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.3.1.tgz",
-            "integrity": "sha512-Y2B06tvgHYt1x0yz17jGkGeeMr5FeKUu+ASJ+N6nB5lQ8Dapfg42i0OVrf8PNGJ3zKL4A23snMi1IRwrqqND7A==",
-            "dev": true,
-            "requires": {
-                "@babel/helper-define-polyfill-provider": "^0.3.1"
-            }
-        },
-        "balanced-match": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
-            "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
-            "dev": true
-        },
-        "base64-js": {
-            "version": "1.5.1",
-            "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
-            "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
-            "dev": true
-        },
-        "batch": {
-            "version": "0.6.1",
-            "resolved": "https://registry.npmjs.org/batch/-/batch-0.6.1.tgz",
-            "integrity": "sha512-x+VAiMRL6UPkx+kudNvxTl6hB2XNNCG2r+7wixVfIYwu/2HKRXimwQyaumLjMveWvT2Hkd/cAJw+QBMfJ/EKVw==",
-            "dev": true
-        },
-        "big.js": {
-            "version": "5.2.2",
-            "resolved": "https://registry.npmjs.org/big.js/-/big.js-5.2.2.tgz",
-            "integrity": "sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ==",
-            "dev": true
-        },
-        "binary-extensions": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.2.0.tgz",
-            "integrity": "sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==",
-            "dev": true
-        },
-        "bn.js": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.1.tgz",
-            "integrity": "sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==",
-            "dev": true
-        },
-        "body-parser": {
-            "version": "1.20.3",
-            "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz",
-            "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==",
-            "dev": true,
-            "requires": {
-                "bytes": "3.1.2",
-                "content-type": "~1.0.5",
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "destroy": "1.2.0",
-                "http-errors": "2.0.0",
-                "iconv-lite": "0.4.24",
-                "on-finished": "2.4.1",
-                "qs": "6.13.0",
-                "raw-body": "2.5.2",
-                "type-is": "~1.6.18",
-                "unpipe": "1.0.0"
-            },
-            "dependencies": {
-                "bytes": {
-                    "version": "3.1.2",
-                    "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
-                    "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
-                    "dev": true
-                },
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-                    "dev": true,
-                    "requires": {
-                        "ms": "2.0.0"
-                    }
-                },
-                "ms": {
-                    "version": "2.0.0",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                    "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                    "dev": true
-                }
-            }
-        },
-        "bonjour-service": {
-            "version": "1.0.13",
-            "resolved": "https://registry.npmjs.org/bonjour-service/-/bonjour-service-1.0.13.tgz",
-            "integrity": "sha512-LWKRU/7EqDUC9CTAQtuZl5HzBALoCYwtLhffW3et7vZMwv3bWLpJf8bRYlMD5OCcDpTfnPgNCV4yo9ZIaJGMiA==",
-            "dev": true,
-            "requires": {
-                "array-flatten": "^2.1.2",
-                "dns-equal": "^1.0.0",
-                "fast-deep-equal": "^3.1.3",
-                "multicast-dns": "^7.2.5"
-            }
-        },
-        "boolbase": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
-            "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
-            "dev": true
-        },
-        "brace-expansion": {
-            "version": "1.1.11",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
-            "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
-            "dev": true,
-            "requires": {
-                "balanced-match": "^1.0.0",
-                "concat-map": "0.0.1"
-            }
-        },
-        "braces": {
-            "version": "3.0.3",
-            "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-            "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-            "dev": true,
-            "requires": {
-                "fill-range": "^7.1.1"
-            }
-        },
-        "brorand": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
-            "integrity": "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==",
-            "dev": true
-        },
-        "browserify-aes": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
-            "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
-            "dev": true,
-            "requires": {
-                "buffer-xor": "^1.0.3",
-                "cipher-base": "^1.0.0",
-                "create-hash": "^1.1.0",
-                "evp_bytestokey": "^1.0.3",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
-            }
-        },
-        "browserify-cipher": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/browserify-cipher/-/browserify-cipher-1.0.1.tgz",
-            "integrity": "sha512-sPhkz0ARKbf4rRQt2hTpAHqn47X3llLkUGn+xEJzLjwY8LRs2p0v7ljvI5EyoRO/mexrNunNECisZs+gw2zz1w==",
-            "dev": true,
-            "requires": {
-                "browserify-aes": "^1.0.4",
-                "browserify-des": "^1.0.0",
-                "evp_bytestokey": "^1.0.0"
-            }
-        },
-        "browserify-des": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.2.tgz",
-            "integrity": "sha512-BioO1xf3hFwz4kc6iBhI3ieDFompMhrMlnDFC4/0/vd5MokpuAc3R+LYbwTA9A5Yc9pq9UYPqffKpW2ObuwX5A==",
-            "dev": true,
-            "requires": {
-                "cipher-base": "^1.0.1",
-                "des.js": "^1.0.0",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            }
-        },
-        "browserify-rsa": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/browserify-rsa/-/browserify-rsa-4.1.0.tgz",
-            "integrity": "sha512-AdEER0Hkspgno2aR97SAf6vi0y0k8NuOpGnVH3O99rcA5Q6sh8QxcngtHuJ6uXwnfAXNM4Gn1Gb7/MV1+Ymbog==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^5.0.0",
-                "randombytes": "^2.0.1"
-            }
-        },
-        "browserify-sign": {
-            "version": "4.2.2",
-            "resolved": "https://registry.npmjs.org/browserify-sign/-/browserify-sign-4.2.2.tgz",
-            "integrity": "sha512-1rudGyeYY42Dk6texmv7c4VcQ0EsvVbLwZkA+AQB7SxvXxmcD93jcHie8bzecJ+ChDlmAm2Qyu0+Ccg5uhZXCg==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^5.2.1",
-                "browserify-rsa": "^4.1.0",
-                "create-hash": "^1.2.0",
-                "create-hmac": "^1.1.7",
-                "elliptic": "^6.5.4",
-                "inherits": "^2.0.4",
-                "parse-asn1": "^5.1.6",
-                "readable-stream": "^3.6.2",
-                "safe-buffer": "^5.2.1"
-            },
-            "dependencies": {
-                "readable-stream": {
-                    "version": "3.6.2",
-                    "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
-                    "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
-                    "dev": true,
-                    "requires": {
-                        "inherits": "^2.0.3",
-                        "string_decoder": "^1.1.1",
-                        "util-deprecate": "^1.0.1"
-                    }
-                },
-                "safe-buffer": {
-                    "version": "5.2.1",
-                    "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-                    "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-                    "dev": true
-                }
-            }
-        },
-        "browserify-zlib": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/browserify-zlib/-/browserify-zlib-0.2.0.tgz",
-            "integrity": "sha512-Z942RysHXmJrhqk88FmKBVq/v5tqmSkDz7p54G/MGyjMnCFFnC79XWNbg+Vta8W6Wb2qtSZTSxIGkJrRpCFEiA==",
-            "dev": true,
-            "requires": {
-                "pako": "~1.0.5"
-            }
-        },
-        "browserslist": {
-            "version": "4.23.3",
-            "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.23.3.tgz",
-            "integrity": "sha512-btwCFJVjI4YWDNfau8RhZ+B1Q/VLoUITrm3RlP6y1tYGWIOa+InuYiRGXUBXo8nA1qKmHMyLB/iVQg5TT4eFoA==",
-            "dev": true,
-            "requires": {
-                "caniuse-lite": "^1.0.30001646",
-                "electron-to-chromium": "^1.5.4",
-                "node-releases": "^2.0.18",
-                "update-browserslist-db": "^1.1.0"
-            }
-        },
-        "buffer": {
-            "version": "4.9.2",
-            "resolved": "https://registry.npmjs.org/buffer/-/buffer-4.9.2.tgz",
-            "integrity": "sha512-xq+q3SRMOxGivLhBNaUdC64hDTQwejJ+H0T/NB1XMtTVEwNTrfFF3gAxiyW0Bu/xWEGhjVKgUcMhCrUy2+uCWg==",
-            "dev": true,
-            "requires": {
-                "base64-js": "^1.0.2",
-                "ieee754": "^1.1.4",
-                "isarray": "^1.0.0"
-            }
-        },
-        "buffer-from": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
-            "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
-            "dev": true
-        },
-        "buffer-xor": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
-            "integrity": "sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==",
-            "dev": true
-        },
-        "builtin-status-codes": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/builtin-status-codes/-/builtin-status-codes-3.0.0.tgz",
-            "integrity": "sha512-HpGFw18DgFWlncDfjTa2rcQ4W88O1mC8e8yZ2AvQY5KDaktSTwo+KRf6nHK6FRI5FyRyb/5T6+TSxfP7QyGsmQ==",
-            "dev": true
-        },
-        "bytes": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.0.0.tgz",
-            "integrity": "sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==",
-            "dev": true
-        },
-        "call-bind": {
-            "version": "1.0.7",
-            "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.7.tgz",
-            "integrity": "sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==",
-            "dev": true,
-            "requires": {
-                "es-define-property": "^1.0.0",
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "get-intrinsic": "^1.2.4",
-                "set-function-length": "^1.2.1"
-            }
-        },
-        "callsites": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
-            "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
-            "dev": true
-        },
-        "camel-case": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/camel-case/-/camel-case-4.1.2.tgz",
-            "integrity": "sha512-gxGWBrTT1JuMx6R+o5PTXMmUnhnVzLQ9SNutD4YqKtI6ap897t3tKECYla6gCWEkplXnlNybEkZg9GEGxKFCgw==",
-            "dev": true,
-            "requires": {
-                "pascal-case": "^3.1.2",
-                "tslib": "^2.0.3"
-            }
-        },
-        "camelcase-css": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz",
-            "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==",
-            "dev": true
-        },
-        "caniuse-api": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-3.0.0.tgz",
-            "integrity": "sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==",
-            "dev": true,
-            "requires": {
-                "browserslist": "^4.0.0",
-                "caniuse-lite": "^1.0.0",
-                "lodash.memoize": "^4.1.2",
-                "lodash.uniq": "^4.5.0"
-            }
-        },
-        "caniuse-lite": {
-            "version": "1.0.30001646",
-            "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001646.tgz",
-            "integrity": "sha512-dRg00gudiBDDTmUhClSdv3hqRfpbOnU28IpI1T6PBTLWa+kOj0681C8uML3PifYfREuBrVjDGhL3adYpBT6spw==",
-            "dev": true
-        },
-        "chalk": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
-            "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
-            "dev": true,
-            "requires": {
-                "ansi-styles": "^4.1.0",
-                "supports-color": "^7.1.0"
-            }
-        },
-        "charenc": {
-            "version": "0.0.2",
-            "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
-            "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==",
-            "dev": true
-        },
-        "chokidar": {
-            "version": "3.5.3",
-            "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz",
-            "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==",
-            "dev": true,
-            "requires": {
-                "anymatch": "~3.1.2",
-                "braces": "~3.0.2",
-                "fsevents": "~2.3.2",
-                "glob-parent": "~5.1.2",
-                "is-binary-path": "~2.1.0",
-                "is-glob": "~4.0.1",
-                "normalize-path": "~3.0.0",
-                "readdirp": "~3.6.0"
-            }
-        },
-        "chrome-trace-event": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.3.tgz",
-            "integrity": "sha512-p3KULyQg4S7NIHixdwbGX+nFHkoBiA4YQmyWtjb8XngSKV124nJmRysgAeujbUVb15vh+RvFUfCPqU7rXk+hZg==",
-            "dev": true
-        },
-        "cipher-base": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.4.tgz",
-            "integrity": "sha512-Kkht5ye6ZGmwv40uUDZztayT2ThLQGfnj/T71N/XzeZeo3nf8foyW7zGTsPYkEya3m5f3cAypH+qe7YOrM1U2Q==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
-            }
-        },
-        "clean-css": {
-            "version": "5.3.1",
-            "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-5.3.1.tgz",
-            "integrity": "sha512-lCr8OHhiWCTw4v8POJovCoh4T7I9U11yVsPjMWWnnMmp9ZowCxyad1Pathle/9HjaDp+fdQKjO9fQydE6RHTZg==",
-            "dev": true,
-            "requires": {
-                "source-map": "~0.6.0"
-            }
-        },
-        "cli-table3": {
-            "version": "0.6.2",
-            "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.2.tgz",
-            "integrity": "sha512-QyavHCaIC80cMivimWu4aWHilIpiDpfm3hGmqAmXVL1UsnbLuBSMd21hTX6VY4ZSDSM73ESLeF8TOYId3rBTbw==",
-            "dev": true,
-            "requires": {
-                "@colors/colors": "1.5.0",
-                "string-width": "^4.2.0"
-            }
-        },
-        "cliui": {
-            "version": "7.0.4",
-            "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
-            "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==",
-            "dev": true,
-            "requires": {
-                "string-width": "^4.2.0",
-                "strip-ansi": "^6.0.0",
-                "wrap-ansi": "^7.0.0"
-            }
-        },
-        "clone-deep": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/clone-deep/-/clone-deep-4.0.1.tgz",
-            "integrity": "sha512-neHB9xuzh/wk0dIHweyAXv2aPGZIVk3pLMe+/RNzINf17fe0OG96QroktYAUm7SM1PBnzTabaLboqqxDyMU+SQ==",
-            "dev": true,
-            "requires": {
-                "is-plain-object": "^2.0.4",
-                "kind-of": "^6.0.2",
-                "shallow-clone": "^3.0.0"
-            }
-        },
-        "collect.js": {
-            "version": "4.34.3",
-            "resolved": "https://registry.npmjs.org/collect.js/-/collect.js-4.34.3.tgz",
-            "integrity": "sha512-aFr67xDazPwthsGm729mnClgNuh15JEagU6McKBKqxuHOkWL7vMFzGbhsXDdPZ+H6ia5QKIMGYuGOMENBHnVpg==",
-            "dev": true
-        },
-        "color-convert": {
-            "version": "1.9.3",
-            "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
-            "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
-            "dev": true,
-            "requires": {
-                "color-name": "1.1.3"
-            },
-            "dependencies": {
-                "color-name": {
-                    "version": "1.1.3",
-                    "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
-                    "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
-                    "dev": true
-                }
-            }
-        },
-        "color-name": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
-            "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
-            "dev": true
-        },
-        "colord": {
-            "version": "2.9.2",
-            "resolved": "https://registry.npmjs.org/colord/-/colord-2.9.2.tgz",
-            "integrity": "sha512-Uqbg+J445nc1TKn4FoDPS6ZZqAvEDnwrH42yo8B40JSOgSLxMZ/gt3h4nmCtPLQeXhjJJkqBx7SCY35WnIixaQ==",
-            "dev": true
-        },
-        "colorette": {
-            "version": "2.0.19",
-            "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.19.tgz",
-            "integrity": "sha512-3tlv/dIP7FWvj3BsbHrGLJ6l/oKh1O3TcgBqMn+yyCagOxc23fyzDS6HypQbgxWbkpDnf52p1LuR4eWDQ/K9WQ==",
-            "dev": true
-        },
-        "commander": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz",
-            "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==",
-            "dev": true
-        },
-        "commondir": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz",
-            "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==",
-            "dev": true
-        },
-        "compressible": {
-            "version": "2.0.18",
-            "resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz",
-            "integrity": "sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==",
-            "dev": true,
-            "requires": {
-                "mime-db": ">= 1.43.0 < 2"
-            }
-        },
-        "compression": {
-            "version": "1.7.4",
-            "resolved": "https://registry.npmjs.org/compression/-/compression-1.7.4.tgz",
-            "integrity": "sha512-jaSIDzP9pZVS4ZfQ+TzvtiWhdpFhE2RDHz8QJkpX9SIpLq88VueF5jJw6t+6CUQcAoA6t+x89MLrWAqpfDE8iQ==",
-            "dev": true,
-            "requires": {
-                "accepts": "~1.3.5",
-                "bytes": "3.0.0",
-                "compressible": "~2.0.16",
-                "debug": "2.6.9",
-                "on-headers": "~1.0.2",
-                "safe-buffer": "5.1.2",
-                "vary": "~1.1.2"
-            },
-            "dependencies": {
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-                    "dev": true,
-                    "requires": {
-                        "ms": "2.0.0"
-                    }
-                },
-                "ms": {
-                    "version": "2.0.0",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                    "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                    "dev": true
-                }
-            }
-        },
-        "concat": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/concat/-/concat-1.0.3.tgz",
-            "integrity": "sha512-f/ZaH1aLe64qHgTILdldbvyfGiGF4uzeo9IuXUloIOLQzFmIPloy9QbZadNsuVv0j5qbKQvQb/H/UYf2UsKTpw==",
-            "dev": true,
-            "requires": {
-                "commander": "^2.9.0"
-            },
-            "dependencies": {
-                "commander": {
-                    "version": "2.20.3",
-                    "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-                    "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-                    "dev": true
-                }
-            }
-        },
-        "concat-map": {
-            "version": "0.0.1",
-            "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-            "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
-            "dev": true
-        },
-        "connect-history-api-fallback": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/connect-history-api-fallback/-/connect-history-api-fallback-2.0.0.tgz",
-            "integrity": "sha512-U73+6lQFmfiNPrYbXqr6kZ1i1wiRqXnp2nhMsINseWXO8lDau0LGEffJ8kQi4EjLZympVgRdvqjAgiZ1tgzDDA==",
-            "dev": true
-        },
-        "consola": {
-            "version": "2.15.3",
-            "resolved": "https://registry.npmjs.org/consola/-/consola-2.15.3.tgz",
-            "integrity": "sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==",
-            "dev": true
-        },
-        "console-browserify": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/console-browserify/-/console-browserify-1.2.0.tgz",
-            "integrity": "sha512-ZMkYO/LkF17QvCPqM0gxw8yUzigAOZOSWSHg91FH6orS7vcEj5dVZTidN2fQ14yBSdg97RqhSNwLUXInd52OTA==",
-            "dev": true
-        },
-        "constants-browserify": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/constants-browserify/-/constants-browserify-1.0.0.tgz",
-            "integrity": "sha512-xFxOwqIzR/e1k1gLiWEophSCMqXcwVHIH7akf7b/vxcUeGunlj3hvZaaqxwHsTgn+IndtkQJgSztIDWeumWJDQ==",
-            "dev": true
-        },
-        "content-disposition": {
-            "version": "0.5.4",
-            "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
-            "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
-            "dev": true,
-            "requires": {
-                "safe-buffer": "5.2.1"
-            },
-            "dependencies": {
-                "safe-buffer": {
-                    "version": "5.2.1",
-                    "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-                    "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-                    "dev": true
-                }
-            }
-        },
-        "content-type": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
-            "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
-            "dev": true
-        },
-        "convert-source-map": {
-            "version": "1.8.0",
-            "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.8.0.tgz",
-            "integrity": "sha512-+OQdjP49zViI/6i7nIJpA8rAl4sV/JdPfU9nZs3VqOwGIgizICvuN2ru6fMd+4llL0tar18UYJXfZ/TWtmhUjA==",
-            "dev": true,
-            "requires": {
-                "safe-buffer": "~5.1.1"
-            }
-        },
-        "cookie": {
-            "version": "0.7.1",
-            "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz",
-            "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==",
-            "dev": true
-        },
-        "cookie-signature": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz",
-            "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==",
-            "dev": true
-        },
-        "core-js-compat": {
-            "version": "3.33.2",
-            "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.33.2.tgz",
-            "integrity": "sha512-axfo+wxFVxnqf8RvxTzoAlzW4gRoacrHeoFlc9n0x50+7BEyZL/Rt3hicaED1/CEd7I6tPCPVUYcJwCMO5XUYw==",
-            "dev": true,
-            "requires": {
-                "browserslist": "^4.22.1"
-            }
-        },
-        "core-util-is": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
-            "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
-            "dev": true
-        },
-        "cosmiconfig": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-7.0.1.tgz",
-            "integrity": "sha512-a1YWNUV2HwGimB7dU2s1wUMurNKjpx60HxBB6xUM8Re+2s1g1IIfJvFR0/iCF+XHdE0GMTKTuLR32UQff4TEyQ==",
-            "dev": true,
-            "requires": {
-                "@types/parse-json": "^4.0.0",
-                "import-fresh": "^3.2.1",
-                "parse-json": "^5.0.0",
-                "path-type": "^4.0.0",
-                "yaml": "^1.10.0"
-            }
-        },
-        "create-ecdh": {
-            "version": "4.0.4",
-            "resolved": "https://registry.npmjs.org/create-ecdh/-/create-ecdh-4.0.4.tgz",
-            "integrity": "sha512-mf+TCx8wWc9VpuxfP2ht0iSISLZnt0JgWlrOKZiNqyUZWnjIaCIVNQArMHnCZKfEYRg6IM7A+NeJoN8gf/Ws0A==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^4.1.0",
-                "elliptic": "^6.5.3"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
-            }
-        },
-        "create-hash": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
-            "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
-            "dev": true,
-            "requires": {
-                "cipher-base": "^1.0.1",
-                "inherits": "^2.0.1",
-                "md5.js": "^1.3.4",
-                "ripemd160": "^2.0.1",
-                "sha.js": "^2.4.0"
-            }
-        },
-        "create-hmac": {
-            "version": "1.1.7",
-            "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
-            "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
-            "dev": true,
-            "requires": {
-                "cipher-base": "^1.0.3",
-                "create-hash": "^1.1.0",
-                "inherits": "^2.0.1",
-                "ripemd160": "^2.0.0",
-                "safe-buffer": "^5.0.1",
-                "sha.js": "^2.4.8"
-            }
-        },
-        "cross-spawn": {
-            "version": "7.0.3",
-            "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",
-            "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==",
-            "dev": true,
-            "requires": {
-                "path-key": "^3.1.0",
-                "shebang-command": "^2.0.0",
-                "which": "^2.0.1"
-            }
-        },
-        "crypt": {
-            "version": "0.0.2",
-            "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
-            "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==",
-            "dev": true
-        },
-        "crypto-browserify": {
-            "version": "3.12.0",
-            "resolved": "https://registry.npmjs.org/crypto-browserify/-/crypto-browserify-3.12.0.tgz",
-            "integrity": "sha512-fz4spIh+znjO2VjL+IdhEpRJ3YN6sMzITSBijk6FK2UvTqruSQW+/cCZTSNsMiZNvUeq0CqurF+dAbyiGOY6Wg==",
-            "dev": true,
-            "requires": {
-                "browserify-cipher": "^1.0.0",
-                "browserify-sign": "^4.0.0",
-                "create-ecdh": "^4.0.0",
-                "create-hash": "^1.1.0",
-                "create-hmac": "^1.1.0",
-                "diffie-hellman": "^5.0.0",
-                "inherits": "^2.0.1",
-                "pbkdf2": "^3.0.3",
-                "public-encrypt": "^4.0.0",
-                "randombytes": "^2.0.0",
-                "randomfill": "^1.0.3"
-            }
-        },
-        "css-declaration-sorter": {
-            "version": "6.3.0",
-            "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-6.3.0.tgz",
-            "integrity": "sha512-OGT677UGHJTAVMRhPO+HJ4oKln3wkBTwtDFH0ojbqm+MJm6xuDMHp2nkhh/ThaBqq20IbraBQSWKfSLNHQO9Og==",
-            "dev": true,
-            "requires": {}
-        },
-        "css-loader": {
-            "version": "5.2.7",
-            "resolved": "https://registry.npmjs.org/css-loader/-/css-loader-5.2.7.tgz",
-            "integrity": "sha512-Q7mOvpBNBG7YrVGMxRxcBJZFL75o+cH2abNASdibkj/fffYD8qWbInZrD0S9ccI6vZclF3DsHE7njGlLtaHbhg==",
-            "dev": true,
-            "requires": {
-                "icss-utils": "^5.1.0",
-                "loader-utils": "^2.0.0",
-                "postcss": "^8.2.15",
-                "postcss-modules-extract-imports": "^3.0.0",
-                "postcss-modules-local-by-default": "^4.0.0",
-                "postcss-modules-scope": "^3.0.0",
-                "postcss-modules-values": "^4.0.0",
-                "postcss-value-parser": "^4.1.0",
-                "schema-utils": "^3.0.0",
-                "semver": "^7.3.5"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                }
-            }
-        },
-        "css-select": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/css-select/-/css-select-4.3.0.tgz",
-            "integrity": "sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ==",
-            "dev": true,
-            "requires": {
-                "boolbase": "^1.0.0",
-                "css-what": "^6.0.1",
-                "domhandler": "^4.3.1",
-                "domutils": "^2.8.0",
-                "nth-check": "^2.0.1"
-            },
-            "dependencies": {
-                "domhandler": {
-                    "version": "4.3.1",
-                    "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-                    "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-                    "dev": true,
-                    "requires": {
-                        "domelementtype": "^2.2.0"
-                    }
-                }
-            }
-        },
-        "css-tree": {
-            "version": "1.1.3",
-            "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.1.3.tgz",
-            "integrity": "sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q==",
-            "dev": true,
-            "requires": {
-                "mdn-data": "2.0.14",
-                "source-map": "^0.6.1"
-            }
-        },
-        "css-what": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.1.0.tgz",
-            "integrity": "sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw==",
-            "dev": true
-        },
-        "cssesc": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
-            "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
-            "dev": true
-        },
-        "cssnano": {
-            "version": "5.1.12",
-            "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-5.1.12.tgz",
-            "integrity": "sha512-TgvArbEZu0lk/dvg2ja+B7kYoD7BBCmn3+k58xD0qjrGHsFzXY/wKTo9M5egcUCabPol05e/PVoIu79s2JN4WQ==",
-            "dev": true,
-            "requires": {
-                "cssnano-preset-default": "^5.2.12",
-                "lilconfig": "^2.0.3",
-                "yaml": "^1.10.2"
-            }
-        },
-        "cssnano-preset-default": {
-            "version": "5.2.12",
-            "resolved": "https://registry.npmjs.org/cssnano-preset-default/-/cssnano-preset-default-5.2.12.tgz",
-            "integrity": "sha512-OyCBTZi+PXgylz9HAA5kHyoYhfGcYdwFmyaJzWnzxuGRtnMw/kR6ilW9XzlzlRAtB6PLT/r+prYgkef7hngFew==",
-            "dev": true,
-            "requires": {
-                "css-declaration-sorter": "^6.3.0",
-                "cssnano-utils": "^3.1.0",
-                "postcss-calc": "^8.2.3",
-                "postcss-colormin": "^5.3.0",
-                "postcss-convert-values": "^5.1.2",
-                "postcss-discard-comments": "^5.1.2",
-                "postcss-discard-duplicates": "^5.1.0",
-                "postcss-discard-empty": "^5.1.1",
-                "postcss-discard-overridden": "^5.1.0",
-                "postcss-merge-longhand": "^5.1.6",
-                "postcss-merge-rules": "^5.1.2",
-                "postcss-minify-font-values": "^5.1.0",
-                "postcss-minify-gradients": "^5.1.1",
-                "postcss-minify-params": "^5.1.3",
-                "postcss-minify-selectors": "^5.2.1",
-                "postcss-normalize-charset": "^5.1.0",
-                "postcss-normalize-display-values": "^5.1.0",
-                "postcss-normalize-positions": "^5.1.1",
-                "postcss-normalize-repeat-style": "^5.1.1",
-                "postcss-normalize-string": "^5.1.0",
-                "postcss-normalize-timing-functions": "^5.1.0",
-                "postcss-normalize-unicode": "^5.1.0",
-                "postcss-normalize-url": "^5.1.0",
-                "postcss-normalize-whitespace": "^5.1.1",
-                "postcss-ordered-values": "^5.1.3",
-                "postcss-reduce-initial": "^5.1.0",
-                "postcss-reduce-transforms": "^5.1.0",
-                "postcss-svgo": "^5.1.0",
-                "postcss-unique-selectors": "^5.1.1"
-            }
-        },
-        "cssnano-utils": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/cssnano-utils/-/cssnano-utils-3.1.0.tgz",
-            "integrity": "sha512-JQNR19/YZhz4psLX/rQ9M83e3z2Wf/HdJbryzte4a3NSuafyp9w/I4U+hx5C2S9g41qlstH7DEWnZaaj83OuEA==",
-            "dev": true,
-            "requires": {}
-        },
-        "csso": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/csso/-/csso-4.2.0.tgz",
-            "integrity": "sha512-wvlcdIbf6pwKEk7vHj8/Bkc0B4ylXZruLvOgs9doS5eOsOpuodOV2zJChSpkp+pRpYQLQMeF04nr3Z68Sta9jA==",
-            "dev": true,
-            "requires": {
-                "css-tree": "^1.1.2"
-            }
-        },
-        "debug": {
-            "version": "4.3.4",
-            "resolved": "https://registry.npmjs.org/debug/-/debug-4.3.4.tgz",
-            "integrity": "sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==",
-            "dev": true,
-            "requires": {
-                "ms": "2.1.2"
-            }
-        },
-        "default-gateway": {
-            "version": "6.0.3",
-            "resolved": "https://registry.npmjs.org/default-gateway/-/default-gateway-6.0.3.tgz",
-            "integrity": "sha512-fwSOJsbbNzZ/CUFpqFBqYfYNLj1NbMPm8MMCIzHjC83iSJRBEGmDUxU+WP661BaBQImeC2yHwXtz+P/O9o+XEg==",
-            "dev": true,
-            "requires": {
-                "execa": "^5.0.0"
-            }
-        },
-        "define-data-property": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
-            "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
-            "dev": true,
-            "requires": {
-                "es-define-property": "^1.0.0",
-                "es-errors": "^1.3.0",
-                "gopd": "^1.0.1"
-            }
-        },
-        "define-lazy-prop": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz",
-            "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==",
-            "dev": true
-        },
-        "define-properties": {
-            "version": "1.1.4",
-            "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.1.4.tgz",
-            "integrity": "sha512-uckOqKcfaVvtBdsVkdPv3XjveQJsNQqmhXgRi8uhvWWuPYZCNlzT8qAyblUgNoXdHdjMTzAqeGjAoli8f+bzPA==",
-            "dev": true,
-            "requires": {
-                "has-property-descriptors": "^1.0.0",
-                "object-keys": "^1.1.1"
-            }
-        },
-        "depd": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
-            "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
-            "dev": true
-        },
-        "des.js": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.1.tgz",
-            "integrity": "sha512-Q0I4pfFrv2VPd34/vfLrFOoRmlYj3OV50i7fskps1jZWK1kApMWWT9G6RRUeYedLcBDIhnSDaUvJMb3AhUlaEA==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.1",
-                "minimalistic-assert": "^1.0.0"
-            }
-        },
-        "destroy": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
-            "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
-            "dev": true
-        },
-        "detect-node": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
-            "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
-            "dev": true
-        },
-        "didyoumean": {
-            "version": "1.2.2",
-            "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz",
-            "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==",
-            "dev": true
-        },
-        "diffie-hellman": {
-            "version": "5.0.3",
-            "resolved": "https://registry.npmjs.org/diffie-hellman/-/diffie-hellman-5.0.3.tgz",
-            "integrity": "sha512-kqag/Nl+f3GwyK25fhUMYj81BUOrZ9IuJsjIcDE5icNM9FJHAVm3VcUDxdLPoQtTuUylWm6ZIknYJwwaPxsUzg==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^4.1.0",
-                "miller-rabin": "^4.0.0",
-                "randombytes": "^2.0.0"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
-            }
-        },
-        "dir-glob": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",
-            "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",
-            "dev": true,
-            "requires": {
-                "path-type": "^4.0.0"
-            }
-        },
-        "dlv": {
-            "version": "1.1.3",
-            "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",
-            "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==",
-            "dev": true
-        },
-        "dns-equal": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/dns-equal/-/dns-equal-1.0.0.tgz",
-            "integrity": "sha512-z+paD6YUQsk+AbGCEM4PrOXSss5gd66QfcVBFTKR/HpFL9jCqikS94HYwKww6fQyO7IxrIIyUu+g0Ka9tUS2Cg==",
-            "dev": true
-        },
-        "dns-packet": {
-            "version": "5.4.0",
-            "resolved": "https://registry.npmjs.org/dns-packet/-/dns-packet-5.4.0.tgz",
-            "integrity": "sha512-EgqGeaBB8hLiHLZtp/IbaDQTL8pZ0+IvwzSHA6d7VyMDM+B9hgddEMa9xjK5oYnw0ci0JQ6g2XCD7/f6cafU6g==",
-            "dev": true,
-            "requires": {
-                "@leichtgewicht/ip-codec": "^2.0.1"
-            }
-        },
-        "dom-serializer": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz",
-            "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==",
-            "dev": true,
-            "requires": {
-                "domelementtype": "^2.0.1",
-                "domhandler": "^4.2.0",
-                "entities": "^2.0.0"
-            },
-            "dependencies": {
-                "domhandler": {
-                    "version": "4.3.1",
-                    "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-                    "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-                    "dev": true,
-                    "requires": {
-                        "domelementtype": "^2.2.0"
-                    }
-                }
-            }
-        },
-        "domain-browser": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/domain-browser/-/domain-browser-1.2.0.tgz",
-            "integrity": "sha512-jnjyiM6eRyZl2H+W8Q/zLMA481hzi0eszAaBUzIVnmYVDBbnLxVNnfu1HgEBvCbL+71FrxMl3E6lpKH7Ge3OXA==",
-            "dev": true
-        },
-        "domelementtype": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
-            "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
-            "dev": true
-        },
-        "domhandler": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-3.3.0.tgz",
-            "integrity": "sha512-J1C5rIANUbuYK+FuFL98650rihynUOEzRLxW+90bKZRWB6A1X1Tf82GxR1qAWLyfNPRvjqfip3Q5tdYlmAa9lA==",
-            "dev": true,
-            "requires": {
-                "domelementtype": "^2.0.1"
-            }
-        },
-        "domutils": {
-            "version": "2.8.0",
-            "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz",
-            "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==",
-            "dev": true,
-            "requires": {
-                "dom-serializer": "^1.0.1",
-                "domelementtype": "^2.2.0",
-                "domhandler": "^4.2.0"
-            },
-            "dependencies": {
-                "domhandler": {
-                    "version": "4.3.1",
-                    "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
-                    "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
-                    "dev": true,
-                    "requires": {
-                        "domelementtype": "^2.2.0"
-                    }
-                }
-            }
-        },
-        "dot-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/dot-case/-/dot-case-3.0.4.tgz",
-            "integrity": "sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w==",
-            "dev": true,
-            "requires": {
-                "no-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
-        },
-        "dotenv": {
-            "version": "10.0.0",
-            "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-10.0.0.tgz",
-            "integrity": "sha512-rlBi9d8jpv9Sf1klPjNfFAuWDjKLwTIJJ/VxtoTwIR6hnZxcEOQCZg2oIL3MWBYw5GpUDKOEnND7LXTbIpQ03Q==",
-            "dev": true
-        },
-        "dotenv-expand": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-5.1.0.tgz",
-            "integrity": "sha512-YXQl1DSa4/PQyRfgrv6aoNjhasp/p4qs9FjJ4q4cQk+8m4r6k4ZSiEyytKG8f8W9gi8WsQtIObNmKd+tMzNTmA==",
-            "dev": true
-        },
-        "eastasianwidth": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
-            "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
-            "dev": true
-        },
-        "ee-first": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
-            "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
-            "dev": true
-        },
-        "electron-to-chromium": {
-            "version": "1.5.4",
-            "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.4.tgz",
-            "integrity": "sha512-orzA81VqLyIGUEA77YkVA1D+N+nNfl2isJVjjmOyrlxuooZ19ynb+dOlaDTqd/idKRS9lDCSBmtzM+kyCsMnkA==",
-            "dev": true
-        },
-        "elliptic": {
-            "version": "6.6.0",
-            "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.6.0.tgz",
-            "integrity": "sha512-dpwoQcLc/2WLQvJvLRHKZ+f9FgOdjnq11rurqwekGQygGPsYSK29OMMD2WalatiqQ+XGFDglTNixpPfI+lpaAA==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^4.11.9",
-                "brorand": "^1.1.0",
-                "hash.js": "^1.0.0",
-                "hmac-drbg": "^1.0.1",
-                "inherits": "^2.0.4",
-                "minimalistic-assert": "^1.0.1",
-                "minimalistic-crypto-utils": "^1.0.1"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
-            }
-        },
-        "emoji-regex": {
-            "version": "8.0.0",
-            "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
-            "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
-            "dev": true
-        },
-        "emojis-list": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/emojis-list/-/emojis-list-3.0.0.tgz",
-            "integrity": "sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q==",
-            "dev": true
-        },
-        "encodeurl": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
-            "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
-            "dev": true
-        },
-        "enhanced-resolve": {
-            "version": "5.17.1",
-            "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.1.tgz",
-            "integrity": "sha512-LMHl3dXhTcfv8gM4kEzIUeTQ+7fpdA0l2tUf34BddXPkz2A5xJ5L/Pchd5BL6rdccM9QGvu0sWZzK1Z1t4wwyg==",
-            "dev": true,
-            "requires": {
-                "graceful-fs": "^4.2.4",
-                "tapable": "^2.2.0"
-            }
-        },
-        "entities": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz",
-            "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==",
-            "dev": true
-        },
-        "envinfo": {
-            "version": "7.8.1",
-            "resolved": "https://registry.npmjs.org/envinfo/-/envinfo-7.8.1.tgz",
-            "integrity": "sha512-/o+BXHmB7ocbHEAs6F2EnG0ogybVVUdkRunTT2glZU9XAaGmhqskrvKwqXuDfNjEO0LZKWdejEEpnq8aM0tOaw==",
-            "dev": true
-        },
-        "error-ex": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
-            "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
-            "dev": true,
-            "requires": {
-                "is-arrayish": "^0.2.1"
-            }
-        },
-        "es-define-property": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.0.tgz",
-            "integrity": "sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==",
-            "dev": true,
-            "requires": {
-                "get-intrinsic": "^1.2.4"
-            }
-        },
-        "es-errors": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
-            "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
-            "dev": true
-        },
-        "es-module-lexer": {
-            "version": "1.5.4",
-            "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.5.4.tgz",
-            "integrity": "sha512-MVNK56NiMrOwitFB7cqDwq0CQutbw+0BvLshJSse0MUNU+y1FC3bUS/AQg7oUng+/wKrrki7JfmwtVHkVfPLlw==",
-            "dev": true
-        },
-        "escalade": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.2.tgz",
-            "integrity": "sha512-ErCHMCae19vR8vQGe50xIsVomy19rg6gFu3+r3jkEO46suLMWBksvVyoGgQV+jOfl84ZSOSlmv6Gxa89PmTGmA==",
-            "dev": true
-        },
-        "escape-html": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
-            "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
-            "dev": true
-        },
-        "escape-string-regexp": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
-            "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
-            "dev": true
-        },
-        "eslint-scope": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz",
-            "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==",
-            "dev": true,
-            "requires": {
-                "esrecurse": "^4.3.0",
-                "estraverse": "^4.1.1"
-            }
-        },
-        "esrecurse": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
-            "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
-            "dev": true,
-            "requires": {
-                "estraverse": "^5.2.0"
-            },
-            "dependencies": {
-                "estraverse": {
-                    "version": "5.3.0",
-                    "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
-                    "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
-                    "dev": true
-                }
-            }
-        },
-        "estraverse": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz",
-            "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==",
-            "dev": true
-        },
-        "esutils": {
-            "version": "2.0.3",
-            "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
-            "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
-            "dev": true
-        },
-        "etag": {
-            "version": "1.8.1",
-            "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
-            "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
-            "dev": true
-        },
-        "eventemitter3": {
-            "version": "4.0.7",
-            "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz",
-            "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==",
-            "dev": true
-        },
-        "events": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
-            "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
-            "dev": true
-        },
-        "evp_bytestokey": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
-            "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
-            "dev": true,
-            "requires": {
-                "md5.js": "^1.3.4",
-                "safe-buffer": "^5.1.1"
-            }
-        },
-        "execa": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
-            "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
-            "dev": true,
-            "requires": {
-                "cross-spawn": "^7.0.3",
-                "get-stream": "^6.0.0",
-                "human-signals": "^2.1.0",
-                "is-stream": "^2.0.0",
-                "merge-stream": "^2.0.0",
-                "npm-run-path": "^4.0.1",
-                "onetime": "^5.1.2",
-                "signal-exit": "^3.0.3",
-                "strip-final-newline": "^2.0.0"
-            }
-        },
-        "express": {
-            "version": "4.21.1",
-            "resolved": "https://registry.npmjs.org/express/-/express-4.21.1.tgz",
-            "integrity": "sha512-YSFlK1Ee0/GC8QaO91tHcDxJiE/X4FbpAyQWkxAvG6AXCuR65YzK8ua6D9hvi/TzUfZMpc+BwuM1IPw8fmQBiQ==",
-            "dev": true,
-            "requires": {
-                "accepts": "~1.3.8",
-                "array-flatten": "1.1.1",
-                "body-parser": "1.20.3",
-                "content-disposition": "0.5.4",
-                "content-type": "~1.0.4",
-                "cookie": "0.7.1",
-                "cookie-signature": "1.0.6",
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "etag": "~1.8.1",
-                "finalhandler": "1.3.1",
-                "fresh": "0.5.2",
-                "http-errors": "2.0.0",
-                "merge-descriptors": "1.0.3",
-                "methods": "~1.1.2",
-                "on-finished": "2.4.1",
-                "parseurl": "~1.3.3",
-                "path-to-regexp": "0.1.10",
-                "proxy-addr": "~2.0.7",
-                "qs": "6.13.0",
-                "range-parser": "~1.2.1",
-                "safe-buffer": "5.2.1",
-                "send": "0.19.0",
-                "serve-static": "1.16.2",
-                "setprototypeof": "1.2.0",
-                "statuses": "2.0.1",
-                "type-is": "~1.6.18",
-                "utils-merge": "1.0.1",
-                "vary": "~1.1.2"
-            },
-            "dependencies": {
-                "array-flatten": {
-                    "version": "1.1.1",
-                    "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
-                    "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
-                    "dev": true
-                },
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-                    "dev": true,
-                    "requires": {
-                        "ms": "2.0.0"
-                    }
-                },
-                "ms": {
-                    "version": "2.0.0",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                    "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                    "dev": true
-                },
-                "safe-buffer": {
-                    "version": "5.2.1",
-                    "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-                    "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-                    "dev": true
-                }
-            }
-        },
-        "fast-deep-equal": {
-            "version": "3.1.3",
-            "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
-            "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-            "dev": true
-        },
-        "fast-glob": {
-            "version": "3.3.2",
-            "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.2.tgz",
-            "integrity": "sha512-oX2ruAFQwf/Orj8m737Y5adxDQO0LAB7/S5MnxCdTNDd4p6BsyIVsv9JQsATbTSq8KHRpLwIHbVlUNatxd+1Ow==",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.stat": "^2.0.2",
-                "@nodelib/fs.walk": "^1.2.3",
-                "glob-parent": "^5.1.2",
-                "merge2": "^1.3.0",
-                "micromatch": "^4.0.4"
-            }
-        },
-        "fast-json-stable-stringify": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-            "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
-            "dev": true
-        },
-        "fastest-levenshtein": {
-            "version": "1.0.14",
-            "resolved": "https://registry.npmjs.org/fastest-levenshtein/-/fastest-levenshtein-1.0.14.tgz",
-            "integrity": "sha512-tFfWHjnuUfKE186Tfgr+jtaFc0mZTApEgKDOeyN+FwOqRkO/zK/3h1AiRd8u8CY53owL3CUmGr/oI9p/RdyLTA==",
-            "dev": true
-        },
-        "fastq": {
-            "version": "1.13.0",
-            "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.13.0.tgz",
-            "integrity": "sha512-YpkpUnK8od0o1hmeSc7UUs/eB/vIPWJYjKck2QKIzAf71Vm1AAQ3EbuZB3g2JIy+pg+ERD0vqI79KyZiB2e2Nw==",
-            "dev": true,
-            "requires": {
-                "reusify": "^1.0.4"
-            }
-        },
-        "faye-websocket": {
-            "version": "0.11.4",
-            "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz",
-            "integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==",
-            "dev": true,
-            "requires": {
-                "websocket-driver": ">=0.5.1"
-            }
-        },
-        "file-loader": {
-            "version": "6.2.0",
-            "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-6.2.0.tgz",
-            "integrity": "sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw==",
-            "dev": true,
-            "requires": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                }
-            }
-        },
-        "file-type": {
-            "version": "12.4.2",
-            "resolved": "https://registry.npmjs.org/file-type/-/file-type-12.4.2.tgz",
-            "integrity": "sha512-UssQP5ZgIOKelfsaB5CuGAL+Y+q7EmONuiwF3N5HAH0t27rvrttgi6Ra9k/+DVaY9UF6+ybxu5pOXLUdA8N7Vg==",
-            "dev": true
-        },
-        "fill-range": {
-            "version": "7.1.1",
-            "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-            "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-            "dev": true,
-            "requires": {
-                "to-regex-range": "^5.0.1"
-            }
-        },
-        "finalhandler": {
-            "version": "1.3.1",
-            "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz",
-            "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==",
-            "dev": true,
-            "requires": {
-                "debug": "2.6.9",
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "on-finished": "2.4.1",
-                "parseurl": "~1.3.3",
-                "statuses": "2.0.1",
-                "unpipe": "~1.0.0"
-            },
-            "dependencies": {
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-                    "dev": true,
-                    "requires": {
-                        "ms": "2.0.0"
-                    }
-                },
-                "ms": {
-                    "version": "2.0.0",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                    "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                    "dev": true
-                }
-            }
-        },
-        "find-cache-dir": {
-            "version": "3.3.2",
-            "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-3.3.2.tgz",
-            "integrity": "sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig==",
-            "dev": true,
-            "requires": {
-                "commondir": "^1.0.1",
-                "make-dir": "^3.0.2",
-                "pkg-dir": "^4.1.0"
-            }
-        },
-        "find-up": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
-            "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
-            "dev": true,
-            "requires": {
-                "locate-path": "^5.0.0",
-                "path-exists": "^4.0.0"
-            }
-        },
-        "follow-redirects": {
-            "version": "1.15.6",
-            "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.6.tgz",
-            "integrity": "sha512-wWN62YITEaOpSK584EZXJafH1AGpO8RVgElfkuXbTOrPX4fIfOyEpW/CsiNd8JdYrAoOvafRTOEnvsO++qCqFA==",
-            "dev": true
-        },
-        "foreground-child": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.1.1.tgz",
-            "integrity": "sha512-TMKDUnIte6bfb5nWv7V/caI169OHgvwjb7V4WkeUvbQQdjr5rWKqHFiKWb/fcOwB+CzBT+qbWjvj+DVwRskpIg==",
-            "dev": true,
-            "requires": {
-                "cross-spawn": "^7.0.0",
-                "signal-exit": "^4.0.1"
-            },
-            "dependencies": {
-                "signal-exit": {
-                    "version": "4.1.0",
-                    "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
-                    "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
-                    "dev": true
-                }
-            }
-        },
-        "forwarded": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
-            "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
-            "dev": true
-        },
-        "fraction.js": {
-            "version": "4.3.7",
-            "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.3.7.tgz",
-            "integrity": "sha512-ZsDfxO51wGAXREY55a7la9LScWpwv9RxIrYABrlvOFBlH/ShPnrtsXeuUIfXKKOVicNxQ+o8JTbJvjS4M89yew==",
-            "dev": true
-        },
-        "fresh": {
-            "version": "0.5.2",
-            "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
-            "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
-            "dev": true
-        },
-        "fs-extra": {
-            "version": "10.1.0",
-            "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
-            "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
-            "dev": true,
-            "requires": {
-                "graceful-fs": "^4.2.0",
-                "jsonfile": "^6.0.1",
-                "universalify": "^2.0.0"
-            }
-        },
-        "fs-monkey": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/fs-monkey/-/fs-monkey-1.0.3.tgz",
-            "integrity": "sha512-cybjIfiiE+pTWicSCLFHSrXZ6EilF30oh91FDP9S2B051prEa7QWfrVTQm10/dDpswBDXZugPa1Ogu8Yh+HV0Q==",
-            "dev": true
-        },
-        "fs.realpath": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
-            "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
-            "dev": true
-        },
-        "fsevents": {
-            "version": "2.3.2",
-            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",
-            "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",
-            "dev": true,
-            "optional": true
-        },
-        "function-bind": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
-            "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
-            "dev": true
-        },
-        "gensync": {
-            "version": "1.0.0-beta.2",
-            "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
-            "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
-            "dev": true
-        },
-        "get-caller-file": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
-            "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
-            "dev": true
-        },
-        "get-intrinsic": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.4.tgz",
-            "integrity": "sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==",
-            "dev": true,
-            "requires": {
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "has-proto": "^1.0.1",
-                "has-symbols": "^1.0.3",
-                "hasown": "^2.0.0"
-            }
-        },
-        "get-stream": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
-            "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
-            "dev": true
-        },
-        "glob": {
-            "version": "7.2.3",
-            "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
-            "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
-            "dev": true,
-            "requires": {
-                "fs.realpath": "^1.0.0",
-                "inflight": "^1.0.4",
-                "inherits": "2",
-                "minimatch": "^3.1.1",
-                "once": "^1.3.0",
-                "path-is-absolute": "^1.0.0"
-            }
-        },
-        "glob-parent": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
-            "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
-            "dev": true,
-            "requires": {
-                "is-glob": "^4.0.1"
-            }
-        },
-        "glob-to-regexp": {
-            "version": "0.4.1",
-            "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz",
-            "integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==",
-            "dev": true
-        },
-        "globals": {
-            "version": "11.12.0",
-            "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz",
-            "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==",
-            "dev": true
-        },
-        "globby": {
-            "version": "10.0.2",
-            "resolved": "https://registry.npmjs.org/globby/-/globby-10.0.2.tgz",
-            "integrity": "sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==",
-            "dev": true,
-            "requires": {
-                "@types/glob": "^7.1.1",
-                "array-union": "^2.1.0",
-                "dir-glob": "^3.0.1",
-                "fast-glob": "^3.0.3",
-                "glob": "^7.1.3",
-                "ignore": "^5.1.1",
-                "merge2": "^1.2.3",
-                "slash": "^3.0.0"
-            }
-        },
-        "gopd": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.0.1.tgz",
-            "integrity": "sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==",
-            "dev": true,
-            "requires": {
-                "get-intrinsic": "^1.1.3"
-            }
-        },
-        "graceful-fs": {
-            "version": "4.2.11",
-            "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
-            "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
-            "dev": true
-        },
-        "growly": {
-            "version": "1.3.0",
-            "resolved": "https://registry.npmjs.org/growly/-/growly-1.3.0.tgz",
-            "integrity": "sha512-+xGQY0YyAWCnqy7Cd++hc2JqMYzlm0dG30Jd0beaA64sROr8C4nt8Yc9V5Ro3avlSUDTN0ulqP/VBKi1/lLygw==",
-            "dev": true
-        },
-        "handle-thing": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/handle-thing/-/handle-thing-2.0.1.tgz",
-            "integrity": "sha512-9Qn4yBxelxoh2Ow62nP+Ka/kMnOXRi8BXnRaUwezLNhqelnN49xKz4F/dPP8OYLxLxq6JDtZb2i9XznUQbNPTg==",
-            "dev": true
-        },
-        "has-flag": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
-            "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
-            "dev": true
-        },
-        "has-property-descriptors": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
-            "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
-            "dev": true,
-            "requires": {
-                "es-define-property": "^1.0.0"
-            }
-        },
-        "has-proto": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/has-proto/-/has-proto-1.0.3.tgz",
-            "integrity": "sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==",
-            "dev": true
-        },
-        "has-symbols": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.3.tgz",
-            "integrity": "sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==",
-            "dev": true
-        },
-        "hash-base": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.1.0.tgz",
-            "integrity": "sha512-1nmYp/rhMDiE7AYkDw+lLwlAzz0AntGIe51F3RfFfEqyQ3feY2eI/NcwC6umIQVOASPMsWJLJScWKSSvzL9IVA==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.4",
-                "readable-stream": "^3.6.0",
-                "safe-buffer": "^5.2.0"
-            },
-            "dependencies": {
-                "readable-stream": {
-                    "version": "3.6.0",
-                    "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
-                    "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
-                    "dev": true,
-                    "requires": {
-                        "inherits": "^2.0.3",
-                        "string_decoder": "^1.1.1",
-                        "util-deprecate": "^1.0.1"
-                    }
-                },
-                "safe-buffer": {
-                    "version": "5.2.1",
-                    "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
-                    "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
-                    "dev": true
-                }
-            }
-        },
-        "hash-sum": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/hash-sum/-/hash-sum-1.0.2.tgz",
-            "integrity": "sha512-fUs4B4L+mlt8/XAtSOGMUO1TXmAelItBPtJG7CyHJfYTdDjwisntGO2JQz7oUsatOY9o68+57eziUVNw/mRHmA==",
-            "dev": true
-        },
-        "hash.js": {
-            "version": "1.1.7",
-            "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
-            "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.3",
-                "minimalistic-assert": "^1.0.1"
-            }
-        },
-        "hasown": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
-            "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
-            "dev": true,
-            "requires": {
-                "function-bind": "^1.1.2"
-            }
-        },
-        "he": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
-            "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
-            "dev": true
-        },
-        "hmac-drbg": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
-            "integrity": "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==",
-            "dev": true,
-            "requires": {
-                "hash.js": "^1.0.3",
-                "minimalistic-assert": "^1.0.0",
-                "minimalistic-crypto-utils": "^1.0.1"
-            }
-        },
-        "hpack.js": {
-            "version": "2.1.6",
-            "resolved": "https://registry.npmjs.org/hpack.js/-/hpack.js-2.1.6.tgz",
-            "integrity": "sha512-zJxVehUdMGIKsRaNt7apO2Gqp0BdqW5yaiGHXXmbpvxgBYVZnAql+BJb4RO5ad2MgpbZKn5G6nMnegrH1FcNYQ==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.1",
-                "obuf": "^1.0.0",
-                "readable-stream": "^2.0.1",
-                "wbuf": "^1.1.0"
-            }
-        },
-        "html-entities": {
-            "version": "2.3.3",
-            "resolved": "https://registry.npmjs.org/html-entities/-/html-entities-2.3.3.tgz",
-            "integrity": "sha512-DV5Ln36z34NNTDgnz0EWGBLZENelNAtkiFA4kyNOG2tDI6Mz1uSWiq1wAKdyjnJwyDiDO7Fa2SO1CTxPXL8VxA==",
-            "dev": true
-        },
-        "html-loader": {
-            "version": "1.3.2",
-            "resolved": "https://registry.npmjs.org/html-loader/-/html-loader-1.3.2.tgz",
-            "integrity": "sha512-DEkUwSd0sijK5PF3kRWspYi56XP7bTNkyg5YWSzBdjaSDmvCufep5c4Vpb3PBf6lUL0YPtLwBfy9fL0t5hBAGA==",
-            "dev": true,
-            "requires": {
-                "html-minifier-terser": "^5.1.1",
-                "htmlparser2": "^4.1.0",
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                }
-            }
-        },
-        "html-minifier-terser": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/html-minifier-terser/-/html-minifier-terser-5.1.1.tgz",
-            "integrity": "sha512-ZPr5MNObqnV/T9akshPKbVgyOqLmy+Bxo7juKCfTfnjNniTAMdy4hz21YQqoofMBJD2kdREaqPPdThoR78Tgxg==",
-            "dev": true,
-            "requires": {
-                "camel-case": "^4.1.1",
-                "clean-css": "^4.2.3",
-                "commander": "^4.1.1",
-                "he": "^1.2.0",
-                "param-case": "^3.0.3",
-                "relateurl": "^0.2.7",
-                "terser": "^4.6.3"
-            },
-            "dependencies": {
-                "clean-css": {
-                    "version": "4.2.4",
-                    "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-4.2.4.tgz",
-                    "integrity": "sha512-EJUDT7nDVFDvaQgAo2G/PJvxmp1o/c6iXLbswsBbUFXi1Nr+AjA2cKmfbKDMjMvzEe75g3P6JkaDDAKk96A85A==",
-                    "dev": true,
-                    "requires": {
-                        "source-map": "~0.6.0"
-                    }
-                },
-                "commander": {
-                    "version": "4.1.1",
-                    "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
-                    "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
-                    "dev": true
-                },
-                "terser": {
-                    "version": "4.8.1",
-                    "resolved": "https://registry.npmjs.org/terser/-/terser-4.8.1.tgz",
-                    "integrity": "sha512-4GnLC0x667eJG0ewJTa6z/yXrbLGv80D9Ru6HIpCQmO+Q4PfEtBFi0ObSckqwL6VyQv/7ENJieXHo2ANmdQwgw==",
-                    "dev": true,
-                    "requires": {
-                        "commander": "^2.20.0",
-                        "source-map": "~0.6.1",
-                        "source-map-support": "~0.5.12"
-                    },
-                    "dependencies": {
-                        "commander": {
-                            "version": "2.20.3",
-                            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-                            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-                            "dev": true
-                        }
-                    }
-                }
-            }
-        },
-        "htmlparser2": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-4.1.0.tgz",
-            "integrity": "sha512-4zDq1a1zhE4gQso/c5LP1OtrhYTncXNSpvJYtWJBtXAETPlMfi3IFNjGuQbYLuVY4ZR0QMqRVvo4Pdy9KLyP8Q==",
-            "dev": true,
-            "requires": {
-                "domelementtype": "^2.0.1",
-                "domhandler": "^3.0.0",
-                "domutils": "^2.0.0",
-                "entities": "^2.0.0"
-            }
-        },
-        "http-deceiver": {
-            "version": "1.2.7",
-            "resolved": "https://registry.npmjs.org/http-deceiver/-/http-deceiver-1.2.7.tgz",
-            "integrity": "sha512-LmpOGxTfbpgtGVxJrj5k7asXHCgNZp5nLfp+hWc8QQRqtb7fUy6kRY3BO1h9ddF6yIPYUARgxGOwB42DnxIaNw==",
-            "dev": true
-        },
-        "http-errors": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
-            "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
-            "dev": true,
-            "requires": {
-                "depd": "2.0.0",
-                "inherits": "2.0.4",
-                "setprototypeof": "1.2.0",
-                "statuses": "2.0.1",
-                "toidentifier": "1.0.1"
-            }
-        },
-        "http-parser-js": {
-            "version": "0.5.8",
-            "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.5.8.tgz",
-            "integrity": "sha512-SGeBX54F94Wgu5RH3X5jsDtf4eHyRogWX1XGT3b4HuW3tQPM4AaBzoUji/4AAJNXCEOWZ5O0DgZmJw1947gD5Q==",
-            "dev": true
-        },
-        "http-proxy": {
-            "version": "1.18.1",
-            "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz",
-            "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==",
-            "dev": true,
-            "requires": {
-                "eventemitter3": "^4.0.0",
-                "follow-redirects": "^1.0.0",
-                "requires-port": "^1.0.0"
-            }
-        },
-        "http-proxy-middleware": {
-            "version": "2.0.6",
-            "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-2.0.6.tgz",
-            "integrity": "sha512-ya/UeJ6HVBYxrgYotAZo1KvPWlgB48kUJLDePFeneHsVujFaW5WNj2NgWCAE//B1Dl02BIfYlpNgBy8Kf8Rjmw==",
-            "dev": true,
-            "requires": {
-                "@types/http-proxy": "^1.17.8",
-                "http-proxy": "^1.18.1",
-                "is-glob": "^4.0.1",
-                "is-plain-obj": "^3.0.0",
-                "micromatch": "^4.0.2"
-            }
-        },
-        "https-browserify": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/https-browserify/-/https-browserify-1.0.0.tgz",
-            "integrity": "sha512-J+FkSdyD+0mA0N+81tMotaRMfSL9SGi+xpD3T6YApKsc3bGSXJlfXri3VyFOeYkfLRQisDk1W+jIFFKBeUBbBg==",
-            "dev": true
-        },
-        "human-signals": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
-            "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
-            "dev": true
-        },
-        "hydefront": {
-            "version": "3.4.0",
-            "resolved": "https://registry.npmjs.org/hydefront/-/hydefront-3.4.0.tgz",
-            "integrity": "sha512-Au1s9Yfw57r0It8lmUjpTMlYuCnwob9zK1TWxOR5ruuvZf8ESDbAuTutrzQfpxnb7yC2KxFt2RKOBpJnjjAveQ==",
-            "dev": true
-        },
-        "iconv-lite": {
-            "version": "0.4.24",
-            "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
-            "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
-            "dev": true,
-            "requires": {
-                "safer-buffer": ">= 2.1.2 < 3"
-            }
-        },
-        "icss-utils": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-5.1.0.tgz",
-            "integrity": "sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==",
-            "dev": true,
-            "requires": {}
-        },
-        "ieee754": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
-            "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
-            "dev": true
-        },
-        "ignore": {
-            "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.2.0.tgz",
-            "integrity": "sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ==",
-            "dev": true
-        },
-        "imagemin": {
-            "version": "7.0.1",
-            "resolved": "https://registry.npmjs.org/imagemin/-/imagemin-7.0.1.tgz",
-            "integrity": "sha512-33AmZ+xjZhg2JMCe+vDf6a9mzWukE7l+wAtesjE7KyteqqKjzxv7aVQeWnul1Ve26mWvEQqyPwl0OctNBfSR9w==",
-            "dev": true,
-            "requires": {
-                "file-type": "^12.0.0",
-                "globby": "^10.0.0",
-                "graceful-fs": "^4.2.2",
-                "junk": "^3.1.0",
-                "make-dir": "^3.0.0",
-                "p-pipe": "^3.0.0",
-                "replace-ext": "^1.0.0"
-            }
-        },
-        "img-loader": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/img-loader/-/img-loader-4.0.0.tgz",
-            "integrity": "sha512-UwRcPQdwdOyEHyCxe1V9s9YFwInwEWCpoO+kJGfIqDrBDqA8jZUsEZTxQ0JteNPGw/Gupmwesk2OhLTcnw6tnQ==",
-            "dev": true,
-            "requires": {
-                "loader-utils": "^1.1.0"
-            },
-            "dependencies": {
-                "json5": {
-                    "version": "1.0.2",
-                    "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
-                    "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
-                    "dev": true,
-                    "requires": {
-                        "minimist": "^1.2.0"
-                    }
-                },
-                "loader-utils": {
-                    "version": "1.4.2",
-                    "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
-                    "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
-                    "dev": true,
-                    "requires": {
-                        "big.js": "^5.2.2",
-                        "emojis-list": "^3.0.0",
-                        "json5": "^1.0.1"
-                    }
-                }
-            }
-        },
-        "import-fresh": {
-            "version": "3.3.0",
-            "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.0.tgz",
-            "integrity": "sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw==",
-            "dev": true,
-            "requires": {
-                "parent-module": "^1.0.0",
-                "resolve-from": "^4.0.0"
-            }
-        },
-        "import-local": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.1.0.tgz",
-            "integrity": "sha512-ASB07uLtnDs1o6EHjKpX34BKYDSqnFerfTOJL2HvMqF70LnxpjkzDB8J44oT9pu4AMPkQwf8jl6szgvNd2tRIg==",
-            "dev": true,
-            "requires": {
-                "pkg-dir": "^4.2.0",
-                "resolve-cwd": "^3.0.0"
-            }
-        },
-        "inflight": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
-            "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
-            "dev": true,
-            "requires": {
-                "once": "^1.3.0",
-                "wrappy": "1"
-            }
-        },
-        "inherits": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
-            "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
-            "dev": true
-        },
-        "interpret": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/interpret/-/interpret-2.2.0.tgz",
-            "integrity": "sha512-Ju0Bz/cEia55xDwUWEa8+olFpCiQoypjnQySseKtmjNrnps3P+xfpUmGr90T7yjlVJmOtybRvPXhKMbHr+fWnw==",
-            "dev": true
-        },
-        "ipaddr.js": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.0.1.tgz",
-            "integrity": "sha512-1qTgH9NG+IIJ4yfKs2e6Pp1bZg8wbDbKHT21HrLIeYBTRLgMYKnMTPAuI3Lcs61nfx5h1xlXnbJtH1kX5/d/ng==",
-            "dev": true
-        },
-        "is-arrayish": {
-            "version": "0.2.1",
-            "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
-            "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
-            "dev": true
-        },
-        "is-binary-path": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
-            "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
-            "dev": true,
-            "requires": {
-                "binary-extensions": "^2.0.0"
-            }
-        },
-        "is-buffer": {
-            "version": "1.1.6",
-            "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
-            "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
-            "dev": true
-        },
-        "is-core-module": {
-            "version": "2.13.1",
-            "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.13.1.tgz",
-            "integrity": "sha512-hHrIjvZsftOsvKSn2TRYl63zvxsgE0K+0mYMoH6gD4omR5IWB2KynivBQczo3+wF1cCkjzvptnI9Q0sPU66ilw==",
-            "dev": true,
-            "requires": {
-                "hasown": "^2.0.0"
-            }
-        },
-        "is-docker": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
-            "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
-            "dev": true
-        },
-        "is-extglob": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
-            "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-            "dev": true
-        },
-        "is-fullwidth-code-point": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
-            "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
-            "dev": true
-        },
-        "is-glob": {
-            "version": "4.0.3",
-            "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
-            "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-            "dev": true,
-            "requires": {
-                "is-extglob": "^2.1.1"
-            }
-        },
-        "is-number": {
-            "version": "7.0.0",
-            "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-            "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-            "dev": true
-        },
-        "is-plain-obj": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-3.0.0.tgz",
-            "integrity": "sha512-gwsOE28k+23GP1B6vFl1oVh/WOzmawBrKwo5Ev6wMKzPkaXaCDIQKzLnvsA42DRlbVTWorkgTKIviAKCWkfUwA==",
-            "dev": true
-        },
-        "is-plain-object": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz",
-            "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==",
-            "dev": true,
-            "requires": {
-                "isobject": "^3.0.1"
-            }
-        },
-        "is-stream": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
-            "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
-            "dev": true
-        },
-        "is-wsl": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
-            "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
-            "dev": true,
-            "requires": {
-                "is-docker": "^2.0.0"
-            }
-        },
-        "isarray": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-            "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
-            "dev": true
-        },
-        "isexe": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-            "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-            "dev": true
-        },
-        "isobject": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz",
-            "integrity": "sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==",
-            "dev": true
-        },
-        "jackspeak": {
-            "version": "2.3.6",
-            "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-2.3.6.tgz",
-            "integrity": "sha512-N3yCS/NegsOBokc8GAdM8UcmfsKiSS8cipheD/nivzr700H+nsMOxJjQnvwOcRYVuFkdH0wGUvW2WbXGmrZGbQ==",
-            "dev": true,
-            "requires": {
-                "@isaacs/cliui": "^8.0.2",
-                "@pkgjs/parseargs": "^0.11.0"
-            }
-        },
-        "jest-worker": {
-            "version": "27.5.1",
-            "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-27.5.1.tgz",
-            "integrity": "sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==",
-            "dev": true,
-            "requires": {
-                "@types/node": "*",
-                "merge-stream": "^2.0.0",
-                "supports-color": "^8.0.0"
-            },
-            "dependencies": {
-                "has-flag": {
-                    "version": "4.0.0",
-                    "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-                    "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-                    "dev": true
-                },
-                "supports-color": {
-                    "version": "8.1.1",
-                    "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
-                    "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
-                    "dev": true,
-                    "requires": {
-                        "has-flag": "^4.0.0"
-                    }
-                }
-            }
-        },
-        "jiti": {
-            "version": "1.21.0",
-            "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.0.tgz",
-            "integrity": "sha512-gFqAIbuKyyso/3G2qhiO2OM6shY6EPP/R0+mkDbyspxKazh8BXDC5FiFsUjlczgdNz/vfra0da2y+aHrusLG/Q==",
-            "dev": true
-        },
-        "js-tokens": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
-            "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
-            "dev": true
-        },
-        "jsesc": {
-            "version": "2.5.2",
-            "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.2.tgz",
-            "integrity": "sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==",
-            "dev": true
-        },
-        "json-parse-even-better-errors": {
-            "version": "2.3.1",
-            "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
-            "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
-            "dev": true
-        },
-        "json-schema-traverse": {
-            "version": "0.4.1",
-            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-            "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
-            "dev": true
-        },
-        "json5": {
-            "version": "2.2.3",
-            "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
-            "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
-            "dev": true
-        },
-        "jsonfile": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz",
-            "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==",
-            "dev": true,
-            "requires": {
-                "graceful-fs": "^4.1.6",
-                "universalify": "^2.0.0"
-            }
-        },
-        "junk": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/junk/-/junk-3.1.0.tgz",
-            "integrity": "sha512-pBxcB3LFc8QVgdggvZWyeys+hnrNWg4OcZIU/1X59k5jQdLBlCsYGRQaz234SqoRLTCgMH00fY0xRJH+F9METQ==",
-            "dev": true
-        },
-        "kind-of": {
-            "version": "6.0.3",
-            "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
-            "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
-            "dev": true
-        },
-        "klona": {
-            "version": "2.0.5",
-            "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.5.tgz",
-            "integrity": "sha512-pJiBpiXMbt7dkzXe8Ghj/u4FfXOOa98fPW+bihOJ4SjnoijweJrNThJfd3ifXpXhREjpoF2mZVH1GfS9LV3kHQ==",
-            "dev": true
-        },
-        "laravel-mix": {
-            "version": "6.0.49",
-            "resolved": "https://registry.npmjs.org/laravel-mix/-/laravel-mix-6.0.49.tgz",
-            "integrity": "sha512-bBMFpFjp26XfijPvY5y9zGKud7VqlyOE0OWUcPo3vTBY5asw8LTjafAbee1dhfLz6PWNqDziz69CP78ELSpfKw==",
-            "dev": true,
-            "requires": {
-                "@babel/core": "^7.15.8",
-                "@babel/plugin-proposal-object-rest-spread": "^7.15.6",
-                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
-                "@babel/plugin-transform-runtime": "^7.15.8",
-                "@babel/preset-env": "^7.15.8",
-                "@babel/runtime": "^7.15.4",
-                "@types/babel__core": "^7.1.16",
-                "@types/clean-css": "^4.2.5",
-                "@types/imagemin-gifsicle": "^7.0.1",
-                "@types/imagemin-mozjpeg": "^8.0.1",
-                "@types/imagemin-optipng": "^5.2.1",
-                "@types/imagemin-svgo": "^8.0.0",
-                "autoprefixer": "^10.4.0",
-                "babel-loader": "^8.2.3",
-                "chalk": "^4.1.2",
-                "chokidar": "^3.5.2",
-                "clean-css": "^5.2.4",
-                "cli-table3": "^0.6.0",
-                "collect.js": "^4.28.5",
-                "commander": "^7.2.0",
-                "concat": "^1.0.3",
-                "css-loader": "^5.2.6",
-                "cssnano": "^5.0.8",
-                "dotenv": "^10.0.0",
-                "dotenv-expand": "^5.1.0",
-                "file-loader": "^6.2.0",
-                "fs-extra": "^10.0.0",
-                "glob": "^7.2.0",
-                "html-loader": "^1.3.2",
-                "imagemin": "^7.0.1",
-                "img-loader": "^4.0.0",
-                "lodash": "^4.17.21",
-                "md5": "^2.3.0",
-                "mini-css-extract-plugin": "^1.6.2",
-                "node-libs-browser": "^2.2.1",
-                "postcss-load-config": "^3.1.0",
-                "postcss-loader": "^6.2.0",
-                "semver": "^7.3.5",
-                "strip-ansi": "^6.0.0",
-                "style-loader": "^2.0.0",
-                "terser": "^5.9.0",
-                "terser-webpack-plugin": "^5.2.4",
-                "vue-style-loader": "^4.1.3",
-                "webpack": "^5.60.0",
-                "webpack-cli": "^4.9.1",
-                "webpack-dev-server": "^4.7.3",
-                "webpack-merge": "^5.8.0",
-                "webpack-notifier": "^1.14.1",
-                "webpackbar": "^5.0.0-3",
-                "yargs": "^17.2.1"
-            }
-        },
-        "lilconfig": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-2.1.0.tgz",
-            "integrity": "sha512-utWOt/GHzuUxnLKxB6dk81RoOeoNeHgbrXiuGk4yyF5qlRz+iIVWu56E2fqGHFrXz0QNUhLB/8nKqvRH66JKGQ==",
-            "dev": true
-        },
-        "lines-and-columns": {
-            "version": "1.2.4",
-            "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
-            "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
-            "dev": true
-        },
-        "loader-runner": {
-            "version": "4.3.0",
-            "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.0.tgz",
-            "integrity": "sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==",
-            "dev": true
-        },
-        "loader-utils": {
-            "version": "2.0.4",
-            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.4.tgz",
-            "integrity": "sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw==",
-            "dev": true,
-            "requires": {
-                "big.js": "^5.2.2",
-                "emojis-list": "^3.0.0",
-                "json5": "^2.1.2"
-            }
-        },
-        "locate-path": {
-            "version": "5.0.0",
-            "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
-            "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
-            "dev": true,
-            "requires": {
-                "p-locate": "^4.1.0"
-            }
-        },
-        "lodash": {
-            "version": "4.17.21",
-            "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
-            "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
-            "dev": true
-        },
-        "lodash.castarray": {
-            "version": "4.4.0",
-            "resolved": "https://registry.npmjs.org/lodash.castarray/-/lodash.castarray-4.4.0.tgz",
-            "integrity": "sha512-aVx8ztPv7/2ULbArGJ2Y42bG1mEQ5mGjpdvrbJcJFU3TbYybe+QlLS4pst9zV52ymy2in1KpFPiZnAOATxD4+Q==",
-            "dev": true
-        },
-        "lodash.debounce": {
-            "version": "4.0.8",
-            "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
-            "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==",
-            "dev": true
-        },
-        "lodash.isplainobject": {
-            "version": "4.0.6",
-            "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
-            "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
-            "dev": true
-        },
-        "lodash.memoize": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
-            "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
-            "dev": true
-        },
-        "lodash.merge": {
-            "version": "4.6.2",
-            "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
-            "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
-            "dev": true
-        },
-        "lodash.uniq": {
-            "version": "4.5.0",
-            "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz",
-            "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==",
-            "dev": true
-        },
-        "lower-case": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/lower-case/-/lower-case-2.0.2.tgz",
-            "integrity": "sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg==",
-            "dev": true,
-            "requires": {
-                "tslib": "^2.0.3"
-            }
-        },
-        "lru-cache": {
-            "version": "6.0.0",
-            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz",
-            "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==",
-            "dev": true,
-            "requires": {
-                "yallist": "^4.0.0"
-            }
-        },
-        "make-dir": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz",
-            "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==",
-            "dev": true,
-            "requires": {
-                "semver": "^6.0.0"
-            },
-            "dependencies": {
-                "semver": {
-                    "version": "6.3.1",
-                    "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
-                    "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
-                    "dev": true
-                }
-            }
-        },
-        "md5": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz",
-            "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==",
-            "dev": true,
-            "requires": {
-                "charenc": "0.0.2",
-                "crypt": "0.0.2",
-                "is-buffer": "~1.1.6"
-            }
-        },
-        "md5.js": {
-            "version": "1.3.5",
-            "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.5.tgz",
-            "integrity": "sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==",
-            "dev": true,
-            "requires": {
-                "hash-base": "^3.0.0",
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            }
-        },
-        "mdn-data": {
-            "version": "2.0.14",
-            "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.14.tgz",
-            "integrity": "sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==",
-            "dev": true
-        },
-        "media-typer": {
-            "version": "0.3.0",
-            "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
-            "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
-            "dev": true
-        },
-        "memfs": {
-            "version": "3.4.7",
-            "resolved": "https://registry.npmjs.org/memfs/-/memfs-3.4.7.tgz",
-            "integrity": "sha512-ygaiUSNalBX85388uskeCyhSAoOSgzBbtVCr9jA2RROssFL9Q19/ZXFqS+2Th2sr1ewNIWgFdLzLC3Yl1Zv+lw==",
-            "dev": true,
-            "requires": {
-                "fs-monkey": "^1.0.3"
-            }
-        },
-        "merge-descriptors": {
-            "version": "1.0.3",
-            "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
-            "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
-            "dev": true
-        },
-        "merge-stream": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
-            "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
-            "dev": true
-        },
-        "merge2": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
-            "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
-            "dev": true
-        },
-        "methods": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
-            "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
-            "dev": true
-        },
-        "micromatch": {
-            "version": "4.0.5",
-            "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.5.tgz",
-            "integrity": "sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==",
-            "dev": true,
-            "requires": {
-                "braces": "^3.0.2",
-                "picomatch": "^2.3.1"
-            }
-        },
-        "miller-rabin": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/miller-rabin/-/miller-rabin-4.0.1.tgz",
-            "integrity": "sha512-115fLhvZVqWwHPbClyntxEVfVDfl9DLLTuJvq3g2O/Oxi8AiNouAHvDSzHS0viUJc+V5vm3eq91Xwqn9dp4jRA==",
-            "dev": true,
-            "requires": {
-                "bn.js": "^4.0.0",
-                "brorand": "^1.0.1"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
-            }
-        },
-        "mime": {
-            "version": "1.6.0",
-            "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
-            "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
-            "dev": true
-        },
-        "mime-db": {
-            "version": "1.52.0",
-            "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
-            "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
-            "dev": true
-        },
-        "mime-types": {
-            "version": "2.1.35",
-            "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
-            "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
-            "dev": true,
-            "requires": {
-                "mime-db": "1.52.0"
-            }
-        },
-        "mimic-fn": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
-            "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
-            "dev": true
-        },
-        "mini-css-extract-plugin": {
-            "version": "1.6.2",
-            "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-1.6.2.tgz",
-            "integrity": "sha512-WhDvO3SjGm40oV5y26GjMJYjd2UMqrLAGKy5YS2/3QKJy2F7jgynuHTir/tgUUOiNQu5saXHdc8reo7YuhhT4Q==",
-            "dev": true,
-            "requires": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0",
-                "webpack-sources": "^1.1.0"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                }
-            }
-        },
-        "minimalistic-assert": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
-            "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
-            "dev": true
-        },
-        "minimalistic-crypto-utils": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
-            "integrity": "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==",
-            "dev": true
-        },
-        "minimatch": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-            "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
-            "dev": true,
-            "requires": {
-                "brace-expansion": "^1.1.7"
-            }
-        },
-        "minimist": {
-            "version": "1.2.6",
-            "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.6.tgz",
-            "integrity": "sha512-Jsjnk4bw3YJqYzbdyBiNsPWHPfO++UGG749Cxs6peCu5Xg4nrena6OVxOYxrQTqww0Jmwt+Ref8rggumkTLz9Q==",
-            "dev": true
-        },
-        "minipass": {
-            "version": "7.0.4",
-            "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.0.4.tgz",
-            "integrity": "sha512-jYofLM5Dam9279rdkWzqHozUo4ybjdZmCsDHePy5V/PbBcVMiSZR97gmAy45aqi8CK1lG2ECd356FU86avfwUQ==",
-            "dev": true
-        },
-        "ms": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.2.tgz",
-            "integrity": "sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==",
-            "dev": true
-        },
-        "multicast-dns": {
-            "version": "7.2.5",
-            "resolved": "https://registry.npmjs.org/multicast-dns/-/multicast-dns-7.2.5.tgz",
-            "integrity": "sha512-2eznPJP8z2BFLX50tf0LuODrpINqP1RVIm/CObbTcBRITQgmC/TjcREF1NeTBzIcR5XO/ukWo+YHOjBbFwIupg==",
-            "dev": true,
-            "requires": {
-                "dns-packet": "^5.2.2",
-                "thunky": "^1.0.2"
-            }
-        },
-        "mz": {
-            "version": "2.7.0",
-            "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
-            "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==",
-            "dev": true,
-            "requires": {
-                "any-promise": "^1.0.0",
-                "object-assign": "^4.0.1",
-                "thenify-all": "^1.0.0"
-            }
-        },
-        "nanoid": {
-            "version": "3.3.7",
-            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.7.tgz",
-            "integrity": "sha512-eSRppjcPIatRIMC1U6UngP8XFcz8MQWGQdt1MTBQ7NaAmvXDfvNxbvWV3x2y6CdEUciCSsDHDQZbhYaB8QEo2g==",
-            "dev": true
-        },
-        "negotiator": {
-            "version": "0.6.3",
-            "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
-            "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
-            "dev": true
-        },
-        "neo-async": {
-            "version": "2.6.2",
-            "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
-            "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
-            "dev": true
-        },
-        "no-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/no-case/-/no-case-3.0.4.tgz",
-            "integrity": "sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg==",
-            "dev": true,
-            "requires": {
-                "lower-case": "^2.0.2",
-                "tslib": "^2.0.3"
-            }
-        },
-        "node-forge": {
-            "version": "1.3.1",
-            "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.3.1.tgz",
-            "integrity": "sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==",
-            "dev": true
-        },
-        "node-libs-browser": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/node-libs-browser/-/node-libs-browser-2.2.1.tgz",
-            "integrity": "sha512-h/zcD8H9kaDZ9ALUWwlBUDo6TKF8a7qBSCSEGfjTVIYeqsioSKaAX+BN7NgiMGp6iSIXZ3PxgCu8KS3b71YK5Q==",
-            "dev": true,
-            "requires": {
-                "assert": "^1.1.1",
-                "browserify-zlib": "^0.2.0",
-                "buffer": "^4.3.0",
-                "console-browserify": "^1.1.0",
-                "constants-browserify": "^1.0.0",
-                "crypto-browserify": "^3.11.0",
-                "domain-browser": "^1.1.1",
-                "events": "^3.0.0",
-                "https-browserify": "^1.0.0",
-                "os-browserify": "^0.3.0",
-                "path-browserify": "0.0.1",
-                "process": "^0.11.10",
-                "punycode": "^1.2.4",
-                "querystring-es3": "^0.2.0",
-                "readable-stream": "^2.3.3",
-                "stream-browserify": "^2.0.1",
-                "stream-http": "^2.7.2",
-                "string_decoder": "^1.0.0",
-                "timers-browserify": "^2.0.4",
-                "tty-browserify": "0.0.0",
-                "url": "^0.11.0",
-                "util": "^0.11.0",
-                "vm-browserify": "^1.0.1"
-            }
-        },
-        "node-notifier": {
-            "version": "9.0.1",
-            "resolved": "https://registry.npmjs.org/node-notifier/-/node-notifier-9.0.1.tgz",
-            "integrity": "sha512-fPNFIp2hF/Dq7qLDzSg4vZ0J4e9v60gJR+Qx7RbjbWqzPDdEqeVpEx5CFeDAELIl+A/woaaNn1fQ5nEVerMxJg==",
-            "dev": true,
-            "requires": {
-                "growly": "^1.3.0",
-                "is-wsl": "^2.2.0",
-                "semver": "^7.3.2",
-                "shellwords": "^0.1.1",
-                "uuid": "^8.3.0",
-                "which": "^2.0.2"
-            }
-        },
-        "node-releases": {
-            "version": "2.0.18",
-            "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.18.tgz",
-            "integrity": "sha512-d9VeXT4SJ7ZeOqGX6R5EM022wpL+eWPooLI+5UpWn2jCT1aosUQEhQP214x33Wkwx3JQMvIm+tIoVOdodFS40g==",
-            "dev": true
-        },
-        "normalize-path": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
-            "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
-            "dev": true
-        },
-        "normalize-range": {
-            "version": "0.1.2",
-            "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",
-            "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",
-            "dev": true
-        },
-        "normalize-url": {
-            "version": "6.1.0",
-            "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
-            "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
-            "dev": true
-        },
-        "npm-run-path": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
-            "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
-            "dev": true,
-            "requires": {
-                "path-key": "^3.0.0"
-            }
-        },
-        "nth-check": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
-            "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
-            "dev": true,
-            "requires": {
-                "boolbase": "^1.0.0"
-            }
-        },
-        "object-assign": {
-            "version": "4.1.1",
-            "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
-            "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
-            "dev": true
-        },
-        "object-hash": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
-            "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
-            "dev": true
-        },
-        "object-inspect": {
-            "version": "1.13.2",
-            "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.2.tgz",
-            "integrity": "sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==",
-            "dev": true
-        },
-        "object-keys": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
-            "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
-            "dev": true
-        },
-        "object.assign": {
-            "version": "4.1.2",
-            "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.2.tgz",
-            "integrity": "sha512-ixT2L5THXsApyiUPYKmW+2EHpXXe5Ii3M+f4e+aJFAHao5amFRW6J0OO6c/LU8Be47utCx2GL89hxGB6XSmKuQ==",
-            "dev": true,
-            "requires": {
-                "call-bind": "^1.0.0",
-                "define-properties": "^1.1.3",
-                "has-symbols": "^1.0.1",
-                "object-keys": "^1.1.1"
-            }
-        },
-        "obuf": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/obuf/-/obuf-1.1.2.tgz",
-            "integrity": "sha512-PX1wu0AmAdPqOL1mWhqmlOd8kOIZQwGZw6rh7uby9fTc5lhaOWFLX3I6R1hrF9k3zUY40e6igsLGkDXK92LJNg==",
-            "dev": true
-        },
-        "on-finished": {
-            "version": "2.4.1",
-            "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
-            "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
-            "dev": true,
-            "requires": {
-                "ee-first": "1.1.1"
-            }
-        },
-        "on-headers": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.0.2.tgz",
-            "integrity": "sha512-pZAE+FJLoyITytdqK0U5s+FIpjN0JP3OzFi/u8Rx+EV5/W+JTWGXG8xFzevE7AjBfDqHv/8vL8qQsIhHnqRkrA==",
-            "dev": true
-        },
-        "once": {
-            "version": "1.4.0",
-            "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-            "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
-            "dev": true,
-            "requires": {
-                "wrappy": "1"
-            }
-        },
-        "onetime": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
-            "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
-            "dev": true,
-            "requires": {
-                "mimic-fn": "^2.1.0"
-            }
+        "@esbuild/android-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "dev": true,
+            "optional": true
         },
-        "open": {
-            "version": "8.4.0",
-            "resolved": "https://registry.npmjs.org/open/-/open-8.4.0.tgz",
-            "integrity": "sha512-XgFPPM+B28FtCCgSb9I+s9szOC1vZRSwgWsRUA5ylIxRTgKozqjOCrVOqGsYABPYK5qnfqClxZTFBa8PKt2v6Q==",
+        "@esbuild/darwin-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
             "dev": true,
-            "requires": {
-                "define-lazy-prop": "^2.0.0",
-                "is-docker": "^2.1.1",
-                "is-wsl": "^2.2.0"
-            }
+            "optional": true
         },
-        "os-browserify": {
-            "version": "0.3.0",
-            "resolved": "https://registry.npmjs.org/os-browserify/-/os-browserify-0.3.0.tgz",
-            "integrity": "sha512-gjcpUc3clBf9+210TRaDWbf+rZZZEshZ+DlXMRCeAjp0xhTrnQsKHypIy1J3d5hKdUzj69t708EHtU8P6bUn0A==",
-            "dev": true
+        "@esbuild/darwin-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "dev": true,
+            "optional": true
         },
-        "p-limit": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
-            "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+        "@esbuild/freebsd-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
             "dev": true,
-            "requires": {
-                "p-try": "^2.0.0"
-            }
+            "optional": true
         },
-        "p-locate": {
-            "version": "4.1.0",
-            "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
-            "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+        "@esbuild/freebsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
             "dev": true,
-            "requires": {
-                "p-limit": "^2.2.0"
-            }
+            "optional": true
         },
-        "p-pipe": {
-            "version": "3.1.0",
-            "resolved": "https://registry.npmjs.org/p-pipe/-/p-pipe-3.1.0.tgz",
-            "integrity": "sha512-08pj8ATpzMR0Y80x50yJHn37NF6vjrqHutASaX5LiH5npS9XPvrUmscd9MF5R4fuYRHOxQR1FfMIlF7AzwoPqw==",
-            "dev": true
+        "@esbuild/linux-arm": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "dev": true,
+            "optional": true
         },
-        "p-retry": {
-            "version": "4.6.2",
-            "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",
-            "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",
+        "@esbuild/linux-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
             "dev": true,
-            "requires": {
-                "@types/retry": "0.12.0",
-                "retry": "^0.13.1"
-            }
+            "optional": true
         },
-        "p-try": {
-            "version": "2.2.0",
-            "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
-            "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
-            "dev": true
+        "@esbuild/linux-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "dev": true,
+            "optional": true
         },
-        "pako": {
-            "version": "1.0.11",
-            "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
-            "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
-            "dev": true
+        "@esbuild/linux-loong64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "dev": true,
+            "optional": true
         },
-        "param-case": {
-            "version": "3.0.4",
-            "resolved": "https://registry.npmjs.org/param-case/-/param-case-3.0.4.tgz",
-            "integrity": "sha512-RXlj7zCYokReqWpOPH9oYivUzLYZ5vAPIfEmCTNViosC78F8F0H9y7T7gG2M39ymgutxF5gcFEsyZQSph9Bp3A==",
+        "@esbuild/linux-mips64el": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
             "dev": true,
-            "requires": {
-                "dot-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
+            "optional": true
         },
-        "parent-module": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
-            "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
+        "@esbuild/linux-ppc64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
             "dev": true,
-            "requires": {
-                "callsites": "^3.0.0"
-            }
+            "optional": true
         },
-        "parse-asn1": {
-            "version": "5.1.6",
-            "resolved": "https://registry.npmjs.org/parse-asn1/-/parse-asn1-5.1.6.tgz",
-            "integrity": "sha512-RnZRo1EPU6JBnra2vGHj0yhp6ebyjBZpmUCLHWiFhxlzvBCCpAuZ7elsBp1PVAbQN0/04VD/19rfzlBSwLstMw==",
+        "@esbuild/linux-riscv64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
             "dev": true,
-            "requires": {
-                "asn1.js": "^5.2.0",
-                "browserify-aes": "^1.0.0",
-                "evp_bytestokey": "^1.0.0",
-                "pbkdf2": "^3.0.3",
-                "safe-buffer": "^5.1.1"
-            }
+            "optional": true
         },
-        "parse-json": {
-            "version": "5.2.0",
-            "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
-            "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
+        "@esbuild/linux-s390x": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
             "dev": true,
-            "requires": {
-                "@babel/code-frame": "^7.0.0",
-                "error-ex": "^1.3.1",
-                "json-parse-even-better-errors": "^2.3.0",
-                "lines-and-columns": "^1.1.6"
-            }
+            "optional": true
         },
-        "parseurl": {
-            "version": "1.3.3",
-            "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
-            "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
-            "dev": true
+        "@esbuild/linux-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "dev": true,
+            "optional": true
         },
-        "pascal-case": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/pascal-case/-/pascal-case-3.1.2.tgz",
-            "integrity": "sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g==",
+        "@esbuild/netbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
             "dev": true,
-            "requires": {
-                "no-case": "^3.0.4",
-                "tslib": "^2.0.3"
-            }
+            "optional": true
         },
-        "path-browserify": {
-            "version": "0.0.1",
-            "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-0.0.1.tgz",
-            "integrity": "sha512-BapA40NHICOS+USX9SN4tyhq+A2RrN/Ws5F0Z5aMHDp98Fl86lX8Oti8B7uN93L4Ifv4fHOEA+pQw87gmMO/lQ==",
-            "dev": true
+        "@esbuild/openbsd-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "dev": true,
+            "optional": true
         },
-        "path-exists": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
-            "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
-            "dev": true
+        "@esbuild/sunos-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "dev": true,
+            "optional": true
         },
-        "path-is-absolute": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
-            "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
-            "dev": true
+        "@esbuild/win32-arm64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "dev": true,
+            "optional": true
         },
-        "path-key": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
-            "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-            "dev": true
+        "@esbuild/win32-ia32": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "dev": true,
+            "optional": true
         },
-        "path-parse": {
-            "version": "1.0.7",
-            "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
-            "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
-            "dev": true
+        "@esbuild/win32-x64": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "dev": true,
+            "optional": true
         },
-        "path-scurry": {
-            "version": "1.10.2",
-            "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.10.2.tgz",
-            "integrity": "sha512-7xTavNy5RQXnsjANvVvMkEjvloOinkAjv/Z6Ildz9v2RinZ4SBKTWFOVRbaF8p0vpHnyjV/UwNDdKuUv6M5qcA==",
+        "@isaacs/cliui": {
+            "version": "8.0.2",
             "dev": true,
             "requires": {
-                "lru-cache": "^10.2.0",
-                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+                "string-width": "^5.1.2",
+                "string-width-cjs": "npm:string-width@^4.2.0",
+                "strip-ansi": "^7.0.1",
+                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+                "wrap-ansi": "^8.1.0",
+                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
             },
             "dependencies": {
-                "lru-cache": {
-                    "version": "10.2.1",
-                    "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.2.1.tgz",
-                    "integrity": "sha512-tS24spDe/zXhWbNPErCHs/AGOzbKGHT+ybSBqmdLm8WZ1xXLWvH8Qn71QPAlqVhd0qUTWjy+Kl9JmISgDdEjsA==",
+                "ansi-regex": {
+                    "version": "6.1.0",
+                    "dev": true
+                },
+                "ansi-styles": {
+                    "version": "6.2.1",
+                    "dev": true
+                },
+                "emoji-regex": {
+                    "version": "9.2.2",
                     "dev": true
+                },
+                "string-width": {
+                    "version": "5.1.2",
+                    "dev": true,
+                    "requires": {
+                        "eastasianwidth": "^0.2.0",
+                        "emoji-regex": "^9.2.2",
+                        "strip-ansi": "^7.0.1"
+                    }
+                },
+                "strip-ansi": {
+                    "version": "7.1.0",
+                    "dev": true,
+                    "requires": {
+                        "ansi-regex": "^6.0.1"
+                    }
+                },
+                "wrap-ansi": {
+                    "version": "8.1.0",
+                    "dev": true,
+                    "requires": {
+                        "ansi-styles": "^6.1.0",
+                        "string-width": "^5.0.1",
+                        "strip-ansi": "^7.0.1"
+                    }
                 }
             }
         },
-        "path-to-regexp": {
-            "version": "0.1.10",
-            "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.10.tgz",
-            "integrity": "sha512-7lf7qcQidTku0Gu3YDPc8DJ1q7OOucfa/BSsIwjuh56VU7katFvuM8hULfkwB3Fns/rsVF7PwPKVw1sl5KQS9w==",
-            "dev": true
-        },
-        "path-type": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
-            "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
-            "dev": true
-        },
-        "pbkdf2": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.1.2.tgz",
-            "integrity": "sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==",
+        "@jridgewell/gen-mapping": {
+            "version": "0.3.5",
             "dev": true,
             "requires": {
-                "create-hash": "^1.1.2",
-                "create-hmac": "^1.1.4",
-                "ripemd160": "^2.0.1",
-                "safe-buffer": "^5.0.1",
-                "sha.js": "^2.4.8"
+                "@jridgewell/set-array": "^1.2.1",
+                "@jridgewell/sourcemap-codec": "^1.4.10",
+                "@jridgewell/trace-mapping": "^0.3.24"
             }
         },
-        "picocolors": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.0.tgz",
-            "integrity": "sha512-TQ92mBOW0l3LeMeyLV6mzy/kWr8lkd/hp3mTg7wYK7zJhuBStmGMBG0BdeDZS/dZx1IukaX6Bk11zcln25o1Aw==",
-            "dev": true
-        },
-        "picomatch": {
-            "version": "2.3.1",
-            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-            "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-            "dev": true
-        },
-        "pify": {
-            "version": "2.3.0",
-            "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
-            "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==",
+        "@jridgewell/resolve-uri": {
+            "version": "3.1.2",
             "dev": true
         },
-        "pirates": {
-            "version": "4.0.6",
-            "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.6.tgz",
-            "integrity": "sha512-saLsH7WeYYPiD25LDuLRRY/i+6HaPYr6G1OUlN39otzkSTxKnubR9RTxS3/Kk50s1g2JTgFwWQDQyplC5/SHZg==",
+        "@jridgewell/set-array": {
+            "version": "1.2.1",
             "dev": true
         },
-        "pkg-dir": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz",
-            "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==",
-            "dev": true,
-            "requires": {
-                "find-up": "^4.0.0"
-            }
-        },
-        "postcss": {
-            "version": "8.4.47",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.47.tgz",
-            "integrity": "sha512-56rxCq7G/XfB4EkXq9Egn5GCqugWvDFjafDOThIdMBsI15iqPqR5r15TfSr1YPYeEI19YeaXMCbY6u88Y76GLQ==",
+        "@jridgewell/source-map": {
+            "version": "0.3.6",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
-                "nanoid": "^3.3.7",
-                "picocolors": "^1.1.0",
-                "source-map-js": "^1.2.1"
+                "@jridgewell/gen-mapping": "^0.3.5",
+                "@jridgewell/trace-mapping": "^0.3.25"
             }
         },
-        "postcss-calc": {
-            "version": "8.2.4",
-            "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-8.2.4.tgz",
-            "integrity": "sha512-SmWMSJmB8MRnnULldx0lQIyhSNvuDl9HfrZkaqqE/WHAhToYsAvDq+yAsA/kIyINDszOp3Rh0GFoNuH5Ypsm3Q==",
-            "dev": true,
-            "requires": {
-                "postcss-selector-parser": "^6.0.9",
-                "postcss-value-parser": "^4.2.0"
-            }
+        "@jridgewell/sourcemap-codec": {
+            "version": "1.5.0",
+            "dev": true
         },
-        "postcss-colormin": {
-            "version": "5.3.0",
-            "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-5.3.0.tgz",
-            "integrity": "sha512-WdDO4gOFG2Z8n4P8TWBpshnL3JpmNmJwdnfP2gbk2qBA8PWwOYcmjmI/t3CmMeL72a7Hkd+x/Mg9O2/0rD54Pg==",
+        "@jridgewell/trace-mapping": {
+            "version": "0.3.25",
             "dev": true,
             "requires": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0",
-                "colord": "^2.9.1",
-                "postcss-value-parser": "^4.2.0"
+                "@jridgewell/resolve-uri": "^3.1.0",
+                "@jridgewell/sourcemap-codec": "^1.4.14"
             }
         },
-        "postcss-convert-values": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-5.1.2.tgz",
-            "integrity": "sha512-c6Hzc4GAv95B7suy4udszX9Zy4ETyMCgFPUDtWjdFTKH1SE9eFY/jEpHSwTH1QPuwxHpWslhckUQWbNRM4ho5g==",
+        "@nodelib/fs.scandir": {
+            "version": "2.1.5",
             "dev": true,
             "requires": {
-                "browserslist": "^4.20.3",
-                "postcss-value-parser": "^4.2.0"
+                "@nodelib/fs.stat": "2.0.5",
+                "run-parallel": "^1.1.9"
             }
         },
-        "postcss-discard-comments": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-5.1.2.tgz",
-            "integrity": "sha512-+L8208OVbHVF2UQf1iDmRcbdjJkuBF6IS29yBDSiWUIzpYaAhtNl6JYnYm12FnkeCwQqF5LeklOu6rAqgfBZqQ==",
-            "dev": true,
-            "requires": {}
-        },
-        "postcss-discard-duplicates": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-5.1.0.tgz",
-            "integrity": "sha512-zmX3IoSI2aoenxHV6C7plngHWWhUOV3sP1T8y2ifzxzbtnuhk1EdPwm0S1bIUNaJ2eNbWeGLEwzw8huPD67aQw==",
-            "dev": true,
-            "requires": {}
-        },
-        "postcss-discard-empty": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-5.1.1.tgz",
-            "integrity": "sha512-zPz4WljiSuLWsI0ir4Mcnr4qQQ5e1Ukc3i7UfE2XcrwKK2LIPIqE5jxMRxO6GbI3cv//ztXDsXwEWT3BHOGh3A==",
-            "dev": true,
-            "requires": {}
-        },
-        "postcss-discard-overridden": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-5.1.0.tgz",
-            "integrity": "sha512-21nOL7RqWR1kasIVdKs8HNqQJhFxLsyRfAnUDm4Fe4t4mCWL9OJiHvlHPjcd8zc5Myu89b/7wZDnOSjFgeWRtw==",
-            "dev": true,
-            "requires": {}
-        },
-        "postcss-import": {
-            "version": "15.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-15.1.0.tgz",
-            "integrity": "sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==",
-            "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.0.0",
-                "read-cache": "^1.0.0",
-                "resolve": "^1.1.7"
-            }
+        "@nodelib/fs.stat": {
+            "version": "2.0.5",
+            "dev": true
         },
-        "postcss-js": {
-            "version": "4.0.1",
-            "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.0.1.tgz",
-            "integrity": "sha512-dDLF8pEO191hJMtlHFPRa8xsizHaM82MLfNkUHdUtVEV3tgTp5oj+8qbEqYM57SLfc74KSbw//4SeJma2LRVIw==",
+        "@nodelib/fs.walk": {
+            "version": "1.2.8",
             "dev": true,
             "requires": {
-                "camelcase-css": "^2.0.1"
+                "@nodelib/fs.scandir": "2.1.5",
+                "fastq": "^1.6.0"
             }
         },
-        "postcss-load-config": {
-            "version": "3.1.4",
-            "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-3.1.4.tgz",
-            "integrity": "sha512-6DiM4E7v4coTE4uzA8U//WhtPwyhiim3eyjEMFCnUpzbrkK9wJHgKDT2mR+HbtSrd/NubVaYTOpSpjUl8NQeRg==",
+        "@pkgjs/parseargs": {
+            "version": "0.11.0",
             "dev": true,
-            "requires": {
-                "lilconfig": "^2.0.5",
-                "yaml": "^1.10.2"
-            }
+            "optional": true
         },
-        "postcss-loader": {
-            "version": "6.2.1",
-            "resolved": "https://registry.npmjs.org/postcss-loader/-/postcss-loader-6.2.1.tgz",
-            "integrity": "sha512-WbbYpmAaKcux/P66bZ40bpWsBucjx/TTgVVzRZ9yUO8yQfVBlameJ0ZGVaPfH64hNSBh63a+ICP5nqOpBA0w+Q==",
+        "@rollup/rollup-android-arm-eabi": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
+            "integrity": "sha512-CC/ZqFZwlAIbU1wUPisHyV/XRc5RydFrNLtgl3dGYskdwPZdt4HERtKm50a/+DtTlKeCq9IXFEWR+P6blwjqBA==",
             "dev": true,
-            "requires": {
-                "cosmiconfig": "^7.0.0",
-                "klona": "^2.0.5",
-                "semver": "^7.3.5"
-            }
+            "optional": true
         },
-        "postcss-merge-longhand": {
-            "version": "5.1.6",
-            "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-5.1.6.tgz",
-            "integrity": "sha512-6C/UGF/3T5OE2CEbOuX7iNO63dnvqhGZeUnKkDeifebY0XqkkvrctYSZurpNE902LDf2yKwwPFgotnfSoPhQiw==",
+        "@rollup/rollup-android-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.25.0.tgz",
+            "integrity": "sha512-/Y76tmLGUJqVBXXCfVS8Q8FJqYGhgH4wl4qTA24E9v/IJM0XvJCGQVSW1QZ4J+VURO9h8YCa28sTFacZXwK7Rg==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0",
-                "stylehacks": "^5.1.0"
-            }
+            "optional": true
         },
-        "postcss-merge-rules": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-5.1.2.tgz",
-            "integrity": "sha512-zKMUlnw+zYCWoPN6yhPjtcEdlJaMUZ0WyVcxTAmw3lkkN/NDMRkOkiuctQEoWAOvH7twaxUUdvBWl0d4+hifRQ==",
+        "@rollup/rollup-darwin-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.25.0.tgz",
+            "integrity": "sha512-YVT6L3UrKTlC0FpCZd0MGA7NVdp7YNaEqkENbWQ7AOVOqd/7VzyHpgIpc1mIaxRAo1ZsJRH45fq8j4N63I/vvg==",
             "dev": true,
-            "requires": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0",
-                "cssnano-utils": "^3.1.0",
-                "postcss-selector-parser": "^6.0.5"
-            }
+            "optional": true
         },
-        "postcss-minify-font-values": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-5.1.0.tgz",
-            "integrity": "sha512-el3mYTgx13ZAPPirSVsHqFzl+BBBDrXvbySvPGFnQcTI4iNslrPaFq4muTkLZmKlGk4gyFAYUBMH30+HurREyA==",
+        "@rollup/rollup-darwin-x64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.25.0.tgz",
+            "integrity": "sha512-ZRL+gexs3+ZmmWmGKEU43Bdn67kWnMeWXLFhcVv5Un8FQcx38yulHBA7XR2+KQdYIOtD0yZDWBCudmfj6lQJoA==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-minify-gradients": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-5.1.1.tgz",
-            "integrity": "sha512-VGvXMTpCEo4qHTNSa9A0a3D+dxGFZCYwR6Jokk+/3oB6flu2/PnPXAh2x7x52EkY5xlIHLm+Le8tJxe/7TNhzw==",
+        "@rollup/rollup-freebsd-arm64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.25.0.tgz",
+            "integrity": "sha512-xpEIXhiP27EAylEpreCozozsxWQ2TJbOLSivGfXhU4G1TBVEYtUPi2pOZBnvGXHyOdLAUUhPnJzH3ah5cqF01g==",
             "dev": true,
-            "requires": {
-                "colord": "^2.9.1",
-                "cssnano-utils": "^3.1.0",
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-minify-params": {
-            "version": "5.1.3",
-            "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-5.1.3.tgz",
-            "integrity": "sha512-bkzpWcjykkqIujNL+EVEPOlLYi/eZ050oImVtHU7b4lFS82jPnsCb44gvC6pxaNt38Els3jWYDHTjHKf0koTgg==",
+        "@rollup/rollup-freebsd-x64": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.25.0.tgz",
+            "integrity": "sha512-sC5FsmZGlJv5dOcURrsnIK7ngc3Kirnx3as2XU9uER+zjfyqIjdcMVgzy4cOawhsssqzoAX19qmxgJ8a14Qrqw==",
             "dev": true,
-            "requires": {
-                "browserslist": "^4.16.6",
-                "cssnano-utils": "^3.1.0",
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-minify-selectors": {
-            "version": "5.2.1",
-            "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-5.2.1.tgz",
-            "integrity": "sha512-nPJu7OjZJTsVUmPdm2TcaiohIwxP+v8ha9NehQ2ye9szv4orirRU3SDdtUmKH+10nzn0bAyOXZ0UEr7OpvLehg==",
+        "@rollup/rollup-linux-arm-gnueabihf": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.25.0.tgz",
+            "integrity": "sha512-uD/dbLSs1BEPzg564TpRAQ/YvTnCds2XxyOndAO8nJhaQcqQGFgv/DAVko/ZHap3boCvxnzYMa3mTkV/B/3SWA==",
             "dev": true,
-            "requires": {
-                "postcss-selector-parser": "^6.0.5"
-            }
+            "optional": true
         },
-        "postcss-modules-extract-imports": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.0.0.tgz",
-            "integrity": "sha512-bdHleFnP3kZ4NYDhuGlVK+CMrQ/pqUm8bx/oGL93K6gVwiclvX5x0n76fYMKuIGKzlABOy13zsvqjb0f92TEXw==",
+        "@rollup/rollup-linux-arm-musleabihf": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.25.0.tgz",
+            "integrity": "sha512-ZVt/XkrDlQWegDWrwyC3l0OfAF7yeJUF4fq5RMS07YM72BlSfn2fQQ6lPyBNjt+YbczMguPiJoCfaQC2dnflpQ==",
             "dev": true,
-            "requires": {}
+            "optional": true
         },
-        "postcss-modules-local-by-default": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.0.0.tgz",
-            "integrity": "sha512-sT7ihtmGSF9yhm6ggikHdV0hlziDTX7oFoXtuVWeDd3hHObNkcHRo9V3yg7vCAY7cONyxJC/XXCmmiHHcvX7bQ==",
+        "@rollup/rollup-linux-arm64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.25.0.tgz",
+            "integrity": "sha512-qboZ+T0gHAW2kkSDPHxu7quaFaaBlynODXpBVnPxUgvWYaE84xgCKAPEYE+fSMd3Zv5PyFZR+L0tCdYCMAtG0A==",
             "dev": true,
-            "requires": {
-                "icss-utils": "^5.0.0",
-                "postcss-selector-parser": "^6.0.2",
-                "postcss-value-parser": "^4.1.0"
-            }
+            "optional": true
         },
-        "postcss-modules-scope": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-scope/-/postcss-modules-scope-3.0.0.tgz",
-            "integrity": "sha512-hncihwFA2yPath8oZ15PZqvWGkWf+XUfQgUGamS4LqoP1anQLOsOJw0vr7J7IwLpoY9fatA2qiGUGmuZL0Iqlg==",
+        "@rollup/rollup-linux-arm64-musl": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.25.0.tgz",
+            "integrity": "sha512-ndWTSEmAaKr88dBuogGH2NZaxe7u2rDoArsejNslugHZ+r44NfWiwjzizVS1nUOHo+n1Z6qV3X60rqE/HlISgw==",
             "dev": true,
-            "requires": {
-                "postcss-selector-parser": "^6.0.4"
-            }
+            "optional": true
         },
-        "postcss-modules-values": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz",
-            "integrity": "sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==",
+        "@rollup/rollup-linux-powerpc64le-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.25.0.tgz",
+            "integrity": "sha512-BVSQvVa2v5hKwJSy6X7W1fjDex6yZnNKy3Kx1JGimccHft6HV0THTwNtC2zawtNXKUu+S5CjXslilYdKBAadzA==",
             "dev": true,
-            "requires": {
-                "icss-utils": "^5.0.0"
-            }
+            "optional": true
         },
-        "postcss-nested": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.0.1.tgz",
-            "integrity": "sha512-mEp4xPMi5bSWiMbsgoPfcP74lsWLHkQbZc3sY+jWYd65CUwXrUaTp0fmNpa01ZcETKlIgUdFN/MpS2xZtqL9dQ==",
+        "@rollup/rollup-linux-riscv64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.25.0.tgz",
+            "integrity": "sha512-G4hTREQrIdeV0PE2JruzI+vXdRnaK1pg64hemHq2v5fhv8C7WjVaeXc9P5i4Q5UC06d/L+zA0mszYIKl+wY8oA==",
             "dev": true,
-            "requires": {
-                "postcss-selector-parser": "^6.0.11"
-            },
-            "dependencies": {
-                "postcss-selector-parser": {
-                    "version": "6.0.16",
-                    "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.16.tgz",
-                    "integrity": "sha512-A0RVJrX+IUkVZbW3ClroRWurercFhieevHB38sr2+l9eUClMqome3LmEmnhlNy+5Mr2EYN6B2Kaw9wYdd+VHiw==",
-                    "dev": true,
-                    "requires": {
-                        "cssesc": "^3.0.0",
-                        "util-deprecate": "^1.0.2"
-                    }
-                }
-            }
+            "optional": true
         },
-        "postcss-normalize-charset": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-5.1.0.tgz",
-            "integrity": "sha512-mSgUJ+pd/ldRGVx26p2wz9dNZ7ji6Pn8VWBajMXFf8jk7vUoSrZ2lt/wZR7DtlZYKesmZI680qjr2CeFF2fbUg==",
+        "@rollup/rollup-linux-s390x-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.25.0.tgz",
+            "integrity": "sha512-9T/w0kQ+upxdkFL9zPVB6zy9vWW1deA3g8IauJxojN4bnz5FwSsUAD034KpXIVX5j5p/rn6XqumBMxfRkcHapQ==",
             "dev": true,
-            "requires": {}
+            "optional": true
         },
-        "postcss-normalize-display-values": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-display-values/-/postcss-normalize-display-values-5.1.0.tgz",
-            "integrity": "sha512-WP4KIM4o2dazQXWmFaqMmcvsKmhdINFblgSeRgn8BJ6vxaMyaJkwAzpPpuvSIoG/rmX3M+IrRZEz2H0glrQNEA==",
+        "@rollup/rollup-linux-x64-gnu": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.25.0.tgz",
+            "integrity": "sha512-ThcnU0EcMDn+J4B9LD++OgBYxZusuA7iemIIiz5yzEcFg04VZFzdFjuwPdlURmYPZw+fgVrFzj4CA64jSTG4Ig==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-normalize-positions": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-positions/-/postcss-normalize-positions-5.1.1.tgz",
-            "integrity": "sha512-6UpCb0G4eofTCQLFVuI3EVNZzBNPiIKcA1AKVka+31fTVySphr3VUgAIULBhxZkKgwLImhzMR2Bw1ORK+37INg==",
+        "@rollup/rollup-linux-x64-musl": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.25.0.tgz",
+            "integrity": "sha512-zx71aY2oQxGxAT1JShfhNG79PnjYhMC6voAjzpu/xmMjDnKNf6Nl/xv7YaB/9SIa9jDYf8RBPWEnjcdlhlv1rQ==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-normalize-repeat-style": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-5.1.1.tgz",
-            "integrity": "sha512-mFpLspGWkQtBcWIRFLmewo8aC3ImN2i/J3v8YCFUwDnPu3Xz4rLohDO26lGjwNsQxB3YF0KKRwspGzE2JEuS0g==",
+        "@rollup/rollup-win32-arm64-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.25.0.tgz",
+            "integrity": "sha512-JT8tcjNocMs4CylWY/CxVLnv8e1lE7ff1fi6kbGocWwxDq9pj30IJ28Peb+Y8yiPNSF28oad42ApJB8oUkwGww==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
         },
-        "postcss-normalize-string": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-string/-/postcss-normalize-string-5.1.0.tgz",
-            "integrity": "sha512-oYiIJOf4T9T1N4i+abeIc7Vgm/xPCGih4bZz5Nm0/ARVJ7K6xrDlLwvwqOydvyL3RHNf8qZk6vo3aatiw/go3w==",
+        "@rollup/rollup-win32-ia32-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.25.0.tgz",
+            "integrity": "sha512-dRLjLsO3dNOfSN6tjyVlG+Msm4IiZnGkuZ7G5NmpzwF9oOc582FZG05+UdfTbz5Jd4buK/wMb6UeHFhG18+OEg==",
             "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.2.0"
-            }
+            "optional": true
+        },
+        "@rollup/rollup-win32-x64-msvc": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.25.0.tgz",
+            "integrity": "sha512-/RqrIFtLB926frMhZD0a5oDa4eFIbyNEwLLloMTEjmqfwZWXywwVVOVmwTsuyhC9HKkVEZcOOi+KV4U9wmOdlg==",
+            "dev": true,
+            "optional": true
         },
-        "postcss-normalize-timing-functions": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-5.1.0.tgz",
-            "integrity": "sha512-DOEkzJ4SAXv5xkHl0Wa9cZLF3WCBhF3o1SKVxKQAa+0pYKlueTpCgvkFAHfk+Y64ezX9+nITGrDZeVGgITJXjg==",
+        "@tailwindcss/typography": {
+            "version": "0.5.15",
             "dev": true,
             "requires": {
-                "postcss-value-parser": "^4.2.0"
+                "lodash.castarray": "^4.4.0",
+                "lodash.isplainobject": "^4.0.6",
+                "lodash.merge": "^4.6.2",
+                "postcss-selector-parser": "6.0.10"
             }
         },
-        "postcss-normalize-unicode": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-unicode/-/postcss-normalize-unicode-5.1.0.tgz",
-            "integrity": "sha512-J6M3MizAAZ2dOdSjy2caayJLQT8E8K9XjLce8AUQMwOrCvjCHv24aLC/Lps1R1ylOfol5VIDMaM/Lo9NGlk1SQ==",
+        "@types/estree": {
+            "version": "1.0.6",
+            "dev": true
+        },
+        "@types/node": {
+            "version": "22.9.0",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
-                "browserslist": "^4.16.6",
-                "postcss-value-parser": "^4.2.0"
+                "undici-types": "~6.19.8"
             }
         },
-        "postcss-normalize-url": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-5.1.0.tgz",
-            "integrity": "sha512-5upGeDO+PVthOxSmds43ZeMeZfKH+/DKgGRD7TElkkyS46JXAUhMzIKiCa7BabPeIy3AQcTkXwVVN7DbqsiCew==",
+        "acorn": {
+            "version": "8.14.0",
+            "dev": true,
+            "optional": true,
+            "peer": true
+        },
+        "ansi-regex": {
+            "version": "5.0.1",
+            "dev": true
+        },
+        "ansi-styles": {
+            "version": "4.3.0",
             "dev": true,
             "requires": {
-                "normalize-url": "^6.0.1",
-                "postcss-value-parser": "^4.2.0"
+                "color-convert": "^2.0.1"
             }
         },
-        "postcss-normalize-whitespace": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-normalize-whitespace/-/postcss-normalize-whitespace-5.1.1.tgz",
-            "integrity": "sha512-83ZJ4t3NUDETIHTa3uEg6asWjSBYL5EdkVB0sDncx9ERzOKBVJIUeDO9RyA9Zwtig8El1d79HBp0JEi8wvGQnA==",
+        "any-promise": {
+            "version": "1.3.0",
+            "dev": true
+        },
+        "anymatch": {
+            "version": "3.1.3",
             "dev": true,
             "requires": {
-                "postcss-value-parser": "^4.2.0"
+                "normalize-path": "^3.0.0",
+                "picomatch": "^2.0.4"
             }
         },
-        "postcss-ordered-values": {
-            "version": "5.1.3",
-            "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-5.1.3.tgz",
-            "integrity": "sha512-9UO79VUhPwEkzbb3RNpqqghc6lcYej1aveQteWY+4POIwlqkYE21HKWaLDF6lWNuqCobEAyTovVhtI32Rbv2RQ==",
+        "arg": {
+            "version": "5.0.2",
+            "dev": true
+        },
+        "autoprefixer": {
+            "version": "10.4.20",
             "dev": true,
             "requires": {
-                "cssnano-utils": "^3.1.0",
+                "browserslist": "^4.23.3",
+                "caniuse-lite": "^1.0.30001646",
+                "fraction.js": "^4.3.7",
+                "normalize-range": "^0.1.2",
+                "picocolors": "^1.0.1",
                 "postcss-value-parser": "^4.2.0"
             }
         },
-        "postcss-reduce-initial": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-5.1.0.tgz",
-            "integrity": "sha512-5OgTUviz0aeH6MtBjHfbr57tml13PuedK/Ecg8szzd4XRMbYxH4572JFG067z+FqBIf6Zp/d+0581glkvvWMFw==",
+        "balanced-match": {
+            "version": "1.0.2",
+            "dev": true
+        },
+        "binary-extensions": {
+            "version": "2.3.0",
+            "dev": true
+        },
+        "braces": {
+            "version": "3.0.3",
             "dev": true,
             "requires": {
-                "browserslist": "^4.16.6",
-                "caniuse-api": "^3.0.0"
+                "fill-range": "^7.1.1"
             }
         },
-        "postcss-reduce-transforms": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-5.1.0.tgz",
-            "integrity": "sha512-2fbdbmgir5AvpW9RLtdONx1QoYG2/EtqpNQbFASDlixBbAYuTcJ0dECwlqNqH7VbaUnEnh8SrxOe2sRIn24XyQ==",
+        "browserslist": {
+            "version": "4.24.2",
             "dev": true,
             "requires": {
-                "postcss-value-parser": "^4.2.0"
+                "caniuse-lite": "^1.0.30001669",
+                "electron-to-chromium": "^1.5.41",
+                "node-releases": "^2.0.18",
+                "update-browserslist-db": "^1.1.1"
             }
         },
-        "postcss-selector-parser": {
-            "version": "6.0.10",
-            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz",
-            "integrity": "sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==",
+        "buffer-from": {
+            "version": "1.1.2",
+            "dev": true,
+            "optional": true,
+            "peer": true
+        },
+        "camelcase-css": {
+            "version": "2.0.1",
+            "dev": true
+        },
+        "caniuse-lite": {
+            "version": "1.0.30001679",
+            "dev": true
+        },
+        "chokidar": {
+            "version": "3.6.0",
             "dev": true,
             "requires": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
+                "anymatch": "~3.1.2",
+                "braces": "~3.0.2",
+                "fsevents": "~2.3.2",
+                "glob-parent": "~5.1.2",
+                "is-binary-path": "~2.1.0",
+                "is-glob": "~4.0.1",
+                "normalize-path": "~3.0.0",
+                "readdirp": "~3.6.0"
             }
         },
-        "postcss-svgo": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-5.1.0.tgz",
-            "integrity": "sha512-D75KsH1zm5ZrHyxPakAxJWtkyXew5qwS70v56exwvw542d9CRtTo78K0WeFxZB4G7JXKKMbEZtZayTGdIky/eA==",
+        "color-convert": {
+            "version": "2.0.1",
             "dev": true,
             "requires": {
-                "postcss-value-parser": "^4.2.0",
-                "svgo": "^2.7.0"
+                "color-name": "~1.1.4"
             }
         },
-        "postcss-unique-selectors": {
-            "version": "5.1.1",
-            "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-5.1.1.tgz",
-            "integrity": "sha512-5JiODlELrz8L2HwxfPnhOWZYWDxVHWL83ufOv84NrcgipI7TaeRsatAhK4Tr2/ZiYldpK/wBvw5BD3qfaK96GA==",
+        "color-name": {
+            "version": "1.1.4",
+            "dev": true
+        },
+        "cross-spawn": {
+            "version": "7.0.5",
             "dev": true,
             "requires": {
-                "postcss-selector-parser": "^6.0.5"
+                "path-key": "^3.1.0",
+                "shebang-command": "^2.0.0",
+                "which": "^2.0.1"
             }
         },
-        "postcss-value-parser": {
-            "version": "4.2.0",
-            "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
-            "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
+        "cssesc": {
+            "version": "3.0.0",
             "dev": true
         },
-        "prettier": {
-            "version": "3.3.3",
-            "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.3.3.tgz",
-            "integrity": "sha512-i2tDNA0O5IrMO757lfrdQZCc2jPNDVntV0m/+4whiDfWaTKfMNgR7Qz0NAeGz/nRqF4m5/6CLzbP4/liHt12Ew==",
+        "didyoumean": {
+            "version": "1.2.2",
+            "dev": true
+        },
+        "dlv": {
+            "version": "1.1.3",
             "dev": true
         },
-        "pretty-time": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/pretty-time/-/pretty-time-1.1.0.tgz",
-            "integrity": "sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA==",
+        "eastasianwidth": {
+            "version": "0.2.0",
             "dev": true
         },
-        "process": {
-            "version": "0.11.10",
-            "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
-            "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
+        "electron-to-chromium": {
+            "version": "1.5.55",
             "dev": true
         },
-        "process-nextick-args": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
-            "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+        "emoji-regex": {
+            "version": "8.0.0",
+            "dev": true
+        },
+        "esbuild": {
+            "version": "0.21.5",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "dev": true,
+            "requires": {
+                "@esbuild/aix-ppc64": "0.21.5",
+                "@esbuild/android-arm": "0.21.5",
+                "@esbuild/android-arm64": "0.21.5",
+                "@esbuild/android-x64": "0.21.5",
+                "@esbuild/darwin-arm64": "0.21.5",
+                "@esbuild/darwin-x64": "0.21.5",
+                "@esbuild/freebsd-arm64": "0.21.5",
+                "@esbuild/freebsd-x64": "0.21.5",
+                "@esbuild/linux-arm": "0.21.5",
+                "@esbuild/linux-arm64": "0.21.5",
+                "@esbuild/linux-ia32": "0.21.5",
+                "@esbuild/linux-loong64": "0.21.5",
+                "@esbuild/linux-mips64el": "0.21.5",
+                "@esbuild/linux-ppc64": "0.21.5",
+                "@esbuild/linux-riscv64": "0.21.5",
+                "@esbuild/linux-s390x": "0.21.5",
+                "@esbuild/linux-x64": "0.21.5",
+                "@esbuild/netbsd-x64": "0.21.5",
+                "@esbuild/openbsd-x64": "0.21.5",
+                "@esbuild/sunos-x64": "0.21.5",
+                "@esbuild/win32-arm64": "0.21.5",
+                "@esbuild/win32-ia32": "0.21.5",
+                "@esbuild/win32-x64": "0.21.5"
+            }
+        },
+        "escalade": {
+            "version": "3.2.0",
             "dev": true
         },
-        "proxy-addr": {
-            "version": "2.0.7",
-            "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
-            "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+        "fast-glob": {
+            "version": "3.3.2",
             "dev": true,
             "requires": {
-                "forwarded": "0.2.0",
-                "ipaddr.js": "1.9.1"
-            },
-            "dependencies": {
-                "ipaddr.js": {
-                    "version": "1.9.1",
-                    "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
-                    "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
-                    "dev": true
-                }
+                "@nodelib/fs.stat": "^2.0.2",
+                "@nodelib/fs.walk": "^1.2.3",
+                "glob-parent": "^5.1.2",
+                "merge2": "^1.3.0",
+                "micromatch": "^4.0.4"
             }
         },
-        "public-encrypt": {
-            "version": "4.0.3",
-            "resolved": "https://registry.npmjs.org/public-encrypt/-/public-encrypt-4.0.3.tgz",
-            "integrity": "sha512-zVpa8oKZSz5bTMTFClc1fQOnyyEzpl5ozpi1B5YcvBrdohMjH2rfsBtyXcuNuwjsDIXmBYlF2N5FlJYhR29t8Q==",
+        "fastq": {
+            "version": "1.17.1",
             "dev": true,
             "requires": {
-                "bn.js": "^4.1.0",
-                "browserify-rsa": "^4.0.0",
-                "create-hash": "^1.1.0",
-                "parse-asn1": "^5.0.0",
-                "randombytes": "^2.0.1",
-                "safe-buffer": "^5.1.2"
-            },
-            "dependencies": {
-                "bn.js": {
-                    "version": "4.12.0",
-                    "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.0.tgz",
-                    "integrity": "sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==",
-                    "dev": true
-                }
+                "reusify": "^1.0.4"
             }
         },
-        "punycode": {
-            "version": "1.4.1",
-            "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz",
-            "integrity": "sha512-jmYNElW7yvO7TV33CjSmvSiE2yco3bV2czu/OzDKdMNVZQWfxCblURLhf+47syQRBntjfLdd/H0egrzIG+oaFQ==",
-            "dev": true
+        "fill-range": {
+            "version": "7.1.1",
+            "dev": true,
+            "requires": {
+                "to-regex-range": "^5.0.1"
+            }
         },
-        "qs": {
-            "version": "6.13.0",
-            "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz",
-            "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==",
+        "foreground-child": {
+            "version": "3.3.0",
             "dev": true,
             "requires": {
-                "side-channel": "^1.0.6"
+                "cross-spawn": "^7.0.0",
+                "signal-exit": "^4.0.1"
+            },
+            "dependencies": {
+                "signal-exit": {
+                    "version": "4.1.0",
+                    "dev": true
+                }
             }
         },
-        "querystring": {
-            "version": "0.2.0",
-            "resolved": "https://registry.npmjs.org/querystring/-/querystring-0.2.0.tgz",
-            "integrity": "sha512-X/xY82scca2tau62i9mDyU9K+I+djTMUsvwf7xnUX5GLvVzgJybOJf4Y6o9Zx3oJK/LSXg5tTZBjwzqVPaPO2g==",
+        "fraction.js": {
+            "version": "4.3.7",
             "dev": true
         },
-        "querystring-es3": {
-            "version": "0.2.1",
-            "resolved": "https://registry.npmjs.org/querystring-es3/-/querystring-es3-0.2.1.tgz",
-            "integrity": "sha512-773xhDQnZBMFobEiztv8LIl70ch5MSF/jUQVlhwFyBILqq96anmoctVIYz+ZRp0qbCKATTn6ev02M3r7Ga5vqA==",
-            "dev": true
+        "fsevents": {
+            "version": "2.3.3",
+            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+            "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+            "dev": true,
+            "optional": true
         },
-        "queue-microtask": {
-            "version": "1.2.3",
-            "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
-            "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+        "function-bind": {
+            "version": "1.1.2",
             "dev": true
         },
-        "randombytes": {
-            "version": "2.1.0",
-            "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
-            "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
+        "glob-parent": {
+            "version": "5.1.2",
             "dev": true,
             "requires": {
-                "safe-buffer": "^5.1.0"
+                "is-glob": "^4.0.1"
             }
         },
-        "randomfill": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/randomfill/-/randomfill-1.0.4.tgz",
-            "integrity": "sha512-87lcbR8+MhcWcUiQ+9e+Rwx8MyR2P7qnt15ynUlbm3TU/fjbgz4GsvfSUDTemtCCtVCqb4ZcEFlyPNTh9bBTLw==",
+        "hasown": {
+            "version": "2.0.2",
             "dev": true,
             "requires": {
-                "randombytes": "^2.0.5",
-                "safe-buffer": "^5.1.0"
+                "function-bind": "^1.1.2"
             }
         },
-        "range-parser": {
-            "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
-            "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+        "hydefront": {
+            "version": "3.4.0",
             "dev": true
         },
-        "raw-body": {
-            "version": "2.5.2",
-            "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz",
-            "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==",
+        "is-binary-path": {
+            "version": "2.1.0",
             "dev": true,
             "requires": {
-                "bytes": "3.1.2",
-                "http-errors": "2.0.0",
-                "iconv-lite": "0.4.24",
-                "unpipe": "1.0.0"
-            },
-            "dependencies": {
-                "bytes": {
-                    "version": "3.1.2",
-                    "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
-                    "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
-                    "dev": true
-                }
+                "binary-extensions": "^2.0.0"
             }
         },
-        "read-cache": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz",
-            "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==",
+        "is-core-module": {
+            "version": "2.15.1",
             "dev": true,
             "requires": {
-                "pify": "^2.3.0"
+                "hasown": "^2.0.2"
             }
         },
-        "readable-stream": {
-            "version": "2.3.7",
-            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.7.tgz",
-            "integrity": "sha512-Ebho8K4jIbHAxnuxi7o42OrZgF/ZTNcsZj6nRKyUmkhLFq8CHItp/fy6hQZuZmP/n3yZ9VBUbp4zz/mX8hmYPw==",
-            "dev": true,
-            "requires": {
-                "core-util-is": "~1.0.0",
-                "inherits": "~2.0.3",
-                "isarray": "~1.0.0",
-                "process-nextick-args": "~2.0.0",
-                "safe-buffer": "~5.1.1",
-                "string_decoder": "~1.1.1",
-                "util-deprecate": "~1.0.1"
-            }
+        "is-extglob": {
+            "version": "2.1.1",
+            "dev": true
         },
-        "readdirp": {
-            "version": "3.6.0",
-            "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
-            "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+        "is-fullwidth-code-point": {
+            "version": "3.0.0",
+            "dev": true
+        },
+        "is-glob": {
+            "version": "4.0.3",
             "dev": true,
             "requires": {
-                "picomatch": "^2.2.1"
+                "is-extglob": "^2.1.1"
             }
         },
-        "rechoir": {
-            "version": "0.7.1",
-            "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.7.1.tgz",
-            "integrity": "sha512-/njmZ8s1wVeR6pjTZ+0nCnv8SpZNRMT2D1RLOJQESlYFDBvwpTA4KWJpZ+sBJ4+vhjILRcK7JIFdGCdxEAAitg==",
+        "is-number": {
+            "version": "7.0.0",
+            "dev": true
+        },
+        "isexe": {
+            "version": "2.0.0",
+            "dev": true
+        },
+        "jackspeak": {
+            "version": "3.4.3",
             "dev": true,
             "requires": {
-                "resolve": "^1.9.0"
+                "@isaacs/cliui": "^8.0.2",
+                "@pkgjs/parseargs": "^0.11.0"
             }
         },
-        "regenerate": {
-            "version": "1.4.2",
-            "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz",
-            "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==",
+        "jiti": {
+            "version": "1.21.6",
+            "dev": true
+        },
+        "lilconfig": {
+            "version": "2.1.0",
+            "dev": true
+        },
+        "lines-and-columns": {
+            "version": "1.2.4",
+            "dev": true
+        },
+        "lodash.castarray": {
+            "version": "4.4.0",
+            "dev": true
+        },
+        "lodash.isplainobject": {
+            "version": "4.0.6",
+            "dev": true
+        },
+        "lodash.merge": {
+            "version": "4.6.2",
+            "dev": true
+        },
+        "merge2": {
+            "version": "1.4.1",
             "dev": true
         },
-        "regenerate-unicode-properties": {
-            "version": "10.0.1",
-            "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.0.1.tgz",
-            "integrity": "sha512-vn5DU6yg6h8hP/2OkQo3K7uVILvY4iu0oI4t3HFa81UPkhGJwkRwM10JEc3upjdhHjs/k8GJY1sRBhk5sr69Bw==",
+        "micromatch": {
+            "version": "4.0.8",
             "dev": true,
             "requires": {
-                "regenerate": "^1.4.2"
+                "braces": "^3.0.3",
+                "picomatch": "^2.3.1"
             }
         },
-        "regenerator-runtime": {
-            "version": "0.13.9",
-            "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.9.tgz",
-            "integrity": "sha512-p3VT+cOEgxFsRRA9X4lkI1E+k2/CtnKtU4gcxyaCUreilL/vqI6CdZ3wxVUx3UOUg+gnUOQQcRI7BmSI656MYA==",
+        "minipass": {
+            "version": "7.1.2",
             "dev": true
         },
-        "regenerator-transform": {
-            "version": "0.15.0",
-            "resolved": "https://registry.npmjs.org/regenerator-transform/-/regenerator-transform-0.15.0.tgz",
-            "integrity": "sha512-LsrGtPmbYg19bcPHwdtmXwbW+TqNvtY4riE3P83foeHRroMbH6/2ddFBfab3t7kbzc7v7p4wbkIecHImqt0QNg==",
+        "mz": {
+            "version": "2.7.0",
             "dev": true,
             "requires": {
-                "@babel/runtime": "^7.8.4"
+                "any-promise": "^1.0.0",
+                "object-assign": "^4.0.1",
+                "thenify-all": "^1.0.0"
             }
         },
-        "regexpu-core": {
-            "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-5.0.1.tgz",
-            "integrity": "sha512-CriEZlrKK9VJw/xQGJpQM5rY88BtuL8DM+AEwvcThHilbxiTAy8vq4iJnd2tqq8wLmjbGZzP7ZcKFjbGkmEFrw==",
-            "dev": true,
-            "requires": {
-                "regenerate": "^1.4.2",
-                "regenerate-unicode-properties": "^10.0.1",
-                "regjsgen": "^0.6.0",
-                "regjsparser": "^0.8.2",
-                "unicode-match-property-ecmascript": "^2.0.0",
-                "unicode-match-property-value-ecmascript": "^2.0.0"
-            }
+        "nanoid": {
+            "version": "3.3.7",
+            "dev": true
         },
-        "regjsgen": {
-            "version": "0.6.0",
-            "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.6.0.tgz",
-            "integrity": "sha512-ozE883Uigtqj3bx7OhL1KNbCzGyW2NQZPl6Hs09WTvCuZD5sTI4JY58bkbQWa/Y9hxIsvJ3M8Nbf7j54IqeZbA==",
+        "node-releases": {
+            "version": "2.0.18",
             "dev": true
         },
-        "regjsparser": {
-            "version": "0.8.4",
-            "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.8.4.tgz",
-            "integrity": "sha512-J3LABycON/VNEu3abOviqGHuB/LOtOQj8SKmfP9anY5GfAVw/SPjwzSjxGjbZXIxbGfqTHtJw58C2Li/WkStmA==",
-            "dev": true,
-            "requires": {
-                "jsesc": "~0.5.0"
-            },
-            "dependencies": {
-                "jsesc": {
-                    "version": "0.5.0",
-                    "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz",
-                    "integrity": "sha512-uZz5UnB7u4T9LvwmFqXii7pZSouaRPorGs5who1Ip7VO0wxanFvBL7GkM6dTHlgX+jhBApRetaWpnDabOeTcnA==",
-                    "dev": true
-                }
-            }
+        "normalize-path": {
+            "version": "3.0.0",
+            "dev": true
         },
-        "relateurl": {
-            "version": "0.2.7",
-            "resolved": "https://registry.npmjs.org/relateurl/-/relateurl-0.2.7.tgz",
-            "integrity": "sha512-G08Dxvm4iDN3MLM0EsP62EDV9IuhXPR6blNz6Utcp7zyV3tr4HVNINt6MpaRWbxoOHT3Q7YN2P+jaHX8vUbgog==",
+        "normalize-range": {
+            "version": "0.1.2",
             "dev": true
         },
-        "replace-ext": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/replace-ext/-/replace-ext-1.0.1.tgz",
-            "integrity": "sha512-yD5BHCe7quCgBph4rMQ+0KkIRKwWCrHDOX1p1Gp6HwjPM5kVoCdKGNhN7ydqqsX6lJEnQDKZ/tFMiEdQ1dvPEw==",
+        "object-assign": {
+            "version": "4.1.1",
             "dev": true
         },
-        "require-directory": {
-            "version": "2.1.1",
-            "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
-            "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+        "object-hash": {
+            "version": "3.0.0",
             "dev": true
         },
-        "require-from-string": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
-            "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+        "package-json-from-dist": {
+            "version": "1.0.1",
             "dev": true
         },
-        "requires-port": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
-            "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==",
+        "path-key": {
+            "version": "3.1.1",
             "dev": true
         },
-        "resolve": {
-            "version": "1.22.8",
-            "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.8.tgz",
-            "integrity": "sha512-oKWePCxqpd6FlLvGV1VU0x7bkPmmCNolxzjMf4NczoDnQcIWrAF+cPtZn5i6n+RfD2d9i0tzpKnG6Yk168yIyw==",
-            "dev": true,
-            "requires": {
-                "is-core-module": "^2.13.0",
-                "path-parse": "^1.0.7",
-                "supports-preserve-symlinks-flag": "^1.0.0"
-            }
+        "path-parse": {
+            "version": "1.0.7",
+            "dev": true
         },
-        "resolve-cwd": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz",
-            "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==",
+        "path-scurry": {
+            "version": "1.11.1",
             "dev": true,
             "requires": {
-                "resolve-from": "^5.0.0"
+                "lru-cache": "^10.2.0",
+                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
             },
             "dependencies": {
-                "resolve-from": {
-                    "version": "5.0.0",
-                    "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
-                    "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
+                "lru-cache": {
+                    "version": "10.4.3",
                     "dev": true
                 }
             }
         },
-        "resolve-from": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
-            "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
-            "dev": true
-        },
-        "retry": {
-            "version": "0.13.1",
-            "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
-            "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
+        "picocolors": {
+            "version": "1.1.1",
             "dev": true
         },
-        "reusify": {
-            "version": "1.0.4",
-            "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.0.4.tgz",
-            "integrity": "sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==",
+        "picomatch": {
+            "version": "2.3.1",
             "dev": true
         },
-        "rimraf": {
-            "version": "3.0.2",
-            "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
-            "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==",
-            "dev": true,
-            "requires": {
-                "glob": "^7.1.3"
-            }
-        },
-        "ripemd160": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
-            "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
-            "dev": true,
-            "requires": {
-                "hash-base": "^3.0.0",
-                "inherits": "^2.0.1"
-            }
-        },
-        "run-parallel": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
-            "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
-            "dev": true,
-            "requires": {
-                "queue-microtask": "^1.2.2"
-            }
-        },
-        "safe-buffer": {
-            "version": "5.1.2",
-            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
-            "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+        "pify": {
+            "version": "2.3.0",
             "dev": true
         },
-        "safer-buffer": {
-            "version": "2.1.2",
-            "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
-            "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+        "pirates": {
+            "version": "4.0.6",
             "dev": true
         },
-        "schema-utils": {
-            "version": "2.7.1",
-            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-2.7.1.tgz",
-            "integrity": "sha512-SHiNtMOUGWBQJwzISiVYKu82GiV4QYGePp3odlY1tuKO7gPtphAT5R/py0fA6xtbgLL/RvtJZnU9b8s0F1q0Xg==",
+        "postcss": {
+            "version": "8.4.48",
             "dev": true,
             "requires": {
-                "@types/json-schema": "^7.0.5",
-                "ajv": "^6.12.4",
-                "ajv-keywords": "^3.5.2"
+                "nanoid": "^3.3.7",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
             }
         },
-        "select-hose": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/select-hose/-/select-hose-2.0.0.tgz",
-            "integrity": "sha512-mEugaLK+YfkijB4fx0e6kImuJdCIt2LxCRcbEYPqRGCs4F2ogyfZU5IAZRdjCP8JPq2AtdNoC/Dux63d9Kiryg==",
-            "dev": true
-        },
-        "selfsigned": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/selfsigned/-/selfsigned-2.0.1.tgz",
-            "integrity": "sha512-LmME957M1zOsUhG+67rAjKfiWFox3SBxE/yymatMZsAx+oMrJ0YQ8AToOnyCm7xbeg2ep37IHLxdu0o2MavQOQ==",
+        "postcss-import": {
+            "version": "15.1.0",
             "dev": true,
             "requires": {
-                "node-forge": "^1"
+                "postcss-value-parser": "^4.0.0",
+                "read-cache": "^1.0.0",
+                "resolve": "^1.1.7"
             }
         },
-        "semver": {
-            "version": "7.5.4",
-            "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz",
-            "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==",
+        "postcss-js": {
+            "version": "4.0.1",
             "dev": true,
             "requires": {
-                "lru-cache": "^6.0.0"
+                "camelcase-css": "^2.0.1"
             }
         },
-        "send": {
-            "version": "0.19.0",
-            "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz",
-            "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==",
+        "postcss-nested": {
+            "version": "6.2.0",
             "dev": true,
             "requires": {
-                "debug": "2.6.9",
-                "depd": "2.0.0",
-                "destroy": "1.2.0",
-                "encodeurl": "~1.0.2",
-                "escape-html": "~1.0.3",
-                "etag": "~1.8.1",
-                "fresh": "0.5.2",
-                "http-errors": "2.0.0",
-                "mime": "1.6.0",
-                "ms": "2.1.3",
-                "on-finished": "2.4.1",
-                "range-parser": "~1.2.1",
-                "statuses": "2.0.1"
+                "postcss-selector-parser": "^6.1.1"
             },
             "dependencies": {
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+                "postcss-selector-parser": {
+                    "version": "6.1.2",
                     "dev": true,
                     "requires": {
-                        "ms": "2.0.0"
-                    },
-                    "dependencies": {
-                        "ms": {
-                            "version": "2.0.0",
-                            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                            "dev": true
-                        }
+                        "cssesc": "^3.0.0",
+                        "util-deprecate": "^1.0.2"
                     }
-                },
-                "encodeurl": {
-                    "version": "1.0.2",
-                    "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz",
-                    "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==",
-                    "dev": true
-                },
-                "ms": {
-                    "version": "2.1.3",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-                    "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-                    "dev": true
                 }
             }
         },
-        "serialize-javascript": {
-            "version": "6.0.2",
-            "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
-            "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
+        "postcss-selector-parser": {
+            "version": "6.0.10",
             "dev": true,
             "requires": {
-                "randombytes": "^2.1.0"
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
             }
         },
-        "serve-index": {
-            "version": "1.9.1",
-            "resolved": "https://registry.npmjs.org/serve-index/-/serve-index-1.9.1.tgz",
-            "integrity": "sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw==",
+        "postcss-value-parser": {
+            "version": "4.2.0",
+            "dev": true
+        },
+        "prettier": {
+            "version": "3.3.3",
+            "dev": true
+        },
+        "queue-microtask": {
+            "version": "1.2.3",
+            "dev": true
+        },
+        "read-cache": {
+            "version": "1.0.0",
             "dev": true,
             "requires": {
-                "accepts": "~1.3.4",
-                "batch": "0.6.1",
-                "debug": "2.6.9",
-                "escape-html": "~1.0.3",
-                "http-errors": "~1.6.2",
-                "mime-types": "~2.1.17",
-                "parseurl": "~1.3.2"
-            },
-            "dependencies": {
-                "debug": {
-                    "version": "2.6.9",
-                    "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-                    "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-                    "dev": true,
-                    "requires": {
-                        "ms": "2.0.0"
-                    }
-                },
-                "depd": {
-                    "version": "1.1.2",
-                    "resolved": "https://registry.npmjs.org/depd/-/depd-1.1.2.tgz",
-                    "integrity": "sha512-7emPTl6Dpo6JRXOXjLRxck+FlLRX5847cLKEn00PLAgc3g2hTZZgr+e4c2v6QpSmLeFP3n5yUo7ft6avBK/5jQ==",
-                    "dev": true
-                },
-                "http-errors": {
-                    "version": "1.6.3",
-                    "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-1.6.3.tgz",
-                    "integrity": "sha512-lks+lVC8dgGyh97jxvxeYTWQFvh4uw4yC12gVl63Cg30sjPX4wuGcdkICVXDAESr6OJGjqGA8Iz5mkeN6zlD7A==",
-                    "dev": true,
-                    "requires": {
-                        "depd": "~1.1.2",
-                        "inherits": "2.0.3",
-                        "setprototypeof": "1.1.0",
-                        "statuses": ">= 1.4.0 < 2"
-                    }
-                },
-                "inherits": {
-                    "version": "2.0.3",
-                    "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-                    "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
-                    "dev": true
-                },
-                "ms": {
-                    "version": "2.0.0",
-                    "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-                    "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
-                    "dev": true
-                },
-                "setprototypeof": {
-                    "version": "1.1.0",
-                    "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.1.0.tgz",
-                    "integrity": "sha512-BvE/TwpZX4FXExxOxZyRGQQv651MSwmWKZGqvmPcRIjDqWub67kTKuIMx43cZZrS/cBBzwBcNDWoFxt2XEFIpQ==",
-                    "dev": true
-                },
-                "statuses": {
-                    "version": "1.5.0",
-                    "resolved": "https://registry.npmjs.org/statuses/-/statuses-1.5.0.tgz",
-                    "integrity": "sha512-OpZ3zP+jT1PI7I8nemJX4AKmAX070ZkYPVWV/AaKTJl+tXCTGyVdC1a4SL8RUQYEwk/f34ZX8UTykN68FwrqAA==",
-                    "dev": true
-                }
+                "pify": "^2.3.0"
             }
         },
-        "serve-static": {
-            "version": "1.16.2",
-            "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz",
-            "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==",
+        "readdirp": {
+            "version": "3.6.0",
             "dev": true,
             "requires": {
-                "encodeurl": "~2.0.0",
-                "escape-html": "~1.0.3",
-                "parseurl": "~1.3.3",
-                "send": "0.19.0"
+                "picomatch": "^2.2.1"
             }
         },
-        "set-function-length": {
-            "version": "1.2.2",
-            "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
-            "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+        "resolve": {
+            "version": "1.22.8",
             "dev": true,
             "requires": {
-                "define-data-property": "^1.1.4",
-                "es-errors": "^1.3.0",
-                "function-bind": "^1.1.2",
-                "get-intrinsic": "^1.2.4",
-                "gopd": "^1.0.1",
-                "has-property-descriptors": "^1.0.2"
+                "is-core-module": "^2.13.0",
+                "path-parse": "^1.0.7",
+                "supports-preserve-symlinks-flag": "^1.0.0"
             }
         },
-        "setimmediate": {
-            "version": "1.0.5",
-            "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
-            "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
-            "dev": true
-        },
-        "setprototypeof": {
-            "version": "1.2.0",
-            "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
-            "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+        "reusify": {
+            "version": "1.0.4",
             "dev": true
         },
-        "sha.js": {
-            "version": "2.4.11",
-            "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
-            "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
-            "dev": true,
-            "requires": {
-                "inherits": "^2.0.1",
-                "safe-buffer": "^5.0.1"
+        "rollup": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
+            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
+            "dev": true,
+            "requires": {
+                "@rollup/rollup-android-arm-eabi": "4.25.0",
+                "@rollup/rollup-android-arm64": "4.25.0",
+                "@rollup/rollup-darwin-arm64": "4.25.0",
+                "@rollup/rollup-darwin-x64": "4.25.0",
+                "@rollup/rollup-freebsd-arm64": "4.25.0",
+                "@rollup/rollup-freebsd-x64": "4.25.0",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
+                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
+                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
+                "@rollup/rollup-linux-arm64-musl": "4.25.0",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
+                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
+                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-musl": "4.25.0",
+                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
+                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
+                "@rollup/rollup-win32-x64-msvc": "4.25.0",
+                "@types/estree": "1.0.6",
+                "fsevents": "~2.3.2"
             }
         },
-        "shallow-clone": {
-            "version": "3.0.1",
-            "resolved": "https://registry.npmjs.org/shallow-clone/-/shallow-clone-3.0.1.tgz",
-            "integrity": "sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA==",
+        "run-parallel": {
+            "version": "1.2.0",
             "dev": true,
             "requires": {
-                "kind-of": "^6.0.2"
+                "queue-microtask": "^1.2.2"
             }
         },
         "shebang-command": {
             "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
-            "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
             "dev": true,
             "requires": {
                 "shebang-regex": "^3.0.0"
@@ -16020,173 +3266,30 @@
         },
         "shebang-regex": {
             "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
-            "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-            "dev": true
-        },
-        "shellwords": {
-            "version": "0.1.1",
-            "resolved": "https://registry.npmjs.org/shellwords/-/shellwords-0.1.1.tgz",
-            "integrity": "sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==",
-            "dev": true
-        },
-        "side-channel": {
-            "version": "1.0.6",
-            "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.6.tgz",
-            "integrity": "sha512-fDW/EZ6Q9RiO8eFG8Hj+7u/oW+XrPTIChwCOM2+th2A6OblDtYYIpve9m+KvI9Z4C9qSEXlaGR6bTEYHReuglA==",
-            "dev": true,
-            "requires": {
-                "call-bind": "^1.0.7",
-                "es-errors": "^1.3.0",
-                "get-intrinsic": "^1.2.4",
-                "object-inspect": "^1.13.1"
-            }
-        },
-        "signal-exit": {
-            "version": "3.0.7",
-            "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
-            "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
-            "dev": true
-        },
-        "slash": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
-            "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
-            "dev": true
-        },
-        "sockjs": {
-            "version": "0.3.24",
-            "resolved": "https://registry.npmjs.org/sockjs/-/sockjs-0.3.24.tgz",
-            "integrity": "sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ==",
-            "dev": true,
-            "requires": {
-                "faye-websocket": "^0.11.3",
-                "uuid": "^8.3.2",
-                "websocket-driver": "^0.7.4"
-            }
-        },
-        "source-list-map": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/source-list-map/-/source-list-map-2.0.1.tgz",
-            "integrity": "sha512-qnQ7gVMxGNxsiL4lEuJwe/To8UnK7fAnmbGEEH8RpLouuKbeEm0lhbQVFIrNSuB+G7tVrAlVsZgETT5nljf+Iw==",
             "dev": true
         },
         "source-map": {
             "version": "0.6.1",
-            "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
-            "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
-            "dev": true
+            "dev": true,
+            "optional": true,
+            "peer": true
         },
         "source-map-js": {
             "version": "1.2.1",
-            "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-            "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
             "dev": true
         },
         "source-map-support": {
             "version": "0.5.21",
-            "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
-            "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
                 "buffer-from": "^1.0.0",
                 "source-map": "^0.6.0"
             }
         },
-        "spdy": {
-            "version": "4.0.2",
-            "resolved": "https://registry.npmjs.org/spdy/-/spdy-4.0.2.tgz",
-            "integrity": "sha512-r46gZQZQV+Kl9oItvl1JZZqJKGr+oEkB08A6BzkiR7593/7IbtuncXHd2YoYeTsG4157ZssMu9KYvUHLcjcDoA==",
-            "dev": true,
-            "requires": {
-                "debug": "^4.1.0",
-                "handle-thing": "^2.0.0",
-                "http-deceiver": "^1.2.7",
-                "select-hose": "^2.0.0",
-                "spdy-transport": "^3.0.0"
-            }
-        },
-        "spdy-transport": {
-            "version": "3.0.0",
-            "resolved": "https://registry.npmjs.org/spdy-transport/-/spdy-transport-3.0.0.tgz",
-            "integrity": "sha512-hsLVFE5SjA6TCisWeJXFKniGGOpBgMLmerfO2aCyCU5s7nJ/rpAepqmFifv/GCbSbueEeAJJnmSQ2rKC/g8Fcw==",
-            "dev": true,
-            "requires": {
-                "debug": "^4.1.0",
-                "detect-node": "^2.0.4",
-                "hpack.js": "^2.1.6",
-                "obuf": "^1.1.2",
-                "readable-stream": "^3.0.6",
-                "wbuf": "^1.7.3"
-            },
-            "dependencies": {
-                "readable-stream": {
-                    "version": "3.6.0",
-                    "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz",
-                    "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==",
-                    "dev": true,
-                    "requires": {
-                        "inherits": "^2.0.3",
-                        "string_decoder": "^1.1.1",
-                        "util-deprecate": "^1.0.1"
-                    }
-                }
-            }
-        },
-        "stable": {
-            "version": "0.1.8",
-            "resolved": "https://registry.npmjs.org/stable/-/stable-0.1.8.tgz",
-            "integrity": "sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w==",
-            "dev": true
-        },
-        "statuses": {
-            "version": "2.0.1",
-            "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
-            "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
-            "dev": true
-        },
-        "std-env": {
-            "version": "3.1.1",
-            "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.1.1.tgz",
-            "integrity": "sha512-/c645XdExBypL01TpFKiG/3RAa/Qmu+zRi0MwAmrdEkwHNuN0ebo8ccAXBBDa5Z0QOJgBskUIbuCK91x0sCVEw==",
-            "dev": true
-        },
-        "stream-browserify": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/stream-browserify/-/stream-browserify-2.0.2.tgz",
-            "integrity": "sha512-nX6hmklHs/gr2FuxYDltq8fJA1GDlxKQCz8O/IM4atRqBH8OORmBNgfvW5gG10GT/qQ9u0CzIvr2X5Pkt6ntqg==",
-            "dev": true,
-            "requires": {
-                "inherits": "~2.0.1",
-                "readable-stream": "^2.0.2"
-            }
-        },
-        "stream-http": {
-            "version": "2.8.3",
-            "resolved": "https://registry.npmjs.org/stream-http/-/stream-http-2.8.3.tgz",
-            "integrity": "sha512-+TSkfINHDo4J+ZobQLWiMouQYB+UVYFttRA94FpEzzJ7ZdqcL4uUUQ7WkdkI4DSozGmgBUE/a47L+38PenXhUw==",
-            "dev": true,
-            "requires": {
-                "builtin-status-codes": "^3.0.0",
-                "inherits": "^2.0.1",
-                "readable-stream": "^2.3.6",
-                "to-arraybuffer": "^1.0.0",
-                "xtend": "^4.0.0"
-            }
-        },
-        "string_decoder": {
-            "version": "1.1.1",
-            "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
-            "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
-            "dev": true,
-            "requires": {
-                "safe-buffer": "~5.1.0"
-            }
-        },
         "string-width": {
             "version": "4.2.3",
-            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
             "dev": true,
             "requires": {
                 "emoji-regex": "^8.0.0",
@@ -16196,76 +3299,29 @@
         },
         "string-width-cjs": {
             "version": "npm:string-width@4.2.3",
-            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
-            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
             "dev": true,
             "requires": {
                 "emoji-regex": "^8.0.0",
                 "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            }
-        },
-        "strip-ansi": {
-            "version": "6.0.1",
-            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-            "dev": true,
-            "requires": {
-                "ansi-regex": "^5.0.1"
-            }
-        },
-        "strip-ansi-cjs": {
-            "version": "npm:strip-ansi@6.0.1",
-            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
-            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
-            "dev": true,
-            "requires": {
-                "ansi-regex": "^5.0.1"
+                "strip-ansi": "^6.0.1"
             }
         },
-        "strip-final-newline": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
-            "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
-            "dev": true
-        },
-        "style-loader": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-2.0.0.tgz",
-            "integrity": "sha512-Z0gYUJmzZ6ZdRUqpg1r8GsaFKypE+3xAzuFeMuoHgjc9KZv3wMyCRjQIWEbhoFSq7+7yoHXySDJyyWQaPajeiQ==",
+        "strip-ansi": {
+            "version": "6.0.1",
             "dev": true,
             "requires": {
-                "loader-utils": "^2.0.0",
-                "schema-utils": "^3.0.0"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                }
+                "ansi-regex": "^5.0.1"
             }
         },
-        "stylehacks": {
-            "version": "5.1.0",
-            "resolved": "https://registry.npmjs.org/stylehacks/-/stylehacks-5.1.0.tgz",
-            "integrity": "sha512-SzLmvHQTrIWfSgljkQCw2++C9+Ne91d/6Sp92I8c5uHTcy/PgeHamwITIbBW9wnFTY/3ZfSXR9HIL6Ikqmcu6Q==",
+        "strip-ansi-cjs": {
+            "version": "npm:strip-ansi@6.0.1",
             "dev": true,
             "requires": {
-                "browserslist": "^4.16.6",
-                "postcss-selector-parser": "^6.0.4"
+                "ansi-regex": "^5.0.1"
             }
         },
         "sucrase": {
             "version": "3.35.0",
-            "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.0.tgz",
-            "integrity": "sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==",
             "dev": true,
             "requires": {
                 "@jridgewell/gen-mapping": "^0.3.2",
@@ -16277,21 +3333,8 @@
                 "ts-interface-checker": "^0.1.9"
             },
             "dependencies": {
-                "@jridgewell/gen-mapping": {
-                    "version": "0.3.5",
-                    "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.5.tgz",
-                    "integrity": "sha512-IzL8ZoEDIBRWEzlCcRhOaCupYyN5gdIK+Q6fbFdPDg6HqX6jpkItn7DFIpW9LQzXG6Df9sA7+OKnq0qlz/GaQg==",
-                    "dev": true,
-                    "requires": {
-                        "@jridgewell/set-array": "^1.2.1",
-                        "@jridgewell/sourcemap-codec": "^1.4.10",
-                        "@jridgewell/trace-mapping": "^0.3.24"
-                    }
-                },
                 "brace-expansion": {
                     "version": "2.0.1",
-                    "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
-                    "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
                     "dev": true,
                     "requires": {
                         "balanced-match": "^1.0.0"
@@ -16299,27 +3342,22 @@
                 },
                 "commander": {
                     "version": "4.1.1",
-                    "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
-                    "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
                     "dev": true
                 },
                 "glob": {
-                    "version": "10.3.12",
-                    "resolved": "https://registry.npmjs.org/glob/-/glob-10.3.12.tgz",
-                    "integrity": "sha512-TCNv8vJ+xz4QiqTpfOJA7HvYv+tNIRHKfUWw/q+v2jdgN4ebz+KY9tGx5J4rHP0o84mNP+ApH66HRX8us3Khqg==",
+                    "version": "10.4.5",
                     "dev": true,
                     "requires": {
                         "foreground-child": "^3.1.0",
-                        "jackspeak": "^2.3.6",
-                        "minimatch": "^9.0.1",
-                        "minipass": "^7.0.4",
-                        "path-scurry": "^1.10.2"
+                        "jackspeak": "^3.1.2",
+                        "minimatch": "^9.0.4",
+                        "minipass": "^7.1.2",
+                        "package-json-from-dist": "^1.0.0",
+                        "path-scurry": "^1.11.1"
                     }
                 },
                 "minimatch": {
-                    "version": "9.0.4",
-                    "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.4.tgz",
-                    "integrity": "sha512-KqWh+VchfxcMNRAJjj2tnsSJdNbHsVgnkBhTNrW7AjVo6OvLtxw8zfT9oLw1JSohlFzJ8jCoTgaoXvJ+kHt6fw==",
+                    "version": "9.0.5",
                     "dev": true,
                     "requires": {
                         "brace-expansion": "^2.0.1"
@@ -16327,48 +3365,12 @@
                 }
             }
         },
-        "supports-color": {
-            "version": "7.2.0",
-            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
-            "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
-            "dev": true,
-            "requires": {
-                "has-flag": "^4.0.0"
-            },
-            "dependencies": {
-                "has-flag": {
-                    "version": "4.0.0",
-                    "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
-                    "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
-                    "dev": true
-                }
-            }
-        },
         "supports-preserve-symlinks-flag": {
             "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
-            "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
             "dev": true
         },
-        "svgo": {
-            "version": "2.8.0",
-            "resolved": "https://registry.npmjs.org/svgo/-/svgo-2.8.0.tgz",
-            "integrity": "sha512-+N/Q9kV1+F+UeWYoSiULYo4xYSDQlTgb+ayMobAXPwMnLvop7oxKMo9OzIrX5x3eS4L4f2UHhc9axXwY8DpChg==",
-            "dev": true,
-            "requires": {
-                "@trysound/sax": "0.2.0",
-                "commander": "^7.2.0",
-                "css-select": "^4.1.3",
-                "css-tree": "^1.1.3",
-                "csso": "^4.2.0",
-                "picocolors": "^1.0.0",
-                "stable": "^0.1.8"
-            }
-        },
         "tailwindcss": {
             "version": "3.4.14",
-            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.14.tgz",
-            "integrity": "sha512-IcSvOcTRcUtQQ7ILQL5quRDg7Xs93PdJEk1ZLbhhvJc7uj/OAhYOnruEiwnGgBvUtaUAJ8/mhSw1o8L2jCiENA==",
             "dev": true,
             "requires": {
                 "@alloc/quick-lru": "^5.2.0",
@@ -16397,8 +3399,6 @@
             "dependencies": {
                 "glob-parent": {
                     "version": "6.0.2",
-                    "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
-                    "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
                     "dev": true,
                     "requires": {
                         "is-glob": "^4.0.3"
@@ -16406,8 +3406,6 @@
                 },
                 "postcss-load-config": {
                     "version": "4.0.2",
-                    "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-4.0.2.tgz",
-                    "integrity": "sha512-bSVhyJGL00wMVoPUzAVAnbEoWyqRxkjv64tUl427SKnPrENtq6hJwUojroMz2VB+Q1edmi4IfrAPpami5VVgMQ==",
                     "dev": true,
                     "requires": {
                         "lilconfig": "^3.0.0",
@@ -16415,17 +3413,13 @@
                     },
                     "dependencies": {
                         "lilconfig": {
-                            "version": "3.1.1",
-                            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.1.tgz",
-                            "integrity": "sha512-O18pf7nyvHTckunPWCV1XUNXU1piu01y2b7ATJ0ppkUkk8ocqVWBrYjJBCwHDjD/ZWcfyrA0P4gKhzWGi5EINQ==",
+                            "version": "3.1.2",
                             "dev": true
                         }
                     }
                 },
                 "postcss-selector-parser": {
-                    "version": "6.0.16",
-                    "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.16.tgz",
-                    "integrity": "sha512-A0RVJrX+IUkVZbW3ClroRWurercFhieevHB38sr2+l9eUClMqome3LmEmnhlNy+5Mr2EYN6B2Kaw9wYdd+VHiw==",
+                    "version": "6.1.2",
                     "dev": true,
                     "requires": {
                         "cssesc": "^3.0.0",
@@ -16433,24 +3427,16 @@
                     }
                 },
                 "yaml": {
-                    "version": "2.4.1",
-                    "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.4.1.tgz",
-                    "integrity": "sha512-pIXzoImaqmfOrL7teGUBt/T7ZDnyeGBWyXQBvOVhLkWLN37GXv8NMLK406UY6dS51JfcQHsmcW5cJ441bHg6Lg==",
+                    "version": "2.6.0",
                     "dev": true
                 }
             }
         },
-        "tapable": {
-            "version": "2.2.1",
-            "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz",
-            "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==",
-            "dev": true
-        },
         "terser": {
-            "version": "5.31.6",
-            "resolved": "https://registry.npmjs.org/terser/-/terser-5.31.6.tgz",
-            "integrity": "sha512-PQ4DAriWzKj+qgehQ7LK5bQqCFNMmlhjR2PFFLuqGCpuCAauxemVBWwWOxo3UIwWQx8+Pr61Df++r76wDmkQBg==",
+            "version": "5.36.0",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
                 "@jridgewell/source-map": "^0.3.3",
                 "acorn": "^8.8.2",
@@ -16460,42 +3446,14 @@
             "dependencies": {
                 "commander": {
                     "version": "2.20.3",
-                    "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
-                    "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
-                    "dev": true
-                }
-            }
-        },
-        "terser-webpack-plugin": {
-            "version": "5.3.10",
-            "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.10.tgz",
-            "integrity": "sha512-BKFPWlPDndPs+NGGCr1U59t0XScL5317Y0UReNrHaw9/FwhPENlq6bfgs+4yPfyP51vqC1bQ4rp1EfXW5ZSH9w==",
-            "dev": true,
-            "requires": {
-                "@jridgewell/trace-mapping": "^0.3.20",
-                "jest-worker": "^27.4.5",
-                "schema-utils": "^3.1.1",
-                "serialize-javascript": "^6.0.1",
-                "terser": "^5.26.0"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.1.1",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.1.1.tgz",
-                    "integrity": "sha512-Y5PQxS4ITlC+EahLuXaY86TXfR7Dc5lw294alXOq86JAHCihAIZfqv8nNCWvaEJvaC51uN9hbLGeV0cFBdH+Fw==",
                     "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
+                    "optional": true,
+                    "peer": true
                 }
             }
         },
         "thenify": {
             "version": "3.3.1",
-            "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
-            "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==",
             "dev": true,
             "requires": {
                 "any-promise": "^1.0.0"
@@ -16503,621 +3461,67 @@
         },
         "thenify-all": {
             "version": "1.6.0",
-            "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz",
-            "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==",
             "dev": true,
             "requires": {
                 "thenify": ">= 3.1.0 < 4"
             }
         },
-        "thunky": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/thunky/-/thunky-1.1.0.tgz",
-            "integrity": "sha512-eHY7nBftgThBqOyHGVN+l8gF0BucP09fMo0oO/Lb0w1OF80dJv+lDVpXG60WMQvkcxAkNybKsrEIE3ZtKGmPrA==",
-            "dev": true
-        },
-        "timers-browserify": {
-            "version": "2.0.12",
-            "resolved": "https://registry.npmjs.org/timers-browserify/-/timers-browserify-2.0.12.tgz",
-            "integrity": "sha512-9phl76Cqm6FhSX9Xe1ZUAMLtm1BLkKj2Qd5ApyWkXzsMRaA7dgr81kf4wJmQf/hAvg8EEyJxDo3du/0KlhPiKQ==",
-            "dev": true,
-            "requires": {
-                "setimmediate": "^1.0.4"
-            }
-        },
-        "to-arraybuffer": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",
-            "integrity": "sha512-okFlQcoGTi4LQBG/PgSYblw9VOyptsz2KJZqc6qtgGdes8VktzUQkj4BI2blit072iS8VODNcMA+tvnS9dnuMA==",
-            "dev": true
-        },
-        "to-fast-properties": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz",
-            "integrity": "sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=",
-            "dev": true
-        },
         "to-regex-range": {
             "version": "5.0.1",
-            "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-            "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
             "dev": true,
             "requires": {
                 "is-number": "^7.0.0"
             }
         },
-        "toidentifier": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
-            "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
-            "dev": true
-        },
         "ts-interface-checker": {
             "version": "0.1.13",
-            "resolved": "https://registry.npmjs.org/ts-interface-checker/-/ts-interface-checker-0.1.13.tgz",
-            "integrity": "sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==",
-            "dev": true
-        },
-        "tslib": {
-            "version": "2.4.0",
-            "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.4.0.tgz",
-            "integrity": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==",
             "dev": true
         },
-        "tty-browserify": {
-            "version": "0.0.0",
-            "resolved": "https://registry.npmjs.org/tty-browserify/-/tty-browserify-0.0.0.tgz",
-            "integrity": "sha512-JVa5ijo+j/sOoHGjw0sxw734b1LhBkQ3bvUGNdxnVXDCX81Yx7TFgnZygxrIIWn23hbfTaMYLwRmAxFyDuFmIw==",
-            "dev": true
-        },
-        "type-is": {
-            "version": "1.6.18",
-            "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
-            "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
-            "dev": true,
-            "requires": {
-                "media-typer": "0.3.0",
-                "mime-types": "~2.1.24"
-            }
-        },
-        "unicode-canonical-property-names-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-yY5PpDlfVIU5+y/BSCxAJRBIS1Zc2dDG3Ujq+sR0U+JjUevW2JhocOF+soROYDSaAezOzOKuyyixhD6mBknSmQ==",
-            "dev": true
-        },
-        "unicode-match-property-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==",
+        "undici-types": {
+            "version": "6.19.8",
             "dev": true,
-            "requires": {
-                "unicode-canonical-property-names-ecmascript": "^2.0.0",
-                "unicode-property-aliases-ecmascript": "^2.0.0"
-            }
-        },
-        "unicode-match-property-value-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-7Yhkc0Ye+t4PNYzOGKedDhXbYIBe1XEQYQxOPyhcXNMJ0WCABqqj6ckydd6pWRZTHV4GuCPKdBAUiMc60tsKVw==",
-            "dev": true
-        },
-        "unicode-property-aliases-ecmascript": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.0.0.tgz",
-            "integrity": "sha512-5Zfuy9q/DFr4tfO7ZPeVXb1aPoeQSdeFMLpYuFebehDAhbuevLs5yxSZmIFN1tP5F9Wl4IpJrYojg85/zgyZHQ==",
-            "dev": true
-        },
-        "universalify": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.0.tgz",
-            "integrity": "sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ==",
-            "dev": true
-        },
-        "unpipe": {
-            "version": "1.0.0",
-            "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
-            "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
-            "dev": true
+            "optional": true,
+            "peer": true
         },
         "update-browserslist-db": {
-            "version": "1.1.0",
-            "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.0.tgz",
-            "integrity": "sha512-EdRAaAyk2cUE1wOf2DkEhzxqOQvFOoRJFNS6NeyJ01Gp2beMRpBAINjM2iDXE3KCuKhwnvHIQCJm6ThL2Z+HzQ==",
-            "dev": true,
-            "requires": {
-                "escalade": "^3.1.2",
-                "picocolors": "^1.0.1"
-            }
-        },
-        "uri-js": {
-            "version": "4.4.1",
-            "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
-            "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
-            "dev": true,
-            "requires": {
-                "punycode": "^2.1.0"
-            },
-            "dependencies": {
-                "punycode": {
-                    "version": "2.1.1",
-                    "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz",
-                    "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==",
-                    "dev": true
-                }
-            }
-        },
-        "url": {
-            "version": "0.11.0",
-            "resolved": "https://registry.npmjs.org/url/-/url-0.11.0.tgz",
-            "integrity": "sha512-kbailJa29QrtXnxgq+DdCEGlbTeYM2eJUxsz6vjZavrCYPMIFHMKQmSKYAIuUK2i7hgPm28a8piX5NTUtM/LKQ==",
-            "dev": true,
-            "requires": {
-                "punycode": "1.3.2",
-                "querystring": "0.2.0"
-            },
-            "dependencies": {
-                "punycode": {
-                    "version": "1.3.2",
-                    "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.3.2.tgz",
-                    "integrity": "sha512-RofWgt/7fL5wP1Y7fxE7/EmTLzQVnB0ycyibJ0OOHIlJqTNzglYFxVwETOcIoJqJmpDXJ9xImDv+Fq34F/d4Dw==",
-                    "dev": true
-                }
-            }
-        },
-        "util": {
-            "version": "0.11.1",
-            "resolved": "https://registry.npmjs.org/util/-/util-0.11.1.tgz",
-            "integrity": "sha512-HShAsny+zS2TZfaXxD9tYj4HQGlBezXZMZuM/S5PKLLoZkShZiGk9o5CzukI1LVHZvjdvZ2Sj1aW/Ndn2NB/HQ==",
+            "version": "1.1.1",
             "dev": true,
             "requires": {
-                "inherits": "2.0.3"
-            },
-            "dependencies": {
-                "inherits": {
-                    "version": "2.0.3",
-                    "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-                    "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
-                    "dev": true
-                }
+                "escalade": "^3.2.0",
+                "picocolors": "^1.1.0"
             }
         },
         "util-deprecate": {
             "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-            "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=",
-            "dev": true
-        },
-        "utils-merge": {
-            "version": "1.0.1",
-            "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
-            "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
-            "dev": true
-        },
-        "uuid": {
-            "version": "8.3.2",
-            "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
-            "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
             "dev": true
         },
-        "vary": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
-            "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
-            "dev": true
-        },
-        "vm-browserify": {
-            "version": "1.1.2",
-            "resolved": "https://registry.npmjs.org/vm-browserify/-/vm-browserify-1.1.2.tgz",
-            "integrity": "sha512-2ham8XPWTONajOR0ohOKOHXkm3+gaBmGut3SRuu75xLd/RRaY6vqgh8NBYYk7+RW3u5AtzPQZG8F10LHkl0lAQ==",
-            "dev": true
-        },
-        "vue-style-loader": {
-            "version": "4.1.3",
-            "resolved": "https://registry.npmjs.org/vue-style-loader/-/vue-style-loader-4.1.3.tgz",
-            "integrity": "sha512-sFuh0xfbtpRlKfm39ss/ikqs9AbKCoXZBpHeVZ8Tx650o0k0q/YCM7FRvigtxpACezfq6af+a7JeqVTWvncqDg==",
-            "dev": true,
-            "requires": {
-                "hash-sum": "^1.0.2",
-                "loader-utils": "^1.0.2"
-            },
-            "dependencies": {
-                "json5": {
-                    "version": "1.0.2",
-                    "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
-                    "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
-                    "dev": true,
-                    "requires": {
-                        "minimist": "^1.2.0"
-                    }
-                },
-                "loader-utils": {
-                    "version": "1.4.2",
-                    "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
-                    "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
-                    "dev": true,
-                    "requires": {
-                        "big.js": "^5.2.2",
-                        "emojis-list": "^3.0.0",
-                        "json5": "^1.0.1"
-                    }
-                }
-            }
-        },
-        "watchpack": {
-            "version": "2.4.2",
-            "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.2.tgz",
-            "integrity": "sha512-TnbFSbcOCcDgjZ4piURLCbJ3nJhznVh9kw6F6iokjiFPl8ONxe9A6nMDVXDiNbrSfLILs6vB07F7wLBrwPYzJw==",
-            "dev": true,
-            "requires": {
-                "glob-to-regexp": "^0.4.1",
-                "graceful-fs": "^4.1.2"
-            }
-        },
-        "wbuf": {
-            "version": "1.7.3",
-            "resolved": "https://registry.npmjs.org/wbuf/-/wbuf-1.7.3.tgz",
-            "integrity": "sha512-O84QOnr0icsbFGLS0O3bI5FswxzRr8/gHwWkDlQFskhSPryQXvrTMxjxGP4+iWYoauLoBvfDpkrOauZ+0iZpDA==",
-            "dev": true,
-            "requires": {
-                "minimalistic-assert": "^1.0.0"
-            }
-        },
-        "webpack": {
-            "version": "5.94.0",
-            "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.94.0.tgz",
-            "integrity": "sha512-KcsGn50VT+06JH/iunZJedYGUJS5FGjow8wb9c0v5n1Om8O1g4L6LjtfxwlXIATopoQu+vOXXa7gYisWxCoPyg==",
-            "dev": true,
-            "requires": {
-                "@types/estree": "^1.0.5",
-                "@webassemblyjs/ast": "^1.12.1",
-                "@webassemblyjs/wasm-edit": "^1.12.1",
-                "@webassemblyjs/wasm-parser": "^1.12.1",
-                "acorn": "^8.7.1",
-                "acorn-import-attributes": "^1.9.5",
-                "browserslist": "^4.21.10",
-                "chrome-trace-event": "^1.0.2",
-                "enhanced-resolve": "^5.17.1",
-                "es-module-lexer": "^1.2.1",
-                "eslint-scope": "5.1.1",
-                "events": "^3.2.0",
-                "glob-to-regexp": "^0.4.1",
-                "graceful-fs": "^4.2.11",
-                "json-parse-even-better-errors": "^2.3.1",
-                "loader-runner": "^4.2.0",
-                "mime-types": "^2.1.27",
-                "neo-async": "^2.6.2",
-                "schema-utils": "^3.2.0",
-                "tapable": "^2.1.1",
-                "terser-webpack-plugin": "^5.3.10",
-                "watchpack": "^2.4.1",
-                "webpack-sources": "^3.2.3"
-            },
-            "dependencies": {
-                "schema-utils": {
-                    "version": "3.3.0",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
-                    "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.8",
-                        "ajv": "^6.12.5",
-                        "ajv-keywords": "^3.5.2"
-                    }
-                },
-                "webpack-sources": {
-                    "version": "3.2.3",
-                    "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.2.3.tgz",
-                    "integrity": "sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w==",
-                    "dev": true
-                }
-            }
-        },
-        "webpack-cli": {
-            "version": "4.10.0",
-            "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-4.10.0.tgz",
-            "integrity": "sha512-NLhDfH/h4O6UOy+0LSso42xvYypClINuMNBVVzX4vX98TmTaTUxwRbXdhucbFMd2qLaCTcLq/PdYrvi8onw90w==",
-            "dev": true,
-            "requires": {
-                "@discoveryjs/json-ext": "^0.5.0",
-                "@webpack-cli/configtest": "^1.2.0",
-                "@webpack-cli/info": "^1.5.0",
-                "@webpack-cli/serve": "^1.7.0",
-                "colorette": "^2.0.14",
-                "commander": "^7.0.0",
-                "cross-spawn": "^7.0.3",
-                "fastest-levenshtein": "^1.0.12",
-                "import-local": "^3.0.2",
-                "interpret": "^2.2.0",
-                "rechoir": "^0.7.0",
-                "webpack-merge": "^5.7.3"
-            }
-        },
-        "webpack-dev-middleware": {
-            "version": "5.3.4",
-            "resolved": "https://registry.npmjs.org/webpack-dev-middleware/-/webpack-dev-middleware-5.3.4.tgz",
-            "integrity": "sha512-BVdTqhhs+0IfoeAf7EoH5WE+exCmqGerHfDM0IL096Px60Tq2Mn9MAbnaGUe6HiMa41KMCYF19gyzZmBcq/o4Q==",
-            "dev": true,
-            "requires": {
-                "colorette": "^2.0.10",
-                "memfs": "^3.4.3",
-                "mime-types": "^2.1.31",
-                "range-parser": "^1.2.1",
-                "schema-utils": "^4.0.0"
-            },
-            "dependencies": {
-                "ajv": {
-                    "version": "8.11.0",
-                    "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-                    "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-                    "dev": true,
-                    "requires": {
-                        "fast-deep-equal": "^3.1.1",
-                        "json-schema-traverse": "^1.0.0",
-                        "require-from-string": "^2.0.2",
-                        "uri-js": "^4.2.2"
-                    }
-                },
-                "ajv-keywords": {
-                    "version": "5.1.0",
-                    "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
-                    "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
-                    "dev": true,
-                    "requires": {
-                        "fast-deep-equal": "^3.1.3"
-                    }
-                },
-                "json-schema-traverse": {
-                    "version": "1.0.0",
-                    "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-                    "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-                    "dev": true
-                },
-                "schema-utils": {
-                    "version": "4.0.0",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz",
-                    "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.9",
-                        "ajv": "^8.8.0",
-                        "ajv-formats": "^2.1.1",
-                        "ajv-keywords": "^5.0.0"
-                    }
-                }
-            }
-        },
-        "webpack-dev-server": {
-            "version": "4.9.3",
-            "resolved": "https://registry.npmjs.org/webpack-dev-server/-/webpack-dev-server-4.9.3.tgz",
-            "integrity": "sha512-3qp/eoboZG5/6QgiZ3llN8TUzkSpYg1Ko9khWX1h40MIEUNS2mDoIa8aXsPfskER+GbTvs/IJZ1QTBBhhuetSw==",
-            "dev": true,
-            "requires": {
-                "@types/bonjour": "^3.5.9",
-                "@types/connect-history-api-fallback": "^1.3.5",
-                "@types/express": "^4.17.13",
-                "@types/serve-index": "^1.9.1",
-                "@types/serve-static": "^1.13.10",
-                "@types/sockjs": "^0.3.33",
-                "@types/ws": "^8.5.1",
-                "ansi-html-community": "^0.0.8",
-                "bonjour-service": "^1.0.11",
-                "chokidar": "^3.5.3",
-                "colorette": "^2.0.10",
-                "compression": "^1.7.4",
-                "connect-history-api-fallback": "^2.0.0",
-                "default-gateway": "^6.0.3",
-                "express": "^4.17.3",
-                "graceful-fs": "^4.2.6",
-                "html-entities": "^2.3.2",
-                "http-proxy-middleware": "^2.0.3",
-                "ipaddr.js": "^2.0.1",
-                "open": "^8.0.9",
-                "p-retry": "^4.5.0",
-                "rimraf": "^3.0.2",
-                "schema-utils": "^4.0.0",
-                "selfsigned": "^2.0.1",
-                "serve-index": "^1.9.1",
-                "sockjs": "^0.3.24",
-                "spdy": "^4.0.2",
-                "webpack-dev-middleware": "^5.3.1",
-                "ws": "^8.4.2"
-            },
-            "dependencies": {
-                "ajv": {
-                    "version": "8.11.0",
-                    "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.11.0.tgz",
-                    "integrity": "sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==",
-                    "dev": true,
-                    "requires": {
-                        "fast-deep-equal": "^3.1.1",
-                        "json-schema-traverse": "^1.0.0",
-                        "require-from-string": "^2.0.2",
-                        "uri-js": "^4.2.2"
-                    }
-                },
-                "ajv-keywords": {
-                    "version": "5.1.0",
-                    "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
-                    "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
-                    "dev": true,
-                    "requires": {
-                        "fast-deep-equal": "^3.1.3"
-                    }
-                },
-                "json-schema-traverse": {
-                    "version": "1.0.0",
-                    "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
-                    "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
-                    "dev": true
-                },
-                "schema-utils": {
-                    "version": "4.0.0",
-                    "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.0.0.tgz",
-                    "integrity": "sha512-1edyXKgh6XnJsJSQ8mKWXnN/BVaIbFMLpouRUrXgVq7WYne5kw3MW7UPhO44uRXQSIpTSXoJbmrR2X0w9kUTyg==",
-                    "dev": true,
-                    "requires": {
-                        "@types/json-schema": "^7.0.9",
-                        "ajv": "^8.8.0",
-                        "ajv-formats": "^2.1.1",
-                        "ajv-keywords": "^5.0.0"
-                    }
-                }
-            }
-        },
-        "webpack-merge": {
-            "version": "5.8.0",
-            "resolved": "https://registry.npmjs.org/webpack-merge/-/webpack-merge-5.8.0.tgz",
-            "integrity": "sha512-/SaI7xY0831XwP6kzuwhKWVKDP9t1QY1h65lAFLbZqMPIuYcD9QAW4u9STIbU9kaJbPBB/geU/gLr1wDjOhQ+Q==",
-            "dev": true,
-            "requires": {
-                "clone-deep": "^4.0.1",
-                "wildcard": "^2.0.0"
-            }
-        },
-        "webpack-notifier": {
-            "version": "1.15.0",
-            "resolved": "https://registry.npmjs.org/webpack-notifier/-/webpack-notifier-1.15.0.tgz",
-            "integrity": "sha512-N2V8UMgRB5komdXQRavBsRpw0hPhJq2/SWNOGuhrXpIgRhcMexzkGQysUyGStHLV5hkUlgpRiF7IUXoBqyMmzQ==",
-            "dev": true,
-            "requires": {
-                "node-notifier": "^9.0.0",
-                "strip-ansi": "^6.0.0"
-            }
-        },
-        "webpack-sources": {
-            "version": "1.4.3",
-            "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-1.4.3.tgz",
-            "integrity": "sha512-lgTS3Xhv1lCOKo7SA5TjKXMjpSM4sBjNV5+q2bqesbSPs5FjGmU6jjtBSkX9b4qW87vDIsCIlUPOEhbZrMdjeQ==",
-            "dev": true,
-            "requires": {
-                "source-list-map": "^2.0.0",
-                "source-map": "~0.6.1"
-            }
-        },
-        "webpackbar": {
-            "version": "5.0.2",
-            "resolved": "https://registry.npmjs.org/webpackbar/-/webpackbar-5.0.2.tgz",
-            "integrity": "sha512-BmFJo7veBDgQzfWXl/wwYXr/VFus0614qZ8i9znqcl9fnEdiVkdbi0TedLQ6xAK92HZHDJ0QmyQ0fmuZPAgCYQ==",
-            "dev": true,
-            "requires": {
-                "chalk": "^4.1.0",
-                "consola": "^2.15.3",
-                "pretty-time": "^1.1.0",
-                "std-env": "^3.0.1"
-            }
-        },
-        "websocket-driver": {
-            "version": "0.7.4",
-            "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz",
-            "integrity": "sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg==",
+        "vite": {
+            "version": "5.4.10",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.10.tgz",
+            "integrity": "sha512-1hvaPshuPUtxeQ0hsVH3Mud0ZanOLwVTneA1EgbAM5LhaZEqyPWGRQ7BtaMvUrTDeEaC8pxtj6a6jku3x4z6SQ==",
             "dev": true,
             "requires": {
-                "http-parser-js": ">=0.5.1",
-                "safe-buffer": ">=5.1.0",
-                "websocket-extensions": ">=0.1.1"
+                "esbuild": "^0.21.3",
+                "fsevents": "~2.3.3",
+                "postcss": "^8.4.43",
+                "rollup": "^4.20.0"
             }
         },
-        "websocket-extensions": {
-            "version": "0.1.4",
-            "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz",
-            "integrity": "sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==",
-            "dev": true
-        },
         "which": {
             "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
-            "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
             "dev": true,
             "requires": {
                 "isexe": "^2.0.0"
             }
         },
-        "wildcard": {
-            "version": "2.0.0",
-            "resolved": "https://registry.npmjs.org/wildcard/-/wildcard-2.0.0.tgz",
-            "integrity": "sha512-JcKqAHLPxcdb9KM49dufGXn2x3ssnfjbcaQdLlfZsL9rH9wgDQjUtDxbo8NE0F6SFvydeu1VhZe7hZuHsB2/pw==",
-            "dev": true
-        },
-        "wrap-ansi": {
-            "version": "7.0.0",
-            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
-            "dev": true,
-            "requires": {
-                "ansi-styles": "^4.0.0",
-                "string-width": "^4.1.0",
-                "strip-ansi": "^6.0.0"
-            }
-        },
         "wrap-ansi-cjs": {
             "version": "npm:wrap-ansi@7.0.0",
-            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
-            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
             "dev": true,
             "requires": {
                 "ansi-styles": "^4.0.0",
                 "string-width": "^4.1.0",
                 "strip-ansi": "^6.0.0"
             }
-        },
-        "wrappy": {
-            "version": "1.0.2",
-            "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-            "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
-            "dev": true
-        },
-        "ws": {
-            "version": "8.17.1",
-            "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
-            "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
-            "dev": true,
-            "requires": {}
-        },
-        "xtend": {
-            "version": "4.0.2",
-            "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
-            "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
-            "dev": true
-        },
-        "y18n": {
-            "version": "5.0.8",
-            "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
-            "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
-            "dev": true
-        },
-        "yallist": {
-            "version": "4.0.0",
-            "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
-            "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==",
-            "dev": true
-        },
-        "yaml": {
-            "version": "1.10.2",
-            "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz",
-            "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==",
-            "dev": true
-        },
-        "yargs": {
-            "version": "17.5.1",
-            "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.5.1.tgz",
-            "integrity": "sha512-t6YAJcxDkNX7NFYiVtKvWUz8l+PaKTLiL63mJYWR2GnHq2gjEWISzsLp9wg3aY36dY1j+gfIEL3pIF+XlJJfbA==",
-            "dev": true,
-            "requires": {
-                "cliui": "^7.0.2",
-                "escalade": "^3.1.1",
-                "get-caller-file": "^2.0.5",
-                "require-directory": "^2.1.1",
-                "string-width": "^4.2.3",
-                "y18n": "^5.0.5",
-                "yargs-parser": "^21.0.0"
-            }
-        },
-        "yargs-parser": {
-            "version": "21.0.1",
-            "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.0.1.tgz",
-            "integrity": "sha512-9BK1jFpLzJROCI5TzwZL/TU4gqjK5xiHV/RfWLOahrjAko/e4DJkRDZQXfvqAsiZzzYhgAzbgz6lg48jcm4GLg==",
-            "dev": true
         }
     }
 }
diff --git a/package.json b/package.json
index 92b803f3e8e..e11b5c60f32 100644
--- a/package.json
+++ b/package.json
@@ -1,17 +1,17 @@
 {
     "private": true,
     "scripts": {
-        "dev": " mix",
-        "prod": "mix --production",
-        "watch": "mix watch"
+        "dev": "vite",
+        "build": "vite build",
+        "preview": "vite preview"
     },
     "devDependencies": {
         "@tailwindcss/typography": "^0.5.15",
         "autoprefixer": "^10.4.20",
         "hydefront": "^3.3.0",
-        "laravel-mix": "^6.0.49",
         "postcss": "^8.4.47",
         "prettier": "3.3.3",
-        "tailwindcss": "^3.4.14"
+        "tailwindcss": "^3.4.14",
+        "vite": "^5.0.0"
     }
 }

From 7452e7c5d162bb8c1d1c1b3fe4b6ed875344454f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:50:47 +0100
Subject: [PATCH 3195/4023] Create vite.config.js

---
 vite.config.js | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 vite.config.js

diff --git a/vite.config.js b/vite.config.js
new file mode 100644
index 00000000000..de5592c2cf7
--- /dev/null
+++ b/vite.config.js
@@ -0,0 +1,29 @@
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+
+export default defineConfig({
+    build: {
+        outDir: '_site/media',
+        emptyOutDir: true,
+        rollupOptions: {
+            input: {
+                app: resolve(__dirname, 'resources/assets/app.js'),
+                style: resolve(__dirname, 'resources/assets/app.css')
+            },
+            output: {
+                entryFileNames: '[name].js',
+                chunkFileNames: '[name].js',
+                assetFileNames: '[name].[ext]'
+            }
+        }
+    },
+    plugins: [
+        {
+            name: 'copy-media',
+            writeBundle() {
+                // Copy files from _site/media to _media
+                // You may want to use fs.copyFileSync or similar here
+            }
+        }
+    ]
+});
\ No newline at end of file

From ac7bf1615d540791cf9ad435127654a6736fe2a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:50:49 +0100
Subject: [PATCH 3196/4023] Create postcss.config.js

---
 postcss.config.js | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 postcss.config.js

diff --git a/postcss.config.js b/postcss.config.js
new file mode 100644
index 00000000000..92642045710
--- /dev/null
+++ b/postcss.config.js
@@ -0,0 +1,6 @@
+export default {
+    plugins: {
+        tailwindcss: {},
+        autoprefixer: {}
+    }
+}

From f8b72282ffa7b7f5d356cc3858a96309884e2134 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:52:35 +0100
Subject: [PATCH 3197/4023] Delete webpack.mix.js

---
 webpack.mix.js | 12 ------------
 1 file changed, 12 deletions(-)
 delete mode 100644 webpack.mix.js

diff --git a/webpack.mix.js b/webpack.mix.js
deleted file mode 100644
index e8d11abbc98..00000000000
--- a/webpack.mix.js
+++ /dev/null
@@ -1,12 +0,0 @@
-// Using Laravel Mix is optional as the styles you need to get started are already included.
-// However, if you add new Tailwind classes, or any customizations, you can use Webpack to
-// compile the assets. See https://hydephp.com/docs/1.x/managing-assets.html.
-
-let mix = require('laravel-mix');
-
-mix.js('resources/assets/app.js', 'app.js')
-    .postCss('resources/assets/app.css', 'app.css', [
-        require('tailwindcss'),
-        require('autoprefixer'),
-    ]).setPublicPath('_site/media')
-    .copyDirectory('_site/media', '_media')

From 83c129a16284b53fe44dba2257f07f9a5a7f200a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:52:37 +0100
Subject: [PATCH 3198/4023] Update vite.config.js

---
 vite.config.js | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/vite.config.js b/vite.config.js
index de5592c2cf7..b1034dc7b23 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -1,3 +1,7 @@
+// Using Vite is optional, as the styles you need to get started are already included.
+// However, if you customize existing or add new Tailwind classes, you can use Vite
+// to compile the assets. See https://hydephp.com/docs/1.x/managing-assets.html.
+
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
 

From 3e82a79b2addd73971bb7d792ea6aa73d0ddef1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:56:09 +0100
Subject: [PATCH 3199/4023] Update documentation for Vite

---
 docs/creating-content/managing-assets.md         | 16 ++++++++--------
 docs/digging-deeper/advanced-customization.md    |  2 +-
 docs/digging-deeper/updating-hyde.md             |  2 +-
 docs/extensions/ui-kit.md                        |  2 +-
 docs/getting-started/core-concepts.md            |  2 +-
 .../resources/views/layouts/scripts.blade.php    |  2 +-
 resources/assets/app.js                          |  2 +-
 7 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index a6eba76523e..f45362cfefb 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -13,7 +13,7 @@ With Hyde, **you don't have to do it**, in fact, you can skip this entire page i
 But as always with Hyde, you can customize everything if you want to.
 
 Hyde ships with a complete frontend using Blade views, TailwindCSS styles, and Alpine.js interactions.
-Some extra custom styles are made in the HydeFront package, which is pre-installed and bundled in the pre-configured Laravel Mix.
+Some extra custom styles are made in the HydeFront package, which is pre-installed and bundled in the pre-configured Tailwind and Vite setup.
 
 To get you started quickly, all the styles are already compiled and minified into `_media/app.css`,
 which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.
@@ -51,22 +51,22 @@ all asset files here will get copied as they are into the `_site/media` folder.
 It may seem weird to have two folders for storing the compiled assets, but it is quite useful.
 
 The `_site` directory is intended to be excluded from version control, while the `_media` folder is included in the
-version control. You are of course free to modify this behaviour by editing the `webpack.mix.js` file to change the output directory.
+version control. You are of course free to modify this behaviour by editing the `vite.config.js` file to change the output directory.
 
 ## How Do I Compile Assets?
 
 First, make sure that you have installed all the NodeJS dependencies using `npm install`.
-Then run `npm run dev` to compile the assets. If you want to compile the assets for production, run `npm run prod`.
-You can also run `npm run watch` to watch for changes in the source files and recompile the assets automatically.
+Then run `npm run dev` to compile the assets in development mode. For production builds, run `npm run build`.
+You can also run `npm run preview` to preview the built assets.
 
 ### How does it work?
 
-Hyde uses [Laravel Mix](https://laravel-mix.com/) (which is a wrapper for [Webpack](https://webpack.js.org/)) to compile the assets.
+Hyde uses [Vite](https://vite.dev/) to compile assets.
 
 When running the `npm run dev/prod` command, the following happens:
 
-1. Laravel Mix will compile the `resources/assets/app.css` file into `_media/app.css` using PostCSS with TailwindCSS and AutoPrefixer.
-2. Mix then copies the `_media` folder into `_site/media`, this is so that they are automatically accessible to your site without having to rerun `php hyde build`.
+1. Vite will compile the `resources/assets/app.css` file into `_media/app.css` using PostCSS with TailwindCSS and AutoPrefixer.
+2. Vite then copies the `_media` folder into `_site/media`, this is so that they are automatically accessible to your site without having to rerun `php hyde build`.
 
 ## Telling Hyde where to find assets
 
@@ -102,7 +102,7 @@ set `use_play_cdn` to `true` in the `config/hyde.php` file. This will in additio
 also add a script tag which loads the TailwindCSS Play CDN.
 
 What's even better is that Hyde will also inject the contents of the included `tailwind.config.js` file into the script tag,
-so the Play CDN styles match the ones created by Laravel Mix.
+so the Play CDN styles match the ones created by Vite.
 
 All in all, this allows you to tinker around with Tailwind without having to compile anything.
 
diff --git a/docs/digging-deeper/advanced-customization.md b/docs/digging-deeper/advanced-customization.md
index 0488dabf7e0..bcc890ba465 100644
--- a/docs/digging-deeper/advanced-customization.md
+++ b/docs/digging-deeper/advanced-customization.md
@@ -152,7 +152,7 @@ You can change the path to this directory by setting the `media_directory` optio
 
 #### Next steps
 
-1. Note that you will likely need to manually update `webpack.mix.js` so Laravel Mix can compile the assets correctly.
+1. Note that you will likely need to manually update `vite.config.js` so Vite can compile the assets correctly.
 2. You will of course also need to copy over any existing files from the old directory to the new one.
 
 #### Note that this setting affects both source and output directories
diff --git a/docs/digging-deeper/updating-hyde.md b/docs/digging-deeper/updating-hyde.md
index d957cd1f8dd..9bb4b060c0e 100644
--- a/docs/digging-deeper/updating-hyde.md
+++ b/docs/digging-deeper/updating-hyde.md
@@ -116,7 +116,7 @@ Here are the paths you may be interested in copying over: (Using Git will help a
 ├── package.json
 ├── resources/
 ├── tailwind.config.js
-└── webpack.mix.js
+└── vite.config.js
 ```
 
 Next, recompile your assets, if you are not using the built-in assets.
diff --git a/docs/extensions/ui-kit.md b/docs/extensions/ui-kit.md
index b632c0719cc..841dfbc8096 100644
--- a/docs/extensions/ui-kit.md
+++ b/docs/extensions/ui-kit.md
@@ -2,7 +2,7 @@
 
 The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCSS components for Laravel Blade,
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
-file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
+file and that you may need to recompile the CSS file using the included Tailwind and Vite configuration.
 
 ## Screenshot
 
diff --git a/docs/getting-started/core-concepts.md b/docs/getting-started/core-concepts.md
index 99d343fb6bc..47ed038ef70 100644
--- a/docs/getting-started/core-concepts.md
+++ b/docs/getting-started/core-concepts.md
@@ -40,7 +40,7 @@ To take full advantage of the framework, it may first be good to familiarize our
 | `_media`           | Store static assets to be copied to the build directory     |
 | `_site`            | The build directory where your compiled site will be stored |
 | `config`           | Configuration files for Hyde and integrations               |
-| `resources/assets` | Location for Laravel Mix source files (optional)            |
+| `resources/assets` | Location for CSS/JS Vite source files (optional)            |
 | `resources/views`  | Location for Blade components (optional)                    |
 | `app`              | Location for custom PHP classes (optional)                  |
 
diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php
index abc3a7030b5..9e121211b45 100644
--- a/packages/framework/resources/views/layouts/scripts.blade.php
+++ b/packages/framework/resources/views/layouts/scripts.blade.php
@@ -1,4 +1,4 @@
-{{-- The compiled Laravel Mix scripts --}}
+{{-- The compiled Vite scripts --}}
 @if(Asset::exists('app.js'))
     <script defer src="{{ Asset::get('app.js') }}"></script>
 @endif
diff --git a/resources/assets/app.js b/resources/assets/app.js
index 5013481cea6..be140143fa0 100644
--- a/resources/assets/app.js
+++ b/resources/assets/app.js
@@ -1,3 +1,3 @@
 /*
-* This is the main JavaScript used by webpack to build the the app.js file.
+* This is the main JavaScript used by Vite to build the the app.js file.
 */

From d7678f171a87eed68ade57f1870e5b778411bb57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 11:57:15 +0100
Subject: [PATCH 3200/4023] Update quickstart for Vite

---
 docs/getting-started/quickstart.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
index 6f962d031cf..b8606e0999f 100644
--- a/docs/getting-started/quickstart.md
+++ b/docs/getting-started/quickstart.md
@@ -68,7 +68,7 @@ on what kind of page it is. You don't have to worry about routing as Hyde takes
 
 ### Managing assets
 
-Hyde comes bundled with a precompiled and minified `app.css` file, containing all the Tailwind you need for the default views meaning that you don't even need to use NPM. However, Hyde is already configured to use Laravel Mix to compile your assets if you feel like there's a need to build the assets yourself. See more on the [Managing Assets](managing-assets) page.
+Hyde comes bundled with a precompiled and minified `app.css` file, containing all the Tailwind you need for the default views meaning that you don't even need to use NPM. However, Hyde is already configured to use Vite to compile your assets if you feel like there's a need to build the assets yourself. See more on the [Managing Assets](managing-assets) page.
 
 ### Deploying your site
 

From cba4be9b123518d7b9ca1e3d705f9ba0d4f077cd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 12:00:29 +0100
Subject: [PATCH 3201/4023] Merge PostCSS config into Vite config

---
 postcss.config.js |  6 ------
 vite.config.js    | 10 ++++++++++
 2 files changed, 10 insertions(+), 6 deletions(-)
 delete mode 100644 postcss.config.js

diff --git a/postcss.config.js b/postcss.config.js
deleted file mode 100644
index 92642045710..00000000000
--- a/postcss.config.js
+++ /dev/null
@@ -1,6 +0,0 @@
-export default {
-    plugins: {
-        tailwindcss: {},
-        autoprefixer: {}
-    }
-}
diff --git a/vite.config.js b/vite.config.js
index b1034dc7b23..0f9ed0e60a8 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -4,8 +4,18 @@
 
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
+import tailwindcss from 'tailwindcss';
+import autoprefixer from 'autoprefixer';
 
 export default defineConfig({
+    css: {
+        postcss: {
+            plugins: [
+                tailwindcss,
+                autoprefixer
+            ]
+        }
+    },
     build: {
         outDir: '_site/media',
         emptyOutDir: true,

From 811730fb1ac4521fa459d20db6538c0453d2beda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 12:33:04 +0100
Subject: [PATCH 3202/4023] Update module import syntax for Vite

---
 resources/assets/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/assets/app.css b/resources/assets/app.css
index dc762b9fd11..dc24361dfc1 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,7 +11,7 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import '~hydefront/dist/hyde.css';
+@import 'hydefront/dist/hyde.css';
 
 @tailwind base;
 @tailwind components;

From ec1722135cce75737e64a016a24077440f328194 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 12:33:36 +0100
Subject: [PATCH 3203/4023] Remove Vite preview command

---
 docs/creating-content/managing-assets.md | 1 -
 package.json                             | 3 +--
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index f45362cfefb..332c9b7c2dd 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -57,7 +57,6 @@ version control. You are of course free to modify this behaviour by editing the
 
 First, make sure that you have installed all the NodeJS dependencies using `npm install`.
 Then run `npm run dev` to compile the assets in development mode. For production builds, run `npm run build`.
-You can also run `npm run preview` to preview the built assets.
 
 ### How does it work?
 
diff --git a/package.json b/package.json
index e11b5c60f32..5a1c60e066d 100644
--- a/package.json
+++ b/package.json
@@ -2,8 +2,7 @@
     "private": true,
     "scripts": {
         "dev": "vite",
-        "build": "vite build",
-        "preview": "vite preview"
+        "build": "vite build"
     },
     "devDependencies": {
         "@tailwindcss/typography": "^0.5.15",

From 6d877b5fb81e920464450228ab0534233db62bae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 17:19:38 +0100
Subject: [PATCH 3204/4023] Use implicit module names

---
 vite.config.js | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/vite.config.js b/vite.config.js
index 0f9ed0e60a8..63e55c6d696 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -20,10 +20,10 @@ export default defineConfig({
         outDir: '_site/media',
         emptyOutDir: true,
         rollupOptions: {
-            input: {
-                app: resolve(__dirname, 'resources/assets/app.js'),
-                style: resolve(__dirname, 'resources/assets/app.css')
-            },
+            input: [
+                resolve(__dirname, 'resources/assets/app.js'),
+                resolve(__dirname, 'resources/assets/app.css')
+            ],
             output: {
                 entryFileNames: '[name].js',
                 chunkFileNames: '[name].js',

From 5a51dd0e5e78360e9c84f6e5754fdf02a36772e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 17:24:46 +0100
Subject: [PATCH 3205/4023] Copy files after bundling assets

---
 vite.config.js | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/vite.config.js b/vite.config.js
index 63e55c6d696..d786c16d3d7 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -36,7 +36,36 @@ export default defineConfig({
             name: 'copy-media',
             writeBundle() {
                 // Copy files from _site/media to _media
-                // You may want to use fs.copyFileSync or similar here
+                const fs = require('fs');
+                const path = require('path');
+
+                const sourceDir = '_site/media';
+                const targetDir = '_media';
+
+                if (!fs.existsSync(targetDir)) {
+                    fs.mkdirSync(targetDir, { recursive: true });
+                }
+
+                // Copy all files recursively
+                function copyRecursively(source, target) {
+                    const files = fs.readdirSync(source);
+
+                    files.forEach(file => {
+                        const sourcePath = path.join(source, file);
+                        const targetPath = path.join(target, file);
+
+                        if (fs.lstatSync(sourcePath).isDirectory()) {
+                            if (!fs.existsSync(targetPath)) {
+                                fs.mkdirSync(targetPath, { recursive: true });
+                            }
+                            copyRecursively(sourcePath, targetPath);
+                        } else {
+                            fs.copyFileSync(sourcePath, targetPath);
+                        }
+                    });
+                }
+
+                copyRecursively(sourceDir, targetDir);
             }
         }
     ]

From f98e593c7adcae78c2c4dc5578ef6699db0f3c8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 22:15:58 +0100
Subject: [PATCH 3206/4023] Update test for Vite

---
 monorepo/scripts/tests/project-styles.php | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/monorepo/scripts/tests/project-styles.php b/monorepo/scripts/tests/project-styles.php
index c4062890cc3..4ca8741482c 100644
--- a/monorepo/scripts/tests/project-styles.php
+++ b/monorepo/scripts/tests/project-styles.php
@@ -16,15 +16,12 @@
     $this->assert(file_exists(BASE_PATH.'/node_modules'), 'Node modules do not exist');
 });
 
-test('can build assets using laravel mix', function () {
-    $output = shell_exec('cd '.BASE_PATH.' && npm run dev');
+test('can build assets using vite', function () {
+    $output = shell_exec('cd '.BASE_PATH.' && npm run build');
 
     $this->assert(file_exists(BASE_PATH.'/_media/app.css'), 'CSS file does not exist');
     $this->assert(file_exists(BASE_PATH.'/_site/media/app.css'), 'CSS file does not exist');
 
     $this->assert(file_exists(BASE_PATH.'/_media/app.js'), 'JS file does not exist');
     $this->assert(file_exists(BASE_PATH.'/_site/media/app.js'), 'JS file does not exist');
-
-    $this->assert(file_exists(BASE_PATH.'/_media/mix-manifest.json'), 'Mix manifest file does not exist');
-    $this->assert(file_exists(BASE_PATH.'/_site/media/mix-manifest.json'), 'Mix manifest file does not exist');
 });

From ff6c3059205887276b0164919050221b8945f5d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 10 Nov 2024 22:49:58 +0100
Subject: [PATCH 3207/4023] Replace Mix build command with Vite build

---
 .github/workflows/continuous-integration.yml                 | 4 ++--
 monorepo/docs/hydefront.md                                   | 2 +-
 packages/framework/src/Console/Commands/BuildSiteCommand.php | 2 +-
 packages/framework/tests/Feature/StaticSiteServiceTest.php   | 2 +-
 packages/hydefront/.github/workflows/node.js.yml             | 2 +-
 packages/hydefront/README.md                                 | 2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml
index ec904dc94d1..d7d3cd93588 100644
--- a/.github/workflows/continuous-integration.yml
+++ b/.github/workflows/continuous-integration.yml
@@ -128,7 +128,7 @@ jobs:
 
       - name: Build assets for production
         working-directory: 'packages/hydefront'
-        run: npm run prod
+        run: npm run build
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
@@ -164,7 +164,7 @@ jobs:
         run: sed -i 's/\.\/vendor\/hyde\/framework\/resources\/views\/\*\*\/\*\.blade\.php/\.\/packages\/framework\/resources\/views\/\*\*\/\*\.blade\.php/' tailwind.config.js
 
       - name: Build assets for production
-        run: npm run prod
+        run: npm run build
 
       - name: Copy compiled app.css file to HydeFront dist folder
         run: cp _media/app.css packages/hydefront/dist/app.css
diff --git a/monorepo/docs/hydefront.md b/monorepo/docs/hydefront.md
index cb7733eabcd..0b31affd451 100644
--- a/monorepo/docs/hydefront.md
+++ b/monorepo/docs/hydefront.md
@@ -48,7 +48,7 @@ This will create commits in both the monorepo and submodule. Now follow the foll
 
 1. Verify that both commits are correct.
 2. Build the new `app.css` through the monorepo
-    - [ ] `npm run prod`
+    - [ ] `npm run build`
 3. Copy the compiled file to the HydeFront repository so it can be served from the CDN.
     - [ ] `cp _media/app.css packages/hydefront/dist/app.css`
 4. Amend the HydeFront commit with the new `app.css` file.
diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index 84ecf1fda17..b5aa1950af2 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -105,7 +105,7 @@ public function runPostBuildActions(): void
         }
 
         if ($this->option('run-prod')) {
-            $this->runNodeCommand('npm run prod', 'Building frontend assets for production!');
+            $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
         }
     }
 
diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 580139033ba..25931842235 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -168,7 +168,7 @@ public function testNodeActionOutputs()
 
         Process::assertRan(fn ($process) => $process->command === 'npx prettier '.Hyde::pathToRelative(Hyde::sitePath()).'/**/*.html --write --bracket-same-line');
         Process::assertRan(fn ($process) => $process->command === 'npm run dev');
-        Process::assertRan(fn ($process) => $process->command === 'npm run prod');
+        Process::assertRan(fn ($process) => $process->command === 'npm run build');
     }
 
     public function testPrettyUrlsOptionOutput()
diff --git a/packages/hydefront/.github/workflows/node.js.yml b/packages/hydefront/.github/workflows/node.js.yml
index 42a5b430521..e4b668cbf0e 100644
--- a/packages/hydefront/.github/workflows/node.js.yml
+++ b/packages/hydefront/.github/workflows/node.js.yml
@@ -24,7 +24,7 @@ jobs:
         run: npm ci
 
       - name: Build assets for production
-        run: npm run prod
+        run: npm run build
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
diff --git a/packages/hydefront/README.md b/packages/hydefront/README.md
index bd7f6ebb3e6..21517a74cc2 100644
--- a/packages/hydefront/README.md
+++ b/packages/hydefront/README.md
@@ -19,7 +19,7 @@ The Hyde stylesheet contains a small set of styles that don't make sense to use
 Normally, this file is imported into the main.css file.
 
 - **App.css**:
-A compiled and minified file containing the TailwindCSS styles for a base Hyde installation. It includes the Hyde.css file. This file is identical to what one would get by running `npm run prod` in a new HydePHP project (which incidentally is exactly how this file is generated).
+A compiled and minified file containing the TailwindCSS styles for a base Hyde installation. It includes the Hyde.css file. This file is identical to what one would get by running `npm run build` in a new HydePHP project (which incidentally is exactly how this file is generated).
 
 
 ## Usage

From da99206ec53c2f7ffcf02ca630f63ddeee1c5ccf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 09:59:10 +0100
Subject: [PATCH 3208/4023] Document build command instead of run dev

---
 docs/digging-deeper/troubleshooting.md | 2 +-
 packages/hyde/README.md                | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/digging-deeper/troubleshooting.md b/docs/digging-deeper/troubleshooting.md
index dbea18f6201..e3c4ae9879c 100644
--- a/docs/digging-deeper/troubleshooting.md
+++ b/docs/digging-deeper/troubleshooting.md
@@ -73,7 +73,7 @@ You can read more about some of these in the [Core Concepts](core-concepts#paths
 | Page not discovered when compiling                 | The file name may be invalid                                                                                                                              | Ensure you follow the correct file naming convention.                                                                                                                                             |
 | Page compiles slowly                               | The Torchlight extension may cause the compile times to increase as API calls need to be made.                                                            | Try disabling Torchlight                                                                                                                                                                          |
 | Torchlight not working                             | Missing Composer package, missing API token, extension disabled in the config.                                                                            | Reinstall Torchlight, add your token in the `.env` file, check config                                                                                                                             |
-| Missing styles and/or assets                       | You may have accidentally deleted the files, or you have added new Tailwind classes.                                                                      | Run `npm run dev`                                                                                                                                                                                 |
+| Missing styles and/or assets                       | You may have accidentally deleted the files, or you have added new Tailwind classes.                                                                      | Run `npm run build`                                                                                                                                                                               |
 | Image not found                                    | You may be using a bad relative path.                                                                                                                     | Ensure your relative paths are correct.  See [managing-assets](managing-assets#referencing-images).                                                                                               |
 | Wrong layout used                                  | Hyde determines the layout template to use depending on the directory of the source file                                                                  | Ensure your source file is in the right directory.                                                                                                                                                |
 | Invalid/no permalinks or post URIs                 | You may be missing or have an invalid site URL                                                                                                            | Set the site URL in the `.env` file                                                                                                                                                               |
diff --git a/packages/hyde/README.md b/packages/hyde/README.md
index 3a2f42d8436..727c8a55e49 100644
--- a/packages/hyde/README.md
+++ b/packages/hyde/README.md
@@ -49,7 +49,7 @@ See the documentation and learn more at https://hydephp.com/docs
 
 - The Hyde starter comes with [HydeFront](https://github.com/hydephp/hydefront) to serve the base stylesheet and JavaScript through the jsDelivr CDN.
 - Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.
-- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run dev` command to recompile the styles using the pre-configured Laravel Mix package.
+- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run build` command to recompile the styles using the pre-configured Laravel Mix package.
 
 ### Customization
 

From a8a1f6c60bb8c3e2dde4f66d57dd445951bbe6f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 10:01:32 +0100
Subject: [PATCH 3209/4023] Update package documentation to reference Vite

---
 packages/hyde/README.md                                   | 2 +-
 packages/ui-kit/README.md                                 | 4 ++--
 packages/ui-kit/docs/documentation.md                     | 2 +-
 tests/fixtures/example-sites/ui-examples/documentation.md | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/hyde/README.md b/packages/hyde/README.md
index 727c8a55e49..00a34c0415a 100644
--- a/packages/hyde/README.md
+++ b/packages/hyde/README.md
@@ -49,7 +49,7 @@ See the documentation and learn more at https://hydephp.com/docs
 
 - The Hyde starter comes with [HydeFront](https://github.com/hydephp/hydefront) to serve the base stylesheet and JavaScript through the jsDelivr CDN.
 - Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.
-- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run build` command to recompile the styles using the pre-configured Laravel Mix package.
+- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run build` command to recompile the styles using the pre-configured Tailwind and Vite configuration.
 
 ### Customization
 
diff --git a/packages/ui-kit/README.md b/packages/ui-kit/README.md
index 487c5208457..ef72372c3f4 100644
--- a/packages/ui-kit/README.md
+++ b/packages/ui-kit/README.md
@@ -7,7 +7,7 @@
 
 The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCSS components for Laravel Blade,
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
-file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
+file and that you may need to recompile the CSS file using the included Tailwind and Vite configuration.
 
 ## Installation
 
@@ -24,7 +24,7 @@ Since HydePHP already comes with several built-in views and templates, including
 Once installed, the package service provider will automatically register the Blade components for you to use.
 
 You can then use the components and layouts when crafting your custom Blade pages.
-You might also need to recompile the CSS file using the Laravel Mix configuration included with Hyde.
+You might also need to recompile the CSS file using the Tailwind and Vite configuration included with Hyde.
 
 You can see a list of all available components in the [documentation](https://hydephp.github.io/ui-kit/).
 
diff --git a/packages/ui-kit/docs/documentation.md b/packages/ui-kit/docs/documentation.md
index 946c82e3a73..fb794676b0f 100644
--- a/packages/ui-kit/docs/documentation.md
+++ b/packages/ui-kit/docs/documentation.md
@@ -6,7 +6,7 @@ title: Documentation
 
 The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCSS components for Laravel Blade,
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
-file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
+file and that you may need to recompile the CSS file using the included Tailwind and Vite configuration.
 
 ## Screenshot
 
diff --git a/tests/fixtures/example-sites/ui-examples/documentation.md b/tests/fixtures/example-sites/ui-examples/documentation.md
index 41235c6c585..48b2dd3bc9d 100644
--- a/tests/fixtures/example-sites/ui-examples/documentation.md
+++ b/tests/fixtures/example-sites/ui-examples/documentation.md
@@ -2,7 +2,7 @@
 
 The HydePHP UI Kit is a collection of minimalistic and un-opinionated TailwindCSS components for Laravel Blade,
 indented to be used with HydePHP. Note that these components may require CSS classes not present in the bundled app.css
-file and that you may need to recompile the CSS file using the included Laravel Mix configuration.
+file and that you may need to recompile the CSS file using the included Tailwind and Vite configuration.
 
 ## Warning
 

From e6667aa19d4b19cde8b82e00441685f86e071c8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 10:02:31 +0100
Subject: [PATCH 3210/4023] Rebuild assets with Vite

---
 _media/app.css                             | 3 +--
 packages/hyde/tests/DefaultContentTest.php | 8 ++++----
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 71c4c32bee0..cb39212aa25 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1,2 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{margin-top:1.25em;max-height:60vh;overflow-y:auto}#search-status{margin-top:0}#sidebar-toggle{display:inline-block;height:2rem;position:relative;width:2rem}#sidebar-toggle span.icon-bar{background-color:#000;display:block;height:2.375px;left:5.5px;position:absolute;transition:all .3s ease-out;width:20px}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-bottom:.35rem;margin-top:.15rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;margin-left:-2rem;opacity:.825;padding-left:2rem}.table-of-contents a:before{content:"#";font-size:75%;margin-right:4px;opacity:.5;transition:opacity .3s ease-in-out}.table-of-contents a:hover{background-color:hsla(0,0%,50%,.2);opacity:1;transition:opacity,background .3s ease-in-out}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink{filter:grayscale(100%);opacity:.75;transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{margin-left:.25rem;opacity:0;padding:0 .25rem;scroll-margin:1rem;transition:opacity .3s ease}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover{filter:unset;opacity:1}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-bottom:1rem;margin-top:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-bottom:1rem;padding-top:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246/var(--tw-border-opacity))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94/var(--tw-border-opacity))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11/var(--tw-border-opacity))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38/var(--tw-border-opacity))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{float:right;opacity:.5;position:relative;right:.25rem;top:-.25rem;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width:767px){pre>code>.filepath{display:none}}@media screen and (min-width:768px){[x-cloak].x-uncloak-md{display:revert!important}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}
-/*! tailwindcss v3.4.14 | MIT License | https://tailwindcss.com*/*,:after,:before{border:0 solid #e5e7eb;box-sizing:border-box}:after,:before{--tw-content:""}:host,html{-webkit-text-size-adjust:100%;font-feature-settings:normal;-webkit-tap-highlight-color:transparent;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-variation-settings:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4}body{line-height:inherit;margin:0}hr{border-top-width:1px;color:inherit;height:0}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-feature-settings:normal;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em;font-variation-settings:normal}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{border-collapse:collapse;border-color:inherit;text-indent:0}button,input,optgroup,select,textarea{font-feature-settings:inherit;color:inherit;font-family:inherit;font-size:100%;font-variation-settings:inherit;font-weight:inherit;letter-spacing:inherit;line-height:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{color:#9ca3af;opacity:1}input::placeholder,textarea::placeholder{color:#9ca3af;opacity:1}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{height:auto;max-width:100%}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em;margin-top:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-bottom:1.2em;margin-top:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-bottom:1.25em;margin-top:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-bottom:1.25em;margin-top:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-bottom:3em;margin-top:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:#80808020;border-inline-start-color:var(--tw-prose-quote-borders);border-inline-start-width:.25rem;border-left-color:#d1d5db;color:unset;font-style:unset;font-weight:500;line-height:1.25em;margin-bottom:1em;margin-top:1em;padding-bottom:.25em;padding-inline-start:1em;padding-left:.75em;padding-top:.25em;quotes:"\201C""\201D""\2018""\2019"}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-bottom:.25em;margin-top:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:2.25em;font-weight:800;line-height:1.1111111;margin-bottom:.8888889em;margin-top:0}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:1.5em;font-weight:700;line-height:1.3333333;margin-bottom:.75em;margin-top:1.5em}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:1.25em;font-weight:600;line-height:1.6;margin-bottom:.6em;margin-top:1.6em}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;line-height:1.5;margin-bottom:.5em;margin-top:1.5em}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-bottom:2em;margin-top:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){border-radius:.3125rem;box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px 0 rgb(var(--tw-prose-kbd-shadows)/10%);color:var(--tw-prose-kbd);font-family:inherit;font-size:.875em;font-weight:500;padding-inline-end:.375em;padding-bottom:.1875em;padding-top:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:#80808033;border-radius:4px;color:var(--tw-prose-code);font-size:.875em;font-weight:600;font:unset;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:var(--tw-prose-pre-bg);border-radius:.375rem;color:var(--tw-prose-pre-code);font-size:.875em;font-weight:400;line-height:1.7142857;margin-bottom:1.7142857em;margin-top:1.7142857em;overflow-x:auto;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-top:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,Monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-radius:0;border-width:0;color:inherit;font-family:inherit;font-size:inherit;font-weight:inherit;line-height:inherit;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){font-size:.875em;line-height:1.7142857;margin-bottom:2em;margin-top:2em;table-layout:auto;width:100%}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-color:var(--tw-prose-th-borders);border-bottom-width:1px}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em;vertical-align:bottom}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-color:var(--tw-prose-td-borders);border-bottom-width:1px}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-color:var(--tw-prose-th-borders);border-top-width:1px}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0;margin-top:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgba(0,0,0,.5);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0;margin-top:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.5em;margin-top:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.75em;margin-top:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.75em;margin-top:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em;margin-top:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-top:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{clip:rect(0,0,0,0);border-width:0;height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;white-space:nowrap;width:1px}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-bottom:0;margin-top:0}.my-1{margin-bottom:.25rem;margin-top:.25rem}.my-2{margin-bottom:.5rem;margin-top:.5rem}.my-3{margin-bottom:.75rem;margin-top:.75rem}.my-4{margin-bottom:1rem;margin-top:1rem}.my-8{margin-bottom:2rem;margin-top:2rem}.my-auto{margin-bottom:auto;margin-top:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0{height:0}.h-1{height:.25rem}.h-16{height:4rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px}.border-b,.border-y{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235/var(--tw-border-opacity))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219/var(--tw-border-opacity))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248/var(--tw-border-opacity))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235/var(--tw-border-opacity))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21/var(--tw-border-opacity))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0/var(--tw-bg-opacity))}.bg-black\/5{background-color:rgba(0,0,0,.05)}.bg-black\/50{background-color:rgba(0,0,0,.5)}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235/var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249/var(--tw-bg-opacity))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-bottom:0;padding-top:0}.py-1{padding-bottom:.25rem;padding-top:.25rem}.py-12{padding-bottom:3rem;padding-top:3rem}.py-16{padding-bottom:4rem;padding-top:4rem}.py-2{padding-bottom:.5rem;padding-top:.5rem}.py-24{padding-bottom:6rem;padding-top:6rem}.py-3{padding-bottom:.75rem;padding-top:.75rem}.py-32{padding-bottom:8rem;padding-top:8rem}.py-4{padding-bottom:1rem;padding-top:1rem}.py-8{padding-bottom:2rem;padding-top:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0/var(--tw-text-opacity))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235/var(--tw-text-opacity))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229/var(--tw-text-opacity))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgba(0,0,0,.1),0 4px 6px -4px rgba(0,0,0,.1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgba(0,0,0,.1),0 2px 4px -2px rgba(0,0,0,.1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgba(0,0,0,.15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-duration:.15s;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1)}.transition-colors{transition-duration:.15s;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1)}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}[x-cloak]{display:none!important}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:rgba(0,0,0,.1)}.hover\:bg-black\/5:hover{background-color:rgba(0,0,0,.05)}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39/var(--tw-text-opacity))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{clip:auto;height:auto;margin:0;overflow:visible;padding:0;position:static;white-space:normal;width:auto}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem;margin-top:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51/var(--tw-border-opacity))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81/var(--tw-border-opacity))}.dark\:bg-black\/10:is(.dark *){background-color:rgba(0,0,0,.1)}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81/var(--tw-bg-opacity))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55/var(--tw-bg-opacity))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39/var(--tw-bg-opacity))}.dark\:bg-white:is(.dark *){--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248/var(--tw-text-opacity))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:rgba(0,0,0,.1)}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgba(0,0,0,.1),0 8px 10px -6px rgba(0,0,0,.1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-bottom:0;margin-top:0}.md\:my-6{margin-bottom:1.5rem;margin-top:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.md\:bg-left{background-position:0}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-bottom:0;padding-top:0}.md\:py-16{padding-bottom:4rem;padding-top:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width:1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}  *,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0{height:0px}.h-1{height:.25rem}.h-16{height:4rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}[x-cloak]{display:none!important}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity))}.dark\:bg-white:is(.dark *){--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hyde/tests/DefaultContentTest.php b/packages/hyde/tests/DefaultContentTest.php
index 77c8d349d18..abd85b152a1 100644
--- a/packages/hyde/tests/DefaultContentTest.php
+++ b/packages/hyde/tests/DefaultContentTest.php
@@ -33,10 +33,10 @@ public function testDefaultCompiledStylesheetIsPresent()
     {
         $this->assertFileExists(Hyde::path('_media/app.css'));
 
-        $this->assertStringContainsString(
-            'https://tailwindcss.com',
-            file_get_contents(Hyde::path('_media/app.css'))
-        );
+        $contents = file_get_contents(Hyde::path('_media/app.css'));
+
+        $this->assertStringContainsString('--tw-', $contents);
+        $this->assertStringContainsString('--tw-prose-', $contents);
     }
 
     public function testLaravelMixResourcesArePresent()

From 2f9aee6068742352043d61d3c8d7677e89705afc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 10:17:07 +0100
Subject: [PATCH 3211/4023] [2.x] Replace Laravel Mix with Vite (#2010)

* Replace Laravel Mix dependencies with Vite

* Create vite.config.js

* Create postcss.config.js

* Delete webpack.mix.js

* Update vite.config.js

* Update documentation for Vite

* Update quickstart for Vite

* Merge PostCSS config into Vite config

* Update module import syntax for Vite

* Remove Vite preview command

* Use implicit module names

* Copy files after bundling assets

* Update test for Vite

* Replace Mix build command with Vite build

* Document build command instead of run dev

* Update package documentation to reference Vite

* Rebuild assets with Vite

From 63ffeb8e62c1cf4b58ea5f464cc4d5e8b0f153b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 10:19:55 +0100
Subject: [PATCH 3212/4023] Temporarily enable end to end testing for all
 branches

---
 .github/workflows/end-to-end-tests.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/end-to-end-tests.yml b/.github/workflows/end-to-end-tests.yml
index 2ec8a249556..963a1cb8a92 100644
--- a/.github/workflows/end-to-end-tests.yml
+++ b/.github/workflows/end-to-end-tests.yml
@@ -2,9 +2,7 @@ name: End-to-End Testing
 
 on:
   push:
-    branches: [ "master" ]
   pull_request:
-    branches: [ "master" ]
   workflow_dispatch:
 
 jobs:

From 7aa57a05244ecbdd50b2797fa05534d6c1179321 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 13:28:13 +0100
Subject: [PATCH 3213/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d922146fc24..b3763f7858f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -26,6 +26,7 @@ This serves two purposes:
 - Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
 - Added environment variable support for saving previews in https://github.com/hydephp/develop/pull/1996
 - Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
+- Added Vite as a build tool in https://github.com/hydephp/develop/pull/2010
 - **Added a new consolidated Asset API to better handle media files.**
     - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
     - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
@@ -86,6 +87,9 @@ This serves two purposes:
     - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
     - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
     - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
+- **Replaced Laravel Mix with Vite for frontend asset compilation** in https://github.com/hydephp/develop/pull/2010
+    - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
+
 
 ### Deprecated
 
@@ -107,6 +111,7 @@ This serves two purposes:
     - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
     - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
     - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
+- Removed Laravel Mix as a dependency in https://github.com/hydephp/develop/pull/2010 (replaced with Vite)
 
 ### Fixed
 

From a1b0783f73839c27940d892c6e282ea1fc634b16 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 13:37:34 +0100
Subject: [PATCH 3214/4023] Document breaking Node script change

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index b3763f7858f..74945acbaec 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -32,6 +32,7 @@ This serves two purposes:
     - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
     - Added method `Asset::exists()` has to check if a media file exists.
     - Added a `Hyde::assets()` method to get all media file instances in the site.
+- Added new `npm run build` command for compiling frontend assets with Vite
 
 ### Changed
 
@@ -112,6 +113,7 @@ This serves two purposes:
     - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
     - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
 - Removed Laravel Mix as a dependency in https://github.com/hydephp/develop/pull/2010 (replaced with Vite)
+- **Breaking:** Removed `npm run prod` command (replaced with `npm run build`)
 
 ### Fixed
 

From 0e81adbe86e27f6c9cd641c1c1f6fce0dd8a5152 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 13:55:27 +0100
Subject: [PATCH 3215/4023] No longer copy files to site output from NPM build
 command

---
 RELEASE_NOTES.md                          |  1 +
 docs/creating-content/managing-assets.md  |  5 ++-
 monorepo/scripts/tests/project-styles.php |  3 --
 vite.config.js                            | 42 ++---------------------
 4 files changed, 5 insertions(+), 46 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 74945acbaec..2ce391e580a 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -90,6 +90,7 @@ This serves two purposes:
     - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
 - **Replaced Laravel Mix with Vite for frontend asset compilation** in https://github.com/hydephp/develop/pull/2010
     - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
+    - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011
 
 
 ### Deprecated
diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index 332c9b7c2dd..e26479b09f2 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -62,10 +62,9 @@ Then run `npm run dev` to compile the assets in development mode. For production
 
 Hyde uses [Vite](https://vite.dev/) to compile assets.
 
-When running the `npm run dev/prod` command, the following happens:
+When running the `npm run dev/prod` command, Vite will compile the `resources/assets/app.css` file into `_media/app.css` using PostCSS with TailwindCSS and AutoPrefixer.
 
-1. Vite will compile the `resources/assets/app.css` file into `_media/app.css` using PostCSS with TailwindCSS and AutoPrefixer.
-2. Vite then copies the `_media` folder into `_site/media`, this is so that they are automatically accessible to your site without having to rerun `php hyde build`.
+The compiled assets will then be automatically copied to `_site/media` when you run `php hyde build`.
 
 ## Telling Hyde where to find assets
 
diff --git a/monorepo/scripts/tests/project-styles.php b/monorepo/scripts/tests/project-styles.php
index 4ca8741482c..3054ff1fd6f 100644
--- a/monorepo/scripts/tests/project-styles.php
+++ b/monorepo/scripts/tests/project-styles.php
@@ -20,8 +20,5 @@
     $output = shell_exec('cd '.BASE_PATH.' && npm run build');
 
     $this->assert(file_exists(BASE_PATH.'/_media/app.css'), 'CSS file does not exist');
-    $this->assert(file_exists(BASE_PATH.'/_site/media/app.css'), 'CSS file does not exist');
-
     $this->assert(file_exists(BASE_PATH.'/_media/app.js'), 'JS file does not exist');
-    $this->assert(file_exists(BASE_PATH.'/_site/media/app.js'), 'JS file does not exist');
 });
diff --git a/vite.config.js b/vite.config.js
index d786c16d3d7..6d088d3819a 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -17,7 +17,7 @@ export default defineConfig({
         }
     },
     build: {
-        outDir: '_site/media',
+        outDir: '_media',
         emptyOutDir: true,
         rollupOptions: {
             input: [
@@ -30,43 +30,5 @@ export default defineConfig({
                 assetFileNames: '[name].[ext]'
             }
         }
-    },
-    plugins: [
-        {
-            name: 'copy-media',
-            writeBundle() {
-                // Copy files from _site/media to _media
-                const fs = require('fs');
-                const path = require('path');
-
-                const sourceDir = '_site/media';
-                const targetDir = '_media';
-
-                if (!fs.existsSync(targetDir)) {
-                    fs.mkdirSync(targetDir, { recursive: true });
-                }
-
-                // Copy all files recursively
-                function copyRecursively(source, target) {
-                    const files = fs.readdirSync(source);
-
-                    files.forEach(file => {
-                        const sourcePath = path.join(source, file);
-                        const targetPath = path.join(target, file);
-
-                        if (fs.lstatSync(sourcePath).isDirectory()) {
-                            if (!fs.existsSync(targetPath)) {
-                                fs.mkdirSync(targetPath, { recursive: true });
-                            }
-                            copyRecursively(sourcePath, targetPath);
-                        } else {
-                            fs.copyFileSync(sourcePath, targetPath);
-                        }
-                    });
-                }
-
-                copyRecursively(sourceDir, targetDir);
-            }
-        }
-    ]
+    }
 });
\ No newline at end of file

From e17212b50d20dc709a38f4318ad259f2a80aecc1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 14:10:21 +0100
Subject: [PATCH 3216/4023] Add fix for renamed method

---
 packages/realtime-compiler/resources/dashboard.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/realtime-compiler/resources/dashboard.blade.php b/packages/realtime-compiler/resources/dashboard.blade.php
index 3e9b16b4582..d7bcf0fb77a 100644
--- a/packages/realtime-compiler/resources/dashboard.blade.php
+++ b/packages/realtime-compiler/resources/dashboard.blade.php
@@ -321,7 +321,7 @@
                                                             <strong title="{{ $mediaFile->getPath() }}">{{ $mediaFile->getName() }}</strong>
                                                         </p>
                                                         <div class="col px-0 text-nowrap">
-                                                            <small class="text-muted">({{ $dashboard::bytesToHuman($mediaFile->getContentLength()) }})</small>
+                                                            <small class="text-muted">({{ $dashboard::bytesToHuman($mediaFile->getLength()) }})</small>
                                                         </div>
                                                     </div>
                                                     <div class="row small align-items-center">

From 2176280daf3f849078e2d9bc713b92756693a50e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 18:09:44 +0100
Subject: [PATCH 3217/4023] Update realtime compiler to only serve source media
 files

---
 RELEASE_NOTES.md                              |  8 ++++++-
 .../src/Actions/AssetFileLocator.php          | 17 ++------------
 .../tests/RealtimeCompilerTest.php            | 23 +++++++++++++++++--
 3 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2ce391e580a..c249bb0dfe4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -91,7 +91,7 @@ This serves two purposes:
 - **Replaced Laravel Mix with Vite for frontend asset compilation** in https://github.com/hydephp/develop/pull/2010
     - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
     - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011
-
+- The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in https://github.com/hydephp/develop/pull/2012
 
 ### Deprecated
 
@@ -124,6 +124,12 @@ This serves two purposes:
 
 - in case of vulnerabilities.
 
+### Package updates
+
+#### Realtime Compiler
+
+- Simplified the asset file locator to only serve files from the media source directory in https://github.com/hydephp/develop/pull/2012
+
 ### Upgrade Guide
 
 Please see the "Breaking changes & upgrade guide" section below for more information.
diff --git a/packages/realtime-compiler/src/Actions/AssetFileLocator.php b/packages/realtime-compiler/src/Actions/AssetFileLocator.php
index d7ad8c57165..5805306c26d 100644
--- a/packages/realtime-compiler/src/Actions/AssetFileLocator.php
+++ b/packages/realtime-compiler/src/Actions/AssetFileLocator.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\RealtimeCompiler\Actions;
 
-use Illuminate\Support\Str;
-
 /**
  * Locate a static file to proxy.
  */
@@ -15,19 +13,8 @@ public static function find(string $path): ?string
     {
         $path = trim($path, '/');
 
-        $strategies = [
-            BASE_PATH.'/_site/'.$path,
-            BASE_PATH.'/_media/'.$path,
-            BASE_PATH.'/_site/'.Str::after($path, 'media/'),
-            BASE_PATH.'/_media/'.Str::after($path, 'media/'),
-        ];
-
-        foreach ($strategies as $strategy) {
-            if (file_exists($strategy)) {
-                return $strategy;
-            }
-        }
+        $file = BASE_PATH.'/_media/'.str_replace('media/', '', $path);
 
-        return null;
+        return file_exists($file) ? $file : null;
     }
 }
diff --git a/packages/realtime-compiler/tests/RealtimeCompilerTest.php b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
index 45e78abd550..c40358ce39f 100644
--- a/packages/realtime-compiler/tests/RealtimeCompilerTest.php
+++ b/packages/realtime-compiler/tests/RealtimeCompilerTest.php
@@ -85,7 +85,8 @@ public function testHandlesRoutesPagesWithHtmlExtension()
 
     public function testHandlesRoutesStaticAssets()
     {
-        $this->mockRoute('media/app.css');
+        $this->mockRoute('media/test.css');
+        Filesystem::put('_media/test.css', 'test');
 
         $kernel = new HttpKernel();
         $response = $kernel->handle(new Request());
@@ -93,7 +94,25 @@ public function testHandlesRoutesStaticAssets()
         $this->assertInstanceOf(Response::class, $response);
         $this->assertEquals(200, $response->statusCode);
         $this->assertEquals('OK', $response->statusMessage);
-        $this->assertEquals(file_get_contents(\Hyde\Hyde::path('_media/app.css')), $response->body);
+        $this->assertEquals('test', $response->body);
+
+        Filesystem::unlink('_media/test.css');
+    }
+
+    public function testNormalizesMediaPath()
+    {
+        $this->mockRoute('media/test.css');
+        Filesystem::put('_media/test.css', 'test');
+
+        $kernel = new HttpKernel();
+        $response = $kernel->handle(new Request());
+
+        $this->assertInstanceOf(Response::class, $response);
+        $this->assertEquals(200, $response->statusCode);
+        $this->assertEquals('OK', $response->statusMessage);
+        $this->assertEquals('test', $response->body);
+
+        Filesystem::unlink('_media/test.css');
     }
 
     public function testThrowsRouteNotFoundExceptionForMissingRoute()

From 7e998a2ccf8e66acf1091c61c797f8d7d9bff705 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 18:42:24 +0100
Subject: [PATCH 3218/4023] Replace `--run-dev` and `--run-prod`  build flags
 with `--run-vite`

---
 RELEASE_NOTES.md                                         | 1 +
 docs/getting-started/console-commands.md                 | 5 ++---
 .../framework/src/Console/Commands/BuildSiteCommand.php  | 9 ++-------
 .../framework/tests/Feature/StaticSiteServiceTest.php    | 4 +---
 4 files changed, 6 insertions(+), 13 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c249bb0dfe4..b9d4991a996 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -92,6 +92,7 @@ This serves two purposes:
     - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
     - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011
 - The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in https://github.com/hydephp/develop/pull/2012
+- **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
 
 ### Deprecated
 
diff --git a/docs/getting-started/console-commands.md b/docs/getting-started/console-commands.md
index c6e4471c4eb..2be9c7de878 100644
--- a/docs/getting-started/console-commands.md
+++ b/docs/getting-started/console-commands.md
@@ -66,7 +66,7 @@ Here is a quick reference of all the available commands. You can also run `php h
 <a name="build" style="display: inline-block; position: absolute; margin-top: -5rem;"></a>
 
 ```bash
-php hyde build [--run-dev] [--run-prod] [--run-prettier] [--pretty-urls] [--no-api]
+php hyde build [--run-vite] [--run-prettier] [--pretty-urls] [--no-api]
 ```
 
 Build the static site
@@ -75,8 +75,7 @@ Build the static site
 
 |                  |                                            |
 |------------------|--------------------------------------------|
-| `--run-dev`      | Run the NPM dev script after build         |
-| `--run-prod`     | Run the NPM prod script after build        |
+| `--run-vite`     | Build frontend assets using Vite           |
 | `--run-prettier` | Format the output using NPM Prettier       |
 | `--pretty-urls`  | Should links in output use pretty URLs?    |
 | `--no-api`       | Disable API calls, for example, Torchlight |
diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index b5aa1950af2..b966f6f36f3 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -26,8 +26,7 @@ class BuildSiteCommand extends Command
 {
     /** @var string */
     protected $signature = 'build
-        {--run-dev : Run the NPM dev script after build}
-        {--run-prod : Run the NPM prod script after build}
+        {--run-vite : Build frontend assets using Vite}
         {--run-prettier : Format the output using NPM Prettier}
         {--pretty-urls : Should links in output use pretty URLs?}
         {--no-api : Disable API calls, for example, Torchlight}';
@@ -100,11 +99,7 @@ public function runPostBuildActions(): void
             );
         }
 
-        if ($this->option('run-dev')) {
-            $this->runNodeCommand('npm run dev', 'Building frontend assets for development!');
-        }
-
-        if ($this->option('run-prod')) {
+        if ($this->option('run-vite')) {
             $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
         }
     }
diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 25931842235..c63a8a66b66 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -160,14 +160,12 @@ public function testNodeActionOutputs()
     {
         Process::fake();
 
-        $this->artisan('build --run-prettier --run-dev --run-prod')
+        $this->artisan('build --run-prettier --run-vite')
             ->expectsOutput('Prettifying code! This may take a second.')
-            ->expectsOutput('Building frontend assets for development! This may take a second.')
             ->expectsOutput('Building frontend assets for production! This may take a second.')
             ->assertExitCode(0);
 
         Process::assertRan(fn ($process) => $process->command === 'npx prettier '.Hyde::pathToRelative(Hyde::sitePath()).'/**/*.html --write --bracket-same-line');
-        Process::assertRan(fn ($process) => $process->command === 'npm run dev');
         Process::assertRan(fn ($process) => $process->command === 'npm run build');
     }
 

From 9625d125d23fcf14bcedd8c93c19e36c1f0d18ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 18:58:51 +0100
Subject: [PATCH 3219/4023] Retransfer assets after Vite build

---
 .../framework/src/Console/Commands/BuildSiteCommand.php   | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index b966f6f36f3..f32982aa624 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -6,6 +6,7 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Illuminate\Support\Arr;
 use Hyde\Support\BuildWarnings;
 use Hyde\Console\Concerns\Command;
 use Hyde\Framework\Services\BuildService;
@@ -101,6 +102,13 @@ public function runPostBuildActions(): void
 
         if ($this->option('run-vite')) {
             $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
+
+            /** @var \Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets $task */
+            $task = Arr::first($this->taskService->getRegisteredTasks(), function (string $task): bool {
+                return class_basename($task) === 'TransferMediaAssets';
+            });
+
+            (new $task)->run($this->output); // Transfer media assets to the public directory
         }
     }
 

From 57e96f0892efc505f7ad6121531eeb42223b7c03 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 18:58:55 +0100
Subject: [PATCH 3220/4023] Revert "Retransfer assets after Vite build"

This reverts commit 9625d125d23fcf14bcedd8c93c19e36c1f0d18ce.
---
 .../framework/src/Console/Commands/BuildSiteCommand.php   | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index f32982aa624..b966f6f36f3 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -6,7 +6,6 @@
 
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Illuminate\Support\Arr;
 use Hyde\Support\BuildWarnings;
 use Hyde\Console\Concerns\Command;
 use Hyde\Framework\Services\BuildService;
@@ -102,13 +101,6 @@ public function runPostBuildActions(): void
 
         if ($this->option('run-vite')) {
             $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
-
-            /** @var \Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets $task */
-            $task = Arr::first($this->taskService->getRegisteredTasks(), function (string $task): bool {
-                return class_basename($task) === 'TransferMediaAssets';
-            });
-
-            (new $task)->run($this->output); // Transfer media assets to the public directory
         }
     }
 

From 9f3c99fb027769a415703a79a183bfb2c88d625c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 19:03:38 +0100
Subject: [PATCH 3221/4023] Moved the Vite build step to run before the
 pre-build tasks

---
 RELEASE_NOTES.md                                          | 1 +
 .../framework/src/Console/Commands/BuildSiteCommand.php   | 8 ++++----
 .../framework/tests/Feature/StaticSiteServiceTest.php     | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index b9d4991a996..7d14e72431f 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -93,6 +93,7 @@ This serves two purposes:
     - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011
 - The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in https://github.com/hydephp/develop/pull/2012
 - **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
+- Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 
 ### Deprecated
 
diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index b966f6f36f3..917cee2772a 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -84,6 +84,10 @@ protected function runPreBuildActions(): void
             Config::set(['hyde.pretty_urls' => true]);
         }
 
+        if ($this->option('run-vite')) {
+            $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
+        }
+
         $this->taskService->runPreBuildTasks();
     }
 
@@ -98,10 +102,6 @@ public function runPostBuildActions(): void
                 'prettify code'
             );
         }
-
-        if ($this->option('run-vite')) {
-            $this->runNodeCommand('npm run build', 'Building frontend assets for production!');
-        }
     }
 
     protected function printFinishMessage(float $timeStart): void
diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index c63a8a66b66..64376c3aa23 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -161,12 +161,12 @@ public function testNodeActionOutputs()
         Process::fake();
 
         $this->artisan('build --run-prettier --run-vite')
-            ->expectsOutput('Prettifying code! This may take a second.')
             ->expectsOutput('Building frontend assets for production! This may take a second.')
+            ->expectsOutput('Prettifying code! This may take a second.')
             ->assertExitCode(0);
 
-        Process::assertRan(fn ($process) => $process->command === 'npx prettier '.Hyde::pathToRelative(Hyde::sitePath()).'/**/*.html --write --bracket-same-line');
         Process::assertRan(fn ($process) => $process->command === 'npm run build');
+        Process::assertRan(fn ($process) => $process->command === 'npx prettier '.Hyde::pathToRelative(Hyde::sitePath()).'/**/*.html --write --bracket-same-line');
     }
 
     public function testPrettyUrlsOptionOutput()

From 25bbab88d63fd59c1a2730342e03e30023177865 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 11 Nov 2024 19:21:56 +0100
Subject: [PATCH 3222/4023] Add a temporary helper to give a helpful error
 message

---
 .../src/Console/Commands/BuildSiteCommand.php | 27 ++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
index 917cee2772a..3bc8f3d367c 100644
--- a/packages/framework/src/Console/Commands/BuildSiteCommand.php
+++ b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -29,7 +29,9 @@ class BuildSiteCommand extends Command
         {--run-vite : Build frontend assets using Vite}
         {--run-prettier : Format the output using NPM Prettier}
         {--pretty-urls : Should links in output use pretty URLs?}
-        {--no-api : Disable API calls, for example, Torchlight}';
+        {--no-api : Disable API calls, for example, Torchlight}
+        {--run-dev : [Removed] Use --run-vite instead}
+        {--run-prod : [Removed] Use --run-vite instead}';
 
     /** @var string */
     protected $description = 'Build the static site';
@@ -39,6 +41,12 @@ class BuildSiteCommand extends Command
 
     public function handle(): int
     {
+        // CodeCoverageIgnoreStart
+        if ($this->option('run-dev') || $this->option('run-prod')) {
+            return $this->deprecatedRunMixCommandFailure();
+        }
+        // CodeCoverageIgnoreEnd
+
         $timeStart = microtime(true);
 
         $this->title('Building your static site!');
@@ -153,4 +161,21 @@ protected function getExitCode(): int
 
         return Command::SUCCESS;
     }
+
+    /**
+     * This method is called when the removed --run-dev or --run-prod options are used.
+     *
+     * @deprecated Use --run-vite instead
+     * @since v2.0 - This will be removed after 2-3 minor releases depending on the timeframe between them. (~v2.3)
+     *
+     * @codeCoverageIgnore
+     */
+    protected function deprecatedRunMixCommandFailure(): int
+    {
+        $this->error('The --run-dev and --run-prod options have been removed in HydePHP v2.0.');
+        $this->info('Please use --run-vite instead to build assets for production with Vite.');
+        $this->line('See https://github.com/hydephp/develop/pull/2013 for more information.');
+
+        return Command::FAILURE;
+    }
 }

From 2f9ad795f3e2ed648345badd96fb2dbcf58a5121 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:39:00 +0100
Subject: [PATCH 3223/4023] Create Vite.php

---
 packages/framework/src/Facades/Vite.php | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 packages/framework/src/Facades/Vite.php

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
new file mode 100644
index 00000000000..d387e0e58a0
--- /dev/null
+++ b/packages/framework/src/Facades/Vite.php
@@ -0,0 +1,11 @@
+<?php
+
+namespace Hyde\Facades;
+
+/**
+ * Vite facade for handling Vite-related operations.
+ */
+class Vite
+{
+    //
+}

From e3dc0a2ad9de7ab2ccd261e9d705b2b558a53a9c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:39:01 +0100
Subject: [PATCH 3224/4023] Create ViteFacadeTest.php

---
 .../framework/tests/Unit/Facades/ViteFacadeTest.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Facades/ViteFacadeTest.php

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
new file mode 100644
index 00000000000..5ad403733b8
--- /dev/null
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Hyde\Framework\Testing\Unit\Facades;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Facades\Vite
+ */
+class ViteFacadeTest extends UnitTestCase
+{
+    //
+}

From 8aba46bfe8ae67a8f2a80bd87d7a2a746f1e39af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:47:53 +0100
Subject: [PATCH 3225/4023] Create Vite server configuration

---
 vite.config.js | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/vite.config.js b/vite.config.js
index 6d088d3819a..ff20640ebe1 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -8,6 +8,13 @@ import tailwindcss from 'tailwindcss';
 import autoprefixer from 'autoprefixer';
 
 export default defineConfig({
+    server: {
+        port: 3000,
+        hmr: {
+            host: 'localhost',
+            port: 3000,
+        },
+    },
     css: {
         postcss: {
             plugins: [

From 220fceba36cdd8818343bd5ffdee55a69eb2f33b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:48:23 +0100
Subject: [PATCH 3226/4023] Draft Vite option for the serve command

---
 docs/getting-started/console-commands.md      |  2 +-
 .../src/Console/Commands/ServeCommand.php     | 39 ++++++++++++++++++-
 2 files changed, 38 insertions(+), 3 deletions(-)

diff --git a/docs/getting-started/console-commands.md b/docs/getting-started/console-commands.md
index 2be9c7de878..f92f196e73b 100644
--- a/docs/getting-started/console-commands.md
+++ b/docs/getting-started/console-commands.md
@@ -101,7 +101,7 @@ Run the static site builder for a single file
 <a name="serve" style="display: inline-block; position: absolute; margin-top: -5rem;"></a>
 
 ```bash
-php hyde serve [--host [HOST]] [--port [PORT]]
+php hyde serve [--host [HOST]] [--port [PORT]] [--vite]
 ```
 
 Start the realtime compiler server.
diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 86008ee805e..2c73e17cd0c 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -35,6 +35,7 @@ class ServeCommand extends Command
         {--pretty-urls= : Enable pretty URLs. (Overrides config setting)}
         {--play-cdn= : Enable the Tailwind Play CDN. (Overrides config setting)}
         {--open=false : Open the site preview in the browser.}
+        {--vite : Enable Vite for Hot Module Replacement (HMR)}
     ';
 
     /** @var string */
@@ -51,15 +52,45 @@ public function safeHandle(): int
             $this->openInBrowser((string) $this->option('open'));
         }
 
-        $this->runServerProcess(sprintf('php -S %s:%d %s',
+        $command = sprintf('php -S %s:%d %s',
             $this->getHostSelection(),
             $this->getPortSelection(),
             $this->getExecutablePath()
-        ));
+        );
+
+        if ($this->option('vite')) {
+            $this->runViteProcess();
+        }
+
+        $this->runServerProcess($command);
 
         return Command::SUCCESS;
     }
 
+    protected function runViteProcess(): void
+    {
+        $viteCommand = 'npm run dev';
+
+        Process::forever()->env($this->getViteEnvironmentVariables())->run($viteCommand, $this->getViteOutputHandler());
+
+        $this->info('Vite development server started for HMR.');
+    }
+
+    protected function getViteEnvironmentVariables(): array
+    {
+        return Arr::whereNotNull([
+            'NODE_ENV' => 'development',
+            'PORT' => 3000,
+        ]);
+    }
+
+    protected function getViteOutputHandler(): Closure
+    {
+        return function (string $type, string $line): void {
+            $this->output->write($line);
+        };
+    }
+
     protected function getHostSelection(): string
     {
         return (string) $this->option('host') ?: Config::getString('hyde.server.host', 'localhost');
@@ -103,6 +134,10 @@ protected function printStartMessage(): void
         $this->useBasicOutput()
             ? $this->output->writeln('<info>Starting the HydeRC server...</info> Press Ctrl+C to stop')
             : $this->console->printStartMessage($this->getHostSelection(), $this->getPortSelection(), $this->getEnvironmentVariables());
+
+        if ($this->option('vite')) {
+            $this->console->printViteMessage();
+        }
     }
 
     protected function getOutputHandler(): Closure

From d67c699cf995dfb5aa3682707e106d3312c9e487 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:48:59 +0100
Subject: [PATCH 3227/4023] Improve realtime compiler documentation

---
 docs/extensions/realtime-compiler.md | 36 ++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/extensions/realtime-compiler.md b/docs/extensions/realtime-compiler.md
index 534588803f7..82ff375f736 100644
--- a/docs/extensions/realtime-compiler.md
+++ b/docs/extensions/realtime-compiler.md
@@ -21,6 +21,21 @@ This will start a local development server at `http://localhost:8080`
 
 >warning Please note that the server is designed for local development, and should not be used on a public network.
 
+### Options
+
+- `--host=`: <comment>[default: "localhost"]</comment>
+- `--port=`: <comment>[default: 8080]</comment>
+- `--save-preview=`: Should the served page be saved to disk? (Overrides config setting)
+- `--dashboard=`: Enable the realtime compiler dashboard. (Overrides config setting)
+- `--pretty-urls=`: Enable pretty URLs. (Overrides config setting)
+- `--play-cdn=`: Enable the Tailwind Play CDN. (Overrides config setting)
+- `--open=false`: Open the site preview in the browser.
+- `--vite`: Enable Vite for Hot Module Replacement (HMR).
+
+### Vite Integration
+
+By adding the `--vite` option, the serve command will initiate Vite's development server alongside the Hyde Realtime Compiler. This setup enables Hot Module Replacement (HMR), allowing for instant updates to your site as you make changes to your assets.
+
 ### Configuration
 
 The server can be configured in the `config/hyde.php` file to change the port, host, and to customize its features.
@@ -29,9 +44,30 @@ The server can be configured in the `config/hyde.php` file to change the port, h
 // filepath config/hyde.php
 
 'server' => [
+    // The default port the preview is served on
     'port' => env('SERVER_PORT', 8080),
+
+    // The default host the preview is served on
     'host' => env('SERVER_HOST', 'localhost'),
+
+    // Should preview pages be saved to the output directory?
     'save_preview' => env('SERVER_SAVE_PREVIEW', false),
+
+    // Should the live edit feature be enabled?
+    'live_edit' => env('SERVER_LIVE_EDIT', true),
+
+    // Configure the realtime compiler dashboard
+    'dashboard' => [
+        // Should the realtime compiler dashboard be enabled?
+        'enabled' => env('SERVER_DASHBOARD', true),
+
+        // Can the dashboard make edits to the project file system?
+        'interactive' => true,
+
+        // Should the dashboard show tips?
+        'tips' => true,
+    ],
+
 ],
 ```
 

From 851421d0ebb96171351a7e1caeb5d67049aad3d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:51:05 +0100
Subject: [PATCH 3228/4023] Method to print the Vite message

---
 packages/realtime-compiler/src/ConsoleOutput.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index a96cd0329be..0d3992c27b7 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -54,6 +54,16 @@ public function printStartMessage(string $host, int $port, array $environment =
         render("<div class=\"text-green-500\">$body</div>");
     }
 
+    public function printViteMessage(): void
+    {
+        $this->output->writeln([
+            '',
+            ' <info>Starting Vite development server...</info>',
+            ' <comment>HMR will be available on port 3000</comment>',
+            '',
+        ]);
+    }
+
     public function getFormatter(): Closure
     {
         return function (string $type, string $line): void {

From d2afceaff64419102ce2a9cc6266fde9e74de675 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:54:53 +0100
Subject: [PATCH 3229/4023] Run processes in parallel

---
 .../src/Console/Commands/ServeCommand.php          | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 2c73e17cd0c..fb59eb1b1df 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -71,7 +71,10 @@ protected function runViteProcess(): void
     {
         $viteCommand = 'npm run dev';
 
-        Process::forever()->env($this->getViteEnvironmentVariables())->run($viteCommand, $this->getViteOutputHandler());
+        Process::forever()
+            ->start($viteCommand, function (string $type, string $line): void {
+                $this->output->write($line);
+            });
 
         $this->info('Vite development server started for HMR.');
     }
@@ -108,7 +111,14 @@ protected function getExecutablePath(): string
 
     protected function runServerProcess(string $command): void
     {
-        Process::forever()->env($this->getEnvironmentVariables())->run($command, $this->getOutputHandler());
+        Process::forever()
+            ->env($this->getEnvironmentVariables())
+            ->start($command, $this->getOutputHandler());
+
+        // Keep the main process running
+        while (true) {
+            usleep(1000000); // Sleep for 1 second
+        }
     }
 
     protected function getEnvironmentVariables(): array

From 6ad2b0446d8d56b0219c90bbe100c37138f0a0bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 09:58:55 +0100
Subject: [PATCH 3230/4023] Stream both process outputs

---
 .../src/Console/Commands/ServeCommand.php        | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index fb59eb1b1df..b4a286a7ea9 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -72,9 +72,8 @@ protected function runViteProcess(): void
         $viteCommand = 'npm run dev';
 
         Process::forever()
-            ->start($viteCommand, function (string $type, string $line): void {
-                $this->output->write($line);
-            });
+            ->env($this->getViteEnvironmentVariables())
+            ->start($viteCommand, $this->getViteOutputHandler());
 
         $this->info('Vite development server started for HMR.');
     }
@@ -111,10 +110,19 @@ protected function getExecutablePath(): string
 
     protected function runServerProcess(string $command): void
     {
-        Process::forever()
+        $process = Process::forever()
             ->env($this->getEnvironmentVariables())
             ->start($command, $this->getOutputHandler());
 
+        if (PHP_OS_FAMILY !== 'Windows') {
+            pcntl_async_signals(true);
+            pcntl_signal(SIGINT, function () use ($process) {
+                $this->info("\nShutting down servers...");
+                $process->stop();
+                exit;
+            });
+        }
+
         // Keep the main process running
         while (true) {
             usleep(1000000); // Sleep for 1 second

From b6361aba657492c0217d6240122783b987e794c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:10:37 +0100
Subject: [PATCH 3231/4023] Create vite-index-page.html

---
 .../resources/vite-index-page.html            | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 packages/realtime-compiler/resources/vite-index-page.html

diff --git a/packages/realtime-compiler/resources/vite-index-page.html b/packages/realtime-compiler/resources/vite-index-page.html
new file mode 100644
index 00000000000..5c2a24e33b1
--- /dev/null
+++ b/packages/realtime-compiler/resources/vite-index-page.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+
+        <title>HydePHP Vite</title>
+
+        <link href="https://fonts.googleapis.com/css2?family=Nunito:wght@400;600;700&display=swap" rel="stylesheet">
+
+        <script src="https://cdn.tailwindcss.com"></script>
+    </head>
+    <body class="antialiased">
+        <div class="relative flex min-h-screen flex-col justify-center overflow-hidden bg-gray-100 text-gray-600 dark:text-gray-400 dark:bg-gray-900 py-6 sm:py-12">
+            <div class="relative bg-white dark:bg-gray-800 px-6 pt-10 pb-8 shadow-xl ring-1 ring-gray-900/5 sm:mx-auto sm:max-w-xl sm:rounded-lg sm:px-10">
+                <div class="mx-auto">
+                    <div class="flex items-center justify-center">
+                        <a href="https://hydephp.com">
+                           <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:serif="http://www.serif.com/" class="h-24 w-auto" viewBox="0 0 4267 4267" version="1.1" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><rect id="masked" x="0" y="0" width="4266.67" height="4266.67" style="fill:none;"/><g id="base"/><g id="src"><path d="M3099.01,2876.31l142.659,-1865.88c-0,-10.687 -0.634,-20.82 -1.663,-29.529c0.238,-2.612 1.663,-5.937 1.663,-8.708c-0,-142.817 -496.296,-258.638 -1108.33,-258.638c-612.116,0 -1108.33,115.742 -1108.33,258.638c-0,2.771 1.346,5.383 1.742,8.075c-1.109,8.708 -1.742,18.208 -1.742,28.896l142.658,1867.15c-277.4,72.041 -459.325,173.454 -459.325,286.187c0,218.658 681.704,395.833 1425,395.833c743.296,0 1425,-177.175 1425,-395.833c0,-112.733 -181.925,-214.146 -459.325,-286.188Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/><path d="M2096.6,1230.44c-387.125,-0.001 -680.992,-70.934 -859.117,-130.309c-41.483,-13.854 -63.966,-58.662 -50.112,-100.146c13.854,-41.483 58.504,-63.966 100.146,-50.112c228.712,76.237 851.991,228.871 1695.83,-1.267c41.879,-11.242 85.658,13.3 97.137,55.575c11.559,42.196 -13.379,85.738 -55.575,97.217c-348.808,95.158 -660.804,129.041 -928.308,129.041Z" style="fill:#66757f;fill-opacity:0.1;fill-rule:nonzero;"/><path d="M3099.01,2876.31l35.309,-461.463c-609.98,170.763 -1392.15,174.721 -2004.18,-29.846l31.113,407.075c5.462,24.067 8.946,51.459 8.946,85.184c-0,138.541 102.045,223.883 219.37,268.85c352.925,135.216 1105.01,130.308 1488.89,11.795c116.137,-35.862 219.767,-137.195 219.767,-252.62c-0,-9.421 1.187,-19.08 1.9,-28.58l-1.109,-0.395Z" style="fill:url(#_Linear2);fill-rule:nonzero;"/><g id="gradient.svg"/></g><defs><linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(2850,0,0,2844.78,708.333,2135.95)"><stop offset="0" style="stop-color:#141e30;stop-opacity:1"/><stop offset="1" style="stop-color:#243b55;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(3008.33,-1187.5,510.846,1294.14,945.833,3320.83)"><stop offset="0" style="stop-color:#8a2387;stop-opacity:1"/><stop offset="0.5" style="stop-color:#e94057;stop-opacity:1"/><stop offset="1" style="stop-color:#f27121;stop-opacity:1"/></linearGradient></defs></svg>
+                        </a>
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6  text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" />
+                        </svg>
+                        <a href="https://vitejs.dev">
+                            <svg viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-16 ml-3 w-auto">
+                                <path d="M399.641 59.5246L215.643 388.545C211.844 395.338 202.084 395.378 198.228 388.618L10.5817 59.5563C6.38087 52.1896 12.6802 43.2665 21.0281 44.7586L205.223 77.6824C206.398 77.8924 207.601 77.8904 208.776 77.6763L389.119 44.8058C397.439 43.2894 403.768 52.1434 399.641 59.5246Z" fill="url(#paint0_linear)" />
+                                <path d="M292.965 1.5744L156.801 28.2552C154.563 28.6937 152.906 30.5903 152.771 32.8664L144.395 174.33C144.198 177.662 147.258 180.248 150.51 179.498L188.42 170.749C191.967 169.931 195.172 173.055 194.443 176.622L183.18 231.775C182.422 235.487 185.907 238.661 189.532 237.56L212.947 230.446C216.577 229.344 220.065 232.527 219.297 236.242L201.398 322.875C200.278 328.294 207.486 331.249 210.492 326.603L212.5 323.5L323.454 102.072C325.312 98.3645 322.108 94.137 318.036 94.9228L279.014 102.454C275.347 103.161 272.227 99.746 273.262 96.1583L298.731 7.86689C299.767 4.27314 296.636 0.855181 292.965 1.5744Z" fill="url(#paint1_linear)" />
+                                <defs>
+                                    <linearGradient id="paint0_linear" x1="6.00017" y1="32.9999" x2="235" y2="344" gradientUnits="userSpaceOnUse">
+                                        <stop stop-color="#41D1FF" />
+                                        <stop offset="1" stop-color="#BD34FE" />
+                                    </linearGradient>
+                                    <linearGradient id="paint1_linear" x1="194.651" y1="8.81818" x2="236.076" y2="292.989" gradientUnits="userSpaceOnUse">
+                                        <stop stop-color="#FFEA83" />
+                                        <stop offset="0.0833333" stop-color="#FFDD35" />
+                                        <stop offset="1" stop-color="#FFA800" />
+                                    </linearGradient>
+                                </defs>
+                            </svg>
+                        </a>
+                    </div>
+                    <div class="divide-y divide-gray-300 dark:divide-gray-700">
+                        <div class="py-8 text-base leading-7">
+                            <p>This is the Vite development server that provides Hot Module Replacement for your HydePHP site.</p>
+                            <p class="mt-6">Your HydePHP site is running on the Realtime Compiler server.</p>
+                            <h2 class="mt-6"><a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Realtime Compiler</a></h2>
+                            <p>The main development server for your HydePHP site.</p>
+                            <h2 class="mt-6"><a href="http://localhost:8080/dashboard" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Dashboard</a></h2>
+                            <p>Access the realtime compiler dashboard to monitor your site.</p>
+                        </div>
+                        <div class="pt-8 text-base leading-7">
+                            <p>
+                                Your HydePHP site is running at:<br />
+                                <a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">http://localhost:8080</a>
+                            </p>
+                            <p class="mt-6">Want to learn more about HydePHP?</p>
+                            <p>
+                                <a href="https://hydephp.com/docs" class="font-semibold text-indigo-500 hover:text-indigo-600">Read the docs &rarr;</a>
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </body>
+</html>
\ No newline at end of file

From c87203ac140c9a9254831eed4c16dc836b120006 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:10:50 +0100
Subject: [PATCH 3232/4023] Render Vite index page

---
 vite.config.js | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/vite.config.js b/vite.config.js
index ff20640ebe1..ee596703bba 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -6,6 +6,8 @@ import { defineConfig } from 'vite';
 import { resolve } from 'path';
 import tailwindcss from 'tailwindcss';
 import autoprefixer from 'autoprefixer';
+import fs from 'fs';
+import path from 'path';
 
 export default defineConfig({
     server: {
@@ -14,7 +16,25 @@ export default defineConfig({
             host: 'localhost',
             port: 3000,
         },
+        middlewareMode: false,
     },
+    plugins: [
+        {
+            name: 'hyde-vite-server',
+            configureServer(server) {
+                server.middlewares.use((req, res, next) => {
+                    if (req.url === '/') {
+                        res.end(fs.readFileSync(
+                            path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
+                            'utf-8'
+                        ));
+                    } else {
+                        next();
+                    }
+                });
+            },
+        },
+    ],
     css: {
         postcss: {
             plugins: [

From ed2404d29cfdd97fdaec9251c1e83ed8e7b3d0be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:26:24 +0100
Subject: [PATCH 3233/4023] Draft facade methods

---
 packages/framework/src/Facades/Vite.php | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index d387e0e58a0..dd2a461fbdd 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -7,5 +7,17 @@
  */
 class Vite
 {
-    //
+    public static function running(): bool
+    {
+        // TODO: Implement this
+
+        return true;
+    }
+
+    public static function assets(array $paths): string
+    {
+        // TODO: Implement this
+
+        return '';
+    }
 }

From f5d6c84becce6186e9484b6e79cef08e219dc9b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:30:53 +0100
Subject: [PATCH 3234/4023] Alias Vite facade

---
 app/config.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/config.php b/app/config.php
index aed2519bbce..26156665112 100644
--- a/app/config.php
+++ b/app/config.php
@@ -92,6 +92,7 @@
         'Hyde' => Hyde\Hyde::class,
         'Site' => \Hyde\Facades\Site::class,
         'Meta' => \Hyde\Facades\Meta::class,
+        'Vite' => \Hyde\Facades\Vite::class,
         'Asset' => \Hyde\Facades\Asset::class,
         'Author' => \Hyde\Facades\Author::class,
         'HydeFront' => \Hyde\Facades\HydeFront::class,

From e59cecf118641a10c21fb43a0414cdfa0a35aed8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:32:02 +0100
Subject: [PATCH 3235/4023] Add strict types declaration

---
 packages/framework/src/Facades/Vite.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index dd2a461fbdd..ccb2d2f40ba 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Hyde\Facades;
 
 /**

From 93bfbbc7d7be43d44687e1817887223e23918fb7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:41:57 +0100
Subject: [PATCH 3236/4023] Implement the Vite asset method

---
 packages/framework/src/Facades/Vite.php | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index ccb2d2f40ba..0de70e06355 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -4,6 +4,8 @@
 
 namespace Hyde\Facades;
 
+use Illuminate\Support\HtmlString;
+
 /**
  * Vite facade for handling Vite-related operations.
  */
@@ -16,10 +18,20 @@ public static function running(): bool
         return true;
     }
 
-    public static function assets(array $paths): string
+    public static function assets(array $paths): HtmlString
     {
-        // TODO: Implement this
+        $html = sprintf('<script src="http://localhost:3000/@vite/client" type="module"></script>');
+
+        foreach ($paths as $path) {
+            if (str_ends_with($path, '.css')) {
+                $html .= sprintf('<link rel="stylesheet" href="http://localhost:3000/%s">', $path);
+            }
+
+            if (str_ends_with($path, '.js')) {
+                $html .= sprintf('<script src="http://localhost:3000/%s" type="module"></script>', $path);
+            }
+        }
 
-        return '';
+        return new HtmlString($html);
     }
 }

From 2683f861872a2792c2736087df0f9005024f59e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:42:13 +0100
Subject: [PATCH 3237/4023] Serve Vite assets when running

---
 .../resources/views/layouts/styles.blade.php  | 25 +++++++++++--------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/packages/framework/resources/views/layouts/styles.blade.php b/packages/framework/resources/views/layouts/styles.blade.php
index 8bf4d5bcc55..cf374c04c99 100644
--- a/packages/framework/resources/views/layouts/styles.blade.php
+++ b/packages/framework/resources/views/layouts/styles.blade.php
@@ -2,17 +2,22 @@
 <style>[x-cloak] {display: none!important}</style>
 
 {{-- The compiled Tailwind/App styles --}}
-@if(config('hyde.load_app_styles_from_cdn', false))
-    <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
-@elseif(Asset::exists('app.css'))
-    <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
-@endif
+@if(Vite::running())
+    {{ Vite::assets(['resources/assets/app.css']) }}
+@else
+    @if(config('hyde.load_app_styles_from_cdn', false))
+        <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
+    @elseif(Asset::exists('app.css'))
+        <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
+    @endif
+
 
-{{-- Dynamic TailwindCSS Play CDN --}}
-@if(config('hyde.use_play_cdn', false))
-    <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
-    <script>tailwind.config = { {!! HydeFront::injectTailwindConfig() !!} }</script>
-    <script>console.warn('The HydePHP TailwindCSS Play CDN is enabled. This is for development purposes only and should not be used in production.', 'See https://hydephp.com/docs/1.x/managing-assets');</script>
+    {{-- Dynamic TailwindCSS Play CDN --}}
+    @if(config('hyde.use_play_cdn', false))
+        <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
+        <script>tailwind.config = { {!! HydeFront::injectTailwindConfig() !!} }</script>
+        <script>console.warn('The HydePHP TailwindCSS Play CDN is enabled. This is for development purposes only and should not be used in production.', 'See https://hydephp.com/docs/1.x/managing-assets');</script>
+    @endif
 @endif
 
 {{-- Add any extra styles to include after the others --}}

From 58a7f7a58cfa986a921a1d956eec8998d351c8e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:50:30 +0100
Subject: [PATCH 3238/4023] Implement the Vite connection checker

---
 packages/framework/src/Facades/Vite.php | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 0de70e06355..8c6174062fd 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -11,11 +11,29 @@
  */
 class Vite
 {
+    protected static bool $isRunning = false;
+    protected static bool $hasChecked = false;
+
     public static function running(): bool
     {
-        // TODO: Implement this
+        if (! static::$hasChecked) {
+            static::checkViteStatus();
+        }
+
+        return static::$isRunning;
+    }
 
-        return true;
+    protected static function checkViteStatus(): void
+    {
+        static::$hasChecked = true;
+
+        // Try to establish a connection to the Vite server
+        $connection = @fsockopen('localhost', 3000, $errno, $errstr, 0.1);
+        
+        if ($connection) {
+            static::$isRunning = true;
+            fclose($connection);
+        }
     }
 
     public static function assets(array $paths): HtmlString

From 86e0180eb8f72e14dce53a81ea826c97ce6e03bd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:55:28 +0100
Subject: [PATCH 3239/4023] Use much faster environment variable for Vite
 status

The socket check takes a few milliseconds on Mac which is totally okay, but about 500ms on Windows which is not acceptable for each page visit.
---
 .../src/Console/Commands/ServeCommand.php     |  1 +
 packages/framework/src/Facades/Vite.php       | 22 +------------------
 2 files changed, 2 insertions(+), 21 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index b4a286a7ea9..69488e9f45d 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -137,6 +137,7 @@ protected function getEnvironmentVariables(): array
             'HYDE_SERVER_DASHBOARD' => $this->parseEnvironmentOption('dashboard'),
             'HYDE_PRETTY_URLS' => $this->parseEnvironmentOption('pretty-urls'),
             'HYDE_PLAY_CDN' => $this->parseEnvironmentOption('play-cdn'),
+            'HYDE_SERVER_VITE' => $this->option('vite') ? 'enabled' : null,
         ]);
     }
 
diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 8c6174062fd..87dc1841263 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -11,29 +11,9 @@
  */
 class Vite
 {
-    protected static bool $isRunning = false;
-    protected static bool $hasChecked = false;
-
     public static function running(): bool
     {
-        if (! static::$hasChecked) {
-            static::checkViteStatus();
-        }
-
-        return static::$isRunning;
-    }
-
-    protected static function checkViteStatus(): void
-    {
-        static::$hasChecked = true;
-
-        // Try to establish a connection to the Vite server
-        $connection = @fsockopen('localhost', 3000, $errno, $errstr, 0.1);
-        
-        if ($connection) {
-            static::$isRunning = true;
-            fclose($connection);
-        }
+        return env('HYDE_SERVER_VITE') === 'enabled';
     }
 
     public static function assets(array $paths): HtmlString

From b0833006004ac867c317163927b34de514b10fcc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 10:58:19 +0100
Subject: [PATCH 3240/4023] Flush output

---
 .../src/Console/Commands/ServeCommand.php     | 36 ++++++++++++++++---
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 69488e9f45d..1ba7c13ca3a 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -73,7 +73,17 @@ protected function runViteProcess(): void
 
         Process::forever()
             ->env($this->getViteEnvironmentVariables())
-            ->start($viteCommand, $this->getViteOutputHandler());
+            ->tty(true)
+            ->start($viteCommand, function (string $type, string $output): void {
+                if (Process::ERR === $type) {
+                    $this->error($output);
+                } else {
+                    $this->line($output);
+                }
+                if (defined('PHP_WINDOWS_VERSION_BUILD')) {
+                    flush();
+                }
+            });
 
         $this->info('Vite development server started for HMR.');
     }
@@ -88,8 +98,15 @@ protected function getViteEnvironmentVariables(): array
 
     protected function getViteOutputHandler(): Closure
     {
-        return function (string $type, string $line): void {
-            $this->output->write($line);
+        return function (string $type, string $output): void {
+            if (Process::ERR === $type) {
+                $this->error($output);
+            } else {
+                $this->line($output);
+            }
+            if (defined('PHP_WINDOWS_VERSION_BUILD')) {
+                flush();
+            }
         };
     }
 
@@ -112,7 +129,14 @@ protected function runServerProcess(string $command): void
     {
         $process = Process::forever()
             ->env($this->getEnvironmentVariables())
-            ->start($command, $this->getOutputHandler());
+            ->tty(true)
+            ->start($command, function (string $type, string $output): void {
+                if (Process::ERR === $type) {
+                    $this->error($output);
+                } else {
+                    $this->line($output);
+                }
+            });
 
         if (PHP_OS_FAMILY !== 'Windows') {
             pcntl_async_signals(true);
@@ -123,9 +147,11 @@ protected function runServerProcess(string $command): void
             });
         }
 
-        // Keep the main process running
         while (true) {
             usleep(1000000); // Sleep for 1 second
+            if (defined('PHP_WINDOWS_VERSION_BUILD')) {
+                flush();
+            }
         }
     }
 

From da82fa60bc6a1310b7093e9d4ee9376827631740 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:02:28 +0100
Subject: [PATCH 3241/4023] Start over with Vite server

---
 .../src/Console/Commands/ServeCommand.php     | 74 +------------------
 1 file changed, 1 insertion(+), 73 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 1ba7c13ca3a..84f28f49e92 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -67,49 +67,6 @@ public function safeHandle(): int
         return Command::SUCCESS;
     }
 
-    protected function runViteProcess(): void
-    {
-        $viteCommand = 'npm run dev';
-
-        Process::forever()
-            ->env($this->getViteEnvironmentVariables())
-            ->tty(true)
-            ->start($viteCommand, function (string $type, string $output): void {
-                if (Process::ERR === $type) {
-                    $this->error($output);
-                } else {
-                    $this->line($output);
-                }
-                if (defined('PHP_WINDOWS_VERSION_BUILD')) {
-                    flush();
-                }
-            });
-
-        $this->info('Vite development server started for HMR.');
-    }
-
-    protected function getViteEnvironmentVariables(): array
-    {
-        return Arr::whereNotNull([
-            'NODE_ENV' => 'development',
-            'PORT' => 3000,
-        ]);
-    }
-
-    protected function getViteOutputHandler(): Closure
-    {
-        return function (string $type, string $output): void {
-            if (Process::ERR === $type) {
-                $this->error($output);
-            } else {
-                $this->line($output);
-            }
-            if (defined('PHP_WINDOWS_VERSION_BUILD')) {
-                flush();
-            }
-        };
-    }
-
     protected function getHostSelection(): string
     {
         return (string) $this->option('host') ?: Config::getString('hyde.server.host', 'localhost');
@@ -127,32 +84,7 @@ protected function getExecutablePath(): string
 
     protected function runServerProcess(string $command): void
     {
-        $process = Process::forever()
-            ->env($this->getEnvironmentVariables())
-            ->tty(true)
-            ->start($command, function (string $type, string $output): void {
-                if (Process::ERR === $type) {
-                    $this->error($output);
-                } else {
-                    $this->line($output);
-                }
-            });
-
-        if (PHP_OS_FAMILY !== 'Windows') {
-            pcntl_async_signals(true);
-            pcntl_signal(SIGINT, function () use ($process) {
-                $this->info("\nShutting down servers...");
-                $process->stop();
-                exit;
-            });
-        }
-
-        while (true) {
-            usleep(1000000); // Sleep for 1 second
-            if (defined('PHP_WINDOWS_VERSION_BUILD')) {
-                flush();
-            }
-        }
+        Process::forever()->env($this->getEnvironmentVariables())->run($command, $this->getOutputHandler());
     }
 
     protected function getEnvironmentVariables(): array
@@ -179,10 +111,6 @@ protected function printStartMessage(): void
         $this->useBasicOutput()
             ? $this->output->writeln('<info>Starting the HydeRC server...</info> Press Ctrl+C to stop')
             : $this->console->printStartMessage($this->getHostSelection(), $this->getPortSelection(), $this->getEnvironmentVariables());
-
-        if ($this->option('vite')) {
-            $this->console->printViteMessage();
-        }
     }
 
     protected function getOutputHandler(): Closure

From 310407ebc0efb0baef53a886b8f61f0e676b6fe6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:09:34 +0100
Subject: [PATCH 3242/4023] Simpler Vite process handler

---
 packages/framework/src/Console/Commands/ServeCommand.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 84f28f49e92..76da51c2c95 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -177,4 +177,11 @@ protected function getOpenCommand(string $osFamily): ?string
             default => null
         };
     }
+
+    protected function runViteProcess(): void
+    {
+        Process::forever()->start('npm run dev', function (string $type, string $output): void {
+            $this->output->write($output);
+        });
+    }
 }

From d0fc208cad18aa97f9d636b3d53873ad8d27ec1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:23:36 +0100
Subject: [PATCH 3243/4023] Run server asynchronously

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 76da51c2c95..456a4bd7ceb 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -84,7 +84,7 @@ protected function getExecutablePath(): string
 
     protected function runServerProcess(string $command): void
     {
-        Process::forever()->env($this->getEnvironmentVariables())->run($command, $this->getOutputHandler());
+        $this->server = Process::forever()->env($this->getEnvironmentVariables())->start($command, $this->getOutputHandler());
     }
 
     protected function getEnvironmentVariables(): array

From b6d96c47f68e58170a7d4f640683007754e99836 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:23:51 +0100
Subject: [PATCH 3244/4023] Sleep while server is running

---
 packages/framework/src/Console/Commands/ServeCommand.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 456a4bd7ceb..f9e233fcf98 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -64,6 +64,10 @@ public function safeHandle(): int
 
         $this->runServerProcess($command);
 
+        while ($this->server->running()) {
+            sleep(1);
+        }
+
         return Command::SUCCESS;
     }
 

From 6d40de62b895427b0f8eadefac66808450cbd27b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:24:07 +0100
Subject: [PATCH 3245/4023] Handle output from sleep loop

---
 packages/framework/src/Console/Commands/ServeCommand.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index f9e233fcf98..9163f28b9e7 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -65,6 +65,10 @@ public function safeHandle(): int
         $this->runServerProcess($command);
 
         while ($this->server->running()) {
+            if (isset($this->vite) && $this->vite->running()) {
+                echo $this->vite->latestOutput();
+            }
+
             sleep(1);
         }
 
@@ -184,8 +188,6 @@ protected function getOpenCommand(string $osFamily): ?string
 
     protected function runViteProcess(): void
     {
-        Process::forever()->start('npm run dev', function (string $type, string $output): void {
-            $this->output->write($output);
-        });
+        $this->vite = Process::forever()->start('npm run dev');
     }
 }

From 6ea538f8fef0ed27d59b976e89c64cf993d4afe3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:24:13 +0100
Subject: [PATCH 3246/4023] Declare properties

---
 packages/framework/src/Console/Commands/ServeCommand.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 9163f28b9e7..8d67f7bb2be 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -7,6 +7,7 @@
 use Closure;
 use Hyde\Hyde;
 use Hyde\Facades\Config;
+use Illuminate\Process\InvokedProcess;
 use Illuminate\Support\Arr;
 use InvalidArgumentException;
 use Hyde\Console\Concerns\Command;
@@ -43,6 +44,9 @@ class ServeCommand extends Command
 
     protected ConsoleOutput $console;
 
+    protected InvokedProcess $server;
+    protected InvokedProcess $vite;
+
     public function safeHandle(): int
     {
         $this->configureOutput();

From 1795b6a110dce23f1c1d66c9e0fc12531e7b6163 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 12:00:48 +0100
Subject: [PATCH 3247/4023] Don't clear Vite output directory

Causes issues since we have other media there
---
 vite.config.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vite.config.js b/vite.config.js
index 6d088d3819a..5502c9215a6 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -18,7 +18,7 @@ export default defineConfig({
     },
     build: {
         outDir: '_media',
-        emptyOutDir: true,
+        emptyOutDir: false,
         rollupOptions: {
             input: [
                 resolve(__dirname, 'resources/assets/app.js'),

From 2df66ec1c249b2623a0d7f13d46d5e3e9e473a8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 12:00:54 +0100
Subject: [PATCH 3248/4023] Fix formatting

---
 vite.config.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vite.config.js b/vite.config.js
index 5502c9215a6..6bca1ce476d 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -31,4 +31,4 @@ export default defineConfig({
             }
         }
     }
-});
\ No newline at end of file
+});

From 6a19d1f31bc5e9a05d314ef2128150860c6c6a45 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 12:05:35 +0100
Subject: [PATCH 3249/4023] Type against the contract

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 8d67f7bb2be..11ce7a5d59d 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -7,7 +7,7 @@
 use Closure;
 use Hyde\Hyde;
 use Hyde\Facades\Config;
-use Illuminate\Process\InvokedProcess;
+use Illuminate\Contracts\Process\InvokedProcess;
 use Illuminate\Support\Arr;
 use InvalidArgumentException;
 use Hyde\Console\Concerns\Command;

From f1703660c205cb60bf72c8520463ccb0e1287729 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:34:21 +0100
Subject: [PATCH 3250/4023] Sleep for 100ms instead of 1 second

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 11ce7a5d59d..eca39f70ac5 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -73,7 +73,7 @@ public function safeHandle(): int
                 echo $this->vite->latestOutput();
             }
 
-            sleep(1);
+            usleep(100000); // Sleep for 100ms
         }
 
         return Command::SUCCESS;

From d9355112444b924e9cd44f29d75ee149f8148b7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:36:56 +0100
Subject: [PATCH 3251/4023] Remove unused Vite start message helper

---
 packages/realtime-compiler/src/ConsoleOutput.php | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index 0d3992c27b7..a96cd0329be 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -54,16 +54,6 @@ public function printStartMessage(string $host, int $port, array $environment =
         render("<div class=\"text-green-500\">$body</div>");
     }
 
-    public function printViteMessage(): void
-    {
-        $this->output->writeln([
-            '',
-            ' <info>Starting Vite development server...</info>',
-            ' <comment>HMR will be available on port 3000</comment>',
-            '',
-        ]);
-    }
-
     public function getFormatter(): Closure
     {
         return function (string $type, string $line): void {

From 406e8ae4e471a674e060a7f747da19dd88cf2b13 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:42:16 +0100
Subject: [PATCH 3252/4023] Add Vite information to output start message

---
 packages/realtime-compiler/src/ConsoleOutput.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index a96cd0329be..93f1d44cbe5 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -35,6 +35,8 @@ public function printStartMessage(string $host, int $port, array $environment =
             sprintf('<span class="text-white">Listening on:</span> <a href="%s" class="text-yellow-500">%s</a>', $url, $url),
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
+            Arr::get($environment, 'HYDE_SERVER_VITE') === 'enabled' ?
+                sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:3000" class="text-yellow-500">http://%s:3000</a>', $host, $host) : null,
             '',
         ]);
 

From 8419a685516f3d67b3cde9314c7a88d21c426a39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:55:22 +0100
Subject: [PATCH 3253/4023] Support standalone Vite servers

---
 packages/framework/src/Facades/Vite.php | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 87dc1841263..e016a35bc1c 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -13,7 +13,22 @@ class Vite
 {
     public static function running(): bool
     {
-        return env('HYDE_SERVER_VITE') === 'enabled';
+        // Check if Vite was enabled via the serve command
+        if (env('HYDE_SERVER_VITE') === 'enabled') {
+            return true;
+        }
+
+        // Check if Vite dev server is running by attempting to connect to it
+        // Todo: Check performance on Windows (takes less than 1ms on macOS)
+        $server = @fsockopen('localhost', 3000, $errno, $errstr, 0.1);
+
+        if ($server) {
+            fclose($server);
+
+            return true;
+        }
+
+        return false;
     }
 
     public static function assets(array $paths): HtmlString

From 57a22d9cf1c570a664469b18ef8b15db8e095349 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 11:56:27 +0100
Subject: [PATCH 3254/4023] Use default Vite port

---
 packages/framework/src/Facades/Vite.php                  | 8 ++++----
 packages/realtime-compiler/resources/dashboard.blade.php | 2 +-
 packages/realtime-compiler/src/ConsoleOutput.php         | 2 +-
 vite.config.js                                           | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index e016a35bc1c..a8dd219ebdf 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -20,7 +20,7 @@ public static function running(): bool
 
         // Check if Vite dev server is running by attempting to connect to it
         // Todo: Check performance on Windows (takes less than 1ms on macOS)
-        $server = @fsockopen('localhost', 3000, $errno, $errstr, 0.1);
+        $server = @fsockopen('localhost', 5173, $errno, $errstr, 0.1);
 
         if ($server) {
             fclose($server);
@@ -33,15 +33,15 @@ public static function running(): bool
 
     public static function assets(array $paths): HtmlString
     {
-        $html = sprintf('<script src="http://localhost:3000/@vite/client" type="module"></script>');
+        $html = sprintf('<script src="http://localhost:5173/@vite/client" type="module"></script>');
 
         foreach ($paths as $path) {
             if (str_ends_with($path, '.css')) {
-                $html .= sprintf('<link rel="stylesheet" href="http://localhost:3000/%s">', $path);
+                $html .= sprintf('<link rel="stylesheet" href="http://localhost:5173/%s">', $path);
             }
 
             if (str_ends_with($path, '.js')) {
-                $html .= sprintf('<script src="http://localhost:3000/%s" type="module"></script>', $path);
+                $html .= sprintf('<script src="http://localhost:5173/%s" type="module"></script>', $path);
             }
         }
 
diff --git a/packages/realtime-compiler/resources/dashboard.blade.php b/packages/realtime-compiler/resources/dashboard.blade.php
index d7bcf0fb77a..ba7301e8d83 100644
--- a/packages/realtime-compiler/resources/dashboard.blade.php
+++ b/packages/realtime-compiler/resources/dashboard.blade.php
@@ -98,7 +98,7 @@
                                                     await navigator.clipboard.writeText(data);
                                                     document.getElementById("copyPathToClipboardButtonIcon").style.display = 'none';
                                                     document.getElementById("copyPathToClipboardButtonIconSuccess").style.display = 'inline';
-                                                    await new Promise(resolve => setTimeout(resolve, 3000)).then(function () {
+                                                    await new Promise(resolve => setTimeout(resolve, 5173)).then(function () {
                                                         document.getElementById("copyPathToClipboardButtonIcon").style.display = 'inline';
                                                         document.getElementById("copyPathToClipboardButtonIconSuccess").style.display = 'none';
                                                     });
diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index 93f1d44cbe5..2c9b216d72d 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -36,7 +36,7 @@ public function printStartMessage(string $host, int $port, array $environment =
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
             Arr::get($environment, 'HYDE_SERVER_VITE') === 'enabled' ?
-                sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:3000" class="text-yellow-500">http://%s:3000</a>', $host, $host) : null,
+                sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:5173" class="text-yellow-500">http://%s:5173</a>', $host, $host) : null,
             '',
         ]);
 
diff --git a/vite.config.js b/vite.config.js
index ee596703bba..17a2bcca8be 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -11,10 +11,10 @@ import path from 'path';
 
 export default defineConfig({
     server: {
-        port: 3000,
+        port: 5173,
         hmr: {
             host: 'localhost',
-            port: 3000,
+            port: 5173,
         },
         middlewareMode: false,
     },

From f1c421e3f6b1fff880d23b50b3e1c96f6b6d9d59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 13:44:49 +0100
Subject: [PATCH 3255/4023] Add widths for layout to work without network

---
 packages/realtime-compiler/resources/vite-index-page.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/realtime-compiler/resources/vite-index-page.html b/packages/realtime-compiler/resources/vite-index-page.html
index 5c2a24e33b1..b6902af7381 100644
--- a/packages/realtime-compiler/resources/vite-index-page.html
+++ b/packages/realtime-compiler/resources/vite-index-page.html
@@ -16,13 +16,13 @@
                 <div class="mx-auto">
                     <div class="flex items-center justify-center">
                         <a href="https://hydephp.com">
-                           <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:serif="http://www.serif.com/" class="h-24 w-auto" viewBox="0 0 4267 4267" version="1.1" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><rect id="masked" x="0" y="0" width="4266.67" height="4266.67" style="fill:none;"/><g id="base"/><g id="src"><path d="M3099.01,2876.31l142.659,-1865.88c-0,-10.687 -0.634,-20.82 -1.663,-29.529c0.238,-2.612 1.663,-5.937 1.663,-8.708c-0,-142.817 -496.296,-258.638 -1108.33,-258.638c-612.116,0 -1108.33,115.742 -1108.33,258.638c-0,2.771 1.346,5.383 1.742,8.075c-1.109,8.708 -1.742,18.208 -1.742,28.896l142.658,1867.15c-277.4,72.041 -459.325,173.454 -459.325,286.187c0,218.658 681.704,395.833 1425,395.833c743.296,0 1425,-177.175 1425,-395.833c0,-112.733 -181.925,-214.146 -459.325,-286.188Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/><path d="M2096.6,1230.44c-387.125,-0.001 -680.992,-70.934 -859.117,-130.309c-41.483,-13.854 -63.966,-58.662 -50.112,-100.146c13.854,-41.483 58.504,-63.966 100.146,-50.112c228.712,76.237 851.991,228.871 1695.83,-1.267c41.879,-11.242 85.658,13.3 97.137,55.575c11.559,42.196 -13.379,85.738 -55.575,97.217c-348.808,95.158 -660.804,129.041 -928.308,129.041Z" style="fill:#66757f;fill-opacity:0.1;fill-rule:nonzero;"/><path d="M3099.01,2876.31l35.309,-461.463c-609.98,170.763 -1392.15,174.721 -2004.18,-29.846l31.113,407.075c5.462,24.067 8.946,51.459 8.946,85.184c-0,138.541 102.045,223.883 219.37,268.85c352.925,135.216 1105.01,130.308 1488.89,11.795c116.137,-35.862 219.767,-137.195 219.767,-252.62c-0,-9.421 1.187,-19.08 1.9,-28.58l-1.109,-0.395Z" style="fill:url(#_Linear2);fill-rule:nonzero;"/><g id="gradient.svg"/></g><defs><linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(2850,0,0,2844.78,708.333,2135.95)"><stop offset="0" style="stop-color:#141e30;stop-opacity:1"/><stop offset="1" style="stop-color:#243b55;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(3008.33,-1187.5,510.846,1294.14,945.833,3320.83)"><stop offset="0" style="stop-color:#8a2387;stop-opacity:1"/><stop offset="0.5" style="stop-color:#e94057;stop-opacity:1"/><stop offset="1" style="stop-color:#f27121;stop-opacity:1"/></linearGradient></defs></svg>
+                           <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:serif="http://www.serif.com/" width="4rem" class="h-24 w-auto" viewBox="0 0 4267 4267" version="1.1" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><rect id="masked" x="0" y="0" width="4266.67" height="4266.67" style="fill:none;"/><g id="base"/><g id="src"><path d="M3099.01,2876.31l142.659,-1865.88c-0,-10.687 -0.634,-20.82 -1.663,-29.529c0.238,-2.612 1.663,-5.937 1.663,-8.708c-0,-142.817 -496.296,-258.638 -1108.33,-258.638c-612.116,0 -1108.33,115.742 -1108.33,258.638c-0,2.771 1.346,5.383 1.742,8.075c-1.109,8.708 -1.742,18.208 -1.742,28.896l142.658,1867.15c-277.4,72.041 -459.325,173.454 -459.325,286.187c0,218.658 681.704,395.833 1425,395.833c743.296,0 1425,-177.175 1425,-395.833c0,-112.733 -181.925,-214.146 -459.325,-286.188Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/><path d="M2096.6,1230.44c-387.125,-0.001 -680.992,-70.934 -859.117,-130.309c-41.483,-13.854 -63.966,-58.662 -50.112,-100.146c13.854,-41.483 58.504,-63.966 100.146,-50.112c228.712,76.237 851.991,228.871 1695.83,-1.267c41.879,-11.242 85.658,13.3 97.137,55.575c11.559,42.196 -13.379,85.738 -55.575,97.217c-348.808,95.158 -660.804,129.041 -928.308,129.041Z" style="fill:#66757f;fill-opacity:0.1;fill-rule:nonzero;"/><path d="M3099.01,2876.31l35.309,-461.463c-609.98,170.763 -1392.15,174.721 -2004.18,-29.846l31.113,407.075c5.462,24.067 8.946,51.459 8.946,85.184c-0,138.541 102.045,223.883 219.37,268.85c352.925,135.216 1105.01,130.308 1488.89,11.795c116.137,-35.862 219.767,-137.195 219.767,-252.62c-0,-9.421 1.187,-19.08 1.9,-28.58l-1.109,-0.395Z" style="fill:url(#_Linear2);fill-rule:nonzero;"/><g id="gradient.svg"/></g><defs><linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(2850,0,0,2844.78,708.333,2135.95)"><stop offset="0" style="stop-color:#141e30;stop-opacity:1"/><stop offset="1" style="stop-color:#243b55;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(3008.33,-1187.5,510.846,1294.14,945.833,3320.83)"><stop offset="0" style="stop-color:#8a2387;stop-opacity:1"/><stop offset="0.5" style="stop-color:#e94057;stop-opacity:1"/><stop offset="1" style="stop-color:#f27121;stop-opacity:1"/></linearGradient></defs></svg>
                         </a>
-                        <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6  text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6  text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" width="2rem">
                             <path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" />
                         </svg>
                         <a href="https://vitejs.dev">
-                            <svg viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg" class="h-16 ml-3 w-auto">
+                            <svg viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg" width="4rem" class="h-16 ml-3 w-auto">
                                 <path d="M399.641 59.5246L215.643 388.545C211.844 395.338 202.084 395.378 198.228 388.618L10.5817 59.5563C6.38087 52.1896 12.6802 43.2665 21.0281 44.7586L205.223 77.6824C206.398 77.8924 207.601 77.8904 208.776 77.6763L389.119 44.8058C397.439 43.2894 403.768 52.1434 399.641 59.5246Z" fill="url(#paint0_linear)" />
                                 <path d="M292.965 1.5744L156.801 28.2552C154.563 28.6937 152.906 30.5903 152.771 32.8664L144.395 174.33C144.198 177.662 147.258 180.248 150.51 179.498L188.42 170.749C191.967 169.931 195.172 173.055 194.443 176.622L183.18 231.775C182.422 235.487 185.907 238.661 189.532 237.56L212.947 230.446C216.577 229.344 220.065 232.527 219.297 236.242L201.398 322.875C200.278 328.294 207.486 331.249 210.492 326.603L212.5 323.5L323.454 102.072C325.312 98.3645 322.108 94.137 318.036 94.9228L279.014 102.454C275.347 103.161 272.227 99.746 273.262 96.1583L298.731 7.86689C299.767 4.27314 296.636 0.855181 292.965 1.5744Z" fill="url(#paint1_linear)" />
                                 <defs>

From c0d67ffdf03c7b6d90410acee64c159d1c34f3de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 13:13:10 +0100
Subject: [PATCH 3256/4023] Update tests for asynchronous server process

---
 .../tests/Feature/Commands/ServeCommandTest.php        | 10 ++++++++--
 .../tests/Unit/ServeCommandOptionsUnitTest.php         |  2 ++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/ServeCommandTest.php b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
index c8569cc38ae..ebabf130cd0 100644
--- a/packages/framework/tests/Feature/Commands/ServeCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
@@ -7,6 +7,7 @@
 use Closure;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Contracts\Process\InvokedProcess;
 use Illuminate\Support\Facades\Process;
 use TypeError;
 
@@ -138,6 +139,11 @@ public function testHydeServeCommandWithInvalidConfigValue()
 
     public function testHydeServeCommandPassesThroughProcessOutput()
     {
+        $mockProcess = mock(InvokedProcess::class);
+        $mockProcess->shouldReceive('running')
+            ->once()
+            ->andReturn(false);
+
         Process::shouldReceive('forever')
             ->once()
             ->withNoArgs()
@@ -148,14 +154,14 @@ public function testHydeServeCommandPassesThroughProcessOutput()
             ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false])
             ->andReturnSelf();
 
-        Process::shouldReceive('run')
+        Process::shouldReceive('start')
             ->once()
             ->withArgs(function (string $command, Closure $handle) {
                 $handle('type', 'foo');
 
                 return $command === "php -S localhost:8080 {$this->binaryPath()}";
             })
-            ->andReturnSelf();
+            ->andReturn($mockProcess);
 
         $this->artisan('serve --no-ansi')
             ->expectsOutput('Starting the HydeRC server... Press Ctrl+C to stop')
diff --git a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
index f76d70e35ee..2d11dcc7d91 100644
--- a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
+++ b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
@@ -367,6 +367,8 @@ protected function printStartMessage(): void
 
             protected function runServerProcess(string $command): void
             {
+                $this->server = Mockery::mock(\Illuminate\Contracts\Process\InvokedProcess::class);
+                $this->server->shouldReceive('running')->once()->andReturn(false);
             }
 
             protected function openInBrowser(string $path = '/'): void

From 704f67cde5b9bcd470a3d9507ae175c955e12ce2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 14:16:59 +0100
Subject: [PATCH 3257/4023] Use the sleep facade

---
 packages/framework/src/Console/Commands/ServeCommand.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index eca39f70ac5..ea74db68609 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -9,6 +9,7 @@
 use Hyde\Facades\Config;
 use Illuminate\Contracts\Process\InvokedProcess;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Sleep;
 use InvalidArgumentException;
 use Hyde\Console\Concerns\Command;
 use Hyde\RealtimeCompiler\ConsoleOutput;
@@ -73,7 +74,7 @@ public function safeHandle(): int
                 echo $this->vite->latestOutput();
             }
 
-            usleep(100000); // Sleep for 100ms
+            Sleep::usleep(100000); // 100ms
         }
 
         return Command::SUCCESS;

From b03ec7fa31e2a0136f92cacf63f6fbf63fa9903f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 13:52:24 +0100
Subject: [PATCH 3258/4023] Add tests to cover introduced code

---
 .../src/Console/Commands/ServeCommand.php     |  2 +-
 .../Feature/Commands/ServeCommandTest.php     | 85 +++++++++++++++++++
 .../tests/Unit/Facades/ViteFacadeTest.php     | 67 ++++++++++++++-
 .../Unit/ServeCommandOptionsUnitTest.php      | 56 ++++++++++++
 4 files changed, 208 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index ea74db68609..00a9628cce3 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -71,7 +71,7 @@ public function safeHandle(): int
 
         while ($this->server->running()) {
             if (isset($this->vite) && $this->vite->running()) {
-                echo $this->vite->latestOutput();
+                $this->line($this->vite->latestOutput());
             }
 
             Sleep::usleep(100000); // 100ms
diff --git a/packages/framework/tests/Feature/Commands/ServeCommandTest.php b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
index ebabf130cd0..d12916858a0 100644
--- a/packages/framework/tests/Feature/Commands/ServeCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
@@ -180,6 +180,91 @@ public function testWithFancyOutput()
         Process::assertRan("php -S localhost:8080 {$this->binaryPath()}");
     }
 
+    public function testHydeServeCommandWithViteOption()
+    {
+        $mockViteProcess = mock(InvokedProcess::class);
+        $mockViteProcess->shouldReceive('running')
+            ->once()
+            ->andReturn(true);
+        $mockViteProcess->shouldReceive('latestOutput')
+            ->once()
+            ->andReturn('vite latest output');
+
+        $mockServerProcess = mock(InvokedProcess::class);
+        $mockServerProcess->shouldReceive('running')
+            ->times(2)
+            ->andReturn(true, false);
+
+        Process::shouldReceive('forever')
+            ->twice()
+            ->withNoArgs()
+            ->andReturnSelf();
+
+        Process::shouldReceive('env')
+            ->once()
+            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false, 'HYDE_SERVER_VITE' => 'enabled'])
+            ->andReturnSelf();
+
+        Process::shouldReceive('start')
+            ->once()
+            ->with('npm run dev')
+            ->andReturn($mockViteProcess);
+
+        Process::shouldReceive('start')
+            ->once()
+            ->withArgs(function (string $command, Closure $output) {
+                $output('stdout', 'server output');
+
+                return $command === "php -S localhost:8080 {$this->binaryPath()}";
+            })
+            ->andReturn($mockServerProcess);
+
+        $this->artisan('serve --no-ansi --vite')
+            ->expectsOutput('Starting the HydeRC server... Press Ctrl+C to stop')
+            ->expectsOutput('server output')
+            ->expectsOutput('vite latest output')
+            ->assertExitCode(0);
+    }
+
+    public function testHydeServeCommandWithViteOptionButViteNotRunning()
+    {
+        $mockViteProcess = mock(InvokedProcess::class);
+        $mockViteProcess->shouldReceive('running')
+            ->once()
+            ->andReturn(false);
+
+        $mockServerProcess = mock(InvokedProcess::class);
+        $mockServerProcess->shouldReceive('running')
+            ->times(2)
+            ->andReturn(true, false);
+
+        Process::shouldReceive('forever')
+            ->twice()
+            ->withNoArgs()
+            ->andReturnSelf();
+
+        Process::shouldReceive('env')
+            ->once()
+            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false, 'HYDE_SERVER_VITE' => 'enabled'])
+            ->andReturnSelf();
+
+        Process::shouldReceive('start')
+            ->once()
+            ->with('npm run dev')
+            ->andReturn($mockViteProcess);
+
+        Process::shouldReceive('start')
+            ->once()
+            ->withArgs(function (string $command, Closure $handle) {
+                return $command === "php -S localhost:8080 {$this->binaryPath()}";
+            })
+            ->andReturn($mockServerProcess);
+
+        $this->artisan('serve --no-ansi --vite')
+            ->expectsOutput('Starting the HydeRC server... Press Ctrl+C to stop')
+            ->assertExitCode(0);
+    }
+
     protected function binaryPath(): string
     {
         return Hyde::path('vendor/hyde/realtime-compiler/bin/server.php');
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 5ad403733b8..54d20d115fb 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -3,11 +3,76 @@
 namespace Hyde\Framework\Testing\Unit\Facades;
 
 use Hyde\Testing\UnitTestCase;
+use Hyde\Facades\Vite;
 
 /**
  * @covers \Hyde\Facades\Vite
  */
 class ViteFacadeTest extends UnitTestCase
 {
-    //
+    public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
+    {
+        putenv('HYDE_SERVER_VITE=enabled');
+
+        $this->assertTrue(Vite::running());
+
+        putenv('HYDE_SERVER_VITE');
+    }
+
+    public function testRunningReturnsTrueWhenViteServerIsAccessible()
+    {
+        // Create a mock server to simulate Vite
+        $server = stream_socket_server('tcp://localhost:5173');
+
+        $this->assertTrue(Vite::running());
+
+        // Clean up
+        stream_socket_shutdown($server, STREAM_SHUT_RDWR);
+    }
+
+    public function testRunningReturnsFalseWhenViteServerIsNotAccessible()
+    {
+        $this->assertFalse(Vite::running());
+    }
+
+    public function testAssetsMethodGeneratesCorrectHtmlForJavaScriptFiles()
+    {
+        $html = Vite::assets(['resources/js/app.js']);
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
+            .'<script src="http://localhost:5173/resources/js/app.js" type="module"></script>';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public function testAssetsMethodGeneratesCorrectHtmlForCssFiles()
+    {
+        $html = Vite::assets(['resources/css/app.css']);
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
+            .'<link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
+    {
+        $html = Vite::assets([
+            'resources/js/app.js',
+            'resources/css/app.css',
+            'resources/js/other.js',
+        ]);
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
+            .'<script src="http://localhost:5173/resources/js/app.js" type="module"></script>'
+            .'<link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">'
+            .'<script src="http://localhost:5173/resources/js/other.js" type="module"></script>';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public function testAssetsMethodReturnsHtmlString()
+    {
+        $this->assertInstanceOf(\Illuminate\Support\HtmlString::class, Vite::assets([]));
+    }
 }
diff --git a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
index 2d11dcc7d91..cf26d2a842e 100644
--- a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
+++ b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
@@ -335,6 +335,29 @@ public function testGetOpenCommandForUnknownOS()
         $this->assertNull($this->getMock()->getOpenCommand('UnknownOS'));
     }
 
+    public function testViteOptionPropagatesToEnvironmentVariables()
+    {
+        $command = $this->getMock(['vite' => true]);
+        $this->assertSame('enabled', $command->getEnvironmentVariables()['HYDE_SERVER_VITE']);
+
+        $command = $this->getMock(['vite' => false]);
+        $this->assertFalse(isset($command->getEnvironmentVariables()['HYDE_SERVER_VITE']));
+
+        $command = $this->getMock();
+        $this->assertFalse(isset($command->getEnvironmentVariables()['HYDE_SERVER_VITE']));
+    }
+
+    public function testWithViteArgument()
+    {
+        HydeKernel::setInstance(new HydeKernel());
+
+        $command = $this->getViteServeCommandMock(['vite' => true]);
+
+        $command->safeHandle();
+
+        $this->assertTrue($command->viteProcessStarted);
+    }
+
     protected function getTestRunnerBinary(): string
     {
         return match (PHP_OS_FAMILY) {
@@ -378,6 +401,39 @@ protected function openInBrowser(string $path = '/'): void
             }
         };
     }
+
+    protected function getViteServeCommandMock(array $arguments): ServeCommandMock
+    {
+        return new class($arguments) extends ServeCommandMock
+        {
+            public bool $viteProcessStarted = false;
+
+            // Void unrelated methods
+            protected function configureOutput(): void
+            {
+            }
+
+            protected function printStartMessage(): void
+            {
+            }
+
+            protected function runServerProcess(string $command): void
+            {
+                $this->server = Mockery::mock(\Illuminate\Contracts\Process\InvokedProcess::class);
+                $this->server->shouldReceive('running')->once()->andReturn(false);
+            }
+
+            protected function runViteProcess(): void
+            {
+                $this->viteProcessStarted = true;
+            }
+
+            protected function openInBrowser(string $path = '/'): void
+            {
+                //
+            }
+        };
+    }
 }
 
 /**

From 2208e17955593a68ea4630ce178cf701329b242b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 15:04:27 +0100
Subject: [PATCH 3259/4023] Suppress failed connection warnings

---
 packages/framework/src/Facades/Vite.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index a8dd219ebdf..4a8b7577c2c 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -20,7 +20,9 @@ public static function running(): bool
 
         // Check if Vite dev server is running by attempting to connect to it
         // Todo: Check performance on Windows (takes less than 1ms on macOS)
-        $server = @fsockopen('localhost', 5173, $errno, $errstr, 0.1);
+        set_error_handler(fn () => false);
+        $server = fsockopen('localhost', 5173, $errno, $errstr, 0.1);
+        restore_error_handler();
 
         if ($server) {
             fclose($server);

From 761d92a55df179c585892a41418d1b1d3c8864de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 12 Nov 2024 15:12:58 +0100
Subject: [PATCH 3260/4023] Update Vite server to check if the port is free

---
 .../src/Console/Commands/ServeCommand.php     | 19 +++++++++++++++++++
 .../Feature/Commands/ServeCommandTest.php     | 11 +++++++++++
 2 files changed, 30 insertions(+)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 00a9628cce3..248ab4431aa 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -193,6 +193,25 @@ protected function getOpenCommand(string $osFamily): ?string
 
     protected function runViteProcess(): void
     {
+        if (! $this->isPortAvailable(5173)) {
+            throw new InvalidArgumentException(
+                'Unable to start Vite server: Port 5173 is already in use. '.
+                'Please stop any other Vite processes and try again.'
+            );
+        }
+
         $this->vite = Process::forever()->start('npm run dev');
     }
+
+    protected function isPortAvailable(int $port): bool
+    {
+        $socket = @fsockopen('localhost', $port, $errno, $errstr, 1);
+        if ($socket !== false) {
+            fclose($socket);
+
+            return false;
+        }
+
+        return true;
+    }
 }
diff --git a/packages/framework/tests/Feature/Commands/ServeCommandTest.php b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
index d12916858a0..8e321328099 100644
--- a/packages/framework/tests/Feature/Commands/ServeCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
@@ -265,6 +265,17 @@ public function testHydeServeCommandWithViteOptionButViteNotRunning()
             ->assertExitCode(0);
     }
 
+    public function testHydeServeCommandWithViteOptionThrowsWhenPortIsInUse()
+    {
+        $socket = stream_socket_server('tcp://127.0.0.1:5173');
+
+        $this->artisan('serve --vite')
+            ->expectsOutputToContain('Unable to start Vite server: Port 5173 is already in use')
+            ->assertExitCode(1);
+
+        stream_socket_shutdown($socket, STREAM_SHUT_RDWR);
+    }
+
     protected function binaryPath(): string
     {
         return Hyde::path('vendor/hyde/realtime-compiler/bin/server.php');

From deb202cda7a4f01d755543fe17ec4fe509834ae3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 13:57:49 +0100
Subject: [PATCH 3261/4023] Conditionally write output

---
 packages/framework/src/Console/Commands/ServeCommand.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 248ab4431aa..5abf027dd89 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -71,7 +71,11 @@ public function safeHandle(): int
 
         while ($this->server->running()) {
             if (isset($this->vite) && $this->vite->running()) {
-                $this->line($this->vite->latestOutput());
+                $output = $this->vite->latestOutput();
+
+                if ($output) {
+                    $this->output->write($output);
+                }
             }
 
             Sleep::usleep(100000); // 100ms

From 41a79fe83cbeecaa99efd30d0645aa26d7bff43d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 14:45:12 +0100
Subject: [PATCH 3262/4023] Document Windows performance

---
 packages/framework/src/Facades/Vite.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 4a8b7577c2c..912728d7487 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -19,7 +19,7 @@ public static function running(): bool
         }
 
         // Check if Vite dev server is running by attempting to connect to it
-        // Todo: Check performance on Windows (takes less than 1ms on macOS)
+        // Todo: Improve performance on Windows (takes less than 1ms on macOS, but around 100ms on Windows)
         set_error_handler(fn () => false);
         $server = fsockopen('localhost', 5173, $errno, $errstr, 0.1);
         restore_error_handler();

From 0daac5a05381c18799a5c64ea087436062f50a1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 14:55:50 +0100
Subject: [PATCH 3263/4023] Document Windows issue

---
 packages/framework/src/Facades/Vite.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 912728d7487..b778f928789 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -20,7 +20,7 @@ public static function running(): bool
 
         // Check if Vite dev server is running by attempting to connect to it
         // Todo: Improve performance on Windows (takes less than 1ms on macOS, but around 100ms on Windows)
-        set_error_handler(fn () => false);
+        set_error_handler(fn () => false); // Todo: This warning surpressor does not work on Windows
         $server = fsockopen('localhost', 5173, $errno, $errstr, 0.1);
         restore_error_handler();
 

From 91297e83feaf79400b2a01159926523e8728e24b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 15:22:40 +0100
Subject: [PATCH 3264/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7d14e72431f..832a0d88e65 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -33,6 +33,7 @@ This serves two purposes:
     - Added method `Asset::exists()` has to check if a media file exists.
     - Added a `Hyde::assets()` method to get all media file instances in the site.
 - Added new `npm run build` command for compiling frontend assets with Vite
+- Added Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
 
 ### Changed
 
@@ -131,6 +132,7 @@ This serves two purposes:
 #### Realtime Compiler
 
 - Simplified the asset file locator to only serve files from the media source directory in https://github.com/hydephp/develop/pull/2012
+- Added Vite HMR support in https://github.com/hydephp/develop/pull/2016
 
 ### Upgrade Guide
 

From 8d497f095b667503a0c7542f8f72f1a4bb842266 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 15:49:25 +0100
Subject: [PATCH 3265/4023] Fix formatting

---
 docs/extensions/realtime-compiler.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/extensions/realtime-compiler.md b/docs/extensions/realtime-compiler.md
index 8bbe2823400..2af60006a0e 100644
--- a/docs/extensions/realtime-compiler.md
+++ b/docs/extensions/realtime-compiler.md
@@ -41,13 +41,13 @@ The server can be configured in the `config/hyde.php` file to change the port, h
 'server' => [
     // The default port the preview is served on
     'port' => env('SERVER_PORT', 8080),
-    
+
     // The default host the preview is served on
     'host' => env('SERVER_HOST', 'localhost'),
-    
+
     // Should preview pages be saved to the output directory?
     'save_preview' => env('SERVER_SAVE_PREVIEW', false),
-    
+
     // Should the live edit feature be enabled?
     'live_edit' => env('SERVER_LIVE_EDIT', true),
 ],

From ff1f6dc109a6dad21c6d36a2d18becafbcb918db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 15:58:43 +0100
Subject: [PATCH 3266/4023] Fix unintentional change

---
 packages/realtime-compiler/resources/dashboard.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/realtime-compiler/resources/dashboard.blade.php b/packages/realtime-compiler/resources/dashboard.blade.php
index ba7301e8d83..d7bcf0fb77a 100644
--- a/packages/realtime-compiler/resources/dashboard.blade.php
+++ b/packages/realtime-compiler/resources/dashboard.blade.php
@@ -98,7 +98,7 @@
                                                     await navigator.clipboard.writeText(data);
                                                     document.getElementById("copyPathToClipboardButtonIcon").style.display = 'none';
                                                     document.getElementById("copyPathToClipboardButtonIconSuccess").style.display = 'inline';
-                                                    await new Promise(resolve => setTimeout(resolve, 5173)).then(function () {
+                                                    await new Promise(resolve => setTimeout(resolve, 3000)).then(function () {
                                                         document.getElementById("copyPathToClipboardButtonIcon").style.display = 'inline';
                                                         document.getElementById("copyPathToClipboardButtonIconSuccess").style.display = 'none';
                                                     });

From 0da73bf24f751e5897a8755e65b7e9c08541580e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 15:59:50 +0100
Subject: [PATCH 3267/4023] Fix formatting

---
 packages/realtime-compiler/resources/vite-index-page.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/realtime-compiler/resources/vite-index-page.html b/packages/realtime-compiler/resources/vite-index-page.html
index b6902af7381..aee5828f9c3 100644
--- a/packages/realtime-compiler/resources/vite-index-page.html
+++ b/packages/realtime-compiler/resources/vite-index-page.html
@@ -63,4 +63,4 @@ <h2 class="mt-6"><a href="http://localhost:8080/dashboard" class="font-semibold
             </div>
         </div>
     </body>
-</html>
\ No newline at end of file
+</html>

From 9dc44d142b35084b816e756981447d42a23aac8a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 15:59:57 +0100
Subject: [PATCH 3268/4023] Normalize formatting

---
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php      | 1 -
 packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php | 1 -
 2 files changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 54d20d115fb..d056f0e3dc0 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -26,7 +26,6 @@ public function testRunningReturnsTrueWhenViteServerIsAccessible()
 
         $this->assertTrue(Vite::running());
 
-        // Clean up
         stream_socket_shutdown($server, STREAM_SHUT_RDWR);
     }
 
diff --git a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
index cf26d2a842e..9df671ec114 100644
--- a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
+++ b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
@@ -430,7 +430,6 @@ protected function runViteProcess(): void
 
             protected function openInBrowser(string $path = '/'): void
             {
-                //
             }
         };
     }

From 5ed9f6b8a6f1d963a2d841ad9f6f9dcdbe9c6954 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 16:00:00 +0100
Subject: [PATCH 3269/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 832a0d88e65..802e893e7f2 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -33,7 +33,8 @@ This serves two purposes:
     - Added method `Asset::exists()` has to check if a media file exists.
     - Added a `Hyde::assets()` method to get all media file instances in the site.
 - Added new `npm run build` command for compiling frontend assets with Vite
-- Added Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
+- Added a Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
+- Added Vite facade in https://github.com/hydephp/develop/pull/2016
 
 ### Changed
 

From e26941d9d9097ff318010d2970af956727a35213 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 16:02:27 +0100
Subject: [PATCH 3270/4023] Mark feature as experimental

---
 packages/framework/src/Console/Commands/ServeCommand.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 3c1e262acf4..c998aba44ce 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -207,6 +207,7 @@ protected function runViteProcess(): void
         $this->vite = Process::forever()->start('npm run dev');
     }
 
+    /** @experimental This feature may be removed before the final release. */
     protected function isPortAvailable(int $port): bool
     {
         $socket = @fsockopen('localhost', $port, $errno, $errstr, 1);

From 2a480c2350606f5c3e32df525f3991e1f5a9f6ea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 16:20:40 +0100
Subject: [PATCH 3271/4023] Add Vite HMR support for the app scripts

---
 packages/framework/resources/views/layouts/scripts.blade.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php
index 9e121211b45..8f2a93343e3 100644
--- a/packages/framework/resources/views/layouts/scripts.blade.php
+++ b/packages/framework/resources/views/layouts/scripts.blade.php
@@ -1,5 +1,7 @@
 {{-- The compiled Vite scripts --}}
-@if(Asset::exists('app.js'))
+@if(Vite::running())
+    {{ Vite::assets(['resources/assets/app.js']) }}
+@elseif(Asset::exists('app.js'))
     <script defer src="{{ Asset::get('app.js') }}"></script>
 @endif
 

From 313e60516fa01a7777acc1201a765363f90406ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 16:23:22 +0100
Subject: [PATCH 3272/4023] Update _ide_helper.php

---
 _ide_helper.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_ide_helper.php b/_ide_helper.php
index a838afac059..88203364b33 100644
--- a/_ide_helper.php
+++ b/_ide_helper.php
@@ -37,6 +37,7 @@ class Asset extends \Hyde\Facades\Asset {}
 class Author extends \Hyde\Facades\Author {}
 class Features extends \Hyde\Facades\Features {}
 class Config extends \Hyde\Facades\Config {}
+class Vite extends \Hyde\Facades\Vite {}
 /** @mixin \Illuminate\Filesystem\Filesystem */
 class Filesystem extends \Hyde\Facades\Filesystem {}
 class DataCollection extends \Hyde\Support\DataCollection {}

From 99d8cb1d3665107c730e7133b5dea4adbcbb7ef2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 20:47:23 +0100
Subject: [PATCH 3273/4023] Extract constant for the Vite plugin

---
 vite.config.js | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/vite.config.js b/vite.config.js
index f9b614b0816..3e7415a695a 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -9,6 +9,23 @@ import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
 
+const hydeVitePlugin = () => ({
+    name: 'hyde-vite',
+    configureServer(server) {
+        // Render the Vite index page when the root URL is requested
+        server.middlewares.use((req, res, next) => {
+            if (req.url === '/') {
+                res.end(fs.readFileSync(
+                    path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
+                    'utf-8'
+                ));
+            } else {
+                next();
+            }
+        });
+    }
+});
+
 export default defineConfig({
     server: {
         port: 5173,
@@ -18,23 +35,7 @@ export default defineConfig({
         },
         middlewareMode: false,
     },
-    plugins: [
-        {
-            name: 'hyde-vite-server',
-            configureServer(server) {
-                server.middlewares.use((req, res, next) => {
-                    if (req.url === '/') {
-                        res.end(fs.readFileSync(
-                            path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
-                            'utf-8'
-                        ));
-                    } else {
-                        next();
-                    }
-                });
-            },
-        },
-    ],
+    plugins: [hydeVitePlugin()],
     css: {
         postcss: {
             plugins: [

From cb56508034aaf11b52211bb4b3b0832990773b71 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 20:48:17 +0100
Subject: [PATCH 3274/4023] Add a "hot" file when the Vite server is running

---
 vite.config.js | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/vite.config.js b/vite.config.js
index 3e7415a695a..be2d06ed8d6 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -12,6 +12,14 @@ import path from 'path';
 const hydeVitePlugin = () => ({
     name: 'hyde-vite',
     configureServer(server) {
+        // Create hot file when Vite server starts
+        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
+
+        // Remove hot file when Vite server closes
+        server.httpServer?.on('close', () => {
+            fs.unlinkSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+        });
+
         // Render the Vite index page when the root URL is requested
         server.middlewares.use((req, res, next) => {
             if (req.url === '/') {

From b42adba8ab464c6a81fc895c17dc2ee48f6363d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 20:51:26 +0100
Subject: [PATCH 3275/4023] Replace slow socket call with hot file check

---
 packages/framework/src/Facades/Vite.php       | 15 ++-------------
 .../tests/Unit/Facades/ViteFacadeTest.php     | 19 +++++++++++++------
 2 files changed, 15 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index b778f928789..d93f60f742d 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -18,19 +18,8 @@ public static function running(): bool
             return true;
         }
 
-        // Check if Vite dev server is running by attempting to connect to it
-        // Todo: Improve performance on Windows (takes less than 1ms on macOS, but around 100ms on Windows)
-        set_error_handler(fn () => false); // Todo: This warning surpressor does not work on Windows
-        $server = fsockopen('localhost', 5173, $errno, $errstr, 0.1);
-        restore_error_handler();
-
-        if ($server) {
-            fclose($server);
-
-            return true;
-        }
-
-        return false;
+        // Check for Vite hot file
+        return Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
     public static function assets(array $paths): HtmlString
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index d056f0e3dc0..2219d319ceb 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -4,12 +4,22 @@
 
 use Hyde\Testing\UnitTestCase;
 use Hyde\Facades\Vite;
+use Hyde\Testing\CreatesTemporaryFiles;
 
 /**
  * @covers \Hyde\Facades\Vite
  */
 class ViteFacadeTest extends UnitTestCase
 {
+    use CreatesTemporaryFiles;
+
+    protected static bool $needsKernel = true;
+
+    protected function tearDown(): void
+    {
+        $this->cleanUpFilesystem();
+    }
+
     public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
     {
         putenv('HYDE_SERVER_VITE=enabled');
@@ -19,17 +29,14 @@ public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
         putenv('HYDE_SERVER_VITE');
     }
 
-    public function testRunningReturnsTrueWhenViteServerIsAccessible()
+    public function testRunningReturnsTrueWhenViteHotFileExists()
     {
-        // Create a mock server to simulate Vite
-        $server = stream_socket_server('tcp://localhost:5173');
+        $this->file('app/storage/framework/cache/vite.hot');
 
         $this->assertTrue(Vite::running());
-
-        stream_socket_shutdown($server, STREAM_SHUT_RDWR);
     }
 
-    public function testRunningReturnsFalseWhenViteServerIsNotAccessible()
+    public function testRunningReturnsFalseWhenViteHotFileDoesNotExist()
     {
         $this->assertFalse(Vite::running());
     }

From 301a8a981fdc1c40dba2888c51a68a5177362eca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 20:59:43 +0100
Subject: [PATCH 3276/4023] Remove hot file on Node signal interrupt

---
 vite.config.js | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/vite.config.js b/vite.config.js
index be2d06ed8d6..207f00860e6 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -16,8 +16,9 @@ const hydeVitePlugin = () => ({
         fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
 
         // Remove hot file when Vite server closes
-        server.httpServer?.on('close', () => {
-            fs.unlinkSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+        process.on('SIGINT', () => {
+            fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+            process.exit();
         });
 
         // Render the Vite index page when the root URL is requested

From 18ccd6b0f33d476f41f587db972d9cb770493ec6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 14 Nov 2024 21:15:35 +0100
Subject: [PATCH 3277/4023] Listen for signal termination as well

---
 vite.config.js | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/vite.config.js b/vite.config.js
index 207f00860e6..7e70d1dcae5 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -16,9 +16,11 @@ const hydeVitePlugin = () => ({
         fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
 
         // Remove hot file when Vite server closes
-        process.on('SIGINT', () => {
-            fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
-            process.exit();
+        ['SIGINT', 'SIGTERM'].forEach(signal => {
+            process.on(signal, () => {
+                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+                process.exit();
+            });
         });
 
         // Render the Vite index page when the root URL is requested

From 1b72c55b2969ffe55e8447d1db20b5473eb8327b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:10:46 +0100
Subject: [PATCH 3278/4023] Create HydeFront-v4-plan.md

---
 HydeFront-v4-plan.md | 79 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 HydeFront-v4-plan.md

diff --git a/HydeFront-v4-plan.md b/HydeFront-v4-plan.md
new file mode 100644
index 00000000000..ad69dc1fe6b
--- /dev/null
+++ b/HydeFront-v4-plan.md
@@ -0,0 +1,79 @@
+# HydeFront v4 Development Plan
+
+## Abstract
+
+We are updating how HydeFront is handled for v2. Instead of declaring styles directly in HydeFront alongside Tailwind, we will refactor those styles into Tailwind. 
+
+HydeFront will serve two main purposes:  
+
+1. It will continue to include the precompiled `app.css` file bundled with new apps, available through the HydeFront CDN.  
+2. It will act as a component library, allowing users to include granular styles from `app.css`, which we will preconfigure.  
+
+For example, users can include our Tailwind styles granularly using just the `app.css` file from the HydeFront package. This file will be compiled alongside Tailwind. If users prefer customization, they can remove the import and add the specific styles they want.  
+
+## Goals
+
+Based on the codebase, here's a detailed plan to refactor HydeFront:
+
+### Phase 1: Setup
+- [ ] Create new branch `feature/hydefront-v4`
+- [ ] Update HydeFront version to 4.0.0-dev in package.json
+- [ ] Create new directory structure in HydeFront:
+```
+src/
+  components/
+  presets/
+  app.css
+```
+
+### Phase 2: Component Migration
+- [ ] Audit current styles in hyde.scss (reference: `packages/hydefront/hyde.scss`)
+- [ ] Create individual Tailwind component files for:
+  - [ ] Documentation styles
+  - [ ] Search functionality
+  - [ ] Sidebar components
+  - [ ] Markdown typography
+  - [ ] Code blocks
+  - [ ] Blockquotes
+- [ ] Move Alpine.js utilities to separate component file
+
+### Phase 3: Preset Configuration
+- [ ] Create base preset that includes all current functionality
+- [ ] Create minimal preset with only core styles
+- [ ] Create documentation preset focused on docs-specific styles
+- [ ] Update the app.css compilation process to use presets
+
+### Phase 4: Build System Updates
+- [ ] Update Vite config to handle new component structure
+- [ ] Modify build scripts to:
+  - [ ] Compile individual components
+  - [ ] Generate preset bundles
+  - [ ] Create the main app.css bundle
+- [ ] Update the CDN distribution process
+
+### Phase 5: Framework Integration
+- [ ] Update Hyde Framework to support new HydeFront structure
+- [ ] Modify Asset facade to handle granular component loading
+- [ ] Update default Hyde project scaffold
+- [ ] Create migration guide for existing projects
+
+### Phase 6: Documentation
+- [ ] Document new component system
+- [ ] Create examples for common customization scenarios
+- [ ] Update HydeFront README
+- [ ] Add migration guide to Hyde docs
+
+### Phase 7: Testing & Release
+- [ ] Create test suite for components
+- [ ] Test backwards compatibility
+- [ ] Create release candidate
+- [ ] Update CDN infrastructure
+- [ ] Release v4.0.0
+
+### Phase 8: Cleanup
+- [ ] Remove deprecated files and methods
+- [ ] Update all references to old HydeFront structure
+- [ ] Archive v3 documentation
+- [ ] Update GitHub workflows
+
+This plan maintains backwards compatibility while introducing the new component system. The main app.css will still be available through CDN for existing projects.

From 27221248d67ac6490a8f2ec0c2f39f5ba097a138 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:12:51 +0100
Subject: [PATCH 3279/4023] Update HydeFront-v4-plan.md

---
 HydeFront-v4-plan.md | 166 ++++++++++++++++++++++++++-----------------
 1 file changed, 102 insertions(+), 64 deletions(-)

diff --git a/HydeFront-v4-plan.md b/HydeFront-v4-plan.md
index ad69dc1fe6b..cae5e99fee6 100644
--- a/HydeFront-v4-plan.md
+++ b/HydeFront-v4-plan.md
@@ -11,69 +11,107 @@ HydeFront will serve two main purposes:
 
 For example, users can include our Tailwind styles granularly using just the `app.css` file from the HydeFront package. This file will be compiled alongside Tailwind. If users prefer customization, they can remove the import and add the specific styles they want.  
 
-## Goals
-
-Based on the codebase, here's a detailed plan to refactor HydeFront:
-
-### Phase 1: Setup
-- [ ] Create new branch `feature/hydefront-v4`
-- [ ] Update HydeFront version to 4.0.0-dev in package.json
-- [ ] Create new directory structure in HydeFront:
-```
-src/
-  components/
-  presets/
-  app.css
+## Refactoring Plan
+
+### 1. Restructure HydeFront Package
+- Create a new directory structure in HydeFront:
+  ```
+  hydefront/
+  ├── dist/
+  │   └── app.css       # Pre-compiled styles for CDN
+  ├── components/       # New component-based structure
+  │   ├── base/        # Base styles
+  │   ├── docs/        # Documentation styles
+  │   ├── markdown/    # Markdown styles
+  │   └── utilities/   # Utility styles
+  └── package.json
+  ```
+
+### 2. Convert SCSS to Tailwind Components
+- Convert existing SCSS styles from `hyde.scss` (reference: `packages/hydefront/hyde.scss`) into Tailwind components
+- Create separate files for each component category that can be imported individually
+- Example component structure:
+  ```javascript
+  // components/docs.js
+  module.exports = {
+    '.docs-sidebar': {
+      '@apply ...': {},
+    }
+  }
+  ```
+
+### 3. Update Build Process
+- Modify the Vite configuration (reference: `vite.config.js`) to handle component-based builds
+- Update the build scripts in package.json to:
+  - Build individual components
+  - Generate the complete app.css for CDN distribution
+  - Add new script for component-based builds
+
+### 4. Update Framework Integration
+Key files to modify:
+
+```blade
+// packages/framework/resources/views/layouts/styles.blade.php
+{{-- Prevent Alpine.js flashes --}}
+<style>[x-cloak] {display: none!important}</style>
+
+{{-- The compiled Tailwind/App styles --}}
+@if(Vite::running())
+    {{ Vite::assets(['resources/assets/app.css']) }}
+@else
+    @if(config('hyde.load_app_styles_from_cdn', false))
+        <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
+    @elseif(Asset::exists('app.css'))
+        <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
+    @endif
+
+
+    {{-- Dynamic TailwindCSS Play CDN --}}
+    @if(config('hyde.use_play_cdn', false))
+        <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
+        <script>tailwind.config = { {!! HydeFront::injectTailwindConfig() !!} }</script>
+        <script>console.warn('The HydePHP TailwindCSS Play CDN is enabled. This is for development purposes only and should not be used in production.', 'See https://hydephp.com/docs/1.x/managing-assets');</script>
+    @endif
+@endif
+
+{{-- Add any extra styles to include after the others --}}
+@stack('styles')
 ```
 
-### Phase 2: Component Migration
-- [ ] Audit current styles in hyde.scss (reference: `packages/hydefront/hyde.scss`)
-- [ ] Create individual Tailwind component files for:
-  - [ ] Documentation styles
-  - [ ] Search functionality
-  - [ ] Sidebar components
-  - [ ] Markdown typography
-  - [ ] Code blocks
-  - [ ] Blockquotes
-- [ ] Move Alpine.js utilities to separate component file
-
-### Phase 3: Preset Configuration
-- [ ] Create base preset that includes all current functionality
-- [ ] Create minimal preset with only core styles
-- [ ] Create documentation preset focused on docs-specific styles
-- [ ] Update the app.css compilation process to use presets
-
-### Phase 4: Build System Updates
-- [ ] Update Vite config to handle new component structure
-- [ ] Modify build scripts to:
-  - [ ] Compile individual components
-  - [ ] Generate preset bundles
-  - [ ] Create the main app.css bundle
-- [ ] Update the CDN distribution process
-
-### Phase 5: Framework Integration
-- [ ] Update Hyde Framework to support new HydeFront structure
-- [ ] Modify Asset facade to handle granular component loading
-- [ ] Update default Hyde project scaffold
-- [ ] Create migration guide for existing projects
-
-### Phase 6: Documentation
-- [ ] Document new component system
-- [ ] Create examples for common customization scenarios
-- [ ] Update HydeFront README
-- [ ] Add migration guide to Hyde docs
-
-### Phase 7: Testing & Release
-- [ ] Create test suite for components
-- [ ] Test backwards compatibility
-- [ ] Create release candidate
-- [ ] Update CDN infrastructure
-- [ ] Release v4.0.0
-
-### Phase 8: Cleanup
-- [ ] Remove deprecated files and methods
-- [ ] Update all references to old HydeFront structure
-- [ ] Archive v3 documentation
-- [ ] Update GitHub workflows
-
-This plan maintains backwards compatibility while introducing the new component system. The main app.css will still be available through CDN for existing projects.
+
+### 5. Documentation Updates
+- Update the asset management documentation
+- Create new documentation for component-based usage
+- Update the HydeFront README (reference: `packages/hydefront/README.md`)
+
+### 6. Migration Path
+1. Create a new major version branch
+2. Keep existing functionality working while adding new component system
+3. Provide migration guide for users moving from v1 to v2
+4. Update the Hyde starter template to use new component system
+
+### 7. Configuration Updates
+- Update the Hyde configuration (reference: `config/hyde.php`) to support component-based imports
+- Add new configuration options for granular style inclusion
+
+### 8. Testing Strategy
+1. Create tests for individual components
+2. Test CDN distribution
+3. Test backward compatibility layer
+4. Test integration with Hyde framework
+
+### 9. Implementation Phases
+1. **Phase 1**: Create new component structure
+2. **Phase 2**: Convert existing styles
+3. **Phase 3**: Update build system
+4. **Phase 4**: Update framework integration
+5. **Phase 5**: Documentation and migration guide
+6. **Phase 6**: Testing and refinement
+
+### 10. Breaking Changes to Document
+- New import syntax for granular components
+- Changes to configuration structure
+- Updates to asset compilation process
+- CDN usage changes
+
+This plan maintains backward compatibility through the CDN while providing a more flexible component-based approach for customization. The changes align with modern frontend practices while keeping Hyde's simplicity.

From 1fbae9551c9df6f7a22990e9fac1391a56bb86ee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:01:52 +0100
Subject: [PATCH 3280/4023] Remove x-cloak style from app CSS as we have it in
 the head HTML

---
 resources/assets/app.css | 2 --
 1 file changed, 2 deletions(-)

diff --git a/resources/assets/app.css b/resources/assets/app.css
index dc24361dfc1..84c2e0cd551 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -16,5 +16,3 @@
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
-
-[x-cloak] { display: none !important; }

From 7fa3711dbbac66c81f78e333559f5f55de1def0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:17:25 +0100
Subject: [PATCH 3281/4023] Track changes made

---
 HydeFront-v4-plan.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/HydeFront-v4-plan.md b/HydeFront-v4-plan.md
index cae5e99fee6..0a0e2d0960c 100644
--- a/HydeFront-v4-plan.md
+++ b/HydeFront-v4-plan.md
@@ -115,3 +115,9 @@ Key files to modify:
 - CDN usage changes
 
 This plan maintains backward compatibility through the CDN while providing a more flexible component-based approach for customization. The changes align with modern frontend practices while keeping Hyde's simplicity.
+
+## Changes Made:
+
+Lists all the changes made to the codebase to implement the new component system in order to make the changelog later on, and to keep track of the changes.
+
+- Remove x-cloak style from app CSS as we have it in the head HTML

From 7704dcabbf4c1f40a6ab9f754c3d89484c1316c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 19:42:49 +0100
Subject: [PATCH 3282/4023] Revert "Track changes made"

This reverts commit 7fa3711dbbac66c81f78e333559f5f55de1def0a.
---
 HydeFront-v4-plan.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/HydeFront-v4-plan.md b/HydeFront-v4-plan.md
index 0a0e2d0960c..cae5e99fee6 100644
--- a/HydeFront-v4-plan.md
+++ b/HydeFront-v4-plan.md
@@ -115,9 +115,3 @@ Key files to modify:
 - CDN usage changes
 
 This plan maintains backward compatibility through the CDN while providing a more flexible component-based approach for customization. The changes align with modern frontend practices while keeping Hyde's simplicity.
-
-## Changes Made:
-
-Lists all the changes made to the codebase to implement the new component system in order to make the changelog later on, and to keep track of the changes.
-
-- Remove x-cloak style from app CSS as we have it in the head HTML

From 65943c4ab6703d8eefd69cc350629655862c2a3a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:34:34 +0100
Subject: [PATCH 3283/4023] Replace `x-uncloak-md` class with pure Tailwind

---
 .../framework/resources/views/layouts/navigation.blade.php   | 5 +++--
 packages/hydefront/sass/utilities/alpine.scss                | 3 ---
 2 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 452e53d62fb..5c29a8871e7 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -32,8 +32,9 @@
         </button>
     </div>
 
-    <div id="main-navigation-links" class="w-full x-uncloak-md md:flex flex-grow md:flex-grow-0 md:items-center md:w-auto px-6 -mx-4 border-t mt-3 pt-3 md:border-none md:mt-0 md:py-0 border-gray-200 dark:border-gray-700"
-         :class="navigationOpen ? '' : 'hidden'" x-cloak>
+    <div id="main-navigation-links" 
+         class="w-full hidden md:flex flex-grow md:flex-grow-0 md:items-center md:w-auto px-6 -mx-4 border-t mt-3 pt-3 md:border-none md:mt-0 md:py-0 border-gray-200 dark:border-gray-700"
+         :class="navigationOpen ? '!block' : ''">
         <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
diff --git a/packages/hydefront/sass/utilities/alpine.scss b/packages/hydefront/sass/utilities/alpine.scss
index 11b2deaaa58..e69de29bb2d 100644
--- a/packages/hydefront/sass/utilities/alpine.scss
+++ b/packages/hydefront/sass/utilities/alpine.scss
@@ -1,3 +0,0 @@
-@media screen and (min-width: 768px) {
-	[x-cloak].x-uncloak-md { display: revert !important; }
-}

From bb3324e374dcd38f6845ebd50838b48256e48c82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 11:35:44 +0100
Subject: [PATCH 3284/4023] Remove now empty `alpine.scss` file

---
 packages/hydefront/hyde.scss                  | 1 -
 packages/hydefront/sass/utilities/alpine.scss | 0
 2 files changed, 1 deletion(-)
 delete mode 100644 packages/hydefront/sass/utilities/alpine.scss

diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
index 0d39c9b6d6f..c268635823f 100644
--- a/packages/hydefront/hyde.scss
+++ b/packages/hydefront/hyde.scss
@@ -10,5 +10,4 @@
 @use 'sass/markdown/torchlight';
 @use 'sass/markdown/blockquotes';
 @use 'sass/markdown/codeblocks';
-@use 'sass/utilities/alpine';
 @use 'sass/patches/typography';
diff --git a/packages/hydefront/sass/utilities/alpine.scss b/packages/hydefront/sass/utilities/alpine.scss
deleted file mode 100644
index e69de29bb2d..00000000000

From 1ee06c47b52bfa1104a58213a121f3624a2a70c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 19:40:55 +0100
Subject: [PATCH 3285/4023] Replace the sidebar toggle styles with pure
 Tailwind

---
 .../docs/sidebar-toggle-button.blade.php        | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
index addcf442ee6..b9fe4309ca5 100644
--- a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
@@ -1,6 +1,13 @@
-<button id="sidebar-toggle" title="Toggle sidebar" aria-label="Toggle sidebar navigation menu" @click="sidebarOpen = ! sidebarOpen" :class="{'active' : sidebarOpen}">
-    <span class="icon-bar dark:bg-white h-0" role="presentation"></span>
-    <span class="icon-bar dark:bg-white h-0" role="presentation"></span>
-    <span class="icon-bar dark:bg-white h-0" role="presentation"></span>
-    <span class="icon-bar dark:bg-white h-0" role="presentation"></span>
+<button 
+    id="sidebar-toggle" 
+    title="Toggle sidebar" 
+    aria-label="Toggle sidebar navigation menu" 
+    @click="sidebarOpen = ! sidebarOpen" 
+    :class="{'[&>span:first-child]:opacity-0 [&>span:nth-child(2)]:rotate-45 [&>span:nth-child(3)]:-rotate-45 [&>span:last-child]:opacity-0': sidebarOpen}"
+    class="relative inline-block w-8 h-8"
+>
+    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[9px] transition-all duration-300 ease-out" role="presentation"></span>
+    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[15px] transition-all duration-300 ease-out origin-center" role="presentation"></span>
+    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[15px] transition-all duration-300 ease-out origin-center" role="presentation"></span>
+    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[21px] transition-all duration-300 ease-out" role="presentation"></span>
 </button>
\ No newline at end of file

From 68e9fa75e3a4b1e16a7c3715c5b777c7ddf4c502 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 19:42:16 +0100
Subject: [PATCH 3286/4023] Remove now empty `sidebar-toggle.scss` file

---
 .../hydefront/sass/docs/sidebar-toggle.scss   | 56 -------------------
 packages/hydefront/sass/hyde-docs.scss        |  1 -
 2 files changed, 57 deletions(-)
 delete mode 100644 packages/hydefront/sass/docs/sidebar-toggle.scss

diff --git a/packages/hydefront/sass/docs/sidebar-toggle.scss b/packages/hydefront/sass/docs/sidebar-toggle.scss
deleted file mode 100644
index bf978b4cfaa..00000000000
--- a/packages/hydefront/sass/docs/sidebar-toggle.scss
+++ /dev/null
@@ -1,56 +0,0 @@
-#sidebar-toggle {
-	position: relative;
-	display: inline-block;
-	width: 2rem;
-	height: 2rem;
-
-	span.icon-bar {
-		display: block;
-		width: 20px;
-		height: 2.375px;
-		background-color: black;
-		position: absolute;
-		left: 5.5px;
-
-		&:first-child {
-			top: 9px;
-		}
-
-		&:nth-child(2),
-		&:nth-child(3) {
-			top: calc(9px + 6px);
-			transform-origin: center;
-		}
-
-		&:last-child {
-			top: calc(9px + 12px);
-		}
-
-		transition: all 0.3s ease-out;
-	}
-
-	&.active {
-		span.icon-bar {
-			&:first-child {
-				opacity: 0;
-			}
-
-			&:nth-child(2) {
-				transform: rotate(45deg);
-			}
-
-			&:nth-child(3) {
-				transform: rotate(-45deg);
-			}
-
-			&:last-child {
-				opacity: 0;
-			}
-		}
-	}
-}
-
-.dark #sidebar-toggle span.icon-bar {
-	background-color: invert($color: #000);
-	height: 2px;
-}
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
index 2641ec3595c..c61c6ef256d 100644
--- a/packages/hydefront/sass/hyde-docs.scss
+++ b/packages/hydefront/sass/hyde-docs.scss
@@ -3,7 +3,6 @@
  */
 
 @use 'docs/search';
-@use 'docs/sidebar-toggle';
 @use 'docs/table-of-contents';
 @use 'docs/heading-permalinks';
 

From 0e435902d6856defa017d35dc4528aa7da12fea4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 20:07:45 +0100
Subject: [PATCH 3287/4023] Tweak sidebar toggle styles to blend in better

---
 .../components/docs/sidebar-toggle-button.blade.php    | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
index b9fe4309ca5..f140bba1527 100644
--- a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
@@ -4,10 +4,10 @@
     aria-label="Toggle sidebar navigation menu" 
     @click="sidebarOpen = ! sidebarOpen" 
     :class="{'[&>span:first-child]:opacity-0 [&>span:nth-child(2)]:rotate-45 [&>span:nth-child(3)]:-rotate-45 [&>span:last-child]:opacity-0': sidebarOpen}"
-    class="relative inline-block w-8 h-8"
+    class="relative inline-block w-8 h-8 hover:text-gray-700 dark:text-gray-200"
 >
-    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[9px] transition-all duration-300 ease-out" role="presentation"></span>
-    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[15px] transition-all duration-300 ease-out origin-center" role="presentation"></span>
-    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[15px] transition-all duration-300 ease-out origin-center" role="presentation"></span>
-    <span class="block w-5 h-[2.375px] bg-black dark:bg-white absolute left-[5.5px] top-[21px] transition-all duration-300 ease-out" role="presentation"></span>
+    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-1 transition-all duration-300 ease-out" role="presentation"></span>
+    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-2.5 transition-all duration-300 ease-out origin-center" role="presentation"></span>
+    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-2.5 transition-all duration-300 ease-out origin-center" role="presentation"></span>
+    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-4 transition-all duration-300 ease-out" role="presentation"></span>
 </button>
\ No newline at end of file

From c42d8fe9c11d68f809c501883262cb74567d5ffd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 20:34:19 +0100
Subject: [PATCH 3288/4023] Fix build command

---
 .github/workflows/continuous-integration.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml
index 8bdcf5cc068..93bc0135e7b 100644
--- a/.github/workflows/continuous-integration.yml
+++ b/.github/workflows/continuous-integration.yml
@@ -128,7 +128,7 @@ jobs:
 
       - name: Build assets for production
         working-directory: 'packages/hydefront'
-        run: npm run build
+        run: npm run prod
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4

From 92c4d11f73dec5082f944fea20af03eec5f3da19 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 20:25:28 +0100
Subject: [PATCH 3289/4023] Recreate improved sidebar toggle button

---
 _media/app.css                                |  2 +-
 .../docs/sidebar-toggle-button.blade.php      | 19 ++++++++++---------
 packages/hydefront/dist/hyde.css              |  2 +-
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index cb39212aa25..c5bc4055258 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0{height:0px}.h-1{height:.25rem}.h-16{height:4rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}[x-cloak]{display:none!important}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity))}.dark\:bg-white:is(.dark *){--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
index f140bba1527..c07f5c353c1 100644
--- a/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-toggle-button.blade.php
@@ -1,13 +1,14 @@
 <button 
     id="sidebar-toggle" 
     title="Toggle sidebar" 
-    aria-label="Toggle sidebar navigation menu" 
-    @click="sidebarOpen = ! sidebarOpen" 
-    :class="{'[&>span:first-child]:opacity-0 [&>span:nth-child(2)]:rotate-45 [&>span:nth-child(3)]:-rotate-45 [&>span:last-child]:opacity-0': sidebarOpen}"
-    class="relative inline-block w-8 h-8 hover:text-gray-700 dark:text-gray-200"
->
-    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-1 transition-all duration-300 ease-out" role="presentation"></span>
-    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-2.5 transition-all duration-300 ease-out origin-center" role="presentation"></span>
-    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-2.5 transition-all duration-300 ease-out origin-center" role="presentation"></span>
-    <span class="block w-5 h-0.5 bg-current absolute left-1.5 top-4 transition-all duration-300 ease-out" role="presentation"></span>
+    aria-label="Toggle sidebar navigation menu"
+    @click="sidebarOpen = !sidebarOpen"
+    class="flex items-center justify-center w-8 h-8 px-2 py-1 hover:text-gray-700 dark:text-gray-200 opacity-75 hover:opacity-100"
+  >
+    <div class="relative w-5 h-4">
+        <div class="absolute top-0 w-5 h-0.5 bg-current transition-all duration-300 ease-in-out" :class="sidebarOpen ? 'opacity-0' : ''"></div>
+        <div class="absolute inset-0 my-auto w-5 h-0.5 bg-current transition-all duration-300 ease-in-out origin-center" :class="sidebarOpen ? 'rotate-45' : ''"></div>
+        <div class="absolute inset-0 my-auto w-5 h-0.5 bg-current transition-all duration-300 ease-in-out origin-center" :class="sidebarOpen ? '-rotate-45' : ''"></div>
+        <div class="absolute bottom-0 w-5 h-0.5 bg-current transition-all duration-300 ease-in-out" :class="sidebarOpen ? 'opacity-0' : ''"></div>
+    </div>
 </button>
\ No newline at end of file
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index 5b2f81bdc4e..5a8c2dbb1cd 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/
-.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a::before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:rgba(128,128,128,.2)}.table-of-contents a:hover::before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink::before,#hyde-docs .prose h2 .heading-permalink::before,#hyde-docs .prose h3 .heading-permalink::before,#hyde-docs .prose h4 .heading-permalink::before,#hyde-docs .prose h5 .heading-permalink::before,#hyde-docs .prose h6 .heading-permalink::before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert !important}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
+.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a::before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:rgba(128,128,128,.2)}.table-of-contents a:hover::before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink::before,#hyde-docs .prose h2 .heading-permalink::before,#hyde-docs .prose h3 .heading-permalink::before,#hyde-docs .prose h4 .heading-permalink::before,#hyde-docs .prose h5 .heading-permalink::before,#hyde-docs .prose h6 .heading-permalink::before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */

From 712cf950d2fb4ad75a2e7fba9b76e23e76700efd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 15 Nov 2024 20:43:26 +0100
Subject: [PATCH 3290/4023] Define table of contents styles with Tailwind

---
 _media/app.css                                |  2 +-
 packages/hydefront/dist/hyde.css              |  2 +-
 packages/hydefront/dist/hyde.css.map          |  2 +-
 .../sass/docs/table-of-contents.scss          | 38 -------------------
 packages/hydefront/sass/hyde-docs.scss        |  1 -
 resources/assets/app.css                      | 24 ++++++++++++
 6 files changed, 27 insertions(+), 42 deletions(-)
 delete mode 100644 packages/hydefront/sass/docs/table-of-contents.scss

diff --git a/_media/app.css b/_media/app.css
index c5bc4055258..5452be81079 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index 5a8c2dbb1cd..fbd83e7bba0 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/
-.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a::before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:rgba(128,128,128,.2)}.table-of-contents a:hover::before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink::before,#hyde-docs .prose h2 .heading-permalink::before,#hyde-docs .prose h3 .heading-permalink::before,#hyde-docs .prose h4 .heading-permalink::before,#hyde-docs .prose h5 .heading-permalink::before,#hyde-docs .prose h6 .heading-permalink::before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
+.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink::before,#hyde-docs .prose h2 .heading-permalink::before,#hyde-docs .prose h3 .heading-permalink::before,#hyde-docs .prose h4 .heading-permalink::before,#hyde-docs .prose h5 .heading-permalink::before,#hyde-docs .prose h6 .heading-permalink::before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index eff9c6355e7..42c4ae90384 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/docs/search.scss","../sass/docs/sidebar-toggle.scss","../sass/docs/table-of-contents.scss","../sass/docs/heading-permalinks.scss","../sass/hyde-docs.scss","../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/utilities/alpine.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAAA,qBACC,mBAGD,qBACC,gBACA,gBACA,kBAGD,eACC,aCXD,gBACC,kBACA,qBACA,WACA,YAEA,8BACC,cACA,WACA,eACA,sBACA,kBACA,WAgBA,4BAdA,0CACC,QAGD,sFAEC,SACA,wBAGD,yCACC,SAQA,iDACC,UAGD,kDACC,wBAGD,kDACC,yBAGD,gDACC,UAMJ,oCACC,sBACA,WCtDD,mBACC,sBAEA,sBACC,kBACA,qBAGD,sBACC,mBAGD,qBACC,cACA,kBACA,kBACA,aAEA,6BACC,YACA,cACA,WACA,iBACA,mCAGD,2BAKC,UACA,8CAEA,sCAPA,mCACC,UC1BF,8HACC,kBAGC,wiBACC,YACA,uBACA,gCAIF,gPACC,UACA,mBACA,4BACA,iBACA,mBACA,gSACC,YAED,wiBACC,UACA,aCfL,KACC,+CCCG,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCpCF,qCACC,4HCCC","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/docs/search.scss","../sass/docs/heading-permalinks.scss","../sass/hyde-docs.scss","../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAAA,qBACC,mBAGD,qBACC,gBACA,gBACA,kBAGD,eACC,aCTC,8HACC,kBAGC,wiBACC,YACA,uBACA,gCAIF,gPACC,UACA,mBACA,4BACA,iBACA,mBACA,gSACC,YAED,wiBACC,UACA,aCjBL,KACC,uBCEC,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCnCF,0EACE","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/sass/docs/table-of-contents.scss b/packages/hydefront/sass/docs/table-of-contents.scss
deleted file mode 100644
index b54c72c5e55..00000000000
--- a/packages/hydefront/sass/docs/table-of-contents.scss
+++ /dev/null
@@ -1,38 +0,0 @@
-.table-of-contents {
-	padding-bottom: 0.75rem;
-
-	>li {
-		margin-top: 0.15rem;
-		margin-bottom: 0.35rem;
-	}
-
-	ul {
-		padding-left: 0.5rem;
-	}
-
-	a {
-		display: block;
-		padding-left: 2rem;
-		margin-left: -2rem;
-		opacity: 0.825;
-
-		&::before {
-			content: "#";
-			font-size: 75%;
-			opacity: 0.5;
-			margin-right: 4px;
-			transition: opacity 0.3s ease-in-out;
-		}
-
-		&:hover {
-			&::before {
-				opacity: 1;
-			}
-
-			opacity: 1;
-			transition: opacity,
-			background 0.3s ease-in-out;
-			background-color: rgba(128, 128, 128, 20%);
-		}
-	}
-}
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
index c61c6ef256d..4baa4dcc133 100644
--- a/packages/hydefront/sass/hyde-docs.scss
+++ b/packages/hydefront/sass/hyde-docs.scss
@@ -3,7 +3,6 @@
  */
 
 @use 'docs/search';
-@use 'docs/table-of-contents';
 @use 'docs/heading-permalinks';
 
 html {
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 84c2e0cd551..88fedbca2bd 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -16,3 +16,27 @@
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
+
+.table-of-contents {
+    @apply pb-3;
+}
+
+.table-of-contents > li {
+    @apply my-[0.35rem];
+}
+
+.table-of-contents ul {
+    @apply pl-2;
+}
+
+.table-of-contents a {
+    @apply block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative;
+}
+
+.table-of-contents a::before {
+    @apply content-['#'] text-[75%] opacity-50 mr-1 transition-opacity duration-300;
+}
+
+.table-of-contents a:hover::before {
+    @apply opacity-100;
+}

From 48bdd88ae9f95885d2c4bf0d971cf02413018c7d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:01:42 +0100
Subject: [PATCH 3291/4023] Define heading permalink styles with Tailwind

---
 _media/app.css                                |  2 +-
 packages/hydefront/dist/hyde.css              |  2 +-
 packages/hydefront/dist/hyde.css.map          |  2 +-
 .../sass/docs/heading-permalinks.scss         | 30 -------------------
 packages/hydefront/sass/hyde-docs.scss        |  1 -
 resources/assets/app.css                      | 25 ++++++++++++++++
 6 files changed, 28 insertions(+), 34 deletions(-)
 delete mode 100644 packages/hydefront/sass/docs/heading-permalinks.scss

diff --git a/_media/app.css b/_media/app.css
index 5452be81079..bcd52183f38 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index fbd83e7bba0..3f3046b20e1 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/
-.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink::before,#hyde-docs .prose h2 .heading-permalink::before,#hyde-docs .prose h3 .heading-permalink::before,#hyde-docs .prose h4 .heading-permalink::before,#hyde-docs .prose h5 .heading-permalink::before,#hyde-docs .prose h6 .heading-permalink::before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
+.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index 42c4ae90384..a077d60ec13 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/docs/search.scss","../sass/docs/heading-permalinks.scss","../sass/hyde-docs.scss","../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAAA,qBACC,mBAGD,qBACC,gBACA,gBACA,kBAGD,eACC,aCTC,8HACC,kBAGC,wiBACC,YACA,uBACA,gCAIF,gPACC,UACA,mBACA,4BACA,iBACA,mBACA,gSACC,YAED,wiBACC,UACA,aCjBL,KACC,uBCEC,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCnCF,0EACE","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/docs/search.scss","../sass/hyde-docs.scss","../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAAA,qBACC,mBAGD,qBACC,gBACA,gBACA,kBAGD,eACC,aCJD,KACC,uBCEC,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCnCF,0EACE","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/sass/docs/heading-permalinks.scss b/packages/hydefront/sass/docs/heading-permalinks.scss
deleted file mode 100644
index 9c1566c4682..00000000000
--- a/packages/hydefront/sass/docs/heading-permalinks.scss
+++ /dev/null
@@ -1,30 +0,0 @@
-#hyde-docs {
-	.prose {
-		h1, h2, h3, h4, h5, h6 {
-			width: fit-content;
-
-			&:hover, &:focus {
-				.heading-permalink {
-					opacity: 0.75;
-					filter: grayscale(100%);
-					transition: opacity 0.1s ease-out;
-				}
-			}
-
-			.heading-permalink {
-				opacity: 0;
-				margin-left: 0.25rem;
-				transition: opacity 0.3s ease;
-				padding: 0 0.25rem;
-				scroll-margin: 1rem;
-				&::before {
-					content: '#';
-				}
-				&:hover, &:focus {
-					opacity: 1;
-					filter: unset;
-				}
-			}
-		}
-	}
-}
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
index 4baa4dcc133..8396d330a41 100644
--- a/packages/hydefront/sass/hyde-docs.scss
+++ b/packages/hydefront/sass/hyde-docs.scss
@@ -3,7 +3,6 @@
  */
 
 @use 'docs/search';
-@use 'docs/heading-permalinks';
 
 html {
 	scroll-behavior: smooth;
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 88fedbca2bd..8253dd13dc8 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -40,3 +40,28 @@
 .table-of-contents a:hover::before {
     @apply opacity-100;
 }
+
+/**
+ * Heading Permalinks
+ */
+
+.prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {
+    @apply w-fit;
+}
+
+.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,
+.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink {
+    @apply opacity-75 grayscale transition-opacity duration-100 ease-out;
+}
+
+.heading-permalink {
+    @apply opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 scroll-m-4;
+}
+
+.heading-permalink::before {
+    @apply content-['#'];
+}
+
+.heading-permalink:hover, .heading-permalink:focus {
+    @apply opacity-100 grayscale-0;
+}

From c6dc8bdb920fdcbc935f07ccf92cf18065b81f84 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:22:41 +0100
Subject: [PATCH 3292/4023] Update code comments

---
 resources/assets/app.css | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/resources/assets/app.css b/resources/assets/app.css
index 8253dd13dc8..b00a99e8679 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -17,6 +17,10 @@
 @tailwind components;
 @tailwind utilities;
 
+/**
+ * Documentation Pages - Table of Contents
+ */
+
 .table-of-contents {
     @apply pb-3;
 }
@@ -42,7 +46,7 @@
 }
 
 /**
- * Heading Permalinks
+ * Documentation Pages - Heading Permalinks
  */
 
 .prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {

From 4569a48b3b1cb490daf8b4ea8348ed2aeb938976 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:25:08 +0100
Subject: [PATCH 3293/4023] Only compile `app.js` if it has contents

---
 vite.config.js | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/vite.config.js b/vite.config.js
index 7e70d1dcae5..b06ea97180d 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -37,6 +37,13 @@ const hydeVitePlugin = () => ({
     }
 });
 
+const hasJavaScriptContent = () => {
+    const appJsPath = resolve(__dirname, 'resources/assets/app.js');
+    if (!fs.existsSync(appJsPath)) return false;
+    const content = fs.readFileSync(appJsPath, 'utf-8');
+    return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
+};
+
 export default defineConfig({
     server: {
         port: 5173,
@@ -60,7 +67,7 @@ export default defineConfig({
         emptyOutDir: false,
         rollupOptions: {
             input: [
-                resolve(__dirname, 'resources/assets/app.js'),
+                ...(hasJavaScriptContent() ? [resolve(__dirname, 'resources/assets/app.js')] : []),
                 resolve(__dirname, 'resources/assets/app.css')
             ],
             output: {

From 64b33c54864d897cdd7ea6a96bd6f733038919ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:30:21 +0100
Subject: [PATCH 3294/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 802e893e7f2..92540b521f0 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -123,6 +123,7 @@ This serves two purposes:
 ### Fixed
 
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
+- The `app.js` file will now only be compiled if it has scripts in https://github.com/hydephp/develop/pull/2028
 
 ### Security
 

From c9db18c66cffaecb4d0823c68317cb5e554d0675 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:44:50 +0100
Subject: [PATCH 3295/4023] Begin recreating the HydeSearch plugin with Alpine

---
 .../components/docs/search-input.blade.php    | 40 ++++++++++-
 .../components/docs/search-scripts.blade.php  | 72 +++++++++++++++++--
 2 files changed, 105 insertions(+), 7 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 55ba20460bd..7f447ffd60c 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -1,6 +1,42 @@
-<div id="hyde-search">
+<div id="hyde-search" x-data="hydeSearch">
     <noscript>
         The search feature requires JavaScript to be enabled in your browser.
     </noscript>
-    <input {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }} type="search" name="search" id="search-input" placeholder="Search..." autocomplete="off" autofocus>
+    
+    <div class="relative">
+        <input 
+            {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
+            type="search" 
+            name="search" 
+            id="search-input"
+            x-model="searchTerm"
+            @input.debounce.250ms="search()"
+            placeholder="Search..." 
+            autocomplete="off" 
+            autofocus
+        >
+        
+        <div x-show="isLoading" class="absolute right-3 top-2.5">
+            <div class="animate-spin h-5 w-5 border-2 border-gray-500 rounded-full border-t-transparent"></div>
+        </div>
+    </div>
+
+    <div x-show="searchTerm" class="mt-4">
+        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
+        
+        <dl class="space-y-4 max-h-[60vh] overflow-y-auto">
+            <template x-for="result in results" :key="result.slug">
+                <div>
+                    <dt class="font-medium">
+                        <a :href="result.destination" 
+                           x-text="result.title"
+                           class="text-blue-600 dark:text-blue-400 hover:underline"></a>
+                        <span class="text-sm text-gray-600 dark:text-gray-400" 
+                              x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
+                    </dt>
+                    <dd class="mt-1 text-sm text-gray-600 dark:text-gray-400" x-html="result.context"></dd>
+                </div>
+            </template>
+        </dl>
+    </div>
 </div>
\ No newline at end of file
diff --git a/packages/framework/resources/views/components/docs/search-scripts.blade.php b/packages/framework/resources/views/components/docs/search-scripts.blade.php
index 6da5968e532..425df75d61c 100644
--- a/packages/framework/resources/views/components/docs/search-scripts.blade.php
+++ b/packages/framework/resources/views/components/docs/search-scripts.blade.php
@@ -1,9 +1,71 @@
-<script src="https://cdn.jsdelivr.net/npm/hydesearch@0.2.1/dist/HydeSearch.min.js" defer></script>
 <script>
-    window.addEventListener('load', function () {
-        const searchIndexLocation = '{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}';
-        const Search = new HydeSearch(searchIndexLocation);
+    document.addEventListener('alpine:init', () => {
+        Alpine.data('hydeSearch', () => ({
+            searchIndex: [],
+            searchTerm: '',
+            results: [],
+            isLoading: true,
+            statusMessage: '',
+            
+            async init() {
+                const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
+                if (!response.ok) {
+                    console.error('Could not load search index');
+                    return;
+                }
+                this.searchIndex = await response.json();
+                this.isLoading = false;
+            },
 
-        Search.init();
+            search() {
+                const startTime = performance.now();
+                this.results = [];
+                
+                if (!this.searchTerm) {
+                    this.statusMessage = '';
+                    return;
+                }
+
+                const searchResults = this.searchIndex.filter(entry => 
+                    entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
+                    entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
+                );
+
+                if (searchResults.length === 0) {
+                    this.statusMessage = 'No results found.';
+                    return;
+                }
+
+                const totalMatches = searchResults.reduce((acc, result) => {
+                    return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                }, 0);
+
+                searchResults.sort((a, b) => {
+                    return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
+                        - (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                });
+
+                this.results = searchResults.map(result => {
+                    const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                    const context = this.getSearchContext(result.content);
+                    return { ...result, matches, context };
+                });
+
+                const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
+                this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
+            },
+
+            getSearchContext(content) {
+                const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
+                const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
+                const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
+                const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+                
+                return sentence.replace(
+                    new RegExp(this.searchTerm, 'gi'),
+                    match => `<mark class="bg-yellow-200 dark:bg-yellow-800">${match}</mark>`
+                );
+            }
+        }));
     });
 </script>
\ No newline at end of file

From 4772fd1a1583fcc19de7cade534519619037b8a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 12:50:04 +0100
Subject: [PATCH 3296/4023] Delete now unused `search.scss` file

---
 packages/hydefront/sass/docs/search.scss | 13 -------------
 packages/hydefront/sass/hyde-docs.scss   |  2 --
 2 files changed, 15 deletions(-)
 delete mode 100644 packages/hydefront/sass/docs/search.scss

diff --git a/packages/hydefront/sass/docs/search.scss b/packages/hydefront/sass/docs/search.scss
deleted file mode 100644
index 828445cf523..00000000000
--- a/packages/hydefront/sass/docs/search.scss
+++ /dev/null
@@ -1,13 +0,0 @@
-.hyde-search-context {
-	margin-bottom: 10px;
-}
-
-.hyde-search-results {
-	max-height: 60vh;
-	overflow-y: auto;
-	margin-top: 1.25em;
-}
-
-#search-status {
-	margin-top: 0;
-}
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
index 8396d330a41..eab5d00fc3a 100644
--- a/packages/hydefront/sass/hyde-docs.scss
+++ b/packages/hydefront/sass/hyde-docs.scss
@@ -2,8 +2,6 @@
  * HydeDocs Core CSS
  */
 
-@use 'docs/search';
-
 html {
 	scroll-behavior: smooth;
 }

From 1db810706e2f17945b156b6d7de1eecf530f4514 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:18:36 +0100
Subject: [PATCH 3297/4023] Add top margin

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 53b8623188d..d6c036293ee 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -41,7 +41,7 @@ class="prose dark:prose-invert bg-white dark:bg-gray-800  z-50 p-4 rounded-lg ov
             <x-hyde::docs.search-input/>
         </div>
         <footer class="mt-auto -mb-2 leading-4 text-center font-mono hidden sm:flex justify-center">
-            <small>
+            <small class="mt-4">
                 Press <code><kbd title="Forward slash">/</kbd></code> to open search window.
                 Use <code><kbd title="Escape key">esc</kbd></code> to close.
             </small>

From c6a2c774d1442c2f0954b7415c12e12a596f04a4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:18:44 +0100
Subject: [PATCH 3298/4023] Hide horizontal overflow

---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 7f447ffd60c..cd28ac4ffd8 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -24,7 +24,7 @@
     <div x-show="searchTerm" class="mt-4">
         <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
         
-        <dl class="space-y-4 max-h-[60vh] overflow-y-auto">
+        <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt class="font-medium">

From b903795ef0cd32cb3e4c522662a6cc8625189fe4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:21:39 +0100
Subject: [PATCH 3299/4023] Tweak colors

---
 .../resources/views/components/docs/search-scripts.blade.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-scripts.blade.php b/packages/framework/resources/views/components/docs/search-scripts.blade.php
index 425df75d61c..9be07521c7f 100644
--- a/packages/framework/resources/views/components/docs/search-scripts.blade.php
+++ b/packages/framework/resources/views/components/docs/search-scripts.blade.php
@@ -63,7 +63,7 @@
                 
                 return sentence.replace(
                     new RegExp(this.searchTerm, 'gi'),
-                    match => `<mark class="bg-yellow-200 dark:bg-yellow-800">${match}</mark>`
+                    match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
                 );
             }
         }));

From 531c4a0747fa924373468167df3bbf080f9e7ae0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:26:16 +0100
Subject: [PATCH 3300/4023] Remove the debounce

---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index cd28ac4ffd8..3448bb5058a 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -10,7 +10,7 @@
             name="search" 
             id="search-input"
             x-model="searchTerm"
-            @input.debounce.250ms="search()"
+            @input="search()"
             placeholder="Search..." 
             autocomplete="off" 
             autofocus

From 808942577e069da8c0807c111f0f429bd2bffb8d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:27:09 +0100
Subject: [PATCH 3301/4023] Use indigo styles

---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 3448bb5058a..b4825d085ad 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -30,7 +30,7 @@
                     <dt class="font-medium">
                         <a :href="result.destination" 
                            x-text="result.title"
-                           class="text-blue-600 dark:text-blue-400 hover:underline"></a>
+                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a>
                         <span class="text-sm text-gray-600 dark:text-gray-400" 
                               x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>

From 4d739f2aef5c6f50a988ed94815fac854a2741e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:32:50 +0100
Subject: [PATCH 3302/4023] Remove prose style

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index d6c036293ee..a7d5c630111 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -27,7 +27,7 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
 <div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog"
      class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
     <aside x-on:click.away="searchWindowOpen = false" id="search-menu"
-           class="prose dark:prose-invert bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
+           class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
         <header class="flex justify-between pb-3 mb-3 border-b dark:border-gray-700 md:hidden">
             <strong>Search the documentation site</strong>
             <button @click="searchWindowOpen = false" title="Close search window" class="opacity-75 hover:opacity-100"

From 96bc412db61b0f79faa134066dbabec9631a5fea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:32:56 +0100
Subject: [PATCH 3303/4023] Fix spacing issue

---
 .../resources/views/components/docs/search-input.blade.php     | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index b4825d085ad..60335a92e38 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -30,8 +30,7 @@
                     <dt class="font-medium">
                         <a :href="result.destination" 
                            x-text="result.title"
-                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a>
-                        <span class="text-sm text-gray-600 dark:text-gray-400" 
+                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" 
                               x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>
                     <dd class="mt-1 text-sm text-gray-600 dark:text-gray-400" x-html="result.context"></dd>

From cabd5a4828e98a75f343c8bd12459e9fa31080bc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:37:31 +0100
Subject: [PATCH 3304/4023] Tweak styles

---
 .../resources/views/components/docs/search-widget.blade.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index a7d5c630111..89496b20ae1 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -40,10 +40,10 @@ class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[3
         <div>
             <x-hyde::docs.search-input/>
         </div>
-        <footer class="mt-auto -mb-2 leading-4 text-center font-mono hidden sm:flex justify-center">
+        <footer class="prose dark:prose-invert mt-auto -mb-2 leading-4 text-center font-mono hidden sm:flex justify-center">
             <small class="mt-4">
-                Press <code><kbd title="Forward slash">/</kbd></code> to open search window.
-                Use <code><kbd title="Escape key">esc</kbd></code> to close.
+                Press <code class="p-0"><kbd title="Forward slash" class="shadow-none">/</kbd></code> to open search window.
+                Use <code class="p-0"><kbd title="Escape key" class="shadow-none">esc</kbd></code> to close.
             </small>
         </footer>
     </aside>

From fe4cdb9e4f68252bdd690792a984481361fd415a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:39:35 +0100
Subject: [PATCH 3305/4023] Tweak margin

---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 60335a92e38..3038a79069a 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -22,7 +22,7 @@
     </div>
 
     <div x-show="searchTerm" class="mt-4">
-        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
+        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400"></p>
         
         <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">

From cf17e40a386fed14bdf83b7d42cceea4bd797284 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:39:41 +0100
Subject: [PATCH 3306/4023] Increase contrast

---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 3038a79069a..2f5cf7360cb 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -33,7 +33,7 @@
                            class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" 
                               x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>
-                    <dd class="mt-1 text-sm text-gray-600 dark:text-gray-400" x-html="result.context"></dd>
+                    <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
                 </div>
             </template>
         </dl>

From 835fcea476a65440a6df4e2e7b219f6a7c4de985 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:41:01 +0100
Subject: [PATCH 3307/4023] Revert "Tweak margin"

This reverts commit fe4cdb9e4f68252bdd690792a984481361fd415a.
---
 .../resources/views/components/docs/search-input.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
index 2f5cf7360cb..e655a64d4bc 100644
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ b/packages/framework/resources/views/components/docs/search-input.blade.php
@@ -22,7 +22,7 @@
     </div>
 
     <div x-show="searchTerm" class="mt-4">
-        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400"></p>
+        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
         
         <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">

From fc9e2c0e71b72fee141d8ab37d9bb0364767f6c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:45:27 +0100
Subject: [PATCH 3308/4023] Compile assets

---
 _media/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index bcd52183f38..26c51a5fb04 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From 0e46a13ef0f97a4b1b2abe4e2034ce6990c5b900 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 14:47:38 +0100
Subject: [PATCH 3309/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 92540b521f0..4386e02bc5e 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -96,6 +96,7 @@ This serves two purposes:
 - The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in https://github.com/hydephp/develop/pull/2012
 - **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
+- Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
 
 ### Deprecated
 

From cf0dc9b0adadb9286cbc0e44fc7f26e876be32da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:00:12 +0100
Subject: [PATCH 3310/4023] Merge HydeSearch Blade views into single component

---
 RELEASE_NOTES.md                              |   2 +
 .../components/docs/hyde-search.blade.php     | 113 ++++++++++++++++++
 .../components/docs/search-input.blade.php    |  41 -------
 .../components/docs/search-scripts.blade.php  |  71 -----------
 .../components/docs/search-widget.blade.php   |   2 +-
 .../resources/views/layouts/docs.blade.php    |   1 -
 .../pages/documentation-search.blade.php      |   2 +-
 7 files changed, 117 insertions(+), 115 deletions(-)
 create mode 100644 packages/framework/resources/views/components/docs/hyde-search.blade.php
 delete mode 100644 packages/framework/resources/views/components/docs/search-input.blade.php
 delete mode 100644 packages/framework/resources/views/components/docs/search-scripts.blade.php

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 4386e02bc5e..c6e55148570 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -120,6 +120,8 @@ This serves two purposes:
     - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
 - Removed Laravel Mix as a dependency in https://github.com/hydephp/develop/pull/2010 (replaced with Vite)
 - **Breaking:** Removed `npm run prod` command (replaced with `npm run build`)
+- Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
+  - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
 
 ### Fixed
 
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
new file mode 100644
index 00000000000..413d8bc1428
--- /dev/null
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -0,0 +1,113 @@
+<div id="hyde-search" x-data="hydeSearch">
+    <noscript>
+        The search feature requires JavaScript to be enabled in your browser.
+    </noscript>
+    
+    <div class="relative">
+        <input 
+            {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
+            type="search" 
+            name="search" 
+            id="search-input"
+            x-model="searchTerm"
+            @input="search()"
+            placeholder="Search..." 
+            autocomplete="off" 
+            autofocus
+        >
+        
+        <div x-show="isLoading" class="absolute right-3 top-2.5">
+            <div class="animate-spin h-5 w-5 border-2 border-gray-500 rounded-full border-t-transparent"></div>
+        </div>
+    </div>
+
+    <div x-show="searchTerm" class="mt-4">
+        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
+        
+        <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
+            <template x-for="result in results" :key="result.slug">
+                <div>
+                    <dt class="font-medium">
+                        <a :href="result.destination" 
+                           x-text="result.title"
+                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" 
+                              x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
+                    </dt>
+                    <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
+                </div>
+            </template>
+        </dl>
+    </div>
+
+    <script>
+        document.addEventListener('alpine:init', () => {
+            Alpine.data('hydeSearch', () => ({
+                searchIndex: [],
+                searchTerm: '',
+                results: [],
+                isLoading: true,
+                statusMessage: '',
+                
+                async init() {
+                    const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
+                    if (!response.ok) {
+                        console.error('Could not load search index');
+                        return;
+                    }
+                    this.searchIndex = await response.json();
+                    this.isLoading = false;
+                },
+
+                search() {
+                    const startTime = performance.now();
+                    this.results = [];
+                    
+                    if (!this.searchTerm) {
+                        this.statusMessage = '';
+                        return;
+                    }
+
+                    const searchResults = this.searchIndex.filter(entry => 
+                        entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
+                        entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
+                    );
+
+                    if (searchResults.length === 0) {
+                        this.statusMessage = 'No results found.';
+                        return;
+                    }
+
+                    const totalMatches = searchResults.reduce((acc, result) => {
+                        return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                    }, 0);
+
+                    searchResults.sort((a, b) => {
+                        return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
+                            - (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                    });
+
+                    this.results = searchResults.map(result => {
+                        const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                        const context = this.getSearchContext(result.content);
+                        return { ...result, matches, context };
+                    });
+
+                    const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
+                    this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
+                },
+
+                getSearchContext(content) {
+                    const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
+                    const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
+                    const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
+                    const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+                    
+                    return sentence.replace(
+                        new RegExp(this.searchTerm, 'gi'),
+                        match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
+                    );
+                }
+            }));
+        });
+    </script>
+</div>
diff --git a/packages/framework/resources/views/components/docs/search-input.blade.php b/packages/framework/resources/views/components/docs/search-input.blade.php
deleted file mode 100644
index e655a64d4bc..00000000000
--- a/packages/framework/resources/views/components/docs/search-input.blade.php
+++ /dev/null
@@ -1,41 +0,0 @@
-<div id="hyde-search" x-data="hydeSearch">
-    <noscript>
-        The search feature requires JavaScript to be enabled in your browser.
-    </noscript>
-    
-    <div class="relative">
-        <input 
-            {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
-            type="search" 
-            name="search" 
-            id="search-input"
-            x-model="searchTerm"
-            @input="search()"
-            placeholder="Search..." 
-            autocomplete="off" 
-            autofocus
-        >
-        
-        <div x-show="isLoading" class="absolute right-3 top-2.5">
-            <div class="animate-spin h-5 w-5 border-2 border-gray-500 rounded-full border-t-transparent"></div>
-        </div>
-    </div>
-
-    <div x-show="searchTerm" class="mt-4">
-        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
-        
-        <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
-            <template x-for="result in results" :key="result.slug">
-                <div>
-                    <dt class="font-medium">
-                        <a :href="result.destination" 
-                           x-text="result.title"
-                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" 
-                              x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
-                    </dt>
-                    <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
-                </div>
-            </template>
-        </dl>
-    </div>
-</div>
\ No newline at end of file
diff --git a/packages/framework/resources/views/components/docs/search-scripts.blade.php b/packages/framework/resources/views/components/docs/search-scripts.blade.php
deleted file mode 100644
index 9be07521c7f..00000000000
--- a/packages/framework/resources/views/components/docs/search-scripts.blade.php
+++ /dev/null
@@ -1,71 +0,0 @@
-<script>
-    document.addEventListener('alpine:init', () => {
-        Alpine.data('hydeSearch', () => ({
-            searchIndex: [],
-            searchTerm: '',
-            results: [],
-            isLoading: true,
-            statusMessage: '',
-            
-            async init() {
-                const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
-                if (!response.ok) {
-                    console.error('Could not load search index');
-                    return;
-                }
-                this.searchIndex = await response.json();
-                this.isLoading = false;
-            },
-
-            search() {
-                const startTime = performance.now();
-                this.results = [];
-                
-                if (!this.searchTerm) {
-                    this.statusMessage = '';
-                    return;
-                }
-
-                const searchResults = this.searchIndex.filter(entry => 
-                    entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
-                    entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
-                );
-
-                if (searchResults.length === 0) {
-                    this.statusMessage = 'No results found.';
-                    return;
-                }
-
-                const totalMatches = searchResults.reduce((acc, result) => {
-                    return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                }, 0);
-
-                searchResults.sort((a, b) => {
-                    return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
-                        - (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                });
-
-                this.results = searchResults.map(result => {
-                    const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                    const context = this.getSearchContext(result.content);
-                    return { ...result, matches, context };
-                });
-
-                const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
-                this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
-            },
-
-            getSearchContext(content) {
-                const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
-                const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
-                const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
-                const sentence = content.substring(sentenceStart, sentenceEnd).trim();
-                
-                return sentence.replace(
-                    new RegExp(this.searchTerm, 'gi'),
-                    match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
-                );
-            }
-        }));
-    });
-</script>
\ No newline at end of file
diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 89496b20ae1..8d7e08f4258 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -38,7 +38,7 @@ class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[3
             </button>
         </header>
         <div>
-            <x-hyde::docs.search-input/>
+            <x-hyde::docs.hyde-search/>
         </div>
         <footer class="prose dark:prose-invert mt-auto -mb-2 leading-4 text-center font-mono hidden sm:flex justify-center">
             <small class="mt-4">
diff --git a/packages/framework/resources/views/layouts/docs.blade.php b/packages/framework/resources/views/layouts/docs.blade.php
index 7a7148adc7c..6476254b142 100644
--- a/packages/framework/resources/views/layouts/docs.blade.php
+++ b/packages/framework/resources/views/layouts/docs.blade.php
@@ -19,7 +19,6 @@
 
         @if(Hyde\Facades\Features::hasDocumentationSearch())
             @include('hyde::components.docs.search-widget')
-            @include('hyde::components.docs.search-scripts')
         @endif
     </div>
 
diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/documentation-search.blade.php
index c50683276d6..7e3ab3bdf51 100644
--- a/packages/framework/resources/views/pages/documentation-search.blade.php
+++ b/packages/framework/resources/views/pages/documentation-search.blade.php
@@ -8,5 +8,5 @@
         #search-results {
             max-height: unset !important;
         }</style>
-    <x-hyde::docs.search-input class="max-w-xs border-b-4 border-indigo-400"/>
+    <x-hyde::docs.hyde-search class="max-w-xs border-b-4 border-indigo-400"/>
 @endsection
\ No newline at end of file

From dbf8cde935f127b32ccf9200fd432f9df632d664 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:03:38 +0100
Subject: [PATCH 3311/4023] Remove noscript tag from search plugin

---
 .../resources/views/components/docs/hyde-search.blade.php     | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 413d8bc1428..846ad661b66 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -1,8 +1,4 @@
 <div id="hyde-search" x-data="hydeSearch">
-    <noscript>
-        The search feature requires JavaScript to be enabled in your browser.
-    </noscript>
-    
     <div class="relative">
         <input 
             {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}

From 0c591b276ef7cef3acbc1616150cd020438b6a53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:03:56 +0100
Subject: [PATCH 3312/4023] Format Blade

---
 .../components/docs/hyde-search.blade.php     | 38 +++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 846ad661b66..8e754d7f14a 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -1,17 +1,17 @@
 <div id="hyde-search" x-data="hydeSearch">
     <div class="relative">
-        <input 
-            {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
-            type="search" 
-            name="search" 
-            id="search-input"
-            x-model="searchTerm"
-            @input="search()"
-            placeholder="Search..." 
-            autocomplete="off" 
-            autofocus
+        <input
+                {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
+                type="search"
+                name="search"
+                id="search-input"
+                x-model="searchTerm"
+                @input="search()"
+                placeholder="Search..."
+                autocomplete="off"
+                autofocus
         >
-        
+
         <div x-show="isLoading" class="absolute right-3 top-2.5">
             <div class="animate-spin h-5 w-5 border-2 border-gray-500 rounded-full border-t-transparent"></div>
         </div>
@@ -19,15 +19,15 @@
 
     <div x-show="searchTerm" class="mt-4">
         <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
-        
+
         <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt class="font-medium">
-                        <a :href="result.destination" 
+                        <a :href="result.destination"
                            x-text="result.title"
-                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" 
-                              x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
+                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400"
+                                                                                                  x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>
                     <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
                 </div>
@@ -43,7 +43,7 @@ class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="te
                 results: [],
                 isLoading: true,
                 statusMessage: '',
-                
+
                 async init() {
                     const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
                     if (!response.ok) {
@@ -57,13 +57,13 @@ class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="te
                 search() {
                     const startTime = performance.now();
                     this.results = [];
-                    
+
                     if (!this.searchTerm) {
                         this.statusMessage = '';
                         return;
                     }
 
-                    const searchResults = this.searchIndex.filter(entry => 
+                    const searchResults = this.searchIndex.filter(entry =>
                         entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
                         entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
                     );
@@ -97,7 +97,7 @@ class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="te
                     const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
                     const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
                     const sentence = content.substring(sentenceStart, sentenceEnd).trim();
-                    
+
                     return sentence.replace(
                         new RegExp(this.searchTerm, 'gi'),
                         match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`

From 7c811e0b959a4695c08ea07c741a41775e7717cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:08:06 +0100
Subject: [PATCH 3313/4023] Manually reformat Blade

---
 .../components/docs/hyde-search.blade.php      | 15 ++-------------
 .../components/docs/search-widget.blade.php    | 18 ++++++------------
 2 files changed, 8 insertions(+), 25 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 8e754d7f14a..8b8f0d29fdb 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -1,15 +1,7 @@
 <div id="hyde-search" x-data="hydeSearch">
     <div class="relative">
-        <input
+        <input type="search" name="search" id="search-input" x-model="searchTerm" @input="search()" placeholder="Search..." autocomplete="off" autofocus
                 {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
-                type="search"
-                name="search"
-                id="search-input"
-                x-model="searchTerm"
-                @input="search()"
-                placeholder="Search..."
-                autocomplete="off"
-                autofocus
         >
 
         <div x-show="isLoading" class="absolute right-3 top-2.5">
@@ -24,10 +16,7 @@
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt class="font-medium">
-                        <a :href="result.destination"
-                           x-text="result.title"
-                           class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400"
-                                                                                                  x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
+                        <a :href="result.destination" x-text="result.title" class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>
                     <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
                 </div>
diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 8d7e08f4258..83dfd690983 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -1,10 +1,8 @@
 <button id="search-menu-button" x-on:click="searchWindowOpen = ! searchWindowOpen"
         :title="searchWindowOpen ? 'Close search window' : 'Open search window'; $nextTick(() => { setTimeout(() => { document.getElementById('search-input').focus(); }); });"
-        class="absolute right-4 top-4 mr-4 z-10 opacity-75 hover:opacity-100 hidden md:block"
-        aria-label="Toggle search window">
+        class="absolute right-4 top-4 mr-4 z-10 opacity-75 hover:opacity-100 hidden md:block" aria-label="Toggle search window">
     <span x-show="! searchWindowOpen">
-        Search <svg class="float-left mr-1 dark:fill-white" xmlns="http://www.w3.org/2000/svg" height="24"
-                    viewBox="0 0 24 24" width="24" role="presentation">
+        Search <svg class="float-left mr-1 dark:fill-white" xmlns="http://www.w3.org/2000/svg" height="24" viewBox="0 0 24 24" width="24" role="presentation">
             <path d="M0 0h24v24H0z" fill="none"/>
             <path d="M15.5 14h-.79l-.28-.27C15.41 12.59 16 11.11 16 9.5 16 5.91 13.09 3 9.5 3S3 5.91 3 9.5 5.91 16 9.5 16c1.61 0 3.09-.59 4.23-1.57l.27.28v.79l5 4.99L20.49 19l-4.99-5zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"/></svg>
     </span>
@@ -24,14 +22,11 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
     </svg>
 </button>
 
-<div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog"
-     class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
-    <aside x-on:click.away="searchWindowOpen = false" id="search-menu"
-           class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
+<div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog" class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
+    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
         <header class="flex justify-between pb-3 mb-3 border-b dark:border-gray-700 md:hidden">
             <strong>Search the documentation site</strong>
-            <button @click="searchWindowOpen = false" title="Close search window" class="opacity-75 hover:opacity-100"
-                    aria-label="Close search window">
+            <button @click="searchWindowOpen = false" title="Close search window" class="opacity-75 hover:opacity-100" aria-label="Close search window">
                 <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
                     <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path>
                 </svg>
@@ -48,6 +43,5 @@ class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[3
         </footer>
     </aside>
 
-    <div id="search-window-backdrop" title="Click to close search window"
-         class="w-screen h-screen cursor-pointer z-40 bg-black/50 absolute top-0"></div>
+    <div id="search-window-backdrop" title="Click to close search window" class="w-screen h-screen cursor-pointer z-40 bg-black/50 absolute top-0"></div>
 </div>
\ No newline at end of file

From cf42f2a25885f01058f8e6d1743bd3e2840a1f48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:13:28 +0100
Subject: [PATCH 3314/4023] Cleanup Blade

---
 .../resources/views/components/docs/search-widget.blade.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index 83dfd690983..d0a0c5e34d0 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -23,7 +23,7 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
 </button>
 
 <div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog" class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
-    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" class="bg-white dark:bg-gray-800  z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto ">
+    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" class="bg-white dark:bg-gray-800 z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto">
         <header class="flex justify-between pb-3 mb-3 border-b dark:border-gray-700 md:hidden">
             <strong>Search the documentation site</strong>
             <button @click="searchWindowOpen = false" title="Close search window" class="opacity-75 hover:opacity-100" aria-label="Close search window">

From 84d65375d345fef2764998a0c30f93e406f28636 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 15:16:01 +0100
Subject: [PATCH 3315/4023] Simplify modal layout styles

---
 .../components/docs/search-widget.blade.php   | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index d0a0c5e34d0..cf8506d6f7c 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -23,20 +23,27 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
 </button>
 
 <div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog" class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
-    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" class="bg-white dark:bg-gray-800 z-50 p-4 rounded-lg overflow-y-hidden min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto">
-        <header class="flex justify-between pb-3 mb-3 border-b dark:border-gray-700 md:hidden">
+    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" 
+        class="bg-white dark:bg-gray-800 z-50 p-4 rounded-lg overflow-y-hidden 
+        min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto
+        flex flex-col gap-4">
+        
+        <header class="flex justify-between items-center border-b dark:border-gray-700 pb-3 md:hidden">
             <strong>Search the documentation site</strong>
-            <button @click="searchWindowOpen = false" title="Close search window" class="opacity-75 hover:opacity-100" aria-label="Close search window">
+            <button @click="searchWindowOpen = false" title="Close search window" 
+                class="opacity-75 hover:opacity-100" aria-label="Close search window">
                 <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
                     <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path>
                 </svg>
             </button>
         </header>
-        <div>
+
+        <div class="flex-grow">
             <x-hyde::docs.hyde-search/>
         </div>
-        <footer class="prose dark:prose-invert mt-auto -mb-2 leading-4 text-center font-mono hidden sm:flex justify-center">
-            <small class="mt-4">
+
+        <footer class="prose dark:prose-invert text-center font-mono hidden sm:block">
+            <small>
                 Press <code class="p-0"><kbd title="Forward slash" class="shadow-none">/</kbd></code> to open search window.
                 Use <code class="p-0"><kbd title="Escape key" class="shadow-none">esc</kbd></code> to close.
             </small>

From 73e9067e75c604d5addf9710296100488b1f3528 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:01:53 +0100
Subject: [PATCH 3316/4023] Hide search footer when there are results

---
 .../resources/views/components/docs/hyde-search.blade.php     | 4 ++++
 .../resources/views/components/docs/search-widget.blade.php   | 4 +++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 8b8f0d29fdb..dbb2d67dbb3 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -49,6 +49,7 @@
 
                     if (!this.searchTerm) {
                         this.statusMessage = '';
+                        window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
                         return;
                     }
 
@@ -59,6 +60,7 @@
 
                     if (searchResults.length === 0) {
                         this.statusMessage = 'No results found.';
+                        window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
                         return;
                     }
 
@@ -79,6 +81,8 @@
 
                     const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
                     this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
+
+                    window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: true } }));
                 },
 
                 getSearchContext(content) {
diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-widget.blade.php
index cf8506d6f7c..6558ee09e4d 100644
--- a/packages/framework/resources/views/components/docs/search-widget.blade.php
+++ b/packages/framework/resources/views/components/docs/search-widget.blade.php
@@ -42,7 +42,9 @@ class="opacity-75 hover:opacity-100" aria-label="Close search window">
             <x-hyde::docs.hyde-search/>
         </div>
 
-        <footer class="prose dark:prose-invert text-center font-mono hidden sm:block">
+        <footer x-data="{ hasResults: false }" @search-results-updated.window="hasResults = $event.detail.hasResults"
+            class="prose dark:prose-invert text-center font-mono hidden sm:block"
+            x-show="!hasResults">
             <small>
                 Press <code class="p-0"><kbd title="Forward slash" class="shadow-none">/</kbd></code> to open search window.
                 Use <code class="p-0"><kbd title="Escape key" class="shadow-none">esc</kbd></code> to close.

From 93bd9b9c4ff347f7448cd13c483b0dea89efd5b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:04:54 +0100
Subject: [PATCH 3317/4023] Tweak margins

---
 _media/app.css                                                | 2 +-
 .../resources/views/components/docs/hyde-search.blade.php     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 26c51a5fb04..112cdce6ac7 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index dbb2d67dbb3..eb295bb550b 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -10,9 +10,9 @@
     </div>
 
     <div x-show="searchTerm" class="mt-4">
-        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-4"></p>
+        <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-2 pb-2"></p>
 
-        <dl class="space-y-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
+        <dl class="space-y-4 -mt-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt class="font-medium">

From 5cefc0bf27ad4ccb89c9056cc192da0459e298ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:07:22 +0100
Subject: [PATCH 3318/4023] Add padding and negative margin to get nicer focus
 states

---
 .../resources/views/components/docs/hyde-search.blade.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index eb295bb550b..5f49798d3e8 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -12,7 +12,7 @@
     <div x-show="searchTerm" class="mt-4">
         <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-2 pb-2"></p>
 
-        <dl class="space-y-4 -mt-4 max-h-[60vh] overflow-x-hidden overflow-y-auto">
+        <dl class="space-y-4 -mt-4 pl-2 -ml-2 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt class="font-medium">

From fa1037b608a8f310057914c58cfbdc0cf38793c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:10:57 +0100
Subject: [PATCH 3319/4023] Move font weight rule to heading

---
 .../resources/views/components/docs/hyde-search.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 5f49798d3e8..003d4bb4500 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -15,8 +15,8 @@
         <dl class="space-y-4 -mt-4 pl-2 -ml-2 max-h-[60vh] overflow-x-hidden overflow-y-auto">
             <template x-for="result in results" :key="result.slug">
                 <div>
-                    <dt class="font-medium">
-                        <a :href="result.destination" x-text="result.title" class="text-indigo-600 dark:text-indigo-400 hover:underline"></a><span class="text-sm text-gray-600 dark:text-gray-400" x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
+                    <dt>
+                        <a :href="result.destination" x-text="result.title" class="text-indigo-600 dark:text-indigo-400 hover:underline font-medium"></a><span class="text-sm text-gray-600 dark:text-gray-400" x-text="`, ${result.matches} occurrence${result.matches !== 1 ? 's' : ''} found.`"></span>
                     </dt>
                     <dd class="mt-1 text-sm text-gray-700 dark:text-gray-300" x-html="result.context"></dd>
                 </div>

From ffee3b35a73af500a43cb6fccae32ecdb62053b0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:21:14 +0100
Subject: [PATCH 3320/4023] Update and clean up the search feature
 documentation

---
 docs/creating-content/documentation-pages.md | 32 ++++++++++++++------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index a79d11889f2..64ab278358a 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -351,11 +351,13 @@ If you set this to false, Hyde will match the directory structure of the source
 
 ### Introduction
 
-The HydeSearch plugin adds a search feature to documentation pages. It consists of two parts, a search index generator that runs during the build command, and a frontend JavaScript plugin that adds the actual search widget.
+Hyde includes a built-in search feature for documentation pages powered by Alpine.js. It consists of two parts:
+1. A search index generator that runs during the build command
+2. An Alpine.js powered frontend that provides the search interface
 
->info Tip: The HydeSearch plugin is what powers the search feature on this site! Why not [try it out](search)?
+>info Tip: The search feature is what powers the search on this site! Why not [try it out](search)?
 
-The search feature is enabled by default. You can disable it by removing the `DocumentationSearch` option from the Hyde `Features` config array.
+The search feature is enabled by default. You can disable it by removing the `DocumentationSearch` option from the Hyde `Features` config array:
 
 ```php
 // filepath: config/hyde.php
@@ -366,17 +368,27 @@ The search feature is enabled by default. You can disable it by removing the `Do
 
 ### Using the Search
 
-The search works by generating a JSON search index which the JavaScript plugin loads asynchronously.
+The search works by generating a JSON search index which Alpine.js loads asynchronously. There are two ways to access the search:
 
-Two ways to access the search are added, one is a full page search screen that will be saved to `docs/search.html`.
-
-The second method is a button added to the documentation pages, similar to how Algolia DocSearch works. Opening it will open a modal with an integrated search screen. You can also open the dialog using the keyboard shortcut `/`.
+1. A full-page search screen at `docs/search.html`
+2. A modal dialog accessible via a button in the documentation pages (similar to Algolia DocSearch). You can also open this dialog using the keyboard shortcut `/`
 
 >info The full page can be disabled by setting `create_search_page` to `false` in the `docs` config.
 
+### Search Features
+
+The search implementation includes:
+- Real-time search results as you type
+- Context highlighting of search terms
+- Match counting and search timing statistics
+- Dark mode support
+- Loading state indicators
+- Keyboard navigation support
+- Mobile-responsive design
+
 ### Hiding Pages from Indexing
 
-If you have a large page on your documentation site, like a changelog, you may want to hide it from the search index. You can do this by adding the page identifier to the `exclude_from_search` array in the `docs` config, similar to how navigation menu items are hidden. The page will still be accessible as normal but will not be added to the search index JSON file.
+For large pages like changelogs, you may want to exclude them from the search index. Add the page identifier to the `exclude_from_search` array in the docs config:
 
 ```php
 // filepath: config/docs.php
@@ -385,9 +397,11 @@ If you have a large page on your documentation site, like a changelog, you may w
 ]
 ```
 
+The page will remain accessible but won't appear in search results.
+
 ### Live Search with the Realtime Compiler
 
-The Realtime Compiler that powers the `php hyde serve` command will automatically generate a fresh search index each time the browser requests it.
+When using `php hyde serve`, the Realtime Compiler automatically generates a fresh search index each time it's requested, ensuring your search results stay current during development.
 
 ## Automatic "Edit Page" Button
 

From 8ebf91d0aefdd72b7b7fa4186ccb9802de3c3c0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:27:44 +0100
Subject: [PATCH 3321/4023] Tweak full page search styles

---
 _media/app.css                                       |  2 +-
 .../views/components/docs/hyde-search.blade.php      |  4 +++-
 .../views/pages/documentation-search.blade.php       | 12 +++---------
 3 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 112cdce6ac7..50a96909cf5 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 003d4bb4500..08964cf60e7 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -1,3 +1,5 @@
+@props(['modal' => true])
+
 <div id="hyde-search" x-data="hydeSearch">
     <div class="relative">
         <input type="search" name="search" id="search-input" x-model="searchTerm" @input="search()" placeholder="Search..." autocomplete="off" autofocus
@@ -12,7 +14,7 @@
     <div x-show="searchTerm" class="mt-4">
         <p x-text="statusMessage" class="text-sm text-gray-600 dark:text-gray-400 mb-2 pb-2"></p>
 
-        <dl class="space-y-4 -mt-4 pl-2 -ml-2 max-h-[60vh] overflow-x-hidden overflow-y-auto">
+        <dl class="space-y-4 -mt-4 pl-2 -ml-2 {{ $modal ? 'max-h-[60vh] overflow-x-hidden overflow-y-auto' : '' }}">
             <template x-for="result in results" :key="result.slug">
                 <div>
                     <dt>
diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/documentation-search.blade.php
index 7e3ab3bdf51..aa2477cf20b 100644
--- a/packages/framework/resources/views/pages/documentation-search.blade.php
+++ b/packages/framework/resources/views/pages/documentation-search.blade.php
@@ -1,12 +1,6 @@
 @extends('hyde::layouts.docs')
 @section('content')
     <h1>Search the documentation site</h1>
-    <style>#search-menu-button, .edit-page-link {
-            display: none !important;
-        }
-
-        #search-results {
-            max-height: unset !important;
-        }</style>
-    <x-hyde::docs.hyde-search class="max-w-xs border-b-4 border-indigo-400"/>
-@endsection
\ No newline at end of file
+    <style>#search-menu-button, .edit-page-link { display: none !important; }</style>
+    <x-hyde::docs.hyde-search class="max-w-sm" :modal="false" />
+@endsection

From b592ae021b5e2d5cf8143191dc853a99fd5c9161 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:28:17 +0100
Subject: [PATCH 3322/4023] Fix not prose styles

---
 .../resources/views/pages/documentation-search.blade.php     | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/documentation-search.blade.php
index aa2477cf20b..e9fe59832f7 100644
--- a/packages/framework/resources/views/pages/documentation-search.blade.php
+++ b/packages/framework/resources/views/pages/documentation-search.blade.php
@@ -2,5 +2,8 @@
 @section('content')
     <h1>Search the documentation site</h1>
     <style>#search-menu-button, .edit-page-link { display: none !important; }</style>
-    <x-hyde::docs.hyde-search class="max-w-sm" :modal="false" />
+
+    <div class="not-prose">
+        <x-hyde::docs.hyde-search class="max-w-sm" :modal="false" />
+    </div>
 @endsection

From cc796dd4a769c54d3657aa84d4590b93c8e3addc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:35:07 +0100
Subject: [PATCH 3323/4023] Rename search widget component to search modal

---
 RELEASE_NOTES.md                                                | 1 +
 .../docs/{search-widget.blade.php => search-modal.blade.php}    | 0
 packages/framework/resources/views/layouts/docs.blade.php       | 2 +-
 3 files changed, 2 insertions(+), 1 deletion(-)
 rename packages/framework/resources/views/components/docs/{search-widget.blade.php => search-modal.blade.php} (100%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c6e55148570..a1212768c8b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -97,6 +97,7 @@ This serves two purposes:
 - **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
+  - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
 
 ### Deprecated
 
diff --git a/packages/framework/resources/views/components/docs/search-widget.blade.php b/packages/framework/resources/views/components/docs/search-modal.blade.php
similarity index 100%
rename from packages/framework/resources/views/components/docs/search-widget.blade.php
rename to packages/framework/resources/views/components/docs/search-modal.blade.php
diff --git a/packages/framework/resources/views/layouts/docs.blade.php b/packages/framework/resources/views/layouts/docs.blade.php
index 6476254b142..9476789fd7e 100644
--- a/packages/framework/resources/views/layouts/docs.blade.php
+++ b/packages/framework/resources/views/layouts/docs.blade.php
@@ -18,7 +18,7 @@
         @include('hyde::components.docs.sidebar-backdrop')
 
         @if(Hyde\Facades\Features::hasDocumentationSearch())
-            @include('hyde::components.docs.search-widget')
+            @include('hyde::components.docs.search-modal')
         @endif
     </div>
 

From 5782c86f44e64c20fbeda3084a93530c3eb0a321 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:35:47 +0100
Subject: [PATCH 3324/4023] Fix Blade formatting

---
 .../views/components/docs/search-modal.blade.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/search-modal.blade.php b/packages/framework/resources/views/components/docs/search-modal.blade.php
index 6558ee09e4d..975f61170d2 100644
--- a/packages/framework/resources/views/components/docs/search-modal.blade.php
+++ b/packages/framework/resources/views/components/docs/search-modal.blade.php
@@ -23,15 +23,15 @@ class="block md:hidden fixed bottom-4 right-4 z-10 rounded-full p-2 opacity-75 h
 </button>
 
 <div id="search-window-container" x-show="searchWindowOpen" x-cloak role="dialog" class="z-30 fixed top-0 left-0 w-screen h-screen flex flex-col items-center px-8 py-24 md:py-16">
-    <aside x-on:click.away="searchWindowOpen = false" id="search-menu" 
-        class="bg-white dark:bg-gray-800 z-50 p-4 rounded-lg overflow-y-hidden 
+    <aside x-on:click.away="searchWindowOpen = false" id="search-menu"
+           class="bg-white dark:bg-gray-800 z-50 p-4 rounded-lg overflow-y-hidden
         min-h-[300px] max-h-[75vh] w-[70ch] max-w-full cursor-auto
         flex flex-col gap-4">
-        
+
         <header class="flex justify-between items-center border-b dark:border-gray-700 pb-3 md:hidden">
             <strong>Search the documentation site</strong>
-            <button @click="searchWindowOpen = false" title="Close search window" 
-                class="opacity-75 hover:opacity-100" aria-label="Close search window">
+            <button @click="searchWindowOpen = false" title="Close search window"
+                    class="opacity-75 hover:opacity-100" aria-label="Close search window">
                 <svg class="w-6 h-6" fill="currentColor" viewBox="0 0 20 20">
                     <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"></path>
                 </svg>
@@ -39,12 +39,12 @@ class="opacity-75 hover:opacity-100" aria-label="Close search window">
         </header>
 
         <div class="flex-grow">
-            <x-hyde::docs.hyde-search/>
+            <x-hyde::docs.hyde-search />
         </div>
 
         <footer x-data="{ hasResults: false }" @search-results-updated.window="hasResults = $event.detail.hasResults"
-            class="prose dark:prose-invert text-center font-mono hidden sm:block"
-            x-show="!hasResults">
+                class="prose dark:prose-invert text-center font-mono hidden sm:block"
+                x-show="!hasResults">
             <small>
                 Press <code class="p-0"><kbd title="Forward slash" class="shadow-none">/</kbd></code> to open search window.
                 Use <code class="p-0"><kbd title="Escape key" class="shadow-none">esc</kbd></code> to close.

From 4cf461cf0563427bcabec704c6c55ae6cc366b14 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:51:56 +0100
Subject: [PATCH 3325/4023] Extract file for the main HydeSearch script

---
 .../framework/resources/js/hyde-search.js     | 73 ++++++++++++++++++
 .../components/docs/hyde-search.blade.php     | 76 ++-----------------
 2 files changed, 78 insertions(+), 71 deletions(-)
 create mode 100644 packages/framework/resources/js/hyde-search.js

diff --git a/packages/framework/resources/js/hyde-search.js b/packages/framework/resources/js/hyde-search.js
new file mode 100644
index 00000000000..5b0e34ab386
--- /dev/null
+++ b/packages/framework/resources/js/hyde-search.js
@@ -0,0 +1,73 @@
+export default function initHydeSearch(searchIndexUrl) {
+    return {
+        searchIndex: [],
+        searchTerm: '',
+        results: [],
+        isLoading: true,
+        statusMessage: '',
+        
+		async init() {
+			const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
+			if (!response.ok) {
+				console.error('Could not load search index');
+				return;
+			}
+			this.searchIndex = await response.json();
+			this.isLoading = false;
+		},
+
+		search() {
+			const startTime = performance.now();
+			this.results = [];
+
+			if (!this.searchTerm) {
+				this.statusMessage = '';
+				window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
+				return;
+			}
+
+			const searchResults = this.searchIndex.filter(entry =>
+				entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
+				entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
+			);
+
+			if (searchResults.length === 0) {
+				this.statusMessage = 'No results found.';
+				window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
+				return;
+			}
+
+			const totalMatches = searchResults.reduce((acc, result) => {
+				return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+			}, 0);
+
+			searchResults.sort((a, b) => {
+				return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
+					- (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+			});
+
+			this.results = searchResults.map(result => {
+				const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+				const context = this.getSearchContext(result.content);
+				return { ...result, matches, context };
+			});
+
+			const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
+			this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
+
+			window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: true } }));
+		},
+
+		getSearchContext(content) {
+			const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
+			const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
+			const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
+			const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+
+			return sentence.replace(
+				new RegExp(this.searchTerm, 'gi'),
+				match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
+			);
+		}
+    };
+}
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 08964cf60e7..087a4e3e837 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -27,78 +27,12 @@
     </div>
 
     <script>
+		{!! file_get_contents(Hyde::vendorPath('resources/js/hyde-search.js')) !!}
+        
         document.addEventListener('alpine:init', () => {
-            Alpine.data('hydeSearch', () => ({
-                searchIndex: [],
-                searchTerm: '',
-                results: [],
-                isLoading: true,
-                statusMessage: '',
-
-                async init() {
-                    const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
-                    if (!response.ok) {
-                        console.error('Could not load search index');
-                        return;
-                    }
-                    this.searchIndex = await response.json();
-                    this.isLoading = false;
-                },
-
-                search() {
-                    const startTime = performance.now();
-                    this.results = [];
-
-                    if (!this.searchTerm) {
-                        this.statusMessage = '';
-                        window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
-                        return;
-                    }
-
-                    const searchResults = this.searchIndex.filter(entry =>
-                        entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
-                        entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
-                    );
-
-                    if (searchResults.length === 0) {
-                        this.statusMessage = 'No results found.';
-                        window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
-                        return;
-                    }
-
-                    const totalMatches = searchResults.reduce((acc, result) => {
-                        return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                    }, 0);
-
-                    searchResults.sort((a, b) => {
-                        return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
-                            - (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                    });
-
-                    this.results = searchResults.map(result => {
-                        const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-                        const context = this.getSearchContext(result.content);
-                        return { ...result, matches, context };
-                    });
-
-                    const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
-                    this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
-
-                    window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: true } }));
-                },
-
-                getSearchContext(content) {
-                    const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
-                    const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
-                    const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
-                    const sentence = content.substring(sentenceStart, sentenceEnd).trim();
-
-                    return sentence.replace(
-                        new RegExp(this.searchTerm, 'gi'),
-                        match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
-                    );
-                }
-            }));
+            Alpine.data('hydeSearch', () => 
+                initHydeSearch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}')
+            );
         });
     </script>
 </div>

From 6cf331cba81fce756b024bc178e24d63b360dd1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:54:43 +0100
Subject: [PATCH 3326/4023] Support overloading the script file

---
 .../resources/views/components/docs/hyde-search.blade.php    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 087a4e3e837..b98bd4fe370 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -27,7 +27,10 @@
     </div>
 
     <script>
-		{!! file_get_contents(Hyde::vendorPath('resources/js/hyde-search.js')) !!}
+		{!! file_get_contents(file_exists(Hyde::path('resources/js/hyde-search.js')) 
+			? Hyde::path('resources/js/hyde-search.js')
+			: Hyde::vendorPath('resources/js/hyde-search.js')
+		) !!}
         
         document.addEventListener('alpine:init', () => {
             Alpine.data('hydeSearch', () => 

From 4007f9d7aaee0046aed7fa1a06945c35ef5a90aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:55:13 +0100
Subject: [PATCH 3327/4023] Remove export default

---
 packages/framework/resources/js/hyde-search.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/js/hyde-search.js b/packages/framework/resources/js/hyde-search.js
index 5b0e34ab386..712762d1255 100644
--- a/packages/framework/resources/js/hyde-search.js
+++ b/packages/framework/resources/js/hyde-search.js
@@ -1,4 +1,4 @@
-export default function initHydeSearch(searchIndexUrl) {
+function initHydeSearch(searchIndexUrl) {
     return {
         searchIndex: [],
         searchTerm: '',

From e27580b4c24651863eb05d97242bb5305e38da6c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:55:44 +0100
Subject: [PATCH 3328/4023] Fix formatting

---
 .../framework/resources/js/hyde-search.js     | 106 +++++++++---------
 1 file changed, 53 insertions(+), 53 deletions(-)

diff --git a/packages/framework/resources/js/hyde-search.js b/packages/framework/resources/js/hyde-search.js
index 712762d1255..ea79cd0b111 100644
--- a/packages/framework/resources/js/hyde-search.js
+++ b/packages/framework/resources/js/hyde-search.js
@@ -5,69 +5,69 @@ function initHydeSearch(searchIndexUrl) {
         results: [],
         isLoading: true,
         statusMessage: '',
-        
-		async init() {
-			const response = await fetch('{{ Hyde::relativeLink(\Hyde\Framework\Features\Documentation\DocumentationSearchIndex::outputPath()) }}');
-			if (!response.ok) {
-				console.error('Could not load search index');
-				return;
-			}
-			this.searchIndex = await response.json();
-			this.isLoading = false;
-		},
 
-		search() {
-			const startTime = performance.now();
-			this.results = [];
+        async init() {
+            const response = await fetch(searchIndexUrl);
+            if (!response.ok) {
+                console.error('Could not load search index');
+                return;
+            }
+            this.searchIndex = await response.json();
+            this.isLoading = false;
+        },
 
-			if (!this.searchTerm) {
-				this.statusMessage = '';
-				window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
-				return;
-			}
+        search() {
+            const startTime = performance.now();
+            this.results = [];
 
-			const searchResults = this.searchIndex.filter(entry =>
-				entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
-				entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
-			);
+            if (!this.searchTerm) {
+                this.statusMessage = '';
+                window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
+                return;
+            }
 
-			if (searchResults.length === 0) {
-				this.statusMessage = 'No results found.';
-				window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
-				return;
-			}
+            const searchResults = this.searchIndex.filter(entry =>
+                entry.title.toLowerCase().includes(this.searchTerm.toLowerCase()) ||
+                entry.content.toLowerCase().includes(this.searchTerm.toLowerCase())
+            );
 
-			const totalMatches = searchResults.reduce((acc, result) => {
-				return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-			}, 0);
+            if (searchResults.length === 0) {
+                this.statusMessage = 'No results found.';
+                window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: false } }));
+                return;
+            }
 
-			searchResults.sort((a, b) => {
-				return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
-					- (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-			});
+            const totalMatches = searchResults.reduce((acc, result) => {
+                return acc + (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+            }, 0);
 
-			this.results = searchResults.map(result => {
-				const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
-				const context = this.getSearchContext(result.content);
-				return { ...result, matches, context };
-			});
+            searchResults.sort((a, b) => {
+                return (b.content.match(new RegExp(this.searchTerm, 'gi')) || []).length
+                    - (a.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+            });
 
-			const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
-			this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
+            this.results = searchResults.map(result => {
+                const matches = (result.content.match(new RegExp(this.searchTerm, 'gi')) || []).length;
+                const context = this.getSearchContext(result.content);
+                return { ...result, matches, context };
+            });
 
-			window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: true } }));
-		},
+            const timeMs = Math.round((performance.now() - startTime) * 100) / 100;
+            this.statusMessage = `Found ${totalMatches} result${totalMatches !== 1 ? 's' : ''} in ${searchResults.length} pages. ~${timeMs}ms`;
 
-		getSearchContext(content) {
-			const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
-			const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
-			const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
-			const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+            window.dispatchEvent(new CustomEvent('search-results-updated', { detail: { hasResults: true } }));
+        },
 
-			return sentence.replace(
-				new RegExp(this.searchTerm, 'gi'),
-				match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
-			);
-		}
+        getSearchContext(content) {
+            const searchTermPos = content.toLowerCase().indexOf(this.searchTerm.toLowerCase());
+            const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
+            const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
+            const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+
+            return sentence.replace(
+                new RegExp(this.searchTerm, 'gi'),
+                match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
+            );
+        }
     };
 }

From 53c9ffbd454aa42e04151709eddddb685bf4cd8d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 19:58:15 +0100
Subject: [PATCH 3329/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a1212768c8b..15d317aca77 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -98,6 +98,7 @@ This serves two purposes:
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
+  - Added support for customizing the search implementation by creating a `resources/js/hyde-search.js` file in https://github.com/hydephp/develop/pull/2030
 
 ### Deprecated
 

From 716c3c0e3237363755bfa798d97523f58c32dc31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 20:04:35 +0100
Subject: [PATCH 3330/4023] Move markup to template so Tailwind can find it

---
 packages/framework/resources/js/hyde-search.js             | 7 ++++++-
 .../resources/views/components/docs/hyde-search.blade.php  | 4 ++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/js/hyde-search.js b/packages/framework/resources/js/hyde-search.js
index ea79cd0b111..ff8a6591f94 100644
--- a/packages/framework/resources/js/hyde-search.js
+++ b/packages/framework/resources/js/hyde-search.js
@@ -63,10 +63,15 @@ function initHydeSearch(searchIndexUrl) {
             const sentenceStart = content.lastIndexOf('.', searchTermPos) + 1;
             const sentenceEnd = content.indexOf('.', searchTermPos) + 1;
             const sentence = content.substring(sentenceStart, sentenceEnd).trim();
+            const template = document.getElementById('search-highlight-template');
 
             return sentence.replace(
                 new RegExp(this.searchTerm, 'gi'),
-                match => `<mark class="bg-yellow-400 dark:bg-yellow-300">${match}</mark>`
+                match => {
+                    const mark = template.content.querySelector('mark').cloneNode();
+                    mark.textContent = match;
+                    return mark.outerHTML;
+                }
             );
         }
     };
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index b98bd4fe370..0deafcc968a 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -1,6 +1,10 @@
 @props(['modal' => true])
 
 <div id="hyde-search" x-data="hydeSearch">
+    <template id="search-highlight-template">
+        <mark class="bg-yellow-400 dark:bg-yellow-300"></mark>
+    </template>
+
     <div class="relative">
         <input type="search" name="search" id="search-input" x-model="searchTerm" @input="search()" placeholder="Search..." autocomplete="off" autofocus
                 {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}

From cf4d641b9a8eb976101449ade3afb467bbdedfa3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 20:06:40 +0100
Subject: [PATCH 3331/4023] Rename file to HydeSearch

---
 RELEASE_NOTES.md                                            | 2 +-
 .../resources/js/{hyde-search.js => HydeSearch.js}          | 0
 .../resources/views/components/docs/hyde-search.blade.php   | 6 +++---
 3 files changed, 4 insertions(+), 4 deletions(-)
 rename packages/framework/resources/js/{hyde-search.js => HydeSearch.js} (100%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 15d317aca77..d9fa574696b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -98,7 +98,7 @@ This serves two purposes:
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
-  - Added support for customizing the search implementation by creating a `resources/js/hyde-search.js` file in https://github.com/hydephp/develop/pull/2030
+  - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2030
 
 ### Deprecated
 
diff --git a/packages/framework/resources/js/hyde-search.js b/packages/framework/resources/js/HydeSearch.js
similarity index 100%
rename from packages/framework/resources/js/hyde-search.js
rename to packages/framework/resources/js/HydeSearch.js
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 0deafcc968a..85289f86dfd 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -31,9 +31,9 @@
     </div>
 
     <script>
-		{!! file_get_contents(file_exists(Hyde::path('resources/js/hyde-search.js')) 
-			? Hyde::path('resources/js/hyde-search.js')
-			: Hyde::vendorPath('resources/js/hyde-search.js')
+		{!! file_get_contents(file_exists(Hyde::path('resources/js/HydeSearch.js')) 
+			? Hyde::path('resources/js/HydeSearch.js')
+			: Hyde::vendorPath('resources/js/HydeSearch.js')
 		) !!}
         
         document.addEventListener('alpine:init', () => {

From 8b6ab34df46eaf1ecc3527245aa2e22d13be610a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 20:09:59 +0100
Subject: [PATCH 3332/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d9fa574696b..510a841eded 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -98,7 +98,7 @@ This serves two purposes:
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
-  - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2030
+  - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
 
 ### Deprecated
 

From 1241a3979d0d718dfaf3dab35251a03adaa07627 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 20:13:12 +0100
Subject: [PATCH 3333/4023] Update app.css

---
 _media/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index 50a96909cf5..95626daf1f5 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From db01c603d812b9286bd8bd6045415e8449cb8800 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 22:56:52 +0100
Subject: [PATCH 3334/4023] Natural language documentation search page header
 generation

---
 RELEASE_NOTES.md                              |  1 +
 .../pages/documentation-search.blade.php      |  9 ++++++++-
 .../Feature/DocumentationSearchPageTest.php   | 20 ++++++++++++++++++-
 3 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d922146fc24..ee6ae37d20c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -72,6 +72,7 @@ This serves two purposes:
 - The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
 - Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
+- The full page documentation search now generates it's heading using smarter natural language processing based on the configured sidebar header in https://github.com/hydephp/develop/pull/2032
 - **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.
     - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
     - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/documentation-search.blade.php
index c50683276d6..9ea0c59474a 100644
--- a/packages/framework/resources/views/pages/documentation-search.blade.php
+++ b/packages/framework/resources/views/pages/documentation-search.blade.php
@@ -1,6 +1,13 @@
 @extends('hyde::layouts.docs')
 @section('content')
-    <h1>Search the documentation site</h1>
+    @php
+        $title = Config::getString('docs.sidebar.header', 'Documentation');
+
+        $searchTitle = str_ends_with(strtolower($title), ' docs')
+            ? 'Search the ' . substr($title, 0, -5) . ' Documentation'
+            : 'Search ' . $title;
+    @endphp
+    <h1>{{ $searchTitle }}</h1>
     <style>#search-menu-button, .edit-page-link {
             display: none !important;
         }
diff --git a/packages/framework/tests/Feature/DocumentationSearchPageTest.php b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
index 2a237064dbc..97badc9ddeb 100644
--- a/packages/framework/tests/Feature/DocumentationSearchPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationSearchPageTest.php
@@ -82,7 +82,7 @@ public function testCanRenderSearchPage()
         $page = new DocumentationSearchPage();
 
         Hyde::shareViewData($page);
-        $this->assertStringContainsString('<h1>Search the documentation site</h1>', $page->compile());
+        $this->assertStringContainsString('<h1>Search the HydePHP Documentation</h1>', $page->compile());
     }
 
     public function testRenderedSearchPageUsesDocumentationPageLayout()
@@ -106,4 +106,22 @@ public function testRenderedSearchPageDoesNotUseSemanticDocumentationMarkup()
         $this->assertStringNotContainsString('<section id="document-main-content"', $html);
         $this->assertStringNotContainsString('<footer id="document-footer"', $html);
     }
+
+    public function testRenderedSearchPageUsesCustomSidebarHeader()
+    {
+        config(['docs.sidebar.header' => 'My Project']);
+        $page = new DocumentationSearchPage();
+
+        Hyde::shareViewData($page);
+        $this->assertStringContainsString('<h1>Search My Project</h1>', $page->compile());
+    }
+
+    public function testRenderedSearchPageExpandsDocsInSidebarHeader()
+    {
+        config(['docs.sidebar.header' => 'Custom Docs']);
+        $page = new DocumentationSearchPage();
+
+        Hyde::shareViewData($page);
+        $this->assertStringContainsString('<h1>Search the Custom Documentation</h1>', $page->compile());
+    }
 }

From a87ac00681d2c83f258d1f27bed81e0fe0e5766e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 16 Nov 2024 23:03:09 +0100
Subject: [PATCH 3335/4023] Move documentation search Blade view to better
 match route structure

---
 RELEASE_NOTES.md                                                | 1 +
 .../{documentation-search.blade.php => docs/search.blade.php}   | 0
 .../Features/Documentation/DocumentationSearchPage.php          | 2 +-
 3 files changed, 2 insertions(+), 1 deletion(-)
 rename packages/framework/resources/views/pages/{documentation-search.blade.php => docs/search.blade.php} (100%)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index ee6ae37d20c..8feb6f52d38 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -73,6 +73,7 @@ This serves two purposes:
 - Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
 - Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
 - The full page documentation search now generates it's heading using smarter natural language processing based on the configured sidebar header in https://github.com/hydephp/develop/pull/2032
+- Moved Blade view `hyde::pages.documentation-search` to `hyde::pages.docs.search` in https://github.com/hydephp/develop/pull/2033
 - **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.
     - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
     - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
diff --git a/packages/framework/resources/views/pages/documentation-search.blade.php b/packages/framework/resources/views/pages/docs/search.blade.php
similarity index 100%
rename from packages/framework/resources/views/pages/documentation-search.blade.php
rename to packages/framework/resources/views/pages/docs/search.blade.php
diff --git a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
index 21c440102e3..9614edc5a46 100644
--- a/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
+++ b/packages/framework/src/Framework/Features/Documentation/DocumentationSearchPage.php
@@ -29,7 +29,7 @@ public function __construct()
             'title' => 'Search',
             'navigation' => ['hidden' => true],
             'article' => false,
-        ], view: 'hyde::pages.documentation-search');
+        ], view: 'hyde::pages.docs.search');
     }
 
     public static function enabled(): bool

From 8c0bddf025785c1cfc41efd63884692542227b23 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 11:00:06 +0100
Subject: [PATCH 3336/4023] Add documentation page smooth scrolling using
 Tailwind

---
 _media/app.css                                             | 2 +-
 packages/framework/resources/views/layouts/docs.blade.php  | 2 +-
 packages/framework/tests/Feature/StaticPageBuilderTest.php | 2 +-
 packages/hydefront/dist/hyde.css                           | 2 +-
 packages/hydefront/dist/hyde.css.map                       | 2 +-
 packages/hydefront/sass/hyde-docs.scss                     | 4 ----
 6 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 95626daf1f5..d879f44afaa 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/layouts/docs.blade.php b/packages/framework/resources/views/layouts/docs.blade.php
index 9476789fd7e..22d3a2a4833 100644
--- a/packages/framework/resources/views/layouts/docs.blade.php
+++ b/packages/framework/resources/views/layouts/docs.blade.php
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="{{ config('hyde.language', 'en') }}">
+<html lang="{{ config('hyde.language', 'en') }}" class="scroll-smooth">
 <head>
     @include('hyde::layouts.head')
 </head>
diff --git a/packages/framework/tests/Feature/StaticPageBuilderTest.php b/packages/framework/tests/Feature/StaticPageBuilderTest.php
index 65cad39ff83..8042597e474 100644
--- a/packages/framework/tests/Feature/StaticPageBuilderTest.php
+++ b/packages/framework/tests/Feature/StaticPageBuilderTest.php
@@ -42,7 +42,7 @@ protected function tearDown(): void
     protected function validateBasicHtml(string $html)
     {
         $this->assertStringContainsString('<!DOCTYPE html>', $html);
-        $this->assertStringContainsString('<html lang="en">', $html);
+        $this->assertStringContainsString('<html lang="en"', $html);
         $this->assertStringContainsString('<head>', $html);
         $this->assertStringContainsString('<title>', $html);
         $this->assertStringContainsString('</title>', $html);
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index 3f3046b20e1..c90cb91fa93 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.0 | MIT License | https://hydephp.com*/
-.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
+.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index a077d60ec13..62833b7a2fd 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/docs/search.scss","../sass/hyde-docs.scss","../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAAA,qBACC,mBAGD,qBACC,gBACA,gBACA,kBAGD,eACC,aCJD,KACC,uBCEC,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCnCF,0EACE","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss","../sass/patches/_typography.scss"],"names":[],"mappings":"AAUE,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC,cCnCF,0EACE","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
index eab5d00fc3a..5dcd8511cd0 100644
--- a/packages/hydefront/sass/hyde-docs.scss
+++ b/packages/hydefront/sass/hyde-docs.scss
@@ -1,7 +1,3 @@
 /**
  * HydeDocs Core CSS
  */
-
-html {
-	scroll-behavior: smooth;
-}

From 8c7a56b09bc145217af8e06619247ae806147dfb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 11:00:49 +0100
Subject: [PATCH 3337/4023] Remove now empty `hyde-docs.scss` file

---
 packages/hydefront/hyde.scss           | 1 -
 packages/hydefront/sass/hyde-docs.scss | 3 ---
 2 files changed, 4 deletions(-)
 delete mode 100644 packages/hydefront/sass/hyde-docs.scss

diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
index c268635823f..81b81a84f47 100644
--- a/packages/hydefront/hyde.scss
+++ b/packages/hydefront/hyde.scss
@@ -6,7 +6,6 @@
  * @author      Caen De Silva
  */
 
-@use 'sass/hyde-docs';
 @use 'sass/markdown/torchlight';
 @use 'sass/markdown/blockquotes';
 @use 'sass/markdown/codeblocks';
diff --git a/packages/hydefront/sass/hyde-docs.scss b/packages/hydefront/sass/hyde-docs.scss
deleted file mode 100644
index 5dcd8511cd0..00000000000
--- a/packages/hydefront/sass/hyde-docs.scss
+++ /dev/null
@@ -1,3 +0,0 @@
-/**
- * HydeDocs Core CSS
- */

From 9598933e0b3d06b743f37c7e2977108df31ccc55 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 12:17:10 +0100
Subject: [PATCH 3338/4023] Update internal HydeFront prod script to be named
 build to match Vite

---
 .github/workflows/continuous-integration.yml | 2 +-
 monorepo/docs/hydefront.md                   | 2 +-
 packages/hydefront/package.json              | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml
index 93bc0135e7b..8bdcf5cc068 100644
--- a/.github/workflows/continuous-integration.yml
+++ b/.github/workflows/continuous-integration.yml
@@ -128,7 +128,7 @@ jobs:
 
       - name: Build assets for production
         working-directory: 'packages/hydefront'
-        run: npm run prod
+        run: npm run build
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
diff --git a/monorepo/docs/hydefront.md b/monorepo/docs/hydefront.md
index 0b31affd451..8b85883da2a 100644
--- a/monorepo/docs/hydefront.md
+++ b/monorepo/docs/hydefront.md
@@ -33,7 +33,7 @@ npm link hydefront
 ```bash
 cd packages/hydefront
 git pull origin master
-npm run prod
+npm run build
 ```
 
 ### Build, version, and publish
diff --git a/packages/hydefront/package.json b/packages/hydefront/package.json
index f0c41d8ad6c..de966a563ae 100644
--- a/packages/hydefront/package.json
+++ b/packages/hydefront/package.json
@@ -3,7 +3,7 @@
   "version": "3.4.1",
   "description": "Frontend assets for HydePHP",
   "scripts": {
-    "prod": "sass hyde.scss dist/hyde.css --style=compressed && php .github/scripts/post-build.php --inject-version",
+    "build": "sass hyde.scss dist/hyde.css --style=compressed && php .github/scripts/post-build.php --inject-version",
     "dev": "sass hyde.scss dist/hyde.css",
     "watch": "sass hyde.scss dist/hyde.css --watch"
   },

From db829ce960d64bb1169161cf2fe460cf263f642f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 12:21:09 +0100
Subject: [PATCH 3339/4023] Sync app stylesheets

---
 packages/hydefront/dist/app.css | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/hydefront/dist/app.css b/packages/hydefront/dist/app.css
index 4f617ecde43..e8a93a566b6 100644
--- a/packages/hydefront/dist/app.css
+++ b/packages/hydefront/dist/app.css
@@ -1,2 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{margin-top:1.25em;max-height:60vh;overflow-y:auto}#search-status{margin-top:0}#sidebar-toggle{display:inline-block;height:2rem;position:relative;width:2rem}#sidebar-toggle span.icon-bar{background-color:#000;display:block;height:2.375px;left:5.5px;position:absolute;transition:all .3s ease-out;width:20px}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-bottom:.35rem;margin-top:.15rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{display:block;margin-left:-2rem;opacity:.825;padding-left:2rem}.table-of-contents a:before{content:"#";font-size:75%;margin-right:4px;opacity:.5;transition:opacity .3s ease-in-out}.table-of-contents a:hover{background-color:hsla(0,0%,50%,.2);opacity:1;transition:opacity,background .3s ease-in-out}.table-of-contents a:hover:before{opacity:1}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink{filter:grayscale(100%);opacity:.75;transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{margin-left:.25rem;opacity:0;padding:0 .25rem;scroll-margin:1rem;transition:opacity .3s ease}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover{filter:unset;opacity:1}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-bottom:1rem;margin-top:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-bottom:1rem;padding-top:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246/var(--tw-border-opacity,1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94/var(--tw-border-opacity,1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11/var(--tw-border-opacity,1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38/var(--tw-border-opacity,1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{float:right;opacity:.5;position:relative;right:.25rem;top:-.25rem;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width:767px){pre>code>.filepath{display:none}}@media screen and (min-width:768px){[x-cloak].x-uncloak-md{display:revert!important}}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}
-/*! tailwindcss v3.4.15 | MIT License | https://tailwindcss.com*/*,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:after,:before{border:0 solid #e5e7eb;box-sizing:border-box}:after,:before{--tw-content:""}:host,html{-webkit-text-size-adjust:100%;font-feature-settings:normal;-webkit-tap-highlight-color:transparent;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-variation-settings:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4}body{line-height:inherit;margin:0}hr{border-top-width:1px;color:inherit;height:0}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-feature-settings:normal;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em;font-variation-settings:normal}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{border-collapse:collapse;border-color:inherit;text-indent:0}button,input,optgroup,select,textarea{font-feature-settings:inherit;color:inherit;font-family:inherit;font-size:100%;font-variation-settings:inherit;font-weight:inherit;letter-spacing:inherit;line-height:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{color:#9ca3af;opacity:1}input::placeholder,textarea::placeholder{color:#9ca3af;opacity:1}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{height:auto;max-width:100%}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em;margin-top:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-bottom:1.2em;margin-top:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-bottom:1.25em;margin-top:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-bottom:1.25em;margin-top:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-bottom:3em;margin-top:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:#80808020;border-inline-start-color:var(--tw-prose-quote-borders);border-inline-start-width:.25rem;border-left-color:#d1d5db;color:unset;font-style:unset;font-weight:500;line-height:1.25em;margin-bottom:1em;margin-top:1em;padding-bottom:.25em;padding-inline-start:1em;padding-left:.75em;padding-top:.25em;quotes:"\201C""\201D""\2018""\2019"}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-bottom:.25em;margin-top:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:2.25em;font-weight:800;line-height:1.1111111;margin-bottom:.8888889em;margin-top:0}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:1.5em;font-weight:700;line-height:1.3333333;margin-bottom:.75em;margin-top:1.5em}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-size:1.25em;font-weight:600;line-height:1.6;margin-bottom:.6em;margin-top:1.6em}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;line-height:1.5;margin-bottom:.5em;margin-top:1.5em}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-bottom:2em;margin-top:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){border-radius:.3125rem;box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px 0 rgb(var(--tw-prose-kbd-shadows)/10%);color:var(--tw-prose-kbd);font-family:inherit;font-size:.875em;font-weight:500;padding-inline-end:.375em;padding-bottom:.1875em;padding-top:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:#80808033;border-radius:4px;color:var(--tw-prose-code);font-size:.875em;font-weight:600;font:unset;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:var(--tw-prose-pre-bg);border-radius:.375rem;color:var(--tw-prose-pre-code);font-size:.875em;font-weight:400;line-height:1.7142857;margin-bottom:1.7142857em;margin-top:1.7142857em;overflow-x:auto;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-top:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,Monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-radius:0;border-width:0;color:inherit;font-family:inherit;font-size:inherit;font-weight:inherit;line-height:inherit;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){font-size:.875em;line-height:1.7142857;margin-bottom:2em;margin-top:2em;table-layout:auto;width:100%}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-color:var(--tw-prose-th-borders);border-bottom-width:1px}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em;vertical-align:bottom}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-color:var(--tw-prose-td-borders);border-bottom-width:1px}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-color:var(--tw-prose-th-borders);border-top-width:1px}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0;margin-top:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgba(0,0,0,.5);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0;margin-top:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.5em;margin-top:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.75em;margin-top:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:.75em;margin-top:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em;margin-top:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-top:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:2em;margin-top:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{clip:rect(0,0,0,0);border-width:0;height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;white-space:nowrap;width:1px}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-bottom:0;margin-top:0}.my-1{margin-bottom:.25rem;margin-top:.25rem}.my-2{margin-bottom:.5rem;margin-top:.5rem}.my-3{margin-bottom:.75rem;margin-top:.75rem}.my-4{margin-bottom:1rem;margin-top:1rem}.my-8{margin-bottom:2rem;margin-top:2rem}.my-auto{margin-bottom:auto;margin-top:auto}.-mb-2{margin-bottom:-.5rem}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0{height:0}.h-1{height:.25rem}.h-16{height:4rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.max-w-xs{max-width:20rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px}.border-b,.border-y{border-bottom-width:1px}.border-b-4{border-bottom-width:4px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235/var(--tw-border-opacity,1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219/var(--tw-border-opacity,1))}.border-indigo-400{--tw-border-opacity:1;border-color:rgb(129 140 248/var(--tw-border-opacity,1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235/var(--tw-border-opacity,1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21/var(--tw-border-opacity,1))}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0/var(--tw-bg-opacity,1))}.bg-black\/5{background-color:rgba(0,0,0,.05)}.bg-black\/50{background-color:rgba(0,0,0,.5)}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity,1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235/var(--tw-bg-opacity,1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity,1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249/var(--tw-bg-opacity,1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity,1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-bottom:0;padding-top:0}.py-1{padding-bottom:.25rem;padding-top:.25rem}.py-12{padding-bottom:3rem;padding-top:3rem}.py-16{padding-bottom:4rem;padding-top:4rem}.py-2{padding-bottom:.5rem;padding-top:.5rem}.py-24{padding-bottom:6rem;padding-top:6rem}.py-3{padding-bottom:.75rem;padding-top:.75rem}.py-32{padding-bottom:8rem;padding-top:8rem}.py-4{padding-bottom:1rem;padding-top:1rem}.py-8{padding-bottom:2rem;padding-top:2rem}.pb-12{padding-bottom:3rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-4{line-height:1rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0/var(--tw-text-opacity,1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity,1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity,1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity,1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity,1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235/var(--tw-text-opacity,1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229/var(--tw-text-opacity,1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgba(0,0,0,.1),0 4px 6px -4px rgba(0,0,0,.1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgba(0,0,0,.1),0 2px 4px -2px rgba(0,0,0,.1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgba(0,0,0,.15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-duration:.15s;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1)}.transition-colors{transition-duration:.15s;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1)}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}[x-cloak]{display:none!important}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:rgba(0,0,0,.1)}.hover\:bg-black\/5:hover{background-color:rgba(0,0,0,.05)}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity,1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39/var(--tw-text-opacity,1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{clip:auto;height:auto;margin:0;overflow:visible;padding:0;position:static;white-space:normal;width:auto}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem;margin-top:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51/var(--tw-border-opacity,1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81/var(--tw-border-opacity,1))}.dark\:bg-black\/10:is(.dark *){background-color:rgba(0,0,0,.1)}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81/var(--tw-bg-opacity,1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55/var(--tw-bg-opacity,1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39/var(--tw-bg-opacity,1))}.dark\:bg-white:is(.dark *){--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity,1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity,1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity,1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248/var(--tw-text-opacity,1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:rgba(0,0,0,.1)}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:flex{display:flex}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgba(0,0,0,.1),0 8px 10px -6px rgba(0,0,0,.1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-bottom:0;margin-top:0}.md\:my-6{margin-bottom:1.5rem;margin-top:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity,1))}.md\:bg-left{background-position:0}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-bottom:0;padding-top:0}.md\:py-16{padding-bottom:4rem;padding-top:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width:1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From 7370623f7f071b8f707b2b87ce9972790e6a92d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 12:51:13 +0100
Subject: [PATCH 3340/4023] Remove the `.torchlight-enabled` CSS class

---
 .../docs/documentation-article.blade.php      |  2 +-
 .../views/components/post/article.blade.php   |  2 +-
 .../resources/views/layouts/page.blade.php    |  2 +-
 packages/hydefront/dist/hyde.css              |  2 +-
 packages/hydefront/dist/hyde.css.map          |  2 +-
 packages/hydefront/hyde.scss                  |  1 -
 .../hydefront/sass/markdown/codeblocks.scss   |  4 ---
 .../hydefront/sass/markdown/torchlight.scss   | 36 -------------------
 tests/fixtures/markdown-features.md           |  2 +-
 9 files changed, 6 insertions(+), 47 deletions(-)
 delete mode 100644 packages/hydefront/sass/markdown/torchlight.scss

diff --git a/packages/framework/resources/views/components/docs/documentation-article.blade.php b/packages/framework/resources/views/components/docs/documentation-article.blade.php
index 56c71641771..a7276818b6a 100644
--- a/packages/framework/resources/views/components/docs/documentation-article.blade.php
+++ b/packages/framework/resources/views/components/docs/documentation-article.blade.php
@@ -5,7 +5,7 @@
 <article id="document" itemscope itemtype="https://schema.org/Article" @class([
         'mx-auto lg:ml-8 max-w-3xl p-12 md:px-16 max-w-[1000px] min-h-[calc(100vh_-_4rem)]',
         config('markdown.prose_classes', 'prose dark:prose-invert'),
-        'torchlight-enabled' => $article && $article->hasTorchlight()])>
+    ])>
     @yield('content')
 
     @if ($article)
diff --git a/packages/framework/resources/views/components/post/article.blade.php b/packages/framework/resources/views/components/post/article.blade.php
index bed0f77e4fc..b3fe6596e25 100644
--- a/packages/framework/resources/views/components/post/article.blade.php
+++ b/packages/framework/resources/views/components/post/article.blade.php
@@ -1,5 +1,5 @@
 <article aria-label="Article" id="{{ $page->identifier }}" itemscope itemtype="https://schema.org/BlogPosting"
-    @class(['post-article mx-auto', config('markdown.prose_classes', 'prose dark:prose-invert'), 'torchlight-enabled' => Features::hasTorchlight()])>
+    @class(['post-article mx-auto', config('markdown.prose_classes', 'prose dark:prose-invert')])>
     <meta itemprop="identifier" content="{{ $page->identifier }}">
     @if($page->getCanonicalUrl() !== null)
         <meta itemprop="url" content="{{ $page->getCanonicalUrl() }}">
diff --git a/packages/framework/resources/views/layouts/page.blade.php b/packages/framework/resources/views/layouts/page.blade.php
index fd529b43ea8..d679ec95bc5 100644
--- a/packages/framework/resources/views/layouts/page.blade.php
+++ b/packages/framework/resources/views/layouts/page.blade.php
@@ -3,7 +3,7 @@
 @section('content')
 
     <main id="content" class="mx-auto max-w-7xl py-16 px-8">
-        <article @class(['mx-auto', config('markdown.prose_classes', 'prose dark:prose-invert'), 'torchlight-enabled' => Features::hasTorchlight()])>
+        <article @class(['mx-auto', config('markdown.prose_classes', 'prose dark:prose-invert')])>
             {{ $content }}
         </article>
     </main>
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index d53fd1ead88..6e870dc7472 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/
-.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}/*# sourceMappingURL=hyde.css.map */
+.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index 81a939aaf70..c97b396a467 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/markdown/torchlight.scss","../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss"],"names":[],"mappings":"AAUE,wBACE,qBACA,gBACA,mBACA,gBACA,UAEA,wCACE,cACA,8BACA,2BACA,sBACA,iBACA,oBAEA,8CACE,kBACA,mBAGF,4GACE,kBC/BR,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAIF,uCACC,WAID,qCACC,mBACC","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAKF,qCACC,mBACC","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
index db34d31125a..71db837ef35 100644
--- a/packages/hydefront/hyde.scss
+++ b/packages/hydefront/hyde.scss
@@ -6,6 +6,5 @@
  * @author      Caen De Silva
  */
 
-@use 'sass/markdown/torchlight';
 @use 'sass/markdown/blockquotes';
 @use 'sass/markdown/codeblocks';
diff --git a/packages/hydefront/sass/markdown/codeblocks.scss b/packages/hydefront/sass/markdown/codeblocks.scss
index dc0cf34f5ed..f8284fdc2d7 100644
--- a/packages/hydefront/sass/markdown/codeblocks.scss
+++ b/packages/hydefront/sass/markdown/codeblocks.scss
@@ -27,10 +27,6 @@ pre>code>.filepath {
 	}
 }
 
-.torchlight-enabled pre>code>.filepath {
-	right: 1rem;
-}
-
 // Hide it on small screens as it tends to overlay the actual code
 @media screen and (max-width: 767px) {
 	pre>code>.filepath {
diff --git a/packages/hydefront/sass/markdown/torchlight.scss b/packages/hydefront/sass/markdown/torchlight.scss
deleted file mode 100644
index ab8f3b53a7f..00000000000
--- a/packages/hydefront/sass/markdown/torchlight.scss
+++ /dev/null
@@ -1,36 +0,0 @@
-/**
- * Styles for Torchlight
- *
- * Uses the styles from https://torchlight.dev/docs/css
- *
- * The .torchlight-enabled class is to not interfere
- * with any pages or sites not using Torchlight.
- */
-
-.torchlight-enabled {
-  pre {
-    border-radius: 0.25rem;
-    margin-top: 1rem;
-    margin-bottom: 1rem;
-    overflow-x: auto;
-    padding: 0;
-
-    code.torchlight {
-      display: block;
-      min-width: -webkit-max-content;
-      min-width: -moz-max-content;
-      min-width: max-content;
-      padding-top: 1rem;
-      padding-bottom: 1rem;
-
-      .line {
-        padding-left: 1rem;
-        padding-right: 1rem;
-      }
-
-      .line-number, .summary-caret {
-        margin-right: 1rem;
-      }
-    }
-  }
-}
diff --git a/tests/fixtures/markdown-features.md b/tests/fixtures/markdown-features.md
index e8314f56195..1d33e4eaaef 100644
--- a/tests/fixtures/markdown-features.md
+++ b/tests/fixtures/markdown-features.md
@@ -22,7 +22,7 @@ echo 'A file path label has been added to the top right corner.';
 
 #### And syntax highlighting
 
-<div class="torchlight-enabled"><pre><code data-theme="material-theme-palenight" data-lang="php" class="torchlight" style="background-color: #292D3E; --theme-selection-background: #00000080;"><div class="line"><span style="color:#3A3F58; text-align: right; -webkit-user-select: none; user-select: none;" class="line-number">1</span><span style="color: #82AAFF;">echo</span><span style="color: #A6ACCD;"> </span><span style="color: #89DDFF;">'</span><span style="color: #C3E88D;">Syntax highlighted by torchlight.dev.</span><span style="color: #89DDFF;">'</span><span style="color: #89DDFF;">;</span></div></code></pre></div>
+<div><pre><code data-theme="material-theme-palenight" data-lang="php" class="torchlight" style="background-color: #292D3E; --theme-selection-background: #00000080;"><div class="line"><span style="color:#3A3F58; text-align: right; -webkit-user-select: none; user-select: none;" class="line-number">1</span><span style="color: #82AAFF;">echo</span><span style="color: #A6ACCD;"> </span><span style="color: #89DDFF;">'</span><span style="color: #C3E88D;">Syntax highlighted by torchlight.dev.</span><span style="color: #89DDFF;">'</span><span style="color: #89DDFF;">;</span></div></code></pre></div>
 
 ---
 

From 9f6aec43325d1cb6571c738a88368ee0172da831 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 12:55:22 +0100
Subject: [PATCH 3341/4023] Move opinionated styles to Tailwind config

---
 _media/app.css                                   |  2 +-
 packages/hydefront/dist/hyde.css                 |  2 +-
 packages/hydefront/dist/hyde.css.map             |  2 +-
 packages/hydefront/sass/markdown/codeblocks.scss | 14 --------------
 tailwind.config.js                               |  6 +++++-
 5 files changed, 8 insertions(+), 18 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index e8a93a566b6..bcde23bdae1 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index 6e870dc7472..b7ace2c00ae 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/
-.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}/*# sourceMappingURL=hyde.css.map */
+.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index c97b396a467..1723114f3c7 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,KACC,eACA,gBACA,mBACA,qBAGD,SACC,cACA,gBAKD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAKF,qCACC,mBACC","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAKF,qCACC,mBACC","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/sass/markdown/codeblocks.scss b/packages/hydefront/sass/markdown/codeblocks.scss
index f8284fdc2d7..f50ae2747a0 100644
--- a/packages/hydefront/sass/markdown/codeblocks.scss
+++ b/packages/hydefront/sass/markdown/codeblocks.scss
@@ -1,17 +1,3 @@
-// Opinionated styles
-
-code {
-	max-width: 80vw;
-	overflow-x: auto;
-	vertical-align: top;
-	word-break: break-all;
-}
-
-pre code {
-	display: block;
-	max-width: unset;
-}
-
 // Filepath labels
 
 pre>code>.filepath {
diff --git a/tailwind.config.js b/tailwind.config.js
index f2bb5c89831..c0f210a5084 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -57,7 +57,11 @@ module.exports = {
                             paddingRight: '4px',
                             marginLeft: '-2px',
                             marginRight: '1px',
-                            borderRadius: '4px'
+                            borderRadius: '4px',
+                            maxWidth: '80vw',
+                            overflowX: 'auto',
+                            verticalAlign: 'top',
+                            wordBreak: 'break-all'
                         },
                         'code::before': {
                             content: 'unset',

From c31543464dd016aa3588d472260a8c780161ccc4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 12:59:34 +0100
Subject: [PATCH 3342/4023] Update Markdown codeblocks to match Torchlight
 background color

Changes the color of Tailwind Typography (Prose) styles on Markdown codeblocks from pure black to #292D3E to match the same color Torchlight uses for consistency.
---
 _media/app.css     | 2 +-
 tailwind.config.js | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index bcde23bdae1..e4ec5bc956c 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/tailwind.config.js b/tailwind.config.js
index c0f210a5084..27736134d63 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -70,6 +70,7 @@ module.exports = {
                             content: 'unset',
                         },
                         pre: {
+                            backgroundColor: '#292D3E',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
                             }

From 23420788b3e29fca863e07a261025d6771b58f4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 13:02:15 +0100
Subject: [PATCH 3343/4023] Match base pre element styles to Torchlight base

---
 _media/app.css     | 2 +-
 tailwind.config.js | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index e4ec5bc956c..1dda2a42ddf 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/tailwind.config.js b/tailwind.config.js
index 27736134d63..b17e52bffad 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -71,6 +71,10 @@ module.exports = {
                         },
                         pre: {
                             backgroundColor: '#292D3E',
+                            borderRadius: '0.25rem',
+                            marginTop: '1rem',
+                            marginBottom: '1rem',
+                            overflowX: 'auto',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
                             }

From fcf8c69a5391472d753f15794467ef6e22961262 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 13:04:30 +0100
Subject: [PATCH 3344/4023] Define Torchlight styles in the Tailwind source
 file

---
 _media/app.css           |  2 +-
 resources/assets/app.css | 16 ++++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index 1dda2a42ddf..cd139c05e3a 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index b00a99e8679..38f86bbf813 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -69,3 +69,19 @@
 .heading-permalink:hover, .heading-permalink:focus {
     @apply opacity-100 grayscale-0;
 }
+
+/**
+ * Torchlight
+ */
+
+pre code.torchlight {
+    @apply block py-4 min-w-max;
+}
+ 
+pre code.torchlight .line {
+    @apply px-4;
+}
+ 
+pre code.torchlight .line-number, pre code.torchlight .summary-caret {
+    @apply mr-4;
+}

From baaf8def677cd16a829192b21c6bf1c0be0fe220 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 13:08:58 +0100
Subject: [PATCH 3345/4023] Normalize padding between normal and Torchlight
 code blocks

---
 _media/app.css           | 2 +-
 resources/assets/app.css | 2 +-
 tailwind.config.js       | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index cd139c05e3a..5839a5a161d 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 38f86bbf813..8f0c64e6e6a 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -75,7 +75,7 @@
  */
 
 pre code.torchlight {
-    @apply block py-4 min-w-max;
+    @apply block py-4 px-0 min-w-max;
 }
  
 pre code.torchlight .line {
diff --git a/tailwind.config.js b/tailwind.config.js
index b17e52bffad..bd2caef5ba3 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -75,8 +75,10 @@ module.exports = {
                             marginTop: '1rem',
                             marginBottom: '1rem',
                             overflowX: 'auto',
+                            padding: '0',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
+                                padding: '0.75rem 1rem',
                             }
                         }
                     },

From db082054f28355088b09aa76d9e37d8abe9dbfc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 13:47:14 +0100
Subject: [PATCH 3346/4023] Refactor code block file path labels to Tailwind

---
 _media/app.css                                |  2 +-
 .../views/components/filepath-label.blade.php |  2 +-
 .../tests/Feature/IncludesFacadeTest.php      |  2 +-
 .../CodeblockFilepathProcessorTest.php        |  8 +++----
 packages/hydefront/dist/hyde.css              |  2 +-
 packages/hydefront/dist/hyde.css.map          |  2 +-
 packages/hydefront/hyde.scss                  |  1 -
 .../hydefront/sass/markdown/codeblocks.scss   | 21 -------------------
 8 files changed, 9 insertions(+), 31 deletions(-)
 delete mode 100644 packages/hydefront/sass/markdown/codeblocks.scss

diff --git a/_media/app.css b/_media/app.css
index 5839a5a161d..53e15535d4d 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index ba7dcacbedf..fe034141cac 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1 +1 @@
-<small class="filepath not-prose"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
+<small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 92ccdd2cb9a..44ac9dbf48f 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -164,7 +164,7 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         <h1>Heading</h1>
         <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
         <blockquote class="info"><p>Info Blockquote</p></blockquote>
-        <pre><code class="language-php"><small class="filepath not-prose"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
+        <pre><code class="language-php"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
         </code></pre>
         <h2>Subheading</h2>
         <ul>
diff --git a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
index 96cd85e6f8e..46b2c773f50 100644
--- a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
@@ -201,7 +201,7 @@ public function testProcessorExpandsFilepathDirectiveInStandardCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="language-html"><small class="filepath not-prose"><span class="sr-only">Filepath: </span>foo.html</small></code></pre>
+        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -215,7 +215,7 @@ public function testProcessorExpandsFilepathDirectiveInTorchlightCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="filepath not-prose"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
+        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -230,7 +230,7 @@ public function testProcessorEscapesHtmlByDefault()
 
         $escaped = e('<a href="">Link</a>');
         $expected = <<<HTML
-        <pre><code class="language-html"><small class="filepath not-prose"><span class="sr-only">Filepath: </span>$escaped</small></code></pre>
+        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>$escaped</small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -246,7 +246,7 @@ public function testProcessorDoesNotEscapeHtmlIfConfigured()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="language-html"><small class="filepath not-prose"><span class="sr-only">Filepath: </span><a href="">Link</a></small></code></pre>
+        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span><a href="">Link</a></small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index b7ace2c00ae..ac645fc265b 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/
-.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}pre>code>.filepath{position:relative;top:-0.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}/*# sourceMappingURL=hyde.css.map */
+.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index 1723114f3c7..11f93f1da10 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss","../sass/markdown/codeblocks.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC,sBCXD,mBACC,kBACA,aACA,aACA,YACA,WACA,wBAEA,yBACC,UAKF,qCACC,mBACC","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
index 71db837ef35..13beccac7a4 100644
--- a/packages/hydefront/hyde.scss
+++ b/packages/hydefront/hyde.scss
@@ -7,4 +7,3 @@
  */
 
 @use 'sass/markdown/blockquotes';
-@use 'sass/markdown/codeblocks';
diff --git a/packages/hydefront/sass/markdown/codeblocks.scss b/packages/hydefront/sass/markdown/codeblocks.scss
deleted file mode 100644
index f50ae2747a0..00000000000
--- a/packages/hydefront/sass/markdown/codeblocks.scss
+++ /dev/null
@@ -1,21 +0,0 @@
-// Filepath labels
-
-pre>code>.filepath {
-	position: relative;
-	top: -.25rem;
-	right: 0.25rem;
-	float: right;
-	opacity: .5;
-	transition: opacity 0.25s;
-
-	&:hover {
-		opacity: 1;
-	}
-}
-
-// Hide it on small screens as it tends to overlay the actual code
-@media screen and (max-width: 767px) {
-	pre>code>.filepath {
-		display: none;
-	}
-}

From 71b5b713fa9a621fd43c4cf5d20034da6315c33b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 13:44:48 +0100
Subject: [PATCH 3347/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0f91edeccc5..801f1e25469 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -101,6 +101,7 @@ This serves two purposes:
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
   - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
+- Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
 
 ### Deprecated
 
@@ -126,6 +127,7 @@ This serves two purposes:
 - **Breaking:** Removed `npm run prod` command (replaced with `npm run build`)
 - Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
+- Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
 
 ### Fixed
 

From 7806047019a14f626da9344b72ed1dab8bf7fe92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 14:13:19 +0100
Subject: [PATCH 3348/4023] Add parameter to dynamically set position for label

---
 _media/app.css                                            | 2 +-
 .../resources/views/components/filepath-label.blade.php   | 2 +-
 .../Markdown/Processing/CodeblockFilepathProcessor.php    | 8 +++++---
 .../Services/Markdown/CodeblockFilepathProcessorTest.php  | 2 +-
 4 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 53e15535d4d..568a1328002 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-2{right:.5rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index fe034141cac..cb5c3ac53a5 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1 +1 @@
-<small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
+<small class="relative top-0 {{ $torchlight ? 'right-2' : 'right-0' }} float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index a757eadb1c7..abc73b97613 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -80,12 +80,13 @@ public static function postprocess(string $html): string
         /** @var int $index */
         foreach ($lines as $index => $line) {
             if (str_starts_with($line, '<!-- HYDE[Filepath]')) {
+                $torchlight = str_contains($html, static::$torchlightKey);
                 $path = static::trimHydeDirective($line);
                 unset($lines[$index]);
                 $codeBlockLine = $index + 1;
-                $label = static::resolveTemplate($path);
+                $label = static::resolveTemplate($path, $torchlight);
 
-                $lines[$codeBlockLine] = str_contains($html, static::$torchlightKey)
+                $lines[$codeBlockLine] = $torchlight
                     ? static::injectLabelToTorchlightCodeLine($label, $lines[$codeBlockLine])
                     : static::injectLabelToCodeLine($label, $lines[$codeBlockLine]);
             }
@@ -112,10 +113,11 @@ protected static function trimHydeDirective(string $line): string
         ));
     }
 
-    protected static function resolveTemplate(string $path): string
+    protected static function resolveTemplate(string $path, bool $torchlight): string
     {
         return View::make('hyde::components.filepath-label', [
             'path' => Config::getBool('markdown.allow_html', false) ? new HtmlString($path) : $path,
+            'torchlight' => $torchlight,
         ])->render();
     }
 
diff --git a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
index 46b2c773f50..49c87701302 100644
--- a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
@@ -215,7 +215,7 @@ public function testProcessorExpandsFilepathDirectiveInTorchlightCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
+        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative top-0 right-2 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));

From 3d54a65cd9156d06d70eab9ea430352d785f8d32 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 14:17:59 +0100
Subject: [PATCH 3349/4023] Scope styles to only inline code spans

---
 _media/app.css     | 2 +-
 tailwind.config.js | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 568a1328002..36b134e4fa9 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-2{right:.5rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-2{right:.5rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/tailwind.config.js b/tailwind.config.js
index bd2caef5ba3..3917ecf7810 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -50,7 +50,7 @@ module.exports = {
                                 content: 'unset',
                             },
                         },
-                        code: {
+                        'code:not(pre code)': {
                             font: 'unset',
                             backgroundColor: '#80808033',
                             paddingLeft: '4px',

From 77af72a453766ee61553fc253536cac81fbb360e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 14:25:12 +0100
Subject: [PATCH 3350/4023] Adjust positioning for Torchlight label

---
 _media/app.css                                                  | 2 +-
 .../resources/views/components/filepath-label.blade.php         | 2 +-
 .../Services/Markdown/CodeblockFilepathProcessorTest.php        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 36b134e4fa9..51ffd79e66b 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-2{right:.5rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index cb5c3ac53a5..fce270fc62d 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1 +1 @@
-<small class="relative top-0 {{ $torchlight ? 'right-2' : 'right-0' }} float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
+<small class="relative {{ $torchlight ? '-top-1 right-3' : 'top-0 right-0' }} float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
index 49c87701302..36d9a7c0261 100644
--- a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
@@ -215,7 +215,7 @@ public function testProcessorExpandsFilepathDirectiveInTorchlightCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative top-0 right-2 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
+        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative -top-1 right-3 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));

From 3a92381384d07620d54ba9b4550acc3baa7ef225 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 14:32:34 +0100
Subject: [PATCH 3351/4023] Refactor to use the class directive

---
 .../resources/views/components/filepath-label.blade.php   | 6 +++++-
 packages/framework/tests/Feature/IncludesFacadeTest.php   | 2 +-
 .../Services/Markdown/CodeblockFilepathProcessorTest.php  | 8 ++++----
 3 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index fce270fc62d..687de3e7c53 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1 +1,5 @@
-<small class="relative {{ $torchlight ? '-top-1 right-3' : 'top-0 right-0' }} float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
+<small @class([
+    'relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block',
+    '-top-1 right-3' => $torchlight,
+    'top-0 right-0' => ! $torchlight,
+])><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 44ac9dbf48f..530ae8c2887 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -164,7 +164,7 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         <h1>Heading</h1>
         <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
         <blockquote class="info"><p>Info Blockquote</p></blockquote>
-        <pre><code class="language-php"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
+        <pre><code class="language-php"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
         </code></pre>
         <h2>Subheading</h2>
         <ul>
diff --git a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
index 36d9a7c0261..021da889fb0 100644
--- a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
@@ -201,7 +201,7 @@ public function testProcessorExpandsFilepathDirectiveInStandardCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small></code></pre>
+        <pre><code class="language-html"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span>foo.html</small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -215,7 +215,7 @@ public function testProcessorExpandsFilepathDirectiveInTorchlightCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative -top-1 right-3 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
+        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block -top-1 right-3"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -230,7 +230,7 @@ public function testProcessorEscapesHtmlByDefault()
 
         $escaped = e('<a href="">Link</a>');
         $expected = <<<HTML
-        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span>$escaped</small></code></pre>
+        <pre><code class="language-html"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span>$escaped</small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));
@@ -246,7 +246,7 @@ public function testProcessorDoesNotEscapeHtmlIfConfigured()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="language-html"><small class="relative top-0 right-0 float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block"><span class="sr-only">Filepath: </span><a href="">Link</a></small></code></pre>
+        <pre><code class="language-html"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span><a href="">Link</a></small></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));

From b2382801e32bba468eb1e609ec964dce20742a7c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:43:10 +0100
Subject: [PATCH 3352/4023] Refactor colored blockquotes styles to Tailwind

---
 _media/app.css                                |  2 +-
 packages/hydefront/dist/hyde.css              |  2 +-
 packages/hydefront/dist/hyde.css.map          |  2 +-
 packages/hydefront/hyde.scss                  |  2 --
 .../hydefront/sass/markdown/blockquotes.scss  | 15 --------------
 resources/assets/app.css                      | 20 +++++++++++++++++++
 6 files changed, 23 insertions(+), 20 deletions(-)
 delete mode 100644 packages/hydefront/sass/markdown/blockquotes.scss

diff --git a/_media/app.css b/_media/app.css
index 51ffd79e66b..8bcdbe09d20 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
index ac645fc265b..00c0ca8187e 100644
--- a/packages/hydefront/dist/hyde.css
+++ b/packages/hydefront/dist/hyde.css
@@ -1,2 +1,2 @@
 /*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/
-.prose blockquote.info{@apply border-blue-500}.prose blockquote.success{@apply border-green-500}.prose blockquote.warning{@apply border-amber-500}.prose blockquote.danger{@apply border-red-600}/*# sourceMappingURL=hyde.css.map */
+/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
index 11f93f1da10..87ddcc7d0d9 100644
--- a/packages/hydefront/dist/hyde.css.map
+++ b/packages/hydefront/dist/hyde.css.map
@@ -1 +1 @@
-{"version":3,"sourceRoot":"","sources":["../sass/markdown/blockquotes.scss"],"names":[],"mappings":"AAAA,uBACC,uBAGD,0BACC,wBAGD,0BACC,wBAGD,yBACC","file":"hyde.css"}
\ No newline at end of file
+{"version":3,"sourceRoot":"","sources":[],"names":[],"mappings":"","file":"hyde.css"}
\ No newline at end of file
diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
index 13beccac7a4..0ecd6b2b5e5 100644
--- a/packages/hydefront/hyde.scss
+++ b/packages/hydefront/hyde.scss
@@ -5,5 +5,3 @@
  * @version     v3.x (HydeFront)
  * @author      Caen De Silva
  */
-
-@use 'sass/markdown/blockquotes';
diff --git a/packages/hydefront/sass/markdown/blockquotes.scss b/packages/hydefront/sass/markdown/blockquotes.scss
deleted file mode 100644
index a2da8438120..00000000000
--- a/packages/hydefront/sass/markdown/blockquotes.scss
+++ /dev/null
@@ -1,15 +0,0 @@
-.prose blockquote.info {
-	@apply border-blue-500;
-}
-
-.prose blockquote.success {
-	@apply border-green-500;
-}
-
-.prose blockquote.warning {
-	@apply border-amber-500;
-}
-
-.prose blockquote.danger {
-	@apply border-red-600;
-}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 8f0c64e6e6a..0563e705f4c 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -85,3 +85,23 @@ pre code.torchlight .line {
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }
+
+/**
+ * Colored Blockquotes
+ */
+
+.prose blockquote.info {
+    @apply border-blue-500;
+}
+
+.prose blockquote.success {
+    @apply border-green-500;
+}
+
+.prose blockquote.warning {
+    @apply border-amber-500;
+}
+
+.prose blockquote.danger {
+    @apply border-red-600;
+}

From 2900eb5dd7d2f9492857e18f5f7e733899c63766 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:46:48 +0100
Subject: [PATCH 3353/4023] Delete hyde.scss

---
 packages/hydefront/hyde.scss | 7 -------
 1 file changed, 7 deletions(-)
 delete mode 100644 packages/hydefront/hyde.scss

diff --git a/packages/hydefront/hyde.scss b/packages/hydefront/hyde.scss
deleted file mode 100644
index 0ecd6b2b5e5..00000000000
--- a/packages/hydefront/hyde.scss
+++ /dev/null
@@ -1,7 +0,0 @@
-/**
- * Core Stylesheet for the HydePHP Frontend
- *
- * @package     HydePHP - HydeFront
- * @version     v3.x (HydeFront)
- * @author      Caen De Silva
- */

From 14f38cef4863b182014f23a14cc935a483435c1f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:46:56 +0100
Subject: [PATCH 3354/4023] Delete hyde.css

---
 packages/hydefront/dist/hyde.css     | 2 --
 packages/hydefront/dist/hyde.css.map | 1 -
 2 files changed, 3 deletions(-)
 delete mode 100644 packages/hydefront/dist/hyde.css
 delete mode 100644 packages/hydefront/dist/hyde.css.map

diff --git a/packages/hydefront/dist/hyde.css b/packages/hydefront/dist/hyde.css
deleted file mode 100644
index 00c0ca8187e..00000000000
--- a/packages/hydefront/dist/hyde.css
+++ /dev/null
@@ -1,2 +0,0 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/
-/*# sourceMappingURL=hyde.css.map */
diff --git a/packages/hydefront/dist/hyde.css.map b/packages/hydefront/dist/hyde.css.map
deleted file mode 100644
index 87ddcc7d0d9..00000000000
--- a/packages/hydefront/dist/hyde.css.map
+++ /dev/null
@@ -1 +0,0 @@
-{"version":3,"sourceRoot":"","sources":[],"names":[],"mappings":"","file":"hyde.css"}
\ No newline at end of file

From e9611092229e66376e28043759a7bd2aa3e0184a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:47:42 +0100
Subject: [PATCH 3355/4023] Remove HydeFront main file

---
 packages/hydefront/package.json | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/hydefront/package.json b/packages/hydefront/package.json
index de966a563ae..16711179c47 100644
--- a/packages/hydefront/package.json
+++ b/packages/hydefront/package.json
@@ -24,6 +24,5 @@
   "homepage": "https://github.com/hydephp/hydefront#readme",
   "devDependencies": {
     "sass": "1.81.0"
-  },
-  "main": "dist/hyde.css"
+  }
 }

From 3be04e5678281bde588bd46826038c37fa308357 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:47:31 +0100
Subject: [PATCH 3356/4023] Remove HydeFront build scripts

---
 packages/hydefront/package.json | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/hydefront/package.json b/packages/hydefront/package.json
index 16711179c47..b26158b21ff 100644
--- a/packages/hydefront/package.json
+++ b/packages/hydefront/package.json
@@ -2,11 +2,6 @@
   "name": "hydefront",
   "version": "3.4.1",
   "description": "Frontend assets for HydePHP",
-  "scripts": {
-    "build": "sass hyde.scss dist/hyde.css --style=compressed && php .github/scripts/post-build.php --inject-version",
-    "dev": "sass hyde.scss dist/hyde.css",
-    "watch": "sass hyde.scss dist/hyde.css --watch"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hydephp/hydefront.git"

From 9926df83d36d7f554b2c5a735c20ba84ac33cff1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:48:50 +0100
Subject: [PATCH 3357/4023] Remove HydeFront dev dependencies

---
 packages/hydefront/package-lock.json | 461 +--------------------------
 packages/hydefront/package.json      |   5 +-
 2 files changed, 2 insertions(+), 464 deletions(-)

diff --git a/packages/hydefront/package-lock.json b/packages/hydefront/package-lock.json
index 95b060d7fb8..622e8ab092a 100644
--- a/packages/hydefront/package-lock.json
+++ b/packages/hydefront/package-lock.json
@@ -7,466 +7,7 @@
     "": {
       "name": "hydefront",
       "version": "3.4.1",
-      "license": "MIT",
-      "devDependencies": {
-        "sass": "1.81.0"
-      }
-    },
-    "node_modules/@parcel/watcher": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher/-/watcher-2.4.1.tgz",
-      "integrity": "sha512-HNjmfLQEVRZmHRET336f20H/8kOozUGwk7yajvsonjNxbj2wBTK1WsQuHkD5yYh9RxFGL2EyDHryOihOwUoKDA==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "detect-libc": "^1.0.3",
-        "is-glob": "^4.0.3",
-        "micromatch": "^4.0.5",
-        "node-addon-api": "^7.0.0"
-      },
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      },
-      "optionalDependencies": {
-        "@parcel/watcher-android-arm64": "2.4.1",
-        "@parcel/watcher-darwin-arm64": "2.4.1",
-        "@parcel/watcher-darwin-x64": "2.4.1",
-        "@parcel/watcher-freebsd-x64": "2.4.1",
-        "@parcel/watcher-linux-arm-glibc": "2.4.1",
-        "@parcel/watcher-linux-arm64-glibc": "2.4.1",
-        "@parcel/watcher-linux-arm64-musl": "2.4.1",
-        "@parcel/watcher-linux-x64-glibc": "2.4.1",
-        "@parcel/watcher-linux-x64-musl": "2.4.1",
-        "@parcel/watcher-win32-arm64": "2.4.1",
-        "@parcel/watcher-win32-ia32": "2.4.1",
-        "@parcel/watcher-win32-x64": "2.4.1"
-      }
-    },
-    "node_modules/@parcel/watcher-android-arm64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-android-arm64/-/watcher-android-arm64-2.4.1.tgz",
-      "integrity": "sha512-LOi/WTbbh3aTn2RYddrO8pnapixAziFl6SMxHM69r3tvdSm94JtCenaKgk1GRg5FJ5wpMCpHeW+7yqPlvZv7kg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "android"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-darwin-arm64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-arm64/-/watcher-darwin-arm64-2.4.1.tgz",
-      "integrity": "sha512-ln41eihm5YXIY043vBrrHfn94SIBlqOWmoROhsMVTSXGh0QahKGy77tfEywQ7v3NywyxBBkGIfrWRHm0hsKtzA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-darwin-x64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-darwin-x64/-/watcher-darwin-x64-2.4.1.tgz",
-      "integrity": "sha512-yrw81BRLjjtHyDu7J61oPuSoeYWR3lDElcPGJyOvIXmor6DEo7/G2u1o7I38cwlcoBHQFULqF6nesIX3tsEXMg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "darwin"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-freebsd-x64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-freebsd-x64/-/watcher-freebsd-x64-2.4.1.tgz",
-      "integrity": "sha512-TJa3Pex/gX3CWIx/Co8k+ykNdDCLx+TuZj3f3h7eOjgpdKM+Mnix37RYsYU4LHhiYJz3DK5nFCCra81p6g050w==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "freebsd"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-linux-arm-glibc": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm-glibc/-/watcher-linux-arm-glibc-2.4.1.tgz",
-      "integrity": "sha512-4rVYDlsMEYfa537BRXxJ5UF4ddNwnr2/1O4MHM5PjI9cvV2qymvhwZSFgXqbS8YoTk5i/JR0L0JDs69BUn45YA==",
-      "cpu": [
-        "arm"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-linux-arm64-glibc": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-glibc/-/watcher-linux-arm64-glibc-2.4.1.tgz",
-      "integrity": "sha512-BJ7mH985OADVLpbrzCLgrJ3TOpiZggE9FMblfO65PlOCdG++xJpKUJ0Aol74ZUIYfb8WsRlUdgrZxKkz3zXWYA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-linux-arm64-musl": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-arm64-musl/-/watcher-linux-arm64-musl-2.4.1.tgz",
-      "integrity": "sha512-p4Xb7JGq3MLgAfYhslU2SjoV9G0kI0Xry0kuxeG/41UfpjHGOhv7UoUDAz/jb1u2elbhazy4rRBL8PegPJFBhA==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-linux-x64-glibc": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-glibc/-/watcher-linux-x64-glibc-2.4.1.tgz",
-      "integrity": "sha512-s9O3fByZ/2pyYDPoLM6zt92yu6P4E39a03zvO0qCHOTjxmt3GHRMLuRZEWhWLASTMSrrnVNWdVI/+pUElJBBBg==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-linux-x64-musl": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-linux-x64-musl/-/watcher-linux-x64-musl-2.4.1.tgz",
-      "integrity": "sha512-L2nZTYR1myLNST0O632g0Dx9LyMNHrn6TOt76sYxWLdff3cB22/GZX2UPtJnaqQPdCRoszoY5rcOj4oMTtp5fQ==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "linux"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-win32-arm64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-arm64/-/watcher-win32-arm64-2.4.1.tgz",
-      "integrity": "sha512-Uq2BPp5GWhrq/lcuItCHoqxjULU1QYEcyjSO5jqqOK8RNFDBQnenMMx4gAl3v8GiWa59E9+uDM7yZ6LxwUIfRg==",
-      "cpu": [
-        "arm64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-win32-ia32": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-ia32/-/watcher-win32-ia32-2.4.1.tgz",
-      "integrity": "sha512-maNRit5QQV2kgHFSYwftmPBxiuK5u4DXjbXx7q6eKjq5dsLXZ4FJiVvlcw35QXzk0KrUecJmuVFbj4uV9oYrcw==",
-      "cpu": [
-        "ia32"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/@parcel/watcher-win32-x64": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@parcel/watcher-win32-x64/-/watcher-win32-x64-2.4.1.tgz",
-      "integrity": "sha512-+DvS92F9ezicfswqrvIRM2njcYJbd5mb9CUgtrHCHmvn7pPPa+nMDRu1o1bYYz/l5IB2NVGNJWiH7h1E58IF2A==",
-      "cpu": [
-        "x64"
-      ],
-      "dev": true,
-      "optional": true,
-      "os": [
-        "win32"
-      ],
-      "engines": {
-        "node": ">= 10.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/parcel"
-      }
-    },
-    "node_modules/braces": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
-      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "fill-range": "^7.1.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/chokidar": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.0.tgz",
-      "integrity": "sha512-mxIojEAQcuEvT/lyXq+jf/3cO/KoA6z4CeNDGGevTybECPOMFCnQy3OPahluUkbqgPNGw5Bi78UC7Po6Lhy+NA==",
-      "dev": true,
-      "dependencies": {
-        "readdirp": "^4.0.1"
-      },
-      "engines": {
-        "node": ">= 14.16.0"
-      },
-      "funding": {
-        "url": "https://paulmillr.com/funding/"
-      }
-    },
-    "node_modules/detect-libc": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-1.0.3.tgz",
-      "integrity": "sha512-pGjwhsmsp4kL2RTz08wcOlGN83otlqHeD/Z5T8GXZB+/YcpQ/dgo+lbU8ZsGxV0HIvqqxo9l7mqYwyYMD9bKDg==",
-      "dev": true,
-      "optional": true,
-      "bin": {
-        "detect-libc": "bin/detect-libc.js"
-      },
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
-    "node_modules/fill-range": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
-      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "to-regex-range": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/immutable": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/immutable/-/immutable-5.0.2.tgz",
-      "integrity": "sha512-1NU7hWZDkV7hJ4PJ9dur9gTNQ4ePNPN4k9/0YhwjzykTi/+3Q5pF93YU5QoVj8BuOnhLgaY8gs0U2pj4kSYVcw==",
-      "dev": true
-    },
-    "node_modules/is-extglob": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
-      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
-      "dev": true,
-      "optional": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-glob": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
-      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "is-extglob": "^2.1.1"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/is-number": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
-      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
-      "dev": true,
-      "optional": true,
-      "engines": {
-        "node": ">=0.12.0"
-      }
-    },
-    "node_modules/micromatch": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
-      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "braces": "^3.0.3",
-        "picomatch": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=8.6"
-      }
-    },
-    "node_modules/node-addon-api": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-7.1.1.tgz",
-      "integrity": "sha512-5m3bsyrjFWE1xf7nz7YXdN4udnVtXK6/Yfgn5qnahL6bCkf2yKt4k3nuTKAtT4r3IG8JNR2ncsIMdZuAzJjHQQ==",
-      "dev": true,
-      "optional": true
-    },
-    "node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
-      "dev": true,
-      "optional": true,
-      "engines": {
-        "node": ">=8.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/jonschlinkert"
-      }
-    },
-    "node_modules/readdirp": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.0.1.tgz",
-      "integrity": "sha512-GkMg9uOTpIWWKbSsgwb5fA4EavTR+SG/PMPoAY8hkhHfEEY0/vqljY+XHqtDf2cr2IJtoNRDbrrEpZUiZCkYRw==",
-      "dev": true,
-      "engines": {
-        "node": ">= 14.16.0"
-      },
-      "funding": {
-        "type": "individual",
-        "url": "https://paulmillr.com/funding/"
-      }
-    },
-    "node_modules/sass": {
-      "version": "1.81.0",
-      "resolved": "https://registry.npmjs.org/sass/-/sass-1.81.0.tgz",
-      "integrity": "sha512-Q4fOxRfhmv3sqCLoGfvrC9pRV8btc0UtqL9mN6Yrv6Qi9ScL55CVH1vlPP863ISLEEMNLLuu9P+enCeGHlnzhA==",
-      "dev": true,
-      "dependencies": {
-        "chokidar": "^4.0.0",
-        "immutable": "^5.0.2",
-        "source-map-js": ">=0.6.2 <2.0.0"
-      },
-      "bin": {
-        "sass": "sass.js"
-      },
-      "engines": {
-        "node": ">=14.0.0"
-      },
-      "optionalDependencies": {
-        "@parcel/watcher": "^2.4.1"
-      }
-    },
-    "node_modules/source-map-js": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.0.tgz",
-      "integrity": "sha512-itJW8lvSA0TXEphiRoawsCksnlf8SyvmFzIhltqAHluXd88pkCd+cXJVHTDwdCr0IzwptSm035IHQktUu1QUMg==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/to-regex-range": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
-      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
-      "dev": true,
-      "optional": true,
-      "dependencies": {
-        "is-number": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=8.0"
-      }
+      "license": "MIT"
     }
   }
 }
diff --git a/packages/hydefront/package.json b/packages/hydefront/package.json
index b26158b21ff..e2ec548480d 100644
--- a/packages/hydefront/package.json
+++ b/packages/hydefront/package.json
@@ -16,8 +16,5 @@
   "bugs": {
     "url": "https://github.com/hydephp/hydefront/issues"
   },
-  "homepage": "https://github.com/hydephp/hydefront#readme",
-  "devDependencies": {
-    "sass": "1.81.0"
-  }
+  "homepage": "https://github.com/hydephp/hydefront#readme"
 }

From 68436ac902ea9745c11387aa1ddbc9ceae815aff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:50:05 +0100
Subject: [PATCH 3358/4023] Remove references to removed hyde.css file

---
 packages/framework/src/Facades/HydeFront.php | 2 +-
 packages/hydefront/README.md                 | 8 +-------
 resources/assets/app.css                     | 2 --
 3 files changed, 2 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 9f3c4135ff6..055b0fd3fe4 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -35,7 +35,7 @@ public static function version(): string
     /**
      * Get the CDN link for a specific file.
      *
-     * @param  'app.css'|'hyde.css'|'hyde.css.map'  $file
+     * @param  'app.css'  $file
      *
      * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
      */
diff --git a/packages/hydefront/README.md b/packages/hydefront/README.md
index 21517a74cc2..e5bca415dad 100644
--- a/packages/hydefront/README.md
+++ b/packages/hydefront/README.md
@@ -13,14 +13,8 @@ Contains the frontend assets for HydePHP.
 
 ### About the files
 
-- **Hyde.css**:
-The Hyde stylesheet contains a small set of styles that don't make sense to use with Tailwind, or that belong to generated content that is harder to modify.
-
-Normally, this file is imported into the main.css file.
-
 - **App.css**:
-A compiled and minified file containing the TailwindCSS styles for a base Hyde installation. It includes the Hyde.css file. This file is identical to what one would get by running `npm run build` in a new HydePHP project (which incidentally is exactly how this file is generated).
-
+A compiled and minified file containing the TailwindCSS styles for a base Hyde installation. This file is identical to what one would get by running `npm run build` in a new HydePHP project (which incidentally is exactly how this file is generated).
 
 ## Usage
 
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 0563e705f4c..cedf75629fc 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,8 +11,6 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import 'hydefront/dist/hyde.css';
-
 @tailwind base;
 @tailwind components;
 @tailwind utilities;

From 6a0b6381800de98b8ca1e59360aca980d531c09a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:50:34 +0100
Subject: [PATCH 3359/4023] Deprecate helper method which may become obsolete

---
 packages/framework/src/Facades/HydeFront.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 055b0fd3fe4..d7bd2ca8810 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -35,6 +35,8 @@ public static function version(): string
     /**
      * Get the CDN link for a specific file.
      *
+     * @deprecated This method may be removed before the final v2.0 release as there is now currently only one file available.
+     *
      * @param  'app.css'  $file
      *
      * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.

From 0bd07ed6afb1d16e5170ba02257e6d38d5c2f939 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:52:05 +0100
Subject: [PATCH 3360/4023] Update script for removed hyde.css file

---
 .../hydefront/.github/scripts/post-build.php  | 31 +------------------
 1 file changed, 1 insertion(+), 30 deletions(-)

diff --git a/packages/hydefront/.github/scripts/post-build.php b/packages/hydefront/.github/scripts/post-build.php
index 6af4f339e1a..f32d3c4fa2f 100644
--- a/packages/hydefront/.github/scripts/post-build.php
+++ b/packages/hydefront/.github/scripts/post-build.php
@@ -33,18 +33,7 @@
     if ($this->hasOption('inject-version')) {
         $package = json_decode(file_get_contents($baseDir.'package.json'), true);
         $version = $package['version'];
-        $css = file_get_contents($baseDir.'dist/hyde.css');
-
-        if (str_contains($css, '/*! HydeFront')) {
-            $this->error('Version already injected in dist/hyde.css');
-            return 1;
-        }
-
-        $template = '/*! HydeFront v{{ $version }} | MIT License | https://hydephp.com*/';
-        $versionString = str_replace('{{ $version }}', $version, $template);
-        $css = "$versionString\n$css";
-        file_put_contents($baseDir.'dist/hyde.css', $css);
-
+        
         return 0;
     }
 
@@ -55,23 +44,12 @@
     $version = $package['version'];
     $this->line("Found version '$version' in package.json");
 
-    $hydeCssVersion = getCssVersion($baseDir.'dist/hyde.css');
-    $this->line("Found version '$hydeCssVersion' in dist/hyde.css");
-
     $appCssVersion = getCssVersion($baseDir.'dist/app.css');
     $this->line("Found version '$appCssVersion' in dist/app.css");
 
     if ($this->hasOption('fix')) {
         $this->info('Fixing build files...');
 
-        if ($version !== $hydeCssVersion) {
-            $this->line(' > Updating dist/hyde.css...');
-            $contents = file_get_contents($baseDir.'dist/hyde.css');
-            $contents = str_replace($hydeCssVersion, $version, $contents);
-            file_put_contents($baseDir.'dist/hyde.css', $contents);
-            $filesChanged = true;
-        }
-
         if ($version !== $appCssVersion) {
             $this->line(' > Updating dist/app.css...');
             $contents = file_get_contents($baseDir.'dist/app.css');
@@ -82,7 +60,6 @@
 
         if (isset($filesChanged)) {
             $this->info('Build files fixed');
-
             $this->info('Tip: You may want to verify the changes again.');
         } else {
             $this->warning('Nothing to fix!');
@@ -90,12 +67,6 @@
         return 0;
     }
 
-    if ($version !== $hydeCssVersion) {
-        $this->error('Version mismatch in package.json and dist/hyde.css:');
-        $this->warning("Expected hyde.css to have version '$version', but found '$hydeCssVersion'");
-        $exitCode = 1;
-    }
-
     if ($version !== $appCssVersion) {
         $this->error('Version mismatch in package.json and dist/app.css:');
         $this->warning("Expected app.css to have version '$version', but found '$appCssVersion'");

From 14387ab4efe9e727afb60d0ca8659aeee790f5e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:52:32 +0100
Subject: [PATCH 3361/4023] Rebuild Tailwind assets without HydeFront

---
 _media/app.css                  | 2 +-
 packages/hydefront/dist/app.css | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 8bcdbe09d20..79b885b934b 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/dist/app.css b/packages/hydefront/dist/app.css
index e8a93a566b6..79b885b934b 100644
--- a/packages/hydefront/dist/app.css
+++ b/packages/hydefront/dist/app.css
@@ -1 +1 @@
-/*! HydeFront v3.4.1 | MIT License | https://hydephp.com*/.hyde-search-context{margin-bottom:10px}.hyde-search-results{max-height:60vh;overflow-y:auto;margin-top:1.25em}#search-status{margin-top:0}#sidebar-toggle{position:relative;display:inline-block;width:2rem;height:2rem}#sidebar-toggle span.icon-bar{display:block;width:20px;height:2.375px;background-color:#000;position:absolute;left:5.5px;transition:all .3s ease-out}#sidebar-toggle span.icon-bar:first-child{top:9px}#sidebar-toggle span.icon-bar:nth-child(2),#sidebar-toggle span.icon-bar:nth-child(3){top:15px;transform-origin:center}#sidebar-toggle span.icon-bar:last-child{top:21px}#sidebar-toggle.active span.icon-bar:first-child{opacity:0}#sidebar-toggle.active span.icon-bar:nth-child(2){transform:rotate(45deg)}#sidebar-toggle.active span.icon-bar:nth-child(3){transform:rotate(-45deg)}#sidebar-toggle.active span.icon-bar:last-child{opacity:0}.dark #sidebar-toggle span.icon-bar{background-color:#fff;height:2px}.table-of-contents>li{margin-top:.15rem;margin-bottom:.35rem}.table-of-contents a{display:block;padding-left:2rem;margin-left:-2rem;opacity:.825}.table-of-contents a:before{content:"#";font-size:75%;opacity:.5;margin-right:4px;transition:opacity .3s ease-in-out}.table-of-contents a:hover{opacity:1;transition:opacity,background .3s ease-in-out;background-color:#80808033}#hyde-docs .prose h1,#hyde-docs .prose h2,#hyde-docs .prose h3,#hyde-docs .prose h4,#hyde-docs .prose h5,#hyde-docs .prose h6{width:-moz-fit-content;width:fit-content}#hyde-docs .prose h1:hover .heading-permalink,#hyde-docs .prose h1:focus .heading-permalink,#hyde-docs .prose h2:hover .heading-permalink,#hyde-docs .prose h2:focus .heading-permalink,#hyde-docs .prose h3:hover .heading-permalink,#hyde-docs .prose h3:focus .heading-permalink,#hyde-docs .prose h4:hover .heading-permalink,#hyde-docs .prose h4:focus .heading-permalink,#hyde-docs .prose h5:hover .heading-permalink,#hyde-docs .prose h5:focus .heading-permalink,#hyde-docs .prose h6:hover .heading-permalink,#hyde-docs .prose h6:focus .heading-permalink{opacity:.75;filter:grayscale(100%);transition:opacity .1s ease-out}#hyde-docs .prose h1 .heading-permalink,#hyde-docs .prose h2 .heading-permalink,#hyde-docs .prose h3 .heading-permalink,#hyde-docs .prose h4 .heading-permalink,#hyde-docs .prose h5 .heading-permalink,#hyde-docs .prose h6 .heading-permalink{opacity:0;margin-left:.25rem;transition:opacity .3s ease;padding:0 .25rem;scroll-margin:1rem}#hyde-docs .prose h1 .heading-permalink:before,#hyde-docs .prose h2 .heading-permalink:before,#hyde-docs .prose h3 .heading-permalink:before,#hyde-docs .prose h4 .heading-permalink:before,#hyde-docs .prose h5 .heading-permalink:before,#hyde-docs .prose h6 .heading-permalink:before{content:"#"}#hyde-docs .prose h1 .heading-permalink:hover,#hyde-docs .prose h1 .heading-permalink:focus,#hyde-docs .prose h2 .heading-permalink:hover,#hyde-docs .prose h2 .heading-permalink:focus,#hyde-docs .prose h3 .heading-permalink:hover,#hyde-docs .prose h3 .heading-permalink:focus,#hyde-docs .prose h4 .heading-permalink:hover,#hyde-docs .prose h4 .heading-permalink:focus,#hyde-docs .prose h5 .heading-permalink:hover,#hyde-docs .prose h5 .heading-permalink:focus,#hyde-docs .prose h6 .heading-permalink:hover,#hyde-docs .prose h6 .heading-permalink:focus{opacity:1;filter:unset}html{scroll-behavior:smooth}.torchlight-enabled pre{border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;overflow-x:auto;padding:0}.torchlight-enabled pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem}.torchlight-enabled pre code.torchlight .line{padding-left:1rem;padding-right:1rem}.torchlight-enabled pre code.torchlight .line-number,.torchlight-enabled pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity:1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity:1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity:1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity:1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}code{max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}pre code{display:block;max-width:unset}pre>code>.filepath{position:relative;top:-.25rem;right:.25rem;float:right;opacity:.5;transition:opacity .25s}pre>code>.filepath:hover{opacity:1}.torchlight-enabled pre>code>.filepath{right:1rem}@media screen and (max-width: 767px){pre>code>.filepath{display:none}}@media screen and (min-width: 768px){[x-cloak].x-uncloak-md{display:revert!important}}*,:before,:after{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgb(59 130 246 / .5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em;font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:var(--tw-prose-pre-bg);overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1.7142857em;margin-bottom:1.7142857em;border-radius:.375rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body:#374151;--tw-prose-headings:#111827;--tw-prose-lead:#4b5563;--tw-prose-links:#111827;--tw-prose-bold:#111827;--tw-prose-counters:#6b7280;--tw-prose-bullets:#d1d5db;--tw-prose-hr:#e5e7eb;--tw-prose-quotes:#111827;--tw-prose-quote-borders:#e5e7eb;--tw-prose-captions:#6b7280;--tw-prose-kbd:#111827;--tw-prose-kbd-shadows:17 24 39;--tw-prose-code:#111827;--tw-prose-pre-code:#e5e7eb;--tw-prose-pre-bg:#1f2937;--tw-prose-th-borders:#d1d5db;--tw-prose-td-borders:#e5e7eb;--tw-prose-invert-body:#d1d5db;--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:#9ca3af;--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:#9ca3af;--tw-prose-invert-bullets:#4b5563;--tw-prose-invert-hr:#374151;--tw-prose-invert-quotes:#f3f4f6;--tw-prose-invert-quote-borders:#374151;--tw-prose-invert-captions:#9ca3af;--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:#d1d5db;--tw-prose-invert-pre-bg:rgb(0 0 0 / 50%);--tw-prose-invert-th-borders:#4b5563;--tw-prose-invert-td-borders:#374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate:-45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate:45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity:1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity:1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity:1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity:1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity:1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity:1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity:1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity:1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow:0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content:"#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale:grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content:"#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale:grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity:1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity:1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity:1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity:1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity:1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity:1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity:1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity:1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity:1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity:1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity:1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity:1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From cea9e1fd2852a6291ae4ef396a58bbd90438af93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 15:59:18 +0100
Subject: [PATCH 3362/4023] Simplify script as the build file no longer needs
 to be verified

---
 .../hydefront/.github/scripts/post-build.php  | 69 +------------------
 1 file changed, 1 insertion(+), 68 deletions(-)

diff --git a/packages/hydefront/.github/scripts/post-build.php b/packages/hydefront/.github/scripts/post-build.php
index f32d3c4fa2f..d7ef81f2e89 100644
--- a/packages/hydefront/.github/scripts/post-build.php
+++ b/packages/hydefront/.github/scripts/post-build.php
@@ -25,76 +25,9 @@
                 return 1;
             } else {
                 $this->info('Root package lock verified. All looks good!');
-                $this->line();
             }
         }
     }
 
-    if ($this->hasOption('inject-version')) {
-        $package = json_decode(file_get_contents($baseDir.'package.json'), true);
-        $version = $package['version'];
-        
-        return 0;
-    }
-
-    $this->info('Verifying build files...');
-    $exitCode = 0;
-
-    $package = json_decode(file_get_contents($baseDir.'package.json'), true);
-    $version = $package['version'];
-    $this->line("Found version '$version' in package.json");
-
-    $appCssVersion = getCssVersion($baseDir.'dist/app.css');
-    $this->line("Found version '$appCssVersion' in dist/app.css");
-
-    if ($this->hasOption('fix')) {
-        $this->info('Fixing build files...');
-
-        if ($version !== $appCssVersion) {
-            $this->line(' > Updating dist/app.css...');
-            $contents = file_get_contents($baseDir.'dist/app.css');
-            $contents = str_replace($appCssVersion, $version, $contents);
-            file_put_contents($baseDir.'dist/app.css', $contents);
-            $filesChanged = true;
-        }
-
-        if (isset($filesChanged)) {
-            $this->info('Build files fixed');
-            $this->info('Tip: You may want to verify the changes again.');
-        } else {
-            $this->warning('Nothing to fix!');
-        }
-        return 0;
-    }
-
-    if ($version !== $appCssVersion) {
-        $this->error('Version mismatch in package.json and dist/app.css:');
-        $this->warning("Expected app.css to have version '$version', but found '$appCssVersion'");
-        $exitCode = 1;
-    }
-
-    if ($exitCode > 0) {
-        $this->error('Exiting with errors.');
-    } else {
-        $this->info('Build files verified. All looks good!');
-    }
-
-    return $exitCode;
+    return 0;
 }));
-
-function getCssVersion(string $path): string
-{
-    $contents = file_get_contents($path);
-    $prefix = '/*! HydeFront v';
-    if (! str_starts_with($contents, $prefix)) {
-        throw new Exception('Invalid CSS file');
-    }
-    $contents = substr($contents, strlen($prefix));
-    // Get everything before  |
-    $pipePos = strpos($contents, '|');
-    if ($pipePos === false) {
-        throw new Exception('Invalid CSS file');
-    }
-    $contents = substr($contents, 0, $pipePos);
-    return trim($contents);
-}

From 6d2090f952245f39880c91dbb6eadc57df143fa0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:03:47 +0100
Subject: [PATCH 3363/4023] Remove removed option usage

Script verified to still work
---
 packages/hydefront/.github/scripts/version.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/hydefront/.github/scripts/version.php b/packages/hydefront/.github/scripts/version.php
index da8a0a96138..3d73d80bdd6 100644
--- a/packages/hydefront/.github/scripts/version.php
+++ b/packages/hydefront/.github/scripts/version.php
@@ -45,7 +45,7 @@
 
     $this->info('Updating version in dist files...');
     $this->line('---');
-    passthru('php packages/hydefront/.github/scripts/post-build.php --fix --skip-root-version-check', $fixExitCode);
+    passthru('php packages/hydefront/.github/scripts/post-build.php --skip-root-version-check', $fixExitCode);
     if ($fixExitCode !== 0) {
         $this->error('Failed to update version in dist files');
         FileBackupHelper::restore();

From ae435afa4bdb102a723a1b59ae6fa45c908d55e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:05:45 +0100
Subject: [PATCH 3364/4023] Update tests for removed hyde.css file

---
 .../framework/tests/Unit/Facades/HydeFrontFacadeTest.php  | 6 +++---
 .../tests/Unit/Views/StylesComponentViewTest.php          | 8 --------
 2 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index 2ac04884afe..a5af3c68d29 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -39,10 +39,10 @@ public function testCdnLinkReturnsCorrectUrl()
         $this->assertSame($expected, HydeFront::cdnLink('styles.css'));
     }
 
-    public function testCdnLinkReturnsCorrectUrlForHydeCss()
+    public function testCdnLinkReturnsCorrectUrlForArbitraryCss()
     {
-        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/hyde.css';
-        $this->assertSame($expected, HydeFront::cdnLink('hyde.css'));
+        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/arbitrary.css';
+        $this->assertSame($expected, HydeFront::cdnLink('arbitrary.css'));
     }
 
     public function testCdnLinkReturnsCorrectUrlForInvalidFile()
diff --git a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
index 95fb7a2ee09..de956a753aa 100644
--- a/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/StylesComponentViewTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit\Views;
 
-use Hyde\Facades\Filesystem;
 use Hyde\Facades\HydeFront;
 use Hyde\Hyde;
 use Hyde\Support\Facades\Render;
@@ -88,11 +87,4 @@ public function testComponentDoesNotRenderLinkToLocalAppCssWhenCdnLinkIsEnabledI
         config(['hyde.load_app_styles_from_cdn' => true]);
         $this->assertStringNotContainsString('<link rel="stylesheet" href="media/app.css"', $this->renderTestView());
     }
-
-    public function testComponentDoesNotRenderCdnLinkWhenALocalFileExists()
-    {
-        Filesystem::touch('_media/hyde.css');
-        $this->assertStringNotContainsString('https://cdn.jsdelivr.net/npm/hydefront', $this->renderTestView());
-        Filesystem::unlink('_media/hyde.css');
-    }
 }

From 6e5bed4416480421a25fe6260541bb74380e75e6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:08:16 +0100
Subject: [PATCH 3365/4023] Remove removed build steps from internal
 documentation

---
 monorepo/docs/hydefront.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/monorepo/docs/hydefront.md b/monorepo/docs/hydefront.md
index 8b85883da2a..cdc19cfb214 100644
--- a/monorepo/docs/hydefront.md
+++ b/monorepo/docs/hydefront.md
@@ -1,6 +1,6 @@
 # Internal HydeFront documentation
 
-## Building and creating a new HydeFront version
+## Creating a new HydeFront version
 
 ### Prerequisites
 
@@ -28,15 +28,14 @@ cd ../../
 npm link hydefront
 ```
 
-### Build and setup
+### Setup
 
 ```bash
 cd packages/hydefront
 git pull origin master
-npm run build
 ```
 
-### Build, version, and publish
+### Version and publish
 
 Head back to the monorepo root and run the following command to bump the version of the HydeFront package:
 

From 2034b015586d5dc222a960fba8209aaee10607a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:14:31 +0100
Subject: [PATCH 3366/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 801f1e25469..e692d7fc7fd 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -128,6 +128,7 @@ This serves two purposes:
 - Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
   - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
 - Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
+- Removed The `hyde.css` file from HydeFront in https://github.com/hydephp/develop/pull/2037 as all styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024.
 
 ### Fixed
 
@@ -145,6 +146,10 @@ This serves two purposes:
 - Simplified the asset file locator to only serve files from the media source directory in https://github.com/hydephp/develop/pull/2012
 - Added Vite HMR support in https://github.com/hydephp/develop/pull/2016
 
+#### HydeFront
+
+- Removed the `hyde.css` file in https://github.com/hydephp/develop/pull/2037 as all its styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024
+
 ### Upgrade Guide
 
 Please see the "Breaking changes & upgrade guide" section below for more information.

From 9f443304a576ed5f6e750de90f9c712600dfa4b9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:16:08 +0100
Subject: [PATCH 3367/4023] Remove HydeFront assets build step

---
 .github/workflows/continuous-integration.yml | 35 --------------------
 1 file changed, 35 deletions(-)

diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml
index 8bdcf5cc068..56d82e0519a 100644
--- a/.github/workflows/continuous-integration.yml
+++ b/.github/workflows/continuous-integration.yml
@@ -109,41 +109,6 @@ jobs:
         run: php monorepo/scripts/tests/${{ matrix.script }}.php
 
 
-  build-hydefront-assets:
-
-    runs-on: ubuntu-latest
-    needs: run-smoke-tests
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          cache: 'npm'
-
-      - name: Install Node.js dependencies
-        working-directory: 'packages/hydefront'
-        run: npm ci
-
-      - name: Build assets for production
-        working-directory: 'packages/hydefront'
-        run: npm run build
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: 'hydefront'
-          path: 'packages/hydefront/dist'
-
-      - name: Commit changes
-        uses: EndBug/add-and-commit@v9
-        with:
-          add: 'packages/hydefront/dist'
-          message: 'Compile HydeFront assets for production'
-          new_branch: compile-hydefront
-
-
   build-tailwindcss:
 
     runs-on: ubuntu-latest

From a12b5652c295f3769c80943a8f660ef259fb47d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 16:16:49 +0100
Subject: [PATCH 3368/4023] Remove HydeFront workflows as there is no longer
 anything to build

---
 .../.github/workflows/dependency-review.yml   | 20 ----------
 .../hydefront/.github/workflows/devskim.yml   | 34 ----------------
 .../hydefront/.github/workflows/node.js.yml   | 39 -------------------
 3 files changed, 93 deletions(-)
 delete mode 100644 packages/hydefront/.github/workflows/dependency-review.yml
 delete mode 100644 packages/hydefront/.github/workflows/devskim.yml
 delete mode 100644 packages/hydefront/.github/workflows/node.js.yml

diff --git a/packages/hydefront/.github/workflows/dependency-review.yml b/packages/hydefront/.github/workflows/dependency-review.yml
deleted file mode 100644
index 0e72a00efcd..00000000000
--- a/packages/hydefront/.github/workflows/dependency-review.yml
+++ /dev/null
@@ -1,20 +0,0 @@
-# Dependency Review Action
-#
-# This Action will scan dependency manifest files that change as part of a Pull Reqest, surfacing known-vulnerable versions of the packages declared or updated in the PR. Once installed, if the workflow run is marked as required, PRs introducing known-vulnerable packages will be blocked from merging.
-#
-# Source repository: https://github.com/actions/dependency-review-action
-# Public documentation: https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review#dependency-review-enforcement
-name: 'Dependency Review'
-on: [pull_request]
-
-permissions:
-  contents: read
-
-jobs:
-  dependency-review:
-    runs-on: ubuntu-latest
-    steps:
-      - name: 'Checkout Repository'
-        uses: actions/checkout@v3
-      - name: 'Dependency Review'
-        uses: actions/dependency-review-action@v1
diff --git a/packages/hydefront/.github/workflows/devskim.yml b/packages/hydefront/.github/workflows/devskim.yml
deleted file mode 100644
index b77d398ac0a..00000000000
--- a/packages/hydefront/.github/workflows/devskim.yml
+++ /dev/null
@@ -1,34 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-
-name: DevSkim
-
-on:
-  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]
-  schedule:
-    - cron: '24 18 * * 1'
-
-jobs:
-  lint:
-    name: DevSkim
-    runs-on: ubuntu-20.04
-    permissions:
-      actions: read
-      contents: read
-      security-events: write
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-
-      - name: Run DevSkim scanner
-        uses: microsoft/DevSkim-Action@v1
-
-      - name: Upload DevSkim scan results to GitHub Security tab
-        uses: github/codeql-action/upload-sarif@v2
-        with:
-          sarif_file: devskim-results.sarif
diff --git a/packages/hydefront/.github/workflows/node.js.yml b/packages/hydefront/.github/workflows/node.js.yml
deleted file mode 100644
index e4b668cbf0e..00000000000
--- a/packages/hydefront/.github/workflows/node.js.yml
+++ /dev/null
@@ -1,39 +0,0 @@
-# This workflow will do a clean installation of node dependencies, cache/restore them, build the compiled assets, and push them.
-# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
-
-name: Build Assets
-
-on:
-  push:
-    branches: [ master ]
-
-jobs:
-  build-assets:
-
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v3
-        with:
-          cache: 'npm'
-
-      - name: Install Node.js dependencies
-        run: npm ci
-
-      - name: Build assets for production
-        run: npm run build
-
-      - name: Upload artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: 'assets'
-          path: 'dist'
-
-      - name: Push assets to GitHub
-        uses: EndBug/add-and-commit@v9
-        with:
-          add: 'dist'
-          message: 'Update assets'

From 62397534c4559821e97a27cc78004ef87ecfe0fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 17:36:33 +0100
Subject: [PATCH 3369/4023] Remove linting workflow with no effect from the
 subpackage

---
 packages/hydefront/.github/workflows/lint.yml | 20 -------------------
 1 file changed, 20 deletions(-)
 delete mode 100644 packages/hydefront/.github/workflows/lint.yml

diff --git a/packages/hydefront/.github/workflows/lint.yml b/packages/hydefront/.github/workflows/lint.yml
deleted file mode 100644
index 59e3406b6c0..00000000000
--- a/packages/hydefront/.github/workflows/lint.yml
+++ /dev/null
@@ -1,20 +0,0 @@
-name: Lint
-
-on:
-  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]
-
-jobs:
-  lint:
-    name: Lint
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-
-      - name: Run linter
-        run: php .github/scripts/post-build.php

From 79ae75fbd6c8b4cc914388c11bfdb2e4570ddf21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 17:37:16 +0100
Subject: [PATCH 3370/4023] Remove badge for removed workflow

---
 packages/hydefront/README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/hydefront/README.md b/packages/hydefront/README.md
index e5bca415dad..602f446895a 100644
--- a/packages/hydefront/README.md
+++ b/packages/hydefront/README.md
@@ -4,7 +4,6 @@
 [![NPM Downloads](https://img.shields.io/npm/dm/hydefront)](https://www.npmjs.com/package/hydefront)
 [![GitHub package.json version](https://img.shields.io/github/package-json/v/hydephp/hydefront)](https://github.com/hydephp/hydefront)
 [![NPM Version](https://img.shields.io/npm/v/hydefront)](https://www.npmjs.com/package/hydefront)
-[![Build & Push CI](https://github.com/hydephp/hydefront/actions/workflows/node.js.yml/badge.svg)](https://github.com/hydephp/hydefront/actions/workflows/node.js.yml)
 
 
 ## About this repository

From 4aee3cd9023e0e749540cea1ec224f6fb6233ca7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 17:38:20 +0100
Subject: [PATCH 3371/4023] Delete HydeFront-v4-plan.md

---
 HydeFront-v4-plan.md | 117 -------------------------------------------
 1 file changed, 117 deletions(-)
 delete mode 100644 HydeFront-v4-plan.md

diff --git a/HydeFront-v4-plan.md b/HydeFront-v4-plan.md
deleted file mode 100644
index cae5e99fee6..00000000000
--- a/HydeFront-v4-plan.md
+++ /dev/null
@@ -1,117 +0,0 @@
-# HydeFront v4 Development Plan
-
-## Abstract
-
-We are updating how HydeFront is handled for v2. Instead of declaring styles directly in HydeFront alongside Tailwind, we will refactor those styles into Tailwind. 
-
-HydeFront will serve two main purposes:  
-
-1. It will continue to include the precompiled `app.css` file bundled with new apps, available through the HydeFront CDN.  
-2. It will act as a component library, allowing users to include granular styles from `app.css`, which we will preconfigure.  
-
-For example, users can include our Tailwind styles granularly using just the `app.css` file from the HydeFront package. This file will be compiled alongside Tailwind. If users prefer customization, they can remove the import and add the specific styles they want.  
-
-## Refactoring Plan
-
-### 1. Restructure HydeFront Package
-- Create a new directory structure in HydeFront:
-  ```
-  hydefront/
-  ├── dist/
-  │   └── app.css       # Pre-compiled styles for CDN
-  ├── components/       # New component-based structure
-  │   ├── base/        # Base styles
-  │   ├── docs/        # Documentation styles
-  │   ├── markdown/    # Markdown styles
-  │   └── utilities/   # Utility styles
-  └── package.json
-  ```
-
-### 2. Convert SCSS to Tailwind Components
-- Convert existing SCSS styles from `hyde.scss` (reference: `packages/hydefront/hyde.scss`) into Tailwind components
-- Create separate files for each component category that can be imported individually
-- Example component structure:
-  ```javascript
-  // components/docs.js
-  module.exports = {
-    '.docs-sidebar': {
-      '@apply ...': {},
-    }
-  }
-  ```
-
-### 3. Update Build Process
-- Modify the Vite configuration (reference: `vite.config.js`) to handle component-based builds
-- Update the build scripts in package.json to:
-  - Build individual components
-  - Generate the complete app.css for CDN distribution
-  - Add new script for component-based builds
-
-### 4. Update Framework Integration
-Key files to modify:
-
-```blade
-// packages/framework/resources/views/layouts/styles.blade.php
-{{-- Prevent Alpine.js flashes --}}
-<style>[x-cloak] {display: none!important}</style>
-
-{{-- The compiled Tailwind/App styles --}}
-@if(Vite::running())
-    {{ Vite::assets(['resources/assets/app.css']) }}
-@else
-    @if(config('hyde.load_app_styles_from_cdn', false))
-        <link rel="stylesheet" href="{{ HydeFront::cdnLink('app.css') }}">
-    @elseif(Asset::exists('app.css'))
-        <link rel="stylesheet" href="{{ Asset::get('app.css') }}">
-    @endif
-
-
-    {{-- Dynamic TailwindCSS Play CDN --}}
-    @if(config('hyde.use_play_cdn', false))
-        <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
-        <script>tailwind.config = { {!! HydeFront::injectTailwindConfig() !!} }</script>
-        <script>console.warn('The HydePHP TailwindCSS Play CDN is enabled. This is for development purposes only and should not be used in production.', 'See https://hydephp.com/docs/1.x/managing-assets');</script>
-    @endif
-@endif
-
-{{-- Add any extra styles to include after the others --}}
-@stack('styles')
-```
-
-
-### 5. Documentation Updates
-- Update the asset management documentation
-- Create new documentation for component-based usage
-- Update the HydeFront README (reference: `packages/hydefront/README.md`)
-
-### 6. Migration Path
-1. Create a new major version branch
-2. Keep existing functionality working while adding new component system
-3. Provide migration guide for users moving from v1 to v2
-4. Update the Hyde starter template to use new component system
-
-### 7. Configuration Updates
-- Update the Hyde configuration (reference: `config/hyde.php`) to support component-based imports
-- Add new configuration options for granular style inclusion
-
-### 8. Testing Strategy
-1. Create tests for individual components
-2. Test CDN distribution
-3. Test backward compatibility layer
-4. Test integration with Hyde framework
-
-### 9. Implementation Phases
-1. **Phase 1**: Create new component structure
-2. **Phase 2**: Convert existing styles
-3. **Phase 3**: Update build system
-4. **Phase 4**: Update framework integration
-5. **Phase 5**: Documentation and migration guide
-6. **Phase 6**: Testing and refinement
-
-### 10. Breaking Changes to Document
-- New import syntax for granular components
-- Changes to configuration structure
-- Updates to asset compilation process
-- CDN usage changes
-
-This plan maintains backward compatibility through the CDN while providing a more flexible component-based approach for customization. The changes align with modern frontend practices while keeping Hyde's simplicity.

From 13f2c703ba1d283005737211abb1c75c51303bf4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 17:47:41 +0100
Subject: [PATCH 3372/4023] Extract HydeFront partials

---
 _media/app.css                                |  2 +-
 packages/hydefront/components/blockquotes.css | 15 +++
 .../components/heading-permalinks.css         | 20 ++++
 .../components/table-of-contents.css          | 23 +++++
 packages/hydefront/components/torchlight.css  | 11 +++
 resources/assets/app.css                      | 96 ++-----------------
 6 files changed, 76 insertions(+), 91 deletions(-)
 create mode 100644 packages/hydefront/components/blockquotes.css
 create mode 100644 packages/hydefront/components/heading-permalinks.css
 create mode 100644 packages/hydefront/components/table-of-contents.css
 create mode 100644 packages/hydefront/components/torchlight.css

diff --git a/_media/app.css b/_media/app.css
index 79b885b934b..6721010d07b 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/components/blockquotes.css b/packages/hydefront/components/blockquotes.css
new file mode 100644
index 00000000000..133ef9dfc5d
--- /dev/null
+++ b/packages/hydefront/components/blockquotes.css
@@ -0,0 +1,15 @@
+.prose blockquote.info {
+    @apply border-blue-500;
+}
+
+.prose blockquote.success {
+    @apply border-green-500;
+}
+
+.prose blockquote.warning {
+    @apply border-amber-500;
+}
+
+.prose blockquote.danger {
+    @apply border-red-600;
+}
diff --git a/packages/hydefront/components/heading-permalinks.css b/packages/hydefront/components/heading-permalinks.css
new file mode 100644
index 00000000000..c1add8ef904
--- /dev/null
+++ b/packages/hydefront/components/heading-permalinks.css
@@ -0,0 +1,20 @@
+.prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {
+    @apply w-fit;
+}
+
+.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,
+.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink {
+    @apply opacity-75 grayscale transition-opacity duration-100 ease-out;
+}
+
+.heading-permalink {
+    @apply opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 scroll-m-4;
+}
+
+.heading-permalink::before {
+    @apply content-['#'];
+}
+
+.heading-permalink:hover, .heading-permalink:focus {
+    @apply opacity-100 grayscale-0;
+}
diff --git a/packages/hydefront/components/table-of-contents.css b/packages/hydefront/components/table-of-contents.css
new file mode 100644
index 00000000000..bdbb63750eb
--- /dev/null
+++ b/packages/hydefront/components/table-of-contents.css
@@ -0,0 +1,23 @@
+.table-of-contents {
+    @apply pb-3;
+}
+
+.table-of-contents > li {
+    @apply my-[0.35rem];
+}
+
+.table-of-contents ul {
+    @apply pl-2;
+}
+
+.table-of-contents a {
+    @apply block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative;
+}
+
+.table-of-contents a::before {
+    @apply content-['#'] text-[75%] opacity-50 mr-1 transition-opacity duration-300;
+}
+
+.table-of-contents a:hover::before {
+    @apply opacity-100;
+}
diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
new file mode 100644
index 00000000000..2a783cf90a7
--- /dev/null
+++ b/packages/hydefront/components/torchlight.css
@@ -0,0 +1,11 @@
+pre code.torchlight {
+    @apply block py-4 px-0 min-w-max;
+}
+
+pre code.torchlight .line {
+    @apply px-4;
+}
+
+pre code.torchlight .line-number, pre code.torchlight .summary-caret {
+    @apply mr-4;
+}
\ No newline at end of file
diff --git a/resources/assets/app.css b/resources/assets/app.css
index cedf75629fc..ad19564d278 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -5,101 +5,17 @@
 * The HydeFront package contains some base styles to make your site look even more amazing.
 *
 * The compiled result of this file is shipped with HydePHP and is found at _media/app.css,
-* so you don't need to compile this file unless you're making changes.
+* so you don't need to compile this file unless you're making changes to the Tailwind.
 *
 * If you want, you can load the compiled file with minified styles for a base install from the CDN.
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
+@import 'hydefront/components/table-of-contents.css';
+@import 'hydefront/components/heading-permalinks.css';
+@import 'hydefront/components/torchlight.css';
+@import 'hydefront/components/blockquotes.css';
+
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
-
-/**
- * Documentation Pages - Table of Contents
- */
-
-.table-of-contents {
-    @apply pb-3;
-}
-
-.table-of-contents > li {
-    @apply my-[0.35rem];
-}
-
-.table-of-contents ul {
-    @apply pl-2;
-}
-
-.table-of-contents a {
-    @apply block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative;
-}
-
-.table-of-contents a::before {
-    @apply content-['#'] text-[75%] opacity-50 mr-1 transition-opacity duration-300;
-}
-
-.table-of-contents a:hover::before {
-    @apply opacity-100;
-}
-
-/**
- * Documentation Pages - Heading Permalinks
- */
-
-.prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {
-    @apply w-fit;
-}
-
-.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,
-.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink {
-    @apply opacity-75 grayscale transition-opacity duration-100 ease-out;
-}
-
-.heading-permalink {
-    @apply opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 scroll-m-4;
-}
-
-.heading-permalink::before {
-    @apply content-['#'];
-}
-
-.heading-permalink:hover, .heading-permalink:focus {
-    @apply opacity-100 grayscale-0;
-}
-
-/**
- * Torchlight
- */
-
-pre code.torchlight {
-    @apply block py-4 px-0 min-w-max;
-}
- 
-pre code.torchlight .line {
-    @apply px-4;
-}
- 
-pre code.torchlight .line-number, pre code.torchlight .summary-caret {
-    @apply mr-4;
-}
-
-/**
- * Colored Blockquotes
- */
-
-.prose blockquote.info {
-    @apply border-blue-500;
-}
-
-.prose blockquote.success {
-    @apply border-green-500;
-}
-
-.prose blockquote.warning {
-    @apply border-amber-500;
-}
-
-.prose blockquote.danger {
-    @apply border-red-600;
-}

From 16fa89c331a904a617ef92699c70195ca73cb751 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 17:54:00 +0100
Subject: [PATCH 3373/4023] Add component styles in the components layer to
 ensure proper precedence

---
 _media/app.css           |  2 +-
 resources/assets/app.css | 12 +++++++-----
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 6721010d07b..21ee5f6d3b2 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+@import"hydefront/components/table-of-contents.css";@import"hydefront/components/heading-permalinks.css";@import"hydefront/components/torchlight.css";@import"hydefront/components/blockquotes.css";*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index ad19564d278..76386afaa8a 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,11 +11,13 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import 'hydefront/components/table-of-contents.css';
-@import 'hydefront/components/heading-permalinks.css';
-@import 'hydefront/components/torchlight.css';
-@import 'hydefront/components/blockquotes.css';
-
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
+
+@layer components {
+    @import 'hydefront/components/table-of-contents.css';
+    @import 'hydefront/components/heading-permalinks.css';
+    @import 'hydefront/components/torchlight.css';
+    @import 'hydefront/components/blockquotes.css';
+}

From 93e0b54d32566000585c72a9908247c440daba4b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:01:31 +0100
Subject: [PATCH 3374/4023] Update managing-assets.md

---
 docs/creating-content/managing-assets.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index e26479b09f2..ca3b1c0aca3 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -13,7 +13,7 @@ With Hyde, **you don't have to do it**, in fact, you can skip this entire page i
 But as always with Hyde, you can customize everything if you want to.
 
 Hyde ships with a complete frontend using Blade views, TailwindCSS styles, and Alpine.js interactions.
-Some extra custom styles are made in the HydeFront package, which is pre-installed and bundled in the pre-configured Tailwind and Vite setup.
+Some extra component styles are organized into modular files in the HydeFront package, which is pre-installed and bundled in the pre-configured Tailwind and Vite setup.
 
 To get you started quickly, all the styles are already compiled and minified into `_media/app.css`,
 which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.
@@ -26,7 +26,7 @@ No, it is optional. All the compiled styles that you need are already installed,
 
 ### When Should Assets be Compiled?
 
-The `_media/app.css` file that comes with Hyde contains TailwindCSS for all classes that are used in the default Blade views, as well as the HydeFront custom styles.
+The `_media/app.css` file that comes with Hyde contains TailwindCSS for all classes that are used in the default Blade views, as well as the HydeFront component styles.
 If you want to customize the Tailwind settings or add custom styles, you will need to recompile the styles yourself.
 
 For example, if you customize the Blade views and add new classes or add new classes in Blade-based pages, you may need to compile the assets yourself to get the new styles.

From f1cc135dbd21715a69c64e5d03b97dba12f7b12a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:06:51 +0100
Subject: [PATCH 3375/4023] Update managing-assets.md

---
 docs/creating-content/managing-assets.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index ca3b1c0aca3..dc84cc013d5 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -66,6 +66,12 @@ When running the `npm run dev/prod` command, Vite will compile the `resources/as
 
 The compiled assets will then be automatically copied to `_site/media` when you run `php hyde build`.
 
+### Customizing HydeFront Components
+
+HydeFront components are modular and can be easily customized to fit your needs.
+
+You can either remove the import of the component you want to customize and replace it with your own styles, or keep the import and add overriding styles after it (since CSS cascade order matters).
+
 ## Telling Hyde where to find assets
 
 ### Customizing the Blade templates

From 0d12c515aea99b0fd870e63e58d4bd70cd4f37c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:19:39 +0100
Subject: [PATCH 3376/4023] Revert "Add component styles in the components
 layer to ensure proper precedence"

This reverts commit 16fa89c331a904a617ef92699c70195ca73cb751.
---
 _media/app.css           |  2 +-
 resources/assets/app.css | 12 +++++-------
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 21ee5f6d3b2..6721010d07b 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-@import"hydefront/components/table-of-contents.css";@import"hydefront/components/heading-permalinks.css";@import"hydefront/components/torchlight.css";@import"hydefront/components/blockquotes.css";*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 76386afaa8a..ad19564d278 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,13 +11,11 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
+@import 'hydefront/components/table-of-contents.css';
+@import 'hydefront/components/heading-permalinks.css';
+@import 'hydefront/components/torchlight.css';
+@import 'hydefront/components/blockquotes.css';
+
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
-
-@layer components {
-    @import 'hydefront/components/table-of-contents.css';
-    @import 'hydefront/components/heading-permalinks.css';
-    @import 'hydefront/components/torchlight.css';
-    @import 'hydefront/components/blockquotes.css';
-}

From 7d631f3525c8a4863e7890a9b2ffe24ed8cca869 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:22:21 +0100
Subject: [PATCH 3377/4023] Normalize formatting

---
 packages/hydefront/components/torchlight.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index 2a783cf90a7..2a24ece7de1 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -8,4 +8,4 @@ pre code.torchlight .line {
 
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
-}
\ No newline at end of file
+}

From 13be44babdf05e183e00f8eece9cb1222baa719b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:46:01 +0100
Subject: [PATCH 3378/4023] Tweak Tailwind setup for more stable cascade

---
 _media/app.css     | 2 +-
 tailwind.config.js | 7 ++++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 6721010d07b..b089e0f3fa4 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(pre:has(code.torchlight)):not(:where([class~=not-prose],[class~=not-prose] *)){padding:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/tailwind.config.js b/tailwind.config.js
index 3917ecf7810..b82ec6c4300 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -75,11 +75,12 @@ module.exports = {
                             marginTop: '1rem',
                             marginBottom: '1rem',
                             overflowX: 'auto',
-                            padding: '0',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
-                                padding: '0.75rem 1rem',
-                            }
+                            },
+                        },
+                        'pre:has(code.torchlight)': {
+                            padding: '0',
                         }
                     },
                 },

From 8838fe002609854156c337edaf78151890fe78ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:52:19 +0100
Subject: [PATCH 3379/4023] Simplify styling setup to not need cascade at all

---
 _media/app.css                               | 2 +-
 packages/hydefront/components/torchlight.css | 6 +-----
 tailwind.config.js                           | 3 ---
 3 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index b089e0f3fa4..5a661333f0e 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.prose :where(pre:has(code.torchlight)):not(:where([class~=not-prose],[class~=not-prose] *)){padding:0}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index 2a24ece7de1..31da6bdba6c 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,9 +1,5 @@
 pre code.torchlight {
-    @apply block py-4 px-0 min-w-max;
-}
-
-pre code.torchlight .line {
-    @apply px-4;
+    @apply block min-w-max;
 }
 
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
diff --git a/tailwind.config.js b/tailwind.config.js
index b82ec6c4300..c171ebbc622 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -79,9 +79,6 @@ module.exports = {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
                             },
                         },
-                        'pre:has(code.torchlight)': {
-                            padding: '0',
-                        }
                     },
                 },
                 invert: {

From 9304b312689ca4bd4e3757dcc9483187e50f7f82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:54:42 +0100
Subject: [PATCH 3380/4023] Remove style rule with no effect

---
 packages/hydefront/components/torchlight.css | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index 31da6bdba6c..f9327ba1066 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,7 +1,3 @@
-pre code.torchlight {
-    @apply block min-w-max;
-}
-
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }

From eabe05b6a36132668bb4e887b4df83ba9169b4ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 18:59:32 +0100
Subject: [PATCH 3381/4023] Tweak positioning for changed styles

---
 _media/app.css                                                  | 2 +-
 .../resources/views/components/filepath-label.blade.php         | 2 +-
 .../Services/Markdown/CodeblockFilepathProcessorTest.php        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 5a661333f0e..4dbcde0aaad 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index 687de3e7c53..5161bb4d183 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1,5 +1,5 @@
 <small @class([
     'relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block',
-    '-top-1 right-3' => $torchlight,
+    '-top-1 right-1' => $torchlight,
     'top-0 right-0' => ! $torchlight,
 ])><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
index 021da889fb0..294d439da6c 100644
--- a/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/CodeblockFilepathProcessorTest.php
@@ -215,7 +215,7 @@ public function testProcessorExpandsFilepathDirectiveInTorchlightCodeblock()
         HTML;
 
         $expected = <<<'HTML'
-        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block -top-1 right-3"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
+        <pre><code class="torchlight"><!-- Syntax highlighted by torchlight.dev --><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block -top-1 right-1"><span class="sr-only">Filepath: </span>foo.html</small><div class="line"><span class="line-number">1</span>&nbsp;</div></code></pre>
         HTML;
 
         $this->assertSame($expected, CodeblockFilepathProcessor::postprocess($html));

From 353987ecb80bbf2d9cfeb8de56e585178ee75c5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:02:44 +0100
Subject: [PATCH 3382/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index e692d7fc7fd..0c99bebd0c6 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -102,6 +102,7 @@ This serves two purposes:
   - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
   - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
 - Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
+- Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
 
 ### Deprecated
 
@@ -149,6 +150,7 @@ This serves two purposes:
 #### HydeFront
 
 - Removed the `hyde.css` file in https://github.com/hydephp/develop/pull/2037 as all its styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024
+- Extracted CSS component partials in https://github.com/hydephp/develop/pull/2038
 
 ### Upgrade Guide
 

From 649bbe95f4b71e31739bb335c1c83fee0aad8664 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:03:24 +0100
Subject: [PATCH 3383/4023] Improve wording

---
 resources/assets/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/resources/assets/app.css b/resources/assets/app.css
index ad19564d278..15c2af459e2 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -5,7 +5,7 @@
 * The HydeFront package contains some base styles to make your site look even more amazing.
 *
 * The compiled result of this file is shipped with HydePHP and is found at _media/app.css,
-* so you don't need to compile this file unless you're making changes to the Tailwind.
+* so you don't need to compile this file unless you're making changes to Tailwind styles.
 *
 * If you want, you can load the compiled file with minified styles for a base install from the CDN.
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn

From 6ac8c27e6854ea33b838dcaf3b7d18f45ac33764 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:07:41 +0100
Subject: [PATCH 3384/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 0c99bebd0c6..adeaec2f58c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -103,6 +103,7 @@ This serves two purposes:
   - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
 - Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
 - Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
+- Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
 
 ### Deprecated
 

From 7e65fd6f4e5f73646f9d890966ccdd24053c0613 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:08:17 +0100
Subject: [PATCH 3385/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index adeaec2f58c..e06c71e46c9 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -150,6 +150,7 @@ This serves two purposes:
 
 #### HydeFront
 
+- Removed all Sass styles after porting everything to Tailwind in https://github.com/hydephp/develop/pull/2024
 - Removed the `hyde.css` file in https://github.com/hydephp/develop/pull/2037 as all its styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024
 - Extracted CSS component partials in https://github.com/hydephp/develop/pull/2038
 

From e3a63c2a728016ba3e206a4af999092aad7f0e22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:12:58 +0100
Subject: [PATCH 3386/4023] Support Torchlight focusing

---
 packages/hydefront/components/torchlight.css | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index f9327ba1066..e8b8b5c9e91 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,3 +1,16 @@
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }
+
+/* Focusing */
+
+.torchlight.has-focus-lines .line:not(.line-focus) {
+    transition: filter 0.35s, opacity 0.35s;
+    filter: blur(.095rem);
+    opacity: .65;
+}
+ 
+.torchlight.has-focus-lines:hover .line:not(.line-focus) {
+    filter: blur(0px);
+    opacity: 1;
+}

From 013a2e56a92a70a9c017bf1f118c0de2d9b3a1a0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:16:17 +0100
Subject: [PATCH 3387/4023] Support Torchlight collapsing

---
 packages/hydefront/components/torchlight.css | 37 ++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index e8b8b5c9e91..3455d235184 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -14,3 +14,40 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     filter: blur(0px);
     opacity: 1;
 }
+
+/* Collapsing */
+
+.torchlight summary:focus {
+    outline: none;
+}
+
+.torchlight details > summary::marker,
+.torchlight details > summary::-webkit-details-marker {
+    display: none;
+}
+
+.torchlight details .summary-caret::after {
+    pointer-events: none;
+}
+
+.torchlight .summary-caret-empty::after,
+.torchlight details .summary-caret-middle::after,
+.torchlight details .summary-caret-end::after {
+    content: " ";
+}
+
+.torchlight details[open] .summary-caret-start::after {
+    content: "-";
+}
+
+.torchlight details:not([open]) .summary-caret-start::after {
+    content: "+";
+}
+
+.torchlight details[open] .summary-hide-when-open {
+    display: none;
+}
+
+.torchlight details:not([open]) .summary-hide-when-open {
+    display: initial;
+}

From c0a38d489be416101b8013a43ab2522cff8a449f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:28:25 +0100
Subject: [PATCH 3388/4023] Style Torchlight links

---
 packages/hydefront/components/torchlight.css | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index 3455d235184..c077babc18f 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -2,6 +2,12 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }
 
+/* Autolinking */
+
+.torchlight-link {
+    text-decoration: underline!important;
+}
+
 /* Focusing */
 
 .torchlight.has-focus-lines .line:not(.line-focus) {

From 5350920ad66edbc89d3b86fac8630af6e6be1d01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:28:51 +0100
Subject: [PATCH 3389/4023] Increase selector specificity instead of important

---
 packages/hydefront/components/torchlight.css | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index c077babc18f..425d7ab840d 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -4,8 +4,9 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
 
 /* Autolinking */
 
+.prose .torchlight-link,
 .torchlight-link {
-    text-decoration: underline!important;
+    text-decoration: underline;
 }
 
 /* Focusing */

From 238156dcb70458d351dfe90f45cde380c4c75af5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:47:52 +0100
Subject: [PATCH 3390/4023] Compile assets

---
 _media/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index 4dbcde0aaad..35362e27f64 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:none}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:initial}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From abeef13135baf179aa7c6180bfd4d65c3ed4de72 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 17 Nov 2024 19:52:45 +0100
Subject: [PATCH 3391/4023] Split out extended Torchlight styles

---
 _media/app.css                                |  2 +-
 .../hydefront/components/torchlight/base.css  | 29 +++++++++++++++++++
 .../extended.css}                             | 28 ++++--------------
 resources/assets/app.css                      |  2 +-
 4 files changed, 36 insertions(+), 25 deletions(-)
 create mode 100644 packages/hydefront/components/torchlight/base.css
 rename packages/hydefront/components/{torchlight.css => torchlight/extended.css} (61%)

diff --git a/_media/app.css b/_media/app.css
index 35362e27f64..a418eb5826d 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:none}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:initial}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/components/torchlight/base.css b/packages/hydefront/components/torchlight/base.css
new file mode 100644
index 00000000000..2382a3db367
--- /dev/null
+++ b/packages/hydefront/components/torchlight/base.css
@@ -0,0 +1,29 @@
+/**
+ * Base styles for Torchlight.
+ * 
+ * You can also import the extended styles in `extended.css` to support advanced features like collapsing.
+ */
+
+pre code.torchlight .line-number, pre code.torchlight .summary-caret {
+    @apply mr-4;
+}
+
+/* Autolinking */
+
+.prose .torchlight-link,
+.torchlight-link {
+    text-decoration: underline;
+}
+
+/* Focusing */
+
+.torchlight.has-focus-lines .line:not(.line-focus) {
+    transition: filter 0.35s, opacity 0.35s;
+    filter: blur(.095rem);
+    opacity: .65;
+}
+ 
+.torchlight.has-focus-lines:hover .line:not(.line-focus) {
+    filter: blur(0px);
+    opacity: 1;
+}
diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight/extended.css
similarity index 61%
rename from packages/hydefront/components/torchlight.css
rename to packages/hydefront/components/torchlight/extended.css
index 425d7ab840d..4fad7ece61e 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight/extended.css
@@ -1,26 +1,8 @@
-pre code.torchlight .line-number, pre code.torchlight .summary-caret {
-    @apply mr-4;
-}
-
-/* Autolinking */
-
-.prose .torchlight-link,
-.torchlight-link {
-    text-decoration: underline;
-}
-
-/* Focusing */
-
-.torchlight.has-focus-lines .line:not(.line-focus) {
-    transition: filter 0.35s, opacity 0.35s;
-    filter: blur(.095rem);
-    opacity: .65;
-}
- 
-.torchlight.has-focus-lines:hover .line:not(.line-focus) {
-    filter: blur(0px);
-    opacity: 1;
-}
+/**
+ * Extended styles for Torchlight.
+ *
+ * You should also import the base styles in `base.css`.
+ */
 
 /* Collapsing */
 
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 15c2af459e2..4ecc8ffbe28 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -13,7 +13,7 @@
 
 @import 'hydefront/components/table-of-contents.css';
 @import 'hydefront/components/heading-permalinks.css';
-@import 'hydefront/components/torchlight.css';
+@import 'hydefront/components/torchlight/base.css';
 @import 'hydefront/components/blockquotes.css';
 
 @tailwind base;

From 038d1d885afee1e6e069dc7e5ef4fa46de9d6b53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Nov 2024 16:20:31 +0100
Subject: [PATCH 3392/4023] Cleanup formatting

---
 packages/hydefront/components/torchlight/base.css     | 7 +------
 packages/hydefront/components/torchlight/extended.css | 7 ++-----
 2 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/packages/hydefront/components/torchlight/base.css b/packages/hydefront/components/torchlight/base.css
index 2382a3db367..40fb752063e 100644
--- a/packages/hydefront/components/torchlight/base.css
+++ b/packages/hydefront/components/torchlight/base.css
@@ -8,15 +8,10 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }
 
-/* Autolinking */
-
-.prose .torchlight-link,
-.torchlight-link {
+.prose .torchlight-link, .torchlight-link {
     text-decoration: underline;
 }
 
-/* Focusing */
-
 .torchlight.has-focus-lines .line:not(.line-focus) {
     transition: filter 0.35s, opacity 0.35s;
     filter: blur(.095rem);
diff --git a/packages/hydefront/components/torchlight/extended.css b/packages/hydefront/components/torchlight/extended.css
index 4fad7ece61e..7755dd1f231 100644
--- a/packages/hydefront/components/torchlight/extended.css
+++ b/packages/hydefront/components/torchlight/extended.css
@@ -10,8 +10,7 @@
     outline: none;
 }
 
-.torchlight details > summary::marker,
-.torchlight details > summary::-webkit-details-marker {
+.torchlight details > summary::marker, .torchlight details > summary::-webkit-details-marker {
     display: none;
 }
 
@@ -19,9 +18,7 @@
     pointer-events: none;
 }
 
-.torchlight .summary-caret-empty::after,
-.torchlight details .summary-caret-middle::after,
-.torchlight details .summary-caret-end::after {
+.torchlight .summary-caret-empty::after, .torchlight details .summary-caret-middle::after, .torchlight details .summary-caret-end::after {
     content: " ";
 }
 

From 5ee67c42ab994caf6970c872f0c57b01897ccf60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 20 Nov 2024 16:24:08 +0100
Subject: [PATCH 3393/4023] Use Tailwind apply where possible

---
 _media/app.css                                        |  2 +-
 packages/hydefront/components/torchlight/base.css     |  4 ++--
 packages/hydefront/components/torchlight/extended.css | 10 +++++-----
 packages/hydefront/dist/app.css                       |  2 +-
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index a418eb5826d..8cc270c5bc4 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/components/torchlight/base.css b/packages/hydefront/components/torchlight/base.css
index 40fb752063e..4f4f2bbda7e 100644
--- a/packages/hydefront/components/torchlight/base.css
+++ b/packages/hydefront/components/torchlight/base.css
@@ -9,7 +9,7 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
 }
 
 .prose .torchlight-link, .torchlight-link {
-    text-decoration: underline;
+    @apply underline;
 }
 
 .torchlight.has-focus-lines .line:not(.line-focus) {
@@ -20,5 +20,5 @@ pre code.torchlight .line-number, pre code.torchlight .summary-caret {
  
 .torchlight.has-focus-lines:hover .line:not(.line-focus) {
     filter: blur(0px);
-    opacity: 1;
+    @apply opacity-100;
 }
diff --git a/packages/hydefront/components/torchlight/extended.css b/packages/hydefront/components/torchlight/extended.css
index 7755dd1f231..faf07363923 100644
--- a/packages/hydefront/components/torchlight/extended.css
+++ b/packages/hydefront/components/torchlight/extended.css
@@ -7,15 +7,15 @@
 /* Collapsing */
 
 .torchlight summary:focus {
-    outline: none;
+    @apply outline-none;
 }
 
 .torchlight details > summary::marker, .torchlight details > summary::-webkit-details-marker {
-    display: none;
+    @apply hidden;
 }
 
 .torchlight details .summary-caret::after {
-    pointer-events: none;
+    @apply pointer-events-none;
 }
 
 .torchlight .summary-caret-empty::after, .torchlight details .summary-caret-middle::after, .torchlight details .summary-caret-end::after {
@@ -31,9 +31,9 @@
 }
 
 .torchlight details[open] .summary-hide-when-open {
-    display: none;
+    @apply hidden;
 }
 
 .torchlight details:not([open]) .summary-hide-when-open {
-    display: initial;
+    @apply block;
 }
diff --git a/packages/hydefront/dist/app.css b/packages/hydefront/dist/app.css
index 79b885b934b..8cc270c5bc4 100644
--- a/packages/hydefront/dist/app.css
+++ b/packages/hydefront/dist/app.css
@@ -1 +1 @@
-*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-inline-end:1.1428571em;padding-inline-start:1.1428571em;padding:0}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New";padding:.75rem 1rem}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight{display:block;min-width:-moz-max-content;min-width:max-content;padding-top:1rem;padding-bottom:1rem;padding-left:0;padding-right:0}pre code.torchlight .line{padding-left:1rem;padding-right:1rem}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From 1667462e449d95b0c9f64426b8e1005421727af9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 13:06:13 +0100
Subject: [PATCH 3394/4023] Merge back Torchlight styles

---
 _media/app.css                                |  2 +-
 .../extended.css => torchlight.css}           | 24 ++++++++++++++++---
 .../hydefront/components/torchlight/base.css  | 24 -------------------
 resources/assets/app.css                      |  2 +-
 4 files changed, 23 insertions(+), 29 deletions(-)
 rename packages/hydefront/components/{torchlight/extended.css => torchlight.css} (62%)
 delete mode 100644 packages/hydefront/components/torchlight/base.css

diff --git a/_media/app.css b/_media/app.css
index 8cc270c5bc4..1ccd5878e90 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/hydefront/components/torchlight/extended.css b/packages/hydefront/components/torchlight.css
similarity index 62%
rename from packages/hydefront/components/torchlight/extended.css
rename to packages/hydefront/components/torchlight.css
index faf07363923..50fe356c6a8 100644
--- a/packages/hydefront/components/torchlight/extended.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,9 +1,27 @@
 /**
- * Extended styles for Torchlight.
- *
- * You should also import the base styles in `base.css`.
+ * Base styles for Torchlight.
  */
 
+pre code.torchlight .line-number, pre code.torchlight .summary-caret {
+    @apply mr-4;
+}
+
+.prose .torchlight-link, .torchlight-link {
+    @apply underline;
+}
+
+.torchlight.has-focus-lines .line:not(.line-focus) {
+    transition: filter 0.35s, opacity 0.35s;
+    filter: blur(.095rem);
+    opacity: .65;
+}
+ 
+.torchlight.has-focus-lines:hover .line:not(.line-focus) {
+    filter: blur(0px);
+    @apply opacity-100;
+}
+
+
 /* Collapsing */
 
 .torchlight summary:focus {
diff --git a/packages/hydefront/components/torchlight/base.css b/packages/hydefront/components/torchlight/base.css
deleted file mode 100644
index 4f4f2bbda7e..00000000000
--- a/packages/hydefront/components/torchlight/base.css
+++ /dev/null
@@ -1,24 +0,0 @@
-/**
- * Base styles for Torchlight.
- * 
- * You can also import the extended styles in `extended.css` to support advanced features like collapsing.
- */
-
-pre code.torchlight .line-number, pre code.torchlight .summary-caret {
-    @apply mr-4;
-}
-
-.prose .torchlight-link, .torchlight-link {
-    @apply underline;
-}
-
-.torchlight.has-focus-lines .line:not(.line-focus) {
-    transition: filter 0.35s, opacity 0.35s;
-    filter: blur(.095rem);
-    opacity: .65;
-}
- 
-.torchlight.has-focus-lines:hover .line:not(.line-focus) {
-    filter: blur(0px);
-    @apply opacity-100;
-}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 4ecc8ffbe28..15c2af459e2 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -13,7 +13,7 @@
 
 @import 'hydefront/components/table-of-contents.css';
 @import 'hydefront/components/heading-permalinks.css';
-@import 'hydefront/components/torchlight/base.css';
+@import 'hydefront/components/torchlight.css';
 @import 'hydefront/components/blockquotes.css';
 
 @tailwind base;

From f31b23f8fb0fa2a6341fb9a99600c83942f29101 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 13:06:50 +0100
Subject: [PATCH 3395/4023] Cleanup code

---
 packages/hydefront/components/torchlight.css | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index 50fe356c6a8..c1cbbcfcbf4 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,7 +1,3 @@
-/**
- * Base styles for Torchlight.
- */
-
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }

From a58d8503360d533b037b25afc810a4f5821d6369 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 13:49:33 +0100
Subject: [PATCH 3396/4023] Create table-of-contents.blade.php

---
 .../docs/table-of-contents.blade.php          | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 packages/framework/resources/views/components/docs/table-of-contents.blade.php

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
new file mode 100644
index 00000000000..ea044a7b407
--- /dev/null
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -0,0 +1,19 @@
+@props(['items'])
+
+<ul class="py-3 space-y-1.5">
+    @foreach($items as $item)
+        <li>
+            <a href="#{{ $item['slug'] }}" 
+               class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
+                <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
+                {{ $item['title'] }}
+            </a>
+            
+            @if(!empty($item['children']))
+                <ul class="pl-2">
+                    <x-hyde::docs.table-of-contents :items="$item['children']" />
+                </ul>
+            @endif
+        </li>
+    @endforeach
+</ul>
\ No newline at end of file

From 285f7febd24c2ef2bc256dd349b7f006b89965c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 13:49:47 +0100
Subject: [PATCH 3397/4023] Update unit test to extend feature test case

---
 .../Feature/Actions/GeneratesSidebarTableOfContentsTest.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
index 26c603b7b4d..e46c054973b 100644
--- a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
@@ -7,15 +7,13 @@
 namespace Hyde\Framework\Testing\Feature\Actions;
 
 use Hyde\Framework\Actions\GeneratesTableOfContents;
-use Hyde\Testing\UnitTestCase;
+use Hyde\Testing\TestCase;
 
 /**
  * @covers \Hyde\Framework\Actions\GeneratesTableOfContents
  */
-class GeneratesSidebarTableOfContentsTest extends UnitTestCase
+class GeneratesSidebarTableOfContentsTest extends TestCase
 {
-    protected static bool $needsConfig = true;
-
     public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";

From b67c4f3ffd6b6acad81632827da56a56693c03c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 13:56:44 +0100
Subject: [PATCH 3398/4023] Add component identifier class

---
 .../resources/views/components/docs/table-of-contents.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index ea044a7b407..e074e9a04d8 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,6 +1,6 @@
 @props(['items'])
 
-<ul class="py-3 space-y-1.5">
+<ul class="table-of-contents py-3 space-y-1.5">
     @foreach($items as $item)
         <li>
             <a href="#{{ $item['slug'] }}" 

From e08057dca3f6e2b42fc3c5f92323fe650f6f694d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:06:53 +0100
Subject: [PATCH 3399/4023] Create SidebarTableOfContentsViewTest.php

---
 .../Views/SidebarTableOfContentsViewTest.php  | 243 ++++++++++++++++++
 1 file changed, 243 insertions(+)
 create mode 100644 packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
new file mode 100644
index 00000000000..64ce4035d67
--- /dev/null
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -0,0 +1,243 @@
+<?php
+
+/** @noinspection HtmlUnknownAnchorTarget */
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature\Views;
+
+use Hyde\Framework\Actions\GeneratesTableOfContents;
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Framework\Actions\GeneratesTableOfContents
+ */
+class SidebarTableOfContentsViewTest extends TestCase
+{
+    public function testCanGenerateTableOfContents()
+    {
+        $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+
+        $this->assertIsString($result);
+        $this->assertStringContainsString('<ul>', $result);
+        $this->assertStringContainsString('<a href="#level-2">Level 2</a>', $result);
+        $this->assertStringNotContainsString('[[END_TOC]]', $result);
+    }
+
+    public function testReturnStringContainsExpectedContent()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        MARKDOWN;
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+            <ul class="table-of-contents">
+                <li>
+                    <a href="#level-2">Level 2</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3">Level 3</a>
+                        </li>
+                    </ul>
+                </li>
+            </ul>
+            HTML, (new GeneratesTableOfContents($markdown))->execute()
+        );
+    }
+
+    public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
+    {
+        $markdown = <<<'MARKDOWN'
+        Level 1
+        =======
+        Level 2
+        -------
+        Level 2B
+        --------
+        MARKDOWN;
+
+        $expected = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ## Level 2B
+        MARKDOWN;
+
+        $this->assertSame(
+            (new GeneratesTableOfContents($expected))->execute(),
+            (new GeneratesTableOfContents($markdown))->execute()
+        );
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+            <ul class="table-of-contents">
+                <li>
+                    <a href="#level-2">Level 2</a>
+                </li>
+                <li>
+                    <a href="#level-2b">Level 2B</a>
+                </li>
+            </ul>
+            HTML, (new GeneratesTableOfContents($markdown))->execute()
+        );
+    }
+
+    public function testNonHeadingMarkdownIsRemoved()
+    {
+        $expected = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        MARKDOWN;
+
+        $actual = <<<'MARKDOWN'
+        # Level 1
+        Foo bar
+        ## Level 2
+        Bar baz
+        ### Level 3
+        Baz foo
+        MARKDOWN;
+
+        $this->assertSame(
+            (new GeneratesTableOfContents($expected))->execute(),
+            (new GeneratesTableOfContents($actual))->execute()
+        );
+    }
+
+    public function testWithNoLevelOneHeading()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Level 2
+        ### Level 3
+        MARKDOWN;
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+            <ul class="table-of-contents">
+                <li>
+                    <a href="#level-2">Level 2</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3">Level 3</a>
+                        </li>
+                    </ul>
+                </li>
+            </ul>
+            HTML, (new GeneratesTableOfContents($markdown))->execute()
+        );
+    }
+
+    public function testWithMultipleNestedHeadings()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        #### Level 4
+        ##### Level 5
+        ###### Level 6
+
+        ## Level 2B
+        ### Level 3B
+        ### Level 3C
+        ## Level 2C
+        ### Level 3D
+        MARKDOWN;
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+            <ul class="table-of-contents">
+                <li>
+                    <a href="#level-2">Level 2</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3">Level 3</a>
+                            <ul>
+                                <li>
+                                    <a href="#level-4">Level 4</a>
+                                </li>
+                            </ul>
+                        </li>
+                    </ul>
+                </li>
+                <li>
+                    <a href="#level-2b">Level 2B</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3b">Level 3B</a>
+                        </li>
+                        <li>
+                            <a href="#level-3c">Level 3C</a>
+                        </li>
+                    </ul>
+                </li>
+                <li>
+                    <a href="#level-2c">Level 2C</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3d">Level 3D</a>
+                        </li>
+                    </ul>
+                </li>
+            </ul>
+            HTML, (new GeneratesTableOfContents($markdown))->execute()
+        );
+    }
+
+    public function testWithMultipleLevelOneHeadings()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        # Level 1B
+        ## Level 2B
+        ### Level 3B
+        MARKDOWN;
+
+        $this->assertSameIgnoringIndentation(<<<'HTML'
+            <ul class="table-of-contents">
+                <li>
+                    <a href="#level-2">Level 2</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3">Level 3</a>
+                        </li>
+                    </ul>
+                </li>
+                <li>
+                    <a href="#level-2b">Level 2B</a>
+                    <ul>
+                        <li>
+                            <a href="#level-3b">Level 3B</a>
+                        </li>
+                    </ul>
+                </li>
+            </ul>
+            HTML, (new GeneratesTableOfContents($markdown))->execute()
+        );
+    }
+
+    public function testWithNoHeadings()
+    {
+        $this->assertSame('', (new GeneratesTableOfContents("Foo bar\nBaz foo"))->execute());
+    }
+
+    public function testWithNoContent()
+    {
+        $this->assertSame('', (new GeneratesTableOfContents(''))->execute());
+    }
+
+    protected function assertSameIgnoringIndentation(string $expected, string $actual): void
+    {
+        $this->assertSame(
+            $this->removeIndentation(trim($expected)),
+            $this->removeIndentation(trim($actual))
+        );
+    }
+
+    protected function removeIndentation(string $actual): string
+    {
+        return implode("\n", array_map('trim', explode("\n", $actual)));
+    }
+}

From 72327b176941ce8d2ec76e955a15373ea0322f1c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:07:01 +0100
Subject: [PATCH 3400/4023] Revert "Update unit test to extend feature test
 case"

This reverts commit 285f7febd24c2ef2bc256dd349b7f006b89965c0.
---
 .../Feature/Actions/GeneratesSidebarTableOfContentsTest.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
index e46c054973b..26c603b7b4d 100644
--- a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
@@ -7,13 +7,15 @@
 namespace Hyde\Framework\Testing\Feature\Actions;
 
 use Hyde\Framework\Actions\GeneratesTableOfContents;
-use Hyde\Testing\TestCase;
+use Hyde\Testing\UnitTestCase;
 
 /**
  * @covers \Hyde\Framework\Actions\GeneratesTableOfContents
  */
-class GeneratesSidebarTableOfContentsTest extends TestCase
+class GeneratesSidebarTableOfContentsTest extends UnitTestCase
 {
+    protected static bool $needsConfig = true;
+
     public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";

From 2f31aac74b25744d87b3e2181fd8048e05fa1d97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:20:04 +0100
Subject: [PATCH 3401/4023] Rewrite table of contents generator with a custom
 implementation

---
 .../Actions/GeneratesTableOfContents.php      | 89 +++++++++++--------
 1 file changed, 52 insertions(+), 37 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 2889b0fe419..f2f342cb19f 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -6,18 +6,11 @@
 
 use Hyde\Facades\Config;
 use Hyde\Markdown\Models\Markdown;
+use Illuminate\Support\Str;
 use League\CommonMark\Environment\Environment;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
 use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
-use League\CommonMark\Extension\TableOfContents\TableOfContentsExtension;
-use League\CommonMark\MarkdownConverter;
 
-use function strpos;
-use function substr;
-
-/**
- * Generates a table of contents for the Markdown document, most commonly used for the sidebar.
- */
 class GeneratesTableOfContents
 {
     protected string $markdown;
@@ -29,41 +22,63 @@ public function __construct(Markdown|string $markdown)
 
     public function execute(): string
     {
-        $config = [
-            'table_of_contents' => [
-                'html_class' => 'table-of-contents',
-                'position' => 'placeholder',
-                'placeholder' => '[[START_TOC]]',
-                'style' => 'bullet',
-                'min_heading_level' => Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2),
-                'max_heading_level' => Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4),
-                'normalize' => 'relative',
-            ],
-            'heading_permalink' => [
-                'fragment_prefix' => '',
-            ],
-        ];
-
-        $environment = new Environment($config);
-        $environment->addExtension(new CommonMarkCoreExtension());
-        $environment->addExtension(new HeadingPermalinkExtension());
-        $environment->addExtension(new TableOfContentsExtension());
+        $headings = $this->parseHeadings();
 
-        $converter = new MarkdownConverter($environment);
-        $html = $converter->convert($this->markdown."\n[[START_TOC]]")->getContent();
+        return view('hyde::components.docs.table-of-contents', [
+            'items' => $this->buildTableOfContents($headings),
+        ])->render();
+    }
 
-        return $this->extractTableOfContents($html);
+    protected function parseHeadings(): array
+    {
+        preg_match_all('/^#{2,4}\s+(.+)$/m', $this->markdown, $matches);
+        
+        $headings = [];
+        foreach ($matches[0] as $index => $heading) {
+            $level = substr_count($heading, '#');
+            $title = $matches[1][$index];
+            $slug = Str::slug($title);
+            
+            $headings[] = [
+                'level' => $level,
+                'title' => $title,
+                'slug' => $slug,
+            ];
+        }
+        
+        return $headings;
     }
 
-    protected function extractTableOfContents(string $html): string
+    protected function buildTableOfContents(array $headings): array
     {
-        // The table of contents is always at the end of the document, so we can just strip everything before it.
-        $position = strpos($html, '<ul class="table-of-contents">');
-        if ($position === false) {
-            // The document has no headings, so we'll just return an empty string.
-            return '';
+        $minLevel = Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2);
+        $maxLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
+        
+        $items = [];
+        $stack = [&$items];
+        $previousLevel = $minLevel;
+
+        foreach ($headings as $heading) {
+            if ($heading['level'] < $minLevel || $heading['level'] > $maxLevel) {
+                continue;
+            }
+
+            $item = [
+                'title' => $heading['title'],
+                'slug' => $heading['slug'],
+                'children' => [],
+            ];
+
+            if ($heading['level'] > $previousLevel) {
+                $stack[] = &$stack[count($stack) - 1][count($stack[count($stack) - 1]) - 1]['children'];
+            } elseif ($heading['level'] < $previousLevel) {
+                array_splice($stack, $heading['level'] - $minLevel + 1);
+            }
+
+            $stack[count($stack) - 1][] = $item;
+            $previousLevel = $heading['level'];
         }
 
-        return substr($html, $position);
+        return $items;
     }
 }

From 9b45af380ab847c0b161265efa641d37e1b16602 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:23:51 +0100
Subject: [PATCH 3402/4023] Breaking: GeneratesTableOfContents execute method
 now returns array

---
 .../src/Framework/Actions/GeneratesTableOfContents.php      | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index f2f342cb19f..451fd472848 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -20,13 +20,11 @@ public function __construct(Markdown|string $markdown)
         $this->markdown = (string) $markdown;
     }
 
-    public function execute(): string
+    public function execute(): array
     {
         $headings = $this->parseHeadings();
 
-        return view('hyde::components.docs.table-of-contents', [
-            'items' => $this->buildTableOfContents($headings),
-        ])->render();
+        return $this->buildTableOfContents($headings);
     }
 
     protected function parseHeadings(): array

From a0511409c85723498ab0bba3173be5955eec638a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:26:06 +0100
Subject: [PATCH 3403/4023] Fix formatting

---
 .../views/components/docs/table-of-contents.blade.php     | 2 +-
 .../src/Framework/Actions/GeneratesTableOfContents.php    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index e074e9a04d8..709219e2f38 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -9,7 +9,7 @@ class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transi
                 {{ $item['title'] }}
             </a>
             
-            @if(!empty($item['children']))
+            @if(! empty($item['children']))
                 <ul class="pl-2">
                     <x-hyde::docs.table-of-contents :items="$item['children']" />
                 </ul>
diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 451fd472848..e81991d1ddc 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -30,20 +30,20 @@ public function execute(): array
     protected function parseHeadings(): array
     {
         preg_match_all('/^#{2,4}\s+(.+)$/m', $this->markdown, $matches);
-        
+
         $headings = [];
         foreach ($matches[0] as $index => $heading) {
             $level = substr_count($heading, '#');
             $title = $matches[1][$index];
             $slug = Str::slug($title);
-            
+
             $headings[] = [
                 'level' => $level,
                 'title' => $title,
                 'slug' => $slug,
             ];
         }
-        
+
         return $headings;
     }
 
@@ -51,7 +51,7 @@ protected function buildTableOfContents(array $headings): array
     {
         $minLevel = Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2);
         $maxLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
-        
+
         $items = [];
         $stack = [&$items];
         $previousLevel = $minLevel;

From 6093c48dce4b479dd18071389ccf22b303b06a39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:27:44 +0100
Subject: [PATCH 3404/4023] Remove old assertions

---
 .../GeneratesSidebarTableOfContentsTest.php   | 122 +-----------------
 1 file changed, 2 insertions(+), 120 deletions(-)

diff --git a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
index 26c603b7b4d..7441854ee36 100644
--- a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
@@ -20,11 +20,6 @@ public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
         $result = (new GeneratesTableOfContents($markdown))->execute();
-
-        $this->assertIsString($result);
-        $this->assertStringContainsString('<ul>', $result);
-        $this->assertStringContainsString('<a href="#level-2">Level 2</a>', $result);
-        $this->assertStringNotContainsString('[[END_TOC]]', $result);
     }
 
     public function testReturnStringContainsExpectedContent()
@@ -34,20 +29,6 @@ public function testReturnStringContainsExpectedContent()
         ## Level 2
         ### Level 3
         MARKDOWN;
-
-        $this->assertSameIgnoringIndentation(<<<'HTML'
-            <ul class="table-of-contents">
-                <li>
-                    <a href="#level-2">Level 2</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3">Level 3</a>
-                        </li>
-                    </ul>
-                </li>
-            </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
-        );
     }
 
     public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
@@ -71,18 +52,6 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
             (new GeneratesTableOfContents($expected))->execute(),
             (new GeneratesTableOfContents($markdown))->execute()
         );
-
-        $this->assertSameIgnoringIndentation(<<<'HTML'
-            <ul class="table-of-contents">
-                <li>
-                    <a href="#level-2">Level 2</a>
-                </li>
-                <li>
-                    <a href="#level-2b">Level 2B</a>
-                </li>
-            </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
-        );
     }
 
     public function testNonHeadingMarkdownIsRemoved()
@@ -114,20 +83,6 @@ public function testWithNoLevelOneHeading()
         ## Level 2
         ### Level 3
         MARKDOWN;
-
-        $this->assertSameIgnoringIndentation(<<<'HTML'
-            <ul class="table-of-contents">
-                <li>
-                    <a href="#level-2">Level 2</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3">Level 3</a>
-                        </li>
-                    </ul>
-                </li>
-            </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
-        );
     }
 
     public function testWithMultipleNestedHeadings()
@@ -146,44 +101,6 @@ public function testWithMultipleNestedHeadings()
         ## Level 2C
         ### Level 3D
         MARKDOWN;
-
-        $this->assertSameIgnoringIndentation(<<<'HTML'
-            <ul class="table-of-contents">
-                <li>
-                    <a href="#level-2">Level 2</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3">Level 3</a>
-                            <ul>
-                                <li>
-                                    <a href="#level-4">Level 4</a>
-                                </li>
-                            </ul>
-                        </li>
-                    </ul>
-                </li>
-                <li>
-                    <a href="#level-2b">Level 2B</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3b">Level 3B</a>
-                        </li>
-                        <li>
-                            <a href="#level-3c">Level 3C</a>
-                        </li>
-                    </ul>
-                </li>
-                <li>
-                    <a href="#level-2c">Level 2C</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3d">Level 3D</a>
-                        </li>
-                    </ul>
-                </li>
-            </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
-        );
     }
 
     public function testWithMultipleLevelOneHeadings()
@@ -196,50 +113,15 @@ public function testWithMultipleLevelOneHeadings()
         ## Level 2B
         ### Level 3B
         MARKDOWN;
-
-        $this->assertSameIgnoringIndentation(<<<'HTML'
-            <ul class="table-of-contents">
-                <li>
-                    <a href="#level-2">Level 2</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3">Level 3</a>
-                        </li>
-                    </ul>
-                </li>
-                <li>
-                    <a href="#level-2b">Level 2B</a>
-                    <ul>
-                        <li>
-                            <a href="#level-3b">Level 3B</a>
-                        </li>
-                    </ul>
-                </li>
-            </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
-        );
     }
 
     public function testWithNoHeadings()
     {
-        $this->assertSame('', (new GeneratesTableOfContents("Foo bar\nBaz foo"))->execute());
+        $this->assertSame([], (new GeneratesTableOfContents("Foo bar\nBaz foo"))->execute());
     }
 
     public function testWithNoContent()
     {
-        $this->assertSame('', (new GeneratesTableOfContents(''))->execute());
-    }
-
-    protected function assertSameIgnoringIndentation(string $expected, string $actual): void
-    {
-        $this->assertSame(
-            $this->removeIndentation(trim($expected)),
-            $this->removeIndentation(trim($actual))
-        );
-    }
-
-    protected function removeIndentation(string $actual): string
-    {
-        return implode("\n", array_map('trim', explode("\n", $actual)));
+        $this->assertSame([], (new GeneratesTableOfContents(''))->execute());
     }
 }

From 8b008f8ea64ff9cf1f2bb6e1f5457c0bbab26621 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:30:51 +0100
Subject: [PATCH 3405/4023] Implement the new assertions

---
 .../GeneratesSidebarTableOfContentsTest.php   | 127 ++++++++++++++++++
 1 file changed, 127 insertions(+)

diff --git a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
index 7441854ee36..3c5fc2f79f7 100644
--- a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
@@ -20,6 +20,25 @@ public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
         $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertEquals([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [],
+            ],
+            [
+                'title' => 'Level 2B',
+                'slug' => 'level-2b',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
     }
 
     public function testReturnStringContainsExpectedContent()
@@ -29,6 +48,22 @@ public function testReturnStringContainsExpectedContent()
         ## Level 2
         ### Level 3
         MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertEquals([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
     }
 
     public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
@@ -83,6 +118,22 @@ public function testWithNoLevelOneHeading()
         ## Level 2
         ### Level 3
         MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertEquals([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
     }
 
     public function testWithMultipleNestedHeadings()
@@ -101,6 +152,55 @@ public function testWithMultipleNestedHeadings()
         ## Level 2C
         ### Level 3D
         MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertEquals([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [
+                            [
+                                'title' => 'Level 4',
+                                'slug' => 'level-4',
+                                'children' => [],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            [
+                'title' => 'Level 2B',
+                'slug' => 'level-2b',
+                'children' => [
+                    [
+                        'title' => 'Level 3B',
+                        'slug' => 'level-3b',
+                        'children' => [],
+                    ],
+                    [
+                        'title' => 'Level 3C',
+                        'slug' => 'level-3c',
+                        'children' => [],
+                    ],
+                ],
+            ],
+            [
+                'title' => 'Level 2C',
+                'slug' => 'level-2c',
+                'children' => [
+                    [
+                        'title' => 'Level 3D',
+                        'slug' => 'level-3d',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
     }
 
     public function testWithMultipleLevelOneHeadings()
@@ -113,6 +213,33 @@ public function testWithMultipleLevelOneHeadings()
         ## Level 2B
         ### Level 3B
         MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertEquals([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [],
+                    ],
+                ],
+            ],
+            [
+                'title' => 'Level 2B',
+                'slug' => 'level-2b',
+                'children' => [
+                    [
+                        'title' => 'Level 3B',
+                        'slug' => 'level-3b',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
     }
 
     public function testWithNoHeadings()

From 876fff8f7f3d268c734d76f6a8832ab2ae450b5d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:33:05 +0100
Subject: [PATCH 3406/4023] Add lost Setext header support

---
 .../Actions/GeneratesTableOfContents.php      | 22 +++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index e81991d1ddc..7c9187931dd 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -29,14 +29,28 @@ public function execute(): array
 
     protected function parseHeadings(): array
     {
-        preg_match_all('/^#{2,4}\s+(.+)$/m', $this->markdown, $matches);
+        // Match both ATX-style (###) and Setext-style (===, ---) headers
+        $pattern = '/^(?:#{2,4}\s+(.+)|(.+)\n([=\-])\3+)$/m';
+        preg_match_all($pattern, $this->markdown, $matches);
 
         $headings = [];
         foreach ($matches[0] as $index => $heading) {
-            $level = substr_count($heading, '#');
-            $title = $matches[1][$index];
-            $slug = Str::slug($title);
+            // Handle ATX-style headers (###)
+            if (str_starts_with($heading, '#')) {
+                $level = substr_count($heading, '#');
+                $title = $matches[1][$index];
+            }
+            // Handle Setext-style headers (=== or ---)
+            else {
+                $title = trim($matches[2][$index]);
+                $level = $matches[3][$index] === '=' ? 1 : 2;
+                // Only add if the config level is met
+                if ($level < Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2)) {
+                    continue;
+                }
+            }
 
+            $slug = Str::slug($title);
             $headings[] = [
                 'level' => $level,
                 'title' => $title,

From e9e3557410bcec32942f0c7b61e63210ad26df93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:34:02 +0100
Subject: [PATCH 3407/4023] Move unit test to unit namespace

---
 .../Actions => Unit}/GeneratesSidebarTableOfContentsTest.php    | 2 +-
 packages/framework/tests/Unit/HasTableOfContentsTest.php        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename packages/framework/tests/{Feature/Actions => Unit}/GeneratesSidebarTableOfContentsTest.php (99%)

diff --git a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
similarity index 99%
rename from packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
rename to packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 3c5fc2f79f7..4a302bab150 100644
--- a/packages/framework/tests/Feature/Actions/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -4,7 +4,7 @@
 
 declare(strict_types=1);
 
-namespace Hyde\Framework\Testing\Feature\Actions;
+namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Framework\Actions\GeneratesTableOfContents;
 use Hyde\Testing\UnitTestCase;
diff --git a/packages/framework/tests/Unit/HasTableOfContentsTest.php b/packages/framework/tests/Unit/HasTableOfContentsTest.php
index 2995b0b509e..42e75b142f8 100644
--- a/packages/framework/tests/Unit/HasTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/HasTableOfContentsTest.php
@@ -10,7 +10,7 @@
 /**
  * @covers \Hyde\Pages\DocumentationPage
  *
- * @see \Hyde\Framework\Testing\Feature\Actions\GeneratesSidebarTableOfContentsTest
+ * @see \Hyde\Framework\Testing\Unit\GeneratesSidebarTableOfContentsTest
  */
 class HasTableOfContentsTest extends UnitTestCase
 {

From bbecf260f12700df756737902858430499025e80 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:34:29 +0100
Subject: [PATCH 3408/4023] Add test crosslinks

---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php      | 2 ++
 .../tests/Unit/GeneratesSidebarTableOfContentsTest.php          | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 64ce4035d67..a7aad071497 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -11,6 +11,8 @@
 
 /**
  * @covers \Hyde\Framework\Actions\GeneratesTableOfContents
+ *
+ * @see \Hyde\Framework\Testing\Unit\GeneratesSidebarTableOfContentsTest
  */
 class SidebarTableOfContentsViewTest extends TestCase
 {
diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 4a302bab150..f608d334116 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -11,6 +11,8 @@
 
 /**
  * @covers \Hyde\Framework\Actions\GeneratesTableOfContents
+ *
+ * @see \Hyde\Framework\Testing\Feature\Views\SidebarTableOfContentsViewTest
  */
 class GeneratesSidebarTableOfContentsTest extends UnitTestCase
 {

From 828cf5ee729a1f2d46b9ea797949f2302b0f317f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:40:08 +0100
Subject: [PATCH 3409/4023] Rename test for new clearer scope

---
 .../tests/Unit/GeneratesSidebarTableOfContentsTest.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index f608d334116..dce7c89979c 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -91,7 +91,7 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
         );
     }
 
-    public function testNonHeadingMarkdownIsRemoved()
+    public function testNonHeadingMarkdownIsIgnored()
     {
         $expected = <<<'MARKDOWN'
         # Level 1

From 586465a80337ae9e31d62fab7e998e88309a5474 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:42:05 +0100
Subject: [PATCH 3410/4023] Explicit test results

---
 .../GeneratesSidebarTableOfContentsTest.php   | 43 ++++++++++++++++---
 1 file changed, 38 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index dce7c89979c..d2eaf2d3571 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -23,7 +23,7 @@ public function testCanGenerateTableOfContents()
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
         $result = (new GeneratesTableOfContents($markdown))->execute();
         
-        $this->assertEquals([
+        $this->assertSame([
             [
                 'title' => 'Level 2',
                 'slug' => 'level-2',
@@ -53,7 +53,7 @@ public function testReturnStringContainsExpectedContent()
         
         $result = (new GeneratesTableOfContents($markdown))->execute();
         
-        $this->assertEquals([
+        $this->assertSame([
             [
                 'title' => 'Level 2',
                 'slug' => 'level-2',
@@ -89,6 +89,22 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
             (new GeneratesTableOfContents($expected))->execute(),
             (new GeneratesTableOfContents($markdown))->execute()
         );
+
+        $this->assertSame(
+            [
+                [
+                    'title' => 'Level 2',
+                    'slug' => 'level-2',
+                    'children' => [],
+                ],
+                [
+                    'title' => 'Level 2B',
+                    'slug' => 'level-2b',
+                    'children' => [],
+                ],
+            ],
+            (new GeneratesTableOfContents($markdown))->execute(),
+        );
     }
 
     public function testNonHeadingMarkdownIsIgnored()
@@ -112,6 +128,23 @@ public function testNonHeadingMarkdownIsIgnored()
             (new GeneratesTableOfContents($expected))->execute(),
             (new GeneratesTableOfContents($actual))->execute()
         );
+
+        $this->assertSame(
+            [
+                [
+                    'title' => 'Level 2',
+                    'slug' => 'level-2',
+                    'children' => [
+                        [
+                            'title' => 'Level 3',
+                            'slug' => 'level-3',
+                            'children' => [],
+                        ],
+                    ],
+                ],
+            ],
+            (new GeneratesTableOfContents($actual))->execute(),
+        );
     }
 
     public function testWithNoLevelOneHeading()
@@ -123,7 +156,7 @@ public function testWithNoLevelOneHeading()
         
         $result = (new GeneratesTableOfContents($markdown))->execute();
         
-        $this->assertEquals([
+        $this->assertSame([
             [
                 'title' => 'Level 2',
                 'slug' => 'level-2',
@@ -157,7 +190,7 @@ public function testWithMultipleNestedHeadings()
         
         $result = (new GeneratesTableOfContents($markdown))->execute();
         
-        $this->assertEquals([
+        $this->assertSame([
             [
                 'title' => 'Level 2',
                 'slug' => 'level-2',
@@ -218,7 +251,7 @@ public function testWithMultipleLevelOneHeadings()
         
         $result = (new GeneratesTableOfContents($markdown))->execute();
         
-        $this->assertEquals([
+        $this->assertSame([
             [
                 'title' => 'Level 2',
                 'slug' => 'level-2',

From 2609fbd0d745cbfb191b94407a42e9e7bf399392 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:47:30 +0100
Subject: [PATCH 3411/4023] Test various config levels

---
 .../GeneratesSidebarTableOfContentsTest.php   | 86 +++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index d2eaf2d3571..04da9c32edd 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -286,4 +286,90 @@ public function testWithNoContent()
     {
         $this->assertSame([], (new GeneratesTableOfContents(''))->execute());
     }
+
+    public function testRespectsMinHeadingLevelConfig()
+    {
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 3,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        #### Level 4
+        MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertSame([
+            [
+                'title' => 'Level 3',
+                'slug' => 'level-3',
+                'children' => [
+                    [
+                        'title' => 'Level 4',
+                        'slug' => 'level-4',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
+    }
+
+    public function testRespectsMaxHeadingLevelConfig()
+    {
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.max_heading_level' => 2,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        #### Level 4
+        MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertSame([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [],
+            ],
+        ], $result);
+    }
+
+    public function testRespectsMinAndMaxHeadingLevelConfig()
+    {
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 2,
+            'docs.sidebar.table_of_contents.max_heading_level' => 3,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        #### Level 4
+        ##### Level 5
+        MARKDOWN;
+        
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        
+        $this->assertSame([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'slug' => 'level-3',
+                        'children' => [],
+                    ],
+                ],
+            ],
+        ], $result);
+    }
 }

From d20182753066d85fc17a3c5171b51189f89e9226 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:55:52 +0100
Subject: [PATCH 3412/4023] Test various config level edge cases

---
 .../GeneratesSidebarTableOfContentsTest.php   | 100 ++++++++++++++++++
 1 file changed, 100 insertions(+)

diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 04da9c32edd..bf8f983c108 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -372,4 +372,104 @@ public function testRespectsMinAndMaxHeadingLevelConfig()
             ],
         ], $result);
     }
+
+    public function testHandlesInvalidConfigLevels()
+    {
+        // Test negative levels
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => -1,
+            'docs.sidebar.table_of_contents.max_heading_level' => -2,
+        ]);
+        
+        $markdown = "## Level 2\n### Level 3";
+        $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
+
+        // Test levels above 6
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 7,
+            'docs.sidebar.table_of_contents.max_heading_level' => 8,
+        ]);
+        
+        $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
+
+        // Test swapped levels (min > max)
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 4,
+            'docs.sidebar.table_of_contents.max_heading_level' => 2,
+        ]);
+        
+        $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
+    }
+
+    public function testSetextHeadersWithDifferentConfigLevels()
+    {
+        // Test where both setext headers should be included
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 1,
+            'docs.sidebar.table_of_contents.max_heading_level' => 2,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        Level 1
+        =======
+        Level 2
+        -------
+        MARKDOWN;
+
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+
+        $this->assertSame([
+            [
+                "title" => "Level 1",
+                "slug" => "level-1",
+                "children" => [
+                    [
+                        "title" => "Level 2",
+                        "slug" => "level-2",
+                        "children" => [],
+                    ]
+                ]
+            ],
+        ], $result);
+
+        // Test where no setext headers should be included
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 3,
+            'docs.sidebar.table_of_contents.max_heading_level' => 4,
+        ]);
+
+        $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
+    }
+
+    public function testEmptyRangeConfig()
+    {
+        // Test where min and max are the same but valid
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 2,
+            'docs.sidebar.table_of_contents.max_heading_level' => 2,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        MARKDOWN;
+
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+        $this->assertSame([
+            [
+                'title' => 'Level 2',
+                'slug' => 'level-2',
+                'children' => [],
+            ],
+        ], $result);
+
+        // Test where range results in no valid levels
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 3,
+            'docs.sidebar.table_of_contents.max_heading_level' => 2,
+        ]);
+
+        $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
+    }
 }

From 0c4de8dda253750fb019935349a8327f311fca3d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:56:05 +0100
Subject: [PATCH 3413/4023] Support all heading levels

---
 .../Actions/GeneratesTableOfContents.php      |  2 +-
 .../GeneratesSidebarTableOfContentsTest.php   | 57 +++++++++++++++++++
 2 files changed, 58 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 7c9187931dd..3ff4af42207 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -30,7 +30,7 @@ public function execute(): array
     protected function parseHeadings(): array
     {
         // Match both ATX-style (###) and Setext-style (===, ---) headers
-        $pattern = '/^(?:#{2,4}\s+(.+)|(.+)\n([=\-])\3+)$/m';
+        $pattern = '/^(?:#{1,6}\s+(.+)|(.+)\n([=\-])\3+)$/m';
         preg_match_all($pattern, $this->markdown, $matches);
 
         $headings = [];
diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index bf8f983c108..075086d6339 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -373,6 +373,63 @@ public function testRespectsMinAndMaxHeadingLevelConfig()
         ], $result);
     }
 
+    public function testWithAllHeadingLevels()
+    {
+        self::mockConfig([
+            'docs.sidebar.table_of_contents.min_heading_level' => 1,
+            'docs.sidebar.table_of_contents.max_heading_level' => 6,
+        ]);
+
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ## Level 2
+        ### Level 3
+        #### Level 4
+        ##### Level 5
+        ###### Level 6
+        MARKDOWN;
+
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+
+        $this->assertSame([
+            [
+                'title' => 'Level 1',
+                'slug' => 'level-1',
+                'children' => [
+                    [
+                        'title' => 'Level 2',
+                        'slug' => 'level-2',
+                        'children' => [
+                            [
+                                'title' => 'Level 3',
+                                'slug' => 'level-3',
+                                'children' => [
+                                    [
+                                        'title' => 'Level 4',
+                                        'slug' => 'level-4',
+                                        'children' => [
+                                            [
+                                                'title' => 'Level 5',
+                                                'slug' => 'level-5',
+                                                'children' => [
+                                                    [
+                                                        'title' => 'Level 6',
+                                                        'slug' => 'level-6',
+                                                        'children' => [],
+                                                    ],
+                                                ],
+                                            ],
+                                        ],
+                                    ],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ], $result);
+    }
+
     public function testHandlesInvalidConfigLevels()
     {
         // Test negative levels

From 849ee8ccdd973a122283c890e96757eb23ade5af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 14:57:48 +0100
Subject: [PATCH 3414/4023] Refactor to extract protected class properties

---
 .../Actions/GeneratesTableOfContents.php         | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 3ff4af42207..939e6acb552 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -15,9 +15,14 @@ class GeneratesTableOfContents
 {
     protected string $markdown;
 
+    protected int $minHeadingLevel = 2;
+    protected int $maxHeadingLevel = 4;
+
     public function __construct(Markdown|string $markdown)
     {
         $this->markdown = (string) $markdown;
+        $this->minHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2);
+        $this->maxHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
     }
 
     public function execute(): array
@@ -45,7 +50,7 @@ protected function parseHeadings(): array
                 $title = trim($matches[2][$index]);
                 $level = $matches[3][$index] === '=' ? 1 : 2;
                 // Only add if the config level is met
-                if ($level < Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2)) {
+                if ($level < $this->minHeadingLevel) {
                     continue;
                 }
             }
@@ -63,15 +68,12 @@ protected function parseHeadings(): array
 
     protected function buildTableOfContents(array $headings): array
     {
-        $minLevel = Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2);
-        $maxLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
-
         $items = [];
         $stack = [&$items];
-        $previousLevel = $minLevel;
+        $previousLevel = $this->minHeadingLevel;
 
         foreach ($headings as $heading) {
-            if ($heading['level'] < $minLevel || $heading['level'] > $maxLevel) {
+            if ($heading['level'] < $this->minHeadingLevel || $heading['level'] > $this->maxHeadingLevel) {
                 continue;
             }
 
@@ -84,7 +86,7 @@ protected function buildTableOfContents(array $headings): array
             if ($heading['level'] > $previousLevel) {
                 $stack[] = &$stack[count($stack) - 1][count($stack[count($stack) - 1]) - 1]['children'];
             } elseif ($heading['level'] < $previousLevel) {
-                array_splice($stack, $heading['level'] - $minLevel + 1);
+                array_splice($stack, $heading['level'] - $this->minHeadingLevel + 1);
             }
 
             $stack[count($stack) - 1][] = $item;

From 3d06340b702eca7869bc99b3c7eef94798c20939 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:12:27 +0100
Subject: [PATCH 3415/4023] Delete table-of-contents.css

---
 .../components/table-of-contents.css          | 23 -------------------
 1 file changed, 23 deletions(-)
 delete mode 100644 packages/hydefront/components/table-of-contents.css

diff --git a/packages/hydefront/components/table-of-contents.css b/packages/hydefront/components/table-of-contents.css
deleted file mode 100644
index bdbb63750eb..00000000000
--- a/packages/hydefront/components/table-of-contents.css
+++ /dev/null
@@ -1,23 +0,0 @@
-.table-of-contents {
-    @apply pb-3;
-}
-
-.table-of-contents > li {
-    @apply my-[0.35rem];
-}
-
-.table-of-contents ul {
-    @apply pl-2;
-}
-
-.table-of-contents a {
-    @apply block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative;
-}
-
-.table-of-contents a::before {
-    @apply content-['#'] text-[75%] opacity-50 mr-1 transition-opacity duration-300;
-}
-
-.table-of-contents a:hover::before {
-    @apply opacity-100;
-}

From bdf5dc73d54d2c92798c54b5a326161059e9e1f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:12:48 +0100
Subject: [PATCH 3416/4023] Remove import for deleted table-of-contents.css

---
 resources/assets/app.css | 1 -
 1 file changed, 1 deletion(-)

diff --git a/resources/assets/app.css b/resources/assets/app.css
index 15c2af459e2..1523247f427 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,7 +11,6 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import 'hydefront/components/table-of-contents.css';
 @import 'hydefront/components/heading-permalinks.css';
 @import 'hydefront/components/torchlight.css';
 @import 'hydefront/components/blockquotes.css';

From 886938696ab16e9fd34e039ccbd7ebae7dd8146c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:16:35 +0100
Subject: [PATCH 3417/4023] Use Blade component to make the table of contents

---
 .../resources/views/components/docs/sidebar-item.blade.php      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index fe320513408..e4dee41b5d5 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -14,7 +14,7 @@
 
         @if(config('docs.sidebar.table_of_contents.enabled', true))
             <span class="sr-only">Table of contents</span>
-            {!! $page->getTableOfContents() !!}
+            <x-hyde::docs.table-of-contents :items="$page->getTableOfContents()" />
         @endif
     @else
         <a href="{{ $item->getLink() }}" @class([$grouped

From e8b8749df8a7787617033c6243c164d78f8bb94b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:18:08 +0100
Subject: [PATCH 3418/4023] Inline method usage

---
 .../resources/views/components/docs/sidebar-item.blade.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/sidebar-item.blade.php b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
index e4dee41b5d5..a610d88c5ec 100644
--- a/packages/framework/resources/views/components/docs/sidebar-item.blade.php
+++ b/packages/framework/resources/views/components/docs/sidebar-item.blade.php
@@ -1,4 +1,5 @@
 @props(['grouped' => false])
+@use('Hyde\Framework\Actions\GeneratesTableOfContents')
 @php /** @var \Hyde\Framework\Features\Navigation\NavigationItem $item */ @endphp
 <li @class(['sidebar-item -ml-4 pl-4', $grouped
         ? 'active -ml-8 pl-8 bg-black/5 dark:bg-black/10'
@@ -14,7 +15,7 @@
 
         @if(config('docs.sidebar.table_of_contents.enabled', true))
             <span class="sr-only">Table of contents</span>
-            <x-hyde::docs.table-of-contents :items="$page->getTableOfContents()" />
+            <x-hyde::docs.table-of-contents :items="(new GeneratesTableOfContents($page->markdown))->execute()" />
         @endif
     @else
         <a href="{{ $item->getLink() }}" @class([$grouped

From 142490d892a700fa21bc1c0e81e20d7eab2e636c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:21:26 +0100
Subject: [PATCH 3419/4023] Breaking: Remove
 `DocumentationPage::getTableOfContents` method

---
 RELEASE_NOTES.md                              |  1 +
 .../documentation-page-methods.md             |  8 ------
 .../framework/src/Pages/DocumentationPage.php |  9 -------
 .../tests/Feature/DocumentationPageTest.php   |  6 -----
 .../tests/Unit/HasTableOfContentsTest.php     | 27 -------------------
 5 files changed, 1 insertion(+), 50 deletions(-)
 delete mode 100644 packages/framework/tests/Unit/HasTableOfContentsTest.php

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index e06c71e46c9..d72d7688033 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -113,6 +113,7 @@ This serves two purposes:
 
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
+- Breaking: Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents in https://github.com/hydephp/develop/pull/2045
 - Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
diff --git a/docs/_data/partials/hyde-pages-api/documentation-page-methods.md b/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
index a22aa0bc815..5de3bf6f58d 100644
--- a/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
+++ b/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
@@ -35,14 +35,6 @@ No description provided.
 $page->getOnlineSourcePath(): string|false
 ```
 
-#### `getTableOfContents()`
-
-Generate Table of Contents as HTML from a Markdown document body.
-
-```php
-$page->getTableOfContents(): string
-```
-
 #### `getRouteKey()`
 
 Get the route key for the page.
diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index 843fd9653bd..16a87e51c9c 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -6,7 +6,6 @@
 
 use Hyde\Facades\Config;
 use Hyde\Foundation\Facades\Routes;
-use Hyde\Framework\Actions\GeneratesTableOfContents;
 use Hyde\Pages\Concerns\BaseMarkdownPage;
 use Hyde\Support\Models\Route;
 
@@ -54,14 +53,6 @@ public static function hasTableOfContents(): bool
         return Config::getBool('docs.sidebar.table_of_contents.enabled', true);
     }
 
-    /**
-     * Generate Table of Contents as HTML from a Markdown document body.
-     */
-    public function getTableOfContents(): string
-    {
-        return (new GeneratesTableOfContents($this->markdown))->execute();
-    }
-
     /**
      * Get the route key for the page.
      *
diff --git a/packages/framework/tests/Feature/DocumentationPageTest.php b/packages/framework/tests/Feature/DocumentationPageTest.php
index 7967d643b17..47ad876ea1a 100644
--- a/packages/framework/tests/Feature/DocumentationPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationPageTest.php
@@ -22,12 +22,6 @@
  */
 class DocumentationPageTest extends TestCase
 {
-    public function testCanGenerateTableOfContents()
-    {
-        $page = DocumentationPage::make(markdown: '# Foo');
-        $this->assertIsString($page->getTableOfContents());
-    }
-
     public function testCanGetCurrentPagePath()
     {
         $page = DocumentationPage::make('foo');
diff --git a/packages/framework/tests/Unit/HasTableOfContentsTest.php b/packages/framework/tests/Unit/HasTableOfContentsTest.php
deleted file mode 100644
index 42e75b142f8..00000000000
--- a/packages/framework/tests/Unit/HasTableOfContentsTest.php
+++ /dev/null
@@ -1,27 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Pages\DocumentationPage;
-use Hyde\Testing\UnitTestCase;
-
-/**
- * @covers \Hyde\Pages\DocumentationPage
- *
- * @see \Hyde\Framework\Testing\Unit\GeneratesSidebarTableOfContentsTest
- */
-class HasTableOfContentsTest extends UnitTestCase
-{
-    protected static bool $needsKernel = true;
-    protected static bool $needsConfig = true;
-
-    public function testConstructorCreatesTableOfContentsString()
-    {
-        $this->assertSame(
-            '<ul class="table-of-contents"><li><a href="#title">Title</a></li></ul>',
-            str_replace("\n", '', (new DocumentationPage(markdown: '## Title'))->getTableOfContents())
-        );
-    }
-}

From 0682b9513607c21d3099fed12480188d346f7c9b Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 1 Dec 2024 14:22:53 +0000
Subject: [PATCH 3420/4023] Apply fixes from StyleCI

---
 .../Actions/GeneratesTableOfContents.php      |  3 --
 .../GeneratesSidebarTableOfContentsTest.php   | 52 +++++++++----------
 2 files changed, 26 insertions(+), 29 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 939e6acb552..5ed8e632c18 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -7,9 +7,6 @@
 use Hyde\Facades\Config;
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Str;
-use League\CommonMark\Environment\Environment;
-use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
-use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
 
 class GeneratesTableOfContents
 {
diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 075086d6339..84728301ade 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -22,7 +22,7 @@ public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -50,9 +50,9 @@ public function testReturnStringContainsExpectedContent()
         ## Level 2
         ### Level 3
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -153,9 +153,9 @@ public function testWithNoLevelOneHeading()
         ## Level 2
         ### Level 3
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -187,9 +187,9 @@ public function testWithMultipleNestedHeadings()
         ## Level 2C
         ### Level 3D
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -248,9 +248,9 @@ public function testWithMultipleLevelOneHeadings()
         ## Level 2B
         ### Level 3B
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -299,9 +299,9 @@ public function testRespectsMinHeadingLevelConfig()
         ### Level 3
         #### Level 4
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 3',
@@ -329,9 +329,9 @@ public function testRespectsMaxHeadingLevelConfig()
         ### Level 3
         #### Level 4
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -355,9 +355,9 @@ public function testRespectsMinAndMaxHeadingLevelConfig()
         #### Level 4
         ##### Level 5
         MARKDOWN;
-        
+
         $result = (new GeneratesTableOfContents($markdown))->execute();
-        
+
         $this->assertSame([
             [
                 'title' => 'Level 2',
@@ -437,7 +437,7 @@ public function testHandlesInvalidConfigLevels()
             'docs.sidebar.table_of_contents.min_heading_level' => -1,
             'docs.sidebar.table_of_contents.max_heading_level' => -2,
         ]);
-        
+
         $markdown = "## Level 2\n### Level 3";
         $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
 
@@ -446,7 +446,7 @@ public function testHandlesInvalidConfigLevels()
             'docs.sidebar.table_of_contents.min_heading_level' => 7,
             'docs.sidebar.table_of_contents.max_heading_level' => 8,
         ]);
-        
+
         $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
 
         // Test swapped levels (min > max)
@@ -454,7 +454,7 @@ public function testHandlesInvalidConfigLevels()
             'docs.sidebar.table_of_contents.min_heading_level' => 4,
             'docs.sidebar.table_of_contents.max_heading_level' => 2,
         ]);
-        
+
         $this->assertSame([], (new GeneratesTableOfContents($markdown))->execute());
     }
 
@@ -477,15 +477,15 @@ public function testSetextHeadersWithDifferentConfigLevels()
 
         $this->assertSame([
             [
-                "title" => "Level 1",
-                "slug" => "level-1",
-                "children" => [
+                'title' => 'Level 1',
+                'slug' => 'level-1',
+                'children' => [
                     [
-                        "title" => "Level 2",
-                        "slug" => "level-2",
-                        "children" => [],
-                    ]
-                ]
+                        'title' => 'Level 2',
+                        'slug' => 'level-2',
+                        'children' => [],
+                    ],
+                ],
             ],
         ], $result);
 

From 2538112c08a635e83cf4ff059844b6c6031222c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:22:43 +0100
Subject: [PATCH 3421/4023] Update app.css

---
 _media/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index 1ccd5878e90..96efb3f97d9 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-1\.5>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.375rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.375rem * var(--tw-space-y-reverse))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}

From b7b00eaefd68e71c1a69ee42da63760c3f80be6d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:25:43 +0100
Subject: [PATCH 3422/4023] Extract new method to render data for component
 test

---
 .../Views/SidebarTableOfContentsViewTest.php  | 31 ++++++++++++-------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index a7aad071497..0d6a0ee40b2 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -19,7 +19,7 @@ class SidebarTableOfContentsViewTest extends TestCase
     public function testCanGenerateTableOfContents()
     {
         $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
-        $result = (new GeneratesTableOfContents($markdown))->execute();
+        $result = $this->render($markdown);
 
         $this->assertIsString($result);
         $this->assertStringContainsString('<ul>', $result);
@@ -46,7 +46,7 @@ public function testReturnStringContainsExpectedContent()
                     </ul>
                 </li>
             </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
+            HTML, $this->render($markdown)
         );
     }
 
@@ -68,8 +68,8 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
         MARKDOWN;
 
         $this->assertSame(
-            (new GeneratesTableOfContents($expected))->execute(),
-            (new GeneratesTableOfContents($markdown))->execute()
+            $this->render($expected),
+            $this->render($markdown)
         );
 
         $this->assertSameIgnoringIndentation(<<<'HTML'
@@ -81,7 +81,7 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
                     <a href="#level-2b">Level 2B</a>
                 </li>
             </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
+            HTML, $this->render($markdown)
         );
     }
 
@@ -103,8 +103,8 @@ public function testNonHeadingMarkdownIsRemoved()
         MARKDOWN;
 
         $this->assertSame(
-            (new GeneratesTableOfContents($expected))->execute(),
-            (new GeneratesTableOfContents($actual))->execute()
+            $this->render($expected),
+            $this->render($actual)
         );
     }
 
@@ -126,7 +126,7 @@ public function testWithNoLevelOneHeading()
                     </ul>
                 </li>
             </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
+            HTML, $this->render($markdown)
         );
     }
 
@@ -182,7 +182,7 @@ public function testWithMultipleNestedHeadings()
                     </ul>
                 </li>
             </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
+            HTML, $this->render($markdown)
         );
     }
 
@@ -216,18 +216,18 @@ public function testWithMultipleLevelOneHeadings()
                     </ul>
                 </li>
             </ul>
-            HTML, (new GeneratesTableOfContents($markdown))->execute()
+            HTML, $this->render($markdown)
         );
     }
 
     public function testWithNoHeadings()
     {
-        $this->assertSame('', (new GeneratesTableOfContents("Foo bar\nBaz foo"))->execute());
+        $this->assertSame('', $this->render("Foo bar\nBaz foo"));
     }
 
     public function testWithNoContent()
     {
-        $this->assertSame('', (new GeneratesTableOfContents(''))->execute());
+        $this->assertSame('', $this->render(''));
     }
 
     protected function assertSameIgnoringIndentation(string $expected, string $actual): void
@@ -242,4 +242,11 @@ protected function removeIndentation(string $actual): string
     {
         return implode("\n", array_map('trim', explode("\n", $actual)));
     }
+
+    protected function render(string $markdown): string
+    {
+        return view('hyde::components.docs.table-of-contents', [
+            'items' => (new GeneratesTableOfContents($markdown))->execute(),
+        ])->render();
+    }
 }

From 654dd4216a999cb4559ffed7ada51f33dd1bb00c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:29:33 +0100
Subject: [PATCH 3423/4023] Cleanup formatting

---
 .../views/components/docs/table-of-contents.blade.php          | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 709219e2f38..081e92908c8 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -3,8 +3,7 @@
 <ul class="table-of-contents py-3 space-y-1.5">
     @foreach($items as $item)
         <li>
-            <a href="#{{ $item['slug'] }}" 
-               class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
+            <a href="#{{ $item['slug'] }}" class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
                 <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
                 {{ $item['title'] }}
             </a>

From d94ff75da765fbefcd7e193ae4c8daf00ccfc954 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:29:50 +0100
Subject: [PATCH 3424/4023] Strip Tailwind from test comparisons

---
 .../Feature/Views/SidebarTableOfContentsViewTest.php  | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 0d6a0ee40b2..f3ba71c2143 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -232,6 +232,8 @@ public function testWithNoContent()
 
     protected function assertSameIgnoringIndentation(string $expected, string $actual): void
     {
+        $expected = $this->stripTailwindClasses($expected);
+        
         $this->assertSame(
             $this->removeIndentation(trim($expected)),
             $this->removeIndentation(trim($actual))
@@ -245,8 +247,15 @@ protected function removeIndentation(string $actual): string
 
     protected function render(string $markdown): string
     {
-        return view('hyde::components.docs.table-of-contents', [
+        $html = view('hyde::components.docs.table-of-contents', [
             'items' => (new GeneratesTableOfContents($markdown))->execute(),
         ])->render();
+
+        return $this->stripTailwindClasses($html);
+    }
+
+    protected function stripTailwindClasses(string $html): string
+    {
+        return preg_replace('/\sclass="[^"]*"/', '', $html);
     }
 }

From bc029077399ed687c82cb2459d26616dbeba19f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:34:39 +0100
Subject: [PATCH 3425/4023] Granular replacements

---
 .../Feature/Views/SidebarTableOfContentsViewTest.php     | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index f3ba71c2143..d56c3810934 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -256,6 +256,13 @@ protected function render(string $markdown): string
 
     protected function stripTailwindClasses(string $html): string
     {
-        return preg_replace('/\sclass="[^"]*"/', '', $html);
+        $replacements = [
+            ' py-3 space-y-1.5' => '',
+            'block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative' => '$anchor',
+            'text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300' => '$icon',
+            'pl-2' => '$children',
+        ];
+
+        return str_replace(array_keys($replacements), array_values($replacements), $html);
     }
 }

From b898ffa92f4730f1bd870f03495f8187b371ef35 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:43:39 +0100
Subject: [PATCH 3426/4023] Reindent HTML for comparison

---
 .../Views/SidebarTableOfContentsViewTest.php  | 69 ++++++++++++++++++-
 1 file changed, 67 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index d56c3810934..ae10794b5da 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -235,8 +235,8 @@ protected function assertSameIgnoringIndentation(string $expected, string $actua
         $expected = $this->stripTailwindClasses($expected);
         
         $this->assertSame(
-            $this->removeIndentation(trim($expected)),
-            $this->removeIndentation(trim($actual))
+            $this->reindent($this->removeIndentation(trim($expected))),
+            $this->reindent($this->removeIndentation(trim($actual))),
         );
     }
 
@@ -245,6 +245,71 @@ protected function removeIndentation(string $actual): string
         return implode("\n", array_map('trim', explode("\n", $actual)));
     }
 
+    protected function reindent(string $html): string
+    {
+        // Create a new DOMDocument instance
+        $doc = new \DOMDocument();
+
+        // Suppress warnings from malformed HTML
+        libxml_use_internal_errors(true);
+
+        // Load the HTML into DOMDocument, wrapping in a temporary container if needed
+        $doc->loadHTML('<!DOCTYPE html><html><body>' . $html . '</body></html>', LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
+
+        // Clear any libxml errors
+        libxml_clear_errors();
+
+        // Retrieve the body content
+        $body = $doc->getElementsByTagName('body')->item(0);
+
+        // If body is empty, return an empty string
+        if (!$body) {
+            return '';
+        }
+
+        // Use a recursive helper function to process child nodes
+        return $this->formatNode($body, 0);
+    }
+
+    protected function formatNode(\DOMNode $node, int $level): string
+    {
+        $indent = str_repeat('  ', $level); // Two spaces for each indentation level
+        $output = '';
+
+        foreach ($node->childNodes as $child) {
+            if ($child->nodeType === XML_TEXT_NODE) {
+                // Trim whitespace from text nodes
+                $text = trim($child->nodeValue);
+                if (!empty($text)) {
+                    $output .= $indent . $text . "\n";
+                }
+            } elseif ($child->nodeType === XML_ELEMENT_NODE) {
+                // Open the tag
+                $output .= $indent . '<' . $child->nodeName;
+
+                // Add attributes
+                if ($child->hasAttributes()) {
+                    foreach ($child->attributes as $attr) {
+                        $output .= ' ' . $attr->nodeName . '="' . htmlspecialchars($attr->nodeValue) . '"';
+                    }
+                }
+
+                $output .= '>';
+
+                // Recursively format children
+                if ($child->childNodes->length > 0) {
+                    $output .= "\n" . $this->formatNode($child, $level + 1);
+                    $output .= $indent; // Closing tag at the same indentation
+                }
+
+                // Close the tag
+                $output .= '</' . $child->nodeName . ">\n";
+            }
+        }
+
+        return $output;
+    }
+
     protected function render(string $markdown): string
     {
         $html = view('hyde::components.docs.table-of-contents', [

From ee9259ba6134f83aadb145e3f2f464627290eaeb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:45:42 +0100
Subject: [PATCH 3427/4023] Unwrap extra list parent element

---
 .../views/components/docs/table-of-contents.blade.php         | 4 +---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php    | 1 -
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 081e92908c8..76fe1572614 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -9,9 +9,7 @@
             </a>
             
             @if(! empty($item['children']))
-                <ul class="pl-2">
-                    <x-hyde::docs.table-of-contents :items="$item['children']" />
-                </ul>
+                <x-hyde::docs.table-of-contents :items="$item['children']" />
             @endif
         </li>
     @endforeach
diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index ae10794b5da..9cd3120475f 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -325,7 +325,6 @@ protected function stripTailwindClasses(string $html): string
             ' py-3 space-y-1.5' => '',
             'block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative' => '$anchor',
             'text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300' => '$icon',
-            'pl-2' => '$children',
         ];
 
         return str_replace(array_keys($replacements), array_values($replacements), $html);

From fed702231f4c245072f82a364ea85656acc464fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:50:25 +0100
Subject: [PATCH 3428/4023] Replace replacements with removals

---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 9cd3120475f..da40a48bee2 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -323,8 +323,8 @@ protected function stripTailwindClasses(string $html): string
     {
         $replacements = [
             ' py-3 space-y-1.5' => '',
-            'block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative' => '$anchor',
-            'text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300' => '$icon',
+            'class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative" ' => '',
+            'class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300" ' => '',
         ];
 
         return str_replace(array_keys($replacements), array_values($replacements), $html);

From 8b189cab78151ab17e64876a064b7c135053ab4b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:51:03 +0100
Subject: [PATCH 3429/4023] Merge two initial tests

---
 .../Views/SidebarTableOfContentsViewTest.php    | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index da40a48bee2..8caadabe514 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -17,17 +17,6 @@
 class SidebarTableOfContentsViewTest extends TestCase
 {
     public function testCanGenerateTableOfContents()
-    {
-        $markdown = "# Level 1\n## Level 2\n## Level 2B\n### Level 3\n";
-        $result = $this->render($markdown);
-
-        $this->assertIsString($result);
-        $this->assertStringContainsString('<ul>', $result);
-        $this->assertStringContainsString('<a href="#level-2">Level 2</a>', $result);
-        $this->assertStringNotContainsString('[[END_TOC]]', $result);
-    }
-
-    public function testReturnStringContainsExpectedContent()
     {
         $markdown = <<<'MARKDOWN'
         # Level 1
@@ -35,6 +24,10 @@ public function testReturnStringContainsExpectedContent()
         ### Level 3
         MARKDOWN;
 
+        $result = $this->render($markdown);
+
+        $this->assertIsString($result);
+
         $this->assertSameIgnoringIndentation(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
@@ -46,7 +39,7 @@ public function testReturnStringContainsExpectedContent()
                     </ul>
                 </li>
             </ul>
-            HTML, $this->render($markdown)
+            HTML, $result
         );
     }
 

From 2668c96e398cb36c10c7c5f77a843a4e427bfb5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:52:08 +0100
Subject: [PATCH 3430/4023] Tweak replacements

---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 8caadabe514..0b05f1771cd 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -316,8 +316,8 @@ protected function stripTailwindClasses(string $html): string
     {
         $replacements = [
             ' py-3 space-y-1.5' => '',
-            'class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative" ' => '',
-            'class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300" ' => '',
+            ' class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative"' => '',
+            'class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300"' => '',
         ];
 
         return str_replace(array_keys($replacements), array_values($replacements), $html);

From 4c1968491931dcd24d8e8385ed26c95d1fbd8b93 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 15:57:42 +0100
Subject: [PATCH 3431/4023] Better test normalization

---
 .../Views/SidebarTableOfContentsViewTest.php  | 23 ++++++++++++-------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 0b05f1771cd..8ba37f607b8 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -28,7 +28,7 @@ public function testCanGenerateTableOfContents()
 
         $this->assertIsString($result);
 
-        $this->assertSameIgnoringIndentation(<<<'HTML'
+        $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
                     <a href="#level-2">Level 2</a>
@@ -65,7 +65,7 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
             $this->render($markdown)
         );
 
-        $this->assertSameIgnoringIndentation(<<<'HTML'
+        $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
                     <a href="#level-2">Level 2</a>
@@ -108,7 +108,7 @@ public function testWithNoLevelOneHeading()
         ### Level 3
         MARKDOWN;
 
-        $this->assertSameIgnoringIndentation(<<<'HTML'
+        $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
                     <a href="#level-2">Level 2</a>
@@ -140,7 +140,7 @@ public function testWithMultipleNestedHeadings()
         ### Level 3D
         MARKDOWN;
 
-        $this->assertSameIgnoringIndentation(<<<'HTML'
+        $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
                     <a href="#level-2">Level 2</a>
@@ -190,7 +190,7 @@ public function testWithMultipleLevelOneHeadings()
         ### Level 3B
         MARKDOWN;
 
-        $this->assertSameIgnoringIndentation(<<<'HTML'
+        $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
                     <a href="#level-2">Level 2</a>
@@ -223,13 +223,13 @@ public function testWithNoContent()
         $this->assertSame('', $this->render(''));
     }
 
-    protected function assertSameIgnoringIndentation(string $expected, string $actual): void
+    protected function assertHtmlStructure(string $expected, string $actual): void
     {
         $expected = $this->stripTailwindClasses($expected);
         
         $this->assertSame(
-            $this->reindent($this->removeIndentation(trim($expected))),
-            $this->reindent($this->removeIndentation(trim($actual))),
+            $this->normalize($this->reindent($this->removeIndentation(trim($expected)))),
+            $this->normalize($this->reindent($this->removeIndentation(trim($actual)))),
         );
     }
 
@@ -303,6 +303,13 @@ protected function formatNode(\DOMNode $node, int $level): string
         return $output;
     }
 
+    protected function normalize(string $html): string
+    {
+        return preg_replace_callback('/<span\b[^>]*>(.*?)<\/span>/s', function ($matches) {
+            return '<span>'.trim(preg_replace('/\s+/', ' ', $matches[1])).'</span>';
+        }, $html);
+    }
+
     protected function render(string $markdown): string
     {
         $html = view('hyde::components.docs.table-of-contents', [

From 5790d8fabc7be67b867f0277a4d1d64c4a544151 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:01:13 +0100
Subject: [PATCH 3432/4023] Don't add class to recursed components

---
 .../views/components/docs/table-of-contents.blade.php       | 6 +++---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php  | 1 +
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 76fe1572614..c64d1cbdc5d 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,6 +1,6 @@
-@props(['items'])
+@props(['items', 'isChild' => false])
 
-<ul class="table-of-contents py-3 space-y-1.5">
+<ul class="{{ ! $isChild ? 'table-of-contents py-3 space-y-1.5' : 'space-y-1.5' }}">
     @foreach($items as $item)
         <li>
             <a href="#{{ $item['slug'] }}" class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
@@ -9,7 +9,7 @@
             </a>
             
             @if(! empty($item['children']))
-                <x-hyde::docs.table-of-contents :items="$item['children']" />
+                <x-hyde::docs.table-of-contents :items="$item['children']" :isChild="true" />
             @endif
         </li>
     @endforeach
diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 8ba37f607b8..c5c4123dbd8 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -325,6 +325,7 @@ protected function stripTailwindClasses(string $html): string
             ' py-3 space-y-1.5' => '',
             ' class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative"' => '',
             'class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300"' => '',
+            ' class="space-y-1.5"' => '',
         ];
 
         return str_replace(array_keys($replacements), array_values($replacements), $html);

From 713cdc42693cd69ea18b5ce2f502d76c9b9282ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:02:04 +0100
Subject: [PATCH 3433/4023] Only render items when there are any

---
 .../docs/table-of-contents.blade.php          | 30 ++++++++++---------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index c64d1cbdc5d..19ad5de4bf4 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,16 +1,18 @@
 @props(['items', 'isChild' => false])
 
-<ul class="{{ ! $isChild ? 'table-of-contents py-3 space-y-1.5' : 'space-y-1.5' }}">
-    @foreach($items as $item)
-        <li>
-            <a href="#{{ $item['slug'] }}" class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
-                <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
-                {{ $item['title'] }}
-            </a>
-            
-            @if(! empty($item['children']))
-                <x-hyde::docs.table-of-contents :items="$item['children']" :isChild="true" />
-            @endif
-        </li>
-    @endforeach
-</ul>
\ No newline at end of file
+@if(! empty($items))
+    <ul class="{{ ! $isChild ? 'table-of-contents py-3 space-y-1.5' : 'space-y-1.5' }}">
+        @foreach($items as $item)
+            <li>
+                <a href="#{{ $item['slug'] }}" class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
+                    <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
+                    {{ $item['title'] }}
+                </a>
+
+                @if(! empty($item['children']))
+                    <x-hyde::docs.table-of-contents :items="$item['children']" :isChild="true" />
+                @endif
+            </li>
+        @endforeach
+    </ul>
+@endif
\ No newline at end of file

From 72a5e1e1733f3790423610b4d5a37bf75a0b369f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:02:13 +0100
Subject: [PATCH 3434/4023] Update tests to expect the hash span

---
 .../Views/SidebarTableOfContentsViewTest.php  | 90 +++++++++++++++----
 1 file changed, 72 insertions(+), 18 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index c5c4123dbd8..12048e93202 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -31,10 +31,16 @@ public function testCanGenerateTableOfContents()
         $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
-                    <a href="#level-2">Level 2</a>
+                    <a href="#level-2">
+                        <span>#</span>
+                        Level 2
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3">Level 3</a>
+                            <a href="#level-3">
+                                <span>#</span>
+                                Level 3
+                            </a>
                         </li>
                     </ul>
                 </li>
@@ -68,10 +74,16 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
         $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
-                    <a href="#level-2">Level 2</a>
+                    <a href="#level-2">
+                        <span>#</span>
+                        Level 2
+                    </a>
                 </li>
                 <li>
-                    <a href="#level-2b">Level 2B</a>
+                    <a href="#level-2b">
+                        <span>#</span>
+                        Level 2B
+                    </a>
                 </li>
             </ul>
             HTML, $this->render($markdown)
@@ -111,10 +123,16 @@ public function testWithNoLevelOneHeading()
         $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
-                    <a href="#level-2">Level 2</a>
+                    <a href="#level-2">
+                        <span>#</span>
+                        Level 2
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3">Level 3</a>
+                            <a href="#level-3">
+                                <span>#</span>
+                                Level 3
+                            </a>
                         </li>
                     </ul>
                 </li>
@@ -143,34 +161,58 @@ public function testWithMultipleNestedHeadings()
         $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
-                    <a href="#level-2">Level 2</a>
+                    <a href="#level-2">
+                        <span>#</span>
+                        Level 2
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3">Level 3</a>
+                            <a href="#level-3">
+                                <span>#</span>
+                                Level 3
+                            </a>
                             <ul>
                                 <li>
-                                    <a href="#level-4">Level 4</a>
+                                    <a href="#level-4">
+                                        <span>#</span>
+                                        Level 4
+                                    </a>
                                 </li>
                             </ul>
                         </li>
                     </ul>
                 </li>
                 <li>
-                    <a href="#level-2b">Level 2B</a>
+                    <a href="#level-2b">
+                        <span>#</span>
+                        Level 2B
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3b">Level 3B</a>
+                            <a href="#level-3b">
+                                <span>#</span>
+                                Level 3B
+                            </a>
                         </li>
                         <li>
-                            <a href="#level-3c">Level 3C</a>
+                            <a href="#level-3c">
+                                <span>#</span>
+                                Level 3C
+                            </a>
                         </li>
                     </ul>
                 </li>
                 <li>
-                    <a href="#level-2c">Level 2C</a>
+                    <a href="#level-2c">
+                        <span>#</span>
+                        Level 2C
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3d">Level 3D</a>
+                            <a href="#level-3d">
+                                <span>#</span>
+                                Level 3D
+                            </a>
                         </li>
                     </ul>
                 </li>
@@ -193,18 +235,30 @@ public function testWithMultipleLevelOneHeadings()
         $this->assertHtmlStructure(<<<'HTML'
             <ul class="table-of-contents">
                 <li>
-                    <a href="#level-2">Level 2</a>
+                    <a href="#level-2">
+                        <span>#</span>
+                        Level 2
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3">Level 3</a>
+                            <a href="#level-3">
+                                <span>#</span>
+                                Level 3
+                            </a>
                         </li>
                     </ul>
                 </li>
                 <li>
-                    <a href="#level-2b">Level 2B</a>
+                    <a href="#level-2b">
+                        <span>#</span>
+                        Level 2B
+                    </a>
                     <ul>
                         <li>
-                            <a href="#level-3b">Level 3B</a>
+                            <a href="#level-3b">
+                                <span>#</span>
+                                Level 3B
+                            </a>
                         </li>
                     </ul>
                 </li>

From 21e9d64bf3ad4d6351817da9d4420085cd43b34d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:02:36 +0100
Subject: [PATCH 3435/4023] Fix formatting

Co-Authored-By: StyleCI Bot <bot@styleci.io>
---
 .../Views/SidebarTableOfContentsViewTest.php   | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 12048e93202..aaa6568dea7 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -280,7 +280,7 @@ public function testWithNoContent()
     protected function assertHtmlStructure(string $expected, string $actual): void
     {
         $expected = $this->stripTailwindClasses($expected);
-        
+
         $this->assertSame(
             $this->normalize($this->reindent($this->removeIndentation(trim($expected)))),
             $this->normalize($this->reindent($this->removeIndentation(trim($actual)))),
@@ -301,7 +301,7 @@ protected function reindent(string $html): string
         libxml_use_internal_errors(true);
 
         // Load the HTML into DOMDocument, wrapping in a temporary container if needed
-        $doc->loadHTML('<!DOCTYPE html><html><body>' . $html . '</body></html>', LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
+        $doc->loadHTML('<!DOCTYPE html><html><body>'.$html.'</body></html>', LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
 
         // Clear any libxml errors
         libxml_clear_errors();
@@ -310,7 +310,7 @@ protected function reindent(string $html): string
         $body = $doc->getElementsByTagName('body')->item(0);
 
         // If body is empty, return an empty string
-        if (!$body) {
+        if (! $body) {
             return '';
         }
 
@@ -327,17 +327,17 @@ protected function formatNode(\DOMNode $node, int $level): string
             if ($child->nodeType === XML_TEXT_NODE) {
                 // Trim whitespace from text nodes
                 $text = trim($child->nodeValue);
-                if (!empty($text)) {
-                    $output .= $indent . $text . "\n";
+                if (! empty($text)) {
+                    $output .= $indent.$text."\n";
                 }
             } elseif ($child->nodeType === XML_ELEMENT_NODE) {
                 // Open the tag
-                $output .= $indent . '<' . $child->nodeName;
+                $output .= $indent.'<'.$child->nodeName;
 
                 // Add attributes
                 if ($child->hasAttributes()) {
                     foreach ($child->attributes as $attr) {
-                        $output .= ' ' . $attr->nodeName . '="' . htmlspecialchars($attr->nodeValue) . '"';
+                        $output .= ' '.$attr->nodeName.'="'.htmlspecialchars($attr->nodeValue).'"';
                     }
                 }
 
@@ -345,12 +345,12 @@ protected function formatNode(\DOMNode $node, int $level): string
 
                 // Recursively format children
                 if ($child->childNodes->length > 0) {
-                    $output .= "\n" . $this->formatNode($child, $level + 1);
+                    $output .= "\n".$this->formatNode($child, $level + 1);
                     $output .= $indent; // Closing tag at the same indentation
                 }
 
                 // Close the tag
-                $output .= '</' . $child->nodeName . ">\n";
+                $output .= '</'.$child->nodeName.">\n";
             }
         }
 

From 0a1d2e15275602d5663f65494faa177ce9b98cd6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:10:32 +0100
Subject: [PATCH 3436/4023] Refactor to closer match existing styles

---
 _media/app.css                                              | 2 +-
 .../views/components/docs/table-of-contents.blade.php       | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 96efb3f97d9..1b558f67ec6 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-1\.5>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(.375rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.375rem * var(--tw-space-y-reverse))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-\[0\.35rem\]{margin-top:.35rem;margin-bottom:.35rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 19ad5de4bf4..e104fa9e144 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,10 +1,10 @@
 @props(['items', 'isChild' => false])
 
 @if(! empty($items))
-    <ul class="{{ ! $isChild ? 'table-of-contents py-3 space-y-1.5' : 'space-y-1.5' }}">
+    <ul class="{{ ! $isChild ? 'table-of-contents pb-3' : 'pl-2' }}">
         @foreach($items as $item)
-            <li>
-                <a href="#{{ $item['slug'] }}" class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
+            <li class="my-[0.35rem]">
+                <a href="#{{ $item['slug'] }}" class="block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
                     <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
                     {{ $item['title'] }}
                 </a>

From 12dc804a7ea8908e2a74408cb1834b9b6cd86584 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:14:38 +0100
Subject: [PATCH 3437/4023] Refactor to closer match old styles

---
 _media/app.css                                              | 2 +-
 .../views/components/docs/table-of-contents.blade.php       | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 1b558f67ec6..f97e07a2508 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-\[0\.35rem\]{margin-top:.35rem;margin-bottom:.35rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index e104fa9e144..974f0e5a01e 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -3,9 +3,9 @@
 @if(! empty($items))
     <ul class="{{ ! $isChild ? 'table-of-contents pb-3' : 'pl-2' }}">
         @foreach($items as $item)
-            <li class="my-[0.35rem]">
-                <a href="#{{ $item['slug'] }}" class="block -ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative">
-                    <span class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300">#</span>
+            <li class="my-0.5">
+                <a href="#{{ $item['slug'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
+                    <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>
                     {{ $item['title'] }}
                 </a>
 

From 9ef45dc6fad267406ef295da303db13d5f2a673c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:16:11 +0100
Subject: [PATCH 3438/4023] Update test for changed classes

---
 .../tests/Feature/Views/SidebarTableOfContentsViewTest.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index aaa6568dea7..5f1e09c5833 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -376,10 +376,11 @@ protected function render(string $markdown): string
     protected function stripTailwindClasses(string $html): string
     {
         $replacements = [
-            ' py-3 space-y-1.5' => '',
-            ' class="block pl-8 -ml-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300 relative"' => '',
+            ' pb-3' => '',
+            ' class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300"' => '',
             'class="text-[75%] opacity-50 mr-1 hover:opacity-100 transition-opacity duration-300"' => '',
-            ' class="space-y-1.5"' => '',
+            ' class="my-0.5"' => '',
+            ' class="pl-2"' => '',
         ];
 
         return str_replace(array_keys($replacements), array_values($replacements), $html);

From ccd29421593b51abf751a81ded968a977dfba447 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:20:37 +0100
Subject: [PATCH 3439/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index d72d7688033..fe8f2f7fb88 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -501,6 +501,28 @@ Hyperlinks::isRemote($source);
 
 This change was implemented in https://github.com/hydephp/develop/pull/1883. Make sure to update any instances of `FeaturedImage::isRemote()` in your codebase to ensure compatibility with HydePHP v2.0.
 
+### Blade-based table of contents generator
+
+The way we generate table of contents for documentation pages have been changed from a helper method to a Blade component.
+
+This new system is much easier to customize and style, and is up to 40 times faster than the old system.
+
+See https://github.com/hydephp/develop/pull/2045 for more information.
+
+#### Scope
+
+The likelihood of impact is low, but if any of the following are true, you may need to update your code:
+
+- If you have used the `Hyde\Framework\Actions\GeneratesTableOfContents` class in custom code, you will likely need to update that code for the rewritten class.
+- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that message has been removed.
+- If you have published the `resources/views/components/docs/sidebar-item.blade.php` component, you will need to update it to call the new component instead of the old generator rendering.
+
+#### Changes
+- Adds a new `resources/views/components/docs/table-of-contents.blade.php` component containing the structure and styles for the table of contents
+- Rewrites the `GeneratesTableOfContents` class to use a custom implementation instead of using CommonMark
+- The `execute` method of the `GeneratesTableOfContents` class now returns an array of data, instead of a string of HTML. This data should be fed into the new component
+- Removed the `table-of-contents.css` file as styles are now made using Tailwind
+
 ## New features
 
 <!-- Editors note: Todo: Maybe move to the relevant docs... -->

From 030cfd855c9cc499cad7e4e79bf19b00a9256699 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:27:59 +0100
Subject: [PATCH 3440/4023] Update documentation for new table of contents
 system

---
 docs/creating-content/documentation-pages.md | 2 ++
 docs/digging-deeper/troubleshooting.md       | 1 -
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/creating-content/documentation-pages.md b/docs/creating-content/documentation-pages.md
index 64ab278358a..ea698b7e3f0 100644
--- a/docs/creating-content/documentation-pages.md
+++ b/docs/creating-content/documentation-pages.md
@@ -336,6 +336,8 @@ In the `config/docs.php` file you can configure the behaviour, content, and the
 ],
 ```
 
+To customize the markup or styles of the table of contents, you can publish the `x-hyde::docs.table-of-contents` Blade component and modify it to your liking.
+
 ### Using Flattened Output Paths
 
 If this setting is set to true, Hyde will output all documentation pages into the same configured documentation output directory. This means that you can use the automatic directory-based grouping feature, but still have a "flat" output structure. Note that this means that you can't have two documentation pages with the same filename or navigation menu label as they will overwrite each other.
diff --git a/docs/digging-deeper/troubleshooting.md b/docs/digging-deeper/troubleshooting.md
index e3c4ae9879c..9de42102756 100644
--- a/docs/digging-deeper/troubleshooting.md
+++ b/docs/digging-deeper/troubleshooting.md
@@ -81,7 +81,6 @@ You can read more about some of these in the [Core Concepts](core-concepts#paths
 | Overriding Hyde views is not working               | Ensure the Blade views are in the correct directory.                                                                                                      | Rerun `php hyde publish:views`.                                                                                                                                                                   |
 | Styles not updating when deploying site            | It could be a caching issue. To be honest, when dealing with styles, it's always a caching issue.                                                         | Clear your cache, and optionally complain to your site host                                                                                                                                       |
 | Documentation sidebar items are in the wrong order | Double check the config, make sure the route keys are written correctly. Check that you are not overriding with front matter.                             | Check config for typos and front matter                                                                                                                                                           |
-| Documentation table of contents is weird           | The table of contents markup is generated by the [League/CommonMark extension](https://commonmark.thephpleague.com/2.3/extensions/table-of-contents/)     | Make sure that your Markdown headings make sense                                                                                                                                                  |
 | Issues with date in blog post front matter         | The date is parsed by the PHP `strtotime()` function. The date may be in an invalid format, or the front matter is invalid                                | Ensure the date is in a format that `strtotime()` can parse. Wrap the front matter value in quotes.                                                                                               |
 | RSS feed not being generated                       | The RSS feed requires that you have set a site URL in the Hyde config or the `.env` file. Also check that you have blog posts, and that they are enabled. | Check your configuration files.                                                                                                                                                                   |                                                                                                                                                         |
 | Sitemap not being generated                        | The sitemap requires that you have set a site URL in the Hyde config or the `.env` file.                                                                  | Check your configuration files.                                                                                                                                                                   |                                                                                                                                                         |

From c76a52cd7fc8055a2830217bf3ebcb4d5f2cf647 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:28:03 +0100
Subject: [PATCH 3441/4023] Cleanup code

---
 .../src/Framework/Actions/GeneratesTableOfContents.php       | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 5ed8e632c18..acbc2f64c97 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -18,15 +18,14 @@ class GeneratesTableOfContents
     public function __construct(Markdown|string $markdown)
     {
         $this->markdown = (string) $markdown;
+
         $this->minHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.min_heading_level', 2);
         $this->maxHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
     }
 
     public function execute(): array
     {
-        $headings = $this->parseHeadings();
-
-        return $this->buildTableOfContents($headings);
+        return $this->buildTableOfContents($this->parseHeadings());
     }
 
     protected function parseHeadings(): array

From 2fc56e5d0b3f98003a6457132ee768859b62be8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:29:55 +0100
Subject: [PATCH 3442/4023] Refactor to break up complex method

---
 .../Actions/GeneratesTableOfContents.php      | 53 ++++++++++++++-----
 1 file changed, 40 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index acbc2f64c97..1abf2c51ff8 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -69,26 +69,53 @@ protected function buildTableOfContents(array $headings): array
         $previousLevel = $this->minHeadingLevel;
 
         foreach ($headings as $heading) {
-            if ($heading['level'] < $this->minHeadingLevel || $heading['level'] > $this->maxHeadingLevel) {
+            if (! $this->isHeadingWithinBounds($heading)) {
                 continue;
             }
 
-            $item = [
-                'title' => $heading['title'],
-                'slug' => $heading['slug'],
-                'children' => [],
-            ];
-
-            if ($heading['level'] > $previousLevel) {
-                $stack[] = &$stack[count($stack) - 1][count($stack[count($stack) - 1]) - 1]['children'];
-            } elseif ($heading['level'] < $previousLevel) {
-                array_splice($stack, $heading['level'] - $this->minHeadingLevel + 1);
-            }
-
+            $item = $this->createTableItem($heading);
+            $this->updateStackForHeadingLevel($stack, $heading['level'], $previousLevel);
+            
             $stack[count($stack) - 1][] = $item;
             $previousLevel = $heading['level'];
         }
 
         return $items;
     }
+
+    protected function isHeadingWithinBounds(array $heading): bool
+    {
+        return $heading['level'] >= $this->minHeadingLevel && 
+               $heading['level'] <= $this->maxHeadingLevel;
+    }
+
+    protected function createTableItem(array $heading): array
+    {
+        return [
+            'title' => $heading['title'],
+            'slug' => $heading['slug'],
+            'children' => [],
+        ];
+    }
+
+    protected function updateStackForHeadingLevel(array &$stack, int $currentLevel, int $previousLevel): void
+    {
+        if ($currentLevel > $previousLevel) {
+            $this->nestNewLevel($stack);
+        } elseif ($currentLevel < $previousLevel) {
+            $this->unwindStack($stack, $currentLevel);
+        }
+    }
+
+    protected function nestNewLevel(array &$stack): void
+    {
+        $lastStackIndex = count($stack) - 1;
+        $lastItemIndex = count($stack[$lastStackIndex]) - 1;
+        $stack[] = &$stack[$lastStackIndex][$lastItemIndex]['children'];
+    }
+
+    protected function unwindStack(array &$stack, int $currentLevel): void
+    {
+        array_splice($stack, $currentLevel - $this->minHeadingLevel + 1);
+    }
 }

From 90d8efa127ce046b8f0e4d1d38dc9942e4015539 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:30:34 +0100
Subject: [PATCH 3443/4023] Invert condition to merge up control flow

---
 .../Framework/Actions/GeneratesTableOfContents.php | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 1abf2c51ff8..8a9eaa19b3f 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -69,15 +69,13 @@ protected function buildTableOfContents(array $headings): array
         $previousLevel = $this->minHeadingLevel;
 
         foreach ($headings as $heading) {
-            if (! $this->isHeadingWithinBounds($heading)) {
-                continue;
-            }
+            if ($this->isHeadingWithinBounds($heading)) {
+                $item = $this->createTableItem($heading);
+                $this->updateStackForHeadingLevel($stack, $heading['level'], $previousLevel);
 
-            $item = $this->createTableItem($heading);
-            $this->updateStackForHeadingLevel($stack, $heading['level'], $previousLevel);
-            
-            $stack[count($stack) - 1][] = $item;
-            $previousLevel = $heading['level'];
+                $stack[count($stack) - 1][] = $item;
+                $previousLevel = $heading['level'];
+            }
         }
 
         return $items;

From 6df1b80857164519917be0df9484eddbfff89fe9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:32:58 +0100
Subject: [PATCH 3444/4023] Refactor to break up complex method

---
 .../Actions/GeneratesTableOfContents.php      | 79 +++++++++++++------
 1 file changed, 56 insertions(+), 23 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 8a9eaa19b3f..bd09e78234d 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -30,38 +30,71 @@ public function execute(): array
 
     protected function parseHeadings(): array
     {
-        // Match both ATX-style (###) and Setext-style (===, ---) headers
-        $pattern = '/^(?:#{1,6}\s+(.+)|(.+)\n([=\-])\3+)$/m';
-        preg_match_all($pattern, $this->markdown, $matches);
-
+        $matches = $this->matchHeadingPatterns();
         $headings = [];
+
         foreach ($matches[0] as $index => $heading) {
-            // Handle ATX-style headers (###)
-            if (str_starts_with($heading, '#')) {
-                $level = substr_count($heading, '#');
-                $title = $matches[1][$index];
-            }
-            // Handle Setext-style headers (=== or ---)
-            else {
-                $title = trim($matches[2][$index]);
-                $level = $matches[3][$index] === '=' ? 1 : 2;
-                // Only add if the config level is met
-                if ($level < $this->minHeadingLevel) {
-                    continue;
-                }
+            $headingData = $this->parseHeadingData($heading, $matches, $index);
+            
+            if ($headingData === null) {
+                continue;
             }
 
-            $slug = Str::slug($title);
-            $headings[] = [
-                'level' => $level,
-                'title' => $title,
-                'slug' => $slug,
-            ];
+            $headings[] = $this->createHeadingEntry($headingData);
         }
 
         return $headings;
     }
 
+    protected function matchHeadingPatterns(): array
+    {
+        // Match both ATX-style (###) and Setext-style (===, ---) headers
+        $pattern = '/^(?:#{1,6}\s+(.+)|(.+)\n([=\-])\3+)$/m';
+        preg_match_all($pattern, $this->markdown, $matches);
+
+        return $matches;
+    }
+
+    protected function parseHeadingData(string $heading, array $matches, int $index): ?array
+    {
+        if (str_starts_with($heading, '#')) {
+            return $this->parseAtxHeading($heading, $matches[1][$index]);
+        }
+        
+        return $this->parseSetextHeading($matches[2][$index], $matches[3][$index]);
+    }
+
+    protected function parseAtxHeading(string $heading, string $title): array
+    {
+        return [
+            'level' => substr_count($heading, '#'),
+            'title' => $title,
+        ];
+    }
+
+    protected function parseSetextHeading(string $title, string $marker): ?array
+    {
+        $level = $marker === '=' ? 1 : 2;
+        
+        if ($level < $this->minHeadingLevel) {
+            return null;
+        }
+
+        return [
+            'level' => $level,
+            'title' => trim($title),
+        ];
+    }
+
+    protected function createHeadingEntry(array $headingData): array
+    {
+        return [
+            'level' => $headingData['level'],
+            'title' => $headingData['title'],
+            'slug' => Str::slug($headingData['title']),
+        ];
+    }
+
     protected function buildTableOfContents(array $headings): array
     {
         $items = [];

From 73c71ca67f9075b1c21e2ff38efb674bc20fc976 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:33:36 +0100
Subject: [PATCH 3445/4023] Break out unnecessary else prefix

---
 .../src/Framework/Actions/GeneratesTableOfContents.php        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index bd09e78234d..145902b8666 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -133,7 +133,9 @@ protected function updateStackForHeadingLevel(array &$stack, int $currentLevel,
     {
         if ($currentLevel > $previousLevel) {
             $this->nestNewLevel($stack);
-        } elseif ($currentLevel < $previousLevel) {
+        } 
+
+        if ($currentLevel < $previousLevel) {
             $this->unwindStack($stack, $currentLevel);
         }
     }

From deaebf015f505ccf5858c59181df577d0c29732b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:34:01 +0100
Subject: [PATCH 3446/4023] Add spacing

---
 .../framework/src/Framework/Actions/GeneratesTableOfContents.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 145902b8666..cd0e3b70012 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -144,6 +144,7 @@ protected function nestNewLevel(array &$stack): void
     {
         $lastStackIndex = count($stack) - 1;
         $lastItemIndex = count($stack[$lastStackIndex]) - 1;
+
         $stack[] = &$stack[$lastStackIndex][$lastItemIndex]['children'];
     }
 

From 3328e41c98a74c95148437c4be13b7d4a2fa86c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:37:10 +0100
Subject: [PATCH 3447/4023] Annotate generics and shapes of the arrays

---
 .../Actions/GeneratesTableOfContents.php      | 50 ++++++++++++++++++-
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index cd0e3b70012..8ea4d23791d 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -8,6 +8,9 @@
 use Hyde\Markdown\Models\Markdown;
 use Illuminate\Support\Str;
 
+/**
+ * Generates a nested table of contents from Markdown headings.
+ */
 class GeneratesTableOfContents
 {
     protected string $markdown;
@@ -23,11 +26,17 @@ public function __construct(Markdown|string $markdown)
         $this->maxHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
     }
 
+    /**
+     * @return array<int, array{title: string, slug: string, children: array}>
+     */
     public function execute(): array
     {
         return $this->buildTableOfContents($this->parseHeadings());
     }
 
+    /**
+     * @return array<int, array{level: int, title: string, slug: string}>
+     */
     protected function parseHeadings(): array
     {
         $matches = $this->matchHeadingPatterns();
@@ -46,6 +55,9 @@ protected function parseHeadings(): array
         return $headings;
     }
 
+    /**
+     * @return array{0: array<int, string>, 1: array<int, string>, 2: array<int, string>, 3: array<int, string>}
+     */
     protected function matchHeadingPatterns(): array
     {
         // Match both ATX-style (###) and Setext-style (===, ---) headers
@@ -55,6 +67,10 @@ protected function matchHeadingPatterns(): array
         return $matches;
     }
 
+    /**
+     * @param  array{0: array<int, string>, 1: array<int, string>, 2: array<int, string>, 3: array<int, string>}  $matches
+     * @return array{level: int, title: string}|null
+     */
     protected function parseHeadingData(string $heading, array $matches, int $index): ?array
     {
         if (str_starts_with($heading, '#')) {
@@ -64,6 +80,9 @@ protected function parseHeadingData(string $heading, array $matches, int $index)
         return $this->parseSetextHeading($matches[2][$index], $matches[3][$index]);
     }
 
+    /**
+     * @return array{level: int, title: string}
+     */
     protected function parseAtxHeading(string $heading, string $title): array
     {
         return [
@@ -72,6 +91,9 @@ protected function parseAtxHeading(string $heading, string $title): array
         ];
     }
 
+    /**
+     * @return array{level: int, title: string}|null
+     */
     protected function parseSetextHeading(string $title, string $marker): ?array
     {
         $level = $marker === '=' ? 1 : 2;
@@ -86,6 +108,10 @@ protected function parseSetextHeading(string $title, string $marker): ?array
         ];
     }
 
+    /**
+     * @param  array{level: int, title: string}  $headingData
+     * @return array{level: int, title: string, slug: string}
+     */
     protected function createHeadingEntry(array $headingData): array
     {
         return [
@@ -95,6 +121,10 @@ protected function createHeadingEntry(array $headingData): array
         ];
     }
 
+    /**
+     * @param  array<int, array{level: int, title: string, slug: string}>  $headings
+     * @return array<int, array{title: string, slug: string, children: array}>
+     */
     protected function buildTableOfContents(array $headings): array
     {
         $items = [];
@@ -114,12 +144,19 @@ protected function buildTableOfContents(array $headings): array
         return $items;
     }
 
+    /**
+     * @param  array{level: int, title: string, slug: string}  $heading
+     */
     protected function isHeadingWithinBounds(array $heading): bool
     {
-        return $heading['level'] >= $this->minHeadingLevel && 
+        return $heading['level'] >= $this->minHeadingLevel &&
                $heading['level'] <= $this->maxHeadingLevel;
     }
 
+    /**
+     * @param  array{level: int, title: string, slug: string}  $heading
+     * @return array{title: string, slug: string, children: array}
+     */
     protected function createTableItem(array $heading): array
     {
         return [
@@ -129,17 +166,23 @@ protected function createTableItem(array $heading): array
         ];
     }
 
+    /**
+     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     */
     protected function updateStackForHeadingLevel(array &$stack, int $currentLevel, int $previousLevel): void
     {
         if ($currentLevel > $previousLevel) {
             $this->nestNewLevel($stack);
-        } 
+        }
 
         if ($currentLevel < $previousLevel) {
             $this->unwindStack($stack, $currentLevel);
         }
     }
 
+    /**
+     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     */
     protected function nestNewLevel(array &$stack): void
     {
         $lastStackIndex = count($stack) - 1;
@@ -148,6 +191,9 @@ protected function nestNewLevel(array &$stack): void
         $stack[] = &$stack[$lastStackIndex][$lastItemIndex]['children'];
     }
 
+    /**
+     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     */
     protected function unwindStack(array &$stack, int $currentLevel): void
     {
         array_splice($stack, $currentLevel - $this->minHeadingLevel + 1);

From a2c420d0fbc90b9578608692c486339b7a6fa167 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 16:37:18 +0100
Subject: [PATCH 3448/4023] Fix formatting

Co-Authored-By: StyleCI Bot <bot@styleci.io>
---
 .../src/Framework/Actions/GeneratesTableOfContents.php      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 8ea4d23791d..ae27d6af08c 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -44,7 +44,7 @@ protected function parseHeadings(): array
 
         foreach ($matches[0] as $index => $heading) {
             $headingData = $this->parseHeadingData($heading, $matches, $index);
-            
+
             if ($headingData === null) {
                 continue;
             }
@@ -76,7 +76,7 @@ protected function parseHeadingData(string $heading, array $matches, int $index)
         if (str_starts_with($heading, '#')) {
             return $this->parseAtxHeading($heading, $matches[1][$index]);
         }
-        
+
         return $this->parseSetextHeading($matches[2][$index], $matches[3][$index]);
     }
 
@@ -97,7 +97,7 @@ protected function parseAtxHeading(string $heading, string $title): array
     protected function parseSetextHeading(string $title, string $marker): ?array
     {
         $level = $marker === '=' ? 1 : 2;
-        
+
         if ($level < $this->minHeadingLevel) {
             return null;
         }

From aff4388b7d3c786d3e2ec34742b035f1308ac188 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 18:50:10 +0100
Subject: [PATCH 3449/4023] Create HeadingRenderer.php

---
 .../Markdown/Processing/HeadingRenderer.php   | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 packages/framework/src/Markdown/Processing/HeadingRenderer.php

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
new file mode 100644
index 00000000000..7edce1b1209
--- /dev/null
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Markdown\Processing;
+
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\ChildNodeRendererInterface;
+use League\CommonMark\Renderer\NodeRendererInterface;
+
+/**
+ * Renders a heading node, and supports built-in permalink generation.
+ *
+ * @see \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer
+ */
+class HeadingRenderer implements NodeRendererInterface
+{
+    public function render(Node $node, ChildNodeRendererInterface $childRenderer): string
+    {
+        if (! ($node instanceof Heading)) {
+            throw new \InvalidArgumentException('Incompatible node type: '.get_class($node));
+        }
+
+        $content = $childRenderer->renderNodes($node->children());
+
+        return view('hyde::components.markdown-heading', [
+            'level' => $node->getLevel(),
+            'slot' => $content,
+        ])->render();
+    }
+}

From ed7f281675da62922d181ce7d59621d5730b987a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 18:50:14 +0100
Subject: [PATCH 3450/4023] Create markdown-heading.blade.php

---
 .../views/components/markdown-heading.blade.php     | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 packages/framework/resources/views/components/markdown-heading.blade.php

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
new file mode 100644
index 00000000000..5994c137dfa
--- /dev/null
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -0,0 +1,13 @@
+@props(['level' => 1, 'id' => null])
+
+@php
+    $tag = 'h' . $level;
+    $id = $id ?? \Illuminate\Support\Str::slug($slot);
+@endphp
+
+<{{ $tag }} {{ $attributes->merge(['id' => $id]) }}>
+{{ $slot }}
+@if(config('markdown.features.permalinks', true))
+    <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
+@endif
+</{{ $tag }}> 
\ No newline at end of file

From 7e452976c4ee92e0aafe64fe001c69c399614f9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 18:50:22 +0100
Subject: [PATCH 3451/4023] Render slot literally

---
 .../resources/views/components/markdown-heading.blade.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 5994c137dfa..12c7ab7df21 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -6,7 +6,7 @@
 @endphp
 
 <{{ $tag }} {{ $attributes->merge(['id' => $id]) }}>
-{{ $slot }}
+{!! $slot !!}
 @if(config('markdown.features.permalinks', true))
     <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
 @endif

From 5607c6d63b8f90b5fe568ee361f5acbff15bf441 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 18:50:41 +0100
Subject: [PATCH 3452/4023] Indent code

---
 .../resources/views/components/markdown-heading.blade.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 12c7ab7df21..7af1dd8ab8c 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -6,8 +6,8 @@
 @endphp
 
 <{{ $tag }} {{ $attributes->merge(['id' => $id]) }}>
-{!! $slot !!}
-@if(config('markdown.features.permalinks', true))
-    <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
-@endif
+    {!! $slot !!}
+    @if(config('markdown.features.permalinks', true))
+        <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
+    @endif
 </{{ $tag }}> 
\ No newline at end of file

From ec6b2c6b120ce4d37a12d23772f410779c7c3dcb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:02:03 +0100
Subject: [PATCH 3453/4023] Add an attribute for controlling permalink state

---
 .../resources/views/components/markdown-heading.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 7af1dd8ab8c..5b7bf42759a 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -1,4 +1,4 @@
-@props(['level' => 1, 'id' => null])
+@props(['level' => 1, 'id' => null, 'addPermalink' => config('markdown.features.permalinks', true)])
 
 @php
     $tag = 'h' . $level;
@@ -7,7 +7,7 @@
 
 <{{ $tag }} {{ $attributes->merge(['id' => $id]) }}>
     {!! $slot !!}
-    @if(config('markdown.features.permalinks', true))
+    @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
     @endif
 </{{ $tag }}> 
\ No newline at end of file

From 98ddab10f67f0818c03d7db8e977f0eccc556ff3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:02:30 +0100
Subject: [PATCH 3454/4023] Set state from class

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 7edce1b1209..ac02180733e 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,6 +27,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
+            'addPermalink' => config('markdown.features.permalinks', true),
         ])->render();
     }
 }

From e1ccda8fdd2f414637390fdab799952f88b5675b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:02:40 +0100
Subject: [PATCH 3455/4023] Fix recursion issue

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index ac02180733e..e68528f3f24 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,7 +27,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
-            'addPermalink' => config('markdown.features.permalinks', true),
+            'addPermalink' => config('markdown.features.permalinks', true) && ! str_contains($content, 'class="heading-permalink"'),
         ])->render();
     }
 }

From 24e459fc780cc5a6001c4411e11eb38b0d0ebbf0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:22:11 +0100
Subject: [PATCH 3456/4023] Support extra attributes

---
 .../resources/views/components/markdown-heading.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 5b7bf42759a..6e87150fa0b 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -1,11 +1,11 @@
-@props(['level' => 1, 'id' => null, 'addPermalink' => config('markdown.features.permalinks', true)])
+@props(['level' => 1, 'id' => null, 'addPermalink' => config('markdown.features.permalinks', true), 'extraAttributes' => []])
 
 @php
     $tag = 'h' . $level;
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
 @endphp
 
-<{{ $tag }} {{ $attributes->merge(['id' => $id]) }}>
+<{{ $tag }} {{ $attributes->merge(['id' => $id, ...$extraAttributes]) }}>
     {!! $slot !!}
     @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>

From 2c3e07b78c12d5003a88ebaedbfec54da3f388c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:22:18 +0100
Subject: [PATCH 3457/4023] Forward node attributes

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index e68528f3f24..97d1789d35e 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -28,6 +28,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
             'level' => $node->getLevel(),
             'slot' => $content,
             'addPermalink' => config('markdown.features.permalinks', true) && ! str_contains($content, 'class="heading-permalink"'),
+            'extraAttributes' =>  $node->data->get('attributes')
         ])->render();
     }
 }

From 6631d8689000fc12eb7ad775fdda83c444c61c64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:22:47 +0100
Subject: [PATCH 3458/4023] Format props

---
 .../resources/views/components/markdown-heading.blade.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 6e87150fa0b..f2f72c26954 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -1,4 +1,9 @@
-@props(['level' => 1, 'id' => null, 'addPermalink' => config('markdown.features.permalinks', true), 'extraAttributes' => []])
+@props([
+    'level' => 1,
+    'id' => null,
+    'extraAttributes' => [],
+    'addPermalink' => config('markdown.features.permalinks', true),
+])
 
 @php
     $tag = 'h' . $level;

From 07d5e97aee166e1f86c5f1447af9e6b16c549df7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:27:03 +0100
Subject: [PATCH 3459/4023] Update added config setting

---
 .../resources/views/components/markdown-heading.blade.php       | 2 +-
 packages/framework/src/Markdown/Processing/HeadingRenderer.php  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index f2f72c26954..67ca05c66a5 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -2,7 +2,7 @@
     'level' => 1,
     'id' => null,
     'extraAttributes' => [],
-    'addPermalink' => config('markdown.features.permalinks', true),
+    'addPermalink' => config('markdown.permalinks.enabled', true),
 ])
 
 @php
diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 97d1789d35e..6440c09b074 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,7 +27,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
-            'addPermalink' => config('markdown.features.permalinks', true) && ! str_contains($content, 'class="heading-permalink"'),
+            'addPermalink' => config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"'),
             'extraAttributes' =>  $node->data->get('attributes')
         ])->render();
     }

From c430b9bcb4ae27b04bbdba6d06689058a1e40b7f Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 1 Dec 2024 18:27:49 +0000
Subject: [PATCH 3460/4023] Apply fixes from StyleCI

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 6440c09b074..6182cb9922e 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -28,7 +28,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
             'level' => $node->getLevel(),
             'slot' => $content,
             'addPermalink' => config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"'),
-            'extraAttributes' =>  $node->data->get('attributes')
+            'extraAttributes' => $node->data->get('attributes'),
         ])->render();
     }
 }

From b0a4ef923a1198f1863a44ae881e5181560313e9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:27:40 +0100
Subject: [PATCH 3461/4023] Register the custom heading renderer

---
 .../src/Framework/Services/MarkdownService.php         | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index 9eb8bc8fc79..c3ccf42388a 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Config;
 use Hyde\Facades\Features;
 use Hyde\Markdown\Models\MarkdownDocument;
+use Hyde\Markdown\Processing\HeadingRenderer;
 use Hyde\Framework\Concerns\Internal\SetsUpMarkdownConverter;
 use Hyde\Pages\DocumentationPage;
 use Hyde\Markdown\MarkdownConverter;
@@ -14,6 +15,7 @@
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract as PostProcessor;
 use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
 use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 
 use function str_contains;
 use function str_replace;
@@ -87,6 +89,8 @@ protected function setupConverter(): void
             $this->initializeExtension($extension);
         }
 
+        $this->configureCustomHeadingRenderer();
+
         $this->registerPreProcessors();
         $this->registerPostProcessors();
     }
@@ -272,4 +276,10 @@ protected static function findLineContentPositions(array $lines): array
 
         return [0, 0];
     }
+
+    protected function configureCustomHeadingRenderer(): void
+    {
+        $environment = $this->converter->getEnvironment();
+        $environment->addRenderer(Heading::class, new HeadingRenderer());
+    }
 }

From 87f03f7acd6da73aefdd50b2a30b2281d0fe8266 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:29:45 +0100
Subject: [PATCH 3462/4023] Extract helper method

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 6182cb9922e..6d31b653a84 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,8 +27,13 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
-            'addPermalink' => config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"'),
+            'addPermalink' => $this->canAddPermalink($content),
             'extraAttributes' => $node->data->get('attributes'),
         ])->render();
     }
+
+    protected function canAddPermalink(string $content): bool
+    {
+        return config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"');
+    }
 }

From 585764db303e0d47dc02c7e0f19a6c338d2937d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:29:58 +0100
Subject: [PATCH 3463/4023] Create heading permalinks configuration

---
 config/markdown.php | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/config/markdown.php b/config/markdown.php
index 0ec940714ab..07365a78799 100644
--- a/config/markdown.php
+++ b/config/markdown.php
@@ -95,4 +95,23 @@
     */
 
     'prose_classes' => 'prose dark:prose-invert',
+
+    /*
+    |--------------------------------------------------------------------------
+    | Heading Permalinks Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Here you can specify which page classes should have heading permalinks.
+    | By default, only documentation pages have permalinks enabled, but you
+    | are free to enable it for any kind of page by adding the page class.
+    |
+    */
+
+    'permalinks' => [
+        'enabled' => true,
+        'page_classes' => [
+            \Hyde\Pages\DocumentationPage::class,
+        ],
+    ],
+
 ];

From bfc93e3939b50dc4f8fa4e5c9c1260cbe8487cde Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:32:56 +0100
Subject: [PATCH 3464/4023] Better option name

---
 config/markdown.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config/markdown.php b/config/markdown.php
index 07365a78799..7e8d142084f 100644
--- a/config/markdown.php
+++ b/config/markdown.php
@@ -109,7 +109,7 @@
 
     'permalinks' => [
         'enabled' => true,
-        'page_classes' => [
+        'pages' => [
             \Hyde\Pages\DocumentationPage::class,
         ],
     ],

From cb6c70e3a887b647c7212fcd1ba4ff11bb37c82c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:33:06 +0100
Subject: [PATCH 3465/4023] Construct with page class

---
 .../framework/src/Framework/Services/MarkdownService.php | 2 +-
 .../src/Markdown/Processing/HeadingRenderer.php          | 9 +++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index c3ccf42388a..cf61708457e 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -280,6 +280,6 @@ protected static function findLineContentPositions(array $lines): array
     protected function configureCustomHeadingRenderer(): void
     {
         $environment = $this->converter->getEnvironment();
-        $environment->addRenderer(Heading::class, new HeadingRenderer());
+        $environment->addRenderer(Heading::class, new HeadingRenderer($this->pageClass));
     }
 }
diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 6d31b653a84..e218bab86f1 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -16,6 +16,15 @@
  */
 class HeadingRenderer implements NodeRendererInterface
 {
+    /** @var class-string<\Hyde\Pages\Concerns\HydePage> */
+    protected string $pageClass;
+
+    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
+    public function __construct(string $pageClass)
+    {
+        $this->pageClass = $pageClass;
+    }
+
     public function render(Node $node, ChildNodeRendererInterface $childRenderer): string
     {
         if (! ($node instanceof Heading)) {

From 94cada0cd548150d9be2cdba4f89fe6b138813f9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:35:32 +0100
Subject: [PATCH 3466/4023] Add permalinks only for configured pages

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index e218bab86f1..62c8f18d51d 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Markdown\Processing;
 
+use Hyde\Pages\DocumentationPage;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
@@ -43,6 +44,6 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
 
     protected function canAddPermalink(string $content): bool
     {
-        return config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"');
+        return config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"') && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
     }
 }

From bcf5cddde41cde644ba566d99c48fbdad0944b40 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:41:04 +0100
Subject: [PATCH 3467/4023] Format long line

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 62c8f18d51d..a9bd051cdba 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -44,6 +44,8 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
 
     protected function canAddPermalink(string $content): bool
     {
-        return config('markdown.permalinks.enabled', true) && ! str_contains($content, 'class="heading-permalink"') && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
+        return config('markdown.permalinks.enabled', true)
+            && ! str_contains($content, 'class="heading-permalink"')
+            && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
     }
 }

From 22d30c56264e705593e21f8e259ee92d9a1bd514 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:41:41 +0100
Subject: [PATCH 3468/4023] Nullable class string

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index a9bd051cdba..f21e79bb3da 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -17,11 +17,11 @@
  */
 class HeadingRenderer implements NodeRendererInterface
 {
-    /** @var class-string<\Hyde\Pages\Concerns\HydePage> */
-    protected string $pageClass;
+    /** @var ?class-string<\Hyde\Pages\Concerns\HydePage> */
+    protected ?string $pageClass = null;
 
-    /** @param class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
-    public function __construct(string $pageClass)
+    /** @param ?class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
+    public function __construct(string $pageClass = null)
     {
         $this->pageClass = $pageClass;
     }

From 6fbb65620f3b441877c4d59742d25484f90db14b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 19:42:07 +0100
Subject: [PATCH 3469/4023] Remove auto-configuration for
 HeadingPermalinkExtension

---
 .../Internal/SetsUpMarkdownConverter.php        |  4 ----
 .../src/Framework/Services/MarkdownService.php  | 17 -----------------
 2 files changed, 21 deletions(-)

diff --git a/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php b/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
index 307c2caa81d..73dc6ab4a1d 100644
--- a/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
+++ b/packages/framework/src/Framework/Concerns/Internal/SetsUpMarkdownConverter.php
@@ -25,10 +25,6 @@ trait SetsUpMarkdownConverter
 {
     protected function enableDynamicExtensions(): void
     {
-        if ($this->canEnablePermalinks()) {
-            $this->configurePermalinksExtension();
-        }
-
         if ($this->canEnableTorchlight()) {
             $this->addExtension(TorchlightExtension::class);
         }
diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index cf61708457e..c7b799a48dc 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -13,7 +13,6 @@
 use Hyde\Markdown\MarkdownConverter;
 use Hyde\Markdown\Contracts\MarkdownPreProcessorContract as PreProcessor;
 use Hyde\Markdown\Contracts\MarkdownPostProcessorContract as PostProcessor;
-use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
 use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 
@@ -204,22 +203,6 @@ protected function injectTorchlightAttribution(): string
         ));
     }
 
-    protected function configurePermalinksExtension(): void
-    {
-        $this->addExtension(HeadingPermalinkExtension::class);
-
-        $this->config = array_merge([
-            'heading_permalink' => [
-                'id_prefix' => '',
-                'fragment_prefix' => '',
-                'symbol' => '',
-                'insert' => 'after',
-                'min_heading_level' => 2,
-                'aria_hidden' => false,
-            ],
-        ], $this->config);
-    }
-
     protected function enableAllHtmlElements(): void
     {
         $this->addExtension(DisallowedRawHtmlExtension::class);

From b7f0509d8a308867821811a7e00cf6f099e7f4c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:10:30 +0100
Subject: [PATCH 3470/4023] Change component to match markup made by extension

---
 .../resources/views/components/markdown-heading.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 67ca05c66a5..a0dec20101f 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -10,9 +10,9 @@
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
 @endphp
 
-<{{ $tag }} {{ $attributes->merge(['id' => $id, ...$extraAttributes]) }}>
+<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
     {!! $slot !!}
     @if($addPermalink === true)
-        <a href="#{{ $id }}" class="heading-permalink" aria-label="Permalink for this section"></a>
+        <a id="{{ $id }}" href="#{{ $id }}" class="heading-permalink" title="Permalink"></a>
     @endif
 </{{ $tag }}> 
\ No newline at end of file

From 539a8ebcaaefe1ce26de26df88800f7dfe92a418 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:14:49 +0100
Subject: [PATCH 3471/4023] Use more explicit assertions

---
 .../Feature/Services/HydeSmartDocsTest.php     | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php b/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
index cdf2540614a..e22136b9b57 100644
--- a/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
+++ b/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
@@ -18,32 +18,32 @@ public function testClassTokenizesDocument()
     {
         $article = $this->makeArticle("# Header Content \n\n Body Content");
 
-        $this->assertEquals('<h1>Header Content</h1>', $article->renderHeader());
-        $this->assertEquals('<p>Body Content</p>', $article->renderBody());
+        $this->assertSame('<h1>Header Content</h1>', $article->renderHeader()->toHtml());
+        $this->assertSame('<p>Body Content</p>', $article->renderBody()->toHtml());
     }
 
     public function testClassCanHandleDocumentWithNoHeader()
     {
         $article = $this->makeArticle('Body Content');
 
-        $this->assertEquals('', $article->renderHeader());
-        $this->assertEquals('<p>Body Content</p>', $article->renderBody());
+        $this->assertSame('', $article->renderHeader()->toHtml());
+        $this->assertSame('<p>Body Content</p>', $article->renderBody()->toHtml());
     }
 
     public function testClassCanHandleDocumentWithOnlyHeader()
     {
         $article = $this->makeArticle('# Header Content');
 
-        $this->assertEquals('<h1>Header Content</h1>', $article->renderHeader());
-        $this->assertEquals('', $article->renderBody());
+        $this->assertSame('<h1>Header Content</h1>', $article->renderHeader()->toHtml());
+        $this->assertSame('', $article->renderBody()->toHtml());
     }
 
     public function testClassCanHandleEmptyDocument()
     {
         $article = $this->makeArticle('');
 
-        $this->assertEquals('', $article->renderHeader());
-        $this->assertEquals('', $article->renderBody());
+        $this->assertSame('', $article->renderHeader()->toHtml());
+        $this->assertSame('', $article->renderBody()->toHtml());
     }
 
     public function testRenderedContentIsHtmlable()
@@ -61,7 +61,7 @@ public function testCreateHelperCreatesNewInstanceAndProcessesIt()
 
         $this->assertInstanceOf(SemanticDocumentationArticle::class, $article);
 
-        $this->assertEquals('<p>Hello world.</p>', $article->renderBody());
+        $this->assertSame('<p>Hello world.</p>', $article->renderBody()->toHtml());
     }
 
     public function testRenderHeaderReturnsTheExtractedHeader()

From 53b158fc83e4b75889a99c1d525c88b2229ea3d2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:19:46 +0100
Subject: [PATCH 3472/4023] Make the permalink headings level configurable

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index f21e79bb3da..3fef190e219 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -37,14 +37,16 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
-            'addPermalink' => $this->canAddPermalink($content),
+            'addPermalink' => $this->canAddPermalink($content, $node->getLevel()),
             'extraAttributes' => $node->data->get('attributes'),
         ])->render();
     }
 
-    protected function canAddPermalink(string $content): bool
+    protected function canAddPermalink(string $content, int $level): bool
     {
         return config('markdown.permalinks.enabled', true)
+            && $level >= config('markdown.permalinks.min_level', 1)
+            && $level <= config('markdown.permalinks.max_level', 6)
             && ! str_contains($content, 'class="heading-permalink"')
             && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
     }

From bb9fd0aca40c3ae6f94644ed7abe09b9ec74da83 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:20:00 +0100
Subject: [PATCH 3473/4023] Default to minimum level of 2

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 3fef190e219..682aaeca011 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -45,7 +45,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
     protected function canAddPermalink(string $content, int $level): bool
     {
         return config('markdown.permalinks.enabled', true)
-            && $level >= config('markdown.permalinks.min_level', 1)
+            && $level >= config('markdown.permalinks.min_level', 2)
             && $level <= config('markdown.permalinks.max_level', 6)
             && ! str_contains($content, 'class="heading-permalink"')
             && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));

From d8896ad16bc8b4e292a9d3bbc61a649f52e00d9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:22:32 +0100
Subject: [PATCH 3474/4023] Introduce local variable

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 682aaeca011..52e5d42cb50 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -34,12 +34,14 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
 
         $content = $childRenderer->renderNodes($node->children());
 
-        return view('hyde::components.markdown-heading', [
+        $rendered = view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
             'addPermalink' => $this->canAddPermalink($content, $node->getLevel()),
             'extraAttributes' => $node->data->get('attributes'),
         ])->render();
+
+        return $rendered;
     }
 
     protected function canAddPermalink(string $content, int $level): bool

From 2c5396345f38758736b72211b6013e2e25b110c7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:27:28 +0100
Subject: [PATCH 3475/4023] Post process to normalize result to CommonMark
 implementation

---
 .../src/Markdown/Processing/HeadingRenderer.php    | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 52e5d42cb50..a6a71ae150d 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -41,7 +41,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
             'extraAttributes' => $node->data->get('attributes'),
         ])->render();
 
-        return $rendered;
+        return $this->postProcess($rendered);
     }
 
     protected function canAddPermalink(string $content, int $level): bool
@@ -52,4 +52,16 @@ protected function canAddPermalink(string $content, int $level): bool
             && ! str_contains($content, 'class="heading-permalink"')
             && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
     }
+
+    protected function postProcess(string $html): string
+    {
+        $html = str_replace('<h1 >', '<h1>', $html);
+        $html = str_replace('<h2 >', '<h2>', $html);
+        $html = str_replace('<h3 >', '<h3>', $html);
+        $html = str_replace('<h4 >', '<h4>', $html);
+        $html = str_replace('<h5 >', '<h5>', $html);
+        $html = str_replace('<h6 >', '<h6>', $html);
+
+        return implode('', array_map('trim', explode("\n", $html)));
+    }
 }

From 358c7996680f233091fa973a5add3ae3de82cd9a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:28:06 +0100
Subject: [PATCH 3476/4023] Replace multiple replacements with single Regex

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php  | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index a6a71ae150d..40fdbbffbc3 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -55,12 +55,7 @@ protected function canAddPermalink(string $content, int $level): bool
 
     protected function postProcess(string $html): string
     {
-        $html = str_replace('<h1 >', '<h1>', $html);
-        $html = str_replace('<h2 >', '<h2>', $html);
-        $html = str_replace('<h3 >', '<h3>', $html);
-        $html = str_replace('<h4 >', '<h4>', $html);
-        $html = str_replace('<h5 >', '<h5>', $html);
-        $html = str_replace('<h6 >', '<h6>', $html);
+        $html = preg_replace('/<h([1-6]) >/', '<h$1>', $html);
 
         return implode('', array_map('trim', explode("\n", $html)));
     }

From cc8cc6d5b57b5683d58018cb1fce2c1588934a1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:32:20 +0100
Subject: [PATCH 3477/4023] Add a test for when heading permalinks are disabled

---
 .../tests/Feature/Services/HydeSmartDocsTest.php       | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php b/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
index e22136b9b57..9648ce4b941 100644
--- a/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
+++ b/packages/framework/tests/Feature/Services/HydeSmartDocsTest.php
@@ -214,6 +214,16 @@ public function renderHeader(): HtmlString
         $this->assertStringContainsString('<p>Hello world.</p>', $rendered);
     }
 
+    public function testClassCanParseDocumentWithDisabledPermalinks()
+    {
+        config(['markdown.permalinks.enabled' => false]);
+
+        $article = $this->makeArticle("# Header Content \n\n Body Content");
+
+        $this->assertSame('<h1>Header Content</h1>', $article->renderHeader()->toHtml());
+        $this->assertSame('<p>Body Content</p>', $article->renderBody()->toHtml());
+    }
+
     protected function makeArticle(string $sourceFileContents = "# Foo\n\nHello world."): SemanticDocumentationArticle
     {
         $this->file('_docs/foo.md', $sourceFileContents);

From 2475010f63053af3a956a804fe9ed989fe14df7a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 20:36:18 +0100
Subject: [PATCH 3478/4023] Sync configuration files

---
 packages/framework/config/markdown.php | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/packages/framework/config/markdown.php b/packages/framework/config/markdown.php
index 0ec940714ab..7e8d142084f 100644
--- a/packages/framework/config/markdown.php
+++ b/packages/framework/config/markdown.php
@@ -95,4 +95,23 @@
     */
 
     'prose_classes' => 'prose dark:prose-invert',
+
+    /*
+    |--------------------------------------------------------------------------
+    | Heading Permalinks Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Here you can specify which page classes should have heading permalinks.
+    | By default, only documentation pages have permalinks enabled, but you
+    | are free to enable it for any kind of page by adding the page class.
+    |
+    */
+
+    'permalinks' => [
+        'enabled' => true,
+        'pages' => [
+            \Hyde\Pages\DocumentationPage::class,
+        ],
+    ],
+
 ];

From 30469f429822eb2f0982ecdd27e149497783aedc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:22:09 +0100
Subject: [PATCH 3479/4023] Mock the View factory

---
 .../framework/tests/Unit/IncludesFacadeUnitTest.php   | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 17f982db1de..7e0d6244a76 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Illuminate\Contracts\View\Factory;
 use Mockery;
 use Closure;
 use Hyde\Hyde;
@@ -34,6 +35,16 @@ protected function setUp(): void
     {
         Blade::swap(Mockery::mock());
 
+        // Mock the View factory
+        $viewFactory = Mockery::mock(Factory::class);
+        $viewFactory->shouldReceive('make')
+            ->with('hyde::components.markdown-heading', Mockery::any())
+            ->andReturn(Mockery::mock([
+                'render' => '<h1>Mocked Heading</h1>'
+            ]));
+
+        app()->instance('view', $viewFactory);
+
         $this->setupTestKernel()->setRoutes(collect());
     }
 

From a6bcaa18bfb09d83c12b565c5b738a0cc5baa7fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:23:11 +0100
Subject: [PATCH 3480/4023] Fix mock bindings

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 7e0d6244a76..05da1556e13 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -4,7 +4,6 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Illuminate\Contracts\View\Factory;
 use Mockery;
 use Closure;
 use Hyde\Hyde;
@@ -35,8 +34,7 @@ protected function setUp(): void
     {
         Blade::swap(Mockery::mock());
 
-        // Mock the View factory
-        $viewFactory = Mockery::mock(Factory::class);
+        $viewFactory = Mockery::mock(\Illuminate\Contracts\View\Factory::class);
         $viewFactory->shouldReceive('make')
             ->with('hyde::components.markdown-heading', Mockery::any())
             ->andReturn(Mockery::mock([
@@ -44,6 +42,7 @@ protected function setUp(): void
             ]));
 
         app()->instance('view', $viewFactory);
+        app()->instance(\Illuminate\Contracts\View\Factory::class, $viewFactory);
 
         $this->setupTestKernel()->setRoutes(collect());
     }

From 567b505977f7d7a08af43ab6547873460e451bed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:37:00 +0100
Subject: [PATCH 3481/4023] Granular mocks

---
 .../tests/Unit/IncludesFacadeUnitTest.php     | 29 ++++++++++++-------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 05da1556e13..37e830b33fe 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Illuminate\Contracts\View\Factory;
 use Mockery;
 use Closure;
 use Hyde\Hyde;
@@ -34,16 +35,6 @@ protected function setUp(): void
     {
         Blade::swap(Mockery::mock());
 
-        $viewFactory = Mockery::mock(\Illuminate\Contracts\View\Factory::class);
-        $viewFactory->shouldReceive('make')
-            ->with('hyde::components.markdown-heading', Mockery::any())
-            ->andReturn(Mockery::mock([
-                'render' => '<h1>Mocked Heading</h1>'
-            ]));
-
-        app()->instance('view', $viewFactory);
-        app()->instance(\Illuminate\Contracts\View\Factory::class, $viewFactory);
-
         $this->setupTestKernel()->setRoutes(collect());
     }
 
@@ -160,6 +151,8 @@ public function testMarkdownReturnsRenderedPartial()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
+        $this->mockViewFactory($expected);
+
         $this->assertHtmlStringIsSame($expected, Includes::markdown($filename));
     }
 
@@ -173,6 +166,8 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
+        $this->mockViewFactory($expected);
+
         $this->assertNull(Includes::markdown($filename));
         $this->assertHtmlStringIsSame($expected, Includes::markdown($filename, $default));
     }
@@ -189,6 +184,8 @@ public function testMarkdownWithAndWithoutExtension()
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });
 
+        $this->mockViewFactory($expected);
+
         $this->assertHtmlStringIsSame($expected, Includes::markdown('foo.md'));
         $this->assertHtmlStringIsSame(Includes::markdown('foo.md'), Includes::markdown('foo'));
         $this->assertHtmlStringIsSame(Includes::markdown('foo.md'), Includes::markdown('foo.md'));
@@ -252,6 +249,18 @@ protected function mockFilesystemFromClosure(Closure $config): void
         app()->instance(Filesystem::class, $filesystem);
     }
 
+    protected function mockViewFactory(string $result): void
+    {
+        $viewFactory = Mockery::mock(Factory::class);
+        $viewFactory->shouldReceive('make')
+            ->andReturn(Mockery::mock([
+                'render' => $result,
+            ]))->byDefault();
+
+        app()->instance('view', $viewFactory);
+        app()->instance(Factory::class, $viewFactory);
+    }
+
     protected function includesPath(string $filename): string
     {
         return Hyde::path('resources/includes/'.$filename);

From 22a7745f0a60e8a0b5898abef11b2e1a5e8ebf03 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:44:27 +0100
Subject: [PATCH 3482/4023] Update test to test the automatic permalinks
 feature

---
 packages/framework/tests/Feature/MarkdownServiceTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index 3f8823f7d64..ad33b21372e 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -29,7 +29,7 @@ public function testServiceCanParseMarkdownToHtmlWithPermalinks()
     {
         $markdown = '## Hello World!';
 
-        $html = (new MarkdownService($markdown))->withPermalinks()->parse();
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
         $this->assertIsString($html);
         $this->assertSame(

From 1100719e57f7244387e0a9b84bf66b5735f884ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:48:23 +0100
Subject: [PATCH 3483/4023] Remove the `MarkdownService::withPermalinks` method

See https://github.com/hydephp/develop/pull/2047#issuecomment-2510243423
---
 RELEASE_NOTES.md                                 |  1 +
 .../src/Framework/Services/MarkdownService.php   |  7 -------
 .../tests/Feature/MarkdownServiceTest.php        | 16 ----------------
 3 files changed, 1 insertion(+), 23 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index fe8f2f7fb88..eeb595d630b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -132,6 +132,7 @@ This serves two purposes:
   - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
 - Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
 - Removed The `hyde.css` file from HydeFront in https://github.com/hydephp/develop/pull/2037 as all styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024.
+- Removed the `MarkdownService::withPermalinks` method in https://github.com/hydephp/develop/pull/2047
 
 ### Fixed
 
diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index c7b799a48dc..a5eb175ca7d 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -144,13 +144,6 @@ public function addFeature(string $feature): static
         return $this;
     }
 
-    public function withPermalinks(): static
-    {
-        $this->addFeature('permalinks');
-
-        return $this;
-    }
-
     public function isDocumentationPage(): bool
     {
         return isset($this->pageClass) && $this->pageClass === DocumentationPage::class;
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index ad33b21372e..a5ba860dbc6 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -157,14 +157,6 @@ public function testMethodWithTableOfContentsMethodChainAddsTheTableOfContentsFe
         $this->assertContains('table-of-contents', $service->features);
     }
 
-    public function testMethodWithPermalinksMethodChainAddsThePermalinksFeature()
-    {
-        $service = $this->makeService();
-
-        $service->withPermalinks();
-        $this->assertContains('permalinks', $service->features);
-    }
-
     public function testHasFeatureReturnsTrueIfTheFeatureIsInTheArray()
     {
         $service = $this->makeService();
@@ -180,14 +172,6 @@ public function testHasFeatureReturnsFalseIfTheFeatureIsNotInTheArray()
         $this->assertFalse($service->hasFeature('test'));
     }
 
-    public function testMethodCanEnablePermalinksReturnsTrueIfThePermalinksFeatureIsInTheArray()
-    {
-        $service = $this->makeService();
-
-        $service->addFeature('permalinks');
-        $this->assertTrue($service->canEnablePermalinks());
-    }
-
     public function testMethodCanEnablePermalinksIsAutomaticallyForDocumentationPages()
     {
         $service = new MarkdownServiceTestClass(pageClass: DocumentationPage::class);

From d03dbf303f1d077ee7f9847ad998100c2c51700f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:52:02 +0100
Subject: [PATCH 3484/4023] Add todo

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 40fdbbffbc3..29e03175d9c 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -14,6 +14,8 @@
  * Renders a heading node, and supports built-in permalink generation.
  *
  * @see \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer
+ *
+ * @todo Add more options to customize the permalink.
  */
 class HeadingRenderer implements NodeRendererInterface
 {

From 9311bd1971dba26b35a6e1426bd0d46867ee29d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:59:07 +0100
Subject: [PATCH 3485/4023] Create HeadingRendererUnitTest.php

---
 .../tests/Unit/HeadingRendererUnitTest.php      | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 packages/framework/tests/Unit/HeadingRendererUnitTest.php

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
new file mode 100644
index 00000000000..7ccc77f4aed
--- /dev/null
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Markdown\Processing\HeadingRenderer
+ *
+ * @see \Hyde\Framework\Testing\Feature\MarkdownHeadingRendererTest
+ */
+class HeadingRendererUnitTest extends UnitTestCase
+{
+    //
+}

From 80ed9d440ed94a0361d0caa29520dc03d0f8bdc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 21:59:29 +0100
Subject: [PATCH 3486/4023] Create MarkdownHeadingRendererTest.php

---
 .../Feature/MarkdownHeadingRendererTest.php     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 packages/framework/tests/Feature/MarkdownHeadingRendererTest.php

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
new file mode 100644
index 00000000000..11b5075f75e
--- /dev/null
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Feature;
+
+use Hyde\Testing\TestCase;
+
+/**
+ * @covers \Hyde\Markdown\Processing\HeadingRenderer
+ *
+ * @see \Hyde\Framework\Testing\Unit\HeadingRendererUnitTest
+ */
+class MarkdownHeadingRendererTest extends TestCase
+{
+    //
+}

From 5e243e757baa7d73455a08d5d40820aa5c433b42 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:34:33 +0100
Subject: [PATCH 3487/4023] Create a minimal view environment

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 7ccc77f4aed..5aa4fb1d382 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -5,6 +5,12 @@
 namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Contracts\View\Factory as FactoryContract;
+use Illuminate\Events\Dispatcher;
+use Illuminate\View\Engines\EngineResolver;
+use Illuminate\View\Factory;
+use Illuminate\View\FileViewFinder;
+use Illuminate\Filesystem\Filesystem;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -13,5 +19,19 @@
  */
 class HeadingRendererUnitTest extends UnitTestCase
 {
-    //
+    protected function setUp(): void
+    {
+        // Create a minimal view environment without the full service provider
+        $view = new Factory(
+            new EngineResolver(),
+            new FileViewFinder(
+                new Filesystem(),
+                [realpath(__DIR__ . '/../../resources/views')]
+            ),
+            new Dispatcher()
+        );
+
+        app()->instance('view', $view);
+        app()->instance(FactoryContract::class, $view);
+    }
 }

From c7eb6bbcd94c2eb8d60e7185a65883c525e8c730 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:41:25 +0100
Subject: [PATCH 3488/4023] Register finder path

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 5aa4fb1d382..aa1ba677be0 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -24,13 +24,15 @@ protected function setUp(): void
         // Create a minimal view environment without the full service provider
         $view = new Factory(
             new EngineResolver(),
-            new FileViewFinder(
+            $finder = new FileViewFinder(
                 new Filesystem(),
                 [realpath(__DIR__ . '/../../resources/views')]
             ),
             new Dispatcher()
         );
 
+        $finder->addNamespace('hyde', realpath(__DIR__ . '/../../resources/views'));
+
         app()->instance('view', $view);
         app()->instance(FactoryContract::class, $view);
     }

From bad9eb30af1234096f4ebb6bd5b0e21a0f89d922 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:42:42 +0100
Subject: [PATCH 3489/4023] Create and configure the engine resolver

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index aa1ba677be0..cf7b1f8d06e 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -7,6 +7,8 @@
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Contracts\View\Factory as FactoryContract;
 use Illuminate\Events\Dispatcher;
+use Illuminate\View\Compilers\BladeCompiler;
+use Illuminate\View\Engines\CompilerEngine;
 use Illuminate\View\Engines\EngineResolver;
 use Illuminate\View\Factory;
 use Illuminate\View\FileViewFinder;
@@ -22,10 +24,23 @@ class HeadingRendererUnitTest extends UnitTestCase
     protected function setUp(): void
     {
         // Create a minimal view environment without the full service provider
+        
+        // Create and configure the engine resolver
+        $resolver = new EngineResolver();
+        $filesystem = new Filesystem();
+        
+        // Register the blade engine
+        $resolver->register('blade', function () use ($filesystem) {
+            return new CompilerEngine(
+                new BladeCompiler($filesystem, sys_get_temp_dir())
+            );
+        });
+
+        // Create the view factory with the configured resolver
         $view = new Factory(
-            new EngineResolver(),
+            $resolver,
             $finder = new FileViewFinder(
-                new Filesystem(),
+                $filesystem,
                 [realpath(__DIR__ . '/../../resources/views')]
             ),
             new Dispatcher()

From fd6df97f1c2edcb3311c7a32621fa5daf2bf8413 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:43:49 +0100
Subject: [PATCH 3490/4023] Extract helper method

---
 .../framework/tests/Unit/HeadingRendererUnitTest.php     | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index cf7b1f8d06e..247c278bcc5 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -23,12 +23,15 @@ class HeadingRendererUnitTest extends UnitTestCase
 {
     protected function setUp(): void
     {
-        // Create a minimal view environment without the full service provider
-        
+        $this->createRealBladeCompilerEnvironment();
+    }
+
+    protected function createRealBladeCompilerEnvironment(): void
+    {
         // Create and configure the engine resolver
         $resolver = new EngineResolver();
         $filesystem = new Filesystem();
-        
+
         // Register the blade engine
         $resolver->register('blade', function () use ($filesystem) {
             return new CompilerEngine(

From 4995016fe0627b41aa20d81264538e8c03717629 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:49:44 +0100
Subject: [PATCH 3491/4023] Basic constructor tests

---
 .../tests/Unit/HeadingRendererUnitTest.php         | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 247c278bcc5..d51307fbef9 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -11,6 +11,8 @@
 use Illuminate\View\Engines\CompilerEngine;
 use Illuminate\View\Engines\EngineResolver;
 use Illuminate\View\Factory;
+use Hyde\Markdown\Processing\HeadingRenderer;
+use Hyde\Pages\DocumentationPage;
 use Illuminate\View\FileViewFinder;
 use Illuminate\Filesystem\Filesystem;
 
@@ -26,6 +28,18 @@ protected function setUp(): void
         $this->createRealBladeCompilerEnvironment();
     }
 
+    public function testCanConstruct()
+    {
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $this->assertInstanceOf(HeadingRenderer::class, $renderer);
+    }
+
+    public function testCanConstructWithPageClass()
+    {
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $this->assertInstanceOf(HeadingRenderer::class, $renderer);
+    }
+
     protected function createRealBladeCompilerEnvironment(): void
     {
         // Create and configure the engine resolver

From a13f1e8ab6af3724a9ca789e35345f006f17cb4a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:55:09 +0100
Subject: [PATCH 3492/4023] Cleanup helper method code

---
 .../tests/Unit/HeadingRendererUnitTest.php        | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index d51307fbef9..bbecaab5a1a 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -42,29 +42,20 @@ public function testCanConstructWithPageClass()
 
     protected function createRealBladeCompilerEnvironment(): void
     {
-        // Create and configure the engine resolver
         $resolver = new EngineResolver();
         $filesystem = new Filesystem();
 
-        // Register the blade engine
         $resolver->register('blade', function () use ($filesystem) {
             return new CompilerEngine(
                 new BladeCompiler($filesystem, sys_get_temp_dir())
             );
         });
 
-        // Create the view factory with the configured resolver
-        $view = new Factory(
-            $resolver,
-            $finder = new FileViewFinder(
-                $filesystem,
-                [realpath(__DIR__ . '/../../resources/views')]
-            ),
-            new Dispatcher()
-        );
-
+        $finder = new FileViewFinder($filesystem, [realpath(__DIR__ . '/../../resources/views')]);
         $finder->addNamespace('hyde', realpath(__DIR__ . '/../../resources/views'));
 
+        $view = new Factory($resolver, $finder, new Dispatcher());
+
         app()->instance('view', $view);
         app()->instance(FactoryContract::class, $view);
     }

From 0d08cc57a76a5d48e39bbc5771ef6baa99bea824 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:55:21 +0100
Subject: [PATCH 3493/4023] Helper to mock child node renderer

---
 .../framework/tests/Unit/HeadingRendererUnitTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index bbecaab5a1a..9b883585e54 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -59,4 +59,13 @@ protected function createRealBladeCompilerEnvironment(): void
         app()->instance('view', $view);
         app()->instance(FactoryContract::class, $view);
     }
+
+    protected function mockChildNodeRenderer(string $contents): ChildNodeRendererInterface
+    {
+        $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
+        $childRenderer->shouldReceive('renderNodes')
+            ->andReturn($contents);
+
+        return $childRenderer;
+    }
 }

From 6dc009516a5969a403b2f8c72ccca51dbe7f4af4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:55:42 +0100
Subject: [PATCH 3494/4023] Improve formatting

Apply fixes from StyleCI

Co-Authored-By: StyleCI Bot <bot@styleci.io>
---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 9b883585e54..07e88ebbd9c 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -51,8 +51,8 @@ protected function createRealBladeCompilerEnvironment(): void
             );
         });
 
-        $finder = new FileViewFinder($filesystem, [realpath(__DIR__ . '/../../resources/views')]);
-        $finder->addNamespace('hyde', realpath(__DIR__ . '/../../resources/views'));
+        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
+        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
 
         $view = new Factory($resolver, $finder, new Dispatcher());
 
@@ -63,8 +63,7 @@ protected function createRealBladeCompilerEnvironment(): void
     protected function mockChildNodeRenderer(string $contents): ChildNodeRendererInterface
     {
         $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
-        $childRenderer->shouldReceive('renderNodes')
-            ->andReturn($contents);
+        $childRenderer->shouldReceive('renderNodes')->andReturn($contents);
 
         return $childRenderer;
     }

From a6b26beba66031eea4aa7aacde00c5921cac6607 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 22:59:21 +0100
Subject: [PATCH 3495/4023] Set default value

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 07e88ebbd9c..94b3f61470f 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -60,7 +60,7 @@ protected function createRealBladeCompilerEnvironment(): void
         app()->instance(FactoryContract::class, $view);
     }
 
-    protected function mockChildNodeRenderer(string $contents): ChildNodeRendererInterface
+    protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface
     {
         $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
         $childRenderer->shouldReceive('renderNodes')->andReturn($contents);

From 598d9c93cd3228851f041558cdef0e3bc3d89d4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:04:22 +0100
Subject: [PATCH 3496/4023] Implement initial unit test

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 116 +++++++++++++++++-
 1 file changed, 113 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 94b3f61470f..1adca4c7b5e 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -4,17 +4,22 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Markdown\Processing\HeadingRenderer;
+use Hyde\Pages\DocumentationPage;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Contracts\View\Factory as FactoryContract;
 use Illuminate\Events\Dispatcher;
+use Illuminate\Filesystem\Filesystem;
 use Illuminate\View\Compilers\BladeCompiler;
 use Illuminate\View\Engines\CompilerEngine;
 use Illuminate\View\Engines\EngineResolver;
 use Illuminate\View\Factory;
-use Hyde\Markdown\Processing\HeadingRenderer;
-use Hyde\Pages\DocumentationPage;
 use Illuminate\View\FileViewFinder;
-use Illuminate\Filesystem\Filesystem;
+use InvalidArgumentException;
+use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\ChildNodeRendererInterface;
+use Mockery;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -23,6 +28,8 @@
  */
 class HeadingRendererUnitTest extends UnitTestCase
 {
+    protected static bool $needsConfig = true;
+
     protected function setUp(): void
     {
         $this->createRealBladeCompilerEnvironment();
@@ -40,6 +47,109 @@ public function testCanConstructWithPageClass()
         $this->assertInstanceOf(HeadingRenderer::class, $renderer);
     }
 
+    public function testCanRenderHeading()
+    {
+        $childRenderer = $this->mockChildNodeRenderer();
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $rendered = $renderer->render(new Heading(2), $childRenderer);
+
+        $this->assertStringContainsString('Test Heading', $rendered);
+        $this->assertStringContainsString('<h2', $rendered);
+        $this->assertStringContainsString('</h2>', $rendered);
+
+        $this->assertSame('<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>', $rendered);
+    }
+
+    public function testAddsPermalinkToValidHeadings()
+    {
+        $childRenderer = $this->mockChildNodeRenderer();
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $heading = new Heading(2);
+        $rendered = $renderer->render($heading, $childRenderer);
+
+        $this->assertStringContainsString('heading-permalink', $rendered);
+        $this->assertStringContainsString('#test-heading', $rendered);
+    }
+
+    public function testDoesNotAddPermalinkToLevelOneHeadingByDefault()
+    {
+        $childRenderer = $this->mockChildNodeRenderer();
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $rendered = $renderer->render(new Heading(1), $childRenderer);
+
+        $this->assertStringNotContainsString('heading-permalink', $rendered);
+    }
+
+    public function testAddsPermalinkToLevelOneHeadingIfConfigured()
+    {
+        self::mockConfig(['markdown.permalinks.min_level' => 1]);
+
+        $childRenderer = $this->mockChildNodeRenderer();
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $rendered = $renderer->render(new Heading(1), $childRenderer);
+
+        $this->assertStringContainsString('heading-permalink', $rendered);
+    }
+
+    public function testThrowsExceptionForInvalidNode()
+    {
+        $invalidNode = Mockery::mock(Node::class);
+
+        $this->expectException(InvalidArgumentException::class);
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
+        $renderer->render($invalidNode, $childRenderer);
+    }
+
+    public function testDoesNotAddPermalinksIfDisabledInConfiguration()
+    {
+        self::mockConfig(['markdown.permalinks.enabled' => false]);
+
+        $childRenderer = $this->mockChildNodeRenderer();
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $rendered = $renderer->render(new Heading(2), $childRenderer);
+
+        $this->assertStringNotContainsString('heading-permalink', $rendered);
+    }
+
+    public function testForwardsHeadingAttributes()
+    {
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $heading = new Heading(2);
+        $heading->data->set('attributes', ['class' => 'custom-class']);
+        $rendered = $renderer->render($heading, $childRenderer);
+
+        $this->assertStringContainsString('class="custom-class"', $rendered);
+    }
+
+    public function testForwardsArbitraryHeadingAttributes()
+    {
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $heading = new Heading(2);
+        $heading->data->set('attributes', ['foo' => 'bar']);
+        $rendered = $renderer->render($heading, $childRenderer);
+
+        $this->assertStringContainsString('foo="bar"', $rendered);
+    }
+
+    public function testMergesAllHeadingAttributes()
+    {
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $heading = new Heading(2);
+        $heading->data->set('attributes', ['class' => 'custom-class', 'foo' => 'bar']);
+        $rendered = $renderer->render($heading, $childRenderer);
+
+        $this->assertStringContainsString('class="custom-class"', $rendered);
+        $this->assertStringContainsString('foo="bar"', $rendered);
+    }
+
     protected function createRealBladeCompilerEnvironment(): void
     {
         $resolver = new EngineResolver();

From 5b00e792a0d7e7e2fde545e08d9072e52bdaf568 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:14:01 +0100
Subject: [PATCH 3497/4023] Test can add permalink based on configuration

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 1adca4c7b5e..236f98f0c08 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -113,6 +113,32 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
+    public function testCanAddPermalinkBasedOnConfiguration()
+    {
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $heading = new Heading(2);
+        $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
+
+        $childRenderer->shouldReceive('renderNodes')
+            ->andReturn('Test Content');
+
+        // Test with different heading levels
+        foreach (range(1, 2) as $level) {
+            $heading->setLevel($level);
+            $rendered = $renderer->render($heading, $childRenderer);
+
+            $this->assertStringNotContainsString('heading-permalink', $rendered);
+        }
+
+        // Test with different heading levels
+        foreach (range(3, 6) as $level) {
+            $heading->setLevel($level);
+            $rendered = $renderer->render($heading, $childRenderer);
+
+            $this->assertStringContainsString('heading-permalink', $rendered);
+        }
+    }
+
     public function testForwardsHeadingAttributes()
     {
         $childRenderer = $this->mockChildNodeRenderer('Test Content');

From bc876e8d162bf80c64c66b9a5456e18b346496e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:17:34 +0100
Subject: [PATCH 3498/4023] Refactor to data provider attribute

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 32 ++++++++-----------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 236f98f0c08..6a478aff6b8 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -20,6 +20,7 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
+use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -113,29 +114,22 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
-    public function testCanAddPermalinkBasedOnConfiguration()
+    #[TestWith([1, false])]
+    #[TestWith([2, true])]
+    #[TestWith([3, true])]
+    #[TestWith([4, true])]
+    #[TestWith([5, true])]
+    #[TestWith([6, true])]
+    public function testCanAddPermalinkBasedOnConfiguration(int $level, bool $shouldHavePermalink): void
     {
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
         $renderer = new HeadingRenderer(DocumentationPage::class);
-        $heading = new Heading(2);
-        $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
-
-        $childRenderer->shouldReceive('renderNodes')
-            ->andReturn('Test Content');
-
-        // Test with different heading levels
-        foreach (range(1, 2) as $level) {
-            $heading->setLevel($level);
-            $rendered = $renderer->render($heading, $childRenderer);
-
-            $this->assertStringNotContainsString('heading-permalink', $rendered);
-        }
-
-        // Test with different heading levels
-        foreach (range(3, 6) as $level) {
-            $heading->setLevel($level);
-            $rendered = $renderer->render($heading, $childRenderer);
+        $rendered = $renderer->render(new Heading($level), $childRenderer);
 
+        if ($shouldHavePermalink) {
             $this->assertStringContainsString('heading-permalink', $rendered);
+        } else {
+            $this->assertStringNotContainsString('heading-permalink', $rendered);
         }
     }
 

From 10e905a719d6f2bed1679dbccdbd73dd283f7034 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:17:40 +0100
Subject: [PATCH 3499/4023] Clean up after test

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 6a478aff6b8..6522d07208f 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -112,6 +112,8 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $rendered = $renderer->render(new Heading(2), $childRenderer);
 
         $this->assertStringNotContainsString('heading-permalink', $rendered);
+
+        self::mockConfig(['markdown.permalinks.enabled' => true]);
     }
 
     #[TestWith([1, false])]

From 703e70cc8a7508227049f19649d6701c1617a86c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:24:57 +0100
Subject: [PATCH 3500/4023] Automatically reset to cached config default

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 6522d07208f..9eaae81b55b 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -30,10 +30,13 @@
 class HeadingRendererUnitTest extends UnitTestCase
 {
     protected static bool $needsConfig = true;
+    protected static ?array $cachedConfig = null;
 
     protected function setUp(): void
     {
         $this->createRealBladeCompilerEnvironment();
+
+        self::mockConfig(['markdown' => self::$cachedConfig ??= require __DIR__.'/../../config/markdown.php']);
     }
 
     public function testCanConstruct()
@@ -112,8 +115,6 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $rendered = $renderer->render(new Heading(2), $childRenderer);
 
         $this->assertStringNotContainsString('heading-permalink', $rendered);
-
-        self::mockConfig(['markdown.permalinks.enabled' => true]);
     }
 
     #[TestWith([1, false])]

From 039c11a1851d2060b73b7775405cdd8ae153e256 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:27:04 +0100
Subject: [PATCH 3501/4023] More extensive range testing

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 90 ++++++++++++++++---
 1 file changed, 79 insertions(+), 11 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 9eaae81b55b..b6c9bbd35db 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -20,7 +20,6 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
-use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -117,21 +116,90 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
-    #[TestWith([1, false])]
-    #[TestWith([2, true])]
-    #[TestWith([3, true])]
-    #[TestWith([4, true])]
-    #[TestWith([5, true])]
-    #[TestWith([6, true])]
-    public function testCanAddPermalinkBasedOnConfiguration(int $level, bool $shouldHavePermalink): void
+    public function testPermalinksAreAddedDependingOnConfigurationWithDefaultRange(): void
     {
         $childRenderer = $this->mockChildNodeRenderer('Test Content');
         $renderer = new HeadingRenderer(DocumentationPage::class);
-        $rendered = $renderer->render(new Heading($level), $childRenderer);
 
-        if ($shouldHavePermalink) {
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
+            $shouldHavePermalink = $level >= 2;
+
+            if ($shouldHavePermalink) {
+                $this->assertStringContainsString('heading-permalink', $rendered);
+            } else {
+                $this->assertStringNotContainsString('heading-permalink', $rendered);
+            }
+        }
+    }
+
+    public function testPermalinksAreAddedDependingOnConfigurationWithFullRange(): void
+    {
+        self::mockConfig(['markdown.permalinks.min_level' => 1, 'markdown.permalinks.max_level' => 6]);
+
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
             $this->assertStringContainsString('heading-permalink', $rendered);
-        } else {
+        }
+    }
+
+    public function testPermalinksAreAddedDependingOnConfigurationWithCustomRange(): void
+    {
+        self::mockConfig(['markdown.permalinks.min_level' => 3, 'markdown.permalinks.max_level' => 4]);
+
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
+            $shouldHavePermalink = $level >= 3 && $level <= 4;
+
+            if ($shouldHavePermalink) {
+                $this->assertStringContainsString('heading-permalink', $rendered);
+            } else {
+                $this->assertStringNotContainsString('heading-permalink', $rendered);
+            }
+        }
+    }
+
+    public function testPermalinksAreAddedDependingOnConfigurationWithNoRange(): void
+    {
+        self::mockConfig(['markdown.permalinks.min_level' => 0, 'markdown.permalinks.max_level' => 0]);
+
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
+            $this->assertStringNotContainsString('heading-permalink', $rendered);
+        }
+
+        self::mockConfig(['markdown.permalinks.min_level' => 7, 'markdown.permalinks.max_level' => 8]);
+
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
+            $this->assertStringNotContainsString('heading-permalink', $rendered);
+        }
+
+        self::mockConfig(['markdown.permalinks.min_level' => -6, 'markdown.permalinks.max_level' => -5]);
+
+        $childRenderer = $this->mockChildNodeRenderer('Test Content');
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
             $this->assertStringNotContainsString('heading-permalink', $rendered);
         }
     }

From 3a709ddf8a5ed7925f89804447abfd35e321e82b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:28:20 +0100
Subject: [PATCH 3502/4023] Revert "More extensive range testing"

This reverts commit 039c11a1851d2060b73b7775405cdd8ae153e256.
---
 .../tests/Unit/HeadingRendererUnitTest.php    | 90 +++----------------
 1 file changed, 11 insertions(+), 79 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index b6c9bbd35db..9eaae81b55b 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -20,6 +20,7 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
+use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -116,90 +117,21 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
-    public function testPermalinksAreAddedDependingOnConfigurationWithDefaultRange(): void
+    #[TestWith([1, false])]
+    #[TestWith([2, true])]
+    #[TestWith([3, true])]
+    #[TestWith([4, true])]
+    #[TestWith([5, true])]
+    #[TestWith([6, true])]
+    public function testCanAddPermalinkBasedOnConfiguration(int $level, bool $shouldHavePermalink): void
     {
         $childRenderer = $this->mockChildNodeRenderer('Test Content');
         $renderer = new HeadingRenderer(DocumentationPage::class);
+        $rendered = $renderer->render(new Heading($level), $childRenderer);
 
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
-            $shouldHavePermalink = $level >= 2;
-
-            if ($shouldHavePermalink) {
-                $this->assertStringContainsString('heading-permalink', $rendered);
-            } else {
-                $this->assertStringNotContainsString('heading-permalink', $rendered);
-            }
-        }
-    }
-
-    public function testPermalinksAreAddedDependingOnConfigurationWithFullRange(): void
-    {
-        self::mockConfig(['markdown.permalinks.min_level' => 1, 'markdown.permalinks.max_level' => 6]);
-
-        $childRenderer = $this->mockChildNodeRenderer('Test Content');
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
+        if ($shouldHavePermalink) {
             $this->assertStringContainsString('heading-permalink', $rendered);
-        }
-    }
-
-    public function testPermalinksAreAddedDependingOnConfigurationWithCustomRange(): void
-    {
-        self::mockConfig(['markdown.permalinks.min_level' => 3, 'markdown.permalinks.max_level' => 4]);
-
-        $childRenderer = $this->mockChildNodeRenderer('Test Content');
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
-            $shouldHavePermalink = $level >= 3 && $level <= 4;
-
-            if ($shouldHavePermalink) {
-                $this->assertStringContainsString('heading-permalink', $rendered);
-            } else {
-                $this->assertStringNotContainsString('heading-permalink', $rendered);
-            }
-        }
-    }
-
-    public function testPermalinksAreAddedDependingOnConfigurationWithNoRange(): void
-    {
-        self::mockConfig(['markdown.permalinks.min_level' => 0, 'markdown.permalinks.max_level' => 0]);
-
-        $childRenderer = $this->mockChildNodeRenderer('Test Content');
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
-            $this->assertStringNotContainsString('heading-permalink', $rendered);
-        }
-
-        self::mockConfig(['markdown.permalinks.min_level' => 7, 'markdown.permalinks.max_level' => 8]);
-
-        $childRenderer = $this->mockChildNodeRenderer('Test Content');
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
-            $this->assertStringNotContainsString('heading-permalink', $rendered);
-        }
-
-        self::mockConfig(['markdown.permalinks.min_level' => -6, 'markdown.permalinks.max_level' => -5]);
-
-        $childRenderer = $this->mockChildNodeRenderer('Test Content');
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
-        foreach (range(1, 6) as $level) {
-            $rendered = $renderer->render(new Heading($level), $childRenderer);
-
+        } else {
             $this->assertStringNotContainsString('heading-permalink', $rendered);
         }
     }

From 496260cf1be10ac15f40bf3a77a251cf65fc9a76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:28:57 +0100
Subject: [PATCH 3503/4023] Make protected helper methods public internal

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php   | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 29e03175d9c..8a9433104e5 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -46,7 +46,8 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         return $this->postProcess($rendered);
     }
 
-    protected function canAddPermalink(string $content, int $level): bool
+    /** @internal */
+    public function canAddPermalink(string $content, int $level): bool
     {
         return config('markdown.permalinks.enabled', true)
             && $level >= config('markdown.permalinks.min_level', 2)
@@ -55,7 +56,8 @@ protected function canAddPermalink(string $content, int $level): bool
             && in_array($this->pageClass, config('markdown.permalinks.pages', [DocumentationPage::class]));
     }
 
-    protected function postProcess(string $html): string
+    /** @internal */
+    public function postProcess(string $html): string
     {
         $html = preg_replace('/<h([1-6]) >/', '<h$1>', $html);
 

From 90ff9295151f25bb83a5ac791b4d706a48b1320b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:37:12 +0100
Subject: [PATCH 3504/4023] Remove tests for later refactor

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 20 -------------------
 1 file changed, 20 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 9eaae81b55b..f90376142cc 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -75,26 +75,6 @@ public function testAddsPermalinkToValidHeadings()
         $this->assertStringContainsString('#test-heading', $rendered);
     }
 
-    public function testDoesNotAddPermalinkToLevelOneHeadingByDefault()
-    {
-        $childRenderer = $this->mockChildNodeRenderer();
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-        $rendered = $renderer->render(new Heading(1), $childRenderer);
-
-        $this->assertStringNotContainsString('heading-permalink', $rendered);
-    }
-
-    public function testAddsPermalinkToLevelOneHeadingIfConfigured()
-    {
-        self::mockConfig(['markdown.permalinks.min_level' => 1]);
-
-        $childRenderer = $this->mockChildNodeRenderer();
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-        $rendered = $renderer->render(new Heading(1), $childRenderer);
-
-        $this->assertStringContainsString('heading-permalink', $rendered);
-    }
-
     public function testThrowsExceptionForInvalidNode()
     {
         $invalidNode = Mockery::mock(Node::class);

From 0382947ca6f988b02049bc48d426c011dad7ff5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 1 Dec 2024 23:37:20 +0100
Subject: [PATCH 3505/4023] Cleaner and extended testing

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 40 +++++++++++++------
 1 file changed, 27 insertions(+), 13 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index f90376142cc..ec6ff4d173b 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -97,23 +97,22 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
-    #[TestWith([1, false])]
-    #[TestWith([2, true])]
-    #[TestWith([3, true])]
-    #[TestWith([4, true])]
-    #[TestWith([5, true])]
-    #[TestWith([6, true])]
-    public function testCanAddPermalinkBasedOnConfiguration(int $level, bool $shouldHavePermalink): void
+    public function testAddsPermalinksBasedOnConfiguration(): void
     {
         $childRenderer = $this->mockChildNodeRenderer('Test Content');
         $renderer = new HeadingRenderer(DocumentationPage::class);
-        $rendered = $renderer->render(new Heading($level), $childRenderer);
 
-        if ($shouldHavePermalink) {
-            $this->assertStringContainsString('heading-permalink', $rendered);
-        } else {
-            $this->assertStringNotContainsString('heading-permalink', $rendered);
-        }
+        self::mockConfig(['markdown.permalinks.min_level' => 2, 'markdown.permalinks.max_level' => 6]);
+
+        $this->validateHeadingPermalinkStates($renderer, $childRenderer);
+
+        self::mockConfig(['markdown.permalinks.min_level' => 3, 'markdown.permalinks.max_level' => 4]);
+
+        $this->validateHeadingPermalinkStates($renderer, $childRenderer);
+
+        self::mockConfig(['markdown.permalinks.min_level' => 0, 'markdown.permalinks.max_level' => 0]);
+
+        $this->validateHeadingPermalinkStates($renderer, $childRenderer);
     }
 
     public function testForwardsHeadingAttributes()
@@ -180,4 +179,19 @@ protected function mockChildNodeRenderer(string $contents = 'Test Heading'): Chi
 
         return $childRenderer;
     }
+
+    protected function validateHeadingPermalinkStates(HeadingRenderer $renderer, ChildNodeRendererInterface $childRenderer): void
+    {
+        foreach (range(1, 6) as $level) {
+            $rendered = $renderer->render(new Heading($level), $childRenderer);
+
+            $shouldHavePermalink = $level >= config('markdown.permalinks.min_level') && $level <= config('markdown.permalinks.max_level');
+
+            if ($shouldHavePermalink) {
+                $this->assertStringContainsString('heading-permalink', $rendered);
+            } else {
+                $this->assertStringNotContainsString('heading-permalink', $rendered);
+            }
+        }
+    }
 }

From 240e3dd9d615bd4bdaf609789779455d93146586 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:01:30 +0100
Subject: [PATCH 3506/4023] Test more code paths

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index ec6ff4d173b..ee52b2905fa 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Markdown\Processing\HeadingRenderer;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Contracts\View\Factory as FactoryContract;
 use Illuminate\Events\Dispatcher;
@@ -152,6 +153,36 @@ public function testMergesAllHeadingAttributes()
         $this->assertStringContainsString('foo="bar"', $rendered);
     }
 
+    public function testCanAddPermalinkReturnsFalseForExistingPermalink(): void
+    {
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+        $content = 'Test Content<a class="heading-permalink"></a>';
+        
+        $result = $renderer->canAddPermalink($content, 2);
+        
+        $this->assertFalse($result);
+    }
+
+    public function testCanAddPermalinkReturnsFalseForNotEnabledPageClass(): void
+    {
+        $renderer = new HeadingRenderer(MarkdownPage::class);
+        $result = $renderer->canAddPermalink('Test Content', 2);
+
+        $this->assertFalse($result);
+    }
+
+    public function testCanAddPermalinkWithCustomPageClasses(): void
+    {
+        self::mockConfig([
+            'markdown.permalinks.pages' => [DocumentationPage::class, MarkdownPage::class],
+        ]);
+
+        $renderer = new HeadingRenderer(MarkdownPage::class);
+        $result = $renderer->canAddPermalink('Test Content', 2);
+        
+        $this->assertTrue($result);
+    }
+
     protected function createRealBladeCompilerEnvironment(): void
     {
         $resolver = new EngineResolver();

From bbd5a0b37669d5c78166a75048d3ab9d04ae295f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:02:17 +0100
Subject: [PATCH 3507/4023] Clarify test name

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index ee52b2905fa..c9bab60eb2c 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -98,7 +98,7 @@ public function testDoesNotAddPermalinksIfDisabledInConfiguration()
         $this->assertStringNotContainsString('heading-permalink', $rendered);
     }
 
-    public function testAddsPermalinksBasedOnConfiguration(): void
+    public function testAddsPermalinksBasedOnConfiguredHeadingLevels(): void
     {
         $childRenderer = $this->mockChildNodeRenderer('Test Content');
         $renderer = new HeadingRenderer(DocumentationPage::class);

From 1195704d08179699bcb1d919755eed746538d4d7 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Mon, 2 Dec 2024 10:02:51 +0000
Subject: [PATCH 3508/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index c9bab60eb2c..5a13e4d06e7 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -21,7 +21,6 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
-use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -157,9 +156,9 @@ public function testCanAddPermalinkReturnsFalseForExistingPermalink(): void
     {
         $renderer = new HeadingRenderer(DocumentationPage::class);
         $content = 'Test Content<a class="heading-permalink"></a>';
-        
+
         $result = $renderer->canAddPermalink($content, 2);
-        
+
         $this->assertFalse($result);
     }
 
@@ -179,7 +178,7 @@ public function testCanAddPermalinkWithCustomPageClasses(): void
 
         $renderer = new HeadingRenderer(MarkdownPage::class);
         $result = $renderer->canAddPermalink('Test Content', 2);
-        
+
         $this->assertTrue($result);
     }
 

From 65cc1ffd1d3071cfcc2afaf8d6fc6d13dfb4476d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:14:37 +0100
Subject: [PATCH 3509/4023] Unit test the post processing

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 5a13e4d06e7..f06bdc0b2b9 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -182,6 +182,61 @@ public function testCanAddPermalinkWithCustomPageClasses(): void
         $this->assertTrue($result);
     }
 
+    public function testPostProcessMethodNormalizesInputToMatchCommonMark()
+    {
+        $renderer = new HeadingRenderer(DocumentationPage::class);
+
+        // Actual HTML output returned from Blade
+        $html = <<<'HTML'
+        <h2 >
+            Test Heading
+                    <a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a>
+            </h2> 
+        HTML;
+
+        // What CommonMark would generate from the same input Markdown
+        $expected = '<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>';
+
+        $processedHtml = $renderer->postProcess($html);
+        $this->assertSame($expected, $processedHtml);
+    }
+
+    public function testPostProcessRemovesSpacesAfterHeadingTags()
+    {
+        $renderer = new HeadingRenderer();
+        $html = "<h1 >Title</h1>\n<h2 >Subtitle</h2>";
+        $processedHtml = $renderer->postProcess($html);
+
+        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', $processedHtml);
+    }
+
+    public function testPostProcessTrimsWhitespaceAndIndentationFromLines()
+    {
+        $renderer = new HeadingRenderer();
+        $html = "  <h1>Title</h1>  \n  <h2>Subtitle</h2>  ";
+        $processedHtml = $renderer->postProcess($html);
+
+        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', $processedHtml);
+    }
+
+    public function testPostProcessHandlesEmptyString()
+    {
+        $renderer = new HeadingRenderer();
+        $html = "";
+        $processedHtml = $renderer->postProcess($html);
+
+        $this->assertSame('', $processedHtml);
+    }
+
+    public function testPostProcessHandlesNoHeadingTags()
+    {
+        $renderer = new HeadingRenderer();
+        $html = "<p>Paragraph</p>";
+        $processedHtml = $renderer->postProcess($html);
+
+        $this->assertSame('<p>Paragraph</p>', $processedHtml);
+    }
+
     protected function createRealBladeCompilerEnvironment(): void
     {
         $resolver = new EngineResolver();

From 2dd5c32a267872b2e54302a7818e68df116b7708 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:15:22 +0100
Subject: [PATCH 3510/4023] Clarify test name to specify the reason behind it

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index f06bdc0b2b9..e37b5a6d407 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -201,7 +201,7 @@ public function testPostProcessMethodNormalizesInputToMatchCommonMark()
         $this->assertSame($expected, $processedHtml);
     }
 
-    public function testPostProcessRemovesSpacesAfterHeadingTags()
+    public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributes()
     {
         $renderer = new HeadingRenderer();
         $html = "<h1 >Title</h1>\n<h2 >Subtitle</h2>";

From b1b62669636ba5bdf9d4237c58963365889f48fe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:16:42 +0100
Subject: [PATCH 3511/4023] Add extra test case

---
 .../framework/tests/Unit/HeadingRendererUnitTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index e37b5a6d407..9e2d87b2bee 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -210,6 +210,15 @@ public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributes()
         $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', $processedHtml);
     }
 
+    public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributesButLeavesExtraAttributesAlone()
+    {
+        $renderer = new HeadingRenderer();
+        $html = "<h1 class=\"foo-bar baz\">Title</h1>\n<h2 >Subtitle</h2>";
+        $processedHtml = $renderer->postProcess($html);
+
+        $this->assertSame('<h1 class="foo-bar baz">Title</h1><h2>Subtitle</h2>', $processedHtml);
+    }
+
     public function testPostProcessTrimsWhitespaceAndIndentationFromLines()
     {
         $renderer = new HeadingRenderer();

From 2f31b9b9949bd2860260600b80b8a14bf0e82ffc Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Mon, 2 Dec 2024 10:16:51 +0000
Subject: [PATCH 3512/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 9e2d87b2bee..a2b5cf73f71 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -231,7 +231,7 @@ public function testPostProcessTrimsWhitespaceAndIndentationFromLines()
     public function testPostProcessHandlesEmptyString()
     {
         $renderer = new HeadingRenderer();
-        $html = "";
+        $html = '';
         $processedHtml = $renderer->postProcess($html);
 
         $this->assertSame('', $processedHtml);
@@ -240,7 +240,7 @@ public function testPostProcessHandlesEmptyString()
     public function testPostProcessHandlesNoHeadingTags()
     {
         $renderer = new HeadingRenderer();
-        $html = "<p>Paragraph</p>";
+        $html = '<p>Paragraph</p>';
         $processedHtml = $renderer->postProcess($html);
 
         $this->assertSame('<p>Paragraph</p>', $processedHtml);

From 3c3661ac77b1fc663d20bab2e421b7b291bdd7ee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:19:53 +0100
Subject: [PATCH 3513/4023] Clean up test code to remove focus from
 implementation details

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 31 +++++--------------
 1 file changed, 8 insertions(+), 23 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index a2b5cf73f71..d544209027d 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -165,9 +165,8 @@ public function testCanAddPermalinkReturnsFalseForExistingPermalink(): void
     public function testCanAddPermalinkReturnsFalseForNotEnabledPageClass(): void
     {
         $renderer = new HeadingRenderer(MarkdownPage::class);
-        $result = $renderer->canAddPermalink('Test Content', 2);
 
-        $this->assertFalse($result);
+        $this->assertFalse($renderer->canAddPermalink('Test Content', 2));
     }
 
     public function testCanAddPermalinkWithCustomPageClasses(): void
@@ -177,15 +176,12 @@ public function testCanAddPermalinkWithCustomPageClasses(): void
         ]);
 
         $renderer = new HeadingRenderer(MarkdownPage::class);
-        $result = $renderer->canAddPermalink('Test Content', 2);
 
-        $this->assertTrue($result);
+        $this->assertTrue($renderer->canAddPermalink('Test Content', 2));
     }
 
     public function testPostProcessMethodNormalizesInputToMatchCommonMark()
     {
-        $renderer = new HeadingRenderer(DocumentationPage::class);
-
         // Actual HTML output returned from Blade
         $html = <<<'HTML'
         <h2 >
@@ -197,53 +193,42 @@ public function testPostProcessMethodNormalizesInputToMatchCommonMark()
         // What CommonMark would generate from the same input Markdown
         $expected = '<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>';
 
-        $processedHtml = $renderer->postProcess($html);
-        $this->assertSame($expected, $processedHtml);
+        $this->assertSame($expected, (new HeadingRenderer())->postProcess($html));
     }
 
     public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributes()
     {
-        $renderer = new HeadingRenderer();
         $html = "<h1 >Title</h1>\n<h2 >Subtitle</h2>";
-        $processedHtml = $renderer->postProcess($html);
 
-        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', $processedHtml);
+        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', (new HeadingRenderer())->postProcess($html));
     }
 
     public function testPostProcessRemovesSpacesCausedByNoExtraBladeAttributesButLeavesExtraAttributesAlone()
     {
-        $renderer = new HeadingRenderer();
         $html = "<h1 class=\"foo-bar baz\">Title</h1>\n<h2 >Subtitle</h2>";
-        $processedHtml = $renderer->postProcess($html);
 
-        $this->assertSame('<h1 class="foo-bar baz">Title</h1><h2>Subtitle</h2>', $processedHtml);
+        $this->assertSame('<h1 class="foo-bar baz">Title</h1><h2>Subtitle</h2>', (new HeadingRenderer())->postProcess($html));
     }
 
     public function testPostProcessTrimsWhitespaceAndIndentationFromLines()
     {
-        $renderer = new HeadingRenderer();
         $html = "  <h1>Title</h1>  \n  <h2>Subtitle</h2>  ";
-        $processedHtml = $renderer->postProcess($html);
 
-        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', $processedHtml);
+        $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', (new HeadingRenderer())->postProcess($html));
     }
 
     public function testPostProcessHandlesEmptyString()
     {
-        $renderer = new HeadingRenderer();
         $html = '';
-        $processedHtml = $renderer->postProcess($html);
 
-        $this->assertSame('', $processedHtml);
+        $this->assertSame('', (new HeadingRenderer())->postProcess($html));
     }
 
     public function testPostProcessHandlesNoHeadingTags()
     {
-        $renderer = new HeadingRenderer();
         $html = '<p>Paragraph</p>';
-        $processedHtml = $renderer->postProcess($html);
 
-        $this->assertSame('<p>Paragraph</p>', $processedHtml);
+        $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
     protected function createRealBladeCompilerEnvironment(): void

From b00ea06a08fe9886850746279f8b34628251ca11 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:35:11 +0100
Subject: [PATCH 3514/4023] Implement the high level feature test

---
 .../Feature/MarkdownHeadingRendererTest.php   | 134 +++++++++++++++++-
 1 file changed, 133 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 11b5075f75e..29daa66038c 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -5,6 +5,9 @@
 namespace Hyde\Framework\Testing\Feature;
 
 use Hyde\Testing\TestCase;
+use Hyde\Framework\Services\MarkdownService;
+use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\MarkdownPage;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -13,5 +16,134 @@
  */
 class MarkdownHeadingRendererTest extends TestCase
 {
-    //
+    public function testBasicHeadingRendering()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Heading 1
+        ## Heading 2
+        ### Heading 3
+        #### Heading 4
+        ##### Heading 5
+        ###### Heading 6
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown))->parse();
+
+        $this->assertStringContainsString('<h1>Heading 1</h1>', $html);
+        $this->assertStringContainsString('<h2>Heading 2</h2>', $html);
+        $this->assertStringContainsString('<h3>Heading 3</h3>', $html);
+        $this->assertStringContainsString('<h4>Heading 4</h4>', $html);
+        $this->assertStringContainsString('<h5>Heading 5</h5>', $html);
+        $this->assertStringContainsString('<h6>Heading 6</h6>', $html);
+    }
+
+    public function testPermalinksInDocumentationPages()
+    {
+        $markdown = '## Documentation Heading';
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertStringContainsString('heading-permalink', $html);
+        $this->assertStringContainsString('id="documentation-heading"', $html);
+        $this->assertStringContainsString('href="#documentation-heading"', $html);
+    }
+
+    public function testPermalinksAreNotAddedToRegularMarkdownPages()
+    {
+        $markdown = '## Regular Page Heading';
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+
+        $this->assertStringNotContainsString('heading-permalink', $html);
+    }
+
+    public function testSetextStyleHeadings()
+    {
+        $markdown = <<<'MARKDOWN'
+        Heading 1
+        =========
+        
+        Heading 2
+        ---------
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown))->parse();
+
+        $this->assertStringContainsString('<h1>Heading 1</h1>', $html);
+        $this->assertStringContainsString('<h2>Heading 2</h2>', $html);
+    }
+
+    public function testHeadingsWithCustomAttributes()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading {.custom-class #custom-id}
+        ### Another Heading {data-test="value"}
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertStringContainsString('class="custom-class"', $html);
+        $this->assertStringContainsString('id="custom-id"', $html);
+        $this->assertStringContainsString('data-test="value"', $html);
+    }
+
+    public function testPermalinkConfigurationLevels()
+    {
+        config(['markdown.permalinks.min_level' => 2]);
+        config(['markdown.permalinks.max_level' => 4]);
+
+        $markdown = <<<'MARKDOWN'
+        # H1 No Permalink
+        ## H2 Has Permalink
+        ### H3 Has Permalink
+        #### H4 Has Permalink
+        ##### H5 No Permalink
+        ###### H6 No Permalink
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertStringNotContainsString('<h1>H1 No Permalink</h1><a', $html);
+        $this->assertStringContainsString('<h2>H2 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h3>H3 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h4>H4 Has Permalink<a', $html);
+        $this->assertStringNotContainsString('<h5>H5 No Permalink</h1><a', $html);
+        $this->assertStringNotContainsString('<h6>H6 No Permalink</h1><a', $html);
+    }
+
+    public function testDisablingPermalinksGlobally()
+    {
+        config(['markdown.permalinks.enabled' => false]);
+
+        $markdown = '## Heading';
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertStringNotContainsString('heading-permalink', $html);
+    }
+
+    public function testHeadingsWithSpecialCharacters()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading with & special < > "characters"
+        ### Heading with émojis 🎉
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertStringContainsString('Heading with &amp; special &lt; &gt; &quot;characters&quot;', $html);
+        $this->assertStringContainsString('Heading with émojis 🎉', $html);
+    }
+
+    public function testCustomPageClassConfiguration()
+    {
+        config(['markdown.permalinks.pages' => [MarkdownPage::class]]);
+
+        $markdown = '## Test Heading';
+
+        // Should now have permalinks
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+        $this->assertStringContainsString('heading-permalink', $html);
+
+        // Should not have permalinks
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html);
+    }
 }

From a7b52d631feb3731acb84d8ae1db23a63e8fb0ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:53:36 +0100
Subject: [PATCH 3515/4023] Add some more assertions

---
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php     | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 29daa66038c..a799652bb6c 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -45,6 +45,8 @@ public function testPermalinksInDocumentationPages()
         $this->assertStringContainsString('heading-permalink', $html);
         $this->assertStringContainsString('id="documentation-heading"', $html);
         $this->assertStringContainsString('href="#documentation-heading"', $html);
+        $this->assertStringContainsString('title="Permalink"', $html);
+        // $this->assertStringContainsString('aria-label="Permalink to this heading"', $html);
     }
 
     public function testPermalinksAreNotAddedToRegularMarkdownPages()

From e67a64074692d4126740c990097fa91a81406843 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 11:58:21 +0100
Subject: [PATCH 3516/4023] Assert on the full output when relevant

---
 .../tests/Feature/MarkdownHeadingRendererTest.php | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index a799652bb6c..72dc6e3b64d 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -35,6 +35,16 @@ public function testBasicHeadingRendering()
         $this->assertStringContainsString('<h4>Heading 4</h4>', $html);
         $this->assertStringContainsString('<h5>Heading 5</h5>', $html);
         $this->assertStringContainsString('<h6>Heading 6</h6>', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h1>Heading 1</h1>
+        <h2>Heading 2</h2>
+        <h3>Heading 3</h3>
+        <h4>Heading 4</h4>
+        <h5>Heading 5</h5>
+        <h6>Heading 6</h6>
+
+        HTML, $html);
     }
 
     public function testPermalinksInDocumentationPages()
@@ -47,6 +57,11 @@ public function testPermalinksInDocumentationPages()
         $this->assertStringContainsString('href="#documentation-heading"', $html);
         $this->assertStringContainsString('title="Permalink"', $html);
         // $this->assertStringContainsString('aria-label="Permalink to this heading"', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2>Documentation Heading<a id="documentation-heading" href="#documentation-heading" class="heading-permalink" title="Permalink"></a></h2>
+
+        HTML, $html);
     }
 
     public function testPermalinksAreNotAddedToRegularMarkdownPages()

From 6fe5cb8fd4db2c86a3e91f8126c6607f1af75234 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 12:03:05 +0100
Subject: [PATCH 3517/4023] Expand feature testing

---
 .../Feature/MarkdownHeadingRendererTest.php   | 44 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 72dc6e3b64d..92a85958ec6 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -95,11 +95,37 @@ public function testHeadingsWithCustomAttributes()
         ### Another Heading {data-test="value"}
         MARKDOWN;
 
-        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
 
+        $this->assertStringContainsString('id="custom-id"', $html);
         $this->assertStringContainsString('class="custom-class"', $html);
+        $this->assertStringContainsString('data-test="value"', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2 class="custom-class" id="custom-id">Heading</h2>
+        <h3 data-test="value">Another Heading</h3>
+        
+        HTML, $html);
+    }
+
+    public function testHeadingsWithCustomAttributesAndPermalinks()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading {.custom-class #custom-id}
+        ### Another Heading {data-test="value"}
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
         $this->assertStringContainsString('id="custom-id"', $html);
+        $this->assertStringContainsString('class="custom-class"', $html);
         $this->assertStringContainsString('data-test="value"', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2 class="custom-class" id="custom-id">Heading<a id="heading" href="#heading" class="heading-permalink" title="Permalink"></a></h2>
+        <h3 data-test="value">Another Heading<a id="another-heading" href="#another-heading" class="heading-permalink" title="Permalink"></a></h3>
+        
+        HTML, $html);
     }
 
     public function testPermalinkConfigurationLevels()
@@ -124,6 +150,16 @@ public function testPermalinkConfigurationLevels()
         $this->assertStringContainsString('<h4>H4 Has Permalink<a', $html);
         $this->assertStringNotContainsString('<h5>H5 No Permalink</h1><a', $html);
         $this->assertStringNotContainsString('<h6>H6 No Permalink</h1><a', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h1>H1 No Permalink</h1>
+        <h2>H2 Has Permalink<a id="h2-has-permalink" href="#h2-has-permalink" class="heading-permalink" title="Permalink"></a></h2>
+        <h3>H3 Has Permalink<a id="h3-has-permalink" href="#h3-has-permalink" class="heading-permalink" title="Permalink"></a></h3>
+        <h4>H4 Has Permalink<a id="h4-has-permalink" href="#h4-has-permalink" class="heading-permalink" title="Permalink"></a></h4>
+        <h5>H5 No Permalink</h5>
+        <h6>H6 No Permalink</h6>
+        
+        HTML, $html);
     }
 
     public function testDisablingPermalinksGlobally()
@@ -147,6 +183,12 @@ public function testHeadingsWithSpecialCharacters()
 
         $this->assertStringContainsString('Heading with &amp; special &lt; &gt; &quot;characters&quot;', $html);
         $this->assertStringContainsString('Heading with émojis 🎉', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2>Heading with &amp; special &lt; &gt; &quot;characters&quot;<a id="heading-with-amp-special-lt-gt-quotcharactersquot" href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink" title="Permalink"></a></h2>
+        <h3>Heading with émojis 🎉<a id="heading-with-emojis" href="#heading-with-emojis" class="heading-permalink" title="Permalink"></a></h3>
+
+        HTML, $html);
     }
 
     public function testCustomPageClassConfiguration()

From 3c285a7ba45d1cdc9dba227a1ff5ab89793fd557 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 12:03:07 +0100
Subject: [PATCH 3518/4023] Add todo

---
 packages/framework/tests/Feature/MarkdownHeadingRendererTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 92a85958ec6..67bb0b3307f 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -184,6 +184,7 @@ public function testHeadingsWithSpecialCharacters()
         $this->assertStringContainsString('Heading with &amp; special &lt; &gt; &quot;characters&quot;', $html);
         $this->assertStringContainsString('Heading with émojis 🎉', $html);
 
+        // Todo: Try to normalize to heading-with-special-characters?
         $this->assertSame(<<<'HTML'
         <h2>Heading with &amp; special &lt; &gt; &quot;characters&quot;<a id="heading-with-amp-special-lt-gt-quotcharactersquot" href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink" title="Permalink"></a></h2>
         <h3>Heading with émojis 🎉<a id="heading-with-emojis" href="#heading-with-emojis" class="heading-permalink" title="Permalink"></a></h3>

From 43d82a4327dcf2cd68d02a97cec041bdcd8dbe28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 2 Dec 2024 12:07:31 +0100
Subject: [PATCH 3519/4023] Test escaping

---
 .../Feature/MarkdownHeadingRendererTest.php   | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 67bb0b3307f..b2d9e70e77f 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -192,6 +192,41 @@ public function testHeadingsWithSpecialCharacters()
         HTML, $html);
     }
 
+    public function testHeadingsAllowMarkdownStyling()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading with **Markdown** styling
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+
+        $this->assertStringContainsString('Heading with <strong>Markdown</strong> styling', $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2>Heading with <strong>Markdown</strong> styling</h2>
+
+        HTML, $html);
+    }
+
+    public function testHeadingsAllowBasicHtmlButEscapesDangerousInput()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading with <strong>HTML</strong>
+        ### Heading with <script>alert('XSS')</script>
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+
+        $this->assertStringContainsString('Heading with <strong>HTML</strong>', $html);
+        $this->assertStringContainsString("Heading with &lt;script>alert('XSS')&lt;/script>", $html);
+
+        $this->assertSame(<<<'HTML'
+        <h2>Heading with <strong>HTML</strong></h2>
+        <h3>Heading with &lt;script>alert('XSS')&lt;/script></h3>
+
+        HTML, $html);
+    }
+
     public function testCustomPageClassConfiguration()
     {
         config(['markdown.permalinks.pages' => [MarkdownPage::class]]);

From 4e80297fa9ae9f229eeb04ec8b49c837da5041c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Dec 2024 20:48:12 +0100
Subject: [PATCH 3520/4023] Document custom Markdown heading renderer

---
 docs/digging-deeper/advanced-markdown.md | 32 ++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 2fe8bd3648d..d8a87c8de63 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -161,6 +161,38 @@ anything within the path label will be rendered as HTML. This means you can add
 The filepaths are hidden on mobile devices using CSS to prevent them from overlapping with the code block.
 
 
+## Heading Permalinks
+
+Hyde automatically adds clickable permalink anchors to headings in documentation pages. When you hover over a heading, a `#` link appears that you can click to get a direct link to that section.
+
+### Usage & Configuration
+
+The feature is enabled by default for documentation pages. When enabled, Hyde will automatically add permalink anchors to headings between levels 2-4 (h2-h4). The permalinks are hidden by default and appear when hovering over the heading.
+
+
+You can disable the feature, or enable it for other page types, in the `config/markdown.php` file.
+
+```php
+// filepath: config/markdown.php
+'permalinks' => [
+    'enabled' => true,
+    'pages' => [
+        \Hyde\Pages\DocumentationPage::class,
+    ],
+],
+```
+
+### Advanced Customization
+
+Under the hood, Hyde uses a custom Blade-based heading renderer when converting Markdown to HTML. This allows for more flexibility and customization compared to standard Markdown parsers. You can also publish and customize the Blade component used to render the headings:
+
+```bash
+php hyde publish:components
+```
+
+This will copy the `markdown-heading.blade.php` component to your views directory where you can modify its markup and behavior.
+
+
 ## Dynamic Markdown Links
 
 HydePHP provides a powerful feature for automatically converting Markdown links to source files to the corresponding routes in the built site.

From f53eb4ddf951e6f5283e33800162a1f237d92cb9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Dec 2024 20:56:58 +0100
Subject: [PATCH 3521/4023] Remove the enabled key from the permalinks
 configuration

---
 config/markdown.php                                           | 1 -
 docs/digging-deeper/advanced-markdown.md                      | 4 +---
 packages/framework/config/markdown.php                        | 1 -
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php   | 2 +-
 4 files changed, 2 insertions(+), 6 deletions(-)

diff --git a/config/markdown.php b/config/markdown.php
index 7e8d142084f..cd9afdea0e5 100644
--- a/config/markdown.php
+++ b/config/markdown.php
@@ -108,7 +108,6 @@
     */
 
     'permalinks' => [
-        'enabled' => true,
         'pages' => [
             \Hyde\Pages\DocumentationPage::class,
         ],
diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index d8a87c8de63..6a2a0d52c98 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -169,13 +169,11 @@ Hyde automatically adds clickable permalink anchors to headings in documentation
 
 The feature is enabled by default for documentation pages. When enabled, Hyde will automatically add permalink anchors to headings between levels 2-4 (h2-h4). The permalinks are hidden by default and appear when hovering over the heading.
 
-
-You can disable the feature, or enable it for other page types, in the `config/markdown.php` file.
+You can enable it for other page types by adding the page class to the `permalinks.pages` array in the `config/markdown.php` file, or disable it for all pages by setting the array to an empty array.
 
 ```php
 // filepath: config/markdown.php
 'permalinks' => [
-    'enabled' => true,
     'pages' => [
         \Hyde\Pages\DocumentationPage::class,
     ],
diff --git a/packages/framework/config/markdown.php b/packages/framework/config/markdown.php
index 7e8d142084f..cd9afdea0e5 100644
--- a/packages/framework/config/markdown.php
+++ b/packages/framework/config/markdown.php
@@ -108,7 +108,6 @@
     */
 
     'permalinks' => [
-        'enabled' => true,
         'pages' => [
             \Hyde\Pages\DocumentationPage::class,
         ],
diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index b2d9e70e77f..d52b02ea5b2 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -164,7 +164,7 @@ public function testPermalinkConfigurationLevels()
 
     public function testDisablingPermalinksGlobally()
     {
-        config(['markdown.permalinks.enabled' => false]);
+        config(['markdown.permalinks.pages' => []]);
 
         $markdown = '## Heading';
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();

From ce21d665d36f9a00eb0eac235538db5920d49179 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Dec 2024 21:10:51 +0100
Subject: [PATCH 3522/4023] Remove the unused `canEnablePermalinks` from
 `MarkdownService`

---
 RELEASE_NOTES.md                                 |  1 +
 .../src/Framework/Services/MarkdownService.php   | 13 -------------
 .../tests/Feature/MarkdownServiceTest.php        | 16 ----------------
 3 files changed, 1 insertion(+), 29 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index eeb595d630b..6efc73d5857 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -133,6 +133,7 @@ This serves two purposes:
 - Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
 - Removed The `hyde.css` file from HydeFront in https://github.com/hydephp/develop/pull/2037 as all styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024.
 - Removed the `MarkdownService::withPermalinks` method in https://github.com/hydephp/develop/pull/2047
+- Removed the `MarkdownService::canEnablePermalinks` method in https://github.com/hydephp/develop/pull/2047
 
 ### Fixed
 
diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index a5eb175ca7d..8835c33667e 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -162,19 +162,6 @@ public function canEnableTorchlight(): bool
             Features::hasTorchlight();
     }
 
-    public function canEnablePermalinks(): bool
-    {
-        if ($this->hasFeature('permalinks')) {
-            return true;
-        }
-
-        if ($this->isDocumentationPage() && DocumentationPage::hasTableOfContents()) {
-            return true;
-        }
-
-        return false;
-    }
-
     public function hasFeature(string $feature): bool
     {
         return in_array($feature, $this->features);
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index a5ba860dbc6..2f4d10b75f7 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -172,22 +172,6 @@ public function testHasFeatureReturnsFalseIfTheFeatureIsNotInTheArray()
         $this->assertFalse($service->hasFeature('test'));
     }
 
-    public function testMethodCanEnablePermalinksIsAutomaticallyForDocumentationPages()
-    {
-        $service = new MarkdownServiceTestClass(pageClass: DocumentationPage::class);
-
-        Config::set('docs.sidebar.table_of_contents.enabled', true);
-
-        $this->assertTrue($service->canEnablePermalinks());
-    }
-
-    public function testMethodCanEnablePermalinksReturnsFalseIfThePermalinksFeatureIsNotInTheArray()
-    {
-        $service = $this->makeService();
-
-        $this->assertFalse($service->canEnablePermalinks());
-    }
-
     public function testMethodCanEnableTorchlightReturnsTrueIfTheTorchlightFeatureIsInTheArray()
     {
         $service = $this->makeService();

From 3d3ed48eaebec035a821651237eace64f2da9b0b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 3 Dec 2024 21:11:04 +0100
Subject: [PATCH 3523/4023] Improve the test

---
 .../tests/Feature/MarkdownServiceTest.php     | 30 ++++++++++++++++---
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index 2f4d10b75f7..cd16cbdb4bc 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -6,6 +6,7 @@
 
 use Hyde\Framework\Services\MarkdownService;
 use Hyde\Pages\DocumentationPage;
+use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\Config;
 
@@ -25,18 +26,39 @@ public function testServiceCanParseMarkdownToHtml()
         $this->assertSame("<h1>Hello World!</h1>\n", $html);
     }
 
-    public function testServiceCanParseMarkdownToHtmlWithPermalinks()
+    public function testServiceCanParseMarkdownToHtmlWithPermalinksDependingOnConfiguration()
     {
         $markdown = '## Hello World!';
 
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
         $this->assertIsString($html);
+        $this->assertStringContainsString('heading-permalink', $html, 'Permalink should be added to documentation pages by default');
         $this->assertSame(
-            '<h2>Hello World!<a id="hello-world" href="#hello-world" class="heading-permalink" '.
-            'title="Permalink"></a></h2>'."\n",
-            $html
+            '<h2>Hello World!<a id="hello-world" href="#hello-world" class="heading-permalink" title="Permalink"></a></h2>'."\n", $html
         );
+
+        $html = (new MarkdownService($markdown))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html, 'Permalink should not be be added when the page class is not set');
+
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html, 'Permalink should not be added to other pages by default');
+
+        Config::set('markdown.permalinks.pages', [MarkdownPage::class]);
+
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+        $this->assertStringContainsString('heading-permalink', $html, 'Permalink should be added to pages when configured');
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html, 'Permalink should not be added to pages when not configured');
+
+        Config::set('markdown.permalinks.pages', []);
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html, 'Permalinks should not be added to any pages when disabled');
+
+        $html = (new MarkdownService($markdown, MarkdownPage::class))->parse();
+        $this->assertStringNotContainsString('heading-permalink', $html, 'Permalinks should not be added to any pages when disabled');
     }
 
     public function testTorchlightExtensionIsNotEnabledByDefault()

From 7f79bee5fa7fad051e5ab2970c84edf4ccfd4ee2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 09:38:59 +0100
Subject: [PATCH 3524/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 6efc73d5857..8d927a0193a 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -104,6 +104,7 @@ This serves two purposes:
 - Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
 - Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
 - Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
+- The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
 
 ### Deprecated
 

From 0710e95dd1d79cea105a7c254a770ec0fd3aa9c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 09:25:08 +0100
Subject: [PATCH 3525/4023] More semantic Markdown heading permalinks

---
 .../resources/views/components/markdown-heading.blade.php     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index a0dec20101f..a41d8dd22bb 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -10,9 +10,9 @@
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
 @endphp
 
-<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
+<{{ $tag }} {{ $attributes->merge(['id' => $id, ...$extraAttributes]) }}>
     {!! $slot !!}
     @if($addPermalink === true)
-        <a id="{{ $id }}" href="#{{ $id }}" class="heading-permalink" title="Permalink"></a>
+        <a href="#{{ $id }}" class="heading-permalink" title="Permalink"></a>
     @endif
 </{{ $tag }}> 
\ No newline at end of file

From 8737a5240ce51da23961776356a958e0007fdb37 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 09:27:42 +0100
Subject: [PATCH 3526/4023] Conditionally add element identifier

---
 .../resources/views/components/markdown-heading.blade.php   | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index a41d8dd22bb..f4af7c2a80a 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -8,9 +8,13 @@
 @php
     $tag = 'h' . $level;
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
+
+    if ($addPermalink === true) {
+        $extraAttributes['id'] = $id;
+    }
 @endphp
 
-<{{ $tag }} {{ $attributes->merge(['id' => $id, ...$extraAttributes]) }}>
+<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
     {!! $slot !!}
     @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink" title="Permalink"></a>

From 04aa325e77b9be0f860c95833ef7ced192593995 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 09:32:18 +0100
Subject: [PATCH 3527/4023] Remove support for custom identifier when it breaks
 permalinks

---
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php  | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index d52b02ea5b2..e4a4d24db93 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -111,18 +111,17 @@ public function testHeadingsWithCustomAttributes()
     public function testHeadingsWithCustomAttributesAndPermalinks()
     {
         $markdown = <<<'MARKDOWN'
-        ## Heading {.custom-class #custom-id}
+        ## Heading {.custom-class}
         ### Another Heading {data-test="value"}
         MARKDOWN;
 
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
-        $this->assertStringContainsString('id="custom-id"', $html);
         $this->assertStringContainsString('class="custom-class"', $html);
         $this->assertStringContainsString('data-test="value"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 class="custom-class" id="custom-id">Heading<a id="heading" href="#heading" class="heading-permalink" title="Permalink"></a></h2>
+        <h2 class="custom-class">Heading<a id="heading" href="#heading" class="heading-permalink" title="Permalink"></a></h2>
         <h3 data-test="value">Another Heading<a id="another-heading" href="#another-heading" class="heading-permalink" title="Permalink"></a></h3>
         
         HTML, $html);

From e7be1522416740ad5e8d0f103c4e053f9ff7f191 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 09:34:30 +0100
Subject: [PATCH 3528/4023] Expect semantic heading identifiers

---
 .../Feature/MarkdownHeadingRendererTest.php   | 22 +++++++++----------
 .../tests/Feature/MarkdownServiceTest.php     |  2 +-
 ...aticSiteBuilderDocumentationModuleTest.php |  4 ++--
 .../tests/Unit/HeadingRendererUnitTest.php    |  2 +-
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index e4a4d24db93..cd20a8545f1 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -59,7 +59,7 @@ public function testPermalinksInDocumentationPages()
         // $this->assertStringContainsString('aria-label="Permalink to this heading"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2>Documentation Heading<a id="documentation-heading" href="#documentation-heading" class="heading-permalink" title="Permalink"></a></h2>
+        <h2 id="documentation-heading">Documentation Heading<a href="#documentation-heading" class="heading-permalink" title="Permalink"></a></h2>
 
         HTML, $html);
     }
@@ -121,8 +121,8 @@ public function testHeadingsWithCustomAttributesAndPermalinks()
         $this->assertStringContainsString('data-test="value"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 class="custom-class">Heading<a id="heading" href="#heading" class="heading-permalink" title="Permalink"></a></h2>
-        <h3 data-test="value">Another Heading<a id="another-heading" href="#another-heading" class="heading-permalink" title="Permalink"></a></h3>
+        <h2 class="custom-class" id="heading">Heading<a href="#heading" class="heading-permalink" title="Permalink"></a></h2>
+        <h3 data-test="value" id="another-heading">Another Heading<a href="#another-heading" class="heading-permalink" title="Permalink"></a></h3>
         
         HTML, $html);
     }
@@ -144,17 +144,17 @@ public function testPermalinkConfigurationLevels()
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
         $this->assertStringNotContainsString('<h1>H1 No Permalink</h1><a', $html);
-        $this->assertStringContainsString('<h2>H2 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h3>H3 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h4>H4 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h2 id="h2-has-permalink">H2 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h3 id="h3-has-permalink">H3 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h4 id="h4-has-permalink">H4 Has Permalink<a', $html);
         $this->assertStringNotContainsString('<h5>H5 No Permalink</h1><a', $html);
         $this->assertStringNotContainsString('<h6>H6 No Permalink</h1><a', $html);
 
         $this->assertSame(<<<'HTML'
         <h1>H1 No Permalink</h1>
-        <h2>H2 Has Permalink<a id="h2-has-permalink" href="#h2-has-permalink" class="heading-permalink" title="Permalink"></a></h2>
-        <h3>H3 Has Permalink<a id="h3-has-permalink" href="#h3-has-permalink" class="heading-permalink" title="Permalink"></a></h3>
-        <h4>H4 Has Permalink<a id="h4-has-permalink" href="#h4-has-permalink" class="heading-permalink" title="Permalink"></a></h4>
+        <h2 id="h2-has-permalink">H2 Has Permalink<a href="#h2-has-permalink" class="heading-permalink" title="Permalink"></a></h2>
+        <h3 id="h3-has-permalink">H3 Has Permalink<a href="#h3-has-permalink" class="heading-permalink" title="Permalink"></a></h3>
+        <h4 id="h4-has-permalink">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink" title="Permalink"></a></h4>
         <h5>H5 No Permalink</h5>
         <h6>H6 No Permalink</h6>
         
@@ -185,8 +185,8 @@ public function testHeadingsWithSpecialCharacters()
 
         // Todo: Try to normalize to heading-with-special-characters?
         $this->assertSame(<<<'HTML'
-        <h2>Heading with &amp; special &lt; &gt; &quot;characters&quot;<a id="heading-with-amp-special-lt-gt-quotcharactersquot" href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink" title="Permalink"></a></h2>
-        <h3>Heading with émojis 🎉<a id="heading-with-emojis" href="#heading-with-emojis" class="heading-permalink" title="Permalink"></a></h3>
+        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink" title="Permalink"></a></h2>
+        <h3 id="heading-with-emojis">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink" title="Permalink"></a></h3>
 
         HTML, $html);
     }
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index cd16cbdb4bc..bb30a4e75b1 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -35,7 +35,7 @@ public function testServiceCanParseMarkdownToHtmlWithPermalinksDependingOnConfig
         $this->assertIsString($html);
         $this->assertStringContainsString('heading-permalink', $html, 'Permalink should be added to documentation pages by default');
         $this->assertSame(
-            '<h2>Hello World!<a id="hello-world" href="#hello-world" class="heading-permalink" title="Permalink"></a></h2>'."\n", $html
+            '<h2 id="hello-world">Hello World!<a href="#hello-world" class="heading-permalink" title="Permalink"></a></h2>'."\n", $html
         );
 
         $html = (new MarkdownService($markdown))->parse();
diff --git a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
index 9584f15907f..c4c2dce1ad2 100644
--- a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
+++ b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
@@ -44,7 +44,7 @@ public function testPageContainsExpectedContent()
     {
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2>CHAPTER I. DOWN THE RABBIT-HOLE.<a id="chapter-i-down-the-rabbit-hole" href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ]);
     }
@@ -55,7 +55,7 @@ public function testCanCompilePageToRootOutputDirectory()
 
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2>CHAPTER I. DOWN THE RABBIT-HOLE.<a id="chapter-i-down-the-rabbit-hole" href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ], '_site/test-page.html');
     }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index d544209027d..7edbf225677 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -61,7 +61,7 @@ public function testCanRenderHeading()
         $this->assertStringContainsString('<h2', $rendered);
         $this->assertStringContainsString('</h2>', $rendered);
 
-        $this->assertSame('<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>', $rendered);
+        $this->assertSame('<h2 id="test-heading">Test Heading<a href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>', $rendered);
     }
 
     public function testAddsPermalinkToValidHeadings()

From 3c66d44cb231ec2d4dd284d5912f418eaaa4962f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 20:30:53 +0100
Subject: [PATCH 3529/4023] Refactor to use Tailwind permalink styles

---
 RELEASE_NOTES.md                              |  1 +
 _media/app.css                                |  2 +-
 .../components/markdown-heading.blade.php     |  8 +++++---
 .../components/heading-permalinks.css         | 20 -------------------
 resources/assets/app.css                      |  1 -
 5 files changed, 7 insertions(+), 25 deletions(-)
 delete mode 100644 packages/hydefront/components/heading-permalinks.css

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 8d927a0193a..2beaacdf5e7 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -525,6 +525,7 @@ The likelihood of impact is low, but if any of the following are true, you may n
 - Rewrites the `GeneratesTableOfContents` class to use a custom implementation instead of using CommonMark
 - The `execute` method of the `GeneratesTableOfContents` class now returns an array of data, instead of a string of HTML. This data should be fed into the new component
 - Removed the `table-of-contents.css` file as styles are now made using Tailwind
+- Removed the `heading-permalinks.css` file as styles are now made using Tailwind
 
 ## New features
 
diff --git a/_media/app.css b/_media/app.css
index f97e07a2508..2c968d5db9a 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:grayscale-0:hover{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index f4af7c2a80a..8cb90f0f2ed 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -14,9 +14,11 @@
     }
 @endphp
 
-<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
+<{{ $tag }} {{ $attributes->merge([...$extraAttributes, 'class' => 'w-fit']) }}>
     {!! $slot !!}
     @if($addPermalink === true)
-        <a href="#{{ $id }}" class="heading-permalink" title="Permalink"></a>
+        <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 hover:opacity-100 focus:opacity-100 hover:grayscale-0 focus:grayscale-0" title="Permalink">
+            #
+        </a>
     @endif
-</{{ $tag }}> 
\ No newline at end of file
+</{{ $tag }}>
diff --git a/packages/hydefront/components/heading-permalinks.css b/packages/hydefront/components/heading-permalinks.css
deleted file mode 100644
index c1add8ef904..00000000000
--- a/packages/hydefront/components/heading-permalinks.css
+++ /dev/null
@@ -1,20 +0,0 @@
-.prose h1, .prose h2, .prose h3, .prose h4, .prose h5, .prose h6 {
-    @apply w-fit;
-}
-
-.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,
-.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink {
-    @apply opacity-75 grayscale transition-opacity duration-100 ease-out;
-}
-
-.heading-permalink {
-    @apply opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 scroll-m-4;
-}
-
-.heading-permalink::before {
-    @apply content-['#'];
-}
-
-.heading-permalink:hover, .heading-permalink:focus {
-    @apply opacity-100 grayscale-0;
-}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 1523247f427..0b95f5d9fe4 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,7 +11,6 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import 'hydefront/components/heading-permalinks.css';
 @import 'hydefront/components/torchlight.css';
 @import 'hydefront/components/blockquotes.css';
 

From 5f90cbcfaa5c5a79aeaae6f7edfe876c3188f1b6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 20:48:07 +0100
Subject: [PATCH 3530/4023] Tweak styles to match original behaviour

---
 _media/app.css                                              | 2 +-
 .../resources/views/components/markdown-heading.blade.php   | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index 2c968d5db9a..db4e93283a9 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:grayscale-0:hover{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 8cb90f0f2ed..f04031818de 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -11,13 +11,15 @@
 
     if ($addPermalink === true) {
         $extraAttributes['id'] = $id;
+
+        isset($extraAttributes['class']) ? $extraAttributes['class'] .= ' group w-fit' : $extraAttributes['class'] = 'group w-fit';
     }
 @endphp
 
-<{{ $tag }} {{ $attributes->merge([...$extraAttributes, 'class' => 'w-fit']) }}>
+<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
     {!! $slot !!}
     @if($addPermalink === true)
-        <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 hover:opacity-100 focus:opacity-100 hover:grayscale-0 focus:grayscale-0" title="Permalink">
+        <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">
             #
         </a>
     @endif

From af9f4fa9b4038d4596c46038a97bdbc50a96ce64 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 4 Dec 2024 20:53:09 +0100
Subject: [PATCH 3531/4023] Update tests for semantic Markdown permalink
 headers

---
 .../Feature/MarkdownHeadingRendererTest.php   | 24 +++++++++----------
 .../tests/Feature/MarkdownServiceTest.php     |  2 +-
 ...aticSiteBuilderDocumentationModuleTest.php |  4 ++--
 .../tests/Unit/HeadingRendererUnitTest.php    | 10 ++++----
 4 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index cd20a8545f1..499bb5af3ad 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -59,7 +59,7 @@ public function testPermalinksInDocumentationPages()
         // $this->assertStringContainsString('aria-label="Permalink to this heading"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 id="documentation-heading">Documentation Heading<a href="#documentation-heading" class="heading-permalink" title="Permalink"></a></h2>
+        <h2 id="documentation-heading" class="group w-fit">Documentation Heading<a href="#documentation-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
 
         HTML, $html);
     }
@@ -117,12 +117,12 @@ public function testHeadingsWithCustomAttributesAndPermalinks()
 
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
-        $this->assertStringContainsString('class="custom-class"', $html);
+        $this->assertStringContainsString('class="custom-class group w-fit"', $html);
         $this->assertStringContainsString('data-test="value"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 class="custom-class" id="heading">Heading<a href="#heading" class="heading-permalink" title="Permalink"></a></h2>
-        <h3 data-test="value" id="another-heading">Another Heading<a href="#another-heading" class="heading-permalink" title="Permalink"></a></h3>
+        <h2 class="custom-class group w-fit" id="heading">Heading<a href="#heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 data-test="value" id="another-heading" class="group w-fit">Another Heading<a href="#another-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
         
         HTML, $html);
     }
@@ -144,17 +144,17 @@ public function testPermalinkConfigurationLevels()
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
         $this->assertStringNotContainsString('<h1>H1 No Permalink</h1><a', $html);
-        $this->assertStringContainsString('<h2 id="h2-has-permalink">H2 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h3 id="h3-has-permalink">H3 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h4 id="h4-has-permalink">H4 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h2 id="h2-has-permalink" class="group w-fit">H2 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h3 id="h3-has-permalink" class="group w-fit">H3 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h4 id="h4-has-permalink" class="group w-fit">H4 Has Permalink<a', $html);
         $this->assertStringNotContainsString('<h5>H5 No Permalink</h1><a', $html);
         $this->assertStringNotContainsString('<h6>H6 No Permalink</h1><a', $html);
 
         $this->assertSame(<<<'HTML'
         <h1>H1 No Permalink</h1>
-        <h2 id="h2-has-permalink">H2 Has Permalink<a href="#h2-has-permalink" class="heading-permalink" title="Permalink"></a></h2>
-        <h3 id="h3-has-permalink">H3 Has Permalink<a href="#h3-has-permalink" class="heading-permalink" title="Permalink"></a></h3>
-        <h4 id="h4-has-permalink">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink" title="Permalink"></a></h4>
+        <h2 id="h2-has-permalink" class="group w-fit">H2 Has Permalink<a href="#h2-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="h3-has-permalink" class="group w-fit">H3 Has Permalink<a href="#h3-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h4 id="h4-has-permalink" class="group w-fit">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
         <h5>H5 No Permalink</h5>
         <h6>H6 No Permalink</h6>
         
@@ -185,8 +185,8 @@ public function testHeadingsWithSpecialCharacters()
 
         // Todo: Try to normalize to heading-with-special-characters?
         $this->assertSame(<<<'HTML'
-        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink" title="Permalink"></a></h2>
-        <h3 id="heading-with-emojis">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink" title="Permalink"></a></h3>
+        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot" class="group w-fit">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="heading-with-emojis" class="group w-fit">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
 
         HTML, $html);
     }
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index bb30a4e75b1..8e761d4bd00 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -35,7 +35,7 @@ public function testServiceCanParseMarkdownToHtmlWithPermalinksDependingOnConfig
         $this->assertIsString($html);
         $this->assertStringContainsString('heading-permalink', $html, 'Permalink should be added to documentation pages by default');
         $this->assertSame(
-            '<h2 id="hello-world">Hello World!<a href="#hello-world" class="heading-permalink" title="Permalink"></a></h2>'."\n", $html
+            '<h2 id="hello-world" class="group w-fit">Hello World!<a href="#hello-world" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>'."\n", $html
         );
 
         $html = (new MarkdownService($markdown))->parse();
diff --git a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
index c4c2dce1ad2..563acafc27c 100644
--- a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
+++ b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
@@ -44,7 +44,7 @@ public function testPageContainsExpectedContent()
     {
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2 id="chapter-i-down-the-rabbit-hole">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ]);
     }
@@ -55,7 +55,7 @@ public function testCanCompilePageToRootOutputDirectory()
 
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2 id="chapter-i-down-the-rabbit-hole">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink" title="Permalink"></a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ], '_site/test-page.html');
     }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 7edbf225677..30853c1d41e 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -61,7 +61,7 @@ public function testCanRenderHeading()
         $this->assertStringContainsString('<h2', $rendered);
         $this->assertStringContainsString('</h2>', $rendered);
 
-        $this->assertSame('<h2 id="test-heading">Test Heading<a href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>', $rendered);
+        $this->assertSame('<h2 id="test-heading" class="group w-fit">Test Heading<a href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>', $rendered);
     }
 
     public function testAddsPermalinkToValidHeadings()
@@ -124,7 +124,7 @@ public function testForwardsHeadingAttributes()
         $heading->data->set('attributes', ['class' => 'custom-class']);
         $rendered = $renderer->render($heading, $childRenderer);
 
-        $this->assertStringContainsString('class="custom-class"', $rendered);
+        $this->assertStringContainsString('class="custom-class group w-fit', $rendered);
     }
 
     public function testForwardsArbitraryHeadingAttributes()
@@ -148,7 +148,7 @@ public function testMergesAllHeadingAttributes()
         $heading->data->set('attributes', ['class' => 'custom-class', 'foo' => 'bar']);
         $rendered = $renderer->render($heading, $childRenderer);
 
-        $this->assertStringContainsString('class="custom-class"', $rendered);
+        $this->assertStringContainsString('class="custom-class group w-fit"', $rendered);
         $this->assertStringContainsString('foo="bar"', $rendered);
     }
 
@@ -186,12 +186,12 @@ public function testPostProcessMethodNormalizesInputToMatchCommonMark()
         $html = <<<'HTML'
         <h2 >
             Test Heading
-                    <a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a>
+                    <a id="test-heading" href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a>
             </h2> 
         HTML;
 
         // What CommonMark would generate from the same input Markdown
-        $expected = '<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink" title="Permalink"></a></h2>';
+        $expected = '<h2>Test Heading<a id="test-heading" href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>';
 
         $this->assertSame($expected, (new HeadingRenderer())->postProcess($html));
     }

From 1caa631e78b339a8cea89a5467c210bb78f8102b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 10:44:52 +0100
Subject: [PATCH 3532/4023] Add scroll margin to header

---
 _media/app.css                                |  2 +-
 .../components/markdown-heading.blade.php     |  2 +-
 .../Feature/MarkdownHeadingRendererTest.php   | 24 +++++++++----------
 .../tests/Feature/MarkdownServiceTest.php     |  2 +-
 ...aticSiteBuilderDocumentationModuleTest.php |  4 ++--
 .../tests/Unit/HeadingRendererUnitTest.php    |  6 ++---
 6 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index db4e93283a9..c1c986c0c9e 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:.5rem}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index f04031818de..7127ef491ad 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -12,7 +12,7 @@
     if ($addPermalink === true) {
         $extraAttributes['id'] = $id;
 
-        isset($extraAttributes['class']) ? $extraAttributes['class'] .= ' group w-fit' : $extraAttributes['class'] = 'group w-fit';
+        isset($extraAttributes['class']) ? $extraAttributes['class'] .= ' group w-fit scroll-mt-2' : $extraAttributes['class'] = 'group w-fit scroll-mt-2';
     }
 @endphp
 
diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 499bb5af3ad..1abbbeae1c3 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -59,7 +59,7 @@ public function testPermalinksInDocumentationPages()
         // $this->assertStringContainsString('aria-label="Permalink to this heading"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 id="documentation-heading" class="group w-fit">Documentation Heading<a href="#documentation-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h2 id="documentation-heading" class="group w-fit scroll-mt-2">Documentation Heading<a href="#documentation-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
 
         HTML, $html);
     }
@@ -117,12 +117,12 @@ public function testHeadingsWithCustomAttributesAndPermalinks()
 
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
-        $this->assertStringContainsString('class="custom-class group w-fit"', $html);
+        $this->assertStringContainsString('class="custom-class group w-fit scroll-mt-2"', $html);
         $this->assertStringContainsString('data-test="value"', $html);
 
         $this->assertSame(<<<'HTML'
-        <h2 class="custom-class group w-fit" id="heading">Heading<a href="#heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
-        <h3 data-test="value" id="another-heading" class="group w-fit">Another Heading<a href="#another-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h2 class="custom-class group w-fit scroll-mt-2" id="heading">Heading<a href="#heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 data-test="value" id="another-heading" class="group w-fit scroll-mt-2">Another Heading<a href="#another-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
         
         HTML, $html);
     }
@@ -144,17 +144,17 @@ public function testPermalinkConfigurationLevels()
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
 
         $this->assertStringNotContainsString('<h1>H1 No Permalink</h1><a', $html);
-        $this->assertStringContainsString('<h2 id="h2-has-permalink" class="group w-fit">H2 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h3 id="h3-has-permalink" class="group w-fit">H3 Has Permalink<a', $html);
-        $this->assertStringContainsString('<h4 id="h4-has-permalink" class="group w-fit">H4 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h2 id="h2-has-permalink" class="group w-fit scroll-mt-2">H2 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h3 id="h3-has-permalink" class="group w-fit scroll-mt-2">H3 Has Permalink<a', $html);
+        $this->assertStringContainsString('<h4 id="h4-has-permalink" class="group w-fit scroll-mt-2">H4 Has Permalink<a', $html);
         $this->assertStringNotContainsString('<h5>H5 No Permalink</h1><a', $html);
         $this->assertStringNotContainsString('<h6>H6 No Permalink</h1><a', $html);
 
         $this->assertSame(<<<'HTML'
         <h1>H1 No Permalink</h1>
-        <h2 id="h2-has-permalink" class="group w-fit">H2 Has Permalink<a href="#h2-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
-        <h3 id="h3-has-permalink" class="group w-fit">H3 Has Permalink<a href="#h3-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
-        <h4 id="h4-has-permalink" class="group w-fit">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
+        <h2 id="h2-has-permalink" class="group w-fit scroll-mt-2">H2 Has Permalink<a href="#h2-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="h3-has-permalink" class="group w-fit scroll-mt-2">H3 Has Permalink<a href="#h3-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h4 id="h4-has-permalink" class="group w-fit scroll-mt-2">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
         <h5>H5 No Permalink</h5>
         <h6>H6 No Permalink</h6>
         
@@ -185,8 +185,8 @@ public function testHeadingsWithSpecialCharacters()
 
         // Todo: Try to normalize to heading-with-special-characters?
         $this->assertSame(<<<'HTML'
-        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot" class="group w-fit">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
-        <h3 id="heading-with-emojis" class="group w-fit">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot" class="group w-fit scroll-mt-2">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="heading-with-emojis" class="group w-fit scroll-mt-2">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
 
         HTML, $html);
     }
diff --git a/packages/framework/tests/Feature/MarkdownServiceTest.php b/packages/framework/tests/Feature/MarkdownServiceTest.php
index 8e761d4bd00..de4faab2dd7 100644
--- a/packages/framework/tests/Feature/MarkdownServiceTest.php
+++ b/packages/framework/tests/Feature/MarkdownServiceTest.php
@@ -35,7 +35,7 @@ public function testServiceCanParseMarkdownToHtmlWithPermalinksDependingOnConfig
         $this->assertIsString($html);
         $this->assertStringContainsString('heading-permalink', $html, 'Permalink should be added to documentation pages by default');
         $this->assertSame(
-            '<h2 id="hello-world" class="group w-fit">Hello World!<a href="#hello-world" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>'."\n", $html
+            '<h2 id="hello-world" class="group w-fit scroll-mt-2">Hello World!<a href="#hello-world" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>'."\n", $html
         );
 
         $html = (new MarkdownService($markdown))->parse();
diff --git a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
index 563acafc27c..5f14a6ad7af 100644
--- a/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
+++ b/packages/framework/tests/Feature/StaticSiteBuilderDocumentationModuleTest.php
@@ -44,7 +44,7 @@ public function testPageContainsExpectedContent()
     {
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit scroll-mt-2">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ]);
     }
@@ -55,7 +55,7 @@ public function testCanCompilePageToRootOutputDirectory()
 
         $this->inspectHtml([
             'Adventures in Wonderland',
-            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
+            '<h2 id="chapter-i-down-the-rabbit-hole" class="group w-fit scroll-mt-2">CHAPTER I. DOWN THE RABBIT-HOLE.<a href="#chapter-i-down-the-rabbit-hole" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>',
             '<p>So she was considering in her own mind, as well as she could',
         ], '_site/test-page.html');
     }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 30853c1d41e..298ff135520 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -61,7 +61,7 @@ public function testCanRenderHeading()
         $this->assertStringContainsString('<h2', $rendered);
         $this->assertStringContainsString('</h2>', $rendered);
 
-        $this->assertSame('<h2 id="test-heading" class="group w-fit">Test Heading<a href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>', $rendered);
+        $this->assertSame('<h2 id="test-heading" class="group w-fit scroll-mt-2">Test Heading<a href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>', $rendered);
     }
 
     public function testAddsPermalinkToValidHeadings()
@@ -124,7 +124,7 @@ public function testForwardsHeadingAttributes()
         $heading->data->set('attributes', ['class' => 'custom-class']);
         $rendered = $renderer->render($heading, $childRenderer);
 
-        $this->assertStringContainsString('class="custom-class group w-fit', $rendered);
+        $this->assertStringContainsString('class="custom-class group w-fit scroll-mt-2', $rendered);
     }
 
     public function testForwardsArbitraryHeadingAttributes()
@@ -148,7 +148,7 @@ public function testMergesAllHeadingAttributes()
         $heading->data->set('attributes', ['class' => 'custom-class', 'foo' => 'bar']);
         $rendered = $renderer->render($heading, $childRenderer);
 
-        $this->assertStringContainsString('class="custom-class group w-fit"', $rendered);
+        $this->assertStringContainsString('class="custom-class group w-fit scroll-mt-2"', $rendered);
         $this->assertStringContainsString('foo="bar"', $rendered);
     }
 

From 9c49d46edaf4e7632e923ba564459e8a684d3d38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 10:54:34 +0100
Subject: [PATCH 3533/4023] Format long line

---
 .../resources/views/components/markdown-heading.blade.php     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 7127ef491ad..27ce13174ef 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -12,7 +12,9 @@
     if ($addPermalink === true) {
         $extraAttributes['id'] = $id;
 
-        isset($extraAttributes['class']) ? $extraAttributes['class'] .= ' group w-fit scroll-mt-2' : $extraAttributes['class'] = 'group w-fit scroll-mt-2';
+        isset($extraAttributes['class'])
+            ? $extraAttributes['class'] .= ' group w-fit scroll-mt-2'
+            : $extraAttributes['class'] = 'group w-fit scroll-mt-2';
     }
 @endphp
 

From 418044e8bed35436f49493d69c285b69378e8897 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:11:43 +0100
Subject: [PATCH 3534/4023] Merge attributes dynamically

---
 .../views/components/markdown-heading.blade.php       | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 27ce13174ef..48ab88ff249 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -9,13 +9,10 @@
     $tag = 'h' . $level;
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
 
-    if ($addPermalink === true) {
-        $extraAttributes['id'] = $id;
-
-        isset($extraAttributes['class'])
-            ? $extraAttributes['class'] .= ' group w-fit scroll-mt-2'
-            : $extraAttributes['class'] = 'group w-fit scroll-mt-2';
-    }
+    $extraAttributes = array_merge($extraAttributes, [
+        'id' => $addPermalink ? $id : ($extraAttributes['id'] ?? null),
+        'class' => trim(($extraAttributes['class'] ?? '') . ($addPermalink ? ' group w-fit scroll-mt-2' : '')),
+    ]);
 @endphp
 
 <{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>

From 4fb8e57c8d9a8738b010cabfcefb7b966c6adc5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:11:53 +0100
Subject: [PATCH 3535/4023] Unwrap unnecessary unwrapping

---
 .../resources/views/components/markdown-heading.blade.php       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index 48ab88ff249..c107780bb95 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -15,7 +15,7 @@
     ]);
 @endphp
 
-<{{ $tag }} {{ $attributes->merge([...$extraAttributes]) }}>
+<{{ $tag }} {{ $attributes->merge($extraAttributes) }}>
     {!! $slot !!}
     @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">

From f9f9755aef5fdb43b765491a0676d69c46289b18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:28:49 +0100
Subject: [PATCH 3536/4023] Trim empty class directives

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php  | 1 +
 packages/framework/tests/Unit/HeadingRendererUnitTest.php  | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 8a9433104e5..184543720d0 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -59,6 +59,7 @@ public function canAddPermalink(string $content, int $level): bool
     /** @internal */
     public function postProcess(string $html): string
     {
+        $html = str_replace('class=""', '', $html);
         $html = preg_replace('/<h([1-6]) >/', '<h$1>', $html);
 
         return implode('', array_map('trim', explode("\n", $html)));
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 298ff135520..ef4fb697f0d 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -217,6 +217,13 @@ public function testPostProcessTrimsWhitespaceAndIndentationFromLines()
         $this->assertSame('<h1>Title</h1><h2>Subtitle</h2>', (new HeadingRenderer())->postProcess($html));
     }
 
+    public function testPostProcessTrimsEmptyClassAttributes()
+    {
+        $html = '<h1 class="">Title</h1>';
+
+        $this->assertSame('<h1>Title</h1>', (new HeadingRenderer())->postProcess($html));
+    }
+
     public function testPostProcessHandlesEmptyString()
     {
         $html = '';

From a36760b498373f062dede1349bfdfddd151d1158 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:32:22 +0100
Subject: [PATCH 3537/4023] Allow side effect of extra space for edge case

---
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 1abbbeae1c3..a2ce05f455e 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -103,7 +103,7 @@ public function testHeadingsWithCustomAttributes()
 
         $this->assertSame(<<<'HTML'
         <h2 class="custom-class" id="custom-id">Heading</h2>
-        <h3 data-test="value">Another Heading</h3>
+        <h3 data-test="value" >Another Heading</h3>
         
         HTML, $html);
     }

From c78ddeb5918379c0efea06881313ffcf28bae32a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:13:18 +0100
Subject: [PATCH 3538/4023] Inline local variable override

---
 .../resources/views/components/markdown-heading.blade.php | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index c107780bb95..ab694f90bdf 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -8,14 +8,12 @@
 @php
     $tag = 'h' . $level;
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
+@endphp
 
-    $extraAttributes = array_merge($extraAttributes, [
+<{{ $tag }} {{ $attributes->merge(array_merge($extraAttributes, [
         'id' => $addPermalink ? $id : ($extraAttributes['id'] ?? null),
         'class' => trim(($extraAttributes['class'] ?? '') . ($addPermalink ? ' group w-fit scroll-mt-2' : '')),
-    ]);
-@endphp
-
-<{{ $tag }} {{ $attributes->merge($extraAttributes) }}>
+    ])) }}>
     {!! $slot !!}
     @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">

From 3feddd34fee93f7536b31aed325f18b3b8a36dea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 11:13:50 +0100
Subject: [PATCH 3539/4023] Revert "Inline local variable override"

This reverts commit d4336e4210c0dbd4422b7bf1cc0cdb2e07c38e85.
---
 .../resources/views/components/markdown-heading.blade.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/resources/views/components/markdown-heading.blade.php b/packages/framework/resources/views/components/markdown-heading.blade.php
index ab694f90bdf..c107780bb95 100644
--- a/packages/framework/resources/views/components/markdown-heading.blade.php
+++ b/packages/framework/resources/views/components/markdown-heading.blade.php
@@ -8,12 +8,14 @@
 @php
     $tag = 'h' . $level;
     $id = $id ?? \Illuminate\Support\Str::slug($slot);
-@endphp
 
-<{{ $tag }} {{ $attributes->merge(array_merge($extraAttributes, [
+    $extraAttributes = array_merge($extraAttributes, [
         'id' => $addPermalink ? $id : ($extraAttributes['id'] ?? null),
         'class' => trim(($extraAttributes['class'] ?? '') . ($addPermalink ? ' group w-fit scroll-mt-2' : '')),
-    ])) }}>
+    ]);
+@endphp
+
+<{{ $tag }} {{ $attributes->merge($extraAttributes) }}>
     {!! $slot !!}
     @if($addPermalink === true)
         <a href="#{{ $id }}" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">

From 0d9f3e8cb85795d791cb54d02a709deb9e4207af Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:18:14 +0100
Subject: [PATCH 3540/4023] Remove todo as it can be handled in Blade

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 184543720d0..c31b7a34e6a 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -14,8 +14,6 @@
  * Renders a heading node, and supports built-in permalink generation.
  *
  * @see \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer
- *
- * @todo Add more options to customize the permalink.
  */
 class HeadingRenderer implements NodeRendererInterface
 {

From 99e2d1e9800e9361450da9ff462e78ae58213973 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:33:07 +0100
Subject: [PATCH 3541/4023] Add internal heading registry

---
 .../Framework/Services/MarkdownService.php    |  5 +++-
 .../Markdown/Processing/HeadingRenderer.php   | 24 ++++++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index 8835c33667e..a0125ae6c18 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -55,6 +55,9 @@ class MarkdownService
     /** @var array<class-string<\Hyde\Markdown\Contracts\MarkdownPostProcessorContract>> */
     protected array $postprocessors = [];
 
+    /** @var array<string> */
+    protected array $headingRegistry = [];
+
     public function __construct(string $markdown, ?string $pageClass = null)
     {
         $this->pageClass = $pageClass;
@@ -243,6 +246,6 @@ protected static function findLineContentPositions(array $lines): array
     protected function configureCustomHeadingRenderer(): void
     {
         $environment = $this->converter->getEnvironment();
-        $environment->addRenderer(Heading::class, new HeadingRenderer($this->pageClass));
+        $environment->addRenderer(Heading::class, new HeadingRenderer($this->pageClass, $this->headingRegistry));
     }
 }
diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index c31b7a34e6a..4ab35464420 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -5,6 +5,7 @@
 namespace Hyde\Markdown\Processing;
 
 use Hyde\Pages\DocumentationPage;
+use Illuminate\Support\Str;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
@@ -20,10 +21,13 @@ class HeadingRenderer implements NodeRendererInterface
     /** @var ?class-string<\Hyde\Pages\Concerns\HydePage> */
     protected ?string $pageClass = null;
 
+    protected array $headingRegistry = [];
+
     /** @param ?class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
-    public function __construct(string $pageClass = null)
+    public function __construct(string $pageClass = null, array &$headingRegistry = [])
     {
         $this->pageClass = $pageClass;
+        $this->headingRegistry = &$headingRegistry;
     }
 
     public function render(Node $node, ChildNodeRendererInterface $childRenderer): string
@@ -37,6 +41,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): s
         $rendered = view('hyde::components.markdown-heading', [
             'level' => $node->getLevel(),
             'slot' => $content,
+            'id' => $this->makeHeadingId($content),
             'addPermalink' => $this->canAddPermalink($content, $node->getLevel()),
             'extraAttributes' => $node->data->get('attributes'),
         ])->render();
@@ -62,4 +67,21 @@ public function postProcess(string $html): string
 
         return implode('', array_map('trim', explode("\n", $html)));
     }
+
+    protected function makeHeadingId(string $contents): string
+    {
+        $identifier = Str::slug($contents);
+
+        // Check for duplicates in the tracker
+        $id = $identifier;
+        $suffix = 1;
+        while (in_array($id, $this->headingRegistry)) {
+            $id = $identifier.'-'.$suffix++;
+        }
+
+        // Record the ID in the tracker and return it
+        $this->headingRegistry[] = $id;
+
+        return $id;
+    }
 }

From 7f40d01b5b74540b967c2c34a43535293b1fb1bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:37:42 +0100
Subject: [PATCH 3542/4023] Start duplicate suffixes at two

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 4ab35464420..38f379991b1 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -74,7 +74,7 @@ protected function makeHeadingId(string $contents): string
 
         // Check for duplicates in the tracker
         $id = $identifier;
-        $suffix = 1;
+        $suffix = 2;
         while (in_array($id, $this->headingRegistry)) {
             $id = $identifier.'-'.$suffix++;
         }

From c4e67ff342a60ae2e62fd40204f87bb79d6b9226 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:36:08 +0100
Subject: [PATCH 3543/4023] Add suffix to heading identifiers of the same name

---
 .../Feature/MarkdownHeadingRendererTest.php   | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index a2ce05f455e..3ade050fa68 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -240,4 +240,44 @@ public function testCustomPageClassConfiguration()
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
         $this->assertStringNotContainsString('heading-permalink', $html);
     }
+
+    public function testItHandlesMultipleHeadingsWithTheSameName()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading
+        ## Heading
+        ## Unique Heading
+        ## With Children
+        ### Child Heading
+        ### Child Heading
+        ### Unique Child Heading
+        #### Child Heading
+        MARKDOWN;
+
+        $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertSame(<<<'HTML'
+        <h2 id="heading" class="group w-fit scroll-mt-2">Heading<a href="#heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h2 id="heading-2" class="group w-fit scroll-mt-2">Heading<a href="#heading-2" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h2 id="unique-heading" class="group w-fit scroll-mt-2">Unique Heading<a href="#unique-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h2 id="with-children" class="group w-fit scroll-mt-2">With Children<a href="#with-children" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="child-heading" class="group w-fit scroll-mt-2">Child Heading<a href="#child-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h3 id="child-heading-2" class="group w-fit scroll-mt-2">Child Heading<a href="#child-heading-2" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h3 id="unique-child-heading" class="group w-fit scroll-mt-2">Unique Child Heading<a href="#unique-child-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h4 id="child-heading-3" class="group w-fit scroll-mt-2">Child Heading<a href="#child-heading-3" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
+        
+        HTML, $html);
+    }
+
+    public function testDoesNotChangeAnythingIfMultipleHeadingsWithTheSameNameAreInDifferentPages()
+    {
+        $markdown = <<<'MARKDOWN'
+        ## Heading
+        MARKDOWN;
+
+        $html1 = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+        $html2 = (new MarkdownService($markdown, DocumentationPage::class))->parse();
+
+        $this->assertSame($html1, $html2);
+    }
 }

From f0adee15db562cf6d08a140aac4b3547b129f171 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:53:50 +0100
Subject: [PATCH 3544/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2beaacdf5e7..2021b32e6ab 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -35,6 +35,7 @@ This serves two purposes:
 - Added new `npm run build` command for compiling frontend assets with Vite
 - Added a Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
 - Added Vite facade in https://github.com/hydephp/develop/pull/2016
+- Added a custom Blade-based heading renderer for Markdown conversions in https://github.com/hydephp/develop/pull/2047
 
 ### Changed
 
@@ -104,7 +105,8 @@ This serves two purposes:
 - Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
 - Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
 - Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
-- The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
+- Markdown headings are now compiled using our custom Blade-based heading renderer in https://github.com/hydephp/develop/pull/2047
+  - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
 
 ### Deprecated
 

From 155c4569f97750da187df2b662e730e33498c1b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:58:00 +0100
Subject: [PATCH 3545/4023] Add more test values to ensure proper count

---
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index 3ade050fa68..f69d07a9e2a 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -252,6 +252,9 @@ public function testItHandlesMultipleHeadingsWithTheSameName()
         ### Child Heading
         ### Unique Child Heading
         #### Child Heading
+        ## Heading
+        ### Heading
+        #### Heading
         MARKDOWN;
 
         $html = (new MarkdownService($markdown, DocumentationPage::class))->parse();
@@ -265,6 +268,9 @@ public function testItHandlesMultipleHeadingsWithTheSameName()
         <h3 id="child-heading-2" class="group w-fit scroll-mt-2">Child Heading<a href="#child-heading-2" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
         <h3 id="unique-child-heading" class="group w-fit scroll-mt-2">Unique Child Heading<a href="#unique-child-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
         <h4 id="child-heading-3" class="group w-fit scroll-mt-2">Child Heading<a href="#child-heading-3" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
+        <h2 id="heading-3" class="group w-fit scroll-mt-2">Heading<a href="#heading-3" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h3 id="heading-4" class="group w-fit scroll-mt-2">Heading<a href="#heading-4" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
+        <h4 id="heading-5" class="group w-fit scroll-mt-2">Heading<a href="#heading-5" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
         
         HTML, $html);
     }

From b959d2d72f0f0512a3feb774e126f3359cf2646a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 19:58:08 +0100
Subject: [PATCH 3546/4023] Cleanup and refactor code

---
 .../Markdown/Processing/HeadingRenderer.php   | 22 +++++++++++--------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 38f379991b1..35a978a7a09 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -70,18 +70,22 @@ public function postProcess(string $html): string
 
     protected function makeHeadingId(string $contents): string
     {
-        $identifier = Str::slug($contents);
+        $identifier = $this->ensureIdentifierIsUnique(Str::slug($contents));
 
-        // Check for duplicates in the tracker
-        $id = $identifier;
+        $this->headingRegistry[] = $identifier;
+
+        return $identifier;
+    }
+
+    protected function ensureIdentifierIsUnique(string $slug): string
+    {
+        $identifier = $slug;
         $suffix = 2;
-        while (in_array($id, $this->headingRegistry)) {
-            $id = $identifier.'-'.$suffix++;
-        }
 
-        // Record the ID in the tracker and return it
-        $this->headingRegistry[] = $id;
+        while (in_array($identifier, $this->headingRegistry)) {
+            $identifier = $slug.'-'.$suffix++;
+        }
 
-        return $id;
+        return $identifier;
     }
 }

From 3df7aa2d063b4dcff9fd552d5dc59c107faf0b5a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 5 Dec 2024 20:11:10 +0100
Subject: [PATCH 3547/4023] Add array types

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 35a978a7a09..397936b16b5 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -21,6 +21,7 @@ class HeadingRenderer implements NodeRendererInterface
     /** @var ?class-string<\Hyde\Pages\Concerns\HydePage> */
     protected ?string $pageClass = null;
 
+    /** @var array<string> */
     protected array $headingRegistry = [];
 
     /** @param ?class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */

From 6fcbcfa862d7a5144d18f146207c0321ceb32a00 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:20:26 +0100
Subject: [PATCH 3548/4023] Update test to be forgiving for system filesystem
 orders

---
 packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php b/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
index 3c109d7473b..43634844a79 100644
--- a/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
+++ b/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
@@ -135,7 +135,7 @@ public function testGetElementsByClassTypes()
 
         $this->assertInstanceOf(Collection::class, $collection);
         $this->assertContainsOnlyInstancesOf(TestableHtmlElement::class, $collection);
-        $this->assertSame(['Foo', 'Bar'], $collection->map->text->all());
+        $this->assertEquals(['Foo', 'Bar'], $collection->map->text->all());
     }
 
     public function testGetElementsByClassWithChildNodes()

From 0f5a61261ae53d3330811d26180cf339d8dd62cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:21:21 +0100
Subject: [PATCH 3549/4023] Revert "Update test to be forgiving for system
 filesystem orders"

This reverts commit 6fcbcfa862d7a5144d18f146207c0321ceb32a00.
---
 packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php b/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
index 43634844a79..3c109d7473b 100644
--- a/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
+++ b/packages/framework/tests/Unit/HtmlTestingSupportMetaTest.php
@@ -135,7 +135,7 @@ public function testGetElementsByClassTypes()
 
         $this->assertInstanceOf(Collection::class, $collection);
         $this->assertContainsOnlyInstancesOf(TestableHtmlElement::class, $collection);
-        $this->assertEquals(['Foo', 'Bar'], $collection->map->text->all());
+        $this->assertSame(['Foo', 'Bar'], $collection->map->text->all());
     }
 
     public function testGetElementsByClassWithChildNodes()

From 1c6105accab0cc0bcd8c9aceeb18b5c0151dfbb1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:03:41 +0100
Subject: [PATCH 3550/4023] Refactor colored Markdown blockquotes to be
 rendered using Blade

---
 .../views/components/colored-blockquote.blade.php        | 3 +++
 .../src/Markdown/Processing/ColoredBlockquotes.php       | 9 +++++----
 2 files changed, 8 insertions(+), 4 deletions(-)
 create mode 100644 packages/framework/resources/views/components/colored-blockquote.blade.php

diff --git a/packages/framework/resources/views/components/colored-blockquote.blade.php b/packages/framework/resources/views/components/colored-blockquote.blade.php
new file mode 100644
index 00000000000..51e5df9f9e8
--- /dev/null
+++ b/packages/framework/resources/views/components/colored-blockquote.blade.php
@@ -0,0 +1,3 @@
+<blockquote class="{{ $class }}">
+    {!! $contents !!}
+</blockquote>
\ No newline at end of file
diff --git a/packages/framework/src/Markdown/Processing/ColoredBlockquotes.php b/packages/framework/src/Markdown/Processing/ColoredBlockquotes.php
index f37d807bbad..c4ce3d9509a 100644
--- a/packages/framework/src/Markdown/Processing/ColoredBlockquotes.php
+++ b/packages/framework/src/Markdown/Processing/ColoredBlockquotes.php
@@ -9,7 +9,7 @@
 
 use function ltrim;
 use function explode;
-use function sprintf;
+use function view;
 use function str_starts_with;
 use function trim;
 
@@ -52,9 +52,10 @@ protected static function expand(string $input): string
         $class = ltrim($parts[0], '>');
         $contents = trim($parts[1] ?? '', ' ');
 
-        return sprintf('<blockquote class="%s">%s</blockquote>',
-            $class, trim(Markdown::render($contents))
-        );
+        return view('hyde::components.colored-blockquote', [
+            'class' => $class,
+            'contents' => trim(Markdown::render($contents)),
+        ])->render();
     }
 
     protected static function stringStartsWithSignature(string $input): bool

From b929f593558035bab051fe6e70579b1ad97fc907 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:07:45 +0100
Subject: [PATCH 3551/4023] Test with real Blade compiler

---
 .../ColoredBlockquoteShortcodesTest.php       | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
index f12ffed3492..1550ce8636c 100644
--- a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
@@ -6,6 +6,14 @@
 
 use Hyde\Markdown\Processing\ColoredBlockquotes;
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Contracts\View\Factory as FactoryContract;
+use Illuminate\Events\Dispatcher;
+use Illuminate\Filesystem\Filesystem;
+use Illuminate\View\Compilers\BladeCompiler;
+use Illuminate\View\Engines\CompilerEngine;
+use Illuminate\View\Engines\EngineResolver;
+use Illuminate\View\Factory;
+use Illuminate\View\FileViewFinder;
 
 /**
  * @covers \Hyde\Markdown\Processing\ColoredBlockquotes
@@ -15,6 +23,12 @@ class ColoredBlockquoteShortcodesTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    protected function setUp(): void
+    {
+        $this->mockRender();
+        $this->createRealBladeCompilerEnvironment();
+    }
+
     public function testSignature()
     {
         $this->assertSame('>', ColoredBlockquotes::signature());
@@ -51,4 +65,24 @@ public function testWithUnrelatedClass()
             ColoredBlockquotes::resolve('>foo foo')
         );
     }
+
+    protected function createRealBladeCompilerEnvironment(): void
+    {
+        $resolver = new EngineResolver();
+        $filesystem = new Filesystem();
+
+        $resolver->register('blade', function () use ($filesystem) {
+            return new CompilerEngine(
+                new BladeCompiler($filesystem, sys_get_temp_dir())
+            );
+        });
+
+        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
+        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
+
+        $view = new Factory($resolver, $finder, new Dispatcher());
+
+        app()->instance('view', $view);
+        app()->instance(FactoryContract::class, $view);
+    }
 }

From 121d1ddd8909a79f1c0b1735eec900dac095f277 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:08:08 +0100
Subject: [PATCH 3552/4023] Add todo

---
 .../framework/tests/Feature/ColoredBlockquoteShortcodesTest.php  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
index 1550ce8636c..c997abc61fa 100644
--- a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
@@ -66,6 +66,7 @@ public function testWithUnrelatedClass()
         );
     }
 
+    // Todo: Extract trait for this and MarkdownHeadingRendererUnitTest
     protected function createRealBladeCompilerEnvironment(): void
     {
         $resolver = new EngineResolver();

From d3572250f0fc0875c3feaa2479d2a7de8d6f60e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:10:28 +0100
Subject: [PATCH 3553/4023] Update tests to expect formatted HTML

Don't think we need a post processor for this
---
 .../Feature/ColoredBlockquoteShortcodesTest.php   | 15 ++++++++++-----
 .../tests/Feature/IncludesFacadeTest.php          |  4 +++-
 .../framework/tests/Unit/MarkdownHelpersTest.php  |  4 +++-
 3 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
index c997abc61fa..efa469fca3a 100644
--- a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
@@ -44,17 +44,22 @@ public function testSignatures()
 
     public function testResolveMethod()
     {
-        $this->assertSame(
-            '<blockquote class="info"><p>foo</p></blockquote>',
-            ColoredBlockquotes::resolve('>info foo')
+        $this->assertSame(<<<'HTML'
+            <blockquote class="info">
+                <p>foo</p>
+            </blockquote>
+            HTML, ColoredBlockquotes::resolve('>info foo')
         );
     }
 
     public function testCanUseMarkdownWithinBlockquote()
     {
         $this->assertSame(
-            '<blockquote class="info"><p>foo <strong>bar</strong></p></blockquote>',
-            ColoredBlockquotes::resolve('>info foo **bar**')
+            <<<HTML
+            <blockquote class="info">
+                <p>foo <strong>bar</strong></p>
+            </blockquote>
+            HTML, ColoredBlockquotes::resolve('>info foo **bar**')
         );
     }
 
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 530ae8c2887..08f4694ccde 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -163,7 +163,9 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $expected = <<<'HTML'
         <h1>Heading</h1>
         <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
-        <blockquote class="info"><p>Info Blockquote</p></blockquote>
+        <blockquote class="info">
+            <p>Info Blockquote</p>
+        </blockquote>
         <pre><code class="language-php"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
         </code></pre>
         <h2>Subheading</h2>
diff --git a/packages/framework/tests/Unit/MarkdownHelpersTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php
index 0d3ac1982cc..2c87440dd62 100644
--- a/packages/framework/tests/Unit/MarkdownHelpersTest.php
+++ b/packages/framework/tests/Unit/MarkdownHelpersTest.php
@@ -129,7 +129,9 @@ public function testRenderWithCustomHydeMarkdownFeatures()
 
         $this->assertSame(<<<'HTML'
         <h1>Hello World</h1>
-        <blockquote class="info"><p>Colored blockquote</p></blockquote>
+        <blockquote class="info">
+            <p>Colored blockquote</p>
+        </blockquote>
         <p><a href="index.html">Home</a></p>
 
         HTML, $html);

From c7971f18a09158f8bf670cd0c1ad40ee8c6c5c79 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:11:04 +0100
Subject: [PATCH 3554/4023] Move unit test to unit testing namespace

---
 .../tests/{Feature => Unit}/ColoredBlockquoteShortcodesTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename packages/framework/tests/{Feature => Unit}/ColoredBlockquoteShortcodesTest.php (98%)

diff --git a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
similarity index 98%
rename from packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
rename to packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
index efa469fca3a..143a198c1f3 100644
--- a/packages/framework/tests/Feature/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Hyde\Framework\Testing\Feature;
+namespace Hyde\Framework\Testing\Unit;
 
 use Hyde\Markdown\Processing\ColoredBlockquotes;
 use Hyde\Testing\UnitTestCase;

From cc9096e240147d06ced01d73e734e4d721347192 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:12:21 +0100
Subject: [PATCH 3555/4023] Fix code style

---
 .../framework/tests/Unit/ColoredBlockquoteShortcodesTest.php    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
index 143a198c1f3..31bc0ab4584 100644
--- a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
@@ -55,7 +55,7 @@ public function testResolveMethod()
     public function testCanUseMarkdownWithinBlockquote()
     {
         $this->assertSame(
-            <<<HTML
+            <<<'HTML'
             <blockquote class="info">
                 <p>foo <strong>bar</strong></p>
             </blockquote>

From 10bb360b680b4f772848b7f429397d163742e8c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 13:18:18 +0100
Subject: [PATCH 3556/4023] Test it resolves all shortcodes

---
 .../Unit/ColoredBlockquoteShortcodesTest.php  | 46 +++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
index 31bc0ab4584..22be79b83f0 100644
--- a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
@@ -71,6 +71,52 @@ public function testWithUnrelatedClass()
         );
     }
 
+    /**
+     * @dataProvider blockquoteProvider
+     */
+    public function testItResolvesAllShortcodes(string $input, string $expectedOutput)
+    {
+        $this->assertSame($expectedOutput, ColoredBlockquotes::resolve($input));
+    }
+
+    public static function blockquoteProvider(): array
+    {
+        return [
+            [
+                '>danger This is a danger blockquote',
+                <<<'HTML'
+                <blockquote class="danger">
+                    <p>This is a danger blockquote</p>
+                </blockquote>
+                HTML,
+            ],
+            [
+                '>info This is an info blockquote',
+                <<<'HTML'
+                <blockquote class="info">
+                    <p>This is an info blockquote</p>
+                </blockquote>
+                HTML,
+            ],
+            [
+                '>success This is a success blockquote',
+                <<<'HTML'
+                <blockquote class="success">
+                    <p>This is a success blockquote</p>
+                </blockquote>
+                HTML,
+            ],
+            [
+                '>warning This is a warning blockquote',
+                <<<'HTML'
+                <blockquote class="warning">
+                    <p>This is a warning blockquote</p>
+                </blockquote>
+                HTML,
+            ],
+        ];
+    }
+
     // Todo: Extract trait for this and MarkdownHeadingRendererUnitTest
     protected function createRealBladeCompilerEnvironment(): void
     {

From c640271a11b0347c593cc9a2316f4f7963acd97c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:03:20 +0100
Subject: [PATCH 3557/4023] Try to fix crazed test

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 37e830b33fe..9f088034dce 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -163,6 +163,7 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
         $expected = '<h1>default</h1>';
 
         $this->mockFilesystemFromClosure(function ($filesystem) use ($filename) {
+            $filesystem->shouldReceive('glob')->andReturn([])->byDefault(); // Looking for media files
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
@@ -180,6 +181,7 @@ public function testMarkdownWithAndWithoutExtension()
             $content = '# foo bar';
             $filename = 'foo.md';
 
+            $filesystem->shouldReceive('glob')->andReturn([])->byDefault(); // Looking for media files
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });

From 91581523df7332944100ac6e06e471a7f54da9f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:13:01 +0100
Subject: [PATCH 3558/4023] Revert "Try to fix crazed test"

This reverts commit 4ad0cf311398a480a28609d29cc1dad353ce1e6d.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 9f088034dce..37e830b33fe 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -163,7 +163,6 @@ public function testMarkdownReturnsRenderedDefaultValueWhenNotFound()
         $expected = '<h1>default</h1>';
 
         $this->mockFilesystemFromClosure(function ($filesystem) use ($filename) {
-            $filesystem->shouldReceive('glob')->andReturn([])->byDefault(); // Looking for media files
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(false);
         });
 
@@ -181,7 +180,6 @@ public function testMarkdownWithAndWithoutExtension()
             $content = '# foo bar';
             $filename = 'foo.md';
 
-            $filesystem->shouldReceive('glob')->andReturn([])->byDefault(); // Looking for media files
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });

From 18f8794948dba1dfa011066420788ba8a368dc12 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:14:21 +0100
Subject: [PATCH 3559/4023] Create UsesRealBladeInUnitTests.php

---
 packages/testing/src/UsesRealBladeInUnitTests.php | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/testing/src/UsesRealBladeInUnitTests.php

diff --git a/packages/testing/src/UsesRealBladeInUnitTests.php b/packages/testing/src/UsesRealBladeInUnitTests.php
new file mode 100644
index 00000000000..bffe4473a93
--- /dev/null
+++ b/packages/testing/src/UsesRealBladeInUnitTests.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Testing;
+
+trait UsesRealBladeInUnitTests
+{
+    //
+}

From 5936d0a16a9a7c8ebcfaf9a03f0eda37f6c7527b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:16:07 +0100
Subject: [PATCH 3560/4023] Extract trait for shared testing code

---
 .../Unit/ColoredBlockquoteShortcodesTest.php  | 32 ++-----------------
 .../tests/Unit/HeadingRendererUnitTest.php    | 31 ++----------------
 .../testing/src/UsesRealBladeInUnitTests.php  | 29 ++++++++++++++++-
 3 files changed, 34 insertions(+), 58 deletions(-)

diff --git a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
index 22be79b83f0..a86b11db4b4 100644
--- a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
@@ -6,20 +6,15 @@
 
 use Hyde\Markdown\Processing\ColoredBlockquotes;
 use Hyde\Testing\UnitTestCase;
-use Illuminate\Contracts\View\Factory as FactoryContract;
-use Illuminate\Events\Dispatcher;
-use Illuminate\Filesystem\Filesystem;
-use Illuminate\View\Compilers\BladeCompiler;
-use Illuminate\View\Engines\CompilerEngine;
-use Illuminate\View\Engines\EngineResolver;
-use Illuminate\View\Factory;
-use Illuminate\View\FileViewFinder;
+use Hyde\Testing\UsesRealBladeInUnitTests;
 
 /**
  * @covers \Hyde\Markdown\Processing\ColoredBlockquotes
  */
 class ColoredBlockquoteShortcodesTest extends UnitTestCase
 {
+    use UsesRealBladeInUnitTests;
+
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
@@ -116,25 +111,4 @@ public static function blockquoteProvider(): array
             ],
         ];
     }
-
-    // Todo: Extract trait for this and MarkdownHeadingRendererUnitTest
-    protected function createRealBladeCompilerEnvironment(): void
-    {
-        $resolver = new EngineResolver();
-        $filesystem = new Filesystem();
-
-        $resolver->register('blade', function () use ($filesystem) {
-            return new CompilerEngine(
-                new BladeCompiler($filesystem, sys_get_temp_dir())
-            );
-        });
-
-        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
-        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
-
-        $view = new Factory($resolver, $finder, new Dispatcher());
-
-        app()->instance('view', $view);
-        app()->instance(FactoryContract::class, $view);
-    }
 }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index ef4fb697f0d..63a7bdc9aae 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -8,14 +8,7 @@
 use Hyde\Pages\DocumentationPage;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Testing\UnitTestCase;
-use Illuminate\Contracts\View\Factory as FactoryContract;
-use Illuminate\Events\Dispatcher;
-use Illuminate\Filesystem\Filesystem;
-use Illuminate\View\Compilers\BladeCompiler;
-use Illuminate\View\Engines\CompilerEngine;
-use Illuminate\View\Engines\EngineResolver;
-use Illuminate\View\Factory;
-use Illuminate\View\FileViewFinder;
+use Hyde\Testing\UsesRealBladeInUnitTests;
 use InvalidArgumentException;
 use League\CommonMark\Extension\CommonMark\Node\Block\Heading;
 use League\CommonMark\Node\Node;
@@ -29,6 +22,8 @@
  */
 class HeadingRendererUnitTest extends UnitTestCase
 {
+    use UsesRealBladeInUnitTests;
+
     protected static bool $needsConfig = true;
     protected static ?array $cachedConfig = null;
 
@@ -238,26 +233,6 @@ public function testPostProcessHandlesNoHeadingTags()
         $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
-    protected function createRealBladeCompilerEnvironment(): void
-    {
-        $resolver = new EngineResolver();
-        $filesystem = new Filesystem();
-
-        $resolver->register('blade', function () use ($filesystem) {
-            return new CompilerEngine(
-                new BladeCompiler($filesystem, sys_get_temp_dir())
-            );
-        });
-
-        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
-        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
-
-        $view = new Factory($resolver, $finder, new Dispatcher());
-
-        app()->instance('view', $view);
-        app()->instance(FactoryContract::class, $view);
-    }
-
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface
     {
         $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);
diff --git a/packages/testing/src/UsesRealBladeInUnitTests.php b/packages/testing/src/UsesRealBladeInUnitTests.php
index bffe4473a93..ec8ae942f71 100644
--- a/packages/testing/src/UsesRealBladeInUnitTests.php
+++ b/packages/testing/src/UsesRealBladeInUnitTests.php
@@ -4,7 +4,34 @@
 
 namespace Hyde\Testing;
 
+use Illuminate\Contracts\View\Factory as FactoryContract;
+use Illuminate\Events\Dispatcher;
+use Illuminate\Filesystem\Filesystem;
+use Illuminate\View\Compilers\BladeCompiler;
+use Illuminate\View\Engines\CompilerEngine;
+use Illuminate\View\Engines\EngineResolver;
+use Illuminate\View\Factory;
+use Illuminate\View\FileViewFinder;
+
 trait UsesRealBladeInUnitTests
 {
-    //
+    protected function createRealBladeCompilerEnvironment(): void
+    {
+        $resolver = new EngineResolver();
+        $filesystem = new Filesystem();
+
+        $resolver->register('blade', function () use ($filesystem) {
+            return new CompilerEngine(
+                new BladeCompiler($filesystem, sys_get_temp_dir())
+            );
+        });
+
+        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
+        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
+
+        $view = new Factory($resolver, $finder, new Dispatcher());
+
+        app()->instance('view', $view);
+        app()->instance(FactoryContract::class, $view);
+    }
 }

From b07473542ece999f24ab2848b4048a6133753dfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:19:05 +0100
Subject: [PATCH 3561/4023] Try to fix crazed test by default

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 37e830b33fe..883680fca79 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -243,6 +243,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
     protected function mockFilesystemFromClosure(Closure $config): void
     {
         $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem->shouldReceive('missing')->andReturn(false)->byDefault();
 
         $config($filesystem);
 

From 532ba0f8af0f322fa839637451ef2cbc48aed254 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:28:58 +0100
Subject: [PATCH 3562/4023] Update IncludesFacadeUnitTest.php

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 883680fca79..57e3b024050 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -243,7 +243,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
     protected function mockFilesystemFromClosure(Closure $config): void
     {
         $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('missing')->andReturn(false)->byDefault();
+        $filesystem->shouldReceive('glob')->andReturn(false)->byDefault();
 
         $config($filesystem);
 

From cbc415230f51509c7755310377e855f7392110b8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:29:25 +0100
Subject: [PATCH 3563/4023] Forget mocked instance

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 57e3b024050..75033590468 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -41,6 +41,8 @@ protected function setUp(): void
     protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
+
+        app()->forgetInstance(Filesystem::class);
     }
 
     public function testPathReturnsTheIncludesDirectory()

From 7f566b8333b1a5854a293375597ed004c4cc5281 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:30:33 +0100
Subject: [PATCH 3564/4023] Revert "Update IncludesFacadeUnitTest.php"

This reverts commit e691f58edf08c5da68145f8d75b6a72d387671d6.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 75033590468..90ccbe2b6f2 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -245,7 +245,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
     protected function mockFilesystemFromClosure(Closure $config): void
     {
         $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('glob')->andReturn(false)->byDefault();
+        $filesystem->shouldReceive('missing')->andReturn(false)->byDefault();
 
         $config($filesystem);
 

From 3840066f4ef254bd7764aa7d7f05a1549e0c7a2a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:30:35 +0100
Subject: [PATCH 3565/4023] Revert "Try to fix crazed test by default"

This reverts commit 1f309a27b7b9f27a41e620ee40b71a260c8ffa32.
---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 90ccbe2b6f2..4d6956938da 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -245,7 +245,6 @@ public function testBladeReturnsDefaultValueWhenNotFound()
     protected function mockFilesystemFromClosure(Closure $config): void
     {
         $filesystem = Mockery::mock(Filesystem::class);
-        $filesystem->shouldReceive('missing')->andReturn(false)->byDefault();
 
         $config($filesystem);
 

From 0b79974b33283bb6d767213746e570d71b5f5440 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:33:03 +0100
Subject: [PATCH 3566/4023] Fix path for extracted method

---
 packages/testing/src/UsesRealBladeInUnitTests.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/testing/src/UsesRealBladeInUnitTests.php b/packages/testing/src/UsesRealBladeInUnitTests.php
index ec8ae942f71..30e1af963d2 100644
--- a/packages/testing/src/UsesRealBladeInUnitTests.php
+++ b/packages/testing/src/UsesRealBladeInUnitTests.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Testing;
 
+use Hyde\Hyde;
 use Illuminate\Contracts\View\Factory as FactoryContract;
 use Illuminate\Events\Dispatcher;
 use Illuminate\Filesystem\Filesystem;
@@ -26,8 +27,8 @@ protected function createRealBladeCompilerEnvironment(): void
             );
         });
 
-        $finder = new FileViewFinder($filesystem, [realpath(__DIR__.'/../../resources/views')]);
-        $finder->addNamespace('hyde', realpath(__DIR__.'/../../resources/views'));
+        $finder = new FileViewFinder($filesystem, [Hyde::vendorPath('resources/views')]);
+        $finder->addNamespace('hyde', Hyde::vendorPath('resources/views'));
 
         $view = new Factory($resolver, $finder, new Dispatcher());
 

From f2b1ef34b9bc158764c16e85edd811dc2e18fa7f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:39:31 +0100
Subject: [PATCH 3567/4023] Use a partial mock to solve crazyness

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 4d6956938da..5d8a148b904 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -244,7 +244,7 @@ public function testBladeReturnsDefaultValueWhenNotFound()
 
     protected function mockFilesystemFromClosure(Closure $config): void
     {
-        $filesystem = Mockery::mock(Filesystem::class);
+        $filesystem = Mockery::mock(Filesystem::class)->makePartial();
 
         $config($filesystem);
 

From 2b31bbbbf4a8406999194341b12d91757ecccc76 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:39:46 +0100
Subject: [PATCH 3568/4023] Can now remove unrelated expectation

---
 packages/framework/tests/Unit/IncludesFacadeUnitTest.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
index 5d8a148b904..548132af104 100644
--- a/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
+++ b/packages/framework/tests/Unit/IncludesFacadeUnitTest.php
@@ -147,8 +147,6 @@ public function testMarkdownReturnsRenderedPartial()
         $this->mockFilesystemFromClosure(function ($filesystem) use ($filename) {
             $content = '# foo bar';
 
-            $filesystem->shouldReceive('glob')->andReturn([])->byDefault(); // Looking for media files
-
             $filesystem->shouldReceive('exists')->with($this->includesPath($filename))->andReturn(true);
             $filesystem->shouldReceive('get')->with($this->includesPath($filename))->andReturn($content);
         });

From fcf5efad0fc1422eb5cf693e6415ce16d85ebd92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 14:47:08 +0100
Subject: [PATCH 3569/4023] Update test for new implementation

---
 .../Markdown/ShortcodeProcessorTest.php         | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
index 20aac354cdc..0d56ac0ef81 100644
--- a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
@@ -7,18 +7,22 @@
 use Hyde\Markdown\Contracts\MarkdownShortcodeContract;
 use Hyde\Markdown\Processing\ShortcodeProcessor;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Testing\UsesRealBladeInUnitTests;
 
 /**
  * @covers \Hyde\Markdown\Processing\ShortcodeProcessor
  */
 class ShortcodeProcessorTest extends UnitTestCase
 {
+    use UsesRealBladeInUnitTests;
+
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
     protected function setUp(): void
     {
         self::mockCurrentRouteKey('foo');
+        $this->createRealBladeCompilerEnvironment();
     }
 
     public function testConstructorDiscoversDefaultShortcodes()
@@ -33,7 +37,11 @@ public function testDiscoveredShortcodesAreUsedToProcessInput()
     {
         $processor = new ShortcodeProcessor('>info foo');
 
-        $this->assertSame('<blockquote class="info"><p>foo</p></blockquote>', $processor->run());
+        $this->assertSame(<<<'HTML'
+        <blockquote class="info">
+            <p>foo</p>
+        </blockquote>
+        HTML, $processor->run());
     }
 
     public function testStringWithoutShortcodeIsNotModified()
@@ -46,8 +54,11 @@ public function testStringWithoutShortcodeIsNotModified()
     public function testProcessStaticShorthand()
     {
         $this->assertSame(
-            '<blockquote class="info"><p>foo</p></blockquote>',
-            ShortcodeProcessor::preprocess('>info foo')
+            <<<'HTML'
+            <blockquote class="info">
+                <p>foo</p>
+            </blockquote>
+            HTML, ShortcodeProcessor::preprocess('>info foo')
         );
     }
 

From 466a044ad494856b48dc186b223ba74b1b768b60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 15:23:02 +0100
Subject: [PATCH 3570/4023] Dynamically set Tailwind blockquote colors in Blade

---
 _media/app.css                                    |  2 +-
 .../views/components/colored-blockquote.blade.php |  7 ++++++-
 .../tests/Feature/IncludesFacadeTest.php          |  2 +-
 .../Services/Markdown/ShortcodeProcessorTest.php  |  4 ++--
 .../Unit/ColoredBlockquoteShortcodesTest.php      | 12 ++++++------
 .../framework/tests/Unit/MarkdownHelpersTest.php  |  2 +-
 packages/hydefront/components/blockquotes.css     | 15 ---------------
 resources/assets/app.css                          |  1 -
 8 files changed, 17 insertions(+), 28 deletions(-)
 delete mode 100644 packages/hydefront/components/blockquotes.css

diff --git a/_media/app.css b/_media/app.css
index c1c986c0c9e..fa7fcb7bb09 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:.5rem}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:.5rem}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-amber-500{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.border-blue-500{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-green-500{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-red-600{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
diff --git a/packages/framework/resources/views/components/colored-blockquote.blade.php b/packages/framework/resources/views/components/colored-blockquote.blade.php
index 51e5df9f9e8..f43c8405964 100644
--- a/packages/framework/resources/views/components/colored-blockquote.blade.php
+++ b/packages/framework/resources/views/components/colored-blockquote.blade.php
@@ -1,3 +1,8 @@
-<blockquote class="{{ $class }}">
+<blockquote @class([
+        'border-blue-500' => $class === 'info',
+        'border-green-500' => $class === 'success',
+        'border-amber-500' => $class === 'warning',
+        'border-red-600' => $class === 'danger',
+    ])>
     {!! $contents !!}
 </blockquote>
\ No newline at end of file
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 08f4694ccde..3ee7b835836 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -163,7 +163,7 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
         $expected = <<<'HTML'
         <h1>Heading</h1>
         <p>This is a paragraph. It has some <strong>bold</strong> and <em>italic</em> text.</p>
-        <blockquote class="info">
+        <blockquote class="border-blue-500">
             <p>Info Blockquote</p>
         </blockquote>
         <pre><code class="language-php"><small class="relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block top-0 right-0"><span class="sr-only">Filepath: </span>hello.php</small>echo 'Hello, World!';
diff --git a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
index 0d56ac0ef81..b7ff55d50eb 100644
--- a/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
+++ b/packages/framework/tests/Feature/Services/Markdown/ShortcodeProcessorTest.php
@@ -38,7 +38,7 @@ public function testDiscoveredShortcodesAreUsedToProcessInput()
         $processor = new ShortcodeProcessor('>info foo');
 
         $this->assertSame(<<<'HTML'
-        <blockquote class="info">
+        <blockquote class="border-blue-500">
             <p>foo</p>
         </blockquote>
         HTML, $processor->run());
@@ -55,7 +55,7 @@ public function testProcessStaticShorthand()
     {
         $this->assertSame(
             <<<'HTML'
-            <blockquote class="info">
+            <blockquote class="border-blue-500">
                 <p>foo</p>
             </blockquote>
             HTML, ShortcodeProcessor::preprocess('>info foo')
diff --git a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
index a86b11db4b4..efe45d0794e 100644
--- a/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
+++ b/packages/framework/tests/Unit/ColoredBlockquoteShortcodesTest.php
@@ -40,7 +40,7 @@ public function testSignatures()
     public function testResolveMethod()
     {
         $this->assertSame(<<<'HTML'
-            <blockquote class="info">
+            <blockquote class="border-blue-500">
                 <p>foo</p>
             </blockquote>
             HTML, ColoredBlockquotes::resolve('>info foo')
@@ -51,7 +51,7 @@ public function testCanUseMarkdownWithinBlockquote()
     {
         $this->assertSame(
             <<<'HTML'
-            <blockquote class="info">
+            <blockquote class="border-blue-500">
                 <p>foo <strong>bar</strong></p>
             </blockquote>
             HTML, ColoredBlockquotes::resolve('>info foo **bar**')
@@ -80,7 +80,7 @@ public static function blockquoteProvider(): array
             [
                 '>danger This is a danger blockquote',
                 <<<'HTML'
-                <blockquote class="danger">
+                <blockquote class="border-red-600">
                     <p>This is a danger blockquote</p>
                 </blockquote>
                 HTML,
@@ -88,7 +88,7 @@ public static function blockquoteProvider(): array
             [
                 '>info This is an info blockquote',
                 <<<'HTML'
-                <blockquote class="info">
+                <blockquote class="border-blue-500">
                     <p>This is an info blockquote</p>
                 </blockquote>
                 HTML,
@@ -96,7 +96,7 @@ public static function blockquoteProvider(): array
             [
                 '>success This is a success blockquote',
                 <<<'HTML'
-                <blockquote class="success">
+                <blockquote class="border-green-500">
                     <p>This is a success blockquote</p>
                 </blockquote>
                 HTML,
@@ -104,7 +104,7 @@ public static function blockquoteProvider(): array
             [
                 '>warning This is a warning blockquote',
                 <<<'HTML'
-                <blockquote class="warning">
+                <blockquote class="border-amber-500">
                     <p>This is a warning blockquote</p>
                 </blockquote>
                 HTML,
diff --git a/packages/framework/tests/Unit/MarkdownHelpersTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php
index 2c87440dd62..e0784327102 100644
--- a/packages/framework/tests/Unit/MarkdownHelpersTest.php
+++ b/packages/framework/tests/Unit/MarkdownHelpersTest.php
@@ -129,7 +129,7 @@ public function testRenderWithCustomHydeMarkdownFeatures()
 
         $this->assertSame(<<<'HTML'
         <h1>Hello World</h1>
-        <blockquote class="info">
+        <blockquote class="border-blue-500">
             <p>Colored blockquote</p>
         </blockquote>
         <p><a href="index.html">Home</a></p>
diff --git a/packages/hydefront/components/blockquotes.css b/packages/hydefront/components/blockquotes.css
deleted file mode 100644
index 133ef9dfc5d..00000000000
--- a/packages/hydefront/components/blockquotes.css
+++ /dev/null
@@ -1,15 +0,0 @@
-.prose blockquote.info {
-    @apply border-blue-500;
-}
-
-.prose blockquote.success {
-    @apply border-green-500;
-}
-
-.prose blockquote.warning {
-    @apply border-amber-500;
-}
-
-.prose blockquote.danger {
-    @apply border-red-600;
-}
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 0b95f5d9fe4..42de1227e3f 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -12,7 +12,6 @@
 */
 
 @import 'hydefront/components/torchlight.css';
-@import 'hydefront/components/blockquotes.css';
 
 @tailwind base;
 @tailwind components;

From f01590d385914601c77a7f6e96611d5024d10875 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 15:30:06 +0100
Subject: [PATCH 3571/4023] Update documentation for Blade Markdown blockquotes

---
 docs/creating-content/blog-posts.md      |  4 +---
 docs/digging-deeper/advanced-markdown.md | 25 +++---------------------
 2 files changed, 4 insertions(+), 25 deletions(-)

diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index 0fce218a810..5dc5061b85e 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -228,9 +228,7 @@ image:
     authorName: "John Doe"
 ```
 
-> See [posts/introducing-images](https://hydephp.com/posts/introducing-images)
-> for a detailed blog post with examples and schema information!
-{ .info }
+>info See [posts/introducing-images](https://hydephp.com/posts/introducing-images) for a detailed blog post with examples and schema information!
 
 ## Using Images in Posts
 
diff --git a/docs/digging-deeper/advanced-markdown.md b/docs/digging-deeper/advanced-markdown.md
index 6a2a0d52c98..8010b4305f6 100644
--- a/docs/digging-deeper/advanced-markdown.md
+++ b/docs/digging-deeper/advanced-markdown.md
@@ -67,29 +67,10 @@ coloured blockquotes. Simply append the desired colour after the initial `>` cha
 
 ### Customizations
 
-You can easily customize these styles too by adding and editing the following in your `resources/app.css` file, and then recompiling your site styles.
-The code examples here use the Tailwind `@apply` directives, but you could also use `border-color: something;` just as well.
+You can easily customize these styles by publishing and editing the `markdown-blockquote.blade.php` file.
 
-```css
-/* filepath resources/app.css
-
-/* Markdown Features */
-
-.prose blockquote.info {
-    @apply border-blue-500;
-}
-
-.prose blockquote.success {
-    @apply border-green-500;
-}
-
-.prose blockquote.warning {
-    @apply border-amber-500;
-}
-
-.prose blockquote.danger {
-    @apply border-red-600;
-}
+```bash
+php hyde publish:views components
 ```
 
 ### Markdown usage

From 9731a8d832572e068a8a7f98ee70b3cac24e7f85 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Fri, 6 Dec 2024 15:35:54 +0100
Subject: [PATCH 3572/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2021b32e6ab..48b3e421bd4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -107,6 +107,7 @@ This serves two purposes:
 - Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
 - Markdown headings are now compiled using our custom Blade-based heading renderer in https://github.com/hydephp/develop/pull/2047
   - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
+- Colored Markdown blockquotes are now rendered using Blade and TailwindCSS, this change is not visible in the rendered result, but the HTML output has changed in https://github.com/hydephp/develop/pull/2056
 
 ### Deprecated
 
@@ -528,6 +529,7 @@ The likelihood of impact is low, but if any of the following are true, you may n
 - The `execute` method of the `GeneratesTableOfContents` class now returns an array of data, instead of a string of HTML. This data should be fed into the new component
 - Removed the `table-of-contents.css` file as styles are now made using Tailwind
 - Removed the `heading-permalinks.css` file as styles are now made using Tailwind
+- Removed the `blockquotes.css` file as styles are now made using Tailwind
 
 ## New features
 

From 2312b887ddadb10fbfc27b43b4bc118b39342108 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 19:20:20 +0100
Subject: [PATCH 3573/4023] Document supported version for HydeFront v4

---
 packages/hydefront/README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/packages/hydefront/README.md b/packages/hydefront/README.md
index 602f446895a..e7b066cc2ad 100644
--- a/packages/hydefront/README.md
+++ b/packages/hydefront/README.md
@@ -33,8 +33,9 @@ HydeFront is not intended to be used for standalone projects and comes with no w
 
 Changes in HydeFront are tied to those in the Hyde Framework and differing versions may be incompatible.
 
-| Hyde Version | Version | Supported          | Notes                   |
-|:-------------|---------|--------------------|-------------------------|
-| 1.x LTS      | 3.x     | :white_check_mark: | Latest                  |
-| 0.x Beta     | 2.x     | :x:                | Unsupported             |
-| 0.x Alpha    | 1.x     | :x:                | Unsupported             |
+| Hyde Version | Version | Supported          | Notes       |
+|:-------------|---------|--------------------|-------------|
+| 2.x          | 4.x     | :white_check_mark: | Latest      |
+| 1.x LTS      | 3.x     | :white_check_mark: | LTS Support |
+| 0.x Beta     | 2.x     | :x:                | Unsupported |
+| 0.x Alpha    | 1.x     | :x:                | Unsupported |

From 3cc57cb64fce0a492bad3016f8074d114a1dba17 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 19:21:51 +0100
Subject: [PATCH 3574/4023] Document file scope

---
 packages/hydefront/components/torchlight.css | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index c1cbbcfcbf4..af843061411 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,3 +1,8 @@
+/*
+ * This file contains the default styles for the Torchlight syntax highlighter.
+ * You can easily include this file through your resources/assets/app.css file.
+ */
+
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {
     @apply mr-4;
 }

From cc532cce652a6fc6afd7dd63f0177b9dfe0c9c7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:31:23 +0100
Subject: [PATCH 3575/4023] Extract helper for making the identifier

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php  | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 397936b16b5..d0fa964613b 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -71,7 +71,7 @@ public function postProcess(string $html): string
 
     protected function makeHeadingId(string $contents): string
     {
-        $identifier = $this->ensureIdentifierIsUnique(Str::slug($contents));
+        $identifier = $this->ensureIdentifierIsUnique(static::makeIdentifier($contents));
 
         $this->headingRegistry[] = $identifier;
 
@@ -89,4 +89,9 @@ protected function ensureIdentifierIsUnique(string $slug): string
 
         return $identifier;
     }
+
+    protected static function makeIdentifier(string $title): string
+    {
+        return Str::slug($title);
+    }
 }

From 302168bec281196fdf466f76073a6fe0cfc50c22 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:31:44 +0100
Subject: [PATCH 3576/4023] Make protected helper public internal

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index d0fa964613b..6b2cf74e2d8 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -90,7 +90,8 @@ protected function ensureIdentifierIsUnique(string $slug): string
         return $identifier;
     }
 
-    protected static function makeIdentifier(string $title): string
+    /** @internal */
+    public static function makeIdentifier(string $title): string
     {
         return Str::slug($title);
     }

From e2a63d5590e5cb9e16af985e2b11f59bc6bc042d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:32:47 +0100
Subject: [PATCH 3577/4023] Use the same identifier generation method
 everywhere

---
 .../src/Framework/Actions/GeneratesTableOfContents.php        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index ae27d6af08c..7f217ed8861 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -6,7 +6,7 @@
 
 use Hyde\Facades\Config;
 use Hyde\Markdown\Models\Markdown;
-use Illuminate\Support\Str;
+use Hyde\Markdown\Processing\HeadingRenderer;
 
 /**
  * Generates a nested table of contents from Markdown headings.
@@ -117,7 +117,7 @@ protected function createHeadingEntry(array $headingData): array
         return [
             'level' => $headingData['level'],
             'title' => $headingData['title'],
-            'slug' => Str::slug($headingData['title']),
+            'slug' => HeadingRenderer::makeIdentifier($headingData['title']),
         ];
     }
 

From 3f48395f3fb136a5e6a91d2a84e7b53b61bf96b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:35:17 +0100
Subject: [PATCH 3578/4023] Test needs kernel in isolate

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 63a7bdc9aae..6d76c141dde 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -25,6 +25,7 @@ class HeadingRendererUnitTest extends UnitTestCase
     use UsesRealBladeInUnitTests;
 
     protected static bool $needsConfig = true;
+    protected static bool $needsKernel = true;
     protected static ?array $cachedConfig = null;
 
     protected function setUp(): void

From c4e9e05f2476da8eaf773c9c888a1f72dc60ded7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:37:23 +0100
Subject: [PATCH 3579/4023] Add unit test

With fixtures from Laravel Framework test for the `Str::slug` helper
---
 .../framework/tests/Unit/HeadingRendererUnitTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 6d76c141dde..79544abac99 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -234,6 +234,15 @@ public function testPostProcessHandlesNoHeadingTags()
         $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
+    public function testHeadingIdentifierGeneration()
+    {
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello world'));
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello-world'));
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello_world'));
+        $this->assertSame('user-at-host', HeadingRenderer::makeIdentifier('user@host'));
+        $this->assertSame('', HeadingRenderer::makeIdentifier(''));
+    }
+
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface
     {
         $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);

From 978493796f3f71df7efad37c9136ddf28bc359ff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:39:30 +0100
Subject: [PATCH 3580/4023] Refactor to use dataprovider attribute

---
 .../tests/Unit/HeadingRendererUnitTest.php         | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 79544abac99..d02d3298aca 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -14,6 +14,7 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
+use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -234,13 +235,14 @@ public function testPostProcessHandlesNoHeadingTags()
         $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
-    public function testHeadingIdentifierGeneration()
+    #[TestWith(['hello world', 'hello-world'])]
+    #[TestWith(['hello-world', 'hello-world'])]
+    #[TestWith(['hello_world', 'hello-world'])]
+    #[TestWith(['user@host', 'user-at-host'])]
+    #[TestWith(['', ''])]
+    public function testHeadingIdentifierGeneration(string $input, string $expected): void
     {
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello world'));
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello-world'));
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello_world'));
-        $this->assertSame('user-at-host', HeadingRenderer::makeIdentifier('user@host'));
-        $this->assertSame('', HeadingRenderer::makeIdentifier(''));
+        $this->assertSame($expected, HeadingRenderer::makeIdentifier($input));
     }
 
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface

From be846bf0a646ab4ca7a59f0acfcfd654115ea652 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:40:42 +0100
Subject: [PATCH 3581/4023] Revert "Refactor to use dataprovider attribute"

This reverts commit 978493796f3f71df7efad37c9136ddf28bc359ff.
---
 .../tests/Unit/HeadingRendererUnitTest.php         | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index d02d3298aca..79544abac99 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -14,7 +14,6 @@
 use League\CommonMark\Node\Node;
 use League\CommonMark\Renderer\ChildNodeRendererInterface;
 use Mockery;
-use PHPUnit\Framework\Attributes\TestWith;
 
 /**
  * @covers \Hyde\Markdown\Processing\HeadingRenderer
@@ -235,14 +234,13 @@ public function testPostProcessHandlesNoHeadingTags()
         $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
-    #[TestWith(['hello world', 'hello-world'])]
-    #[TestWith(['hello-world', 'hello-world'])]
-    #[TestWith(['hello_world', 'hello-world'])]
-    #[TestWith(['user@host', 'user-at-host'])]
-    #[TestWith(['', ''])]
-    public function testHeadingIdentifierGeneration(string $input, string $expected): void
+    public function testHeadingIdentifierGeneration()
     {
-        $this->assertSame($expected, HeadingRenderer::makeIdentifier($input));
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello world'));
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello-world'));
+        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello_world'));
+        $this->assertSame('user-at-host', HeadingRenderer::makeIdentifier('user@host'));
+        $this->assertSame('', HeadingRenderer::makeIdentifier(''));
     }
 
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface

From 7b2a9c73eee76a670a8a698fcd35e588b7d65c70 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:41:31 +0100
Subject: [PATCH 3582/4023] Refactor to use dataprovider

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 79544abac99..f9796f80937 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -234,13 +234,12 @@ public function testPostProcessHandlesNoHeadingTags()
         $this->assertSame('<p>Paragraph</p>', (new HeadingRenderer())->postProcess($html));
     }
 
-    public function testHeadingIdentifierGeneration()
+    /**
+     * @dataProvider headingIdentifierProvider
+     */
+    public function testHeadingIdentifierGeneration($input, $expected)
     {
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello world'));
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello-world'));
-        $this->assertSame('hello-world', HeadingRenderer::makeIdentifier('hello_world'));
-        $this->assertSame('user-at-host', HeadingRenderer::makeIdentifier('user@host'));
-        $this->assertSame('', HeadingRenderer::makeIdentifier(''));
+        $this->assertSame($expected, HeadingRenderer::makeIdentifier($input));
     }
 
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface
@@ -265,4 +264,15 @@ protected function validateHeadingPermalinkStates(HeadingRenderer $renderer, Chi
             }
         }
     }
+
+    public static function headingIdentifierProvider(): array
+    {
+        return [
+            ['hello world', 'hello-world'],
+            ['hello-world', 'hello-world'],
+            ['hello_world', 'hello-world'],
+            ['user@host', 'user-at-host'],
+            ['', ''],
+        ];
+    }
 }

From d36d8a94cd211d430e4efb2409ad2e76e03ef915 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:55:55 +0100
Subject: [PATCH 3583/4023] Add some fixtures for common real headings

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index f9796f80937..21f3d4d2eac 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -273,6 +273,11 @@ public static function headingIdentifierProvider(): array
             ['hello_world', 'hello-world'],
             ['user@host', 'user-at-host'],
             ['', ''],
+            ['Introduction', 'introduction'],
+            ['Getting Started', 'getting-started'],
+            ['Installation Guide', 'installation-guide'],
+            ['API Reference', 'api-reference'],
+            ['Frequently Asked Questions', 'frequently-asked-questions'],
         ];
     }
 }

From 416338ee138f5bde827583491b6de4cb1f29972b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 21:57:36 +0100
Subject: [PATCH 3584/4023] Add some fixtures for some edge cases

---
 .../framework/tests/Unit/HeadingRendererUnitTest.php | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 21f3d4d2eac..35bc14a8e26 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -278,6 +278,18 @@ public static function headingIdentifierProvider(): array
             ['Installation Guide', 'installation-guide'],
             ['API Reference', 'api-reference'],
             ['Frequently Asked Questions', 'frequently-asked-questions'],
+            ['123 heading', '123-heading'],
+            ['heading with multiple spaces', 'heading-with-multiple-spaces'],
+            ['heading_with_underscores_and-dashes', 'heading-with-underscores-and-dashes'],
+            ['heading with special characters !@#$', 'heading-with-special-characters-at'],
+            ['heading with numbers 123', 'heading-with-numbers-123'],
+            ['UPPERCASE HEADING', 'uppercase-heading'],
+            ['heading with emoji 😊', 'heading-with-emoji'],
+            ['heading with mixed CASE and 123 numbers', 'heading-with-mixed-case-and-123-numbers'],
+            ['heading with punctuation, commas, and periods.', 'heading-with-punctuation-commas-and-periods'],
+            ['heading with quotes "double" and \'single\'', 'heading-with-quotes-double-and-single'],
+            ['heading with slashes / and \\', 'heading-with-slashes-and'],
+            ['heading with parentheses (and brackets) [and braces] {and more}', 'heading-with-parentheses-and-brackets-and-braces-and-more'],
         ];
     }
 }

From 94577e6fb8c81fb7381c22eece72edf02e0330e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:01:17 +0100
Subject: [PATCH 3585/4023] Grouped and improved fixtures

---
 .../tests/Unit/HeadingRendererUnitTest.php    | 55 +++++++++++--------
 1 file changed, 33 insertions(+), 22 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 35bc14a8e26..c7d34e244dc 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -268,28 +268,39 @@ protected function validateHeadingPermalinkStates(HeadingRenderer $renderer, Chi
     public static function headingIdentifierProvider(): array
     {
         return [
-            ['hello world', 'hello-world'],
-            ['hello-world', 'hello-world'],
-            ['hello_world', 'hello-world'],
-            ['user@host', 'user-at-host'],
-            ['', ''],
-            ['Introduction', 'introduction'],
-            ['Getting Started', 'getting-started'],
-            ['Installation Guide', 'installation-guide'],
-            ['API Reference', 'api-reference'],
-            ['Frequently Asked Questions', 'frequently-asked-questions'],
-            ['123 heading', '123-heading'],
-            ['heading with multiple spaces', 'heading-with-multiple-spaces'],
-            ['heading_with_underscores_and-dashes', 'heading-with-underscores-and-dashes'],
-            ['heading with special characters !@#$', 'heading-with-special-characters-at'],
-            ['heading with numbers 123', 'heading-with-numbers-123'],
-            ['UPPERCASE HEADING', 'uppercase-heading'],
-            ['heading with emoji 😊', 'heading-with-emoji'],
-            ['heading with mixed CASE and 123 numbers', 'heading-with-mixed-case-and-123-numbers'],
-            ['heading with punctuation, commas, and periods.', 'heading-with-punctuation-commas-and-periods'],
-            ['heading with quotes "double" and \'single\'', 'heading-with-quotes-double-and-single'],
-            ['heading with slashes / and \\', 'heading-with-slashes-and'],
-            ['heading with parentheses (and brackets) [and braces] {and more}', 'heading-with-parentheses-and-brackets-and-braces-and-more'],
+            // Basic cases
+            ['Hello World', 'hello-world'],
+            ['Simple Heading', 'simple-heading'],
+            ['Heading With Numbers 123', 'heading-with-numbers-123'],
+
+            // Special characters
+            ['Heading with & symbol', 'heading-with-amp-symbol'],
+            ['Heading with < > symbols', 'heading-with-lt-gt-symbols'],
+            ['Heading with "quotes"', 'heading-with-quot-quotes'],
+            ['Heading with / and \\', 'heading-with-and'],
+            ['Heading with punctuation!?!', 'heading-with-punctuation'],
+            ['Hyphenated-heading-name', 'hyphenated-heading-name'],
+
+            // Emojis
+            ['Heading with emoji 🎉', 'heading-with-emoji'],
+            ['Another emoji 🤔 test', 'another-emoji-test'],
+            ['Multiple emojis 🎉🤔✨', 'multiple-emojis'],
+
+            // Accented and non-ASCII characters
+            ['Accented é character', 'accented-e-character'],
+            ['Café Crème', 'cafe-creme'],
+            ['Łódź and święto', 'lodz-and-swieto'],
+            ['中文标题', ''],
+            ['日本語の見出し', ''],
+
+            // Edge cases
+            ['    Leading spaces', 'leading-spaces'],
+            ['Trailing spaces    ', 'trailing-spaces'],
+            ['  Surrounded by spaces  ', 'surrounded-by-spaces'],
+            ['----', ''], // All hyphens
+            ['%%%%%%%', ''], // All special characters
+            ['    ', ''], // Empty after trimming
+            ['1234567890', '1234567890'], // Numbers only
         ];
     }
 }

From 0f2e322e39ad49feed5ab3c9d5181d26ae0ce410 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:12:22 +0100
Subject: [PATCH 3586/4023] Transliterate heading identifiers

Adds only ~0.20ms for the entire dataprovider set, so I think this small thing is worth it
---
 .../framework/src/Markdown/Processing/HeadingRenderer.php     | 2 +-
 packages/framework/tests/Unit/HeadingRendererUnitTest.php     | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 6b2cf74e2d8..ce7305b3a71 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -93,6 +93,6 @@ protected function ensureIdentifierIsUnique(string $slug): string
     /** @internal */
     public static function makeIdentifier(string $title): string
     {
-        return Str::slug($title);
+        return Str::slug(Str::transliterate($title));
     }
 }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index c7d34e244dc..3cf2132afac 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -290,8 +290,8 @@ public static function headingIdentifierProvider(): array
             ['Accented é character', 'accented-e-character'],
             ['Café Crème', 'cafe-creme'],
             ['Łódź and święto', 'lodz-and-swieto'],
-            ['中文标题', ''],
-            ['日本語の見出し', ''],
+            ['中文标题', 'zhong-wen-biao-ti'],
+            ['日本語の見出し', 'ri-ben-yu-nojian-chu-si'],
 
             // Edge cases
             ['    Leading spaces', 'leading-spaces'],

From fb9f6523756cfccfaf9c330549780acda30743c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:12:32 +0100
Subject: [PATCH 3587/4023] Add additional fixture

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 3cf2132afac..23655e4875b 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -292,6 +292,7 @@ public static function headingIdentifierProvider(): array
             ['Łódź and święto', 'lodz-and-swieto'],
             ['中文标题', 'zhong-wen-biao-ti'],
             ['日本語の見出し', 'ri-ben-yu-nojian-chu-si'],
+            ['한국어 제목', 'han-gug-eo-jemog'],
 
             // Edge cases
             ['    Leading spaces', 'leading-spaces'],

From 25e0a0173bd93d9de6d87dfaa5572113cc4a82d4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:13:26 +0100
Subject: [PATCH 3588/4023] Inline default dictionary value

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php     | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index ce7305b3a71..db271ef5e8b 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -93,6 +93,8 @@ protected function ensureIdentifierIsUnique(string $slug): string
     /** @internal */
     public static function makeIdentifier(string $title): string
     {
-        return Str::slug(Str::transliterate($title));
+        return Str::slug(Str::transliterate($title), dictionary: [
+            '@' => 'at',
+        ]);
     }
 }

From 5881e138f82c81938a4197598ca7e5866a818889 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:13:55 +0100
Subject: [PATCH 3589/4023] Expand ampersands

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 1 +
 packages/framework/tests/Unit/HeadingRendererUnitTest.php      | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index db271ef5e8b..479b3455e1a 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -95,6 +95,7 @@ public static function makeIdentifier(string $title): string
     {
         return Str::slug(Str::transliterate($title), dictionary: [
             '@' => 'at',
+            '&' => 'and',
         ]);
     }
 }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 23655e4875b..edf6fe45764 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -274,7 +274,7 @@ public static function headingIdentifierProvider(): array
             ['Heading With Numbers 123', 'heading-with-numbers-123'],
 
             // Special characters
-            ['Heading with & symbol', 'heading-with-amp-symbol'],
+            ['Heading with & symbol', 'heading-with-and-symbol'],
             ['Heading with < > symbols', 'heading-with-lt-gt-symbols'],
             ['Heading with "quotes"', 'heading-with-quot-quotes'],
             ['Heading with / and \\', 'heading-with-and'],

From 316023d8a8e511315a4e10fae5ede924aef36ac2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:15:48 +0100
Subject: [PATCH 3590/4023] Strip escaped angle brackets

---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 ++
 packages/framework/tests/Unit/HeadingRendererUnitTest.php      | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 479b3455e1a..125a3aa9881 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -96,6 +96,8 @@ public static function makeIdentifier(string $title): string
         return Str::slug(Str::transliterate($title), dictionary: [
             '@' => 'at',
             '&' => 'and',
+            '<' => '',
+            '>' => '',
         ]);
     }
 }
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index edf6fe45764..94f5249a26d 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -275,7 +275,7 @@ public static function headingIdentifierProvider(): array
 
             // Special characters
             ['Heading with & symbol', 'heading-with-and-symbol'],
-            ['Heading with < > symbols', 'heading-with-lt-gt-symbols'],
+            ['Heading with < > symbols', 'heading-with-symbols'],
             ['Heading with "quotes"', 'heading-with-quot-quotes'],
             ['Heading with / and \\', 'heading-with-and'],
             ['Heading with punctuation!?!', 'heading-with-punctuation'],

From fe6864ba54beaba8fe2438f2c26c558843703804 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:16:11 +0100
Subject: [PATCH 3591/4023] Fix typo

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 94f5249a26d..6bd5d346a35 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -291,7 +291,7 @@ public static function headingIdentifierProvider(): array
             ['Café Crème', 'cafe-creme'],
             ['Łódź and święto', 'lodz-and-swieto'],
             ['中文标题', 'zhong-wen-biao-ti'],
-            ['日本語の見出し', 'ri-ben-yu-nojian-chu-si'],
+            ['日本語の見出し', 'ri-ben-yu-nojian-chu-shi'],
             ['한국어 제목', 'han-gug-eo-jemog'],
 
             // Edge cases

From 19a63ff2d0c15602e2a3e496ed5493da386f9752 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:16:38 +0100
Subject: [PATCH 3592/4023] Fix faulty expectation

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 6bd5d346a35..ce7c56ac142 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -276,7 +276,7 @@ public static function headingIdentifierProvider(): array
             // Special characters
             ['Heading with & symbol', 'heading-with-and-symbol'],
             ['Heading with < > symbols', 'heading-with-symbols'],
-            ['Heading with "quotes"', 'heading-with-quot-quotes'],
+            ['Heading with "quotes"', 'heading-with-quotes'],
             ['Heading with / and \\', 'heading-with-and'],
             ['Heading with punctuation!?!', 'heading-with-punctuation'],
             ['Hyphenated-heading-name', 'hyphenated-heading-name'],

From 3b7894f7b40a140d1381f8f82bd4db2b99e973de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:16:51 +0100
Subject: [PATCH 3593/4023] Fix transliterated value

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index ce7c56ac142..07b476dd10f 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -292,7 +292,7 @@ public static function headingIdentifierProvider(): array
             ['Łódź and święto', 'lodz-and-swieto'],
             ['中文标题', 'zhong-wen-biao-ti'],
             ['日本語の見出し', 'ri-ben-yu-nojian-chu-shi'],
-            ['한국어 제목', 'han-gug-eo-jemog'],
+            ['한국어 제목', 'hangugeo-jemog'],
 
             // Edge cases
             ['    Leading spaces', 'leading-spaces'],

From b6bf4499b3c47925f1b73ea9ea556615f1e26713 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:21:55 +0100
Subject: [PATCH 3594/4023] Test heading identifier generation with escaped
 input

---
 .../framework/tests/Unit/HeadingRendererUnitTest.php     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 07b476dd10f..f7662e1d6bf 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -242,6 +242,15 @@ public function testHeadingIdentifierGeneration($input, $expected)
         $this->assertSame($expected, HeadingRenderer::makeIdentifier($input));
     }
 
+    /**
+     * @dataProvider headingIdentifierProvider
+     */
+    public function testHeadingIdentifierGenerationWithEscapedInput($input, $expected)
+    {
+        $this->assertSame(HeadingRenderer::makeIdentifier($input), HeadingRenderer::makeIdentifier(e($input)));
+        $this->assertSame($expected, HeadingRenderer::makeIdentifier(e($input)));
+    }
+
     protected function mockChildNodeRenderer(string $contents = 'Test Heading'): ChildNodeRendererInterface
     {
         $childRenderer = Mockery::mock(ChildNodeRendererInterface::class);

From d78add71e5b284d58e4989b8ebeebced36f34cea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:27:53 +0100
Subject: [PATCH 3595/4023] Ensure it works with escaped inputs

Found that decoding and reescaping is the most reliable and easiest method, and it has virtually no performance impact
---
 .../framework/src/Markdown/Processing/HeadingRenderer.php     | 4 ++--
 .../framework/tests/Feature/MarkdownHeadingRendererTest.php   | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 125a3aa9881..8c7f072f0fd 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -93,11 +93,11 @@ protected function ensureIdentifierIsUnique(string $slug): string
     /** @internal */
     public static function makeIdentifier(string $title): string
     {
-        return Str::slug(Str::transliterate($title), dictionary: [
+        return e(Str::slug(Str::transliterate(html_entity_decode($title)), dictionary: [
             '@' => 'at',
             '&' => 'and',
             '<' => '',
             '>' => '',
-        ]);
+        ]));
     }
 }
diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index f69d07a9e2a..a254be2949d 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -183,9 +183,8 @@ public function testHeadingsWithSpecialCharacters()
         $this->assertStringContainsString('Heading with &amp; special &lt; &gt; &quot;characters&quot;', $html);
         $this->assertStringContainsString('Heading with émojis 🎉', $html);
 
-        // Todo: Try to normalize to heading-with-special-characters?
         $this->assertSame(<<<'HTML'
-        <h2 id="heading-with-amp-special-lt-gt-quotcharactersquot" class="group w-fit scroll-mt-2">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-amp-special-lt-gt-quotcharactersquot" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
+        <h2 id="heading-with-and-special-characters" class="group w-fit scroll-mt-2">Heading with &amp; special &lt; &gt; &quot;characters&quot;<a href="#heading-with-and-special-characters" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
         <h3 id="heading-with-emojis" class="group w-fit scroll-mt-2">Heading with émojis 🎉<a href="#heading-with-emojis" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
 
         HTML, $html);

From c240c15f01c6aa736d2e0d4dee85cfba03ab434f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:29:34 +0100
Subject: [PATCH 3596/4023] Join comma-separated values into a single line

---
 .../framework/src/Markdown/Processing/HeadingRenderer.php  | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 8c7f072f0fd..dcb4517c3f9 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -93,11 +93,6 @@ protected function ensureIdentifierIsUnique(string $slug): string
     /** @internal */
     public static function makeIdentifier(string $title): string
     {
-        return e(Str::slug(Str::transliterate(html_entity_decode($title)), dictionary: [
-            '@' => 'at',
-            '&' => 'and',
-            '<' => '',
-            '>' => '',
-        ]));
+        return e(Str::slug(Str::transliterate(html_entity_decode($title)), dictionary: ['@' => 'at', '&' => 'and', '<' => '', '>' => '']));
     }
 }

From 50f89f85450e26f07c8f8d102f969a82053c6bc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 7 Dec 2024 22:44:36 +0100
Subject: [PATCH 3597/4023] Cleanup code

---
 packages/framework/tests/Unit/HeadingRendererUnitTest.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index f7662e1d6bf..2b71abb4677 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -307,10 +307,10 @@ public static function headingIdentifierProvider(): array
             ['    Leading spaces', 'leading-spaces'],
             ['Trailing spaces    ', 'trailing-spaces'],
             ['  Surrounded by spaces  ', 'surrounded-by-spaces'],
-            ['----', ''], // All hyphens
-            ['%%%%%%%', ''], // All special characters
-            ['    ', ''], // Empty after trimming
-            ['1234567890', '1234567890'], // Numbers only
+            ['----', ''],
+            ['%%%%%%%', ''],
+            ['    ', ''],
+            ['1234567890', '1234567890'],
         ];
     }
 }

From 2f34586811c8f310e9ec48f58824e31074ac259e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 13:21:41 +0100
Subject: [PATCH 3598/4023] Release notes for new asset system

---
 RELEASE_NOTES.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 48b3e421bd4..94998b93fad 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -507,6 +507,57 @@ Hyperlinks::isRemote($source);
 
 This change was implemented in https://github.com/hydephp/develop/pull/1883. Make sure to update any instances of `FeaturedImage::isRemote()` in your codebase to ensure compatibility with HydePHP v2.0.
 
+## New Asset System
+
+### Abstract
+
+The new asset system is a complete rewrite of the HydeFront asset handling system, replacing Laravel Mix with Vite, and favouring Blade-based components with Tailwind classes over CSS partials and custom stylesheets.
+
+### Enhancements
+
+- **Replaced Laravel Mix with Vite for frontend asset compilation.** ([#2010], [#2011], [#2012], [#2013], [#2016], [#2021])
+    - Bundled assets are now compiled directly into the `_media` folder.
+    - The realtime compiler now only serves assets from the media source directory (`_media`).
+    - Added a new `npm run build` command for compiling frontend assets with Vite.
+    - Added Vite facade for Blade templates.
+    - Added Vite Hot Module Replacement (HMR) support to the realtime compiler.
+    - Build command now uses Vite to compile assets when the `--run-vite` flag is passed.
+
+- **Improved HydeFront integration.** ([#2024], [#2029], [#2031], [#2036], [#2037], [#2038], [#2039])
+    - HydeFront styles are now refactored into Tailwind.
+    - HydeFront now acts as a component library with granular Tailwind styles in `app.css`.
+    - HydeSearch plugin ported to Alpine.js, improving performance and customizability.
+    - Normalized Tailwind Typography Prose code block styles to match Torchlight.
+    - Extracted CSS component partials in HydeFront.
+    - Removed `hyde.css` from HydeFront, as all styles are now included in `app.css`.
+
+- **Implemented a custom Blade-based heading renderer for Markdown.** ([#2047], [#2052])
+    - Improves permalink handling and customization options.
+    - `id` attributes for heading permalinks have been moved from the anchor to the heading element.
+- **Colored Markdown blockquotes are now rendered using Blade and Tailwind CSS.** ([#2056])
+- The `app.js` file will now only be compiled if it has scripts. ([#2028])
+
+
+### Breaking Changes
+
+- Replaced Laravel Mix with Vite. ([#2010])
+    - You must now use `npm run build` to compile your assets, instead of `npm run prod`.
+- Removed `--run-dev` and `--run-prod` build command flags, replaced by `--run-vite`. ([#2013])
+- Removed `DocumentationPage::getTableOfContents()` method. Table of contents are now generated using a Blade component. ([#2045])
+- Removed `hyde.css` from HydeFront, requiring recompilation of assets if you were extending it. ([#2037])
+- Changed how HydeFront is included in projects.  Instead of separate `hyde.css` and `app.css`, all styles are now in `app.css`. ([#2024])
+
+
+### Removals
+
+- Removed Laravel Mix as a dependency. ([#2010])
+- Removed `npm run prod` command. ([#2010])
+- Removed CDN include for HydeSearch plugin. ([#2029])
+- Removed the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by `<x-hyde::docs.hyde-search />`. ([#2029])
+- Removed the `.torchlight-enabled` CSS class. ([#2036])
+- Removed the `MarkdownService::withPermalinks` and `MarkdownService::canEnablePermalinks` methods. ([#2047])
+
+
 ### Blade-based table of contents generator
 
 The way we generate table of contents for documentation pages have been changed from a helper method to a Blade component.

From 5e0ebed299d6dc61222a410248983d7e645b6619 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 13:23:19 +0100
Subject: [PATCH 3599/4023] Revert "Temporarily enable end to end testing for
 all branches"

This reverts commit 63ffeb8e62c1cf4b58ea5f464cc4d5e8b0f153b1.
---
 .github/workflows/end-to-end-tests.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/end-to-end-tests.yml b/.github/workflows/end-to-end-tests.yml
index 963a1cb8a92..2ec8a249556 100644
--- a/.github/workflows/end-to-end-tests.yml
+++ b/.github/workflows/end-to-end-tests.yml
@@ -2,7 +2,9 @@ name: End-to-End Testing
 
 on:
   push:
+    branches: [ "master" ]
   pull_request:
+    branches: [ "master" ]
   workflow_dispatch:
 
 jobs:

From 1a261e2c507a9cb821f15474373b263030495e97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 13:41:06 +0100
Subject: [PATCH 3600/4023] Todo comments for changes after merge

---
 packages/framework/src/Facades/HydeFront.php       | 4 +++-
 packages/framework/src/Pages/DocumentationPage.php | 5 +++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index d7bd2ca8810..a87f2c6f28d 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -35,9 +35,11 @@ public static function version(): string
     /**
      * Get the CDN link for a specific file.
      *
+     * @param  'app.css'  $file
+     *
      * @deprecated This method may be removed before the final v2.0 release as there is now currently only one file available.
      *
-     * @param  'app.css'  $file
+     * @todo Remove the method before the final v2.0 release.
      *
      * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
      */
diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index 16a87e51c9c..9b52c039834 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -48,6 +48,11 @@ public function getOnlineSourcePath(): string|false
         return sprintf('%s/%s.md', trim(Config::getString('docs.source_file_location_base'), '/'), $this->identifier);
     }
 
+    /**
+     * @todo Remove unused method?
+     *
+     * @deprecated This is unused anc could be replaced by using the config directly.
+     */
     public static function hasTableOfContents(): bool
     {
         return Config::getBool('docs.sidebar.table_of_contents.enabled', true);

From 748664d46c355b71adbd93c0d5c170166c7582d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 13:58:08 +0100
Subject: [PATCH 3601/4023] Remove unnecessary comment

---
 packages/framework/src/Facades/Vite.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index d93f60f742d..af0be16bfe6 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -18,7 +18,6 @@ public static function running(): bool
             return true;
         }
 
-        // Check for Vite hot file
         return Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 

From df47004d5f43b4fa667cff6d84f4a38860a0a3de Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 13:58:24 +0100
Subject: [PATCH 3602/4023] Unwrap function call

---
 packages/framework/src/Facades/Vite.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index af0be16bfe6..a1f7e0a3193 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -23,7 +23,7 @@ public static function running(): bool
 
     public static function assets(array $paths): HtmlString
     {
-        $html = sprintf('<script src="http://localhost:5173/@vite/client" type="module"></script>');
+        $html = '<script src="http://localhost:5173/@vite/client" type="module"></script>';
 
         foreach ($paths as $path) {
             if (str_ends_with($path, '.css')) {

From f0029d1e8baebdff926b0864edc2a40c861c88ce Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:00:57 +0100
Subject: [PATCH 3603/4023] Extract helper method from code comment

---
 packages/framework/src/Facades/Vite.php | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index a1f7e0a3193..27441fdcd53 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -13,12 +13,7 @@ class Vite
 {
     public static function running(): bool
     {
-        // Check if Vite was enabled via the serve command
-        if (env('HYDE_SERVER_VITE') === 'enabled') {
-            return true;
-        }
-
-        return Filesystem::exists('app/storage/framework/cache/vite.hot');
+        return self::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
     public static function assets(array $paths): HtmlString
@@ -37,4 +32,9 @@ public static function assets(array $paths): HtmlString
 
         return new HtmlString($html);
     }
+
+    protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
+    {
+        return env('HYDE_SERVER_VITE') === 'enabled';
+    }
 }

From dece09711653a55aaf7bc0e6a74652058d770e3c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:02:50 +0100
Subject: [PATCH 3604/4023] Add strict types declaration

---
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 2219d319ceb..e8c32b3eb65 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Hyde\Framework\Testing\Unit\Facades;
 
 use Hyde\Testing\UnitTestCase;

From 5e7c05c1e2c15340dc735501f6f448679916b811 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:06:12 +0100
Subject: [PATCH 3605/4023] Convert concatenation to a scalar values

---
 .../framework/tests/Unit/Facades/ViteFacadeTest.php   | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index e8c32b3eb65..a429e9494ce 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -47,8 +47,7 @@ public function testAssetsMethodGeneratesCorrectHtmlForJavaScriptFiles()
     {
         $html = Vite::assets(['resources/js/app.js']);
 
-        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
-            .'<script src="http://localhost:5173/resources/js/app.js" type="module"></script>';
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><script src="http://localhost:5173/resources/js/app.js" type="module"></script>';
 
         $this->assertSame($expected, (string) $html);
     }
@@ -57,8 +56,7 @@ public function testAssetsMethodGeneratesCorrectHtmlForCssFiles()
     {
         $html = Vite::assets(['resources/css/app.css']);
 
-        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
-            .'<link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">';
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">';
 
         $this->assertSame($expected, (string) $html);
     }
@@ -71,10 +69,7 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
             'resources/js/other.js',
         ]);
 
-        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>'
-            .'<script src="http://localhost:5173/resources/js/app.js" type="module"></script>'
-            .'<link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">'
-            .'<script src="http://localhost:5173/resources/js/other.js" type="module"></script>';
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><script src="http://localhost:5173/resources/js/app.js" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.css"><script src="http://localhost:5173/resources/js/other.js" type="module"></script>';
 
         $this->assertSame($expected, (string) $html);
     }

From 4f5d228460c3161a2d2cdf6d5e62d58398023871 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:06:16 +0100
Subject: [PATCH 3606/4023] Replace qualifier with an import

---
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index a429e9494ce..90247deddf1 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -7,6 +7,7 @@
 use Hyde\Testing\UnitTestCase;
 use Hyde\Facades\Vite;
 use Hyde\Testing\CreatesTemporaryFiles;
+use Illuminate\Support\HtmlString;
 
 /**
  * @covers \Hyde\Facades\Vite
@@ -76,6 +77,6 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
 
     public function testAssetsMethodReturnsHtmlString()
     {
-        $this->assertInstanceOf(\Illuminate\Support\HtmlString::class, Vite::assets([]));
+        $this->assertInstanceOf(HtmlString::class, Vite::assets([]));
     }
 }

From 5e653a93803406971cac5edbef71fde5d58286d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:07:31 +0100
Subject: [PATCH 3607/4023] Add inverse test

---
 .../framework/tests/Unit/Facades/ViteFacadeTest.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 90247deddf1..76cb606ce16 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -31,6 +31,19 @@ public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
 
         putenv('HYDE_SERVER_VITE');
     }
+    
+    public function testRunningReturnsFalseWhenEnvironmentVariableIsNotSetOrDisabled()
+    {
+        $this->assertFalse(Vite::running());
+
+        putenv('HYDE_SERVER_VITE=disabled');
+
+        $this->assertFalse(Vite::running());
+
+        putenv('HYDE_SERVER_VITE');
+
+        $this->assertFalse(Vite::running());
+    }
 
     public function testRunningReturnsTrueWhenViteHotFileExists()
     {

From 5508d358a746c817019e1dcec4974d2da983b761 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:08:16 +0100
Subject: [PATCH 3608/4023] Improve confidence of test

---
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 76cb606ce16..90c5e06481c 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -54,6 +54,8 @@ public function testRunningReturnsTrueWhenViteHotFileExists()
 
     public function testRunningReturnsFalseWhenViteHotFileDoesNotExist()
     {
+        $this->assertFileDoesNotExist('app/storage/framework/cache/vite.hot');
+
         $this->assertFalse(Vite::running());
     }
 

From 079913d8a37306cb87a557f134dbcde4ff0c34e2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:11:57 +0100
Subject: [PATCH 3609/4023] Move up and improve test

---
 .../tests/Unit/Facades/ViteFacadeTest.php          | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 90c5e06481c..6c0cbfac33f 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -59,6 +59,15 @@ public function testRunningReturnsFalseWhenViteHotFileDoesNotExist()
         $this->assertFalse(Vite::running());
     }
 
+    public function testAssetsMethodReturnsHtmlString()
+    {
+        $this->assertInstanceOf(HtmlString::class, Vite::assets([]));
+        $this->assertInstanceOf(HtmlString::class, Vite::assets(['foo.js']));
+
+        $this->assertEquals(new HtmlString('<script src="http://localhost:5173/@vite/client" type="module"></script>'), Vite::assets([]));
+        $this->assertEquals(new HtmlString('<script src="http://localhost:5173/@vite/client" type="module"></script><script src="http://localhost:5173/foo.js" type="module"></script>'), Vite::assets(['foo.js']));
+    }
+
     public function testAssetsMethodGeneratesCorrectHtmlForJavaScriptFiles()
     {
         $html = Vite::assets(['resources/js/app.js']);
@@ -89,9 +98,4 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
 
         $this->assertSame($expected, (string) $html);
     }
-
-    public function testAssetsMethodReturnsHtmlString()
-    {
-        $this->assertInstanceOf(HtmlString::class, Vite::assets([]));
-    }
 }

From ecbf8bdd06459e19d59ab2851d91eaae59e611e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:12:04 +0100
Subject: [PATCH 3610/4023] Extract helper methods

---
 packages/framework/src/Facades/Vite.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 27441fdcd53..cadc8ec6dfc 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -22,11 +22,11 @@ public static function assets(array $paths): HtmlString
 
         foreach ($paths as $path) {
             if (str_ends_with($path, '.css')) {
-                $html .= sprintf('<link rel="stylesheet" href="http://localhost:5173/%s">', $path);
+                $html .= static::formatStylesheetLink($path);
             }
 
             if (str_ends_with($path, '.js')) {
-                $html .= sprintf('<script src="http://localhost:5173/%s" type="module"></script>', $path);
+                $html .= static::formatScriptInclude($path);
             }
         }
 
@@ -37,4 +37,14 @@ protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
     {
         return env('HYDE_SERVER_VITE') === 'enabled';
     }
+
+    protected static function formatStylesheetLink(string $path): string
+    {
+        return sprintf('<link rel="stylesheet" href="http://localhost:5173/%s">', $path);
+    }
+
+    protected static function formatScriptInclude(string $path): string
+    {
+        return sprintf('<script src="http://localhost:5173/%s" type="module"></script>', $path);
+    }
 }

From 029a0c6ba6cfbe29cc9539d6af8f07329ea1f187 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 8 Dec 2024 13:12:14 +0000
Subject: [PATCH 3611/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 6c0cbfac33f..27397aeac9c 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -31,7 +31,7 @@ public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
 
         putenv('HYDE_SERVER_VITE');
     }
-    
+
     public function testRunningReturnsFalseWhenEnvironmentVariableIsNotSetOrDisabled()
     {
         $this->assertFalse(Vite::running());

From aab895a5faa01a1883c2e5bd20a9d358fd03dd06 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:19:25 +0100
Subject: [PATCH 3612/4023] Add todo

---
 packages/framework/src/Facades/Vite.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index cadc8ec6dfc..991e2b4322c 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -35,6 +35,7 @@ public static function assets(array $paths): HtmlString
 
     protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
     {
+        // TODO: Do we actually need this? Hotfile should be enough.
         return env('HYDE_SERVER_VITE') === 'enabled';
     }
 

From 3501102f51f97f3d30462a30f7eef3e0fde2d19b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:22:07 +0100
Subject: [PATCH 3613/4023] Annotate the array types

---
 packages/framework/src/Facades/Vite.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 991e2b4322c..e0b5336ed07 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -16,6 +16,7 @@ public static function running(): bool
         return self::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
+    /** @param array<string> $paths */
     public static function assets(array $paths): HtmlString
     {
         $html = '<script src="http://localhost:5173/@vite/client" type="module"></script>';

From 0e940568df15e540a58ea7367318576340b9be32 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:23:14 +0100
Subject: [PATCH 3614/4023] Extract helper methods

---
 packages/framework/src/Facades/Vite.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index e0b5336ed07..2ff21c2ab67 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -22,11 +22,11 @@ public static function assets(array $paths): HtmlString
         $html = '<script src="http://localhost:5173/@vite/client" type="module"></script>';
 
         foreach ($paths as $path) {
-            if (str_ends_with($path, '.css')) {
+            if (self::isCssPath($path)) {
                 $html .= static::formatStylesheetLink($path);
             }
 
-            if (str_ends_with($path, '.js')) {
+            if (self::isJsPath($path)) {
                 $html .= static::formatScriptInclude($path);
             }
         }
@@ -40,6 +40,16 @@ protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
         return env('HYDE_SERVER_VITE') === 'enabled';
     }
 
+    protected static function isCssPath(string $path): bool
+    {
+        return str_ends_with($path, '.css');
+    }
+
+    protected static function isJsPath(string $path): bool
+    {
+        return str_ends_with($path, '.js');
+    }
+
     protected static function formatStylesheetLink(string $path): string
     {
         return sprintf('<link rel="stylesheet" href="http://localhost:5173/%s">', $path);

From 7e0016bad1ac260d556b8bb6d510c804f1115d18 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 14:45:44 +0100
Subject: [PATCH 3615/4023] Better document the Vite system

---
 docs/creating-content/managing-assets.md | 51 ++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index dc84cc013d5..0b06e747b1c 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -18,6 +18,57 @@ Some extra component styles are organized into modular files in the HydeFront pa
 To get you started quickly, all the styles are already compiled and minified into `_media/app.css`,
 which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.
 
+## Vite
+
+Hyde uses [Vite](https://vitejs.dev/) to compile assets. Vite is a build tool that aims to provide a faster and more efficient development experience for modern web projects.
+
+### Why Vite?
+
+HydePHP integrates Vite to compile assets such as CSS and JavaScript files. This integration ensures that your assets are processed efficiently, enhancing the development workflow by leveraging Vite's rapid build system.
+
+#### Asset Management
+
+**Development and Production Modes**
+
+- **Development Mode**: Use `npm run dev` to start the Vite development HMR server, which provides fast live reloading and efficient compilation during development.
+- **Production Mode**: Use `npm run build` for creating optimized, minified asset bundles ready for production deployment.
+
+**Asset Compilation**:
+
+- Assets are compiled from the `resources/assets` directory. The primary CSS file, `app.css`, is processed with TailwindCSS and other specified tools like PostCSS.
+- Vite automatically processes all scripts and styles, outputting compiled files to the `_media` directory. These are copied to `_site/media` when the static site is built with `php hyde build`.
+
+>warn Note that the HydePHP Vite integration only supports CSS and JavaScript files, if you try to load other file types, they will not be processed by Vite.
+
+**Configuration**:
+- You can customize Vite's behavior and output paths by modifying the pre-configured `vite.config.js` file in the project root directory.
+
+### Blade Integration
+
+Hyde effortlessly integrates Vite with Blade views, allowing you to include compiled assets in your templates. The Blade components `hyde::layouts.styles` and `hyde::layouts.scripts` are already set up to load the compiled CSS and JavaScript files.
+
+You can check if the Vite HMR server is running with `Vite::running()`, and you can include CSS and JavaScript resources with `Vite::asset('path')`, or `Vite::assets([])` to supply an array of paths.
+
+**Example: Using Vite if the HMR server is enabled, or loading the compiled CSS file if not:**
+
+```blade
+@if(Vite::running())
+    {{ Vite::assets(['resources/assets/app.css']) }}
+@else
+    <link rel="stylesheet" href="{{ asset('media/app.css') }}">
+@endif
+```
+
+### Hot Module Replacement (HMR)
+
+Vite's HMR feature allows for instant updates to the browser without requiring a full page reload. This **only works** through the realtime compiler when the Vite development server is also running.
+
+You can start both of these by running `npm run dev` and `php hyde serve` in separate terminals, or using the `--vite` flag with the serve command:
+
+```bash
+php hyde serve --vite
+```
+
 ## Additional Information and Answers to Common Questions
 
 ### Is NodeJS/NPM Required for Using Hyde?

From 30b09393f83c7b8ad4349394e87b5a4d2834b0c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 15:06:40 +0100
Subject: [PATCH 3616/4023] Swap section order

---
 docs/creating-content/managing-assets.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index 0b06e747b1c..e4db6fee431 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -43,6 +43,16 @@ HydePHP integrates Vite to compile assets such as CSS and JavaScript files. This
 **Configuration**:
 - You can customize Vite's behavior and output paths by modifying the pre-configured `vite.config.js` file in the project root directory.
 
+### Hot Module Replacement (HMR)
+
+Vite's HMR feature allows for instant updates to the browser without requiring a full page reload. This **only works** through the realtime compiler when the Vite development server is also running.
+
+You can start both of these by running `npm run dev` and `php hyde serve` in separate terminals, or using the `--vite` flag with the serve command:
+
+```bash
+php hyde serve --vite
+```
+
 ### Blade Integration
 
 Hyde effortlessly integrates Vite with Blade views, allowing you to include compiled assets in your templates. The Blade components `hyde::layouts.styles` and `hyde::layouts.scripts` are already set up to load the compiled CSS and JavaScript files.
@@ -59,16 +69,6 @@ You can check if the Vite HMR server is running with `Vite::running()`, and you
 @endif
 ```
 
-### Hot Module Replacement (HMR)
-
-Vite's HMR feature allows for instant updates to the browser without requiring a full page reload. This **only works** through the realtime compiler when the Vite development server is also running.
-
-You can start both of these by running `npm run dev` and `php hyde serve` in separate terminals, or using the `--vite` flag with the serve command:
-
-```bash
-php hyde serve --vite
-```
-
 ## Additional Information and Answers to Common Questions
 
 ### Is NodeJS/NPM Required for Using Hyde?

From a511976954807e492e533b5c39cb3d2170884e61 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 16:27:47 +0100
Subject: [PATCH 3617/4023] Support all CSS extensions like Laravel Vite uses

---
 packages/framework/src/Facades/Vite.php         |  2 +-
 .../tests/Unit/Facades/ViteFacadeTest.php       | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 2ff21c2ab67..d45c21aaf24 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -42,7 +42,7 @@ protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
 
     protected static function isCssPath(string $path): bool
     {
-        return str_ends_with($path, '.css');
+        return preg_match('/\.(css|less|sass|scss|styl|stylus|pcss|postcss)$/', $path) === 1;
     }
 
     protected static function isJsPath(string $path): bool
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 27397aeac9c..fa10f82300e 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -98,4 +98,21 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
 
         $this->assertSame($expected, (string) $html);
     }
+
+    /**
+     * @dataProvider cssFileExtensions
+     */
+    public function testAssetsMethodSupportsAllCssFileExtensions(string $extension)
+    {
+        $html = Vite::assets(["resources/css/app.$extension"]);
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.'.$extension.'">';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public static function cssFileExtensions(): array
+    {
+        return array_map(fn (string $ext): array => [$ext], ['css', 'less', 'sass', 'scss', 'styl', 'stylus', 'pcss', 'postcss']);
+    }
 }

From 7230be56e385485274325a05d548d6fca25a1967 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 16:32:42 +0100
Subject: [PATCH 3618/4023] Improve accuracy of test

---
 .../tests/Unit/Facades/ViteFacadeTest.php     | 24 +++++++++++++++----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index fa10f82300e..60d2e7f630c 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -100,19 +100,33 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
     }
 
     /**
-     * @dataProvider cssFileExtensions
+     * @dataProvider cssFileExtensionsProvider
      */
-    public function testAssetsMethodSupportsAllCssFileExtensions(string $extension)
+    public function testAssetsMethodSupportsAllCssFileExtensions(string $extension, bool $shouldBeUsed)
     {
         $html = Vite::assets(["resources/css/app.$extension"]);
 
-        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.'.$extension.'">';
+        $expected = $shouldBeUsed
+            ? '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.'.$extension.'">'
+            : '<script src="http://localhost:5173/@vite/client" type="module"></script>';
 
         $this->assertSame($expected, (string) $html);
     }
 
-    public static function cssFileExtensions(): array
+    public static function cssFileExtensionsProvider(): array
     {
-        return array_map(fn (string $ext): array => [$ext], ['css', 'less', 'sass', 'scss', 'styl', 'stylus', 'pcss', 'postcss']);
+        return [
+            ['css', true],
+            ['less', true],
+            ['sass', true],
+            ['scss', true],
+            ['styl', true],
+            ['stylus', true],
+            ['pcss', true],
+            ['postcss', true],
+            ['foo', false],
+            ['txt', false],
+            ['html', false],
+        ];
     }
 }

From 59979e3982b452fad4331a9b8ff7b9e6b6cfe008 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 16:54:20 +0100
Subject: [PATCH 3619/4023] Use else if instead of if

---
 packages/framework/src/Facades/Vite.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index d45c21aaf24..c9a80ff3edf 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -24,9 +24,7 @@ public static function assets(array $paths): HtmlString
         foreach ($paths as $path) {
             if (self::isCssPath($path)) {
                 $html .= static::formatStylesheetLink($path);
-            }
-
-            if (self::isJsPath($path)) {
+            } elseif (self::isJsPath($path)) {
                 $html .= static::formatScriptInclude($path);
             }
         }

From 06d9641094392a1982111014bd8e3d2a1699d60b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 16:57:13 +0100
Subject: [PATCH 3620/4023] Revert "Use else if instead of if"

This reverts commit 59979e3982b452fad4331a9b8ff7b9e6b6cfe008.
---
 packages/framework/src/Facades/Vite.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index c9a80ff3edf..d45c21aaf24 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -24,7 +24,9 @@ public static function assets(array $paths): HtmlString
         foreach ($paths as $path) {
             if (self::isCssPath($path)) {
                 $html .= static::formatStylesheetLink($path);
-            } elseif (self::isJsPath($path)) {
+            }
+
+            if (self::isJsPath($path)) {
                 $html .= static::formatScriptInclude($path);
             }
         }

From da2ba15dbf69582e1b182cadf07ea0deeb3582d1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 16:59:02 +0100
Subject: [PATCH 3621/4023] Add more tests

---
 .../tests/Unit/Facades/ViteFacadeTest.php        | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 60d2e7f630c..0f1c8d3c155 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -59,6 +59,22 @@ public function testRunningReturnsFalseWhenViteHotFileDoesNotExist()
         $this->assertFalse(Vite::running());
     }
 
+    public function testItAlwaysImportsClientModule()
+    {
+        $html = Vite::assets([]);
+
+        $this->assertStringContainsString('<script src="http://localhost:5173/@vite/client" type="module"></script>', (string) $html);
+
+        $html = Vite::assets(['foo.js']);
+
+        $this->assertStringContainsString('<script src="http://localhost:5173/@vite/client" type="module"></script>', (string) $html);
+    }
+
+    public function testItDoesNotIncludeUnknownExtensions()
+    {
+        $this->assertSame((string) Vite::assets([]), (string) Vite::assets(['foo.txt']));
+    }
+
     public function testAssetsMethodReturnsHtmlString()
     {
         $this->assertInstanceOf(HtmlString::class, Vite::assets([]));

From d5ec63d6bf53ebd665cbaf399036821d0517fb21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:03:36 +0100
Subject: [PATCH 3622/4023] Extract helper to format the asset path

---
 packages/framework/src/Facades/Vite.php | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index d45c21aaf24..18f1c35fe5e 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -22,18 +22,25 @@ public static function assets(array $paths): HtmlString
         $html = '<script src="http://localhost:5173/@vite/client" type="module"></script>';
 
         foreach ($paths as $path) {
-            if (self::isCssPath($path)) {
-                $html .= static::formatStylesheetLink($path);
-            }
-
-            if (self::isJsPath($path)) {
-                $html .= static::formatScriptInclude($path);
-            }
+            $html .= static::formatAssetPath($path);
         }
 
         return new HtmlString($html);
     }
 
+    protected static function formatAssetPath(string $path): string
+    {
+        if (self::isCssPath($path)) {
+            return static::formatStylesheetLink($path);
+        }
+
+        if (self::isJsPath($path)) {
+            return static::formatScriptInclude($path);
+        }
+
+        return ''; // TODO: Throw an exception?
+    }
+
     protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
     {
         // TODO: Do we actually need this? Hotfile should be enough.

From 4bc0f52e05eb614861c4cc842f744cb21461a76c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:06:05 +0100
Subject: [PATCH 3623/4023] Use static instead of self

---
 packages/framework/src/Facades/Vite.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 18f1c35fe5e..eda0ec78a44 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -13,7 +13,7 @@ class Vite
 {
     public static function running(): bool
     {
-        return self::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
+        return static::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
     /** @param array<string> $paths */
@@ -30,11 +30,11 @@ public static function assets(array $paths): HtmlString
 
     protected static function formatAssetPath(string $path): string
     {
-        if (self::isCssPath($path)) {
+        if (static::isCssPath($path)) {
             return static::formatStylesheetLink($path);
         }
 
-        if (self::isJsPath($path)) {
+        if (static::isJsPath($path)) {
             return static::formatScriptInclude($path);
         }
 

From 8af55eda8866d4d71706687f4111ff22428bc333 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:09:21 +0100
Subject: [PATCH 3624/4023] Add helper to get single asset

---
 packages/framework/src/Facades/Vite.php       |  5 +++
 .../tests/Unit/Facades/ViteFacadeTest.php     | 32 +++++++++++++++++++
 2 files changed, 37 insertions(+)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index eda0ec78a44..d98fdf50eb1 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -16,6 +16,11 @@ public static function running(): bool
         return static::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
+    public static function asset(string $path): HtmlString
+    {
+        return static::assets([$path]);
+    }
+
     /** @param array<string> $paths */
     public static function assets(array $paths): HtmlString
     {
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 0f1c8d3c155..df7314c1565 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -129,6 +129,38 @@ public function testAssetsMethodSupportsAllCssFileExtensions(string $extension,
         $this->assertSame($expected, (string) $html);
     }
 
+    public function testAssetMethodReturnsHtmlString()
+    {
+        $this->assertInstanceOf(HtmlString::class, Vite::asset('foo.js'));
+    }
+
+    public function testAssetMethodGeneratesCorrectHtmlForJavaScriptFile()
+    {
+        $html = Vite::asset('resources/js/app.js');
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><script src="http://localhost:5173/resources/js/app.js" type="module"></script>';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public function testAssetMethodGeneratesCorrectHtmlForCssFile()
+    {
+        $html = Vite::asset('resources/css/app.css');
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.css">';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
+    public function testAssetMethodDoesNotIncludeUnknownExtensions()
+    {
+        $html = Vite::asset('unknown.ext');
+
+        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>';
+
+        $this->assertSame($expected, (string) $html);
+    }
+
     public static function cssFileExtensionsProvider(): array
     {
         return [

From fb3865c112caf41c35d2d28941e90de2d5af314b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:36:46 +0100
Subject: [PATCH 3625/4023] Simplify test

---
 .../tests/Unit/Facades/ViteFacadeTest.php     | 33 ++++++++++---------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index df7314c1565..80f223688d9 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -118,15 +118,18 @@ public function testAssetsMethodGeneratesCorrectHtmlForMultipleFiles()
     /**
      * @dataProvider cssFileExtensionsProvider
      */
-    public function testAssetsMethodSupportsAllCssFileExtensions(string $extension, bool $shouldBeUsed)
+    public function testAssetsMethodSupportsAllCssFileExtensions(string $extension)
     {
         $html = Vite::assets(["resources/css/app.$extension"]);
 
-        $expected = $shouldBeUsed
-            ? '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.'.$extension.'">'
-            : '<script src="http://localhost:5173/@vite/client" type="module"></script>';
+        if ($extension !== 'js') {
+            $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><link rel="stylesheet" href="http://localhost:5173/resources/css/app.'.$extension.'">';
 
-        $this->assertSame($expected, (string) $html);
+            $this->assertStringContainsString('stylesheet', (string) $html);
+            $this->assertSame($expected, (string) $html);
+        } else {
+            $this->assertStringNotContainsString('stylesheet', (string) $html);
+        }
     }
 
     public function testAssetMethodReturnsHtmlString()
@@ -164,17 +167,15 @@ public function testAssetMethodDoesNotIncludeUnknownExtensions()
     public static function cssFileExtensionsProvider(): array
     {
         return [
-            ['css', true],
-            ['less', true],
-            ['sass', true],
-            ['scss', true],
-            ['styl', true],
-            ['stylus', true],
-            ['pcss', true],
-            ['postcss', true],
-            ['foo', false],
-            ['txt', false],
-            ['html', false],
+            ['css'],
+            ['less'],
+            ['sass'],
+            ['scss'],
+            ['styl'],
+            ['stylus'],
+            ['pcss'],
+            ['postcss'],
+            ['js'],
         ];
     }
 }

From bf88379b728105893106375397c59716230f9718 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:38:13 +0100
Subject: [PATCH 3626/4023] Throw exception if the asset type is not supported

---
 packages/framework/src/Facades/Vite.php       |  5 +++-
 .../tests/Unit/Facades/ViteFacadeTest.php     | 25 +++++++++++--------
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index d98fdf50eb1..a3db7dd3608 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -5,6 +5,7 @@
 namespace Hyde\Facades;
 
 use Illuminate\Support\HtmlString;
+use InvalidArgumentException;
 
 /**
  * Vite facade for handling Vite-related operations.
@@ -33,6 +34,7 @@ public static function assets(array $paths): HtmlString
         return new HtmlString($html);
     }
 
+    /** @throws InvalidArgumentException If the asset type is not supported. */
     protected static function formatAssetPath(string $path): string
     {
         if (static::isCssPath($path)) {
@@ -43,7 +45,8 @@ protected static function formatAssetPath(string $path): string
             return static::formatScriptInclude($path);
         }
 
-        return ''; // TODO: Throw an exception?
+        // We don't know how to handle other asset types, so we throw an exception to let the user know.
+        throw new InvalidArgumentException("Unsupported asset type for path: '$path'");
     }
 
     protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 80f223688d9..faa90a4676a 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -8,6 +8,7 @@
 use Hyde\Facades\Vite;
 use Hyde\Testing\CreatesTemporaryFiles;
 use Illuminate\Support\HtmlString;
+use InvalidArgumentException;
 
 /**
  * @covers \Hyde\Facades\Vite
@@ -70,9 +71,20 @@ public function testItAlwaysImportsClientModule()
         $this->assertStringContainsString('<script src="http://localhost:5173/@vite/client" type="module"></script>', (string) $html);
     }
 
-    public function testItDoesNotIncludeUnknownExtensions()
+    public function testAssetMethodThrowsExceptionForUnknownExtensions()
     {
-        $this->assertSame((string) Vite::assets([]), (string) Vite::assets(['foo.txt']));
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Unsupported asset type for path: 'foo.txt'");
+
+        Vite::asset('foo.txt');
+    }
+
+    public function testAssetsMethodThrowsExceptionForUnknownExtensions()
+    {
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage("Unsupported asset type for path: 'foo.txt'");
+
+        Vite::assets(['foo.txt']);
     }
 
     public function testAssetsMethodReturnsHtmlString()
@@ -155,15 +167,6 @@ public function testAssetMethodGeneratesCorrectHtmlForCssFile()
         $this->assertSame($expected, (string) $html);
     }
 
-    public function testAssetMethodDoesNotIncludeUnknownExtensions()
-    {
-        $html = Vite::asset('unknown.ext');
-
-        $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script>';
-
-        $this->assertSame($expected, (string) $html);
-    }
-
     public static function cssFileExtensionsProvider(): array
     {
         return [

From b048fae428615c8329eba5dccd2dd3b557fd7865 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 17:59:14 +0100
Subject: [PATCH 3627/4023] Use only hotfiles instead of internal environment
 variable

See https://github.com/hydephp/develop/pull/2060
---
 .../src/Console/Commands/ServeCommand.php     |  4 +++-
 packages/framework/src/Facades/Vite.php       |  8 +------
 .../Feature/Commands/ServeCommandTest.php     | 12 ++++++++--
 .../tests/Unit/Facades/ViteFacadeTest.php     | 22 -------------------
 .../Unit/ServeCommandOptionsUnitTest.php      | 12 ----------
 .../realtime-compiler/src/ConsoleOutput.php   |  3 ++-
 6 files changed, 16 insertions(+), 45 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index c998aba44ce..b2b85548d05 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -5,6 +5,7 @@
 namespace Hyde\Console\Commands;
 
 use Closure;
+use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
 use Hyde\Facades\Config;
 use Illuminate\Contracts\Process\InvokedProcess;
@@ -112,7 +113,6 @@ protected function getEnvironmentVariables(): array
             'HYDE_SERVER_DASHBOARD' => $this->parseEnvironmentOption('dashboard'),
             'HYDE_PRETTY_URLS' => $this->parseEnvironmentOption('pretty-urls'),
             'HYDE_PLAY_CDN' => $this->parseEnvironmentOption('play-cdn'),
-            'HYDE_SERVER_VITE' => $this->option('vite') ? 'enabled' : null,
         ]);
     }
 
@@ -204,6 +204,8 @@ protected function runViteProcess(): void
             );
         }
 
+        Filesystem::touch('app/storage/framework/cache/vite.hot');
+
         $this->vite = Process::forever()->start('npm run dev');
     }
 
diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index a3db7dd3608..f69c8f0b9de 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -14,7 +14,7 @@ class Vite
 {
     public static function running(): bool
     {
-        return static::checkIfViteWasEnabledViaTheServeCommand() || Filesystem::exists('app/storage/framework/cache/vite.hot');
+        return Filesystem::exists('app/storage/framework/cache/vite.hot');
     }
 
     public static function asset(string $path): HtmlString
@@ -49,12 +49,6 @@ protected static function formatAssetPath(string $path): string
         throw new InvalidArgumentException("Unsupported asset type for path: '$path'");
     }
 
-    protected static function checkIfViteWasEnabledViaTheServeCommand(): bool
-    {
-        // TODO: Do we actually need this? Hotfile should be enough.
-        return env('HYDE_SERVER_VITE') === 'enabled';
-    }
-
     protected static function isCssPath(string $path): bool
     {
         return preg_match('/\.(css|less|sass|scss|styl|stylus|pcss|postcss)$/', $path) === 1;
diff --git a/packages/framework/tests/Feature/Commands/ServeCommandTest.php b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
index 1f26744c908..3b34e3f4ce9 100644
--- a/packages/framework/tests/Feature/Commands/ServeCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
@@ -182,6 +182,8 @@ public function testWithFancyOutput()
 
     public function testHydeServeCommandWithViteOption()
     {
+        $this->cleanUpWhenDone('app/storage/framework/cache/vite.hot');
+
         $mockViteProcess = mock(InvokedProcess::class);
         $mockViteProcess->shouldReceive('running')
             ->once()
@@ -202,7 +204,7 @@ public function testHydeServeCommandWithViteOption()
 
         Process::shouldReceive('env')
             ->once()
-            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false, 'HYDE_SERVER_VITE' => 'enabled'])
+            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false])
             ->andReturnSelf();
 
         Process::shouldReceive('start')
@@ -224,10 +226,14 @@ public function testHydeServeCommandWithViteOption()
             ->expectsOutput('server output')
             ->expectsOutput('vite latest output')
             ->assertExitCode(0);
+
+        $this->assertFileExists('app/storage/framework/cache/vite.hot');
     }
 
     public function testHydeServeCommandWithViteOptionButViteNotRunning()
     {
+        $this->cleanUpWhenDone('app/storage/framework/cache/vite.hot');
+
         $mockViteProcess = mock(InvokedProcess::class);
         $mockViteProcess->shouldReceive('running')
             ->once()
@@ -245,7 +251,7 @@ public function testHydeServeCommandWithViteOptionButViteNotRunning()
 
         Process::shouldReceive('env')
             ->once()
-            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false, 'HYDE_SERVER_VITE' => 'enabled'])
+            ->with(['HYDE_SERVER_REQUEST_OUTPUT' => false])
             ->andReturnSelf();
 
         Process::shouldReceive('start')
@@ -263,6 +269,8 @@ public function testHydeServeCommandWithViteOptionButViteNotRunning()
         $this->artisan('serve --no-ansi --vite')
             ->expectsOutput('Starting the HydeRC server... Use Ctrl+C to stop')
             ->assertExitCode(0);
+
+        $this->assertFileExists('app/storage/framework/cache/vite.hot');
     }
 
     public function testHydeServeCommandWithViteOptionThrowsWhenPortIsInUse()
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index faa90a4676a..4c804e9bf85 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -24,28 +24,6 @@ protected function tearDown(): void
         $this->cleanUpFilesystem();
     }
 
-    public function testRunningReturnsTrueWhenEnvironmentVariableIsSet()
-    {
-        putenv('HYDE_SERVER_VITE=enabled');
-
-        $this->assertTrue(Vite::running());
-
-        putenv('HYDE_SERVER_VITE');
-    }
-
-    public function testRunningReturnsFalseWhenEnvironmentVariableIsNotSetOrDisabled()
-    {
-        $this->assertFalse(Vite::running());
-
-        putenv('HYDE_SERVER_VITE=disabled');
-
-        $this->assertFalse(Vite::running());
-
-        putenv('HYDE_SERVER_VITE');
-
-        $this->assertFalse(Vite::running());
-    }
-
     public function testRunningReturnsTrueWhenViteHotFileExists()
     {
         $this->file('app/storage/framework/cache/vite.hot');
diff --git a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
index 9df671ec114..eeaa62b5a47 100644
--- a/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
+++ b/packages/framework/tests/Unit/ServeCommandOptionsUnitTest.php
@@ -335,18 +335,6 @@ public function testGetOpenCommandForUnknownOS()
         $this->assertNull($this->getMock()->getOpenCommand('UnknownOS'));
     }
 
-    public function testViteOptionPropagatesToEnvironmentVariables()
-    {
-        $command = $this->getMock(['vite' => true]);
-        $this->assertSame('enabled', $command->getEnvironmentVariables()['HYDE_SERVER_VITE']);
-
-        $command = $this->getMock(['vite' => false]);
-        $this->assertFalse(isset($command->getEnvironmentVariables()['HYDE_SERVER_VITE']));
-
-        $command = $this->getMock();
-        $this->assertFalse(isset($command->getEnvironmentVariables()['HYDE_SERVER_VITE']));
-    }
-
     public function testWithViteArgument()
     {
         HydeKernel::setInstance(new HydeKernel());
diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index fdb1cf0a801..0d1d6a611bf 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -5,6 +5,7 @@
 namespace Hyde\RealtimeCompiler;
 
 use Closure;
+use Hyde\Facades\Vite;
 use Hyde\Hyde;
 use Illuminate\Support\Str;
 use Illuminate\Support\Arr;
@@ -35,7 +36,7 @@ public function printStartMessage(string $host, int $port, array $environment =
             sprintf('<span class="text-white">Listening on:</span> <a href="%s" class="text-yellow-500">%s</a>', $url, $url),
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
-            Arr::get($environment, 'HYDE_SERVER_VITE') === 'enabled' ?
+            Vite::running() ?
                 sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:5173" class="text-yellow-500">http://%s:5173</a>', $host, $host) : null,
             '',
         ]);

From 9ffbeed4d63d3b9246e75bd3b44711aa39ee486d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 18:15:51 +0100
Subject: [PATCH 3628/4023] Extract constant for CSS extensions

---
 packages/framework/src/Facades/Vite.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index f69c8f0b9de..84efa37482e 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -12,6 +12,8 @@
  */
 class Vite
 {
+    protected const CSS_EXTENSIONS = ['css', 'less', 'sass', 'scss', 'styl', 'stylus', 'pcss', 'postcss'];
+
     public static function running(): bool
     {
         return Filesystem::exists('app/storage/framework/cache/vite.hot');
@@ -51,7 +53,7 @@ protected static function formatAssetPath(string $path): string
 
     protected static function isCssPath(string $path): bool
     {
-        return preg_match('/\.(css|less|sass|scss|styl|stylus|pcss|postcss)$/', $path) === 1;
+        return preg_match('/\.('.implode('|', static::CSS_EXTENSIONS).')$/', $path) === 1;
     }
 
     protected static function isJsPath(string $path): bool

From f418e2bd9776a5e8f93bdf972a6fc100e2e50be3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 18:19:07 +0100
Subject: [PATCH 3629/4023] Support more JavaScript extensions

---
 packages/framework/src/Facades/Vite.php       |  3 +-
 .../tests/Unit/Facades/ViteFacadeTest.php     | 28 +++++++++++++++++++
 2 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 84efa37482e..f2729b26d27 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -13,6 +13,7 @@
 class Vite
 {
     protected const CSS_EXTENSIONS = ['css', 'less', 'sass', 'scss', 'styl', 'stylus', 'pcss', 'postcss'];
+    protected const JS_EXTENSIONS = ['js', 'jsx', 'ts', 'tsx'];
 
     public static function running(): bool
     {
@@ -58,7 +59,7 @@ protected static function isCssPath(string $path): bool
 
     protected static function isJsPath(string $path): bool
     {
-        return str_ends_with($path, '.js');
+        return preg_match('/\.('.implode('|', static::JS_EXTENSIONS).')$/', $path) === 1;
     }
 
     protected static function formatStylesheetLink(string $path): string
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 4c804e9bf85..45adda783c4 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -122,6 +122,23 @@ public function testAssetsMethodSupportsAllCssFileExtensions(string $extension)
         }
     }
 
+    /**
+     * @dataProvider jsFileExtensionsProvider
+     */
+    public function testAssetsMethodSupportsAllJsFileExtensions(string $extension)
+    {
+        $html = Vite::assets(["resources/js/app.$extension"]);
+
+        if ($extension !== 'css') {
+            $expected = '<script src="http://localhost:5173/@vite/client" type="module"></script><script src="http://localhost:5173/resources/js/app.'.$extension.'" type="module"></script>';
+
+            $this->assertStringNotContainsString('stylesheet', (string) $html);
+            $this->assertSame($expected, (string) $html);
+        } else {
+            $this->assertStringContainsString('stylesheet', (string) $html);
+        }
+    }
+
     public function testAssetMethodReturnsHtmlString()
     {
         $this->assertInstanceOf(HtmlString::class, Vite::asset('foo.js'));
@@ -159,4 +176,15 @@ public static function cssFileExtensionsProvider(): array
             ['js'],
         ];
     }
+
+    public static function jsFileExtensionsProvider(): array
+    {
+        return [
+            ['js'],
+            ['jsx'],
+            ['ts'],
+            ['tsx'],
+            ['css'],
+        ];
+    }
 }

From 83264ca794b35e794e65b1cd114fd3ea688267d8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 18:23:39 +0100
Subject: [PATCH 3630/4023] Extract helper method for repeated code

---
 packages/framework/src/Facades/Vite.php | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index f2729b26d27..814aff2b07c 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -54,12 +54,17 @@ protected static function formatAssetPath(string $path): string
 
     protected static function isCssPath(string $path): bool
     {
-        return preg_match('/\.('.implode('|', static::CSS_EXTENSIONS).')$/', $path) === 1;
+        return static::checkFileExtensionForPath($path, static::CSS_EXTENSIONS);
     }
 
     protected static function isJsPath(string $path): bool
     {
-        return preg_match('/\.('.implode('|', static::JS_EXTENSIONS).')$/', $path) === 1;
+        return static::checkFileExtensionForPath($path, static::JS_EXTENSIONS);
+    }
+
+    protected static function checkFileExtensionForPath(string $path, array $extensions): bool
+    {
+        return preg_match('/\.('.implode('|', $extensions).')$/', $path) === 1;
     }
 
     protected static function formatStylesheetLink(string $path): string

From 0878552c9e7ab9210f34d09b35fba58b8777bba6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:36:34 +0100
Subject: [PATCH 3631/4023] Remove section as there is only one component left

---
 docs/creating-content/managing-assets.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index e4db6fee431..2017183b109 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -117,12 +117,6 @@ When running the `npm run dev/prod` command, Vite will compile the `resources/as
 
 The compiled assets will then be automatically copied to `_site/media` when you run `php hyde build`.
 
-### Customizing HydeFront Components
-
-HydeFront components are modular and can be easily customized to fit your needs.
-
-You can either remove the import of the component you want to customize and replace it with your own styles, or keep the import and add overriding styles after it (since CSS cascade order matters).
-
 ## Telling Hyde where to find assets
 
 ### Customizing the Blade templates

From a3ac13ab8e74c69ad190b58fdfb149664f04130e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:39:16 +0100
Subject: [PATCH 3632/4023] Document HydeSearch overloading

---
 packages/framework/resources/js/HydeSearch.js | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/resources/js/HydeSearch.js b/packages/framework/resources/js/HydeSearch.js
index ff8a6591f94..15502049751 100644
--- a/packages/framework/resources/js/HydeSearch.js
+++ b/packages/framework/resources/js/HydeSearch.js
@@ -1,3 +1,14 @@
+/**
+ * This file provides support for the Alpine.js search component.
+ *
+ * It's automatically loaded by the hyde-search.blade.php component.
+ *
+ * It can be replaced by a custom implementation, at the developer's own risk,
+ * by providing a new compatible implementation in ./resources/js/HydeSearch.js.
+ *
+ * @param {string} searchIndexUrl
+ * @returns {Object}
+ */
 function initHydeSearch(searchIndexUrl) {
     return {
         searchIndex: [],

From c66e2f5c618e9d9bc57b405ae56b32755effaf8f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:51:41 +0100
Subject: [PATCH 3633/4023] Extract helper methods

---
 .../src/Console/Commands/ServeCommand.php     | 32 ++++++++++++-------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index b2b85548d05..18d94199d30 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -70,17 +70,7 @@ public function safeHandle(): int
 
         $this->runServerProcess($command);
 
-        while ($this->server->running()) {
-            if (isset($this->vite) && $this->vite->running()) {
-                $output = $this->vite->latestOutput();
-
-                if ($output) {
-                    $this->output->write($output);
-                }
-            }
-
-            Sleep::usleep(100000); // 100ms
-        }
+        $this->handleRunningProcesses();
 
         return Command::SUCCESS;
     }
@@ -209,6 +199,26 @@ protected function runViteProcess(): void
         $this->vite = Process::forever()->start('npm run dev');
     }
 
+    protected function handleRunningProcesses(): void
+    {
+        while ($this->server->running()) {
+            $this->handleViteOutput();
+
+            Sleep::usleep(100000); // 100ms
+        }
+    }
+
+    protected function handleViteOutput(): void
+    {
+        if (isset($this->vite) && $this->vite->running()) {
+            $output = $this->vite->latestOutput();
+
+            if ($output) {
+                $this->output->write($output);
+            }
+        }
+    }
+
     /** @experimental This feature may be removed before the final release. */
     protected function isPortAvailable(int $port): bool
     {

From 2b30ef223ff33208681c16b8d3dd88d0b9b917f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:55:55 +0100
Subject: [PATCH 3634/4023] Use fluent sleep declaration

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 18d94199d30..798be1e1155 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -204,7 +204,7 @@ protected function handleRunningProcesses(): void
         while ($this->server->running()) {
             $this->handleViteOutput();
 
-            Sleep::usleep(100000); // 100ms
+            Sleep::for(100)->milliseconds();
         }
     }
 

From e88c368aade9129f5d856450076c53efe4715d2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:59:07 +0100
Subject: [PATCH 3635/4023] Make sure docs is up to date

---
 docs/creating-content/managing-assets.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index 2017183b109..a087678236b 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -12,8 +12,7 @@ Managing and compiling assets is a very common task in web development. Unfortun
 With Hyde, **you don't have to do it**, in fact, you can skip this entire page if you are happy with how it is.
 But as always with Hyde, you can customize everything if you want to.
 
-Hyde ships with a complete frontend using Blade views, TailwindCSS styles, and Alpine.js interactions.
-Some extra component styles are organized into modular files in the HydeFront package, which is pre-installed and bundled in the pre-configured Tailwind and Vite setup.
+Hyde ships with a complete frontend using Blade views, TailwindCSS styles, and Alpine.js interactions, all pre-installed and bundled in the pre-configured Tailwind and Vite setup.
 
 To get you started quickly, all the styles are already compiled and minified into `_media/app.css`,
 which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.

From c831eea5f03d448f713326f44738bb593dbbc839 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 19:59:12 +0100
Subject: [PATCH 3636/4023] Clean up formatting

---
 docs/creating-content/managing-assets.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index a087678236b..fc51664d9d6 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -9,13 +9,11 @@ navigation:
 
 Managing and compiling assets is a very common task in web development. Unfortunately, it's rarely fun.
 
-With Hyde, **you don't have to do it**, in fact, you can skip this entire page if you are happy with how it is.
-But as always with Hyde, you can customize everything if you want to.
+With Hyde, **you don't have to do it**, in fact, you can skip this entire page if you are happy with how it is. But as always with Hyde, you can customize everything if you want to.
 
 Hyde ships with a complete frontend using Blade views, TailwindCSS styles, and Alpine.js interactions, all pre-installed and bundled in the pre-configured Tailwind and Vite setup.
 
-To get you started quickly, all the styles are already compiled and minified into `_media/app.css`,
-which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.
+To get you started quickly, all the styles are already compiled and minified into `_media/app.css`, which will be copied to the `_site/media/app.css` directory when you run `php hyde build`.
 
 ## Vite
 

From bf0711248c56e8250f03cf744ac0d6c9ce929952 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:00:46 +0100
Subject: [PATCH 3637/4023] Make Vite process nullable

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 798be1e1155..f4fca78bc0a 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -47,7 +47,7 @@ class ServeCommand extends Command
     protected ConsoleOutput $console;
 
     protected InvokedProcess $server;
-    protected InvokedProcess $vite;
+    protected ?InvokedProcess $vite = null;
 
     public function safeHandle(): int
     {

From d1199d516971e37a95749df18106ade024de5aa8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:00:50 +0100
Subject: [PATCH 3638/4023] Use null safe operator

---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index f4fca78bc0a..2b83aea0641 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -210,7 +210,7 @@ protected function handleRunningProcesses(): void
 
     protected function handleViteOutput(): void
     {
-        if (isset($this->vite) && $this->vite->running()) {
+        if ($this->vite?->running()) {
             $output = $this->vite->latestOutput();
 
             if ($output) {

From 35d12384cf6de4d36098c8446d810d5788bbf339 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:02:08 +0100
Subject: [PATCH 3639/4023] Move up option handler

---
 packages/framework/src/Console/Commands/ServeCommand.php | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 2b83aea0641..f74c7560928 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -58,16 +58,16 @@ public function safeHandle(): int
             $this->openInBrowser((string) $this->option('open'));
         }
 
+        if ($this->option('vite')) {
+            $this->runViteProcess();
+        }
+
         $command = sprintf('php -S %s:%d %s',
             $this->getHostSelection(),
             $this->getPortSelection(),
             $this->getExecutablePath()
         );
 
-        if ($this->option('vite')) {
-            $this->runViteProcess();
-        }
-
         $this->runServerProcess($command);
 
         $this->handleRunningProcesses();

From ba2c7c67df0af96e22e4a3f7577f7870af35d74d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:02:16 +0100
Subject: [PATCH 3640/4023] Inline variable

---
 packages/framework/src/Console/Commands/ServeCommand.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index f74c7560928..ac967da8d9f 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -62,13 +62,11 @@ public function safeHandle(): int
             $this->runViteProcess();
         }
 
-        $command = sprintf('php -S %s:%d %s',
+        $this->runServerProcess(sprintf('php -S %s:%d %s',
             $this->getHostSelection(),
             $this->getPortSelection(),
             $this->getExecutablePath()
-        );
-
-        $this->runServerProcess($command);
+        ));
 
         $this->handleRunningProcesses();
 

From 96a00ea8df228aae65050cc8fc7c1232acc3f113 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:08:13 +0100
Subject: [PATCH 3641/4023] Fix clunky wording

---
 packages/hyde/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/hyde/README.md b/packages/hyde/README.md
index 00a34c0415a..f95515ca99a 100644
--- a/packages/hyde/README.md
+++ b/packages/hyde/README.md
@@ -49,7 +49,7 @@ See the documentation and learn more at https://hydephp.com/docs
 
 - The Hyde starter comes with [HydeFront](https://github.com/hydephp/hydefront) to serve the base stylesheet and JavaScript through the jsDelivr CDN.
 - Hyde ships with precompiled and minified TailwindCSS styles in the app.css file, you can also load them through the CDN.
-- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run build` command to recompile the styles using the pre-configured Tailwind and Vite configuration.
+- This means that all the styles you need are already installed. However, if you want to customize the included Tailwind config, or if you add new Tailwind classes through Blade files, you can simply run the `npm run build` command to recompile the styles using the pre-configured Tailwind and Vite setup.
 
 ### Customization
 

From 08a966120d0f37f456775ee25581c30b2ad69651 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:16:59 +0100
Subject: [PATCH 3642/4023] Expand on file documentation

---
 packages/hydefront/components/torchlight.css | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/hydefront/components/torchlight.css b/packages/hydefront/components/torchlight.css
index af843061411..062aa04f85a 100644
--- a/packages/hydefront/components/torchlight.css
+++ b/packages/hydefront/components/torchlight.css
@@ -1,6 +1,7 @@
 /*
  * This file contains the default styles for the Torchlight syntax highlighter.
- * You can easily include this file through your resources/assets/app.css file.
+ * This is already included in the bundled `resources/assets/app.css` file,
+ * and can be customized by replacing the import with your custom CSS.
  */
 
 pre code.torchlight .line-number, pre code.torchlight .summary-caret {

From 5110508cc69b51b6ca98fc856ad48966091475a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:22:14 +0100
Subject: [PATCH 3643/4023] Add internal environment variable if we will use
 Vite

---
 packages/framework/src/Console/Commands/ServeCommand.php | 1 +
 packages/realtime-compiler/src/ConsoleOutput.php         | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index ac967da8d9f..736969fa2a5 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -97,6 +97,7 @@ protected function getEnvironmentVariables(): array
     {
         return Arr::whereNotNull([
             'HYDE_SERVER_REQUEST_OUTPUT' => ! $this->option('no-ansi'),
+            'HYDE_SERVER_WILL_USE_VITE' => $this->option('vite') ? 'enabled' : null,
             'HYDE_SERVER_SAVE_PREVIEW' => $this->parseEnvironmentOption('save-preview'),
             'HYDE_SERVER_DASHBOARD' => $this->parseEnvironmentOption('dashboard'),
             'HYDE_PRETTY_URLS' => $this->parseEnvironmentOption('pretty-urls'),
diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index 0d1d6a611bf..fb2e53b2e49 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -36,7 +36,7 @@ public function printStartMessage(string $host, int $port, array $environment =
             sprintf('<span class="text-white">Listening on:</span> <a href="%s" class="text-yellow-500">%s</a>', $url, $url),
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
-            Vite::running() ?
+            (Vite::running() || (Arr::has($environment, 'HYDE_SERVER_WILL_USE_VITE'))) ?
                 sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:5173" class="text-yellow-500">http://%s:5173</a>', $host, $host) : null,
             '',
         ]);

From e9881cb5aba9fa225238c221077779753d0f120e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:22:17 +0100
Subject: [PATCH 3644/4023] Revert "Add internal environment variable if we
 will use Vite"

This reverts commit 5110508cc69b51b6ca98fc856ad48966091475a6.
---
 packages/framework/src/Console/Commands/ServeCommand.php | 1 -
 packages/realtime-compiler/src/ConsoleOutput.php         | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 736969fa2a5..ac967da8d9f 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -97,7 +97,6 @@ protected function getEnvironmentVariables(): array
     {
         return Arr::whereNotNull([
             'HYDE_SERVER_REQUEST_OUTPUT' => ! $this->option('no-ansi'),
-            'HYDE_SERVER_WILL_USE_VITE' => $this->option('vite') ? 'enabled' : null,
             'HYDE_SERVER_SAVE_PREVIEW' => $this->parseEnvironmentOption('save-preview'),
             'HYDE_SERVER_DASHBOARD' => $this->parseEnvironmentOption('dashboard'),
             'HYDE_PRETTY_URLS' => $this->parseEnvironmentOption('pretty-urls'),
diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index fb2e53b2e49..0d1d6a611bf 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -36,7 +36,7 @@ public function printStartMessage(string $host, int $port, array $environment =
             sprintf('<span class="text-white">Listening on:</span> <a href="%s" class="text-yellow-500">%s</a>', $url, $url),
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
-            (Vite::running() || (Arr::has($environment, 'HYDE_SERVER_WILL_USE_VITE'))) ?
+            Vite::running() ?
                 sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:5173" class="text-yellow-500">http://%s:5173</a>', $host, $host) : null,
             '',
         ]);

From d2793df9d8f8b09e800e9c55298a3758d2211986 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:27:13 +0100
Subject: [PATCH 3645/4023] Add parameter if we will use Vite

Replaces 5110508cc69b51b6ca98fc856ad48966091475a6 as the file is already internal so we don't need to worry about supporting another parameter
---
 packages/framework/src/Console/Commands/ServeCommand.php | 2 +-
 packages/realtime-compiler/src/ConsoleOutput.php         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index ac967da8d9f..676972a9ad8 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -115,7 +115,7 @@ protected function printStartMessage(): void
     {
         $this->useBasicOutput()
             ? $this->output->writeln('<info>Starting the HydeRC server...</info> Use Ctrl+C to stop')
-            : $this->console->printStartMessage($this->getHostSelection(), $this->getPortSelection(), $this->getEnvironmentVariables());
+            : $this->console->printStartMessage($this->getHostSelection(), $this->getPortSelection(), $this->getEnvironmentVariables(), $this->option('vite'));
     }
 
     protected function getOutputHandler(): Closure
diff --git a/packages/realtime-compiler/src/ConsoleOutput.php b/packages/realtime-compiler/src/ConsoleOutput.php
index 0d1d6a611bf..e756e026a76 100644
--- a/packages/realtime-compiler/src/ConsoleOutput.php
+++ b/packages/realtime-compiler/src/ConsoleOutput.php
@@ -25,7 +25,7 @@ public function __construct(bool $verbose = false, ?SymfonyOutput $output = null
         $this->output = $output ?? new SymfonyOutput();
     }
 
-    public function printStartMessage(string $host, int $port, array $environment = []): void
+    public function printStartMessage(string $host, int $port, array $environment = [], ?bool $willUseVite = false): void
     {
         $url = sprintf('%s://%s:%d', $port === 443 ? 'https' : 'http', $host, $port);
 
@@ -36,7 +36,7 @@ public function printStartMessage(string $host, int $port, array $environment =
             sprintf('<span class="text-white">Listening on:</span> <a href="%s" class="text-yellow-500">%s</a>', $url, $url),
             (config('hyde.server.dashboard.enabled') || Arr::has($environment, 'HYDE_SERVER_DASHBOARD')) && Arr::get($environment, 'HYDE_SERVER_DASHBOARD') === 'enabled' ?
                 sprintf('<span class="text-white">Live dashboard:</span> <a href="%s/dashboard" class="text-yellow-500">%s/dashboard</a>', $url, $url) : null,
-            Vite::running() ?
+            (Vite::running() || $willUseVite) ?
                 sprintf('<span class="text-white">Vite HMR server:</span> <a href="http://%s:5173" class="text-yellow-500">http://%s:5173</a>', $host, $host) : null,
             '',
         ]);

From 8d16f525c100b3538971bcf97f33d6f60ec1a90d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:32:34 +0100
Subject: [PATCH 3646/4023] Mark the HeadingRenderer class as internal

This will reduce the maintenance burden and ensure more controlled usage within the core library. If future user needs arise, we will consider revisiting this decision.
---
 packages/framework/src/Markdown/Processing/HeadingRenderer.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index dcb4517c3f9..74045871666 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -14,6 +14,8 @@
 /**
  * Renders a heading node, and supports built-in permalink generation.
  *
+ * @internal This class is an internal implementation detail of our Markdown processing and is not indented for use outside of the framework.
+ *
  * @see \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer
  */
 class HeadingRenderer implements NodeRendererInterface

From f3f5b088514a5c10cc292f46aeb65a09b1e8fb8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:34:14 +0100
Subject: [PATCH 3647/4023] Make variable name clearer

---
 .../resources/views/components/filepath-label.blade.php       | 4 ++--
 .../src/Markdown/Processing/CodeblockFilepathProcessor.php    | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index 5161bb4d183..6ced610eeeb 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1,5 +1,5 @@
 <small @class([
     'relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block',
-    '-top-1 right-1' => $torchlight,
-    'top-0 right-0' => ! $torchlight,
+    '-top-1 right-1' => $highlightedByTorchlight,
+    'top-0 right-0' => ! $highlightedByTorchlight,
 ])><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file
diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index abc73b97613..94d1fa928c8 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -113,11 +113,11 @@ protected static function trimHydeDirective(string $line): string
         ));
     }
 
-    protected static function resolveTemplate(string $path, bool $torchlight): string
+    protected static function resolveTemplate(string $path, bool $highlightedByTorchlight): string
     {
         return View::make('hyde::components.filepath-label', [
             'path' => Config::getBool('markdown.allow_html', false) ? new HtmlString($path) : $path,
-            'torchlight' => $torchlight,
+            'highlightedByTorchlight' => $highlightedByTorchlight,
         ])->render();
     }
 

From 830ddbfac218ebfbbbafdabe98c6aa669102bc24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:34:18 +0100
Subject: [PATCH 3648/4023] Add component props

---
 .../resources/views/components/filepath-label.blade.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index 6ced610eeeb..2bd7ce88aa5 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1,3 +1,4 @@
+@props(['path', 'highlightedByTorchlight' => false])
 <small @class([
     'relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block',
     '-top-1 right-1' => $highlightedByTorchlight,

From 8969c03a879a649f4cc36506a543ce9fe93848c3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:35:34 +0100
Subject: [PATCH 3649/4023] Consistent variable naming

---
 .../src/Markdown/Processing/CodeblockFilepathProcessor.php  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index 94d1fa928c8..8ed390d404d 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -80,13 +80,13 @@ public static function postprocess(string $html): string
         /** @var int $index */
         foreach ($lines as $index => $line) {
             if (str_starts_with($line, '<!-- HYDE[Filepath]')) {
-                $torchlight = str_contains($html, static::$torchlightKey);
+                $highlightedByTorchlight = str_contains($html, static::$torchlightKey);
                 $path = static::trimHydeDirective($line);
                 unset($lines[$index]);
                 $codeBlockLine = $index + 1;
-                $label = static::resolveTemplate($path, $torchlight);
+                $label = static::resolveTemplate($path, $highlightedByTorchlight);
 
-                $lines[$codeBlockLine] = $torchlight
+                $lines[$codeBlockLine] = $highlightedByTorchlight
                     ? static::injectLabelToTorchlightCodeLine($label, $lines[$codeBlockLine])
                     : static::injectLabelToCodeLine($label, $lines[$codeBlockLine]);
             }

From cd669531f39a8516c9944d0d9627b0982aa4fa78 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:36:33 +0100
Subject: [PATCH 3650/4023] Document reason for the heading registry

---
 packages/framework/src/Framework/Services/MarkdownService.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index a0125ae6c18..f570e9f4ab1 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -55,7 +55,7 @@ class MarkdownService
     /** @var array<class-string<\Hyde\Markdown\Contracts\MarkdownPostProcessorContract>> */
     protected array $postprocessors = [];
 
-    /** @var array<string> */
+    /** @var array<string> Tracks all the headings in the document to ensure identifiers are unique */
     protected array $headingRegistry = [];
 
     public function __construct(string $markdown, ?string $pageClass = null)

From a037ab15f6fe6fd79480f5ae6e61508f1783c3c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:38:31 +0100
Subject: [PATCH 3651/4023] Use consistent naming for heading identifiers

---
 .../docs/table-of-contents.blade.php          |  2 +-
 .../Actions/GeneratesTableOfContents.php      | 26 +++----
 .../GeneratesSidebarTableOfContentsTest.php   | 74 +++++++++----------
 3 files changed, 51 insertions(+), 51 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 974f0e5a01e..67759d24f96 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -4,7 +4,7 @@
     <ul class="{{ ! $isChild ? 'table-of-contents pb-3' : 'pl-2' }}">
         @foreach($items as $item)
             <li class="my-0.5">
-                <a href="#{{ $item['slug'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
+                <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
                     <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>
                     {{ $item['title'] }}
                 </a>
diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 7f217ed8861..ca06d36a3a0 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -27,7 +27,7 @@ public function __construct(Markdown|string $markdown)
     }
 
     /**
-     * @return array<int, array{title: string, slug: string, children: array}>
+     * @return array<int, array{title: string, identifier: string, children: array}>
      */
     public function execute(): array
     {
@@ -35,7 +35,7 @@ public function execute(): array
     }
 
     /**
-     * @return array<int, array{level: int, title: string, slug: string}>
+     * @return array<int, array{level: int, title: string, identifier: string}>
      */
     protected function parseHeadings(): array
     {
@@ -110,20 +110,20 @@ protected function parseSetextHeading(string $title, string $marker): ?array
 
     /**
      * @param  array{level: int, title: string}  $headingData
-     * @return array{level: int, title: string, slug: string}
+     * @return array{level: int, title: string, identifier: string}
      */
     protected function createHeadingEntry(array $headingData): array
     {
         return [
             'level' => $headingData['level'],
             'title' => $headingData['title'],
-            'slug' => HeadingRenderer::makeIdentifier($headingData['title']),
+            'identifier' => HeadingRenderer::makeIdentifier($headingData['title']),
         ];
     }
 
     /**
-     * @param  array<int, array{level: int, title: string, slug: string}>  $headings
-     * @return array<int, array{title: string, slug: string, children: array}>
+     * @param  array<int, array{level: int, title: string, identifier: string}>  $headings
+     * @return array<int, array{title: string, identifier: string, children: array}>
      */
     protected function buildTableOfContents(array $headings): array
     {
@@ -145,7 +145,7 @@ protected function buildTableOfContents(array $headings): array
     }
 
     /**
-     * @param  array{level: int, title: string, slug: string}  $heading
+     * @param  array{level: int, title: string, identifier: string}  $heading
      */
     protected function isHeadingWithinBounds(array $heading): bool
     {
@@ -154,20 +154,20 @@ protected function isHeadingWithinBounds(array $heading): bool
     }
 
     /**
-     * @param  array{level: int, title: string, slug: string}  $heading
-     * @return array{title: string, slug: string, children: array}
+     * @param  array{level: int, title: string, identifier: string}  $heading
+     * @return array{title: string, identifier: string, children: array}
      */
     protected function createTableItem(array $heading): array
     {
         return [
             'title' => $heading['title'],
-            'slug' => $heading['slug'],
+            'identifier' => $heading['identifier'],
             'children' => [],
         ];
     }
 
     /**
-     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
      */
     protected function updateStackForHeadingLevel(array &$stack, int $currentLevel, int $previousLevel): void
     {
@@ -181,7 +181,7 @@ protected function updateStackForHeadingLevel(array &$stack, int $currentLevel,
     }
 
     /**
-     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
      */
     protected function nestNewLevel(array &$stack): void
     {
@@ -192,7 +192,7 @@ protected function nestNewLevel(array &$stack): void
     }
 
     /**
-     * @param  array<int, array<int, array{title: string, slug: string, children: array}>>  $stack
+     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
      */
     protected function unwindStack(array &$stack, int $currentLevel): void
     {
diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 84728301ade..32952775d32 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -26,16 +26,16 @@ public function testCanGenerateTableOfContents()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [],
             ],
             [
                 'title' => 'Level 2B',
-                'slug' => 'level-2b',
+                'identifier' => 'level-2b',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [],
                     ],
                 ],
@@ -56,11 +56,11 @@ public function testReturnStringContainsExpectedContent()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [],
                     ],
                 ],
@@ -94,12 +94,12 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
             [
                 [
                     'title' => 'Level 2',
-                    'slug' => 'level-2',
+                    'identifier' => 'level-2',
                     'children' => [],
                 ],
                 [
                     'title' => 'Level 2B',
-                    'slug' => 'level-2b',
+                    'identifier' => 'level-2b',
                     'children' => [],
                 ],
             ],
@@ -133,11 +133,11 @@ public function testNonHeadingMarkdownIsIgnored()
             [
                 [
                     'title' => 'Level 2',
-                    'slug' => 'level-2',
+                    'identifier' => 'level-2',
                     'children' => [
                         [
                             'title' => 'Level 3',
-                            'slug' => 'level-3',
+                            'identifier' => 'level-3',
                             'children' => [],
                         ],
                     ],
@@ -159,11 +159,11 @@ public function testWithNoLevelOneHeading()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [],
                     ],
                 ],
@@ -193,15 +193,15 @@ public function testWithMultipleNestedHeadings()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [
                             [
                                 'title' => 'Level 4',
-                                'slug' => 'level-4',
+                                'identifier' => 'level-4',
                                 'children' => [],
                             ],
                         ],
@@ -210,27 +210,27 @@ public function testWithMultipleNestedHeadings()
             ],
             [
                 'title' => 'Level 2B',
-                'slug' => 'level-2b',
+                'identifier' => 'level-2b',
                 'children' => [
                     [
                         'title' => 'Level 3B',
-                        'slug' => 'level-3b',
+                        'identifier' => 'level-3b',
                         'children' => [],
                     ],
                     [
                         'title' => 'Level 3C',
-                        'slug' => 'level-3c',
+                        'identifier' => 'level-3c',
                         'children' => [],
                     ],
                 ],
             ],
             [
                 'title' => 'Level 2C',
-                'slug' => 'level-2c',
+                'identifier' => 'level-2c',
                 'children' => [
                     [
                         'title' => 'Level 3D',
-                        'slug' => 'level-3d',
+                        'identifier' => 'level-3d',
                         'children' => [],
                     ],
                 ],
@@ -254,22 +254,22 @@ public function testWithMultipleLevelOneHeadings()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [],
                     ],
                 ],
             ],
             [
                 'title' => 'Level 2B',
-                'slug' => 'level-2b',
+                'identifier' => 'level-2b',
                 'children' => [
                     [
                         'title' => 'Level 3B',
-                        'slug' => 'level-3b',
+                        'identifier' => 'level-3b',
                         'children' => [],
                     ],
                 ],
@@ -305,11 +305,11 @@ public function testRespectsMinHeadingLevelConfig()
         $this->assertSame([
             [
                 'title' => 'Level 3',
-                'slug' => 'level-3',
+                'identifier' => 'level-3',
                 'children' => [
                     [
                         'title' => 'Level 4',
-                        'slug' => 'level-4',
+                        'identifier' => 'level-4',
                         'children' => [],
                     ],
                 ],
@@ -335,7 +335,7 @@ public function testRespectsMaxHeadingLevelConfig()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [],
             ],
         ], $result);
@@ -361,11 +361,11 @@ public function testRespectsMinAndMaxHeadingLevelConfig()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [
                     [
                         'title' => 'Level 3',
-                        'slug' => 'level-3',
+                        'identifier' => 'level-3',
                         'children' => [],
                     ],
                 ],
@@ -394,27 +394,27 @@ public function testWithAllHeadingLevels()
         $this->assertSame([
             [
                 'title' => 'Level 1',
-                'slug' => 'level-1',
+                'identifier' => 'level-1',
                 'children' => [
                     [
                         'title' => 'Level 2',
-                        'slug' => 'level-2',
+                        'identifier' => 'level-2',
                         'children' => [
                             [
                                 'title' => 'Level 3',
-                                'slug' => 'level-3',
+                                'identifier' => 'level-3',
                                 'children' => [
                                     [
                                         'title' => 'Level 4',
-                                        'slug' => 'level-4',
+                                        'identifier' => 'level-4',
                                         'children' => [
                                             [
                                                 'title' => 'Level 5',
-                                                'slug' => 'level-5',
+                                                'identifier' => 'level-5',
                                                 'children' => [
                                                     [
                                                         'title' => 'Level 6',
-                                                        'slug' => 'level-6',
+                                                        'identifier' => 'level-6',
                                                         'children' => [],
                                                     ],
                                                 ],
@@ -478,11 +478,11 @@ public function testSetextHeadersWithDifferentConfigLevels()
         $this->assertSame([
             [
                 'title' => 'Level 1',
-                'slug' => 'level-1',
+                'identifier' => 'level-1',
                 'children' => [
                     [
                         'title' => 'Level 2',
-                        'slug' => 'level-2',
+                        'identifier' => 'level-2',
                         'children' => [],
                     ],
                 ],
@@ -516,7 +516,7 @@ public function testEmptyRangeConfig()
         $this->assertSame([
             [
                 'title' => 'Level 2',
-                'slug' => 'level-2',
+                'identifier' => 'level-2',
                 'children' => [],
             ],
         ], $result);

From 9e62334ed88dccb3c8960c0a47115645fcfa76fd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:41:54 +0100
Subject: [PATCH 3652/4023] Invert ternary class logic

---
 .../resources/views/components/docs/table-of-contents.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 67759d24f96..9bf15ee9826 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,7 +1,7 @@
 @props(['items', 'isChild' => false])
 
 @if(! empty($items))
-    <ul class="{{ ! $isChild ? 'table-of-contents pb-3' : 'pl-2' }}">
+    <ul class="{{ $isChild ? 'pl-2' : 'table-of-contents pb-3' }}">
         @foreach($items as $item)
             <li class="my-0.5">
                 <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">

From 6be9c9ddadfab140746eba269dba8c984871bb2f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:42:55 +0100
Subject: [PATCH 3653/4023] Refactor to class directive

---
 .../resources/views/components/docs/table-of-contents.blade.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 9bf15ee9826..3165353ea02 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -1,7 +1,7 @@
 @props(['items', 'isChild' => false])
 
 @if(! empty($items))
-    <ul class="{{ $isChild ? 'pl-2' : 'table-of-contents pb-3' }}">
+    <ul @class([$isChild ? 'pl-2' : 'table-of-contents pb-3'])>
         @foreach($items as $item)
             <li class="my-0.5">
                 <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">

From 7d0d58b1691fc8274c174298e82497bee058caba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:48:53 +0100
Subject: [PATCH 3654/4023] Merge class directive rows into ternary expression

---
 .../resources/views/components/filepath-label.blade.php        | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/resources/views/components/filepath-label.blade.php b/packages/framework/resources/views/components/filepath-label.blade.php
index 2bd7ce88aa5..aaf8a1d88c7 100644
--- a/packages/framework/resources/views/components/filepath-label.blade.php
+++ b/packages/framework/resources/views/components/filepath-label.blade.php
@@ -1,6 +1,5 @@
 @props(['path', 'highlightedByTorchlight' => false])
 <small @class([
     'relative float-right opacity-50 hover:opacity-100 transition-opacity duration-250 not-prose hidden md:block',
-    '-top-1 right-1' => $highlightedByTorchlight,
-    'top-0 right-0' => ! $highlightedByTorchlight,
+    $highlightedByTorchlight ? '-top-1 right-1' : 'top-0 right-0',
 ])><span class="sr-only">Filepath: </span>{{ $path }}</small>
\ No newline at end of file

From b8bbf36097f396982feb65f02ee7e985fd293c36 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:51:30 +0100
Subject: [PATCH 3655/4023] Fix typo

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 94998b93fad..78fc2dccf4d 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -571,7 +571,7 @@ See https://github.com/hydephp/develop/pull/2045 for more information.
 The likelihood of impact is low, but if any of the following are true, you may need to update your code:
 
 - If you have used the `Hyde\Framework\Actions\GeneratesTableOfContents` class in custom code, you will likely need to update that code for the rewritten class.
-- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that message has been removed.
+- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that method has been removed.
 - If you have published the `resources/views/components/docs/sidebar-item.blade.php` component, you will need to update it to call the new component instead of the old generator rendering.
 
 #### Changes

From 1b5113dda84ccce9deebeb5b6d605cce106f1188 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:53:14 +0100
Subject: [PATCH 3656/4023] Swap line order

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 78fc2dccf4d..22e4cf19a37 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -571,8 +571,8 @@ See https://github.com/hydephp/develop/pull/2045 for more information.
 The likelihood of impact is low, but if any of the following are true, you may need to update your code:
 
 - If you have used the `Hyde\Framework\Actions\GeneratesTableOfContents` class in custom code, you will likely need to update that code for the rewritten class.
-- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that method has been removed.
 - If you have published the `resources/views/components/docs/sidebar-item.blade.php` component, you will need to update it to call the new component instead of the old generator rendering.
+- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that method has been removed.
 
 #### Changes
 - Adds a new `resources/views/components/docs/table-of-contents.blade.php` component containing the structure and styles for the table of contents

From b04bff28ce2b0a9b248d256ce2799072a54753b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:57:23 +0100
Subject: [PATCH 3657/4023] Improve formatting

---
 RELEASE_NOTES.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 22e4cf19a37..2fc2b85ca6d 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -572,7 +572,7 @@ The likelihood of impact is low, but if any of the following are true, you may n
 
 - If you have used the `Hyde\Framework\Actions\GeneratesTableOfContents` class in custom code, you will likely need to update that code for the rewritten class.
 - If you have published the `resources/views/components/docs/sidebar-item.blade.php` component, you will need to update it to call the new component instead of the old generator rendering.
-- If you have called the `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as the that method has been removed.
+- If you have called the now removed `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as to possibly call the new Blade component directly, depending on your use case.
 
 #### Changes
 - Adds a new `resources/views/components/docs/table-of-contents.blade.php` component containing the structure and styles for the table of contents

From b195b2f317383900c3a1dd5bd9005a0ab2048d4d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 20:58:52 +0100
Subject: [PATCH 3658/4023] Breaking: Remove
 `DocumentationPage::hasTableOfContents` method

---
 RELEASE_NOTES.md                                      |  2 ++
 .../hyde-pages-api/documentation-page-methods.md      |  8 --------
 packages/framework/src/Pages/DocumentationPage.php    | 10 ----------
 .../framework/tests/Feature/DocumentationPageTest.php | 11 -----------
 4 files changed, 2 insertions(+), 29 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2fc2b85ca6d..9ba8dcbde0c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -118,6 +118,7 @@ This serves two purposes:
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Breaking: Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents in https://github.com/hydephp/develop/pull/2045
+- Breaking: Removed the `DocumentationPage::hasTableOfContents()` method as it is now unused by the framework in https://github.com/hydephp/develop/pull/2006
 - Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
 - Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
 - Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
@@ -573,6 +574,7 @@ The likelihood of impact is low, but if any of the following are true, you may n
 - If you have used the `Hyde\Framework\Actions\GeneratesTableOfContents` class in custom code, you will likely need to update that code for the rewritten class.
 - If you have published the `resources/views/components/docs/sidebar-item.blade.php` component, you will need to update it to call the new component instead of the old generator rendering.
 - If you have called the now removed `getTableOfContents` method of the `DocumentationPage` class in custom code, you will need to update that usage as to possibly call the new Blade component directly, depending on your use case.
+- If you have called the now removed `hasTableOfContents` method of the `DocumentationPage` class in custom code you will need to replace the method call with `Config::getBool('docs.sidebar.table_of_contents.enabled', true)`
 
 #### Changes
 - Adds a new `resources/views/components/docs/table-of-contents.blade.php` component containing the structure and styles for the table of contents
diff --git a/docs/_data/partials/hyde-pages-api/documentation-page-methods.md b/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
index 5de3bf6f58d..31b50835012 100644
--- a/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
+++ b/docs/_data/partials/hyde-pages-api/documentation-page-methods.md
@@ -19,14 +19,6 @@ No description provided.
 DocumentationPage::homeRouteName(): string
 ```
 
-#### `hasTableOfContents()`
-
-No description provided.
-
-```php
-DocumentationPage::hasTableOfContents(): bool
-```
-
 #### `getOnlineSourcePath()`
 
 No description provided.
diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index 9b52c039834..4eb092b28ca 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -48,16 +48,6 @@ public function getOnlineSourcePath(): string|false
         return sprintf('%s/%s.md', trim(Config::getString('docs.source_file_location_base'), '/'), $this->identifier);
     }
 
-    /**
-     * @todo Remove unused method?
-     *
-     * @deprecated This is unused anc could be replaced by using the config directly.
-     */
-    public static function hasTableOfContents(): bool
-    {
-        return Config::getBool('docs.sidebar.table_of_contents.enabled', true);
-    }
-
     /**
      * Get the route key for the page.
      *
diff --git a/packages/framework/tests/Feature/DocumentationPageTest.php b/packages/framework/tests/Feature/DocumentationPageTest.php
index 47ad876ea1a..17119c2f37d 100644
--- a/packages/framework/tests/Feature/DocumentationPageTest.php
+++ b/packages/framework/tests/Feature/DocumentationPageTest.php
@@ -195,17 +195,6 @@ public function testHomeRouteNameMethodReturnsCustomizedOutputDirectorySlashInde
         $this->assertSame('foo/bar/index', DocumentationPage::homeRouteName());
     }
 
-    public function testHasTableOfContents()
-    {
-        $this->assertIsBool(DocumentationPage::hasTableOfContents());
-
-        Config::set('docs.sidebar.table_of_contents.enabled', true);
-        $this->assertTrue(DocumentationPage::hasTableOfContents());
-
-        Config::set('docs.sidebar.table_of_contents.enabled', false);
-        $this->assertFalse(DocumentationPage::hasTableOfContents());
-    }
-
     public function testCompiledPagesOriginatingInSubdirectoriesGetOutputToRootDocsPath()
     {
         $page = DocumentationPage::make('foo/bar');

From 17fa356faf382ecde178e82020faafab0a3a2d31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:10:13 +0100
Subject: [PATCH 3659/4023] Slimmer formatting for single line annotations

---
 .../Actions/GeneratesTableOfContents.php      | 36 +++++--------------
 1 file changed, 9 insertions(+), 27 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index ca06d36a3a0..8f8b605c215 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -26,17 +26,13 @@ public function __construct(Markdown|string $markdown)
         $this->maxHeadingLevel = Config::getInt('docs.sidebar.table_of_contents.max_heading_level', 4);
     }
 
-    /**
-     * @return array<int, array{title: string, identifier: string, children: array}>
-     */
+    /** @return array<int, array{title: string, identifier: string, children: array}> */
     public function execute(): array
     {
         return $this->buildTableOfContents($this->parseHeadings());
     }
 
-    /**
-     * @return array<int, array{level: int, title: string, identifier: string}>
-     */
+    /** @return array<int, array{level: int, title: string, identifier: string}> */
     protected function parseHeadings(): array
     {
         $matches = $this->matchHeadingPatterns();
@@ -55,9 +51,7 @@ protected function parseHeadings(): array
         return $headings;
     }
 
-    /**
-     * @return array{0: array<int, string>, 1: array<int, string>, 2: array<int, string>, 3: array<int, string>}
-     */
+    /** @return array{0: array<int, string>, 1: array<int, string>, 2: array<int, string>, 3: array<int, string>} */
     protected function matchHeadingPatterns(): array
     {
         // Match both ATX-style (###) and Setext-style (===, ---) headers
@@ -80,9 +74,7 @@ protected function parseHeadingData(string $heading, array $matches, int $index)
         return $this->parseSetextHeading($matches[2][$index], $matches[3][$index]);
     }
 
-    /**
-     * @return array{level: int, title: string}
-     */
+    /** @return array{level: int, title: string} */
     protected function parseAtxHeading(string $heading, string $title): array
     {
         return [
@@ -91,9 +83,7 @@ protected function parseAtxHeading(string $heading, string $title): array
         ];
     }
 
-    /**
-     * @return array{level: int, title: string}|null
-     */
+    /** @return array{level: int, title: string}|null */
     protected function parseSetextHeading(string $title, string $marker): ?array
     {
         $level = $marker === '=' ? 1 : 2;
@@ -144,9 +134,7 @@ protected function buildTableOfContents(array $headings): array
         return $items;
     }
 
-    /**
-     * @param  array{level: int, title: string, identifier: string}  $heading
-     */
+    /** @param array{level: int, title: string, identifier: string}  $heading */
     protected function isHeadingWithinBounds(array $heading): bool
     {
         return $heading['level'] >= $this->minHeadingLevel &&
@@ -166,9 +154,7 @@ protected function createTableItem(array $heading): array
         ];
     }
 
-    /**
-     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
-     */
+    /** @param  array<int, array<int, array{title: string, identifier: string, children: array}>> $stack */
     protected function updateStackForHeadingLevel(array &$stack, int $currentLevel, int $previousLevel): void
     {
         if ($currentLevel > $previousLevel) {
@@ -180,9 +166,7 @@ protected function updateStackForHeadingLevel(array &$stack, int $currentLevel,
         }
     }
 
-    /**
-     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
-     */
+    /** @param array<int, array<int, array{title: string, identifier: string, children: array}>> $stack */
     protected function nestNewLevel(array &$stack): void
     {
         $lastStackIndex = count($stack) - 1;
@@ -191,9 +175,7 @@ protected function nestNewLevel(array &$stack): void
         $stack[] = &$stack[$lastStackIndex][$lastItemIndex]['children'];
     }
 
-    /**
-     * @param  array<int, array<int, array{title: string, identifier: string, children: array}>>  $stack
-     */
+    /** @param array<int, array<int, array{title: string, identifier: string, children: array}>> $stack */
     protected function unwindStack(array &$stack, int $currentLevel): void
     {
         array_splice($stack, $currentLevel - $this->minHeadingLevel + 1);

From af9dd9ef4ec09f73486fa5d9242f7b98a7dc629f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:20:47 +0100
Subject: [PATCH 3660/4023] Invert and merge control flow

---
 .../src/Framework/Actions/GeneratesTableOfContents.php      | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 8f8b605c215..0c24ef24ec7 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -41,11 +41,9 @@ protected function parseHeadings(): array
         foreach ($matches[0] as $index => $heading) {
             $headingData = $this->parseHeadingData($heading, $matches, $index);
 
-            if ($headingData === null) {
-                continue;
+            if ($headingData !== null) {
+                $headings[] = $this->createHeadingEntry($headingData);
             }
-
-            $headings[] = $this->createHeadingEntry($headingData);
         }
 
         return $headings;

From 3f77d0cffeaef49256637d3ba7dba8e0dd943583 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:21:50 +0100
Subject: [PATCH 3661/4023] Add spacing

---
 .../framework/src/Framework/Actions/GeneratesTableOfContents.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index 0c24ef24ec7..f1457712b5a 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -54,6 +54,7 @@ protected function matchHeadingPatterns(): array
     {
         // Match both ATX-style (###) and Setext-style (===, ---) headers
         $pattern = '/^(?:#{1,6}\s+(.+)|(.+)\n([=\-])\3+)$/m';
+
         preg_match_all($pattern, $this->markdown, $matches);
 
         return $matches;

From 6487ee1378c87bba2e94340af7cecad95d0cb25a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:32:01 +0100
Subject: [PATCH 3662/4023] Clarify removal reason

---
 packages/framework/src/Facades/HydeFront.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index a87f2c6f28d..aa3a6d39e90 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -39,7 +39,7 @@ public static function version(): string
      *
      * @deprecated This method may be removed before the final v2.0 release as there is now currently only one file available.
      *
-     * @todo Remove the method before the final v2.0 release.
+     * @todo Remove the method before the final v2.0 release. This is not a super breaking change as this entire class was added in 2.x, and was ported from the Asset facade.
      *
      * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
      */

From bae76b21a1f8b1adfb6a017b0e2d27ee396ed2c0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:34:45 +0100
Subject: [PATCH 3663/4023] Remove parameter from `HydeFront::cdnLink()`

In HydePHP v2 and HydeFront v4 there is only one file, so we no longer need this parameter as it will never be useful for anything else than `app.css`.
---
 packages/framework/src/Facades/HydeFront.php     |  8 +++-----
 .../tests/Unit/Facades/HydeFrontFacadeTest.php   | 16 ++--------------
 2 files changed, 5 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index aa3a6d39e90..085efcf4a6c 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -33,9 +33,7 @@ public static function version(): string
     }
 
     /**
-     * Get the CDN link for a specific file.
-     *
-     * @param  'app.css'  $file
+     * Get the CDN link for the HydeFront CSS file.
      *
      * @deprecated This method may be removed before the final v2.0 release as there is now currently only one file available.
      *
@@ -43,9 +41,9 @@ public static function version(): string
      *
      * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
      */
-    public static function cdnLink(string $file): string
+    public static function cdnLink(): string
     {
-        return sprintf(static::HYDEFRONT_CDN_URL, static::version(), $file);
+        return sprintf(static::HYDEFRONT_CDN_URL, static::version(), 'app.css');
     }
 
     /** This method is used to inject the project's Tailwind CSS configuration into the Play CDN integration so it can match the styles. */
diff --git a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
index a5af3c68d29..965a6f6b817 100644
--- a/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/HydeFrontFacadeTest.php
@@ -35,20 +35,8 @@ public function testVersionReturnsString()
 
     public function testCdnLinkReturnsCorrectUrl()
     {
-        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/styles.css';
-        $this->assertSame($expected, HydeFront::cdnLink('styles.css'));
-    }
-
-    public function testCdnLinkReturnsCorrectUrlForArbitraryCss()
-    {
-        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/arbitrary.css';
-        $this->assertSame($expected, HydeFront::cdnLink('arbitrary.css'));
-    }
-
-    public function testCdnLinkReturnsCorrectUrlForInvalidFile()
-    {
-        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/invalid';
-        $this->assertSame($expected, HydeFront::cdnLink('invalid'));
+        $expected = 'https://cdn.jsdelivr.net/npm/hydefront@v3.4/dist/app.css';
+        $this->assertSame($expected, HydeFront::cdnLink());
     }
 
     public function testInjectTailwindConfigReturnsExtractedTailwindConfig()

From 11634c070fc47b4e90dbb33c8e976fed23a213eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:38:41 +0100
Subject: [PATCH 3664/4023] Remove deprecation

Was considering renaming it, but I could not really find a better method name
---
 packages/framework/src/Facades/HydeFront.php | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/packages/framework/src/Facades/HydeFront.php b/packages/framework/src/Facades/HydeFront.php
index 085efcf4a6c..ed1dd511888 100644
--- a/packages/framework/src/Facades/HydeFront.php
+++ b/packages/framework/src/Facades/HydeFront.php
@@ -32,15 +32,7 @@ public static function version(): string
         return static::HYDEFRONT_VERSION;
     }
 
-    /**
-     * Get the CDN link for the HydeFront CSS file.
-     *
-     * @deprecated This method may be removed before the final v2.0 release as there is now currently only one file available.
-     *
-     * @todo Remove the method before the final v2.0 release. This is not a super breaking change as this entire class was added in 2.x, and was ported from the Asset facade.
-     *
-     * @link https://cdn.jsdelivr.net/npm/hydefront@latest/dist/ for the available files.
-     */
+    /** Get the CDN link for the HydeFront CSS file. This will return the default `app.css` file. */
     public static function cdnLink(): string
     {
         return sprintf(static::HYDEFRONT_CDN_URL, static::version(), 'app.css');

From 0987ac05641841e9661f10d9e7807b1560a98630 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:43:00 +0100
Subject: [PATCH 3665/4023] Inline local variable

---
 packages/framework/src/Framework/Services/MarkdownService.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index f570e9f4ab1..fc6230b762c 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -245,7 +245,6 @@ protected static function findLineContentPositions(array $lines): array
 
     protected function configureCustomHeadingRenderer(): void
     {
-        $environment = $this->converter->getEnvironment();
-        $environment->addRenderer(Heading::class, new HeadingRenderer($this->pageClass, $this->headingRegistry));
+        $this->converter->getEnvironment()->addRenderer(Heading::class, new HeadingRenderer($this->pageClass, $this->headingRegistry));
     }
 }

From 57334a5560050fc7ba4bbbe93699b0b1b5f900ba Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:43:15 +0100
Subject: [PATCH 3666/4023] Clean up formatting

---
 packages/framework/src/Framework/Services/MarkdownService.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Services/MarkdownService.php b/packages/framework/src/Framework/Services/MarkdownService.php
index fc6230b762c..a8b24a42cc8 100644
--- a/packages/framework/src/Framework/Services/MarkdownService.php
+++ b/packages/framework/src/Framework/Services/MarkdownService.php
@@ -245,6 +245,8 @@ protected static function findLineContentPositions(array $lines): array
 
     protected function configureCustomHeadingRenderer(): void
     {
-        $this->converter->getEnvironment()->addRenderer(Heading::class, new HeadingRenderer($this->pageClass, $this->headingRegistry));
+        $this->converter->getEnvironment()->addRenderer(Heading::class,
+            new HeadingRenderer($this->pageClass, $this->headingRegistry)
+        );
     }
 }

From 801d9debe4d85132db65e0f3a7c1f67ec7cc5735 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:48:57 +0100
Subject: [PATCH 3667/4023] Extract methods from complex inner loop

---
 .../Processing/CodeblockFilepathProcessor.php | 32 +++++++++++++------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index 8ed390d404d..e98d97316a4 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -76,25 +76,39 @@ public static function preprocess(string $markdown): string
     public static function postprocess(string $html): string
     {
         $lines = explode("\n", $html);
+        $highlightedByTorchlight = str_contains($html, static::$torchlightKey);
 
         /** @var int $index */
         foreach ($lines as $index => $line) {
             if (str_starts_with($line, '<!-- HYDE[Filepath]')) {
-                $highlightedByTorchlight = str_contains($html, static::$torchlightKey);
-                $path = static::trimHydeDirective($line);
-                unset($lines[$index]);
-                $codeBlockLine = $index + 1;
-                $label = static::resolveTemplate($path, $highlightedByTorchlight);
-
-                $lines[$codeBlockLine] = $highlightedByTorchlight
-                    ? static::injectLabelToTorchlightCodeLine($label, $lines[$codeBlockLine])
-                    : static::injectLabelToCodeLine($label, $lines[$codeBlockLine]);
+                $lines = static::processFilepathLine($lines, $index, $highlightedByTorchlight);
             }
         }
 
         return implode("\n", $lines);
     }
 
+    protected static function processFilepathLine(array $lines, int $index, bool $highlightedByTorchlight): array
+    {
+        $path = static::trimHydeDirective($lines[$index]);
+
+        unset($lines[$index]);
+
+        $codeBlockLine = $index + 1;
+        $label = static::resolveTemplate($path, $highlightedByTorchlight);
+
+        $lines[$codeBlockLine] = static::injectLabel($label, $lines[$codeBlockLine], $highlightedByTorchlight);
+
+        return $lines;
+    }
+
+    protected static function injectLabel(string $label, string $line, bool $highlightedByTorchlight): string
+    {
+        return $highlightedByTorchlight
+            ? static::injectLabelToTorchlightCodeLine($label, $line)
+            : static::injectLabelToCodeLine($label, $line);
+    }
+
     protected static function lineMatchesPattern(string $line): bool
     {
         foreach (static::$patterns as $pattern) {

From 4fd21b69912d91ddcbae2eda2da43e95f0b42dc0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:50:41 +0100
Subject: [PATCH 3668/4023] Cleanup code

---
 .../src/Markdown/Processing/CodeblockFilepathProcessor.php   | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index e98d97316a4..8b486a8fc0b 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -91,12 +91,11 @@ public static function postprocess(string $html): string
     protected static function processFilepathLine(array $lines, int $index, bool $highlightedByTorchlight): array
     {
         $path = static::trimHydeDirective($lines[$index]);
+        $label = static::resolveTemplate($path, $highlightedByTorchlight);
+        $codeBlockLine = $index + 1;
 
         unset($lines[$index]);
 
-        $codeBlockLine = $index + 1;
-        $label = static::resolveTemplate($path, $highlightedByTorchlight);
-
         $lines[$codeBlockLine] = static::injectLabel($label, $lines[$codeBlockLine], $highlightedByTorchlight);
 
         return $lines;

From b01e9eabb049f988bd6f6f15097e155eadc2f890 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 21:54:05 +0100
Subject: [PATCH 3669/4023] Add todo

---
 .../src/Markdown/Processing/CodeblockFilepathProcessor.php      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
index 8b486a8fc0b..322e8334a24 100644
--- a/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
+++ b/packages/framework/src/Markdown/Processing/CodeblockFilepathProcessor.php
@@ -24,6 +24,8 @@
 
 /**
  * Resolves file path comments found in Markdown code blocks into a neat badge shown in the top right corner.
+ *
+ * @todo See about replacing this with a custom Codeblock Blade view that can be customized, even supporting click to copy buttons or arbitrary other features.
  */
 class CodeblockFilepathProcessor implements MarkdownPreProcessorContract, MarkdownPostProcessorContract
 {

From 70a572b06906641794660125f138028ae3fac6d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 8 Dec 2024 22:00:25 +0100
Subject: [PATCH 3670/4023] Fix formatting

---
 RELEASE_NOTES.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9ba8dcbde0c..2e7dc862e12 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -100,13 +100,13 @@ This serves two purposes:
 - **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
 - Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
 - Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
-  - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
-  - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
+    - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
+    - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
 - Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
 - Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
 - Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
 - Markdown headings are now compiled using our custom Blade-based heading renderer in https://github.com/hydephp/develop/pull/2047
-  - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
+    - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
 - Colored Markdown blockquotes are now rendered using Blade and TailwindCSS, this change is not visible in the rendered result, but the HTML output has changed in https://github.com/hydephp/develop/pull/2056
 
 ### Deprecated
@@ -134,7 +134,7 @@ This serves two purposes:
 - Removed Laravel Mix as a dependency in https://github.com/hydephp/develop/pull/2010 (replaced with Vite)
 - **Breaking:** Removed `npm run prod` command (replaced with `npm run build`)
 - Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
-  - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
+    - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
 - Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
 - Removed The `hyde.css` file from HydeFront in https://github.com/hydephp/develop/pull/2037 as all styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024.
 - Removed the `MarkdownService::withPermalinks` method in https://github.com/hydephp/develop/pull/2047

From 0841928156ee5c9f134b2a8129eef09e785ce06b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 9 Dec 2024 10:39:20 +0100
Subject: [PATCH 3671/4023] Debug workflow issue

---
 .../deploy-documentation-preview.yml          | 27 -------------------
 1 file changed, 27 deletions(-)

diff --git a/.github/workflows/deploy-documentation-preview.yml b/.github/workflows/deploy-documentation-preview.yml
index 3b5f8ce9e2a..98f6c1c5dc6 100644
--- a/.github/workflows/deploy-documentation-preview.yml
+++ b/.github/workflows/deploy-documentation-preview.yml
@@ -46,33 +46,6 @@ jobs:
         run: |
           mkdir -p resources/views/vendor/hyde/layouts
           cp vendor/hyde/framework/resources/views/layouts/docs.blade.php resources/views/vendor/hyde/layouts/docs.blade.php
-          cat <<- HTML >> resources/views/vendor/hyde/layouts/docs.blade.php
-            <style>.font-bold{font-weight: 700;}.text-lg{font-size: 1.125rem; line-height: 1.75rem;}.mr-3{margin-right: 0.75rem rem ;}.mb-2{margin-bottom: 0.5rem;}.mr-3{margin-right: 0.75rem;}.text-gray-400{--tw-text-opacity: 1; color: rgb(156 163 175 / var(--tw-text-opacity));}.mx-0\.5{margin-left: 0.125rem; margin-right: 0.125rem;}</style>
-            <aside class="fixed bottom-4 right-4 z-50 hidden md:block">
-              <div class="bg-white dark:bg-gray-800 rounded-lg shadow-lg p-4">
-                <header class="flex flex-row nowrap items-center justify-between">
-                    <h3 class="text-lg font-bold mb-2 mr-3 flex">Documentation preview for&nbsp; <a href="${{ github.event.pull_request.html_url }}" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">PR #${{ github.event.pull_request.number }}</a> &nbsp;
-                        <small class="opacity-75">(#<a href="https://github.com/hydephp/develop/commit/${{ github.event.pull_request.head.sha }}"><span style=" display: inline-flex; font-family: monospace; width: 7ch; white-space: nowrap; overflow: hidden; text-overflow: clip;">${{ github.event.pull_request.head.sha }}</span></a>)</small>
-                    </h3>
-                    <small class="mb-2">
-                        <a href="${{ github.event.pull_request.html_url }}" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">Back to PR</a>
-                        <span class="text-gray-400 mx-0.5">|</span>
-                        <a href="${{ github.event.pull_request.html_url }}/files?file-filters%5B%5D=.md" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">View Diff</a>
-                    </small>
-                </header>
-                <p class="prose dark:prose-invert">
-                  You are browsing the documentation for a user-contributed pull request.<br>
-                  <small>Contents may be inaccurate or incomplete, and not representative of the organization.</small><br>
-                 </p>
-              </div>
-            </aside>
-
-            <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/styles/dark.min.css">
-            <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/highlight.min.js"></script>
-            <script>hljs.highlightAll();</script>
-            <style>.prose :where(pre):not(:where([class~=not-prose] *)) { background-color: #303030 } </style>
-            <style>pre code.hljs { padding: 0; }</style>
-          HTML
 
       - name: Configure environment variables
         run: |

From 8c7bc012fe66aff51a6a056d662faff03c61ce1e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 9 Dec 2024 10:39:25 +0100
Subject: [PATCH 3672/4023] Revert "Debug workflow issue"

This reverts commit 0841928156ee5c9f134b2a8129eef09e785ce06b.
---
 .../deploy-documentation-preview.yml          | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/.github/workflows/deploy-documentation-preview.yml b/.github/workflows/deploy-documentation-preview.yml
index 98f6c1c5dc6..3b5f8ce9e2a 100644
--- a/.github/workflows/deploy-documentation-preview.yml
+++ b/.github/workflows/deploy-documentation-preview.yml
@@ -46,6 +46,33 @@ jobs:
         run: |
           mkdir -p resources/views/vendor/hyde/layouts
           cp vendor/hyde/framework/resources/views/layouts/docs.blade.php resources/views/vendor/hyde/layouts/docs.blade.php
+          cat <<- HTML >> resources/views/vendor/hyde/layouts/docs.blade.php
+            <style>.font-bold{font-weight: 700;}.text-lg{font-size: 1.125rem; line-height: 1.75rem;}.mr-3{margin-right: 0.75rem rem ;}.mb-2{margin-bottom: 0.5rem;}.mr-3{margin-right: 0.75rem;}.text-gray-400{--tw-text-opacity: 1; color: rgb(156 163 175 / var(--tw-text-opacity));}.mx-0\.5{margin-left: 0.125rem; margin-right: 0.125rem;}</style>
+            <aside class="fixed bottom-4 right-4 z-50 hidden md:block">
+              <div class="bg-white dark:bg-gray-800 rounded-lg shadow-lg p-4">
+                <header class="flex flex-row nowrap items-center justify-between">
+                    <h3 class="text-lg font-bold mb-2 mr-3 flex">Documentation preview for&nbsp; <a href="${{ github.event.pull_request.html_url }}" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">PR #${{ github.event.pull_request.number }}</a> &nbsp;
+                        <small class="opacity-75">(#<a href="https://github.com/hydephp/develop/commit/${{ github.event.pull_request.head.sha }}"><span style=" display: inline-flex; font-family: monospace; width: 7ch; white-space: nowrap; overflow: hidden; text-overflow: clip;">${{ github.event.pull_request.head.sha }}</span></a>)</small>
+                    </h3>
+                    <small class="mb-2">
+                        <a href="${{ github.event.pull_request.html_url }}" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">Back to PR</a>
+                        <span class="text-gray-400 mx-0.5">|</span>
+                        <a href="${{ github.event.pull_request.html_url }}/files?file-filters%5B%5D=.md" class="dark:text-indigo-400 text-indigo-500 hover:text-indigo-600">View Diff</a>
+                    </small>
+                </header>
+                <p class="prose dark:prose-invert">
+                  You are browsing the documentation for a user-contributed pull request.<br>
+                  <small>Contents may be inaccurate or incomplete, and not representative of the organization.</small><br>
+                 </p>
+              </div>
+            </aside>
+
+            <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/styles/dark.min.css">
+            <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11.7.0/build/highlight.min.js"></script>
+            <script>hljs.highlightAll();</script>
+            <style>.prose :where(pre):not(:where([class~=not-prose] *)) { background-color: #303030 } </style>
+            <style>pre code.hljs { padding: 0; }</style>
+          HTML
 
       - name: Configure environment variables
         run: |

From ddb899e194d77c49d5e6ec2ad47da015cb744ad0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 9 Dec 2024 10:41:23 +0100
Subject: [PATCH 3673/4023] Debug workflow issue

---
 .../views/components/docs/table-of-contents.blade.php          | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 3165353ea02..000acadb909 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -3,6 +3,9 @@
 @if(! empty($items))
     <ul @class([$isChild ? 'pl-2' : 'table-of-contents pb-3'])>
         @foreach($items as $item)
+            @if(! isset($item['identifier']))
+                @dd($item);
+            @endif
             <li class="my-0.5">
                 <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
                     <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>

From 59fc714aae9e45825418523c58ed590ce18435a9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 9 Dec 2024 14:11:29 +0100
Subject: [PATCH 3674/4023] Revert "Debug workflow issue"

This reverts commit ddb899e194d77c49d5e6ec2ad47da015cb744ad0.
---
 .../views/components/docs/table-of-contents.blade.php          | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 000acadb909..3165353ea02 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -3,9 +3,6 @@
 @if(! empty($items))
     <ul @class([$isChild ? 'pl-2' : 'table-of-contents pb-3'])>
         @foreach($items as $item)
-            @if(! isset($item['identifier']))
-                @dd($item);
-            @endif
             <li class="my-0.5">
                 <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
                     <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>

From 7092df68b75f7044e64072884cf071395b960458 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 12:07:05 +0100
Subject: [PATCH 3675/4023] Skip empty identifiers to allow just child items

Required if headings don't follow a sensible order
---
 .../docs/table-of-contents.blade.php          | 10 ++--
 .../Views/SidebarTableOfContentsViewTest.php  | 56 +++++++++++++++++++
 .../GeneratesSidebarTableOfContentsTest.php   | 24 ++++++++
 3 files changed, 86 insertions(+), 4 deletions(-)

diff --git a/packages/framework/resources/views/components/docs/table-of-contents.blade.php b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
index 3165353ea02..ba9bdeb1741 100644
--- a/packages/framework/resources/views/components/docs/table-of-contents.blade.php
+++ b/packages/framework/resources/views/components/docs/table-of-contents.blade.php
@@ -4,10 +4,12 @@
     <ul @class([$isChild ? 'pl-2' : 'table-of-contents pb-3'])>
         @foreach($items as $item)
             <li class="my-0.5">
-                <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
-                    <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>
-                    {{ $item['title'] }}
-                </a>
+                @if(isset($item['identifier']))
+                    <a href="#{{ $item['identifier'] }}" class="-ml-8 pl-8 opacity-80 hover:opacity-100 hover:bg-gray-200/20 transition-all duration-300">
+                        <span class="text-[75%] opacity-50 hover:opacity-100 transition-opacity duration-300">#</span>
+                        {{ $item['title'] }}
+                    </a>
+                @endif
 
                 @if(! empty($item['children']))
                     <x-hyde::docs.table-of-contents :items="$item['children']" :isChild="true" />
diff --git a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
index 5f1e09c5833..5db1fcb4b90 100644
--- a/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
+++ b/packages/framework/tests/Feature/Views/SidebarTableOfContentsViewTest.php
@@ -90,6 +90,62 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
         );
     }
 
+    public function testCanGenerateTableOfContentsWithNonLogicalHeadingOrder()
+    {
+        $markdown = <<<'MARKDOWN'
+        # Level 1
+        ### Level 3
+        #### Level 4
+        ## Level 2
+        # Level 1B
+        ### Level 3B
+        MARKDOWN;
+
+        $result = $this->render($markdown);
+
+        $this->assertIsString($result);
+
+        $this->assertHtmlStructure(<<<'HTML'
+            <ul class="table-of-contents">
+              <li>
+                <ul>
+                  <li>
+                    <a href="#level-3">
+                      <span>#</span>
+                      Level 3
+                    </a>
+                    <ul>
+                      <li>
+                        <a href="#level-4">
+                          <span>#</span>
+                          Level 4
+                        </a>
+                      </li>
+                    </ul>
+                  </li>
+                </ul>
+              </li>
+              <li>
+                <a href="#level-2">
+                  <span>#</span>
+                  Level 2
+                </a>
+              </li>
+              <li>
+                <ul>
+                  <li>
+                    <a href="#level-3b">
+                      <span>#</span>
+                      Level 3B
+                    </a>
+                  </li>
+                </ul>
+              </li>
+            </ul>
+            HTML, $result
+        );
+    }
+
     public function testNonHeadingMarkdownIsRemoved()
     {
         $expected = <<<'MARKDOWN'
diff --git a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
index 32952775d32..e340e1bf142 100644
--- a/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
+++ b/packages/framework/tests/Unit/GeneratesSidebarTableOfContentsTest.php
@@ -107,6 +107,30 @@ public function testCanGenerateTableOfContentsForDocumentUsingSetextHeaders()
         );
     }
 
+    public function testCanGenerateTableOfContentsWithNonLogicalHeadingOrder()
+    {
+        $markdown = "# Level 1\n### Level 3\n#### Level 4\n";
+        $result = (new GeneratesTableOfContents($markdown))->execute();
+
+        $this->assertSame([
+            [
+                'children' => [
+                    [
+                        'title' => 'Level 3',
+                        'identifier' => 'level-3',
+                        'children' => [
+                            [
+                                'title' => 'Level 4',
+                                'identifier' => 'level-4',
+                                'children' => [],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ], $result);
+    }
+
     public function testNonHeadingMarkdownIsIgnored()
     {
         $expected = <<<'MARKDOWN'

From 8c11d3978a761295bef496b73d33ae5a2fc39f05 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 12:43:44 +0100
Subject: [PATCH 3676/4023] Reset array keys

---
 .../src/Framework/Actions/GeneratesTableOfContents.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
index f1457712b5a..45ade6461f1 100644
--- a/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
+++ b/packages/framework/src/Framework/Actions/GeneratesTableOfContents.php
@@ -130,7 +130,7 @@ protected function buildTableOfContents(array $headings): array
             }
         }
 
-        return $items;
+        return array_values($items);
     }
 
     /** @param array{level: int, title: string, identifier: string}  $heading */

From 396bfe5dbf39657dd5139cf8ea4e4aa2de67a1aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:21:02 +0100
Subject: [PATCH 3677/4023] Update signature to include interactive flag

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 46ef8d6c1be..a9f6472db13 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -17,7 +17,7 @@
 class PublishViewsCommand extends Command
 {
     /** @var string */
-    protected $signature = 'publish:views {category? : The category to publish}';
+    protected $signature = 'publish:views {category? : The category to publish} {--interactive|-i : Interactively select the views to publish}';
 
     /** @var string */
     protected $description = 'Publish the hyde components for customization. Note that existing files will be overwritten';

From bdf1d4bafd0e142acad534b5e7423fdbd575598b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:23:15 +0100
Subject: [PATCH 3678/4023] Fix shortcut syntax

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index a9f6472db13..53fe0e8bcd6 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -17,7 +17,7 @@
 class PublishViewsCommand extends Command
 {
     /** @var string */
-    protected $signature = 'publish:views {category? : The category to publish} {--interactive|-i : Interactively select the views to publish}';
+    protected $signature = 'publish:views {category? : The category to publish} {--i|interactive : Interactively select the views to publish}';
 
     /** @var string */
     protected $description = 'Publish the hyde components for customization. Note that existing files will be overwritten';

From 07d46fc9d2970b8cf59b2e78decb11c3e00ca03d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:23:21 +0100
Subject: [PATCH 3679/4023] Add helper method

---
 .../framework/src/Console/Commands/PublishViewsCommand.php   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 53fe0e8bcd6..de9f9b1a2ac 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -56,6 +56,11 @@ public function handle(): int
         return Command::SUCCESS;
     }
 
+    protected function isInteractive(): bool
+    {
+        return $this->option('interactive');
+    }
+
     protected function publishOption(string $selected): void
     {
         Artisan::call('vendor:publish', [

From b22a7e8a8f576a9445d602d874262da41f8d3bfe Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:24:46 +0100
Subject: [PATCH 3680/4023] Draft outline for interactive publish

---
 .../src/Console/Commands/PublishViewsCommand.php      | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index de9f9b1a2ac..700fdd5cffe 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -50,6 +50,12 @@ public function handle(): int
                 $this->publishOption($key);
             }
         } else {
+            if ($selected === 'components' && $this->isInteractive()) {
+                $this->handleInteractivePublish();
+
+                return Command::SUCCESS;
+            }
+
             $this->publishOption($selected);
         }
 
@@ -99,4 +105,9 @@ protected function parseChoiceIntoKey(string $choice): string
     {
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
+
+    protected function handleInteractivePublish(): void
+    {
+        //
+    }
 }

From 0ff87fd9f7a2d8484d13de073c51801e279473e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:44:35 +0100
Subject: [PATCH 3681/4023] First pass at collecting and formatting publish
 paths

---
 .../Console/Commands/PublishViewsCommand.php  | 24 ++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 700fdd5cffe..71bac636dec 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -5,8 +5,13 @@
 namespace Hyde\Console\Commands;
 
 use Hyde\Console\Concerns\Command;
+use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Hyde;
 use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\ServiceProvider;
 
+use function Hyde\path_join;
 use function str_replace;
 use function sprintf;
 use function strstr;
@@ -108,6 +113,23 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function handleInteractivePublish(): void
     {
-        //
+        // Initially only works for components
+
+        // Get all files in the components tag
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, 'hyde-components');
+        $source = key($paths);
+        $target = $paths[$source];
+
+        $sourceBaseDir = basename($source);
+        $targetBaseDir = basename($target);
+
+        // Now we need an array that maps all source files to their target paths retaining the directory structure
+        $search = File::allFiles($source);
+
+        $files = collect($search)->mapWithKeys(function (\Symfony\Component\Finder\SplFileInfo $file) use ($source, $target, $sourceBaseDir, $targetBaseDir) {
+            $targetPath =  path_join($target, $file->getRelativePathname());
+
+            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
+        });
     }
 }

From 73bcf9f8ee6e0caf3b8c5636fb84817d3d433d61 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 14:45:13 +0100
Subject: [PATCH 3682/4023] Cleanup code

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 71bac636dec..bc02f91b5f0 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -10,6 +10,7 @@
 use Illuminate\Support\Facades\Artisan;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\ServiceProvider;
+use Symfony\Component\Finder\SplFileInfo;
 
 use function Hyde\path_join;
 use function str_replace;
@@ -120,14 +121,11 @@ protected function handleInteractivePublish(): void
         $source = key($paths);
         $target = $paths[$source];
 
-        $sourceBaseDir = basename($source);
-        $targetBaseDir = basename($target);
-
         // Now we need an array that maps all source files to their target paths retaining the directory structure
         $search = File::allFiles($source);
 
-        $files = collect($search)->mapWithKeys(function (\Symfony\Component\Finder\SplFileInfo $file) use ($source, $target, $sourceBaseDir, $targetBaseDir) {
-            $targetPath =  path_join($target, $file->getRelativePathname());
+        $files = collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file) use ($target): array {
+            $targetPath = path_join($target, $file->getRelativePathname());
 
             return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
         });

From ff5757fe0c76d5ba71178cf01b082bccb929b21d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 15:07:11 +0100
Subject: [PATCH 3683/4023] Prompt for files

---
 .../Console/Commands/PublishViewsCommand.php  | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index bc02f91b5f0..ebdb2a2e80e 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -7,9 +7,11 @@
 use Hyde\Console\Concerns\Command;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Artisan;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Str;
 use Symfony\Component\Finder\SplFileInfo;
 
 use function Hyde\path_join;
@@ -129,5 +131,27 @@ protected function handleInteractivePublish(): void
 
             return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
         });
+
+        // Now we need to prompt the user for which files to publish
+        $selectedFiles = $this->promptForFiles($files, basename($target));
+    }
+
+    protected function promptForFiles(Collection $files, string $baseDir): array
+    {
+        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source, string $target) use ($baseDir, $files): array {
+            return [$source => Str::after($source, $baseDir.'/')];
+        });
+
+        $selected = $this->choice(
+            'Which files do you want to publish?',
+            $choices->values()->toArray(),
+            null,
+            null,
+            true
+        );
+
+        $this->infoComment(sprintf("Selected files [%s]\n", implode(', ', $selected)));
+
+        return $selected;
     }
 }

From 6025e57e0c170381b14de62af0f54836d910069d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 16:05:28 +0100
Subject: [PATCH 3684/4023] Use Laravel Prompts multiselect

---
 .../src/Console/Commands/PublishViewsCommand.php         | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index ebdb2a2e80e..08d1554feb8 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -15,6 +15,7 @@
 use Symfony\Component\Finder\SplFileInfo;
 
 use function Hyde\path_join;
+use function Laravel\Prompts\multiselect;
 use function str_replace;
 use function sprintf;
 use function strstr;
@@ -142,13 +143,7 @@ protected function promptForFiles(Collection $files, string $baseDir): array
             return [$source => Str::after($source, $baseDir.'/')];
         });
 
-        $selected = $this->choice(
-            'Which files do you want to publish?',
-            $choices->values()->toArray(),
-            null,
-            null,
-            true
-        );
+        $selected = multiselect('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
         $this->infoComment(sprintf("Selected files [%s]\n", implode(', ', $selected)));
 

From b6eba4ae1a9b63eedd525932c24ac0822e1f8725 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:16:55 +0100
Subject: [PATCH 3685/4023] Cleanup and move up output

---
 .../src/Console/Commands/PublishViewsCommand.php       | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 08d1554feb8..e31837becee 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -135,18 +135,16 @@ protected function handleInteractivePublish(): void
 
         // Now we need to prompt the user for which files to publish
         $selectedFiles = $this->promptForFiles($files, basename($target));
+
+        $this->infoComment(sprintf("Selected files [%s]\n", collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', ')));
     }
 
     protected function promptForFiles(Collection $files, string $baseDir): array
     {
-        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source, string $target) use ($baseDir, $files): array {
+        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
             return [$source => Str::after($source, $baseDir.'/')];
         });
 
-        $selected = multiselect('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-
-        $this->infoComment(sprintf("Selected files [%s]\n", implode(', ', $selected)));
-
-        return $selected;
+        return multiselect('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
     }
 }

From 98e4b16709ff336e359094890739ab7de78d5a2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:20:16 +0100
Subject: [PATCH 3686/4023] Filter the files to only include the selected ones

---
 .../framework/src/Console/Commands/PublishViewsCommand.php     | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index e31837becee..39128f25e26 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -137,6 +137,9 @@ protected function handleInteractivePublish(): void
         $selectedFiles = $this->promptForFiles($files, basename($target));
 
         $this->infoComment(sprintf("Selected files [%s]\n", collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', ')));
+
+        // Now we filter the files to only include the selected ones
+        $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
     }
 
     protected function promptForFiles(Collection $files, string $baseDir): array

From 6607d3dda9a9e0b62c0076692c6bae80b7342c7e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:21:44 +0100
Subject: [PATCH 3687/4023] Publish the files

---
 .../src/Console/Commands/PublishViewsCommand.php      | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 39128f25e26..3f0e560c544 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -5,6 +5,7 @@
 namespace Hyde\Console\Commands;
 
 use Hyde\Console\Concerns\Command;
+use Hyde\Facades\Filesystem;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
 use Illuminate\Support\Collection;
@@ -136,10 +137,16 @@ protected function handleInteractivePublish(): void
         // Now we need to prompt the user for which files to publish
         $selectedFiles = $this->promptForFiles($files, basename($target));
 
-        $this->infoComment(sprintf("Selected files [%s]\n", collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', ')));
-
         // Now we filter the files to only include the selected ones
         $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
+
+        // Now we need to publish the selected files
+        foreach ($selectedFiles as $source => $target) {
+            Filesystem::ensureDirectoryExists(dirname($target));
+            Filesystem::copy($source, $target);
+        }
+
+        $this->infoComment(sprintf('Published files [%s]', collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', ')));
     }
 
     protected function promptForFiles(Collection $files, string $baseDir): array

From cea2f6c3724a4db10b9166e86ad906ef468ca514 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:34:40 +0100
Subject: [PATCH 3688/4023] Display how to select/unselect all at once

Really wish there was a button option like in the original PR https://github.com/laravel/prompts/pull/147
---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 3f0e560c544..e43865cd653 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -155,6 +155,6 @@ protected function promptForFiles(Collection $files, string $baseDir): array
             return [$source => Str::after($source, $baseDir.'/')];
         });
 
-        return multiselect('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
     }
 }

From e737d1fd8f7bdb20031984ad209668b9a444afaa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:36:20 +0100
Subject: [PATCH 3689/4023] Create InteractivePublishCommandHelper.php

---
 .../Helpers/InteractivePublishCommandHelper.php        | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
new file mode 100644
index 00000000000..01000b0f7cd
--- /dev/null
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Console\Helpers;
+
+class InteractivePublishCommandHelper
+{
+    //
+}

From 1b93233d9ed3540d8ea58c1d38ac94c694749bbb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:37:48 +0100
Subject: [PATCH 3690/4023] Create InteractivePublishCommandHelperTest.php

---
 .../InteractivePublishCommandHelperTest.php     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
new file mode 100644
index 00000000000..a3a934ffc97
--- /dev/null
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Console\Helpers\InteractivePublishCommandHelper
+ *
+ * @see \Hyde\Framework\Testing\Feature\Commands\PublishViewsCommandTest
+ */
+class InteractivePublishCommandHelperTest extends UnitTestCase
+{
+    //
+}

From d27fae88bf012c30378b798935bb729f699e8c02 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:37:51 +0100
Subject: [PATCH 3691/4023] Add test crosslink

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php          | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 190823910b0..7c845aabf49 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -10,6 +10,8 @@
 
 /**
  * @covers \Hyde\Console\Commands\PublishViewsCommand
+ *
+ * @see \Hyde\Framework\Testing\Unit\InteractivePublishCommandHelperTest
  */
 class PublishViewsCommandTest extends TestCase
 {

From e04400a502cd8b7e205877301ab5a7d0a1e54a48 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:39:21 +0100
Subject: [PATCH 3692/4023] Support all groups

---
 .../Console/Commands/PublishViewsCommand.php   | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index e43865cd653..5a528376b7f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -60,12 +60,6 @@ public function handle(): int
                 $this->publishOption($key);
             }
         } else {
-            if ($selected === 'components' && $this->isInteractive()) {
-                $this->handleInteractivePublish();
-
-                return Command::SUCCESS;
-            }
-
             $this->publishOption($selected);
         }
 
@@ -79,6 +73,12 @@ protected function isInteractive(): bool
 
     protected function publishOption(string $selected): void
     {
+        if ($this->isInteractive()) {
+            $this->handleInteractivePublish($selected);
+
+            return;
+        }
+
         Artisan::call('vendor:publish', [
             '--tag' => $this->options[$selected]['group'] ?? $selected,
             '--force' => true,
@@ -116,12 +116,10 @@ protected function parseChoiceIntoKey(string $choice): string
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
 
-    protected function handleInteractivePublish(): void
+    protected function handleInteractivePublish(string $group): void
     {
-        // Initially only works for components
-
         // Get all files in the components tag
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, 'hyde-components');
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->options[$group]['group']);
         $source = key($paths);
         $target = $paths[$source];
 

From f9bb56aed218fb7a7a98fffeb8529356c8701723 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:41:17 +0100
Subject: [PATCH 3693/4023] Add todo

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 5a528376b7f..988c218498e 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -73,6 +73,7 @@ protected function isInteractive(): bool
 
     protected function publishOption(string $selected): void
     {
+        // Todo: Don't trigger interactive if "all" is selected
         if ($this->isInteractive()) {
             $this->handleInteractivePublish($selected);
 

From 3f406ad5a7774bbd873f9c4864c63cdf9d666781 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:44:39 +0100
Subject: [PATCH 3694/4023] Tweak setup

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 988c218498e..e235ebf39d1 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -117,10 +117,12 @@ protected function parseChoiceIntoKey(string $choice): string
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
 
-    protected function handleInteractivePublish(string $group): void
+    protected function handleInteractivePublish(string $selected): void
     {
+        $group = $this->options[$selected]['group'];
+
         // Get all files in the components tag
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->options[$group]['group']);
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $group);
         $source = key($paths);
         $target = $paths[$source];
 

From 04813dadf75f8a868f0240652aa865fa64b220be Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:45:00 +0100
Subject: [PATCH 3695/4023] Create helper instance

---
 .../framework/src/Console/Commands/PublishViewsCommand.php     | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index e235ebf39d1..63699b0676a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -5,6 +5,7 @@
 namespace Hyde\Console\Commands;
 
 use Hyde\Console\Concerns\Command;
+use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Facades\Filesystem;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
@@ -119,6 +120,8 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function handleInteractivePublish(string $selected): void
     {
+        $publisher = new InteractivePublishCommandHelper();
+
         $group = $this->options[$selected]['group'];
 
         // Get all files in the components tag

From 15b67aa3858bd52401ade5de9e078b008b9b6cb4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:46:00 +0100
Subject: [PATCH 3696/4023] Introduce local variable

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 63699b0676a..8722c30a12f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -150,7 +150,9 @@ protected function handleInteractivePublish(string $selected): void
             Filesystem::copy($source, $target);
         }
 
-        $this->infoComment(sprintf('Published files [%s]', collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', ')));
+        $message = sprintf('Published files [%s]', collect($selectedFiles)->map(fn(string $file): string => Str::after($file, basename($source) . '/'))->implode(', '));
+
+        $this->infoComment($message);
     }
 
     protected function promptForFiles(Collection $files, string $baseDir): array

From 5589e363fe97d11bc7e29b7ee823a9cb4f03d679 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:46:32 +0100
Subject: [PATCH 3697/4023] Mark helper as internal

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 01000b0f7cd..fe093e45197 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Console\Helpers;
 
+/**
+ * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
+ */
 class InteractivePublishCommandHelper
 {
     //

From 6d7810a075169958aadecdd062410065896dc0ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:49:04 +0100
Subject: [PATCH 3698/4023] Move method to helper

---
 .../src/Console/Commands/PublishViewsCommand.php    | 11 +----------
 .../Helpers/InteractivePublishCommandHelper.php     | 13 ++++++++++++-
 2 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 8722c30a12f..aea402d7f24 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -139,7 +139,7 @@ protected function handleInteractivePublish(string $selected): void
         });
 
         // Now we need to prompt the user for which files to publish
-        $selectedFiles = $this->promptForFiles($files, basename($target));
+        $selectedFiles = $publisher->promptForFiles($files, basename($target));
 
         // Now we filter the files to only include the selected ones
         $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
@@ -154,13 +154,4 @@ protected function handleInteractivePublish(string $selected): void
 
         $this->infoComment($message);
     }
-
-    protected function promptForFiles(Collection $files, string $baseDir): array
-    {
-        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
-            return [$source => Str::after($source, $baseDir.'/')];
-        });
-
-        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-    }
 }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index fe093e45197..f45fe6f86df 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -4,10 +4,21 @@
 
 namespace Hyde\Console\Helpers;
 
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+use function Laravel\Prompts\multiselect;
+
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
  */
 class InteractivePublishCommandHelper
 {
-    //
+    public function promptForFiles(Collection $files, string $baseDir): array
+    {
+        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
+            return [$source => Str::after($source, $baseDir.'/')];
+        });
+
+        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+    }
 }

From 32105b2698fc49f488c4c9316de45d8a6d00c6db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:49:07 +0100
Subject: [PATCH 3699/4023] Revert "Move method to helper"

This reverts commit 85989f4636216a20e2c336001f8467724074512c.
---
 .../src/Console/Commands/PublishViewsCommand.php    | 11 ++++++++++-
 .../Helpers/InteractivePublishCommandHelper.php     | 13 +------------
 2 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index aea402d7f24..8722c30a12f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -139,7 +139,7 @@ protected function handleInteractivePublish(string $selected): void
         });
 
         // Now we need to prompt the user for which files to publish
-        $selectedFiles = $publisher->promptForFiles($files, basename($target));
+        $selectedFiles = $this->promptForFiles($files, basename($target));
 
         // Now we filter the files to only include the selected ones
         $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
@@ -154,4 +154,13 @@ protected function handleInteractivePublish(string $selected): void
 
         $this->infoComment($message);
     }
+
+    protected function promptForFiles(Collection $files, string $baseDir): array
+    {
+        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
+            return [$source => Str::after($source, $baseDir.'/')];
+        });
+
+        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+    }
 }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index f45fe6f86df..fe093e45197 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -4,21 +4,10 @@
 
 namespace Hyde\Console\Helpers;
 
-use Illuminate\Support\Collection;
-use Illuminate\Support\Str;
-use function Laravel\Prompts\multiselect;
-
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
  */
 class InteractivePublishCommandHelper
 {
-    public function promptForFiles(Collection $files, string $baseDir): array
-    {
-        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
-            return [$source => Str::after($source, $baseDir.'/')];
-        });
-
-        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-    }
+    //
 }

From 72b4b11e614d52f95544c379535a784240f3397f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:54:01 +0100
Subject: [PATCH 3700/4023] Move logic to helper

---
 .../Console/Commands/PublishViewsCommand.php  | 50 +--------------
 .../InteractivePublishCommandHelper.php       | 63 ++++++++++++++++++-
 2 files changed, 64 insertions(+), 49 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 8722c30a12f..19c16b6e1b9 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -6,18 +6,9 @@
 
 use Hyde\Console\Concerns\Command;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Hyde\Facades\Filesystem;
-use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
-use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Artisan;
-use Illuminate\Support\Facades\File;
-use Illuminate\Support\ServiceProvider;
-use Illuminate\Support\Str;
-use Symfony\Component\Finder\SplFileInfo;
 
-use function Hyde\path_join;
-use function Laravel\Prompts\multiselect;
 use function str_replace;
 use function sprintf;
 use function strstr;
@@ -120,47 +111,10 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function handleInteractivePublish(string $selected): void
     {
-        $publisher = new InteractivePublishCommandHelper();
-
         $group = $this->options[$selected]['group'];
+        $publisher = new InteractivePublishCommandHelper($group);
 
-        // Get all files in the components tag
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $group);
-        $source = key($paths);
-        $target = $paths[$source];
-
-        // Now we need an array that maps all source files to their target paths retaining the directory structure
-        $search = File::allFiles($source);
-
-        $files = collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file) use ($target): array {
-            $targetPath = path_join($target, $file->getRelativePathname());
-
-            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
-        });
-
-        // Now we need to prompt the user for which files to publish
-        $selectedFiles = $this->promptForFiles($files, basename($target));
-
-        // Now we filter the files to only include the selected ones
-        $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
-
-        // Now we need to publish the selected files
-        foreach ($selectedFiles as $source => $target) {
-            Filesystem::ensureDirectoryExists(dirname($target));
-            Filesystem::copy($source, $target);
-        }
-
-        $message = sprintf('Published files [%s]', collect($selectedFiles)->map(fn(string $file): string => Str::after($file, basename($source) . '/'))->implode(', '));
-
+        $message = $publisher->handle();
         $this->infoComment($message);
     }
-
-    protected function promptForFiles(Collection $files, string $baseDir): array
-    {
-        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
-            return [$source => Str::after($source, $baseDir.'/')];
-        });
-
-        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-    }
 }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index fe093e45197..5b4c615bcdb 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -4,10 +4,71 @@
 
 namespace Hyde\Console\Helpers;
 
+use Hyde\Facades\Filesystem;
+use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Hyde;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Str;
+use Symfony\Component\Finder\SplFileInfo;
+
+use function Hyde\path_join;
+use function Laravel\Prompts\multiselect;
+
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
  */
 class InteractivePublishCommandHelper
 {
-    //
+    protected readonly string $group;
+
+    public function __construct(string $group)
+    {
+        $this->group = $group;
+    }
+
+    public function handle(): string
+    {
+        $group = $this->group;
+
+        // Get all files in the components tag
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $group);
+        $source = key($paths);
+        $target = $paths[$source];
+
+        // Now we need an array that maps all source files to their target paths retaining the directory structure
+        $search = File::allFiles($source);
+
+        $files = collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file) use ($target): array {
+            $targetPath = path_join($target, $file->getRelativePathname());
+
+            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
+        });
+
+        // Now we need to prompt the user for which files to publish
+        $selectedFiles = $this->promptForFiles($files, basename($target));
+
+        // Now we filter the files to only include the selected ones
+        $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
+
+        // Now we need to publish the selected files
+        foreach ($selectedFiles as $source => $target) {
+            Filesystem::ensureDirectoryExists(dirname($target));
+            Filesystem::copy($source, $target);
+        }
+
+        $message = sprintf('Published files [%s]', collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', '));
+
+        return $message;
+    }
+
+    protected function promptForFiles(Collection $files, string $baseDir): array
+    {
+        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
+            return [$source => Str::after($source, $baseDir.'/')];
+        });
+
+        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+    }
 }

From 2faf686b9fb836b90db54937247d592b1a629555 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 10 Dec 2024 17:54:59 +0100
Subject: [PATCH 3701/4023] Refactor the extracted class

---
 .../InteractivePublishCommandHelper.php       | 60 +++++++++++--------
 1 file changed, 36 insertions(+), 24 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 5b4c615bcdb..dc7ead2e606 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -22,6 +22,8 @@
 class InteractivePublishCommandHelper
 {
     protected readonly string $group;
+    protected readonly string $source;
+    protected readonly string $target;
 
     public function __construct(string $group)
     {
@@ -30,37 +32,34 @@ public function __construct(string $group)
 
     public function handle(): string
     {
-        $group = $this->group;
+        $filesInTag = $this->findAllFilesForTag();
+        $publishableFilesMap = $this->mapPublishableFiles($filesInTag);
 
-        // Get all files in the components tag
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $group);
-        $source = key($paths);
-        $target = $paths[$source];
+        $selectedFiles = $this->promptForFiles($publishableFilesMap, basename($this->target));
+        $filesToPublish = $publishableFilesMap->filter(fn (string $file): bool => in_array($file, $selectedFiles));
 
-        // Now we need an array that maps all source files to their target paths retaining the directory structure
-        $search = File::allFiles($source);
+        $this->publishFiles($filesToPublish);
 
-        $files = collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file) use ($target): array {
-            $targetPath = path_join($target, $file->getRelativePathname());
-
-            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
-        });
-
-        // Now we need to prompt the user for which files to publish
-        $selectedFiles = $this->promptForFiles($files, basename($target));
+        return sprintf('Published files [%s]', $this->getPublishedFilesForOutput($filesToPublish));
+    }
 
-        // Now we filter the files to only include the selected ones
-        $selectedFiles = $files->filter(fn (string $file): bool => in_array($file, $selectedFiles));
+    /** @return \Symfony\Component\Finder\SplFileInfo[] */
+    protected function findAllFilesForTag(): array
+    {
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
+        $this->source = key($paths);
+        $this->target = $paths[$this->source];
 
-        // Now we need to publish the selected files
-        foreach ($selectedFiles as $source => $target) {
-            Filesystem::ensureDirectoryExists(dirname($target));
-            Filesystem::copy($source, $target);
-        }
+        return File::allFiles($this->source);
+    }
 
-        $message = sprintf('Published files [%s]', collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($source).'/'))->implode(', '));
+    protected function mapPublishableFiles(array $search): Collection
+    {
+        return collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file): array {
+            $targetPath = path_join($this->target, $file->getRelativePathname());
 
-        return $message;
+            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
+        });
     }
 
     protected function promptForFiles(Collection $files, string $baseDir): array
@@ -71,4 +70,17 @@ protected function promptForFiles(Collection $files, string $baseDir): array
 
         return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
     }
+
+    protected function publishFiles(Collection $selectedFiles): void
+    {
+        foreach ($selectedFiles as $source => $target) {
+            Filesystem::ensureDirectoryExists(dirname($target));
+            Filesystem::copy($source, $target); // Todo: See how we should handle existing files
+        }
+    }
+
+    protected function getPublishedFilesForOutput(Collection $selectedFiles): string
+    {
+        return collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($this->source).'/'))->implode(', ');
+    }
 }

From 26eff2f39b49e6ea7b263d6ef7df86b22e3c174e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:07:16 +0100
Subject: [PATCH 3702/4023] Refactor so output is handled in command

---
 .../Console/Commands/PublishViewsCommand.php  |  7 ++++-
 .../InteractivePublishCommandHelper.php       | 28 +++++++++----------
 2 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 19c16b6e1b9..4557a5ca618 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,6 +9,7 @@
 use Hyde\Hyde;
 use Illuminate\Support\Facades\Artisan;
 
+use function Laravel\Prompts\multiselect;
 use function str_replace;
 use function sprintf;
 use function strstr;
@@ -114,7 +115,11 @@ protected function handleInteractivePublish(string $selected): void
         $group = $this->options[$selected]['group'];
         $publisher = new InteractivePublishCommandHelper($group);
 
-        $message = $publisher->handle();
+        $choices = $publisher->getFileChoices();
+
+        $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+
+        $message = $publisher->handle($selectedFiles);
         $this->infoComment($message);
     }
 }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index dc7ead2e606..3717d6b78db 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -14,7 +14,6 @@
 use Symfony\Component\Finder\SplFileInfo;
 
 use function Hyde\path_join;
-use function Laravel\Prompts\multiselect;
 
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
@@ -25,18 +24,26 @@ class InteractivePublishCommandHelper
     protected readonly string $source;
     protected readonly string $target;
 
+    /** @var \Illuminate\Support\Collection<string, string> Map of source files to target files */
+    protected readonly Collection $publishableFilesMap;
+
     public function __construct(string $group)
     {
         $this->group = $group;
     }
 
-    public function handle(): string
+    public function getFileChoices(): Collection
     {
-        $filesInTag = $this->findAllFilesForTag();
-        $publishableFilesMap = $this->mapPublishableFiles($filesInTag);
+        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
 
-        $selectedFiles = $this->promptForFiles($publishableFilesMap, basename($this->target));
-        $filesToPublish = $publishableFilesMap->filter(fn (string $file): bool => in_array($file, $selectedFiles));
+        return $this->publishableFilesMap->mapWithKeys(/** @return array<string, string> */ function (string $source): array {
+            return [$source => Str::after($source, basename($this->target).'/')];
+        });
+    }
+
+    public function handle(array $selectedFiles): string
+    {
+        $filesToPublish = $this->publishableFilesMap->filter(fn (string $file): bool => in_array($file, $selectedFiles));
 
         $this->publishFiles($filesToPublish);
 
@@ -62,15 +69,6 @@ protected function mapPublishableFiles(array $search): Collection
         });
     }
 
-    protected function promptForFiles(Collection $files, string $baseDir): array
-    {
-        $choices = $files->mapWithKeys(/** @return array<string, string> */ function (string $source) use ($baseDir): array {
-            return [$source => Str::after($source, $baseDir.'/')];
-        });
-
-        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-    }
-
     protected function publishFiles(Collection $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {

From b6010c24673f6a68dc8f00d09212c6f756631286 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:22:58 +0100
Subject: [PATCH 3703/4023] Refactor to initialise all data in constructor

Feels a bit meh to do expensive file ops in constructor, but it's an internal class and and it does better handle responsibilities as the constructor ensures state is fully initialized. It takes about 0.673ms for multiple runs so in tests we can microoptimize to mock files if needed.
---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 3717d6b78db..a9143b0576e 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -30,12 +30,11 @@ class InteractivePublishCommandHelper
     public function __construct(string $group)
     {
         $this->group = $group;
+        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
     }
 
     public function getFileChoices(): Collection
     {
-        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
-
         return $this->publishableFilesMap->mapWithKeys(/** @return array<string, string> */ function (string $source): array {
             return [$source => Str::after($source, basename($this->target).'/')];
         });

From acaf3f38988a82cede22e16b6f44f28a815d9859 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:24:45 +0100
Subject: [PATCH 3704/4023] Make it clearer where data is initialized

---
 .../Helpers/InteractivePublishCommandHelper.php     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index a9143b0576e..b1ca64ad46a 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -30,7 +30,14 @@ class InteractivePublishCommandHelper
     public function __construct(string $group)
     {
         $this->group = $group;
-        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
+
+        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
+
+        $this->source = key($paths);
+        $this->target = $paths[$this->source];
+
+        $filesForTag = $this->findAllFilesForTag();
+        $this->publishableFilesMap = $this->mapPublishableFiles($filesForTag);
     }
 
     public function getFileChoices(): Collection
@@ -52,10 +59,6 @@ public function handle(array $selectedFiles): string
     /** @return \Symfony\Component\Finder\SplFileInfo[] */
     protected function findAllFilesForTag(): array
     {
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
-        $this->source = key($paths);
-        $this->target = $paths[$this->source];
-
         return File::allFiles($this->source);
     }
 

From 093c96e718861629a017ebf3198872245d36c58d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:25:11 +0100
Subject: [PATCH 3705/4023] Cleanup code

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 4557a5ca618..95f8fdebda2 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -112,14 +112,12 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function handleInteractivePublish(string $selected): void
     {
-        $group = $this->options[$selected]['group'];
-        $publisher = new InteractivePublishCommandHelper($group);
+        $publisher = new InteractivePublishCommandHelper($this->options[$selected]['group']);
 
         $choices = $publisher->getFileChoices();
 
         $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
-        $message = $publisher->handle($selectedFiles);
-        $this->infoComment($message);
+        $this->infoComment($publisher->handle($selectedFiles));
     }
 }

From 2f000ba26a8b12f4d4440187d1e66a280a32674e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:33:10 +0100
Subject: [PATCH 3706/4023] Refactor data retrieval to clean up constructor

---
 .../Helpers/InteractivePublishCommandHelper.php  | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index b1ca64ad46a..1a695f8773c 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -31,10 +31,7 @@ public function __construct(string $group)
     {
         $this->group = $group;
 
-        $paths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
-
-        $this->source = key($paths);
-        $this->target = $paths[$this->source];
+        [$this->source, $this->target] = $this->getPublishPaths();
 
         $filesForTag = $this->findAllFilesForTag();
         $this->publishableFilesMap = $this->mapPublishableFiles($filesForTag);
@@ -56,6 +53,17 @@ public function handle(array $selectedFiles): string
         return sprintf('Published files [%s]', $this->getPublishedFilesForOutput($filesToPublish));
     }
 
+    /** @return array{string, string} */
+    protected function getPublishPaths(): array
+    {
+        $viewPaths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
+
+        $source = array_key_first($viewPaths);
+        $target = $viewPaths[$source];
+
+        return [$source, $target];
+    }
+
     /** @return \Symfony\Component\Finder\SplFileInfo[] */
     protected function findAllFilesForTag(): array
     {

From cd6dbb012ee8e233a9cad854b5d0f0a42fe1705d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:34:04 +0100
Subject: [PATCH 3707/4023] Rename properties to indicate they are directories

---
 .../Helpers/InteractivePublishCommandHelper.php    | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 1a695f8773c..6d3cf0e088c 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -21,8 +21,8 @@
 class InteractivePublishCommandHelper
 {
     protected readonly string $group;
-    protected readonly string $source;
-    protected readonly string $target;
+    protected readonly string $sourceDirectory;
+    protected readonly string $targetDirectory;
 
     /** @var \Illuminate\Support\Collection<string, string> Map of source files to target files */
     protected readonly Collection $publishableFilesMap;
@@ -31,7 +31,7 @@ public function __construct(string $group)
     {
         $this->group = $group;
 
-        [$this->source, $this->target] = $this->getPublishPaths();
+        [$this->sourceDirectory, $this->targetDirectory] = $this->getPublishPaths();
 
         $filesForTag = $this->findAllFilesForTag();
         $this->publishableFilesMap = $this->mapPublishableFiles($filesForTag);
@@ -40,7 +40,7 @@ public function __construct(string $group)
     public function getFileChoices(): Collection
     {
         return $this->publishableFilesMap->mapWithKeys(/** @return array<string, string> */ function (string $source): array {
-            return [$source => Str::after($source, basename($this->target).'/')];
+            return [$source => Str::after($source, basename($this->targetDirectory).'/')];
         });
     }
 
@@ -67,13 +67,13 @@ protected function getPublishPaths(): array
     /** @return \Symfony\Component\Finder\SplFileInfo[] */
     protected function findAllFilesForTag(): array
     {
-        return File::allFiles($this->source);
+        return File::allFiles($this->sourceDirectory);
     }
 
     protected function mapPublishableFiles(array $search): Collection
     {
         return collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file): array {
-            $targetPath = path_join($this->target, $file->getRelativePathname());
+            $targetPath = path_join($this->targetDirectory, $file->getRelativePathname());
 
             return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
         });
@@ -89,6 +89,6 @@ protected function publishFiles(Collection $selectedFiles): void
 
     protected function getPublishedFilesForOutput(Collection $selectedFiles): string
     {
-        return collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($this->source).'/'))->implode(', ');
+        return collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($this->sourceDirectory).'/'))->implode(', ');
     }
 }

From ecc8725ceadba9758921ec906218ba7725a0d067 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:37:35 +0100
Subject: [PATCH 3708/4023] Use array facade instead of unnecessary collections

---
 .../InteractivePublishCommandHelper.php       | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 6d3cf0e088c..8bf58f57d23 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -7,6 +7,7 @@
 use Hyde\Facades\Filesystem;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\ServiceProvider;
@@ -24,8 +25,8 @@ class InteractivePublishCommandHelper
     protected readonly string $sourceDirectory;
     protected readonly string $targetDirectory;
 
-    /** @var \Illuminate\Support\Collection<string, string> Map of source files to target files */
-    protected readonly Collection $publishableFilesMap;
+    /** @var array<string, string> Map of source files to target files */
+    protected readonly array $publishableFilesMap;
 
     public function __construct(string $group)
     {
@@ -37,16 +38,16 @@ public function __construct(string $group)
         $this->publishableFilesMap = $this->mapPublishableFiles($filesForTag);
     }
 
-    public function getFileChoices(): Collection
+    public function getFileChoices(): array
     {
-        return $this->publishableFilesMap->mapWithKeys(/** @return array<string, string> */ function (string $source): array {
+        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source): array {
             return [$source => Str::after($source, basename($this->targetDirectory).'/')];
         });
     }
 
     public function handle(array $selectedFiles): string
     {
-        $filesToPublish = $this->publishableFilesMap->filter(fn (string $file): bool => in_array($file, $selectedFiles));
+        $filesToPublish = array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
 
         $this->publishFiles($filesToPublish);
 
@@ -70,16 +71,16 @@ protected function findAllFilesForTag(): array
         return File::allFiles($this->sourceDirectory);
     }
 
-    protected function mapPublishableFiles(array $search): Collection
+    protected function mapPublishableFiles(array $search): array
     {
-        return collect($search)->mapWithKeys(/** @return array<string, string> */ function (SplFileInfo $file): array {
+        return Arr::mapWithKeys($search, /** @return array<string, string> */ function (SplFileInfo $file): array {
             $targetPath = path_join($this->targetDirectory, $file->getRelativePathname());
 
             return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
         });
     }
 
-    protected function publishFiles(Collection $selectedFiles): void
+    protected function publishFiles(array $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {
             Filesystem::ensureDirectoryExists(dirname($target));
@@ -87,7 +88,7 @@ protected function publishFiles(Collection $selectedFiles): void
         }
     }
 
-    protected function getPublishedFilesForOutput(Collection $selectedFiles): string
+    protected function getPublishedFilesForOutput(array $selectedFiles): string
     {
         return collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($this->sourceDirectory).'/'))->implode(', ');
     }

From 9c9b113c7937886bd63a25d42011d898c0bc7672 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:41:18 +0100
Subject: [PATCH 3709/4023] Extract helper method

---
 .../Console/Helpers/InteractivePublishCommandHelper.php  | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 8bf58f57d23..76a26930519 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -41,7 +41,7 @@ public function __construct(string $group)
     public function getFileChoices(): array
     {
         return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source): array {
-            return [$source => Str::after($source, basename($this->targetDirectory).'/')];
+            return [$source => $this->pathRelativeToDirectory($source, $this->targetDirectory)];
         });
     }
 
@@ -90,6 +90,11 @@ protected function publishFiles(array $selectedFiles): void
 
     protected function getPublishedFilesForOutput(array $selectedFiles): string
     {
-        return collect($selectedFiles)->map(fn (string $file): string => Str::after($file, basename($this->sourceDirectory).'/'))->implode(', ');
+        return collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');
+    }
+
+    protected function pathRelativeToDirectory(string $source, string $directory): string
+    {
+        return Str::after($source, basename($directory).'/');
     }
 }

From 50f83623996bd6c554f43a5dea19e116f848210e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 10:41:43 +0100
Subject: [PATCH 3710/4023] Formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 1 -
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 +---
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 95f8fdebda2..833a04e87c3 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -6,7 +6,6 @@
 
 use Hyde\Console\Concerns\Command;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Hyde\Hyde;
 use Illuminate\Support\Facades\Artisan;
 
 use function Laravel\Prompts\multiselect;
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 76a26930519..ff4232b0878 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -8,7 +8,6 @@
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
 use Illuminate\Support\Arr;
-use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
@@ -34,8 +33,7 @@ public function __construct(string $group)
 
         [$this->sourceDirectory, $this->targetDirectory] = $this->getPublishPaths();
 
-        $filesForTag = $this->findAllFilesForTag();
-        $this->publishableFilesMap = $this->mapPublishableFiles($filesForTag);
+        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
     }
 
     public function getFileChoices(): array

From 3330f3acb75c110010f217c9c06c84886aa19ca1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 21:19:36 +0100
Subject: [PATCH 3711/4023] Extract helper method and add more array types

---
 .../Helpers/InteractivePublishCommandHelper.php     | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ff4232b0878..1fcd3f1e436 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -36,6 +36,7 @@ public function __construct(string $group)
         $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
     }
 
+    /** @return array<string, string> */
     public function getFileChoices(): array
     {
         return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source): array {
@@ -43,9 +44,10 @@ public function getFileChoices(): array
         });
     }
 
+    /** @param array<string> $selectedFiles */
     public function handle(array $selectedFiles): string
     {
-        $filesToPublish = array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
+        $filesToPublish = $this->filterPublishableFiles($selectedFiles);
 
         $this->publishFiles($filesToPublish);
 
@@ -95,4 +97,13 @@ protected function pathRelativeToDirectory(string $source, string $directory): s
     {
         return Str::after($source, basename($directory).'/');
     }
+
+    /**
+     * @param array<string> $selectedFiles
+     * @return array<string, string>
+     */
+    public function filterPublishableFiles(array $selectedFiles): array
+    {
+        return array_filter($this->publishableFilesMap, fn(string $file): bool => in_array($file, $selectedFiles));
+    }
 }

From 7c689548fb5d62e890b4a2ad94c894b874e2a938 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 21:22:36 +0100
Subject: [PATCH 3712/4023] Change variable used to match signature

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 1fcd3f1e436..978f90f58f8 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -51,7 +51,7 @@ public function handle(array $selectedFiles): string
 
         $this->publishFiles($filesToPublish);
 
-        return sprintf('Published files [%s]', $this->getPublishedFilesForOutput($filesToPublish));
+        return sprintf('Published files [%s]', $this->getPublishedFilesForOutput($selectedFiles));
     }
 
     /** @return array{string, string} */

From 179a6d3002666e189f5c175aa0edff5056e1152a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 21:23:04 +0100
Subject: [PATCH 3713/4023] Fix formatting

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 978f90f58f8..c63a0d988dc 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -99,11 +99,11 @@ protected function pathRelativeToDirectory(string $source, string $directory): s
     }
 
     /**
-     * @param array<string> $selectedFiles
+     * @param  array<string>  $selectedFiles
      * @return array<string, string>
      */
-    public function filterPublishableFiles(array $selectedFiles): array
+    protected function filterPublishableFiles(array $selectedFiles): array
     {
-        return array_filter($this->publishableFilesMap, fn(string $file): bool => in_array($file, $selectedFiles));
+        return array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
     }
 }

From c60a240c94dfff9cf12edb8943cdc4029d0bf129 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 21:33:16 +0100
Subject: [PATCH 3714/4023] Split out output handler to void handle method

---
 .../src/Console/Commands/PublishViewsCommand.php       |  3 ++-
 .../Helpers/InteractivePublishCommandHelper.php        | 10 +++++-----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 833a04e87c3..03dacd3d6d0 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -116,7 +116,8 @@ protected function handleInteractivePublish(string $selected): void
         $choices = $publisher->getFileChoices();
 
         $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $publisher->handle($selectedFiles);
 
-        $this->infoComment($publisher->handle($selectedFiles));
+        $this->infoComment($publisher->formatOutput($selectedFiles));
     }
 }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index c63a0d988dc..ddfaada280a 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -45,13 +45,11 @@ public function getFileChoices(): array
     }
 
     /** @param array<string> $selectedFiles */
-    public function handle(array $selectedFiles): string
+    public function handle(array $selectedFiles): void
     {
         $filesToPublish = $this->filterPublishableFiles($selectedFiles);
 
         $this->publishFiles($filesToPublish);
-
-        return sprintf('Published files [%s]', $this->getPublishedFilesForOutput($selectedFiles));
     }
 
     /** @return array{string, string} */
@@ -88,9 +86,11 @@ protected function publishFiles(array $selectedFiles): void
         }
     }
 
-    protected function getPublishedFilesForOutput(array $selectedFiles): string
+    public function formatOutput(array $selectedFiles): string
     {
-        return collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');
+        $publishedFiles = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');
+
+        return sprintf('Published files [%s]', $publishedFiles);
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string

From 8df8040c844f5bf69f475e0fedc410ed9ce668cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 11 Dec 2024 21:46:15 +0100
Subject: [PATCH 3715/4023] Add base test setups

---
 .../Unit/InteractivePublishCommandHelperTest.php    | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index a3a934ffc97..c753b88a858 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -13,5 +13,16 @@
  */
 class InteractivePublishCommandHelperTest extends UnitTestCase
 {
-    //
+    /** @var \Illuminate\Filesystem\Filesystem&\Mockery\MockInterface */
+    protected $filesystem;
+
+    protected function setUp(): void
+    {
+        $this->filesystem = $this->mockFilesystemStrict();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->verifyMockeryExpectations();
+    }
 }

From c28a233527e8cc6fc10eb9544c3fc77e1a64a56e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:36:20 +0100
Subject: [PATCH 3716/4023] Disable interactive publishing on Windows

There is a fallback, but I think it's worse than what we get otherwise.
---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 03dacd3d6d0..5fe24a87052 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -67,6 +67,12 @@ protected function publishOption(string $selected): void
     {
         // Todo: Don't trigger interactive if "all" is selected
         if ($this->isInteractive()) {
+            if (windows_os() || (config('app.env') === 'testing') && config('internal.testing.os') === 'windows') {
+                // Laravel Prompts supports macOS, Linux, and Windows with WSL. Due to limitations in the Windows version of PHP, it is not currently possible to use Laravel Prompts on Windows outside of WSL.
+
+                $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
+            }
+
             $this->handleInteractivePublish($selected);
 
             return;

From 27d3cc2da6e9b2709ab9bd7ce98248ca44482192 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:37:05 +0100
Subject: [PATCH 3717/4023] Create ConsoleHelper.php

---
 .../framework/src/Console/Helpers/ConsoleHelper.php    | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 packages/framework/src/Console/Helpers/ConsoleHelper.php

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
new file mode 100644
index 00000000000..5632cad5e14
--- /dev/null
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Console\Helpers;
+
+class ConsoleHelper
+{
+    //
+}

From 4e59a21ed7bcab7ea5602c55d8bb499836469ca4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:37:47 +0100
Subject: [PATCH 3718/4023] Mark helper as internal

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 5632cad5e14..a850b1f2b57 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -4,6 +4,9 @@
 
 namespace Hyde\Console\Helpers;
 
+/**
+ * @internal This class contains internal helpers for interacting with the console, and for easier testing.
+ */
 class ConsoleHelper
 {
     //

From 2c221b11b8db550abf6bac1341d3c215fed69382 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:38:11 +0100
Subject: [PATCH 3719/4023] Code coverage ignore helper

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index a850b1f2b57..a86e348c91e 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -6,6 +6,8 @@
 
 /**
  * @internal This class contains internal helpers for interacting with the console, and for easier testing.
+ *
+ * @codeCoverageIgnore This class provides internal testing helpers and does not need to be tested.
  */
 class ConsoleHelper
 {

From b9a4ed8f2dd86aae0aab4936cda43213a09e0f65 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:38:52 +0100
Subject: [PATCH 3720/4023] Add mocking scaffolding

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index a86e348c91e..c89ad0608c9 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -11,5 +11,10 @@
  */
 class ConsoleHelper
 {
-    //
+    protected static array $mocks = [];
+
+    public static function clearMocks(): void
+    {
+        static::$mocks = [];
+    }
 }

From 443a1a8037c2c12d36b07e86853b0df950a642f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 15:40:22 +0100
Subject: [PATCH 3721/4023] Add and use mockable Windows detection helper

---
 .../src/Console/Commands/PublishViewsCommand.php   |  3 ++-
 .../src/Console/Helpers/ConsoleHelper.php          | 14 ++++++++++++++
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 5fe24a87052..5965b65f32b 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -5,6 +5,7 @@
 namespace Hyde\Console\Commands;
 
 use Hyde\Console\Concerns\Command;
+use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Support\Facades\Artisan;
 
@@ -67,7 +68,7 @@ protected function publishOption(string $selected): void
     {
         // Todo: Don't trigger interactive if "all" is selected
         if ($this->isInteractive()) {
-            if (windows_os() || (config('app.env') === 'testing') && config('internal.testing.os') === 'windows') {
+            if (ConsoleHelper::usesWindowsOs()) {
                 // Laravel Prompts supports macOS, Linux, and Windows with WSL. Due to limitations in the Windows version of PHP, it is not currently possible to use Laravel Prompts on Windows outside of WSL.
 
                 $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index c89ad0608c9..cd0198766c9 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -17,4 +17,18 @@ public static function clearMocks(): void
     {
         static::$mocks = [];
     }
+
+    public static function usesWindowsOs()
+    {
+        if (isset(static::$mocks['usesWindowsOs'])) {
+            return static::$mocks['usesWindowsOs'];
+        }
+
+        return windows_os();
+    }
+
+    public static function mockWindowsOs(bool $isWindows = true): void
+    {
+        static::$mocks['usesWindowsOs'] = $isWindows;
+    }
 }

From 03bcc03e8c8ec9d20df21e7f916c8e4c80ce817e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:03:37 +0100
Subject: [PATCH 3722/4023] Create mockable helper for multiselect

---
 .../Console/Commands/PublishViewsCommand.php  |  2 +-
 .../src/Console/Helpers/ConsoleHelper.php     | 30 +++++++++++++++++++
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 5965b65f32b..303b52a94e3 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -122,7 +122,7 @@ protected function handleInteractivePublish(string $selected): void
 
         $choices = $publisher->getFileChoices();
 
-        $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $selectedFiles = ConsoleHelper::multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
         $publisher->handle($selectedFiles);
 
         $this->infoComment($publisher->formatOutput($selectedFiles));
diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index cd0198766c9..ab10c68756b 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -4,6 +4,11 @@
 
 namespace Hyde\Console\Helpers;
 
+use Closure;
+use Illuminate\Support\Collection;
+
+use function Laravel\Prompts\multiselect;
+
 /**
  * @internal This class contains internal helpers for interacting with the console, and for easier testing.
  *
@@ -31,4 +36,29 @@ public static function mockWindowsOs(bool $isWindows = true): void
     {
         static::$mocks['usesWindowsOs'] = $isWindows;
     }
+
+    // Todo: Add test to ensure the signature is the same if Laravel updates it
+    public static function multiselect(string $label, array|Collection $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, string $hint = 'Use the space bar to select options.', ?Closure $transform = null): array
+    {
+        if (isset(static::$mocks['multiselect'])) {
+            $returns = static::$mocks['multiselect'];
+            $assertionCallback = static::$mocks['multiselectAssertion'] ?? null;
+
+            if ($assertionCallback !== null) {
+                $assertionCallback($label, $options, $default, $scroll, $required, $validate, $hint, $transform);
+            }
+
+            return $returns;
+        }
+
+        return multiselect($label, $options, $default, $scroll, $required, $validate, $hint, $transform);
+    }
+
+    public static function mockMultiselect(array $returns, ?Closure $assertionCallback = null): void
+    {
+        assert(! isset(static::$mocks['multiselect']), 'Cannot mock multiselect twice.');
+
+        static::$mocks['multiselect'] = $returns;
+        static::$mocks['multiselectAssertion'] = $assertionCallback;
+    }
 }

From 4f907650a56e08d263fffbe871cbb4744606df79 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:04:40 +0100
Subject: [PATCH 3723/4023] Create first tests

---
 .../Console/Commands/PublishViewsCommand.php  |  1 -
 .../Commands/PublishViewsCommandTest.php      | 35 +++++++++++++++++++
 2 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 303b52a94e3..88c2280b729 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,7 +9,6 @@
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Support\Facades\Artisan;
 
-use function Laravel\Prompts\multiselect;
 use function str_replace;
 use function sprintf;
 use function strstr;
diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 7c845aabf49..d3999f7266e 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Feature\Commands;
 
+use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\File;
@@ -50,4 +51,38 @@ public function testWithInvalidSuppliedTag()
             ->expectsOutputToContain('No publishable resources for tag [invalid].')
             ->assertExitCode(0);
     }
+
+    public function testInteractiveSelectionOnUnixSystems()
+    {
+        if (windows_os()) {
+            $this->markTestSkipped('Laravel Prompts does not support Windows OS');
+        }
+
+        ConsoleHelper::mockMultiselect(['resources/views/vendor/hyde/components/article-excerpt.blade.php'], function ($label, $options) {
+            $this->assertEquals('Select the files you want to publish (CTRL+A to toggle all)', $label);
+            $this->assertContainsOnly('string', array_keys($options));
+            $this->assertContainsOnly('string', array_values($options));
+            $this->assertContains('resources/views/vendor/hyde/components/article-excerpt.blade.php', array_keys($options));
+            $this->assertContains('article-excerpt.blade.php', array_values($options));
+        });
+
+        $this->artisan('publish:views components --interactive')
+            ->expectsOutput('Published files [article-excerpt.blade.php]')
+            ->assertExitCode(0);
+
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+
+        File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
+    }
+
+    public function testInteractiveSelectionOnWindowsSystems()
+    {
+        if (! windows_os()) {
+            $this->markTestSkipped('This test is only for Windows OS');
+        }
+
+        $this->artisan('publish:views components --interactive')
+            ->expectsOutput('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.')
+            ->assertExitCode(1);
+    }
 }

From 366c42d0b697d2a43d88a0ca08a32cdfa0829ac2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:06:53 +0100
Subject: [PATCH 3724/4023] Mock test state

---
 .../Feature/Commands/PublishViewsCommandTest.php     | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index d3999f7266e..0cfab769e6b 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -54,9 +54,7 @@ public function testWithInvalidSuppliedTag()
 
     public function testInteractiveSelectionOnUnixSystems()
     {
-        if (windows_os()) {
-            $this->markTestSkipped('Laravel Prompts does not support Windows OS');
-        }
+        ConsoleHelper::mockWindowsOs(false);
 
         ConsoleHelper::mockMultiselect(['resources/views/vendor/hyde/components/article-excerpt.blade.php'], function ($label, $options) {
             $this->assertEquals('Select the files you want to publish (CTRL+A to toggle all)', $label);
@@ -77,12 +75,12 @@ public function testInteractiveSelectionOnUnixSystems()
 
     public function testInteractiveSelectionOnWindowsSystems()
     {
-        if (! windows_os()) {
-            $this->markTestSkipped('This test is only for Windows OS');
-        }
+        ConsoleHelper::mockWindowsOs();
 
         $this->artisan('publish:views components --interactive')
             ->expectsOutput('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.')
-            ->assertExitCode(1);
+            ->assertExitCode(0);
+
+        File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
     }
 }

From f64240bca83951f1df01119440458f6d22759eca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:07:54 +0100
Subject: [PATCH 3725/4023] Refactor to add check earlier so we can fail
 command

---
 .../src/Console/Commands/PublishViewsCommand.php     | 12 ++++++------
 .../Feature/Commands/PublishViewsCommandTest.php     |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 88c2280b729..fc256261585 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -45,6 +45,12 @@ class PublishViewsCommand extends Command
 
     public function handle(): int
     {
+        if ($this->isInteractive() && ConsoleHelper::usesWindowsOs()) {
+            $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
+
+            return Command::FAILURE;
+        }
+
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
         if ($selected === 'all' || $selected === '') {
@@ -67,12 +73,6 @@ protected function publishOption(string $selected): void
     {
         // Todo: Don't trigger interactive if "all" is selected
         if ($this->isInteractive()) {
-            if (ConsoleHelper::usesWindowsOs()) {
-                // Laravel Prompts supports macOS, Linux, and Windows with WSL. Due to limitations in the Windows version of PHP, it is not currently possible to use Laravel Prompts on Windows outside of WSL.
-
-                $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
-            }
-
             $this->handleInteractivePublish($selected);
 
             return;
diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 0cfab769e6b..23a5685f7f4 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -79,7 +79,7 @@ public function testInteractiveSelectionOnWindowsSystems()
 
         $this->artisan('publish:views components --interactive')
             ->expectsOutput('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.')
-            ->assertExitCode(0);
+            ->assertExitCode(1);
 
         File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
     }

From 86ac4a6f29292b06ce5994cbbc3cbbdbdbddbca5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:08:42 +0100
Subject: [PATCH 3726/4023] Clean up after test

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php     | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 23a5685f7f4..ecd5a5274c7 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -83,4 +83,11 @@ public function testInteractiveSelectionOnWindowsSystems()
 
         File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
     }
+
+    protected function tearDown(): void
+    {
+        ConsoleHelper::clearMocks();
+        
+        parent::tearDown();
+    }
 }

From 0200cc690d64f915b3423b8027911988c3f3768d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:12:58 +0100
Subject: [PATCH 3727/4023] Cleanup test

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index ecd5a5274c7..abfd5712c71 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -56,8 +56,8 @@ public function testInteractiveSelectionOnUnixSystems()
     {
         ConsoleHelper::mockWindowsOs(false);
 
-        ConsoleHelper::mockMultiselect(['resources/views/vendor/hyde/components/article-excerpt.blade.php'], function ($label, $options) {
-            $this->assertEquals('Select the files you want to publish (CTRL+A to toggle all)', $label);
+        ConsoleHelper::mockMultiselect(['resources/views/vendor/hyde/components/article-excerpt.blade.php'], function (string $label, array $options) {
+            $this->assertSame('Select the files you want to publish (CTRL+A to toggle all)', $label);
             $this->assertContainsOnly('string', array_keys($options));
             $this->assertContainsOnly('string', array_values($options));
             $this->assertContains('resources/views/vendor/hyde/components/article-excerpt.blade.php', array_keys($options));
@@ -87,7 +87,7 @@ public function testInteractiveSelectionOnWindowsSystems()
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();
-        
+
         parent::tearDown();
     }
 }

From 6824637be4674c072898c817ab90c866fed8ca3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:18:25 +0100
Subject: [PATCH 3728/4023] Also bail if the stream is not interactive

This pre-evaluates the check Laravel Prompts makes, to ensure we don't use their fallback.
---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index fc256261585..a8afad74ede 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -45,7 +45,7 @@ class PublishViewsCommand extends Command
 
     public function handle(): int
     {
-        if ($this->isInteractive() && ConsoleHelper::usesWindowsOs()) {
+        if ($this->isInteractive() && (ConsoleHelper::usesWindowsOs() || ! stream_isatty(STDIN))) {
             $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
 
             return Command::FAILURE;

From e72985ac6b2ed756eb0256a184868278660be1ae Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:23:28 +0100
Subject: [PATCH 3729/4023] Revert "Also bail if the stream is not interactive"

This reverts commit ab6ef83149fe0e92641cae5ae98ad6e6312770d3.
---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index a8afad74ede..fc256261585 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -45,7 +45,7 @@ class PublishViewsCommand extends Command
 
     public function handle(): int
     {
-        if ($this->isInteractive() && (ConsoleHelper::usesWindowsOs() || ! stream_isatty(STDIN))) {
+        if ($this->isInteractive() && ConsoleHelper::usesWindowsOs()) {
             $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
 
             return Command::FAILURE;

From 802a9abfc7d8497e1b952d27bcfa8560e1adbe58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:38:03 +0100
Subject: [PATCH 3730/4023] Mock the application

---
 .../InteractivePublishCommandHelperTest.php   | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index c753b88a858..b1d552d38c2 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -4,7 +4,12 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
+use Illuminate\Container\Container;
+use Illuminate\Support\Facades\Blade;
+use Mockery;
 
 /**
  * @covers \Hyde\Console\Helpers\InteractivePublishCommandHelper
@@ -13,16 +18,40 @@
  */
 class InteractivePublishCommandHelperTest extends UnitTestCase
 {
+    protected static bool $needsKernel = true;
+
     /** @var \Illuminate\Filesystem\Filesystem&\Mockery\MockInterface */
     protected $filesystem;
 
+    protected $originalApp;
+
     protected function setUp(): void
     {
         $this->filesystem = $this->mockFilesystemStrict();
+
+        Blade::partialMock()->shouldReceive('component');
+
+        $app = $this->setupMockApplication();
+
+        (new ViewServiceProvider($app))->boot();
     }
 
     protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
+
+        Container::setInstance($this->originalApp);
+    }
+
+    protected function setupMockApplication(): Container
+    {
+        $this->originalApp = Container::getInstance();
+
+        $app = Mockery::mock(app())->makePartial();
+        $app->shouldReceive('resourcePath')->andReturn(Hyde::path('resources'));
+
+        Container::setInstance($app);
+
+        return $app;
     }
 }

From b3faee766f37e9ae29a87a3025e85da88a1c77e5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 17:38:12 +0100
Subject: [PATCH 3731/4023] Annotate literal parameters

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php      | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ddfaada280a..45dd1585d04 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -27,6 +27,7 @@ class InteractivePublishCommandHelper
     /** @var array<string, string> Map of source files to target files */
     protected readonly array $publishableFilesMap;
 
+    /** @param "hyde-layouts"|"hyde-components"|"hyde-page-404" $group */
     public function __construct(string $group)
     {
         $this->group = $group;

From 7b4003d63affde30aaf7056ecec3376b30a97b85 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 18:46:23 +0100
Subject: [PATCH 3732/4023] Annotate array types

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 45dd1585d04..17af8424783 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -70,6 +70,10 @@ protected function findAllFilesForTag(): array
         return File::allFiles($this->sourceDirectory);
     }
 
+    /**
+     * @param \Symfony\Component\Finder\SplFileInfo[] $search
+     * @return array<string, string>
+     */
     protected function mapPublishableFiles(array $search): array
     {
         return Arr::mapWithKeys($search, /** @return array<string, string> */ function (SplFileInfo $file): array {
@@ -79,6 +83,7 @@ protected function mapPublishableFiles(array $search): array
         });
     }
 
+    /** @param array<string, string> $selectedFiles */
     protected function publishFiles(array $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {
@@ -87,6 +92,7 @@ protected function publishFiles(array $selectedFiles): void
         }
     }
 
+    /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
         $publishedFiles = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');

From 6fa6b357dffe06432d44ceb736d2d7297f9ff088 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 19:16:51 +0100
Subject: [PATCH 3733/4023] Implement the unit test

---
 .../InteractivePublishCommandHelperTest.php   | 58 ++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index b1d552d38c2..7e47c969909 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -4,12 +4,16 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
+use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Container\Container;
 use Illuminate\Support\Facades\Blade;
+use Illuminate\Support\Facades\Facade;
+use Illuminate\Support\Facades\File;
 use Mockery;
+use Symfony\Component\Finder\SplFileInfo;
 
 /**
  * @covers \Hyde\Console\Helpers\InteractivePublishCommandHelper
@@ -29,6 +33,7 @@ protected function setUp(): void
     {
         $this->filesystem = $this->mockFilesystemStrict();
 
+        File::swap($this->filesystem);
         Blade::partialMock()->shouldReceive('component');
 
         $app = $this->setupMockApplication();
@@ -41,6 +46,57 @@ protected function tearDown(): void
         $this->verifyMockeryExpectations();
 
         Container::setInstance($this->originalApp);
+        Facade::clearResolvedInstances();
+    }
+
+    public function testGetFileChoices()
+    {
+        $this->filesystem->shouldReceive('allFiles')->andReturn([
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/app.blade.php'), '', 'app.blade.php'),
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/page.blade.php'), '', 'page.blade.php'),
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/post.blade.php'), '', 'post.blade.php'),
+        ]);
+
+        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+
+        $this->assertSame([
+            'resources/views/vendor/hyde/layouts/app.blade.php' => 'app.blade.php',
+            'resources/views/vendor/hyde/layouts/page.blade.php' => 'page.blade.php',
+            'resources/views/vendor/hyde/layouts/post.blade.php' => 'post.blade.php',
+        ], $helper->getFileChoices());
+    }
+
+    public function testHandle()
+    {
+        $this->filesystem->shouldReceive('allFiles')->andReturn([
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/app.blade.php'), '', 'app.blade.php'),
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/page.blade.php'), '', 'page.blade.php'),
+            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/post.blade.php'), '', 'post.blade.php'),
+        ]);
+
+        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+
+        $this->filesystem->shouldReceive('ensureDirectoryExists')->twice();
+        $this->filesystem->shouldReceive('copy')->twice();
+
+        $helper->handle([
+            "resources/views/vendor/hyde/layouts/app.blade.php",
+            "resources/views/vendor/hyde/layouts/page.blade.php",
+        ]);
+
+        $this->filesystem->shouldHaveReceived('ensureDirectoryExists')
+            ->with(Hyde::path('resources/views/vendor/hyde/layouts'))
+            ->twice();
+
+        $this->filesystem->shouldHaveReceived('copy')->with(
+            Hyde::path('packages/framework/resources/views/layouts/app.blade.php'),
+            Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php')
+        )->once();
+
+        $this->filesystem->shouldHaveReceived('copy')->with(
+            Hyde::path('packages/framework/resources/views/layouts/page.blade.php'),
+            Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php')
+        )->once();
     }
 
     protected function setupMockApplication(): Container
@@ -48,7 +104,7 @@ protected function setupMockApplication(): Container
         $this->originalApp = Container::getInstance();
 
         $app = Mockery::mock(app())->makePartial();
-        $app->shouldReceive('resourcePath')->andReturn(Hyde::path('resources'));
+        $app->shouldReceive('resourcePath')->andReturnUsing(fn (string $path) => "resources/$path");
 
         Container::setInstance($app);
 

From 31a1400b428c8d0073a143c81699017e34864e61 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 19:17:50 +0100
Subject: [PATCH 3734/4023] Cleanup code and use real app

---
 .../InteractivePublishCommandHelper.php       |  2 +-
 .../InteractivePublishCommandHelperTest.php   | 38 +++++++------------
 2 files changed, 15 insertions(+), 25 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 17af8424783..09bb7fa7247 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -71,7 +71,7 @@ protected function findAllFilesForTag(): array
     }
 
     /**
-     * @param \Symfony\Component\Finder\SplFileInfo[] $search
+     * @param  \Symfony\Component\Finder\SplFileInfo[]  $search
      * @return array<string, string>
      */
     protected function mapPublishableFiles(array $search): array
diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 7e47c969909..d603734a5bd 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -4,15 +4,17 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Testing\CreatesApplication;
+use Illuminate\Filesystem\Filesystem;
+use Mockery;
 use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
+use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Container\Container;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Support\Facades\Facade;
 use Illuminate\Support\Facades\File;
-use Mockery;
 use Symfony\Component\Finder\SplFileInfo;
 
 /**
@@ -22,22 +24,22 @@
  */
 class InteractivePublishCommandHelperTest extends UnitTestCase
 {
-    protected static bool $needsKernel = true;
+    use CreatesApplication;
 
-    /** @var \Illuminate\Filesystem\Filesystem&\Mockery\MockInterface */
-    protected $filesystem;
+    protected static bool $needsKernel = true;
 
-    protected $originalApp;
+    protected Filesystem|Mockery\MockInterface $filesystem;
 
     protected function setUp(): void
     {
+        $app = $this->createApplication();
+        Container::setInstance($app);
+
         $this->filesystem = $this->mockFilesystemStrict();
 
         File::swap($this->filesystem);
         Blade::partialMock()->shouldReceive('component');
 
-        $app = $this->setupMockApplication();
-
         (new ViewServiceProvider($app))->boot();
     }
 
@@ -45,7 +47,7 @@ protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
 
-        Container::setInstance($this->originalApp);
+        Container::setInstance();
         Facade::clearResolvedInstances();
     }
 
@@ -80,8 +82,8 @@ public function testHandle()
         $this->filesystem->shouldReceive('copy')->twice();
 
         $helper->handle([
-            "resources/views/vendor/hyde/layouts/app.blade.php",
-            "resources/views/vendor/hyde/layouts/page.blade.php",
+            'resources/views/vendor/hyde/layouts/app.blade.php',
+            'resources/views/vendor/hyde/layouts/page.blade.php',
         ]);
 
         $this->filesystem->shouldHaveReceived('ensureDirectoryExists')
@@ -98,16 +100,4 @@ public function testHandle()
             Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php')
         )->once();
     }
-
-    protected function setupMockApplication(): Container
-    {
-        $this->originalApp = Container::getInstance();
-
-        $app = Mockery::mock(app())->makePartial();
-        $app->shouldReceive('resourcePath')->andReturnUsing(fn (string $path) => "resources/$path");
-
-        Container::setInstance($app);
-
-        return $app;
-    }
 }

From 540c0c431c0ba6a17e0d1b2f2a2de7533f7cffeb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 21:07:07 +0100
Subject: [PATCH 3735/4023] Add final unit test

---
 .../Unit/InteractivePublishCommandHelperTest.php  | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index d603734a5bd..a8904134050 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -100,4 +100,19 @@ public function testHandle()
             Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php')
         )->once();
     }
+
+    public function testFormatOutput()
+    {
+        $this->filesystem->shouldReceive('allFiles')->andReturn([]);
+
+        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+
+        $output = $helper->formatOutput([
+            'resources/views/vendor/hyde/layouts/app.blade.php',
+            'resources/views/vendor/hyde/layouts/page.blade.php',
+            'resources/views/vendor/hyde/layouts/post.blade.php',
+        ]);
+
+        $this->assertSame('Published files [app.blade.php, page.blade.php, post.blade.php]', $output);
+    }
 }

From 24384713cf65ab808c65738a159998e032b97874 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 21:15:09 +0100
Subject: [PATCH 3736/4023] Refactor to mock by default

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php         | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index a8904134050..ae1049c7a18 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -36,6 +36,7 @@ protected function setUp(): void
         Container::setInstance($app);
 
         $this->filesystem = $this->mockFilesystemStrict();
+        $this->filesystem->shouldReceive('allFiles')->andReturn([])->byDefault();
 
         File::swap($this->filesystem);
         Blade::partialMock()->shouldReceive('component');
@@ -103,8 +104,6 @@ public function testHandle()
 
     public function testFormatOutput()
     {
-        $this->filesystem->shouldReceive('allFiles')->andReturn([]);
-
         $helper = new InteractivePublishCommandHelper('hyde-layouts');
 
         $output = $helper->formatOutput([

From 8e45658b5868fdb5fb9c55534f930cc67961286f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 22 Dec 2024 21:44:17 +0100
Subject: [PATCH 3737/4023] Simplify setup

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php         | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index ae1049c7a18..524ae82dc36 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -11,7 +11,6 @@
 use Hyde\Testing\UnitTestCase;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Illuminate\Container\Container;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Support\Facades\Facade;
 use Illuminate\Support\Facades\File;
@@ -33,7 +32,6 @@ class InteractivePublishCommandHelperTest extends UnitTestCase
     protected function setUp(): void
     {
         $app = $this->createApplication();
-        Container::setInstance($app);
 
         $this->filesystem = $this->mockFilesystemStrict();
         $this->filesystem->shouldReceive('allFiles')->andReturn([])->byDefault();
@@ -48,7 +46,6 @@ protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
 
-        Container::setInstance();
         Facade::clearResolvedInstances();
     }
 

From 4394f66bb75bdf27efcb7e2ba41da2f4691308ed Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:11:16 +0100
Subject: [PATCH 3738/4023] Add testing helper

---
 .../InteractivePublishCommandHelperTest.php    | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 524ae82dc36..7e9eb113b5e 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -111,4 +111,22 @@ public function testFormatOutput()
 
         $this->assertSame('Published files [app.blade.php, page.blade.php, post.blade.php]', $output);
     }
+
+    protected function selectedFiles(int $take = 10): array
+    {
+        $files = [
+            "resources/views/vendor/hyde/layouts/app.blade.php",
+            "resources/views/vendor/hyde/layouts/docs.blade.php",
+            "resources/views/vendor/hyde/layouts/footer.blade.php",
+            "resources/views/vendor/hyde/layouts/head.blade.php",
+            "resources/views/vendor/hyde/layouts/meta.blade.php",
+            "resources/views/vendor/hyde/layouts/navigation.blade.php",
+            "resources/views/vendor/hyde/layouts/page.blade.php",
+            "resources/views/vendor/hyde/layouts/post.blade.php",
+            "resources/views/vendor/hyde/layouts/scripts.blade.php",
+            "resources/views/vendor/hyde/layouts/styles.blade.php",
+        ];
+
+        return array_slice($files, 0, $take);
+    }
 }

From 9f37161b94a9b2c73e13acdddc693c4fdb427703 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:14:52 +0100
Subject: [PATCH 3739/4023] Use proper single file pluralization

---
 .../Console/Helpers/InteractivePublishCommandHelper.php  | 4 +++-
 .../tests/Unit/InteractivePublishCommandHelperTest.php   | 9 +++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 09bb7fa7247..c5047dc6025 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -97,7 +97,9 @@ public function formatOutput(array $selectedFiles): string
     {
         $publishedFiles = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');
 
-        return sprintf('Published files [%s]', $publishedFiles);
+        $files = count($selectedFiles) === 1 ? 'file' : 'files';
+
+        return sprintf('Published ' . $files . ' [%s]', $publishedFiles);
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string
diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 7e9eb113b5e..52de4fdae44 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -112,6 +112,15 @@ public function testFormatOutput()
         $this->assertSame('Published files [app.blade.php, page.blade.php, post.blade.php]', $output);
     }
 
+    public function testFormatOutputWithSingleFile()
+    {
+        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+
+        $output = $helper->formatOutput($this->selectedFiles(1));
+
+        $this->assertSame('Published file [app.blade.php]', $output);
+    }
+
     protected function selectedFiles(int $take = 10): array
     {
         $files = [

From f71272d12cb73a3a21e98846dee11cb0d7bf7864 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:17:31 +0100
Subject: [PATCH 3740/4023] More Laravely formatting

---
 .../Helpers/InteractivePublishCommandHelper.php     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index c5047dc6025..813ad007304 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -95,11 +95,14 @@ protected function publishFiles(array $selectedFiles): void
     /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
-        $publishedFiles = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))->implode(', ');
-
-        $files = count($selectedFiles) === 1 ? 'file' : 'files';
-
-        return sprintf('Published ' . $files . ' [%s]', $publishedFiles);
+        $publishedFiles = collect($selectedFiles)
+            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))
+            ->implode(', ');
+
+        return sprintf('Published %s [%s]',
+            Str::plural('file', count($selectedFiles)),
+            $publishedFiles
+        );
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string

From 789539105fdfd0f6e8e4afa9a6ed593da6e11bc3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:21:39 +0100
Subject: [PATCH 3741/4023] Extract helper method

---
 .../Helpers/InteractivePublishCommandHelper.php      | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 813ad007304..0a1ccae71cb 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -95,9 +95,7 @@ protected function publishFiles(array $selectedFiles): void
     /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
-        $publishedFiles = collect($selectedFiles)
-            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))
-            ->implode(', ');
+        $publishedFiles = $this->mapPathsToRelativeDirectories($selectedFiles);
 
         return sprintf('Published %s [%s]',
             Str::plural('file', count($selectedFiles)),
@@ -118,4 +116,12 @@ protected function filterPublishableFiles(array $selectedFiles): array
     {
         return array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
     }
+
+    /** @param array<string> $selectedFiles */
+    protected function mapPathsToRelativeDirectories(array $selectedFiles): string
+    {
+        return collect($selectedFiles)
+            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))
+            ->implode(', ');
+    }
 }

From dbb49aa5f0020f5b8f793afb93200833e69fedf8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:22:08 +0100
Subject: [PATCH 3742/4023] Clearer helper method name

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 0a1ccae71cb..6e6e0f86386 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -95,7 +95,7 @@ protected function publishFiles(array $selectedFiles): void
     /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
-        $publishedFiles = $this->mapPathsToRelativeDirectories($selectedFiles);
+        $publishedFiles = $this->mapPathsToRelativeDirectoryString($selectedFiles);
 
         return sprintf('Published %s [%s]',
             Str::plural('file', count($selectedFiles)),
@@ -118,7 +118,7 @@ protected function filterPublishableFiles(array $selectedFiles): array
     }
 
     /** @param array<string> $selectedFiles */
-    protected function mapPathsToRelativeDirectories(array $selectedFiles): string
+    protected function mapPathsToRelativeDirectoryString(array $selectedFiles): string
     {
         return collect($selectedFiles)
             ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))

From 945d5f1bc8fc7847443e9792315e67ad8fd5d4bb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:22:18 +0100
Subject: [PATCH 3743/4023] Inline local variable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 6e6e0f86386..f476cf9356e 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -95,11 +95,9 @@ protected function publishFiles(array $selectedFiles): void
     /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
-        $publishedFiles = $this->mapPathsToRelativeDirectoryString($selectedFiles);
-
         return sprintf('Published %s [%s]',
             Str::plural('file', count($selectedFiles)),
-            $publishedFiles
+            $this->mapPathsToRelativeDirectoryString($selectedFiles)
         );
     }
 

From 988a1dc68de18c4c3ee11967b376239867ed9122 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:22:56 +0100
Subject: [PATCH 3744/4023] Helper method

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php     | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 52de4fdae44..b1239c3b3da 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -114,13 +114,18 @@ public function testFormatOutput()
 
     public function testFormatOutputWithSingleFile()
     {
-        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+        $helper = $this->getHelper();
 
         $output = $helper->formatOutput($this->selectedFiles(1));
 
         $this->assertSame('Published file [app.blade.php]', $output);
     }
 
+    protected function getHelper(): InteractivePublishCommandHelper
+    {
+        return new InteractivePublishCommandHelper('hyde-layouts');
+    }
+
     protected function selectedFiles(int $take = 10): array
     {
         $files = [

From a799498c7d39f77b086df2a267279e4a98c09f0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:23:13 +0100
Subject: [PATCH 3745/4023] Inline variable

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php        | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index b1239c3b3da..33d356dfd83 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -114,9 +114,7 @@ public function testFormatOutput()
 
     public function testFormatOutputWithSingleFile()
     {
-        $helper = $this->getHelper();
-
-        $output = $helper->formatOutput($this->selectedFiles(1));
+        $output = $this->getHelper()->formatOutput($this->selectedFiles(1));
 
         $this->assertSame('Published file [app.blade.php]', $output);
     }

From 63c8b61f9537d93a611f64ef117c413812d7bab2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:34:17 +0100
Subject: [PATCH 3746/4023] Implement dynamic formatting

---
 .../InteractivePublishCommandHelper.php       | 21 +++++++++++++++----
 .../InteractivePublishCommandHelperTest.php   | 14 +++++++++++++
 2 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index f476cf9356e..3453d4b0d1a 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -11,6 +11,7 @@
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
+use Illuminate\Support\Stringable;
 use Symfony\Component\Finder\SplFileInfo;
 
 use function Hyde\path_join;
@@ -95,10 +96,22 @@ protected function publishFiles(array $selectedFiles): void
     /** @param array<string> $selectedFiles */
     public function formatOutput(array $selectedFiles): string
     {
-        return sprintf('Published %s [%s]',
-            Str::plural('file', count($selectedFiles)),
-            $this->mapPathsToRelativeDirectoryString($selectedFiles)
-        );
+        $fileCount = count($selectedFiles);
+        $displayLimit = 3;
+
+        $fileNames = collect($selectedFiles)
+            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory));
+
+        $displayFiles = $fileNames->take($displayLimit)->implode(', ');
+
+        return Str::of('Published')
+            ->append(' ', Str::plural('file', $fileCount))
+            ->append(' [', $displayFiles, ']')
+            ->when(
+                $fileCount > $displayLimit,
+                fn (Stringable $str): Stringable => $str->append(' and ', $fileCount - $displayLimit, ' more')
+            )
+            ->toString();
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string
diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 33d356dfd83..16358208306 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -119,6 +119,20 @@ public function testFormatOutputWithSingleFile()
         $this->assertSame('Published file [app.blade.php]', $output);
     }
 
+    public function testFormatOutputWithMultipleFiles()
+    {
+        $output = $this->getHelper()->formatOutput($this->selectedFiles(3));
+
+        $this->assertSame('Published files [app.blade.php, docs.blade.php, footer.blade.php]', $output);
+    }
+
+    public function testFormatOutputWithManyFiles()
+    {
+        $output = $this->getHelper()->formatOutput($this->selectedFiles(7));
+
+        $this->assertSame('Published files [app.blade.php, docs.blade.php, footer.blade.php] and 4 more', $output);
+    }
+
     protected function getHelper(): InteractivePublishCommandHelper
     {
         return new InteractivePublishCommandHelper('hyde-layouts');

From 95a305c387600700215f6cc0c01ef1c26b34eb82 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:35:01 +0100
Subject: [PATCH 3747/4023] Remove inlined helper method

---
 .../Console/Helpers/InteractivePublishCommandHelper.php   | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 3453d4b0d1a..3effb18a02e 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -127,12 +127,4 @@ protected function filterPublishableFiles(array $selectedFiles): array
     {
         return array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
     }
-
-    /** @param array<string> $selectedFiles */
-    protected function mapPathsToRelativeDirectoryString(array $selectedFiles): string
-    {
-        return collect($selectedFiles)
-            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory))
-            ->implode(', ');
-    }
 }

From 84b54598b746b976d171eabe5082248aa8e5cdda Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:41:45 +0100
Subject: [PATCH 3748/4023] Go really crazy with the formatting

---
 .../InteractivePublishCommandHelper.php       | 17 ++++++-
 .../InteractivePublishCommandHelperTest.php   | 48 ++++++++++++++-----
 2 files changed, 51 insertions(+), 14 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 3effb18a02e..416d45c027f 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -93,7 +93,11 @@ protected function publishFiles(array $selectedFiles): void
         }
     }
 
-    /** @param array<string> $selectedFiles */
+    /**
+     * @experimental This method may be toned down in the future.
+     *
+     * @param  array<string>  $selectedFiles
+     */
     public function formatOutput(array $selectedFiles): string
     {
         $fileCount = count($selectedFiles);
@@ -105,7 +109,11 @@ public function formatOutput(array $selectedFiles): string
         $displayFiles = $fileNames->take($displayLimit)->implode(', ');
 
         return Str::of('Published')
-            ->append(' ', Str::plural('file', $fileCount))
+            ->when(
+                $fileCount === $this->publishableFilesMapCount(),
+                fn (Stringable $str): Stringable => $str->append(' all files, including'),
+                fn (Stringable $str): Stringable => $str->append(' ', Str::plural('file', $fileCount))
+            )
             ->append(' [', $displayFiles, ']')
             ->when(
                 $fileCount > $displayLimit,
@@ -127,4 +135,9 @@ protected function filterPublishableFiles(array $selectedFiles): array
     {
         return array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
     }
+
+    protected function publishableFilesMapCount(): int
+    {
+        return count($this->publishableFilesMap);
+    }
 }
diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 16358208306..afbe6c8c4b6 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -133,26 +133,50 @@ public function testFormatOutputWithManyFiles()
         $this->assertSame('Published files [app.blade.php, docs.blade.php, footer.blade.php] and 4 more', $output);
     }
 
-    protected function getHelper(): InteractivePublishCommandHelper
+    public function testFormatOutputWithAllFiles()
     {
-        return new InteractivePublishCommandHelper('hyde-layouts');
+        $output = $this->getHelper()->mockPublishableFileCount(10)->formatOutput($this->selectedFiles(10));
+
+        $this->assertSame('Published all files, including [app.blade.php, docs.blade.php, footer.blade.php] and 7 more', $output);
+    }
+
+    protected function getHelper(): MockableInteractivePublishCommandHelper
+    {
+        return new MockableInteractivePublishCommandHelper('hyde-layouts');
     }
 
     protected function selectedFiles(int $take = 10): array
     {
         $files = [
-            "resources/views/vendor/hyde/layouts/app.blade.php",
-            "resources/views/vendor/hyde/layouts/docs.blade.php",
-            "resources/views/vendor/hyde/layouts/footer.blade.php",
-            "resources/views/vendor/hyde/layouts/head.blade.php",
-            "resources/views/vendor/hyde/layouts/meta.blade.php",
-            "resources/views/vendor/hyde/layouts/navigation.blade.php",
-            "resources/views/vendor/hyde/layouts/page.blade.php",
-            "resources/views/vendor/hyde/layouts/post.blade.php",
-            "resources/views/vendor/hyde/layouts/scripts.blade.php",
-            "resources/views/vendor/hyde/layouts/styles.blade.php",
+            'resources/views/vendor/hyde/layouts/app.blade.php',
+            'resources/views/vendor/hyde/layouts/docs.blade.php',
+            'resources/views/vendor/hyde/layouts/footer.blade.php',
+            'resources/views/vendor/hyde/layouts/head.blade.php',
+            'resources/views/vendor/hyde/layouts/meta.blade.php',
+            'resources/views/vendor/hyde/layouts/navigation.blade.php',
+            'resources/views/vendor/hyde/layouts/page.blade.php',
+            'resources/views/vendor/hyde/layouts/post.blade.php',
+            'resources/views/vendor/hyde/layouts/scripts.blade.php',
+            'resources/views/vendor/hyde/layouts/styles.blade.php',
         ];
 
         return array_slice($files, 0, $take);
     }
 }
+
+class MockableInteractivePublishCommandHelper extends InteractivePublishCommandHelper
+{
+    public ?int $mockedPublishableFilesMapCount = null;
+
+    public function mockPublishableFileCount(int $count): self
+    {
+        $this->mockedPublishableFilesMapCount = $count;
+
+        return $this;
+    }
+
+    protected function publishableFilesMapCount(): int
+    {
+        return $this->mockedPublishableFilesMapCount ?? parent::publishableFilesMapCount();
+    }
+}

From 1cabc8b4277d990a7add9b83ad2b459621dad30b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 23 Dec 2024 19:44:09 +0100
Subject: [PATCH 3749/4023] Expect smarter formatting

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index abfd5712c71..7b7afb95c1b 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -65,7 +65,7 @@ public function testInteractiveSelectionOnUnixSystems()
         });
 
         $this->artisan('publish:views components --interactive')
-            ->expectsOutput('Published files [article-excerpt.blade.php]')
+            ->expectsOutput('Published file [article-excerpt.blade.php]')
             ->assertExitCode(0);
 
         $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));

From e9a1dda90a63982cd96a58a11c7a4033b1c49b6e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 24 Dec 2024 10:16:44 +0100
Subject: [PATCH 3750/4023] Cleanup formatting

---
 .../Console/Helpers/InteractivePublishCommandHelper.php  | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 416d45c027f..4f2e91e1012 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -103,20 +103,17 @@ public function formatOutput(array $selectedFiles): string
         $fileCount = count($selectedFiles);
         $displayLimit = 3;
 
-        $fileNames = collect($selectedFiles)
-            ->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory));
+        $fileNames = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory));
 
         $displayFiles = $fileNames->take($displayLimit)->implode(', ');
 
         return Str::of('Published')
-            ->when(
-                $fileCount === $this->publishableFilesMapCount(),
+            ->when($fileCount === $this->publishableFilesMapCount(),
                 fn (Stringable $str): Stringable => $str->append(' all files, including'),
                 fn (Stringable $str): Stringable => $str->append(' ', Str::plural('file', $fileCount))
             )
             ->append(' [', $displayFiles, ']')
-            ->when(
-                $fileCount > $displayLimit,
+            ->when($fileCount > $displayLimit,
                 fn (Stringable $str): Stringable => $str->append(' and ', $fileCount - $displayLimit, ' more')
             )
             ->toString();

From 38d8a21fe3131eeeee11baa8e6fc37b6914997b5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 24 Dec 2024 19:49:16 +0100
Subject: [PATCH 3751/4023] Create ConsoleHelperTest.php

---
 .../tests/Unit/ConsoleHelperTest.php          | 91 +++++++++++++++++++
 1 file changed, 91 insertions(+)
 create mode 100644 packages/framework/tests/Unit/ConsoleHelperTest.php

diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
new file mode 100644
index 00000000000..51490edf35f
--- /dev/null
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Console\Helpers\ConsoleHelper;
+use Hyde\Testing\UnitTestCase;
+
+/**
+ * @covers \Hyde\Console\Helpers\ConsoleHelper
+ */
+class ConsoleHelperTest extends UnitTestCase
+{
+    protected function setUp(): void
+    {
+        ConsoleHelper::clearMocks();
+    }
+
+    protected function tearDown(): void
+    {
+        ConsoleHelper::clearMocks();
+    }
+
+    public function testClearMocksClearsAllMocks()
+    {
+        // Set up some mocks
+        ConsoleHelper::mockWindowsOs(true);
+        ConsoleHelper::mockMultiselect(['option1']);
+
+        // Clear mocks
+        ConsoleHelper::clearMocks();
+
+        // Assert mocks are cleared by checking default behavior is restored
+        $this->assertSame(windows_os(), ConsoleHelper::usesWindowsOs());
+    }
+
+    public function testUsesWindowsOsReturnsSystemValueByDefault()
+    {
+        $this->assertSame(windows_os(), ConsoleHelper::usesWindowsOs());
+    }
+
+    public function testUsesWindowsOsReturnsMockedValue()
+    {
+        ConsoleHelper::mockWindowsOs(true);
+        $this->assertTrue(ConsoleHelper::usesWindowsOs());
+
+        ConsoleHelper::mockWindowsOs(false);
+        $this->assertFalse(ConsoleHelper::usesWindowsOs());
+    }
+
+    public function testMultiselectReturnsMockedValues()
+    {
+        $mockedReturn = ['option1', 'option2'];
+        ConsoleHelper::mockMultiselect($mockedReturn);
+
+        $result = ConsoleHelper::multiselect(
+            'Select options',
+            ['option1', 'option2', 'option3'],
+            []
+        );
+
+        $this->assertSame($mockedReturn, $result);
+    }
+
+    public function testMultiselectAssertionCallbackIsExecuted()
+    {
+        $wasCalled = false;
+        $expectedLabel = 'Select options';
+        $expectedOptions = ['option1', 'option2'];
+        $expectedDefault = ['option1'];
+
+        ConsoleHelper::mockMultiselect(
+            ['option1'],
+            function ($label, $options, $default) use (
+                $expectedLabel,
+                $expectedOptions,
+                $expectedDefault,
+                &$wasCalled
+            ) {
+                $this->assertSame($expectedLabel, $label);
+                $this->assertSame($expectedOptions, $options);
+                $this->assertSame($expectedDefault, $default);
+                $wasCalled = true;
+            }
+        );
+
+        ConsoleHelper::multiselect($expectedLabel, $expectedOptions, $expectedDefault);
+        $this->assertTrue($wasCalled);
+    }
+}

From 65ebd7ecade9704a6032897c29262455fa8b4ffb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 24 Dec 2024 19:51:10 +0100
Subject: [PATCH 3752/4023] Add regression test

---
 .../tests/Unit/ConsoleHelperTest.php          | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index 51490edf35f..687ccd3d7b6 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -88,4 +88,59 @@ function ($label, $options, $default) use (
         ConsoleHelper::multiselect($expectedLabel, $expectedOptions, $expectedDefault);
         $this->assertTrue($wasCalled);
     }
+
+    public function testMultiselectSignatureMatchesLaravelPrompts()
+    {
+        $reflectionLaravel = new \ReflectionFunction('\Laravel\Prompts\multiselect');
+        $reflectionHelper = new \ReflectionMethod(ConsoleHelper::class, 'multiselect');
+
+        $laravelParams = $reflectionLaravel->getParameters();
+        $helperParams = $reflectionHelper->getParameters();
+
+        // Test parameter count
+        $this->assertCount(count($laravelParams), $helperParams, 'Parameter count mismatch');
+
+        // Test each parameter
+        foreach ($laravelParams as $index => $laravelParam) {
+            $helperParam = $helperParams[$index];
+
+            $this->assertSame(
+                $laravelParam->getName(),
+                $helperParam->getName(),
+                "Parameter name mismatch at position {$index}"
+            );
+
+            $this->assertEquals(
+                $laravelParam->getType(),
+                $helperParam->getType(),
+                "Parameter type mismatch for '{$laravelParam->getName()}'"
+            );
+
+            $this->assertSame(
+                $laravelParam->isOptional(),
+                $helperParam->isOptional(),
+                "Parameter optionality mismatch for '{$laravelParam->getName()}'"
+            );
+
+            if ($laravelParam->isDefaultValueAvailable()) {
+                $this->assertTrue(
+                    $helperParam->isDefaultValueAvailable(),
+                    "Default value availability mismatch for '{$laravelParam->getName()}'"
+                );
+
+                $this->assertEquals(
+                    $laravelParam->getDefaultValue(),
+                    $helperParam->getDefaultValue(),
+                    "Default value mismatch for '{$laravelParam->getName()}'"
+                );
+            }
+        }
+
+        // Test return type
+        $this->assertEquals(
+            $reflectionLaravel->getReturnType(),
+            $reflectionHelper->getReturnType(),
+            'Return type mismatch'
+        );
+    }
 }

From e9bee64e04f08fb3f13df746d2343bd34be7ac28 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 24 Dec 2024 19:51:23 +0100
Subject: [PATCH 3753/4023] Cleanup code

---
 packages/framework/tests/Unit/ConsoleHelperTest.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index 687ccd3d7b6..d599ed6561d 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -6,6 +6,8 @@
 
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Testing\UnitTestCase;
+use ReflectionFunction;
+use ReflectionMethod;
 
 /**
  * @covers \Hyde\Console\Helpers\ConsoleHelper
@@ -91,8 +93,8 @@ function ($label, $options, $default) use (
 
     public function testMultiselectSignatureMatchesLaravelPrompts()
     {
-        $reflectionLaravel = new \ReflectionFunction('\Laravel\Prompts\multiselect');
-        $reflectionHelper = new \ReflectionMethod(ConsoleHelper::class, 'multiselect');
+        $reflectionLaravel = new ReflectionFunction('\Laravel\Prompts\multiselect');
+        $reflectionHelper = new ReflectionMethod(ConsoleHelper::class, 'multiselect');
 
         $laravelParams = $reflectionLaravel->getParameters();
         $helperParams = $reflectionHelper->getParameters();

From 5143c0b2aa7e36064ee0948d4cae193a88568511 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 24 Dec 2024 19:57:51 +0100
Subject: [PATCH 3754/4023] Clean up formatting

---
 .../tests/Unit/ConsoleHelperTest.php          | 41 +++----------------
 1 file changed, 6 insertions(+), 35 deletions(-)

diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index d599ed6561d..027b70a1f0d 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -99,50 +99,21 @@ public function testMultiselectSignatureMatchesLaravelPrompts()
         $laravelParams = $reflectionLaravel->getParameters();
         $helperParams = $reflectionHelper->getParameters();
 
-        // Test parameter count
         $this->assertCount(count($laravelParams), $helperParams, 'Parameter count mismatch');
 
-        // Test each parameter
         foreach ($laravelParams as $index => $laravelParam) {
             $helperParam = $helperParams[$index];
 
-            $this->assertSame(
-                $laravelParam->getName(),
-                $helperParam->getName(),
-                "Parameter name mismatch at position {$index}"
-            );
-
-            $this->assertEquals(
-                $laravelParam->getType(),
-                $helperParam->getType(),
-                "Parameter type mismatch for '{$laravelParam->getName()}'"
-            );
-
-            $this->assertSame(
-                $laravelParam->isOptional(),
-                $helperParam->isOptional(),
-                "Parameter optionality mismatch for '{$laravelParam->getName()}'"
-            );
+            $this->assertSame($laravelParam->getName(), $helperParam->getName(), "Parameter name mismatch at position {$index}");
+            $this->assertEquals($laravelParam->getType(), $helperParam->getType(), "Parameter type mismatch for '{$laravelParam->getName()}'");
+            $this->assertSame($laravelParam->isOptional(), $helperParam->isOptional(), "Parameter optionality mismatch for '{$laravelParam->getName()}'");
 
             if ($laravelParam->isDefaultValueAvailable()) {
-                $this->assertTrue(
-                    $helperParam->isDefaultValueAvailable(),
-                    "Default value availability mismatch for '{$laravelParam->getName()}'"
-                );
-
-                $this->assertEquals(
-                    $laravelParam->getDefaultValue(),
-                    $helperParam->getDefaultValue(),
-                    "Default value mismatch for '{$laravelParam->getName()}'"
-                );
+                $this->assertTrue($helperParam->isDefaultValueAvailable(), "Default value availability mismatch for '{$laravelParam->getName()}'");
+                $this->assertEquals($laravelParam->getDefaultValue(), $helperParam->getDefaultValue(), "Default value mismatch for '{$laravelParam->getName()}'");
             }
         }
 
-        // Test return type
-        $this->assertEquals(
-            $reflectionLaravel->getReturnType(),
-            $reflectionHelper->getReturnType(),
-            'Return type mismatch'
-        );
+        $this->assertEquals($reflectionLaravel->getReturnType(), $reflectionHelper->getReturnType(), 'Return type mismatch');
     }
 }

From 88d7545a1355104ab6b7987169093f0e70a05a26 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 10:34:00 +0100
Subject: [PATCH 3755/4023] Don't trigger interactive if "all" is selected

---
 .../framework/src/Console/Commands/PublishViewsCommand.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index fc256261585..0891393006c 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -55,7 +55,7 @@ public function handle(): int
 
         if ($selected === 'all' || $selected === '') {
             foreach ($this->options as $key => $_ignored) {
-                $this->publishOption($key);
+                $this->publishOption($key, true);
             }
         } else {
             $this->publishOption($selected);
@@ -69,10 +69,9 @@ protected function isInteractive(): bool
         return $this->option('interactive');
     }
 
-    protected function publishOption(string $selected): void
+    protected function publishOption(string $selected, bool $isPublishingAll = false): void
     {
-        // Todo: Don't trigger interactive if "all" is selected
-        if ($this->isInteractive()) {
+        if ($this->isInteractive() && ! $isPublishingAll) {
             $this->handleInteractivePublish($selected);
 
             return;

From 88b9713c567736c4d38674157d1c05fbd8c9aae6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 10:38:05 +0100
Subject: [PATCH 3756/4023] Cleanup code with expanded func get args

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index ab10c68756b..64fcc4a57ce 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -45,13 +45,13 @@ public static function multiselect(string $label, array|Collection $options, arr
             $assertionCallback = static::$mocks['multiselectAssertion'] ?? null;
 
             if ($assertionCallback !== null) {
-                $assertionCallback($label, $options, $default, $scroll, $required, $validate, $hint, $transform);
+                $assertionCallback(...func_get_args());
             }
 
             return $returns;
         }
 
-        return multiselect($label, $options, $default, $scroll, $required, $validate, $hint, $transform);
+        return multiselect(...func_get_args());
     }
 
     public static function mockMultiselect(array $returns, ?Closure $assertionCallback = null): void

From 5791d2958ac35e176072a1c52955e0ebe4d0a661 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:01:38 +0100
Subject: [PATCH 3757/4023] Use Laravel Prompts for initial select

---
 .../Console/Commands/PublishViewsCommand.php    | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 0891393006c..cbfe37d1e5e 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,6 +9,7 @@
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Support\Facades\Artisan;
 
+use function Laravel\Prompts\select;
 use function str_replace;
 use function sprintf;
 use function strstr;
@@ -85,12 +86,16 @@ protected function publishOption(string $selected, bool $isPublishingAll = false
 
     protected function promptForCategory(): string
     {
-        /** @var string $choice */
-        $choice = $this->choice(
-            'Which category do you want to publish?',
-            $this->formatPublishableChoices(),
-            0
-        );
+        if ($this->isInteractive()) {
+            $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
+        } else {
+            /** @var string $choice */
+            $choice = $this->choice(
+                'Which category do you want to publish?',
+                $this->formatPublishableChoices(),
+                0
+            );
+        }
 
         $selection = $this->parseChoiceIntoKey($choice);
 

From c48d2de979266f41043e067431acad4cb160b029 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:03:01 +0100
Subject: [PATCH 3758/4023] Remove resolved todo

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 64fcc4a57ce..2f0d67588ca 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -37,7 +37,6 @@ public static function mockWindowsOs(bool $isWindows = true): void
         static::$mocks['usesWindowsOs'] = $isWindows;
     }
 
-    // Todo: Add test to ensure the signature is the same if Laravel updates it
     public static function multiselect(string $label, array|Collection $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, string $hint = 'Use the space bar to select options.', ?Closure $transform = null): array
     {
         if (isset(static::$mocks['multiselect'])) {

From 21f7f54a11a4856d590027307b90b18baf816736 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:03:22 +0100
Subject: [PATCH 3759/4023] Annotate array types

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 2f0d67588ca..5ace431d13f 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -37,6 +37,7 @@ public static function mockWindowsOs(bool $isWindows = true): void
         static::$mocks['usesWindowsOs'] = $isWindows;
     }
 
+    /* @return array<int|string> */
     public static function multiselect(string $label, array|Collection $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, string $hint = 'Use the space bar to select options.', ?Closure $transform = null): array
     {
         if (isset(static::$mocks['multiselect'])) {

From c5f57d43a6e3f2363deff1a36149e584dd8195f8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:03:32 +0100
Subject: [PATCH 3760/4023] Formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index cbfe37d1e5e..922147910c6 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -90,11 +90,7 @@ protected function promptForCategory(): string
             $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
         } else {
             /** @var string $choice */
-            $choice = $this->choice(
-                'Which category do you want to publish?',
-                $this->formatPublishableChoices(),
-                0
-            );
+            $choice = $this->choice('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
         }
 
         $selection = $this->parseChoiceIntoKey($choice);

From b2f9692f51b3bd467f281f2584adf2d887ef6c4f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:21:13 +0100
Subject: [PATCH 3761/4023] Use proper Laravel Prompts fallback

---
 .../src/Console/Commands/PublishViewsCommand.php     | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 922147910c6..abcb38cb7a0 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -8,6 +8,7 @@
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Support\Facades\Artisan;
+use Laravel\Prompts\SelectPrompt;
 
 use function Laravel\Prompts\select;
 use function str_replace;
@@ -86,12 +87,11 @@ protected function publishOption(string $selected, bool $isPublishingAll = false
 
     protected function promptForCategory(): string
     {
-        if ($this->isInteractive()) {
-            $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
-        } else {
-            /** @var string $choice */
-            $choice = $this->choice('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
-        }
+        SelectPrompt::fallbackUsing(function (SelectPrompt $prompt): string {
+            return $this->choice($prompt->label, $prompt->options, $prompt->default);
+        });
+
+        $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
 
         $selection = $this->parseChoiceIntoKey($choice);
 

From 56895f46e84816203df463c9d7190703962406e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:23:04 +0100
Subject: [PATCH 3762/4023] Fix formatting

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 packages/hyde/tests/HydeCLITest.php                             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index abcb38cb7a0..64786e8b2cc 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -24,7 +24,7 @@ class PublishViewsCommand extends Command
     protected $signature = 'publish:views {category? : The category to publish} {--i|interactive : Interactively select the views to publish}';
 
     /** @var string */
-    protected $description = 'Publish the hyde components for customization. Note that existing files will be overwritten';
+    protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';
 
     /** @var array<string, array<string, string>> */
     protected array $options = [
diff --git a/packages/hyde/tests/HydeCLITest.php b/packages/hyde/tests/HydeCLITest.php
index b72eea310a2..7ba4502c7b4 100644
--- a/packages/hyde/tests/HydeCLITest.php
+++ b/packages/hyde/tests/HydeCLITest.php
@@ -9,7 +9,7 @@ class HydeCLITest extends TestCase
     public function testCanShowHydeConsole()
     {
         $this->artisan('list')
-            ->expectsOutputToContain('hyde')
+            ->expectsOutputToContain('Hyde')
             ->assertExitCode(0);
     }
 }

From 9538c715b350965834702576348a9ac4701a9133 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:25:47 +0100
Subject: [PATCH 3763/4023] Add todo

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 64786e8b2cc..afb5d57f973 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -21,7 +21,7 @@
 class PublishViewsCommand extends Command
 {
     /** @var string */
-    protected $signature = 'publish:views {category? : The category to publish} {--i|interactive : Interactively select the views to publish}';
+    protected $signature = 'publish:views {category? : The category to publish} {--i|interactive : Interactively select the views to publish}'; // TODO: Always use interactive publishing
 
     /** @var string */
     protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';

From 24b583888f46c1f5d342693e38aada96f0b0e5cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:32:22 +0100
Subject: [PATCH 3764/4023] Normalize implementation to not call vendor command

---
 .../Console/Commands/PublishViewsCommand.php  | 29 +++++++------------
 1 file changed, 10 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index afb5d57f973..e4d21ed622e 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -73,16 +73,19 @@ protected function isInteractive(): bool
 
     protected function publishOption(string $selected, bool $isPublishingAll = false): void
     {
-        if ($this->isInteractive() && ! $isPublishingAll) {
-            $this->handleInteractivePublish($selected);
+        $publisher = new InteractivePublishCommandHelper($this->options[$selected]['group']);
 
-            return;
+        $choices = $publisher->getFileChoices();
+
+        if ($this->isInteractive() && ! $isPublishingAll) {
+            $selectedFiles = ConsoleHelper::multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        } else {
+            $selectedFiles = array_keys($choices);
         }
+        
+        $publisher->handle($selectedFiles);
 
-        Artisan::call('vendor:publish', [
-            '--tag' => $this->options[$selected]['group'] ?? $selected,
-            '--force' => true,
-        ], $this->output);
+        $this->infoComment($publisher->formatOutput($selectedFiles));
     }
 
     protected function promptForCategory(): string
@@ -114,16 +117,4 @@ protected function parseChoiceIntoKey(string $choice): string
     {
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
-
-    protected function handleInteractivePublish(string $selected): void
-    {
-        $publisher = new InteractivePublishCommandHelper($this->options[$selected]['group']);
-
-        $choices = $publisher->getFileChoices();
-
-        $selectedFiles = ConsoleHelper::multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-        $publisher->handle($selectedFiles);
-
-        $this->infoComment($publisher->formatOutput($selectedFiles));
-    }
 }

From 5183876f0a7e360e598496d65ce6a850aa7e8cf0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:40:21 +0100
Subject: [PATCH 3765/4023] Support single file

---
 .../Helpers/InteractivePublishCommandHelper.php        | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 4f2e91e1012..459860e8b3b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -68,6 +68,10 @@ protected function getPublishPaths(): array
     /** @return \Symfony\Component\Finder\SplFileInfo[] */
     protected function findAllFilesForTag(): array
     {
+        if (! File::isDirectory($this->sourceDirectory)) {
+            return [new SplFileInfo($this->sourceDirectory, '', basename($this->sourceDirectory))];
+        }
+
         return File::allFiles($this->sourceDirectory);
     }
 
@@ -88,7 +92,11 @@ protected function mapPublishableFiles(array $search): array
     protected function publishFiles(array $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {
-            Filesystem::ensureDirectoryExists(dirname($target));
+            if (! Filesystem::isFile(dirname($target))) {
+                Filesystem::ensureDirectoryExists(dirname($target));
+            } else {
+                $target = dirname($target);
+            }
             Filesystem::copy($source, $target); // Todo: See how we should handle existing files
         }
     }

From 138c4dbe943f8ecc39a0dcfa4fe67e689178d159 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:44:37 +0100
Subject: [PATCH 3766/4023] Formatting

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index e4d21ed622e..814cf99388d 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -82,7 +82,7 @@ protected function publishOption(string $selected, bool $isPublishingAll = false
         } else {
             $selectedFiles = array_keys($choices);
         }
-        
+
         $publisher->handle($selectedFiles);
 
         $this->infoComment($publisher->formatOutput($selectedFiles));

From 4ad163ba82fbd9900480e5bc31e310695f1cfea9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:48:03 +0100
Subject: [PATCH 3767/4023] Update PublishViewsCommand.php

---
 .../src/Console/Commands/PublishViewsCommand.php       | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 814cf99388d..76d147920b3 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -8,8 +8,10 @@
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Illuminate\Support\Facades\Artisan;
+use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\SelectPrompt;
 
+use function Laravel\Prompts\multiselect;
 use function Laravel\Prompts\select;
 use function str_replace;
 use function sprintf;
@@ -21,7 +23,7 @@
 class PublishViewsCommand extends Command
 {
     /** @var string */
-    protected $signature = 'publish:views {category? : The category to publish} {--i|interactive : Interactively select the views to publish}'; // TODO: Always use interactive publishing
+    protected $signature = 'publish:views {category? : The category to publish}';
 
     /** @var string */
     protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';
@@ -47,12 +49,6 @@ class PublishViewsCommand extends Command
 
     public function handle(): int
     {
-        if ($this->isInteractive() && ConsoleHelper::usesWindowsOs()) {
-            $this->error('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.');
-
-            return Command::FAILURE;
-        }
-
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
         if ($selected === 'all' || $selected === '') {

From 4b0806998301ef87036bf4ac3ca42ca8f262debd Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 14:48:10 +0100
Subject: [PATCH 3768/4023] Use proper fallback syntax

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 76d147920b3..54ad934bf49 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -73,11 +73,9 @@ protected function publishOption(string $selected, bool $isPublishingAll = false
 
         $choices = $publisher->getFileChoices();
 
-        if ($this->isInteractive() && ! $isPublishingAll) {
-            $selectedFiles = ConsoleHelper::multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-        } else {
-            $selectedFiles = array_keys($choices);
-        }
+        MultiSelectPrompt::fallbackUsing(fn (): array => $choices);
+
+        $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
         $publisher->handle($selectedFiles);
 

From 50f078b90acc3c3de108530b539517c7173c4285 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:18:43 +0100
Subject: [PATCH 3769/4023] Create ViewPublishGroup.php

---
 .../src/Console/Helpers/ViewPublishGroup.php        | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 packages/framework/src/Console/Helpers/ViewPublishGroup.php

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
new file mode 100644
index 00000000000..3c2a4962cfc
--- /dev/null
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Console\Helpers;
+
+/**
+ * @internal Helper object for publishable view groups.
+ */
+class ViewPublishGroup
+{
+    //
+}

From e7b6e9c0d9533397adbb9960ec1b5d734187ab59 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:19:13 +0100
Subject: [PATCH 3770/4023] Create internal helper class for wrapping
 publishable files

---
 .../src/Console/Helpers/ViewPublishGroup.php  | 69 ++++++++++++++++++-
 1 file changed, 68 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 3c2a4962cfc..d197f24bb43 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -4,10 +4,77 @@
 
 namespace Hyde\Console\Helpers;
 
+use Hyde\Facades\Filesystem;
+use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Hyde;
+use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Str;
+
+use function Hyde\unslash;
+
 /**
  * @internal Helper object for publishable view groups.
  */
 class ViewPublishGroup
 {
-    //
+    readonly public string $group;
+
+    readonly public string $name;
+    readonly public string $description;
+
+    readonly public string $source;
+    readonly public string $target;
+    readonly public bool $isDirectory;
+
+    /** @var array<string> The filenames relative to the source, if the source is a directory. */
+    readonly public array $files;
+
+
+    /** @var class-string<\Hyde\Foundation\Providers\ViewServiceProvider> */
+    protected static string $provider = ViewServiceProvider::class;
+
+    protected function __construct(string $group, string $source, string $target, bool $isDirectory, array $files, ?string $name = null, ?string $description = null)
+    {
+        $this->group = $group;
+        $this->source = $source;
+        $this->target = $target;
+        $this->files = $files;
+        $this->name = $name ?? Hyde::makeTitle($group);
+        $this->description = $description ?? "Publish the '$group' files for customization.";
+    }
+
+    public static function fromGroup(string $group, ?string $name = null, ?string $description = null): self
+    {
+        [$source, $target] = static::keyedArrayToTuple(ServiceProvider::pathsToPublish(static::$provider, $group));
+
+        $source = static::normalizePath($source);
+        $target = static::normalizePath($target);
+
+        $isDirectory = Filesystem::isDirectory($source);
+        $files = $isDirectory ? self::findFiles($source) : [];
+
+        return new static($group, $source, $target, $isDirectory, $files, $name, $description);
+    }
+
+    protected static function keyedArrayToTuple(array $array): array
+    {
+        return [key($array), current($array)];
+    }
+
+    /** @return array<string> */
+    protected static function findFiles(string $source): array
+    {
+        return Filesystem::findFiles($source, recursive: true)
+            ->map(fn (string $file) => static::normalizePath($file))
+            ->map(fn (string $file) => unslash(Str::after($file, $source)))
+            ->sort(fn (string $a, string $b): int => substr_count($a, '/') <=> substr_count($b, '/') ?: strcmp($a, $b))
+            ->all();
+    }
+
+    protected static function normalizePath(string $path): string
+    {
+        return Hyde::pathToRelative(
+            Filesystem::exists($path) ? realpath($path) : $path
+        );
+    }
 }

From e49769d0466e33b9ec0c325528f6c70eead882f1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:19:50 +0100
Subject: [PATCH 3771/4023] Cleanup formatting

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index d197f24bb43..64e37f45c24 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -46,9 +46,7 @@ protected function __construct(string $group, string $source, string $target, bo
     public static function fromGroup(string $group, ?string $name = null, ?string $description = null): self
     {
         [$source, $target] = static::keyedArrayToTuple(ServiceProvider::pathsToPublish(static::$provider, $group));
-
-        $source = static::normalizePath($source);
-        $target = static::normalizePath($target);
+        [$source, $target] = [static::normalizePath($source), static::normalizePath($target)];
 
         $isDirectory = Filesystem::isDirectory($source);
         $files = $isDirectory ? self::findFiles($source) : [];

From ffad46b66be5c5ffe2d6e2e83570d0794a3160d5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:20:03 +0100
Subject: [PATCH 3772/4023] Fix formatting

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 64e37f45c24..f65e7ddb364 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -29,7 +29,6 @@ class ViewPublishGroup
     /** @var array<string> The filenames relative to the source, if the source is a directory. */
     readonly public array $files;
 
-
     /** @var class-string<\Hyde\Foundation\Providers\ViewServiceProvider> */
     protected static string $provider = ViewServiceProvider::class;
 

From c73740f3bb39fd530611ce884a0d08859b65f543 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:20:28 +0100
Subject: [PATCH 3773/4023] Construct directory

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index f65e7ddb364..5ea10a1392c 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -37,6 +37,7 @@ protected function __construct(string $group, string $source, string $target, bo
         $this->group = $group;
         $this->source = $source;
         $this->target = $target;
+        $this->isDirectory = $isDirectory;
         $this->files = $files;
         $this->name = $name ?? Hyde::makeTitle($group);
         $this->description = $description ?? "Publish the '$group' files for customization.";

From a77da56381829098426234309b8cda1f302e27e8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:20:38 +0100
Subject: [PATCH 3774/4023] Formatting

---
 .../src/Console/Commands/PublishViewsCommand.php |  2 --
 .../src/Console/Helpers/ViewPublishGroup.php     | 16 +++++++++-------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 54ad934bf49..6d5258a78c1 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -5,9 +5,7 @@
 namespace Hyde\Console\Commands;
 
 use Hyde\Console\Concerns\Command;
-use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Illuminate\Support\Facades\Artisan;
 use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\SelectPrompt;
 
diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 5ea10a1392c..af2262cfc16 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -17,17 +17,17 @@
  */
 class ViewPublishGroup
 {
-    readonly public string $group;
+    public readonly string $group;
 
-    readonly public string $name;
-    readonly public string $description;
+    public readonly string $name;
+    public readonly string $description;
 
-    readonly public string $source;
-    readonly public string $target;
-    readonly public bool $isDirectory;
+    public readonly string $source;
+    public readonly string $target;
+    public readonly bool $isDirectory;
 
     /** @var array<string> The filenames relative to the source, if the source is a directory. */
-    readonly public array $files;
+    public readonly array $files;
 
     /** @var class-string<\Hyde\Foundation\Providers\ViewServiceProvider> */
     protected static string $provider = ViewServiceProvider::class;
@@ -37,8 +37,10 @@ protected function __construct(string $group, string $source, string $target, bo
         $this->group = $group;
         $this->source = $source;
         $this->target = $target;
+
         $this->isDirectory = $isDirectory;
         $this->files = $files;
+
         $this->name = $name ?? Hyde::makeTitle($group);
         $this->description = $description ?? "Publish the '$group' files for customization.";
     }

From 54c8891bae89f980590e715a779a6f1c619d02c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:22:52 +0100
Subject: [PATCH 3775/4023] Declare options using helper

---
 .../Console/Commands/PublishViewsCommand.php  | 26 +++++--------------
 1 file changed, 7 insertions(+), 19 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 6d5258a78c1..d006fc105f7 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -6,6 +6,7 @@
 
 use Hyde\Console\Concerns\Command;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
+use Hyde\Console\Helpers\ViewPublishGroup;
 use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\SelectPrompt;
 
@@ -26,27 +27,14 @@ class PublishViewsCommand extends Command
     /** @var string */
     protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';
 
-    /** @var array<string, array<string, string>> */
-    protected array $options = [
-        'layouts' => [
-            'name' => 'Blade Layouts',
-            'description' => 'Shared layout views, such as the app layout, navigation menu, and Markdown page templates',
-            'group' => 'hyde-layouts',
-        ],
-        'components' => [
-            'name' => 'Blade Components',
-            'description' => 'More or less self contained components, extracted for customizability and DRY code',
-            'group' => 'hyde-components',
-        ],
-        'page-404' => [
-            'name' => '404 Page',
-            'description' => 'A beautiful 404 error page by the Laravel Collective',
-            'group' => 'hyde-page-404',
-        ],
-    ];
-
     public function handle(): int
     {
+        $options = [
+            ViewPublishGroup::fromGroup('hyde-layouts', 'Blade Layouts', 'Shared layout views, such as the app layout, navigation menu, and Markdown page templates'),
+            ViewPublishGroup::fromGroup('hyde-components', 'Blade Components', 'More or less self contained components, extracted for customizability and DRY code'),
+            ViewPublishGroup::fromGroup('hyde-page-404', '404 Page', 'A beautiful 404 error page by the Laravel Collective'),
+        ];
+
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
         if ($selected === 'all' || $selected === '') {

From 3d7dff96688cf92b2f6de07619ca9c094c1eb5d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:31:08 +0100
Subject: [PATCH 3776/4023] Add helper to get the map of all publishable file
 paths

---
 .../src/Console/Helpers/ViewPublishGroup.php        | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index af2262cfc16..bd28748da27 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -10,6 +10,7 @@
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
 
+use function Hyde\path_join;
 use function Hyde\unslash;
 
 /**
@@ -56,6 +57,18 @@ public static function fromGroup(string $group, ?string $name = null, ?string $d
         return new static($group, $source, $target, $isDirectory, $files, $name, $description);
     }
 
+    /**
+     * Get the map of all publishable file paths.
+     *
+     * @return array<string, string> The source file paths mapped to their target file paths.
+     */
+    public function publishableFilesMap(): array
+    {
+        return collect($this->files)->mapWithKeys(fn (string $file): array => [
+            path_join($this->source, $file) => path_join($this->target, $file),
+        ])->all();
+    }
+
     protected static function keyedArrayToTuple(array $array): array
     {
         return [key($array), current($array)];

From e08e68ceedc86c5b29a5a82bb45f08ad6159927a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:33:31 +0100
Subject: [PATCH 3777/4023] Map to keys

---
 .../src/Console/Commands/PublishViewsCommand.php | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index d006fc105f7..deda00d7ba4 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -27,13 +27,16 @@ class PublishViewsCommand extends Command
     /** @var string */
     protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';
 
+    /** @var array<string, \Hyde\Console\Helpers\ViewPublishGroup> */
+    protected array $options;
+
     public function handle(): int
     {
-        $options = [
+        $this->options = static::mapToKeys([
             ViewPublishGroup::fromGroup('hyde-layouts', 'Blade Layouts', 'Shared layout views, such as the app layout, navigation menu, and Markdown page templates'),
             ViewPublishGroup::fromGroup('hyde-components', 'Blade Components', 'More or less self contained components, extracted for customizability and DRY code'),
             ViewPublishGroup::fromGroup('hyde-page-404', '404 Page', 'A beautiful 404 error page by the Laravel Collective'),
-        ];
+        ]);
 
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
@@ -97,4 +100,13 @@ protected function parseChoiceIntoKey(string $choice): string
     {
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
+
+    /**
+     * @param array<string, ViewPublishGroup> $groups
+     * @return array<string, ViewPublishGroup>
+     */
+    protected static function mapToKeys(array $groups): array
+    {
+        return collect($groups)->mapWithKeys(fn (ViewPublishGroup $group): array => [$group->group => $group])->all();
+    }
 }

From 542a2f5584414474442a1e660d46f512d32fd02a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:35:10 +0100
Subject: [PATCH 3778/4023] Use object access

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index deda00d7ba4..0a4231ea10a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -90,7 +90,7 @@ protected function formatPublishableChoices(): array
     {
         $keys = ['Publish all categories listed below'];
         foreach ($this->options as $key => $option) {
-            $keys[] = "<comment>$key</comment>: {$option['description']}";
+            $keys[] = "<comment>$key</comment>: {$option->description}";
         }
 
         return $keys;

From bc4e9a4cd6b249af8a34049d7c12d91678ef616b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:35:13 +0100
Subject: [PATCH 3779/4023] Unwrap curly braces

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 0a4231ea10a..c04d213da32 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -90,7 +90,7 @@ protected function formatPublishableChoices(): array
     {
         $keys = ['Publish all categories listed below'];
         foreach ($this->options as $key => $option) {
-            $keys[] = "<comment>$key</comment>: {$option->description}";
+            $keys[] = "<comment>$key</comment>: $option->description";
         }
 
         return $keys;

From 881960a9f788cf314c3a9c6dba8e1ec4ff75f082 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:35:26 +0100
Subject: [PATCH 3780/4023] Add spacing

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index c04d213da32..8baeb5a4cf8 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -89,6 +89,7 @@ protected function promptForCategory(): string
     protected function formatPublishableChoices(): array
     {
         $keys = ['Publish all categories listed below'];
+
         foreach ($this->options as $key => $option) {
             $keys[] = "<comment>$key</comment>: $option->description";
         }

From 9c95612bf6c2f0a86be0d2e716b632e5c316bae2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:42:26 +0100
Subject: [PATCH 3781/4023] More semantic implementation with collect call

---
 .../src/Console/Commands/PublishViewsCommand.php | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 8baeb5a4cf8..f87cd8b9ecd 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -88,13 +88,15 @@ protected function promptForCategory(): string
 
     protected function formatPublishableChoices(): array
     {
-        $keys = ['Publish all categories listed below'];
-
-        foreach ($this->options as $key => $option) {
-            $keys[] = "<comment>$key</comment>: $option->description";
-        }
-
-        return $keys;
+        return collect($this->options)
+            ->prepend('Publish all categories listed below')
+            ->map(fn ($option, $key) => 
+                $key === 0 
+                    ? $option 
+                    : sprintf("<comment>%s</comment>: %s", $key, $option->description)
+            )
+            ->values()
+            ->all();
     }
 
     protected function parseChoiceIntoKey(string $choice): string

From 14ce32db6d90e2e399e1c8791fbec22bfb014733 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:44:15 +0100
Subject: [PATCH 3782/4023] Refactor and cleanup

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index f87cd8b9ecd..d071291f325 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -90,11 +90,7 @@ protected function formatPublishableChoices(): array
     {
         return collect($this->options)
             ->prepend('Publish all categories listed below')
-            ->map(fn ($option, $key) => 
-                $key === 0 
-                    ? $option 
-                    : sprintf("<comment>%s</comment>: %s", $key, $option->description)
-            )
+            ->map(fn (ViewPublishGroup $option, string $key): string => sprintf("<comment>%s</comment>: %s", $key, $option->description))
             ->values()
             ->all();
     }

From 4b4f439fab52463828a4afd9773deedb029b2726 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:44:20 +0100
Subject: [PATCH 3783/4023] Move down prepend

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index d071291f325..e38dacd1add 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -89,8 +89,8 @@ protected function promptForCategory(): string
     protected function formatPublishableChoices(): array
     {
         return collect($this->options)
-            ->prepend('Publish all categories listed below')
             ->map(fn (ViewPublishGroup $option, string $key): string => sprintf("<comment>%s</comment>: %s", $key, $option->description))
+            ->prepend('Publish all categories listed below')
             ->values()
             ->all();
     }

From ddb86dd5f9c9afd72865bd3a486be15c25200248 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:46:38 +0100
Subject: [PATCH 3784/4023] Validate selection

---
 .../src/Console/Commands/PublishViewsCommand.php         | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index e38dacd1add..57367430c29 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -40,6 +40,8 @@ public function handle(): int
 
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
+        $this->validateSelection($selected);
+
         if ($selected === 'all' || $selected === '') {
             foreach ($this->options as $key => $_ignored) {
                 $this->publishOption($key, true);
@@ -100,6 +102,13 @@ protected function parseChoiceIntoKey(string $choice): string
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
 
+    protected function validateSelection(string $selected): void
+    {
+        if ($selected !== 'all' && ! isset($this->options[$selected])) {
+            throw new \InvalidArgumentException("Invalid selection: $selected");
+        }
+    }
+
     /**
      * @param array<string, ViewPublishGroup> $groups
      * @return array<string, ViewPublishGroup>

From 5b6f41f7ae6a296ce30f3e297029e76f9e2f35e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:49:38 +0100
Subject: [PATCH 3785/4023] Merge allowed keys

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 57367430c29..1cc5dd2e1f9 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -104,7 +104,9 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function validateSelection(string $selected): void
     {
-        if ($selected !== 'all' && ! isset($this->options[$selected])) {
+        $allowed = array_merge(array_keys($this->options), ['all']);
+
+        if (! in_array($selected, $allowed, true)) {
             throw new \InvalidArgumentException("Invalid selection: $selected");
         }
     }

From f915c1dc7ce90b6a63713d1d36a89923ebc6c0e0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:50:07 +0100
Subject: [PATCH 3786/4023] Inline variable

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1cc5dd2e1f9..89443da0507 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -104,9 +104,7 @@ protected function parseChoiceIntoKey(string $choice): string
 
     protected function validateSelection(string $selected): void
     {
-        $allowed = array_merge(array_keys($this->options), ['all']);
-
-        if (! in_array($selected, $allowed, true)) {
+        if (! in_array($selected, array_merge(array_keys($this->options), ['all']), true)) {
             throw new \InvalidArgumentException("Invalid selection: $selected");
         }
     }

From 5bce2741761c2fb41f62ebb6f33e6450e7b85465 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:50:22 +0100
Subject: [PATCH 3787/4023] Inline method

---
 .../src/Console/Commands/PublishViewsCommand.php      | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 89443da0507..239b63a7385 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -40,7 +40,9 @@ public function handle(): int
 
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
-        $this->validateSelection($selected);
+        if (! in_array($selected, array_merge(array_keys($this->options), ['all']), true)) {
+            throw new \InvalidArgumentException("Invalid selection: $selected");
+        }
 
         if ($selected === 'all' || $selected === '') {
             foreach ($this->options as $key => $_ignored) {
@@ -102,13 +104,6 @@ protected function parseChoiceIntoKey(string $choice): string
         return strstr(str_replace(['<comment>', '</comment>'], '', $choice), ':', true) ?: '';
     }
 
-    protected function validateSelection(string $selected): void
-    {
-        if (! in_array($selected, array_merge(array_keys($this->options), ['all']), true)) {
-            throw new \InvalidArgumentException("Invalid selection: $selected");
-        }
-    }
-
     /**
      * @param array<string, ViewPublishGroup> $groups
      * @return array<string, ViewPublishGroup>

From a64767d1a7eb0261d820f39b692b52d029630fc9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:51:31 +0100
Subject: [PATCH 3788/4023] Return with better error instead of throw

---
 .../framework/src/Console/Commands/PublishViewsCommand.php | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 239b63a7385..eff3b945c3d 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -40,8 +40,11 @@ public function handle(): int
 
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
-        if (! in_array($selected, array_merge(array_keys($this->options), ['all']), true)) {
-            throw new \InvalidArgumentException("Invalid selection: $selected");
+        if (! in_array($selected, $allowed = array_merge(array_keys($this->options), ['all']), true)) {
+            $this->error("Invalid selection: '$selected'");
+            $this->infoComment('Allowed values are: ['.implode(', ', $allowed).']');
+
+            return Command::FAILURE;
         }
 
         if ($selected === 'all' || $selected === '') {

From fdcb53ca3309dad13160b1497bd1c96b75a393cc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:51:52 +0100
Subject: [PATCH 3789/4023] Flip values

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index eff3b945c3d..f928f0dd3f9 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -40,7 +40,7 @@ public function handle(): int
 
         $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
 
-        if (! in_array($selected, $allowed = array_merge(array_keys($this->options), ['all']), true)) {
+        if (! in_array($selected, $allowed = array_merge(['all'], array_keys($this->options)), true)) {
             $this->error("Invalid selection: '$selected'");
             $this->infoComment('Allowed values are: ['.implode(', ', $allowed).']');
 

From 7890671e6ef31fa28e6ef8cf3c4dba0a25ff34c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:52:52 +0100
Subject: [PATCH 3790/4023] Trim the prefix we don't need here

---
 .../framework/src/Console/Commands/PublishViewsCommand.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index f928f0dd3f9..f2dfb96aa34 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -7,6 +7,7 @@
 use Hyde\Console\Concerns\Command;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Console\Helpers\ViewPublishGroup;
+use Illuminate\Support\Str;
 use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\SelectPrompt;
 
@@ -113,6 +114,6 @@ protected function parseChoiceIntoKey(string $choice): string
      */
     protected static function mapToKeys(array $groups): array
     {
-        return collect($groups)->mapWithKeys(fn (ViewPublishGroup $group): array => [$group->group => $group])->all();
+        return collect($groups)->mapWithKeys(fn (ViewPublishGroup $group): array => [Str::after($group->group, 'hyde-') => $group])->all();
     }
 }

From 5f82f329fd1d3b8a8a9bf2340f3a14c3eb06d330 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:53:05 +0100
Subject: [PATCH 3791/4023] Convert the arrow function to a traditional closure

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index f2dfb96aa34..5041db66b8d 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -114,6 +114,8 @@ protected function parseChoiceIntoKey(string $choice): string
      */
     protected static function mapToKeys(array $groups): array
     {
-        return collect($groups)->mapWithKeys(fn (ViewPublishGroup $group): array => [Str::after($group->group, 'hyde-') => $group])->all();
+        return collect($groups)->mapWithKeys(function (ViewPublishGroup $group): array {
+            return [Str::after($group->group, 'hyde-') => $group];
+        })->all();
     }
 }

From 8d95940ad8d565525707d3c228b72e219b42d27d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:53:28 +0100
Subject: [PATCH 3792/4023] Fix formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 5041db66b8d..97d8e3be901 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -109,8 +109,8 @@ protected function parseChoiceIntoKey(string $choice): string
     }
 
     /**
-     * @param array<string, ViewPublishGroup> $groups
-     * @return array<string, ViewPublishGroup>
+     * @param array<string, \Hyde\Console\Helpers\ViewPublishGroup> $groups
+     * @return array<string, \Hyde\Console\Helpers\ViewPublishGroup>
      */
     protected static function mapToKeys(array $groups): array
     {

From 87bbb3d1f10398f083bc4664d00e236b87d08ccb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:55:24 +0100
Subject: [PATCH 3793/4023] Should not need string cast

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 97d8e3be901..64ef4160fa7 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -39,7 +39,7 @@ public function handle(): int
             ViewPublishGroup::fromGroup('hyde-page-404', '404 Page', 'A beautiful 404 error page by the Laravel Collective'),
         ]);
 
-        $selected = (string) ($this->argument('category') ?? $this->promptForCategory());
+        $selected = ($this->argument('category') ?? $this->promptForCategory());
 
         if (! in_array($selected, $allowed = array_merge(['all'], array_keys($this->options)), true)) {
             $this->error("Invalid selection: '$selected'");

From ac4ebcf9dd349bd5d8bcb3361fb1706bb20f7269 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 15:56:01 +0100
Subject: [PATCH 3794/4023] Fallback to all earlier

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 64ef4160fa7..0edb858905f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -39,7 +39,7 @@ public function handle(): int
             ViewPublishGroup::fromGroup('hyde-page-404', '404 Page', 'A beautiful 404 error page by the Laravel Collective'),
         ]);
 
-        $selected = ($this->argument('category') ?? $this->promptForCategory());
+        $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
 
         if (! in_array($selected, $allowed = array_merge(['all'], array_keys($this->options)), true)) {
             $this->error("Invalid selection: '$selected'");
@@ -48,7 +48,7 @@ public function handle(): int
             return Command::FAILURE;
         }
 
-        if ($selected === 'all' || $selected === '') {
+        if ($selected === 'all') {
             foreach ($this->options as $key => $_ignored) {
                 $this->publishOption($key, true);
             }

From 9ecb4bedd855bbef301b05c0d11d3623a744f412 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:02:49 +0100
Subject: [PATCH 3795/4023] Only support groups to publish here

See https://github.com/hydephp/develop/pull/2062#issuecomment-2561921207
---
 .../src/Console/Commands/PublishViewsCommand.php     |  1 -
 .../src/Console/Helpers/ViewPublishGroup.php         | 12 ++++--------
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 0edb858905f..df521f76ea0 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -36,7 +36,6 @@ public function handle(): int
         $this->options = static::mapToKeys([
             ViewPublishGroup::fromGroup('hyde-layouts', 'Blade Layouts', 'Shared layout views, such as the app layout, navigation menu, and Markdown page templates'),
             ViewPublishGroup::fromGroup('hyde-components', 'Blade Components', 'More or less self contained components, extracted for customizability and DRY code'),
-            ViewPublishGroup::fromGroup('hyde-page-404', '404 Page', 'A beautiful 404 error page by the Laravel Collective'),
         ]);
 
         $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index bd28748da27..a01e33bd843 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -25,21 +25,18 @@ class ViewPublishGroup
 
     public readonly string $source;
     public readonly string $target;
-    public readonly bool $isDirectory;
 
-    /** @var array<string> The filenames relative to the source, if the source is a directory. */
+    /** @var array<string> The filenames relative to the source directory. */
     public readonly array $files;
 
     /** @var class-string<\Hyde\Foundation\Providers\ViewServiceProvider> */
     protected static string $provider = ViewServiceProvider::class;
 
-    protected function __construct(string $group, string $source, string $target, bool $isDirectory, array $files, ?string $name = null, ?string $description = null)
+    protected function __construct(string $group, string $source, string $target, array $files, ?string $name = null, ?string $description = null)
     {
         $this->group = $group;
         $this->source = $source;
         $this->target = $target;
-
-        $this->isDirectory = $isDirectory;
         $this->files = $files;
 
         $this->name = $name ?? Hyde::makeTitle($group);
@@ -51,10 +48,9 @@ public static function fromGroup(string $group, ?string $name = null, ?string $d
         [$source, $target] = static::keyedArrayToTuple(ServiceProvider::pathsToPublish(static::$provider, $group));
         [$source, $target] = [static::normalizePath($source), static::normalizePath($target)];
 
-        $isDirectory = Filesystem::isDirectory($source);
-        $files = $isDirectory ? self::findFiles($source) : [];
+        $files = self::findFiles($source);
 
-        return new static($group, $source, $target, $isDirectory, $files, $name, $description);
+        return new static($group, $source, $target, $files, $name, $description);
     }
 
     /**

From d9f59e0fe36b04a28da0357741cdec9d57df1cb6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:04:25 +0100
Subject: [PATCH 3796/4023] Merge all paths to publish

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index df521f76ea0..5d9a78f79be 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -48,9 +48,7 @@ public function handle(): int
         }
 
         if ($selected === 'all') {
-            foreach ($this->options as $key => $_ignored) {
-                $this->publishOption($key, true);
-            }
+            $files = collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all();
         } else {
             $this->publishOption($selected);
         }

From 3b30a4f43c5c05b7849623505cb0d18bd2cbee74 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:04:32 +0100
Subject: [PATCH 3797/4023] Buffer files to publish

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 5d9a78f79be..04a70d4cb6b 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -50,9 +50,11 @@ public function handle(): int
         if ($selected === 'all') {
             $files = collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all();
         } else {
-            $this->publishOption($selected);
+            $files = $this->options[$selected]->files;
         }
 
+        $this->publishFiles($files);
+
         return Command::SUCCESS;
     }
 

From 860e262715819b2e814b47f2b7e70edb233f4034 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:07:33 +0100
Subject: [PATCH 3798/4023] Remove unused method

---
 .../framework/src/Console/Commands/PublishViewsCommand.php   | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 04a70d4cb6b..bc008f89d89 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -58,11 +58,6 @@ public function handle(): int
         return Command::SUCCESS;
     }
 
-    protected function isInteractive(): bool
-    {
-        return $this->option('interactive');
-    }
-
     protected function publishOption(string $selected, bool $isPublishingAll = false): void
     {
         $publisher = new InteractivePublishCommandHelper($this->options[$selected]['group']);

From f1ceaefbd49833ef3dd23c569a919b217d510c92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:09:21 +0100
Subject: [PATCH 3799/4023] Normalize format

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index bc008f89d89..50556bff91f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -50,7 +50,7 @@ public function handle(): int
         if ($selected === 'all') {
             $files = collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all();
         } else {
-            $files = $this->options[$selected]->files;
+            $files = $this->options[$selected]->publishableFilesMap();
         }
 
         $this->publishFiles($files);

From 0e812af7b329f65ca7e6d0a2a6d01fd7dbec3c89 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:31:16 +0100
Subject: [PATCH 3800/4023] Algorithm to find the most specific common path

---
 .../Helpers/InteractivePublishCommandHelper.php      | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 459860e8b3b..034c70b94f6 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -54,6 +54,18 @@ public function handle(array $selectedFiles): void
         $this->publishFiles($filesToPublish);
     }
 
+    protected function getBaseDirectory(): string
+    {
+        // Find the most specific common parent directory path for the files (in case they are in different directories, we want to trim as much as possible whilst keeping specificity and uniqueness)
+        $partsMap = collect($this->publishableFilesMap)->map(fn (string $file): array => explode('/', $file));
+
+        $commonParts = $partsMap->reduce(function (array $carry, array $parts): array {
+            return array_intersect($carry, $parts);
+        }, $partsMap->first());
+
+        return implode('/', $commonParts);
+    }
+
     /** @return array{string, string} */
     protected function getPublishPaths(): array
     {

From 1ec031ac0c2564a0f2cea742b9bcd907aba77c84 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:34:39 +0100
Subject: [PATCH 3801/4023] Refactor for the new publisher system

---
 .../Console/Commands/PublishViewsCommand.php  |  5 +-
 .../InteractivePublishCommandHelper.php       | 46 ++++---------------
 2 files changed, 12 insertions(+), 39 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 50556bff91f..4462f397ccc 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,6 +9,7 @@
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
 use Laravel\Prompts\MultiSelectPrompt;
+use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
 
 use function Laravel\Prompts\multiselect;
@@ -53,7 +54,9 @@ public function handle(): int
             $files = $this->options[$selected]->publishableFilesMap();
         }
 
-        $this->publishFiles($files);
+        $publisher = new InteractivePublishCommandHelper($files);
+
+        $publisher->publishFiles($files);
 
         return Command::SUCCESS;
     }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 034c70b94f6..5ab2d137f33 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -21,28 +21,22 @@
  */
 class InteractivePublishCommandHelper
 {
-    protected readonly string $group;
-    protected readonly string $sourceDirectory;
-    protected readonly string $targetDirectory;
-
     /** @var array<string, string> Map of source files to target files */
     protected readonly array $publishableFilesMap;
 
-    /** @param "hyde-layouts"|"hyde-components"|"hyde-page-404" $group */
-    public function __construct(string $group)
+    /** @param array<string, string> $publishableFilesMap */
+    public function __construct(array $publishableFilesMap)
     {
-        $this->group = $group;
-
-        [$this->sourceDirectory, $this->targetDirectory] = $this->getPublishPaths();
-
-        $this->publishableFilesMap = $this->mapPublishableFiles($this->findAllFilesForTag());
+        $this->publishableFilesMap = $publishableFilesMap;
     }
 
     /** @return array<string, string> */
     public function getFileChoices(): array
     {
-        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source): array {
-            return [$source => $this->pathRelativeToDirectory($source, $this->targetDirectory)];
+        $mostCommonDirectoryNominator = $this->getBaseDirectory();
+
+        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source) use ($mostCommonDirectoryNominator): array {
+            return [$source => $this->pathRelativeToDirectory($source, $mostCommonDirectoryNominator)];
         });
     }
 
@@ -77,31 +71,7 @@ protected function getPublishPaths(): array
         return [$source, $target];
     }
 
-    /** @return \Symfony\Component\Finder\SplFileInfo[] */
-    protected function findAllFilesForTag(): array
-    {
-        if (! File::isDirectory($this->sourceDirectory)) {
-            return [new SplFileInfo($this->sourceDirectory, '', basename($this->sourceDirectory))];
-        }
-
-        return File::allFiles($this->sourceDirectory);
-    }
-
-    /**
-     * @param  \Symfony\Component\Finder\SplFileInfo[]  $search
-     * @return array<string, string>
-     */
-    protected function mapPublishableFiles(array $search): array
-    {
-        return Arr::mapWithKeys($search, /** @return array<string, string> */ function (SplFileInfo $file): array {
-            $targetPath = path_join($this->targetDirectory, $file->getRelativePathname());
-
-            return [Hyde::pathToRelative(realpath($file->getPathname())) => Hyde::pathToRelative($targetPath)];
-        });
-    }
-
-    /** @param array<string, string> $selectedFiles */
-    protected function publishFiles(array $selectedFiles): void
+    public function publishFiles(array $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {
             if (! Filesystem::isFile(dirname($target))) {

From 4f982fdc48a3ec8b04242add3768d856918d1d5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:36:05 +0100
Subject: [PATCH 3802/4023] Make array writable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 5ab2d137f33..e2de7381887 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -22,7 +22,7 @@
 class InteractivePublishCommandHelper
 {
     /** @var array<string, string> Map of source files to target files */
-    protected readonly array $publishableFilesMap;
+    protected array $publishableFilesMap;
 
     /** @param array<string, string> $publishableFilesMap */
     public function __construct(array $publishableFilesMap)

From 9917956b4af77aeb50405a336bf6bb332c9a60a6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:36:58 +0100
Subject: [PATCH 3803/4023] Remove unused methods

---
 .../InteractivePublishCommandHelper.php       | 28 -------------------
 1 file changed, 28 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index e2de7381887..870e712e469 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -40,14 +40,6 @@ public function getFileChoices(): array
         });
     }
 
-    /** @param array<string> $selectedFiles */
-    public function handle(array $selectedFiles): void
-    {
-        $filesToPublish = $this->filterPublishableFiles($selectedFiles);
-
-        $this->publishFiles($filesToPublish);
-    }
-
     protected function getBaseDirectory(): string
     {
         // Find the most specific common parent directory path for the files (in case they are in different directories, we want to trim as much as possible whilst keeping specificity and uniqueness)
@@ -60,17 +52,6 @@ protected function getBaseDirectory(): string
         return implode('/', $commonParts);
     }
 
-    /** @return array{string, string} */
-    protected function getPublishPaths(): array
-    {
-        $viewPaths = ServiceProvider::pathsToPublish(ViewServiceProvider::class, $this->group);
-
-        $source = array_key_first($viewPaths);
-        $target = $viewPaths[$source];
-
-        return [$source, $target];
-    }
-
     public function publishFiles(array $selectedFiles): void
     {
         foreach ($selectedFiles as $source => $target) {
@@ -114,15 +95,6 @@ protected function pathRelativeToDirectory(string $source, string $directory): s
         return Str::after($source, basename($directory).'/');
     }
 
-    /**
-     * @param  array<string>  $selectedFiles
-     * @return array<string, string>
-     */
-    protected function filterPublishableFiles(array $selectedFiles): array
-    {
-        return array_filter($this->publishableFilesMap, fn (string $file): bool => in_array($file, $selectedFiles));
-    }
-
     protected function publishableFilesMapCount(): int
     {
         return count($this->publishableFilesMap);

From 648e3c47902b2106e76873c865a9cbac185b252b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:37:32 +0100
Subject: [PATCH 3804/4023] Use instance data

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 870e712e469..6cd19a9fab1 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -52,9 +52,9 @@ protected function getBaseDirectory(): string
         return implode('/', $commonParts);
     }
 
-    public function publishFiles(array $selectedFiles): void
+    public function publishFiles(): void
     {
-        foreach ($selectedFiles as $source => $target) {
+        foreach ($this->publishableFilesMap as $source => $target) {
             if (! Filesystem::isFile(dirname($target))) {
                 Filesystem::ensureDirectoryExists(dirname($target));
             } else {

From c50f60a9cfd2c027285fb7baa1c4b67495c76400 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:38:20 +0100
Subject: [PATCH 3805/4023] Simplify publishing handler

---
 .../Console/Helpers/InteractivePublishCommandHelper.php    | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 6cd19a9fab1..9c94b3e270f 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -55,11 +55,8 @@ protected function getBaseDirectory(): string
     public function publishFiles(): void
     {
         foreach ($this->publishableFilesMap as $source => $target) {
-            if (! Filesystem::isFile(dirname($target))) {
-                Filesystem::ensureDirectoryExists(dirname($target));
-            } else {
-                $target = dirname($target);
-            }
+            Filesystem::ensureDirectoryExists(dirname($target));
+
             Filesystem::copy($source, $target); // Todo: See how we should handle existing files
         }
     }

From a7a6652cab95d58b14682db25ef904a076247d39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:38:28 +0100
Subject: [PATCH 3806/4023] Formatting

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php      | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 9c94b3e270f..93b66947824 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -56,7 +56,6 @@ public function publishFiles(): void
     {
         foreach ($this->publishableFilesMap as $source => $target) {
             Filesystem::ensureDirectoryExists(dirname($target));
-
             Filesystem::copy($source, $target); // Todo: See how we should handle existing files
         }
     }

From ee62aaf40fa95480ceaa73b0edec9056944640a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:38:38 +0100
Subject: [PATCH 3807/4023] Remove todo as we overwrite files

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 93b66947824..ba92353d631 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -56,7 +56,7 @@ public function publishFiles(): void
     {
         foreach ($this->publishableFilesMap as $source => $target) {
             Filesystem::ensureDirectoryExists(dirname($target));
-            Filesystem::copy($source, $target); // Todo: See how we should handle existing files
+            Filesystem::copy($source, $target);
         }
     }
 

From 8697255d86f6623dd9277b5b0ea692ad2e62e8e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:41:27 +0100
Subject: [PATCH 3808/4023] Get selected files from instance

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ba92353d631..015a4829d48 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -62,11 +62,11 @@ public function publishFiles(): void
 
     /**
      * @experimental This method may be toned down in the future.
-     *
-     * @param  array<string>  $selectedFiles
      */
-    public function formatOutput(array $selectedFiles): string
+    public function formatOutput(): string
     {
+        $selectedFiles = array_keys($this->publishableFilesMap);
+
         $fileCount = count($selectedFiles);
         $displayLimit = 3;
 

From 6ff9b2ca958a0410a94e73b2ed572a04cb326e61 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:42:15 +0100
Subject: [PATCH 3809/4023] Use dynamic base directory

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 015a4829d48..f548e422a6b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -70,7 +70,8 @@ public function formatOutput(): string
         $fileCount = count($selectedFiles);
         $displayLimit = 3;
 
-        $fileNames = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $this->sourceDirectory));
+        $baseDirectory = $this->getBaseDirectory();
+        $fileNames = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $baseDirectory));
 
         $displayFiles = $fileNames->take($displayLimit)->implode(', ');
 

From df24553f87ba2cd7e3f2c35c24cd7e92c7072bf8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:43:36 +0100
Subject: [PATCH 3810/4023] Publish files

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 4462f397ccc..df6cfc7d15f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -58,6 +58,8 @@ public function handle(): int
 
         $publisher->publishFiles($files);
 
+        $publisher->publishFiles();
+
         return Command::SUCCESS;
     }
 

From b69a93ad28ca78cccb6427f34924d9474be19617 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:43:41 +0100
Subject: [PATCH 3811/4023] Write output

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index df6cfc7d15f..98decae909d 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -60,6 +60,8 @@ public function handle(): int
 
         $publisher->publishFiles();
 
+        $this->infoComment($publisher->formatOutput());
+
         return Command::SUCCESS;
     }
 

From 9672a0b8146b3d673dc87af33aea20b1e44c6211 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:48:49 +0100
Subject: [PATCH 3812/4023] Fix source not being used

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index f548e422a6b..2a0fefb6f03 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -35,7 +35,7 @@ public function getFileChoices(): array
     {
         $mostCommonDirectoryNominator = $this->getBaseDirectory();
 
-        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $source) use ($mostCommonDirectoryNominator): array {
+        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $target, string $source) use ($mostCommonDirectoryNominator): array {
             return [$source => $this->pathRelativeToDirectory($source, $mostCommonDirectoryNominator)];
         });
     }

From 05d4781f3c9583bc1ddd07a3b9a1025d316f9c13 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:49:21 +0100
Subject: [PATCH 3813/4023] Helper to only publish the selected files

---
 .../Helpers/InteractivePublishCommandHelper.php        | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 2a0fefb6f03..7b02cbcc422 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -40,6 +40,16 @@ public function getFileChoices(): array
         });
     }
 
+    /**
+     * Only publish the selected files.
+     *
+     * @param array<string> $selectedFiles Array of selected file paths, matching the keys of the publishableFilesMap.
+     */
+    public function only(array $selectedFiles): void
+    {
+        $this->publishableFilesMap = Arr::only($this->publishableFilesMap, $selectedFiles);
+    }
+
     protected function getBaseDirectory(): string
     {
         // Find the most specific common parent directory path for the files (in case they are in different directories, we want to trim as much as possible whilst keeping specificity and uniqueness)

From e6d03fe72f98097e9f9298a3442bf2991b32c5db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:49:49 +0100
Subject: [PATCH 3814/4023] Cleanup code

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 --
 1 file changed, 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 98decae909d..7b9913d3912 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -56,8 +56,6 @@ public function handle(): int
 
         $publisher = new InteractivePublishCommandHelper($files);
 
-        $publisher->publishFiles($files);
-
         $publisher->publishFiles();
 
         $this->infoComment($publisher->formatOutput());

From 5c8cec8d3ff7df650cd6fd956676643dde00fa38 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:50:07 +0100
Subject: [PATCH 3815/4023] Interactively publish selected files

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 7b9913d3912..6ea7ad206bc 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -56,6 +56,14 @@ public function handle(): int
 
         $publisher = new InteractivePublishCommandHelper($files);
 
+        if ($selected !== 'all' && ! Prompt::shouldFallback()) {
+            // If Laravel Prompts are supported, we interactively prompt the user for which files to publish
+            $choices = $publisher->getFileChoices();
+            $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+
+            $publisher->only($selectedFiles);
+        }
+
         $publisher->publishFiles();
 
         $this->infoComment($publisher->formatOutput());

From aebd65afe1fb0236f6e8717fb82abac14a8e22d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:51:40 +0100
Subject: [PATCH 3816/4023] Cleanup code

---
 .../src/Console/Commands/PublishViewsCommand.php         | 9 +++------
 .../Console/Helpers/InteractivePublishCommandHelper.php  | 8 +-------
 2 files changed, 4 insertions(+), 13 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 6ea7ad206bc..19b8649270b 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -58,10 +58,7 @@ public function handle(): int
 
         if ($selected !== 'all' && ! Prompt::shouldFallback()) {
             // If Laravel Prompts are supported, we interactively prompt the user for which files to publish
-            $choices = $publisher->getFileChoices();
-            $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-
-            $publisher->only($selectedFiles);
+            $publisher->only(multiselect('Select the files you want to publish (CTRL+A to toggle all)', $publisher->getFileChoices(), [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.'));
         }
 
         $publisher->publishFiles();
@@ -104,7 +101,7 @@ protected function promptForCategory(): string
     protected function formatPublishableChoices(): array
     {
         return collect($this->options)
-            ->map(fn (ViewPublishGroup $option, string $key): string => sprintf("<comment>%s</comment>: %s", $key, $option->description))
+            ->map(fn (ViewPublishGroup $option, string $key): string => sprintf('<comment>%s</comment>: %s', $key, $option->description))
             ->prepend('Publish all categories listed below')
             ->values()
             ->all();
@@ -116,7 +113,7 @@ protected function parseChoiceIntoKey(string $choice): string
     }
 
     /**
-     * @param array<string, \Hyde\Console\Helpers\ViewPublishGroup> $groups
+     * @param  array<string, \Hyde\Console\Helpers\ViewPublishGroup>  $groups
      * @return array<string, \Hyde\Console\Helpers\ViewPublishGroup>
      */
     protected static function mapToKeys(array $groups): array
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 7b02cbcc422..bf6edf56c5e 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -5,16 +5,10 @@
 namespace Hyde\Console\Helpers;
 
 use Hyde\Facades\Filesystem;
-use Hyde\Foundation\Providers\ViewServiceProvider;
-use Hyde\Hyde;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\File;
-use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
 use Illuminate\Support\Stringable;
-use Symfony\Component\Finder\SplFileInfo;
-
-use function Hyde\path_join;
 
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.
@@ -43,7 +37,7 @@ public function getFileChoices(): array
     /**
      * Only publish the selected files.
      *
-     * @param array<string> $selectedFiles Array of selected file paths, matching the keys of the publishableFilesMap.
+     * @param  array<string>  $selectedFiles  Array of selected file paths, matching the keys of the publishableFilesMap.
      */
     public function only(array $selectedFiles): void
     {

From 93af32edeed2463d213eb631347aa76e37e533cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:52:54 +0100
Subject: [PATCH 3817/4023] Remove unused method

---
 .../src/Console/Commands/PublishViewsCommand.php  | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 19b8649270b..8b958338e4f 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -68,21 +68,6 @@ public function handle(): int
         return Command::SUCCESS;
     }
 
-    protected function publishOption(string $selected, bool $isPublishingAll = false): void
-    {
-        $publisher = new InteractivePublishCommandHelper($this->options[$selected]['group']);
-
-        $choices = $publisher->getFileChoices();
-
-        MultiSelectPrompt::fallbackUsing(fn (): array => $choices);
-
-        $selectedFiles = multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
-
-        $publisher->handle($selectedFiles);
-
-        $this->infoComment($publisher->formatOutput($selectedFiles));
-    }
-
     protected function promptForCategory(): string
     {
         SelectPrompt::fallbackUsing(function (SelectPrompt $prompt): string {

From 7b1b7b02b00e15e3f968abbfc50aa11cec02c208 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:53:06 +0100
Subject: [PATCH 3818/4023] Remove unused import

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php      | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index bf6edf56c5e..26c64828cb7 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -6,7 +6,6 @@
 
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Arr;
-use Illuminate\Support\Facades\File;
 use Illuminate\Support\Str;
 use Illuminate\Support\Stringable;
 

From 6406e7caa2b1b90c5999024808c5c3a3f94e36e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:55:28 +0100
Subject: [PATCH 3819/4023] Improve formatting

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 26c64828cb7..07167998770 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -43,10 +43,12 @@ public function only(array $selectedFiles): void
         $this->publishableFilesMap = Arr::only($this->publishableFilesMap, $selectedFiles);
     }
 
+    /**  Find the most specific common parent directory path for the files, trimming as much as possible whilst keeping specificity and uniqueness. */
     protected function getBaseDirectory(): string
     {
-        // Find the most specific common parent directory path for the files (in case they are in different directories, we want to trim as much as possible whilst keeping specificity and uniqueness)
-        $partsMap = collect($this->publishableFilesMap)->map(fn (string $file): array => explode('/', $file));
+        $partsMap = collect($this->publishableFilesMap)->map(function (string $file): array {
+            return explode('/', $file);
+        });
 
         $commonParts = $partsMap->reduce(function (array $carry, array $parts): array {
             return array_intersect($carry, $parts);

From 8f1790cd6df0bdd30d0b490340619833f620a051 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:57:24 +0100
Subject: [PATCH 3820/4023] Simplify 'if'

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 8b958338e4f..3204d01b0bc 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -48,11 +48,9 @@ public function handle(): int
             return Command::FAILURE;
         }
 
-        if ($selected === 'all') {
-            $files = collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all();
-        } else {
-            $files = $this->options[$selected]->publishableFilesMap();
-        }
+        $files = $selected === 'all'
+            ? collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all()
+            : $this->options[$selected]->publishableFilesMap();
 
         $publisher = new InteractivePublishCommandHelper($files);
 

From 5f19c373ce1325316b2b75cae378f4da0ee6e7cf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 16:58:59 +0100
Subject: [PATCH 3821/4023] Extract helper method

---
 .../src/Console/Commands/PublishViewsCommand.php     | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 3204d01b0bc..0acace94380 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -55,8 +55,7 @@ public function handle(): int
         $publisher = new InteractivePublishCommandHelper($files);
 
         if ($selected !== 'all' && ! Prompt::shouldFallback()) {
-            // If Laravel Prompts are supported, we interactively prompt the user for which files to publish
-            $publisher->only(multiselect('Select the files you want to publish (CTRL+A to toggle all)', $publisher->getFileChoices(), [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.'));
+            $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
         }
 
         $publisher->publishFiles();
@@ -105,4 +104,13 @@ protected static function mapToKeys(array $groups): array
             return [Str::after($group->group, 'hyde-') => $group];
         })->all();
     }
+
+    /**
+     * @param array<string, string> $choices
+     * @return array<string>
+     */
+    protected function promptUserForWhichFilesToPublish(array $choices): array
+    {
+        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+    }
 }

From 1624692d32db0723717bbcbd830dbe19932b17b4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 17:01:26 +0100
Subject: [PATCH 3822/4023] Extract helper method

---
 .../Console/Commands/PublishViewsCommand.php  | 27 ++++++++++++-------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 0acace94380..041a21500f2 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -52,15 +52,7 @@ public function handle(): int
             ? collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all()
             : $this->options[$selected]->publishableFilesMap();
 
-        $publisher = new InteractivePublishCommandHelper($files);
-
-        if ($selected !== 'all' && ! Prompt::shouldFallback()) {
-            $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
-        }
-
-        $publisher->publishFiles();
-
-        $this->infoComment($publisher->formatOutput());
+        $this->publishSelectedFiles($files, $selected === 'all');
 
         return Command::SUCCESS;
     }
@@ -113,4 +105,21 @@ protected function promptUserForWhichFilesToPublish(array $choices): array
     {
         return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
     }
+
+    /**
+     * @param array<string, string> $files
+     * @param bool $isPublishingAll
+     */
+    protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
+    {
+        $publisher = new InteractivePublishCommandHelper($files);
+
+        if (! $isPublishingAll && ! Prompt::shouldFallback()) {
+            $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
+        }
+
+        $publisher->publishFiles();
+
+        $this->infoComment($publisher->formatOutput());
+    }
 }

From 0966cc701ed2968980a025ea202d3723411ec3b2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 17:02:13 +0100
Subject: [PATCH 3823/4023] Cleanup code

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 041a21500f2..c21c19ec7ae 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -8,7 +8,6 @@
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
-use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
 

From 54c125f5af6bb240326eca87e5fc0ba3d318c469 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 17:04:45 +0100
Subject: [PATCH 3824/4023] Remove extra newline

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index c21c19ec7ae..04bba0acc87 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -66,7 +66,7 @@ protected function promptForCategory(): string
 
         $selection = $this->parseChoiceIntoKey($choice);
 
-        $this->infoComment(sprintf("Selected category [%s]\n", $selection ?: 'all'));
+        $this->infoComment(sprintf("Selected category [%s]", $selection ?: 'all'));
 
         return $selection;
     }

From 991ffe1184e4c287025a1729101e1eca3bddc96c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 17:14:51 +0100
Subject: [PATCH 3825/4023] Print more helpful output

I expect the files I selected to be published, but I may not know the new paths
---
 .../InteractivePublishCommandHelper.php       | 34 +++++++------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 07167998770..d69ccd24aca 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -17,10 +17,13 @@ class InteractivePublishCommandHelper
     /** @var array<string, string> Map of source files to target files */
     protected array $publishableFilesMap;
 
+    protected readonly int $originalFileCount;
+
     /** @param array<string, string> $publishableFilesMap */
     public function __construct(array $publishableFilesMap)
     {
         $this->publishableFilesMap = $publishableFilesMap;
+        $this->originalFileCount = count($publishableFilesMap);
     }
 
     /** @return array<string, string> */
@@ -70,35 +73,22 @@ public function publishFiles(): void
      */
     public function formatOutput(): string
     {
-        $selectedFiles = array_keys($this->publishableFilesMap);
+        $fileCount = count($this->publishableFilesMap);
+
+        if ($fileCount === 1) {
+            $path = $this->publishableFilesMap[array_keys($this->publishableFilesMap)[0]];
 
-        $fileCount = count($selectedFiles);
-        $displayLimit = 3;
+            return "Published file to [$path].";
+        }
 
+        $count = $fileCount === $this->originalFileCount ? 'all' : $fileCount;
         $baseDirectory = $this->getBaseDirectory();
-        $fileNames = collect($selectedFiles)->map(fn (string $file): string => $this->pathRelativeToDirectory($file, $baseDirectory));
-
-        $displayFiles = $fileNames->take($displayLimit)->implode(', ');
-
-        return Str::of('Published')
-            ->when($fileCount === $this->publishableFilesMapCount(),
-                fn (Stringable $str): Stringable => $str->append(' all files, including'),
-                fn (Stringable $str): Stringable => $str->append(' ', Str::plural('file', $fileCount))
-            )
-            ->append(' [', $displayFiles, ']')
-            ->when($fileCount > $displayLimit,
-                fn (Stringable $str): Stringable => $str->append(' and ', $fileCount - $displayLimit, ' more')
-            )
-            ->toString();
+
+        return "Published $count files to [$baseDirectory].";
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string
     {
         return Str::after($source, basename($directory).'/');
     }
-
-    protected function publishableFilesMapCount(): int
-    {
-        return count($this->publishableFilesMap);
-    }
 }

From 6d5606f98bf32a3d15367a1b21cbc4fb876a4beb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:13:42 +0100
Subject: [PATCH 3826/4023] Add magic key to select all

---
 .../Console/Commands/PublishViewsCommand.php  | 33 +++++++++++++++++--
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 04bba0acc87..4c32545f671 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -8,10 +8,11 @@
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
+use Laravel\Prompts\Key;
+use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
 
-use function Laravel\Prompts\multiselect;
 use function Laravel\Prompts\select;
 use function str_replace;
 use function sprintf;
@@ -100,9 +101,35 @@ protected static function mapToKeys(array $groups): array
      * @param array<string, string> $choices
      * @return array<string>
      */
-    protected function promptUserForWhichFilesToPublish(array $choices): array
+    protected function promptUserForWhichFilesToPublish(array $files): array
     {
-        return multiselect('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
+
+        $prompt = new MultiSelectPrompt('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+
+        $prompt->on('key', function ($key) use ($prompt): void {
+            static $isToggled = false;
+            if ($prompt->highlighted === 0) {
+                if ($key === Key::SPACE) {
+                    if (! $isToggled) {
+                        $prompt->emit('key', Key::CTRL_A);
+                        $isToggled = true;
+                    } else {
+                        // Laravel Prompts is crazy, but this apparently is how you deselect all items
+                        $prompt->emit('key', Key::CTRL_A);
+                        $prompt->emit('key', Key::CTRL_A);
+                        $isToggled = false;
+                    }
+                } elseif ($key === Key::ENTER) {
+                    if (! $isToggled) {
+                        $prompt->emit('key', Key::CTRL_A);
+                    }
+                    $prompt->state = 'submit';
+                }
+            }
+        });
+
+        return $prompt->prompt();
     }
 
     /**

From 215d75c96e5240f319d4f31d53a8333b61f4802c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:14:54 +0100
Subject: [PATCH 3827/4023] No need to write we select all here

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 4c32545f671..ffa227f9e14 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -67,7 +67,9 @@ protected function promptForCategory(): string
 
         $selection = $this->parseChoiceIntoKey($choice);
 
-        $this->infoComment(sprintf("Selected category [%s]", $selection ?: 'all'));
+        if ($selection) {
+            $this->infoComment(sprintf("Selected category [%s]", $selection));
+        }
 
         return $selection;
     }

From 4be8d4231b9367917e84ec8c3e41362ea8e26fea Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:15:58 +0100
Subject: [PATCH 3828/4023] Move up method in source

---
 .../Console/Commands/PublishViewsCommand.php  | 35 ++++++++++---------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index ffa227f9e14..67f85e9252a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -99,6 +99,24 @@ protected static function mapToKeys(array $groups): array
         })->all();
     }
 
+
+    /**
+     * @param array<string, string> $files
+     * @param bool $isPublishingAll
+     */
+    protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
+    {
+        $publisher = new InteractivePublishCommandHelper($files);
+
+        if (! $isPublishingAll && ! Prompt::shouldFallback()) {
+            $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
+        }
+
+        $publisher->publishFiles();
+
+        $this->infoComment($publisher->formatOutput());
+    }
+
     /**
      * @param array<string, string> $choices
      * @return array<string>
@@ -133,21 +151,4 @@ protected function promptUserForWhichFilesToPublish(array $files): array
 
         return $prompt->prompt();
     }
-
-    /**
-     * @param array<string, string> $files
-     * @param bool $isPublishingAll
-     */
-    protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
-    {
-        $publisher = new InteractivePublishCommandHelper($files);
-
-        if (! $isPublishingAll && ! Prompt::shouldFallback()) {
-            $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
-        }
-
-        $publisher->publishFiles();
-
-        $this->infoComment($publisher->formatOutput());
-    }
 }

From a628959a621afd86b05b6a216fe571315cffc77e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:29:49 +0100
Subject: [PATCH 3829/4023] Fix parameter name

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 67f85e9252a..1337a9daf4a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -118,7 +118,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
     }
 
     /**
-     * @param array<string, string> $choices
+     * @param array<string, string> $files
      * @return array<string>
      */
     protected function promptUserForWhichFilesToPublish(array $files): array

From e54e782b3a3a4489c6c0fa1de58b096564577157 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:30:43 +0100
Subject: [PATCH 3830/4023] No longer need hint

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1337a9daf4a..caabda7e31a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -125,7 +125,7 @@ protected function promptUserForWhichFilesToPublish(array $files): array
     {
         $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
 
-        $prompt = new MultiSelectPrompt('Select the files you want to publish (CTRL+A to toggle all)', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
         $prompt->on('key', function ($key) use ($prompt): void {
             static $isToggled = false;

From 5df46b539dfa943a378d25dab7b32f589211adf2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:36:39 +0100
Subject: [PATCH 3831/4023] Use search instead of select

---
 .../src/Console/Commands/PublishViewsCommand.php      | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index caabda7e31a..27e0f065bec 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,6 +9,7 @@
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
 use Laravel\Prompts\Key;
+use Laravel\Prompts\MultiSearchPrompt;
 use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
@@ -123,9 +124,15 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
      */
     protected function promptUserForWhichFilesToPublish(array $files): array
     {
-        $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
+        $choices = collect(array_merge(['all' => '<comment>All files</comment>'], $files));
 
-        $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $prompt = new MultiSearchPrompt('Select the files you want to publish', function (string $search) use ($choices): array {
+            if (empty($search)) {
+                return $choices->all();
+            }
+
+            return $choices->filter(fn (string $label, string $value) => str_contains($value, $search))->all();
+        }, 'Type to filter', 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
         $prompt->on('key', function ($key) use ($prompt): void {
             static $isToggled = false;

From 3f95c4dc7e063a941d62e5cf865690274e918539 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:36:43 +0100
Subject: [PATCH 3832/4023] Revert "Use search instead of select"

This reverts commit d35b01e3c34fdd64d4bdbf2e320e4e20caa03687.
---
 .../src/Console/Commands/PublishViewsCommand.php      | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 27e0f065bec..caabda7e31a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -9,7 +9,6 @@
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
 use Laravel\Prompts\Key;
-use Laravel\Prompts\MultiSearchPrompt;
 use Laravel\Prompts\MultiSelectPrompt;
 use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
@@ -124,15 +123,9 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
      */
     protected function promptUserForWhichFilesToPublish(array $files): array
     {
-        $choices = collect(array_merge(['all' => '<comment>All files</comment>'], $files));
+        $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
 
-        $prompt = new MultiSearchPrompt('Select the files you want to publish', function (string $search) use ($choices): array {
-            if (empty($search)) {
-                return $choices->all();
-            }
-
-            return $choices->filter(fn (string $label, string $value) => str_contains($value, $search))->all();
-        }, 'Type to filter', 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
+        $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
         $prompt->on('key', function ($key) use ($prompt): void {
             static $isToggled = false;

From 004b7de53c0a9d0bf6b8bcaf18023fd6984c6722 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:38:06 +0100
Subject: [PATCH 3833/4023] Extract helper method

---
 .../src/Console/Commands/PublishViewsCommand.php | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index caabda7e31a..69943f25498 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Console\Commands;
 
+use Closure;
 use Hyde\Console\Concerns\Command;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Console\Helpers\ViewPublishGroup;
@@ -127,8 +128,16 @@ protected function promptUserForWhichFilesToPublish(array $files): array
 
         $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
-        $prompt->on('key', function ($key) use ($prompt): void {
+        $prompt->on('key', static::supportTogglingAll($prompt));
+
+        return $prompt->prompt();
+    }
+
+    protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
+    {
+        return function ($key) use ($prompt): void {
             static $isToggled = false;
+
             if ($prompt->highlighted === 0) {
                 if ($key === Key::SPACE) {
                     if (! $isToggled) {
@@ -144,11 +153,10 @@ protected function promptUserForWhichFilesToPublish(array $files): array
                     if (! $isToggled) {
                         $prompt->emit('key', Key::CTRL_A);
                     }
+
                     $prompt->state = 'submit';
                 }
             }
-        });
-
-        return $prompt->prompt();
+        };
     }
 }

From baf1571622b4df6541a9afe9ad2a54f7f5c0f219 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:42:25 +0100
Subject: [PATCH 3834/4023] Fix formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 69943f25498..94d9ebbedc2 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -102,8 +102,8 @@ protected static function mapToKeys(array $groups): array
 
 
     /**
-     * @param array<string, string> $files
-     * @param bool $isPublishingAll
+     * @param  array<string, string>  $files
+     * @param  bool  $isPublishingAll
      */
     protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
     {
@@ -119,7 +119,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
     }
 
     /**
-     * @param array<string, string> $files
+     * @param  array<string, string>  $files
      * @return array<string>
      */
     protected function promptUserForWhichFilesToPublish(array $files): array

From 20d879c210ce277e1676cc6181675ca589a6e248 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:43:10 +0100
Subject: [PATCH 3835/4023] Cleanup control flow

---
 .../src/Console/Commands/PublishViewsCommand.php       | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 94d9ebbedc2..d82decca8bc 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -140,14 +140,14 @@ protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
 
             if ($prompt->highlighted === 0) {
                 if ($key === Key::SPACE) {
-                    if (! $isToggled) {
-                        $prompt->emit('key', Key::CTRL_A);
-                        $isToggled = true;
-                    } else {
+                    $prompt->emit('key', Key::CTRL_A);
+
+                    if ($isToggled) {
                         // Laravel Prompts is crazy, but this apparently is how you deselect all items
                         $prompt->emit('key', Key::CTRL_A);
-                        $prompt->emit('key', Key::CTRL_A);
                         $isToggled = false;
+                    } else {
+                        $isToggled = true;
                     }
                 } elseif ($key === Key::ENTER) {
                     if (! $isToggled) {

From 93fba2c55b790ffca28ad279fced4d2ceb9708aa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:45:06 +0100
Subject: [PATCH 3836/4023] Ignore coverage for Laravel Prompts patch

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index d82decca8bc..54857cc1205 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -133,6 +133,7 @@ protected function promptUserForWhichFilesToPublish(array $files): array
         return $prompt->prompt();
     }
 
+    /** @codeCoverageIgnore We can't easily test Laravel Prompts. */
     protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
     {
         return function ($key) use ($prompt): void {

From 592c2eb70cd177b0e02aca5face271395c018ecc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:48:44 +0100
Subject: [PATCH 3837/4023] Dynamic label

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 54857cc1205..035a5cdcb77 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -124,7 +124,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
      */
     protected function promptUserForWhichFilesToPublish(array $files): array
     {
-        $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
+        $choices = array_merge(['all' => '<comment>Select all files</comment>'], $files);
 
         $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
@@ -146,8 +146,10 @@ protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
                     if ($isToggled) {
                         // Laravel Prompts is crazy, but this apparently is how you deselect all items
                         $prompt->emit('key', Key::CTRL_A);
+                        $prompt->options['all'] = '<comment>Select all files</comment>';
                         $isToggled = false;
                     } else {
+                        $prompt->options['all'] = '<comment>Unselect all files</comment>';
                         $isToggled = true;
                     }
                 } elseif ($key === Key::ENTER) {

From d51c76851994b494c9b4f61b804911e0fa9707c5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:48:47 +0100
Subject: [PATCH 3838/4023] Revert "Dynamic label"

This reverts commit 27e5b0b489e4a7d9787ca6df59ad91cc42c63d12.
---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 035a5cdcb77..54857cc1205 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -124,7 +124,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
      */
     protected function promptUserForWhichFilesToPublish(array $files): array
     {
-        $choices = array_merge(['all' => '<comment>Select all files</comment>'], $files);
+        $choices = array_merge(['all' => '<comment>All files</comment>'], $files);
 
         $prompt = new MultiSelectPrompt('Select the files you want to publish', $choices, [], 10, 'required', hint: 'Navigate with arrow keys, space to select, enter to confirm.');
 
@@ -146,10 +146,8 @@ protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
                     if ($isToggled) {
                         // Laravel Prompts is crazy, but this apparently is how you deselect all items
                         $prompt->emit('key', Key::CTRL_A);
-                        $prompt->options['all'] = '<comment>Select all files</comment>';
                         $isToggled = false;
                     } else {
-                        $prompt->options['all'] = '<comment>Unselect all files</comment>';
                         $isToggled = true;
                     }
                 } elseif ($key === Key::ENTER) {

From 793d27cf5594fd3146d7dbba6edc5817e472634a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:49:04 +0100
Subject: [PATCH 3839/4023] Use more semantic helper

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 54857cc1205..67f13b49df4 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -139,7 +139,7 @@ protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
         return function ($key) use ($prompt): void {
             static $isToggled = false;
 
-            if ($prompt->highlighted === 0) {
+            if ($prompt->isHighlighted('all')) {
                 if ($key === Key::SPACE) {
                     $prompt->emit('key', Key::CTRL_A);
 

From d54b2b9f7c87e37c29dd8d71ed39720d138cb574 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 18:51:53 +0100
Subject: [PATCH 3840/4023] Formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php     | 3 +--
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 1 -
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 67f13b49df4..b692dc592e2 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -69,7 +69,7 @@ protected function promptForCategory(): string
         $selection = $this->parseChoiceIntoKey($choice);
 
         if ($selection) {
-            $this->infoComment(sprintf("Selected category [%s]", $selection));
+            $this->infoComment(sprintf('Selected category [%s]', $selection));
         }
 
         return $selection;
@@ -100,7 +100,6 @@ protected static function mapToKeys(array $groups): array
         })->all();
     }
 
-
     /**
      * @param  array<string, string>  $files
      * @param  bool  $isPublishingAll
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index d69ccd24aca..fdea7ed5456 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -7,7 +7,6 @@
 use Hyde\Facades\Filesystem;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Str;
-use Illuminate\Support\Stringable;
 
 /**
  * @internal This class offloads logic from the PublishViewsCommand class and should not be used elsewhere.

From da40f5fc0f60e522176d6557bc1fd269886174d0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:12:52 +0100
Subject: [PATCH 3841/4023] Rewrite unit test for new scope

---
 .../InteractivePublishCommandHelperTest.php   | 172 +++++-------------
 1 file changed, 47 insertions(+), 125 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index afbe6c8c4b6..86375af0c81 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -4,179 +4,101 @@
 
 namespace Hyde\Framework\Testing\Unit;
 
-use Hyde\Testing\CreatesApplication;
-use Illuminate\Filesystem\Filesystem;
-use Mockery;
+use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Foundation\Providers\ViewServiceProvider;
-use Hyde\Console\Helpers\InteractivePublishCommandHelper;
-use Illuminate\Support\Facades\Blade;
-use Illuminate\Support\Facades\Facade;
+use Illuminate\Filesystem\Filesystem;
 use Illuminate\Support\Facades\File;
-use Symfony\Component\Finder\SplFileInfo;
+use Mockery;
 
 /**
  * @covers \Hyde\Console\Helpers\InteractivePublishCommandHelper
- *
- * @see \Hyde\Framework\Testing\Feature\Commands\PublishViewsCommandTest
  */
 class InteractivePublishCommandHelperTest extends UnitTestCase
 {
-    use CreatesApplication;
-
     protected static bool $needsKernel = true;
-
     protected Filesystem|Mockery\MockInterface $filesystem;
 
     protected function setUp(): void
     {
-        $app = $this->createApplication();
-
         $this->filesystem = $this->mockFilesystemStrict();
-        $this->filesystem->shouldReceive('allFiles')->andReturn([])->byDefault();
-
         File::swap($this->filesystem);
-        Blade::partialMock()->shouldReceive('component');
-
-        (new ViewServiceProvider($app))->boot();
     }
 
     protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
-
-        Facade::clearResolvedInstances();
+        File::swap(null);
     }
 
-    public function testGetFileChoices()
+    public function testGetFileChoices(): void
     {
-        $this->filesystem->shouldReceive('allFiles')->andReturn([
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/app.blade.php'), '', 'app.blade.php'),
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/page.blade.php'), '', 'page.blade.php'),
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/post.blade.php'), '', 'post.blade.php'),
+        $helper = new InteractivePublishCommandHelper([
+            'source/path/file1.php' => 'target/path/file1.php',
+            'source/path/file2.php' => 'target/path/file2.php',
         ]);
 
-        $helper = new InteractivePublishCommandHelper('hyde-layouts');
-
         $this->assertSame([
-            'resources/views/vendor/hyde/layouts/app.blade.php' => 'app.blade.php',
-            'resources/views/vendor/hyde/layouts/page.blade.php' => 'page.blade.php',
-            'resources/views/vendor/hyde/layouts/post.blade.php' => 'post.blade.php',
+            'source/path/file1.php' => 'file1.php',
+            'source/path/file2.php' => 'file2.php',
         ], $helper->getFileChoices());
     }
 
-    public function testHandle()
+    public function testOnlyFiltersPublishableFiles(): void
     {
-        $this->filesystem->shouldReceive('allFiles')->andReturn([
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/app.blade.php'), '', 'app.blade.php'),
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/page.blade.php'), '', 'page.blade.php'),
-            new SplFileInfo(Hyde::path('packages/framework/resources/views/layouts/post.blade.php'), '', 'post.blade.php'),
+        $helper = new InteractivePublishCommandHelper([
+            'source/path/file1.php' => 'target/path/file1.php',
+            'source/path/file2.php' => 'target/path/file2.php',
+            'source/path/file3.php' => 'target/path/file3.php',
         ]);
 
-        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+        $helper->only(['source/path/file1.php', 'source/path/file3.php']);
 
-        $this->filesystem->shouldReceive('ensureDirectoryExists')->twice();
-        $this->filesystem->shouldReceive('copy')->twice();
-
-        $helper->handle([
-            'resources/views/vendor/hyde/layouts/app.blade.php',
-            'resources/views/vendor/hyde/layouts/page.blade.php',
-        ]);
-
-        $this->filesystem->shouldHaveReceived('ensureDirectoryExists')
-            ->with(Hyde::path('resources/views/vendor/hyde/layouts'))
-            ->twice();
-
-        $this->filesystem->shouldHaveReceived('copy')->with(
-            Hyde::path('packages/framework/resources/views/layouts/app.blade.php'),
-            Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php')
-        )->once();
-
-        $this->filesystem->shouldHaveReceived('copy')->with(
-            Hyde::path('packages/framework/resources/views/layouts/page.blade.php'),
-            Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php')
-        )->once();
+        $this->assertSame([
+            'source/path/file1.php' => 'file1.php',
+            'source/path/file3.php' => 'file3.php',
+        ], $helper->getFileChoices());
     }
 
-    public function testFormatOutput()
+    public function testPublishFiles(): void
     {
-        $helper = new InteractivePublishCommandHelper('hyde-layouts');
+        $this->filesystem->shouldReceive('ensureDirectoryExists')->twice();
+        $this->filesystem->shouldReceive('copy')->twice();
 
-        $output = $helper->formatOutput([
-            'resources/views/vendor/hyde/layouts/app.blade.php',
-            'resources/views/vendor/hyde/layouts/page.blade.php',
-            'resources/views/vendor/hyde/layouts/post.blade.php',
+        $helper = new InteractivePublishCommandHelper([
+            'source/path/file1.php' => 'target/path/file1.php',
+            'source/path/file2.php' => 'target/path/file2.php',
         ]);
 
-        $this->assertSame('Published files [app.blade.php, page.blade.php, post.blade.php]', $output);
-    }
+        $helper->publishFiles();
 
-    public function testFormatOutputWithSingleFile()
-    {
-        $output = $this->getHelper()->formatOutput($this->selectedFiles(1));
-
-        $this->assertSame('Published file [app.blade.php]', $output);
-    }
-
-    public function testFormatOutputWithMultipleFiles()
-    {
-        $output = $this->getHelper()->formatOutput($this->selectedFiles(3));
-
-        $this->assertSame('Published files [app.blade.php, docs.blade.php, footer.blade.php]', $output);
-    }
-
-    public function testFormatOutputWithManyFiles()
-    {
-        $output = $this->getHelper()->formatOutput($this->selectedFiles(7));
-
-        $this->assertSame('Published files [app.blade.php, docs.blade.php, footer.blade.php] and 4 more', $output);
-    }
-
-    public function testFormatOutputWithAllFiles()
-    {
-        $output = $this->getHelper()->mockPublishableFileCount(10)->formatOutput($this->selectedFiles(10));
-
-        $this->assertSame('Published all files, including [app.blade.php, docs.blade.php, footer.blade.php] and 7 more', $output);
+        $this->filesystem->shouldHaveReceived('ensureDirectoryExists')->with(Hyde::path('target/path'))->twice();
+        $this->filesystem->shouldHaveReceived('copy')->with(Hyde::path('source/path/file1.php'), Hyde::path('target/path/file1.php'))->once();
+        $this->filesystem->shouldHaveReceived('copy')->with(Hyde::path('source/path/file2.php'), Hyde::path('target/path/file2.php'))->once();
     }
 
-    protected function getHelper(): MockableInteractivePublishCommandHelper
+    public function testFormatOutputForSingleFile(): void
     {
-        return new MockableInteractivePublishCommandHelper('hyde-layouts');
-    }
+        $helper = new InteractivePublishCommandHelper([
+            'source/path/file1.php' => 'target/path/file1.php',
+        ]);
 
-    protected function selectedFiles(int $take = 10): array
-    {
-        $files = [
-            'resources/views/vendor/hyde/layouts/app.blade.php',
-            'resources/views/vendor/hyde/layouts/docs.blade.php',
-            'resources/views/vendor/hyde/layouts/footer.blade.php',
-            'resources/views/vendor/hyde/layouts/head.blade.php',
-            'resources/views/vendor/hyde/layouts/meta.blade.php',
-            'resources/views/vendor/hyde/layouts/navigation.blade.php',
-            'resources/views/vendor/hyde/layouts/page.blade.php',
-            'resources/views/vendor/hyde/layouts/post.blade.php',
-            'resources/views/vendor/hyde/layouts/scripts.blade.php',
-            'resources/views/vendor/hyde/layouts/styles.blade.php',
-        ];
-
-        return array_slice($files, 0, $take);
+        $this->assertSame(
+            'Published file to [target/path/file1.php].',
+            $helper->formatOutput()
+        );
     }
-}
 
-class MockableInteractivePublishCommandHelper extends InteractivePublishCommandHelper
-{
-    public ?int $mockedPublishableFilesMapCount = null;
-
-    public function mockPublishableFileCount(int $count): self
+    public function testFormatOutputForMultipleFiles(): void
     {
-        $this->mockedPublishableFilesMapCount = $count;
-
-        return $this;
-    }
+        $helper = new InteractivePublishCommandHelper([
+            'source/path/file1.php' => 'target/path/file1.php',
+            'source/path/file2.php' => 'target/path/file2.php',
+        ]);
 
-    protected function publishableFilesMapCount(): int
-    {
-        return $this->mockedPublishableFilesMapCount ?? parent::publishableFilesMapCount();
+        $this->assertSame(
+            'Published all files to [target/path].',
+            $helper->formatOutput()
+        );
     }
 }

From 134b4e99b7f663c06f5f241df4d3cf5b49a2f01c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:17:52 +0100
Subject: [PATCH 3842/4023] Remove experimental marker

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index fdea7ed5456..5423cbb7a9b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -67,9 +67,6 @@ public function publishFiles(): void
         }
     }
 
-    /**
-     * @experimental This method may be toned down in the future.
-     */
     public function formatOutput(): string
     {
         $fileCount = count($this->publishableFilesMap);

From 2025cf6556011670316ae5d8313a2fdfc458dcad Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:19:23 +0100
Subject: [PATCH 3843/4023] Fix formatting

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 5423cbb7a9b..c4366dc0bca 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -45,7 +45,7 @@ public function only(array $selectedFiles): void
         $this->publishableFilesMap = Arr::only($this->publishableFilesMap, $selectedFiles);
     }
 
-    /**  Find the most specific common parent directory path for the files, trimming as much as possible whilst keeping specificity and uniqueness. */
+    /** Find the most specific common parent directory path for the files, trimming as much as possible whilst keeping specificity and uniqueness. */
     protected function getBaseDirectory(): string
     {
         $partsMap = collect($this->publishableFilesMap)->map(function (string $file): array {

From 51358b1aa301498a07ce13fdcbc55b9298ffaf58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:19:41 +0100
Subject: [PATCH 3844/4023] Make helper public

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index c4366dc0bca..f72c09e0270 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -46,7 +46,7 @@ public function only(array $selectedFiles): void
     }
 
     /** Find the most specific common parent directory path for the files, trimming as much as possible whilst keeping specificity and uniqueness. */
-    protected function getBaseDirectory(): string
+    public function getBaseDirectory(): string
     {
         $partsMap = collect($this->publishableFilesMap)->map(function (string $file): array {
             return explode('/', $file);

From 574fb8b972d52ac5f7bf44ac16a074507e31302c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:25:15 +0100
Subject: [PATCH 3845/4023] Use more realistic dataset

---
 .../InteractivePublishCommandHelperTest.php   | 63 ++++++++++++-------
 1 file changed, 41 insertions(+), 22 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 86375af0c81..e00ff24857c 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -34,57 +34,76 @@ protected function tearDown(): void
     public function testGetFileChoices(): void
     {
         $helper = new InteractivePublishCommandHelper([
-            'source/path/file1.php' => 'target/path/file1.php',
-            'source/path/file2.php' => 'target/path/file2.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
         ]);
 
         $this->assertSame([
-            'source/path/file1.php' => 'file1.php',
-            'source/path/file2.php' => 'file2.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'post.blade.php',
         ], $helper->getFileChoices());
     }
 
     public function testOnlyFiltersPublishableFiles(): void
     {
         $helper = new InteractivePublishCommandHelper([
-            'source/path/file1.php' => 'target/path/file1.php',
-            'source/path/file2.php' => 'target/path/file2.php',
-            'source/path/file3.php' => 'target/path/file3.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
         ]);
 
-        $helper->only(['source/path/file1.php', 'source/path/file3.php']);
+        $helper->only([
+            'packages/framework/resources/views/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php'
+        ]);
 
         $this->assertSame([
-            'source/path/file1.php' => 'file1.php',
-            'source/path/file3.php' => 'file3.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'app.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'post.blade.php',
         ], $helper->getFileChoices());
     }
 
     public function testPublishFiles(): void
     {
-        $this->filesystem->shouldReceive('ensureDirectoryExists')->twice();
-        $this->filesystem->shouldReceive('copy')->twice();
+        $this->filesystem->shouldReceive('ensureDirectoryExists')->times(3);
+        $this->filesystem->shouldReceive('copy')->times(3);
 
         $helper = new InteractivePublishCommandHelper([
-            'source/path/file1.php' => 'target/path/file1.php',
-            'source/path/file2.php' => 'target/path/file2.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
         ]);
 
         $helper->publishFiles();
 
-        $this->filesystem->shouldHaveReceived('ensureDirectoryExists')->with(Hyde::path('target/path'))->twice();
-        $this->filesystem->shouldHaveReceived('copy')->with(Hyde::path('source/path/file1.php'), Hyde::path('target/path/file1.php'))->once();
-        $this->filesystem->shouldHaveReceived('copy')->with(Hyde::path('source/path/file2.php'), Hyde::path('target/path/file2.php'))->once();
+        $this->filesystem->shouldHaveReceived('ensureDirectoryExists')->with(Hyde::path('resources/views/vendor/hyde/layouts'))->times(3);
+
+        $this->filesystem->shouldHaveReceived('copy')->with(
+            Hyde::path('packages/framework/resources/views/layouts/app.blade.php'),
+            Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php')
+        )->once();
+
+        $this->filesystem->shouldHaveReceived('copy')->with(
+            Hyde::path('packages/framework/resources/views/layouts/page.blade.php'),
+            Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php')
+        )->once();
+
+        $this->filesystem->shouldHaveReceived('copy')->with(
+            Hyde::path('packages/framework/resources/views/layouts/post.blade.php'),
+            Hyde::path('resources/views/vendor/hyde/layouts/post.blade.php')
+        )->once();
     }
 
     public function testFormatOutputForSingleFile(): void
     {
         $helper = new InteractivePublishCommandHelper([
-            'source/path/file1.php' => 'target/path/file1.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
         ]);
 
         $this->assertSame(
-            'Published file to [target/path/file1.php].',
+            'Published file to [resources/views/vendor/hyde/layouts/app.blade.php].',
             $helper->formatOutput()
         );
     }
@@ -92,12 +111,12 @@ public function testFormatOutputForSingleFile(): void
     public function testFormatOutputForMultipleFiles(): void
     {
         $helper = new InteractivePublishCommandHelper([
-            'source/path/file1.php' => 'target/path/file1.php',
-            'source/path/file2.php' => 'target/path/file2.php',
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
         ]);
 
         $this->assertSame(
-            'Published all files to [target/path].',
+            'Published all files to [resources/views/vendor/hyde/layouts].',
             $helper->formatOutput()
         );
     }

From e52b1f97b3bac7517853faa1726cb05cfb76d576 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:26:46 +0100
Subject: [PATCH 3846/4023] Test more cases

---
 .../InteractivePublishCommandHelperTest.php   | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index e00ff24857c..e2f5888c00d 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -120,4 +120,41 @@ public function testFormatOutputForMultipleFiles(): void
             $helper->formatOutput()
         );
     }
+
+    public function testFormatOutputForSingleChosenFile(): void
+    {
+        $helper = new InteractivePublishCommandHelper([
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
+        ]);
+
+        $helper->only([
+            'packages/framework/resources/views/layouts/app.blade.php'
+        ]);
+
+        $this->assertSame(
+            'Published file to [resources/views/vendor/hyde/layouts/app.blade.php].',
+            $helper->formatOutput()
+        );
+    }
+
+    public function testFormatOutputForMultipleChosenFiles(): void
+    {
+        $helper = new InteractivePublishCommandHelper([
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
+        ]);
+
+        $helper->only([
+            'packages/framework/resources/views/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php',
+        ]);
+
+        $this->assertSame(
+            'Published 2 files to [resources/views/vendor/hyde/layouts].',
+            $helper->formatOutput()
+        );
+    }
 }

From 0f3fd96032071bbb75b8a00ce9c7fa5416675365 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:41:53 +0100
Subject: [PATCH 3847/4023] Test the base directory helper

---
 .../InteractivePublishCommandHelperTest.php   | 40 +++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index e2f5888c00d..43c34db205a 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -157,4 +157,44 @@ public function testFormatOutputForMultipleChosenFiles(): void
             $helper->formatOutput()
         );
     }
+
+    public function testGetBaseDirectoryWithOneSet(): void
+    {
+        $helper = new InteractivePublishCommandHelper([
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
+        ]);
+
+        $this->assertSame(
+            'resources/views/vendor/hyde/layouts',
+            $helper->getBaseDirectory()
+        );
+    }
+
+    public function testGetBaseDirectoryWithMultipleSets(): void
+    {
+        $helper = new InteractivePublishCommandHelper([
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
+            'packages/framework/resources/views/components/page.blade.php' => 'resources/views/vendor/hyde/components/page.blade.php',
+        ]);
+
+        $this->assertSame(
+            'resources/views/vendor/hyde',
+            $helper->getBaseDirectory()
+        );
+    }
+
+    public function testGetBaseDirectoryWithSinglePath(): void
+    {
+        $helper = new InteractivePublishCommandHelper([
+            'packages/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+        ]);
+
+        $this->assertSame(
+            'resources/views/vendor/hyde/layouts/app.blade.php',
+            $helper->getBaseDirectory()
+        );
+    }
 }

From 7c21ab59ddab40b65fe28db2f302d618a4d9623e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:42:58 +0100
Subject: [PATCH 3848/4023] Fix formatting

---
 .../framework/tests/Unit/InteractivePublishCommandHelperTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 43c34db205a..f4acf9860f9 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -17,6 +17,7 @@
 class InteractivePublishCommandHelperTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
+
     protected Filesystem|Mockery\MockInterface $filesystem;
 
     protected function setUp(): void

From 796bae1d279df8edb806f8cf5986049c94d50b57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:44:51 +0100
Subject: [PATCH 3849/4023] Cleanup and refactor method

---
 .../Helpers/InteractivePublishCommandHelper.php      | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index f72c09e0270..a657270a1bb 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -72,15 +72,15 @@ public function formatOutput(): string
         $fileCount = count($this->publishableFilesMap);
 
         if ($fileCount === 1) {
-            $path = $this->publishableFilesMap[array_keys($this->publishableFilesMap)[0]];
-
-            return "Published file to [$path].";
+            return sprintf('Published file to [%s].', reset($this->publishableFilesMap));
         }
 
-        $count = $fileCount === $this->originalFileCount ? 'all' : $fileCount;
-        $baseDirectory = $this->getBaseDirectory();
+        return sprintf('Published %s files to [%s].', $this->getCountDescription($fileCount), $this->getBaseDirectory());
+    }
 
-        return "Published $count files to [$baseDirectory].";
+    protected function getCountDescription(int $fileCount): string
+    {
+        return $fileCount === $this->originalFileCount ? 'all' : (string) $fileCount;
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string

From 25296301893d7666dafd068f8968cb9ad19e7f1a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:45:58 +0100
Subject: [PATCH 3850/4023] Reformat to ternary return

---
 .../Console/Helpers/InteractivePublishCommandHelper.php   | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index a657270a1bb..f72d9c4e9df 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -71,11 +71,9 @@ public function formatOutput(): string
     {
         $fileCount = count($this->publishableFilesMap);
 
-        if ($fileCount === 1) {
-            return sprintf('Published file to [%s].', reset($this->publishableFilesMap));
-        }
-
-        return sprintf('Published %s files to [%s].', $this->getCountDescription($fileCount), $this->getBaseDirectory());
+        return $fileCount === 1
+            ? sprintf('Published file to [%s].', reset($this->publishableFilesMap))
+            : sprintf('Published %s files to [%s].', $this->getCountDescription($fileCount), $this->getBaseDirectory());
     }
 
     protected function getCountDescription(int $fileCount): string

From 1accd038784fa2b5dc403d0cc2b4e65da063df39 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:47:22 +0100
Subject: [PATCH 3851/4023] Merge declaration

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index f72d9c4e9df..6537ce416e2 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -69,9 +69,7 @@ public function publishFiles(): void
 
     public function formatOutput(): string
     {
-        $fileCount = count($this->publishableFilesMap);
-
-        return $fileCount === 1
+        return ($fileCount = count($this->publishableFilesMap)) === 1
             ? sprintf('Published file to [%s].', reset($this->publishableFilesMap))
             : sprintf('Published %s files to [%s].', $this->getCountDescription($fileCount), $this->getBaseDirectory());
     }

From f9d36f69478fe1f83aa63ae28345b4bfac6052ab Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:49:14 +0100
Subject: [PATCH 3852/4023] Remove multi select mocker we are no longer using

---
 .../src/Console/Helpers/ConsoleHelper.php     | 25 -------
 .../tests/Unit/ConsoleHelperTest.php          | 67 -------------------
 2 files changed, 92 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 5ace431d13f..c78c8602657 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -36,29 +36,4 @@ public static function mockWindowsOs(bool $isWindows = true): void
     {
         static::$mocks['usesWindowsOs'] = $isWindows;
     }
-
-    /* @return array<int|string> */
-    public static function multiselect(string $label, array|Collection $options, array|Collection $default = [], int $scroll = 5, bool|string $required = false, mixed $validate = null, string $hint = 'Use the space bar to select options.', ?Closure $transform = null): array
-    {
-        if (isset(static::$mocks['multiselect'])) {
-            $returns = static::$mocks['multiselect'];
-            $assertionCallback = static::$mocks['multiselectAssertion'] ?? null;
-
-            if ($assertionCallback !== null) {
-                $assertionCallback(...func_get_args());
-            }
-
-            return $returns;
-        }
-
-        return multiselect(...func_get_args());
-    }
-
-    public static function mockMultiselect(array $returns, ?Closure $assertionCallback = null): void
-    {
-        assert(! isset(static::$mocks['multiselect']), 'Cannot mock multiselect twice.');
-
-        static::$mocks['multiselect'] = $returns;
-        static::$mocks['multiselectAssertion'] = $assertionCallback;
-    }
 }
diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index 027b70a1f0d..82960525c4e 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -28,7 +28,6 @@ public function testClearMocksClearsAllMocks()
     {
         // Set up some mocks
         ConsoleHelper::mockWindowsOs(true);
-        ConsoleHelper::mockMultiselect(['option1']);
 
         // Clear mocks
         ConsoleHelper::clearMocks();
@@ -50,70 +49,4 @@ public function testUsesWindowsOsReturnsMockedValue()
         ConsoleHelper::mockWindowsOs(false);
         $this->assertFalse(ConsoleHelper::usesWindowsOs());
     }
-
-    public function testMultiselectReturnsMockedValues()
-    {
-        $mockedReturn = ['option1', 'option2'];
-        ConsoleHelper::mockMultiselect($mockedReturn);
-
-        $result = ConsoleHelper::multiselect(
-            'Select options',
-            ['option1', 'option2', 'option3'],
-            []
-        );
-
-        $this->assertSame($mockedReturn, $result);
-    }
-
-    public function testMultiselectAssertionCallbackIsExecuted()
-    {
-        $wasCalled = false;
-        $expectedLabel = 'Select options';
-        $expectedOptions = ['option1', 'option2'];
-        $expectedDefault = ['option1'];
-
-        ConsoleHelper::mockMultiselect(
-            ['option1'],
-            function ($label, $options, $default) use (
-                $expectedLabel,
-                $expectedOptions,
-                $expectedDefault,
-                &$wasCalled
-            ) {
-                $this->assertSame($expectedLabel, $label);
-                $this->assertSame($expectedOptions, $options);
-                $this->assertSame($expectedDefault, $default);
-                $wasCalled = true;
-            }
-        );
-
-        ConsoleHelper::multiselect($expectedLabel, $expectedOptions, $expectedDefault);
-        $this->assertTrue($wasCalled);
-    }
-
-    public function testMultiselectSignatureMatchesLaravelPrompts()
-    {
-        $reflectionLaravel = new ReflectionFunction('\Laravel\Prompts\multiselect');
-        $reflectionHelper = new ReflectionMethod(ConsoleHelper::class, 'multiselect');
-
-        $laravelParams = $reflectionLaravel->getParameters();
-        $helperParams = $reflectionHelper->getParameters();
-
-        $this->assertCount(count($laravelParams), $helperParams, 'Parameter count mismatch');
-
-        foreach ($laravelParams as $index => $laravelParam) {
-            $helperParam = $helperParams[$index];
-
-            $this->assertSame($laravelParam->getName(), $helperParam->getName(), "Parameter name mismatch at position {$index}");
-            $this->assertEquals($laravelParam->getType(), $helperParam->getType(), "Parameter type mismatch for '{$laravelParam->getName()}'");
-            $this->assertSame($laravelParam->isOptional(), $helperParam->isOptional(), "Parameter optionality mismatch for '{$laravelParam->getName()}'");
-
-            if ($laravelParam->isDefaultValueAvailable()) {
-                $this->assertTrue($helperParam->isDefaultValueAvailable(), "Default value availability mismatch for '{$laravelParam->getName()}'");
-                $this->assertEquals($laravelParam->getDefaultValue(), $helperParam->getDefaultValue(), "Default value mismatch for '{$laravelParam->getName()}'");
-            }
-        }
-
-        $this->assertEquals($reflectionLaravel->getReturnType(), $reflectionHelper->getReturnType(), 'Return type mismatch');
-    }
 }

From 68b584f623e4e7b6c66fddd32ca6b327ec6ddf68 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:52:53 +0100
Subject: [PATCH 3853/4023] Inline variable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 6537ce416e2..0e10509a001 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -28,10 +28,8 @@ public function __construct(array $publishableFilesMap)
     /** @return array<string, string> */
     public function getFileChoices(): array
     {
-        $mostCommonDirectoryNominator = $this->getBaseDirectory();
-
-        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $target, string $source) use ($mostCommonDirectoryNominator): array {
-            return [$source => $this->pathRelativeToDirectory($source, $mostCommonDirectoryNominator)];
+        return Arr::mapWithKeys($this->publishableFilesMap, /** @return array<string, string> */ function (string $target, string $source): array {
+            return [$source => $this->pathRelativeToDirectory($source, $this->getBaseDirectory())];
         });
     }
 

From 06aad10866583842a62ca32789817276d3f8f3cb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:56:52 +0100
Subject: [PATCH 3854/4023] Refactor to move up output

---
 .../src/Console/Commands/PublishViewsCommand.php     | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index b692dc592e2..47261aec0d3 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -42,6 +42,10 @@ public function handle(): int
 
         $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
 
+        if ($selected !== 'all') {
+            $this->infoComment(sprintf('Selected category [%s]', $selected));
+        }
+
         if (! in_array($selected, $allowed = array_merge(['all'], array_keys($this->options)), true)) {
             $this->error("Invalid selection: '$selected'");
             $this->infoComment('Allowed values are: ['.implode(', ', $allowed).']');
@@ -66,13 +70,7 @@ protected function promptForCategory(): string
 
         $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
 
-        $selection = $this->parseChoiceIntoKey($choice);
-
-        if ($selection) {
-            $this->infoComment(sprintf('Selected category [%s]', $selection));
-        }
-
-        return $selection;
+        return $this->parseChoiceIntoKey($choice);
     }
 
     protected function formatPublishableChoices(): array

From 80dbaec2d62867f162d45acf42983dbb984453c8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 19:57:11 +0100
Subject: [PATCH 3855/4023] Inline local variable

---
 .../framework/src/Console/Commands/PublishViewsCommand.php  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 47261aec0d3..1bd0036d441 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -68,9 +68,9 @@ protected function promptForCategory(): string
             return $this->choice($prompt->label, $prompt->options, $prompt->default);
         });
 
-        $choice = select('Which category do you want to publish?', $this->formatPublishableChoices(), 0);
-
-        return $this->parseChoiceIntoKey($choice);
+        return $this->parseChoiceIntoKey(
+            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0)
+        );
     }
 
     protected function formatPublishableChoices(): array

From ca972554bba3fc1098850977f0eef6421cf7b66b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 21:35:34 +0100
Subject: [PATCH 3856/4023] Tweak helper methods

---
 .../src/Console/Helpers/ConsoleHelper.php     | 26 +++++++++----------
 .../tests/Unit/ConsoleHelperTest.php          | 25 +++---------------
 2 files changed, 15 insertions(+), 36 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index c78c8602657..8a7c47f4550 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -4,10 +4,7 @@
 
 namespace Hyde\Console\Helpers;
 
-use Closure;
-use Illuminate\Support\Collection;
-
-use function Laravel\Prompts\multiselect;
+use Laravel\Prompts\Prompt;
 
 /**
  * @internal This class contains internal helpers for interacting with the console, and for easier testing.
@@ -16,24 +13,25 @@
  */
 class ConsoleHelper
 {
-    protected static array $mocks = [];
+    /** Allows for mocking the Windows OS check. Remember to clear the mock after the test. */
+    protected static ?bool $enableLaravelPrompts = null;
 
     public static function clearMocks(): void
     {
-        static::$mocks = [];
+        self::$enableLaravelPrompts = null;
     }
 
-    public static function usesWindowsOs()
+    public static function mockWindowsOs(bool $isWindowsOs): void
     {
-        if (isset(static::$mocks['usesWindowsOs'])) {
-            return static::$mocks['usesWindowsOs'];
-        }
-
-        return windows_os();
+        self::$enableLaravelPrompts = $isWindowsOs;
     }
 
-    public static function mockWindowsOs(bool $isWindows = true): void
+    public static function canUseLaravelPrompts(): bool
     {
-        static::$mocks['usesWindowsOs'] = $isWindows;
+        if (self::$enableLaravelPrompts !== null) {
+            return self::$enableLaravelPrompts;
+        }
+
+        return windows_os() === false && Prompt::shouldFallback() === false;
     }
 }
diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index 82960525c4e..6f0ada9f494 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -6,8 +6,6 @@
 
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Testing\UnitTestCase;
-use ReflectionFunction;
-use ReflectionMethod;
 
 /**
  * @covers \Hyde\Console\Helpers\ConsoleHelper
@@ -24,29 +22,12 @@ protected function tearDown(): void
         ConsoleHelper::clearMocks();
     }
 
-    public function testClearMocksClearsAllMocks()
+    public function testCanMockWindowsOs()
     {
-        // Set up some mocks
-        ConsoleHelper::mockWindowsOs(true);
-
-        // Clear mocks
-        ConsoleHelper::clearMocks();
-
-        // Assert mocks are cleared by checking default behavior is restored
-        $this->assertSame(windows_os(), ConsoleHelper::usesWindowsOs());
-    }
+        $this->assertTrue(ConsoleHelper::canUseLaravelPrompts());
 
-    public function testUsesWindowsOsReturnsSystemValueByDefault()
-    {
-        $this->assertSame(windows_os(), ConsoleHelper::usesWindowsOs());
-    }
-
-    public function testUsesWindowsOsReturnsMockedValue()
-    {
         ConsoleHelper::mockWindowsOs(true);
-        $this->assertTrue(ConsoleHelper::usesWindowsOs());
 
-        ConsoleHelper::mockWindowsOs(false);
-        $this->assertFalse(ConsoleHelper::usesWindowsOs());
+        $this->assertFalse(ConsoleHelper::canUseLaravelPrompts());
     }
 }

From 842c3d8e59b47d270f16e6ab7eb690388283972c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 21:42:50 +0100
Subject: [PATCH 3857/4023] Fix logic

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 8a7c47f4550..b2985c69dad 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -23,7 +23,7 @@ public static function clearMocks(): void
 
     public static function mockWindowsOs(bool $isWindowsOs): void
     {
-        self::$enableLaravelPrompts = $isWindowsOs;
+        self::$enableLaravelPrompts = ! $isWindowsOs;
     }
 
     public static function canUseLaravelPrompts(): bool

From 7023deadddfad5dced791ef429a876054857a768 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 21:42:57 +0100
Subject: [PATCH 3858/4023] Check the input

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index b2985c69dad..39cb08ec002 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -5,6 +5,7 @@
 namespace Hyde\Console\Helpers;
 
 use Laravel\Prompts\Prompt;
+use Symfony\Component\Console\Input\InputInterface;
 
 /**
  * @internal This class contains internal helpers for interacting with the console, and for easier testing.
@@ -26,12 +27,12 @@ public static function mockWindowsOs(bool $isWindowsOs): void
         self::$enableLaravelPrompts = ! $isWindowsOs;
     }
 
-    public static function canUseLaravelPrompts(): bool
+    public static function canUseLaravelPrompts(InputInterface $input): bool
     {
         if (self::$enableLaravelPrompts !== null) {
             return self::$enableLaravelPrompts;
         }
 
-        return windows_os() === false && Prompt::shouldFallback() === false;
+        return $input->isInteractive() && windows_os() === false && Prompt::shouldFallback() === false;
     }
 }

From d46660789cbdeb3611ae672cd76dabb5ccb2a226 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 21:43:03 +0100
Subject: [PATCH 3859/4023] Check using helper

---
 .../framework/src/Console/Commands/PublishViewsCommand.php     | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1bd0036d441..816ebebf5cb 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -6,6 +6,7 @@
 
 use Closure;
 use Hyde\Console\Concerns\Command;
+use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Console\Helpers\InteractivePublishCommandHelper;
 use Hyde\Console\Helpers\ViewPublishGroup;
 use Illuminate\Support\Str;
@@ -106,7 +107,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
     {
         $publisher = new InteractivePublishCommandHelper($files);
 
-        if (! $isPublishingAll && ! Prompt::shouldFallback()) {
+        if (! $isPublishingAll && ConsoleHelper::canUseLaravelPrompts($this->input)) {
             $publisher->only($this->promptUserForWhichFilesToPublish($publisher->getFileChoices()));
         }
 

From 1248247f5cd014b87e72cad39a66551724ef59ee Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Wed, 25 Dec 2024 21:44:41 +0100
Subject: [PATCH 3860/4023] Update the test

---
 .../framework/tests/Unit/ConsoleHelperTest.php    | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/packages/framework/tests/Unit/ConsoleHelperTest.php b/packages/framework/tests/Unit/ConsoleHelperTest.php
index 6f0ada9f494..ff3307e1088 100644
--- a/packages/framework/tests/Unit/ConsoleHelperTest.php
+++ b/packages/framework/tests/Unit/ConsoleHelperTest.php
@@ -6,17 +6,13 @@
 
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Testing\UnitTestCase;
+use Symfony\Component\Console\Input\InputInterface;
 
 /**
  * @covers \Hyde\Console\Helpers\ConsoleHelper
  */
 class ConsoleHelperTest extends UnitTestCase
 {
-    protected function setUp(): void
-    {
-        ConsoleHelper::clearMocks();
-    }
-
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();
@@ -24,10 +20,15 @@ protected function tearDown(): void
 
     public function testCanMockWindowsOs()
     {
-        $this->assertTrue(ConsoleHelper::canUseLaravelPrompts());
+        $input = $this->createMock(InputInterface::class);
+        $input->method('isInteractive')->willReturn(true);
+
+        ConsoleHelper::mockWindowsOs(false);
+
+        $this->assertTrue(ConsoleHelper::canUseLaravelPrompts($input));
 
         ConsoleHelper::mockWindowsOs(true);
 
-        $this->assertFalse(ConsoleHelper::canUseLaravelPrompts());
+        $this->assertFalse(ConsoleHelper::canUseLaravelPrompts($input));
     }
 }

From 7fee865e7b974e89d200eeb2f7cd3c8d6f284636 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 09:56:25 +0100
Subject: [PATCH 3861/4023] Remove annotation we don't need

---
 .../framework/src/Console/Commands/PublishViewsCommand.php   | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 816ebebf5cb..b70d4de9f17 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -99,10 +99,7 @@ protected static function mapToKeys(array $groups): array
         })->all();
     }
 
-    /**
-     * @param  array<string, string>  $files
-     * @param  bool  $isPublishingAll
-     */
+    /** @param  array<string, string>  $files */
     protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
     {
         $publisher = new InteractivePublishCommandHelper($files);

From 586068fc925506abb2699c1b90be97071b685d0e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 09:57:25 +0100
Subject: [PATCH 3862/4023] Handle output in main command body

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index b70d4de9f17..db80ef7d375 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -58,7 +58,9 @@ public function handle(): int
             ? collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all()
             : $this->options[$selected]->publishableFilesMap();
 
-        $this->publishSelectedFiles($files, $selected === 'all');
+        $output = $this->publishSelectedFiles($files, $selected === 'all');
+
+        $this->infoComment($output);
 
         return Command::SUCCESS;
     }
@@ -100,7 +102,7 @@ protected static function mapToKeys(array $groups): array
     }
 
     /** @param  array<string, string>  $files */
-    protected function publishSelectedFiles(array $files, bool $isPublishingAll): void
+    protected function publishSelectedFiles(array $files, bool $isPublishingAll): string
     {
         $publisher = new InteractivePublishCommandHelper($files);
 
@@ -110,7 +112,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): vo
 
         $publisher->publishFiles();
 
-        $this->infoComment($publisher->formatOutput());
+        return $publisher->formatOutput();
     }
 
     /**

From 970b4c3de0dcb0ff99f88a89ab56ab7bffbce92b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 09:58:09 +0100
Subject: [PATCH 3863/4023] Return publisher to handle all output in main
 command body

---
 .../src/Console/Commands/PublishViewsCommand.php          | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index db80ef7d375..1adbc470589 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -58,9 +58,9 @@ public function handle(): int
             ? collect($this->options)->flatMap(fn (ViewPublishGroup $option): array => $option->publishableFilesMap())->all()
             : $this->options[$selected]->publishableFilesMap();
 
-        $output = $this->publishSelectedFiles($files, $selected === 'all');
+        $publisher = $this->publishSelectedFiles($files, $selected === 'all');
 
-        $this->infoComment($output);
+        $this->infoComment($publisher->formatOutput());
 
         return Command::SUCCESS;
     }
@@ -102,7 +102,7 @@ protected static function mapToKeys(array $groups): array
     }
 
     /** @param  array<string, string>  $files */
-    protected function publishSelectedFiles(array $files, bool $isPublishingAll): string
+    protected function publishSelectedFiles(array $files, bool $isPublishingAll): InteractivePublishCommandHelper
     {
         $publisher = new InteractivePublishCommandHelper($files);
 
@@ -112,7 +112,7 @@ protected function publishSelectedFiles(array $files, bool $isPublishingAll): st
 
         $publisher->publishFiles();
 
-        return $publisher->formatOutput();
+        return $publisher;
     }
 
     /**

From 5570d91a8a22e8d2ad14180175c241c40ee70fa1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:08:43 +0100
Subject: [PATCH 3864/4023] Print the published group

---
 .../src/Console/Commands/PublishViewsCommand.php          | 2 +-
 .../Console/Helpers/InteractivePublishCommandHelper.php   | 8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1adbc470589..b5eebea41b7 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -60,7 +60,7 @@ public function handle(): int
 
         $publisher = $this->publishSelectedFiles($files, $selected === 'all');
 
-        $this->infoComment($publisher->formatOutput());
+        $this->infoComment($publisher->formatOutput($selected));
 
         return Command::SUCCESS;
     }
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 0e10509a001..b0169905f0b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -65,11 +65,15 @@ public function publishFiles(): void
         }
     }
 
-    public function formatOutput(): string
+    public function formatOutput(?string $group = null): string
     {
+        if ($group) {
+            $group = '['.Str::singular($group).']';
+        }
+
         return ($fileCount = count($this->publishableFilesMap)) === 1
             ? sprintf('Published file to [%s].', reset($this->publishableFilesMap))
-            : sprintf('Published %s files to [%s].', $this->getCountDescription($fileCount), $this->getBaseDirectory());
+            : sprintf('Published %s files to [%s].', $group ?? $this->getCountDescription($fileCount), $this->getBaseDirectory());
     }
 
     protected function getCountDescription(int $fileCount): string

From 31fcc3a33ce99e29cf2fd066b23716a9d74f0352 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:11:23 +0100
Subject: [PATCH 3865/4023] Check group is not all

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index b0169905f0b..4b78a85612a 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -67,7 +67,7 @@ public function publishFiles(): void
 
     public function formatOutput(?string $group = null): string
     {
-        if ($group) {
+        if ($group && $group !== 'all') {
             $group = '['.Str::singular($group).']';
         }
 

From c7f1eac9d4218437388464631fb25f5761f50481 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:12:32 +0100
Subject: [PATCH 3866/4023] Don't print selected when using argument

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index b5eebea41b7..eedcc652571 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -43,7 +43,7 @@ public function handle(): int
 
         $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
 
-        if ($selected !== 'all') {
+        if ($selected !== 'all' && (bool) $this->argument('category') === false) {
             $this->infoComment(sprintf('Selected category [%s]', $selected));
         }
 

From b829a8295335fa7641bebeee22f02d4b738352a1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:17:31 +0100
Subject: [PATCH 3867/4023] Instead of printing count, assume we did what the
 user wanted

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 4b78a85612a..d230d01a910 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -72,13 +72,13 @@ public function formatOutput(?string $group = null): string
         }
 
         return ($fileCount = count($this->publishableFilesMap)) === 1
-            ? sprintf('Published file to [%s].', reset($this->publishableFilesMap))
-            : sprintf('Published %s files to [%s].', $group ?? $this->getCountDescription($fileCount), $this->getBaseDirectory());
+            ? sprintf('Published selected file to [%s].', reset($this->publishableFilesMap))
+            : sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory());
     }
 
     protected function getCountDescription(int $fileCount): string
     {
-        return $fileCount === $this->originalFileCount ? 'all' : (string) $fileCount;
+        return $fileCount === $this->originalFileCount ? '' : (string) $fileCount;
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string

From 0ab7e8c0d1c0870219bf5065dd8fd4b9af6f55da Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:18:41 +0100
Subject: [PATCH 3868/4023] Null all group

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index d230d01a910..670b59776b3 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -67,7 +67,11 @@ public function publishFiles(): void
 
     public function formatOutput(?string $group = null): string
     {
-        if ($group && $group !== 'all') {
+        if ($group === 'all') {
+            $group = null;
+        }
+
+        if ($group) {
             $group = '['.Str::singular($group).']';
         }
 

From c2002df36b82932b53ccef6ad2d70c31a47359d6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:18:51 +0100
Subject: [PATCH 3869/4023] Remove unused variable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 670b59776b3..ad21aeb6c2b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -75,7 +75,7 @@ public function formatOutput(?string $group = null): string
             $group = '['.Str::singular($group).']';
         }
 
-        return ($fileCount = count($this->publishableFilesMap)) === 1
+        return (count($this->publishableFilesMap)) === 1
             ? sprintf('Published selected file to [%s].', reset($this->publishableFilesMap))
             : sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory());
     }

From 3c708b937e52e2269825f1cad454f14950114d9f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:18:58 +0100
Subject: [PATCH 3870/4023] Remove unused method

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php  | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ad21aeb6c2b..961e25c66ce 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -80,11 +80,6 @@ public function formatOutput(?string $group = null): string
             : sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory());
     }
 
-    protected function getCountDescription(int $fileCount): string
-    {
-        return $fileCount === $this->originalFileCount ? '' : (string) $fileCount;
-    }
-
     protected function pathRelativeToDirectory(string $source, string $directory): string
     {
         return Str::after($source, basename($directory).'/');

From 50c55ebfd5d5941ec6a9bbe88137699911ec4d67 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:21:01 +0100
Subject: [PATCH 3871/4023] Replace ternary return with match returns

---
 .../Helpers/InteractivePublishCommandHelper.php       | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 961e25c66ce..624c41bc546 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -75,9 +75,14 @@ public function formatOutput(?string $group = null): string
             $group = '['.Str::singular($group).']';
         }
 
-        return (count($this->publishableFilesMap)) === 1
-            ? sprintf('Published selected file to [%s].', reset($this->publishableFilesMap))
-            : sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory());
+        $publishedOneFile = (count($this->publishableFilesMap)) === 1;
+        $publishedAllGroups = $group === null;
+
+        return match (true) {
+            $publishedAllGroups => sprintf('Published all files to [%s].', $this->getBaseDirectory()),
+            $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
+            default => sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory())
+        };
     }
 
     protected function pathRelativeToDirectory(string $source, string $directory): string

From bc5fb308c0fcab126ab05833ec6e0ad6ea880ffa Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:22:14 +0100
Subject: [PATCH 3872/4023] Print the file count

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 624c41bc546..4eef144dcd3 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -78,8 +78,10 @@ public function formatOutput(?string $group = null): string
         $publishedOneFile = (count($this->publishableFilesMap)) === 1;
         $publishedAllGroups = $group === null;
 
+        $fileCount = count($this->publishableFilesMap);
+
         return match (true) {
-            $publishedAllGroups => sprintf('Published all files to [%s].', $this->getBaseDirectory()),
+            $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
             $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
             default => sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory())
         };

From 6bc60307fd07058857629cbe2bcbf9c2fb894eb3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:22:25 +0100
Subject: [PATCH 3873/4023] Add testing helper to disable prompts

---
 packages/framework/src/Console/Helpers/ConsoleHelper.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index 39cb08ec002..f0bbef57317 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -22,6 +22,11 @@ public static function clearMocks(): void
         self::$enableLaravelPrompts = null;
     }
 
+    public static function disableLaravelPrompts(): void
+    {
+        self::$enableLaravelPrompts = false;
+    }
+
     public static function mockWindowsOs(bool $isWindowsOs): void
     {
         self::$enableLaravelPrompts = ! $isWindowsOs;

From 78e73d78c1690010b8ceb9f2bac006c5da9df178 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:22:49 +0100
Subject: [PATCH 3874/4023] Move up variable declaration

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 4eef144dcd3..0bead84a5cc 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -75,11 +75,10 @@ public function formatOutput(?string $group = null): string
             $group = '['.Str::singular($group).']';
         }
 
+        $fileCount = count($this->publishableFilesMap);
         $publishedOneFile = (count($this->publishableFilesMap)) === 1;
         $publishedAllGroups = $group === null;
 
-        $fileCount = count($this->publishableFilesMap);
-
         return match (true) {
             $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
             $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),

From 19d6e36fe70ff477a3eeb8ac3b2f8272c0e9519d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:22:58 +0100
Subject: [PATCH 3875/4023] Use local variable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 0bead84a5cc..361465d9bc9 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -76,7 +76,7 @@ public function formatOutput(?string $group = null): string
         }
 
         $fileCount = count($this->publishableFilesMap);
-        $publishedOneFile = (count($this->publishableFilesMap)) === 1;
+        $publishedOneFile = $fileCount === 1;
         $publishedAllGroups = $group === null;
 
         return match (true) {

From 460bd1f06bb9637cebe7c31026335aeaee3c659e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:23:20 +0100
Subject: [PATCH 3876/4023] Invert local data flow

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 361465d9bc9..4a3c7f6a514 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -67,11 +67,11 @@ public function publishFiles(): void
 
     public function formatOutput(?string $group = null): string
     {
-        if ($group === 'all') {
-            $group = null;
+        if ($group === null) {
+            $group = 'all';
         }
 
-        if ($group) {
+        if ($group !== 'all') {
             $group = '['.Str::singular($group).']';
         }
 

From 413e777625c55cc3a57c08def0dbd1415a357a57 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:24:25 +0100
Subject: [PATCH 3877/4023] Remove null support as real code is never null

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 4a3c7f6a514..ee8c08da6f1 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -65,12 +65,8 @@ public function publishFiles(): void
         }
     }
 
-    public function formatOutput(?string $group = null): string
+    public function formatOutput(string $group): string
     {
-        if ($group === null) {
-            $group = 'all';
-        }
-
         if ($group !== 'all') {
             $group = '['.Str::singular($group).']';
         }

From 763662e6530afcfe1769a39c3416a50f3a84913f Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:27:21 +0100
Subject: [PATCH 3878/4023] Fix wrong comparison

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ee8c08da6f1..8ea6415d6ff 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -73,7 +73,7 @@ public function formatOutput(string $group): string
 
         $fileCount = count($this->publishableFilesMap);
         $publishedOneFile = $fileCount === 1;
-        $publishedAllGroups = $group === null;
+        $publishedAllGroups = $group === 'all';
 
         return match (true) {
             $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),

From 7bbdc49cb02076c0c9de14d8a5c8babc298bc642 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:28:21 +0100
Subject: [PATCH 3879/4023] Move down formatting

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 8ea6415d6ff..8a8388e5843 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -67,10 +67,6 @@ public function publishFiles(): void
 
     public function formatOutput(string $group): string
     {
-        if ($group !== 'all') {
-            $group = '['.Str::singular($group).']';
-        }
-
         $fileCount = count($this->publishableFilesMap);
         $publishedOneFile = $fileCount === 1;
         $publishedAllGroups = $group === 'all';
@@ -78,7 +74,7 @@ public function formatOutput(string $group): string
         return match (true) {
             $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
             $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
-            default => sprintf('Published selected %s files to [%s].', $group, $this->getBaseDirectory())
+            default => sprintf('Published selected [%s] files to [%s].', Str::singular($group), $this->getBaseDirectory())
         };
     }
 

From b6fc64cf6be8bfd21286d1c686eb3a664bf67b07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:33:16 +0100
Subject: [PATCH 3880/4023] Dynamic noun modifiers

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 8a8388e5843..ea54829217b 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -70,11 +70,12 @@ public function formatOutput(string $group): string
         $fileCount = count($this->publishableFilesMap);
         $publishedOneFile = $fileCount === 1;
         $publishedAllGroups = $group === 'all';
+        $publishedAllFiles = $fileCount === $this->originalFileCount;
 
         return match (true) {
             $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
             $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
-            default => sprintf('Published selected [%s] files to [%s].', Str::singular($group), $this->getBaseDirectory())
+            default => sprintf('Published %s [%s] files to [%s].', $publishedAllFiles ? 'all' : 'selected', Str::singular($group), $this->getBaseDirectory())
         };
     }
 

From 10c0fde1a824e70cf3d336b0ca5291795d53aec3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:35:13 +0100
Subject: [PATCH 3881/4023] Introduce local variable

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index ea54829217b..3ac7966f781 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -71,11 +71,12 @@ public function formatOutput(string $group): string
         $publishedOneFile = $fileCount === 1;
         $publishedAllGroups = $group === 'all';
         $publishedAllFiles = $fileCount === $this->originalFileCount;
+        $selectedFilesModifier = $publishedAllFiles ? 'all' : 'selected';
 
         return match (true) {
             $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
             $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
-            default => sprintf('Published %s [%s] files to [%s].', $publishedAllFiles ? 'all' : 'selected', Str::singular($group), $this->getBaseDirectory())
+            default => sprintf('Published %s [%s] files to [%s].', $selectedFilesModifier, Str::singular($group), $this->getBaseDirectory())
         };
     }
 

From def449a87e77e0a607bc386663b9ea3feb61b8e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 10:37:58 +0100
Subject: [PATCH 3882/4023] Fix formatting

---
 .../framework/src/Console/Commands/PublishViewsCommand.php    | 1 -
 .../src/Console/Helpers/InteractivePublishCommandHelper.php   | 2 +-
 .../tests/Unit/InteractivePublishCommandHelperTest.php        | 4 ++--
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index eedcc652571..1d570766946 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -12,7 +12,6 @@
 use Illuminate\Support\Str;
 use Laravel\Prompts\Key;
 use Laravel\Prompts\MultiSelectPrompt;
-use Laravel\Prompts\Prompt;
 use Laravel\Prompts\SelectPrompt;
 
 use function Laravel\Prompts\select;
diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 3ac7966f781..5dd56522071 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -18,7 +18,7 @@ class InteractivePublishCommandHelper
 
     protected readonly int $originalFileCount;
 
-    /** @param array<string, string> $publishableFilesMap */
+    /** @param  array<string, string>  $publishableFilesMap */
     public function __construct(array $publishableFilesMap)
     {
         $this->publishableFilesMap = $publishableFilesMap;
diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index f4acf9860f9..5903aa3239f 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -57,7 +57,7 @@ public function testOnlyFiltersPublishableFiles(): void
 
         $helper->only([
             'packages/framework/resources/views/layouts/app.blade.php',
-            'packages/framework/resources/views/layouts/post.blade.php'
+            'packages/framework/resources/views/layouts/post.blade.php',
         ]);
 
         $this->assertSame([
@@ -131,7 +131,7 @@ public function testFormatOutputForSingleChosenFile(): void
         ]);
 
         $helper->only([
-            'packages/framework/resources/views/layouts/app.blade.php'
+            'packages/framework/resources/views/layouts/app.blade.php',
         ]);
 
         $this->assertSame(

From ea2dc6873ff909ff12da677e58cc851b135b549a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 12:24:02 +0100
Subject: [PATCH 3883/4023] Test covers helper

---
 .../framework/tests/Feature/Commands/PublishViewsCommandTest.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 7b7afb95c1b..08367c78a9c 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -11,6 +11,7 @@
 
 /**
  * @covers \Hyde\Console\Commands\PublishViewsCommand
+ * @covers \Hyde\Console\Helpers\InteractivePublishCommandHelper
  *
  * @see \Hyde\Framework\Testing\Unit\InteractivePublishCommandHelperTest
  */

From eda8e34b206056aae8088787ab91b63a94ae053e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 12:25:09 +0100
Subject: [PATCH 3884/4023] Remove periods

---
 .../src/Console/Helpers/InteractivePublishCommandHelper.php | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
index 5dd56522071..faf33bb20a7 100644
--- a/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
+++ b/packages/framework/src/Console/Helpers/InteractivePublishCommandHelper.php
@@ -74,9 +74,9 @@ public function formatOutput(string $group): string
         $selectedFilesModifier = $publishedAllFiles ? 'all' : 'selected';
 
         return match (true) {
-            $publishedAllGroups => sprintf('Published all %d files to [%s].', $fileCount, $this->getBaseDirectory()),
-            $publishedOneFile => sprintf('Published selected file to [%s].', reset($this->publishableFilesMap)),
-            default => sprintf('Published %s [%s] files to [%s].', $selectedFilesModifier, Str::singular($group), $this->getBaseDirectory())
+            $publishedAllGroups => sprintf('Published all %d files to [%s]', $fileCount, $this->getBaseDirectory()),
+            $publishedOneFile => sprintf('Published selected file to [%s]', reset($this->publishableFilesMap)),
+            default => sprintf('Published %s [%s] files to [%s]', $selectedFilesModifier, Str::singular($group), $this->getBaseDirectory())
         };
     }
 

From ef11340e3bfaa3026b58a7479b31a8aa65b783db Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 12:36:06 +0100
Subject: [PATCH 3885/4023] Reimplement the test for base usages

---
 .../Commands/PublishViewsCommandTest.php      | 82 ++++++++-----------
 1 file changed, 36 insertions(+), 46 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 08367c78a9c..f5038f6c298 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Feature\Commands;
 
 use Hyde\Console\Helpers\ConsoleHelper;
+use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
 use Illuminate\Support\Facades\File;
@@ -19,76 +20,65 @@ class PublishViewsCommandTest extends TestCase
 {
     public function testCommandPublishesViews()
     {
-        $path = str_replace('\\', '/', Hyde::pathToRelative(realpath(Hyde::vendorPath('resources/views/pages/404.blade.php'))));
+        $count = Filesystem::findFiles('vendor/hyde/framework/resources/views/components', '.blade.php', true)->count()
+            + Filesystem::findFiles('vendor/hyde/framework/resources/views/layouts', '.blade.php', true)->count();
+
         $this->artisan('publish:views')
             ->expectsQuestion('Which category do you want to publish?', 'all')
-            ->expectsOutputToContain("Copying file [$path] to [_pages/404.blade.php]")
+            ->doesntExpectOutputToContain('Selected category')
+            ->expectsOutput("Published all $count files to [resources/views/vendor/hyde]")
             ->assertExitCode(0);
 
+        // Assert all groups were published
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde'));
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde/layouts'));
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde/components'));
+
+        // Assert files were published
         $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
 
-        if (is_dir(Hyde::path('resources/views/vendor/hyde'))) {
-            File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
-        }
+        // Assert subdirectories were published with files
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde/components/docs'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/components/docs/documentation-article.blade.php'));
     }
 
-    public function testCanSelectView()
+    public function testCanSelectGroupWithArgument()
     {
-        $path = str_replace('\\', '/', Hyde::pathToRelative(realpath(Hyde::vendorPath('resources/views/pages/404.blade.php'))));
-        $this->artisan('publish:views page-404')
-            ->expectsOutputToContain("Copying file [$path] to [_pages/404.blade.php]")
+        $this->artisan('publish:views layouts --no-interaction')
+            ->expectsOutput("Published all [layout] files to [resources/views/vendor/hyde/layouts]")
             ->assertExitCode(0);
 
-        $this->assertFileExists(Hyde::path('_pages/404.blade.php'));
+        // Assert selected group was published
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde'));
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde/layouts'));
 
-        if (is_dir(Hyde::path('resources/views/vendor/hyde'))) {
-            File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
-        }
+        // Assert files were published
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php'));
+
+        // Assert not selected group was not published
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
     }
 
     public function testWithInvalidSuppliedTag()
     {
         $this->artisan('publish:views invalid')
-            ->expectsOutputToContain('No publishable resources for tag [invalid].')
-            ->assertExitCode(0);
-    }
-
-    public function testInteractiveSelectionOnUnixSystems()
-    {
-        ConsoleHelper::mockWindowsOs(false);
-
-        ConsoleHelper::mockMultiselect(['resources/views/vendor/hyde/components/article-excerpt.blade.php'], function (string $label, array $options) {
-            $this->assertSame('Select the files you want to publish (CTRL+A to toggle all)', $label);
-            $this->assertContainsOnly('string', array_keys($options));
-            $this->assertContainsOnly('string', array_values($options));
-            $this->assertContains('resources/views/vendor/hyde/components/article-excerpt.blade.php', array_keys($options));
-            $this->assertContains('article-excerpt.blade.php', array_values($options));
-        });
-
-        $this->artisan('publish:views components --interactive')
-            ->expectsOutput('Published file [article-excerpt.blade.php]')
-            ->assertExitCode(0);
-
-        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
-
-        File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
-    }
-
-    public function testInteractiveSelectionOnWindowsSystems()
-    {
-        ConsoleHelper::mockWindowsOs();
-
-        $this->artisan('publish:views components --interactive')
-            ->expectsOutput('Due to limitations in the Windows version of PHP, it is not currently possible to use interactive mode on Windows outside of WSL.')
+            ->expectsOutput("Invalid selection: 'invalid'")
+            ->expectsOutput('Allowed values are: [all, layouts, components]')
             ->assertExitCode(1);
-
-        File::deleteDirectory(Hyde::path('resources/views/vendor/hyde'));
     }
 
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();
 
+        if (File::isDirectory(Hyde::path('resources/views/vendor'))) {
+            File::deleteDirectory(Hyde::path('resources/views/vendor'));
+        }
+
         parent::tearDown();
     }
 }

From 3a9591c34fd72771480daf40e61be8da69bd7df0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:06:20 +0100
Subject: [PATCH 3886/4023] Test with interactive output

---
 .../Commands/PublishViewsCommandTest.php      | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index f5038f6c298..c17eca7d828 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -4,11 +4,17 @@
 
 namespace Hyde\Framework\Testing\Feature\Commands;
 
+use Hyde\Console\Commands\PublishViewsCommand;
 use Hyde\Console\Helpers\ConsoleHelper;
 use Hyde\Facades\Filesystem;
 use Hyde\Hyde;
 use Hyde\Testing\TestCase;
+use Illuminate\Console\OutputStyle;
 use Illuminate\Support\Facades\File;
+use Laravel\Prompts\Key;
+use Laravel\Prompts\Prompt;
+use Symfony\Component\Console\Input\ArrayInput;
+use Symfony\Component\Console\Output\BufferedOutput;
 
 /**
  * @covers \Hyde\Console\Commands\PublishViewsCommand
@@ -71,6 +77,51 @@ public function testWithInvalidSuppliedTag()
             ->assertExitCode(1);
     }
 
+    public function testInteractiveSelectionOnWindowsSystemsSkipsInteractiveness()
+    {
+        ConsoleHelper::mockWindowsOs(true);
+
+        $this->artisan('publish:views components')
+            ->expectsOutput("Published all [component] files to [resources/views/vendor/hyde/components]")
+            ->assertExitCode(0);
+    }
+
+    public function testInteractiveSelectionOnUnixSystems()
+    {
+        $this->withoutMockingConsoleOutput();
+
+        ConsoleHelper::mockWindowsOs(false);
+
+        Prompt::fake([
+            Key::DOWN, Key::SPACE,
+            Key::DOWN, Key::SPACE,
+            Key::DOWN, Key::SPACE,
+            Key::ENTER,
+        ]);
+
+        $command = (new PublishViewsCommand());
+        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
+        $output = new BufferedOutput();
+        $command->setInput($input);
+        $command->setOutput(new OutputStyle($input, $output));
+        $command->handle();
+
+        Prompt::assertOutputContains('Select the files you want to publish');
+        Prompt::assertOutputContains('All files');
+        Prompt::assertOutputContains('app.blade.php');
+        Prompt::assertOutputContains('docs.blade.php');
+        Prompt::assertOutputContains('footer.blade.php');
+
+        $this->assertSame("Published selected [layout] files to [resources/views/vendor/hyde/layouts]\n", $output->fetch());
+
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/docs.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/footer.blade.php'));
+
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+    }
+
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();

From 0a8e97deb77b5e42a374bdfa92c9a8ab3e444054 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:34:12 +0100
Subject: [PATCH 3887/4023] Add hacky workaround for
 https://github.com/laravel/prompts/issues/158

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index c17eca7d828..bd6401f4df8 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -125,6 +125,7 @@ public function testInteractiveSelectionOnUnixSystems()
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();
+        PromptsReset::resetFallbacks();
 
         if (File::isDirectory(Hyde::path('resources/views/vendor'))) {
             File::deleteDirectory(Hyde::path('resources/views/vendor'));
@@ -133,3 +134,12 @@ protected function tearDown(): void
         parent::tearDown();
     }
 }
+
+abstract class PromptsReset extends Prompt
+{
+    // Workaround for https://github.com/laravel/prompts/issues/158
+    public static function resetFallbacks(): void
+    {
+        static::$shouldFallback = false;
+    }
+}

From a527e302a745e3940dfff82e532f7a249f135bbb Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Thu, 26 Dec 2024 15:35:05 +0000
Subject: [PATCH 3888/4023] Apply fixes from StyleCI

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index bd6401f4df8..0bf83e69099 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -53,7 +53,7 @@ public function testCommandPublishesViews()
     public function testCanSelectGroupWithArgument()
     {
         $this->artisan('publish:views layouts --no-interaction')
-            ->expectsOutput("Published all [layout] files to [resources/views/vendor/hyde/layouts]")
+            ->expectsOutput('Published all [layout] files to [resources/views/vendor/hyde/layouts]')
             ->assertExitCode(0);
 
         // Assert selected group was published
@@ -82,7 +82,7 @@ public function testInteractiveSelectionOnWindowsSystemsSkipsInteractiveness()
         ConsoleHelper::mockWindowsOs(true);
 
         $this->artisan('publish:views components')
-            ->expectsOutput("Published all [component] files to [resources/views/vendor/hyde/components]")
+            ->expectsOutput('Published all [component] files to [resources/views/vendor/hyde/components]')
             ->assertExitCode(0);
     }
 

From 4236205ab192e6fbed5d1aebfb164a659dc3845b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:40:37 +0100
Subject: [PATCH 3889/4023] Update tests for added parameter

---
 .../Unit/InteractivePublishCommandHelperTest.php | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 5903aa3239f..167f2bc4773 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -104,8 +104,8 @@ public function testFormatOutputForSingleFile(): void
         ]);
 
         $this->assertSame(
-            'Published file to [resources/views/vendor/hyde/layouts/app.blade.php].',
-            $helper->formatOutput()
+            'Published selected file to [resources/views/vendor/hyde/layouts/app.blade.php]',
+            $helper->formatOutput('layouts')
         );
     }
 
@@ -117,8 +117,8 @@ public function testFormatOutputForMultipleFiles(): void
         ]);
 
         $this->assertSame(
-            'Published all files to [resources/views/vendor/hyde/layouts].',
-            $helper->formatOutput()
+            'Published all 2 files to [resources/views/vendor/hyde/layouts]',
+            $helper->formatOutput('all')
         );
     }
 
@@ -135,8 +135,8 @@ public function testFormatOutputForSingleChosenFile(): void
         ]);
 
         $this->assertSame(
-            'Published file to [resources/views/vendor/hyde/layouts/app.blade.php].',
-            $helper->formatOutput()
+            'Published selected file to [resources/views/vendor/hyde/layouts/app.blade.php]',
+            $helper->formatOutput('layouts')
         );
     }
 
@@ -154,8 +154,8 @@ public function testFormatOutputForMultipleChosenFiles(): void
         ]);
 
         $this->assertSame(
-            'Published 2 files to [resources/views/vendor/hyde/layouts].',
-            $helper->formatOutput()
+            'Published selected [layout] files to [resources/views/vendor/hyde/layouts]',
+            $helper->formatOutput('layouts')
         );
     }
 

From 3abd5bc7805f1bfe3a703e73e0624e0a177ed665 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:34:46 +0100
Subject: [PATCH 3890/4023] Remove code coverage ignore

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1d570766946..a532b24a83e 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -129,7 +129,6 @@ protected function promptUserForWhichFilesToPublish(array $files): array
         return $prompt->prompt();
     }
 
-    /** @codeCoverageIgnore We can't easily test Laravel Prompts. */
     protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
     {
         return function ($key) use ($prompt): void {

From bbea834c7fe273c5ee94cb02e2c82f562bfe890d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:50:58 +0100
Subject: [PATCH 3891/4023] Set mock through container

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php       | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 167f2bc4773..2366d87784c 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -8,7 +8,6 @@
 use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
 use Illuminate\Filesystem\Filesystem;
-use Illuminate\Support\Facades\File;
 use Mockery;
 
 /**
@@ -23,13 +22,13 @@ class InteractivePublishCommandHelperTest extends UnitTestCase
     protected function setUp(): void
     {
         $this->filesystem = $this->mockFilesystemStrict();
-        File::swap($this->filesystem);
+        app()->instance(Filesystem::class, $this->filesystem);
     }
 
     protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
-        File::swap(null);
+        app()->forgetInstance(Filesystem::class);
     }
 
     public function testGetFileChoices(): void

From 24bf9ea3a78d31b840ad1a49b0d8d6ac115adb08 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 16:51:02 +0100
Subject: [PATCH 3892/4023] Cleanup formatting

---
 .../tests/Unit/InteractivePublishCommandHelperTest.php          | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
index 2366d87784c..8b669e08e94 100644
--- a/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
+++ b/packages/framework/tests/Unit/InteractivePublishCommandHelperTest.php
@@ -22,12 +22,14 @@ class InteractivePublishCommandHelperTest extends UnitTestCase
     protected function setUp(): void
     {
         $this->filesystem = $this->mockFilesystemStrict();
+
         app()->instance(Filesystem::class, $this->filesystem);
     }
 
     protected function tearDown(): void
     {
         $this->verifyMockeryExpectations();
+
         app()->forgetInstance(Filesystem::class);
     }
 

From c0683c3ee907403074186d4afcce267050e11bc8 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:38:40 +0100
Subject: [PATCH 3893/4023] Test all interactive selection paths

---
 .../Commands/PublishViewsCommandTest.php      | 75 +++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 0bf83e69099..027288988b6 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -122,6 +122,81 @@ public function testInteractiveSelectionOnUnixSystems()
         $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
     }
 
+    public function testInteractiveSelectionWithHittingEnterRightAway()
+    {
+        $this->withoutMockingConsoleOutput();
+
+        ConsoleHelper::mockWindowsOs(false);
+
+        Prompt::fake([
+            Key::ENTER,
+        ]);
+
+        $command = (new PublishViewsCommand());
+        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
+        $output = new BufferedOutput();
+        $command->setInput($input);
+        $command->setOutput(new OutputStyle($input, $output));
+        $command->handle();
+
+        Prompt::assertOutputContains('Select the files you want to publish');
+        Prompt::assertOutputContains('All files');
+        Prompt::assertOutputContains('app.blade.php');
+        Prompt::assertOutputContains('docs.blade.php');
+
+        $this->assertSame("Published all [layout] files to [resources/views/vendor/hyde/layouts]\n", $output->fetch());
+
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/docs.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/footer.blade.php'));
+
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+    }
+
+    public function testInteractiveSelectionWithComplexToggles()
+    {
+        $this->withoutMockingConsoleOutput();
+
+        ConsoleHelper::mockWindowsOs(false);
+
+        Prompt::fake([
+            // Select "all files"
+            Key::SPACE,
+            // Unselect next file
+            Key::DOWN, Key::SPACE,
+            // Go back up and deselect the all files option
+            Key::UP, Key::SPACE,
+            // Select the next three files
+            Key::DOWN, Key::SPACE, Key::DOWN, Key::SPACE, Key::DOWN, Key::SPACE,
+            // De-select the last file
+            Key::SPACE,
+            // Confirm selection
+            Key::ENTER,
+        ]);
+
+        $command = (new PublishViewsCommand());
+        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
+        $output = new BufferedOutput();
+        $command->setInput($input);
+        $command->setOutput(new OutputStyle($input, $output));
+        $command->handle();
+
+        Prompt::assertOutputContains('Select the files you want to publish');
+        Prompt::assertOutputContains('All files');
+        Prompt::assertOutputContains('app.blade.php');
+        Prompt::assertOutputContains('docs.blade.php');
+
+        $this->assertSame("Published selected [layout] files to [resources/views/vendor/hyde/layouts]\n", $output->fetch());
+
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/docs.blade.php'));
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/layouts/footer.blade.php'));
+
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+    }
+
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();

From ba6d1b65283cfba3ce0aa9388029e74f1ed9da3b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:40:13 +0100
Subject: [PATCH 3894/4023] Extract helper method and cleanup code

---
 .../Commands/PublishViewsCommandTest.php      | 39 +++++++------------
 1 file changed, 15 insertions(+), 24 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 027288988b6..41dc4b49fb6 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -88,8 +88,6 @@ public function testInteractiveSelectionOnWindowsSystemsSkipsInteractiveness()
 
     public function testInteractiveSelectionOnUnixSystems()
     {
-        $this->withoutMockingConsoleOutput();
-
         ConsoleHelper::mockWindowsOs(false);
 
         Prompt::fake([
@@ -99,12 +97,7 @@ public function testInteractiveSelectionOnUnixSystems()
             Key::ENTER,
         ]);
 
-        $command = (new PublishViewsCommand());
-        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
-        $output = new BufferedOutput();
-        $command->setInput($input);
-        $command->setOutput(new OutputStyle($input, $output));
-        $command->handle();
+        $output = $this->executePublishViewsCommand();
 
         Prompt::assertOutputContains('Select the files you want to publish');
         Prompt::assertOutputContains('All files');
@@ -124,20 +117,13 @@ public function testInteractiveSelectionOnUnixSystems()
 
     public function testInteractiveSelectionWithHittingEnterRightAway()
     {
-        $this->withoutMockingConsoleOutput();
-
         ConsoleHelper::mockWindowsOs(false);
 
         Prompt::fake([
             Key::ENTER,
         ]);
 
-        $command = (new PublishViewsCommand());
-        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
-        $output = new BufferedOutput();
-        $command->setInput($input);
-        $command->setOutput(new OutputStyle($input, $output));
-        $command->handle();
+        $output = $this->executePublishViewsCommand();
 
         Prompt::assertOutputContains('Select the files you want to publish');
         Prompt::assertOutputContains('All files');
@@ -156,8 +142,6 @@ public function testInteractiveSelectionWithHittingEnterRightAway()
 
     public function testInteractiveSelectionWithComplexToggles()
     {
-        $this->withoutMockingConsoleOutput();
-
         ConsoleHelper::mockWindowsOs(false);
 
         Prompt::fake([
@@ -175,12 +159,7 @@ public function testInteractiveSelectionWithComplexToggles()
             Key::ENTER,
         ]);
 
-        $command = (new PublishViewsCommand());
-        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
-        $output = new BufferedOutput();
-        $command->setInput($input);
-        $command->setOutput(new OutputStyle($input, $output));
-        $command->handle();
+        $output = $this->executePublishViewsCommand();
 
         Prompt::assertOutputContains('Select the files you want to publish');
         Prompt::assertOutputContains('All files');
@@ -197,6 +176,18 @@ public function testInteractiveSelectionWithComplexToggles()
         $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
     }
 
+    protected function executePublishViewsCommand(): BufferedOutput
+    {
+        $command = (new PublishViewsCommand());
+        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
+        $output = new BufferedOutput();
+        $command->setInput($input);
+        $command->setOutput(new OutputStyle($input, $output));
+        $command->handle();
+
+        return $output;
+    }
+
     protected function tearDown(): void
     {
         ConsoleHelper::clearMocks();

From e9fbb80ae2befcd3cc36251a2015a0c9e0e60826 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:41:06 +0100
Subject: [PATCH 3895/4023] Use more explicit disabler

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 41dc4b49fb6..52d71baa305 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -52,7 +52,9 @@ public function testCommandPublishesViews()
 
     public function testCanSelectGroupWithArgument()
     {
-        $this->artisan('publish:views layouts --no-interaction')
+        ConsoleHelper::disableLaravelPrompts();
+
+        $this->artisan('publish:views layouts')
             ->expectsOutput('Published all [layout] files to [resources/views/vendor/hyde/layouts]')
             ->assertExitCode(0);
 

From 826779a3d0f37277415b83a605866485c0f35815 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:45:39 +0100
Subject: [PATCH 3896/4023] Test with the group question

---
 .../Commands/PublishViewsCommandTest.php      | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 52d71baa305..709e6e4f96d 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -71,6 +71,29 @@ public function testCanSelectGroupWithArgument()
         $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
     }
 
+    public function testCanSelectGroupWithQuestion()
+    {
+        ConsoleHelper::disableLaravelPrompts();
+
+        $this->artisan('publish:views')
+            ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
+            ->expectsOutput('Selected category [layouts]')
+            ->expectsOutput('Published all [layout] files to [resources/views/vendor/hyde/layouts]')
+            ->assertExitCode(0);
+
+        // Assert selected group was published
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde'));
+        $this->assertDirectoryExists(Hyde::path('resources/views/vendor/hyde/layouts'));
+
+        // Assert files were published
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php'));
+
+        // Assert not selected group was not published
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+    }
+
     public function testWithInvalidSuppliedTag()
     {
         $this->artisan('publish:views invalid')

From e47239a0d7c570413218b70e41b81af29bbf302a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:46:20 +0100
Subject: [PATCH 3897/4023] Change comment text

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index a532b24a83e..2098f1c7337 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -139,7 +139,7 @@ protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
                     $prompt->emit('key', Key::CTRL_A);
 
                     if ($isToggled) {
-                        // Laravel Prompts is crazy, but this apparently is how you deselect all items
+                        // We need to emit CTRL+A twice to deselect all for some reason
                         $prompt->emit('key', Key::CTRL_A);
                         $isToggled = false;
                     } else {

From 101d398ee25edc163c3a403098b449c474886ece Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 18:52:36 +0100
Subject: [PATCH 3898/4023] Create ViewPublishGroupTest.php

---
 .../Console/Helpers/ViewPublishGroupTest.php  | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
new file mode 100644
index 00000000000..39dd9e6e615
--- /dev/null
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit\Console\Helpers;
+
+use Hyde\Testing\UnitTestCase;
+use Hyde\Console\Helpers\ViewPublishGroup;
+
+/**
+ * @covers \Hyde\Console\Helpers\ViewPublishGroup
+ */
+class ViewPublishGroupTest extends UnitTestCase
+{
+    protected static bool $needsKernel = true;
+    protected static bool $needsConfig = true;
+
+    protected function setUp(): void
+    {
+        //
+    }
+}

From d5d36af49330911ad8f4c28ccb7c9dc966932677 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:24:00 +0100
Subject: [PATCH 3899/4023] Call method on static provider

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index a01e33bd843..2447a48463f 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -7,7 +7,6 @@
 use Hyde\Facades\Filesystem;
 use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Hyde;
-use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Str;
 
 use function Hyde\path_join;
@@ -45,7 +44,7 @@ protected function __construct(string $group, string $source, string $target, ar
 
     public static function fromGroup(string $group, ?string $name = null, ?string $description = null): self
     {
-        [$source, $target] = static::keyedArrayToTuple(ServiceProvider::pathsToPublish(static::$provider, $group));
+        [$source, $target] = static::keyedArrayToTuple(static::$provider::pathsToPublish(static::$provider, $group));
         [$source, $target] = [static::normalizePath($source), static::normalizePath($target)];
 
         $files = self::findFiles($source);

From d8192c7786dcd87caa5ab8fc3265050ede8a301a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:24:07 +0100
Subject: [PATCH 3900/4023] Use static instead of self

---
 .../framework/src/Console/Helpers/ConsoleHelper.php    | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ConsoleHelper.php b/packages/framework/src/Console/Helpers/ConsoleHelper.php
index f0bbef57317..f59a8a09ab3 100644
--- a/packages/framework/src/Console/Helpers/ConsoleHelper.php
+++ b/packages/framework/src/Console/Helpers/ConsoleHelper.php
@@ -19,23 +19,23 @@ class ConsoleHelper
 
     public static function clearMocks(): void
     {
-        self::$enableLaravelPrompts = null;
+        static::$enableLaravelPrompts = null;
     }
 
     public static function disableLaravelPrompts(): void
     {
-        self::$enableLaravelPrompts = false;
+        static::$enableLaravelPrompts = false;
     }
 
     public static function mockWindowsOs(bool $isWindowsOs): void
     {
-        self::$enableLaravelPrompts = ! $isWindowsOs;
+        static::$enableLaravelPrompts = ! $isWindowsOs;
     }
 
     public static function canUseLaravelPrompts(InputInterface $input): bool
     {
-        if (self::$enableLaravelPrompts !== null) {
-            return self::$enableLaravelPrompts;
+        if (static::$enableLaravelPrompts !== null) {
+            return static::$enableLaravelPrompts;
         }
 
         return $input->isInteractive() && windows_os() === false && Prompt::shouldFallback() === false;

From dfca5592a87fc967540e58fad107dddd1b40dc5c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:27:52 +0100
Subject: [PATCH 3901/4023] Create setup for mocking the provider

---
 .../Console/Helpers/ViewPublishGroupTest.php  | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 39dd9e6e615..55d80f81b54 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Testing\Unit\Console\Helpers;
 
+use Hyde\Foundation\Providers\ViewServiceProvider;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Console\Helpers\ViewPublishGroup;
 
@@ -17,6 +18,24 @@ class ViewPublishGroupTest extends UnitTestCase
 
     protected function setUp(): void
     {
-        //
+        TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
+    }
+
+    protected function tearDown(): void
+    {
+        TestViewPublishGroup::setProvider(ViewServiceProvider::class);
+    }
+}
+
+class TestViewServiceProvider extends ViewServiceProvider
+{
+    //
+}
+
+class TestViewPublishGroup extends ViewPublishGroup
+{
+    public static function setProvider(string $provider): void
+    {
+        parent::$provider = $provider;
     }
 }

From ad57a2e335c650f95777ef52712c6db876e3c542 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:31:03 +0100
Subject: [PATCH 3902/4023] Mock paths to publish based on real output

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 55d80f81b54..bf0df311983 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -29,7 +29,12 @@ protected function tearDown(): void
 
 class TestViewServiceProvider extends ViewServiceProvider
 {
-    //
+    public static function pathsToPublish($provider = null, $group = null): array
+    {
+        return [
+            Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
+        ];
+    }
 }
 
 class TestViewPublishGroup extends ViewPublishGroup

From 2a8540fdbb82808bad9aab235d3e69f7bc22103d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:33:45 +0100
Subject: [PATCH 3903/4023] Reorder helper classes

---
 .../Console/Helpers/ViewPublishGroupTest.php     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index bf0df311983..d2c9676fb46 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -27,20 +27,20 @@ protected function tearDown(): void
     }
 }
 
-class TestViewServiceProvider extends ViewServiceProvider
+class TestViewPublishGroup extends ViewPublishGroup
 {
-    public static function pathsToPublish($provider = null, $group = null): array
+    public static function setProvider(string $provider): void
     {
-        return [
-            Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
-        ];
+        parent::$provider = $provider;
     }
 }
 
-class TestViewPublishGroup extends ViewPublishGroup
+class TestViewServiceProvider extends ViewServiceProvider
 {
-    public static function setProvider(string $provider): void
+    public static function pathsToPublish($provider = null, $group = null): array
     {
-        parent::$provider = $provider;
+        return [
+            Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
+        ];
     }
 }

From ebe07f8b7d56399a4aeaec96b360037ac9edf113 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:36:44 +0100
Subject: [PATCH 3904/4023] Assert from helper class

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index d2c9676fb46..c4b675bfef9 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -16,9 +16,13 @@ class ViewPublishGroupTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    public static self $test;
+
     protected function setUp(): void
     {
         TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
+
+        self::$test = $this;
     }
 
     protected function tearDown(): void
@@ -39,6 +43,9 @@ class TestViewServiceProvider extends ViewServiceProvider
 {
     public static function pathsToPublish($provider = null, $group = null): array
     {
+        ViewPublishGroupTest::$test->assertSame($provider, TestViewServiceProvider::class);
+        ViewPublishGroupTest::$test->assertSame($group, 'layouts');
+
         return [
             Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
         ];

From 4a7229ae9dd062fae97939d5222812ce26b5decc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:37:05 +0100
Subject: [PATCH 3905/4023] Simplify test passer

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php    | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index c4b675bfef9..ad7ab7424e6 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -16,13 +16,9 @@ class ViewPublishGroupTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
-    public static self $test;
-
     protected function setUp(): void
     {
         TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
-
-        self::$test = $this;
     }
 
     protected function tearDown(): void
@@ -44,7 +40,8 @@ class TestViewServiceProvider extends ViewServiceProvider
     public static function pathsToPublish($provider = null, $group = null): array
     {
         ViewPublishGroupTest::$test->assertSame($provider, TestViewServiceProvider::class);
-        ViewPublishGroupTest::$test->assertSame($group, 'layouts');
+        ViewPublishGroupTest::assertSame($provider, TestViewServiceProvider::class);
+        ViewPublishGroupTest::assertSame($group, 'layouts');
 
         return [
             Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),

From f346f16e66a848eb8b1bfaa69c2002e8586cbf6b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:39:28 +0100
Subject: [PATCH 3906/4023] Cleanup

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php          | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index ad7ab7424e6..78853197cfc 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -39,7 +39,6 @@ class TestViewServiceProvider extends ViewServiceProvider
 {
     public static function pathsToPublish($provider = null, $group = null): array
     {
-        ViewPublishGroupTest::$test->assertSame($provider, TestViewServiceProvider::class);
         ViewPublishGroupTest::assertSame($provider, TestViewServiceProvider::class);
         ViewPublishGroupTest::assertSame($group, 'layouts');
 

From c272bbffa3d05af1d5af395c176e9cbaf0479d92 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:40:18 +0100
Subject: [PATCH 3907/4023] Import class

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 78853197cfc..ec2c9fd81ce 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -5,6 +5,7 @@
 namespace Hyde\Framework\Testing\Unit\Console\Helpers;
 
 use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Console\Helpers\ViewPublishGroup;
 

From 50100015cc2e5a09a33d1be3811737686eff915b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:40:25 +0100
Subject: [PATCH 3908/4023] Draft initial test

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index ec2c9fd81ce..ec81bedf12d 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -26,6 +26,13 @@ protected function tearDown(): void
     {
         TestViewPublishGroup::setProvider(ViewServiceProvider::class);
     }
+
+    public function testCanCreateGroup()
+    {
+        $group = ViewPublishGroup::fromGroup('layouts');
+
+        $this->assertInstanceOf(ViewPublishGroup::class, $group);
+    }
 }
 
 class TestViewPublishGroup extends ViewPublishGroup

From 3855c868558f80cf1697a9ac836d00f19c452cd6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:40:43 +0100
Subject: [PATCH 3909/4023] Mock file finder

---
 .../Console/Helpers/ViewPublishGroupTest.php  | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index ec81bedf12d..c3f215f22ca 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -5,9 +5,11 @@
 namespace Hyde\Framework\Testing\Unit\Console\Helpers;
 
 use Hyde\Foundation\Providers\ViewServiceProvider;
+use Hyde\Framework\Actions\Internal\FileFinder;
 use Hyde\Hyde;
 use Hyde\Testing\UnitTestCase;
 use Hyde\Console\Helpers\ViewPublishGroup;
+use Illuminate\Support\Collection;
 
 /**
  * @covers \Hyde\Console\Helpers\ViewPublishGroup
@@ -20,11 +22,15 @@ class ViewPublishGroupTest extends UnitTestCase
     protected function setUp(): void
     {
         TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
+
+        app()->singleton(FileFinder::class, TestFileFinder::class);
     }
 
     protected function tearDown(): void
     {
         TestViewPublishGroup::setProvider(ViewServiceProvider::class);
+
+        app()->forgetInstance(FileFinder::class);
     }
 
     public function testCanCreateGroup()
@@ -55,3 +61,19 @@ public static function pathsToPublish($provider = null, $group = null): array
         ];
     }
 }
+
+class TestFileFinder extends FileFinder
+{
+    public static function handle(string $directory, array|string|false $matchExtensions = false, bool $recursive = false): Collection
+    {
+        ViewPublishGroupTest::assertSame($directory, 'packages/framework/resources/views/layouts');
+        ViewPublishGroupTest::assertSame($matchExtensions, false);
+        ViewPublishGroupTest::assertSame($recursive, true);    
+
+        return collect([
+            "packages/framework/resources/views/layouts/app.blade.php",
+            "packages/framework/resources/views/layouts/page.blade.php",
+            "packages/framework/resources/views/layouts/post.blade.php",
+        ]);
+    }
+}

From 0afe4abb3b7f84d5bf576c379a258c53dda96d01 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:45:38 +0100
Subject: [PATCH 3910/4023] Assert all properties

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php    | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index c3f215f22ca..caa68f7cb33 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -38,6 +38,13 @@ public function testCanCreateGroup()
         $group = ViewPublishGroup::fromGroup('layouts');
 
         $this->assertInstanceOf(ViewPublishGroup::class, $group);
+
+        $this->assertSame($group->group, 'layouts');
+        $this->assertSame($group->name, 'Layouts');
+        $this->assertSame($group->description, "Publish the 'layouts' files for customization.");
+        $this->assertSame($group->source, 'packages/framework/resources/views/layouts');
+        $this->assertSame($group->target, 'resources/views/vendor/hyde/layouts');
+        $this->assertSame($group->files, ["app.blade.php", "page.blade.php", "post.blade.php"]);
     }
 }
 

From adf92fc015955d6bafb565bb54caa8df44e132c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:46:58 +0100
Subject: [PATCH 3911/4023] Test custom names and descriptions

---
 .../Console/Helpers/ViewPublishGroupTest.php  | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index caa68f7cb33..5414b258748 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -46,6 +46,30 @@ public function testCanCreateGroup()
         $this->assertSame($group->target, 'resources/views/vendor/hyde/layouts');
         $this->assertSame($group->files, ["app.blade.php", "page.blade.php", "post.blade.php"]);
     }
+
+    public function testCanCreateGroupWithCustomName()
+    {
+        $group = ViewPublishGroup::fromGroup('layouts', 'Custom Layouts');
+
+        $this->assertSame($group->name, 'Custom Layouts');
+        $this->assertSame($group->description, "Publish the 'layouts' files for customization.");
+    }
+
+    public function testCanCreateGroupWithCustomDescription()
+    {
+        $group = ViewPublishGroup::fromGroup('layouts', null, 'Custom description');
+
+        $this->assertSame($group->name, 'Layouts');
+        $this->assertSame($group->description, 'Custom description');
+    }
+
+    public function testCanCreateGroupWithCustomNameAndDescription()
+    {
+        $group = ViewPublishGroup::fromGroup('layouts', 'Custom Layouts', 'Custom description');
+
+        $this->assertSame($group->name, 'Custom Layouts');
+        $this->assertSame($group->description, 'Custom description');
+    }
 }
 
 class TestViewPublishGroup extends ViewPublishGroup

From 49eee7e27a6c7698dd8e172a207215a98ebf26c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:47:27 +0100
Subject: [PATCH 3912/4023] Use static instead of self

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 2447a48463f..98ed15970d2 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -42,12 +42,12 @@ protected function __construct(string $group, string $source, string $target, ar
         $this->description = $description ?? "Publish the '$group' files for customization.";
     }
 
-    public static function fromGroup(string $group, ?string $name = null, ?string $description = null): self
+    public static function fromGroup(string $group, ?string $name = null, ?string $description = null): static
     {
         [$source, $target] = static::keyedArrayToTuple(static::$provider::pathsToPublish(static::$provider, $group));
         [$source, $target] = [static::normalizePath($source), static::normalizePath($target)];
 
-        $files = self::findFiles($source);
+        $files = static::findFiles($source);
 
         return new static($group, $source, $target, $files, $name, $description);
     }

From b701c32b80a6b15bbf13af8d10b3194302a96db0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:47:46 +0100
Subject: [PATCH 3913/4023] Clean up formatting

---
 .../framework/src/Console/Helpers/ViewPublishGroup.php |  6 +-----
 .../Unit/Console/Helpers/ViewPublishGroupTest.php      | 10 +++++-----
 2 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 98ed15970d2..7b3a197dda5 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -52,11 +52,7 @@ public static function fromGroup(string $group, ?string $name = null, ?string $d
         return new static($group, $source, $target, $files, $name, $description);
     }
 
-    /**
-     * Get the map of all publishable file paths.
-     *
-     * @return array<string, string> The source file paths mapped to their target file paths.
-     */
+    /** @return array<string, string> The source file paths mapped to their target file paths. */
     public function publishableFilesMap(): array
     {
         return collect($this->files)->mapWithKeys(fn (string $file): array => [
diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 5414b258748..1ad971a257c 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -44,7 +44,7 @@ public function testCanCreateGroup()
         $this->assertSame($group->description, "Publish the 'layouts' files for customization.");
         $this->assertSame($group->source, 'packages/framework/resources/views/layouts');
         $this->assertSame($group->target, 'resources/views/vendor/hyde/layouts');
-        $this->assertSame($group->files, ["app.blade.php", "page.blade.php", "post.blade.php"]);
+        $this->assertSame($group->files, ['app.blade.php', 'page.blade.php', 'post.blade.php']);
     }
 
     public function testCanCreateGroupWithCustomName()
@@ -99,12 +99,12 @@ public static function handle(string $directory, array|string|false $matchExtens
     {
         ViewPublishGroupTest::assertSame($directory, 'packages/framework/resources/views/layouts');
         ViewPublishGroupTest::assertSame($matchExtensions, false);
-        ViewPublishGroupTest::assertSame($recursive, true);    
+        ViewPublishGroupTest::assertSame($recursive, true);
 
         return collect([
-            "packages/framework/resources/views/layouts/app.blade.php",
-            "packages/framework/resources/views/layouts/page.blade.php",
-            "packages/framework/resources/views/layouts/post.blade.php",
+            'packages/framework/resources/views/layouts/app.blade.php',
+            'packages/framework/resources/views/layouts/page.blade.php',
+            'packages/framework/resources/views/layouts/post.blade.php',
         ]);
     }
 }

From 7199591f912bf72150ccf50bb35fae28f8a6607d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:55:51 +0100
Subject: [PATCH 3914/4023] Fix paths needing to be dynamic for monorepo

---
 .../Console/Helpers/ViewPublishGroupTest.php  | 21 +++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 1ad971a257c..c20c03af4ed 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -19,6 +19,15 @@ class ViewPublishGroupTest extends UnitTestCase
     protected static bool $needsKernel = true;
     protected static bool $needsConfig = true;
 
+    public static string $packageDirectory;
+
+    public static function setUpBeforeClass(): void
+    {
+        parent::setUpBeforeClass();
+
+        self::$packageDirectory = is_dir(Hyde::path('packages')) ? 'packages' : 'vendor/hyde';
+    }
+
     protected function setUp(): void
     {
         TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
@@ -42,7 +51,7 @@ public function testCanCreateGroup()
         $this->assertSame($group->group, 'layouts');
         $this->assertSame($group->name, 'Layouts');
         $this->assertSame($group->description, "Publish the 'layouts' files for customization.");
-        $this->assertSame($group->source, 'packages/framework/resources/views/layouts');
+        $this->assertSame($group->source, ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts');
         $this->assertSame($group->target, 'resources/views/vendor/hyde/layouts');
         $this->assertSame($group->files, ['app.blade.php', 'page.blade.php', 'post.blade.php']);
     }
@@ -88,7 +97,7 @@ public static function pathsToPublish($provider = null, $group = null): array
         ViewPublishGroupTest::assertSame($group, 'layouts');
 
         return [
-            Hyde::vendorPath('src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
+            Hyde::path(ViewPublishGroupTest::$packageDirectory.'/framework/src/Foundation/Providers/../../../resources/views/layouts') => Hyde::path('resources/views/vendor/hyde/layouts'),
         ];
     }
 }
@@ -97,14 +106,14 @@ class TestFileFinder extends FileFinder
 {
     public static function handle(string $directory, array|string|false $matchExtensions = false, bool $recursive = false): Collection
     {
-        ViewPublishGroupTest::assertSame($directory, 'packages/framework/resources/views/layouts');
+        ViewPublishGroupTest::assertSame($directory, ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts');
         ViewPublishGroupTest::assertSame($matchExtensions, false);
         ViewPublishGroupTest::assertSame($recursive, true);
 
         return collect([
-            'packages/framework/resources/views/layouts/app.blade.php',
-            'packages/framework/resources/views/layouts/page.blade.php',
-            'packages/framework/resources/views/layouts/post.blade.php',
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/app.blade.php',
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/page.blade.php',
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/post.blade.php',
         ]);
     }
 }

From 93ff4eb2b312dee2d0bc14bdc752db15d2017f49 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:56:50 +0100
Subject: [PATCH 3915/4023] Test we can get the publishable files map

---
 .../Unit/Console/Helpers/ViewPublishGroupTest.php     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index c20c03af4ed..fe0866fd72c 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -79,6 +79,17 @@ public function testCanCreateGroupWithCustomNameAndDescription()
         $this->assertSame($group->name, 'Custom Layouts');
         $this->assertSame($group->description, 'Custom description');
     }
+
+    public function testCanGetPublishableFilesMap()
+    {
+        $group = ViewPublishGroup::fromGroup('layouts');
+
+        $this->assertSame($group->publishableFilesMap(), [
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/app.blade.php' => 'resources/views/vendor/hyde/layouts/app.blade.php',
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/page.blade.php' => 'resources/views/vendor/hyde/layouts/page.blade.php',
+            ViewPublishGroupTest::$packageDirectory.'/framework/resources/views/layouts/post.blade.php' => 'resources/views/vendor/hyde/layouts/post.blade.php',
+        ]);
+    }
 }
 
 class TestViewPublishGroup extends ViewPublishGroup

From 9936d17eb1ca18e56f9799208f3913c58b13fc60 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 19:58:59 +0100
Subject: [PATCH 3916/4023] Test does not need config

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php          | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index fe0866fd72c..3ae71eb7cc4 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -17,7 +17,6 @@
 class ViewPublishGroupTest extends UnitTestCase
 {
     protected static bool $needsKernel = true;
-    protected static bool $needsConfig = true;
 
     public static string $packageDirectory;
 

From b9b038b628f2583590ab1b52c7a82d1d10d9a45a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Thu, 26 Dec 2024 20:01:38 +0100
Subject: [PATCH 3917/4023] Should not be singleton

---
 .../tests/Unit/Console/Helpers/ViewPublishGroupTest.php       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
index 3ae71eb7cc4..fb7942d0fbd 100644
--- a/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
+++ b/packages/framework/tests/Unit/Console/Helpers/ViewPublishGroupTest.php
@@ -31,14 +31,14 @@ protected function setUp(): void
     {
         TestViewPublishGroup::setProvider(TestViewServiceProvider::class);
 
-        app()->singleton(FileFinder::class, TestFileFinder::class);
+        app()->bind(FileFinder::class, TestFileFinder::class);
     }
 
     protected function tearDown(): void
     {
         TestViewPublishGroup::setProvider(ViewServiceProvider::class);
 
-        app()->forgetInstance(FileFinder::class);
+        app()->bind(FileFinder::class, FileFinder::class);
     }
 
     public function testCanCreateGroup()

From 88d0ea4cb15055fea8cecc4fecfd0e2bdff9ff2d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 28 Dec 2024 18:02:23 +0100
Subject: [PATCH 3918/4023] Run more tests on the 2.x branch

---
 .github/workflows/matrix-tests.yml    | 2 +-
 .github/workflows/static-analysis.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/matrix-tests.yml b/.github/workflows/matrix-tests.yml
index ff1f7cdaf14..481bedf5e20 100644
--- a/.github/workflows/matrix-tests.yml
+++ b/.github/workflows/matrix-tests.yml
@@ -2,7 +2,7 @@ name: Matrix Tests
 
 on:
   pull_request:
-    branches: [ "master" ]
+    branches: [ "master", "2.x-dev" ]
     paths:
       - 'app/**'
       - 'packages/**'
diff --git a/.github/workflows/static-analysis.yml b/.github/workflows/static-analysis.yml
index 91eaf200989..096406ad18d 100644
--- a/.github/workflows/static-analysis.yml
+++ b/.github/workflows/static-analysis.yml
@@ -2,7 +2,7 @@ name: 🔎 Static Analysis
 
 on:
   pull_request:
-    branches: [ "master" ]
+    branches: [ "master", "2.x-dev" ]
 
 jobs:
 

From b9df42b1a949aa9cb36d38b2a8a6b59f9ae4e9e1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 28 Dec 2024 20:41:03 +0100
Subject: [PATCH 3919/4023] Apparently faked prompts can't run on Windows

---
 .../Feature/Commands/PublishViewsCommandTest.php     | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index 709e6e4f96d..bb44614d6cc 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -113,7 +113,9 @@ public function testInteractiveSelectionOnWindowsSystemsSkipsInteractiveness()
 
     public function testInteractiveSelectionOnUnixSystems()
     {
-        ConsoleHelper::mockWindowsOs(false);
+        if (windows_os()) {
+            $this->markTestSkipped('Test is not applicable on Windows systems.');
+        }
 
         Prompt::fake([
             Key::DOWN, Key::SPACE,
@@ -142,7 +144,9 @@ public function testInteractiveSelectionOnUnixSystems()
 
     public function testInteractiveSelectionWithHittingEnterRightAway()
     {
-        ConsoleHelper::mockWindowsOs(false);
+        if (windows_os()) {
+            $this->markTestSkipped('Test is not applicable on Windows systems.');
+        }
 
         Prompt::fake([
             Key::ENTER,
@@ -167,7 +171,9 @@ public function testInteractiveSelectionWithHittingEnterRightAway()
 
     public function testInteractiveSelectionWithComplexToggles()
     {
-        ConsoleHelper::mockWindowsOs(false);
+        if (windows_os()) {
+            $this->markTestSkipped('Test is not applicable on Windows systems.');
+        }
 
         Prompt::fake([
             // Select "all files"

From fc972d5baaf276a33032513ceb3247cf4357d0d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 28 Dec 2024 21:24:37 +0100
Subject: [PATCH 3920/4023] Annotate array types

---
 packages/framework/src/Console/Helpers/ViewPublishGroup.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/framework/src/Console/Helpers/ViewPublishGroup.php b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
index 7b3a197dda5..43d381d7916 100644
--- a/packages/framework/src/Console/Helpers/ViewPublishGroup.php
+++ b/packages/framework/src/Console/Helpers/ViewPublishGroup.php
@@ -60,6 +60,10 @@ public function publishableFilesMap(): array
         ])->all();
     }
 
+    /**
+     * @param  array<string, string>  $array
+     * @return list<string>
+     */
     protected static function keyedArrayToTuple(array $array): array
     {
         return [key($array), current($array)];

From 2650e64e24b41085d5a2ed75ee3079bf11a729c9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 28 Dec 2024 21:26:18 +0100
Subject: [PATCH 3921/4023] Add missing closure type

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 2098f1c7337..c210d09c7fa 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -131,7 +131,7 @@ protected function promptUserForWhichFilesToPublish(array $files): array
 
     protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure
     {
-        return function ($key) use ($prompt): void {
+        return function (string $key) use ($prompt): void {
             static $isToggled = false;
 
             if ($prompt->isHighlighted('all')) {

From a07d1edf2ece9eaf6b785b003f1c39ce723b5879 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 28 Dec 2024 21:27:00 +0100
Subject: [PATCH 3922/4023] Add array cast

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index c210d09c7fa..1bb14b827ac 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -126,7 +126,7 @@ protected function promptUserForWhichFilesToPublish(array $files): array
 
         $prompt->on('key', static::supportTogglingAll($prompt));
 
-        return $prompt->prompt();
+        return (array) $prompt->prompt();
     }
 
     protected static function supportTogglingAll(MultiSelectPrompt $prompt): Closure

From 724362bb7a97573562cd7ec92823bf7897f86b8b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 17:38:12 +0100
Subject: [PATCH 3923/4023] Fix default for non-interactive mode

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1bb14b827ac..415c6e9e58a 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -71,7 +71,7 @@ protected function promptForCategory(): string
         });
 
         return $this->parseChoiceIntoKey(
-            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0)
+            select('Which category do you want to publish?', $this->formatPublishableChoices(), 'all')
         );
     }
 

From e91f0506e10ee92f51e7f222c6c89fe8597f2be3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 19:38:18 +0100
Subject: [PATCH 3924/4023] Revert "Fix default for non-interactive mode"

This reverts commit 724362bb7a97573562cd7ec92823bf7897f86b8b.
---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 415c6e9e58a..1bb14b827ac 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -71,7 +71,7 @@ protected function promptForCategory(): string
         });
 
         return $this->parseChoiceIntoKey(
-            select('Which category do you want to publish?', $this->formatPublishableChoices(), 'all')
+            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0)
         );
     }
 

From c74b8ba1c913c4e9f24ef0f232d856cdc73cbb6a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 19:39:21 +0100
Subject: [PATCH 3925/4023] Fall back naught value to all

---
 packages/framework/src/Console/Commands/PublishViewsCommand.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 1bb14b827ac..725889dd4f5 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -71,7 +71,7 @@ protected function promptForCategory(): string
         });
 
         return $this->parseChoiceIntoKey(
-            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0)
+            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0) ?: 'all'
         );
     }
 

From ba2c0b6fd7792c5deb6ac5f7f00495e57b5c1f84 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 19:41:44 +0100
Subject: [PATCH 3926/4023] Don't show feedback when prompts are not used

---
 .../Console/Commands/PublishViewsCommand.php  |  2 +-
 .../Commands/PublishViewsCommandTest.php      | 21 ++++++++++++++++++-
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index 725889dd4f5..c66aadecc84 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -42,7 +42,7 @@ public function handle(): int
 
         $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
 
-        if ($selected !== 'all' && (bool) $this->argument('category') === false) {
+        if ($selected !== 'all' && (bool) $this->argument('category') === false && ConsoleHelper::canUseLaravelPrompts($this->input)) {
             $this->infoComment(sprintf('Selected category [%s]', $selected));
         }
 
diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index bb44614d6cc..a57133db3bb 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -77,7 +77,6 @@ public function testCanSelectGroupWithQuestion()
 
         $this->artisan('publish:views')
             ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
-            ->expectsOutput('Selected category [layouts]')
             ->expectsOutput('Published all [layout] files to [resources/views/vendor/hyde/layouts]')
             ->assertExitCode(0);
 
@@ -207,6 +206,26 @@ public function testInteractiveSelectionWithComplexToggles()
         $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
     }
 
+    public function testCanSelectGroupWithQuestionAndPrompts()
+    {
+        if (windows_os()) {
+            $this->markTestSkipped('Test is not applicable on Windows systems.');
+        }
+
+        $this->artisan('publish:views')
+            ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
+            ->expectsOutput('Selected category [layouts]')
+            ->expectsQuestion('Select the files you want to publish', (is_dir(Hyde::path('packages')) ? 'packages' : 'vendor/hyde').'/framework/resources/views/layouts/app.blade.php')
+            ->expectsOutput('Published selected file to [resources/views/vendor/hyde/layouts/app.blade.php]')
+            ->assertExitCode(0);
+
+        $this->assertFileExists(Hyde::path('resources/views/vendor/hyde/layouts/app.blade.php'));
+
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/layouts/page.blade.php'));
+        $this->assertDirectoryDoesNotExist(Hyde::path('resources/views/vendor/hyde/components'));
+        $this->assertFileDoesNotExist(Hyde::path('resources/views/vendor/hyde/components/article-excerpt.blade.php'));
+    }
+
     protected function executePublishViewsCommand(): BufferedOutput
     {
         $command = (new PublishViewsCommand());

From 09c668e73ea4ab9c1920b7ab856d931742a4e571 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 19:44:43 +0100
Subject: [PATCH 3927/4023] Update customization.md

---
 docs/digging-deeper/customization.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/digging-deeper/customization.md b/docs/digging-deeper/customization.md
index 95965376d78..6bdaafe30ac 100644
--- a/docs/digging-deeper/customization.md
+++ b/docs/digging-deeper/customization.md
@@ -370,6 +370,8 @@ php hyde publish:views
 
 The files will then be available in the `resources/views/vendor/hyde` directory.
 
+>info **Tip:** If you use Linux/macOS or Windows with WSL you will be able to interactively select individual files to publish.
+
 ## Frontend Styles
 
 Hyde is designed to not only serve as a framework but a whole starter kit and comes with a Tailwind starter template

From 68aec1eb85e8fdbc916484299f1cd0dee9d53d85 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 29 Dec 2024 19:45:56 +0100
Subject: [PATCH 3928/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 2e7dc862e12..7ad10418a8b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -36,6 +36,7 @@ This serves two purposes:
 - Added a Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
 - Added Vite facade in https://github.com/hydephp/develop/pull/2016
 - Added a custom Blade-based heading renderer for Markdown conversions in https://github.com/hydephp/develop/pull/2047
+- The `publish:views` command is now interactive for Unix-like systems in https://github.com/hydephp/develop/pull/2062
 
 ### Changed
 

From b117a542f8867408d1738ddf89d1044ec42f48d0 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 20 Apr 2025 15:08:26 +0000
Subject: [PATCH 3929/4023] Apply fixes from StyleCI

---
 packages/framework/src/Facades/Features.php                     | 2 +-
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 packages/framework/src/Markdown/Processing/HeadingRenderer.php  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index e78ecc290f6..4a9a6383eee 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -150,7 +150,7 @@ public function toArray(): array
     }
 
     /** @internal This method is not covered by the backward compatibility promise. */
-    public static function mock(string $feature, bool $enabled = null): void
+    public static function mock(string $feature, ?bool $enabled = null): void
     {
         if ($enabled === true) {
             // Add the feature if it doesn't already exist.
diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index f3b363238c9..20c10e1639a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -36,7 +36,7 @@ public static function hasNumericalPrefix(string $identifier): bool
     /**
      * Splits a numbered identifier into its numerical prefix and the rest of the identifier.
      *
-     * @return array{integer, string}
+     * @return array{int, string}
      */
     public static function splitNumericPrefix(string $identifier): array
     {
diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 74045871666..d4eedced24f 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,7 +27,7 @@ class HeadingRenderer implements NodeRendererInterface
     protected array $headingRegistry = [];
 
     /** @param ?class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
-    public function __construct(string $pageClass = null, array &$headingRegistry = [])
+    public function __construct(?string $pageClass = null, array &$headingRegistry = [])
     {
         $this->pageClass = $pageClass;
         $this->headingRegistry = &$headingRegistry;

From 0f8931edf0ccd13b632e5a4ec4f46ee2a665834c Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 20 Apr 2025 15:02:23 +0000
Subject: [PATCH 3930/4023] Apply fixes from StyleCI

---
 packages/framework/src/Facades/Features.php                     | 2 +-
 .../Features/Navigation/NumericalPageOrderingHelper.php         | 2 +-
 packages/framework/src/Markdown/Processing/HeadingRenderer.php  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/framework/src/Facades/Features.php b/packages/framework/src/Facades/Features.php
index e78ecc290f6..4a9a6383eee 100644
--- a/packages/framework/src/Facades/Features.php
+++ b/packages/framework/src/Facades/Features.php
@@ -150,7 +150,7 @@ public function toArray(): array
     }
 
     /** @internal This method is not covered by the backward compatibility promise. */
-    public static function mock(string $feature, bool $enabled = null): void
+    public static function mock(string $feature, ?bool $enabled = null): void
     {
         if ($enabled === true) {
             // Add the feature if it doesn't already exist.
diff --git a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
index f3b363238c9..20c10e1639a 100644
--- a/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
+++ b/packages/framework/src/Framework/Features/Navigation/NumericalPageOrderingHelper.php
@@ -36,7 +36,7 @@ public static function hasNumericalPrefix(string $identifier): bool
     /**
      * Splits a numbered identifier into its numerical prefix and the rest of the identifier.
      *
-     * @return array{integer, string}
+     * @return array{int, string}
      */
     public static function splitNumericPrefix(string $identifier): array
     {
diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 74045871666..d4eedced24f 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -27,7 +27,7 @@ class HeadingRenderer implements NodeRendererInterface
     protected array $headingRegistry = [];
 
     /** @param ?class-string<\Hyde\Pages\Concerns\HydePage> $pageClass */
-    public function __construct(string $pageClass = null, array &$headingRegistry = [])
+    public function __construct(?string $pageClass = null, array &$headingRegistry = [])
     {
         $this->pageClass = $pageClass;
         $this->headingRegistry = &$headingRegistry;

From fe90e552b53d7abb2b479488e64bf0dcf2ee1af7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:38:01 +0100
Subject: [PATCH 3931/4023] Minimum PHP version is now 8.2

---
 composer.json                    | 2 +-
 packages/framework/composer.json | 2 +-
 packages/hyde/composer.json      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/composer.json b/composer.json
index 833c7a7ff33..29da0920051 100644
--- a/composer.json
+++ b/composer.json
@@ -15,7 +15,7 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.2",
         "hyde/framework": "*",
         "hyde/publications": "*",
         "hyde/ui-kit": "*",
diff --git a/packages/framework/composer.json b/packages/framework/composer.json
index f716759c2d4..5d42c472662 100644
--- a/packages/framework/composer.json
+++ b/packages/framework/composer.json
@@ -22,7 +22,7 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.2",
         "illuminate/support": "^10.0",
         "illuminate/view": "^10.0",
         "symfony/yaml": "^6.0",
diff --git a/packages/hyde/composer.json b/packages/hyde/composer.json
index eec3ec1c0dc..992899ff74f 100644
--- a/packages/hyde/composer.json
+++ b/packages/hyde/composer.json
@@ -24,7 +24,7 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.2",
         "hyde/framework": "^1.7",
         "laravel-zero/framework": "^10.0"
     },

From 244de050392c6b1253da39eb308920bc7042794b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:38:18 +0100
Subject: [PATCH 3932/4023] Update Laravel Zero Framework version to 11

---
 composer.json                    | 2 +-
 packages/framework/composer.json | 2 +-
 packages/hyde/composer.json      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/composer.json b/composer.json
index 29da0920051..cd5ee11ca54 100644
--- a/composer.json
+++ b/composer.json
@@ -19,7 +19,7 @@
         "hyde/framework": "*",
         "hyde/publications": "*",
         "hyde/ui-kit": "*",
-        "laravel-zero/framework": "^10.0"
+        "laravel-zero/framework": "^11.0"
     },
     "require-dev": {
         "desilva/psalm-coverage": "dev-master",
diff --git a/packages/framework/composer.json b/packages/framework/composer.json
index 5d42c472662..ad5d753af6c 100644
--- a/packages/framework/composer.json
+++ b/packages/framework/composer.json
@@ -33,6 +33,6 @@
     "suggest": {
         "hyde/hyde" : "The Framework package contains the Hyde Core. To create your site you should use the Hyde/Hyde project.",
         "ext-simplexml": "Required to generate sitemaps and RSS feeds.",
-        "laravel-zero/framework": "^10.0"
+        "laravel-zero/framework": "^11.0"
     }
 }
diff --git a/packages/hyde/composer.json b/packages/hyde/composer.json
index 992899ff74f..fbd094f8d07 100644
--- a/packages/hyde/composer.json
+++ b/packages/hyde/composer.json
@@ -26,7 +26,7 @@
     "require": {
         "php": "^8.2",
         "hyde/framework": "^1.7",
-        "laravel-zero/framework": "^10.0"
+        "laravel-zero/framework": "^11.0"
     },
     "require-dev": {
         "hyde/realtime-compiler": "^3.6"

From 31e2d033e6888911218465c529f4a08854dcdaf5 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:39:50 +0100
Subject: [PATCH 3933/4023] Update Symfony Yaml to 7.0

---
 packages/framework/composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/composer.json b/packages/framework/composer.json
index ad5d753af6c..777150ce195 100644
--- a/packages/framework/composer.json
+++ b/packages/framework/composer.json
@@ -25,7 +25,7 @@
         "php": "^8.2",
         "illuminate/support": "^10.0",
         "illuminate/view": "^10.0",
-        "symfony/yaml": "^6.0",
+        "symfony/yaml": "^7.0",
         "league/commonmark": "^2.2",
         "spatie/yaml-front-matter": "^2.0.9",
         "torchlight/torchlight-commonmark": "^0.5.5"

From 67e84db3a9a41baaf72a18491d21111f6606eb97 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:40:02 +0100
Subject: [PATCH 3934/4023] Update Illuminate packages to 11

---
 packages/framework/composer.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/framework/composer.json b/packages/framework/composer.json
index 777150ce195..82e7552e250 100644
--- a/packages/framework/composer.json
+++ b/packages/framework/composer.json
@@ -23,8 +23,8 @@
     ],
     "require": {
         "php": "^8.2",
-        "illuminate/support": "^10.0",
-        "illuminate/view": "^10.0",
+        "illuminate/support": "^11.0",
+        "illuminate/view": "^11.0",
         "symfony/yaml": "^7.0",
         "league/commonmark": "^2.2",
         "spatie/yaml-front-matter": "^2.0.9",

From 27c1e737ff35aec64c5f93622a695e416b15150a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:41:10 +0100
Subject: [PATCH 3935/4023] Update documentation for Laravel 11

---
 docs/getting-started/quickstart.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
index b8606e0999f..e124350ac8b 100644
--- a/docs/getting-started/quickstart.md
+++ b/docs/getting-started/quickstart.md
@@ -16,7 +16,7 @@ composer create-project hyde/hyde
 
 ### Requirements
 
-Hyde is based on [Laravel 10](https://laravel.com/docs/10.x/releases)
+Hyde is based on [Laravel 11](https://laravel.com/docs/11.x/releases)
 which requires a minimum PHP version of 8.1.
 You should also have [Composer](https://getcomposer.org/) installed.
 

From e8f0249b0db170d85e9ec7acaef310ecd5782667 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:41:19 +0100
Subject: [PATCH 3936/4023] Update documentation for PHP 8.2

---
 docs/getting-started/quickstart.md | 2 +-
 docs/index.md                      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
index e124350ac8b..85d25d046e0 100644
--- a/docs/getting-started/quickstart.md
+++ b/docs/getting-started/quickstart.md
@@ -17,7 +17,7 @@ composer create-project hyde/hyde
 ### Requirements
 
 Hyde is based on [Laravel 11](https://laravel.com/docs/11.x/releases)
-which requires a minimum PHP version of 8.1.
+which requires a minimum PHP version of 8.2.
 You should also have [Composer](https://getcomposer.org/) installed.
 
 To use some features like [compiling your own assets](managing-assets)
diff --git a/docs/index.md b/docs/index.md
index 86636842179..d233d29f399 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -34,7 +34,7 @@ virtually no configuration out of the box as it favours convention over configur
 
 HydePHP is a command-line interface (CLI) application that is installed on a per-project basis.
 
-To use HydePHP, your system must have PHP version 8.1 or later installed, along with Composer, and access to a terminal.
+To use HydePHP, your system must have PHP version 8.2 or later installed, along with Composer, and access to a terminal.
 
 The recommended method of installation is using Composer.
 

From 0e66a993daf67d28f4a42b8526a7b4515996de2c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:47:55 +0100
Subject: [PATCH 3937/4023] Update release notes for Laravel 11 upgrade

---
 RELEASE_NOTES.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 7ad10418a8b..37aed8698c5 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -49,6 +49,10 @@ This serves two purposes:
 - **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
 - **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
 - **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in https://github.com/hydephp/develop/pull/1980
+- Dependency: Upgraded from Laravel 10 to Laravel 11
+- Dependency: Updated minimum PHP requirement to 8.2
+- Dependency: Updated Symfony/yaml to ^7.0
+- Dependency: Updated illuminate/support and illuminate/view to ^11.0
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)

From 82f45601bb920fae0838b3ace2322b3c1548a7f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 20:10:46 +0100
Subject: [PATCH 3938/4023] Upgrade Torchlight version to forked version

---
 RELEASE_NOTES.md                 | 1 +
 packages/framework/composer.json | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 37aed8698c5..9fec3ca32fa 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -53,6 +53,7 @@ This serves two purposes:
 - Dependency: Updated minimum PHP requirement to 8.2
 - Dependency: Updated Symfony/yaml to ^7.0
 - Dependency: Updated illuminate/support and illuminate/view to ^11.0
+- Dependency: Switched to forked version of the Torchlight client
 - Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
 - Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
 - Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
diff --git a/packages/framework/composer.json b/packages/framework/composer.json
index 82e7552e250..c3ff81acbfa 100644
--- a/packages/framework/composer.json
+++ b/packages/framework/composer.json
@@ -28,7 +28,7 @@
         "symfony/yaml": "^7.0",
         "league/commonmark": "^2.2",
         "spatie/yaml-front-matter": "^2.0.9",
-        "torchlight/torchlight-commonmark": "^0.5.5"
+        "hydephp/torchlight-commonmark": "^1.0"
     },
     "suggest": {
         "hyde/hyde" : "The Framework package contains the Hyde Core. To create your site you should use the Hyde/Hyde project.",

From c8b03cd0fe33ac8d781b9d992727b8e5ff4b1909 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 20:21:25 +0100
Subject: [PATCH 3939/4023] Update packages to Laravel 11 and PHP 8.2

---
 packages/publications/composer.json      | 6 +++---
 packages/realtime-compiler/composer.json | 2 +-
 packages/testing/composer.json           | 4 ++--
 packages/ui-kit/composer.json            | 4 ++--
 packages/ui-kit/docs/composer.json       | 4 ++--
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/publications/composer.json b/packages/publications/composer.json
index b6d6b35fda9..68dca02bf49 100644
--- a/packages/publications/composer.json
+++ b/packages/publications/composer.json
@@ -17,9 +17,9 @@
         }
     ],
     "require": {
-        "php": "^8.0",
-        "illuminate/support": "^10.0",
-        "illuminate/validation": "^10.0"
+        "php": "^8.2",
+        "illuminate/support": "^11.0",
+        "illuminate/validation": "^11.0"
     },
     "autoload": {
         "psr-4": {
diff --git a/packages/realtime-compiler/composer.json b/packages/realtime-compiler/composer.json
index 37ec6be3455..34f7d7651b3 100644
--- a/packages/realtime-compiler/composer.json
+++ b/packages/realtime-compiler/composer.json
@@ -21,7 +21,7 @@
     ],
     "bin": ["bin/server.php"],
     "require": {
-        "php": "^8.1",
+        "php": "^8.2",
         "desilva/microserve": "^2.0",
         "hyde/framework": "*"
     },
diff --git a/packages/testing/composer.json b/packages/testing/composer.json
index 3306c81eaeb..e4d0b98a27e 100644
--- a/packages/testing/composer.json
+++ b/packages/testing/composer.json
@@ -17,8 +17,8 @@
         }
     ],
     "require": {
-        "php": "^8.0",
-        "illuminate/support": "^10.0",
+        "php": "^8.2",
+        "illuminate/support": "^11.0",
         "laravel/dusk": "^8.2.2",
         "mockery/mockery": "^1.4.4",
         "pestphp/pest": "^v2.1.0",
diff --git a/packages/ui-kit/composer.json b/packages/ui-kit/composer.json
index 5203760de44..15dc8c1c447 100644
--- a/packages/ui-kit/composer.json
+++ b/packages/ui-kit/composer.json
@@ -13,8 +13,8 @@
         }
     ],
     "require": {
-        "php": "^8.0",
-        "illuminate/support": "^10.0"
+        "php": "^8.2",
+        "illuminate/support": "^11.0"
     },
     "autoload": {
         "psr-4": {
diff --git a/packages/ui-kit/docs/composer.json b/packages/ui-kit/docs/composer.json
index 1100f569399..1850d4f82a3 100644
--- a/packages/ui-kit/docs/composer.json
+++ b/packages/ui-kit/docs/composer.json
@@ -24,10 +24,10 @@
         }
     ],
     "require": {
-        "php": "^8.1",
+        "php": "^8.2",
         "hyde/framework": "^1.0",
         "hyde/ui-kit": "dev-master",
-        "laravel-zero/framework": "^10.0"
+        "laravel-zero/framework": "^11.0"
     },
     "require-dev": {
         "hyde/realtime-compiler": "^3.0"

From 09fd8b9df517959b4469221a57590a4612c23b8e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 19:42:15 +0100
Subject: [PATCH 3940/4023] Bump locked Composer dependencies

---
 composer.lock | 3878 ++++++++++++++++++++++++++++++++-----------------
 1 file changed, 2553 insertions(+), 1325 deletions(-)

diff --git a/composer.lock b/composer.lock
index 94baff3a821..d0348f130ad 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,20 +4,20 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "51bea0fb107cbafb480399a6d0817a74",
+    "content-hash": "bbac95f022e643213751e01c6a7cdf9a",
     "packages": [
         {
             "name": "brick/math",
-            "version": "0.12.1",
+            "version": "0.12.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/brick/math.git",
-                "reference": "f510c0a40911935b77b86859eb5223d58d660df1"
+                "reference": "866551da34e9a618e64a819ee1e01c20d8a588ba"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/brick/math/zipball/f510c0a40911935b77b86859eb5223d58d660df1",
-                "reference": "f510c0a40911935b77b86859eb5223d58d660df1",
+                "url": "https://api.github.com/repos/brick/math/zipball/866551da34e9a618e64a819ee1e01c20d8a588ba",
+                "reference": "866551da34e9a618e64a819ee1e01c20d8a588ba",
                 "shasum": ""
             },
             "require": {
@@ -26,7 +26,7 @@
             "require-dev": {
                 "php-coveralls/php-coveralls": "^2.2",
                 "phpunit/phpunit": "^10.1",
-                "vimeo/psalm": "5.16.0"
+                "vimeo/psalm": "6.8.8"
             },
             "type": "library",
             "autoload": {
@@ -56,7 +56,7 @@
             ],
             "support": {
                 "issues": "https://github.com/brick/math/issues",
-                "source": "https://github.com/brick/math/tree/0.12.1"
+                "source": "https://github.com/brick/math/tree/0.12.3"
             },
             "funding": [
                 {
@@ -64,30 +64,30 @@
                     "type": "github"
                 }
             ],
-            "time": "2023-11-29T23:19:16+00:00"
+            "time": "2025-02-28T13:11:00+00:00"
         },
         {
             "name": "carbonphp/carbon-doctrine-types",
-            "version": "2.1.0",
+            "version": "3.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/CarbonPHP/carbon-doctrine-types.git",
-                "reference": "99f76ffa36cce3b70a4a6abce41dba15ca2e84cb"
+                "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/CarbonPHP/carbon-doctrine-types/zipball/99f76ffa36cce3b70a4a6abce41dba15ca2e84cb",
-                "reference": "99f76ffa36cce3b70a4a6abce41dba15ca2e84cb",
+                "url": "https://api.github.com/repos/CarbonPHP/carbon-doctrine-types/zipball/18ba5ddfec8976260ead6e866180bd5d2f71aa1d",
+                "reference": "18ba5ddfec8976260ead6e866180bd5d2f71aa1d",
                 "shasum": ""
             },
             "require": {
-                "php": "^7.4 || ^8.0"
+                "php": "^8.1"
             },
             "conflict": {
-                "doctrine/dbal": "<3.7.0 || >=4.0.0"
+                "doctrine/dbal": "<4.0.0 || >=5.0.0"
             },
             "require-dev": {
-                "doctrine/dbal": "^3.7.0",
+                "doctrine/dbal": "^4.0.0",
                 "nesbot/carbon": "^2.71.0 || ^3.0.0",
                 "phpunit/phpunit": "^10.3"
             },
@@ -117,7 +117,7 @@
             ],
             "support": {
                 "issues": "https://github.com/CarbonPHP/carbon-doctrine-types/issues",
-                "source": "https://github.com/CarbonPHP/carbon-doctrine-types/tree/2.1.0"
+                "source": "https://github.com/CarbonPHP/carbon-doctrine-types/tree/3.2.0"
             },
             "funding": [
                 {
@@ -133,7 +133,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-12-11T17:09:12+00:00"
+            "time": "2024-02-09T16:56:22+00:00"
         },
         {
             "name": "dflydev/dot-access-data",
@@ -445,16 +445,16 @@
         },
         {
             "name": "egulias/email-validator",
-            "version": "4.0.2",
+            "version": "4.0.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/egulias/EmailValidator.git",
-                "reference": "ebaaf5be6c0286928352e054f2d5125608e5405e"
+                "reference": "d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/egulias/EmailValidator/zipball/ebaaf5be6c0286928352e054f2d5125608e5405e",
-                "reference": "ebaaf5be6c0286928352e054f2d5125608e5405e",
+                "url": "https://api.github.com/repos/egulias/EmailValidator/zipball/d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa",
+                "reference": "d42c8731f0624ad6bdc8d3e5e9a4524f68801cfa",
                 "shasum": ""
             },
             "require": {
@@ -500,7 +500,7 @@
             ],
             "support": {
                 "issues": "https://github.com/egulias/EmailValidator/issues",
-                "source": "https://github.com/egulias/EmailValidator/tree/4.0.2"
+                "source": "https://github.com/egulias/EmailValidator/tree/4.0.4"
             },
             "funding": [
                 {
@@ -508,20 +508,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2023-10-06T06:47:41+00:00"
+            "time": "2025-03-06T22:45:56+00:00"
         },
         {
             "name": "filp/whoops",
-            "version": "2.16.0",
+            "version": "2.18.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/filp/whoops.git",
-                "reference": "befcdc0e5dce67252aa6322d82424be928214fa2"
+                "reference": "a7de6c3c6c3c022f5cfc337f8ede6a14460cf77e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/filp/whoops/zipball/befcdc0e5dce67252aa6322d82424be928214fa2",
-                "reference": "befcdc0e5dce67252aa6322d82424be928214fa2",
+                "url": "https://api.github.com/repos/filp/whoops/zipball/a7de6c3c6c3c022f5cfc337f8ede6a14460cf77e",
+                "reference": "a7de6c3c6c3c022f5cfc337f8ede6a14460cf77e",
                 "shasum": ""
             },
             "require": {
@@ -571,7 +571,7 @@
             ],
             "support": {
                 "issues": "https://github.com/filp/whoops/issues",
-                "source": "https://github.com/filp/whoops/tree/2.16.0"
+                "source": "https://github.com/filp/whoops/tree/2.18.0"
             },
             "funding": [
                 {
@@ -579,7 +579,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-09-25T12:00:00+00:00"
+            "time": "2025-03-15T12:00:00+00:00"
         },
         {
             "name": "fruitcake/php-cors",
@@ -1041,16 +1041,16 @@
         },
         {
             "name": "guzzlehttp/uri-template",
-            "version": "v1.0.3",
+            "version": "v1.0.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/uri-template.git",
-                "reference": "ecea8feef63bd4fef1f037ecb288386999ecc11c"
+                "reference": "30e286560c137526eccd4ce21b2de477ab0676d2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/uri-template/zipball/ecea8feef63bd4fef1f037ecb288386999ecc11c",
-                "reference": "ecea8feef63bd4fef1f037ecb288386999ecc11c",
+                "url": "https://api.github.com/repos/guzzle/uri-template/zipball/30e286560c137526eccd4ce21b2de477ab0676d2",
+                "reference": "30e286560c137526eccd4ce21b2de477ab0676d2",
                 "shasum": ""
             },
             "require": {
@@ -1107,7 +1107,7 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/uri-template/issues",
-                "source": "https://github.com/guzzle/uri-template/tree/v1.0.3"
+                "source": "https://github.com/guzzle/uri-template/tree/v1.0.4"
             },
             "funding": [
                 {
@@ -1123,29 +1123,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-12-03T19:50:20+00:00"
+            "time": "2025-02-03T10:55:03+00:00"
         },
         {
             "name": "hyde/framework",
-            "version": "dev-main",
+            "version": "dev-develop",
             "dist": {
                 "type": "path",
                 "url": "./packages/framework",
-                "reference": "784479be93b9882e4416fcec249de2e839f72df4"
+                "reference": "5b96d090b888e202790ecda6a6da750fa5dc68cc"
             },
             "require": {
-                "illuminate/support": "^10.0",
-                "illuminate/view": "^10.0",
+                "hydephp/torchlight-commonmark": "^1.0",
+                "illuminate/support": "^11.0",
+                "illuminate/view": "^11.0",
                 "league/commonmark": "^2.2",
-                "php": "^8.1",
+                "php": "^8.2",
                 "spatie/yaml-front-matter": "^2.0.9",
-                "symfony/yaml": "^6.0",
-                "torchlight/torchlight-commonmark": "^0.5.5"
+                "symfony/yaml": "^7.0"
             },
             "suggest": {
                 "ext-simplexml": "Required to generate sitemaps and RSS feeds.",
                 "hyde/hyde": "The Framework package contains the Hyde Core. To create your site you should use the Hyde/Hyde project.",
-                "laravel-zero/framework": "^10.0"
+                "laravel-zero/framework": "^11.0"
             },
             "type": "library",
             "autoload": {
@@ -1177,16 +1177,16 @@
         },
         {
             "name": "hyde/publications",
-            "version": "dev-main",
+            "version": "dev-laravel-11",
             "dist": {
                 "type": "path",
                 "url": "./packages/publications",
-                "reference": "702ffcfbb9545b64d464610af83c7837c181e295"
+                "reference": "030fe9197a830b0ca2c97e4b63e0ce0005056aab"
             },
             "require": {
-                "illuminate/support": "^10.0",
-                "illuminate/validation": "^10.0",
-                "php": "^8.0"
+                "illuminate/support": "^11.0",
+                "illuminate/validation": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
@@ -1224,15 +1224,15 @@
         },
         {
             "name": "hyde/ui-kit",
-            "version": "dev-main",
+            "version": "dev-laravel-11",
             "dist": {
                 "type": "path",
                 "url": "./packages/ui-kit",
-                "reference": "aff2af82d0d757e5669f3a428287530e645eb808"
+                "reference": "10741c42ca77cbd917041d8eb67b6c3728d68a87"
             },
             "require": {
-                "illuminate/support": "^10.0",
-                "php": "^8.0"
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
@@ -1270,26 +1270,90 @@
                 "relative": true
             }
         },
+        {
+            "name": "hydephp/torchlight-commonmark",
+            "version": "v1.0.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/hydephp/torchlight-commonmark-php.git",
+                "reference": "44aefc0e1c0d433f01756911c9d8e2c5a8f99585"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/hydephp/torchlight-commonmark-php/zipball/44aefc0e1c0d433f01756911c9d8e2c5a8f99585",
+                "reference": "44aefc0e1c0d433f01756911c9d8e2c5a8f99585",
+                "shasum": ""
+            },
+            "require": {
+                "league/commonmark": "^1.5|^2.0",
+                "php": "^7.2|^8.0",
+                "torchlight/torchlight-laravel": "^0.5|^0.6"
+            },
+            "require-dev": {
+                "mockery/mockery": "^1.3.3",
+                "orchestra/testbench": "^5.0|^6.0",
+                "phpunit/phpunit": "^8.4"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Torchlight\\Commonmark\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Aaron Francis",
+                    "email": "aaron@hammerstone.dev"
+                }
+            ],
+            "description": "A Commonmark extension for Torchlight, the syntax highlighting API.",
+            "homepage": "https://torchlight.dev",
+            "keywords": [
+                "Code highlighting",
+                "commonmark",
+                "laravel",
+                "markdown",
+                "syntax highlighting"
+            ],
+            "support": {
+                "source": "https://github.com/hydephp/torchlight-commonmark-php/tree/v1.0.0"
+            },
+            "funding": [
+                {
+                    "url": "https://www.buymeacoffee.com/caen",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://opencollective.com/hydephp",
+                    "type": "open_collective"
+                }
+            ],
+            "time": "2025-03-22T19:03:56+00:00"
+        },
         {
             "name": "illuminate/bus",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/bus.git",
-                "reference": "c66d57011eec385055e1426d026c270aeecb05aa"
+                "reference": "a6945ee3f9f19f45e8ecbfda1884418d13794e1d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/bus/zipball/c66d57011eec385055e1426d026c270aeecb05aa",
-                "reference": "c66d57011eec385055e1426d026c270aeecb05aa",
+                "url": "https://api.github.com/repos/illuminate/bus/zipball/a6945ee3f9f19f45e8ecbfda1884418d13794e1d",
+                "reference": "a6945ee3f9f19f45e8ecbfda1884418d13794e1d",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/pipeline": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/pipeline": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "suggest": {
                 "illuminate/queue": "Required to use closures when chaining jobs (^7.0)."
@@ -1297,7 +1361,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1321,28 +1385,28 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-02-12T20:57:17+00:00"
         },
         {
             "name": "illuminate/cache",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/cache.git",
-                "reference": "6020bc5f40b62cc680be3eb57e980e5cb26884ff"
+                "reference": "f9196623f6b75f7e69b9ac92f367491909753987"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/cache/zipball/6020bc5f40b62cc680be3eb57e980e5cb26884ff",
-                "reference": "6020bc5f40b62cc680be3eb57e980e5cb26884ff",
+                "url": "https://api.github.com/repos/illuminate/cache/zipball/f9196623f6b75f7e69b9ac92f367491909753987",
+                "reference": "f9196623f6b75f7e69b9ac92f367491909753987",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "provide": {
                 "psr/simple-cache-implementation": "1.0|2.0|3.0"
@@ -1351,15 +1415,15 @@
                 "ext-apcu": "Required to use the APC cache driver.",
                 "ext-filter": "Required to use the DynamoDb cache driver.",
                 "ext-memcached": "Required to use the memcache cache driver.",
-                "illuminate/database": "Required to use the database cache driver (^10.0).",
-                "illuminate/filesystem": "Required to use the file cache driver (^10.0).",
-                "illuminate/redis": "Required to use the redis cache driver (^10.0).",
-                "symfony/cache": "Required to use PSR-6 cache bridge (^6.2)."
+                "illuminate/database": "Required to use the database cache driver (^11.0).",
+                "illuminate/filesystem": "Required to use the file cache driver (^11.0).",
+                "illuminate/redis": "Required to use the redis cache driver (^11.0).",
+                "symfony/cache": "Required to use PSR-6 cache bridge (^7.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1383,39 +1447,40 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-05-23T18:38:25+00:00"
+            "time": "2025-01-27T22:47:27+00:00"
         },
         {
             "name": "illuminate/collections",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/collections.git",
-                "reference": "48de3d6bc6aa779112ddcb608a3a96fc975d89d8"
+                "reference": "f2f537dfb2a142791d37478f34c920b44a45cea9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/collections/zipball/48de3d6bc6aa779112ddcb608a3a96fc975d89d8",
-                "reference": "48de3d6bc6aa779112ddcb608a3a96fc975d89d8",
+                "url": "https://api.github.com/repos/illuminate/collections/zipball/f2f537dfb2a142791d37478f34c920b44a45cea9",
+                "reference": "f2f537dfb2a142791d37478f34c920b44a45cea9",
                 "shasum": ""
             },
             "require": {
-                "illuminate/conditionable": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "php": "^8.1"
+                "illuminate/conditionable": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "php": "^8.2"
             },
             "suggest": {
-                "symfony/var-dumper": "Required to use the dump method (^6.2)."
+                "symfony/var-dumper": "Required to use the dump method (^7.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
                 "files": [
+                    "functions.php",
                     "helpers.php"
                 ],
                 "psr-4": {
@@ -1438,20 +1503,20 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-03-06T14:02:47+00:00"
         },
         {
             "name": "illuminate/conditionable",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/conditionable.git",
-                "reference": "3ee34ac306fafc2a6f19cd7cd68c9af389e432a5"
+                "reference": "911df1bda950a3b799cf80671764e34eede131c6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/conditionable/zipball/3ee34ac306fafc2a6f19cd7cd68c9af389e432a5",
-                "reference": "3ee34ac306fafc2a6f19cd7cd68c9af389e432a5",
+                "url": "https://api.github.com/repos/illuminate/conditionable/zipball/911df1bda950a3b799cf80671764e34eede131c6",
+                "reference": "911df1bda950a3b799cf80671764e34eede131c6",
                 "shasum": ""
             },
             "require": {
@@ -1460,7 +1525,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1484,31 +1549,31 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2024-11-21T16:28:56+00:00"
         },
         {
             "name": "illuminate/config",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/config.git",
-                "reference": "d5e83ceff5c4d5607b1b81763eb4c436911c35da"
+                "reference": "64daa8d520cd76e505a82460a672692c56a07be8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/config/zipball/d5e83ceff5c4d5607b1b81763eb4c436911c35da",
-                "reference": "d5e83ceff5c4d5607b1b81763eb4c436911c35da",
+                "url": "https://api.github.com/repos/illuminate/config/zipball/64daa8d520cd76e505a82460a672692c56a07be8",
+                "reference": "64daa8d520cd76e505a82460a672692c56a07be8",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1532,48 +1597,49 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2022-08-21T15:47:27+00:00"
+            "time": "2024-11-14T17:17:02+00:00"
         },
         {
             "name": "illuminate/console",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/console.git",
-                "reference": "e30d1f6ec68bd8138ba5f21998a2ee1c65ca82ca"
+                "reference": "bd26864d3356a7fad52c06abed0c71e90dd5ebcc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/console/zipball/e30d1f6ec68bd8138ba5f21998a2ee1c65ca82ca",
-                "reference": "e30d1f6ec68bd8138ba5f21998a2ee1c65ca82ca",
+                "url": "https://api.github.com/repos/illuminate/console/zipball/bd26864d3356a7fad52c06abed0c71e90dd5ebcc",
+                "reference": "bd26864d3356a7fad52c06abed0c71e90dd5ebcc",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "illuminate/view": "^10.0",
-                "laravel/prompts": "^0.1.9",
-                "nunomaduro/termwind": "^1.13",
-                "php": "^8.1",
-                "symfony/console": "^6.2",
-                "symfony/process": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "illuminate/view": "^11.0",
+                "laravel/prompts": "^0.1.20|^0.2|^0.3",
+                "nunomaduro/termwind": "^2.0",
+                "php": "^8.2",
+                "symfony/console": "^7.0.3",
+                "symfony/polyfill-php83": "^1.31",
+                "symfony/process": "^7.0.3"
             },
             "suggest": {
                 "dragonmantank/cron-expression": "Required to use scheduler (^3.3.2).",
                 "ext-pcntl": "Required to use signal trapping.",
-                "guzzlehttp/guzzle": "Required to use the ping methods on schedules (^7.5).",
-                "illuminate/bus": "Required to use the scheduled job dispatcher (^10.0).",
-                "illuminate/container": "Required to use the scheduler (^10.0).",
-                "illuminate/filesystem": "Required to use the generator command (^10.0).",
-                "illuminate/queue": "Required to use closures for scheduled jobs (^10.0)."
+                "guzzlehttp/guzzle": "Required to use the ping methods on schedules (^7.8).",
+                "illuminate/bus": "Required to use the scheduled job dispatcher (^11.0).",
+                "illuminate/container": "Required to use the scheduler (^11.0).",
+                "illuminate/filesystem": "Required to use the generator command (^11.0).",
+                "illuminate/queue": "Required to use closures for scheduled jobs (^11.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1597,25 +1663,25 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2025-01-10T00:56:56+00:00"
+            "time": "2025-02-11T15:03:50+00:00"
         },
         {
             "name": "illuminate/container",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/container.git",
-                "reference": "ed6253f7dd3a67d468b2cc7a69a657e1f14c7ba3"
+                "reference": "4dcc3fcbab92e734fc0c08d9cfd97f5a1aef18ca"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/container/zipball/ed6253f7dd3a67d468b2cc7a69a657e1f14c7ba3",
-                "reference": "ed6253f7dd3a67d468b2cc7a69a657e1f14c7ba3",
+                "url": "https://api.github.com/repos/illuminate/container/zipball/4dcc3fcbab92e734fc0c08d9cfd97f5a1aef18ca",
+                "reference": "4dcc3fcbab92e734fc0c08d9cfd97f5a1aef18ca",
                 "shasum": ""
             },
             "require": {
-                "illuminate/contracts": "^10.0",
-                "php": "^8.1",
+                "illuminate/contracts": "^11.0",
+                "php": "^8.2",
                 "psr/container": "^1.1.1|^2.0.1"
             },
             "provide": {
@@ -1624,7 +1690,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1648,31 +1714,31 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-02-10T14:20:57+00:00"
         },
         {
             "name": "illuminate/contracts",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/contracts.git",
-                "reference": "f90663a69f926105a70b78060a31f3c64e2d1c74"
+                "reference": "b350a3cd8450846325cb49e1cbc1293598b18898"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/contracts/zipball/f90663a69f926105a70b78060a31f3c64e2d1c74",
-                "reference": "f90663a69f926105a70b78060a31f3c64e2d1c74",
+                "url": "https://api.github.com/repos/illuminate/contracts/zipball/b350a3cd8450846325cb49e1cbc1293598b18898",
+                "reference": "b350a3cd8450846325cb49e1cbc1293598b18898",
                 "shasum": ""
             },
             "require": {
-                "php": "^8.1",
+                "php": "^8.2",
                 "psr/container": "^1.1.1|^2.0.1",
                 "psr/simple-cache": "^1.0|^2.0|^3.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1696,35 +1762,35 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-02-10T14:20:57+00:00"
         },
         {
             "name": "illuminate/events",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/events.git",
-                "reference": "3edcdad2f2fe6da6802afb0a256b0f7ee00d72e9"
+                "reference": "607e8620fe51462e859859bb57b469e2c61efe1d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/events/zipball/3edcdad2f2fe6da6802afb0a256b0f7ee00d72e9",
-                "reference": "3edcdad2f2fe6da6802afb0a256b0f7ee00d72e9",
+                "url": "https://api.github.com/repos/illuminate/events/zipball/607e8620fe51462e859859bb57b469e2c61efe1d",
+                "reference": "607e8620fe51462e859859bb57b469e2c61efe1d",
                 "shasum": ""
             },
             "require": {
-                "illuminate/bus": "^10.0",
-                "illuminate/collections": "^10.0",
-                "illuminate/container": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/bus": "^11.0",
+                "illuminate/collections": "^11.0",
+                "illuminate/container": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1751,47 +1817,47 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-01-31T17:44:22+00:00"
         },
         {
             "name": "illuminate/filesystem",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/filesystem.git",
-                "reference": "584ff4da2218e63e7210bba1c541ce526f24f37e"
+                "reference": "c79a54ebc61ad4e1665ca7610f276ff8a92f48f7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/filesystem/zipball/584ff4da2218e63e7210bba1c541ce526f24f37e",
-                "reference": "584ff4da2218e63e7210bba1c541ce526f24f37e",
+                "url": "https://api.github.com/repos/illuminate/filesystem/zipball/c79a54ebc61ad4e1665ca7610f276ff8a92f48f7",
+                "reference": "c79a54ebc61ad4e1665ca7610f276ff8a92f48f7",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1",
-                "symfony/finder": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2",
+                "symfony/finder": "^7.0.3"
             },
             "suggest": {
                 "ext-fileinfo": "Required to use the Filesystem class.",
                 "ext-ftp": "Required to use the Flysystem FTP driver.",
                 "ext-hash": "Required to use the Filesystem class.",
                 "illuminate/http": "Required for handling uploaded files (^7.0).",
-                "league/flysystem": "Required to use the Flysystem local driver (^3.0.16).",
-                "league/flysystem-aws-s3-v3": "Required to use the Flysystem S3 driver (^3.0).",
-                "league/flysystem-ftp": "Required to use the Flysystem FTP driver (^3.0).",
-                "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.0).",
+                "league/flysystem": "Required to use the Flysystem local driver (^3.25.1).",
+                "league/flysystem-aws-s3-v3": "Required to use the Flysystem S3 driver (^3.25.1).",
+                "league/flysystem-ftp": "Required to use the Flysystem FTP driver (^3.25.1).",
+                "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.25.1).",
                 "psr/http-message": "Required to allow Storage::put to accept a StreamInterface (^1.0).",
-                "symfony/filesystem": "Required to enable support for relative symbolic links (^6.2).",
-                "symfony/mime": "Required to enable support for guessing extensions (^6.2)."
+                "symfony/filesystem": "Required to enable support for relative symbolic links (^7.0).",
+                "symfony/mime": "Required to enable support for guessing extensions (^7.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1818,43 +1884,44 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2025-01-24T16:09:31+00:00"
+            "time": "2025-02-19T20:17:00+00:00"
         },
         {
             "name": "illuminate/http",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/http.git",
-                "reference": "bde2f993d77a8a10027376a18c90d1ba7ef0f214"
+                "reference": "8fe991160856deebae6e7f45719140228635c99c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/http/zipball/bde2f993d77a8a10027376a18c90d1ba7ef0f214",
-                "reference": "bde2f993d77a8a10027376a18c90d1ba7ef0f214",
+                "url": "https://api.github.com/repos/illuminate/http/zipball/8fe991160856deebae6e7f45719140228635c99c",
+                "reference": "8fe991160856deebae6e7f45719140228635c99c",
                 "shasum": ""
             },
             "require": {
                 "ext-filter": "*",
-                "fruitcake/php-cors": "^1.2",
+                "fruitcake/php-cors": "^1.3",
+                "guzzlehttp/guzzle": "^7.8.2",
                 "guzzlehttp/uri-template": "^1.0",
-                "illuminate/collections": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/session": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1",
-                "symfony/http-foundation": "^6.4",
-                "symfony/http-kernel": "^6.2",
-                "symfony/mime": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/session": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2",
+                "symfony/http-foundation": "^7.0.3",
+                "symfony/http-kernel": "^7.0.3",
+                "symfony/mime": "^7.0.3",
+                "symfony/polyfill-php83": "^1.31"
             },
             "suggest": {
-                "ext-gd": "Required to use Illuminate\\Http\\Testing\\FileFactory::image().",
-                "guzzlehttp/guzzle": "Required to use the HTTP Client (^7.5)."
+                "ext-gd": "Required to use Illuminate\\Http\\Testing\\FileFactory::image()."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1878,29 +1945,29 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-08-05T17:20:47+00:00"
+            "time": "2025-01-23T14:04:49+00:00"
         },
         {
             "name": "illuminate/macroable",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/macroable.git",
-                "reference": "dff667a46ac37b634dcf68909d9d41e94dc97c27"
+                "reference": "e1cb9e51b9ed5d3c9bc1ab431d0a52fe42a990ed"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/macroable/zipball/dff667a46ac37b634dcf68909d9d41e94dc97c27",
-                "reference": "dff667a46ac37b634dcf68909d9d41e94dc97c27",
+                "url": "https://api.github.com/repos/illuminate/macroable/zipball/e1cb9e51b9ed5d3c9bc1ab431d0a52fe42a990ed",
+                "reference": "e1cb9e51b9ed5d3c9bc1ab431d0a52fe42a990ed",
                 "shasum": ""
             },
             "require": {
-                "php": "^8.1"
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1924,31 +1991,31 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2023-06-05T12:46:42+00:00"
+            "time": "2024-06-28T20:10:30+00:00"
         },
         {
             "name": "illuminate/pipeline",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/pipeline.git",
-                "reference": "3030a131e5e9cb18c9a826428fcffc076df9dcd7"
+                "reference": "713afd1b476f1974f6e0207fc9f65671f16fb64b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/pipeline/zipball/3030a131e5e9cb18c9a826428fcffc076df9dcd7",
-                "reference": "3030a131e5e9cb18c9a826428fcffc076df9dcd7",
+                "url": "https://api.github.com/repos/illuminate/pipeline/zipball/713afd1b476f1974f6e0207fc9f65671f16fb64b",
+                "reference": "713afd1b476f1974f6e0207fc9f65671f16fb64b",
                 "shasum": ""
             },
             "require": {
-                "illuminate/contracts": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/contracts": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -1972,34 +2039,34 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-02-17T16:02:42+00:00"
         },
         {
             "name": "illuminate/process",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/process.git",
-                "reference": "1568d348daaa9d55637c616edb8889a083949b4a"
+                "reference": "954343a343ccc2ae678d7e631f977e6382cfbdc9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/process/zipball/1568d348daaa9d55637c616edb8889a083949b4a",
-                "reference": "1568d348daaa9d55637c616edb8889a083949b4a",
+                "url": "https://api.github.com/repos/illuminate/process/zipball/954343a343ccc2ae678d7e631f977e6382cfbdc9",
+                "reference": "954343a343ccc2ae678d7e631f977e6382cfbdc9",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1",
-                "symfony/process": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2",
+                "symfony/process": "^7.0.3"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2023,40 +2090,40 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-02-22T14:52:10+00:00"
+            "time": "2025-02-14T15:31:55+00:00"
         },
         {
             "name": "illuminate/session",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/session.git",
-                "reference": "a095707b83327e27ba292c9c4d2413888b1f517c"
+                "reference": "2ad71663c1cca955f483a5227247f13eba3b495c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/session/zipball/a095707b83327e27ba292c9c4d2413888b1f517c",
-                "reference": "a095707b83327e27ba292c9c4d2413888b1f517c",
+                "url": "https://api.github.com/repos/illuminate/session/zipball/2ad71663c1cca955f483a5227247f13eba3b495c",
+                "reference": "2ad71663c1cca955f483a5227247f13eba3b495c",
                 "shasum": ""
             },
             "require": {
                 "ext-ctype": "*",
                 "ext-session": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/filesystem": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1",
-                "symfony/finder": "^6.2",
-                "symfony/http-foundation": "^6.4"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/filesystem": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2",
+                "symfony/finder": "^7.0.3",
+                "symfony/http-foundation": "^7.0.3"
             },
             "suggest": {
-                "illuminate/console": "Required to use the session:table command (^10.0)."
+                "illuminate/console": "Required to use the session:table command (^11.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2080,20 +2147,20 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2023-12-29T21:53:12+00:00"
+            "time": "2025-01-28T15:20:31+00:00"
         },
         {
             "name": "illuminate/support",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/support.git",
-                "reference": "6d09b480d34846245d9288f4dcefb17a73ce6e6a"
+                "reference": "d86d42ad0c75a020e0e4a7c734e9424ca86811cc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/support/zipball/6d09b480d34846245d9288f4dcefb17a73ce6e6a",
-                "reference": "6d09b480d34846245d9288f4dcefb17a73ce6e6a",
+                "url": "https://api.github.com/repos/illuminate/support/zipball/d86d42ad0c75a020e0e4a7c734e9424ca86811cc",
+                "reference": "d86d42ad0c75a020e0e4a7c734e9424ca86811cc",
                 "shasum": ""
             },
             "require": {
@@ -2101,34 +2168,40 @@
                 "ext-ctype": "*",
                 "ext-filter": "*",
                 "ext-mbstring": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/conditionable": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "nesbot/carbon": "^2.67",
-                "php": "^8.1",
-                "voku/portable-ascii": "^2.0"
+                "illuminate/collections": "^11.0",
+                "illuminate/conditionable": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "nesbot/carbon": "^2.72.6|^3.8.4",
+                "php": "^8.2",
+                "voku/portable-ascii": "^2.0.2"
             },
             "conflict": {
                 "tightenco/collect": "<5.5.33"
             },
+            "replace": {
+                "spatie/once": "*"
+            },
             "suggest": {
-                "illuminate/filesystem": "Required to use the composer class (^10.0).",
+                "illuminate/filesystem": "Required to use the Composer class (^11.0).",
+                "laravel/serializable-closure": "Required to use the once function (^1.3|^2.0).",
                 "league/commonmark": "Required to use Str::markdown() and Stringable::markdown() (^2.6).",
+                "league/uri": "Required to use the Uri class (^7.5.1).",
                 "ramsey/uuid": "Required to use Str::uuid() (^4.7).",
-                "symfony/process": "Required to use the composer class (^6.2).",
-                "symfony/uid": "Required to use Str::ulid() (^6.2).",
-                "symfony/var-dumper": "Required to use the dd function (^6.2).",
-                "vlucas/phpdotenv": "Required to use the Env class and env helper (^5.4.1)."
+                "symfony/process": "Required to use the Composer class (^7.0).",
+                "symfony/uid": "Required to use Str::ulid() (^7.0).",
+                "symfony/var-dumper": "Required to use the dd function (^7.0).",
+                "vlucas/phpdotenv": "Required to use the Env class and env helper (^5.6.1)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
                 "files": [
+                    "functions.php",
                     "helpers.php"
                 ],
                 "psr-4": {
@@ -2151,42 +2224,42 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-12-10T14:47:55+00:00"
+            "time": "2025-02-23T14:20:22+00:00"
         },
         {
             "name": "illuminate/testing",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/testing.git",
-                "reference": "ff641ff4813040c2a5abfcbe8e38590106608cd7"
+                "reference": "55685e5d1a594032b256d7c736091f89f7c007fb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/testing/zipball/ff641ff4813040c2a5abfcbe8e38590106608cd7",
-                "reference": "ff641ff4813040c2a5abfcbe8e38590106608cd7",
+                "url": "https://api.github.com/repos/illuminate/testing/zipball/55685e5d1a594032b256d7c736091f89f7c007fb",
+                "reference": "55685e5d1a594032b256d7c736091f89f7c007fb",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "suggest": {
-                "brianium/paratest": "Required to run tests in parallel (^6.0).",
-                "illuminate/console": "Required to assert console commands (^10.0).",
-                "illuminate/database": "Required to assert databases (^10.0).",
-                "illuminate/http": "Required to assert responses (^10.0).",
-                "mockery/mockery": "Required to use mocking (^1.5.1).",
-                "phpunit/phpunit": "Required to use assertions and run tests (^9.5.8|^10.0.7)."
+                "brianium/paratest": "Required to run tests in parallel (^7.0|^8.0).",
+                "illuminate/console": "Required to assert console commands (^11.0).",
+                "illuminate/database": "Required to assert databases (^11.0).",
+                "illuminate/http": "Required to assert responses (^11.0).",
+                "mockery/mockery": "Required to use mocking (^1.6).",
+                "phpunit/phpunit": "Required to use assertions and run tests (^10.5.35|^11.3.6|^12.0.1)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2210,34 +2283,34 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-04-22T13:20:30+00:00"
+            "time": "2025-02-23T14:20:06+00:00"
         },
         {
             "name": "illuminate/translation",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/translation.git",
-                "reference": "4da8ed16d6ea6008acf43c7375a9b2073fb10e0b"
+                "reference": "de64584470b1d4bfc30f2c291585b873ce844ecf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/translation/zipball/4da8ed16d6ea6008acf43c7375a9b2073fb10e0b",
-                "reference": "4da8ed16d6ea6008acf43c7375a9b2073fb10e0b",
+                "url": "https://api.github.com/repos/illuminate/translation/zipball/de64584470b1d4bfc30f2c291585b873ce844ecf",
+                "reference": "de64584470b1d4bfc30f2c291585b873ce844ecf",
                 "shasum": ""
             },
             "require": {
-                "illuminate/collections": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/filesystem": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/filesystem": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2261,20 +2334,20 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-01-30T15:55:48+00:00"
+            "time": "2025-02-14T15:47:05+00:00"
         },
         {
             "name": "illuminate/validation",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/validation.git",
-                "reference": "c9be8b183279f0175233e0758285a297431045ac"
+                "reference": "0abcf721a46d3c2a94f225dce82f3c00070f6121"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/validation/zipball/c9be8b183279f0175233e0758285a297431045ac",
-                "reference": "c9be8b183279f0175233e0758285a297431045ac",
+                "url": "https://api.github.com/repos/illuminate/validation/zipball/0abcf721a46d3c2a94f225dce82f3c00070f6121",
+                "reference": "0abcf721a46d3c2a94f225dce82f3c00070f6121",
                 "shasum": ""
             },
             "require": {
@@ -2282,23 +2355,23 @@
                 "egulias/email-validator": "^3.2.5|^4.0",
                 "ext-filter": "*",
                 "ext-mbstring": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/container": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "illuminate/translation": "^10.0",
-                "php": "^8.1",
-                "symfony/http-foundation": "^6.4",
-                "symfony/mime": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/container": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "illuminate/translation": "^11.0",
+                "php": "^8.2",
+                "symfony/http-foundation": "^7.0",
+                "symfony/mime": "^7.0"
             },
             "suggest": {
-                "illuminate/database": "Required to use the database presence verifier (^10.0)."
+                "illuminate/database": "Required to use the database presence verifier (^11.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2322,37 +2395,37 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-03-08T02:31:57+00:00"
+            "time": "2025-03-11T08:51:12+00:00"
         },
         {
             "name": "illuminate/view",
-            "version": "v10.48.28",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/view.git",
-                "reference": "51c9feaf1364bc35ffb056463cde1d6e639b7c6e"
+                "reference": "fb583cecd970d5eb1265320208fb234e1103eaa7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/view/zipball/51c9feaf1364bc35ffb056463cde1d6e639b7c6e",
-                "reference": "51c9feaf1364bc35ffb056463cde1d6e639b7c6e",
+                "url": "https://api.github.com/repos/illuminate/view/zipball/fb583cecd970d5eb1265320208fb234e1103eaa7",
+                "reference": "fb583cecd970d5eb1265320208fb234e1103eaa7",
                 "shasum": ""
             },
             "require": {
                 "ext-tokenizer": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/container": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/events": "^10.0",
-                "illuminate/filesystem": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
+                "illuminate/collections": "^11.0",
+                "illuminate/container": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/events": "^11.0",
+                "illuminate/filesystem": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2376,7 +2449,7 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-11-21T14:02:44+00:00"
+            "time": "2025-02-17T16:11:15+00:00"
         },
         {
             "name": "jolicode/jolinotif",
@@ -2497,25 +2570,25 @@
         },
         {
             "name": "laravel-zero/foundation",
-            "version": "v10.48.8",
+            "version": "v11.5.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel-zero/foundation.git",
-                "reference": "5203cc84ace9c74e26735888f4c46396450b4b4f"
+                "reference": "9d566a50d1399656e837a3b9354745149265e32e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel-zero/foundation/zipball/5203cc84ace9c74e26735888f4c46396450b4b4f",
-                "reference": "5203cc84ace9c74e26735888f4c46396450b4b4f",
+                "url": "https://api.github.com/repos/laravel-zero/foundation/zipball/9d566a50d1399656e837a3b9354745149265e32e",
+                "reference": "9d566a50d1399656e837a3b9354745149265e32e",
                 "shasum": ""
             },
             "require": {
-                "php": "^8.1"
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "10.x-dev"
+                    "dev-main": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2536,73 +2609,82 @@
                 "laravel"
             ],
             "support": {
-                "source": "https://github.com/laravel-zero/foundation/tree/v10.48.8"
+                "source": "https://github.com/laravel-zero/foundation/tree/v11.5.0"
             },
-            "time": "2024-04-18T13:09:49+00:00"
+            "funding": [
+                {
+                    "url": "https://www.paypal.com/paypalme/enunomaduro",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/nunomaduro",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-04-24T16:56:18+00:00"
         },
         {
             "name": "laravel-zero/framework",
-            "version": "v10.4.0",
+            "version": "v11.36.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel-zero/framework.git",
-                "reference": "1c44f0cdb936b447d5556e0a23733bfc17cdd997"
+                "reference": "9e2c9d4616f125c355e24f752881ca7f27c1f226"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel-zero/framework/zipball/1c44f0cdb936b447d5556e0a23733bfc17cdd997",
-                "reference": "1c44f0cdb936b447d5556e0a23733bfc17cdd997",
+                "url": "https://api.github.com/repos/laravel-zero/framework/zipball/9e2c9d4616f125c355e24f752881ca7f27c1f226",
+                "reference": "9e2c9d4616f125c355e24f752881ca7f27c1f226",
                 "shasum": ""
             },
             "require": {
-                "dragonmantank/cron-expression": "^3.3.3",
+                "dragonmantank/cron-expression": "^3.4.0",
                 "ext-json": "*",
-                "illuminate/cache": "^10.28",
-                "illuminate/collections": "^10.28",
-                "illuminate/config": "^10.28",
-                "illuminate/console": "^10.28",
-                "illuminate/container": "^10.28",
-                "illuminate/contracts": "^10.28",
-                "illuminate/events": "^10.28",
-                "illuminate/filesystem": "^10.28",
-                "illuminate/process": "^10.28",
-                "illuminate/support": "^10.28",
-                "illuminate/testing": "^10.28",
-                "laravel-zero/foundation": "^10.48.8",
-                "league/flysystem": "^3.27.0",
-                "nunomaduro/collision": "^6.4.0|^7.10.0",
-                "nunomaduro/laravel-console-summary": "^1.11.1",
+                "guzzlehttp/guzzle": "^7.9.2",
+                "illuminate/cache": "^11.30.0",
+                "illuminate/collections": "^11.30.0",
+                "illuminate/config": "^11.30.0",
+                "illuminate/console": "^11.30.0",
+                "illuminate/container": "^11.30.0",
+                "illuminate/contracts": "^11.30.0",
+                "illuminate/events": "^11.30.0",
+                "illuminate/filesystem": "^11.30.0",
+                "illuminate/process": "^11.30.0",
+                "illuminate/support": "^11.30.0",
+                "illuminate/testing": "^11.30.0",
+                "laravel-zero/foundation": "^11.5.0",
+                "laravel/prompts": "^0.3.1 || ^0.3.1 || ^0.3.1",
+                "league/flysystem": "^3.29.1",
+                "nunomaduro/collision": "^8.5.0",
+                "nunomaduro/laravel-console-summary": "^1.12.1",
                 "nunomaduro/laravel-console-task": "^1.9",
                 "nunomaduro/laravel-desktop-notifier": "^2.8.1",
-                "php": "^8.1",
-                "psr/log": "^1.1|^2.0|^3.0",
-                "ramsey/uuid": "^4.7.5",
-                "symfony/console": "^6.4.6",
-                "symfony/error-handler": "^6.4.6",
-                "symfony/event-dispatcher": "^6.4.3",
-                "symfony/finder": "^6.4.0",
-                "symfony/process": "^6.4.4",
-                "symfony/var-dumper": "^6.4.6",
-                "vlucas/phpdotenv": "^5.6"
+                "nunomaduro/termwind": "^2.2.0",
+                "php": "^8.2",
+                "psr/log": "^3.0.2",
+                "ramsey/uuid": "^4.7.6",
+                "symfony/console": "^7.1.6",
+                "symfony/error-handler": "^7.1.6",
+                "symfony/event-dispatcher": "^7.1.6",
+                "symfony/finder": "^7.1.6",
+                "symfony/process": "^7.1.6",
+                "symfony/var-dumper": "^7.1.6",
+                "vlucas/phpdotenv": "^5.6.1"
             },
             "require-dev": {
-                "guzzlehttp/guzzle": "^7.8.1",
-                "illuminate/bus": "^10.28",
-                "illuminate/database": "^10.28",
-                "illuminate/http": "^10.28",
-                "illuminate/log": "^10.28",
-                "illuminate/queue": "^10.28",
-                "illuminate/redis": "^10.28",
-                "illuminate/view": "^10.28",
-                "laminas/laminas-text": "^2.11",
+                "illuminate/bus": "^11.30.0",
+                "illuminate/database": "^11.30.0",
+                "illuminate/http": "^11.30.0",
+                "illuminate/log": "^11.30.0",
+                "illuminate/queue": "^11.30.0",
+                "illuminate/redis": "^11.30.0",
+                "illuminate/view": "^11.30.0",
                 "laravel-zero/phar-updater": "^1.4",
-                "laravel/pint": "^1.15.1",
-                "nunomaduro/laravel-console-dusk": "^1.12",
+                "laravel/pint": "^1.18.1",
+                "nunomaduro/laravel-console-dusk": "^1.13.1",
                 "nunomaduro/laravel-console-menu": "^3.5",
-                "nunomaduro/termwind": "^1.15.1",
-                "pestphp/pest": "^2.34.7",
-                "pestphp/pest-plugin-laravel": "^2.3",
-                "phpstan/phpstan": "^1.10.67"
+                "pestphp/pest": "^3.5.1",
+                "phpstan/phpstan": "^1.12.7"
             },
             "suggest": {
                 "ext-pcntl": "Required to ensure that data is cleared when cancelling the build process."
@@ -2610,7 +2692,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -2645,25 +2727,35 @@
                 "issues": "https://github.com/laravel-zero/laravel-zero/issues",
                 "source": "https://github.com/laravel-zero/laravel-zero"
             },
-            "time": "2024-04-18T13:12:28+00:00"
+            "funding": [
+                {
+                    "url": "https://www.paypal.com/paypalme/enunomaduro",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/nunomaduro",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-12-02T16:33:43+00:00"
         },
         {
             "name": "laravel/prompts",
-            "version": "v0.1.25",
+            "version": "v0.3.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/prompts.git",
-                "reference": "7b4029a84c37cb2725fc7f011586e2997040bc95"
+                "reference": "57b8f7efe40333cdb925700891c7d7465325d3b1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/prompts/zipball/7b4029a84c37cb2725fc7f011586e2997040bc95",
-                "reference": "7b4029a84c37cb2725fc7f011586e2997040bc95",
+                "url": "https://api.github.com/repos/laravel/prompts/zipball/57b8f7efe40333cdb925700891c7d7465325d3b1",
+                "reference": "57b8f7efe40333cdb925700891c7d7465325d3b1",
                 "shasum": ""
             },
             "require": {
+                "composer-runtime-api": "^2.2",
                 "ext-mbstring": "*",
-                "illuminate/collections": "^10.0|^11.0",
                 "php": "^8.1",
                 "symfony/console": "^6.2|^7.0"
             },
@@ -2672,8 +2764,9 @@
                 "laravel/framework": ">=10.17.0 <10.25.0"
             },
             "require-dev": {
+                "illuminate/collections": "^10.0|^11.0|^12.0",
                 "mockery/mockery": "^1.5",
-                "pestphp/pest": "^2.3",
+                "pestphp/pest": "^2.3|^3.4",
                 "phpstan/phpstan": "^1.11",
                 "phpstan/phpstan-mockery": "^1.1"
             },
@@ -2683,7 +2776,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "0.1.x-dev"
+                    "dev-main": "0.3.x-dev"
                 }
             },
             "autoload": {
@@ -2701,22 +2794,22 @@
             "description": "Add beautiful and user-friendly forms to your command-line applications.",
             "support": {
                 "issues": "https://github.com/laravel/prompts/issues",
-                "source": "https://github.com/laravel/prompts/tree/v0.1.25"
+                "source": "https://github.com/laravel/prompts/tree/v0.3.5"
             },
-            "time": "2024-08-12T22:06:33+00:00"
+            "time": "2025-02-11T13:34:40+00:00"
         },
         {
             "name": "league/commonmark",
-            "version": "2.6.0",
+            "version": "2.6.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/commonmark.git",
-                "reference": "d150f911e0079e90ae3c106734c93137c184f932"
+                "reference": "d990688c91cedfb69753ffc2512727ec646df2ad"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/d150f911e0079e90ae3c106734c93137c184f932",
-                "reference": "d150f911e0079e90ae3c106734c93137c184f932",
+                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/d990688c91cedfb69753ffc2512727ec646df2ad",
+                "reference": "d990688c91cedfb69753ffc2512727ec646df2ad",
                 "shasum": ""
             },
             "require": {
@@ -2810,7 +2903,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-12-07T15:34:16+00:00"
+            "time": "2024-12-29T14:10:59+00:00"
         },
         {
             "name": "league/config",
@@ -3084,42 +3177,41 @@
         },
         {
             "name": "nesbot/carbon",
-            "version": "2.73.0",
+            "version": "3.8.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/CarbonPHP/carbon.git",
-                "reference": "9228ce90e1035ff2f0db84b40ec2e023ed802075"
+                "reference": "ff2f20cf83bd4d503720632ce8a426dc747bf7fd"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/9228ce90e1035ff2f0db84b40ec2e023ed802075",
-                "reference": "9228ce90e1035ff2f0db84b40ec2e023ed802075",
+                "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/ff2f20cf83bd4d503720632ce8a426dc747bf7fd",
+                "reference": "ff2f20cf83bd4d503720632ce8a426dc747bf7fd",
                 "shasum": ""
             },
             "require": {
-                "carbonphp/carbon-doctrine-types": "*",
+                "carbonphp/carbon-doctrine-types": "<100.0",
                 "ext-json": "*",
-                "php": "^7.1.8 || ^8.0",
+                "php": "^8.1",
                 "psr/clock": "^1.0",
+                "symfony/clock": "^6.3 || ^7.0",
                 "symfony/polyfill-mbstring": "^1.0",
-                "symfony/polyfill-php80": "^1.16",
-                "symfony/translation": "^3.4 || ^4.0 || ^5.0 || ^6.0"
+                "symfony/translation": "^4.4.18 || ^5.2.1|| ^6.0 || ^7.0"
             },
             "provide": {
                 "psr/clock-implementation": "1.0"
             },
             "require-dev": {
-                "doctrine/dbal": "^2.0 || ^3.1.4 || ^4.0",
-                "doctrine/orm": "^2.7 || ^3.0",
-                "friendsofphp/php-cs-fixer": "^3.0",
-                "kylekatarnls/multi-tester": "^2.0",
-                "ondrejmirtes/better-reflection": "<6",
-                "phpmd/phpmd": "^2.9",
-                "phpstan/extension-installer": "^1.0",
-                "phpstan/phpstan": "^0.12.99 || ^1.7.14",
-                "phpunit/php-file-iterator": "^2.0.5 || ^3.0.6",
-                "phpunit/phpunit": "^7.5.20 || ^8.5.26 || ^9.5.20",
-                "squizlabs/php_codesniffer": "^3.4"
+                "doctrine/dbal": "^3.6.3 || ^4.0",
+                "doctrine/orm": "^2.15.2 || ^3.0",
+                "friendsofphp/php-cs-fixer": "^3.57.2",
+                "kylekatarnls/multi-tester": "^2.5.3",
+                "ondrejmirtes/better-reflection": "^6.25.0.4",
+                "phpmd/phpmd": "^2.15.0",
+                "phpstan/extension-installer": "^1.3.1",
+                "phpstan/phpstan": "^1.11.2",
+                "phpunit/phpunit": "^10.5.20",
+                "squizlabs/php_codesniffer": "^3.9.0"
             },
             "bin": [
                 "bin/carbon"
@@ -3170,8 +3262,8 @@
             ],
             "support": {
                 "docs": "https://carbon.nesbot.com/docs",
-                "issues": "https://github.com/briannesbitt/Carbon/issues",
-                "source": "https://github.com/briannesbitt/Carbon"
+                "issues": "https://github.com/CarbonPHP/carbon/issues",
+                "source": "https://github.com/CarbonPHP/carbon"
             },
             "funding": [
                 {
@@ -3187,7 +3279,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-01-08T20:10:23+00:00"
+            "time": "2025-02-20T17:33:38+00:00"
         },
         {
             "name": "nette/schema",
@@ -3339,40 +3431,38 @@
         },
         {
             "name": "nunomaduro/collision",
-            "version": "v7.11.0",
+            "version": "v8.5.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/collision.git",
-                "reference": "994ea93df5d4132f69d3f1bd74730509df6e8a05"
+                "reference": "f5c101b929c958e849a633283adff296ed5f38f5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/collision/zipball/994ea93df5d4132f69d3f1bd74730509df6e8a05",
-                "reference": "994ea93df5d4132f69d3f1bd74730509df6e8a05",
+                "url": "https://api.github.com/repos/nunomaduro/collision/zipball/f5c101b929c958e849a633283adff296ed5f38f5",
+                "reference": "f5c101b929c958e849a633283adff296ed5f38f5",
                 "shasum": ""
             },
             "require": {
                 "filp/whoops": "^2.16.0",
-                "nunomaduro/termwind": "^1.15.1",
-                "php": "^8.1.0",
-                "symfony/console": "^6.4.12"
+                "nunomaduro/termwind": "^2.1.0",
+                "php": "^8.2.0",
+                "symfony/console": "^7.1.5"
             },
             "conflict": {
-                "laravel/framework": ">=11.0.0"
+                "laravel/framework": "<11.0.0 || >=12.0.0",
+                "phpunit/phpunit": "<10.5.1 || >=12.0.0"
             },
             "require-dev": {
-                "brianium/paratest": "^7.3.1",
-                "laravel/framework": "^10.48.22",
+                "larastan/larastan": "^2.9.8",
+                "laravel/framework": "^11.28.0",
                 "laravel/pint": "^1.18.1",
                 "laravel/sail": "^1.36.0",
-                "laravel/sanctum": "^3.3.3",
+                "laravel/sanctum": "^4.0.3",
                 "laravel/tinker": "^2.10.0",
-                "nunomaduro/larastan": "^2.9.8",
-                "orchestra/testbench-core": "^8.28.3",
-                "pestphp/pest": "^2.35.1",
-                "phpunit/phpunit": "^10.5.36",
-                "sebastian/environment": "^6.1.0",
-                "spatie/laravel-ignition": "^2.8.0"
+                "orchestra/testbench-core": "^9.5.3",
+                "pestphp/pest": "^2.36.0 || ^3.4.0",
+                "sebastian/environment": "^6.1.0 || ^7.2.0"
             },
             "type": "library",
             "extra": {
@@ -3380,6 +3470,9 @@
                     "providers": [
                         "NunoMaduro\\Collision\\Adapters\\Laravel\\CollisionServiceProvider"
                     ]
+                },
+                "branch-alias": {
+                    "dev-8.x": "8.x-dev"
                 }
             },
             "autoload": {
@@ -3431,29 +3524,29 @@
                     "type": "patreon"
                 }
             ],
-            "time": "2024-10-15T15:12:40+00:00"
+            "time": "2024-10-15T16:06:32+00:00"
         },
         {
             "name": "nunomaduro/laravel-console-summary",
-            "version": "v1.11.1",
+            "version": "v1.13.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/laravel-console-summary.git",
-                "reference": "2e3cf7b261697eed3fdf87a66be4470d32b405bd"
+                "reference": "8fe07f5ecbedca8544edc54f397538dc0b49d7f9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/laravel-console-summary/zipball/2e3cf7b261697eed3fdf87a66be4470d32b405bd",
-                "reference": "2e3cf7b261697eed3fdf87a66be4470d32b405bd",
+                "url": "https://api.github.com/repos/nunomaduro/laravel-console-summary/zipball/8fe07f5ecbedca8544edc54f397538dc0b49d7f9",
+                "reference": "8fe07f5ecbedca8544edc54f397538dc0b49d7f9",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^9.0|^10.0|^11.0",
-                "illuminate/support": "^9.0|^10.0|^11.0",
-                "php": "^8.1"
+                "illuminate/console": "^11.4|^12.0",
+                "illuminate/support": "^11.4|^12.0",
+                "php": "^8.2"
             },
             "require-dev": {
-                "laravel/pint": "^1.4"
+                "laravel/pint": "^1.21"
             },
             "type": "library",
             "extra": {
@@ -3493,29 +3586,29 @@
                 "issues": "https://github.com/nunomaduro/laravel-console-summary/issues",
                 "source": "https://github.com/nunomaduro/laravel-console-summary"
             },
-            "time": "2024-04-09T08:41:54+00:00"
+            "time": "2025-02-19T11:10:44+00:00"
         },
         {
             "name": "nunomaduro/laravel-console-task",
-            "version": "v1.9.0",
+            "version": "v1.10.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/laravel-console-task.git",
-                "reference": "02b2a550318fda3355e45763885e30b4e650bc1b"
+                "reference": "9d11073ad8b0215c63a962250e2bf071611f975d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/laravel-console-task/zipball/02b2a550318fda3355e45763885e30b4e650bc1b",
-                "reference": "02b2a550318fda3355e45763885e30b4e650bc1b",
+                "url": "https://api.github.com/repos/nunomaduro/laravel-console-task/zipball/9d11073ad8b0215c63a962250e2bf071611f975d",
+                "reference": "9d11073ad8b0215c63a962250e2bf071611f975d",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^10.0|^11.0",
-                "illuminate/support": "^10.0|^11.0",
-                "php": "^8.1"
+                "illuminate/console": "^10.0|^11.0|^12.0",
+                "illuminate/support": "^10.0|^11.0|^12.0",
+                "php": "^8.2"
             },
             "require-dev": {
-                "pestphp/pest": "^2.34"
+                "pestphp/pest": "^3.7"
             },
             "type": "library",
             "extra": {
@@ -3555,41 +3648,41 @@
                 "issues": "https://github.com/nunomaduro/laravel-console-task/issues",
                 "source": "https://github.com/nunomaduro/laravel-console-task"
             },
-            "time": "2024-04-11T07:51:10+00:00"
+            "time": "2025-02-19T11:02:37+00:00"
         },
         {
             "name": "nunomaduro/laravel-desktop-notifier",
-            "version": "v2.8.1",
+            "version": "v2.9.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/laravel-desktop-notifier.git",
-                "reference": "9937f1f8898077ad6d058c03ecee39d6eae7eb39"
+                "reference": "4871ee90fff38fbe25a2b8f81b5daeedf98a3ed7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/laravel-desktop-notifier/zipball/9937f1f8898077ad6d058c03ecee39d6eae7eb39",
-                "reference": "9937f1f8898077ad6d058c03ecee39d6eae7eb39",
+                "url": "https://api.github.com/repos/nunomaduro/laravel-desktop-notifier/zipball/4871ee90fff38fbe25a2b8f81b5daeedf98a3ed7",
+                "reference": "4871ee90fff38fbe25a2b8f81b5daeedf98a3ed7",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^10.0|^11.0",
-                "illuminate/support": "^10.0|^11.0",
+                "illuminate/console": "^10.0|^11.0|^12.0",
+                "illuminate/support": "^10.0|^11.0|^12.0",
                 "jolicode/jolinotif": "^2.5",
-                "php": "^8.1"
+                "php": "^8.2"
             },
             "require-dev": {
-                "graham-campbell/testbench": "^5.7|^6.1",
-                "pestphp/pest": "^2.34"
+                "graham-campbell/testbench": "^5.7|^6.2",
+                "pestphp/pest": "^3.7"
             },
             "type": "library",
             "extra": {
                 "laravel": {
-                    "providers": [
-                        "NunoMaduro\\LaravelDesktopNotifier\\LaravelDesktopNotifierServiceProvider"
-                    ],
                     "aliases": {
                         "Notifier": "NunoMaduro\\LaravelDesktopNotifier\\Facaces\\Notifier"
-                    }
+                    },
+                    "providers": [
+                        "NunoMaduro\\LaravelDesktopNotifier\\LaravelDesktopNotifierServiceProvider"
+                    ]
                 }
             },
             "autoload": {
@@ -3623,38 +3716,37 @@
             ],
             "support": {
                 "issues": "https://github.com/nunomaduro/laravel-desktop-notifier/issues",
-                "source": "https://github.com/nunomaduro/laravel-desktop-notifier/tree/v2.8.1"
+                "source": "https://github.com/nunomaduro/laravel-desktop-notifier/tree/v2.9.0"
             },
-            "time": "2024-04-06T06:39:11+00:00"
+            "time": "2025-02-19T11:22:09+00:00"
         },
         {
             "name": "nunomaduro/termwind",
-            "version": "v1.17.0",
+            "version": "v2.3.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/termwind.git",
-                "reference": "5369ef84d8142c1d87e4ec278711d4ece3cbf301"
+                "reference": "52915afe6a1044e8b9cee1bcff836fb63acf9cda"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/5369ef84d8142c1d87e4ec278711d4ece3cbf301",
-                "reference": "5369ef84d8142c1d87e4ec278711d4ece3cbf301",
+                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/52915afe6a1044e8b9cee1bcff836fb63acf9cda",
+                "reference": "52915afe6a1044e8b9cee1bcff836fb63acf9cda",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
-                "php": "^8.1",
-                "symfony/console": "^6.4.15"
+                "php": "^8.2",
+                "symfony/console": "^7.1.8"
             },
             "require-dev": {
-                "illuminate/console": "^10.48.24",
-                "illuminate/support": "^10.48.24",
+                "illuminate/console": "^11.33.2",
                 "laravel/pint": "^1.18.2",
+                "mockery/mockery": "^1.6.12",
                 "pestphp/pest": "^2.36.0",
-                "pestphp/pest-plugin-mock": "2.0.0",
                 "phpstan/phpstan": "^1.12.11",
                 "phpstan/phpstan-strict-rules": "^1.6.1",
-                "symfony/var-dumper": "^6.4.15",
+                "symfony/var-dumper": "^7.1.8",
                 "thecodingmachine/phpstan-strict-rules": "^1.0.0"
             },
             "type": "library",
@@ -3663,6 +3755,9 @@
                     "providers": [
                         "Termwind\\Laravel\\TermwindServiceProvider"
                     ]
+                },
+                "branch-alias": {
+                    "dev-2.x": "2.x-dev"
                 }
             },
             "autoload": {
@@ -3694,7 +3789,7 @@
             ],
             "support": {
                 "issues": "https://github.com/nunomaduro/termwind/issues",
-                "source": "https://github.com/nunomaduro/termwind/tree/v1.17.0"
+                "source": "https://github.com/nunomaduro/termwind/tree/v2.3.0"
             },
             "funding": [
                 {
@@ -3710,7 +3805,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-11-21T10:36:35+00:00"
+            "time": "2024-11-21T10:39:51+00:00"
         },
         {
             "name": "phpoption/phpoption",
@@ -4245,16 +4340,16 @@
         },
         {
             "name": "ramsey/collection",
-            "version": "2.0.0",
+            "version": "2.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/ramsey/collection.git",
-                "reference": "a4b48764bfbb8f3a6a4d1aeb1a35bb5e9ecac4a5"
+                "reference": "344572933ad0181accbf4ba763e85a0306a8c5e2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/ramsey/collection/zipball/a4b48764bfbb8f3a6a4d1aeb1a35bb5e9ecac4a5",
-                "reference": "a4b48764bfbb8f3a6a4d1aeb1a35bb5e9ecac4a5",
+                "url": "https://api.github.com/repos/ramsey/collection/zipball/344572933ad0181accbf4ba763e85a0306a8c5e2",
+                "reference": "344572933ad0181accbf4ba763e85a0306a8c5e2",
                 "shasum": ""
             },
             "require": {
@@ -4262,25 +4357,22 @@
             },
             "require-dev": {
                 "captainhook/plugin-composer": "^5.3",
-                "ergebnis/composer-normalize": "^2.28.3",
-                "fakerphp/faker": "^1.21",
+                "ergebnis/composer-normalize": "^2.45",
+                "fakerphp/faker": "^1.24",
                 "hamcrest/hamcrest-php": "^2.0",
-                "jangregor/phpstan-prophecy": "^1.0",
-                "mockery/mockery": "^1.5",
+                "jangregor/phpstan-prophecy": "^2.1",
+                "mockery/mockery": "^1.6",
                 "php-parallel-lint/php-console-highlighter": "^1.0",
-                "php-parallel-lint/php-parallel-lint": "^1.3",
-                "phpcsstandards/phpcsutils": "^1.0.0-rc1",
-                "phpspec/prophecy-phpunit": "^2.0",
-                "phpstan/extension-installer": "^1.2",
-                "phpstan/phpstan": "^1.9",
-                "phpstan/phpstan-mockery": "^1.1",
-                "phpstan/phpstan-phpunit": "^1.3",
-                "phpunit/phpunit": "^9.5",
-                "psalm/plugin-mockery": "^1.1",
-                "psalm/plugin-phpunit": "^0.18.4",
-                "ramsey/coding-standard": "^2.0.3",
-                "ramsey/conventional-commits": "^1.3",
-                "vimeo/psalm": "^5.4"
+                "php-parallel-lint/php-parallel-lint": "^1.4",
+                "phpspec/prophecy-phpunit": "^2.3",
+                "phpstan/extension-installer": "^1.4",
+                "phpstan/phpstan": "^2.1",
+                "phpstan/phpstan-mockery": "^2.0",
+                "phpstan/phpstan-phpunit": "^2.0",
+                "phpunit/phpunit": "^10.5",
+                "ramsey/coding-standard": "^2.3",
+                "ramsey/conventional-commits": "^1.6",
+                "roave/security-advisories": "dev-latest"
             },
             "type": "library",
             "extra": {
@@ -4318,19 +4410,9 @@
             ],
             "support": {
                 "issues": "https://github.com/ramsey/collection/issues",
-                "source": "https://github.com/ramsey/collection/tree/2.0.0"
+                "source": "https://github.com/ramsey/collection/tree/2.1.1"
             },
-            "funding": [
-                {
-                    "url": "https://github.com/ramsey",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/ramsey/collection",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2022-12-31T21:50:55+00:00"
+            "time": "2025-03-22T05:38:12+00:00"
         },
         {
             "name": "ramsey/uuid",
@@ -4426,21 +4508,21 @@
         },
         {
             "name": "spatie/yaml-front-matter",
-            "version": "2.0.9",
+            "version": "2.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/spatie/yaml-front-matter.git",
-                "reference": "cbe67e1cdd0a29a96d74ccab9400fe663e078392"
+                "reference": "5d0009289dd19a23e5f6cbb72c959a9fc1881e32"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/spatie/yaml-front-matter/zipball/cbe67e1cdd0a29a96d74ccab9400fe663e078392",
-                "reference": "cbe67e1cdd0a29a96d74ccab9400fe663e078392",
+                "url": "https://api.github.com/repos/spatie/yaml-front-matter/zipball/5d0009289dd19a23e5f6cbb72c959a9fc1881e32",
+                "reference": "5d0009289dd19a23e5f6cbb72c959a9fc1881e32",
                 "shasum": ""
             },
             "require": {
-                "php": "^7.0|^8.0",
-                "symfony/yaml": "^3.0|^4.0|^5.0|^6.0|^7.0"
+                "php": "^8.0",
+                "symfony/yaml": "^6.0|^7.0"
             },
             "require-dev": {
                 "phpunit/phpunit": "^9.0"
@@ -4472,7 +4554,7 @@
                 "yaml"
             ],
             "support": {
-                "source": "https://github.com/spatie/yaml-front-matter/tree/2.0.9"
+                "source": "https://github.com/spatie/yaml-front-matter/tree/2.1.0"
             },
             "funding": [
                 {
@@ -4484,51 +4566,124 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-06-13T10:20:51+00:00"
+            "time": "2024-12-02T08:40:45+00:00"
+        },
+        {
+            "name": "symfony/clock",
+            "version": "v7.2.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/clock.git",
+                "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/clock/zipball/b81435fbd6648ea425d1ee96a2d8e68f4ceacd24",
+                "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=8.2",
+                "psr/clock": "^1.0",
+                "symfony/polyfill-php83": "^1.28"
+            },
+            "provide": {
+                "psr/clock-implementation": "1.0"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "Resources/now.php"
+                ],
+                "psr-4": {
+                    "Symfony\\Component\\Clock\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Decouples applications from the system clock",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "clock",
+                "psr20",
+                "time"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/clock/tree/v7.2.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2024-09-25T14:21:43+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v6.4.17",
+            "version": "v7.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "799445db3f15768ecc382ac5699e6da0520a0a04"
+                "reference": "fefcc18c0f5d0efe3ab3152f15857298868dc2c3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/799445db3f15768ecc382ac5699e6da0520a0a04",
-                "reference": "799445db3f15768ecc382ac5699e6da0520a0a04",
+                "url": "https://api.github.com/repos/symfony/console/zipball/fefcc18c0f5d0efe3ab3152f15857298868dc2c3",
+                "reference": "fefcc18c0f5d0efe3ab3152f15857298868dc2c3",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.2",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/string": "^5.4|^6.0|^7.0"
+                "symfony/string": "^6.4|^7.0"
             },
             "conflict": {
-                "symfony/dependency-injection": "<5.4",
-                "symfony/dotenv": "<5.4",
-                "symfony/event-dispatcher": "<5.4",
-                "symfony/lock": "<5.4",
-                "symfony/process": "<5.4"
+                "symfony/dependency-injection": "<6.4",
+                "symfony/dotenv": "<6.4",
+                "symfony/event-dispatcher": "<6.4",
+                "symfony/lock": "<6.4",
+                "symfony/process": "<6.4"
             },
             "provide": {
                 "psr/log-implementation": "1.0|2.0|3.0"
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^5.4|^6.0|^7.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/event-dispatcher": "^5.4|^6.0|^7.0",
+                "symfony/config": "^6.4|^7.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/event-dispatcher": "^6.4|^7.0",
                 "symfony/http-foundation": "^6.4|^7.0",
                 "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/lock": "^5.4|^6.0|^7.0",
-                "symfony/messenger": "^5.4|^6.0|^7.0",
-                "symfony/process": "^5.4|^6.0|^7.0",
-                "symfony/stopwatch": "^5.4|^6.0|^7.0",
-                "symfony/var-dumper": "^5.4|^6.0|^7.0"
+                "symfony/lock": "^6.4|^7.0",
+                "symfony/messenger": "^6.4|^7.0",
+                "symfony/process": "^6.4|^7.0",
+                "symfony/stopwatch": "^6.4|^7.0",
+                "symfony/var-dumper": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -4562,7 +4717,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v6.4.17"
+                "source": "https://github.com/symfony/console/tree/v7.2.1"
             },
             "funding": [
                 {
@@ -4578,7 +4733,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-12-07T12:07:30+00:00"
+            "time": "2024-12-11T03:49:26+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
@@ -4649,22 +4804,22 @@
         },
         {
             "name": "symfony/error-handler",
-            "version": "v6.4.14",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/error-handler.git",
-                "reference": "9e024324511eeb00983ee76b9aedc3e6ecd993d9"
+                "reference": "aabf79938aa795350c07ce6464dd1985607d95d5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/error-handler/zipball/9e024324511eeb00983ee76b9aedc3e6ecd993d9",
-                "reference": "9e024324511eeb00983ee76b9aedc3e6ecd993d9",
+                "url": "https://api.github.com/repos/symfony/error-handler/zipball/aabf79938aa795350c07ce6464dd1985607d95d5",
+                "reference": "aabf79938aa795350c07ce6464dd1985607d95d5",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "psr/log": "^1|^2|^3",
-                "symfony/var-dumper": "^5.4|^6.0|^7.0"
+                "symfony/var-dumper": "^6.4|^7.0"
             },
             "conflict": {
                 "symfony/deprecation-contracts": "<2.5",
@@ -4673,7 +4828,7 @@
             "require-dev": {
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/serializer": "^5.4|^6.0|^7.0"
+                "symfony/serializer": "^6.4|^7.0"
             },
             "bin": [
                 "Resources/bin/patch-type-declarations"
@@ -4704,7 +4859,7 @@
             "description": "Provides tools to manage errors and ease debugging PHP code",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/error-handler/tree/v6.4.14"
+                "source": "https://github.com/symfony/error-handler/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -4720,28 +4875,28 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-05T15:34:40+00:00"
+            "time": "2025-02-02T20:27:07+00:00"
         },
         {
             "name": "symfony/event-dispatcher",
-            "version": "v6.4.13",
+            "version": "v7.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/event-dispatcher.git",
-                "reference": "0ffc48080ab3e9132ea74ef4e09d8dcf26bf897e"
+                "reference": "910c5db85a5356d0fea57680defec4e99eb9c8c1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/0ffc48080ab3e9132ea74ef4e09d8dcf26bf897e",
-                "reference": "0ffc48080ab3e9132ea74ef4e09d8dcf26bf897e",
+                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/910c5db85a5356d0fea57680defec4e99eb9c8c1",
+                "reference": "910c5db85a5356d0fea57680defec4e99eb9c8c1",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/event-dispatcher-contracts": "^2.5|^3"
             },
             "conflict": {
-                "symfony/dependency-injection": "<5.4",
+                "symfony/dependency-injection": "<6.4",
                 "symfony/service-contracts": "<2.5"
             },
             "provide": {
@@ -4750,13 +4905,13 @@
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^5.4|^6.0|^7.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/error-handler": "^5.4|^6.0|^7.0",
-                "symfony/expression-language": "^5.4|^6.0|^7.0",
-                "symfony/http-foundation": "^5.4|^6.0|^7.0",
+                "symfony/config": "^6.4|^7.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/error-handler": "^6.4|^7.0",
+                "symfony/expression-language": "^6.4|^7.0",
+                "symfony/http-foundation": "^6.4|^7.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/stopwatch": "^5.4|^6.0|^7.0"
+                "symfony/stopwatch": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -4784,7 +4939,7 @@
             "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/event-dispatcher/tree/v6.4.13"
+                "source": "https://github.com/symfony/event-dispatcher/tree/v7.2.0"
             },
             "funding": [
                 {
@@ -4800,7 +4955,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:18:03+00:00"
+            "time": "2024-09-25T14:21:43+00:00"
         },
         {
             "name": "symfony/event-dispatcher-contracts",
@@ -4880,23 +5035,23 @@
         },
         {
             "name": "symfony/finder",
-            "version": "v6.4.17",
+            "version": "v7.2.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7"
+                "reference": "87a71856f2f56e4100373e92529eed3171695cfb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
-                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/87a71856f2f56e4100373e92529eed3171695cfb",
+                "reference": "87a71856f2f56e4100373e92529eed3171695cfb",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1"
+                "php": ">=8.2"
             },
             "require-dev": {
-                "symfony/filesystem": "^6.0|^7.0"
+                "symfony/filesystem": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -4924,7 +5079,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v6.4.17"
+                "source": "https://github.com/symfony/finder/tree/v7.2.2"
             },
             "funding": [
                 {
@@ -4940,40 +5095,41 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-12-29T13:51:37+00:00"
+            "time": "2024-12-30T19:00:17+00:00"
         },
         {
             "name": "symfony/http-foundation",
-            "version": "v6.4.14",
+            "version": "v7.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-foundation.git",
-                "reference": "ba020a321a95519303a3f09ec2824d34d601c388"
+                "reference": "ee1b504b8926198be89d05e5b6fc4c3810c090f0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/ba020a321a95519303a3f09ec2824d34d601c388",
-                "reference": "ba020a321a95519303a3f09ec2824d34d601c388",
+                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/ee1b504b8926198be89d05e5b6fc4c3810c090f0",
+                "reference": "ee1b504b8926198be89d05e5b6fc4c3810c090f0",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.2",
+                "symfony/deprecation-contracts": "^2.5|^3.0",
                 "symfony/polyfill-mbstring": "~1.1",
                 "symfony/polyfill-php83": "^1.27"
             },
             "conflict": {
-                "symfony/cache": "<6.3"
+                "doctrine/dbal": "<3.6",
+                "symfony/cache": "<6.4.12|>=7.0,<7.1.5"
             },
             "require-dev": {
-                "doctrine/dbal": "^2.13.1|^3|^4",
+                "doctrine/dbal": "^3.6|^4",
                 "predis/predis": "^1.1|^2.0",
-                "symfony/cache": "^6.3|^7.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/expression-language": "^5.4|^6.0|^7.0",
-                "symfony/http-kernel": "^5.4.12|^6.0.12|^6.1.4|^7.0",
-                "symfony/mime": "^5.4|^6.0|^7.0",
-                "symfony/rate-limiter": "^5.4|^6.0|^7.0"
+                "symfony/cache": "^6.4.12|^7.1.5",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/expression-language": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0",
+                "symfony/mime": "^6.4|^7.0",
+                "symfony/rate-limiter": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -5001,7 +5157,7 @@
             "description": "Defines an object-oriented layer for the HTTP specification",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-foundation/tree/v6.4.14"
+                "source": "https://github.com/symfony/http-foundation/tree/v7.2.3"
             },
             "funding": [
                 {
@@ -5017,77 +5173,77 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-05T16:39:55+00:00"
+            "time": "2025-01-17T10:56:55+00:00"
         },
         {
             "name": "symfony/http-kernel",
-            "version": "v6.4.14",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-kernel.git",
-                "reference": "8278a947d0369754a47b758a9e17b72cab970951"
+                "reference": "9f1103734c5789798fefb90e91de4586039003ed"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/8278a947d0369754a47b758a9e17b72cab970951",
-                "reference": "8278a947d0369754a47b758a9e17b72cab970951",
+                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/9f1103734c5789798fefb90e91de4586039003ed",
+                "reference": "9f1103734c5789798fefb90e91de4586039003ed",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "psr/log": "^1|^2|^3",
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/error-handler": "^6.4|^7.0",
-                "symfony/event-dispatcher": "^5.4|^6.0|^7.0",
+                "symfony/event-dispatcher": "^6.4|^7.0",
                 "symfony/http-foundation": "^6.4|^7.0",
                 "symfony/polyfill-ctype": "^1.8"
             },
             "conflict": {
-                "symfony/browser-kit": "<5.4",
-                "symfony/cache": "<5.4",
-                "symfony/config": "<6.1",
-                "symfony/console": "<5.4",
+                "symfony/browser-kit": "<6.4",
+                "symfony/cache": "<6.4",
+                "symfony/config": "<6.4",
+                "symfony/console": "<6.4",
                 "symfony/dependency-injection": "<6.4",
-                "symfony/doctrine-bridge": "<5.4",
-                "symfony/form": "<5.4",
-                "symfony/http-client": "<5.4",
+                "symfony/doctrine-bridge": "<6.4",
+                "symfony/form": "<6.4",
+                "symfony/http-client": "<6.4",
                 "symfony/http-client-contracts": "<2.5",
-                "symfony/mailer": "<5.4",
-                "symfony/messenger": "<5.4",
-                "symfony/translation": "<5.4",
+                "symfony/mailer": "<6.4",
+                "symfony/messenger": "<6.4",
+                "symfony/translation": "<6.4",
                 "symfony/translation-contracts": "<2.5",
-                "symfony/twig-bridge": "<5.4",
+                "symfony/twig-bridge": "<6.4",
                 "symfony/validator": "<6.4",
-                "symfony/var-dumper": "<6.3",
-                "twig/twig": "<2.13"
+                "symfony/var-dumper": "<6.4",
+                "twig/twig": "<3.12"
             },
             "provide": {
                 "psr/log-implementation": "1.0|2.0|3.0"
             },
             "require-dev": {
                 "psr/cache": "^1.0|^2.0|^3.0",
-                "symfony/browser-kit": "^5.4|^6.0|^7.0",
-                "symfony/clock": "^6.2|^7.0",
-                "symfony/config": "^6.1|^7.0",
-                "symfony/console": "^5.4|^6.0|^7.0",
-                "symfony/css-selector": "^5.4|^6.0|^7.0",
+                "symfony/browser-kit": "^6.4|^7.0",
+                "symfony/clock": "^6.4|^7.0",
+                "symfony/config": "^6.4|^7.0",
+                "symfony/console": "^6.4|^7.0",
+                "symfony/css-selector": "^6.4|^7.0",
                 "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/dom-crawler": "^5.4|^6.0|^7.0",
-                "symfony/expression-language": "^5.4|^6.0|^7.0",
-                "symfony/finder": "^5.4|^6.0|^7.0",
+                "symfony/dom-crawler": "^6.4|^7.0",
+                "symfony/expression-language": "^6.4|^7.0",
+                "symfony/finder": "^6.4|^7.0",
                 "symfony/http-client-contracts": "^2.5|^3",
-                "symfony/process": "^5.4|^6.0|^7.0",
-                "symfony/property-access": "^5.4.5|^6.0.5|^7.0",
-                "symfony/routing": "^5.4|^6.0|^7.0",
-                "symfony/serializer": "^6.4.4|^7.0.4",
-                "symfony/stopwatch": "^5.4|^6.0|^7.0",
-                "symfony/translation": "^5.4|^6.0|^7.0",
+                "symfony/process": "^6.4|^7.0",
+                "symfony/property-access": "^7.1",
+                "symfony/routing": "^6.4|^7.0",
+                "symfony/serializer": "^7.1",
+                "symfony/stopwatch": "^6.4|^7.0",
+                "symfony/translation": "^6.4|^7.0",
                 "symfony/translation-contracts": "^2.5|^3",
-                "symfony/uid": "^5.4|^6.0|^7.0",
+                "symfony/uid": "^6.4|^7.0",
                 "symfony/validator": "^6.4|^7.0",
-                "symfony/var-dumper": "^5.4|^6.4|^7.0",
-                "symfony/var-exporter": "^6.2|^7.0",
-                "twig/twig": "^2.13|^3.0.4"
+                "symfony/var-dumper": "^6.4|^7.0",
+                "symfony/var-exporter": "^6.4|^7.0",
+                "twig/twig": "^3.12"
             },
             "type": "library",
             "autoload": {
@@ -5115,7 +5271,7 @@
             "description": "Provides a structured process for converting a Request into a Response",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-kernel/tree/v6.4.14"
+                "source": "https://github.com/symfony/http-kernel/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -5131,25 +5287,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-06T09:45:21+00:00"
+            "time": "2025-02-26T11:01:22+00:00"
         },
         {
             "name": "symfony/mime",
-            "version": "v6.4.13",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/mime.git",
-                "reference": "1de1cf14d99b12c7ebbb850491ec6ae3ed468855"
+                "reference": "87ca22046b78c3feaff04b337f33b38510fd686b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/mime/zipball/1de1cf14d99b12c7ebbb850491ec6ae3ed468855",
-                "reference": "1de1cf14d99b12c7ebbb850491ec6ae3ed468855",
+                "url": "https://api.github.com/repos/symfony/mime/zipball/87ca22046b78c3feaff04b337f33b38510fd686b",
+                "reference": "87ca22046b78c3feaff04b337f33b38510fd686b",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.2",
                 "symfony/polyfill-intl-idn": "^1.10",
                 "symfony/polyfill-mbstring": "^1.0"
             },
@@ -5157,17 +5312,17 @@
                 "egulias/email-validator": "~3.0.0",
                 "phpdocumentor/reflection-docblock": "<3.2.2",
                 "phpdocumentor/type-resolver": "<1.4.0",
-                "symfony/mailer": "<5.4",
+                "symfony/mailer": "<6.4",
                 "symfony/serializer": "<6.4.3|>7.0,<7.0.3"
             },
             "require-dev": {
                 "egulias/email-validator": "^2.1.10|^3.1|^4",
                 "league/html-to-markdown": "^5.0",
                 "phpdocumentor/reflection-docblock": "^3.0|^4.0|^5.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/process": "^5.4|^6.4|^7.0",
-                "symfony/property-access": "^5.4|^6.0|^7.0",
-                "symfony/property-info": "^5.4|^6.0|^7.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/process": "^6.4|^7.0",
+                "symfony/property-access": "^6.4|^7.0",
+                "symfony/property-info": "^6.4|^7.0",
                 "symfony/serializer": "^6.4.3|^7.0.3"
             },
             "type": "library",
@@ -5200,7 +5355,7 @@
                 "mime-type"
             ],
             "support": {
-                "source": "https://github.com/symfony/mime/tree/v6.4.13"
+                "source": "https://github.com/symfony/mime/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -5216,7 +5371,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-10-25T15:07:50+00:00"
+            "time": "2025-02-19T08:51:20+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
@@ -5399,8 +5554,8 @@
             "type": "library",
             "extra": {
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
                 }
             },
             "autoload": {
@@ -5697,20 +5852,20 @@
         },
         {
             "name": "symfony/process",
-            "version": "v6.4.19",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3"
+                "reference": "d8f411ff3c7ddc4ae9166fb388d1190a2df5b5cf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3",
-                "reference": "7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3",
+                "url": "https://api.github.com/repos/symfony/process/zipball/d8f411ff3c7ddc4ae9166fb388d1190a2df5b5cf",
+                "reference": "d8f411ff3c7ddc4ae9166fb388d1190a2df5b5cf",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1"
+                "php": ">=8.2"
             },
             "type": "library",
             "autoload": {
@@ -5738,7 +5893,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v6.4.19"
+                "source": "https://github.com/symfony/process/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -5754,7 +5909,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-02-04T13:35:48+00:00"
+            "time": "2025-02-05T08:33:46+00:00"
         },
         {
             "name": "symfony/service-contracts",
@@ -5927,33 +6082,33 @@
         },
         {
             "name": "symfony/translation",
-            "version": "v6.4.19",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation.git",
-                "reference": "3b9bf9f33997c064885a7bfc126c14b9daa0e00e"
+                "reference": "283856e6981286cc0d800b53bd5703e8e363f05a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation/zipball/3b9bf9f33997c064885a7bfc126c14b9daa0e00e",
-                "reference": "3b9bf9f33997c064885a7bfc126c14b9daa0e00e",
+                "url": "https://api.github.com/repos/symfony/translation/zipball/283856e6981286cc0d800b53bd5703e8e363f05a",
+                "reference": "283856e6981286cc0d800b53bd5703e8e363f05a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/translation-contracts": "^2.5|^3.0"
             },
             "conflict": {
-                "symfony/config": "<5.4",
-                "symfony/console": "<5.4",
-                "symfony/dependency-injection": "<5.4",
+                "symfony/config": "<6.4",
+                "symfony/console": "<6.4",
+                "symfony/dependency-injection": "<6.4",
                 "symfony/http-client-contracts": "<2.5",
-                "symfony/http-kernel": "<5.4",
+                "symfony/http-kernel": "<6.4",
                 "symfony/service-contracts": "<2.5",
-                "symfony/twig-bundle": "<5.4",
-                "symfony/yaml": "<5.4"
+                "symfony/twig-bundle": "<6.4",
+                "symfony/yaml": "<6.4"
             },
             "provide": {
                 "symfony/translation-implementation": "2.3|3.0"
@@ -5961,17 +6116,17 @@
             "require-dev": {
                 "nikic/php-parser": "^4.18|^5.0",
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^5.4|^6.0|^7.0",
-                "symfony/console": "^5.4|^6.0|^7.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/finder": "^5.4|^6.0|^7.0",
+                "symfony/config": "^6.4|^7.0",
+                "symfony/console": "^6.4|^7.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/finder": "^6.4|^7.0",
                 "symfony/http-client-contracts": "^2.5|^3.0",
-                "symfony/http-kernel": "^5.4|^6.0|^7.0",
-                "symfony/intl": "^5.4|^6.0|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0",
+                "symfony/intl": "^6.4|^7.0",
                 "symfony/polyfill-intl-icu": "^1.21",
-                "symfony/routing": "^5.4|^6.0|^7.0",
+                "symfony/routing": "^6.4|^7.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/yaml": "^5.4|^6.0|^7.0"
+                "symfony/yaml": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -6002,7 +6157,7 @@
             "description": "Provides tools to internationalize your application",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/translation/tree/v6.4.19"
+                "source": "https://github.com/symfony/translation/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -6018,7 +6173,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-02-13T10:18:43+00:00"
+            "time": "2025-02-13T10:27:23+00:00"
         },
         {
             "name": "symfony/translation-contracts",
@@ -6100,34 +6255,32 @@
         },
         {
             "name": "symfony/var-dumper",
-            "version": "v6.4.18",
+            "version": "v7.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/var-dumper.git",
-                "reference": "4ad10cf8b020e77ba665305bb7804389884b4837"
+                "reference": "82b478c69745d8878eb60f9a049a4d584996f73a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/4ad10cf8b020e77ba665305bb7804389884b4837",
-                "reference": "4ad10cf8b020e77ba665305bb7804389884b4837",
+                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/82b478c69745d8878eb60f9a049a4d584996f73a",
+                "reference": "82b478c69745d8878eb60f9a049a4d584996f73a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.2",
                 "symfony/polyfill-mbstring": "~1.0"
             },
             "conflict": {
-                "symfony/console": "<5.4"
+                "symfony/console": "<6.4"
             },
             "require-dev": {
                 "ext-iconv": "*",
-                "symfony/console": "^5.4|^6.0|^7.0",
-                "symfony/error-handler": "^6.3|^7.0",
-                "symfony/http-kernel": "^5.4|^6.0|^7.0",
-                "symfony/process": "^5.4|^6.0|^7.0",
-                "symfony/uid": "^5.4|^6.0|^7.0",
-                "twig/twig": "^2.13|^3.0.4"
+                "symfony/console": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0",
+                "symfony/process": "^6.4|^7.0",
+                "symfony/uid": "^6.4|^7.0",
+                "twig/twig": "^3.12"
             },
             "bin": [
                 "Resources/bin/var-dump-server"
@@ -6165,7 +6318,7 @@
                 "dump"
             ],
             "support": {
-                "source": "https://github.com/symfony/var-dumper/tree/v6.4.18"
+                "source": "https://github.com/symfony/var-dumper/tree/v7.2.3"
             },
             "funding": [
                 {
@@ -6181,32 +6334,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-01-17T11:26:11+00:00"
+            "time": "2025-01-17T11:39:41+00:00"
         },
         {
             "name": "symfony/yaml",
-            "version": "v6.4.13",
+            "version": "v7.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/yaml.git",
-                "reference": "e99b4e94d124b29ee4cf3140e1b537d2dad8cec9"
+                "reference": "ac238f173df0c9c1120f862d0f599e17535a87ec"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/yaml/zipball/e99b4e94d124b29ee4cf3140e1b537d2dad8cec9",
-                "reference": "e99b4e94d124b29ee4cf3140e1b537d2dad8cec9",
+                "url": "https://api.github.com/repos/symfony/yaml/zipball/ac238f173df0c9c1120f862d0f599e17535a87ec",
+                "reference": "ac238f173df0c9c1120f862d0f599e17535a87ec",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.2",
+                "symfony/deprecation-contracts": "^2.5|^3.0",
                 "symfony/polyfill-ctype": "^1.8"
             },
             "conflict": {
-                "symfony/console": "<5.4"
+                "symfony/console": "<6.4"
             },
             "require-dev": {
-                "symfony/console": "^5.4|^6.0|^7.0"
+                "symfony/console": "^6.4|^7.0"
             },
             "bin": [
                 "Resources/bin/yaml-lint"
@@ -6237,7 +6390,7 @@
             "description": "Loads and dumps YAML files",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/yaml/tree/v6.4.13"
+                "source": "https://github.com/symfony/yaml/tree/v7.2.3"
             },
             "funding": [
                 {
@@ -6253,103 +6406,48 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:18:03+00:00"
+            "time": "2025-01-07T12:55:42+00:00"
         },
         {
-            "name": "torchlight/torchlight-commonmark",
-            "version": "v0.5.5",
+            "name": "torchlight/torchlight-laravel",
+            "version": "v0.6.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/torchlight-api/torchlight-commonmark-php.git",
-                "reference": "eb618ae6187090126a9ef881ccaf9c315d49c99b"
+                "url": "https://github.com/torchlight-api/torchlight-laravel.git",
+                "reference": "5670af34e9637761c89687848b8bd71e043d6819"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/torchlight-api/torchlight-commonmark-php/zipball/eb618ae6187090126a9ef881ccaf9c315d49c99b",
-                "reference": "eb618ae6187090126a9ef881ccaf9c315d49c99b",
+                "url": "https://api.github.com/repos/torchlight-api/torchlight-laravel/zipball/5670af34e9637761c89687848b8bd71e043d6819",
+                "reference": "5670af34e9637761c89687848b8bd71e043d6819",
                 "shasum": ""
             },
             "require": {
-                "league/commonmark": "^1.5|^2.0",
-                "php": "^7.2|^8.0",
-                "torchlight/torchlight-laravel": "^0.5.10"
+                "guzzlehttp/guzzle": "^7.2",
+                "illuminate/cache": "^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/console": "^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/http": "^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/view": "^8.0|^9.0|^10.0|^11.0|^12.0",
+                "php": "^7.3|^8.0",
+                "ramsey/uuid": "^3.7|^4.0"
             },
             "require-dev": {
                 "mockery/mockery": "^1.3.3",
-                "orchestra/testbench": "^5.0|^6.0",
-                "phpunit/phpunit": "^8.4"
+                "orchestra/testbench": "^5.0|^6.0|^7.0|^9.0|^10.0",
+                "phpunit/phpunit": "^8.5.23|^9.5|^10.5|^11.5.3"
             },
             "type": "library",
+            "extra": {
+                "laravel": {
+                    "providers": [
+                        "Torchlight\\TorchlightServiceProvider"
+                    ]
+                }
+            },
             "autoload": {
                 "psr-4": {
-                    "Torchlight\\Commonmark\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Aaron Francis",
-                    "email": "aaron@hammerstone.dev"
-                }
-            ],
-            "description": "A Commonmark extension for Torchlight, the syntax highlighting API.",
-            "homepage": "https://torchlight.dev",
-            "keywords": [
-                "Code highlighting",
-                "commonmark",
-                "laravel",
-                "markdown",
-                "syntax highlighting"
-            ],
-            "support": {
-                "issues": "https://github.com/torchlight-api/torchlight-commonmark-php/issues",
-                "source": "https://github.com/torchlight-api/torchlight-commonmark-php/tree/v0.5.5"
-            },
-            "time": "2022-02-23T17:09:44+00:00"
-        },
-        {
-            "name": "torchlight/torchlight-laravel",
-            "version": "v0.5.14",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/torchlight-api/torchlight-laravel.git",
-                "reference": "6a47c9dfdc5dc11ce0ef0672337119026189326d"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/torchlight-api/torchlight-laravel/zipball/6a47c9dfdc5dc11ce0ef0672337119026189326d",
-                "reference": "6a47c9dfdc5dc11ce0ef0672337119026189326d",
-                "shasum": ""
-            },
-            "require": {
-                "guzzlehttp/guzzle": "^7.2",
-                "illuminate/cache": "^8.0|^9.0|^10.0",
-                "illuminate/console": "^8.0|^9.0|^10.0",
-                "illuminate/http": "^8.0|^9.0|^10.0",
-                "illuminate/support": "^8.0|^9.0|^10.0",
-                "illuminate/view": "^8.0|^9.0|^10.0",
-                "php": "^7.3|^8.0",
-                "ramsey/uuid": "^3.7|^4.0"
-            },
-            "require-dev": {
-                "mockery/mockery": "^1.3.3",
-                "orchestra/testbench": "^5.0|^6.0|^7.0",
-                "phpunit/phpunit": "^8.5.23|^9.5"
-            },
-            "type": "library",
-            "extra": {
-                "laravel": {
-                    "providers": [
-                        "Torchlight\\TorchlightServiceProvider"
-                    ]
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Torchlight\\": "src/"
+                    "Torchlight\\": "src/"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6371,9 +6469,9 @@
             ],
             "support": {
                 "issues": "https://github.com/torchlight-api/torchlight-laravel/issues",
-                "source": "https://github.com/torchlight-api/torchlight-laravel/tree/v0.5.14"
+                "source": "https://github.com/torchlight-api/torchlight-laravel/tree/v0.6.1"
             },
-            "time": "2023-08-18T21:14:06+00:00"
+            "time": "2025-03-22T15:38:26+00:00"
         },
         {
             "name": "vlucas/phpdotenv",
@@ -6595,43 +6693,36 @@
     "packages-dev": [
         {
             "name": "amphp/amp",
-            "version": "v2.6.4",
+            "version": "v3.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/amphp/amp.git",
-                "reference": "ded3d9be08f526089eb7ee8d9f16a9768f9dec2d"
+                "reference": "7cf7fef3d667bfe4b2560bc87e67d5387a7bcde9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/amphp/amp/zipball/ded3d9be08f526089eb7ee8d9f16a9768f9dec2d",
-                "reference": "ded3d9be08f526089eb7ee8d9f16a9768f9dec2d",
+                "url": "https://api.github.com/repos/amphp/amp/zipball/7cf7fef3d667bfe4b2560bc87e67d5387a7bcde9",
+                "reference": "7cf7fef3d667bfe4b2560bc87e67d5387a7bcde9",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
             },
             "require-dev": {
-                "amphp/php-cs-fixer-config": "dev-master",
-                "amphp/phpunit-util": "^1",
-                "ext-json": "*",
-                "jetbrains/phpstorm-stubs": "^2019.3",
-                "phpunit/phpunit": "^7 | ^8 | ^9",
-                "react/promise": "^2",
-                "vimeo/psalm": "^3.12"
+                "amphp/php-cs-fixer-config": "^2",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "5.23.1"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "2.x-dev"
-                }
-            },
             "autoload": {
                 "files": [
-                    "lib/functions.php",
-                    "lib/Internal/functions.php"
+                    "src/functions.php",
+                    "src/Future/functions.php",
+                    "src/Internal/functions.php"
                 ],
                 "psr-4": {
-                    "Amp\\": "lib"
+                    "Amp\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6639,10 +6730,6 @@
                 "MIT"
             ],
             "authors": [
-                {
-                    "name": "Daniel Lowrey",
-                    "email": "rdlowrey@php.net"
-                },
                 {
                     "name": "Aaron Piotrowski",
                     "email": "aaron@trowski.com"
@@ -6654,6 +6741,10 @@
                 {
                     "name": "Niklas Keller",
                     "email": "me@kelunik.com"
+                },
+                {
+                    "name": "Daniel Lowrey",
+                    "email": "rdlowrey@php.net"
                 }
             ],
             "description": "A non-blocking concurrency framework for PHP applications.",
@@ -6670,9 +6761,8 @@
                 "promise"
             ],
             "support": {
-                "irc": "irc://irc.freenode.org/amphp",
                 "issues": "https://github.com/amphp/amp/issues",
-                "source": "https://github.com/amphp/amp/tree/v2.6.4"
+                "source": "https://github.com/amphp/amp/tree/v3.1.0"
             },
             "funding": [
                 {
@@ -6680,41 +6770,45 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-03-21T18:52:26+00:00"
+            "time": "2025-01-26T16:07:39+00:00"
         },
         {
             "name": "amphp/byte-stream",
-            "version": "v1.8.2",
+            "version": "v2.1.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/amphp/byte-stream.git",
-                "reference": "4f0e968ba3798a423730f567b1b50d3441c16ddc"
+                "reference": "55a6bd071aec26fa2a3e002618c20c35e3df1b46"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/amphp/byte-stream/zipball/4f0e968ba3798a423730f567b1b50d3441c16ddc",
-                "reference": "4f0e968ba3798a423730f567b1b50d3441c16ddc",
+                "url": "https://api.github.com/repos/amphp/byte-stream/zipball/55a6bd071aec26fa2a3e002618c20c35e3df1b46",
+                "reference": "55a6bd071aec26fa2a3e002618c20c35e3df1b46",
                 "shasum": ""
             },
             "require": {
-                "amphp/amp": "^2",
-                "php": ">=7.1"
+                "amphp/amp": "^3",
+                "amphp/parser": "^1.1",
+                "amphp/pipeline": "^1",
+                "amphp/serialization": "^1",
+                "amphp/sync": "^2",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2.3"
             },
             "require-dev": {
-                "amphp/php-cs-fixer-config": "dev-master",
-                "amphp/phpunit-util": "^1.4",
-                "friendsofphp/php-cs-fixer": "^2.3",
-                "jetbrains/phpstorm-stubs": "^2019.3",
-                "phpunit/phpunit": "^6 || ^7 || ^8",
-                "psalm/phar": "^3.11.4"
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "5.22.1"
             },
             "type": "library",
             "autoload": {
                 "files": [
-                    "lib/functions.php"
+                    "src/functions.php",
+                    "src/Internal/functions.php"
                 ],
                 "psr-4": {
-                    "Amp\\ByteStream\\": "lib"
+                    "Amp\\ByteStream\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6743,7 +6837,7 @@
             ],
             "support": {
                 "issues": "https://github.com/amphp/byte-stream/issues",
-                "source": "https://github.com/amphp/byte-stream/tree/v1.8.2"
+                "source": "https://github.com/amphp/byte-stream/tree/v2.1.2"
             },
             "funding": [
                 {
@@ -6751,62 +6845,39 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-04-13T18:00:56+00:00"
+            "time": "2025-03-16T17:10:27+00:00"
         },
         {
-            "name": "barryvdh/laravel-ide-helper",
-            "version": "v3.1.0",
+            "name": "amphp/cache",
+            "version": "v2.0.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/barryvdh/laravel-ide-helper.git",
-                "reference": "591e7d665fbab8a3b682e451641706341573eb80"
+                "url": "https://github.com/amphp/cache.git",
+                "reference": "46912e387e6aa94933b61ea1ead9cf7540b7797c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/barryvdh/laravel-ide-helper/zipball/591e7d665fbab8a3b682e451641706341573eb80",
-                "reference": "591e7d665fbab8a3b682e451641706341573eb80",
+                "url": "https://api.github.com/repos/amphp/cache/zipball/46912e387e6aa94933b61ea1ead9cf7540b7797c",
+                "reference": "46912e387e6aa94933b61ea1ead9cf7540b7797c",
                 "shasum": ""
             },
             "require": {
-                "barryvdh/reflection-docblock": "^2.1.1",
-                "composer/class-map-generator": "^1.0",
-                "ext-json": "*",
-                "illuminate/console": "^10 || ^11",
-                "illuminate/database": "^10.38 || ^11",
-                "illuminate/filesystem": "^10 || ^11",
-                "illuminate/support": "^10 || ^11",
-                "nikic/php-parser": "^4.18 || ^5",
-                "php": "^8.1",
-                "phpdocumentor/type-resolver": "^1.1.0"
+                "amphp/amp": "^3",
+                "amphp/serialization": "^1",
+                "amphp/sync": "^2",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
             },
             "require-dev": {
-                "ext-pdo_sqlite": "*",
-                "friendsofphp/php-cs-fixer": "^3",
-                "illuminate/config": "^9 || ^10 || ^11",
-                "illuminate/view": "^9 || ^10 || ^11",
-                "mockery/mockery": "^1.4",
-                "orchestra/testbench": "^8 || ^9",
-                "phpunit/phpunit": "^10.5",
-                "spatie/phpunit-snapshot-assertions": "^4 || ^5",
-                "vimeo/psalm": "^5.4"
-            },
-            "suggest": {
-                "illuminate/events": "Required for automatic helper generation (^6|^7|^8|^9|^10|^11)."
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.4"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "3.1-dev"
-                },
-                "laravel": {
-                    "providers": [
-                        "Barryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider"
-                    ]
-                }
-            },
             "autoload": {
                 "psr-4": {
-                    "Barryvdh\\LaravelIdeHelper\\": "src"
+                    "Amp\\Cache\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6815,73 +6886,71 @@
             ],
             "authors": [
                 {
-                    "name": "Barry vd. Heuvel",
-                    "email": "barryvdh@gmail.com"
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                },
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Daniel Lowrey",
+                    "email": "rdlowrey@php.net"
                 }
             ],
-            "description": "Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.",
-            "keywords": [
-                "autocomplete",
-                "codeintel",
-                "helper",
-                "ide",
-                "laravel",
-                "netbeans",
-                "phpdoc",
-                "phpstorm",
-                "sublime"
-            ],
+            "description": "A fiber-aware cache API based on Amp and Revolt.",
+            "homepage": "https://amphp.org/cache",
             "support": {
-                "issues": "https://github.com/barryvdh/laravel-ide-helper/issues",
-                "source": "https://github.com/barryvdh/laravel-ide-helper/tree/v3.1.0"
+                "issues": "https://github.com/amphp/cache/issues",
+                "source": "https://github.com/amphp/cache/tree/v2.0.1"
             },
             "funding": [
                 {
-                    "url": "https://fruitcake.nl",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/barryvdh",
+                    "url": "https://github.com/amphp",
                     "type": "github"
                 }
             ],
-            "time": "2024-07-12T14:20:51+00:00"
+            "time": "2024-04-19T03:38:06+00:00"
         },
         {
-            "name": "barryvdh/reflection-docblock",
-            "version": "v2.1.3",
+            "name": "amphp/dns",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/barryvdh/ReflectionDocBlock.git",
-                "reference": "c6fad15f7c878be21650c51e1f841bca7e49752e"
+                "url": "https://github.com/amphp/dns.git",
+                "reference": "78eb3db5fc69bf2fc0cb503c4fcba667bc223c71"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/barryvdh/ReflectionDocBlock/zipball/c6fad15f7c878be21650c51e1f841bca7e49752e",
-                "reference": "c6fad15f7c878be21650c51e1f841bca7e49752e",
+                "url": "https://api.github.com/repos/amphp/dns/zipball/78eb3db5fc69bf2fc0cb503c4fcba667bc223c71",
+                "reference": "78eb3db5fc69bf2fc0cb503c4fcba667bc223c71",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "amphp/cache": "^2",
+                "amphp/parser": "^1",
+                "amphp/process": "^2",
+                "daverandom/libdns": "^2.0.2",
+                "ext-filter": "*",
+                "ext-json": "*",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
             },
             "require-dev": {
-                "phpunit/phpunit": "^8.5.14|^9"
-            },
-            "suggest": {
-                "dflydev/markdown": "~1.0",
-                "erusev/parsedown": "~1.0"
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "5.20"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "2.0.x-dev"
-                }
-            },
             "autoload": {
-                "psr-0": {
-                    "Barryvdh": [
-                        "src/"
-                    ]
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "Amp\\Dns\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6890,68 +6959,91 @@
             ],
             "authors": [
                 {
-                    "name": "Mike van Riel",
-                    "email": "mike.vanriel@naenius.com"
+                    "name": "Chris Wright",
+                    "email": "addr@daverandom.com"
+                },
+                {
+                    "name": "Daniel Lowrey",
+                    "email": "rdlowrey@php.net"
+                },
+                {
+                    "name": "Bob Weinand",
+                    "email": "bobwei9@hotmail.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                },
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
                 }
             ],
+            "description": "Async DNS resolution for Amp.",
+            "homepage": "https://github.com/amphp/dns",
+            "keywords": [
+                "amp",
+                "amphp",
+                "async",
+                "client",
+                "dns",
+                "resolve"
+            ],
             "support": {
-                "source": "https://github.com/barryvdh/ReflectionDocBlock/tree/v2.1.3"
+                "issues": "https://github.com/amphp/dns/issues",
+                "source": "https://github.com/amphp/dns/tree/v2.4.0"
             },
-            "time": "2024-10-23T11:41:03+00:00"
+            "funding": [
+                {
+                    "url": "https://github.com/amphp",
+                    "type": "github"
+                }
+            ],
+            "time": "2025-01-19T15:43:40+00:00"
         },
         {
-            "name": "brianium/paratest",
-            "version": "v7.3.1",
+            "name": "amphp/parallel",
+            "version": "v2.3.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/paratestphp/paratest.git",
-                "reference": "551f46f52a93177d873f3be08a1649ae886b4a30"
+                "url": "https://github.com/amphp/parallel.git",
+                "reference": "5113111de02796a782f5d90767455e7391cca190"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/paratestphp/paratest/zipball/551f46f52a93177d873f3be08a1649ae886b4a30",
-                "reference": "551f46f52a93177d873f3be08a1649ae886b4a30",
+                "url": "https://api.github.com/repos/amphp/parallel/zipball/5113111de02796a782f5d90767455e7391cca190",
+                "reference": "5113111de02796a782f5d90767455e7391cca190",
                 "shasum": ""
             },
             "require": {
-                "ext-dom": "*",
-                "ext-pcre": "*",
-                "ext-reflection": "*",
-                "ext-simplexml": "*",
-                "fidry/cpu-core-counter": "^0.5.1 || ^1.0.0",
-                "jean85/pretty-package-versions": "^2.0.5",
-                "php": "~8.1.0 || ~8.2.0 || ~8.3.0",
-                "phpunit/php-code-coverage": "^10.1.7",
-                "phpunit/php-file-iterator": "^4.1.0",
-                "phpunit/php-timer": "^6.0",
-                "phpunit/phpunit": "^10.4.2",
-                "sebastian/environment": "^6.0.1",
-                "symfony/console": "^6.3.4 || ^7.0.0",
-                "symfony/process": "^6.3.4 || ^7.0.0"
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "amphp/cache": "^2",
+                "amphp/parser": "^1",
+                "amphp/pipeline": "^1",
+                "amphp/process": "^2",
+                "amphp/serialization": "^1",
+                "amphp/socket": "^2",
+                "amphp/sync": "^2",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^12.0.0",
-                "ext-pcov": "*",
-                "ext-posix": "*",
-                "infection/infection": "^0.27.6",
-                "phpstan/phpstan": "^1.10.40",
-                "phpstan/phpstan-deprecation-rules": "^1.1.4",
-                "phpstan/phpstan-phpunit": "^1.3.15",
-                "phpstan/phpstan-strict-rules": "^1.5.2",
-                "squizlabs/php_codesniffer": "^3.7.2",
-                "symfony/filesystem": "^6.3.1 || ^7.0.0"
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.18"
             },
-            "bin": [
-                "bin/paratest",
-                "bin/paratest.bat",
-                "bin/paratest_for_phpstorm"
-            ],
             "type": "library",
             "autoload": {
+                "files": [
+                    "src/Context/functions.php",
+                    "src/Context/Internal/functions.php",
+                    "src/Ipc/functions.php",
+                    "src/Worker/functions.php"
+                ],
                 "psr-4": {
-                    "ParaTest\\": [
-                        "src/"
-                    ]
+                    "Amp\\Parallel\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6960,76 +7052,65 @@
             ],
             "authors": [
                 {
-                    "name": "Brian Scaturro",
-                    "email": "scaturrob@gmail.com",
-                    "role": "Developer"
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
                 },
                 {
-                    "name": "Filippo Tessarotto",
-                    "email": "zoeslam@gmail.com",
-                    "role": "Developer"
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                },
+                {
+                    "name": "Stephen Coakley",
+                    "email": "me@stephencoakley.com"
                 }
             ],
-            "description": "Parallel testing for PHP",
-            "homepage": "https://github.com/paratestphp/paratest",
+            "description": "Parallel processing component for Amp.",
+            "homepage": "https://github.com/amphp/parallel",
             "keywords": [
+                "async",
+                "asynchronous",
                 "concurrent",
-                "parallel",
-                "phpunit",
-                "testing"
+                "multi-processing",
+                "multi-threading"
             ],
             "support": {
-                "issues": "https://github.com/paratestphp/paratest/issues",
-                "source": "https://github.com/paratestphp/paratest/tree/v7.3.1"
+                "issues": "https://github.com/amphp/parallel/issues",
+                "source": "https://github.com/amphp/parallel/tree/v2.3.1"
             },
             "funding": [
                 {
-                    "url": "https://github.com/sponsors/Slamdunk",
+                    "url": "https://github.com/amphp",
                     "type": "github"
-                },
-                {
-                    "url": "https://paypal.me/filippotessarotto",
-                    "type": "paypal"
                 }
             ],
-            "time": "2023-10-31T09:24:17+00:00"
+            "time": "2024-12-21T01:56:09+00:00"
         },
         {
-            "name": "composer/class-map-generator",
-            "version": "1.4.0",
+            "name": "amphp/parser",
+            "version": "v1.1.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/composer/class-map-generator.git",
-                "reference": "98bbf6780e56e0fd2404fe4b82eb665a0f93b783"
+                "url": "https://github.com/amphp/parser.git",
+                "reference": "3cf1f8b32a0171d4b1bed93d25617637a77cded7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/composer/class-map-generator/zipball/98bbf6780e56e0fd2404fe4b82eb665a0f93b783",
-                "reference": "98bbf6780e56e0fd2404fe4b82eb665a0f93b783",
+                "url": "https://api.github.com/repos/amphp/parser/zipball/3cf1f8b32a0171d4b1bed93d25617637a77cded7",
+                "reference": "3cf1f8b32a0171d4b1bed93d25617637a77cded7",
                 "shasum": ""
             },
             "require": {
-                "composer/pcre": "^2.1 || ^3.1",
-                "php": "^7.2 || ^8.0",
-                "symfony/finder": "^4.4 || ^5.3 || ^6 || ^7"
+                "php": ">=7.4"
             },
             "require-dev": {
-                "phpstan/phpstan": "^1.6",
-                "phpstan/phpstan-deprecation-rules": "^1",
-                "phpstan/phpstan-phpunit": "^1",
-                "phpstan/phpstan-strict-rules": "^1.1",
-                "phpunit/phpunit": "^8",
-                "symfony/filesystem": "^5.4 || ^6"
+                "amphp/php-cs-fixer-config": "^2",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.4"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "1.x-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
-                    "Composer\\ClassMapGenerator\\": "src"
+                    "Amp\\Parser\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -7038,71 +7119,439 @@
             ],
             "authors": [
                 {
-                    "name": "Jordi Boggiano",
-                    "email": "j.boggiano@seld.be",
-                    "homepage": "https://seld.be"
-                }
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
             ],
-            "description": "Utilities to scan PHP code and generate class maps.",
+            "description": "A generator parser to make streaming parsers simple.",
+            "homepage": "https://github.com/amphp/parser",
             "keywords": [
-                "classmap"
+                "async",
+                "non-blocking",
+                "parser",
+                "stream"
             ],
             "support": {
-                "issues": "https://github.com/composer/class-map-generator/issues",
-                "source": "https://github.com/composer/class-map-generator/tree/1.4.0"
+                "issues": "https://github.com/amphp/parser/issues",
+                "source": "https://github.com/amphp/parser/tree/v1.1.1"
             },
             "funding": [
                 {
-                    "url": "https://packagist.com",
-                    "type": "custom"
+                    "url": "https://github.com/amphp",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-03-21T19:16:53+00:00"
+        },
+        {
+            "name": "amphp/pipeline",
+            "version": "v1.2.3",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/amphp/pipeline.git",
+                "reference": "7b52598c2e9105ebcddf247fc523161581930367"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/amphp/pipeline/zipball/7b52598c2e9105ebcddf247fc523161581930367",
+                "reference": "7b52598c2e9105ebcddf247fc523161581930367",
+                "shasum": ""
+            },
+            "require": {
+                "amphp/amp": "^3",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1"
+            },
+            "require-dev": {
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.18"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Amp\\Pipeline\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
                 },
                 {
-                    "url": "https://github.com/composer",
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "Asynchronous iterators and operators.",
+            "homepage": "https://amphp.org/pipeline",
+            "keywords": [
+                "amp",
+                "amphp",
+                "async",
+                "io",
+                "iterator",
+                "non-blocking"
+            ],
+            "support": {
+                "issues": "https://github.com/amphp/pipeline/issues",
+                "source": "https://github.com/amphp/pipeline/tree/v1.2.3"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/amphp",
                     "type": "github"
+                }
+            ],
+            "time": "2025-03-16T16:33:53+00:00"
+        },
+        {
+            "name": "amphp/process",
+            "version": "v2.0.3",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/amphp/process.git",
+                "reference": "52e08c09dec7511d5fbc1fb00d3e4e79fc77d58d"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/amphp/process/zipball/52e08c09dec7511d5fbc1fb00d3e4e79fc77d58d",
+                "reference": "52e08c09dec7511d5fbc1fb00d3e4e79fc77d58d",
+                "shasum": ""
+            },
+            "require": {
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "amphp/sync": "^2",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
+            },
+            "require-dev": {
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.4"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "Amp\\Process\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Bob Weinand",
+                    "email": "bobwei9@hotmail.com"
                 },
                 {
-                    "url": "https://tidelift.com/funding/github/packagist/composer/composer",
-                    "type": "tidelift"
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "A fiber-aware process manager based on Amp and Revolt.",
+            "homepage": "https://amphp.org/process",
+            "support": {
+                "issues": "https://github.com/amphp/process/issues",
+                "source": "https://github.com/amphp/process/tree/v2.0.3"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/amphp",
+                    "type": "github"
                 }
             ],
-            "time": "2024-10-03T18:14:00+00:00"
+            "time": "2024-04-19T03:13:44+00:00"
         },
         {
-            "name": "composer/package-versions-deprecated",
-            "version": "1.11.99.5",
+            "name": "amphp/serialization",
+            "version": "v1.0.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/composer/package-versions-deprecated.git",
-                "reference": "b4f54f74ef3453349c24a845d22392cd31e65f1d"
+                "url": "https://github.com/amphp/serialization.git",
+                "reference": "693e77b2fb0b266c3c7d622317f881de44ae94a1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/composer/package-versions-deprecated/zipball/b4f54f74ef3453349c24a845d22392cd31e65f1d",
-                "reference": "b4f54f74ef3453349c24a845d22392cd31e65f1d",
+                "url": "https://api.github.com/repos/amphp/serialization/zipball/693e77b2fb0b266c3c7d622317f881de44ae94a1",
+                "reference": "693e77b2fb0b266c3c7d622317f881de44ae94a1",
                 "shasum": ""
             },
             "require": {
-                "composer-plugin-api": "^1.1.0 || ^2.0",
-                "php": "^7 || ^8"
+                "php": ">=7.1"
             },
-            "replace": {
-                "ocramius/package-versions": "1.11.99"
+            "require-dev": {
+                "amphp/php-cs-fixer-config": "dev-master",
+                "phpunit/phpunit": "^9 || ^8 || ^7"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "Amp\\Serialization\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "Serialization tools for IPC and data storage in PHP.",
+            "homepage": "https://github.com/amphp/serialization",
+            "keywords": [
+                "async",
+                "asynchronous",
+                "serialization",
+                "serialize"
+            ],
+            "support": {
+                "issues": "https://github.com/amphp/serialization/issues",
+                "source": "https://github.com/amphp/serialization/tree/master"
+            },
+            "time": "2020-03-25T21:39:07+00:00"
+        },
+        {
+            "name": "amphp/socket",
+            "version": "v2.3.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/amphp/socket.git",
+                "reference": "58e0422221825b79681b72c50c47a930be7bf1e1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/amphp/socket/zipball/58e0422221825b79681b72c50c47a930be7bf1e1",
+                "reference": "58e0422221825b79681b72c50c47a930be7bf1e1",
+                "shasum": ""
+            },
+            "require": {
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "amphp/dns": "^2",
+                "ext-openssl": "*",
+                "kelunik/certificate": "^1.1",
+                "league/uri": "^6.5 | ^7",
+                "league/uri-interfaces": "^2.3 | ^7",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
             },
             "require-dev": {
-                "composer/composer": "^1.9.3 || ^2.0@dev",
-                "ext-zip": "^1.13",
-                "phpunit/phpunit": "^6.5 || ^7"
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "amphp/process": "^2",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "5.20"
             },
-            "type": "composer-plugin",
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php",
+                    "src/Internal/functions.php",
+                    "src/SocketAddress/functions.php"
+                ],
+                "psr-4": {
+                    "Amp\\Socket\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Daniel Lowrey",
+                    "email": "rdlowrey@gmail.com"
+                },
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "Non-blocking socket connection / server implementations based on Amp and Revolt.",
+            "homepage": "https://github.com/amphp/socket",
+            "keywords": [
+                "amp",
+                "async",
+                "encryption",
+                "non-blocking",
+                "sockets",
+                "tcp",
+                "tls"
+            ],
+            "support": {
+                "issues": "https://github.com/amphp/socket/issues",
+                "source": "https://github.com/amphp/socket/tree/v2.3.1"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/amphp",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-04-21T14:33:03+00:00"
+        },
+        {
+            "name": "amphp/sync",
+            "version": "v2.3.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/amphp/sync.git",
+                "reference": "217097b785130d77cfcc58ff583cf26cd1770bf1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/amphp/sync/zipball/217097b785130d77cfcc58ff583cf26cd1770bf1",
+                "reference": "217097b785130d77cfcc58ff583cf26cd1770bf1",
+                "shasum": ""
+            },
+            "require": {
+                "amphp/amp": "^3",
+                "amphp/pipeline": "^1",
+                "amphp/serialization": "^1",
+                "php": ">=8.1",
+                "revolt/event-loop": "^1 || ^0.2"
+            },
+            "require-dev": {
+                "amphp/php-cs-fixer-config": "^2",
+                "amphp/phpunit-util": "^3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "5.23"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "Amp\\Sync\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                },
+                {
+                    "name": "Stephen Coakley",
+                    "email": "me@stephencoakley.com"
+                }
+            ],
+            "description": "Non-blocking synchronization primitives for PHP based on Amp and Revolt.",
+            "homepage": "https://github.com/amphp/sync",
+            "keywords": [
+                "async",
+                "asynchronous",
+                "mutex",
+                "semaphore",
+                "synchronization"
+            ],
+            "support": {
+                "issues": "https://github.com/amphp/sync/issues",
+                "source": "https://github.com/amphp/sync/tree/v2.3.0"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/amphp",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-08-03T19:31:26+00:00"
+        },
+        {
+            "name": "barryvdh/laravel-ide-helper",
+            "version": "v3.5.5",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/barryvdh/laravel-ide-helper.git",
+                "reference": "8d441ec99f8612b942b55f5183151d91591b618a"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/barryvdh/laravel-ide-helper/zipball/8d441ec99f8612b942b55f5183151d91591b618a",
+                "reference": "8d441ec99f8612b942b55f5183151d91591b618a",
+                "shasum": ""
+            },
+            "require": {
+                "barryvdh/reflection-docblock": "^2.3",
+                "composer/class-map-generator": "^1.0",
+                "ext-json": "*",
+                "illuminate/console": "^11.15 || ^12",
+                "illuminate/database": "^11.15 || ^12",
+                "illuminate/filesystem": "^11.15 || ^12",
+                "illuminate/support": "^11.15 || ^12",
+                "php": "^8.2"
+            },
+            "require-dev": {
+                "ext-pdo_sqlite": "*",
+                "friendsofphp/php-cs-fixer": "^3",
+                "illuminate/config": "^11.15 || ^12",
+                "illuminate/view": "^11.15 || ^12",
+                "mockery/mockery": "^1.4",
+                "orchestra/testbench": "^9.2 || ^10",
+                "phpunit/phpunit": "^10.5 || ^11.5.3",
+                "spatie/phpunit-snapshot-assertions": "^4 || ^5",
+                "vimeo/psalm": "^5.4",
+                "vlucas/phpdotenv": "^5"
+            },
+            "suggest": {
+                "illuminate/events": "Required for automatic helper generation (^6|^7|^8|^9|^10|^11)."
+            },
+            "type": "library",
             "extra": {
-                "class": "PackageVersions\\Installer",
+                "laravel": {
+                    "providers": [
+                        "Barryvdh\\LaravelIdeHelper\\IdeHelperServiceProvider"
+                    ]
+                },
                 "branch-alias": {
-                    "dev-master": "1.x-dev"
+                    "dev-master": "3.5-dev"
                 }
             },
             "autoload": {
                 "psr-4": {
-                    "PackageVersions\\": "src/PackageVersions"
+                    "Barryvdh\\LaravelIdeHelper\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -7111,18 +7560,240 @@
             ],
             "authors": [
                 {
-                    "name": "Marco Pivetta",
-                    "email": "ocramius@gmail.com"
+                    "name": "Barry vd. Heuvel",
+                    "email": "barryvdh@gmail.com"
+                }
+            ],
+            "description": "Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.",
+            "keywords": [
+                "autocomplete",
+                "codeintel",
+                "dev",
+                "helper",
+                "ide",
+                "laravel",
+                "netbeans",
+                "phpdoc",
+                "phpstorm",
+                "sublime"
+            ],
+            "support": {
+                "issues": "https://github.com/barryvdh/laravel-ide-helper/issues",
+                "source": "https://github.com/barryvdh/laravel-ide-helper/tree/v3.5.5"
+            },
+            "funding": [
+                {
+                    "url": "https://fruitcake.nl",
+                    "type": "custom"
                 },
+                {
+                    "url": "https://github.com/barryvdh",
+                    "type": "github"
+                }
+            ],
+            "time": "2025-02-11T13:59:46+00:00"
+        },
+        {
+            "name": "barryvdh/reflection-docblock",
+            "version": "v2.3.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/barryvdh/ReflectionDocBlock.git",
+                "reference": "b6ff9f93603561f50e53b64310495d20b8dff5d8"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/barryvdh/ReflectionDocBlock/zipball/b6ff9f93603561f50e53b64310495d20b8dff5d8",
+                "reference": "b6ff9f93603561f50e53b64310495d20b8dff5d8",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^8.5.14|^9"
+            },
+            "suggest": {
+                "dflydev/markdown": "~1.0",
+                "erusev/parsedown": "~1.0"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.3.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-0": {
+                    "Barryvdh": [
+                        "src/"
+                    ]
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Mike van Riel",
+                    "email": "mike.vanriel@naenius.com"
+                }
+            ],
+            "support": {
+                "source": "https://github.com/barryvdh/ReflectionDocBlock/tree/v2.3.1"
+            },
+            "time": "2025-01-18T19:26:32+00:00"
+        },
+        {
+            "name": "brianium/paratest",
+            "version": "v7.4.8",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/paratestphp/paratest.git",
+                "reference": "cf16fcbb9b8107a7df6b97e497fc91e819774d8b"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/paratestphp/paratest/zipball/cf16fcbb9b8107a7df6b97e497fc91e819774d8b",
+                "reference": "cf16fcbb9b8107a7df6b97e497fc91e819774d8b",
+                "shasum": ""
+            },
+            "require": {
+                "ext-dom": "*",
+                "ext-pcre": "*",
+                "ext-reflection": "*",
+                "ext-simplexml": "*",
+                "fidry/cpu-core-counter": "^1.2.0",
+                "jean85/pretty-package-versions": "^2.0.6",
+                "php": "~8.2.0 || ~8.3.0 || ~8.4.0",
+                "phpunit/php-code-coverage": "^10.1.16",
+                "phpunit/php-file-iterator": "^4.1.0",
+                "phpunit/php-timer": "^6.0.0",
+                "phpunit/phpunit": "^10.5.36",
+                "sebastian/environment": "^6.1.0",
+                "symfony/console": "^6.4.7 || ^7.1.5",
+                "symfony/process": "^6.4.7 || ^7.1.5"
+            },
+            "require-dev": {
+                "doctrine/coding-standard": "^12.0.0",
+                "ext-pcov": "*",
+                "ext-posix": "*",
+                "phpstan/phpstan": "^1.12.6",
+                "phpstan/phpstan-deprecation-rules": "^1.2.1",
+                "phpstan/phpstan-phpunit": "^1.4.0",
+                "phpstan/phpstan-strict-rules": "^1.6.1",
+                "squizlabs/php_codesniffer": "^3.10.3",
+                "symfony/filesystem": "^6.4.3 || ^7.1.5"
+            },
+            "bin": [
+                "bin/paratest",
+                "bin/paratest_for_phpstorm"
+            ],
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "ParaTest\\": [
+                        "src/"
+                    ]
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Brian Scaturro",
+                    "email": "scaturrob@gmail.com",
+                    "role": "Developer"
+                },
+                {
+                    "name": "Filippo Tessarotto",
+                    "email": "zoeslam@gmail.com",
+                    "role": "Developer"
+                }
+            ],
+            "description": "Parallel testing for PHP",
+            "homepage": "https://github.com/paratestphp/paratest",
+            "keywords": [
+                "concurrent",
+                "parallel",
+                "phpunit",
+                "testing"
+            ],
+            "support": {
+                "issues": "https://github.com/paratestphp/paratest/issues",
+                "source": "https://github.com/paratestphp/paratest/tree/v7.4.8"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/sponsors/Slamdunk",
+                    "type": "github"
+                },
+                {
+                    "url": "https://paypal.me/filippotessarotto",
+                    "type": "paypal"
+                }
+            ],
+            "time": "2024-10-15T12:45:19+00:00"
+        },
+        {
+            "name": "composer/class-map-generator",
+            "version": "1.6.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/composer/class-map-generator.git",
+                "reference": "ffe442c5974c44a9343e37a0abcb1cc37319f5b9"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/composer/class-map-generator/zipball/ffe442c5974c44a9343e37a0abcb1cc37319f5b9",
+                "reference": "ffe442c5974c44a9343e37a0abcb1cc37319f5b9",
+                "shasum": ""
+            },
+            "require": {
+                "composer/pcre": "^2.1 || ^3.1",
+                "php": "^7.2 || ^8.0",
+                "symfony/finder": "^4.4 || ^5.3 || ^6 || ^7"
+            },
+            "require-dev": {
+                "phpstan/phpstan": "^1.12 || ^2",
+                "phpstan/phpstan-deprecation-rules": "^1 || ^2",
+                "phpstan/phpstan-phpunit": "^1 || ^2",
+                "phpstan/phpstan-strict-rules": "^1.1 || ^2",
+                "phpunit/phpunit": "^8",
+                "symfony/filesystem": "^5.4 || ^6"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Composer\\ClassMapGenerator\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
                 {
                     "name": "Jordi Boggiano",
-                    "email": "j.boggiano@seld.be"
+                    "email": "j.boggiano@seld.be",
+                    "homepage": "https://seld.be"
                 }
             ],
-            "description": "Composer plugin that provides efficient querying for installed package versions (no runtime IO)",
+            "description": "Utilities to scan PHP code and generate class maps.",
+            "keywords": [
+                "classmap"
+            ],
             "support": {
-                "issues": "https://github.com/composer/package-versions-deprecated/issues",
-                "source": "https://github.com/composer/package-versions-deprecated/tree/1.11.99.5"
+                "issues": "https://github.com/composer/class-map-generator/issues",
+                "source": "https://github.com/composer/class-map-generator/tree/1.6.0"
             },
             "funding": [
                 {
@@ -7138,20 +7809,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-01-17T14:14:24+00:00"
+            "time": "2025-02-05T10:05:34+00:00"
         },
         {
             "name": "composer/pcre",
-            "version": "3.3.1",
+            "version": "3.3.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/composer/pcre.git",
-                "reference": "63aaeac21d7e775ff9bc9d45021e1745c97521c4"
+                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/composer/pcre/zipball/63aaeac21d7e775ff9bc9d45021e1745c97521c4",
-                "reference": "63aaeac21d7e775ff9bc9d45021e1745c97521c4",
+                "url": "https://api.github.com/repos/composer/pcre/zipball/b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
+                "reference": "b2bed4734f0cc156ee1fe9c0da2550420d99a21e",
                 "shasum": ""
             },
             "require": {
@@ -7161,19 +7832,19 @@
                 "phpstan/phpstan": "<1.11.10"
             },
             "require-dev": {
-                "phpstan/phpstan": "^1.11.10",
-                "phpstan/phpstan-strict-rules": "^1.1",
+                "phpstan/phpstan": "^1.12 || ^2",
+                "phpstan/phpstan-strict-rules": "^1 || ^2",
                 "phpunit/phpunit": "^8 || ^9"
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "3.x-dev"
-                },
                 "phpstan": {
                     "includes": [
                         "extension.neon"
                     ]
+                },
+                "branch-alias": {
+                    "dev-main": "3.x-dev"
                 }
             },
             "autoload": {
@@ -7201,7 +7872,7 @@
             ],
             "support": {
                 "issues": "https://github.com/composer/pcre/issues",
-                "source": "https://github.com/composer/pcre/tree/3.3.1"
+                "source": "https://github.com/composer/pcre/tree/3.3.2"
             },
             "funding": [
                 {
@@ -7217,7 +7888,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-08-27T18:44:43+00:00"
+            "time": "2024-11-12T16:29:46+00:00"
         },
         {
             "name": "composer/semver",
@@ -7366,6 +8037,50 @@
             ],
             "time": "2024-05-06T16:37:16+00:00"
         },
+        {
+            "name": "daverandom/libdns",
+            "version": "v2.1.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/DaveRandom/LibDNS.git",
+                "reference": "b84c94e8fe6b7ee4aecfe121bfe3b6177d303c8a"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/DaveRandom/LibDNS/zipball/b84c94e8fe6b7ee4aecfe121bfe3b6177d303c8a",
+                "reference": "b84c94e8fe6b7ee4aecfe121bfe3b6177d303c8a",
+                "shasum": ""
+            },
+            "require": {
+                "ext-ctype": "*",
+                "php": ">=7.1"
+            },
+            "suggest": {
+                "ext-intl": "Required for IDN support"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "LibDNS\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "DNS protocol implementation written in pure PHP",
+            "keywords": [
+                "dns"
+            ],
+            "support": {
+                "issues": "https://github.com/DaveRandom/LibDNS/issues",
+                "source": "https://github.com/DaveRandom/LibDNS/tree/v2.1.0"
+            },
+            "time": "2024-04-12T12:12:48+00:00"
+        },
         {
             "name": "desilva/microserve",
             "version": "v2.0.0",
@@ -7428,18 +8143,18 @@
             "source": {
                 "type": "git",
                 "url": "https://github.com/caendesilva/psalm-coverage",
-                "reference": "fb464f51528fe6b2813aaedca6196301ce0b2087"
+                "reference": "7172e5eeb4fb223c230e909adaab5cf2135f3a43"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/caendesilva/psalm-coverage/zipball/fb464f51528fe6b2813aaedca6196301ce0b2087",
-                "reference": "fb464f51528fe6b2813aaedca6196301ce0b2087",
+                "url": "https://api.github.com/repos/caendesilva/psalm-coverage/zipball/7172e5eeb4fb223c230e909adaab5cf2135f3a43",
+                "reference": "7172e5eeb4fb223c230e909adaab5cf2135f3a43",
                 "shasum": ""
             },
             "require": {
-                "amphp/amp": "^2.4.2",
-                "amphp/byte-stream": "^1.5",
-                "composer/package-versions-deprecated": "^1.10.0",
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "composer-runtime-api": "^2",
                 "composer/semver": "^1.4 || ^2.0 || ^3.0",
                 "composer/xdebug-handler": "^2.0 || ^3.0",
                 "dnoegel/php-xdg-base-dir": "^0.1.1",
@@ -7452,21 +8167,23 @@
                 "ext-tokenizer": "*",
                 "felixfbecker/advanced-json-rpc": "^3.1",
                 "felixfbecker/language-server-protocol": "^1.5.2",
-                "fidry/cpu-core-counter": "^0.4.1 || ^0.5.1",
+                "fidry/cpu-core-counter": "^0.4.1 || ^0.5.1 || ^1.0.0",
                 "netresearch/jsonmapper": "^1.0 || ^2.0 || ^3.0 || ^4.0",
-                "nikic/php-parser": "^4.13",
-                "php": "^7.4 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0",
-                "sebastian/diff": "^4.0 || ^5.0",
-                "spatie/array-to-xml": "^2.17.0",
-                "symfony/console": "^4.1.6 || ^5.0 || ^6.0",
-                "symfony/filesystem": "^5.4 || ^6.0"
+                "nikic/php-parser": "^5.0.0",
+                "php": "~8.1.17 || ~8.2.4 || ~8.3.0 || ~8.4.0",
+                "sebastian/diff": "^4.0 || ^5.0 || ^6.0",
+                "spatie/array-to-xml": "^2.17.0 || ^3.0",
+                "symfony/console": "^4.1.6 || ^5.0 || ^6.0 || ^7.0",
+                "symfony/filesystem": "^5.4 || ^6.0 || ^7.0"
             },
             "provide": {
                 "psalm/psalm": "self.version"
             },
             "require-dev": {
+                "amphp/phpunit-util": "^3",
                 "bamarni/composer-bin-plugin": "^1.4",
                 "brianium/paratest": "^6.9",
+                "dg/bypass-finals": "^1.5",
                 "ext-curl": "*",
                 "mockery/mockery": "^1.5",
                 "nunomaduro/mock-final-classes": "^1.1",
@@ -7477,7 +8194,7 @@
                 "psalm/plugin-phpunit": "^0.18",
                 "slevomat/coding-standard": "^8.4",
                 "squizlabs/php_codesniffer": "^3.6",
-                "symfony/process": "^4.4 || ^5.0 || ^6.0"
+                "symfony/process": "^4.4 || ^5.0 || ^6.0 || ^7.0"
             },
             "suggest": {
                 "ext-curl": "In order to send data to shepherd",
@@ -7494,7 +8211,8 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "5.x-dev",
+                    "dev-master": "6.x-dev",
+                    "dev-5.x": "5.x-dev",
                     "dev-4.x": "4.x-dev",
                     "dev-3.x": "3.x-dev",
                     "dev-2.x": "2.x-dev",
@@ -7513,30 +8231,30 @@
             },
             "scripts": {
                 "cs": [
-                    "phpcs -ps"
+                    "@php phpcs -ps"
                 ],
                 "cs-fix": [
-                    "phpcbf -ps"
+                    "@php phpcbf -ps"
                 ],
                 "lint": [
-                    "parallel-lint ./src ./tests"
+                    "@php parallel-lint ./src ./tests"
                 ],
                 "phpunit": [
                     "Composer\\Config::disableProcessTimeout",
-                    "paratest --runner=WrapperRunner"
+                    "paratest -f --runner=WrapperRunner"
                 ],
                 "phpunit-std": [
                     "Composer\\Config::disableProcessTimeout",
-                    "phpunit"
+                    "@php phpunit"
                 ],
                 "verify-callmap": [
-                    "phpunit tests/Internal/Codebase/InternalCallMapHandlerTest.php"
+                    "@php phpunit tests/Internal/Codebase/InternalCallMapHandlerTest.php"
                 ],
                 "psalm": [
                     "@php ./psalm"
                 ],
                 "psalm-set-baseline": [
-                    "@php ./psalm --set-baseline=psalm-baseline.xml"
+                    "@php ./psalm --set-baseline"
                 ],
                 "tests": [
                     "@lint",
@@ -7557,9 +8275,15 @@
             "keywords": [
                 "code",
                 "inspection",
-                "php"
+                "php",
+                "static analysis"
             ],
-            "time": "2024-07-31T13:03:00+00:00"
+            "support": {
+                "docs": "https://psalm.dev/docs",
+                "issues": "https://github.com/vimeo/psalm/issues",
+                "source": "https://github.com/vimeo/psalm"
+            },
+            "time": "2024-12-15T13:40:25+00:00"
         },
         {
             "name": "dnoegel/php-xdg-base-dir",
@@ -7600,29 +8324,27 @@
         },
         {
             "name": "doctrine/deprecations",
-            "version": "1.1.3",
+            "version": "1.1.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/deprecations.git",
-                "reference": "dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab"
+                "reference": "31610dbb31faa98e6b5447b62340826f54fbc4e9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab",
-                "reference": "dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab",
+                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/31610dbb31faa98e6b5447b62340826f54fbc4e9",
+                "reference": "31610dbb31faa98e6b5447b62340826f54fbc4e9",
                 "shasum": ""
             },
             "require": {
                 "php": "^7.1 || ^8.0"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^9",
-                "phpstan/phpstan": "1.4.10 || 1.10.15",
-                "phpstan/phpstan-phpunit": "^1.0",
+                "doctrine/coding-standard": "^9 || ^12",
+                "phpstan/phpstan": "1.4.10 || 2.0.3",
+                "phpstan/phpstan-phpunit": "^1.0 || ^2",
                 "phpunit/phpunit": "^7.5 || ^8.5 || ^9.5",
-                "psalm/plugin-phpunit": "0.18.4",
-                "psr/log": "^1 || ^2 || ^3",
-                "vimeo/psalm": "4.30.0 || 5.12.0"
+                "psr/log": "^1 || ^2 || ^3"
             },
             "suggest": {
                 "psr/log": "Allows logging deprecations via PSR-3 logger implementation"
@@ -7630,7 +8352,7 @@
             "type": "library",
             "autoload": {
                 "psr-4": {
-                    "Doctrine\\Deprecations\\": "lib/Doctrine/Deprecations"
+                    "Doctrine\\Deprecations\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -7641,9 +8363,9 @@
             "homepage": "https://www.doctrine-project.org/",
             "support": {
                 "issues": "https://github.com/doctrine/deprecations/issues",
-                "source": "https://github.com/doctrine/deprecations/tree/1.1.3"
+                "source": "https://github.com/doctrine/deprecations/tree/1.1.4"
             },
-            "time": "2024-01-30T19:34:25+00:00"
+            "time": "2024-12-07T21:18:45+00:00"
         },
         {
             "name": "felixfbecker/advanced-json-rpc",
@@ -7748,16 +8470,16 @@
         },
         {
             "name": "fidry/cpu-core-counter",
-            "version": "0.5.1",
+            "version": "1.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/theofidry/cpu-core-counter.git",
-                "reference": "b58e5a3933e541dc286cc91fc4f3898bbc6f1623"
+                "reference": "8520451a140d3f46ac33042715115e290cf5785f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/theofidry/cpu-core-counter/zipball/b58e5a3933e541dc286cc91fc4f3898bbc6f1623",
-                "reference": "b58e5a3933e541dc286cc91fc4f3898bbc6f1623",
+                "url": "https://api.github.com/repos/theofidry/cpu-core-counter/zipball/8520451a140d3f46ac33042715115e290cf5785f",
+                "reference": "8520451a140d3f46ac33042715115e290cf5785f",
                 "shasum": ""
             },
             "require": {
@@ -7765,13 +8487,13 @@
             },
             "require-dev": {
                 "fidry/makefile": "^0.2.0",
+                "fidry/php-cs-fixer-config": "^1.1.2",
                 "phpstan/extension-installer": "^1.2.0",
                 "phpstan/phpstan": "^1.9.2",
                 "phpstan/phpstan-deprecation-rules": "^1.0.0",
                 "phpstan/phpstan-phpunit": "^1.2.2",
                 "phpstan/phpstan-strict-rules": "^1.4.4",
-                "phpunit/phpunit": "^9.5.26 || ^8.5.31",
-                "theofidry/php-cs-fixer-config": "^1.0",
+                "phpunit/phpunit": "^8.5.31 || ^9.5.26",
                 "webmozarts/strict-phpunit": "^7.5"
             },
             "type": "library",
@@ -7797,7 +8519,7 @@
             ],
             "support": {
                 "issues": "https://github.com/theofidry/cpu-core-counter/issues",
-                "source": "https://github.com/theofidry/cpu-core-counter/tree/0.5.1"
+                "source": "https://github.com/theofidry/cpu-core-counter/tree/1.2.0"
             },
             "funding": [
                 {
@@ -7805,7 +8527,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2022-12-24T12:35:10+00:00"
+            "time": "2024-08-06T10:04:20+00:00"
         },
         {
             "name": "hamcrest/hamcrest-php",
@@ -7860,7 +8582,7 @@
         },
         {
             "name": "hyde/monorepo-dev-tools",
-            "version": "dev-main",
+            "version": "dev-laravel-11",
             "dist": {
                 "type": "path",
                 "url": "./monorepo/DevTools",
@@ -7886,16 +8608,16 @@
         },
         {
             "name": "hyde/realtime-compiler",
-            "version": "dev-main",
+            "version": "dev-laravel-11",
             "dist": {
                 "type": "path",
                 "url": "./packages/realtime-compiler",
-                "reference": "6a68a736b9cb318aaaa6ee9c82ea508b0d45a985"
+                "reference": "0461e2b920c2af25a08bb45a95a53e63d94c30e8"
             },
             "require": {
                 "desilva/microserve": "^2.0",
                 "hyde/framework": "*",
-                "php": "^8.1"
+                "php": "^8.2"
             },
             "require-dev": {
                 "ext-zip": "*",
@@ -7942,20 +8664,20 @@
         },
         {
             "name": "hyde/testing",
-            "version": "dev-main",
+            "version": "dev-laravel-11",
             "dist": {
                 "type": "path",
                 "url": "./packages/testing",
-                "reference": "5ea9a00cc9a4698e45070d884500b613b12c2e5e"
+                "reference": "887244a39bbd417f09fe495999377f30d0d5327d"
             },
             "require": {
                 "ext-dom": "*",
                 "ext-libxml": "*",
-                "illuminate/support": "^10.0",
+                "illuminate/support": "^11.0",
                 "laravel/dusk": "^8.2.2",
                 "mockery/mockery": "^1.4.4",
                 "pestphp/pest": "^v2.1.0",
-                "php": "^8.0"
+                "php": "^8.2"
             },
             "type": "library",
             "extra": {
@@ -7993,46 +8715,42 @@
         },
         {
             "name": "illuminate/database",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/database.git",
-                "reference": "098df19dc27f8a1c938547fbaa0e308b405b61c5"
+                "reference": "a63391e43a6d38beb40fa21fc020d16c9b5352ea"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/database/zipball/098df19dc27f8a1c938547fbaa0e308b405b61c5",
-                "reference": "098df19dc27f8a1c938547fbaa0e308b405b61c5",
+                "url": "https://api.github.com/repos/illuminate/database/zipball/a63391e43a6d38beb40fa21fc020d16c9b5352ea",
+                "reference": "a63391e43a6d38beb40fa21fc020d16c9b5352ea",
                 "shasum": ""
             },
             "require": {
                 "brick/math": "^0.9.3|^0.10.2|^0.11|^0.12",
                 "ext-pdo": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/container": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1"
-            },
-            "conflict": {
-                "carbonphp/carbon-doctrine-types": ">=3.0",
-                "doctrine/dbal": ">=4.0"
+                "illuminate/collections": "^11.0",
+                "illuminate/container": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/support": "^11.0",
+                "laravel/serializable-closure": "^1.3|^2.0",
+                "php": "^8.2"
             },
             "suggest": {
-                "doctrine/dbal": "Required to rename columns and drop SQLite columns (^3.5.1).",
                 "ext-filter": "Required to use the Postgres database driver.",
-                "fakerphp/faker": "Required to use the eloquent factory builder (^1.21).",
-                "illuminate/console": "Required to use the database commands (^10.0).",
-                "illuminate/events": "Required to use the observers with Eloquent (^10.0).",
-                "illuminate/filesystem": "Required to use the migrations (^10.0).",
-                "illuminate/pagination": "Required to paginate the result set (^10.0).",
-                "symfony/finder": "Required to use Eloquent model factories (^6.2)."
+                "fakerphp/faker": "Required to use the eloquent factory builder (^1.24).",
+                "illuminate/console": "Required to use the database commands (^11.0).",
+                "illuminate/events": "Required to use the observers with Eloquent (^11.0).",
+                "illuminate/filesystem": "Required to use the migrations (^11.0).",
+                "illuminate/pagination": "Required to paginate the result set (^11.0).",
+                "symfony/finder": "Required to use Eloquent model factories (^7.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -8062,47 +8780,47 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-09-09T13:54:22+00:00"
+            "time": "2025-03-12T14:13:54+00:00"
         },
         {
             "name": "illuminate/routing",
-            "version": "v10.48.22",
+            "version": "v11.44.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/illuminate/routing.git",
-                "reference": "db74937fd10c0b2cbbe095a34f9c73e6f19c3d16"
+                "reference": "3a3007ef5b16632612fd1269409eb77da7ef162f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/illuminate/routing/zipball/db74937fd10c0b2cbbe095a34f9c73e6f19c3d16",
-                "reference": "db74937fd10c0b2cbbe095a34f9c73e6f19c3d16",
+                "url": "https://api.github.com/repos/illuminate/routing/zipball/3a3007ef5b16632612fd1269409eb77da7ef162f",
+                "reference": "3a3007ef5b16632612fd1269409eb77da7ef162f",
                 "shasum": ""
             },
             "require": {
                 "ext-filter": "*",
                 "ext-hash": "*",
-                "illuminate/collections": "^10.0",
-                "illuminate/container": "^10.0",
-                "illuminate/contracts": "^10.0",
-                "illuminate/http": "^10.0",
-                "illuminate/macroable": "^10.0",
-                "illuminate/pipeline": "^10.0",
-                "illuminate/session": "^10.0",
-                "illuminate/support": "^10.0",
-                "php": "^8.1",
-                "symfony/http-foundation": "^6.4",
-                "symfony/http-kernel": "^6.2",
-                "symfony/routing": "^6.2"
+                "illuminate/collections": "^11.0",
+                "illuminate/container": "^11.0",
+                "illuminate/contracts": "^11.0",
+                "illuminate/http": "^11.0",
+                "illuminate/macroable": "^11.0",
+                "illuminate/pipeline": "^11.0",
+                "illuminate/session": "^11.0",
+                "illuminate/support": "^11.0",
+                "php": "^8.2",
+                "symfony/http-foundation": "^7.0.3",
+                "symfony/http-kernel": "^7.0.3",
+                "symfony/routing": "^7.0.3"
             },
             "suggest": {
-                "illuminate/console": "Required to use the make commands (^10.0).",
-                "nyholm/psr7": "Required to use PSR-7 bridging features (^1.2).",
-                "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^2.0)."
+                "illuminate/console": "Required to use the make commands (^11.0).",
+                "php-http/discovery": "Required to use PSR-7 bridging features (^1.15).",
+                "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^7.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "10.x-dev"
+                    "dev-master": "11.x-dev"
                 }
             },
             "autoload": {
@@ -8126,32 +8844,33 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2024-05-27T13:41:52+00:00"
+            "time": "2025-02-19T19:24:24+00:00"
         },
         {
             "name": "jean85/pretty-package-versions",
-            "version": "2.0.6",
+            "version": "2.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/Jean85/pretty-package-versions.git",
-                "reference": "f9fdd29ad8e6d024f52678b570e5593759b550b4"
+                "reference": "4d7aa5dab42e2a76d99559706022885de0e18e1a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/Jean85/pretty-package-versions/zipball/f9fdd29ad8e6d024f52678b570e5593759b550b4",
-                "reference": "f9fdd29ad8e6d024f52678b570e5593759b550b4",
+                "url": "https://api.github.com/repos/Jean85/pretty-package-versions/zipball/4d7aa5dab42e2a76d99559706022885de0e18e1a",
+                "reference": "4d7aa5dab42e2a76d99559706022885de0e18e1a",
                 "shasum": ""
             },
             "require": {
-                "composer-runtime-api": "^2.0.0",
-                "php": "^7.1|^8.0"
+                "composer-runtime-api": "^2.1.0",
+                "php": "^7.4|^8.0"
             },
             "require-dev": {
                 "friendsofphp/php-cs-fixer": "^3.2",
                 "jean85/composer-provided-replaced-stub-package": "^1.0",
-                "phpstan/phpstan": "^1.4",
-                "phpunit/phpunit": "^7.5|^8.5|^9.4",
-                "vimeo/psalm": "^4.3"
+                "phpstan/phpstan": "^2.0",
+                "phpunit/phpunit": "^7.5|^8.5|^9.6",
+                "rector/rector": "^2.0",
+                "vimeo/psalm": "^4.3 || ^5.0"
             },
             "type": "library",
             "extra": {
@@ -8183,9 +8902,9 @@
             ],
             "support": {
                 "issues": "https://github.com/Jean85/pretty-package-versions/issues",
-                "source": "https://github.com/Jean85/pretty-package-versions/tree/2.0.6"
+                "source": "https://github.com/Jean85/pretty-package-versions/tree/2.1.1"
             },
-            "time": "2024-03-08T09:58:59+00:00"
+            "time": "2025-03-19T14:43:43+00:00"
         },
         {
             "name": "jetbrains/phpstorm-attributes",
@@ -8229,39 +8948,99 @@
             },
             "time": "2024-10-11T10:46:19+00:00"
         },
+        {
+            "name": "kelunik/certificate",
+            "version": "v1.1.3",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/kelunik/certificate.git",
+                "reference": "7e00d498c264d5eb4f78c69f41c8bd6719c0199e"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/kelunik/certificate/zipball/7e00d498c264d5eb4f78c69f41c8bd6719c0199e",
+                "reference": "7e00d498c264d5eb4f78c69f41c8bd6719c0199e",
+                "shasum": ""
+            },
+            "require": {
+                "ext-openssl": "*",
+                "php": ">=7.0"
+            },
+            "require-dev": {
+                "amphp/php-cs-fixer-config": "^2",
+                "phpunit/phpunit": "^6 | 7 | ^8 | ^9"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Kelunik\\Certificate\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "Access certificate details and transform between different formats.",
+            "keywords": [
+                "DER",
+                "certificate",
+                "certificates",
+                "openssl",
+                "pem",
+                "x509"
+            ],
+            "support": {
+                "issues": "https://github.com/kelunik/certificate/issues",
+                "source": "https://github.com/kelunik/certificate/tree/v1.1.3"
+            },
+            "time": "2023-02-03T21:26:53+00:00"
+        },
         {
             "name": "laravel/dusk",
-            "version": "v8.2.10",
+            "version": "v8.3.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/dusk.git",
-                "reference": "fde2ae6c1b32d2f8dbdcff300bbd6e2ccffb1bb4"
+                "reference": "bb701836357bf6f6c6658ef90b5a0f8232affb0f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/dusk/zipball/fde2ae6c1b32d2f8dbdcff300bbd6e2ccffb1bb4",
-                "reference": "fde2ae6c1b32d2f8dbdcff300bbd6e2ccffb1bb4",
+                "url": "https://api.github.com/repos/laravel/dusk/zipball/bb701836357bf6f6c6658ef90b5a0f8232affb0f",
+                "reference": "bb701836357bf6f6c6658ef90b5a0f8232affb0f",
                 "shasum": ""
             },
             "require": {
                 "ext-json": "*",
                 "ext-zip": "*",
                 "guzzlehttp/guzzle": "^7.5",
-                "illuminate/console": "^10.0|^11.0",
-                "illuminate/support": "^10.0|^11.0",
+                "illuminate/console": "^10.0|^11.0|^12.0",
+                "illuminate/support": "^10.0|^11.0|^12.0",
                 "php": "^8.1",
-                "php-webdriver/webdriver": "^1.9.0",
+                "php-webdriver/webdriver": "^1.15.2",
                 "symfony/console": "^6.2|^7.0",
                 "symfony/finder": "^6.2|^7.0",
                 "symfony/process": "^6.2|^7.0",
                 "vlucas/phpdotenv": "^5.2"
             },
             "require-dev": {
+                "laravel/framework": "^10.0|^11.0|^12.0",
                 "mockery/mockery": "^1.6",
-                "orchestra/testbench": "^8.19|^9.0",
+                "orchestra/testbench-core": "^8.19|^9.0|^10.0",
                 "phpstan/phpstan": "^1.10",
-                "phpunit/phpunit": "^10.1|^11.0",
-                "psy/psysh": "^0.11.12|^0.12"
+                "phpunit/phpunit": "^10.1|^11.0|^12.0.1",
+                "psy/psysh": "^0.11.12|^0.12",
+                "symfony/yaml": "^6.2|^7.0"
             },
             "suggest": {
                 "ext-pcntl": "Used to gracefully terminate Dusk when tests are running."
@@ -8291,57 +9070,269 @@
             ],
             "description": "Laravel Dusk provides simple end-to-end testing and browser automation.",
             "keywords": [
-                "laravel",
-                "testing",
-                "webdriver"
+                "laravel",
+                "testing",
+                "webdriver"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/dusk/issues",
+                "source": "https://github.com/laravel/dusk/tree/v8.3.2"
+            },
+            "time": "2025-02-20T14:42:00+00:00"
+        },
+        {
+            "name": "laravel/serializable-closure",
+            "version": "v2.0.3",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/serializable-closure.git",
+                "reference": "f379c13663245f7aa4512a7869f62eb14095f23f"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/f379c13663245f7aa4512a7869f62eb14095f23f",
+                "reference": "f379c13663245f7aa4512a7869f62eb14095f23f",
+                "shasum": ""
+            },
+            "require": {
+                "php": "^8.1"
+            },
+            "require-dev": {
+                "illuminate/support": "^10.0|^11.0|^12.0",
+                "nesbot/carbon": "^2.67|^3.0",
+                "pestphp/pest": "^2.36|^3.0",
+                "phpstan/phpstan": "^2.0",
+                "symfony/var-dumper": "^6.2.0|^7.0.0"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\SerializableClosure\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Taylor Otwell",
+                    "email": "taylor@laravel.com"
+                },
+                {
+                    "name": "Nuno Maduro",
+                    "email": "nuno@laravel.com"
+                }
+            ],
+            "description": "Laravel Serializable Closure provides an easy and secure way to serialize closures in PHP.",
+            "keywords": [
+                "closure",
+                "laravel",
+                "serializable"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/serializable-closure/issues",
+                "source": "https://github.com/laravel/serializable-closure"
+            },
+            "time": "2025-02-11T15:03:05+00:00"
+        },
+        {
+            "name": "laravel/tinker",
+            "version": "v2.10.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/tinker.git",
+                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/tinker/zipball/22177cc71807d38f2810c6204d8f7183d88a57d3",
+                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3",
+                "shasum": ""
+            },
+            "require": {
+                "illuminate/console": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/contracts": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
+                "illuminate/support": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
+                "php": "^7.2.5|^8.0",
+                "psy/psysh": "^0.11.1|^0.12.0",
+                "symfony/var-dumper": "^4.3.4|^5.0|^6.0|^7.0"
+            },
+            "require-dev": {
+                "mockery/mockery": "~1.3.3|^1.4.2",
+                "phpstan/phpstan": "^1.10",
+                "phpunit/phpunit": "^8.5.8|^9.3.3|^10.0"
+            },
+            "suggest": {
+                "illuminate/database": "The Illuminate Database package (^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0)."
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "providers": [
+                        "Laravel\\Tinker\\TinkerServiceProvider"
+                    ]
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\Tinker\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Taylor Otwell",
+                    "email": "taylor@laravel.com"
+                }
+            ],
+            "description": "Powerful REPL for the Laravel framework.",
+            "keywords": [
+                "REPL",
+                "Tinker",
+                "laravel",
+                "psysh"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/tinker/issues",
+                "source": "https://github.com/laravel/tinker/tree/v2.10.1"
+            },
+            "time": "2025-01-27T14:24:01+00:00"
+        },
+        {
+            "name": "league/uri",
+            "version": "7.5.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/thephpleague/uri.git",
+                "reference": "81fb5145d2644324614cc532b28efd0215bda430"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/thephpleague/uri/zipball/81fb5145d2644324614cc532b28efd0215bda430",
+                "reference": "81fb5145d2644324614cc532b28efd0215bda430",
+                "shasum": ""
+            },
+            "require": {
+                "league/uri-interfaces": "^7.5",
+                "php": "^8.1"
+            },
+            "conflict": {
+                "league/uri-schemes": "^1.0"
+            },
+            "suggest": {
+                "ext-bcmath": "to improve IPV4 host parsing",
+                "ext-fileinfo": "to create Data URI from file contennts",
+                "ext-gmp": "to improve IPV4 host parsing",
+                "ext-intl": "to handle IDN host with the best performance",
+                "jeremykendall/php-domain-parser": "to resolve Public Suffix and Top Level Domain",
+                "league/uri-components": "Needed to easily manipulate URI objects components",
+                "php-64bit": "to improve IPV4 host parsing",
+                "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "7.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "League\\Uri\\": ""
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Ignace Nyamagana Butera",
+                    "email": "nyamsprod@gmail.com",
+                    "homepage": "https://nyamsprod.com"
+                }
+            ],
+            "description": "URI manipulation library",
+            "homepage": "https://uri.thephpleague.com",
+            "keywords": [
+                "data-uri",
+                "file-uri",
+                "ftp",
+                "hostname",
+                "http",
+                "https",
+                "middleware",
+                "parse_str",
+                "parse_url",
+                "psr-7",
+                "query-string",
+                "querystring",
+                "rfc3986",
+                "rfc3987",
+                "rfc6570",
+                "uri",
+                "uri-template",
+                "url",
+                "ws"
             ],
             "support": {
-                "issues": "https://github.com/laravel/dusk/issues",
-                "source": "https://github.com/laravel/dusk/tree/v8.2.10"
+                "docs": "https://uri.thephpleague.com",
+                "forum": "https://thephpleague.slack.com",
+                "issues": "https://github.com/thephpleague/uri-src/issues",
+                "source": "https://github.com/thephpleague/uri/tree/7.5.1"
             },
-            "time": "2024-10-22T13:58:17+00:00"
+            "funding": [
+                {
+                    "url": "https://github.com/sponsors/nyamsprod",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-12-08T08:40:02+00:00"
         },
         {
-            "name": "laravel/tinker",
-            "version": "v2.10.1",
+            "name": "league/uri-interfaces",
+            "version": "7.5.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/laravel/tinker.git",
-                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3"
+                "url": "https://github.com/thephpleague/uri-interfaces.git",
+                "reference": "08cfc6c4f3d811584fb09c37e2849e6a7f9b0742"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/tinker/zipball/22177cc71807d38f2810c6204d8f7183d88a57d3",
-                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3",
+                "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/08cfc6c4f3d811584fb09c37e2849e6a7f9b0742",
+                "reference": "08cfc6c4f3d811584fb09c37e2849e6a7f9b0742",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "illuminate/contracts": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "illuminate/support": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "php": "^7.2.5|^8.0",
-                "psy/psysh": "^0.11.1|^0.12.0",
-                "symfony/var-dumper": "^4.3.4|^5.0|^6.0|^7.0"
-            },
-            "require-dev": {
-                "mockery/mockery": "~1.3.3|^1.4.2",
-                "phpstan/phpstan": "^1.10",
-                "phpunit/phpunit": "^8.5.8|^9.3.3|^10.0"
+                "ext-filter": "*",
+                "php": "^8.1",
+                "psr/http-factory": "^1",
+                "psr/http-message": "^1.1 || ^2.0"
             },
             "suggest": {
-                "illuminate/database": "The Illuminate Database package (^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0)."
+                "ext-bcmath": "to improve IPV4 host parsing",
+                "ext-gmp": "to improve IPV4 host parsing",
+                "ext-intl": "to handle IDN host with the best performance",
+                "php-64bit": "to improve IPV4 host parsing",
+                "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
             },
             "type": "library",
             "extra": {
-                "laravel": {
-                    "providers": [
-                        "Laravel\\Tinker\\TinkerServiceProvider"
-                    ]
+                "branch-alias": {
+                    "dev-master": "7.x-dev"
                 }
             },
             "autoload": {
                 "psr-4": {
-                    "Laravel\\Tinker\\": "src/"
+                    "League\\Uri\\": ""
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -8350,22 +9341,45 @@
             ],
             "authors": [
                 {
-                    "name": "Taylor Otwell",
-                    "email": "taylor@laravel.com"
+                    "name": "Ignace Nyamagana Butera",
+                    "email": "nyamsprod@gmail.com",
+                    "homepage": "https://nyamsprod.com"
                 }
             ],
-            "description": "Powerful REPL for the Laravel framework.",
+            "description": "Common interfaces and classes for URI representation and interaction",
+            "homepage": "https://uri.thephpleague.com",
             "keywords": [
-                "REPL",
-                "Tinker",
-                "laravel",
-                "psysh"
+                "data-uri",
+                "file-uri",
+                "ftp",
+                "hostname",
+                "http",
+                "https",
+                "parse_str",
+                "parse_url",
+                "psr-7",
+                "query-string",
+                "querystring",
+                "rfc3986",
+                "rfc3987",
+                "rfc6570",
+                "uri",
+                "url",
+                "ws"
             ],
             "support": {
-                "issues": "https://github.com/laravel/tinker/issues",
-                "source": "https://github.com/laravel/tinker/tree/v2.10.1"
+                "docs": "https://uri.thephpleague.com",
+                "forum": "https://thephpleague.slack.com",
+                "issues": "https://github.com/thephpleague/uri-src/issues",
+                "source": "https://github.com/thephpleague/uri-interfaces/tree/7.5.0"
             },
-            "time": "2025-01-27T14:24:01+00:00"
+            "funding": [
+                {
+                    "url": "https://github.com/sponsors/nyamsprod",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-12-08T08:18:47+00:00"
         },
         {
             "name": "mockery/mockery",
@@ -8452,16 +9466,16 @@
         },
         {
             "name": "myclabs/deep-copy",
-            "version": "1.12.1",
+            "version": "1.13.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/myclabs/DeepCopy.git",
-                "reference": "123267b2c49fbf30d78a7b2d333f6be754b94845"
+                "reference": "024473a478be9df5fdaca2c793f2232fe788e414"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/123267b2c49fbf30d78a7b2d333f6be754b94845",
-                "reference": "123267b2c49fbf30d78a7b2d333f6be754b94845",
+                "url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/024473a478be9df5fdaca2c793f2232fe788e414",
+                "reference": "024473a478be9df5fdaca2c793f2232fe788e414",
                 "shasum": ""
             },
             "require": {
@@ -8500,7 +9514,7 @@
             ],
             "support": {
                 "issues": "https://github.com/myclabs/DeepCopy/issues",
-                "source": "https://github.com/myclabs/DeepCopy/tree/1.12.1"
+                "source": "https://github.com/myclabs/DeepCopy/tree/1.13.0"
             },
             "funding": [
                 {
@@ -8508,7 +9522,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-08T17:47:46+00:00"
+            "time": "2025-02-12T12:17:51+00:00"
         },
         {
             "name": "netresearch/jsonmapper",
@@ -8563,25 +9577,27 @@
         },
         {
             "name": "nikic/php-parser",
-            "version": "v4.19.4",
+            "version": "v5.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nikic/PHP-Parser.git",
-                "reference": "715f4d25e225bc47b293a8b997fe6ce99bf987d2"
+                "reference": "447a020a1f875a434d62f2a401f53b82a396e494"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/715f4d25e225bc47b293a8b997fe6ce99bf987d2",
-                "reference": "715f4d25e225bc47b293a8b997fe6ce99bf987d2",
+                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/447a020a1f875a434d62f2a401f53b82a396e494",
+                "reference": "447a020a1f875a434d62f2a401f53b82a396e494",
                 "shasum": ""
             },
             "require": {
+                "ext-ctype": "*",
+                "ext-json": "*",
                 "ext-tokenizer": "*",
-                "php": ">=7.1"
+                "php": ">=7.4"
             },
             "require-dev": {
                 "ircmaxell/php-yacc": "^0.0.7",
-                "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0"
+                "phpunit/phpunit": "^9.0"
             },
             "bin": [
                 "bin/php-parse"
@@ -8589,7 +9605,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "4.9-dev"
+                    "dev-master": "5.0-dev"
                 }
             },
             "autoload": {
@@ -8613,63 +9629,119 @@
             ],
             "support": {
                 "issues": "https://github.com/nikic/PHP-Parser/issues",
-                "source": "https://github.com/nikic/PHP-Parser/tree/v4.19.4"
+                "source": "https://github.com/nikic/PHP-Parser/tree/v5.4.0"
+            },
+            "time": "2024-12-30T11:07:19+00:00"
+        },
+        {
+            "name": "orchestra/sidekick",
+            "version": "v1.1.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/orchestral/sidekick.git",
+                "reference": "33c6b297761a1b2bd398e99245bf85e17773723b"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/orchestral/sidekick/zipball/33c6b297761a1b2bd398e99245bf85e17773723b",
+                "reference": "33c6b297761a1b2bd398e99245bf85e17773723b",
+                "shasum": ""
+            },
+            "require": {
+                "composer-runtime-api": "^2.2",
+                "php": "^8.0",
+                "symfony/polyfill-php83": "^1.31"
+            },
+            "require-dev": {
+                "laravel/framework": "^9.52.16|^10.48.29|^11.44.1|^12.1.1|^13.0",
+                "laravel/pint": "^1.4",
+                "phpstan/phpstan": "^2.1",
+                "phpunit/phpunit": "^9.6|^10.0|^11.0|^12.0",
+                "symfony/process": "^6.0|^7.0"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/Eloquent/functions.php",
+                    "src/Http/functions.php",
+                    "src/functions.php"
+                ],
+                "psr-4": {
+                    "Orchestra\\Sidekick\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Mior Muhammad Zaki",
+                    "email": "crynobone@gmail.com"
+                }
+            ],
+            "description": "Packages Toolkit Utilities and Helpers for Laravel",
+            "support": {
+                "issues": "https://github.com/orchestral/sidekick/issues",
+                "source": "https://github.com/orchestral/sidekick/tree/v1.1.0"
             },
-            "time": "2024-09-29T15:01:53+00:00"
+            "time": "2025-03-15T16:02:42+00:00"
         },
         {
             "name": "orchestra/testbench-core",
-            "version": "v8.28.5",
+            "version": "v9.12.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/orchestral/testbench-core.git",
-                "reference": "47374b1f22f520bc9d2eb1709b272c0614f96064"
+                "reference": "af32a4e2ec2f4db965a8996fb8ee88bb0077229e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/orchestral/testbench-core/zipball/47374b1f22f520bc9d2eb1709b272c0614f96064",
-                "reference": "47374b1f22f520bc9d2eb1709b272c0614f96064",
+                "url": "https://api.github.com/repos/orchestral/testbench-core/zipball/af32a4e2ec2f4db965a8996fb8ee88bb0077229e",
+                "reference": "af32a4e2ec2f4db965a8996fb8ee88bb0077229e",
                 "shasum": ""
             },
             "require": {
                 "composer-runtime-api": "^2.2",
-                "php": "^8.1",
-                "symfony/polyfill-php83": "^1.28"
+                "orchestra/sidekick": "^1.0.5",
+                "php": "^8.2",
+                "symfony/deprecation-contracts": "^2.5|^3.0",
+                "symfony/polyfill-php83": "^1.31",
+                "symfony/polyfill-php84": "^1.31"
             },
             "conflict": {
-                "brianium/paratest": "<6.4.0 || >=7.0.0 <7.1.4 || >=8.0.0",
-                "laravel/framework": "<10.48.22 || >=11.0.0",
-                "laravel/serializable-closure": "<1.3.0 || >=2.0.0",
-                "nunomaduro/collision": "<6.4.0 || >=7.0.0 <7.4.0 || >=8.0.0",
-                "orchestra/testbench-dusk": "<8.21.0 || >=9.0.0",
-                "orchestra/workbench": "<1.0.0",
-                "phpunit/phpunit": "<9.6.0 || >=10.3.0 <10.3.3 || >=10.6.0"
+                "brianium/paratest": "<7.3.0|>=8.0.0",
+                "laravel/framework": "<11.44.1|>=12.0.0",
+                "laravel/serializable-closure": "<1.3.0|>=3.0.0",
+                "nunomaduro/collision": "<8.0.0|>=9.0.0",
+                "orchestra/testbench-dusk": "<9.10.0|>=10.0.0",
+                "phpunit/phpunit": "<10.5.35|>=11.0.0 <11.3.6|>=12.0.0 <12.0.1|>=12.1.0"
             },
             "require-dev": {
-                "fakerphp/faker": "^1.21",
-                "laravel/framework": "^10.48.22",
-                "laravel/pint": "^1.17",
-                "mockery/mockery": "^1.5.1",
-                "phpstan/phpstan": "^1.11",
-                "phpunit/phpunit": "^10.1",
-                "spatie/laravel-ray": "^1.32.4",
-                "symfony/process": "^6.2",
-                "symfony/yaml": "^6.2",
-                "vlucas/phpdotenv": "^5.4.1"
+                "fakerphp/faker": "^1.24",
+                "laravel/framework": "^11.44.1",
+                "laravel/pint": "^1.20",
+                "laravel/serializable-closure": "^1.3|^2.0",
+                "mockery/mockery": "^1.6.10",
+                "phpstan/phpstan": "^2.1",
+                "phpunit/phpunit": "^10.5.35|^11.3.6|^12.0.1",
+                "spatie/laravel-ray": "^1.39",
+                "symfony/process": "^7.0.3",
+                "symfony/yaml": "^7.0.3",
+                "vlucas/phpdotenv": "^5.6.1"
             },
             "suggest": {
-                "brianium/paratest": "Allow using parallel testing (^6.4 || ^7.1.4).",
+                "brianium/paratest": "Allow using parallel testing (^7.3).",
                 "ext-pcntl": "Required to use all features of the console signal trapping.",
-                "fakerphp/faker": "Allow using Faker for testing (^1.21).",
-                "laravel/framework": "Required for testing (^10.48.20).",
-                "mockery/mockery": "Allow using Mockery for testing (^1.5.1).",
-                "nunomaduro/collision": "Allow using Laravel style tests output and parallel testing (^6.4 || ^7.4).",
-                "orchestra/testbench-browser-kit": "Allow using legacy Laravel BrowserKit for testing (^8.0).",
-                "orchestra/testbench-dusk": "Allow using Laravel Dusk for testing (^8.0).",
-                "phpunit/phpunit": "Allow using PHPUnit for testing (^9.6 || ^10.1).",
-                "symfony/process": "Required to use Orchestra\\Testbench\\remote function (^6.2).",
-                "symfony/yaml": "Required for Testbench CLI (^6.2).",
-                "vlucas/phpdotenv": "Required for Testbench CLI (^5.4.1)."
+                "fakerphp/faker": "Allow using Faker for testing (^1.23).",
+                "laravel/framework": "Required for testing (^11.44.0).",
+                "mockery/mockery": "Allow using Mockery for testing (^1.6).",
+                "nunomaduro/collision": "Allow using Laravel style tests output and parallel testing (^8.0).",
+                "orchestra/testbench-dusk": "Allow using Laravel Dusk for testing (^9.10).",
+                "phpunit/phpunit": "Allow using PHPUnit for testing (^10.5|^11.0).",
+                "symfony/process": "Required to use Orchestra\\Testbench\\remote function (^7.0).",
+                "symfony/yaml": "Required for Testbench CLI (^7.0).",
+                "vlucas/phpdotenv": "Required for Testbench CLI (^5.6.1)."
             },
             "bin": [
                 "testbench"
@@ -8708,7 +9780,7 @@
                 "issues": "https://github.com/orchestral/testbench/issues",
                 "source": "https://github.com/orchestral/testbench-core"
             },
-            "time": "2024-10-25T14:40:30+00:00"
+            "time": "2025-03-06T10:15:41+00:00"
         },
         {
             "name": "pestphp/pest",
@@ -9152,16 +10224,16 @@
         },
         {
             "name": "php-webdriver/webdriver",
-            "version": "1.15.1",
+            "version": "1.15.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-webdriver/php-webdriver.git",
-                "reference": "cd52d9342c5aa738c2e75a67e47a1b6df97154e8"
+                "reference": "998e499b786805568deaf8cbf06f4044f05d91bf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-webdriver/php-webdriver/zipball/cd52d9342c5aa738c2e75a67e47a1b6df97154e8",
-                "reference": "cd52d9342c5aa738c2e75a67e47a1b6df97154e8",
+                "url": "https://api.github.com/repos/php-webdriver/php-webdriver/zipball/998e499b786805568deaf8cbf06f4044f05d91bf",
+                "reference": "998e499b786805568deaf8cbf06f4044f05d91bf",
                 "shasum": ""
             },
             "require": {
@@ -9183,7 +10255,7 @@
                 "php-parallel-lint/php-parallel-lint": "^1.2",
                 "phpunit/phpunit": "^9.3",
                 "squizlabs/php_codesniffer": "^3.5",
-                "symfony/var-dumper": "^5.0 || ^6.0"
+                "symfony/var-dumper": "^5.0 || ^6.0 || ^7.0"
             },
             "suggest": {
                 "ext-SimpleXML": "For Firefox profile creation"
@@ -9212,9 +10284,9 @@
             ],
             "support": {
                 "issues": "https://github.com/php-webdriver/php-webdriver/issues",
-                "source": "https://github.com/php-webdriver/php-webdriver/tree/1.15.1"
+                "source": "https://github.com/php-webdriver/php-webdriver/tree/1.15.2"
             },
-            "time": "2023-10-20T12:21:20+00:00"
+            "time": "2024-11-21T15:12:59+00:00"
         },
         {
             "name": "phpdocumentor/reflection-common",
@@ -9271,16 +10343,16 @@
         },
         {
             "name": "phpdocumentor/reflection-docblock",
-            "version": "5.5.1",
+            "version": "5.6.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpDocumentor/ReflectionDocBlock.git",
-                "reference": "0c70d2c566e899666f367ab7b80986beb3581e6f"
+                "reference": "e5e784149a09bd69d9a5e3b01c5cbd2e2bd653d8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/0c70d2c566e899666f367ab7b80986beb3581e6f",
-                "reference": "0c70d2c566e899666f367ab7b80986beb3581e6f",
+                "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/e5e784149a09bd69d9a5e3b01c5cbd2e2bd653d8",
+                "reference": "e5e784149a09bd69d9a5e3b01c5cbd2e2bd653d8",
                 "shasum": ""
             },
             "require": {
@@ -9289,7 +10361,7 @@
                 "php": "^7.4 || ^8.0",
                 "phpdocumentor/reflection-common": "^2.2",
                 "phpdocumentor/type-resolver": "^1.7",
-                "phpstan/phpdoc-parser": "^1.7",
+                "phpstan/phpdoc-parser": "^1.7|^2.0",
                 "webmozart/assert": "^1.9.1"
             },
             "require-dev": {
@@ -9329,9 +10401,9 @@
             "description": "With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.",
             "support": {
                 "issues": "https://github.com/phpDocumentor/ReflectionDocBlock/issues",
-                "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.5.1"
+                "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.6.1"
             },
-            "time": "2024-11-06T11:58:54+00:00"
+            "time": "2024-12-07T09:39:29+00:00"
         },
         {
             "name": "phpdocumentor/type-resolver",
@@ -9393,30 +10465,30 @@
         },
         {
             "name": "phpstan/phpdoc-parser",
-            "version": "1.33.0",
+            "version": "2.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpstan/phpdoc-parser.git",
-                "reference": "82a311fd3690fb2bf7b64d5c98f912b3dd746140"
+                "reference": "9b30d6fd026b2c132b3985ce6b23bec09ab3aa68"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpstan/phpdoc-parser/zipball/82a311fd3690fb2bf7b64d5c98f912b3dd746140",
-                "reference": "82a311fd3690fb2bf7b64d5c98f912b3dd746140",
+                "url": "https://api.github.com/repos/phpstan/phpdoc-parser/zipball/9b30d6fd026b2c132b3985ce6b23bec09ab3aa68",
+                "reference": "9b30d6fd026b2c132b3985ce6b23bec09ab3aa68",
                 "shasum": ""
             },
             "require": {
-                "php": "^7.2 || ^8.0"
+                "php": "^7.4 || ^8.0"
             },
             "require-dev": {
                 "doctrine/annotations": "^2.0",
-                "nikic/php-parser": "^4.15",
+                "nikic/php-parser": "^5.3.0",
                 "php-parallel-lint/php-parallel-lint": "^1.2",
                 "phpstan/extension-installer": "^1.0",
-                "phpstan/phpstan": "^1.5",
-                "phpstan/phpstan-phpunit": "^1.1",
-                "phpstan/phpstan-strict-rules": "^1.0",
-                "phpunit/phpunit": "^9.5",
+                "phpstan/phpstan": "^2.0",
+                "phpstan/phpstan-phpunit": "^2.0",
+                "phpstan/phpstan-strict-rules": "^2.0",
+                "phpunit/phpunit": "^9.6",
                 "symfony/process": "^5.2"
             },
             "type": "library",
@@ -9434,22 +10506,22 @@
             "description": "PHPDoc parser with support for nullable, intersection and generic types",
             "support": {
                 "issues": "https://github.com/phpstan/phpdoc-parser/issues",
-                "source": "https://github.com/phpstan/phpdoc-parser/tree/1.33.0"
+                "source": "https://github.com/phpstan/phpdoc-parser/tree/2.1.0"
             },
-            "time": "2024-10-13T11:25:22+00:00"
+            "time": "2025-02-19T13:28:12+00:00"
         },
         {
             "name": "phpstan/phpstan",
-            "version": "1.12.9",
+            "version": "1.12.21",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpstan/phpstan.git",
-                "reference": "ceb937fb39a92deabc02d20709cf14b2c452502c"
+                "reference": "14276fdef70575106a3392a4ed553c06a984df28"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpstan/phpstan/zipball/ceb937fb39a92deabc02d20709cf14b2c452502c",
-                "reference": "ceb937fb39a92deabc02d20709cf14b2c452502c",
+                "url": "https://api.github.com/repos/phpstan/phpstan/zipball/14276fdef70575106a3392a4ed553c06a984df28",
+                "reference": "14276fdef70575106a3392a4ed553c06a984df28",
                 "shasum": ""
             },
             "require": {
@@ -9494,7 +10566,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-11-10T17:10:04+00:00"
+            "time": "2025-03-09T09:24:50+00:00"
         },
         {
             "name": "phpunit/php-code-coverage",
@@ -9920,16 +10992,16 @@
         },
         {
             "name": "psalm/plugin-laravel",
-            "version": "v2.11.0",
+            "version": "v2.12.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/psalm/psalm-plugin-laravel.git",
-                "reference": "ffd51399b672959331ed3ef4eaae13984474e2f0"
+                "reference": "c7910a1e199fe26812df2381ede086aaa256d222"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/psalm/psalm-plugin-laravel/zipball/ffd51399b672959331ed3ef4eaae13984474e2f0",
-                "reference": "ffd51399b672959331ed3ef4eaae13984474e2f0",
+                "url": "https://api.github.com/repos/psalm/psalm-plugin-laravel/zipball/c7910a1e199fe26812df2381ede086aaa256d222",
+                "reference": "c7910a1e199fe26812df2381ede086aaa256d222",
                 "shasum": ""
             },
             "require": {
@@ -9949,7 +11021,7 @@
                 "php": "^8.1",
                 "symfony/console": "^6.0 || ^7.0",
                 "symfony/finder": "^6.0 || ^7.0",
-                "vimeo/psalm": "^5.20"
+                "vimeo/psalm": "^5.20|^6"
             },
             "require-dev": {
                 "laravel/framework": "^10.48 || ^11.0",
@@ -9986,22 +11058,22 @@
             "homepage": "https://github.com/psalm/psalm-plugin-laravel",
             "support": {
                 "issues": "https://github.com/psalm/psalm-plugin-laravel/issues",
-                "source": "https://github.com/psalm/psalm-plugin-laravel/tree/v2.11.0"
+                "source": "https://github.com/psalm/psalm-plugin-laravel/tree/v2.12.1"
             },
-            "time": "2024-03-19T21:40:03+00:00"
+            "time": "2025-02-16T19:03:28+00:00"
         },
         {
             "name": "psy/psysh",
-            "version": "v0.12.7",
+            "version": "v0.12.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/bobthecow/psysh.git",
-                "reference": "d73fa3c74918ef4522bb8a3bf9cab39161c4b57c"
+                "reference": "85057ceedee50c49d4f6ecaff73ee96adb3b3625"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/d73fa3c74918ef4522bb8a3bf9cab39161c4b57c",
-                "reference": "d73fa3c74918ef4522bb8a3bf9cab39161c4b57c",
+                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/85057ceedee50c49d4f6ecaff73ee96adb3b3625",
+                "reference": "85057ceedee50c49d4f6ecaff73ee96adb3b3625",
                 "shasum": ""
             },
             "require": {
@@ -10065,9 +11137,81 @@
             ],
             "support": {
                 "issues": "https://github.com/bobthecow/psysh/issues",
-                "source": "https://github.com/bobthecow/psysh/tree/v0.12.7"
+                "source": "https://github.com/bobthecow/psysh/tree/v0.12.8"
+            },
+            "time": "2025-03-16T03:05:19+00:00"
+        },
+        {
+            "name": "revolt/event-loop",
+            "version": "v1.0.7",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/revoltphp/event-loop.git",
+                "reference": "09bf1bf7f7f574453efe43044b06fafe12216eb3"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/revoltphp/event-loop/zipball/09bf1bf7f7f574453efe43044b06fafe12216eb3",
+                "reference": "09bf1bf7f7f574453efe43044b06fafe12216eb3",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=8.1"
+            },
+            "require-dev": {
+                "ext-json": "*",
+                "jetbrains/phpstorm-stubs": "^2019.3",
+                "phpunit/phpunit": "^9",
+                "psalm/phar": "^5.15"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Revolt\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Aaron Piotrowski",
+                    "email": "aaron@trowski.com"
+                },
+                {
+                    "name": "Cees-Jan Kiewiet",
+                    "email": "ceesjank@gmail.com"
+                },
+                {
+                    "name": "Christian Lück",
+                    "email": "christian@clue.engineering"
+                },
+                {
+                    "name": "Niklas Keller",
+                    "email": "me@kelunik.com"
+                }
+            ],
+            "description": "Rock-solid event loop for concurrent PHP applications.",
+            "keywords": [
+                "async",
+                "asynchronous",
+                "concurrency",
+                "event",
+                "event-loop",
+                "non-blocking",
+                "scheduler"
+            ],
+            "support": {
+                "issues": "https://github.com/revoltphp/event-loop/issues",
+                "source": "https://github.com/revoltphp/event-loop/tree/v1.0.7"
             },
-            "time": "2024-12-10T01:58:33+00:00"
+            "time": "2025-01-25T19:27:39+00:00"
         },
         {
             "name": "sebastian/cli-parser",
@@ -10987,29 +12131,33 @@
         },
         {
             "name": "spatie/array-to-xml",
-            "version": "2.17.1",
+            "version": "3.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/spatie/array-to-xml.git",
-                "reference": "5cbec9c6ab17e320c58a259f0cebe88bde4a7c46"
+                "reference": "7dcfc67d60b0272926dabad1ec01f6b8a5fb5e67"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/spatie/array-to-xml/zipball/5cbec9c6ab17e320c58a259f0cebe88bde4a7c46",
-                "reference": "5cbec9c6ab17e320c58a259f0cebe88bde4a7c46",
+                "url": "https://api.github.com/repos/spatie/array-to-xml/zipball/7dcfc67d60b0272926dabad1ec01f6b8a5fb5e67",
+                "reference": "7dcfc67d60b0272926dabad1ec01f6b8a5fb5e67",
                 "shasum": ""
             },
             "require": {
                 "ext-dom": "*",
-                "php": "^7.4|^8.0"
+                "php": "^8.0"
             },
             "require-dev": {
                 "mockery/mockery": "^1.2",
                 "pestphp/pest": "^1.21",
-                "phpunit/phpunit": "^9.0",
                 "spatie/pest-plugin-snapshots": "^1.1"
             },
             "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "3.x-dev"
+                }
+            },
             "autoload": {
                 "psr-4": {
                     "Spatie\\ArrayToXml\\": "src"
@@ -11035,7 +12183,7 @@
                 "xml"
             ],
             "support": {
-                "source": "https://github.com/spatie/array-to-xml/tree/2.17.1"
+                "source": "https://github.com/spatie/array-to-xml/tree/3.4.0"
             },
             "funding": [
                 {
@@ -11047,29 +12195,29 @@
                     "type": "github"
                 }
             ],
-            "time": "2022-12-26T08:22:07+00:00"
+            "time": "2024-12-16T12:45:15+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v6.4.13",
+            "version": "v7.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3"
+                "reference": "b8dce482de9d7c9fe2891155035a7248ab5c7fdb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/4856c9cf585d5a0313d8d35afd681a526f038dd3",
-                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/b8dce482de9d7c9fe2891155035a7248ab5c7fdb",
+                "reference": "b8dce482de9d7c9fe2891155035a7248ab5c7fdb",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.8"
             },
             "require-dev": {
-                "symfony/process": "^5.4|^6.4|^7.0"
+                "symfony/process": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -11097,7 +12245,83 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v6.4.13"
+                "source": "https://github.com/symfony/filesystem/tree/v7.2.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2024-10-25T15:15:23+00:00"
+        },
+        {
+            "name": "symfony/polyfill-php84",
+            "version": "v1.31.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-php84.git",
+                "reference": "e5493eb51311ab0b1cc2243416613f06ed8f18bd"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-php84/zipball/e5493eb51311ab0b1cc2243416613f06ed8f18bd",
+                "reference": "e5493eb51311ab0b1cc2243416613f06ed8f18bd",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2"
+            },
+            "type": "library",
+            "extra": {
+                "thanks": {
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "files": [
+                    "bootstrap.php"
+                ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php84\\": ""
+                },
+                "classmap": [
+                    "Resources/stubs"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill backporting some PHP 8.4+ features to lower PHP versions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-php84/tree/v1.31.0"
             },
             "funding": [
                 {
@@ -11113,40 +12337,38 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-10-25T15:07:50+00:00"
+            "time": "2024-09-09T12:04:04+00:00"
         },
         {
             "name": "symfony/routing",
-            "version": "v6.4.13",
+            "version": "v7.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/routing.git",
-                "reference": "640a74250d13f9c30d5ca045b6aaaabcc8215278"
+                "reference": "ee9a67edc6baa33e5fae662f94f91fd262930996"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/routing/zipball/640a74250d13f9c30d5ca045b6aaaabcc8215278",
-                "reference": "640a74250d13f9c30d5ca045b6aaaabcc8215278",
+                "url": "https://api.github.com/repos/symfony/routing/zipball/ee9a67edc6baa33e5fae662f94f91fd262930996",
+                "reference": "ee9a67edc6baa33e5fae662f94f91fd262930996",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/deprecation-contracts": "^2.5|^3"
             },
             "conflict": {
-                "doctrine/annotations": "<1.12",
-                "symfony/config": "<6.2",
-                "symfony/dependency-injection": "<5.4",
-                "symfony/yaml": "<5.4"
+                "symfony/config": "<6.4",
+                "symfony/dependency-injection": "<6.4",
+                "symfony/yaml": "<6.4"
             },
             "require-dev": {
-                "doctrine/annotations": "^1.12|^2",
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.2|^7.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/expression-language": "^5.4|^6.0|^7.0",
-                "symfony/http-foundation": "^5.4|^6.0|^7.0",
-                "symfony/yaml": "^5.4|^6.0|^7.0"
+                "symfony/config": "^6.4|^7.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/expression-language": "^6.4|^7.0",
+                "symfony/http-foundation": "^6.4|^7.0",
+                "symfony/yaml": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -11180,7 +12402,7 @@
                 "url"
             ],
             "support": {
-                "source": "https://github.com/symfony/routing/tree/v6.4.13"
+                "source": "https://github.com/symfony/routing/tree/v7.2.3"
             },
             "funding": [
                 {
@@ -11196,7 +12418,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-10-01T08:30:56+00:00"
+            "time": "2025-01-17T10:56:55+00:00"
         },
         {
             "name": "ta-tikoma/phpunit-architecture-test",
@@ -11366,21 +12588,22 @@
         },
         {
             "name": "vimeo/psalm",
-            "version": "5.26.1",
+            "version": "6.5.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/vimeo/psalm.git",
-                "reference": "d747f6500b38ac4f7dfc5edbcae6e4b637d7add0"
+                "reference": "38fc8444edf0cebc9205296ee6e30e906ade783b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/vimeo/psalm/zipball/d747f6500b38ac4f7dfc5edbcae6e4b637d7add0",
-                "reference": "d747f6500b38ac4f7dfc5edbcae6e4b637d7add0",
+                "url": "https://api.github.com/repos/vimeo/psalm/zipball/38fc8444edf0cebc9205296ee6e30e906ade783b",
+                "reference": "38fc8444edf0cebc9205296ee6e30e906ade783b",
                 "shasum": ""
             },
             "require": {
-                "amphp/amp": "^2.4.2",
-                "amphp/byte-stream": "^1.5",
+                "amphp/amp": "^3",
+                "amphp/byte-stream": "^2",
+                "amphp/parallel": "^2.3",
                 "composer-runtime-api": "^2",
                 "composer/semver": "^1.4 || ^2.0 || ^3.0",
                 "composer/xdebug-handler": "^2.0 || ^3.0",
@@ -11393,26 +12616,24 @@
                 "ext-simplexml": "*",
                 "ext-tokenizer": "*",
                 "felixfbecker/advanced-json-rpc": "^3.1",
-                "felixfbecker/language-server-protocol": "^1.5.2",
+                "felixfbecker/language-server-protocol": "^1.5.3",
                 "fidry/cpu-core-counter": "^0.4.1 || ^0.5.1 || ^1.0.0",
                 "netresearch/jsonmapper": "^1.0 || ^2.0 || ^3.0 || ^4.0",
-                "nikic/php-parser": "^4.17",
-                "php": "^7.4 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0",
-                "sebastian/diff": "^4.0 || ^5.0 || ^6.0",
+                "nikic/php-parser": "^5.0.0",
+                "php": "~8.1.17 || ~8.2.4 || ~8.3.0 || ~8.4.0",
+                "sebastian/diff": "^4.0 || ^5.0 || ^6.0 || ^7.0",
                 "spatie/array-to-xml": "^2.17.0 || ^3.0",
-                "symfony/console": "^4.1.6 || ^5.0 || ^6.0 || ^7.0",
-                "symfony/filesystem": "^5.4 || ^6.0 || ^7.0"
-            },
-            "conflict": {
-                "nikic/php-parser": "4.17.0"
+                "symfony/console": "^6.0 || ^7.0",
+                "symfony/filesystem": "^6.0 || ^7.0"
             },
             "provide": {
                 "psalm/psalm": "self.version"
             },
             "require-dev": {
-                "amphp/phpunit-util": "^2.0",
+                "amphp/phpunit-util": "^3",
                 "bamarni/composer-bin-plugin": "^1.4",
                 "brianium/paratest": "^6.9",
+                "dg/bypass-finals": "^1.5",
                 "ext-curl": "*",
                 "mockery/mockery": "^1.5",
                 "nunomaduro/mock-final-classes": "^1.1",
@@ -11420,10 +12641,10 @@
                 "phpstan/phpdoc-parser": "^1.6",
                 "phpunit/phpunit": "^9.6",
                 "psalm/plugin-mockery": "^1.1",
-                "psalm/plugin-phpunit": "^0.18",
+                "psalm/plugin-phpunit": "^0.19",
                 "slevomat/coding-standard": "^8.4",
                 "squizlabs/php_codesniffer": "^3.6",
-                "symfony/process": "^4.4 || ^5.0 || ^6.0 || ^7.0"
+                "symfony/process": "^6.0 || ^7.0"
             },
             "suggest": {
                 "ext-curl": "In order to send data to shepherd",
@@ -11434,16 +12655,19 @@
                 "psalm-language-server",
                 "psalm-plugin",
                 "psalm-refactor",
+                "psalm-review",
                 "psalter"
             ],
             "type": "project",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "5.x-dev",
-                    "dev-4.x": "4.x-dev",
-                    "dev-3.x": "3.x-dev",
+                    "dev-1.x": "1.x-dev",
                     "dev-2.x": "2.x-dev",
-                    "dev-1.x": "1.x-dev"
+                    "dev-3.x": "3.x-dev",
+                    "dev-4.x": "4.x-dev",
+                    "dev-5.x": "5.x-dev",
+                    "dev-6.x": "6.x-dev",
+                    "dev-master": "7.x-dev"
                 }
             },
             "autoload": {
@@ -11458,6 +12682,10 @@
             "authors": [
                 {
                     "name": "Matthew Brown"
+                },
+                {
+                    "name": "Daniil Gentili",
+                    "email": "daniil@daniil.it"
                 }
             ],
             "description": "A static analysis tool for finding errors in PHP applications",
@@ -11472,7 +12700,7 @@
                 "issues": "https://github.com/vimeo/psalm/issues",
                 "source": "https://github.com/vimeo/psalm"
             },
-            "time": "2024-09-08T18:53:08+00:00"
+            "time": "2025-02-07T20:42:25+00:00"
         }
     ],
     "aliases": [],
@@ -11484,8 +12712,8 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": "^8.1"
+        "php": "^8.2"
     },
-    "platform-dev": [],
-    "plugin-api-version": "2.3.0"
+    "platform-dev": {},
+    "plugin-api-version": "2.6.0"
 }

From 69a20506a5d77664973a08327b5f053934dcaf24 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 22 Mar 2025 20:28:59 +0100
Subject: [PATCH 3941/4023] Update PhpStorm configuration files

---
 .idea/develop.iml | 23 +++++++++++++++++++++++
 .idea/php.xml     | 22 ++++++++++++++++++++--
 .idea/phpunit.xml |  1 -
 3 files changed, 43 insertions(+), 3 deletions(-)

diff --git a/.idea/develop.iml b/.idea/develop.iml
index e5c500c8de7..d55c9677f2f 100644
--- a/.idea/develop.iml
+++ b/.idea/develop.iml
@@ -13,6 +13,10 @@
       <sourceFolder url="file://$MODULE_DIR$/packages/hyde/app" isTestSource="false" packagePrefix="App\" />
       <sourceFolder url="file://$MODULE_DIR$/packages/testing/src" isTestSource="false" packagePrefix="Hyde\Testing\" />
       <sourceFolder url="file://$MODULE_DIR$/packages/ui-kit/src" isTestSource="false" packagePrefix="Hyde\UIKit\" />
+      <sourceFolder url="file://$MODULE_DIR$/packages/framework/tests/Feature" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/packages/framework/tests/Unit" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/packages/hyde/tests/Feature" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/packages/publications/tests" isTestSource="true" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyde" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyde/framework" />
       <excludeFolder url="file://$MODULE_DIR$/packages/realtime-compiler/vendor/hyde" />
@@ -63,6 +67,25 @@
       <excludeFolder url="file://$MODULE_DIR$/vendor/psalm/plugin-laravel" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/routing" />
       <excludeFolder url="file://$MODULE_DIR$/monorepo/scripts/cache" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/cache" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/dns" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/parallel" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/parser" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/pipeline" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/process" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/serialization" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/socket" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/amphp/sync" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/daverandom/libdns" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hydephp/torchlight-commonmark" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/kelunik/certificate" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/serializable-closure" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/league/uri" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/league/uri-interfaces" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/orchestra/sidekick" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/revolt/event-loop" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/clock" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/polyfill-php84" />
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
diff --git a/.idea/php.xml b/.idea/php.xml
index 59d9085e017..b8fd8b2d22b 100644
--- a/.idea/php.xml
+++ b/.idea/php.xml
@@ -150,7 +150,6 @@
       <path value="$PROJECT_DIR$/vendor/symfony/var-dumper" />
       <path value="$PROJECT_DIR$/vendor/symfony/yaml" />
       <path value="$PROJECT_DIR$/vendor/theseer/tokenizer" />
-      <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-commonmark" />
       <path value="$PROJECT_DIR$/vendor/torchlight/torchlight-laravel" />
       <path value="$PROJECT_DIR$/vendor/vlucas/phpdotenv" />
       <path value="$PROJECT_DIR$/vendor/voku/portable-ascii" />
@@ -199,9 +198,28 @@
       <path value="$PROJECT_DIR$/vendor/psalm/plugin-laravel" />
       <path value="$PROJECT_DIR$/vendor/illuminate/routing" />
       <path value="$PROJECT_DIR$/vendor/illuminate/database" />
+      <path value="$PROJECT_DIR$/vendor/laravel/serializable-closure" />
+      <path value="$PROJECT_DIR$/vendor/revolt/event-loop" />
+      <path value="$PROJECT_DIR$/vendor/daverandom/libdns" />
+      <path value="$PROJECT_DIR$/vendor/symfony/clock" />
+      <path value="$PROJECT_DIR$/vendor/orchestra/sidekick" />
+      <path value="$PROJECT_DIR$/vendor/symfony/polyfill-php84" />
+      <path value="$PROJECT_DIR$/vendor/league/uri-interfaces" />
+      <path value="$PROJECT_DIR$/vendor/league/uri" />
+      <path value="$PROJECT_DIR$/vendor/amphp/pipeline" />
+      <path value="$PROJECT_DIR$/vendor/amphp/cache" />
+      <path value="$PROJECT_DIR$/vendor/amphp/serialization" />
+      <path value="$PROJECT_DIR$/vendor/amphp/parallel" />
+      <path value="$PROJECT_DIR$/vendor/amphp/dns" />
+      <path value="$PROJECT_DIR$/vendor/amphp/process" />
+      <path value="$PROJECT_DIR$/vendor/amphp/parser" />
+      <path value="$PROJECT_DIR$/vendor/amphp/socket" />
+      <path value="$PROJECT_DIR$/vendor/amphp/sync" />
+      <path value="$PROJECT_DIR$/vendor/hydephp/torchlight-commonmark" />
+      <path value="$PROJECT_DIR$/vendor/kelunik/certificate" />
     </include_path>
   </component>
-  <component name="PhpProjectSharedConfiguration" php_language_level="8.1">
+  <component name="PhpProjectSharedConfiguration" php_language_level="8.2">
     <option name="suggestChangeDefaultLanguageLevel" value="false" />
   </component>
   <component name="PhpStan">
diff --git a/.idea/phpunit.xml b/.idea/phpunit.xml
index d0e69a37e22..8a06c9eef22 100644
--- a/.idea/phpunit.xml
+++ b/.idea/phpunit.xml
@@ -8,7 +8,6 @@
         <option value="$PROJECT_DIR$/packages/framework/tests/Feature" />
         <option value="$PROJECT_DIR$/packages/publications/tests" />
         <option value="$PROJECT_DIR$/packages/hyde/tests/Feature" />
-        <option value="$PROJECT_DIR$/tests" />
         <option value="$PROJECT_DIR$/packages/realtime-compiler/tests" />
       </list>
     </option>

From 12eb0e7403e1412bed82a78d782428736d920916 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 20 Apr 2025 17:12:12 +0200
Subject: [PATCH 3942/4023] Test on PHP 8.2 through 8.4

---
 .github/workflows/continuous-integration.yml   | 18 +++++++++---------
 .github/workflows/coverage-tests.yml           |  2 +-
 .github/workflows/matrix-tests.yml             |  2 +-
 .../framework/.github/workflows/run-tests.yml  |  2 +-
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/continuous-integration.yml b/.github/workflows/continuous-integration.yml
index 56d82e0519a..0b958b3f3cf 100644
--- a/.github/workflows/continuous-integration.yml
+++ b/.github/workflows/continuous-integration.yml
@@ -12,7 +12,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
           extensions: fileinfo
 
       - uses: actions/checkout@v4
@@ -74,7 +74,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        php: [8.1, 8.2, 8.3]
+        php: [8.2, 8.3, 8.4]
     runs-on: ${{ matrix.os }}
 
     steps:
@@ -161,7 +161,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
           coverage: xdebug
           extensions: fileinfo
       - uses: actions/checkout@v4
@@ -255,7 +255,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
 
       - name: Cache Composer packages
         id: composer-cache
@@ -297,7 +297,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
 
       - name: Cache Composer packages
         id: composer-cache
@@ -342,7 +342,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
 
       - name: Cache Composer packages
         id: composer-cache
@@ -509,7 +509,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
       - uses: actions/checkout@v4
 
       - name: Download static analysis tools
@@ -529,7 +529,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
       - uses: actions/checkout@v4
 
       - name: Install Composer Dependencies
@@ -547,7 +547,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
       - uses: actions/checkout@v4
 
       - name: Install Composer Dependencies
diff --git a/.github/workflows/coverage-tests.yml b/.github/workflows/coverage-tests.yml
index 170eba8b329..cc5e5e80564 100644
--- a/.github/workflows/coverage-tests.yml
+++ b/.github/workflows/coverage-tests.yml
@@ -9,7 +9,7 @@ jobs:
     steps:
       - uses: shivammathur/setup-php@v2
         with:
-          php-version: "8.1"
+          php-version: "8.2"
           coverage: xdebug
           extensions: fileinfo
       - uses: actions/checkout@v4
diff --git a/.github/workflows/matrix-tests.yml b/.github/workflows/matrix-tests.yml
index 481bedf5e20..4cb88606756 100644
--- a/.github/workflows/matrix-tests.yml
+++ b/.github/workflows/matrix-tests.yml
@@ -19,7 +19,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        php: [8.1, 8.2, 8.3]
+        php: [8.2, 8.3, 8.4]
     runs-on: ${{ matrix.os }}
 
     steps:
diff --git a/packages/framework/.github/workflows/run-tests.yml b/packages/framework/.github/workflows/run-tests.yml
index c78208af9be..e7ee90735f9 100644
--- a/packages/framework/.github/workflows/run-tests.yml
+++ b/packages/framework/.github/workflows/run-tests.yml
@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        php: [8.1, 8.2, 8.3]
+        php: [8.2, 8.3, 8.4]
     runs-on: ${{ matrix.os }}
 
     steps:

From ddb87790363f48f1b8f4b88fefd65e14e01ca90c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 20 Apr 2025 19:20:10 +0200
Subject: [PATCH 3943/4023] Fix view paths now need to be absolute in test

---
 .../Unit/SourceFilesInCustomDirectoriesCanBeCompiledTest.php  | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/framework/tests/Unit/SourceFilesInCustomDirectoriesCanBeCompiledTest.php b/packages/framework/tests/Unit/SourceFilesInCustomDirectoriesCanBeCompiledTest.php
index 087d49f29b1..da1e977885f 100644
--- a/packages/framework/tests/Unit/SourceFilesInCustomDirectoriesCanBeCompiledTest.php
+++ b/packages/framework/tests/Unit/SourceFilesInCustomDirectoriesCanBeCompiledTest.php
@@ -78,7 +78,9 @@ public function testBladePagesInChangedDirectoryCanBeCompiled()
         Filesystem::touch('testSourceDir/blade/test.blade.php');
 
         BladePage::setSourceDirectory('testSourceDir/blade');
-        Config::set('view.paths', ['testSourceDir/blade']);
+
+        Config::set('view.paths', [Hyde::path('testSourceDir/blade')]);
+        app('view')->addLocation(Hyde::path('testSourceDir/blade'));
 
         StaticPageBuilder::handle(BladePage::parse('test'));
 

From 6f3ed0b85691bd68aec78d4fb81901ba4b33ffdc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 10:49:54 +0200
Subject: [PATCH 3944/4023] Fix string is now enforced to array

---
 .../tests/Feature/Commands/PublishViewsCommandTest.php          | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index a57133db3bb..e049b2001dc 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -215,7 +215,7 @@ public function testCanSelectGroupWithQuestionAndPrompts()
         $this->artisan('publish:views')
             ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
             ->expectsOutput('Selected category [layouts]')
-            ->expectsQuestion('Select the files you want to publish', (is_dir(Hyde::path('packages')) ? 'packages' : 'vendor/hyde').'/framework/resources/views/layouts/app.blade.php')
+            ->expectsQuestion('Select the files you want to publish', [(is_dir(Hyde::path('packages')) ? 'packages' : 'vendor/hyde').'/framework/resources/views/layouts/app.blade.php'])
             ->expectsOutput('Published selected file to [resources/views/vendor/hyde/layouts/app.blade.php]')
             ->assertExitCode(0);
 

From b2eb8449a38ed1eb547e0d6f8f84e3728a166e21 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 11:04:29 +0200
Subject: [PATCH 3945/4023] Fix assertion for slightly changed HTML output

---
 .../tests/Feature/DynamicMarkdownLinksFeatureTest.php     | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index e0981f7cabb..98cfb893193 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -93,12 +93,8 @@ public function testDynamicMarkdownLinksInLists()
 
         $expected = <<<'HTML'
         <ul>
-        <li>
-        <a href="index.html">Home</a>
-        </li>
-        <li>
-        <img src="media/logo.png" alt="Logo" />
-        </li>
+        <li><a href="index.html">Home</a></li>
+        <li><img src="media/logo.png" alt="Logo" /></li>
         </ul>
 
         HTML;

From a0c9cadb9443747062a9b82e8f958b1d90e8d907 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 11:18:26 +0200
Subject: [PATCH 3946/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 9fec3ca32fa..91436ec0aa0 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,6 +11,7 @@ This serves two purposes:
 
 ### Added
 
+- Added support for PHP 8.4.
 - You can now specify sidebar item priorities by adding a numeric prefix to doc umentation page source file names in https://github.com/hydephp/develop/pull/1709
 - Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
@@ -40,6 +41,7 @@ This serves two purposes:
 
 ### Changed
 
+- **Breaking:** The minimum PHP version is now 8.2 instead of 8.1, but we now support PHP 8.3.
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
@@ -121,6 +123,7 @@ This serves two purposes:
 
 ### Removed
 
+- Breaking: Removed support for PHP 8.1.
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Breaking: Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents in https://github.com/hydephp/develop/pull/2045

From 823e74f9c21d0ba8f6324efdca7d3a221d848648 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 11:18:26 +0200
Subject: [PATCH 3947/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 91436ec0aa0..e2bc7b7af88 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,7 +11,7 @@ This serves two purposes:
 
 ### Added
 
-- Added support for PHP 8.4.
+- Added support for PHP 8.4 in https://github.com/hydephp/develop/pull/2141
 - You can now specify sidebar item priorities by adding a numeric prefix to doc umentation page source file names in https://github.com/hydephp/develop/pull/1709
 - Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
@@ -41,7 +41,7 @@ This serves two purposes:
 
 ### Changed
 
-- **Breaking:** The minimum PHP version is now 8.2 instead of 8.1, but we now support PHP 8.3.
+- **Breaking:** We now support PHP [8.2, 8.3, 8.4] instead of [8.1, 8.2, 8.3] in https://github.com/hydephp/develop/pull/2141
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
@@ -123,7 +123,7 @@ This serves two purposes:
 
 ### Removed
 
-- Breaking: Removed support for PHP 8.1.
+- Breaking: Removed support for PHP 8.1 in https://github.com/hydephp/develop/pull/2141.
 - Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
 - Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
 - Breaking: Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents in https://github.com/hydephp/develop/pull/2045

From a2b410695176fdaa384a9cdbc2146371239d5835 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 19:07:11 +0200
Subject: [PATCH 3948/4023] Copy the Vite config to the Hyde package

---
 packages/hyde/vite.config.js | 80 ++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 packages/hyde/vite.config.js

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
new file mode 100644
index 00000000000..b06ea97180d
--- /dev/null
+++ b/packages/hyde/vite.config.js
@@ -0,0 +1,80 @@
+// Using Vite is optional, as the styles you need to get started are already included.
+// However, if you customize existing or add new Tailwind classes, you can use Vite
+// to compile the assets. See https://hydephp.com/docs/1.x/managing-assets.html.
+
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+import tailwindcss from 'tailwindcss';
+import autoprefixer from 'autoprefixer';
+import fs from 'fs';
+import path from 'path';
+
+const hydeVitePlugin = () => ({
+    name: 'hyde-vite',
+    configureServer(server) {
+        // Create hot file when Vite server starts
+        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
+
+        // Remove hot file when Vite server closes
+        ['SIGINT', 'SIGTERM'].forEach(signal => {
+            process.on(signal, () => {
+                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+                process.exit();
+            });
+        });
+
+        // Render the Vite index page when the root URL is requested
+        server.middlewares.use((req, res, next) => {
+            if (req.url === '/') {
+                res.end(fs.readFileSync(
+                    path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
+                    'utf-8'
+                ));
+            } else {
+                next();
+            }
+        });
+    }
+});
+
+const hasJavaScriptContent = () => {
+    const appJsPath = resolve(__dirname, 'resources/assets/app.js');
+    if (!fs.existsSync(appJsPath)) return false;
+    const content = fs.readFileSync(appJsPath, 'utf-8');
+    return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
+};
+
+export default defineConfig({
+    server: {
+        port: 5173,
+        hmr: {
+            host: 'localhost',
+            port: 5173,
+        },
+        middlewareMode: false,
+    },
+    plugins: [hydeVitePlugin()],
+    css: {
+        postcss: {
+            plugins: [
+                tailwindcss,
+                autoprefixer
+            ]
+        }
+    },
+    build: {
+        outDir: '_media',
+        emptyOutDir: false,
+        rollupOptions: {
+            input: [
+                ...(hasJavaScriptContent() ? [resolve(__dirname, 'resources/assets/app.js')] : []),
+                resolve(__dirname, 'resources/assets/app.css')
+            ],
+            output: {
+                entryFileNames: '[name].js',
+                chunkFileNames: '[name].js',
+                assetFileNames: '[name].[ext]'
+            }
+        }
+    }
+});

From 02637890f67120a3e12b75c51a2fe54ca1769d5d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 19:07:22 +0200
Subject: [PATCH 3949/4023] Sync Tailwind config files

---
 packages/hyde/tailwind.config.js | 41 ++++++++++++++++++++++++++++----
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/packages/hyde/tailwind.config.js b/packages/hyde/tailwind.config.js
index 499b0b97e78..9068a370456 100644
--- a/packages/hyde/tailwind.config.js
+++ b/packages/hyde/tailwind.config.js
@@ -50,14 +50,18 @@ module.exports = {
                                 content: 'unset',
                             },
                         },
-                        code: {
+                        'code:not(pre code)': {
                             font: 'unset',
                             backgroundColor: '#80808033',
                             paddingLeft: '4px',
                             paddingRight: '4px',
                             marginLeft: '-2px',
                             marginRight: '1px',
-                            borderRadius: '4px'
+                            borderRadius: '4px',
+                            maxWidth: '80vw',
+                            overflowX: 'auto',
+                            verticalAlign: 'top',
+                            wordBreak: 'break-all'
                         },
                         'code::before': {
                             content: 'unset',
@@ -66,10 +70,15 @@ module.exports = {
                             content: 'unset',
                         },
                         pre: {
+                            backgroundColor: '#292D3E',
+                            borderRadius: '0.25rem',
+                            marginTop: '1rem',
+                            marginBottom: '1rem',
+                            overflowX: 'auto',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
-                            }
-                        }
+                            },
+                        },
                     },
                 },
                 invert: {
@@ -91,6 +100,30 @@ module.exports = {
         },
     },
 
+    safelist: [
+        'prose',
+        'dark:prose-invert',
+        'prose-img:inline',
+        'text-left',
+        'text-center',
+        'text-right',
+        'ml-auto',
+        'mx-auto',
+        'mr-auto',
+        'my-0',
+        'my-4',
+        'my-8',
+        'py-0',
+        'py-4',
+        'py-8',
+        'mx-0',
+        'mx-4',
+        'mx-8',
+        'px-0',
+        'px-4',
+        'px-8',
+    ],
+
     plugins: [
         require('@tailwindcss/typography')
     ],

From 7ae843117a61e105f83c619c4ac5fe01f71f8a98 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 19:07:45 +0200
Subject: [PATCH 3950/4023] Revert "Sync Tailwind config files"

This reverts commit 02637890f67120a3e12b75c51a2fe54ca1769d5d.
---
 packages/hyde/tailwind.config.js | 41 ++++----------------------------
 1 file changed, 4 insertions(+), 37 deletions(-)

diff --git a/packages/hyde/tailwind.config.js b/packages/hyde/tailwind.config.js
index 9068a370456..499b0b97e78 100644
--- a/packages/hyde/tailwind.config.js
+++ b/packages/hyde/tailwind.config.js
@@ -50,18 +50,14 @@ module.exports = {
                                 content: 'unset',
                             },
                         },
-                        'code:not(pre code)': {
+                        code: {
                             font: 'unset',
                             backgroundColor: '#80808033',
                             paddingLeft: '4px',
                             paddingRight: '4px',
                             marginLeft: '-2px',
                             marginRight: '1px',
-                            borderRadius: '4px',
-                            maxWidth: '80vw',
-                            overflowX: 'auto',
-                            verticalAlign: 'top',
-                            wordBreak: 'break-all'
+                            borderRadius: '4px'
                         },
                         'code::before': {
                             content: 'unset',
@@ -70,15 +66,10 @@ module.exports = {
                             content: 'unset',
                         },
                         pre: {
-                            backgroundColor: '#292D3E',
-                            borderRadius: '0.25rem',
-                            marginTop: '1rem',
-                            marginBottom: '1rem',
-                            overflowX: 'auto',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
-                            },
-                        },
+                            }
+                        }
                     },
                 },
                 invert: {
@@ -100,30 +91,6 @@ module.exports = {
         },
     },
 
-    safelist: [
-        'prose',
-        'dark:prose-invert',
-        'prose-img:inline',
-        'text-left',
-        'text-center',
-        'text-right',
-        'ml-auto',
-        'mx-auto',
-        'mr-auto',
-        'my-0',
-        'my-4',
-        'my-8',
-        'py-0',
-        'py-4',
-        'py-8',
-        'mx-0',
-        'mx-4',
-        'mx-8',
-        'px-0',
-        'px-4',
-        'px-8',
-    ],
-
     plugins: [
         require('@tailwindcss/typography')
     ],

From 4b63f4d669bcd835e3bbd507ce488718e8d8c04a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 19:08:30 +0200
Subject: [PATCH 3951/4023] Update Tailwind config files

---
 packages/hyde/tailwind.config.js | 17 +++++++++++++----
 tailwind.config.js               |  1 +
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/packages/hyde/tailwind.config.js b/packages/hyde/tailwind.config.js
index 499b0b97e78..4db5d1e3a26 100644
--- a/packages/hyde/tailwind.config.js
+++ b/packages/hyde/tailwind.config.js
@@ -50,14 +50,18 @@ module.exports = {
                                 content: 'unset',
                             },
                         },
-                        code: {
+                        'code:not(pre code)': {
                             font: 'unset',
                             backgroundColor: '#80808033',
                             paddingLeft: '4px',
                             paddingRight: '4px',
                             marginLeft: '-2px',
                             marginRight: '1px',
-                            borderRadius: '4px'
+                            borderRadius: '4px',
+                            maxWidth: '80vw',
+                            overflowX: 'auto',
+                            verticalAlign: 'top',
+                            wordBreak: 'break-all'
                         },
                         'code::before': {
                             content: 'unset',
@@ -66,10 +70,15 @@ module.exports = {
                             content: 'unset',
                         },
                         pre: {
+                            backgroundColor: '#292D3E',
+                            borderRadius: '0.25rem',
+                            marginTop: '1rem',
+                            marginBottom: '1rem',
+                            overflowX: 'auto',
                             code: {
                                 fontFamily: "'Fira Code Regular', Consolas, Monospace, 'Courier New'",
-                            }
-                        }
+                            },
+                        },
                     },
                 },
                 invert: {
diff --git a/tailwind.config.js b/tailwind.config.js
index 9068a370456..083c2625df7 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -100,6 +100,7 @@ module.exports = {
         },
     },
 
+    // Safelist should NOT be copied to packages/hyde. It's purely for the monorepo.
     safelist: [
         'prose',
         'dark:prose-invert',

From dcf9b8c0f2ad9e77a2665868231913ffa55222e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 18:55:43 +0200
Subject: [PATCH 3952/4023] Prepare Tailwind v4 migration

---
 RELEASE_NOTES.md                           | 9 +++++++++
 packages/hyde/tests/DefaultContentTest.php | 5 +----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index e2bc7b7af88..3f88fe0ac0c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -42,6 +42,7 @@ This serves two purposes:
 ### Changed
 
 - **Breaking:** We now support PHP [8.2, 8.3, 8.4] instead of [8.1, 8.2, 8.3] in https://github.com/hydephp/develop/pull/2141
+- **Breaking:** We upgraded from the TailwindCSS version from v3 v4. You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details. Introduced in https://github.com/hydephp/develop/pull/2146.
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
@@ -185,6 +186,14 @@ Please read through this section to ensure your site upgrades smoothly.
 
 Before you start, please upgrade your application to at least HydePHP v1.6 as that version contains helpers to make the upgrade process easier.
 
+## TailwindCSS v4
+
+We upgraded the TailwindCSS version from v3 to v4. If you have written custom markup with Tailwind classes you should read the Tailwind v4 [Upgrade Guide](https://tailwindcss.com/docs/upgrade-guide#changes-from-v3) so you know which breaking changes were introduced. Thankfully, the team behind Tailwind provide an automated [Upgrade Tool](https://tailwindcss.com/docs/upgrade-guide#using-the-upgrade-tool). Run it with the following command:
+
+```bash
+$ npx @tailwindcss/upgrade
+```
+
 ## High impact
 
 ### Navigation system rewrite
diff --git a/packages/hyde/tests/DefaultContentTest.php b/packages/hyde/tests/DefaultContentTest.php
index abd85b152a1..ae9fe9f87bc 100644
--- a/packages/hyde/tests/DefaultContentTest.php
+++ b/packages/hyde/tests/DefaultContentTest.php
@@ -44,10 +44,7 @@ public function testLaravelMixResourcesArePresent()
         $this->assertFileExists(Hyde::path('resources/assets/app.css'));
         $this->assertFileExists(Hyde::path('resources/assets/app.js'));
 
-        $this->assertFileContainsString('@tailwind base;', Hyde::path('resources/assets/app.css'));
-        $this->assertFileContainsString('@tailwind components;', Hyde::path('resources/assets/app.css'));
-        $this->assertFileContainsString('@tailwind utilities;', Hyde::path('resources/assets/app.css'));
-
+        $this->assertFileContainsString("@import 'tailwindcss'", Hyde::path('resources/assets/app.css'));
         $this->assertFileContainsString('This is the main JavaScript', Hyde::path('resources/assets/app.js'));
     }
 

From 834f26b402b1a1c78851c4ab25fdf57cc2758c31 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 18:47:35 +0200
Subject: [PATCH 3953/4023] Run the Tailwind v4 migration tool

---
 _pages/index.blade.php                        |    4 +-
 package-lock.json                             | 2019 ++---------------
 package.json                                  |    2 +-
 .../components/docs/hyde-search.blade.php     |    2 +-
 .../components/docs/search-modal.blade.php    |    2 +-
 .../views/homepages/welcome.blade.php         |    4 +-
 .../views/layouts/navigation.blade.php        |    8 +-
 resources/assets/app.css                      |    8 +-
 8 files changed, 175 insertions(+), 1874 deletions(-)

diff --git a/_pages/index.blade.php b/_pages/index.blade.php
index c8989f5ba9e..ed3a8c6175a 100644
--- a/_pages/index.blade.php
+++ b/_pages/index.blade.php
@@ -9,7 +9,7 @@
 
     <style>
         /*! tailwindcss v3.0.23 | MIT License | https://tailwindcss.com*/
-        *,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b{font-weight:bolder}code{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}[type=button],[type=reset],[type=submit]{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}h1,h2,h3,h4,h5,h6,p{margin:0}[role=button]{cursor:pointer}:disabled{cursor:default}[hidden]{display:none}*,:after,:before{--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-scroll-snap-strictness:proximity;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.static{position:static}.relative{position:relative}.top-0{top:0}.left-0{left:0}.m-2{margin:.5rem}.my-auto{margin-top:auto;margin-bottom:auto}.mx-auto{margin-left:auto;margin-right:auto}.mx-3{margin-left:.75rem;margin-right:.75rem}.mb-4{margin-bottom:1rem}.mt-2{margin-top:.5rem}.mt-8{margin-top:2rem}.mt-4{margin-top:1rem}.mt-auto{margin-top:auto}.block{display:block}.flex{display:flex}.hidden{display:none}.h-16{height:4rem}.h-screen{height:100vh}.min-h-screen{min-height:100vh}.w-screen{width:100vw}.w-64{width:16rem}.max-w-7xl{max-width:80rem}.max-w-lg{max-width:32rem}.max-w-3xl{max-width:48rem}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.justify-center{justify-content:center}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.p-4{padding:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-4{padding-left:1rem;padding-right:1rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-16{padding-top:4rem;padding-bottom:4rem}.px-8{padding-left:2rem;padding-right:2rem}.pb-12{padding-bottom:3rem}.text-left{text-align:left}.text-center{text-align:center}.text-5xl{font-size:3rem;line-height:1}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-extrabold{font-weight:800}.font-bold{font-weight:700}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.tracking-tight{letter-spacing:-.025em}.tracking-normal{letter-spacing:0}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.text-transparent{color:#0000}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.shadow-lg{--tw-shadow:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a;--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px #00000026);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px #0000001a,0 8px 10px -6px #0000001a;--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:absolute{position:absolute}.md\:left-72{left:18rem}.md\:mt-8{margin-top:2rem}.md\:mt-0{margin-top:0}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:max-w-none{max-width:none}.md\:max-w-2xl{max-width:42rem}.md\:text-center{text-align:center}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:text-5xl{font-size:3rem;line-height:1}}@media (min-width:1024px){.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:left-80{left:20rem}}.sr-only{position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;}.list-none{list-style-type: none;}
+        *,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b{font-weight:bolder}code{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}[type=button],[type=reset],[type=submit]{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}h1,h2,h3,h4,h5,h6,p{margin:0}[role=button]{cursor:pointer}:disabled{cursor:default}[hidden]{display:none}*,:after,:before{--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-scroll-snap-strictness:proximity;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.static{position:static}.relative{position:relative}.top-0{top:0}.left-0{left:0}.m-2{margin:.5rem}.my-auto{margin-top:auto;margin-bottom:auto}.mx-auto{margin-left:auto;margin-right:auto}.mx-3{margin-left:.75rem;margin-right:.75rem}.mb-4{margin-bottom:1rem}.mt-2{margin-top:.5rem}.mt-8{margin-top:2rem}.mt-4{margin-top:1rem}.mt-auto{margin-top:auto}.block{display:block}.flex{display:flex}.hidden{display:none}.h-16{height:4rem}.h-screen{height:100vh}.min-h-screen{min-height:100vh}.w-screen{width:100vw}.w-64{width:16rem}.max-w-7xl{max-width:80rem}.max-w-lg{max-width:32rem}.max-w-3xl{max-width:48rem}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.justify-center{justify-content:center}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-linear-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.p-4{padding:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-4{padding-left:1rem;padding-right:1rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-16{padding-top:4rem;padding-bottom:4rem}.px-8{padding-left:2rem;padding-right:2rem}.pb-12{padding-bottom:3rem}.text-left{text-align:left}.text-center{text-align:center}.text-5xl{font-size:3rem;line-height:1}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-extrabold{font-weight:800}.font-bold{font-weight:700}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.tracking-tight{letter-spacing:-.025em}.tracking-normal{letter-spacing:0}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.text-transparent{color:#0000}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.shadow-lg{--tw-shadow:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a;--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px #00000026);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px #0000001a,0 8px 10px -6px #0000001a;--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:absolute{position:absolute}.md\:left-72{left:18rem}.md\:mt-8{margin-top:2rem}.md\:mt-0{margin-top:0}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:max-w-none{max-width:none}.md\:max-w-2xl{max-width:42rem}.md\:text-center{text-align:center}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:text-5xl{font-size:3rem;line-height:1}}@media (min-width:1024px){.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:left-80{left:20rem}}.sr-only{position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;}.list-none{list-style-type: none;}
     </style>
 
     <style>
@@ -37,7 +37,7 @@
             <h1
                 class="text-5xl font-extrabold leading-10 tracking-tight text-left text-gray-100 md:text-center sm:leading-none md:text-6xl lg:text-7xl">
                 <span class="block text-4xl md:text-5xl mb-4 sm:mb-0">You're running on </span><span
-                    class="relative mt-2 text-transparent bg-clip-text bg-gradient-to-br logo-gradient md:inline-block drop-shadow-2xl tracking-normal">HydePHP</span>
+                    class="relative mt-2 text-transparent bg-clip-text bg-linear-to-br logo-gradient md:inline-block drop-shadow-2xl tracking-normal">HydePHP</span>
             </h1>
             <div class="mx-auto mt-8 sm:mt-4 text-gray-200 md:mt-8 md:max-w-2xl md:text-center">
                 <section aria-label="About Hyde">
diff --git a/package-lock.json b/package-lock.json
index 3514affbe6d..dd39f7d7638 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,5 +1,5 @@
 {
-    "name": "monorepo",
+    "name": "develop",
     "lockfileVersion": 2,
     "requires": true,
     "packages": {
@@ -10,21 +10,10 @@
                 "hydefront": "^3.3.0",
                 "postcss": "^8.4.49",
                 "prettier": "3.3.3",
-                "tailwindcss": "^3.4.15",
+                "tailwindcss": "^4.1.4",
                 "vite": "^5.0.0"
             }
         },
-        "node_modules/@alloc/quick-lru": {
-            "version": "5.2.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
         "node_modules/@esbuild/aix-ppc64": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
@@ -393,99 +382,12 @@
                 "node": ">=12"
             }
         },
-        "node_modules/@isaacs/cliui": {
-            "version": "8.0.2",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "string-width": "^5.1.2",
-                "string-width-cjs": "npm:string-width@^4.2.0",
-                "strip-ansi": "^7.0.1",
-                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
-                "wrap-ansi": "^8.1.0",
-                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
-            },
-            "engines": {
-                "node": ">=12"
-            }
-        },
-        "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
-            "version": "6.1.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-regex?sponsor=1"
-            }
-        },
-        "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
-            "version": "6.2.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-            }
-        },
-        "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
-            "version": "9.2.2",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/@isaacs/cliui/node_modules/string-width": {
-            "version": "5.1.2",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "eastasianwidth": "^0.2.0",
-                "emoji-regex": "^9.2.2",
-                "strip-ansi": "^7.0.1"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
-            "version": "7.1.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "ansi-regex": "^6.0.1"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/strip-ansi?sponsor=1"
-            }
-        },
-        "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
-            "version": "8.1.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "ansi-styles": "^6.1.0",
-                "string-width": "^5.0.1",
-                "strip-ansi": "^7.0.1"
-            },
-            "engines": {
-                "node": ">=12"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-            }
-        },
         "node_modules/@jridgewell/gen-mapping": {
             "version": "0.3.5",
             "dev": true,
             "license": "MIT",
+            "optional": true,
+            "peer": true,
             "dependencies": {
                 "@jridgewell/set-array": "^1.2.1",
                 "@jridgewell/sourcemap-codec": "^1.4.10",
@@ -499,6 +401,8 @@
             "version": "3.1.2",
             "dev": true,
             "license": "MIT",
+            "optional": true,
+            "peer": true,
             "engines": {
                 "node": ">=6.0.0"
             }
@@ -507,6 +411,8 @@
             "version": "1.2.1",
             "dev": true,
             "license": "MIT",
+            "optional": true,
+            "peer": true,
             "engines": {
                 "node": ">=6.0.0"
             }
@@ -525,58 +431,21 @@
         "node_modules/@jridgewell/sourcemap-codec": {
             "version": "1.5.0",
             "dev": true,
-            "license": "MIT"
+            "license": "MIT",
+            "optional": true,
+            "peer": true
         },
         "node_modules/@jridgewell/trace-mapping": {
             "version": "0.3.25",
             "dev": true,
             "license": "MIT",
+            "optional": true,
+            "peer": true,
             "dependencies": {
                 "@jridgewell/resolve-uri": "^3.1.0",
                 "@jridgewell/sourcemap-codec": "^1.4.14"
             }
         },
-        "node_modules/@nodelib/fs.scandir": {
-            "version": "2.1.5",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "@nodelib/fs.stat": "2.0.5",
-                "run-parallel": "^1.1.9"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/@nodelib/fs.stat": {
-            "version": "2.0.5",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/@nodelib/fs.walk": {
-            "version": "1.2.8",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "@nodelib/fs.scandir": "2.1.5",
-                "fastq": "^1.6.0"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/@pkgjs/parseargs": {
-            "version": "0.11.0",
-            "dev": true,
-            "license": "MIT",
-            "optional": true,
-            "engines": {
-                "node": ">=14"
-            }
-        },
         "node_modules/@rollup/rollup-android-arm-eabi": {
             "version": "4.25.0",
             "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
@@ -853,50 +722,6 @@
                 "node": ">=0.4.0"
             }
         },
-        "node_modules/ansi-regex": {
-            "version": "5.0.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/ansi-styles": {
-            "version": "4.3.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "color-convert": "^2.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
-            }
-        },
-        "node_modules/any-promise": {
-            "version": "1.3.0",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/anymatch": {
-            "version": "3.1.3",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "normalize-path": "^3.0.0",
-                "picomatch": "^2.0.4"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/arg": {
-            "version": "5.0.2",
-            "dev": true,
-            "license": "MIT"
-        },
         "node_modules/autoprefixer": {
             "version": "10.4.20",
             "dev": true,
@@ -933,33 +758,6 @@
                 "postcss": "^8.1.0"
             }
         },
-        "node_modules/balanced-match": {
-            "version": "1.0.2",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/binary-extensions": {
-            "version": "2.3.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/sindresorhus"
-            }
-        },
-        "node_modules/braces": {
-            "version": "3.0.3",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "fill-range": "^7.1.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
         "node_modules/browserslist": {
             "version": "4.24.2",
             "dev": true,
@@ -998,14 +796,6 @@
             "optional": true,
             "peer": true
         },
-        "node_modules/camelcase-css": {
-            "version": "2.0.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 6"
-            }
-        },
         "node_modules/caniuse-lite": {
             "version": "1.0.30001679",
             "dev": true,
@@ -1025,58 +815,6 @@
             ],
             "license": "CC-BY-4.0"
         },
-        "node_modules/chokidar": {
-            "version": "3.6.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "anymatch": "~3.1.2",
-                "braces": "~3.0.2",
-                "glob-parent": "~5.1.2",
-                "is-binary-path": "~2.1.0",
-                "is-glob": "~4.0.1",
-                "normalize-path": "~3.0.0",
-                "readdirp": "~3.6.0"
-            },
-            "engines": {
-                "node": ">= 8.10.0"
-            },
-            "funding": {
-                "url": "https://paulmillr.com/funding/"
-            },
-            "optionalDependencies": {
-                "fsevents": "~2.3.2"
-            }
-        },
-        "node_modules/color-convert": {
-            "version": "2.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "color-name": "~1.1.4"
-            },
-            "engines": {
-                "node": ">=7.0.0"
-            }
-        },
-        "node_modules/color-name": {
-            "version": "1.1.4",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/cross-spawn": {
-            "version": "7.0.5",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "path-key": "^3.1.0",
-                "shebang-command": "^2.0.0",
-                "which": "^2.0.1"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
         "node_modules/cssesc": {
             "version": "3.0.0",
             "dev": true,
@@ -1088,31 +826,11 @@
                 "node": ">=4"
             }
         },
-        "node_modules/didyoumean": {
-            "version": "1.2.2",
-            "dev": true,
-            "license": "Apache-2.0"
-        },
-        "node_modules/dlv": {
-            "version": "1.1.3",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/eastasianwidth": {
-            "version": "0.2.0",
-            "dev": true,
-            "license": "MIT"
-        },
         "node_modules/electron-to-chromium": {
             "version": "1.5.55",
             "dev": true,
             "license": "ISC"
         },
-        "node_modules/emoji-regex": {
-            "version": "8.0.0",
-            "dev": true,
-            "license": "MIT"
-        },
         "node_modules/esbuild": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
@@ -1159,66 +877,6 @@
                 "node": ">=6"
             }
         },
-        "node_modules/fast-glob": {
-            "version": "3.3.2",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "@nodelib/fs.stat": "^2.0.2",
-                "@nodelib/fs.walk": "^1.2.3",
-                "glob-parent": "^5.1.2",
-                "merge2": "^1.3.0",
-                "micromatch": "^4.0.4"
-            },
-            "engines": {
-                "node": ">=8.6.0"
-            }
-        },
-        "node_modules/fastq": {
-            "version": "1.17.1",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "reusify": "^1.0.4"
-            }
-        },
-        "node_modules/fill-range": {
-            "version": "7.1.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "to-regex-range": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/foreground-child": {
-            "version": "3.3.0",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "cross-spawn": "^7.0.0",
-                "signal-exit": "^4.0.1"
-            },
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/foreground-child/node_modules/signal-exit": {
-            "version": "4.1.0",
-            "dev": true,
-            "license": "ISC",
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
         "node_modules/fraction.js": {
             "version": "4.3.7",
             "dev": true,
@@ -1245,196 +903,28 @@
                 "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
             }
         },
-        "node_modules/function-bind": {
-            "version": "1.1.2",
+        "node_modules/hydefront": {
+            "version": "3.4.1",
             "dev": true,
-            "license": "MIT",
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
+            "license": "MIT"
         },
-        "node_modules/glob-parent": {
-            "version": "5.1.2",
+        "node_modules/lodash.castarray": {
+            "version": "4.4.0",
             "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "is-glob": "^4.0.1"
-            },
-            "engines": {
-                "node": ">= 6"
-            }
+            "license": "MIT"
         },
-        "node_modules/hasown": {
-            "version": "2.0.2",
+        "node_modules/lodash.isplainobject": {
+            "version": "4.0.6",
             "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "function-bind": "^1.1.2"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            }
+            "license": "MIT"
         },
-        "node_modules/hydefront": {
-            "version": "3.4.1",
+        "node_modules/lodash.merge": {
+            "version": "4.6.2",
             "dev": true,
             "license": "MIT"
         },
-        "node_modules/is-binary-path": {
-            "version": "2.1.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "binary-extensions": "^2.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/is-core-module": {
-            "version": "2.15.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "hasown": "^2.0.2"
-            },
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/is-extglob": {
-            "version": "2.1.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/is-fullwidth-code-point": {
-            "version": "3.0.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/is-glob": {
-            "version": "4.0.3",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "is-extglob": "^2.1.1"
-            },
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/is-number": {
-            "version": "7.0.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.12.0"
-            }
-        },
-        "node_modules/isexe": {
-            "version": "2.0.0",
-            "dev": true,
-            "license": "ISC"
-        },
-        "node_modules/jackspeak": {
-            "version": "3.4.3",
-            "dev": true,
-            "license": "BlueOak-1.0.0",
-            "dependencies": {
-                "@isaacs/cliui": "^8.0.2"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            },
-            "optionalDependencies": {
-                "@pkgjs/parseargs": "^0.11.0"
-            }
-        },
-        "node_modules/jiti": {
-            "version": "1.21.6",
-            "dev": true,
-            "license": "MIT",
-            "bin": {
-                "jiti": "bin/jiti.js"
-            }
-        },
-        "node_modules/lilconfig": {
-            "version": "2.1.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=10"
-            }
-        },
-        "node_modules/lines-and-columns": {
-            "version": "1.2.4",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/lodash.castarray": {
-            "version": "4.4.0",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/lodash.isplainobject": {
-            "version": "4.0.6",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/lodash.merge": {
-            "version": "4.6.2",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/merge2": {
-            "version": "1.4.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/micromatch": {
-            "version": "4.0.8",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "braces": "^3.0.3",
-                "picomatch": "^2.3.1"
-            },
-            "engines": {
-                "node": ">=8.6"
-            }
-        },
-        "node_modules/minipass": {
-            "version": "7.1.2",
-            "dev": true,
-            "license": "ISC",
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            }
-        },
-        "node_modules/mz": {
-            "version": "2.7.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "any-promise": "^1.0.0",
-                "object-assign": "^4.0.1",
-                "thenify-all": "^1.0.0"
-            }
-        },
-        "node_modules/nanoid": {
-            "version": "3.3.7",
+        "node_modules/nanoid": {
+            "version": "3.3.7",
             "dev": true,
             "funding": [
                 {
@@ -1444,666 +934,161 @@
             ],
             "license": "MIT",
             "bin": {
-                "nanoid": "bin/nanoid.cjs"
-            },
-            "engines": {
-                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
-            }
-        },
-        "node_modules/node-releases": {
-            "version": "2.0.18",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/normalize-path": {
-            "version": "3.0.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/normalize-range": {
-            "version": "0.1.2",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/object-assign": {
-            "version": "4.1.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/object-hash": {
-            "version": "3.0.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/package-json-from-dist": {
-            "version": "1.0.1",
-            "dev": true,
-            "license": "BlueOak-1.0.0"
-        },
-        "node_modules/path-key": {
-            "version": "3.1.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/path-parse": {
-            "version": "1.0.7",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/path-scurry": {
-            "version": "1.11.1",
-            "dev": true,
-            "license": "BlueOak-1.0.0",
-            "dependencies": {
-                "lru-cache": "^10.2.0",
-                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.18"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/path-scurry/node_modules/lru-cache": {
-            "version": "10.4.3",
-            "dev": true,
-            "license": "ISC"
-        },
-        "node_modules/picocolors": {
-            "version": "1.1.1",
-            "dev": true,
-            "license": "ISC"
-        },
-        "node_modules/picomatch": {
-            "version": "2.3.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8.6"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/jonschlinkert"
-            }
-        },
-        "node_modules/pify": {
-            "version": "2.3.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/pirates": {
-            "version": "4.0.6",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/postcss": {
-            "version": "8.4.49",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz",
-            "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/postcss/"
-                },
-                {
-                    "type": "tidelift",
-                    "url": "https://tidelift.com/funding/github/npm/postcss"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "dependencies": {
-                "nanoid": "^3.3.7",
-                "picocolors": "^1.1.1",
-                "source-map-js": "^1.2.1"
-            },
-            "engines": {
-                "node": "^10 || ^12 || >=14"
-            }
-        },
-        "node_modules/postcss-import": {
-            "version": "15.1.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "postcss-value-parser": "^4.0.0",
-                "read-cache": "^1.0.0",
-                "resolve": "^1.1.7"
-            },
-            "engines": {
-                "node": ">=14.0.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.0.0"
-            }
-        },
-        "node_modules/postcss-js": {
-            "version": "4.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "camelcase-css": "^2.0.1"
-            },
-            "engines": {
-                "node": "^12 || ^14 || >= 16"
-            },
-            "funding": {
-                "type": "opencollective",
-                "url": "https://opencollective.com/postcss/"
-            },
-            "peerDependencies": {
-                "postcss": "^8.4.21"
-            }
-        },
-        "node_modules/postcss-nested": {
-            "version": "6.2.0",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "opencollective",
-                    "url": "https://opencollective.com/postcss/"
-                },
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/ai"
-                }
-            ],
-            "license": "MIT",
-            "dependencies": {
-                "postcss-selector-parser": "^6.1.1"
-            },
-            "engines": {
-                "node": ">=12.0"
-            },
-            "peerDependencies": {
-                "postcss": "^8.2.14"
-            }
-        },
-        "node_modules/postcss-nested/node_modules/postcss-selector-parser": {
-            "version": "6.1.2",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/postcss-selector-parser": {
-            "version": "6.0.10",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
-            },
-            "engines": {
-                "node": ">=4"
-            }
-        },
-        "node_modules/postcss-value-parser": {
-            "version": "4.2.0",
-            "dev": true,
-            "license": "MIT"
-        },
-        "node_modules/prettier": {
-            "version": "3.3.3",
-            "dev": true,
-            "license": "MIT",
-            "bin": {
-                "prettier": "bin/prettier.cjs"
-            },
-            "engines": {
-                "node": ">=14"
-            },
-            "funding": {
-                "url": "https://github.com/prettier/prettier?sponsor=1"
-            }
-        },
-        "node_modules/queue-microtask": {
-            "version": "1.2.3",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ],
-            "license": "MIT"
-        },
-        "node_modules/read-cache": {
-            "version": "1.0.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "pify": "^2.3.0"
-            }
-        },
-        "node_modules/readdirp": {
-            "version": "3.6.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "picomatch": "^2.2.1"
-            },
-            "engines": {
-                "node": ">=8.10.0"
-            }
-        },
-        "node_modules/resolve": {
-            "version": "1.22.8",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "is-core-module": "^2.13.0",
-                "path-parse": "^1.0.7",
-                "supports-preserve-symlinks-flag": "^1.0.0"
-            },
-            "bin": {
-                "resolve": "bin/resolve"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
-        },
-        "node_modules/reusify": {
-            "version": "1.0.4",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "iojs": ">=1.0.0",
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/rollup": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
-            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
-            "dev": true,
-            "dependencies": {
-                "@types/estree": "1.0.6"
-            },
-            "bin": {
-                "rollup": "dist/bin/rollup"
-            },
-            "engines": {
-                "node": ">=18.0.0",
-                "npm": ">=8.0.0"
-            },
-            "optionalDependencies": {
-                "@rollup/rollup-android-arm-eabi": "4.25.0",
-                "@rollup/rollup-android-arm64": "4.25.0",
-                "@rollup/rollup-darwin-arm64": "4.25.0",
-                "@rollup/rollup-darwin-x64": "4.25.0",
-                "@rollup/rollup-freebsd-arm64": "4.25.0",
-                "@rollup/rollup-freebsd-x64": "4.25.0",
-                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
-                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
-                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
-                "@rollup/rollup-linux-arm64-musl": "4.25.0",
-                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
-                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
-                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-musl": "4.25.0",
-                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
-                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
-                "@rollup/rollup-win32-x64-msvc": "4.25.0",
-                "fsevents": "~2.3.2"
-            }
-        },
-        "node_modules/run-parallel": {
-            "version": "1.2.0",
-            "dev": true,
-            "funding": [
-                {
-                    "type": "github",
-                    "url": "https://github.com/sponsors/feross"
-                },
-                {
-                    "type": "patreon",
-                    "url": "https://www.patreon.com/feross"
-                },
-                {
-                    "type": "consulting",
-                    "url": "https://feross.org/support"
-                }
-            ],
-            "license": "MIT",
-            "dependencies": {
-                "queue-microtask": "^1.2.2"
-            }
-        },
-        "node_modules/shebang-command": {
-            "version": "2.0.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "shebang-regex": "^3.0.0"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/shebang-regex": {
-            "version": "3.0.0",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/source-map": {
-            "version": "0.6.1",
-            "dev": true,
-            "license": "BSD-3-Clause",
-            "optional": true,
-            "peer": true,
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/source-map-js": {
-            "version": "1.2.1",
-            "dev": true,
-            "license": "BSD-3-Clause",
-            "engines": {
-                "node": ">=0.10.0"
-            }
-        },
-        "node_modules/source-map-support": {
-            "version": "0.5.21",
-            "dev": true,
-            "license": "MIT",
-            "optional": true,
-            "peer": true,
-            "dependencies": {
-                "buffer-from": "^1.0.0",
-                "source-map": "^0.6.0"
-            }
-        },
-        "node_modules/string-width": {
-            "version": "4.2.3",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/string-width-cjs": {
-            "name": "string-width",
-            "version": "4.2.3",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/strip-ansi": {
-            "version": "6.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "ansi-regex": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/strip-ansi-cjs": {
-            "name": "strip-ansi",
-            "version": "6.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "ansi-regex": "^5.0.1"
-            },
-            "engines": {
-                "node": ">=8"
-            }
-        },
-        "node_modules/sucrase": {
-            "version": "3.35.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "@jridgewell/gen-mapping": "^0.3.2",
-                "commander": "^4.0.0",
-                "glob": "^10.3.10",
-                "lines-and-columns": "^1.1.6",
-                "mz": "^2.7.0",
-                "pirates": "^4.0.1",
-                "ts-interface-checker": "^0.1.9"
-            },
-            "bin": {
-                "sucrase": "bin/sucrase",
-                "sucrase-node": "bin/sucrase-node"
-            },
-            "engines": {
-                "node": ">=16 || 14 >=14.17"
-            }
-        },
-        "node_modules/sucrase/node_modules/brace-expansion": {
-            "version": "2.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "balanced-match": "^1.0.0"
-            }
-        },
-        "node_modules/sucrase/node_modules/commander": {
-            "version": "4.1.1",
-            "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 6"
-            }
-        },
-        "node_modules/sucrase/node_modules/glob": {
-            "version": "10.4.5",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "foreground-child": "^3.1.0",
-                "jackspeak": "^3.1.2",
-                "minimatch": "^9.0.4",
-                "minipass": "^7.1.2",
-                "package-json-from-dist": "^1.0.0",
-                "path-scurry": "^1.11.1"
-            },
-            "bin": {
-                "glob": "dist/esm/bin.mjs"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
-            }
-        },
-        "node_modules/sucrase/node_modules/minimatch": {
-            "version": "9.0.5",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "brace-expansion": "^2.0.1"
+                "nanoid": "bin/nanoid.cjs"
             },
             "engines": {
-                "node": ">=16 || 14 >=14.17"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/isaacs"
+                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
             }
         },
-        "node_modules/supports-preserve-symlinks-flag": {
-            "version": "1.0.0",
+        "node_modules/node-releases": {
+            "version": "2.0.18",
             "dev": true,
-            "license": "MIT",
-            "engines": {
-                "node": ">= 0.4"
-            },
-            "funding": {
-                "url": "https://github.com/sponsors/ljharb"
-            }
+            "license": "MIT"
         },
-        "node_modules/tailwindcss": {
-            "version": "3.4.15",
-            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.15.tgz",
-            "integrity": "sha512-r4MeXnfBmSOuKUWmXe6h2CcyfzJCEk4F0pptO5jlnYSIViUkVmsawj80N5h2lO3gwcmSb4n3PuN+e+GC1Guylw==",
+        "node_modules/normalize-range": {
+            "version": "0.1.2",
             "dev": true,
             "license": "MIT",
-            "dependencies": {
-                "@alloc/quick-lru": "^5.2.0",
-                "arg": "^5.0.2",
-                "chokidar": "^3.6.0",
-                "didyoumean": "^1.2.2",
-                "dlv": "^1.1.3",
-                "fast-glob": "^3.3.2",
-                "glob-parent": "^6.0.2",
-                "is-glob": "^4.0.3",
-                "jiti": "^1.21.6",
-                "lilconfig": "^2.1.0",
-                "micromatch": "^4.0.8",
-                "normalize-path": "^3.0.0",
-                "object-hash": "^3.0.0",
-                "picocolors": "^1.1.1",
-                "postcss": "^8.4.47",
-                "postcss-import": "^15.1.0",
-                "postcss-js": "^4.0.1",
-                "postcss-load-config": "^4.0.2",
-                "postcss-nested": "^6.2.0",
-                "postcss-selector-parser": "^6.1.2",
-                "resolve": "^1.22.8",
-                "sucrase": "^3.35.0"
-            },
-            "bin": {
-                "tailwind": "lib/cli.js",
-                "tailwindcss": "lib/cli.js"
-            },
             "engines": {
-                "node": ">=14.0.0"
+                "node": ">=0.10.0"
             }
         },
-        "node_modules/tailwindcss/node_modules/glob-parent": {
-            "version": "6.0.2",
+        "node_modules/picocolors": {
+            "version": "1.1.1",
             "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "is-glob": "^4.0.3"
-            },
-            "engines": {
-                "node": ">=10.13.0"
-            }
+            "license": "ISC"
         },
-        "node_modules/tailwindcss/node_modules/postcss-load-config": {
-            "version": "4.0.2",
+        "node_modules/postcss": {
+            "version": "8.4.49",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz",
+            "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==",
             "dev": true,
             "funding": [
                 {
                     "type": "opencollective",
                     "url": "https://opencollective.com/postcss/"
                 },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/postcss"
+                },
                 {
                     "type": "github",
                     "url": "https://github.com/sponsors/ai"
                 }
             ],
-            "license": "MIT",
             "dependencies": {
-                "lilconfig": "^3.0.0",
-                "yaml": "^2.3.4"
+                "nanoid": "^3.3.7",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
             },
             "engines": {
-                "node": ">= 14"
-            },
-            "peerDependencies": {
-                "postcss": ">=8.0.9",
-                "ts-node": ">=9.0.0"
+                "node": "^10 || ^12 || >=14"
+            }
+        },
+        "node_modules/postcss-selector-parser": {
+            "version": "6.0.10",
+            "dev": true,
+            "license": "MIT",
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
             },
-            "peerDependenciesMeta": {
-                "postcss": {
-                    "optional": true
-                },
-                "ts-node": {
-                    "optional": true
-                }
+            "engines": {
+                "node": ">=4"
             }
         },
-        "node_modules/tailwindcss/node_modules/postcss-load-config/node_modules/lilconfig": {
-            "version": "3.1.2",
+        "node_modules/postcss-value-parser": {
+            "version": "4.2.0",
+            "dev": true,
+            "license": "MIT"
+        },
+        "node_modules/prettier": {
+            "version": "3.3.3",
             "dev": true,
             "license": "MIT",
+            "bin": {
+                "prettier": "bin/prettier.cjs"
+            },
             "engines": {
                 "node": ">=14"
             },
             "funding": {
-                "url": "https://github.com/sponsors/antonk52"
+                "url": "https://github.com/prettier/prettier?sponsor=1"
             }
         },
-        "node_modules/tailwindcss/node_modules/postcss-selector-parser": {
-            "version": "6.1.2",
+        "node_modules/rollup": {
+            "version": "4.25.0",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
+            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
             "dev": true,
-            "license": "MIT",
             "dependencies": {
-                "cssesc": "^3.0.0",
-                "util-deprecate": "^1.0.2"
+                "@types/estree": "1.0.6"
+            },
+            "bin": {
+                "rollup": "dist/bin/rollup"
             },
             "engines": {
-                "node": ">=4"
+                "node": ">=18.0.0",
+                "npm": ">=8.0.0"
+            },
+            "optionalDependencies": {
+                "@rollup/rollup-android-arm-eabi": "4.25.0",
+                "@rollup/rollup-android-arm64": "4.25.0",
+                "@rollup/rollup-darwin-arm64": "4.25.0",
+                "@rollup/rollup-darwin-x64": "4.25.0",
+                "@rollup/rollup-freebsd-arm64": "4.25.0",
+                "@rollup/rollup-freebsd-x64": "4.25.0",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
+                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
+                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
+                "@rollup/rollup-linux-arm64-musl": "4.25.0",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
+                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
+                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-gnu": "4.25.0",
+                "@rollup/rollup-linux-x64-musl": "4.25.0",
+                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
+                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
+                "@rollup/rollup-win32-x64-msvc": "4.25.0",
+                "fsevents": "~2.3.2"
             }
         },
-        "node_modules/tailwindcss/node_modules/yaml": {
-            "version": "2.6.0",
+        "node_modules/source-map": {
+            "version": "0.6.1",
             "dev": true,
-            "license": "ISC",
-            "bin": {
-                "yaml": "bin.mjs"
-            },
+            "license": "BSD-3-Clause",
+            "optional": true,
+            "peer": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/source-map-js": {
+            "version": "1.2.1",
+            "dev": true,
+            "license": "BSD-3-Clause",
             "engines": {
-                "node": ">= 14"
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/source-map-support": {
+            "version": "0.5.21",
+            "dev": true,
+            "license": "MIT",
+            "optional": true,
+            "peer": true,
+            "dependencies": {
+                "buffer-from": "^1.0.0",
+                "source-map": "^0.6.0"
             }
         },
+        "node_modules/tailwindcss": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.4.tgz",
+            "integrity": "sha512-1ZIUqtPITFbv/DxRmDr5/agPqJwF69d24m9qmM1939TJehgY539CtzeZRjbLt5G6fSy/7YqqYsfvoTEw9xUI2A==",
+            "dev": true
+        },
         "node_modules/terser": {
             "version": "5.36.0",
             "dev": true,
@@ -2130,41 +1115,6 @@
             "optional": true,
             "peer": true
         },
-        "node_modules/thenify": {
-            "version": "3.3.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "any-promise": "^1.0.0"
-            }
-        },
-        "node_modules/thenify-all": {
-            "version": "1.6.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "thenify": ">= 3.1.0 < 4"
-            },
-            "engines": {
-                "node": ">=0.8"
-            }
-        },
-        "node_modules/to-regex-range": {
-            "version": "5.0.1",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "is-number": "^7.0.0"
-            },
-            "engines": {
-                "node": ">=8.0"
-            }
-        },
-        "node_modules/ts-interface-checker": {
-            "version": "0.1.13",
-            "dev": true,
-            "license": "Apache-2.0"
-        },
         "node_modules/undici-types": {
             "version": "6.19.8",
             "dev": true,
@@ -2264,44 +1214,9 @@
                     "optional": true
                 }
             }
-        },
-        "node_modules/which": {
-            "version": "2.0.2",
-            "dev": true,
-            "license": "ISC",
-            "dependencies": {
-                "isexe": "^2.0.0"
-            },
-            "bin": {
-                "node-which": "bin/node-which"
-            },
-            "engines": {
-                "node": ">= 8"
-            }
-        },
-        "node_modules/wrap-ansi-cjs": {
-            "name": "wrap-ansi",
-            "version": "7.0.0",
-            "dev": true,
-            "license": "MIT",
-            "dependencies": {
-                "ansi-styles": "^4.0.0",
-                "string-width": "^4.1.0",
-                "strip-ansi": "^6.0.0"
-            },
-            "engines": {
-                "node": ">=10"
-            },
-            "funding": {
-                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
-            }
         }
     },
     "dependencies": {
-        "@alloc/quick-lru": {
-            "version": "5.2.0",
-            "dev": true
-        },
         "@esbuild/aix-ppc64": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
@@ -2463,60 +1378,11 @@
             "dev": true,
             "optional": true
         },
-        "@isaacs/cliui": {
-            "version": "8.0.2",
-            "dev": true,
-            "requires": {
-                "string-width": "^5.1.2",
-                "string-width-cjs": "npm:string-width@^4.2.0",
-                "strip-ansi": "^7.0.1",
-                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
-                "wrap-ansi": "^8.1.0",
-                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
-            },
-            "dependencies": {
-                "ansi-regex": {
-                    "version": "6.1.0",
-                    "dev": true
-                },
-                "ansi-styles": {
-                    "version": "6.2.1",
-                    "dev": true
-                },
-                "emoji-regex": {
-                    "version": "9.2.2",
-                    "dev": true
-                },
-                "string-width": {
-                    "version": "5.1.2",
-                    "dev": true,
-                    "requires": {
-                        "eastasianwidth": "^0.2.0",
-                        "emoji-regex": "^9.2.2",
-                        "strip-ansi": "^7.0.1"
-                    }
-                },
-                "strip-ansi": {
-                    "version": "7.1.0",
-                    "dev": true,
-                    "requires": {
-                        "ansi-regex": "^6.0.1"
-                    }
-                },
-                "wrap-ansi": {
-                    "version": "8.1.0",
-                    "dev": true,
-                    "requires": {
-                        "ansi-styles": "^6.1.0",
-                        "string-width": "^5.0.1",
-                        "strip-ansi": "^7.0.1"
-                    }
-                }
-            }
-        },
         "@jridgewell/gen-mapping": {
             "version": "0.3.5",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
                 "@jridgewell/set-array": "^1.2.1",
                 "@jridgewell/sourcemap-codec": "^1.4.10",
@@ -2525,11 +1391,15 @@
         },
         "@jridgewell/resolve-uri": {
             "version": "3.1.2",
-            "dev": true
+            "dev": true,
+            "optional": true,
+            "peer": true
         },
         "@jridgewell/set-array": {
             "version": "1.2.1",
-            "dev": true
+            "dev": true,
+            "optional": true,
+            "peer": true
         },
         "@jridgewell/source-map": {
             "version": "0.3.6",
@@ -2543,41 +1413,20 @@
         },
         "@jridgewell/sourcemap-codec": {
             "version": "1.5.0",
-            "dev": true
+            "dev": true,
+            "optional": true,
+            "peer": true
         },
         "@jridgewell/trace-mapping": {
             "version": "0.3.25",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
                 "@jridgewell/resolve-uri": "^3.1.0",
                 "@jridgewell/sourcemap-codec": "^1.4.14"
             }
         },
-        "@nodelib/fs.scandir": {
-            "version": "2.1.5",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.stat": "2.0.5",
-                "run-parallel": "^1.1.9"
-            }
-        },
-        "@nodelib/fs.stat": {
-            "version": "2.0.5",
-            "dev": true
-        },
-        "@nodelib/fs.walk": {
-            "version": "1.2.8",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.scandir": "2.1.5",
-                "fastq": "^1.6.0"
-            }
-        },
-        "@pkgjs/parseargs": {
-            "version": "0.11.0",
-            "dev": true,
-            "optional": true
-        },
         "@rollup/rollup-android-arm-eabi": {
             "version": "4.25.0",
             "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
@@ -2718,47 +1567,20 @@
             "version": "1.0.6",
             "dev": true
         },
-        "@types/node": {
-            "version": "22.9.0",
-            "dev": true,
-            "optional": true,
-            "peer": true,
-            "requires": {
-                "undici-types": "~6.19.8"
-            }
-        },
-        "acorn": {
-            "version": "8.14.0",
-            "dev": true,
-            "optional": true,
-            "peer": true
-        },
-        "ansi-regex": {
-            "version": "5.0.1",
-            "dev": true
-        },
-        "ansi-styles": {
-            "version": "4.3.0",
-            "dev": true,
-            "requires": {
-                "color-convert": "^2.0.1"
-            }
-        },
-        "any-promise": {
-            "version": "1.3.0",
-            "dev": true
-        },
-        "anymatch": {
-            "version": "3.1.3",
+        "@types/node": {
+            "version": "22.9.0",
             "dev": true,
+            "optional": true,
+            "peer": true,
             "requires": {
-                "normalize-path": "^3.0.0",
-                "picomatch": "^2.0.4"
+                "undici-types": "~6.19.8"
             }
         },
-        "arg": {
-            "version": "5.0.2",
-            "dev": true
+        "acorn": {
+            "version": "8.14.0",
+            "dev": true,
+            "optional": true,
+            "peer": true
         },
         "autoprefixer": {
             "version": "10.4.20",
@@ -2772,21 +1594,6 @@
                 "postcss-value-parser": "^4.2.0"
             }
         },
-        "balanced-match": {
-            "version": "1.0.2",
-            "dev": true
-        },
-        "binary-extensions": {
-            "version": "2.3.0",
-            "dev": true
-        },
-        "braces": {
-            "version": "3.0.3",
-            "dev": true,
-            "requires": {
-                "fill-range": "^7.1.1"
-            }
-        },
         "browserslist": {
             "version": "4.24.2",
             "dev": true,
@@ -2803,72 +1610,18 @@
             "optional": true,
             "peer": true
         },
-        "camelcase-css": {
-            "version": "2.0.1",
-            "dev": true
-        },
         "caniuse-lite": {
             "version": "1.0.30001679",
             "dev": true
         },
-        "chokidar": {
-            "version": "3.6.0",
-            "dev": true,
-            "requires": {
-                "anymatch": "~3.1.2",
-                "braces": "~3.0.2",
-                "fsevents": "~2.3.2",
-                "glob-parent": "~5.1.2",
-                "is-binary-path": "~2.1.0",
-                "is-glob": "~4.0.1",
-                "normalize-path": "~3.0.0",
-                "readdirp": "~3.6.0"
-            }
-        },
-        "color-convert": {
-            "version": "2.0.1",
-            "dev": true,
-            "requires": {
-                "color-name": "~1.1.4"
-            }
-        },
-        "color-name": {
-            "version": "1.1.4",
-            "dev": true
-        },
-        "cross-spawn": {
-            "version": "7.0.5",
-            "dev": true,
-            "requires": {
-                "path-key": "^3.1.0",
-                "shebang-command": "^2.0.0",
-                "which": "^2.0.1"
-            }
-        },
         "cssesc": {
             "version": "3.0.0",
             "dev": true
         },
-        "didyoumean": {
-            "version": "1.2.2",
-            "dev": true
-        },
-        "dlv": {
-            "version": "1.1.3",
-            "dev": true
-        },
-        "eastasianwidth": {
-            "version": "0.2.0",
-            "dev": true
-        },
         "electron-to-chromium": {
             "version": "1.5.55",
             "dev": true
         },
-        "emoji-regex": {
-            "version": "8.0.0",
-            "dev": true
-        },
         "esbuild": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
@@ -2904,45 +1657,6 @@
             "version": "3.2.0",
             "dev": true
         },
-        "fast-glob": {
-            "version": "3.3.2",
-            "dev": true,
-            "requires": {
-                "@nodelib/fs.stat": "^2.0.2",
-                "@nodelib/fs.walk": "^1.2.3",
-                "glob-parent": "^5.1.2",
-                "merge2": "^1.3.0",
-                "micromatch": "^4.0.4"
-            }
-        },
-        "fastq": {
-            "version": "1.17.1",
-            "dev": true,
-            "requires": {
-                "reusify": "^1.0.4"
-            }
-        },
-        "fill-range": {
-            "version": "7.1.1",
-            "dev": true,
-            "requires": {
-                "to-regex-range": "^5.0.1"
-            }
-        },
-        "foreground-child": {
-            "version": "3.3.0",
-            "dev": true,
-            "requires": {
-                "cross-spawn": "^7.0.0",
-                "signal-exit": "^4.0.1"
-            },
-            "dependencies": {
-                "signal-exit": {
-                    "version": "4.1.0",
-                    "dev": true
-                }
-            }
-        },
         "fraction.js": {
             "version": "4.3.7",
             "dev": true
@@ -2954,85 +1668,10 @@
             "dev": true,
             "optional": true
         },
-        "function-bind": {
-            "version": "1.1.2",
-            "dev": true
-        },
-        "glob-parent": {
-            "version": "5.1.2",
-            "dev": true,
-            "requires": {
-                "is-glob": "^4.0.1"
-            }
-        },
-        "hasown": {
-            "version": "2.0.2",
-            "dev": true,
-            "requires": {
-                "function-bind": "^1.1.2"
-            }
-        },
         "hydefront": {
             "version": "3.4.1",
             "dev": true
         },
-        "is-binary-path": {
-            "version": "2.1.0",
-            "dev": true,
-            "requires": {
-                "binary-extensions": "^2.0.0"
-            }
-        },
-        "is-core-module": {
-            "version": "2.15.1",
-            "dev": true,
-            "requires": {
-                "hasown": "^2.0.2"
-            }
-        },
-        "is-extglob": {
-            "version": "2.1.1",
-            "dev": true
-        },
-        "is-fullwidth-code-point": {
-            "version": "3.0.0",
-            "dev": true
-        },
-        "is-glob": {
-            "version": "4.0.3",
-            "dev": true,
-            "requires": {
-                "is-extglob": "^2.1.1"
-            }
-        },
-        "is-number": {
-            "version": "7.0.0",
-            "dev": true
-        },
-        "isexe": {
-            "version": "2.0.0",
-            "dev": true
-        },
-        "jackspeak": {
-            "version": "3.4.3",
-            "dev": true,
-            "requires": {
-                "@isaacs/cliui": "^8.0.2",
-                "@pkgjs/parseargs": "^0.11.0"
-            }
-        },
-        "jiti": {
-            "version": "1.21.6",
-            "dev": true
-        },
-        "lilconfig": {
-            "version": "2.1.0",
-            "dev": true
-        },
-        "lines-and-columns": {
-            "version": "1.2.4",
-            "dev": true
-        },
         "lodash.castarray": {
             "version": "4.4.0",
             "dev": true
@@ -3045,31 +1684,6 @@
             "version": "4.6.2",
             "dev": true
         },
-        "merge2": {
-            "version": "1.4.1",
-            "dev": true
-        },
-        "micromatch": {
-            "version": "4.0.8",
-            "dev": true,
-            "requires": {
-                "braces": "^3.0.3",
-                "picomatch": "^2.3.1"
-            }
-        },
-        "minipass": {
-            "version": "7.1.2",
-            "dev": true
-        },
-        "mz": {
-            "version": "2.7.0",
-            "dev": true,
-            "requires": {
-                "any-promise": "^1.0.0",
-                "object-assign": "^4.0.1",
-                "thenify-all": "^1.0.0"
-            }
-        },
         "nanoid": {
             "version": "3.3.7",
             "dev": true
@@ -3078,64 +1692,14 @@
             "version": "2.0.18",
             "dev": true
         },
-        "normalize-path": {
-            "version": "3.0.0",
-            "dev": true
-        },
         "normalize-range": {
             "version": "0.1.2",
             "dev": true
         },
-        "object-assign": {
-            "version": "4.1.1",
-            "dev": true
-        },
-        "object-hash": {
-            "version": "3.0.0",
-            "dev": true
-        },
-        "package-json-from-dist": {
-            "version": "1.0.1",
-            "dev": true
-        },
-        "path-key": {
-            "version": "3.1.1",
-            "dev": true
-        },
-        "path-parse": {
-            "version": "1.0.7",
-            "dev": true
-        },
-        "path-scurry": {
-            "version": "1.11.1",
-            "dev": true,
-            "requires": {
-                "lru-cache": "^10.2.0",
-                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
-            },
-            "dependencies": {
-                "lru-cache": {
-                    "version": "10.4.3",
-                    "dev": true
-                }
-            }
-        },
         "picocolors": {
             "version": "1.1.1",
             "dev": true
         },
-        "picomatch": {
-            "version": "2.3.1",
-            "dev": true
-        },
-        "pify": {
-            "version": "2.3.0",
-            "dev": true
-        },
-        "pirates": {
-            "version": "4.0.6",
-            "dev": true
-        },
         "postcss": {
             "version": "8.4.49",
             "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz",
@@ -3147,39 +1711,6 @@
                 "source-map-js": "^1.2.1"
             }
         },
-        "postcss-import": {
-            "version": "15.1.0",
-            "dev": true,
-            "requires": {
-                "postcss-value-parser": "^4.0.0",
-                "read-cache": "^1.0.0",
-                "resolve": "^1.1.7"
-            }
-        },
-        "postcss-js": {
-            "version": "4.0.1",
-            "dev": true,
-            "requires": {
-                "camelcase-css": "^2.0.1"
-            }
-        },
-        "postcss-nested": {
-            "version": "6.2.0",
-            "dev": true,
-            "requires": {
-                "postcss-selector-parser": "^6.1.1"
-            },
-            "dependencies": {
-                "postcss-selector-parser": {
-                    "version": "6.1.2",
-                    "dev": true,
-                    "requires": {
-                        "cssesc": "^3.0.0",
-                        "util-deprecate": "^1.0.2"
-                    }
-                }
-            }
-        },
         "postcss-selector-parser": {
             "version": "6.0.10",
             "dev": true,
@@ -3196,37 +1727,6 @@
             "version": "3.3.3",
             "dev": true
         },
-        "queue-microtask": {
-            "version": "1.2.3",
-            "dev": true
-        },
-        "read-cache": {
-            "version": "1.0.0",
-            "dev": true,
-            "requires": {
-                "pify": "^2.3.0"
-            }
-        },
-        "readdirp": {
-            "version": "3.6.0",
-            "dev": true,
-            "requires": {
-                "picomatch": "^2.2.1"
-            }
-        },
-        "resolve": {
-            "version": "1.22.8",
-            "dev": true,
-            "requires": {
-                "is-core-module": "^2.13.0",
-                "path-parse": "^1.0.7",
-                "supports-preserve-symlinks-flag": "^1.0.0"
-            }
-        },
-        "reusify": {
-            "version": "1.0.4",
-            "dev": true
-        },
         "rollup": {
             "version": "4.25.0",
             "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
@@ -3255,24 +1755,6 @@
                 "fsevents": "~2.3.2"
             }
         },
-        "run-parallel": {
-            "version": "1.2.0",
-            "dev": true,
-            "requires": {
-                "queue-microtask": "^1.2.2"
-            }
-        },
-        "shebang-command": {
-            "version": "2.0.0",
-            "dev": true,
-            "requires": {
-                "shebang-regex": "^3.0.0"
-            }
-        },
-        "shebang-regex": {
-            "version": "3.0.0",
-            "dev": true
-        },
         "source-map": {
             "version": "0.6.1",
             "dev": true,
@@ -3293,151 +1775,11 @@
                 "source-map": "^0.6.0"
             }
         },
-        "string-width": {
-            "version": "4.2.3",
-            "dev": true,
-            "requires": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            }
-        },
-        "string-width-cjs": {
-            "version": "npm:string-width@4.2.3",
-            "dev": true,
-            "requires": {
-                "emoji-regex": "^8.0.0",
-                "is-fullwidth-code-point": "^3.0.0",
-                "strip-ansi": "^6.0.1"
-            }
-        },
-        "strip-ansi": {
-            "version": "6.0.1",
-            "dev": true,
-            "requires": {
-                "ansi-regex": "^5.0.1"
-            }
-        },
-        "strip-ansi-cjs": {
-            "version": "npm:strip-ansi@6.0.1",
-            "dev": true,
-            "requires": {
-                "ansi-regex": "^5.0.1"
-            }
-        },
-        "sucrase": {
-            "version": "3.35.0",
-            "dev": true,
-            "requires": {
-                "@jridgewell/gen-mapping": "^0.3.2",
-                "commander": "^4.0.0",
-                "glob": "^10.3.10",
-                "lines-and-columns": "^1.1.6",
-                "mz": "^2.7.0",
-                "pirates": "^4.0.1",
-                "ts-interface-checker": "^0.1.9"
-            },
-            "dependencies": {
-                "brace-expansion": {
-                    "version": "2.0.1",
-                    "dev": true,
-                    "requires": {
-                        "balanced-match": "^1.0.0"
-                    }
-                },
-                "commander": {
-                    "version": "4.1.1",
-                    "dev": true
-                },
-                "glob": {
-                    "version": "10.4.5",
-                    "dev": true,
-                    "requires": {
-                        "foreground-child": "^3.1.0",
-                        "jackspeak": "^3.1.2",
-                        "minimatch": "^9.0.4",
-                        "minipass": "^7.1.2",
-                        "package-json-from-dist": "^1.0.0",
-                        "path-scurry": "^1.11.1"
-                    }
-                },
-                "minimatch": {
-                    "version": "9.0.5",
-                    "dev": true,
-                    "requires": {
-                        "brace-expansion": "^2.0.1"
-                    }
-                }
-            }
-        },
-        "supports-preserve-symlinks-flag": {
-            "version": "1.0.0",
-            "dev": true
-        },
         "tailwindcss": {
-            "version": "3.4.15",
-            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.15.tgz",
-            "integrity": "sha512-r4MeXnfBmSOuKUWmXe6h2CcyfzJCEk4F0pptO5jlnYSIViUkVmsawj80N5h2lO3gwcmSb4n3PuN+e+GC1Guylw==",
-            "dev": true,
-            "requires": {
-                "@alloc/quick-lru": "^5.2.0",
-                "arg": "^5.0.2",
-                "chokidar": "^3.6.0",
-                "didyoumean": "^1.2.2",
-                "dlv": "^1.1.3",
-                "fast-glob": "^3.3.2",
-                "glob-parent": "^6.0.2",
-                "is-glob": "^4.0.3",
-                "jiti": "^1.21.6",
-                "lilconfig": "^2.1.0",
-                "micromatch": "^4.0.8",
-                "normalize-path": "^3.0.0",
-                "object-hash": "^3.0.0",
-                "picocolors": "^1.1.1",
-                "postcss": "^8.4.47",
-                "postcss-import": "^15.1.0",
-                "postcss-js": "^4.0.1",
-                "postcss-load-config": "^4.0.2",
-                "postcss-nested": "^6.2.0",
-                "postcss-selector-parser": "^6.1.2",
-                "resolve": "^1.22.8",
-                "sucrase": "^3.35.0"
-            },
-            "dependencies": {
-                "glob-parent": {
-                    "version": "6.0.2",
-                    "dev": true,
-                    "requires": {
-                        "is-glob": "^4.0.3"
-                    }
-                },
-                "postcss-load-config": {
-                    "version": "4.0.2",
-                    "dev": true,
-                    "requires": {
-                        "lilconfig": "^3.0.0",
-                        "yaml": "^2.3.4"
-                    },
-                    "dependencies": {
-                        "lilconfig": {
-                            "version": "3.1.2",
-                            "dev": true
-                        }
-                    }
-                },
-                "postcss-selector-parser": {
-                    "version": "6.1.2",
-                    "dev": true,
-                    "requires": {
-                        "cssesc": "^3.0.0",
-                        "util-deprecate": "^1.0.2"
-                    }
-                },
-                "yaml": {
-                    "version": "2.6.0",
-                    "dev": true
-                }
-            }
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-4.1.4.tgz",
+            "integrity": "sha512-1ZIUqtPITFbv/DxRmDr5/agPqJwF69d24m9qmM1939TJehgY539CtzeZRjbLt5G6fSy/7YqqYsfvoTEw9xUI2A==",
+            "dev": true
         },
         "terser": {
             "version": "5.36.0",
@@ -3459,31 +1801,6 @@
                 }
             }
         },
-        "thenify": {
-            "version": "3.3.1",
-            "dev": true,
-            "requires": {
-                "any-promise": "^1.0.0"
-            }
-        },
-        "thenify-all": {
-            "version": "1.6.0",
-            "dev": true,
-            "requires": {
-                "thenify": ">= 3.1.0 < 4"
-            }
-        },
-        "to-regex-range": {
-            "version": "5.0.1",
-            "dev": true,
-            "requires": {
-                "is-number": "^7.0.0"
-            }
-        },
-        "ts-interface-checker": {
-            "version": "0.1.13",
-            "dev": true
-        },
         "undici-types": {
             "version": "6.19.8",
             "dev": true,
@@ -3513,22 +1830,6 @@
                 "postcss": "^8.4.43",
                 "rollup": "^4.20.0"
             }
-        },
-        "which": {
-            "version": "2.0.2",
-            "dev": true,
-            "requires": {
-                "isexe": "^2.0.0"
-            }
-        },
-        "wrap-ansi-cjs": {
-            "version": "npm:wrap-ansi@7.0.0",
-            "dev": true,
-            "requires": {
-                "ansi-styles": "^4.0.0",
-                "string-width": "^4.1.0",
-                "strip-ansi": "^6.0.0"
-            }
         }
     }
 }
diff --git a/package.json b/package.json
index fca9243c396..dce0a23b93f 100644
--- a/package.json
+++ b/package.json
@@ -10,7 +10,7 @@
         "hydefront": "^3.3.0",
         "postcss": "^8.4.49",
         "prettier": "3.3.3",
-        "tailwindcss": "^3.4.15",
+        "tailwindcss": "^4.1.4",
         "vite": "^5.0.0"
     }
 }
diff --git a/packages/framework/resources/views/components/docs/hyde-search.blade.php b/packages/framework/resources/views/components/docs/hyde-search.blade.php
index 85289f86dfd..03677724a2b 100644
--- a/packages/framework/resources/views/components/docs/hyde-search.blade.php
+++ b/packages/framework/resources/views/components/docs/hyde-search.blade.php
@@ -7,7 +7,7 @@
 
     <div class="relative">
         <input type="search" name="search" id="search-input" x-model="searchTerm" @input="search()" placeholder="Search..." autocomplete="off" autofocus
-                {{ $attributes->merge(['class' => 'w-full rounded text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
+                {{ $attributes->merge(['class' => 'w-full rounded-sm text-base leading-normal bg-gray-100 dark:bg-gray-700 py-2 px-3']) }}
         >
 
         <div x-show="isLoading" class="absolute right-3 top-2.5">
diff --git a/packages/framework/resources/views/components/docs/search-modal.blade.php b/packages/framework/resources/views/components/docs/search-modal.blade.php
index 975f61170d2..0c4c3e0169b 100644
--- a/packages/framework/resources/views/components/docs/search-modal.blade.php
+++ b/packages/framework/resources/views/components/docs/search-modal.blade.php
@@ -38,7 +38,7 @@ class="opacity-75 hover:opacity-100" aria-label="Close search window">
             </button>
         </header>
 
-        <div class="flex-grow">
+        <div class="grow">
             <x-hyde::docs.hyde-search />
         </div>
 
diff --git a/packages/framework/resources/views/homepages/welcome.blade.php b/packages/framework/resources/views/homepages/welcome.blade.php
index c8989f5ba9e..ed3a8c6175a 100644
--- a/packages/framework/resources/views/homepages/welcome.blade.php
+++ b/packages/framework/resources/views/homepages/welcome.blade.php
@@ -9,7 +9,7 @@
 
     <style>
         /*! tailwindcss v3.0.23 | MIT License | https://tailwindcss.com*/
-        *,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b{font-weight:bolder}code{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}[type=button],[type=reset],[type=submit]{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}h1,h2,h3,h4,h5,h6,p{margin:0}[role=button]{cursor:pointer}:disabled{cursor:default}[hidden]{display:none}*,:after,:before{--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-scroll-snap-strictness:proximity;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.static{position:static}.relative{position:relative}.top-0{top:0}.left-0{left:0}.m-2{margin:.5rem}.my-auto{margin-top:auto;margin-bottom:auto}.mx-auto{margin-left:auto;margin-right:auto}.mx-3{margin-left:.75rem;margin-right:.75rem}.mb-4{margin-bottom:1rem}.mt-2{margin-top:.5rem}.mt-8{margin-top:2rem}.mt-4{margin-top:1rem}.mt-auto{margin-top:auto}.block{display:block}.flex{display:flex}.hidden{display:none}.h-16{height:4rem}.h-screen{height:100vh}.min-h-screen{min-height:100vh}.w-screen{width:100vw}.w-64{width:16rem}.max-w-7xl{max-width:80rem}.max-w-lg{max-width:32rem}.max-w-3xl{max-width:48rem}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.justify-center{justify-content:center}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.p-4{padding:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-4{padding-left:1rem;padding-right:1rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-16{padding-top:4rem;padding-bottom:4rem}.px-8{padding-left:2rem;padding-right:2rem}.pb-12{padding-bottom:3rem}.text-left{text-align:left}.text-center{text-align:center}.text-5xl{font-size:3rem;line-height:1}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-extrabold{font-weight:800}.font-bold{font-weight:700}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.tracking-tight{letter-spacing:-.025em}.tracking-normal{letter-spacing:0}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.text-transparent{color:#0000}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.shadow-lg{--tw-shadow:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a;--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px #00000026);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px #0000001a,0 8px 10px -6px #0000001a;--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:absolute{position:absolute}.md\:left-72{left:18rem}.md\:mt-8{margin-top:2rem}.md\:mt-0{margin-top:0}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:max-w-none{max-width:none}.md\:max-w-2xl{max-width:42rem}.md\:text-center{text-align:center}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:text-5xl{font-size:3rem;line-height:1}}@media (min-width:1024px){.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:left-80{left:20rem}}.sr-only{position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;}.list-none{list-style-type: none;}
+        *,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b{font-weight:bolder}code{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}[type=button],[type=reset],[type=submit]{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}h1,h2,h3,h4,h5,h6,p{margin:0}[role=button]{cursor:pointer}:disabled{cursor:default}[hidden]{display:none}*,:after,:before{--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-scroll-snap-strictness:proximity;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.static{position:static}.relative{position:relative}.top-0{top:0}.left-0{left:0}.m-2{margin:.5rem}.my-auto{margin-top:auto;margin-bottom:auto}.mx-auto{margin-left:auto;margin-right:auto}.mx-3{margin-left:.75rem;margin-right:.75rem}.mb-4{margin-bottom:1rem}.mt-2{margin-top:.5rem}.mt-8{margin-top:2rem}.mt-4{margin-top:1rem}.mt-auto{margin-top:auto}.block{display:block}.flex{display:flex}.hidden{display:none}.h-16{height:4rem}.h-screen{height:100vh}.min-h-screen{min-height:100vh}.w-screen{width:100vw}.w-64{width:16rem}.max-w-7xl{max-width:80rem}.max-w-lg{max-width:32rem}.max-w-3xl{max-width:48rem}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.justify-center{justify-content:center}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-linear-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.p-4{padding:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-4{padding-left:1rem;padding-right:1rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-16{padding-top:4rem;padding-bottom:4rem}.px-8{padding-left:2rem;padding-right:2rem}.pb-12{padding-bottom:3rem}.text-left{text-align:left}.text-center{text-align:center}.text-5xl{font-size:3rem;line-height:1}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-extrabold{font-weight:800}.font-bold{font-weight:700}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.tracking-tight{letter-spacing:-.025em}.tracking-normal{letter-spacing:0}.text-gray-100{--tw-text-opacity:1;color:rgb(243 244 246/var(--tw-text-opacity))}.text-transparent{color:#0000}.text-gray-200{--tw-text-opacity:1;color:rgb(229 231 235/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.shadow-lg{--tw-shadow:0 10px 15px -3px #0000001a,0 4px 6px -4px #0000001a;--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.shadow-lg,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px #0000001a,0 2px 4px -2px #0000001a;--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.drop-shadow-2xl{--tw-drop-shadow:drop-shadow(0 25px 25px #00000026);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}@media (min-width:640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px #0000001a,0 8px 10px -6px #0000001a;--tw-shadow-colored:0 20px 25px -5px var(--tw-shadow-color),0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:768px){.md\:absolute{position:absolute}.md\:left-72{left:18rem}.md\:mt-8{margin-top:2rem}.md\:mt-0{margin-top:0}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:max-w-none{max-width:none}.md\:max-w-2xl{max-width:42rem}.md\:text-center{text-align:center}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:text-5xl{font-size:3rem;line-height:1}}@media (min-width:1024px){.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width:1280px){.xl\:left-80{left:20rem}}.sr-only{position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;}.list-none{list-style-type: none;}
     </style>
 
     <style>
@@ -37,7 +37,7 @@
             <h1
                 class="text-5xl font-extrabold leading-10 tracking-tight text-left text-gray-100 md:text-center sm:leading-none md:text-6xl lg:text-7xl">
                 <span class="block text-4xl md:text-5xl mb-4 sm:mb-0">You're running on </span><span
-                    class="relative mt-2 text-transparent bg-clip-text bg-gradient-to-br logo-gradient md:inline-block drop-shadow-2xl tracking-normal">HydePHP</span>
+                    class="relative mt-2 text-transparent bg-clip-text bg-linear-to-br logo-gradient md:inline-block drop-shadow-2xl tracking-normal">HydePHP</span>
             </h1>
             <div class="mx-auto mt-8 sm:mt-4 text-gray-200 md:mt-8 md:max-w-2xl md:text-center">
                 <section aria-label="About Hyde">
diff --git a/packages/framework/resources/views/layouts/navigation.blade.php b/packages/framework/resources/views/layouts/navigation.blade.php
index 5c29a8871e7..12841622790 100644
--- a/packages/framework/resources/views/layouts/navigation.blade.php
+++ b/packages/framework/resources/views/layouts/navigation.blade.php
@@ -3,7 +3,7 @@
 @endphp
 
 <nav aria-label="Main navigation" id="main-navigation" class="flex flex-wrap items-center justify-between p-4 shadow-lg sm:shadow-xl md:shadow-none dark:bg-gray-800">
-    <div id="main-navigation-brand" class="flex flex-grow items-center flex-shrink-0 text-gray-700 dark:text-gray-200">
+    <div id="main-navigation-brand" class="flex grow items-center shrink-0 text-gray-700 dark:text-gray-200">
         @include('hyde::components.navigation.navigation-brand')
 
         <div class="ml-auto">
@@ -33,9 +33,9 @@
     </div>
 
     <div id="main-navigation-links" 
-         class="w-full hidden md:flex flex-grow md:flex-grow-0 md:items-center md:w-auto px-6 -mx-4 border-t mt-3 pt-3 md:border-none md:mt-0 md:py-0 border-gray-200 dark:border-gray-700"
-         :class="navigationOpen ? '!block' : ''">
-        <ul aria-label="Navigation links" class="md:flex-grow md:flex justify-end">
+         class="w-full hidden md:flex grow md:grow-0 md:items-center md:w-auto px-6 -mx-4 border-t mt-3 pt-3 md:border-none md:mt-0 md:py-0 border-gray-200 dark:border-gray-700"
+         :class="navigationOpen ? 'block!' : ''">
+        <ul aria-label="Navigation links" class="md:grow md:flex justify-end">
             @foreach ($navigation->getItems() as $item)
                 <li class="md:mx-2">
                     @if($item instanceof \Hyde\Framework\Features\Navigation\NavigationGroup)
diff --git a/resources/assets/app.css b/resources/assets/app.css
index 42de1227e3f..28818a9ac56 100644
--- a/resources/assets/app.css
+++ b/resources/assets/app.css
@@ -11,8 +11,8 @@
 * See https://hydephp.com/docs/1.x/managing-assets#loading-from-cdn
 */
 
-@import 'hydefront/components/torchlight.css';
+@import 'hydefront/components/torchlight.css' layer(base);
 
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
+@import 'tailwindcss';
+
+@config '../../tailwind.config.js';

From 8bb01ef1716399fe72d6250d4205615a0f1aec7b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 18:59:01 +0200
Subject: [PATCH 3954/4023] Migrate Hyde to Tailwind v4

---
 packages/hyde/package-lock.json | 9821 +++++++++++++++++++++++++++++++
 packages/hyde/package.json      |    2 +-
 2 files changed, 9822 insertions(+), 1 deletion(-)
 create mode 100644 packages/hyde/package-lock.json

diff --git a/packages/hyde/package-lock.json b/packages/hyde/package-lock.json
new file mode 100644
index 00000000000..7a2620bee2a
--- /dev/null
+++ b/packages/hyde/package-lock.json
@@ -0,0 +1,9821 @@
+{
+    "name": "hyde",
+    "lockfileVersion": 3,
+    "requires": true,
+    "packages": {
+        "": {
+            "devDependencies": {
+                "@tailwindcss/typography": "^0.5.2",
+                "autoprefixer": "^10.4.5",
+                "hydefront": "^3.4.1",
+                "laravel-mix": "^6.0.49",
+                "postcss": "^8.4.31",
+                "prettier": "3.5.3",
+                "tailwindcss": "^3.4.17"
+            }
+        },
+        "node_modules/@alloc/quick-lru": {
+            "version": "5.2.0",
+            "resolved": "https://registry.npmjs.org/@alloc/quick-lru/-/quick-lru-5.2.0.tgz",
+            "integrity": "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/@ampproject/remapping": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz",
+            "integrity": "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/gen-mapping": "^0.3.5",
+                "@jridgewell/trace-mapping": "^0.3.24"
+            },
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/@babel/code-frame": {
+            "version": "7.26.2",
+            "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.26.2.tgz",
+            "integrity": "sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-validator-identifier": "^7.25.9",
+                "js-tokens": "^4.0.0",
+                "picocolors": "^1.0.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/compat-data": {
+            "version": "7.26.8",
+            "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.26.8.tgz",
+            "integrity": "sha512-oH5UPLMWR3L2wEFLnFJ1TZXqHufiTKAiLfqw5zkhS4dKXLJ10yVztfil/twG8EDTA4F/tvVNw9nOl4ZMslB8rQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/core": {
+            "version": "7.26.10",
+            "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.26.10.tgz",
+            "integrity": "sha512-vMqyb7XCDMPvJFFOaT9kxtiRh42GwlZEg1/uIgtZshS5a/8OaduUfCi7kynKgc3Tw/6Uo2D+db9qBttghhmxwQ==",
+            "dev": true,
+            "dependencies": {
+                "@ampproject/remapping": "^2.2.0",
+                "@babel/code-frame": "^7.26.2",
+                "@babel/generator": "^7.26.10",
+                "@babel/helper-compilation-targets": "^7.26.5",
+                "@babel/helper-module-transforms": "^7.26.0",
+                "@babel/helpers": "^7.26.10",
+                "@babel/parser": "^7.26.10",
+                "@babel/template": "^7.26.9",
+                "@babel/traverse": "^7.26.10",
+                "@babel/types": "^7.26.10",
+                "convert-source-map": "^2.0.0",
+                "debug": "^4.1.0",
+                "gensync": "^1.0.0-beta.2",
+                "json5": "^2.2.3",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/babel"
+            }
+        },
+        "node_modules/@babel/core/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/generator": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.27.0.tgz",
+            "integrity": "sha512-VybsKvpiN1gU1sdMZIp7FcqphVVKEwcuj02x73uvcHE0PTihx1nlBcowYWhDwjpoAXRv43+gDzyggGnn1XZhVw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/parser": "^7.27.0",
+                "@babel/types": "^7.27.0",
+                "@jridgewell/gen-mapping": "^0.3.5",
+                "@jridgewell/trace-mapping": "^0.3.25",
+                "jsesc": "^3.0.2"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-annotate-as-pure": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.25.9.tgz",
+            "integrity": "sha512-gv7320KBUFJz1RnylIg5WWYPRXKZ884AGkYpgpWW02TH66Dl+HaC1t1CKd0z3R4b6hdYEcmrNZHUmfCP+1u3/g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-compilation-targets": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.27.0.tgz",
+            "integrity": "sha512-LVk7fbXml0H2xH34dFzKQ7TDZ2G4/rVTOrq9V+icbbadjbVxxeFeDsNHv2SrZeWoA+6ZiTyWYWtScEIW07EAcA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/compat-data": "^7.26.8",
+                "@babel/helper-validator-option": "^7.25.9",
+                "browserslist": "^4.24.0",
+                "lru-cache": "^5.1.1",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-compilation-targets/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/helper-create-class-features-plugin": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.27.0.tgz",
+            "integrity": "sha512-vSGCvMecvFCd/BdpGlhpXYNhhC4ccxyvQWpbGL4CWbvfEoLFWUZuSuf7s9Aw70flgQF+6vptvgK2IfOnKlRmBg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-annotate-as-pure": "^7.25.9",
+                "@babel/helper-member-expression-to-functions": "^7.25.9",
+                "@babel/helper-optimise-call-expression": "^7.25.9",
+                "@babel/helper-replace-supers": "^7.26.5",
+                "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9",
+                "@babel/traverse": "^7.27.0",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/helper-create-class-features-plugin/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/helper-create-regexp-features-plugin": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.27.0.tgz",
+            "integrity": "sha512-fO8l08T76v48BhpNRW/nQ0MxfnSdoSKUJBMjubOAYffsVuGG5qOfMq7N6Es7UJvi7Y8goXXo07EfcHZXDPuELQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-annotate-as-pure": "^7.25.9",
+                "regexpu-core": "^6.2.0",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/helper-create-regexp-features-plugin/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/helper-define-polyfill-provider": {
+            "version": "0.6.4",
+            "resolved": "https://registry.npmjs.org/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.6.4.tgz",
+            "integrity": "sha512-jljfR1rGnXXNWnmQg2K3+bvhkxB51Rl32QRaOTuwwjviGrHzIbSc8+x9CpraDtbT7mfyjXObULP4w/adunNwAw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-compilation-targets": "^7.22.6",
+                "@babel/helper-plugin-utils": "^7.22.5",
+                "debug": "^4.1.1",
+                "lodash.debounce": "^4.0.8",
+                "resolve": "^1.14.2"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+            }
+        },
+        "node_modules/@babel/helper-member-expression-to-functions": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.25.9.tgz",
+            "integrity": "sha512-wbfdZ9w5vk0C0oyHqAJbc62+vet5prjj01jjJ8sKn3j9h3MQQlflEdXYvuqRWjHnM12coDEqiC1IRCi0U/EKwQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/traverse": "^7.25.9",
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-module-imports": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.25.9.tgz",
+            "integrity": "sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/traverse": "^7.25.9",
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-module-transforms": {
+            "version": "7.26.0",
+            "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.26.0.tgz",
+            "integrity": "sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-imports": "^7.25.9",
+                "@babel/helper-validator-identifier": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/helper-optimise-call-expression": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.25.9.tgz",
+            "integrity": "sha512-FIpuNaz5ow8VyrYcnXQTDRGvV6tTjkNtCK/RYNDXGSLlUD6cBuQTSw43CShGxjvfBTfcUA/r6UhUCbtYqkhcuQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-plugin-utils": {
+            "version": "7.26.5",
+            "resolved": "https://registry.npmjs.org/@babel/helper-plugin-utils/-/helper-plugin-utils-7.26.5.tgz",
+            "integrity": "sha512-RS+jZcRdZdRFzMyr+wcsaqOmld1/EqTghfaBGQQd/WnRdzdlvSZ//kF7U8VQTxf1ynZ4cjUcYgjVGx13ewNPMg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-remap-async-to-generator": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.25.9.tgz",
+            "integrity": "sha512-IZtukuUeBbhgOcaW2s06OXTzVNJR0ybm4W5xC1opWFFJMZbwRj5LCk+ByYH7WdZPZTt8KnFwA8pvjN2yqcPlgw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-annotate-as-pure": "^7.25.9",
+                "@babel/helper-wrap-function": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/helper-replace-supers": {
+            "version": "7.26.5",
+            "resolved": "https://registry.npmjs.org/@babel/helper-replace-supers/-/helper-replace-supers-7.26.5.tgz",
+            "integrity": "sha512-bJ6iIVdYX1YooY2X7w1q6VITt+LnUILtNk7zT78ykuwStx8BauCzxvFqFaHjOpW1bVnSUM1PN1f0p5P21wHxvg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-member-expression-to-functions": "^7.25.9",
+                "@babel/helper-optimise-call-expression": "^7.25.9",
+                "@babel/traverse": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/helper-skip-transparent-expression-wrappers": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.25.9.tgz",
+            "integrity": "sha512-K4Du3BFa3gvyhzgPcntrkDgZzQaq6uozzcpGbOO1OEJaI+EJdqWIMTLgFgQf6lrfiDFo5FU+BxKepI9RmZqahA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/traverse": "^7.25.9",
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-string-parser": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.25.9.tgz",
+            "integrity": "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-validator-identifier": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.25.9.tgz",
+            "integrity": "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-validator-option": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.25.9.tgz",
+            "integrity": "sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helper-wrap-function": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/helper-wrap-function/-/helper-wrap-function-7.25.9.tgz",
+            "integrity": "sha512-ETzz9UTjQSTmw39GboatdymDq4XIQbR8ySgVrylRhPOFpsd+JrKHIuF0de7GCWmem+T4uC5z7EZguod7Wj4A4g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/template": "^7.25.9",
+                "@babel/traverse": "^7.25.9",
+                "@babel/types": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/helpers": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.27.0.tgz",
+            "integrity": "sha512-U5eyP/CTFPuNE3qk+WZMxFkp/4zUzdceQlfzf7DdGdhp+Fezd7HD+i8Y24ZuTMKX3wQBld449jijbGq6OdGNQg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/template": "^7.27.0",
+                "@babel/types": "^7.27.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/parser": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.27.0.tgz",
+            "integrity": "sha512-iaepho73/2Pz7w2eMS0Q5f83+0RKI7i4xmiYeBmDzfRVbQtTOG7Ts0S4HzJVsTMGI9keU8rNfuZr8DKfSt7Yyg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/types": "^7.27.0"
+            },
+            "bin": {
+                "parser": "bin/babel-parser.js"
+            },
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-bugfix-firefox-class-in-computed-class-key": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-firefox-class-in-computed-class-key/-/plugin-bugfix-firefox-class-in-computed-class-key-7.25.9.tgz",
+            "integrity": "sha512-ZkRyVkThtxQ/J6nv3JFYv1RYY+JT5BvU0y3k5bWrmuG4woXypRa4PXmm9RhOwodRkYFWqC0C0cqcJ4OqR7kW+g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-bugfix-safari-class-field-initializer-scope": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-class-field-initializer-scope/-/plugin-bugfix-safari-class-field-initializer-scope-7.25.9.tgz",
+            "integrity": "sha512-MrGRLZxLD/Zjj0gdU15dfs+HH/OXvnw/U4jJD8vpcP2CJQapPEv1IWwjc/qMg7ItBlPwSv1hRBbb7LeuANdcnw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.25.9.tgz",
+            "integrity": "sha512-2qUwwfAFpJLZqxd02YW9btUCZHl+RFvdDkNfZwaIJrvB8Tesjsk8pEQkTvGwZXLqXUx/2oyY3ySRhm6HOXuCug==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.25.9.tgz",
+            "integrity": "sha512-6xWgLZTJXwilVjlnV7ospI3xi+sl8lN8rXXbBD6vYn3UYDlGsag8wrZkKcSI8G6KgqKP7vNFaDgeDnfAABq61g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9",
+                "@babel/plugin-transform-optional-chaining": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.13.0"
+            }
+        },
+        "node_modules/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly/-/plugin-bugfix-v8-static-class-fields-redefine-readonly-7.25.9.tgz",
+            "integrity": "sha512-aLnMXYPnzwwqhYSCyXfKkIkYgJ8zv9RK+roo9DkTXz38ynIhd9XCbN08s3MGvqL2MYGVUGdRQLL/JqBIeJhJBg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-proposal-object-rest-spread": {
+            "version": "7.20.7",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-object-rest-spread/-/plugin-proposal-object-rest-spread-7.20.7.tgz",
+            "integrity": "sha512-d2S98yCiLxDVmBmE8UjGcfPvNEUbA1U5q5WxaWFUGRzJSVAZqm5W6MbPct0jxnegUZ0niLeNX+IOzEs7wYg9Dg==",
+            "deprecated": "This proposal has been merged to the ECMAScript standard and thus this plugin is no longer maintained. Please use @babel/plugin-transform-object-rest-spread instead.",
+            "dev": true,
+            "dependencies": {
+                "@babel/compat-data": "^7.20.5",
+                "@babel/helper-compilation-targets": "^7.20.7",
+                "@babel/helper-plugin-utils": "^7.20.2",
+                "@babel/plugin-syntax-object-rest-spread": "^7.8.3",
+                "@babel/plugin-transform-parameters": "^7.20.7"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-proposal-private-property-in-object": {
+            "version": "7.21.0-placeholder-for-preset-env.2",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.21.0-placeholder-for-preset-env.2.tgz",
+            "integrity": "sha512-SOSkfJDddaM7mak6cPEpswyTRnuRltl429hMraQEglW+OkovnCzsiszTmsrlY//qLFjCpQDFRvjdm2wA5pPm9w==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-syntax-dynamic-import": {
+            "version": "7.8.3",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-dynamic-import/-/plugin-syntax-dynamic-import-7.8.3.tgz",
+            "integrity": "sha512-5gdGbFon+PszYzqs83S3E5mpi7/y/8M9eC90MRTZfduQOYW76ig6SOSPNe41IG5LoP3FGBn2N0RjVDSQiS94kQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.8.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-syntax-import-assertions": {
+            "version": "7.26.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.26.0.tgz",
+            "integrity": "sha512-QCWT5Hh830hK5EQa7XzuqIkQU9tT/whqbDz7kuaZMHFl1inRRg7JnuAEOQ0Ur0QUl0NufCk1msK2BeY79Aj/eg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-syntax-import-attributes": {
+            "version": "7.26.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.26.0.tgz",
+            "integrity": "sha512-e2dttdsJ1ZTpi3B9UYGLw41hifAubg19AtCu/2I/F1QNVclOBr1dYpTdmdyZ84Xiz43BS/tCUkMAZNLv12Pi+A==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-syntax-object-rest-spread": {
+            "version": "7.8.3",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz",
+            "integrity": "sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.8.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-syntax-unicode-sets-regex": {
+            "version": "7.18.6",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-unicode-sets-regex/-/plugin-syntax-unicode-sets-regex-7.18.6.tgz",
+            "integrity": "sha512-727YkEAPwSIQTv5im8QHz3upqp92JTWhidIC81Tdx4VJYIte/VndKf1qKrfnnhPLiPghStWfvC/iFaMCQu7Nqg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.18.6",
+                "@babel/helper-plugin-utils": "^7.18.6"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-arrow-functions": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.25.9.tgz",
+            "integrity": "sha512-6jmooXYIwn9ca5/RylZADJ+EnSxVUS5sjeJ9UPk6RWRzXCmOJCy6dqItPJFpw2cuCangPK4OYr5uhGKcmrm5Qg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-async-generator-functions": {
+            "version": "7.26.8",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.26.8.tgz",
+            "integrity": "sha512-He9Ej2X7tNf2zdKMAGOsmg2MrFc+hfoAhd3po4cWfo/NWjzEAKa0oQruj1ROVUdl0e6fb6/kE/G3SSxE0lRJOg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5",
+                "@babel/helper-remap-async-to-generator": "^7.25.9",
+                "@babel/traverse": "^7.26.8"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-async-to-generator": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.25.9.tgz",
+            "integrity": "sha512-NT7Ejn7Z/LjUH0Gv5KsBCxh7BH3fbLTV0ptHvpeMvrt3cPThHfJfst9Wrb7S8EvJ7vRTFI7z+VAvFVEQn/m5zQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-imports": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-remap-async-to-generator": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-block-scoped-functions": {
+            "version": "7.26.5",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.26.5.tgz",
+            "integrity": "sha512-chuTSY+hq09+/f5lMj8ZSYgCFpppV2CbYrhNFJ1BFoXpiWPnnAb7R0MqrafCpN8E1+YRrtM1MXZHJdIx8B6rMQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-block-scoping": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.27.0.tgz",
+            "integrity": "sha512-u1jGphZ8uDI2Pj/HJj6YQ6XQLZCNjOlprjxB5SVz6rq2T6SwAR+CdrWK0CP7F+9rDVMXdB0+r6Am5G5aobOjAQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-class-properties": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-properties/-/plugin-transform-class-properties-7.25.9.tgz",
+            "integrity": "sha512-bbMAII8GRSkcd0h0b4X+36GksxuheLFjP65ul9w6C3KgAamI3JqErNgSrosX6ZPj+Mpim5VvEbawXxJCyEUV3Q==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-class-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-class-static-block": {
+            "version": "7.26.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-class-static-block/-/plugin-transform-class-static-block-7.26.0.tgz",
+            "integrity": "sha512-6J2APTs7BDDm+UMqP1useWqhcRAXo0WIoVj26N7kPFB6S73Lgvyka4KTZYIxtgYXiN5HTyRObA72N2iu628iTQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-class-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.12.0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-classes": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-classes/-/plugin-transform-classes-7.25.9.tgz",
+            "integrity": "sha512-mD8APIXmseE7oZvZgGABDyM34GUmK45Um2TXiBUt7PnuAxrgoSVf123qUzPxEr/+/BHrRn5NMZCdE2m/1F8DGg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-annotate-as-pure": "^7.25.9",
+                "@babel/helper-compilation-targets": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-replace-supers": "^7.25.9",
+                "@babel/traverse": "^7.25.9",
+                "globals": "^11.1.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-computed-properties": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.25.9.tgz",
+            "integrity": "sha512-HnBegGqXZR12xbcTHlJ9HGxw1OniltT26J5YpfruGqtUHlz/xKf/G2ak9e+t0rVqrjXa9WOhvYPz1ERfMj23AA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/template": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-destructuring": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.25.9.tgz",
+            "integrity": "sha512-WkCGb/3ZxXepmMiX101nnGiU+1CAdut8oHyEOHxkKuS1qKpU2SMXE2uSvfz8PBuLd49V6LEsbtyPhWC7fnkgvQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-dotall-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.25.9.tgz",
+            "integrity": "sha512-t7ZQ7g5trIgSRYhI9pIJtRl64KHotutUJsh4Eze5l7olJv+mRSg4/MmbZ0tv1eeqRbdvo/+trvJD/Oc5DmW2cA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-duplicate-keys": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.25.9.tgz",
+            "integrity": "sha512-LZxhJ6dvBb/f3x8xwWIuyiAHy56nrRG3PeYTpBkkzkYRRQ6tJLu68lEF5VIqMUZiAV7a8+Tb78nEoMCMcqjXBw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-duplicate-named-capturing-groups-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-duplicate-named-capturing-groups-regex/-/plugin-transform-duplicate-named-capturing-groups-regex-7.25.9.tgz",
+            "integrity": "sha512-0UfuJS0EsXbRvKnwcLjFtJy/Sxc5J5jhLHnFhy7u4zih97Hz6tJkLU+O+FMMrNZrosUPxDi6sYxJ/EA8jDiAog==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-dynamic-import": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-dynamic-import/-/plugin-transform-dynamic-import-7.25.9.tgz",
+            "integrity": "sha512-GCggjexbmSLaFhqsojeugBpeaRIgWNTcgKVq/0qIteFEqY2A+b9QidYadrWlnbWQUrW5fn+mCvf3tr7OeBFTyg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-exponentiation-operator": {
+            "version": "7.26.3",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.26.3.tgz",
+            "integrity": "sha512-7CAHcQ58z2chuXPWblnn1K6rLDnDWieghSOEmqQsrBenH0P9InCUtOJYD89pvngljmZlJcz3fcmgYsXFNGa1ZQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-export-namespace-from": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-export-namespace-from/-/plugin-transform-export-namespace-from-7.25.9.tgz",
+            "integrity": "sha512-2NsEz+CxzJIVOPx2o9UsW1rXLqtChtLoVnwYHHiB04wS5sgn7mrV45fWMBX0Kk+ub9uXytVYfNP2HjbVbCB3Ww==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-for-of": {
+            "version": "7.26.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.26.9.tgz",
+            "integrity": "sha512-Hry8AusVm8LW5BVFgiyUReuoGzPUpdHQQqJY5bZnbbf+ngOHWuCuYFKw/BqaaWlvEUrF91HMhDtEaI1hZzNbLg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5",
+                "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-function-name": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.25.9.tgz",
+            "integrity": "sha512-8lP+Yxjv14Vc5MuWBpJsoUCd3hD6V9DgBon2FVYL4jJgbnVQ9fTgYmonchzZJOVNgzEgbxp4OwAf6xz6M/14XA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-compilation-targets": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-json-strings": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-json-strings/-/plugin-transform-json-strings-7.25.9.tgz",
+            "integrity": "sha512-xoTMk0WXceiiIvsaquQQUaLLXSW1KJ159KP87VilruQm0LNNGxWzahxSS6T6i4Zg3ezp4vA4zuwiNUR53qmQAw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-literals": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-literals/-/plugin-transform-literals-7.25.9.tgz",
+            "integrity": "sha512-9N7+2lFziW8W9pBl2TzaNht3+pgMIRP74zizeCSrtnSKVdUl8mAjjOP2OOVQAfZ881P2cNjDj1uAMEdeD50nuQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-logical-assignment-operators": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-logical-assignment-operators/-/plugin-transform-logical-assignment-operators-7.25.9.tgz",
+            "integrity": "sha512-wI4wRAzGko551Y8eVf6iOY9EouIDTtPb0ByZx+ktDGHwv6bHFimrgJM/2T021txPZ2s4c7bqvHbd+vXG6K948Q==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-member-expression-literals": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.25.9.tgz",
+            "integrity": "sha512-PYazBVfofCQkkMzh2P6IdIUaCEWni3iYEerAsRWuVd8+jlM1S9S9cz1dF9hIzyoZ8IA3+OwVYIp9v9e+GbgZhA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-modules-amd": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.25.9.tgz",
+            "integrity": "sha512-g5T11tnI36jVClQlMlt4qKDLlWnG5pP9CSM4GhdRciTNMRgkfpo5cR6b4rGIOYPgRRuFAvwjPQ/Yk+ql4dyhbw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-transforms": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-modules-commonjs": {
+            "version": "7.26.3",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.26.3.tgz",
+            "integrity": "sha512-MgR55l4q9KddUDITEzEFYn5ZsGDXMSsU9E+kh7fjRXTIC3RHqfCo8RPRbyReYJh44HQ/yomFkqbOFohXvDCiIQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-transforms": "^7.26.0",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-modules-systemjs": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.25.9.tgz",
+            "integrity": "sha512-hyss7iIlH/zLHaehT+xwiymtPOpsiwIIRlCAOwBB04ta5Tt+lNItADdlXw3jAWZ96VJ2jlhl/c+PNIQPKNfvcA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-transforms": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-validator-identifier": "^7.25.9",
+                "@babel/traverse": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-modules-umd": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.25.9.tgz",
+            "integrity": "sha512-bS9MVObUgE7ww36HEfwe6g9WakQ0KF07mQF74uuXdkoziUPfKyu/nIm663kz//e5O1nPInPFx36z7WJmJ4yNEw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-transforms": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-named-capturing-groups-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.25.9.tgz",
+            "integrity": "sha512-oqB6WHdKTGl3q/ItQhpLSnWWOpjUJLsOCLVyeFgeTktkBSCiurvPOsyt93gibI9CmuKvTUEtWmG5VhZD+5T/KA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-new-target": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.25.9.tgz",
+            "integrity": "sha512-U/3p8X1yCSoKyUj2eOBIx3FOn6pElFOKvAAGf8HTtItuPyB+ZeOqfn+mvTtg9ZlOAjsPdK3ayQEjqHjU/yLeVQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-nullish-coalescing-operator": {
+            "version": "7.26.6",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-nullish-coalescing-operator/-/plugin-transform-nullish-coalescing-operator-7.26.6.tgz",
+            "integrity": "sha512-CKW8Vu+uUZneQCPtXmSBUC6NCAUdya26hWCElAWh5mVSlSRsmiCPUUDKb3Z0szng1hiAJa098Hkhg9o4SE35Qw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-numeric-separator": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-numeric-separator/-/plugin-transform-numeric-separator-7.25.9.tgz",
+            "integrity": "sha512-TlprrJ1GBZ3r6s96Yq8gEQv82s8/5HnCVHtEJScUj90thHQbwe+E5MLhi2bbNHBEJuzrvltXSru+BUxHDoog7Q==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-object-rest-spread": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-rest-spread/-/plugin-transform-object-rest-spread-7.25.9.tgz",
+            "integrity": "sha512-fSaXafEE9CVHPweLYw4J0emp1t8zYTXyzN3UuG+lylqkvYd7RMrsOQ8TYx5RF231be0vqtFC6jnx3UmpJmKBYg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-compilation-targets": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/plugin-transform-parameters": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-object-super": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.25.9.tgz",
+            "integrity": "sha512-Kj/Gh+Rw2RNLbCK1VAWj2U48yxxqL2x0k10nPtSdRa0O2xnHXalD0s+o1A6a0W43gJ00ANo38jxkQreckOzv5A==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-replace-supers": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-optional-catch-binding": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-catch-binding/-/plugin-transform-optional-catch-binding-7.25.9.tgz",
+            "integrity": "sha512-qM/6m6hQZzDcZF3onzIhZeDHDO43bkNNlOX0i8n3lR6zLbu0GN2d8qfM/IERJZYauhAHSLHy39NF0Ctdvcid7g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-optional-chaining": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-optional-chaining/-/plugin-transform-optional-chaining-7.25.9.tgz",
+            "integrity": "sha512-6AvV0FsLULbpnXeBjrY4dmWF8F7gf8QnvTEoO/wX/5xm/xE1Xo8oPuD3MPS+KS9f9XBEAWN7X1aWr4z9HdOr7A==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-parameters": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.25.9.tgz",
+            "integrity": "sha512-wzz6MKwpnshBAiRmn4jR8LYz/g8Ksg0o80XmwZDlordjwEk9SxBzTWC7F5ef1jhbrbOW2DJ5J6ayRukrJmnr0g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-private-methods": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-methods/-/plugin-transform-private-methods-7.25.9.tgz",
+            "integrity": "sha512-D/JUozNpQLAPUVusvqMxyvjzllRaF8/nSrP1s2YGQT/W4LHK4xxsMcHjhOGTS01mp9Hda8nswb+FblLdJornQw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-class-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-private-property-in-object": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-private-property-in-object/-/plugin-transform-private-property-in-object-7.25.9.tgz",
+            "integrity": "sha512-Evf3kcMqzXA3xfYJmZ9Pg1OvKdtqsDMSWBDzZOPLvHiTt36E75jLDQo5w1gtRU95Q4E5PDttrTf25Fw8d/uWLw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-annotate-as-pure": "^7.25.9",
+                "@babel/helper-create-class-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-property-literals": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.25.9.tgz",
+            "integrity": "sha512-IvIUeV5KrS/VPavfSM/Iu+RE6llrHrYIKY1yfCzyO/lMXHQ+p7uGhonmGVisv6tSBSVgWzMBohTcvkC9vQcQFA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-regenerator": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.27.0.tgz",
+            "integrity": "sha512-LX/vCajUJQDqE7Aum/ELUMZAY19+cDpghxrnyt5I1tV6X5PyC86AOoWXWFYFeIvauyeSA6/ktn4tQVn/3ZifsA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5",
+                "regenerator-transform": "^0.15.2"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-regexp-modifiers": {
+            "version": "7.26.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-regexp-modifiers/-/plugin-transform-regexp-modifiers-7.26.0.tgz",
+            "integrity": "sha512-vN6saax7lrA2yA/Pak3sCxuD6F5InBjn9IcrIKQPjpsLvuHYLVroTxjdlVRHjjBWxKOqIwpTXDkOssYT4BFdRw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-reserved-words": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.25.9.tgz",
+            "integrity": "sha512-7DL7DKYjn5Su++4RXu8puKZm2XBPHyjWLUidaPEkCUBbE7IPcsrkRHggAOOKydH1dASWdcUBxrkOGNxUv5P3Jg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-runtime": {
+            "version": "7.26.10",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.26.10.tgz",
+            "integrity": "sha512-NWaL2qG6HRpONTnj4JvDU6th4jYeZOJgu3QhmFTCihib0ermtOJqktA5BduGm3suhhVe9EMP9c9+mfJ/I9slqw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-module-imports": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.26.5",
+                "babel-plugin-polyfill-corejs2": "^0.4.10",
+                "babel-plugin-polyfill-corejs3": "^0.11.0",
+                "babel-plugin-polyfill-regenerator": "^0.6.1",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-runtime/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/plugin-transform-shorthand-properties": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.25.9.tgz",
+            "integrity": "sha512-MUv6t0FhO5qHnS/W8XCbHmiRWOphNufpE1IVxhK5kuN3Td9FT1x4rx4K42s3RYdMXCXpfWkGSbCSd0Z64xA7Ng==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-spread": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-spread/-/plugin-transform-spread-7.25.9.tgz",
+            "integrity": "sha512-oNknIB0TbURU5pqJFVbOOFspVlrpVwo2H1+HUIsVDvp5VauGGDP1ZEvO8Nn5xyMEs3dakajOxlmkNW7kNgSm6A==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9",
+                "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-sticky-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.25.9.tgz",
+            "integrity": "sha512-WqBUSgeVwucYDP9U/xNRQam7xV8W5Zf+6Eo7T2SRVUFlhRiMNFdFz58u0KZmCVVqs2i7SHgpRnAhzRNmKfi2uA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-template-literals": {
+            "version": "7.26.8",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.26.8.tgz",
+            "integrity": "sha512-OmGDL5/J0CJPJZTHZbi2XpO0tyT2Ia7fzpW5GURwdtp2X3fMmN8au/ej6peC/T33/+CRiIpA8Krse8hFGVmT5Q==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-typeof-symbol": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.27.0.tgz",
+            "integrity": "sha512-+LLkxA9rKJpNoGsbLnAgOCdESl73vwYn+V6b+5wHbrE7OGKVDPHIQvbFSzqE6rwqaCw2RE+zdJrlLkcf8YOA0w==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.26.5"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-unicode-escapes": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.25.9.tgz",
+            "integrity": "sha512-s5EDrE6bW97LtxOcGj1Khcx5AaXwiMmi4toFWRDP9/y0Woo6pXC+iyPu/KuhKtfSrNFd7jJB+/fkOtZy6aIC6Q==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-unicode-property-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-property-regex/-/plugin-transform-unicode-property-regex-7.25.9.tgz",
+            "integrity": "sha512-Jt2d8Ga+QwRluxRQ307Vlxa6dMrYEMZCgGxoPR8V52rxPyldHu3hdlHspxaqYmE7oID5+kB+UKUB/eWS+DkkWg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-unicode-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.25.9.tgz",
+            "integrity": "sha512-yoxstj7Rg9dlNn9UQxzk4fcNivwv4nUYz7fYXBaKxvw/lnmPuOm/ikoELygbYq68Bls3D/D+NBPHiLwZdZZ4HA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/plugin-transform-unicode-sets-regex": {
+            "version": "7.25.9",
+            "resolved": "https://registry.npmjs.org/@babel/plugin-transform-unicode-sets-regex/-/plugin-transform-unicode-sets-regex-7.25.9.tgz",
+            "integrity": "sha512-8BYqO3GeVNHtx69fdPshN3fnzUNLrWdHhk/icSwigksJGczKSizZ+Z6SBCxTs723Fr5VSNorTIK7a+R2tISvwQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-create-regexp-features-plugin": "^7.25.9",
+                "@babel/helper-plugin-utils": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0"
+            }
+        },
+        "node_modules/@babel/preset-env": {
+            "version": "7.26.9",
+            "resolved": "https://registry.npmjs.org/@babel/preset-env/-/preset-env-7.26.9.tgz",
+            "integrity": "sha512-vX3qPGE8sEKEAZCWk05k3cpTAE3/nOYca++JA+Rd0z2NCNzabmYvEiSShKzm10zdquOIAVXsy2Ei/DTW34KlKQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/compat-data": "^7.26.8",
+                "@babel/helper-compilation-targets": "^7.26.5",
+                "@babel/helper-plugin-utils": "^7.26.5",
+                "@babel/helper-validator-option": "^7.25.9",
+                "@babel/plugin-bugfix-firefox-class-in-computed-class-key": "^7.25.9",
+                "@babel/plugin-bugfix-safari-class-field-initializer-scope": "^7.25.9",
+                "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression": "^7.25.9",
+                "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining": "^7.25.9",
+                "@babel/plugin-bugfix-v8-static-class-fields-redefine-readonly": "^7.25.9",
+                "@babel/plugin-proposal-private-property-in-object": "7.21.0-placeholder-for-preset-env.2",
+                "@babel/plugin-syntax-import-assertions": "^7.26.0",
+                "@babel/plugin-syntax-import-attributes": "^7.26.0",
+                "@babel/plugin-syntax-unicode-sets-regex": "^7.18.6",
+                "@babel/plugin-transform-arrow-functions": "^7.25.9",
+                "@babel/plugin-transform-async-generator-functions": "^7.26.8",
+                "@babel/plugin-transform-async-to-generator": "^7.25.9",
+                "@babel/plugin-transform-block-scoped-functions": "^7.26.5",
+                "@babel/plugin-transform-block-scoping": "^7.25.9",
+                "@babel/plugin-transform-class-properties": "^7.25.9",
+                "@babel/plugin-transform-class-static-block": "^7.26.0",
+                "@babel/plugin-transform-classes": "^7.25.9",
+                "@babel/plugin-transform-computed-properties": "^7.25.9",
+                "@babel/plugin-transform-destructuring": "^7.25.9",
+                "@babel/plugin-transform-dotall-regex": "^7.25.9",
+                "@babel/plugin-transform-duplicate-keys": "^7.25.9",
+                "@babel/plugin-transform-duplicate-named-capturing-groups-regex": "^7.25.9",
+                "@babel/plugin-transform-dynamic-import": "^7.25.9",
+                "@babel/plugin-transform-exponentiation-operator": "^7.26.3",
+                "@babel/plugin-transform-export-namespace-from": "^7.25.9",
+                "@babel/plugin-transform-for-of": "^7.26.9",
+                "@babel/plugin-transform-function-name": "^7.25.9",
+                "@babel/plugin-transform-json-strings": "^7.25.9",
+                "@babel/plugin-transform-literals": "^7.25.9",
+                "@babel/plugin-transform-logical-assignment-operators": "^7.25.9",
+                "@babel/plugin-transform-member-expression-literals": "^7.25.9",
+                "@babel/plugin-transform-modules-amd": "^7.25.9",
+                "@babel/plugin-transform-modules-commonjs": "^7.26.3",
+                "@babel/plugin-transform-modules-systemjs": "^7.25.9",
+                "@babel/plugin-transform-modules-umd": "^7.25.9",
+                "@babel/plugin-transform-named-capturing-groups-regex": "^7.25.9",
+                "@babel/plugin-transform-new-target": "^7.25.9",
+                "@babel/plugin-transform-nullish-coalescing-operator": "^7.26.6",
+                "@babel/plugin-transform-numeric-separator": "^7.25.9",
+                "@babel/plugin-transform-object-rest-spread": "^7.25.9",
+                "@babel/plugin-transform-object-super": "^7.25.9",
+                "@babel/plugin-transform-optional-catch-binding": "^7.25.9",
+                "@babel/plugin-transform-optional-chaining": "^7.25.9",
+                "@babel/plugin-transform-parameters": "^7.25.9",
+                "@babel/plugin-transform-private-methods": "^7.25.9",
+                "@babel/plugin-transform-private-property-in-object": "^7.25.9",
+                "@babel/plugin-transform-property-literals": "^7.25.9",
+                "@babel/plugin-transform-regenerator": "^7.25.9",
+                "@babel/plugin-transform-regexp-modifiers": "^7.26.0",
+                "@babel/plugin-transform-reserved-words": "^7.25.9",
+                "@babel/plugin-transform-shorthand-properties": "^7.25.9",
+                "@babel/plugin-transform-spread": "^7.25.9",
+                "@babel/plugin-transform-sticky-regex": "^7.25.9",
+                "@babel/plugin-transform-template-literals": "^7.26.8",
+                "@babel/plugin-transform-typeof-symbol": "^7.26.7",
+                "@babel/plugin-transform-unicode-escapes": "^7.25.9",
+                "@babel/plugin-transform-unicode-property-regex": "^7.25.9",
+                "@babel/plugin-transform-unicode-regex": "^7.25.9",
+                "@babel/plugin-transform-unicode-sets-regex": "^7.25.9",
+                "@babel/preset-modules": "0.1.6-no-external-plugins",
+                "babel-plugin-polyfill-corejs2": "^0.4.10",
+                "babel-plugin-polyfill-corejs3": "^0.11.0",
+                "babel-plugin-polyfill-regenerator": "^0.6.1",
+                "core-js-compat": "^3.40.0",
+                "semver": "^6.3.1"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0"
+            }
+        },
+        "node_modules/@babel/preset-env/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/@babel/preset-modules": {
+            "version": "0.1.6-no-external-plugins",
+            "resolved": "https://registry.npmjs.org/@babel/preset-modules/-/preset-modules-0.1.6-no-external-plugins.tgz",
+            "integrity": "sha512-HrcgcIESLm9aIR842yhJ5RWan/gebQUJ6E/E5+rf0y9o6oj7w0Br+sWuL6kEQ/o/AdfvR1Je9jG18/gnpwjEyA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-plugin-utils": "^7.0.0",
+                "@babel/types": "^7.4.4",
+                "esutils": "^2.0.2"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0-0 || ^8.0.0-0 <8.0.0"
+            }
+        },
+        "node_modules/@babel/runtime": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.27.0.tgz",
+            "integrity": "sha512-VtPOkrdPHZsKc/clNqyi9WUA8TINkZ4cGk63UUE3u4pmB2k+ZMQRDuIOagv8UVd6j7k0T3+RRIb7beKTebNbcw==",
+            "dev": true,
+            "dependencies": {
+                "regenerator-runtime": "^0.14.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/template": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.27.0.tgz",
+            "integrity": "sha512-2ncevenBqXI6qRMukPlXwHKHchC7RyMuu4xv5JBXRfOGVcTy1mXCD12qrp7Jsoxll1EV3+9sE4GugBVRjT2jFA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/code-frame": "^7.26.2",
+                "@babel/parser": "^7.27.0",
+                "@babel/types": "^7.27.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/traverse": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.27.0.tgz",
+            "integrity": "sha512-19lYZFzYVQkkHkl4Cy4WrAVcqBkgvV2YM2TU3xG6DIwO7O3ecbDPfW3yM3bjAGcqcQHi+CCtjMR3dIEHxsd6bA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/code-frame": "^7.26.2",
+                "@babel/generator": "^7.27.0",
+                "@babel/parser": "^7.27.0",
+                "@babel/template": "^7.27.0",
+                "@babel/types": "^7.27.0",
+                "debug": "^4.3.1",
+                "globals": "^11.1.0"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@babel/types": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.27.0.tgz",
+            "integrity": "sha512-H45s8fVLYjbhFH62dIJ3WtmJ6RSPt/3DRO0ZcT2SUiYiQyz3BLVb9ADEnLl91m74aQPS3AzzeajZHYOalWe3bg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-string-parser": "^7.25.9",
+                "@babel/helper-validator-identifier": "^7.25.9"
+            },
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/@colors/colors": {
+            "version": "1.5.0",
+            "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
+            "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
+            "dev": true,
+            "optional": true,
+            "engines": {
+                "node": ">=0.1.90"
+            }
+        },
+        "node_modules/@discoveryjs/json-ext": {
+            "version": "0.5.7",
+            "resolved": "https://registry.npmjs.org/@discoveryjs/json-ext/-/json-ext-0.5.7.tgz",
+            "integrity": "sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.0.0"
+            }
+        },
+        "node_modules/@isaacs/cliui": {
+            "version": "8.0.2",
+            "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+            "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+            "dev": true,
+            "dependencies": {
+                "string-width": "^5.1.2",
+                "string-width-cjs": "npm:string-width@^4.2.0",
+                "strip-ansi": "^7.0.1",
+                "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+                "wrap-ansi": "^8.1.0",
+                "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+            },
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
+            "version": "6.1.0",
+            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+            "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+            "dev": true,
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+            }
+        },
+        "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
+            "version": "6.2.1",
+            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+            "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+            "dev": true,
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+            }
+        },
+        "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
+            "version": "9.2.2",
+            "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+            "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+            "dev": true
+        },
+        "node_modules/@isaacs/cliui/node_modules/string-width": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+            "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+            "dev": true,
+            "dependencies": {
+                "eastasianwidth": "^0.2.0",
+                "emoji-regex": "^9.2.2",
+                "strip-ansi": "^7.0.1"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
+            "version": "7.1.0",
+            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+            "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+            "dev": true,
+            "dependencies": {
+                "ansi-regex": "^6.0.1"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+            }
+        },
+        "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
+            "version": "8.1.0",
+            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+            "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+            "dev": true,
+            "dependencies": {
+                "ansi-styles": "^6.1.0",
+                "string-width": "^5.0.1",
+                "strip-ansi": "^7.0.1"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+            }
+        },
+        "node_modules/@jridgewell/gen-mapping": {
+            "version": "0.3.8",
+            "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.8.tgz",
+            "integrity": "sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/set-array": "^1.2.1",
+                "@jridgewell/sourcemap-codec": "^1.4.10",
+                "@jridgewell/trace-mapping": "^0.3.24"
+            },
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/@jridgewell/resolve-uri": {
+            "version": "3.1.2",
+            "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+            "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/@jridgewell/set-array": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/@jridgewell/set-array/-/set-array-1.2.1.tgz",
+            "integrity": "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/@jridgewell/source-map": {
+            "version": "0.3.6",
+            "resolved": "https://registry.npmjs.org/@jridgewell/source-map/-/source-map-0.3.6.tgz",
+            "integrity": "sha512-1ZJTZebgqllO79ue2bm3rIGud/bOe0pP5BjSRCRxxYkEZS8STV7zN84UBbiYu7jy+eCKSnVIUgoWWE/tt+shMQ==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/gen-mapping": "^0.3.5",
+                "@jridgewell/trace-mapping": "^0.3.25"
+            }
+        },
+        "node_modules/@jridgewell/sourcemap-codec": {
+            "version": "1.5.0",
+            "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz",
+            "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==",
+            "dev": true
+        },
+        "node_modules/@jridgewell/trace-mapping": {
+            "version": "0.3.25",
+            "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.25.tgz",
+            "integrity": "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/resolve-uri": "^3.1.0",
+                "@jridgewell/sourcemap-codec": "^1.4.14"
+            }
+        },
+        "node_modules/@leichtgewicht/ip-codec": {
+            "version": "2.0.5",
+            "resolved": "https://registry.npmjs.org/@leichtgewicht/ip-codec/-/ip-codec-2.0.5.tgz",
+            "integrity": "sha512-Vo+PSpZG2/fmgmiNzYK9qWRh8h/CHrwD0mo1h1DzL4yzHNSfWYujGTYsWGreD000gcgmZ7K4Ys6Tx9TxtsKdDw==",
+            "dev": true
+        },
+        "node_modules/@nodelib/fs.scandir": {
+            "version": "2.1.5",
+            "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+            "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+            "dev": true,
+            "dependencies": {
+                "@nodelib/fs.stat": "2.0.5",
+                "run-parallel": "^1.1.9"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/@nodelib/fs.stat": {
+            "version": "2.0.5",
+            "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+            "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+            "dev": true,
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/@nodelib/fs.walk": {
+            "version": "1.2.8",
+            "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+            "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+            "dev": true,
+            "dependencies": {
+                "@nodelib/fs.scandir": "2.1.5",
+                "fastq": "^1.6.0"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/@pkgjs/parseargs": {
+            "version": "0.11.0",
+            "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+            "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+            "dev": true,
+            "optional": true,
+            "engines": {
+                "node": ">=14"
+            }
+        },
+        "node_modules/@tailwindcss/typography": {
+            "version": "0.5.16",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/typography/-/typography-0.5.16.tgz",
+            "integrity": "sha512-0wDLwCVF5V3x3b1SGXPCDcdsbDHMBe+lkFzBRaHeLvNi+nrrnZ1lA18u+OTWO8iSWU2GxUOCvlXtDuqftc1oiA==",
+            "dev": true,
+            "dependencies": {
+                "lodash.castarray": "^4.4.0",
+                "lodash.isplainobject": "^4.0.6",
+                "lodash.merge": "^4.6.2",
+                "postcss-selector-parser": "6.0.10"
+            },
+            "peerDependencies": {
+                "tailwindcss": ">=3.0.0 || insiders || >=4.0.0-alpha.20 || >=4.0.0-beta.1"
+            }
+        },
+        "node_modules/@trysound/sax": {
+            "version": "0.2.0",
+            "resolved": "https://registry.npmjs.org/@trysound/sax/-/sax-0.2.0.tgz",
+            "integrity": "sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/@types/babel__core": {
+            "version": "7.20.5",
+            "resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
+            "integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
+            "dev": true,
+            "dependencies": {
+                "@babel/parser": "^7.20.7",
+                "@babel/types": "^7.20.7",
+                "@types/babel__generator": "*",
+                "@types/babel__template": "*",
+                "@types/babel__traverse": "*"
+            }
+        },
+        "node_modules/@types/babel__generator": {
+            "version": "7.27.0",
+            "resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
+            "integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/types": "^7.0.0"
+            }
+        },
+        "node_modules/@types/babel__template": {
+            "version": "7.4.4",
+            "resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
+            "integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
+            "dev": true,
+            "dependencies": {
+                "@babel/parser": "^7.1.0",
+                "@babel/types": "^7.0.0"
+            }
+        },
+        "node_modules/@types/babel__traverse": {
+            "version": "7.20.7",
+            "resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.20.7.tgz",
+            "integrity": "sha512-dkO5fhS7+/oos4ciWxyEyjWe48zmG6wbCheo/G2ZnHx4fs3EU6YC6UM8rk56gAjNJ9P3MTH2jo5jb92/K6wbng==",
+            "dev": true,
+            "dependencies": {
+                "@babel/types": "^7.20.7"
+            }
+        },
+        "node_modules/@types/body-parser": {
+            "version": "1.19.5",
+            "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.5.tgz",
+            "integrity": "sha512-fB3Zu92ucau0iQ0JMCFQE7b/dv8Ot07NI3KaZIkIUNXq82k4eBAqUaneXfleGY9JWskeS9y+u0nXMyspcuQrCg==",
+            "dev": true,
+            "dependencies": {
+                "@types/connect": "*",
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/bonjour": {
+            "version": "3.5.13",
+            "resolved": "https://registry.npmjs.org/@types/bonjour/-/bonjour-3.5.13.tgz",
+            "integrity": "sha512-z9fJ5Im06zvUL548KvYNecEVlA7cVDkGUi6kZusb04mpyEFKCIZJvloCcmpmLaIahDpOQGHaHmG6imtPMmPXGQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/clean-css": {
+            "version": "4.2.11",
+            "resolved": "https://registry.npmjs.org/@types/clean-css/-/clean-css-4.2.11.tgz",
+            "integrity": "sha512-Y8n81lQVTAfP2TOdtJJEsCoYl1AnOkqDqMvXb9/7pfgZZ7r8YrEyurrAvAoAjHOGXKRybay+5CsExqIH6liccw==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*",
+                "source-map": "^0.6.0"
+            }
+        },
+        "node_modules/@types/connect": {
+            "version": "3.4.38",
+            "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
+            "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/connect-history-api-fallback": {
+            "version": "1.5.4",
+            "resolved": "https://registry.npmjs.org/@types/connect-history-api-fallback/-/connect-history-api-fallback-1.5.4.tgz",
+            "integrity": "sha512-n6Cr2xS1h4uAulPRdlw6Jl6s1oG8KrVilPN2yUITEs+K48EzMJJ3W1xy8K5eWuFvjp3R74AOIGSmp2UfBJ8HFw==",
+            "dev": true,
+            "dependencies": {
+                "@types/express-serve-static-core": "*",
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/eslint": {
+            "version": "9.6.1",
+            "resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-9.6.1.tgz",
+            "integrity": "sha512-FXx2pKgId/WyYo2jXw63kk7/+TY7u7AziEJxJAnSFzHlqTAS3Ync6SvgYAN/k4/PQpnnVuzoMuVnByKK2qp0ag==",
+            "dev": true,
+            "dependencies": {
+                "@types/estree": "*",
+                "@types/json-schema": "*"
+            }
+        },
+        "node_modules/@types/eslint-scope": {
+            "version": "3.7.7",
+            "resolved": "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz",
+            "integrity": "sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==",
+            "dev": true,
+            "dependencies": {
+                "@types/eslint": "*",
+                "@types/estree": "*"
+            }
+        },
+        "node_modules/@types/estree": {
+            "version": "1.0.7",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz",
+            "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==",
+            "dev": true
+        },
+        "node_modules/@types/express": {
+            "version": "4.17.21",
+            "resolved": "https://registry.npmjs.org/@types/express/-/express-4.17.21.tgz",
+            "integrity": "sha512-ejlPM315qwLpaQlQDTjPdsUFSc6ZsP4AN6AlWnogPjQ7CVi7PYF3YVz+CY3jE2pwYf7E/7HlDAN0rV2GxTG0HQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/body-parser": "*",
+                "@types/express-serve-static-core": "^4.17.33",
+                "@types/qs": "*",
+                "@types/serve-static": "*"
+            }
+        },
+        "node_modules/@types/express-serve-static-core": {
+            "version": "5.0.6",
+            "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.0.6.tgz",
+            "integrity": "sha512-3xhRnjJPkULekpSzgtoNYYcTWgEZkp4myc+Saevii5JPnHNvHMRlBSHDbs7Bh1iPPoVTERHEZXyhyLbMEsExsA==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*",
+                "@types/qs": "*",
+                "@types/range-parser": "*",
+                "@types/send": "*"
+            }
+        },
+        "node_modules/@types/express/node_modules/@types/express-serve-static-core": {
+            "version": "4.19.6",
+            "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-4.19.6.tgz",
+            "integrity": "sha512-N4LZ2xG7DatVqhCZzOGb1Yi5lMbXSZcmdLDe9EzSndPV2HpWYWzRbaerl2n27irrm94EPpprqa8KpskPT085+A==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*",
+                "@types/qs": "*",
+                "@types/range-parser": "*",
+                "@types/send": "*"
+            }
+        },
+        "node_modules/@types/glob": {
+            "version": "7.2.0",
+            "resolved": "https://registry.npmjs.org/@types/glob/-/glob-7.2.0.tgz",
+            "integrity": "sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==",
+            "dev": true,
+            "dependencies": {
+                "@types/minimatch": "*",
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/http-errors": {
+            "version": "2.0.4",
+            "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.4.tgz",
+            "integrity": "sha512-D0CFMMtydbJAegzOyHjtiKPLlvnm3iTZyZRSZoLq2mRhDdmLfIWOCYPfQJ4cu2erKghU++QvjcUjp/5h7hESpA==",
+            "dev": true
+        },
+        "node_modules/@types/http-proxy": {
+            "version": "1.17.16",
+            "resolved": "https://registry.npmjs.org/@types/http-proxy/-/http-proxy-1.17.16.tgz",
+            "integrity": "sha512-sdWoUajOB1cd0A8cRRQ1cfyWNbmFKLAqBB89Y8x5iYyG/mkJHc0YUH8pdWBy2omi9qtCpiIgGjuwO0dQST2l5w==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/imagemin": {
+            "version": "9.0.1",
+            "resolved": "https://registry.npmjs.org/@types/imagemin/-/imagemin-9.0.1.tgz",
+            "integrity": "sha512-xMWpvrUhtYxl6EeW+UhVH3rwUKhCRx21XddcoWByjDAasXZT5pQaCn0YVnXoTijX5hlTrGqV4TGQL/Htpp00+w==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/imagemin-gifsicle": {
+            "version": "7.0.4",
+            "resolved": "https://registry.npmjs.org/@types/imagemin-gifsicle/-/imagemin-gifsicle-7.0.4.tgz",
+            "integrity": "sha512-ZghMBd/Jgqg5utTJNPmvf6DkuHzMhscJ8vgf/7MUGCpO+G+cLrhYltL+5d+h3A1B4W73S2SrmJZ1jS5LACpX+A==",
+            "dev": true,
+            "dependencies": {
+                "@types/imagemin": "*"
+            }
+        },
+        "node_modules/@types/imagemin-mozjpeg": {
+            "version": "8.0.4",
+            "resolved": "https://registry.npmjs.org/@types/imagemin-mozjpeg/-/imagemin-mozjpeg-8.0.4.tgz",
+            "integrity": "sha512-ZCAxV8SYJB8ehwHpnbRpHjg5Wc4HcyuAMiDhXbkgC7gujDoOTyHO3dhDkUtZ1oK1DLBRZapqG9etdLVhUml7yQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/imagemin": "*"
+            }
+        },
+        "node_modules/@types/imagemin-optipng": {
+            "version": "5.2.4",
+            "resolved": "https://registry.npmjs.org/@types/imagemin-optipng/-/imagemin-optipng-5.2.4.tgz",
+            "integrity": "sha512-mvKnDMC8eCYZetAQudjs1DbgpR84WhsTx1wgvdiXnpuUEti3oJ+MaMYBRWPY0JlQ4+y4TXKOfa7+LOuT8daegQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/imagemin": "*"
+            }
+        },
+        "node_modules/@types/imagemin-svgo": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/@types/imagemin-svgo/-/imagemin-svgo-8.0.1.tgz",
+            "integrity": "sha512-YafkdrVAcr38U0Ln1C+L1n4SIZqC47VBHTyxCq7gTUSd1R9MdIvMcrljWlgU1M9O68WZDeQWUrKipKYfEOCOvQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/imagemin": "*",
+                "@types/svgo": "^1"
+            }
+        },
+        "node_modules/@types/json-schema": {
+            "version": "7.0.15",
+            "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+            "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+            "dev": true
+        },
+        "node_modules/@types/mime": {
+            "version": "1.3.5",
+            "resolved": "https://registry.npmjs.org/@types/mime/-/mime-1.3.5.tgz",
+            "integrity": "sha512-/pyBZWSLD2n0dcHE3hq8s8ZvcETHtEuF+3E7XVt0Ig2nvsVQXdghHVcEkIWjy9A0wKfTn97a/PSDYohKIlnP/w==",
+            "dev": true
+        },
+        "node_modules/@types/minimatch": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-5.1.2.tgz",
+            "integrity": "sha512-K0VQKziLUWkVKiRVrx4a40iPaxTUefQmjtkQofBkYRcoaaL/8rhwDWww9qWbrgicNOgnpIsMxyNIUM4+n6dUIA==",
+            "dev": true
+        },
+        "node_modules/@types/node": {
+            "version": "22.14.1",
+            "resolved": "https://registry.npmjs.org/@types/node/-/node-22.14.1.tgz",
+            "integrity": "sha512-u0HuPQwe/dHrItgHHpmw3N2fYCR6x4ivMNbPHRkBVP4CvN+kiRrKHWk3i8tXiO/joPwXLMYvF9TTF0eqgHIuOw==",
+            "dev": true,
+            "dependencies": {
+                "undici-types": "~6.21.0"
+            }
+        },
+        "node_modules/@types/node-forge": {
+            "version": "1.3.11",
+            "resolved": "https://registry.npmjs.org/@types/node-forge/-/node-forge-1.3.11.tgz",
+            "integrity": "sha512-FQx220y22OKNTqaByeBGqHWYz4cl94tpcxeFdvBo3wjG6XPBuZ0BNgNZRV5J5TFmmcsJ4IzsLkmGRiQbnYsBEQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/parse-json": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/@types/parse-json/-/parse-json-4.0.2.tgz",
+            "integrity": "sha512-dISoDXWWQwUquiKsyZ4Ng+HX2KsPL7LyHKHQwgGFEA3IaKac4Obd+h2a/a6waisAoepJlBcx9paWqjA8/HVjCw==",
+            "dev": true
+        },
+        "node_modules/@types/qs": {
+            "version": "6.9.18",
+            "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.18.tgz",
+            "integrity": "sha512-kK7dgTYDyGqS+e2Q4aK9X3D7q234CIZ1Bv0q/7Z5IwRDoADNU81xXJK/YVyLbLTZCoIwUoDoffFeF+p/eIklAA==",
+            "dev": true
+        },
+        "node_modules/@types/range-parser": {
+            "version": "1.2.7",
+            "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
+            "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
+            "dev": true
+        },
+        "node_modules/@types/retry": {
+            "version": "0.12.0",
+            "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",
+            "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",
+            "dev": true
+        },
+        "node_modules/@types/send": {
+            "version": "0.17.4",
+            "resolved": "https://registry.npmjs.org/@types/send/-/send-0.17.4.tgz",
+            "integrity": "sha512-x2EM6TJOybec7c52BX0ZspPodMsQUd5L6PRwOunVyVUhXiBSKf3AezDL8Dgvgt5o0UfKNfuA0eMLr2wLT4AiBA==",
+            "dev": true,
+            "dependencies": {
+                "@types/mime": "^1",
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/serve-index": {
+            "version": "1.9.4",
+            "resolved": "https://registry.npmjs.org/@types/serve-index/-/serve-index-1.9.4.tgz",
+            "integrity": "sha512-qLpGZ/c2fhSs5gnYsQxtDEq3Oy8SXPClIXkW5ghvAvsNuVSA8k+gCONcUCS/UjLEYvYps+e8uBtfgXgvhwfNug==",
+            "dev": true,
+            "dependencies": {
+                "@types/express": "*"
+            }
+        },
+        "node_modules/@types/serve-static": {
+            "version": "1.15.7",
+            "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-1.15.7.tgz",
+            "integrity": "sha512-W8Ym+h8nhuRwaKPaDw34QUkwsGi6Rc4yYqvKFo5rm2FUEhCFbzVWrxXUxuKK8TASjWsysJY0nsmNCGhCOIsrOw==",
+            "dev": true,
+            "dependencies": {
+                "@types/http-errors": "*",
+                "@types/node": "*",
+                "@types/send": "*"
+            }
+        },
+        "node_modules/@types/sockjs": {
+            "version": "0.3.36",
+            "resolved": "https://registry.npmjs.org/@types/sockjs/-/sockjs-0.3.36.tgz",
+            "integrity": "sha512-MK9V6NzAS1+Ud7JV9lJLFqW85VbC9dq3LmwZCuBe4wBDgKC0Kj/jd8Xl+nSviU+Qc3+m7umHHyHg//2KSa0a0Q==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@types/svgo": {
+            "version": "1.3.6",
+            "resolved": "https://registry.npmjs.org/@types/svgo/-/svgo-1.3.6.tgz",
+            "integrity": "sha512-AZU7vQcy/4WFEuwnwsNsJnFwupIpbllH1++LXScN6uxT1Z4zPzdrWG97w4/I7eFKFTvfy/bHFStWjdBAg2Vjug==",
+            "dev": true
+        },
+        "node_modules/@types/ws": {
+            "version": "8.18.1",
+            "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
+            "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*"
+            }
+        },
+        "node_modules/@webassemblyjs/ast": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.14.1.tgz",
+            "integrity": "sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/helper-numbers": "1.13.2",
+                "@webassemblyjs/helper-wasm-bytecode": "1.13.2"
+            }
+        },
+        "node_modules/@webassemblyjs/floating-point-hex-parser": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.13.2.tgz",
+            "integrity": "sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA==",
+            "dev": true
+        },
+        "node_modules/@webassemblyjs/helper-api-error": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.13.2.tgz",
+            "integrity": "sha512-U56GMYxy4ZQCbDZd6JuvvNV/WFildOjsaWD3Tzzvmw/mas3cXzRJPMjP83JqEsgSbyrmaGjBfDtV7KDXV9UzFQ==",
+            "dev": true
+        },
+        "node_modules/@webassemblyjs/helper-buffer": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.14.1.tgz",
+            "integrity": "sha512-jyH7wtcHiKssDtFPRB+iQdxlDf96m0E39yb0k5uJVhFGleZFoNw1c4aeIcVUPPbXUVJ94wwnMOAqUHyzoEPVMA==",
+            "dev": true
+        },
+        "node_modules/@webassemblyjs/helper-numbers": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.13.2.tgz",
+            "integrity": "sha512-FE8aCmS5Q6eQYcV3gI35O4J789wlQA+7JrqTTpJqn5emA4U2hvwJmvFRC0HODS+3Ye6WioDklgd6scJ3+PLnEA==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/floating-point-hex-parser": "1.13.2",
+                "@webassemblyjs/helper-api-error": "1.13.2",
+                "@xtuc/long": "4.2.2"
+            }
+        },
+        "node_modules/@webassemblyjs/helper-wasm-bytecode": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.13.2.tgz",
+            "integrity": "sha512-3QbLKy93F0EAIXLh0ogEVR6rOubA9AoZ+WRYhNbFyuB70j3dRdwH9g+qXhLAO0kiYGlg3TxDV+I4rQTr/YNXkA==",
+            "dev": true
+        },
+        "node_modules/@webassemblyjs/helper-wasm-section": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.14.1.tgz",
+            "integrity": "sha512-ds5mXEqTJ6oxRoqjhWDU83OgzAYjwsCV8Lo/N+oRsNDmx/ZDpqalmrtgOMkHwxsG0iI//3BwWAErYRHtgn0dZw==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@webassemblyjs/helper-buffer": "1.14.1",
+                "@webassemblyjs/helper-wasm-bytecode": "1.13.2",
+                "@webassemblyjs/wasm-gen": "1.14.1"
+            }
+        },
+        "node_modules/@webassemblyjs/ieee754": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.13.2.tgz",
+            "integrity": "sha512-4LtOzh58S/5lX4ITKxnAK2USuNEvpdVV9AlgGQb8rJDHaLeHciwG4zlGr0j/SNWlr7x3vO1lDEsuePvtcDNCkw==",
+            "dev": true,
+            "dependencies": {
+                "@xtuc/ieee754": "^1.2.0"
+            }
+        },
+        "node_modules/@webassemblyjs/leb128": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.13.2.tgz",
+            "integrity": "sha512-Lde1oNoIdzVzdkNEAWZ1dZ5orIbff80YPdHx20mrHwHrVNNTjNr8E3xz9BdpcGqRQbAEa+fkrCb+fRFTl/6sQw==",
+            "dev": true,
+            "dependencies": {
+                "@xtuc/long": "4.2.2"
+            }
+        },
+        "node_modules/@webassemblyjs/utf8": {
+            "version": "1.13.2",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.13.2.tgz",
+            "integrity": "sha512-3NQWGjKTASY1xV5m7Hr0iPeXD9+RDobLll3T9d2AO+g3my8xy5peVyjSag4I50mR1bBSN/Ct12lo+R9tJk0NZQ==",
+            "dev": true
+        },
+        "node_modules/@webassemblyjs/wasm-edit": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.14.1.tgz",
+            "integrity": "sha512-RNJUIQH/J8iA/1NzlE4N7KtyZNHi3w7at7hDjvRNm5rcUXa00z1vRz3glZoULfJ5mpvYhLybmVcwcjGrC1pRrQ==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@webassemblyjs/helper-buffer": "1.14.1",
+                "@webassemblyjs/helper-wasm-bytecode": "1.13.2",
+                "@webassemblyjs/helper-wasm-section": "1.14.1",
+                "@webassemblyjs/wasm-gen": "1.14.1",
+                "@webassemblyjs/wasm-opt": "1.14.1",
+                "@webassemblyjs/wasm-parser": "1.14.1",
+                "@webassemblyjs/wast-printer": "1.14.1"
+            }
+        },
+        "node_modules/@webassemblyjs/wasm-gen": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.14.1.tgz",
+            "integrity": "sha512-AmomSIjP8ZbfGQhumkNvgC33AY7qtMCXnN6bL2u2Js4gVCg8fp735aEiMSBbDR7UQIj90n4wKAFUSEd0QN2Ukg==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@webassemblyjs/helper-wasm-bytecode": "1.13.2",
+                "@webassemblyjs/ieee754": "1.13.2",
+                "@webassemblyjs/leb128": "1.13.2",
+                "@webassemblyjs/utf8": "1.13.2"
+            }
+        },
+        "node_modules/@webassemblyjs/wasm-opt": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.14.1.tgz",
+            "integrity": "sha512-PTcKLUNvBqnY2U6E5bdOQcSM+oVP/PmrDY9NzowJjislEjwP/C4an2303MCVS2Mg9d3AJpIGdUFIQQWbPds0Sw==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@webassemblyjs/helper-buffer": "1.14.1",
+                "@webassemblyjs/wasm-gen": "1.14.1",
+                "@webassemblyjs/wasm-parser": "1.14.1"
+            }
+        },
+        "node_modules/@webassemblyjs/wasm-parser": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.14.1.tgz",
+            "integrity": "sha512-JLBl+KZ0R5qB7mCnud/yyX08jWFw5MsoalJ1pQ4EdFlgj9VdXKGuENGsiCIjegI1W7p91rUlcB/LB5yRJKNTcQ==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@webassemblyjs/helper-api-error": "1.13.2",
+                "@webassemblyjs/helper-wasm-bytecode": "1.13.2",
+                "@webassemblyjs/ieee754": "1.13.2",
+                "@webassemblyjs/leb128": "1.13.2",
+                "@webassemblyjs/utf8": "1.13.2"
+            }
+        },
+        "node_modules/@webassemblyjs/wast-printer": {
+            "version": "1.14.1",
+            "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.14.1.tgz",
+            "integrity": "sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==",
+            "dev": true,
+            "dependencies": {
+                "@webassemblyjs/ast": "1.14.1",
+                "@xtuc/long": "4.2.2"
+            }
+        },
+        "node_modules/@webpack-cli/configtest": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/@webpack-cli/configtest/-/configtest-1.2.0.tgz",
+            "integrity": "sha512-4FB8Tj6xyVkyqjj1OaTqCjXYULB9FMkqQ8yGrZjRDrYh0nOE+7Lhs45WioWQQMV+ceFlE368Ukhe6xdvJM9Egg==",
+            "dev": true,
+            "peerDependencies": {
+                "webpack": "4.x.x || 5.x.x",
+                "webpack-cli": "4.x.x"
+            }
+        },
+        "node_modules/@webpack-cli/info": {
+            "version": "1.5.0",
+            "resolved": "https://registry.npmjs.org/@webpack-cli/info/-/info-1.5.0.tgz",
+            "integrity": "sha512-e8tSXZpw2hPl2uMJY6fsMswaok5FdlGNRTktvFk2sD8RjH0hE2+XistawJx1vmKteh4NmGmNUrp+Tb2w+udPcQ==",
+            "dev": true,
+            "dependencies": {
+                "envinfo": "^7.7.3"
+            },
+            "peerDependencies": {
+                "webpack-cli": "4.x.x"
+            }
+        },
+        "node_modules/@webpack-cli/serve": {
+            "version": "1.7.0",
+            "resolved": "https://registry.npmjs.org/@webpack-cli/serve/-/serve-1.7.0.tgz",
+            "integrity": "sha512-oxnCNGj88fL+xzV+dacXs44HcDwf1ovs3AuEzvP7mqXw7fQntqIhQ1BRmynh4qEKQSSSRSWVyXRjmTbZIX9V2Q==",
+            "dev": true,
+            "peerDependencies": {
+                "webpack-cli": "4.x.x"
+            },
+            "peerDependenciesMeta": {
+                "webpack-dev-server": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@xtuc/ieee754": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz",
+            "integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==",
+            "dev": true
+        },
+        "node_modules/@xtuc/long": {
+            "version": "4.2.2",
+            "resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz",
+            "integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==",
+            "dev": true
+        },
+        "node_modules/accepts": {
+            "version": "1.3.8",
+            "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+            "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+            "dev": true,
+            "dependencies": {
+                "mime-types": "~2.1.34",
+                "negotiator": "0.6.3"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/accepts/node_modules/negotiator": {
+            "version": "0.6.3",
+            "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+            "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/acorn": {
+            "version": "8.14.1",
+            "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.1.tgz",
+            "integrity": "sha512-OvQ/2pUDKmgfCg++xsTX1wGxfTaszcHVcTctW4UJB4hibJx2HXxxO5UmVgyjMa+ZDsiaf5wWLXYpRWMmBI0QHg==",
+            "dev": true,
+            "bin": {
+                "acorn": "bin/acorn"
+            },
+            "engines": {
+                "node": ">=0.4.0"
+            }
+        },
+        "node_modules/ajv": {
+            "version": "6.12.6",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
+            "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.1",
+                "fast-json-stable-stringify": "^2.0.0",
+                "json-schema-traverse": "^0.4.1",
+                "uri-js": "^4.2.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/ajv-formats": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz",
+            "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==",
+            "dev": true,
+            "dependencies": {
+                "ajv": "^8.0.0"
+            },
+            "peerDependencies": {
+                "ajv": "^8.0.0"
+            },
+            "peerDependenciesMeta": {
+                "ajv": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/ajv-formats/node_modules/ajv": {
+            "version": "8.17.1",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+            "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "fast-uri": "^3.0.1",
+                "json-schema-traverse": "^1.0.0",
+                "require-from-string": "^2.0.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/ajv-formats/node_modules/json-schema-traverse": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+            "dev": true
+        },
+        "node_modules/ajv-keywords": {
+            "version": "3.5.2",
+            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.5.2.tgz",
+            "integrity": "sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ==",
+            "dev": true,
+            "peerDependencies": {
+                "ajv": "^6.9.1"
+            }
+        },
+        "node_modules/ansi-html-community": {
+            "version": "0.0.8",
+            "resolved": "https://registry.npmjs.org/ansi-html-community/-/ansi-html-community-0.0.8.tgz",
+            "integrity": "sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw==",
+            "dev": true,
+            "engines": [
+                "node >= 0.8.0"
+            ],
+            "bin": {
+                "ansi-html": "bin/ansi-html"
+            }
+        },
+        "node_modules/ansi-regex": {
+            "version": "5.0.1",
+            "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+            "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/ansi-styles": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+            "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+            "dev": true,
+            "dependencies": {
+                "color-convert": "^2.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+            }
+        },
+        "node_modules/any-promise": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
+            "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==",
+            "dev": true
+        },
+        "node_modules/anymatch": {
+            "version": "3.1.3",
+            "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+            "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+            "dev": true,
+            "dependencies": {
+                "normalize-path": "^3.0.0",
+                "picomatch": "^2.0.4"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/arg": {
+            "version": "5.0.2",
+            "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
+            "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
+            "dev": true
+        },
+        "node_modules/array-flatten": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
+            "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
+            "dev": true
+        },
+        "node_modules/array-union": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
+            "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/asn1.js": {
+            "version": "4.10.1",
+            "resolved": "https://registry.npmjs.org/asn1.js/-/asn1.js-4.10.1.tgz",
+            "integrity": "sha512-p32cOF5q0Zqs9uBiONKYLm6BClCoBCM5O9JfeUSlnQLBTxYdTK+pW+nXflm8UkKd2UYlEbYz5qEi0JuZR9ckSw==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.0.0",
+                "inherits": "^2.0.1",
+                "minimalistic-assert": "^1.0.0"
+            }
+        },
+        "node_modules/asn1.js/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/assert": {
+            "version": "1.5.1",
+            "resolved": "https://registry.npmjs.org/assert/-/assert-1.5.1.tgz",
+            "integrity": "sha512-zzw1uCAgLbsKwBfFc8CX78DDg+xZeBksSO3vwVIDDN5i94eOrPsSSyiVhmsSABFDM/OcpE2aagCat9dnWQLG1A==",
+            "dev": true,
+            "dependencies": {
+                "object.assign": "^4.1.4",
+                "util": "^0.10.4"
+            }
+        },
+        "node_modules/assert/node_modules/inherits": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
+            "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
+            "dev": true
+        },
+        "node_modules/assert/node_modules/util": {
+            "version": "0.10.4",
+            "resolved": "https://registry.npmjs.org/util/-/util-0.10.4.tgz",
+            "integrity": "sha512-0Pm9hTQ3se5ll1XihRic3FDIku70C+iHUdT/W926rSgHV5QgXsYbKZN8MSC3tJtSkhuROzvsQjAaFENRXr+19A==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "2.0.3"
+            }
+        },
+        "node_modules/autoprefixer": {
+            "version": "10.4.21",
+            "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.21.tgz",
+            "integrity": "sha512-O+A6LWV5LDHSJD3LjHYoNi4VLsj/Whi7k6zG12xTYaU4cQ8oxQGckXNX8cRHK5yOZ/ppVHe0ZBXGzSV9jXdVbQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/autoprefixer"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "browserslist": "^4.24.4",
+                "caniuse-lite": "^1.0.30001702",
+                "fraction.js": "^4.3.7",
+                "normalize-range": "^0.1.2",
+                "picocolors": "^1.1.1",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "bin": {
+                "autoprefixer": "bin/autoprefixer"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/babel-loader": {
+            "version": "8.4.1",
+            "resolved": "https://registry.npmjs.org/babel-loader/-/babel-loader-8.4.1.tgz",
+            "integrity": "sha512-nXzRChX+Z1GoE6yWavBQg6jDslyFF3SDjl2paADuoQtQW10JqShJt62R6eJQ5m/pjJFDT8xgKIWSP85OY8eXeA==",
+            "dev": true,
+            "dependencies": {
+                "find-cache-dir": "^3.3.1",
+                "loader-utils": "^2.0.4",
+                "make-dir": "^3.1.0",
+                "schema-utils": "^2.6.5"
+            },
+            "engines": {
+                "node": ">= 8.9"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.0.0",
+                "webpack": ">=2"
+            }
+        },
+        "node_modules/babel-plugin-polyfill-corejs2": {
+            "version": "0.4.13",
+            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.13.tgz",
+            "integrity": "sha512-3sX/eOms8kd3q2KZ6DAhKPc0dgm525Gqq5NtWKZ7QYYZEv57OQ54KtblzJzH1lQF/eQxO8KjWGIK9IPUJNus5g==",
+            "dev": true,
+            "dependencies": {
+                "@babel/compat-data": "^7.22.6",
+                "@babel/helper-define-polyfill-provider": "^0.6.4",
+                "semver": "^6.3.1"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+            }
+        },
+        "node_modules/babel-plugin-polyfill-corejs2/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/babel-plugin-polyfill-corejs3": {
+            "version": "0.11.1",
+            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.11.1.tgz",
+            "integrity": "sha512-yGCqvBT4rwMczo28xkH/noxJ6MZ4nJfkVYdoDaC/utLtWrXxv27HVrzAeSbqR8SxDsp46n0YF47EbHoixy6rXQ==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-define-polyfill-provider": "^0.6.3",
+                "core-js-compat": "^3.40.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+            }
+        },
+        "node_modules/babel-plugin-polyfill-regenerator": {
+            "version": "0.6.4",
+            "resolved": "https://registry.npmjs.org/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.6.4.tgz",
+            "integrity": "sha512-7gD3pRadPrbjhjLyxebmx/WrFYcuSjZ0XbdUujQMZ/fcE9oeewk2U/7PCvez84UeuK3oSjmPZ0Ch0dlupQvGzw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/helper-define-polyfill-provider": "^0.6.4"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.4.0 || ^8.0.0-0 <8.0.0"
+            }
+        },
+        "node_modules/balanced-match": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+            "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+            "dev": true
+        },
+        "node_modules/base64-js": {
+            "version": "1.5.1",
+            "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+            "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ]
+        },
+        "node_modules/batch": {
+            "version": "0.6.1",
+            "resolved": "https://registry.npmjs.org/batch/-/batch-0.6.1.tgz",
+            "integrity": "sha512-x+VAiMRL6UPkx+kudNvxTl6hB2XNNCG2r+7wixVfIYwu/2HKRXimwQyaumLjMveWvT2Hkd/cAJw+QBMfJ/EKVw==",
+            "dev": true
+        },
+        "node_modules/big.js": {
+            "version": "5.2.2",
+            "resolved": "https://registry.npmjs.org/big.js/-/big.js-5.2.2.tgz",
+            "integrity": "sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ==",
+            "dev": true,
+            "engines": {
+                "node": "*"
+            }
+        },
+        "node_modules/binary-extensions": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
+            "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/bn.js": {
+            "version": "5.2.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.1.tgz",
+            "integrity": "sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==",
+            "dev": true
+        },
+        "node_modules/body-parser": {
+            "version": "1.20.3",
+            "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz",
+            "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==",
+            "dev": true,
+            "dependencies": {
+                "bytes": "3.1.2",
+                "content-type": "~1.0.5",
+                "debug": "2.6.9",
+                "depd": "2.0.0",
+                "destroy": "1.2.0",
+                "http-errors": "2.0.0",
+                "iconv-lite": "0.4.24",
+                "on-finished": "2.4.1",
+                "qs": "6.13.0",
+                "raw-body": "2.5.2",
+                "type-is": "~1.6.18",
+                "unpipe": "1.0.0"
+            },
+            "engines": {
+                "node": ">= 0.8",
+                "npm": "1.2.8000 || >= 1.4.16"
+            }
+        },
+        "node_modules/body-parser/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/body-parser/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/body-parser/node_modules/qs": {
+            "version": "6.13.0",
+            "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz",
+            "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==",
+            "dev": true,
+            "dependencies": {
+                "side-channel": "^1.0.6"
+            },
+            "engines": {
+                "node": ">=0.6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/bonjour-service": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/bonjour-service/-/bonjour-service-1.3.0.tgz",
+            "integrity": "sha512-3YuAUiSkWykd+2Azjgyxei8OWf8thdn8AITIog2M4UICzoqfjlqr64WIjEXZllf/W6vK1goqleSR6brGomxQqA==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "multicast-dns": "^7.2.5"
+            }
+        },
+        "node_modules/boolbase": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+            "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
+            "dev": true
+        },
+        "node_modules/brace-expansion": {
+            "version": "1.1.11",
+            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+            "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+            "dev": true,
+            "dependencies": {
+                "balanced-match": "^1.0.0",
+                "concat-map": "0.0.1"
+            }
+        },
+        "node_modules/braces": {
+            "version": "3.0.3",
+            "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+            "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+            "dev": true,
+            "dependencies": {
+                "fill-range": "^7.1.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/brorand": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
+            "integrity": "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==",
+            "dev": true
+        },
+        "node_modules/browserify-aes": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
+            "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
+            "dev": true,
+            "dependencies": {
+                "buffer-xor": "^1.0.3",
+                "cipher-base": "^1.0.0",
+                "create-hash": "^1.1.0",
+                "evp_bytestokey": "^1.0.3",
+                "inherits": "^2.0.1",
+                "safe-buffer": "^5.0.1"
+            }
+        },
+        "node_modules/browserify-cipher": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/browserify-cipher/-/browserify-cipher-1.0.1.tgz",
+            "integrity": "sha512-sPhkz0ARKbf4rRQt2hTpAHqn47X3llLkUGn+xEJzLjwY8LRs2p0v7ljvI5EyoRO/mexrNunNECisZs+gw2zz1w==",
+            "dev": true,
+            "dependencies": {
+                "browserify-aes": "^1.0.4",
+                "browserify-des": "^1.0.0",
+                "evp_bytestokey": "^1.0.0"
+            }
+        },
+        "node_modules/browserify-des": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.2.tgz",
+            "integrity": "sha512-BioO1xf3hFwz4kc6iBhI3ieDFompMhrMlnDFC4/0/vd5MokpuAc3R+LYbwTA9A5Yc9pq9UYPqffKpW2ObuwX5A==",
+            "dev": true,
+            "dependencies": {
+                "cipher-base": "^1.0.1",
+                "des.js": "^1.0.0",
+                "inherits": "^2.0.1",
+                "safe-buffer": "^5.1.2"
+            }
+        },
+        "node_modules/browserify-rsa": {
+            "version": "4.1.1",
+            "resolved": "https://registry.npmjs.org/browserify-rsa/-/browserify-rsa-4.1.1.tgz",
+            "integrity": "sha512-YBjSAiTqM04ZVei6sXighu679a3SqWORA3qZTEqZImnlkDIFtKc6pNutpjyZ8RJTjQtuYfeetkxM11GwoYXMIQ==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^5.2.1",
+                "randombytes": "^2.1.0",
+                "safe-buffer": "^5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/browserify-sign": {
+            "version": "4.2.3",
+            "resolved": "https://registry.npmjs.org/browserify-sign/-/browserify-sign-4.2.3.tgz",
+            "integrity": "sha512-JWCZW6SKhfhjJxO8Tyiiy+XYB7cqd2S5/+WeYHsKdNKFlCBhKbblba1A/HN/90YwtxKc8tCErjffZl++UNmGiw==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^5.2.1",
+                "browserify-rsa": "^4.1.0",
+                "create-hash": "^1.2.0",
+                "create-hmac": "^1.1.7",
+                "elliptic": "^6.5.5",
+                "hash-base": "~3.0",
+                "inherits": "^2.0.4",
+                "parse-asn1": "^5.1.7",
+                "readable-stream": "^2.3.8",
+                "safe-buffer": "^5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.12"
+            }
+        },
+        "node_modules/browserify-zlib": {
+            "version": "0.2.0",
+            "resolved": "https://registry.npmjs.org/browserify-zlib/-/browserify-zlib-0.2.0.tgz",
+            "integrity": "sha512-Z942RysHXmJrhqk88FmKBVq/v5tqmSkDz7p54G/MGyjMnCFFnC79XWNbg+Vta8W6Wb2qtSZTSxIGkJrRpCFEiA==",
+            "dev": true,
+            "dependencies": {
+                "pako": "~1.0.5"
+            }
+        },
+        "node_modules/browserslist": {
+            "version": "4.24.4",
+            "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.24.4.tgz",
+            "integrity": "sha512-KDi1Ny1gSePi1vm0q4oxSF8b4DR44GF4BbmS2YdhPLOEqd8pDviZOGH/GsmRwoWJ2+5Lr085X7naowMwKHDG1A==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/browserslist"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/browserslist"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "caniuse-lite": "^1.0.30001688",
+                "electron-to-chromium": "^1.5.73",
+                "node-releases": "^2.0.19",
+                "update-browserslist-db": "^1.1.1"
+            },
+            "bin": {
+                "browserslist": "cli.js"
+            },
+            "engines": {
+                "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
+            }
+        },
+        "node_modules/buffer": {
+            "version": "4.9.2",
+            "resolved": "https://registry.npmjs.org/buffer/-/buffer-4.9.2.tgz",
+            "integrity": "sha512-xq+q3SRMOxGivLhBNaUdC64hDTQwejJ+H0T/NB1XMtTVEwNTrfFF3gAxiyW0Bu/xWEGhjVKgUcMhCrUy2+uCWg==",
+            "dev": true,
+            "dependencies": {
+                "base64-js": "^1.0.2",
+                "ieee754": "^1.1.4",
+                "isarray": "^1.0.0"
+            }
+        },
+        "node_modules/buffer-from": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+            "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+            "dev": true
+        },
+        "node_modules/buffer-xor": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
+            "integrity": "sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==",
+            "dev": true
+        },
+        "node_modules/builtin-status-codes": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/builtin-status-codes/-/builtin-status-codes-3.0.0.tgz",
+            "integrity": "sha512-HpGFw18DgFWlncDfjTa2rcQ4W88O1mC8e8yZ2AvQY5KDaktSTwo+KRf6nHK6FRI5FyRyb/5T6+TSxfP7QyGsmQ==",
+            "dev": true
+        },
+        "node_modules/bytes": {
+            "version": "3.1.2",
+            "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+            "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/call-bind": {
+            "version": "1.0.8",
+            "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz",
+            "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==",
+            "dev": true,
+            "dependencies": {
+                "call-bind-apply-helpers": "^1.0.0",
+                "es-define-property": "^1.0.0",
+                "get-intrinsic": "^1.2.4",
+                "set-function-length": "^1.2.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/call-bind-apply-helpers": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+            "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+            "dev": true,
+            "dependencies": {
+                "es-errors": "^1.3.0",
+                "function-bind": "^1.1.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/call-bound": {
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+            "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+            "dev": true,
+            "dependencies": {
+                "call-bind-apply-helpers": "^1.0.2",
+                "get-intrinsic": "^1.3.0"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/callsites": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz",
+            "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/camel-case": {
+            "version": "4.1.2",
+            "resolved": "https://registry.npmjs.org/camel-case/-/camel-case-4.1.2.tgz",
+            "integrity": "sha512-gxGWBrTT1JuMx6R+o5PTXMmUnhnVzLQ9SNutD4YqKtI6ap897t3tKECYla6gCWEkplXnlNybEkZg9GEGxKFCgw==",
+            "dev": true,
+            "dependencies": {
+                "pascal-case": "^3.1.2",
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/camelcase-css": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz",
+            "integrity": "sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/caniuse-api": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-3.0.0.tgz",
+            "integrity": "sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.0.0",
+                "caniuse-lite": "^1.0.0",
+                "lodash.memoize": "^4.1.2",
+                "lodash.uniq": "^4.5.0"
+            }
+        },
+        "node_modules/caniuse-lite": {
+            "version": "1.0.30001715",
+            "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001715.tgz",
+            "integrity": "sha512-7ptkFGMm2OAOgvZpwgA4yjQ5SQbrNVGdRjzH0pBdy1Fasvcr+KAeECmbCAECzTuDuoX0FCY8KzUxjf9+9kfZEw==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/browserslist"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/caniuse-lite"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ]
+        },
+        "node_modules/chalk": {
+            "version": "4.1.2",
+            "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+            "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+            "dev": true,
+            "dependencies": {
+                "ansi-styles": "^4.1.0",
+                "supports-color": "^7.1.0"
+            },
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/chalk?sponsor=1"
+            }
+        },
+        "node_modules/charenc": {
+            "version": "0.0.2",
+            "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
+            "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==",
+            "dev": true,
+            "engines": {
+                "node": "*"
+            }
+        },
+        "node_modules/chokidar": {
+            "version": "3.6.0",
+            "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
+            "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==",
+            "dev": true,
+            "dependencies": {
+                "anymatch": "~3.1.2",
+                "braces": "~3.0.2",
+                "glob-parent": "~5.1.2",
+                "is-binary-path": "~2.1.0",
+                "is-glob": "~4.0.1",
+                "normalize-path": "~3.0.0",
+                "readdirp": "~3.6.0"
+            },
+            "engines": {
+                "node": ">= 8.10.0"
+            },
+            "funding": {
+                "url": "https://paulmillr.com/funding/"
+            },
+            "optionalDependencies": {
+                "fsevents": "~2.3.2"
+            }
+        },
+        "node_modules/chrome-trace-event": {
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.4.tgz",
+            "integrity": "sha512-rNjApaLzuwaOTjCiT8lSDdGN1APCiqkChLMJxJPWLunPAt5fy8xgU9/jNOchV84wfIxrA0lRQB7oCT8jrn/wrQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.0"
+            }
+        },
+        "node_modules/cipher-base": {
+            "version": "1.0.6",
+            "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.6.tgz",
+            "integrity": "sha512-3Ek9H3X6pj5TgenXYtNWdaBon1tgYCaebd+XPg0keyjEbEfkD4KkmAxkQ/i1vYvxdcT5nscLBfq9VJRmCBcFSw==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.4",
+                "safe-buffer": "^5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/clean-css": {
+            "version": "5.3.3",
+            "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-5.3.3.tgz",
+            "integrity": "sha512-D5J+kHaVb/wKSFcyyV75uCn8fiY4sV38XJoe4CUyGQ+mOU/fMVYUdH1hJC+CJQ5uY3EnW27SbJYS4X8BiLrAFg==",
+            "dev": true,
+            "dependencies": {
+                "source-map": "~0.6.0"
+            },
+            "engines": {
+                "node": ">= 10.0"
+            }
+        },
+        "node_modules/cli-table3": {
+            "version": "0.6.5",
+            "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz",
+            "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==",
+            "dev": true,
+            "dependencies": {
+                "string-width": "^4.2.0"
+            },
+            "engines": {
+                "node": "10.* || >= 12.*"
+            },
+            "optionalDependencies": {
+                "@colors/colors": "1.5.0"
+            }
+        },
+        "node_modules/cliui": {
+            "version": "8.0.1",
+            "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
+            "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
+            "dev": true,
+            "dependencies": {
+                "string-width": "^4.2.0",
+                "strip-ansi": "^6.0.1",
+                "wrap-ansi": "^7.0.0"
+            },
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/clone-deep": {
+            "version": "4.0.1",
+            "resolved": "https://registry.npmjs.org/clone-deep/-/clone-deep-4.0.1.tgz",
+            "integrity": "sha512-neHB9xuzh/wk0dIHweyAXv2aPGZIVk3pLMe+/RNzINf17fe0OG96QroktYAUm7SM1PBnzTabaLboqqxDyMU+SQ==",
+            "dev": true,
+            "dependencies": {
+                "is-plain-object": "^2.0.4",
+                "kind-of": "^6.0.2",
+                "shallow-clone": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/collect.js": {
+            "version": "4.36.1",
+            "resolved": "https://registry.npmjs.org/collect.js/-/collect.js-4.36.1.tgz",
+            "integrity": "sha512-jd97xWPKgHn6uvK31V6zcyPd40lUJd7gpYxbN2VOVxGWO4tyvS9Li4EpsFjXepGTo2tYcOTC4a8YsbQXMJ4XUw==",
+            "dev": true
+        },
+        "node_modules/color-convert": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+            "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+            "dev": true,
+            "dependencies": {
+                "color-name": "~1.1.4"
+            },
+            "engines": {
+                "node": ">=7.0.0"
+            }
+        },
+        "node_modules/color-name": {
+            "version": "1.1.4",
+            "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+            "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+            "dev": true
+        },
+        "node_modules/colord": {
+            "version": "2.9.3",
+            "resolved": "https://registry.npmjs.org/colord/-/colord-2.9.3.tgz",
+            "integrity": "sha512-jeC1axXpnb0/2nn/Y1LPuLdgXBLH7aDcHu4KEKfqw3CUhX7ZpfBSlPKyqXE6btIgEzfWtrX3/tyBCaCvXvMkOw==",
+            "dev": true
+        },
+        "node_modules/colorette": {
+            "version": "2.0.20",
+            "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz",
+            "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==",
+            "dev": true
+        },
+        "node_modules/commander": {
+            "version": "7.2.0",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-7.2.0.tgz",
+            "integrity": "sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/commondir": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz",
+            "integrity": "sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg==",
+            "dev": true
+        },
+        "node_modules/compressible": {
+            "version": "2.0.18",
+            "resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz",
+            "integrity": "sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==",
+            "dev": true,
+            "dependencies": {
+                "mime-db": ">= 1.43.0 < 2"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/compression": {
+            "version": "1.8.0",
+            "resolved": "https://registry.npmjs.org/compression/-/compression-1.8.0.tgz",
+            "integrity": "sha512-k6WLKfunuqCYD3t6AsuPGvQWaKwuLLh2/xHNcX4qE+vIfDNXpSqnrhwA7O53R7WVQUnt8dVAIW+YHr7xTgOgGA==",
+            "dev": true,
+            "dependencies": {
+                "bytes": "3.1.2",
+                "compressible": "~2.0.18",
+                "debug": "2.6.9",
+                "negotiator": "~0.6.4",
+                "on-headers": "~1.0.2",
+                "safe-buffer": "5.2.1",
+                "vary": "~1.1.2"
+            },
+            "engines": {
+                "node": ">= 0.8.0"
+            }
+        },
+        "node_modules/compression/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/compression/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/concat": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/concat/-/concat-1.0.3.tgz",
+            "integrity": "sha512-f/ZaH1aLe64qHgTILdldbvyfGiGF4uzeo9IuXUloIOLQzFmIPloy9QbZadNsuVv0j5qbKQvQb/H/UYf2UsKTpw==",
+            "dev": true,
+            "dependencies": {
+                "commander": "^2.9.0"
+            },
+            "bin": {
+                "concat": "bin/concat"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/concat-map": {
+            "version": "0.0.1",
+            "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+            "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+            "dev": true
+        },
+        "node_modules/concat/node_modules/commander": {
+            "version": "2.20.3",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+            "dev": true
+        },
+        "node_modules/connect-history-api-fallback": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/connect-history-api-fallback/-/connect-history-api-fallback-2.0.0.tgz",
+            "integrity": "sha512-U73+6lQFmfiNPrYbXqr6kZ1i1wiRqXnp2nhMsINseWXO8lDau0LGEffJ8kQi4EjLZympVgRdvqjAgiZ1tgzDDA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.8"
+            }
+        },
+        "node_modules/consola": {
+            "version": "2.15.3",
+            "resolved": "https://registry.npmjs.org/consola/-/consola-2.15.3.tgz",
+            "integrity": "sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==",
+            "dev": true
+        },
+        "node_modules/console-browserify": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/console-browserify/-/console-browserify-1.2.0.tgz",
+            "integrity": "sha512-ZMkYO/LkF17QvCPqM0gxw8yUzigAOZOSWSHg91FH6orS7vcEj5dVZTidN2fQ14yBSdg97RqhSNwLUXInd52OTA==",
+            "dev": true
+        },
+        "node_modules/constants-browserify": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/constants-browserify/-/constants-browserify-1.0.0.tgz",
+            "integrity": "sha512-xFxOwqIzR/e1k1gLiWEophSCMqXcwVHIH7akf7b/vxcUeGunlj3hvZaaqxwHsTgn+IndtkQJgSztIDWeumWJDQ==",
+            "dev": true
+        },
+        "node_modules/content-disposition": {
+            "version": "0.5.4",
+            "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
+            "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+            "dev": true,
+            "dependencies": {
+                "safe-buffer": "5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/content-type": {
+            "version": "1.0.5",
+            "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+            "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/convert-source-map": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+            "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
+            "dev": true
+        },
+        "node_modules/cookie": {
+            "version": "0.7.1",
+            "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.1.tgz",
+            "integrity": "sha512-6DnInpx7SJ2AK3+CTUE/ZM0vWTUboZCegxhC2xiIydHR9jNuTAASBrfEpHhiGOZw/nX51bHt6YQl8jsGo4y/0w==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/cookie-signature": {
+            "version": "1.0.6",
+            "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.6.tgz",
+            "integrity": "sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ==",
+            "dev": true
+        },
+        "node_modules/core-js-compat": {
+            "version": "3.41.0",
+            "resolved": "https://registry.npmjs.org/core-js-compat/-/core-js-compat-3.41.0.tgz",
+            "integrity": "sha512-RFsU9LySVue9RTwdDVX/T0e2Y6jRYWXERKElIjpuEOEnxaXffI0X7RUwVzfYLfzuLXSNJDYoRYUAmRUcyln20A==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.24.4"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/core-js"
+            }
+        },
+        "node_modules/core-util-is": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
+            "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
+            "dev": true
+        },
+        "node_modules/cosmiconfig": {
+            "version": "7.1.0",
+            "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-7.1.0.tgz",
+            "integrity": "sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA==",
+            "dev": true,
+            "dependencies": {
+                "@types/parse-json": "^4.0.0",
+                "import-fresh": "^3.2.1",
+                "parse-json": "^5.0.0",
+                "path-type": "^4.0.0",
+                "yaml": "^1.10.0"
+            },
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/create-ecdh": {
+            "version": "4.0.4",
+            "resolved": "https://registry.npmjs.org/create-ecdh/-/create-ecdh-4.0.4.tgz",
+            "integrity": "sha512-mf+TCx8wWc9VpuxfP2ht0iSISLZnt0JgWlrOKZiNqyUZWnjIaCIVNQArMHnCZKfEYRg6IM7A+NeJoN8gf/Ws0A==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.1.0",
+                "elliptic": "^6.5.3"
+            }
+        },
+        "node_modules/create-ecdh/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/create-hash": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
+            "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
+            "dev": true,
+            "dependencies": {
+                "cipher-base": "^1.0.1",
+                "inherits": "^2.0.1",
+                "md5.js": "^1.3.4",
+                "ripemd160": "^2.0.1",
+                "sha.js": "^2.4.0"
+            }
+        },
+        "node_modules/create-hmac": {
+            "version": "1.1.7",
+            "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
+            "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
+            "dev": true,
+            "dependencies": {
+                "cipher-base": "^1.0.3",
+                "create-hash": "^1.1.0",
+                "inherits": "^2.0.1",
+                "ripemd160": "^2.0.0",
+                "safe-buffer": "^5.0.1",
+                "sha.js": "^2.4.8"
+            }
+        },
+        "node_modules/cross-spawn": {
+            "version": "7.0.6",
+            "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+            "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+            "dev": true,
+            "dependencies": {
+                "path-key": "^3.1.0",
+                "shebang-command": "^2.0.0",
+                "which": "^2.0.1"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/crypt": {
+            "version": "0.0.2",
+            "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
+            "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==",
+            "dev": true,
+            "engines": {
+                "node": "*"
+            }
+        },
+        "node_modules/crypto-browserify": {
+            "version": "3.12.1",
+            "resolved": "https://registry.npmjs.org/crypto-browserify/-/crypto-browserify-3.12.1.tgz",
+            "integrity": "sha512-r4ESw/IlusD17lgQi1O20Fa3qNnsckR126TdUuBgAu7GBYSIPvdNyONd3Zrxh0xCwA4+6w/TDArBPsMvhur+KQ==",
+            "dev": true,
+            "dependencies": {
+                "browserify-cipher": "^1.0.1",
+                "browserify-sign": "^4.2.3",
+                "create-ecdh": "^4.0.4",
+                "create-hash": "^1.2.0",
+                "create-hmac": "^1.1.7",
+                "diffie-hellman": "^5.0.3",
+                "hash-base": "~3.0.4",
+                "inherits": "^2.0.4",
+                "pbkdf2": "^3.1.2",
+                "public-encrypt": "^4.0.3",
+                "randombytes": "^2.1.0",
+                "randomfill": "^1.0.4"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/css-declaration-sorter": {
+            "version": "6.4.1",
+            "resolved": "https://registry.npmjs.org/css-declaration-sorter/-/css-declaration-sorter-6.4.1.tgz",
+            "integrity": "sha512-rtdthzxKuyq6IzqX6jEcIzQF/YqccluefyCYheovBOLhFT/drQA9zj/UbRAa9J7C0o6EG6u3E6g+vKkay7/k3g==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.0.9"
+            }
+        },
+        "node_modules/css-loader": {
+            "version": "5.2.7",
+            "resolved": "https://registry.npmjs.org/css-loader/-/css-loader-5.2.7.tgz",
+            "integrity": "sha512-Q7mOvpBNBG7YrVGMxRxcBJZFL75o+cH2abNASdibkj/fffYD8qWbInZrD0S9ccI6vZclF3DsHE7njGlLtaHbhg==",
+            "dev": true,
+            "dependencies": {
+                "icss-utils": "^5.1.0",
+                "loader-utils": "^2.0.0",
+                "postcss": "^8.2.15",
+                "postcss-modules-extract-imports": "^3.0.0",
+                "postcss-modules-local-by-default": "^4.0.0",
+                "postcss-modules-scope": "^3.0.0",
+                "postcss-modules-values": "^4.0.0",
+                "postcss-value-parser": "^4.1.0",
+                "schema-utils": "^3.0.0",
+                "semver": "^7.3.5"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.27.0 || ^5.0.0"
+            }
+        },
+        "node_modules/css-loader/node_modules/schema-utils": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
+            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.8",
+                "ajv": "^6.12.5",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/css-select": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/css-select/-/css-select-4.3.0.tgz",
+            "integrity": "sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ==",
+            "dev": true,
+            "dependencies": {
+                "boolbase": "^1.0.0",
+                "css-what": "^6.0.1",
+                "domhandler": "^4.3.1",
+                "domutils": "^2.8.0",
+                "nth-check": "^2.0.1"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/fb55"
+            }
+        },
+        "node_modules/css-select/node_modules/domhandler": {
+            "version": "4.3.1",
+            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
+            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.2.0"
+            },
+            "engines": {
+                "node": ">= 4"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/domhandler?sponsor=1"
+            }
+        },
+        "node_modules/css-tree": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-1.1.3.tgz",
+            "integrity": "sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q==",
+            "dev": true,
+            "dependencies": {
+                "mdn-data": "2.0.14",
+                "source-map": "^0.6.1"
+            },
+            "engines": {
+                "node": ">=8.0.0"
+            }
+        },
+        "node_modules/css-what": {
+            "version": "6.1.0",
+            "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.1.0.tgz",
+            "integrity": "sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/fb55"
+            }
+        },
+        "node_modules/cssesc": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
+            "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
+            "dev": true,
+            "bin": {
+                "cssesc": "bin/cssesc"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/cssnano": {
+            "version": "5.1.15",
+            "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-5.1.15.tgz",
+            "integrity": "sha512-j+BKgDcLDQA+eDifLx0EO4XSA56b7uut3BQFH+wbSaSTuGLuiyTa/wbRYthUXX8LC9mLg+WWKe8h+qJuwTAbHw==",
+            "dev": true,
+            "dependencies": {
+                "cssnano-preset-default": "^5.2.14",
+                "lilconfig": "^2.0.3",
+                "yaml": "^1.10.2"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/cssnano"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/cssnano-preset-default": {
+            "version": "5.2.14",
+            "resolved": "https://registry.npmjs.org/cssnano-preset-default/-/cssnano-preset-default-5.2.14.tgz",
+            "integrity": "sha512-t0SFesj/ZV2OTylqQVOrFgEh5uanxbO6ZAdeCrNsUQ6fVuXwYTxJPNAGvGTxHbD68ldIJNec7PyYZDBrfDQ+6A==",
+            "dev": true,
+            "dependencies": {
+                "css-declaration-sorter": "^6.3.1",
+                "cssnano-utils": "^3.1.0",
+                "postcss-calc": "^8.2.3",
+                "postcss-colormin": "^5.3.1",
+                "postcss-convert-values": "^5.1.3",
+                "postcss-discard-comments": "^5.1.2",
+                "postcss-discard-duplicates": "^5.1.0",
+                "postcss-discard-empty": "^5.1.1",
+                "postcss-discard-overridden": "^5.1.0",
+                "postcss-merge-longhand": "^5.1.7",
+                "postcss-merge-rules": "^5.1.4",
+                "postcss-minify-font-values": "^5.1.0",
+                "postcss-minify-gradients": "^5.1.1",
+                "postcss-minify-params": "^5.1.4",
+                "postcss-minify-selectors": "^5.2.1",
+                "postcss-normalize-charset": "^5.1.0",
+                "postcss-normalize-display-values": "^5.1.0",
+                "postcss-normalize-positions": "^5.1.1",
+                "postcss-normalize-repeat-style": "^5.1.1",
+                "postcss-normalize-string": "^5.1.0",
+                "postcss-normalize-timing-functions": "^5.1.0",
+                "postcss-normalize-unicode": "^5.1.1",
+                "postcss-normalize-url": "^5.1.0",
+                "postcss-normalize-whitespace": "^5.1.1",
+                "postcss-ordered-values": "^5.1.3",
+                "postcss-reduce-initial": "^5.1.2",
+                "postcss-reduce-transforms": "^5.1.0",
+                "postcss-svgo": "^5.1.0",
+                "postcss-unique-selectors": "^5.1.1"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/cssnano-utils": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/cssnano-utils/-/cssnano-utils-3.1.0.tgz",
+            "integrity": "sha512-JQNR19/YZhz4psLX/rQ9M83e3z2Wf/HdJbryzte4a3NSuafyp9w/I4U+hx5C2S9g41qlstH7DEWnZaaj83OuEA==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/csso": {
+            "version": "4.2.0",
+            "resolved": "https://registry.npmjs.org/csso/-/csso-4.2.0.tgz",
+            "integrity": "sha512-wvlcdIbf6pwKEk7vHj8/Bkc0B4ylXZruLvOgs9doS5eOsOpuodOV2zJChSpkp+pRpYQLQMeF04nr3Z68Sta9jA==",
+            "dev": true,
+            "dependencies": {
+                "css-tree": "^1.1.2"
+            },
+            "engines": {
+                "node": ">=8.0.0"
+            }
+        },
+        "node_modules/debug": {
+            "version": "4.4.0",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz",
+            "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "^2.1.3"
+            },
+            "engines": {
+                "node": ">=6.0"
+            },
+            "peerDependenciesMeta": {
+                "supports-color": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/default-gateway": {
+            "version": "6.0.3",
+            "resolved": "https://registry.npmjs.org/default-gateway/-/default-gateway-6.0.3.tgz",
+            "integrity": "sha512-fwSOJsbbNzZ/CUFpqFBqYfYNLj1NbMPm8MMCIzHjC83iSJRBEGmDUxU+WP661BaBQImeC2yHwXtz+P/O9o+XEg==",
+            "dev": true,
+            "dependencies": {
+                "execa": "^5.0.0"
+            },
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/define-data-property": {
+            "version": "1.1.4",
+            "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",
+            "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",
+            "dev": true,
+            "dependencies": {
+                "es-define-property": "^1.0.0",
+                "es-errors": "^1.3.0",
+                "gopd": "^1.0.1"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/define-lazy-prop": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz",
+            "integrity": "sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/define-properties": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",
+            "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",
+            "dev": true,
+            "dependencies": {
+                "define-data-property": "^1.0.1",
+                "has-property-descriptors": "^1.0.0",
+                "object-keys": "^1.1.1"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/depd": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+            "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/des.js": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.1.0.tgz",
+            "integrity": "sha512-r17GxjhUCjSRy8aiJpr8/UadFIzMzJGexI3Nmz4ADi9LYSFx4gTBp80+NaX/YsXWWLhpZ7v/v/ubEc/bCNfKwg==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.1",
+                "minimalistic-assert": "^1.0.0"
+            }
+        },
+        "node_modules/destroy": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
+            "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8",
+                "npm": "1.2.8000 || >= 1.4.16"
+            }
+        },
+        "node_modules/detect-node": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
+            "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",
+            "dev": true
+        },
+        "node_modules/didyoumean": {
+            "version": "1.2.2",
+            "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz",
+            "integrity": "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw==",
+            "dev": true
+        },
+        "node_modules/diffie-hellman": {
+            "version": "5.0.3",
+            "resolved": "https://registry.npmjs.org/diffie-hellman/-/diffie-hellman-5.0.3.tgz",
+            "integrity": "sha512-kqag/Nl+f3GwyK25fhUMYj81BUOrZ9IuJsjIcDE5icNM9FJHAVm3VcUDxdLPoQtTuUylWm6ZIknYJwwaPxsUzg==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.1.0",
+                "miller-rabin": "^4.0.0",
+                "randombytes": "^2.0.0"
+            }
+        },
+        "node_modules/diffie-hellman/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/dir-glob": {
+            "version": "3.0.1",
+            "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",
+            "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",
+            "dev": true,
+            "dependencies": {
+                "path-type": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/dlv": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",
+            "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==",
+            "dev": true
+        },
+        "node_modules/dns-packet": {
+            "version": "5.6.1",
+            "resolved": "https://registry.npmjs.org/dns-packet/-/dns-packet-5.6.1.tgz",
+            "integrity": "sha512-l4gcSouhcgIKRvyy99RNVOgxXiicE+2jZoNmaNmZ6JXiGajBOJAesk1OBlJuM5k2c+eudGdLxDqXuPCKIj6kpw==",
+            "dev": true,
+            "dependencies": {
+                "@leichtgewicht/ip-codec": "^2.0.1"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/dom-serializer": {
+            "version": "1.4.1",
+            "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz",
+            "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.0.1",
+                "domhandler": "^4.2.0",
+                "entities": "^2.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+            }
+        },
+        "node_modules/dom-serializer/node_modules/domhandler": {
+            "version": "4.3.1",
+            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
+            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.2.0"
+            },
+            "engines": {
+                "node": ">= 4"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/domhandler?sponsor=1"
+            }
+        },
+        "node_modules/domain-browser": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/domain-browser/-/domain-browser-1.2.0.tgz",
+            "integrity": "sha512-jnjyiM6eRyZl2H+W8Q/zLMA481hzi0eszAaBUzIVnmYVDBbnLxVNnfu1HgEBvCbL+71FrxMl3E6lpKH7Ge3OXA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.4",
+                "npm": ">=1.2"
+            }
+        },
+        "node_modules/domelementtype": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
+            "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/fb55"
+                }
+            ]
+        },
+        "node_modules/domhandler": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-3.3.0.tgz",
+            "integrity": "sha512-J1C5rIANUbuYK+FuFL98650rihynUOEzRLxW+90bKZRWB6A1X1Tf82GxR1qAWLyfNPRvjqfip3Q5tdYlmAa9lA==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.0.1"
+            },
+            "engines": {
+                "node": ">= 4"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/domhandler?sponsor=1"
+            }
+        },
+        "node_modules/domutils": {
+            "version": "2.8.0",
+            "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz",
+            "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==",
+            "dev": true,
+            "dependencies": {
+                "dom-serializer": "^1.0.1",
+                "domelementtype": "^2.2.0",
+                "domhandler": "^4.2.0"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/domutils?sponsor=1"
+            }
+        },
+        "node_modules/domutils/node_modules/domhandler": {
+            "version": "4.3.1",
+            "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",
+            "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.2.0"
+            },
+            "engines": {
+                "node": ">= 4"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/domhandler?sponsor=1"
+            }
+        },
+        "node_modules/dot-case": {
+            "version": "3.0.4",
+            "resolved": "https://registry.npmjs.org/dot-case/-/dot-case-3.0.4.tgz",
+            "integrity": "sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w==",
+            "dev": true,
+            "dependencies": {
+                "no-case": "^3.0.4",
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/dotenv": {
+            "version": "10.0.0",
+            "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-10.0.0.tgz",
+            "integrity": "sha512-rlBi9d8jpv9Sf1klPjNfFAuWDjKLwTIJJ/VxtoTwIR6hnZxcEOQCZg2oIL3MWBYw5GpUDKOEnND7LXTbIpQ03Q==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/dotenv-expand": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/dotenv-expand/-/dotenv-expand-5.1.0.tgz",
+            "integrity": "sha512-YXQl1DSa4/PQyRfgrv6aoNjhasp/p4qs9FjJ4q4cQk+8m4r6k4ZSiEyytKG8f8W9gi8WsQtIObNmKd+tMzNTmA==",
+            "dev": true
+        },
+        "node_modules/dunder-proto": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+            "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+            "dev": true,
+            "dependencies": {
+                "call-bind-apply-helpers": "^1.0.1",
+                "es-errors": "^1.3.0",
+                "gopd": "^1.2.0"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/eastasianwidth": {
+            "version": "0.2.0",
+            "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+            "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+            "dev": true
+        },
+        "node_modules/ee-first": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+            "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+            "dev": true
+        },
+        "node_modules/electron-to-chromium": {
+            "version": "1.5.139",
+            "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.139.tgz",
+            "integrity": "sha512-GGnRYOTdN5LYpwbIr0rwP/ZHOQSvAF6TG0LSzp28uCBb9JiXHJGmaaKw29qjNJc5bGnnp6kXJqRnGMQoELwi5w==",
+            "dev": true
+        },
+        "node_modules/elliptic": {
+            "version": "6.6.1",
+            "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.6.1.tgz",
+            "integrity": "sha512-RaddvvMatK2LJHqFJ+YA4WysVN5Ita9E35botqIYspQ4TkRAlCicdzKOjlyv/1Za5RyTNn7di//eEV0uTAfe3g==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.11.9",
+                "brorand": "^1.1.0",
+                "hash.js": "^1.0.0",
+                "hmac-drbg": "^1.0.1",
+                "inherits": "^2.0.4",
+                "minimalistic-assert": "^1.0.1",
+                "minimalistic-crypto-utils": "^1.0.1"
+            }
+        },
+        "node_modules/elliptic/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/emoji-regex": {
+            "version": "8.0.0",
+            "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+            "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+            "dev": true
+        },
+        "node_modules/emojis-list": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/emojis-list/-/emojis-list-3.0.0.tgz",
+            "integrity": "sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q==",
+            "dev": true,
+            "engines": {
+                "node": ">= 4"
+            }
+        },
+        "node_modules/encodeurl": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+            "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/enhanced-resolve": {
+            "version": "5.18.1",
+            "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.1.tgz",
+            "integrity": "sha512-ZSW3ma5GkcQBIpwZTSRAI8N71Uuwgs93IezB7mf7R60tC8ZbJideoDNKjHn2O9KIlx6rkGTTEk1xUCK2E1Y2Yg==",
+            "dev": true,
+            "dependencies": {
+                "graceful-fs": "^4.2.4",
+                "tapable": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/entities": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz",
+            "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==",
+            "dev": true,
+            "funding": {
+                "url": "https://github.com/fb55/entities?sponsor=1"
+            }
+        },
+        "node_modules/envinfo": {
+            "version": "7.14.0",
+            "resolved": "https://registry.npmjs.org/envinfo/-/envinfo-7.14.0.tgz",
+            "integrity": "sha512-CO40UI41xDQzhLB1hWyqUKgFhs250pNcGbyGKe1l/e4FSaI/+YE4IMG76GDt0In67WLPACIITC+sOi08x4wIvg==",
+            "dev": true,
+            "bin": {
+                "envinfo": "dist/cli.js"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/error-ex": {
+            "version": "1.3.2",
+            "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
+            "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
+            "dev": true,
+            "dependencies": {
+                "is-arrayish": "^0.2.1"
+            }
+        },
+        "node_modules/es-define-property": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+            "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/es-errors": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+            "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/es-module-lexer": {
+            "version": "1.6.0",
+            "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.6.0.tgz",
+            "integrity": "sha512-qqnD1yMU6tk/jnaMosogGySTZP8YtUgAffA9nMN+E/rjxcfRQ6IEk7IiozUjgxKoFHBGjTLnrHB/YC45r/59EQ==",
+            "dev": true
+        },
+        "node_modules/es-object-atoms": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+            "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+            "dev": true,
+            "dependencies": {
+                "es-errors": "^1.3.0"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/escalade": {
+            "version": "3.2.0",
+            "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+            "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/escape-html": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+            "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+            "dev": true
+        },
+        "node_modules/eslint-scope": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz",
+            "integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==",
+            "dev": true,
+            "dependencies": {
+                "esrecurse": "^4.3.0",
+                "estraverse": "^4.1.1"
+            },
+            "engines": {
+                "node": ">=8.0.0"
+            }
+        },
+        "node_modules/esrecurse": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
+            "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
+            "dev": true,
+            "dependencies": {
+                "estraverse": "^5.2.0"
+            },
+            "engines": {
+                "node": ">=4.0"
+            }
+        },
+        "node_modules/esrecurse/node_modules/estraverse": {
+            "version": "5.3.0",
+            "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
+            "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
+            "dev": true,
+            "engines": {
+                "node": ">=4.0"
+            }
+        },
+        "node_modules/estraverse": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz",
+            "integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==",
+            "dev": true,
+            "engines": {
+                "node": ">=4.0"
+            }
+        },
+        "node_modules/esutils": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+            "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/etag": {
+            "version": "1.8.1",
+            "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+            "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/eventemitter3": {
+            "version": "4.0.7",
+            "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz",
+            "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==",
+            "dev": true
+        },
+        "node_modules/events": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
+            "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.8.x"
+            }
+        },
+        "node_modules/evp_bytestokey": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
+            "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
+            "dev": true,
+            "dependencies": {
+                "md5.js": "^1.3.4",
+                "safe-buffer": "^5.1.1"
+            }
+        },
+        "node_modules/execa": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
+            "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
+            "dev": true,
+            "dependencies": {
+                "cross-spawn": "^7.0.3",
+                "get-stream": "^6.0.0",
+                "human-signals": "^2.1.0",
+                "is-stream": "^2.0.0",
+                "merge-stream": "^2.0.0",
+                "npm-run-path": "^4.0.1",
+                "onetime": "^5.1.2",
+                "signal-exit": "^3.0.3",
+                "strip-final-newline": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/sindresorhus/execa?sponsor=1"
+            }
+        },
+        "node_modules/express": {
+            "version": "4.21.2",
+            "resolved": "https://registry.npmjs.org/express/-/express-4.21.2.tgz",
+            "integrity": "sha512-28HqgMZAmih1Czt9ny7qr6ek2qddF4FclbMzwhCREB6OFfH+rXAnuNCwo1/wFvrtbgsQDb4kSbX9de9lFbrXnA==",
+            "dev": true,
+            "dependencies": {
+                "accepts": "~1.3.8",
+                "array-flatten": "1.1.1",
+                "body-parser": "1.20.3",
+                "content-disposition": "0.5.4",
+                "content-type": "~1.0.4",
+                "cookie": "0.7.1",
+                "cookie-signature": "1.0.6",
+                "debug": "2.6.9",
+                "depd": "2.0.0",
+                "encodeurl": "~2.0.0",
+                "escape-html": "~1.0.3",
+                "etag": "~1.8.1",
+                "finalhandler": "1.3.1",
+                "fresh": "0.5.2",
+                "http-errors": "2.0.0",
+                "merge-descriptors": "1.0.3",
+                "methods": "~1.1.2",
+                "on-finished": "2.4.1",
+                "parseurl": "~1.3.3",
+                "path-to-regexp": "0.1.12",
+                "proxy-addr": "~2.0.7",
+                "qs": "6.13.0",
+                "range-parser": "~1.2.1",
+                "safe-buffer": "5.2.1",
+                "send": "0.19.0",
+                "serve-static": "1.16.2",
+                "setprototypeof": "1.2.0",
+                "statuses": "2.0.1",
+                "type-is": "~1.6.18",
+                "utils-merge": "1.0.1",
+                "vary": "~1.1.2"
+            },
+            "engines": {
+                "node": ">= 0.10.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/express"
+            }
+        },
+        "node_modules/express/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/express/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/express/node_modules/qs": {
+            "version": "6.13.0",
+            "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz",
+            "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==",
+            "dev": true,
+            "dependencies": {
+                "side-channel": "^1.0.6"
+            },
+            "engines": {
+                "node": ">=0.6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/fast-deep-equal": {
+            "version": "3.1.3",
+            "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+            "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+            "dev": true
+        },
+        "node_modules/fast-glob": {
+            "version": "3.3.3",
+            "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+            "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+            "dev": true,
+            "dependencies": {
+                "@nodelib/fs.stat": "^2.0.2",
+                "@nodelib/fs.walk": "^1.2.3",
+                "glob-parent": "^5.1.2",
+                "merge2": "^1.3.0",
+                "micromatch": "^4.0.8"
+            },
+            "engines": {
+                "node": ">=8.6.0"
+            }
+        },
+        "node_modules/fast-json-stable-stringify": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+            "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+            "dev": true
+        },
+        "node_modules/fast-uri": {
+            "version": "3.0.6",
+            "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.6.tgz",
+            "integrity": "sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/fastify"
+                },
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/fastify"
+                }
+            ]
+        },
+        "node_modules/fastest-levenshtein": {
+            "version": "1.0.16",
+            "resolved": "https://registry.npmjs.org/fastest-levenshtein/-/fastest-levenshtein-1.0.16.tgz",
+            "integrity": "sha512-eRnCtTTtGZFpQCwhJiUOuxPQWRXVKYDn0b2PeHfXL6/Zi53SLAzAHfVhVWK2AryC/WH05kGfxhFIPvTF0SXQzg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 4.9.1"
+            }
+        },
+        "node_modules/fastq": {
+            "version": "1.19.1",
+            "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
+            "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
+            "dev": true,
+            "dependencies": {
+                "reusify": "^1.0.4"
+            }
+        },
+        "node_modules/faye-websocket": {
+            "version": "0.11.4",
+            "resolved": "https://registry.npmjs.org/faye-websocket/-/faye-websocket-0.11.4.tgz",
+            "integrity": "sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g==",
+            "dev": true,
+            "dependencies": {
+                "websocket-driver": ">=0.5.1"
+            },
+            "engines": {
+                "node": ">=0.8.0"
+            }
+        },
+        "node_modules/file-loader": {
+            "version": "6.2.0",
+            "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-6.2.0.tgz",
+            "integrity": "sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw==",
+            "dev": true,
+            "dependencies": {
+                "loader-utils": "^2.0.0",
+                "schema-utils": "^3.0.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.0.0 || ^5.0.0"
+            }
+        },
+        "node_modules/file-loader/node_modules/schema-utils": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
+            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.8",
+                "ajv": "^6.12.5",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/file-type": {
+            "version": "12.4.2",
+            "resolved": "https://registry.npmjs.org/file-type/-/file-type-12.4.2.tgz",
+            "integrity": "sha512-UssQP5ZgIOKelfsaB5CuGAL+Y+q7EmONuiwF3N5HAH0t27rvrttgi6Ra9k/+DVaY9UF6+ybxu5pOXLUdA8N7Vg==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/fill-range": {
+            "version": "7.1.1",
+            "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+            "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+            "dev": true,
+            "dependencies": {
+                "to-regex-range": "^5.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/finalhandler": {
+            "version": "1.3.1",
+            "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz",
+            "integrity": "sha512-6BN9trH7bp3qvnrRyzsBz+g3lZxTNZTbVO2EV1CS0WIcDbawYVdYvGflME/9QP0h0pYlCDBCTjYa9nZzMDpyxQ==",
+            "dev": true,
+            "dependencies": {
+                "debug": "2.6.9",
+                "encodeurl": "~2.0.0",
+                "escape-html": "~1.0.3",
+                "on-finished": "2.4.1",
+                "parseurl": "~1.3.3",
+                "statuses": "2.0.1",
+                "unpipe": "~1.0.0"
+            },
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/finalhandler/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/finalhandler/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/find-cache-dir": {
+            "version": "3.3.2",
+            "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-3.3.2.tgz",
+            "integrity": "sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig==",
+            "dev": true,
+            "dependencies": {
+                "commondir": "^1.0.1",
+                "make-dir": "^3.0.2",
+                "pkg-dir": "^4.1.0"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/avajs/find-cache-dir?sponsor=1"
+            }
+        },
+        "node_modules/find-up": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+            "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
+            "dev": true,
+            "dependencies": {
+                "locate-path": "^5.0.0",
+                "path-exists": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/flat": {
+            "version": "5.0.2",
+            "resolved": "https://registry.npmjs.org/flat/-/flat-5.0.2.tgz",
+            "integrity": "sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==",
+            "dev": true,
+            "bin": {
+                "flat": "cli.js"
+            }
+        },
+        "node_modules/follow-redirects": {
+            "version": "1.15.9",
+            "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.9.tgz",
+            "integrity": "sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "individual",
+                    "url": "https://github.com/sponsors/RubenVerborgh"
+                }
+            ],
+            "engines": {
+                "node": ">=4.0"
+            },
+            "peerDependenciesMeta": {
+                "debug": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/foreground-child": {
+            "version": "3.3.1",
+            "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+            "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+            "dev": true,
+            "dependencies": {
+                "cross-spawn": "^7.0.6",
+                "signal-exit": "^4.0.1"
+            },
+            "engines": {
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/foreground-child/node_modules/signal-exit": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+            "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+            "dev": true,
+            "engines": {
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/forwarded": {
+            "version": "0.2.0",
+            "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+            "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/fraction.js": {
+            "version": "4.3.7",
+            "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.3.7.tgz",
+            "integrity": "sha512-ZsDfxO51wGAXREY55a7la9LScWpwv9RxIrYABrlvOFBlH/ShPnrtsXeuUIfXKKOVicNxQ+o8JTbJvjS4M89yew==",
+            "dev": true,
+            "engines": {
+                "node": "*"
+            },
+            "funding": {
+                "type": "patreon",
+                "url": "https://github.com/sponsors/rawify"
+            }
+        },
+        "node_modules/fresh": {
+            "version": "0.5.2",
+            "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
+            "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/fs-extra": {
+            "version": "10.1.0",
+            "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
+            "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
+            "dev": true,
+            "dependencies": {
+                "graceful-fs": "^4.2.0",
+                "jsonfile": "^6.0.1",
+                "universalify": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/fs-monkey": {
+            "version": "1.0.6",
+            "resolved": "https://registry.npmjs.org/fs-monkey/-/fs-monkey-1.0.6.tgz",
+            "integrity": "sha512-b1FMfwetIKymC0eioW7mTywihSQE4oLzQn1dB6rZB5fx/3NpNEdAWeCSMB+60/AeT0TCXsxzAlcYVEFCTAksWg==",
+            "dev": true
+        },
+        "node_modules/fs.realpath": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+            "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+            "dev": true
+        },
+        "node_modules/fsevents": {
+            "version": "2.3.3",
+            "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+            "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+            }
+        },
+        "node_modules/function-bind": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+            "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+            "dev": true,
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/gensync": {
+            "version": "1.0.0-beta.2",
+            "resolved": "https://registry.npmjs.org/gensync/-/gensync-1.0.0-beta.2.tgz",
+            "integrity": "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.9.0"
+            }
+        },
+        "node_modules/get-caller-file": {
+            "version": "2.0.5",
+            "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+            "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+            "dev": true,
+            "engines": {
+                "node": "6.* || 8.* || >= 10.*"
+            }
+        },
+        "node_modules/get-intrinsic": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+            "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+            "dev": true,
+            "dependencies": {
+                "call-bind-apply-helpers": "^1.0.2",
+                "es-define-property": "^1.0.1",
+                "es-errors": "^1.3.0",
+                "es-object-atoms": "^1.1.1",
+                "function-bind": "^1.1.2",
+                "get-proto": "^1.0.1",
+                "gopd": "^1.2.0",
+                "has-symbols": "^1.1.0",
+                "hasown": "^2.0.2",
+                "math-intrinsics": "^1.1.0"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/get-proto": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+            "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+            "dev": true,
+            "dependencies": {
+                "dunder-proto": "^1.0.1",
+                "es-object-atoms": "^1.0.0"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/get-stream": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
+            "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/glob": {
+            "version": "7.2.3",
+            "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+            "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+            "deprecated": "Glob versions prior to v9 are no longer supported",
+            "dev": true,
+            "dependencies": {
+                "fs.realpath": "^1.0.0",
+                "inflight": "^1.0.4",
+                "inherits": "2",
+                "minimatch": "^3.1.1",
+                "once": "^1.3.0",
+                "path-is-absolute": "^1.0.0"
+            },
+            "engines": {
+                "node": "*"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/glob-parent": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+            "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+            "dev": true,
+            "dependencies": {
+                "is-glob": "^4.0.1"
+            },
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/glob-to-regexp": {
+            "version": "0.4.1",
+            "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz",
+            "integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==",
+            "dev": true
+        },
+        "node_modules/globals": {
+            "version": "11.12.0",
+            "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz",
+            "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/globby": {
+            "version": "10.0.2",
+            "resolved": "https://registry.npmjs.org/globby/-/globby-10.0.2.tgz",
+            "integrity": "sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==",
+            "dev": true,
+            "dependencies": {
+                "@types/glob": "^7.1.1",
+                "array-union": "^2.1.0",
+                "dir-glob": "^3.0.1",
+                "fast-glob": "^3.0.3",
+                "glob": "^7.1.3",
+                "ignore": "^5.1.1",
+                "merge2": "^1.2.3",
+                "slash": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/gopd": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+            "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/graceful-fs": {
+            "version": "4.2.11",
+            "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+            "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+            "dev": true
+        },
+        "node_modules/growly": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/growly/-/growly-1.3.0.tgz",
+            "integrity": "sha512-+xGQY0YyAWCnqy7Cd++hc2JqMYzlm0dG30Jd0beaA64sROr8C4nt8Yc9V5Ro3avlSUDTN0ulqP/VBKi1/lLygw==",
+            "dev": true
+        },
+        "node_modules/handle-thing": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/handle-thing/-/handle-thing-2.0.1.tgz",
+            "integrity": "sha512-9Qn4yBxelxoh2Ow62nP+Ka/kMnOXRi8BXnRaUwezLNhqelnN49xKz4F/dPP8OYLxLxq6JDtZb2i9XznUQbNPTg==",
+            "dev": true
+        },
+        "node_modules/has-flag": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+            "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/has-property-descriptors": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",
+            "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",
+            "dev": true,
+            "dependencies": {
+                "es-define-property": "^1.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/has-symbols": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+            "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/hash-base": {
+            "version": "3.0.5",
+            "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.0.5.tgz",
+            "integrity": "sha512-vXm0l45VbcHEVlTCzs8M+s0VeYsB2lnlAaThoLKGXr3bE/VWDOelNUnycUPEhKEaXARL2TEFjBOyUiM6+55KBg==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.4",
+                "safe-buffer": "^5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/hash-sum": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/hash-sum/-/hash-sum-1.0.2.tgz",
+            "integrity": "sha512-fUs4B4L+mlt8/XAtSOGMUO1TXmAelItBPtJG7CyHJfYTdDjwisntGO2JQz7oUsatOY9o68+57eziUVNw/mRHmA==",
+            "dev": true
+        },
+        "node_modules/hash.js": {
+            "version": "1.1.7",
+            "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
+            "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.3",
+                "minimalistic-assert": "^1.0.1"
+            }
+        },
+        "node_modules/hasown": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+            "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+            "dev": true,
+            "dependencies": {
+                "function-bind": "^1.1.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/he": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
+            "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
+            "dev": true,
+            "bin": {
+                "he": "bin/he"
+            }
+        },
+        "node_modules/hmac-drbg": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
+            "integrity": "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==",
+            "dev": true,
+            "dependencies": {
+                "hash.js": "^1.0.3",
+                "minimalistic-assert": "^1.0.0",
+                "minimalistic-crypto-utils": "^1.0.1"
+            }
+        },
+        "node_modules/hpack.js": {
+            "version": "2.1.6",
+            "resolved": "https://registry.npmjs.org/hpack.js/-/hpack.js-2.1.6.tgz",
+            "integrity": "sha512-zJxVehUdMGIKsRaNt7apO2Gqp0BdqW5yaiGHXXmbpvxgBYVZnAql+BJb4RO5ad2MgpbZKn5G6nMnegrH1FcNYQ==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.1",
+                "obuf": "^1.0.0",
+                "readable-stream": "^2.0.1",
+                "wbuf": "^1.1.0"
+            }
+        },
+        "node_modules/html-entities": {
+            "version": "2.6.0",
+            "resolved": "https://registry.npmjs.org/html-entities/-/html-entities-2.6.0.tgz",
+            "integrity": "sha512-kig+rMn/QOVRvr7c86gQ8lWXq+Hkv6CbAH1hLu+RG338StTpE8Z0b44SDVaqVu7HGKf27frdmUYEs9hTUX/cLQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/mdevils"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://patreon.com/mdevils"
+                }
+            ]
+        },
+        "node_modules/html-loader": {
+            "version": "1.3.2",
+            "resolved": "https://registry.npmjs.org/html-loader/-/html-loader-1.3.2.tgz",
+            "integrity": "sha512-DEkUwSd0sijK5PF3kRWspYi56XP7bTNkyg5YWSzBdjaSDmvCufep5c4Vpb3PBf6lUL0YPtLwBfy9fL0t5hBAGA==",
+            "dev": true,
+            "dependencies": {
+                "html-minifier-terser": "^5.1.1",
+                "htmlparser2": "^4.1.0",
+                "loader-utils": "^2.0.0",
+                "schema-utils": "^3.0.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.0.0 || ^5.0.0"
+            }
+        },
+        "node_modules/html-loader/node_modules/schema-utils": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
+            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.8",
+                "ajv": "^6.12.5",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/html-minifier-terser": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/html-minifier-terser/-/html-minifier-terser-5.1.1.tgz",
+            "integrity": "sha512-ZPr5MNObqnV/T9akshPKbVgyOqLmy+Bxo7juKCfTfnjNniTAMdy4hz21YQqoofMBJD2kdREaqPPdThoR78Tgxg==",
+            "dev": true,
+            "dependencies": {
+                "camel-case": "^4.1.1",
+                "clean-css": "^4.2.3",
+                "commander": "^4.1.1",
+                "he": "^1.2.0",
+                "param-case": "^3.0.3",
+                "relateurl": "^0.2.7",
+                "terser": "^4.6.3"
+            },
+            "bin": {
+                "html-minifier-terser": "cli.js"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/html-minifier-terser/node_modules/clean-css": {
+            "version": "4.2.4",
+            "resolved": "https://registry.npmjs.org/clean-css/-/clean-css-4.2.4.tgz",
+            "integrity": "sha512-EJUDT7nDVFDvaQgAo2G/PJvxmp1o/c6iXLbswsBbUFXi1Nr+AjA2cKmfbKDMjMvzEe75g3P6JkaDDAKk96A85A==",
+            "dev": true,
+            "dependencies": {
+                "source-map": "~0.6.0"
+            },
+            "engines": {
+                "node": ">= 4.0"
+            }
+        },
+        "node_modules/html-minifier-terser/node_modules/commander": {
+            "version": "4.1.1",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
+            "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/html-minifier-terser/node_modules/terser": {
+            "version": "4.8.1",
+            "resolved": "https://registry.npmjs.org/terser/-/terser-4.8.1.tgz",
+            "integrity": "sha512-4GnLC0x667eJG0ewJTa6z/yXrbLGv80D9Ru6HIpCQmO+Q4PfEtBFi0ObSckqwL6VyQv/7ENJieXHo2ANmdQwgw==",
+            "dev": true,
+            "dependencies": {
+                "commander": "^2.20.0",
+                "source-map": "~0.6.1",
+                "source-map-support": "~0.5.12"
+            },
+            "bin": {
+                "terser": "bin/terser"
+            },
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/html-minifier-terser/node_modules/terser/node_modules/commander": {
+            "version": "2.20.3",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+            "dev": true
+        },
+        "node_modules/htmlparser2": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-4.1.0.tgz",
+            "integrity": "sha512-4zDq1a1zhE4gQso/c5LP1OtrhYTncXNSpvJYtWJBtXAETPlMfi3IFNjGuQbYLuVY4ZR0QMqRVvo4Pdy9KLyP8Q==",
+            "dev": true,
+            "dependencies": {
+                "domelementtype": "^2.0.1",
+                "domhandler": "^3.0.0",
+                "domutils": "^2.0.0",
+                "entities": "^2.0.0"
+            }
+        },
+        "node_modules/http-deceiver": {
+            "version": "1.2.7",
+            "resolved": "https://registry.npmjs.org/http-deceiver/-/http-deceiver-1.2.7.tgz",
+            "integrity": "sha512-LmpOGxTfbpgtGVxJrj5k7asXHCgNZp5nLfp+hWc8QQRqtb7fUy6kRY3BO1h9ddF6yIPYUARgxGOwB42DnxIaNw==",
+            "dev": true
+        },
+        "node_modules/http-errors": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
+            "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
+            "dev": true,
+            "dependencies": {
+                "depd": "2.0.0",
+                "inherits": "2.0.4",
+                "setprototypeof": "1.2.0",
+                "statuses": "2.0.1",
+                "toidentifier": "1.0.1"
+            },
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/http-parser-js": {
+            "version": "0.5.10",
+            "resolved": "https://registry.npmjs.org/http-parser-js/-/http-parser-js-0.5.10.tgz",
+            "integrity": "sha512-Pysuw9XpUq5dVc/2SMHpuTY01RFl8fttgcyunjL7eEMhGM3cI4eOmiCycJDVCo/7O7ClfQD3SaI6ftDzqOXYMA==",
+            "dev": true
+        },
+        "node_modules/http-proxy": {
+            "version": "1.18.1",
+            "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz",
+            "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==",
+            "dev": true,
+            "dependencies": {
+                "eventemitter3": "^4.0.0",
+                "follow-redirects": "^1.0.0",
+                "requires-port": "^1.0.0"
+            },
+            "engines": {
+                "node": ">=8.0.0"
+            }
+        },
+        "node_modules/http-proxy-middleware": {
+            "version": "2.0.9",
+            "resolved": "https://registry.npmjs.org/http-proxy-middleware/-/http-proxy-middleware-2.0.9.tgz",
+            "integrity": "sha512-c1IyJYLYppU574+YI7R4QyX2ystMtVXZwIdzazUIPIJsHuWNd+mho2j+bKoHftndicGj9yh+xjd+l0yj7VeT1Q==",
+            "dev": true,
+            "dependencies": {
+                "@types/http-proxy": "^1.17.8",
+                "http-proxy": "^1.18.1",
+                "is-glob": "^4.0.1",
+                "is-plain-obj": "^3.0.0",
+                "micromatch": "^4.0.2"
+            },
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "peerDependencies": {
+                "@types/express": "^4.17.13"
+            },
+            "peerDependenciesMeta": {
+                "@types/express": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/https-browserify": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/https-browserify/-/https-browserify-1.0.0.tgz",
+            "integrity": "sha512-J+FkSdyD+0mA0N+81tMotaRMfSL9SGi+xpD3T6YApKsc3bGSXJlfXri3VyFOeYkfLRQisDk1W+jIFFKBeUBbBg==",
+            "dev": true
+        },
+        "node_modules/human-signals": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
+            "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.17.0"
+            }
+        },
+        "node_modules/hydefront": {
+            "version": "3.4.1",
+            "resolved": "https://registry.npmjs.org/hydefront/-/hydefront-3.4.1.tgz",
+            "integrity": "sha512-CoLVeM0IfGxPLk8PVCKUN4v/SuvY8CIELOTQ1LE4IkvEHTKqgddOatuCbL8HQUMW6L/RcBEBZ766xSfoi3lkiA==",
+            "dev": true
+        },
+        "node_modules/iconv-lite": {
+            "version": "0.4.24",
+            "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+            "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+            "dev": true,
+            "dependencies": {
+                "safer-buffer": ">= 2.1.2 < 3"
+            },
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/icss-utils": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-5.1.0.tgz",
+            "integrity": "sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >= 14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/ieee754": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+            "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ]
+        },
+        "node_modules/ignore": {
+            "version": "5.3.2",
+            "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+            "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+            "dev": true,
+            "engines": {
+                "node": ">= 4"
+            }
+        },
+        "node_modules/imagemin": {
+            "version": "7.0.1",
+            "resolved": "https://registry.npmjs.org/imagemin/-/imagemin-7.0.1.tgz",
+            "integrity": "sha512-33AmZ+xjZhg2JMCe+vDf6a9mzWukE7l+wAtesjE7KyteqqKjzxv7aVQeWnul1Ve26mWvEQqyPwl0OctNBfSR9w==",
+            "dev": true,
+            "dependencies": {
+                "file-type": "^12.0.0",
+                "globby": "^10.0.0",
+                "graceful-fs": "^4.2.2",
+                "junk": "^3.1.0",
+                "make-dir": "^3.0.0",
+                "p-pipe": "^3.0.0",
+                "replace-ext": "^1.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/img-loader": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/img-loader/-/img-loader-4.0.0.tgz",
+            "integrity": "sha512-UwRcPQdwdOyEHyCxe1V9s9YFwInwEWCpoO+kJGfIqDrBDqA8jZUsEZTxQ0JteNPGw/Gupmwesk2OhLTcnw6tnQ==",
+            "dev": true,
+            "dependencies": {
+                "loader-utils": "^1.1.0"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "peerDependencies": {
+                "imagemin": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+            }
+        },
+        "node_modules/img-loader/node_modules/json5": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
+            "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
+            "dev": true,
+            "dependencies": {
+                "minimist": "^1.2.0"
+            },
+            "bin": {
+                "json5": "lib/cli.js"
+            }
+        },
+        "node_modules/img-loader/node_modules/loader-utils": {
+            "version": "1.4.2",
+            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
+            "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
+            "dev": true,
+            "dependencies": {
+                "big.js": "^5.2.2",
+                "emojis-list": "^3.0.0",
+                "json5": "^1.0.1"
+            },
+            "engines": {
+                "node": ">=4.0.0"
+            }
+        },
+        "node_modules/import-fresh": {
+            "version": "3.3.1",
+            "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",
+            "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",
+            "dev": true,
+            "dependencies": {
+                "parent-module": "^1.0.0",
+                "resolve-from": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/import-local": {
+            "version": "3.2.0",
+            "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.2.0.tgz",
+            "integrity": "sha512-2SPlun1JUPWoM6t3F0dw0FkCF/jWY8kttcY4f599GLTSjh2OCuuhdTkJQsEcZzBqbXZGKMK2OqW1oZsjtf/gQA==",
+            "dev": true,
+            "dependencies": {
+                "pkg-dir": "^4.2.0",
+                "resolve-cwd": "^3.0.0"
+            },
+            "bin": {
+                "import-local-fixture": "fixtures/cli.js"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/inflight": {
+            "version": "1.0.6",
+            "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+            "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+            "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+            "dev": true,
+            "dependencies": {
+                "once": "^1.3.0",
+                "wrappy": "1"
+            }
+        },
+        "node_modules/inherits": {
+            "version": "2.0.4",
+            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+            "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+            "dev": true
+        },
+        "node_modules/interpret": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/interpret/-/interpret-2.2.0.tgz",
+            "integrity": "sha512-Ju0Bz/cEia55xDwUWEa8+olFpCiQoypjnQySseKtmjNrnps3P+xfpUmGr90T7yjlVJmOtybRvPXhKMbHr+fWnw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/ipaddr.js": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.2.0.tgz",
+            "integrity": "sha512-Ag3wB2o37wslZS19hZqorUnrnzSkpOVy+IiiDEiTqNubEYpYuHWIf6K4psgN2ZWKExS4xhVCrRVfb/wfW8fWJA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/is-arrayish": {
+            "version": "0.2.1",
+            "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
+            "integrity": "sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg==",
+            "dev": true
+        },
+        "node_modules/is-binary-path": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
+            "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
+            "dev": true,
+            "dependencies": {
+                "binary-extensions": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/is-buffer": {
+            "version": "1.1.6",
+            "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
+            "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
+            "dev": true
+        },
+        "node_modules/is-core-module": {
+            "version": "2.16.1",
+            "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz",
+            "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==",
+            "dev": true,
+            "dependencies": {
+                "hasown": "^2.0.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/is-docker": {
+            "version": "2.2.1",
+            "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+            "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+            "dev": true,
+            "bin": {
+                "is-docker": "cli.js"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/is-extglob": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+            "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/is-fullwidth-code-point": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+            "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/is-glob": {
+            "version": "4.0.3",
+            "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+            "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+            "dev": true,
+            "dependencies": {
+                "is-extglob": "^2.1.1"
+            },
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/is-number": {
+            "version": "7.0.0",
+            "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+            "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.12.0"
+            }
+        },
+        "node_modules/is-plain-obj": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-3.0.0.tgz",
+            "integrity": "sha512-gwsOE28k+23GP1B6vFl1oVh/WOzmawBrKwo5Ev6wMKzPkaXaCDIQKzLnvsA42DRlbVTWorkgTKIviAKCWkfUwA==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/is-plain-object": {
+            "version": "2.0.4",
+            "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz",
+            "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==",
+            "dev": true,
+            "dependencies": {
+                "isobject": "^3.0.1"
+            },
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/is-stream": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+            "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/is-wsl": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+            "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+            "dev": true,
+            "dependencies": {
+                "is-docker": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/isarray": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+            "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+            "dev": true
+        },
+        "node_modules/isexe": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+            "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+            "dev": true
+        },
+        "node_modules/isobject": {
+            "version": "3.0.1",
+            "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz",
+            "integrity": "sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/jackspeak": {
+            "version": "3.4.3",
+            "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+            "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+            "dev": true,
+            "dependencies": {
+                "@isaacs/cliui": "^8.0.2"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            },
+            "optionalDependencies": {
+                "@pkgjs/parseargs": "^0.11.0"
+            }
+        },
+        "node_modules/jest-worker": {
+            "version": "27.5.1",
+            "resolved": "https://registry.npmjs.org/jest-worker/-/jest-worker-27.5.1.tgz",
+            "integrity": "sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg==",
+            "dev": true,
+            "dependencies": {
+                "@types/node": "*",
+                "merge-stream": "^2.0.0",
+                "supports-color": "^8.0.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            }
+        },
+        "node_modules/jest-worker/node_modules/supports-color": {
+            "version": "8.1.1",
+            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
+            "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
+            "dev": true,
+            "dependencies": {
+                "has-flag": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/supports-color?sponsor=1"
+            }
+        },
+        "node_modules/jiti": {
+            "version": "1.21.7",
+            "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz",
+            "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
+            "dev": true,
+            "bin": {
+                "jiti": "bin/jiti.js"
+            }
+        },
+        "node_modules/js-tokens": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
+            "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==",
+            "dev": true
+        },
+        "node_modules/jsesc": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
+            "integrity": "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA==",
+            "dev": true,
+            "bin": {
+                "jsesc": "bin/jsesc"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/json-parse-even-better-errors": {
+            "version": "2.3.1",
+            "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz",
+            "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==",
+            "dev": true
+        },
+        "node_modules/json-schema-traverse": {
+            "version": "0.4.1",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+            "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+            "dev": true
+        },
+        "node_modules/json5": {
+            "version": "2.2.3",
+            "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+            "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+            "dev": true,
+            "bin": {
+                "json5": "lib/cli.js"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/jsonfile": {
+            "version": "6.1.0",
+            "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz",
+            "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==",
+            "dev": true,
+            "dependencies": {
+                "universalify": "^2.0.0"
+            },
+            "optionalDependencies": {
+                "graceful-fs": "^4.1.6"
+            }
+        },
+        "node_modules/junk": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/junk/-/junk-3.1.0.tgz",
+            "integrity": "sha512-pBxcB3LFc8QVgdggvZWyeys+hnrNWg4OcZIU/1X59k5jQdLBlCsYGRQaz234SqoRLTCgMH00fY0xRJH+F9METQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/kind-of": {
+            "version": "6.0.3",
+            "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+            "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/klona": {
+            "version": "2.0.6",
+            "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.6.tgz",
+            "integrity": "sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/laravel-mix": {
+            "version": "6.0.49",
+            "resolved": "https://registry.npmjs.org/laravel-mix/-/laravel-mix-6.0.49.tgz",
+            "integrity": "sha512-bBMFpFjp26XfijPvY5y9zGKud7VqlyOE0OWUcPo3vTBY5asw8LTjafAbee1dhfLz6PWNqDziz69CP78ELSpfKw==",
+            "dev": true,
+            "dependencies": {
+                "@babel/core": "^7.15.8",
+                "@babel/plugin-proposal-object-rest-spread": "^7.15.6",
+                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+                "@babel/plugin-transform-runtime": "^7.15.8",
+                "@babel/preset-env": "^7.15.8",
+                "@babel/runtime": "^7.15.4",
+                "@types/babel__core": "^7.1.16",
+                "@types/clean-css": "^4.2.5",
+                "@types/imagemin-gifsicle": "^7.0.1",
+                "@types/imagemin-mozjpeg": "^8.0.1",
+                "@types/imagemin-optipng": "^5.2.1",
+                "@types/imagemin-svgo": "^8.0.0",
+                "autoprefixer": "^10.4.0",
+                "babel-loader": "^8.2.3",
+                "chalk": "^4.1.2",
+                "chokidar": "^3.5.2",
+                "clean-css": "^5.2.4",
+                "cli-table3": "^0.6.0",
+                "collect.js": "^4.28.5",
+                "commander": "^7.2.0",
+                "concat": "^1.0.3",
+                "css-loader": "^5.2.6",
+                "cssnano": "^5.0.8",
+                "dotenv": "^10.0.0",
+                "dotenv-expand": "^5.1.0",
+                "file-loader": "^6.2.0",
+                "fs-extra": "^10.0.0",
+                "glob": "^7.2.0",
+                "html-loader": "^1.3.2",
+                "imagemin": "^7.0.1",
+                "img-loader": "^4.0.0",
+                "lodash": "^4.17.21",
+                "md5": "^2.3.0",
+                "mini-css-extract-plugin": "^1.6.2",
+                "node-libs-browser": "^2.2.1",
+                "postcss-load-config": "^3.1.0",
+                "postcss-loader": "^6.2.0",
+                "semver": "^7.3.5",
+                "strip-ansi": "^6.0.0",
+                "style-loader": "^2.0.0",
+                "terser": "^5.9.0",
+                "terser-webpack-plugin": "^5.2.4",
+                "vue-style-loader": "^4.1.3",
+                "webpack": "^5.60.0",
+                "webpack-cli": "^4.9.1",
+                "webpack-dev-server": "^4.7.3",
+                "webpack-merge": "^5.8.0",
+                "webpack-notifier": "^1.14.1",
+                "webpackbar": "^5.0.0-3",
+                "yargs": "^17.2.1"
+            },
+            "bin": {
+                "laravel-mix": "bin/cli.js",
+                "mix": "bin/cli.js"
+            },
+            "engines": {
+                "node": ">=12.14.0"
+            },
+            "peerDependencies": {
+                "@babel/core": "^7.15.8",
+                "@babel/plugin-proposal-object-rest-spread": "^7.15.6",
+                "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+                "@babel/plugin-transform-runtime": "^7.15.8",
+                "@babel/preset-env": "^7.15.8",
+                "postcss": "^8.3.11",
+                "webpack": "^5.60.0",
+                "webpack-cli": "^4.9.1"
+            }
+        },
+        "node_modules/launch-editor": {
+            "version": "2.10.0",
+            "resolved": "https://registry.npmjs.org/launch-editor/-/launch-editor-2.10.0.tgz",
+            "integrity": "sha512-D7dBRJo/qcGX9xlvt/6wUYzQxjh5G1RvZPgPv8vi4KRU99DVQL/oW7tnVOCCTm2HGeo3C5HvGE5Yrh6UBoZ0vA==",
+            "dev": true,
+            "dependencies": {
+                "picocolors": "^1.0.0",
+                "shell-quote": "^1.8.1"
+            }
+        },
+        "node_modules/lilconfig": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-2.1.0.tgz",
+            "integrity": "sha512-utWOt/GHzuUxnLKxB6dk81RoOeoNeHgbrXiuGk4yyF5qlRz+iIVWu56E2fqGHFrXz0QNUhLB/8nKqvRH66JKGQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/lines-and-columns": {
+            "version": "1.2.4",
+            "resolved": "https://registry.npmjs.org/lines-and-columns/-/lines-and-columns-1.2.4.tgz",
+            "integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
+            "dev": true
+        },
+        "node_modules/loader-runner": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.0.tgz",
+            "integrity": "sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6.11.5"
+            }
+        },
+        "node_modules/loader-utils": {
+            "version": "2.0.4",
+            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.4.tgz",
+            "integrity": "sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw==",
+            "dev": true,
+            "dependencies": {
+                "big.js": "^5.2.2",
+                "emojis-list": "^3.0.0",
+                "json5": "^2.1.2"
+            },
+            "engines": {
+                "node": ">=8.9.0"
+            }
+        },
+        "node_modules/locate-path": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+            "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
+            "dev": true,
+            "dependencies": {
+                "p-locate": "^4.1.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/lodash": {
+            "version": "4.17.21",
+            "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+            "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+            "dev": true
+        },
+        "node_modules/lodash.castarray": {
+            "version": "4.4.0",
+            "resolved": "https://registry.npmjs.org/lodash.castarray/-/lodash.castarray-4.4.0.tgz",
+            "integrity": "sha512-aVx8ztPv7/2ULbArGJ2Y42bG1mEQ5mGjpdvrbJcJFU3TbYybe+QlLS4pst9zV52ymy2in1KpFPiZnAOATxD4+Q==",
+            "dev": true
+        },
+        "node_modules/lodash.debounce": {
+            "version": "4.0.8",
+            "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
+            "integrity": "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow==",
+            "dev": true
+        },
+        "node_modules/lodash.isplainobject": {
+            "version": "4.0.6",
+            "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
+            "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
+            "dev": true
+        },
+        "node_modules/lodash.memoize": {
+            "version": "4.1.2",
+            "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
+            "integrity": "sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag==",
+            "dev": true
+        },
+        "node_modules/lodash.merge": {
+            "version": "4.6.2",
+            "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz",
+            "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==",
+            "dev": true
+        },
+        "node_modules/lodash.uniq": {
+            "version": "4.5.0",
+            "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz",
+            "integrity": "sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ==",
+            "dev": true
+        },
+        "node_modules/lower-case": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/lower-case/-/lower-case-2.0.2.tgz",
+            "integrity": "sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg==",
+            "dev": true,
+            "dependencies": {
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/lru-cache": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-5.1.1.tgz",
+            "integrity": "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==",
+            "dev": true,
+            "dependencies": {
+                "yallist": "^3.0.2"
+            }
+        },
+        "node_modules/make-dir": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz",
+            "integrity": "sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw==",
+            "dev": true,
+            "dependencies": {
+                "semver": "^6.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/make-dir/node_modules/semver": {
+            "version": "6.3.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+            "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            }
+        },
+        "node_modules/math-intrinsics": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+            "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/md5": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/md5/-/md5-2.3.0.tgz",
+            "integrity": "sha512-T1GITYmFaKuO91vxyoQMFETst+O71VUPEU3ze5GNzDm0OWdP8v1ziTaAEPUr/3kLsY3Sftgz242A1SetQiDL7g==",
+            "dev": true,
+            "dependencies": {
+                "charenc": "0.0.2",
+                "crypt": "0.0.2",
+                "is-buffer": "~1.1.6"
+            }
+        },
+        "node_modules/md5.js": {
+            "version": "1.3.5",
+            "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.5.tgz",
+            "integrity": "sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==",
+            "dev": true,
+            "dependencies": {
+                "hash-base": "^3.0.0",
+                "inherits": "^2.0.1",
+                "safe-buffer": "^5.1.2"
+            }
+        },
+        "node_modules/mdn-data": {
+            "version": "2.0.14",
+            "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.14.tgz",
+            "integrity": "sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow==",
+            "dev": true
+        },
+        "node_modules/media-typer": {
+            "version": "0.3.0",
+            "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+            "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/memfs": {
+            "version": "3.5.3",
+            "resolved": "https://registry.npmjs.org/memfs/-/memfs-3.5.3.tgz",
+            "integrity": "sha512-UERzLsxzllchadvbPs5aolHh65ISpKpM+ccLbOJ8/vvpBKmAWf+la7dXFy7Mr0ySHbdHrFv5kGFCUHHe6GFEmw==",
+            "dev": true,
+            "dependencies": {
+                "fs-monkey": "^1.0.4"
+            },
+            "engines": {
+                "node": ">= 4.0.0"
+            }
+        },
+        "node_modules/merge-descriptors": {
+            "version": "1.0.3",
+            "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+            "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
+            "dev": true,
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/merge-stream": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
+            "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
+            "dev": true
+        },
+        "node_modules/merge2": {
+            "version": "1.4.1",
+            "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+            "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/methods": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
+            "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/micromatch": {
+            "version": "4.0.8",
+            "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+            "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+            "dev": true,
+            "dependencies": {
+                "braces": "^3.0.3",
+                "picomatch": "^2.3.1"
+            },
+            "engines": {
+                "node": ">=8.6"
+            }
+        },
+        "node_modules/miller-rabin": {
+            "version": "4.0.1",
+            "resolved": "https://registry.npmjs.org/miller-rabin/-/miller-rabin-4.0.1.tgz",
+            "integrity": "sha512-115fLhvZVqWwHPbClyntxEVfVDfl9DLLTuJvq3g2O/Oxi8AiNouAHvDSzHS0viUJc+V5vm3eq91Xwqn9dp4jRA==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.0.0",
+                "brorand": "^1.0.1"
+            },
+            "bin": {
+                "miller-rabin": "bin/miller-rabin"
+            }
+        },
+        "node_modules/miller-rabin/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/mime": {
+            "version": "1.6.0",
+            "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+            "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
+            "dev": true,
+            "bin": {
+                "mime": "cli.js"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/mime-db": {
+            "version": "1.52.0",
+            "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+            "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/mime-types": {
+            "version": "2.1.35",
+            "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+            "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+            "dev": true,
+            "dependencies": {
+                "mime-db": "1.52.0"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/mimic-fn": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
+            "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/mini-css-extract-plugin": {
+            "version": "1.6.2",
+            "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-1.6.2.tgz",
+            "integrity": "sha512-WhDvO3SjGm40oV5y26GjMJYjd2UMqrLAGKy5YS2/3QKJy2F7jgynuHTir/tgUUOiNQu5saXHdc8reo7YuhhT4Q==",
+            "dev": true,
+            "dependencies": {
+                "loader-utils": "^2.0.0",
+                "schema-utils": "^3.0.0",
+                "webpack-sources": "^1.1.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.4.0 || ^5.0.0"
+            }
+        },
+        "node_modules/mini-css-extract-plugin/node_modules/schema-utils": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
+            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.8",
+                "ajv": "^6.12.5",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/minimalistic-assert": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
+            "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
+            "dev": true
+        },
+        "node_modules/minimalistic-crypto-utils": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
+            "integrity": "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==",
+            "dev": true
+        },
+        "node_modules/minimatch": {
+            "version": "3.1.2",
+            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+            "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+            "dev": true,
+            "dependencies": {
+                "brace-expansion": "^1.1.7"
+            },
+            "engines": {
+                "node": "*"
+            }
+        },
+        "node_modules/minimist": {
+            "version": "1.2.8",
+            "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+            "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+            "dev": true,
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/minipass": {
+            "version": "7.1.2",
+            "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz",
+            "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==",
+            "dev": true,
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
+            }
+        },
+        "node_modules/ms": {
+            "version": "2.1.3",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+            "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+            "dev": true
+        },
+        "node_modules/multicast-dns": {
+            "version": "7.2.5",
+            "resolved": "https://registry.npmjs.org/multicast-dns/-/multicast-dns-7.2.5.tgz",
+            "integrity": "sha512-2eznPJP8z2BFLX50tf0LuODrpINqP1RVIm/CObbTcBRITQgmC/TjcREF1NeTBzIcR5XO/ukWo+YHOjBbFwIupg==",
+            "dev": true,
+            "dependencies": {
+                "dns-packet": "^5.2.2",
+                "thunky": "^1.0.2"
+            },
+            "bin": {
+                "multicast-dns": "cli.js"
+            }
+        },
+        "node_modules/mz": {
+            "version": "2.7.0",
+            "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
+            "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==",
+            "dev": true,
+            "dependencies": {
+                "any-promise": "^1.0.0",
+                "object-assign": "^4.0.1",
+                "thenify-all": "^1.0.0"
+            }
+        },
+        "node_modules/nanoid": {
+            "version": "3.3.11",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+            "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "bin": {
+                "nanoid": "bin/nanoid.cjs"
+            },
+            "engines": {
+                "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+            }
+        },
+        "node_modules/negotiator": {
+            "version": "0.6.4",
+            "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.4.tgz",
+            "integrity": "sha512-myRT3DiWPHqho5PrJaIRyaMv2kgYf0mUVgBNOYMuCH5Ki1yEiQaf/ZJuQ62nvpc44wL5WDbTX7yGJi1Neevw8w==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/neo-async": {
+            "version": "2.6.2",
+            "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
+            "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
+            "dev": true
+        },
+        "node_modules/no-case": {
+            "version": "3.0.4",
+            "resolved": "https://registry.npmjs.org/no-case/-/no-case-3.0.4.tgz",
+            "integrity": "sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg==",
+            "dev": true,
+            "dependencies": {
+                "lower-case": "^2.0.2",
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/node-forge": {
+            "version": "1.3.1",
+            "resolved": "https://registry.npmjs.org/node-forge/-/node-forge-1.3.1.tgz",
+            "integrity": "sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6.13.0"
+            }
+        },
+        "node_modules/node-libs-browser": {
+            "version": "2.2.1",
+            "resolved": "https://registry.npmjs.org/node-libs-browser/-/node-libs-browser-2.2.1.tgz",
+            "integrity": "sha512-h/zcD8H9kaDZ9ALUWwlBUDo6TKF8a7qBSCSEGfjTVIYeqsioSKaAX+BN7NgiMGp6iSIXZ3PxgCu8KS3b71YK5Q==",
+            "dev": true,
+            "dependencies": {
+                "assert": "^1.1.1",
+                "browserify-zlib": "^0.2.0",
+                "buffer": "^4.3.0",
+                "console-browserify": "^1.1.0",
+                "constants-browserify": "^1.0.0",
+                "crypto-browserify": "^3.11.0",
+                "domain-browser": "^1.1.1",
+                "events": "^3.0.0",
+                "https-browserify": "^1.0.0",
+                "os-browserify": "^0.3.0",
+                "path-browserify": "0.0.1",
+                "process": "^0.11.10",
+                "punycode": "^1.2.4",
+                "querystring-es3": "^0.2.0",
+                "readable-stream": "^2.3.3",
+                "stream-browserify": "^2.0.1",
+                "stream-http": "^2.7.2",
+                "string_decoder": "^1.0.0",
+                "timers-browserify": "^2.0.4",
+                "tty-browserify": "0.0.0",
+                "url": "^0.11.0",
+                "util": "^0.11.0",
+                "vm-browserify": "^1.0.1"
+            }
+        },
+        "node_modules/node-notifier": {
+            "version": "9.0.1",
+            "resolved": "https://registry.npmjs.org/node-notifier/-/node-notifier-9.0.1.tgz",
+            "integrity": "sha512-fPNFIp2hF/Dq7qLDzSg4vZ0J4e9v60gJR+Qx7RbjbWqzPDdEqeVpEx5CFeDAELIl+A/woaaNn1fQ5nEVerMxJg==",
+            "dev": true,
+            "dependencies": {
+                "growly": "^1.3.0",
+                "is-wsl": "^2.2.0",
+                "semver": "^7.3.2",
+                "shellwords": "^0.1.1",
+                "uuid": "^8.3.0",
+                "which": "^2.0.2"
+            }
+        },
+        "node_modules/node-releases": {
+            "version": "2.0.19",
+            "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.19.tgz",
+            "integrity": "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw==",
+            "dev": true
+        },
+        "node_modules/normalize-path": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+            "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/normalize-range": {
+            "version": "0.1.2",
+            "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",
+            "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/normalize-url": {
+            "version": "6.1.0",
+            "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
+            "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/npm-run-path": {
+            "version": "4.0.1",
+            "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
+            "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
+            "dev": true,
+            "dependencies": {
+                "path-key": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/nth-check": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
+            "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
+            "dev": true,
+            "dependencies": {
+                "boolbase": "^1.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/fb55/nth-check?sponsor=1"
+            }
+        },
+        "node_modules/object-assign": {
+            "version": "4.1.1",
+            "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+            "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/object-hash": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz",
+            "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/object-inspect": {
+            "version": "1.13.4",
+            "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+            "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/object-keys": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",
+            "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/object.assign": {
+            "version": "4.1.7",
+            "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.7.tgz",
+            "integrity": "sha512-nK28WOo+QIjBkDduTINE4JkF/UJJKyf2EJxvJKfblDpyg0Q+pkOHNTL0Qwy6NP6FhE/EnzV73BxxqcJaXY9anw==",
+            "dev": true,
+            "dependencies": {
+                "call-bind": "^1.0.8",
+                "call-bound": "^1.0.3",
+                "define-properties": "^1.2.1",
+                "es-object-atoms": "^1.0.0",
+                "has-symbols": "^1.1.0",
+                "object-keys": "^1.1.1"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/obuf": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/obuf/-/obuf-1.1.2.tgz",
+            "integrity": "sha512-PX1wu0AmAdPqOL1mWhqmlOd8kOIZQwGZw6rh7uby9fTc5lhaOWFLX3I6R1hrF9k3zUY40e6igsLGkDXK92LJNg==",
+            "dev": true
+        },
+        "node_modules/on-finished": {
+            "version": "2.4.1",
+            "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+            "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+            "dev": true,
+            "dependencies": {
+                "ee-first": "1.1.1"
+            },
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/on-headers": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.0.2.tgz",
+            "integrity": "sha512-pZAE+FJLoyITytdqK0U5s+FIpjN0JP3OzFi/u8Rx+EV5/W+JTWGXG8xFzevE7AjBfDqHv/8vL8qQsIhHnqRkrA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/once": {
+            "version": "1.4.0",
+            "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+            "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+            "dev": true,
+            "dependencies": {
+                "wrappy": "1"
+            }
+        },
+        "node_modules/onetime": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
+            "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
+            "dev": true,
+            "dependencies": {
+                "mimic-fn": "^2.1.0"
+            },
+            "engines": {
+                "node": ">=6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/open": {
+            "version": "8.4.2",
+            "resolved": "https://registry.npmjs.org/open/-/open-8.4.2.tgz",
+            "integrity": "sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ==",
+            "dev": true,
+            "dependencies": {
+                "define-lazy-prop": "^2.0.0",
+                "is-docker": "^2.1.1",
+                "is-wsl": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/os-browserify": {
+            "version": "0.3.0",
+            "resolved": "https://registry.npmjs.org/os-browserify/-/os-browserify-0.3.0.tgz",
+            "integrity": "sha512-gjcpUc3clBf9+210TRaDWbf+rZZZEshZ+DlXMRCeAjp0xhTrnQsKHypIy1J3d5hKdUzj69t708EHtU8P6bUn0A==",
+            "dev": true
+        },
+        "node_modules/p-limit": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+            "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+            "dev": true,
+            "dependencies": {
+                "p-try": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/p-locate": {
+            "version": "4.1.0",
+            "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+            "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+            "dev": true,
+            "dependencies": {
+                "p-limit": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/p-pipe": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/p-pipe/-/p-pipe-3.1.0.tgz",
+            "integrity": "sha512-08pj8ATpzMR0Y80x50yJHn37NF6vjrqHutASaX5LiH5npS9XPvrUmscd9MF5R4fuYRHOxQR1FfMIlF7AzwoPqw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/p-retry": {
+            "version": "4.6.2",
+            "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",
+            "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/retry": "0.12.0",
+                "retry": "^0.13.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/p-try": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+            "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/package-json-from-dist": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+            "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+            "dev": true
+        },
+        "node_modules/pako": {
+            "version": "1.0.11",
+            "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz",
+            "integrity": "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==",
+            "dev": true
+        },
+        "node_modules/param-case": {
+            "version": "3.0.4",
+            "resolved": "https://registry.npmjs.org/param-case/-/param-case-3.0.4.tgz",
+            "integrity": "sha512-RXlj7zCYokReqWpOPH9oYivUzLYZ5vAPIfEmCTNViosC78F8F0H9y7T7gG2M39ymgutxF5gcFEsyZQSph9Bp3A==",
+            "dev": true,
+            "dependencies": {
+                "dot-case": "^3.0.4",
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/parent-module": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz",
+            "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==",
+            "dev": true,
+            "dependencies": {
+                "callsites": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/parse-asn1": {
+            "version": "5.1.7",
+            "resolved": "https://registry.npmjs.org/parse-asn1/-/parse-asn1-5.1.7.tgz",
+            "integrity": "sha512-CTM5kuWR3sx9IFamcl5ErfPl6ea/N8IYwiJ+vpeB2g+1iknv7zBl5uPwbMbRVznRVbrNY6lGuDoE5b30grmbqg==",
+            "dev": true,
+            "dependencies": {
+                "asn1.js": "^4.10.1",
+                "browserify-aes": "^1.2.0",
+                "evp_bytestokey": "^1.0.3",
+                "hash-base": "~3.0",
+                "pbkdf2": "^3.1.2",
+                "safe-buffer": "^5.2.1"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/parse-json": {
+            "version": "5.2.0",
+            "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-5.2.0.tgz",
+            "integrity": "sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/code-frame": "^7.0.0",
+                "error-ex": "^1.3.1",
+                "json-parse-even-better-errors": "^2.3.0",
+                "lines-and-columns": "^1.1.6"
+            },
+            "engines": {
+                "node": ">=8"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/sindresorhus"
+            }
+        },
+        "node_modules/parseurl": {
+            "version": "1.3.3",
+            "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+            "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/pascal-case": {
+            "version": "3.1.2",
+            "resolved": "https://registry.npmjs.org/pascal-case/-/pascal-case-3.1.2.tgz",
+            "integrity": "sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g==",
+            "dev": true,
+            "dependencies": {
+                "no-case": "^3.0.4",
+                "tslib": "^2.0.3"
+            }
+        },
+        "node_modules/path-browserify": {
+            "version": "0.0.1",
+            "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-0.0.1.tgz",
+            "integrity": "sha512-BapA40NHICOS+USX9SN4tyhq+A2RrN/Ws5F0Z5aMHDp98Fl86lX8Oti8B7uN93L4Ifv4fHOEA+pQw87gmMO/lQ==",
+            "dev": true
+        },
+        "node_modules/path-exists": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+            "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/path-is-absolute": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+            "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/path-key": {
+            "version": "3.1.1",
+            "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+            "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/path-parse": {
+            "version": "1.0.7",
+            "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+            "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+            "dev": true
+        },
+        "node_modules/path-scurry": {
+            "version": "1.11.1",
+            "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+            "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+            "dev": true,
+            "dependencies": {
+                "lru-cache": "^10.2.0",
+                "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+            },
+            "engines": {
+                "node": ">=16 || 14 >=14.18"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/path-scurry/node_modules/lru-cache": {
+            "version": "10.4.3",
+            "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+            "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+            "dev": true
+        },
+        "node_modules/path-to-regexp": {
+            "version": "0.1.12",
+            "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz",
+            "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==",
+            "dev": true
+        },
+        "node_modules/path-type": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
+            "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/pbkdf2": {
+            "version": "3.1.2",
+            "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.1.2.tgz",
+            "integrity": "sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==",
+            "dev": true,
+            "dependencies": {
+                "create-hash": "^1.1.2",
+                "create-hmac": "^1.1.4",
+                "ripemd160": "^2.0.1",
+                "safe-buffer": "^5.0.1",
+                "sha.js": "^2.4.8"
+            },
+            "engines": {
+                "node": ">=0.12"
+            }
+        },
+        "node_modules/picocolors": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+            "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+            "dev": true
+        },
+        "node_modules/picomatch": {
+            "version": "2.3.1",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+            "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+            "dev": true,
+            "engines": {
+                "node": ">=8.6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/jonschlinkert"
+            }
+        },
+        "node_modules/pify": {
+            "version": "2.3.0",
+            "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
+            "integrity": "sha512-udgsAY+fTnvv7kI7aaxbqwWNb0AHiB0qBO89PZKPkoTmGOgdbrHDKD+0B2X4uTfJ/FT1R09r9gTsjUjNJotuog==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/pirates": {
+            "version": "4.0.7",
+            "resolved": "https://registry.npmjs.org/pirates/-/pirates-4.0.7.tgz",
+            "integrity": "sha512-TfySrs/5nm8fQJDcBDuUng3VOUKsd7S+zqvbOTiGXHfxX4wK31ard+hoNuvkicM/2YFzlpDgABOevKSsB4G/FA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/pkg-dir": {
+            "version": "4.2.0",
+            "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-4.2.0.tgz",
+            "integrity": "sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ==",
+            "dev": true,
+            "dependencies": {
+                "find-up": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/postcss": {
+            "version": "8.5.3",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.3.tgz",
+            "integrity": "sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/postcss"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "nanoid": "^3.3.8",
+                "picocolors": "^1.1.1",
+                "source-map-js": "^1.2.1"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14"
+            }
+        },
+        "node_modules/postcss-calc": {
+            "version": "8.2.4",
+            "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-8.2.4.tgz",
+            "integrity": "sha512-SmWMSJmB8MRnnULldx0lQIyhSNvuDl9HfrZkaqqE/WHAhToYsAvDq+yAsA/kIyINDszOp3Rh0GFoNuH5Ypsm3Q==",
+            "dev": true,
+            "dependencies": {
+                "postcss-selector-parser": "^6.0.9",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.2"
+            }
+        },
+        "node_modules/postcss-colormin": {
+            "version": "5.3.1",
+            "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-5.3.1.tgz",
+            "integrity": "sha512-UsWQG0AqTFQmpBegeLLc1+c3jIqBNB0zlDGRWR+dQ3pRKJL1oeMzyqmH3o2PIfn9MBdNrVPWhDbT769LxCTLJQ==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "caniuse-api": "^3.0.0",
+                "colord": "^2.9.1",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-convert-values": {
+            "version": "5.1.3",
+            "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-5.1.3.tgz",
+            "integrity": "sha512-82pC1xkJZtcJEfiLw6UXnXVXScgtBrjlO5CBmuDQc+dlb88ZYheFsjTn40+zBVi3DkfF7iezO0nJUPLcJK3pvA==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-discard-comments": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-5.1.2.tgz",
+            "integrity": "sha512-+L8208OVbHVF2UQf1iDmRcbdjJkuBF6IS29yBDSiWUIzpYaAhtNl6JYnYm12FnkeCwQqF5LeklOu6rAqgfBZqQ==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-discard-duplicates": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-5.1.0.tgz",
+            "integrity": "sha512-zmX3IoSI2aoenxHV6C7plngHWWhUOV3sP1T8y2ifzxzbtnuhk1EdPwm0S1bIUNaJ2eNbWeGLEwzw8huPD67aQw==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-discard-empty": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-5.1.1.tgz",
+            "integrity": "sha512-zPz4WljiSuLWsI0ir4Mcnr4qQQ5e1Ukc3i7UfE2XcrwKK2LIPIqE5jxMRxO6GbI3cv//ztXDsXwEWT3BHOGh3A==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-discard-overridden": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-5.1.0.tgz",
+            "integrity": "sha512-21nOL7RqWR1kasIVdKs8HNqQJhFxLsyRfAnUDm4Fe4t4mCWL9OJiHvlHPjcd8zc5Myu89b/7wZDnOSjFgeWRtw==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-import": {
+            "version": "15.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-import/-/postcss-import-15.1.0.tgz",
+            "integrity": "sha512-hpr+J05B2FVYUAXHeK1YyI267J/dDDhMU6B6civm8hSY1jYJnBXxzKDKDswzJmtLHryrjhnDjqqp/49t8FALew==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.0.0",
+                "read-cache": "^1.0.0",
+                "resolve": "^1.1.7"
+            },
+            "engines": {
+                "node": ">=14.0.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.0.0"
+            }
+        },
+        "node_modules/postcss-js": {
+            "version": "4.0.1",
+            "resolved": "https://registry.npmjs.org/postcss-js/-/postcss-js-4.0.1.tgz",
+            "integrity": "sha512-dDLF8pEO191hJMtlHFPRa8xsizHaM82MLfNkUHdUtVEV3tgTp5oj+8qbEqYM57SLfc74KSbw//4SeJma2LRVIw==",
+            "dev": true,
+            "dependencies": {
+                "camelcase-css": "^2.0.1"
+            },
+            "engines": {
+                "node": "^12 || ^14 || >= 16"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/postcss/"
+            },
+            "peerDependencies": {
+                "postcss": "^8.4.21"
+            }
+        },
+        "node_modules/postcss-load-config": {
+            "version": "3.1.4",
+            "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-3.1.4.tgz",
+            "integrity": "sha512-6DiM4E7v4coTE4uzA8U//WhtPwyhiim3eyjEMFCnUpzbrkK9wJHgKDT2mR+HbtSrd/NubVaYTOpSpjUl8NQeRg==",
+            "dev": true,
+            "dependencies": {
+                "lilconfig": "^2.0.5",
+                "yaml": "^1.10.2"
+            },
+            "engines": {
+                "node": ">= 10"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/postcss/"
+            },
+            "peerDependencies": {
+                "postcss": ">=8.0.9",
+                "ts-node": ">=9.0.0"
+            },
+            "peerDependenciesMeta": {
+                "postcss": {
+                    "optional": true
+                },
+                "ts-node": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/postcss-loader": {
+            "version": "6.2.1",
+            "resolved": "https://registry.npmjs.org/postcss-loader/-/postcss-loader-6.2.1.tgz",
+            "integrity": "sha512-WbbYpmAaKcux/P66bZ40bpWsBucjx/TTgVVzRZ9yUO8yQfVBlameJ0ZGVaPfH64hNSBh63a+ICP5nqOpBA0w+Q==",
+            "dev": true,
+            "dependencies": {
+                "cosmiconfig": "^7.0.0",
+                "klona": "^2.0.5",
+                "semver": "^7.3.5"
+            },
+            "engines": {
+                "node": ">= 12.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "postcss": "^7.0.0 || ^8.0.1",
+                "webpack": "^5.0.0"
+            }
+        },
+        "node_modules/postcss-merge-longhand": {
+            "version": "5.1.7",
+            "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-5.1.7.tgz",
+            "integrity": "sha512-YCI9gZB+PLNskrK0BB3/2OzPnGhPkBEwmwhfYk1ilBHYVAZB7/tkTHFBAnCrvBBOmeYyMYw3DMjT55SyxMBzjQ==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0",
+                "stylehacks": "^5.1.1"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-merge-rules": {
+            "version": "5.1.4",
+            "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-5.1.4.tgz",
+            "integrity": "sha512-0R2IuYpgU93y9lhVbO/OylTtKMVcHb67zjWIfCiKR9rWL3GUk1677LAqD/BcHizukdZEjT8Ru3oHRoAYoJy44g==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "caniuse-api": "^3.0.0",
+                "cssnano-utils": "^3.1.0",
+                "postcss-selector-parser": "^6.0.5"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-minify-font-values": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-5.1.0.tgz",
+            "integrity": "sha512-el3mYTgx13ZAPPirSVsHqFzl+BBBDrXvbySvPGFnQcTI4iNslrPaFq4muTkLZmKlGk4gyFAYUBMH30+HurREyA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-minify-gradients": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-5.1.1.tgz",
+            "integrity": "sha512-VGvXMTpCEo4qHTNSa9A0a3D+dxGFZCYwR6Jokk+/3oB6flu2/PnPXAh2x7x52EkY5xlIHLm+Le8tJxe/7TNhzw==",
+            "dev": true,
+            "dependencies": {
+                "colord": "^2.9.1",
+                "cssnano-utils": "^3.1.0",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-minify-params": {
+            "version": "5.1.4",
+            "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-5.1.4.tgz",
+            "integrity": "sha512-+mePA3MgdmVmv6g+30rn57USjOGSAyuxUmkfiWpzalZ8aiBkdPYjXWtHuwJGm1v5Ojy0Z0LaSYhHaLJQB0P8Jw==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "cssnano-utils": "^3.1.0",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-minify-selectors": {
+            "version": "5.2.1",
+            "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-5.2.1.tgz",
+            "integrity": "sha512-nPJu7OjZJTsVUmPdm2TcaiohIwxP+v8ha9NehQ2ye9szv4orirRU3SDdtUmKH+10nzn0bAyOXZ0UEr7OpvLehg==",
+            "dev": true,
+            "dependencies": {
+                "postcss-selector-parser": "^6.0.5"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-modules-extract-imports": {
+            "version": "3.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.1.0.tgz",
+            "integrity": "sha512-k3kNe0aNFQDAZGbin48pL2VNidTF0w4/eASDsxlyspobzU3wZQLOGj7L9gfRe0Jo9/4uud09DsjFNH7winGv8Q==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >= 14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/postcss-modules-local-by-default": {
+            "version": "4.2.0",
+            "resolved": "https://registry.npmjs.org/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.2.0.tgz",
+            "integrity": "sha512-5kcJm/zk+GJDSfw+V/42fJ5fhjL5YbFDl8nVdXkJPLLW+Vf9mTD5Xe0wqIaDnLuL2U6cDNpTr+UQ+v2HWIBhzw==",
+            "dev": true,
+            "dependencies": {
+                "icss-utils": "^5.0.0",
+                "postcss-selector-parser": "^7.0.0",
+                "postcss-value-parser": "^4.1.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >= 14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/postcss-modules-local-by-default/node_modules/postcss-selector-parser": {
+            "version": "7.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.0.tgz",
+            "integrity": "sha512-8sLjZwK0R+JlxlYcTuVnyT2v+htpdrjDOKuMcOVdYjt52Lh8hWRYpxBPoKx/Zg+bcjc3wx6fmQevMmUztS/ccA==",
+            "dev": true,
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/postcss-modules-scope": {
+            "version": "3.2.1",
+            "resolved": "https://registry.npmjs.org/postcss-modules-scope/-/postcss-modules-scope-3.2.1.tgz",
+            "integrity": "sha512-m9jZstCVaqGjTAuny8MdgE88scJnCiQSlSrOWcTQgM2t32UBe+MUmFSO5t7VMSfAf/FJKImAxBav8ooCHJXCJA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-selector-parser": "^7.0.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >= 14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/postcss-modules-scope/node_modules/postcss-selector-parser": {
+            "version": "7.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.0.tgz",
+            "integrity": "sha512-8sLjZwK0R+JlxlYcTuVnyT2v+htpdrjDOKuMcOVdYjt52Lh8hWRYpxBPoKx/Zg+bcjc3wx6fmQevMmUztS/ccA==",
+            "dev": true,
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/postcss-modules-values": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz",
+            "integrity": "sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ==",
+            "dev": true,
+            "dependencies": {
+                "icss-utils": "^5.0.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >= 14"
+            },
+            "peerDependencies": {
+                "postcss": "^8.1.0"
+            }
+        },
+        "node_modules/postcss-nested": {
+            "version": "6.2.0",
+            "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.2.0.tgz",
+            "integrity": "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "postcss-selector-parser": "^6.1.1"
+            },
+            "engines": {
+                "node": ">=12.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.14"
+            }
+        },
+        "node_modules/postcss-nested/node_modules/postcss-selector-parser": {
+            "version": "6.1.2",
+            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz",
+            "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==",
+            "dev": true,
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/postcss-normalize-charset": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-5.1.0.tgz",
+            "integrity": "sha512-mSgUJ+pd/ldRGVx26p2wz9dNZ7ji6Pn8VWBajMXFf8jk7vUoSrZ2lt/wZR7DtlZYKesmZI680qjr2CeFF2fbUg==",
+            "dev": true,
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-display-values": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-display-values/-/postcss-normalize-display-values-5.1.0.tgz",
+            "integrity": "sha512-WP4KIM4o2dazQXWmFaqMmcvsKmhdINFblgSeRgn8BJ6vxaMyaJkwAzpPpuvSIoG/rmX3M+IrRZEz2H0glrQNEA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-positions": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-positions/-/postcss-normalize-positions-5.1.1.tgz",
+            "integrity": "sha512-6UpCb0G4eofTCQLFVuI3EVNZzBNPiIKcA1AKVka+31fTVySphr3VUgAIULBhxZkKgwLImhzMR2Bw1ORK+37INg==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-repeat-style": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-5.1.1.tgz",
+            "integrity": "sha512-mFpLspGWkQtBcWIRFLmewo8aC3ImN2i/J3v8YCFUwDnPu3Xz4rLohDO26lGjwNsQxB3YF0KKRwspGzE2JEuS0g==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-string": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-string/-/postcss-normalize-string-5.1.0.tgz",
+            "integrity": "sha512-oYiIJOf4T9T1N4i+abeIc7Vgm/xPCGih4bZz5Nm0/ARVJ7K6xrDlLwvwqOydvyL3RHNf8qZk6vo3aatiw/go3w==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-timing-functions": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-5.1.0.tgz",
+            "integrity": "sha512-DOEkzJ4SAXv5xkHl0Wa9cZLF3WCBhF3o1SKVxKQAa+0pYKlueTpCgvkFAHfk+Y64ezX9+nITGrDZeVGgITJXjg==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-unicode": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-unicode/-/postcss-normalize-unicode-5.1.1.tgz",
+            "integrity": "sha512-qnCL5jzkNUmKVhZoENp1mJiGNPcsJCs1aaRmURmeJGES23Z/ajaln+EPTD+rBeNkSryI+2WTdW+lwcVdOikrpA==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-url": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-5.1.0.tgz",
+            "integrity": "sha512-5upGeDO+PVthOxSmds43ZeMeZfKH+/DKgGRD7TElkkyS46JXAUhMzIKiCa7BabPeIy3AQcTkXwVVN7DbqsiCew==",
+            "dev": true,
+            "dependencies": {
+                "normalize-url": "^6.0.1",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-normalize-whitespace": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-normalize-whitespace/-/postcss-normalize-whitespace-5.1.1.tgz",
+            "integrity": "sha512-83ZJ4t3NUDETIHTa3uEg6asWjSBYL5EdkVB0sDncx9ERzOKBVJIUeDO9RyA9Zwtig8El1d79HBp0JEi8wvGQnA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-ordered-values": {
+            "version": "5.1.3",
+            "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-5.1.3.tgz",
+            "integrity": "sha512-9UO79VUhPwEkzbb3RNpqqghc6lcYej1aveQteWY+4POIwlqkYE21HKWaLDF6lWNuqCobEAyTovVhtI32Rbv2RQ==",
+            "dev": true,
+            "dependencies": {
+                "cssnano-utils": "^3.1.0",
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-reduce-initial": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-5.1.2.tgz",
+            "integrity": "sha512-dE/y2XRaqAi6OvjzD22pjTUQ8eOfc6m/natGHgKFBK9DxFmIm69YmaRVQrGgFlEfc1HePIurY0TmDeROK05rIg==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "caniuse-api": "^3.0.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-reduce-transforms": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-5.1.0.tgz",
+            "integrity": "sha512-2fbdbmgir5AvpW9RLtdONx1QoYG2/EtqpNQbFASDlixBbAYuTcJ0dECwlqNqH7VbaUnEnh8SrxOe2sRIn24XyQ==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-selector-parser": {
+            "version": "6.0.10",
+            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.0.10.tgz",
+            "integrity": "sha512-IQ7TZdoaqbT+LCpShg46jnZVlhWD2w6iQYAcYXfHARZ7X1t/UGhhceQDs5X0cGqKvYlHNOuv7Oa1xmb0oQuA3w==",
+            "dev": true,
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/postcss-svgo": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-5.1.0.tgz",
+            "integrity": "sha512-D75KsH1zm5ZrHyxPakAxJWtkyXew5qwS70v56exwvw542d9CRtTo78K0WeFxZB4G7JXKKMbEZtZayTGdIky/eA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-value-parser": "^4.2.0",
+                "svgo": "^2.7.0"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-unique-selectors": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-5.1.1.tgz",
+            "integrity": "sha512-5JiODlELrz8L2HwxfPnhOWZYWDxVHWL83ufOv84NrcgipI7TaeRsatAhK4Tr2/ZiYldpK/wBvw5BD3qfaK96GA==",
+            "dev": true,
+            "dependencies": {
+                "postcss-selector-parser": "^6.0.5"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/postcss-value-parser": {
+            "version": "4.2.0",
+            "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz",
+            "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==",
+            "dev": true
+        },
+        "node_modules/prettier": {
+            "version": "3.5.3",
+            "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.5.3.tgz",
+            "integrity": "sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==",
+            "dev": true,
+            "bin": {
+                "prettier": "bin/prettier.cjs"
+            },
+            "engines": {
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/prettier/prettier?sponsor=1"
+            }
+        },
+        "node_modules/pretty-time": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/pretty-time/-/pretty-time-1.1.0.tgz",
+            "integrity": "sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/process": {
+            "version": "0.11.10",
+            "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
+            "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6.0"
+            }
+        },
+        "node_modules/process-nextick-args": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
+            "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
+            "dev": true
+        },
+        "node_modules/proxy-addr": {
+            "version": "2.0.7",
+            "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+            "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+            "dev": true,
+            "dependencies": {
+                "forwarded": "0.2.0",
+                "ipaddr.js": "1.9.1"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/proxy-addr/node_modules/ipaddr.js": {
+            "version": "1.9.1",
+            "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+            "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/public-encrypt": {
+            "version": "4.0.3",
+            "resolved": "https://registry.npmjs.org/public-encrypt/-/public-encrypt-4.0.3.tgz",
+            "integrity": "sha512-zVpa8oKZSz5bTMTFClc1fQOnyyEzpl5ozpi1B5YcvBrdohMjH2rfsBtyXcuNuwjsDIXmBYlF2N5FlJYhR29t8Q==",
+            "dev": true,
+            "dependencies": {
+                "bn.js": "^4.1.0",
+                "browserify-rsa": "^4.0.0",
+                "create-hash": "^1.1.0",
+                "parse-asn1": "^5.0.0",
+                "randombytes": "^2.0.1",
+                "safe-buffer": "^5.1.2"
+            }
+        },
+        "node_modules/public-encrypt/node_modules/bn.js": {
+            "version": "4.12.1",
+            "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+            "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+            "dev": true
+        },
+        "node_modules/punycode": {
+            "version": "1.4.1",
+            "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz",
+            "integrity": "sha512-jmYNElW7yvO7TV33CjSmvSiE2yco3bV2czu/OzDKdMNVZQWfxCblURLhf+47syQRBntjfLdd/H0egrzIG+oaFQ==",
+            "dev": true
+        },
+        "node_modules/qs": {
+            "version": "6.14.0",
+            "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
+            "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==",
+            "dev": true,
+            "dependencies": {
+                "side-channel": "^1.1.0"
+            },
+            "engines": {
+                "node": ">=0.6"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/querystring-es3": {
+            "version": "0.2.1",
+            "resolved": "https://registry.npmjs.org/querystring-es3/-/querystring-es3-0.2.1.tgz",
+            "integrity": "sha512-773xhDQnZBMFobEiztv8LIl70ch5MSF/jUQVlhwFyBILqq96anmoctVIYz+ZRp0qbCKATTn6ev02M3r7Ga5vqA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.4.x"
+            }
+        },
+        "node_modules/queue-microtask": {
+            "version": "1.2.3",
+            "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+            "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ]
+        },
+        "node_modules/randombytes": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
+            "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
+            "dev": true,
+            "dependencies": {
+                "safe-buffer": "^5.1.0"
+            }
+        },
+        "node_modules/randomfill": {
+            "version": "1.0.4",
+            "resolved": "https://registry.npmjs.org/randomfill/-/randomfill-1.0.4.tgz",
+            "integrity": "sha512-87lcbR8+MhcWcUiQ+9e+Rwx8MyR2P7qnt15ynUlbm3TU/fjbgz4GsvfSUDTemtCCtVCqb4ZcEFlyPNTh9bBTLw==",
+            "dev": true,
+            "dependencies": {
+                "randombytes": "^2.0.5",
+                "safe-buffer": "^5.1.0"
+            }
+        },
+        "node_modules/range-parser": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+            "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/raw-body": {
+            "version": "2.5.2",
+            "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz",
+            "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==",
+            "dev": true,
+            "dependencies": {
+                "bytes": "3.1.2",
+                "http-errors": "2.0.0",
+                "iconv-lite": "0.4.24",
+                "unpipe": "1.0.0"
+            },
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/read-cache": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/read-cache/-/read-cache-1.0.0.tgz",
+            "integrity": "sha512-Owdv/Ft7IjOgm/i0xvNDZ1LrRANRfew4b2prF3OWMQLxLfu3bS8FVhCsrSCMK4lR56Y9ya+AThoTpDCTxCmpRA==",
+            "dev": true,
+            "dependencies": {
+                "pify": "^2.3.0"
+            }
+        },
+        "node_modules/readable-stream": {
+            "version": "2.3.8",
+            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
+            "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
+            "dev": true,
+            "dependencies": {
+                "core-util-is": "~1.0.0",
+                "inherits": "~2.0.3",
+                "isarray": "~1.0.0",
+                "process-nextick-args": "~2.0.0",
+                "safe-buffer": "~5.1.1",
+                "string_decoder": "~1.1.1",
+                "util-deprecate": "~1.0.1"
+            }
+        },
+        "node_modules/readable-stream/node_modules/safe-buffer": {
+            "version": "5.1.2",
+            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+            "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+            "dev": true
+        },
+        "node_modules/readable-stream/node_modules/string_decoder": {
+            "version": "1.1.1",
+            "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+            "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+            "dev": true,
+            "dependencies": {
+                "safe-buffer": "~5.1.0"
+            }
+        },
+        "node_modules/readdirp": {
+            "version": "3.6.0",
+            "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
+            "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+            "dev": true,
+            "dependencies": {
+                "picomatch": "^2.2.1"
+            },
+            "engines": {
+                "node": ">=8.10.0"
+            }
+        },
+        "node_modules/rechoir": {
+            "version": "0.7.1",
+            "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.7.1.tgz",
+            "integrity": "sha512-/njmZ8s1wVeR6pjTZ+0nCnv8SpZNRMT2D1RLOJQESlYFDBvwpTA4KWJpZ+sBJ4+vhjILRcK7JIFdGCdxEAAitg==",
+            "dev": true,
+            "dependencies": {
+                "resolve": "^1.9.0"
+            },
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/regenerate": {
+            "version": "1.4.2",
+            "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz",
+            "integrity": "sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A==",
+            "dev": true
+        },
+        "node_modules/regenerate-unicode-properties": {
+            "version": "10.2.0",
+            "resolved": "https://registry.npmjs.org/regenerate-unicode-properties/-/regenerate-unicode-properties-10.2.0.tgz",
+            "integrity": "sha512-DqHn3DwbmmPVzeKj9woBadqmXxLvQoQIwu7nopMc72ztvxVmVk2SBhSnx67zuye5TP+lJsb/TBQsjLKhnDf3MA==",
+            "dev": true,
+            "dependencies": {
+                "regenerate": "^1.4.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/regenerator-runtime": {
+            "version": "0.14.1",
+            "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.14.1.tgz",
+            "integrity": "sha512-dYnhHh0nJoMfnkZs6GmmhFknAGRrLznOu5nc9ML+EJxGvrx6H7teuevqVqCuPcPK//3eDrrjQhehXVx9cnkGdw==",
+            "dev": true
+        },
+        "node_modules/regenerator-transform": {
+            "version": "0.15.2",
+            "resolved": "https://registry.npmjs.org/regenerator-transform/-/regenerator-transform-0.15.2.tgz",
+            "integrity": "sha512-hfMp2BoF0qOk3uc5V20ALGDS2ddjQaLrdl7xrGXvAIow7qeWRM2VA2HuCHkUKk9slq3VwEwLNK3DFBqDfPGYtg==",
+            "dev": true,
+            "dependencies": {
+                "@babel/runtime": "^7.8.4"
+            }
+        },
+        "node_modules/regexpu-core": {
+            "version": "6.2.0",
+            "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-6.2.0.tgz",
+            "integrity": "sha512-H66BPQMrv+V16t8xtmq+UC0CBpiTBA60V8ibS1QVReIp8T1z8hwFxqcGzm9K6lgsN7sB5edVH8a+ze6Fqm4weA==",
+            "dev": true,
+            "dependencies": {
+                "regenerate": "^1.4.2",
+                "regenerate-unicode-properties": "^10.2.0",
+                "regjsgen": "^0.8.0",
+                "regjsparser": "^0.12.0",
+                "unicode-match-property-ecmascript": "^2.0.0",
+                "unicode-match-property-value-ecmascript": "^2.1.0"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/regjsgen": {
+            "version": "0.8.0",
+            "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.8.0.tgz",
+            "integrity": "sha512-RvwtGe3d7LvWiDQXeQw8p5asZUmfU1G/l6WbUXeHta7Y2PEIvBTwH6E2EfmYUK8pxcxEdEmaomqyp0vZZ7C+3Q==",
+            "dev": true
+        },
+        "node_modules/regjsparser": {
+            "version": "0.12.0",
+            "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.12.0.tgz",
+            "integrity": "sha512-cnE+y8bz4NhMjISKbgeVJtqNbtf5QpjZP+Bslo+UqkIt9QPnX9q095eiRRASJG1/tz6dlNr6Z5NsBiWYokp6EQ==",
+            "dev": true,
+            "dependencies": {
+                "jsesc": "~3.0.2"
+            },
+            "bin": {
+                "regjsparser": "bin/parser"
+            }
+        },
+        "node_modules/regjsparser/node_modules/jsesc": {
+            "version": "3.0.2",
+            "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.0.2.tgz",
+            "integrity": "sha512-xKqzzWXDttJuOcawBt4KnKHHIf5oQ/Cxax+0PWFG+DFDgHNAdi+TXECADI+RYiFUMmx8792xsMbbgXj4CwnP4g==",
+            "dev": true,
+            "bin": {
+                "jsesc": "bin/jsesc"
+            },
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/relateurl": {
+            "version": "0.2.7",
+            "resolved": "https://registry.npmjs.org/relateurl/-/relateurl-0.2.7.tgz",
+            "integrity": "sha512-G08Dxvm4iDN3MLM0EsP62EDV9IuhXPR6blNz6Utcp7zyV3tr4HVNINt6MpaRWbxoOHT3Q7YN2P+jaHX8vUbgog==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/replace-ext": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/replace-ext/-/replace-ext-1.0.1.tgz",
+            "integrity": "sha512-yD5BHCe7quCgBph4rMQ+0KkIRKwWCrHDOX1p1Gp6HwjPM5kVoCdKGNhN7ydqqsX6lJEnQDKZ/tFMiEdQ1dvPEw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.10"
+            }
+        },
+        "node_modules/require-directory": {
+            "version": "2.1.1",
+            "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+            "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/require-from-string": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+            "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/requires-port": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
+            "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==",
+            "dev": true
+        },
+        "node_modules/resolve": {
+            "version": "1.22.10",
+            "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.10.tgz",
+            "integrity": "sha512-NPRy+/ncIMeDlTAsuqwKIiferiawhefFJtkNSW0qZJEqMEb+qBt/77B/jGeeek+F0uOeN05CDa6HXbbIgtVX4w==",
+            "dev": true,
+            "dependencies": {
+                "is-core-module": "^2.16.0",
+                "path-parse": "^1.0.7",
+                "supports-preserve-symlinks-flag": "^1.0.0"
+            },
+            "bin": {
+                "resolve": "bin/resolve"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/resolve-cwd": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-3.0.0.tgz",
+            "integrity": "sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==",
+            "dev": true,
+            "dependencies": {
+                "resolve-from": "^5.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/resolve-cwd/node_modules/resolve-from": {
+            "version": "5.0.0",
+            "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz",
+            "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/resolve-from": {
+            "version": "4.0.0",
+            "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz",
+            "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/retry": {
+            "version": "0.13.1",
+            "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
+            "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 4"
+            }
+        },
+        "node_modules/reusify": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+            "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+            "dev": true,
+            "engines": {
+                "iojs": ">=1.0.0",
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/rimraf": {
+            "version": "3.0.2",
+            "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",
+            "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==",
+            "deprecated": "Rimraf versions prior to v4 are no longer supported",
+            "dev": true,
+            "dependencies": {
+                "glob": "^7.1.3"
+            },
+            "bin": {
+                "rimraf": "bin.js"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/ripemd160": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
+            "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
+            "dev": true,
+            "dependencies": {
+                "hash-base": "^3.0.0",
+                "inherits": "^2.0.1"
+            }
+        },
+        "node_modules/run-parallel": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+            "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ],
+            "dependencies": {
+                "queue-microtask": "^1.2.2"
+            }
+        },
+        "node_modules/safe-buffer": {
+            "version": "5.2.1",
+            "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+            "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/feross"
+                },
+                {
+                    "type": "patreon",
+                    "url": "https://www.patreon.com/feross"
+                },
+                {
+                    "type": "consulting",
+                    "url": "https://feross.org/support"
+                }
+            ]
+        },
+        "node_modules/safer-buffer": {
+            "version": "2.1.2",
+            "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+            "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+            "dev": true
+        },
+        "node_modules/schema-utils": {
+            "version": "2.7.1",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-2.7.1.tgz",
+            "integrity": "sha512-SHiNtMOUGWBQJwzISiVYKu82GiV4QYGePp3odlY1tuKO7gPtphAT5R/py0fA6xtbgLL/RvtJZnU9b8s0F1q0Xg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.5",
+                "ajv": "^6.12.4",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 8.9.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/select-hose": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/select-hose/-/select-hose-2.0.0.tgz",
+            "integrity": "sha512-mEugaLK+YfkijB4fx0e6kImuJdCIt2LxCRcbEYPqRGCs4F2ogyfZU5IAZRdjCP8JPq2AtdNoC/Dux63d9Kiryg==",
+            "dev": true
+        },
+        "node_modules/selfsigned": {
+            "version": "2.4.1",
+            "resolved": "https://registry.npmjs.org/selfsigned/-/selfsigned-2.4.1.tgz",
+            "integrity": "sha512-th5B4L2U+eGLq1TVh7zNRGBapioSORUeymIydxgFpwww9d2qyKvtuPU2jJuHvYAwwqi2Y596QBL3eEqcPEYL8Q==",
+            "dev": true,
+            "dependencies": {
+                "@types/node-forge": "^1.3.0",
+                "node-forge": "^1"
+            },
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/semver": {
+            "version": "7.7.1",
+            "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz",
+            "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==",
+            "dev": true,
+            "bin": {
+                "semver": "bin/semver.js"
+            },
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/send": {
+            "version": "0.19.0",
+            "resolved": "https://registry.npmjs.org/send/-/send-0.19.0.tgz",
+            "integrity": "sha512-dW41u5VfLXu8SJh5bwRmyYUbAoSB3c9uQh6L8h/KtsFREPWpbX1lrljJo186Jc4nmci/sGUZ9a0a0J2zgfq2hw==",
+            "dev": true,
+            "dependencies": {
+                "debug": "2.6.9",
+                "depd": "2.0.0",
+                "destroy": "1.2.0",
+                "encodeurl": "~1.0.2",
+                "escape-html": "~1.0.3",
+                "etag": "~1.8.1",
+                "fresh": "0.5.2",
+                "http-errors": "2.0.0",
+                "mime": "1.6.0",
+                "ms": "2.1.3",
+                "on-finished": "2.4.1",
+                "range-parser": "~1.2.1",
+                "statuses": "2.0.1"
+            },
+            "engines": {
+                "node": ">= 0.8.0"
+            }
+        },
+        "node_modules/send/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/send/node_modules/debug/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/send/node_modules/encodeurl": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz",
+            "integrity": "sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/serialize-javascript": {
+            "version": "6.0.2",
+            "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
+            "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
+            "dev": true,
+            "dependencies": {
+                "randombytes": "^2.1.0"
+            }
+        },
+        "node_modules/serve-index": {
+            "version": "1.9.1",
+            "resolved": "https://registry.npmjs.org/serve-index/-/serve-index-1.9.1.tgz",
+            "integrity": "sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw==",
+            "dev": true,
+            "dependencies": {
+                "accepts": "~1.3.4",
+                "batch": "0.6.1",
+                "debug": "2.6.9",
+                "escape-html": "~1.0.3",
+                "http-errors": "~1.6.2",
+                "mime-types": "~2.1.17",
+                "parseurl": "~1.3.2"
+            },
+            "engines": {
+                "node": ">= 0.8.0"
+            }
+        },
+        "node_modules/serve-index/node_modules/debug": {
+            "version": "2.6.9",
+            "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+            "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+            "dev": true,
+            "dependencies": {
+                "ms": "2.0.0"
+            }
+        },
+        "node_modules/serve-index/node_modules/depd": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/depd/-/depd-1.1.2.tgz",
+            "integrity": "sha512-7emPTl6Dpo6JRXOXjLRxck+FlLRX5847cLKEn00PLAgc3g2hTZZgr+e4c2v6QpSmLeFP3n5yUo7ft6avBK/5jQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/serve-index/node_modules/http-errors": {
+            "version": "1.6.3",
+            "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-1.6.3.tgz",
+            "integrity": "sha512-lks+lVC8dgGyh97jxvxeYTWQFvh4uw4yC12gVl63Cg30sjPX4wuGcdkICVXDAESr6OJGjqGA8Iz5mkeN6zlD7A==",
+            "dev": true,
+            "dependencies": {
+                "depd": "~1.1.2",
+                "inherits": "2.0.3",
+                "setprototypeof": "1.1.0",
+                "statuses": ">= 1.4.0 < 2"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/serve-index/node_modules/inherits": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
+            "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
+            "dev": true
+        },
+        "node_modules/serve-index/node_modules/ms": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+            "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+            "dev": true
+        },
+        "node_modules/serve-index/node_modules/setprototypeof": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.1.0.tgz",
+            "integrity": "sha512-BvE/TwpZX4FXExxOxZyRGQQv651MSwmWKZGqvmPcRIjDqWub67kTKuIMx43cZZrS/cBBzwBcNDWoFxt2XEFIpQ==",
+            "dev": true
+        },
+        "node_modules/serve-index/node_modules/statuses": {
+            "version": "1.5.0",
+            "resolved": "https://registry.npmjs.org/statuses/-/statuses-1.5.0.tgz",
+            "integrity": "sha512-OpZ3zP+jT1PI7I8nemJX4AKmAX070ZkYPVWV/AaKTJl+tXCTGyVdC1a4SL8RUQYEwk/f34ZX8UTykN68FwrqAA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/serve-static": {
+            "version": "1.16.2",
+            "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.2.tgz",
+            "integrity": "sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==",
+            "dev": true,
+            "dependencies": {
+                "encodeurl": "~2.0.0",
+                "escape-html": "~1.0.3",
+                "parseurl": "~1.3.3",
+                "send": "0.19.0"
+            },
+            "engines": {
+                "node": ">= 0.8.0"
+            }
+        },
+        "node_modules/set-function-length": {
+            "version": "1.2.2",
+            "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+            "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
+            "dev": true,
+            "dependencies": {
+                "define-data-property": "^1.1.4",
+                "es-errors": "^1.3.0",
+                "function-bind": "^1.1.2",
+                "get-intrinsic": "^1.2.4",
+                "gopd": "^1.0.1",
+                "has-property-descriptors": "^1.0.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/setimmediate": {
+            "version": "1.0.5",
+            "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+            "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+            "dev": true
+        },
+        "node_modules/setprototypeof": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+            "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+            "dev": true
+        },
+        "node_modules/sha.js": {
+            "version": "2.4.11",
+            "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
+            "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.1",
+                "safe-buffer": "^5.0.1"
+            },
+            "bin": {
+                "sha.js": "bin.js"
+            }
+        },
+        "node_modules/shallow-clone": {
+            "version": "3.0.1",
+            "resolved": "https://registry.npmjs.org/shallow-clone/-/shallow-clone-3.0.1.tgz",
+            "integrity": "sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA==",
+            "dev": true,
+            "dependencies": {
+                "kind-of": "^6.0.2"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/shebang-command": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+            "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+            "dev": true,
+            "dependencies": {
+                "shebang-regex": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/shebang-regex": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+            "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/shell-quote": {
+            "version": "1.8.2",
+            "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.8.2.tgz",
+            "integrity": "sha512-AzqKpGKjrj7EM6rKVQEPpB288oCfnrEIuyoT9cyF4nmGa7V8Zk6f7RRqYisX8X9m+Q7bd632aZW4ky7EhbQztA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/shellwords": {
+            "version": "0.1.1",
+            "resolved": "https://registry.npmjs.org/shellwords/-/shellwords-0.1.1.tgz",
+            "integrity": "sha512-vFwSUfQvqybiICwZY5+DAWIPLKsWO31Q91JSKl3UYv+K5c2QRPzn0qzec6QPu1Qc9eHYItiP3NdJqNVqetYAww==",
+            "dev": true
+        },
+        "node_modules/side-channel": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+            "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+            "dev": true,
+            "dependencies": {
+                "es-errors": "^1.3.0",
+                "object-inspect": "^1.13.3",
+                "side-channel-list": "^1.0.0",
+                "side-channel-map": "^1.0.1",
+                "side-channel-weakmap": "^1.0.2"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/side-channel-list": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+            "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+            "dev": true,
+            "dependencies": {
+                "es-errors": "^1.3.0",
+                "object-inspect": "^1.13.3"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/side-channel-map": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+            "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+            "dev": true,
+            "dependencies": {
+                "call-bound": "^1.0.2",
+                "es-errors": "^1.3.0",
+                "get-intrinsic": "^1.2.5",
+                "object-inspect": "^1.13.3"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/side-channel-weakmap": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+            "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+            "dev": true,
+            "dependencies": {
+                "call-bound": "^1.0.2",
+                "es-errors": "^1.3.0",
+                "get-intrinsic": "^1.2.5",
+                "object-inspect": "^1.13.3",
+                "side-channel-map": "^1.0.1"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/signal-exit": {
+            "version": "3.0.7",
+            "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+            "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+            "dev": true
+        },
+        "node_modules/slash": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
+            "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/sockjs": {
+            "version": "0.3.24",
+            "resolved": "https://registry.npmjs.org/sockjs/-/sockjs-0.3.24.tgz",
+            "integrity": "sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ==",
+            "dev": true,
+            "dependencies": {
+                "faye-websocket": "^0.11.3",
+                "uuid": "^8.3.2",
+                "websocket-driver": "^0.7.4"
+            }
+        },
+        "node_modules/source-list-map": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/source-list-map/-/source-list-map-2.0.1.tgz",
+            "integrity": "sha512-qnQ7gVMxGNxsiL4lEuJwe/To8UnK7fAnmbGEEH8RpLouuKbeEm0lhbQVFIrNSuB+G7tVrAlVsZgETT5nljf+Iw==",
+            "dev": true
+        },
+        "node_modules/source-map": {
+            "version": "0.6.1",
+            "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+            "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/source-map-js": {
+            "version": "1.2.1",
+            "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+            "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.10.0"
+            }
+        },
+        "node_modules/source-map-support": {
+            "version": "0.5.21",
+            "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+            "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+            "dev": true,
+            "dependencies": {
+                "buffer-from": "^1.0.0",
+                "source-map": "^0.6.0"
+            }
+        },
+        "node_modules/spdy": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/spdy/-/spdy-4.0.2.tgz",
+            "integrity": "sha512-r46gZQZQV+Kl9oItvl1JZZqJKGr+oEkB08A6BzkiR7593/7IbtuncXHd2YoYeTsG4157ZssMu9KYvUHLcjcDoA==",
+            "dev": true,
+            "dependencies": {
+                "debug": "^4.1.0",
+                "handle-thing": "^2.0.0",
+                "http-deceiver": "^1.2.7",
+                "select-hose": "^2.0.0",
+                "spdy-transport": "^3.0.0"
+            },
+            "engines": {
+                "node": ">=6.0.0"
+            }
+        },
+        "node_modules/spdy-transport": {
+            "version": "3.0.0",
+            "resolved": "https://registry.npmjs.org/spdy-transport/-/spdy-transport-3.0.0.tgz",
+            "integrity": "sha512-hsLVFE5SjA6TCisWeJXFKniGGOpBgMLmerfO2aCyCU5s7nJ/rpAepqmFifv/GCbSbueEeAJJnmSQ2rKC/g8Fcw==",
+            "dev": true,
+            "dependencies": {
+                "debug": "^4.1.0",
+                "detect-node": "^2.0.4",
+                "hpack.js": "^2.1.6",
+                "obuf": "^1.1.2",
+                "readable-stream": "^3.0.6",
+                "wbuf": "^1.7.3"
+            }
+        },
+        "node_modules/spdy-transport/node_modules/readable-stream": {
+            "version": "3.6.2",
+            "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+            "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "^2.0.3",
+                "string_decoder": "^1.1.1",
+                "util-deprecate": "^1.0.1"
+            },
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/stable": {
+            "version": "0.1.8",
+            "resolved": "https://registry.npmjs.org/stable/-/stable-0.1.8.tgz",
+            "integrity": "sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w==",
+            "deprecated": "Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility",
+            "dev": true
+        },
+        "node_modules/statuses": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
+            "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/std-env": {
+            "version": "3.9.0",
+            "resolved": "https://registry.npmjs.org/std-env/-/std-env-3.9.0.tgz",
+            "integrity": "sha512-UGvjygr6F6tpH7o2qyqR6QYpwraIjKSdtzyBdyytFOHmPZY917kwdwLG0RbOjWOnKmnm3PeHjaoLLMie7kPLQw==",
+            "dev": true
+        },
+        "node_modules/stream-browserify": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/stream-browserify/-/stream-browserify-2.0.2.tgz",
+            "integrity": "sha512-nX6hmklHs/gr2FuxYDltq8fJA1GDlxKQCz8O/IM4atRqBH8OORmBNgfvW5gG10GT/qQ9u0CzIvr2X5Pkt6ntqg==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "~2.0.1",
+                "readable-stream": "^2.0.2"
+            }
+        },
+        "node_modules/stream-http": {
+            "version": "2.8.3",
+            "resolved": "https://registry.npmjs.org/stream-http/-/stream-http-2.8.3.tgz",
+            "integrity": "sha512-+TSkfINHDo4J+ZobQLWiMouQYB+UVYFttRA94FpEzzJ7ZdqcL4uUUQ7WkdkI4DSozGmgBUE/a47L+38PenXhUw==",
+            "dev": true,
+            "dependencies": {
+                "builtin-status-codes": "^3.0.0",
+                "inherits": "^2.0.1",
+                "readable-stream": "^2.3.6",
+                "to-arraybuffer": "^1.0.0",
+                "xtend": "^4.0.0"
+            }
+        },
+        "node_modules/string_decoder": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+            "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+            "dev": true,
+            "dependencies": {
+                "safe-buffer": "~5.2.0"
+            }
+        },
+        "node_modules/string-width": {
+            "version": "4.2.3",
+            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+            "dev": true,
+            "dependencies": {
+                "emoji-regex": "^8.0.0",
+                "is-fullwidth-code-point": "^3.0.0",
+                "strip-ansi": "^6.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/string-width-cjs": {
+            "name": "string-width",
+            "version": "4.2.3",
+            "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+            "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+            "dev": true,
+            "dependencies": {
+                "emoji-regex": "^8.0.0",
+                "is-fullwidth-code-point": "^3.0.0",
+                "strip-ansi": "^6.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/strip-ansi": {
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+            "dev": true,
+            "dependencies": {
+                "ansi-regex": "^5.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/strip-ansi-cjs": {
+            "name": "strip-ansi",
+            "version": "6.0.1",
+            "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+            "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+            "dev": true,
+            "dependencies": {
+                "ansi-regex": "^5.0.1"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/strip-final-newline": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
+            "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/style-loader": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-2.0.0.tgz",
+            "integrity": "sha512-Z0gYUJmzZ6ZdRUqpg1r8GsaFKypE+3xAzuFeMuoHgjc9KZv3wMyCRjQIWEbhoFSq7+7yoHXySDJyyWQaPajeiQ==",
+            "dev": true,
+            "dependencies": {
+                "loader-utils": "^2.0.0",
+                "schema-utils": "^3.0.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.0.0 || ^5.0.0"
+            }
+        },
+        "node_modules/style-loader/node_modules/schema-utils": {
+            "version": "3.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-3.3.0.tgz",
+            "integrity": "sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.8",
+                "ajv": "^6.12.5",
+                "ajv-keywords": "^3.5.2"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/stylehacks": {
+            "version": "5.1.1",
+            "resolved": "https://registry.npmjs.org/stylehacks/-/stylehacks-5.1.1.tgz",
+            "integrity": "sha512-sBpcd5Hx7G6seo7b1LkpttvTz7ikD0LlH5RmdcBNb6fFR0Fl7LQwHDFr300q4cwUqi+IYrFGmsIHieMBfnN/Bw==",
+            "dev": true,
+            "dependencies": {
+                "browserslist": "^4.21.4",
+                "postcss-selector-parser": "^6.0.4"
+            },
+            "engines": {
+                "node": "^10 || ^12 || >=14.0"
+            },
+            "peerDependencies": {
+                "postcss": "^8.2.15"
+            }
+        },
+        "node_modules/sucrase": {
+            "version": "3.35.0",
+            "resolved": "https://registry.npmjs.org/sucrase/-/sucrase-3.35.0.tgz",
+            "integrity": "sha512-8EbVDiu9iN/nESwxeSxDKe0dunta1GOlHufmSSXxMD2z2/tMZpDMpvXQGsc+ajGo8y2uYUmixaSRUc/QPoQ0GA==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/gen-mapping": "^0.3.2",
+                "commander": "^4.0.0",
+                "glob": "^10.3.10",
+                "lines-and-columns": "^1.1.6",
+                "mz": "^2.7.0",
+                "pirates": "^4.0.1",
+                "ts-interface-checker": "^0.1.9"
+            },
+            "bin": {
+                "sucrase": "bin/sucrase",
+                "sucrase-node": "bin/sucrase-node"
+            },
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
+            }
+        },
+        "node_modules/sucrase/node_modules/brace-expansion": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
+            "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+            "dev": true,
+            "dependencies": {
+                "balanced-match": "^1.0.0"
+            }
+        },
+        "node_modules/sucrase/node_modules/commander": {
+            "version": "4.1.1",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
+            "integrity": "sha512-NOKm8xhkzAjzFx8B2v5OAHT+u5pRQc2UCa2Vq9jYL/31o2wi9mxBA7LIFs3sV5VSC49z6pEhfbMULvShKj26WA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/sucrase/node_modules/glob": {
+            "version": "10.4.5",
+            "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz",
+            "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==",
+            "dev": true,
+            "dependencies": {
+                "foreground-child": "^3.1.0",
+                "jackspeak": "^3.1.2",
+                "minimatch": "^9.0.4",
+                "minipass": "^7.1.2",
+                "package-json-from-dist": "^1.0.0",
+                "path-scurry": "^1.11.1"
+            },
+            "bin": {
+                "glob": "dist/esm/bin.mjs"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/sucrase/node_modules/minimatch": {
+            "version": "9.0.5",
+            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+            "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+            "dev": true,
+            "dependencies": {
+                "brace-expansion": "^2.0.1"
+            },
+            "engines": {
+                "node": ">=16 || 14 >=14.17"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/isaacs"
+            }
+        },
+        "node_modules/supports-color": {
+            "version": "7.2.0",
+            "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+            "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+            "dev": true,
+            "dependencies": {
+                "has-flag": "^4.0.0"
+            },
+            "engines": {
+                "node": ">=8"
+            }
+        },
+        "node_modules/supports-preserve-symlinks-flag": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
+            "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/ljharb"
+            }
+        },
+        "node_modules/svgo": {
+            "version": "2.8.0",
+            "resolved": "https://registry.npmjs.org/svgo/-/svgo-2.8.0.tgz",
+            "integrity": "sha512-+N/Q9kV1+F+UeWYoSiULYo4xYSDQlTgb+ayMobAXPwMnLvop7oxKMo9OzIrX5x3eS4L4f2UHhc9axXwY8DpChg==",
+            "dev": true,
+            "dependencies": {
+                "@trysound/sax": "0.2.0",
+                "commander": "^7.2.0",
+                "css-select": "^4.1.3",
+                "css-tree": "^1.1.3",
+                "csso": "^4.2.0",
+                "picocolors": "^1.0.0",
+                "stable": "^0.1.8"
+            },
+            "bin": {
+                "svgo": "bin/svgo"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/tailwindcss": {
+            "version": "3.4.17",
+            "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz",
+            "integrity": "sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==",
+            "dev": true,
+            "dependencies": {
+                "@alloc/quick-lru": "^5.2.0",
+                "arg": "^5.0.2",
+                "chokidar": "^3.6.0",
+                "didyoumean": "^1.2.2",
+                "dlv": "^1.1.3",
+                "fast-glob": "^3.3.2",
+                "glob-parent": "^6.0.2",
+                "is-glob": "^4.0.3",
+                "jiti": "^1.21.6",
+                "lilconfig": "^3.1.3",
+                "micromatch": "^4.0.8",
+                "normalize-path": "^3.0.0",
+                "object-hash": "^3.0.0",
+                "picocolors": "^1.1.1",
+                "postcss": "^8.4.47",
+                "postcss-import": "^15.1.0",
+                "postcss-js": "^4.0.1",
+                "postcss-load-config": "^4.0.2",
+                "postcss-nested": "^6.2.0",
+                "postcss-selector-parser": "^6.1.2",
+                "resolve": "^1.22.8",
+                "sucrase": "^3.35.0"
+            },
+            "bin": {
+                "tailwind": "lib/cli.js",
+                "tailwindcss": "lib/cli.js"
+            },
+            "engines": {
+                "node": ">=14.0.0"
+            }
+        },
+        "node_modules/tailwindcss/node_modules/glob-parent": {
+            "version": "6.0.2",
+            "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
+            "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
+            "dev": true,
+            "dependencies": {
+                "is-glob": "^4.0.3"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/tailwindcss/node_modules/lilconfig": {
+            "version": "3.1.3",
+            "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz",
+            "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==",
+            "dev": true,
+            "engines": {
+                "node": ">=14"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/antonk52"
+            }
+        },
+        "node_modules/tailwindcss/node_modules/postcss-load-config": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/postcss-load-config/-/postcss-load-config-4.0.2.tgz",
+            "integrity": "sha512-bSVhyJGL00wMVoPUzAVAnbEoWyqRxkjv64tUl427SKnPrENtq6hJwUojroMz2VB+Q1edmi4IfrAPpami5VVgMQ==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/postcss/"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "lilconfig": "^3.0.0",
+                "yaml": "^2.3.4"
+            },
+            "engines": {
+                "node": ">= 14"
+            },
+            "peerDependencies": {
+                "postcss": ">=8.0.9",
+                "ts-node": ">=9.0.0"
+            },
+            "peerDependenciesMeta": {
+                "postcss": {
+                    "optional": true
+                },
+                "ts-node": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/tailwindcss/node_modules/postcss-selector-parser": {
+            "version": "6.1.2",
+            "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz",
+            "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==",
+            "dev": true,
+            "dependencies": {
+                "cssesc": "^3.0.0",
+                "util-deprecate": "^1.0.2"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/tailwindcss/node_modules/yaml": {
+            "version": "2.7.1",
+            "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.7.1.tgz",
+            "integrity": "sha512-10ULxpnOCQXxJvBgxsn9ptjq6uviG/htZKk9veJGhlqn3w/DxQ631zFF+nlQXLwmImeS5amR2dl2U8sg6U9jsQ==",
+            "dev": true,
+            "bin": {
+                "yaml": "bin.mjs"
+            },
+            "engines": {
+                "node": ">= 14"
+            }
+        },
+        "node_modules/tapable": {
+            "version": "2.2.1",
+            "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz",
+            "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/terser": {
+            "version": "5.39.0",
+            "resolved": "https://registry.npmjs.org/terser/-/terser-5.39.0.tgz",
+            "integrity": "sha512-LBAhFyLho16harJoWMg/nZsQYgTrg5jXOn2nCYjRUcZZEdE3qa2zb8QEDRUGVZBW4rlazf2fxkg8tztybTaqWw==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/source-map": "^0.3.3",
+                "acorn": "^8.8.2",
+                "commander": "^2.20.0",
+                "source-map-support": "~0.5.20"
+            },
+            "bin": {
+                "terser": "bin/terser"
+            },
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/terser-webpack-plugin": {
+            "version": "5.3.14",
+            "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.14.tgz",
+            "integrity": "sha512-vkZjpUjb6OMS7dhV+tILUW6BhpDR7P2L/aQSAv+Uwk+m8KATX9EccViHTJR2qDtACKPIYndLGCyl3FMo+r2LMw==",
+            "dev": true,
+            "dependencies": {
+                "@jridgewell/trace-mapping": "^0.3.25",
+                "jest-worker": "^27.4.5",
+                "schema-utils": "^4.3.0",
+                "serialize-javascript": "^6.0.2",
+                "terser": "^5.31.1"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^5.1.0"
+            },
+            "peerDependenciesMeta": {
+                "@swc/core": {
+                    "optional": true
+                },
+                "esbuild": {
+                    "optional": true
+                },
+                "uglify-js": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/terser-webpack-plugin/node_modules/ajv": {
+            "version": "8.17.1",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+            "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "fast-uri": "^3.0.1",
+                "json-schema-traverse": "^1.0.0",
+                "require-from-string": "^2.0.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/terser-webpack-plugin/node_modules/ajv-keywords": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
+            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3"
+            },
+            "peerDependencies": {
+                "ajv": "^8.8.2"
+            }
+        },
+        "node_modules/terser-webpack-plugin/node_modules/json-schema-traverse": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+            "dev": true
+        },
+        "node_modules/terser-webpack-plugin/node_modules/schema-utils": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.0.tgz",
+            "integrity": "sha512-Gf9qqc58SpCA/xdziiHz35F4GNIWYWZrEshUc/G/r5BnLph6xpKuLeoJoQuj5WfBIx/eQLf+hmVPYHaxJu7V2g==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.9",
+                "ajv": "^8.9.0",
+                "ajv-formats": "^2.1.1",
+                "ajv-keywords": "^5.1.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/terser/node_modules/commander": {
+            "version": "2.20.3",
+            "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+            "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+            "dev": true
+        },
+        "node_modules/thenify": {
+            "version": "3.3.1",
+            "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
+            "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==",
+            "dev": true,
+            "dependencies": {
+                "any-promise": "^1.0.0"
+            }
+        },
+        "node_modules/thenify-all": {
+            "version": "1.6.0",
+            "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz",
+            "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==",
+            "dev": true,
+            "dependencies": {
+                "thenify": ">= 3.1.0 < 4"
+            },
+            "engines": {
+                "node": ">=0.8"
+            }
+        },
+        "node_modules/thunky": {
+            "version": "1.1.0",
+            "resolved": "https://registry.npmjs.org/thunky/-/thunky-1.1.0.tgz",
+            "integrity": "sha512-eHY7nBftgThBqOyHGVN+l8gF0BucP09fMo0oO/Lb0w1OF80dJv+lDVpXG60WMQvkcxAkNybKsrEIE3ZtKGmPrA==",
+            "dev": true
+        },
+        "node_modules/timers-browserify": {
+            "version": "2.0.12",
+            "resolved": "https://registry.npmjs.org/timers-browserify/-/timers-browserify-2.0.12.tgz",
+            "integrity": "sha512-9phl76Cqm6FhSX9Xe1ZUAMLtm1BLkKj2Qd5ApyWkXzsMRaA7dgr81kf4wJmQf/hAvg8EEyJxDo3du/0KlhPiKQ==",
+            "dev": true,
+            "dependencies": {
+                "setimmediate": "^1.0.4"
+            },
+            "engines": {
+                "node": ">=0.6.0"
+            }
+        },
+        "node_modules/to-arraybuffer": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",
+            "integrity": "sha512-okFlQcoGTi4LQBG/PgSYblw9VOyptsz2KJZqc6qtgGdes8VktzUQkj4BI2blit072iS8VODNcMA+tvnS9dnuMA==",
+            "dev": true
+        },
+        "node_modules/to-regex-range": {
+            "version": "5.0.1",
+            "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+            "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+            "dev": true,
+            "dependencies": {
+                "is-number": "^7.0.0"
+            },
+            "engines": {
+                "node": ">=8.0"
+            }
+        },
+        "node_modules/toidentifier": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+            "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.6"
+            }
+        },
+        "node_modules/ts-interface-checker": {
+            "version": "0.1.13",
+            "resolved": "https://registry.npmjs.org/ts-interface-checker/-/ts-interface-checker-0.1.13.tgz",
+            "integrity": "sha512-Y/arvbn+rrz3JCKl9C4kVNfTfSm2/mEp5FSz5EsZSANGPSlQrpRI5M4PKF+mJnE52jOO90PnPSc3Ur3bTQw0gA==",
+            "dev": true
+        },
+        "node_modules/tslib": {
+            "version": "2.8.1",
+            "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+            "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+            "dev": true
+        },
+        "node_modules/tty-browserify": {
+            "version": "0.0.0",
+            "resolved": "https://registry.npmjs.org/tty-browserify/-/tty-browserify-0.0.0.tgz",
+            "integrity": "sha512-JVa5ijo+j/sOoHGjw0sxw734b1LhBkQ3bvUGNdxnVXDCX81Yx7TFgnZygxrIIWn23hbfTaMYLwRmAxFyDuFmIw==",
+            "dev": true
+        },
+        "node_modules/type-is": {
+            "version": "1.6.18",
+            "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+            "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+            "dev": true,
+            "dependencies": {
+                "media-typer": "0.3.0",
+                "mime-types": "~2.1.24"
+            },
+            "engines": {
+                "node": ">= 0.6"
+            }
+        },
+        "node_modules/undici-types": {
+            "version": "6.21.0",
+            "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+            "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+            "dev": true
+        },
+        "node_modules/unicode-canonical-property-names-ecmascript": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.1.tgz",
+            "integrity": "sha512-dA8WbNeb2a6oQzAQ55YlT5vQAWGV9WXOsi3SskE3bcCdM0P4SDd+24zS/OCacdRq5BkdsRj9q3Pg6YyQoxIGqg==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/unicode-match-property-ecmascript": {
+            "version": "2.0.0",
+            "resolved": "https://registry.npmjs.org/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz",
+            "integrity": "sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q==",
+            "dev": true,
+            "dependencies": {
+                "unicode-canonical-property-names-ecmascript": "^2.0.0",
+                "unicode-property-aliases-ecmascript": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/unicode-match-property-value-ecmascript": {
+            "version": "2.2.0",
+            "resolved": "https://registry.npmjs.org/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.2.0.tgz",
+            "integrity": "sha512-4IehN3V/+kkr5YeSSDDQG8QLqO26XpL2XP3GQtqwlT/QYSECAwFztxVHjlbh0+gjJ3XmNLS0zDsbgs9jWKExLg==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/unicode-property-aliases-ecmascript": {
+            "version": "2.1.0",
+            "resolved": "https://registry.npmjs.org/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.1.0.tgz",
+            "integrity": "sha512-6t3foTQI9qne+OZoVQB/8x8rk2k1eVy1gRXhV3oFQ5T6R1dqQ1xtin3XqSlx3+ATBkliTaR/hHyJBm+LVPNM8w==",
+            "dev": true,
+            "engines": {
+                "node": ">=4"
+            }
+        },
+        "node_modules/universalify": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+            "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+            "dev": true,
+            "engines": {
+                "node": ">= 10.0.0"
+            }
+        },
+        "node_modules/unpipe": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+            "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/update-browserslist-db": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.3.tgz",
+            "integrity": "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw==",
+            "dev": true,
+            "funding": [
+                {
+                    "type": "opencollective",
+                    "url": "https://opencollective.com/browserslist"
+                },
+                {
+                    "type": "tidelift",
+                    "url": "https://tidelift.com/funding/github/npm/browserslist"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/ai"
+                }
+            ],
+            "dependencies": {
+                "escalade": "^3.2.0",
+                "picocolors": "^1.1.1"
+            },
+            "bin": {
+                "update-browserslist-db": "cli.js"
+            },
+            "peerDependencies": {
+                "browserslist": ">= 4.21.0"
+            }
+        },
+        "node_modules/uri-js": {
+            "version": "4.4.1",
+            "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz",
+            "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==",
+            "dev": true,
+            "dependencies": {
+                "punycode": "^2.1.0"
+            }
+        },
+        "node_modules/uri-js/node_modules/punycode": {
+            "version": "2.3.1",
+            "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+            "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
+        "node_modules/url": {
+            "version": "0.11.4",
+            "resolved": "https://registry.npmjs.org/url/-/url-0.11.4.tgz",
+            "integrity": "sha512-oCwdVC7mTuWiPyjLUz/COz5TLk6wgp0RCsN+wHZ2Ekneac9w8uuV0njcbbie2ME+Vs+d6duwmYuR3HgQXs1fOg==",
+            "dev": true,
+            "dependencies": {
+                "punycode": "^1.4.1",
+                "qs": "^6.12.3"
+            },
+            "engines": {
+                "node": ">= 0.4"
+            }
+        },
+        "node_modules/util": {
+            "version": "0.11.1",
+            "resolved": "https://registry.npmjs.org/util/-/util-0.11.1.tgz",
+            "integrity": "sha512-HShAsny+zS2TZfaXxD9tYj4HQGlBezXZMZuM/S5PKLLoZkShZiGk9o5CzukI1LVHZvjdvZ2Sj1aW/Ndn2NB/HQ==",
+            "dev": true,
+            "dependencies": {
+                "inherits": "2.0.3"
+            }
+        },
+        "node_modules/util-deprecate": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+            "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+            "dev": true
+        },
+        "node_modules/util/node_modules/inherits": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
+            "integrity": "sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw==",
+            "dev": true
+        },
+        "node_modules/utils-merge": {
+            "version": "1.0.1",
+            "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
+            "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.4.0"
+            }
+        },
+        "node_modules/uuid": {
+            "version": "8.3.2",
+            "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
+            "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
+            "dev": true,
+            "bin": {
+                "uuid": "dist/bin/uuid"
+            }
+        },
+        "node_modules/vary": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+            "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 0.8"
+            }
+        },
+        "node_modules/vm-browserify": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/vm-browserify/-/vm-browserify-1.1.2.tgz",
+            "integrity": "sha512-2ham8XPWTONajOR0ohOKOHXkm3+gaBmGut3SRuu75xLd/RRaY6vqgh8NBYYk7+RW3u5AtzPQZG8F10LHkl0lAQ==",
+            "dev": true
+        },
+        "node_modules/vue-style-loader": {
+            "version": "4.1.3",
+            "resolved": "https://registry.npmjs.org/vue-style-loader/-/vue-style-loader-4.1.3.tgz",
+            "integrity": "sha512-sFuh0xfbtpRlKfm39ss/ikqs9AbKCoXZBpHeVZ8Tx650o0k0q/YCM7FRvigtxpACezfq6af+a7JeqVTWvncqDg==",
+            "dev": true,
+            "dependencies": {
+                "hash-sum": "^1.0.2",
+                "loader-utils": "^1.0.2"
+            }
+        },
+        "node_modules/vue-style-loader/node_modules/json5": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
+            "integrity": "sha512-g1MWMLBiz8FKi1e4w0UyVL3w+iJceWAFBAaBnnGKOpNa5f8TLktkbre1+s6oICydWAm+HRUGTmI+//xv2hvXYA==",
+            "dev": true,
+            "dependencies": {
+                "minimist": "^1.2.0"
+            },
+            "bin": {
+                "json5": "lib/cli.js"
+            }
+        },
+        "node_modules/vue-style-loader/node_modules/loader-utils": {
+            "version": "1.4.2",
+            "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.4.2.tgz",
+            "integrity": "sha512-I5d00Pd/jwMD2QCduo657+YM/6L3KZu++pmX9VFncxaxvHcru9jx1lBaFft+r4Mt2jK0Yhp41XlRAihzPxHNCg==",
+            "dev": true,
+            "dependencies": {
+                "big.js": "^5.2.2",
+                "emojis-list": "^3.0.0",
+                "json5": "^1.0.1"
+            },
+            "engines": {
+                "node": ">=4.0.0"
+            }
+        },
+        "node_modules/watchpack": {
+            "version": "2.4.2",
+            "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.2.tgz",
+            "integrity": "sha512-TnbFSbcOCcDgjZ4piURLCbJ3nJhznVh9kw6F6iokjiFPl8ONxe9A6nMDVXDiNbrSfLILs6vB07F7wLBrwPYzJw==",
+            "dev": true,
+            "dependencies": {
+                "glob-to-regexp": "^0.4.1",
+                "graceful-fs": "^4.1.2"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/wbuf": {
+            "version": "1.7.3",
+            "resolved": "https://registry.npmjs.org/wbuf/-/wbuf-1.7.3.tgz",
+            "integrity": "sha512-O84QOnr0icsbFGLS0O3bI5FswxzRr8/gHwWkDlQFskhSPryQXvrTMxjxGP4+iWYoauLoBvfDpkrOauZ+0iZpDA==",
+            "dev": true,
+            "dependencies": {
+                "minimalistic-assert": "^1.0.0"
+            }
+        },
+        "node_modules/webpack": {
+            "version": "5.99.6",
+            "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.99.6.tgz",
+            "integrity": "sha512-TJOLrJ6oeccsGWPl7ujCYuc0pIq2cNsuD6GZDma8i5o5Npvcco/z+NKvZSFsP0/x6SShVb0+X2JK/JHUjKY9dQ==",
+            "dev": true,
+            "dependencies": {
+                "@types/eslint-scope": "^3.7.7",
+                "@types/estree": "^1.0.6",
+                "@webassemblyjs/ast": "^1.14.1",
+                "@webassemblyjs/wasm-edit": "^1.14.1",
+                "@webassemblyjs/wasm-parser": "^1.14.1",
+                "acorn": "^8.14.0",
+                "browserslist": "^4.24.0",
+                "chrome-trace-event": "^1.0.2",
+                "enhanced-resolve": "^5.17.1",
+                "es-module-lexer": "^1.2.1",
+                "eslint-scope": "5.1.1",
+                "events": "^3.2.0",
+                "glob-to-regexp": "^0.4.1",
+                "graceful-fs": "^4.2.11",
+                "json-parse-even-better-errors": "^2.3.1",
+                "loader-runner": "^4.2.0",
+                "mime-types": "^2.1.27",
+                "neo-async": "^2.6.2",
+                "schema-utils": "^4.3.0",
+                "tapable": "^2.1.1",
+                "terser-webpack-plugin": "^5.3.11",
+                "watchpack": "^2.4.1",
+                "webpack-sources": "^3.2.3"
+            },
+            "bin": {
+                "webpack": "bin/webpack.js"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependenciesMeta": {
+                "webpack-cli": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/webpack-cli": {
+            "version": "4.10.0",
+            "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-4.10.0.tgz",
+            "integrity": "sha512-NLhDfH/h4O6UOy+0LSso42xvYypClINuMNBVVzX4vX98TmTaTUxwRbXdhucbFMd2qLaCTcLq/PdYrvi8onw90w==",
+            "dev": true,
+            "dependencies": {
+                "@discoveryjs/json-ext": "^0.5.0",
+                "@webpack-cli/configtest": "^1.2.0",
+                "@webpack-cli/info": "^1.5.0",
+                "@webpack-cli/serve": "^1.7.0",
+                "colorette": "^2.0.14",
+                "commander": "^7.0.0",
+                "cross-spawn": "^7.0.3",
+                "fastest-levenshtein": "^1.0.12",
+                "import-local": "^3.0.2",
+                "interpret": "^2.2.0",
+                "rechoir": "^0.7.0",
+                "webpack-merge": "^5.7.3"
+            },
+            "bin": {
+                "webpack-cli": "bin/cli.js"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "4.x.x || 5.x.x"
+            },
+            "peerDependenciesMeta": {
+                "@webpack-cli/generators": {
+                    "optional": true
+                },
+                "@webpack-cli/migrate": {
+                    "optional": true
+                },
+                "webpack-bundle-analyzer": {
+                    "optional": true
+                },
+                "webpack-dev-server": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/webpack-dev-middleware": {
+            "version": "5.3.4",
+            "resolved": "https://registry.npmjs.org/webpack-dev-middleware/-/webpack-dev-middleware-5.3.4.tgz",
+            "integrity": "sha512-BVdTqhhs+0IfoeAf7EoH5WE+exCmqGerHfDM0IL096Px60Tq2Mn9MAbnaGUe6HiMa41KMCYF19gyzZmBcq/o4Q==",
+            "dev": true,
+            "dependencies": {
+                "colorette": "^2.0.10",
+                "memfs": "^3.4.3",
+                "mime-types": "^2.1.31",
+                "range-parser": "^1.2.1",
+                "schema-utils": "^4.0.0"
+            },
+            "engines": {
+                "node": ">= 12.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.0.0 || ^5.0.0"
+            }
+        },
+        "node_modules/webpack-dev-middleware/node_modules/ajv": {
+            "version": "8.17.1",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+            "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "fast-uri": "^3.0.1",
+                "json-schema-traverse": "^1.0.0",
+                "require-from-string": "^2.0.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/webpack-dev-middleware/node_modules/ajv-keywords": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
+            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3"
+            },
+            "peerDependencies": {
+                "ajv": "^8.8.2"
+            }
+        },
+        "node_modules/webpack-dev-middleware/node_modules/json-schema-traverse": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+            "dev": true
+        },
+        "node_modules/webpack-dev-middleware/node_modules/schema-utils": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.0.tgz",
+            "integrity": "sha512-Gf9qqc58SpCA/xdziiHz35F4GNIWYWZrEshUc/G/r5BnLph6xpKuLeoJoQuj5WfBIx/eQLf+hmVPYHaxJu7V2g==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.9",
+                "ajv": "^8.9.0",
+                "ajv-formats": "^2.1.1",
+                "ajv-keywords": "^5.1.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/webpack-dev-server": {
+            "version": "4.15.2",
+            "resolved": "https://registry.npmjs.org/webpack-dev-server/-/webpack-dev-server-4.15.2.tgz",
+            "integrity": "sha512-0XavAZbNJ5sDrCbkpWL8mia0o5WPOd2YGtxrEiZkBK9FjLppIUK2TgxK6qGD2P3hUXTJNNPVibrerKcx5WkR1g==",
+            "dev": true,
+            "dependencies": {
+                "@types/bonjour": "^3.5.9",
+                "@types/connect-history-api-fallback": "^1.3.5",
+                "@types/express": "^4.17.13",
+                "@types/serve-index": "^1.9.1",
+                "@types/serve-static": "^1.13.10",
+                "@types/sockjs": "^0.3.33",
+                "@types/ws": "^8.5.5",
+                "ansi-html-community": "^0.0.8",
+                "bonjour-service": "^1.0.11",
+                "chokidar": "^3.5.3",
+                "colorette": "^2.0.10",
+                "compression": "^1.7.4",
+                "connect-history-api-fallback": "^2.0.0",
+                "default-gateway": "^6.0.3",
+                "express": "^4.17.3",
+                "graceful-fs": "^4.2.6",
+                "html-entities": "^2.3.2",
+                "http-proxy-middleware": "^2.0.3",
+                "ipaddr.js": "^2.0.1",
+                "launch-editor": "^2.6.0",
+                "open": "^8.0.9",
+                "p-retry": "^4.5.0",
+                "rimraf": "^3.0.2",
+                "schema-utils": "^4.0.0",
+                "selfsigned": "^2.1.1",
+                "serve-index": "^1.9.1",
+                "sockjs": "^0.3.24",
+                "spdy": "^4.0.2",
+                "webpack-dev-middleware": "^5.3.4",
+                "ws": "^8.13.0"
+            },
+            "bin": {
+                "webpack-dev-server": "bin/webpack-dev-server.js"
+            },
+            "engines": {
+                "node": ">= 12.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            },
+            "peerDependencies": {
+                "webpack": "^4.37.0 || ^5.0.0"
+            },
+            "peerDependenciesMeta": {
+                "webpack": {
+                    "optional": true
+                },
+                "webpack-cli": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/webpack-dev-server/node_modules/ajv": {
+            "version": "8.17.1",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+            "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "fast-uri": "^3.0.1",
+                "json-schema-traverse": "^1.0.0",
+                "require-from-string": "^2.0.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/webpack-dev-server/node_modules/ajv-keywords": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
+            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3"
+            },
+            "peerDependencies": {
+                "ajv": "^8.8.2"
+            }
+        },
+        "node_modules/webpack-dev-server/node_modules/json-schema-traverse": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+            "dev": true
+        },
+        "node_modules/webpack-dev-server/node_modules/schema-utils": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.0.tgz",
+            "integrity": "sha512-Gf9qqc58SpCA/xdziiHz35F4GNIWYWZrEshUc/G/r5BnLph6xpKuLeoJoQuj5WfBIx/eQLf+hmVPYHaxJu7V2g==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.9",
+                "ajv": "^8.9.0",
+                "ajv-formats": "^2.1.1",
+                "ajv-keywords": "^5.1.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/webpack-merge": {
+            "version": "5.10.0",
+            "resolved": "https://registry.npmjs.org/webpack-merge/-/webpack-merge-5.10.0.tgz",
+            "integrity": "sha512-+4zXKdx7UnO+1jaN4l2lHVD+mFvnlZQP/6ljaJVb4SZiwIKeUnrT5l0gkT8z+n4hKpC+jpOv6O9R+gLtag7pSA==",
+            "dev": true,
+            "dependencies": {
+                "clone-deep": "^4.0.1",
+                "flat": "^5.0.2",
+                "wildcard": "^2.0.0"
+            },
+            "engines": {
+                "node": ">=10.0.0"
+            }
+        },
+        "node_modules/webpack-notifier": {
+            "version": "1.15.0",
+            "resolved": "https://registry.npmjs.org/webpack-notifier/-/webpack-notifier-1.15.0.tgz",
+            "integrity": "sha512-N2V8UMgRB5komdXQRavBsRpw0hPhJq2/SWNOGuhrXpIgRhcMexzkGQysUyGStHLV5hkUlgpRiF7IUXoBqyMmzQ==",
+            "dev": true,
+            "dependencies": {
+                "node-notifier": "^9.0.0",
+                "strip-ansi": "^6.0.0"
+            },
+            "peerDependencies": {
+                "@types/webpack": ">4.41.31"
+            },
+            "peerDependenciesMeta": {
+                "@types/webpack": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/webpack-sources": {
+            "version": "1.4.3",
+            "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-1.4.3.tgz",
+            "integrity": "sha512-lgTS3Xhv1lCOKo7SA5TjKXMjpSM4sBjNV5+q2bqesbSPs5FjGmU6jjtBSkX9b4qW87vDIsCIlUPOEhbZrMdjeQ==",
+            "dev": true,
+            "dependencies": {
+                "source-list-map": "^2.0.0",
+                "source-map": "~0.6.1"
+            }
+        },
+        "node_modules/webpack/node_modules/ajv": {
+            "version": "8.17.1",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+            "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3",
+                "fast-uri": "^3.0.1",
+                "json-schema-traverse": "^1.0.0",
+                "require-from-string": "^2.0.2"
+            },
+            "funding": {
+                "type": "github",
+                "url": "https://github.com/sponsors/epoberezkin"
+            }
+        },
+        "node_modules/webpack/node_modules/ajv-keywords": {
+            "version": "5.1.0",
+            "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
+            "integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
+            "dev": true,
+            "dependencies": {
+                "fast-deep-equal": "^3.1.3"
+            },
+            "peerDependencies": {
+                "ajv": "^8.8.2"
+            }
+        },
+        "node_modules/webpack/node_modules/json-schema-traverse": {
+            "version": "1.0.0",
+            "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+            "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+            "dev": true
+        },
+        "node_modules/webpack/node_modules/schema-utils": {
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.0.tgz",
+            "integrity": "sha512-Gf9qqc58SpCA/xdziiHz35F4GNIWYWZrEshUc/G/r5BnLph6xpKuLeoJoQuj5WfBIx/eQLf+hmVPYHaxJu7V2g==",
+            "dev": true,
+            "dependencies": {
+                "@types/json-schema": "^7.0.9",
+                "ajv": "^8.9.0",
+                "ajv-formats": "^2.1.1",
+                "ajv-keywords": "^5.1.0"
+            },
+            "engines": {
+                "node": ">= 10.13.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/webpack"
+            }
+        },
+        "node_modules/webpack/node_modules/webpack-sources": {
+            "version": "3.2.3",
+            "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.2.3.tgz",
+            "integrity": "sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
+        "node_modules/webpackbar": {
+            "version": "5.0.2",
+            "resolved": "https://registry.npmjs.org/webpackbar/-/webpackbar-5.0.2.tgz",
+            "integrity": "sha512-BmFJo7veBDgQzfWXl/wwYXr/VFus0614qZ8i9znqcl9fnEdiVkdbi0TedLQ6xAK92HZHDJ0QmyQ0fmuZPAgCYQ==",
+            "dev": true,
+            "dependencies": {
+                "chalk": "^4.1.0",
+                "consola": "^2.15.3",
+                "pretty-time": "^1.1.0",
+                "std-env": "^3.0.1"
+            },
+            "engines": {
+                "node": ">=12"
+            },
+            "peerDependencies": {
+                "webpack": "3 || 4 || 5"
+            }
+        },
+        "node_modules/websocket-driver": {
+            "version": "0.7.4",
+            "resolved": "https://registry.npmjs.org/websocket-driver/-/websocket-driver-0.7.4.tgz",
+            "integrity": "sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg==",
+            "dev": true,
+            "dependencies": {
+                "http-parser-js": ">=0.5.1",
+                "safe-buffer": ">=5.1.0",
+                "websocket-extensions": ">=0.1.1"
+            },
+            "engines": {
+                "node": ">=0.8.0"
+            }
+        },
+        "node_modules/websocket-extensions": {
+            "version": "0.1.4",
+            "resolved": "https://registry.npmjs.org/websocket-extensions/-/websocket-extensions-0.1.4.tgz",
+            "integrity": "sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.8.0"
+            }
+        },
+        "node_modules/which": {
+            "version": "2.0.2",
+            "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+            "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+            "dev": true,
+            "dependencies": {
+                "isexe": "^2.0.0"
+            },
+            "bin": {
+                "node-which": "bin/node-which"
+            },
+            "engines": {
+                "node": ">= 8"
+            }
+        },
+        "node_modules/wildcard": {
+            "version": "2.0.1",
+            "resolved": "https://registry.npmjs.org/wildcard/-/wildcard-2.0.1.tgz",
+            "integrity": "sha512-CC1bOL87PIWSBhDcTrdeLo6eGT7mCFtrg0uIJtqJUFyK+eJnzl8A1niH56uu7KMa5XFrtiV+AQuHO3n7DsHnLQ==",
+            "dev": true
+        },
+        "node_modules/wrap-ansi": {
+            "version": "7.0.0",
+            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+            "dev": true,
+            "dependencies": {
+                "ansi-styles": "^4.0.0",
+                "string-width": "^4.1.0",
+                "strip-ansi": "^6.0.0"
+            },
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+            }
+        },
+        "node_modules/wrap-ansi-cjs": {
+            "name": "wrap-ansi",
+            "version": "7.0.0",
+            "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+            "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+            "dev": true,
+            "dependencies": {
+                "ansi-styles": "^4.0.0",
+                "string-width": "^4.1.0",
+                "strip-ansi": "^6.0.0"
+            },
+            "engines": {
+                "node": ">=10"
+            },
+            "funding": {
+                "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+            }
+        },
+        "node_modules/wrappy": {
+            "version": "1.0.2",
+            "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+            "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+            "dev": true
+        },
+        "node_modules/ws": {
+            "version": "8.18.1",
+            "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.1.tgz",
+            "integrity": "sha512-RKW2aJZMXeMxVpnZ6bck+RswznaxmzdULiBr6KY7XkTnW8uvt0iT9H5DkHUChXrc+uurzwa0rVI16n/Xzjdz1w==",
+            "dev": true,
+            "engines": {
+                "node": ">=10.0.0"
+            },
+            "peerDependencies": {
+                "bufferutil": "^4.0.1",
+                "utf-8-validate": ">=5.0.2"
+            },
+            "peerDependenciesMeta": {
+                "bufferutil": {
+                    "optional": true
+                },
+                "utf-8-validate": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/xtend": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
+            "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=0.4"
+            }
+        },
+        "node_modules/y18n": {
+            "version": "5.0.8",
+            "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+            "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+            "dev": true,
+            "engines": {
+                "node": ">=10"
+            }
+        },
+        "node_modules/yallist": {
+            "version": "3.1.1",
+            "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
+            "integrity": "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==",
+            "dev": true
+        },
+        "node_modules/yaml": {
+            "version": "1.10.2",
+            "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz",
+            "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==",
+            "dev": true,
+            "engines": {
+                "node": ">= 6"
+            }
+        },
+        "node_modules/yargs": {
+            "version": "17.7.2",
+            "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz",
+            "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==",
+            "dev": true,
+            "dependencies": {
+                "cliui": "^8.0.1",
+                "escalade": "^3.1.1",
+                "get-caller-file": "^2.0.5",
+                "require-directory": "^2.1.1",
+                "string-width": "^4.2.3",
+                "y18n": "^5.0.5",
+                "yargs-parser": "^21.1.1"
+            },
+            "engines": {
+                "node": ">=12"
+            }
+        },
+        "node_modules/yargs-parser": {
+            "version": "21.1.1",
+            "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
+            "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
+            "dev": true,
+            "engines": {
+                "node": ">=12"
+            }
+        }
+    }
+}
diff --git a/packages/hyde/package.json b/packages/hyde/package.json
index 1b80b36daa4..39be96d027e 100644
--- a/packages/hyde/package.json
+++ b/packages/hyde/package.json
@@ -12,6 +12,6 @@
         "laravel-mix": "^6.0.49",
         "postcss": "^8.4.31",
         "prettier": "3.5.3",
-        "tailwindcss": "^3.0.24"
+        "tailwindcss": "^4.1.4"
     }
 }

From 02182924b84ff036e10eadac77388afd89912b0d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 19:19:47 +0200
Subject: [PATCH 3955/4023] Remove the TailwindCSS PostCSS Vite plugin

---
 packages/hyde/vite.config.js | 2 --
 vite.config.js               | 2 --
 2 files changed, 4 deletions(-)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index b06ea97180d..3b0bff62979 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -4,7 +4,6 @@
 
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
-import tailwindcss from 'tailwindcss';
 import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
@@ -57,7 +56,6 @@ export default defineConfig({
     css: {
         postcss: {
             plugins: [
-                tailwindcss,
                 autoprefixer
             ]
         }
diff --git a/vite.config.js b/vite.config.js
index b06ea97180d..3b0bff62979 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -4,7 +4,6 @@
 
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
-import tailwindcss from 'tailwindcss';
 import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
@@ -57,7 +56,6 @@ export default defineConfig({
     css: {
         postcss: {
             plugins: [
-                tailwindcss,
                 autoprefixer
             ]
         }

From 2856a71a44c96f5087370893fd51b190ae61deff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 21:13:39 +0200
Subject: [PATCH 3956/4023] Use the new Tailwind Vite plugin

---
 package-lock.json            | 787 +++++++++++++++++++++++++++++++++++
 package.json                 |   1 +
 packages/hyde/package.json   |   1 +
 packages/hyde/vite.config.js |   2 +
 vite.config.js               |   2 +
 5 files changed, 793 insertions(+)

diff --git a/package-lock.json b/package-lock.json
index dd39f7d7638..9a6fc19c37b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -6,6 +6,7 @@
         "": {
             "devDependencies": {
                 "@tailwindcss/typography": "^0.5.15",
+                "@tailwindcss/vite": "^4.1.4",
                 "autoprefixer": "^10.4.20",
                 "hydefront": "^3.3.0",
                 "postcss": "^8.4.49",
@@ -680,6 +681,246 @@
                 "win32"
             ]
         },
+        "node_modules/@tailwindcss/node": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.1.4.tgz",
+            "integrity": "sha512-MT5118zaiO6x6hNA04OWInuAiP1YISXql8Z+/Y8iisV5nuhM8VXlyhRuqc2PEviPszcXI66W44bCIk500Oolhw==",
+            "dev": true,
+            "dependencies": {
+                "enhanced-resolve": "^5.18.1",
+                "jiti": "^2.4.2",
+                "lightningcss": "1.29.2",
+                "tailwindcss": "4.1.4"
+            }
+        },
+        "node_modules/@tailwindcss/oxide": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.1.4.tgz",
+            "integrity": "sha512-p5wOpXyOJx7mKh5MXh5oKk+kqcz8T+bA3z/5VWWeQwFrmuBItGwz8Y2CHk/sJ+dNb9B0nYFfn0rj/cKHZyjahQ==",
+            "dev": true,
+            "engines": {
+                "node": ">= 10"
+            },
+            "optionalDependencies": {
+                "@tailwindcss/oxide-android-arm64": "4.1.4",
+                "@tailwindcss/oxide-darwin-arm64": "4.1.4",
+                "@tailwindcss/oxide-darwin-x64": "4.1.4",
+                "@tailwindcss/oxide-freebsd-x64": "4.1.4",
+                "@tailwindcss/oxide-linux-arm-gnueabihf": "4.1.4",
+                "@tailwindcss/oxide-linux-arm64-gnu": "4.1.4",
+                "@tailwindcss/oxide-linux-arm64-musl": "4.1.4",
+                "@tailwindcss/oxide-linux-x64-gnu": "4.1.4",
+                "@tailwindcss/oxide-linux-x64-musl": "4.1.4",
+                "@tailwindcss/oxide-wasm32-wasi": "4.1.4",
+                "@tailwindcss/oxide-win32-arm64-msvc": "4.1.4",
+                "@tailwindcss/oxide-win32-x64-msvc": "4.1.4"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-android-arm64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.1.4.tgz",
+            "integrity": "sha512-xMMAe/SaCN/vHfQYui3fqaBDEXMu22BVwQ33veLc8ep+DNy7CWN52L+TTG9y1K397w9nkzv+Mw+mZWISiqhmlA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "android"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-darwin-arm64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.1.4.tgz",
+            "integrity": "sha512-JGRj0SYFuDuAGilWFBlshcexev2hOKfNkoX+0QTksKYq2zgF9VY/vVMq9m8IObYnLna0Xlg+ytCi2FN2rOL0Sg==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-darwin-x64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.1.4.tgz",
+            "integrity": "sha512-sdDeLNvs3cYeWsEJ4H1DvjOzaGios4QbBTNLVLVs0XQ0V95bffT3+scptzYGPMjm7xv4+qMhCDrkHwhnUySEzA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-freebsd-x64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.1.4.tgz",
+            "integrity": "sha512-VHxAqxqdghM83HslPhRsNhHo91McsxRJaEnShJOMu8mHmEj9Ig7ToHJtDukkuLWLzLboh2XSjq/0zO6wgvykNA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-linux-arm-gnueabihf": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.1.4.tgz",
+            "integrity": "sha512-OTU/m/eV4gQKxy9r5acuesqaymyeSCnsx1cFto/I1WhPmi5HDxX1nkzb8KYBiwkHIGg7CTfo/AcGzoXAJBxLfg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-linux-arm64-gnu": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.1.4.tgz",
+            "integrity": "sha512-hKlLNvbmUC6z5g/J4H+Zx7f7w15whSVImokLPmP6ff1QqTVE+TxUM9PGuNsjHvkvlHUtGTdDnOvGNSEUiXI1Ww==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-linux-arm64-musl": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.1.4.tgz",
+            "integrity": "sha512-X3As2xhtgPTY/m5edUtddmZ8rCruvBvtxYLMw9OsZdH01L2gS2icsHRwxdU0dMItNfVmrBezueXZCHxVeeb7Aw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-linux-x64-gnu": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.1.4.tgz",
+            "integrity": "sha512-2VG4DqhGaDSmYIu6C4ua2vSLXnJsb/C9liej7TuSO04NK+JJJgJucDUgmX6sn7Gw3Cs5ZJ9ZLrnI0QRDOjLfNQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-linux-x64-musl": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.1.4.tgz",
+            "integrity": "sha512-v+mxVgH2kmur/X5Mdrz9m7TsoVjbdYQT0b4Z+dr+I4RvreCNXyCFELZL/DO0M1RsidZTrm6O1eMnV6zlgEzTMQ==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-wasm32-wasi": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.1.4.tgz",
+            "integrity": "sha512-2TLe9ir+9esCf6Wm+lLWTMbgklIjiF0pbmDnwmhR9MksVOq+e8aP3TSsXySnBDDvTTVd/vKu1aNttEGj3P6l8Q==",
+            "bundleDependencies": [
+                "@napi-rs/wasm-runtime",
+                "@emnapi/core",
+                "@emnapi/runtime",
+                "@tybys/wasm-util",
+                "@emnapi/wasi-threads",
+                "tslib"
+            ],
+            "cpu": [
+                "wasm32"
+            ],
+            "dev": true,
+            "optional": true,
+            "dependencies": {
+                "@emnapi/core": "^1.4.0",
+                "@emnapi/runtime": "^1.4.0",
+                "@emnapi/wasi-threads": "^1.0.1",
+                "@napi-rs/wasm-runtime": "^0.2.8",
+                "@tybys/wasm-util": "^0.9.0",
+                "tslib": "^2.8.0"
+            },
+            "engines": {
+                "node": ">=14.0.0"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-win32-arm64-msvc": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.4.tgz",
+            "integrity": "sha512-VlnhfilPlO0ltxW9/BgfLI5547PYzqBMPIzRrk4W7uupgCt8z6Trw/tAj6QUtF2om+1MH281Pg+HHUJoLesmng==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
+        "node_modules/@tailwindcss/oxide-win32-x64-msvc": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.1.4.tgz",
+            "integrity": "sha512-+7S63t5zhYjslUGb8NcgLpFXD+Kq1F/zt5Xv5qTv7HaFTG/DHyHD9GA6ieNAxhgyA4IcKa/zy7Xx4Oad2/wuhw==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 10"
+            }
+        },
         "node_modules/@tailwindcss/typography": {
             "version": "0.5.15",
             "dev": true,
@@ -694,6 +935,20 @@
                 "tailwindcss": ">=3.0.0 || insiders || >=4.0.0-alpha.20"
             }
         },
+        "node_modules/@tailwindcss/vite": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/vite/-/vite-4.1.4.tgz",
+            "integrity": "sha512-4UQeMrONbvrsXKXXp/uxmdEN5JIJ9RkH7YVzs6AMxC/KC1+Np7WZBaNIco7TEjlkthqxZbt8pU/ipD+hKjm80A==",
+            "dev": true,
+            "dependencies": {
+                "@tailwindcss/node": "4.1.4",
+                "@tailwindcss/oxide": "4.1.4",
+                "tailwindcss": "4.1.4"
+            },
+            "peerDependencies": {
+                "vite": "^5.2.0 || ^6"
+            }
+        },
         "node_modules/@types/estree": {
             "version": "1.0.6",
             "dev": true,
@@ -826,11 +1081,33 @@
                 "node": ">=4"
             }
         },
+        "node_modules/detect-libc": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.3.tgz",
+            "integrity": "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw==",
+            "dev": true,
+            "engines": {
+                "node": ">=8"
+            }
+        },
         "node_modules/electron-to-chromium": {
             "version": "1.5.55",
             "dev": true,
             "license": "ISC"
         },
+        "node_modules/enhanced-resolve": {
+            "version": "5.18.1",
+            "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.1.tgz",
+            "integrity": "sha512-ZSW3ma5GkcQBIpwZTSRAI8N71Uuwgs93IezB7mf7R60tC8ZbJideoDNKjHn2O9KIlx6rkGTTEk1xUCK2E1Y2Yg==",
+            "dev": true,
+            "dependencies": {
+                "graceful-fs": "^4.2.4",
+                "tapable": "^2.2.0"
+            },
+            "engines": {
+                "node": ">=10.13.0"
+            }
+        },
         "node_modules/esbuild": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
@@ -903,11 +1180,254 @@
                 "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
             }
         },
+        "node_modules/graceful-fs": {
+            "version": "4.2.11",
+            "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+            "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+            "dev": true
+        },
         "node_modules/hydefront": {
             "version": "3.4.1",
             "dev": true,
             "license": "MIT"
         },
+        "node_modules/jiti": {
+            "version": "2.4.2",
+            "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.4.2.tgz",
+            "integrity": "sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A==",
+            "dev": true,
+            "bin": {
+                "jiti": "lib/jiti-cli.mjs"
+            }
+        },
+        "node_modules/lightningcss": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.29.2.tgz",
+            "integrity": "sha512-6b6gd/RUXKaw5keVdSEtqFVdzWnU5jMxTUjA2bVcMNPLwSQ08Sv/UodBVtETLCn7k4S1Ibxwh7k68IwLZPgKaA==",
+            "dev": true,
+            "dependencies": {
+                "detect-libc": "^2.0.3"
+            },
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            },
+            "optionalDependencies": {
+                "lightningcss-darwin-arm64": "1.29.2",
+                "lightningcss-darwin-x64": "1.29.2",
+                "lightningcss-freebsd-x64": "1.29.2",
+                "lightningcss-linux-arm-gnueabihf": "1.29.2",
+                "lightningcss-linux-arm64-gnu": "1.29.2",
+                "lightningcss-linux-arm64-musl": "1.29.2",
+                "lightningcss-linux-x64-gnu": "1.29.2",
+                "lightningcss-linux-x64-musl": "1.29.2",
+                "lightningcss-win32-arm64-msvc": "1.29.2",
+                "lightningcss-win32-x64-msvc": "1.29.2"
+            }
+        },
+        "node_modules/lightningcss-darwin-arm64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.29.2.tgz",
+            "integrity": "sha512-cK/eMabSViKn/PG8U/a7aCorpeKLMlK0bQeNHmdb7qUnBkNPnL+oV5DjJUo0kqWsJUapZsM4jCfYItbqBDvlcA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-darwin-x64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.29.2.tgz",
+            "integrity": "sha512-j5qYxamyQw4kDXX5hnnCKMf3mLlHvG44f24Qyi2965/Ycz829MYqjrVg2H8BidybHBp9kom4D7DR5VqCKDXS0w==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "darwin"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-freebsd-x64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.29.2.tgz",
+            "integrity": "sha512-wDk7M2tM78Ii8ek9YjnY8MjV5f5JN2qNVO+/0BAGZRvXKtQrBC4/cn4ssQIpKIPP44YXw6gFdpUF+Ps+RGsCwg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "freebsd"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm-gnueabihf": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.29.2.tgz",
+            "integrity": "sha512-IRUrOrAF2Z+KExdExe3Rz7NSTuuJ2HvCGlMKoquK5pjvo2JY4Rybr+NrKnq0U0hZnx5AnGsuFHjGnNT14w26sg==",
+            "cpu": [
+                "arm"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-gnu": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.29.2.tgz",
+            "integrity": "sha512-KKCpOlmhdjvUTX/mBuaKemp0oeDIBBLFiU5Fnqxh1/DZ4JPZi4evEH7TKoSBFOSOV3J7iEmmBaw/8dpiUvRKlQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-arm64-musl": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.29.2.tgz",
+            "integrity": "sha512-Q64eM1bPlOOUgxFmoPUefqzY1yV3ctFPE6d/Vt7WzLW4rKTv7MyYNky+FWxRpLkNASTnKQUaiMJ87zNODIrrKQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-gnu": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.29.2.tgz",
+            "integrity": "sha512-0v6idDCPG6epLXtBH/RPkHvYx74CVziHo6TMYga8O2EiQApnUPZsbR9nFNrg2cgBzk1AYqEd95TlrsL7nYABQg==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-linux-x64-musl": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.29.2.tgz",
+            "integrity": "sha512-rMpz2yawkgGT8RULc5S4WiZopVMOFWjiItBT7aSfDX4NQav6M44rhn5hjtkKzB+wMTRlLLqxkeYEtQ3dd9696w==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-arm64-msvc": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.29.2.tgz",
+            "integrity": "sha512-nL7zRW6evGQqYVu/bKGK+zShyz8OVzsCotFgc7judbt6wnB2KbiKKJwBE4SGoDBQ1O94RjW4asrCjQL4i8Fhbw==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
+        "node_modules/lightningcss-win32-x64-msvc": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.29.2.tgz",
+            "integrity": "sha512-EdIUW3B2vLuHmv7urfzMI/h2fmlnOQBk1xlsDxkN1tCWKjNFjfLhGxYk8C8mzpSfr+A6jFFIi8fU6LbQGsRWjA==",
+            "cpu": [
+                "x64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "win32"
+            ],
+            "engines": {
+                "node": ">= 12.0.0"
+            },
+            "funding": {
+                "type": "opencollective",
+                "url": "https://opencollective.com/parcel"
+            }
+        },
         "node_modules/lodash.castarray": {
             "version": "4.4.0",
             "dev": true,
@@ -1089,6 +1609,15 @@
             "integrity": "sha512-1ZIUqtPITFbv/DxRmDr5/agPqJwF69d24m9qmM1939TJehgY539CtzeZRjbLt5G6fSy/7YqqYsfvoTEw9xUI2A==",
             "dev": true
         },
+        "node_modules/tapable": {
+            "version": "2.2.1",
+            "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz",
+            "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==",
+            "dev": true,
+            "engines": {
+                "node": ">=6"
+            }
+        },
         "node_modules/terser": {
             "version": "5.36.0",
             "dev": true,
@@ -1553,6 +2082,130 @@
             "dev": true,
             "optional": true
         },
+        "@tailwindcss/node": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/node/-/node-4.1.4.tgz",
+            "integrity": "sha512-MT5118zaiO6x6hNA04OWInuAiP1YISXql8Z+/Y8iisV5nuhM8VXlyhRuqc2PEviPszcXI66W44bCIk500Oolhw==",
+            "dev": true,
+            "requires": {
+                "enhanced-resolve": "^5.18.1",
+                "jiti": "^2.4.2",
+                "lightningcss": "1.29.2",
+                "tailwindcss": "4.1.4"
+            }
+        },
+        "@tailwindcss/oxide": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide/-/oxide-4.1.4.tgz",
+            "integrity": "sha512-p5wOpXyOJx7mKh5MXh5oKk+kqcz8T+bA3z/5VWWeQwFrmuBItGwz8Y2CHk/sJ+dNb9B0nYFfn0rj/cKHZyjahQ==",
+            "dev": true,
+            "requires": {
+                "@tailwindcss/oxide-android-arm64": "4.1.4",
+                "@tailwindcss/oxide-darwin-arm64": "4.1.4",
+                "@tailwindcss/oxide-darwin-x64": "4.1.4",
+                "@tailwindcss/oxide-freebsd-x64": "4.1.4",
+                "@tailwindcss/oxide-linux-arm-gnueabihf": "4.1.4",
+                "@tailwindcss/oxide-linux-arm64-gnu": "4.1.4",
+                "@tailwindcss/oxide-linux-arm64-musl": "4.1.4",
+                "@tailwindcss/oxide-linux-x64-gnu": "4.1.4",
+                "@tailwindcss/oxide-linux-x64-musl": "4.1.4",
+                "@tailwindcss/oxide-wasm32-wasi": "4.1.4",
+                "@tailwindcss/oxide-win32-arm64-msvc": "4.1.4",
+                "@tailwindcss/oxide-win32-x64-msvc": "4.1.4"
+            }
+        },
+        "@tailwindcss/oxide-android-arm64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-android-arm64/-/oxide-android-arm64-4.1.4.tgz",
+            "integrity": "sha512-xMMAe/SaCN/vHfQYui3fqaBDEXMu22BVwQ33veLc8ep+DNy7CWN52L+TTG9y1K397w9nkzv+Mw+mZWISiqhmlA==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-darwin-arm64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-arm64/-/oxide-darwin-arm64-4.1.4.tgz",
+            "integrity": "sha512-JGRj0SYFuDuAGilWFBlshcexev2hOKfNkoX+0QTksKYq2zgF9VY/vVMq9m8IObYnLna0Xlg+ytCi2FN2rOL0Sg==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-darwin-x64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-darwin-x64/-/oxide-darwin-x64-4.1.4.tgz",
+            "integrity": "sha512-sdDeLNvs3cYeWsEJ4H1DvjOzaGios4QbBTNLVLVs0XQ0V95bffT3+scptzYGPMjm7xv4+qMhCDrkHwhnUySEzA==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-freebsd-x64": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-freebsd-x64/-/oxide-freebsd-x64-4.1.4.tgz",
+            "integrity": "sha512-VHxAqxqdghM83HslPhRsNhHo91McsxRJaEnShJOMu8mHmEj9Ig7ToHJtDukkuLWLzLboh2XSjq/0zO6wgvykNA==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-linux-arm-gnueabihf": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm-gnueabihf/-/oxide-linux-arm-gnueabihf-4.1.4.tgz",
+            "integrity": "sha512-OTU/m/eV4gQKxy9r5acuesqaymyeSCnsx1cFto/I1WhPmi5HDxX1nkzb8KYBiwkHIGg7CTfo/AcGzoXAJBxLfg==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-linux-arm64-gnu": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-gnu/-/oxide-linux-arm64-gnu-4.1.4.tgz",
+            "integrity": "sha512-hKlLNvbmUC6z5g/J4H+Zx7f7w15whSVImokLPmP6ff1QqTVE+TxUM9PGuNsjHvkvlHUtGTdDnOvGNSEUiXI1Ww==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-linux-arm64-musl": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-arm64-musl/-/oxide-linux-arm64-musl-4.1.4.tgz",
+            "integrity": "sha512-X3As2xhtgPTY/m5edUtddmZ8rCruvBvtxYLMw9OsZdH01L2gS2icsHRwxdU0dMItNfVmrBezueXZCHxVeeb7Aw==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-linux-x64-gnu": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-gnu/-/oxide-linux-x64-gnu-4.1.4.tgz",
+            "integrity": "sha512-2VG4DqhGaDSmYIu6C4ua2vSLXnJsb/C9liej7TuSO04NK+JJJgJucDUgmX6sn7Gw3Cs5ZJ9ZLrnI0QRDOjLfNQ==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-linux-x64-musl": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-linux-x64-musl/-/oxide-linux-x64-musl-4.1.4.tgz",
+            "integrity": "sha512-v+mxVgH2kmur/X5Mdrz9m7TsoVjbdYQT0b4Z+dr+I4RvreCNXyCFELZL/DO0M1RsidZTrm6O1eMnV6zlgEzTMQ==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-wasm32-wasi": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-wasm32-wasi/-/oxide-wasm32-wasi-4.1.4.tgz",
+            "integrity": "sha512-2TLe9ir+9esCf6Wm+lLWTMbgklIjiF0pbmDnwmhR9MksVOq+e8aP3TSsXySnBDDvTTVd/vKu1aNttEGj3P6l8Q==",
+            "dev": true,
+            "optional": true,
+            "requires": {
+                "@emnapi/core": "^1.4.0",
+                "@emnapi/runtime": "^1.4.0",
+                "@emnapi/wasi-threads": "^1.0.1",
+                "@napi-rs/wasm-runtime": "^0.2.8",
+                "@tybys/wasm-util": "^0.9.0",
+                "tslib": "^2.8.0"
+            }
+        },
+        "@tailwindcss/oxide-win32-arm64-msvc": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-arm64-msvc/-/oxide-win32-arm64-msvc-4.1.4.tgz",
+            "integrity": "sha512-VlnhfilPlO0ltxW9/BgfLI5547PYzqBMPIzRrk4W7uupgCt8z6Trw/tAj6QUtF2om+1MH281Pg+HHUJoLesmng==",
+            "dev": true,
+            "optional": true
+        },
+        "@tailwindcss/oxide-win32-x64-msvc": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/oxide-win32-x64-msvc/-/oxide-win32-x64-msvc-4.1.4.tgz",
+            "integrity": "sha512-+7S63t5zhYjslUGb8NcgLpFXD+Kq1F/zt5Xv5qTv7HaFTG/DHyHD9GA6ieNAxhgyA4IcKa/zy7Xx4Oad2/wuhw==",
+            "dev": true,
+            "optional": true
+        },
         "@tailwindcss/typography": {
             "version": "0.5.15",
             "dev": true,
@@ -1563,6 +2216,17 @@
                 "postcss-selector-parser": "6.0.10"
             }
         },
+        "@tailwindcss/vite": {
+            "version": "4.1.4",
+            "resolved": "https://registry.npmjs.org/@tailwindcss/vite/-/vite-4.1.4.tgz",
+            "integrity": "sha512-4UQeMrONbvrsXKXXp/uxmdEN5JIJ9RkH7YVzs6AMxC/KC1+Np7WZBaNIco7TEjlkthqxZbt8pU/ipD+hKjm80A==",
+            "dev": true,
+            "requires": {
+                "@tailwindcss/node": "4.1.4",
+                "@tailwindcss/oxide": "4.1.4",
+                "tailwindcss": "4.1.4"
+            }
+        },
         "@types/estree": {
             "version": "1.0.6",
             "dev": true
@@ -1618,10 +2282,26 @@
             "version": "3.0.0",
             "dev": true
         },
+        "detect-libc": {
+            "version": "2.0.3",
+            "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.3.tgz",
+            "integrity": "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw==",
+            "dev": true
+        },
         "electron-to-chromium": {
             "version": "1.5.55",
             "dev": true
         },
+        "enhanced-resolve": {
+            "version": "5.18.1",
+            "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.1.tgz",
+            "integrity": "sha512-ZSW3ma5GkcQBIpwZTSRAI8N71Uuwgs93IezB7mf7R60tC8ZbJideoDNKjHn2O9KIlx6rkGTTEk1xUCK2E1Y2Yg==",
+            "dev": true,
+            "requires": {
+                "graceful-fs": "^4.2.4",
+                "tapable": "^2.2.0"
+            }
+        },
         "esbuild": {
             "version": "0.21.5",
             "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
@@ -1668,10 +2348,111 @@
             "dev": true,
             "optional": true
         },
+        "graceful-fs": {
+            "version": "4.2.11",
+            "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+            "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+            "dev": true
+        },
         "hydefront": {
             "version": "3.4.1",
             "dev": true
         },
+        "jiti": {
+            "version": "2.4.2",
+            "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.4.2.tgz",
+            "integrity": "sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A==",
+            "dev": true
+        },
+        "lightningcss": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.29.2.tgz",
+            "integrity": "sha512-6b6gd/RUXKaw5keVdSEtqFVdzWnU5jMxTUjA2bVcMNPLwSQ08Sv/UodBVtETLCn7k4S1Ibxwh7k68IwLZPgKaA==",
+            "dev": true,
+            "requires": {
+                "detect-libc": "^2.0.3",
+                "lightningcss-darwin-arm64": "1.29.2",
+                "lightningcss-darwin-x64": "1.29.2",
+                "lightningcss-freebsd-x64": "1.29.2",
+                "lightningcss-linux-arm-gnueabihf": "1.29.2",
+                "lightningcss-linux-arm64-gnu": "1.29.2",
+                "lightningcss-linux-arm64-musl": "1.29.2",
+                "lightningcss-linux-x64-gnu": "1.29.2",
+                "lightningcss-linux-x64-musl": "1.29.2",
+                "lightningcss-win32-arm64-msvc": "1.29.2",
+                "lightningcss-win32-x64-msvc": "1.29.2"
+            }
+        },
+        "lightningcss-darwin-arm64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.29.2.tgz",
+            "integrity": "sha512-cK/eMabSViKn/PG8U/a7aCorpeKLMlK0bQeNHmdb7qUnBkNPnL+oV5DjJUo0kqWsJUapZsM4jCfYItbqBDvlcA==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-darwin-x64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.29.2.tgz",
+            "integrity": "sha512-j5qYxamyQw4kDXX5hnnCKMf3mLlHvG44f24Qyi2965/Ycz829MYqjrVg2H8BidybHBp9kom4D7DR5VqCKDXS0w==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-freebsd-x64": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.29.2.tgz",
+            "integrity": "sha512-wDk7M2tM78Ii8ek9YjnY8MjV5f5JN2qNVO+/0BAGZRvXKtQrBC4/cn4ssQIpKIPP44YXw6gFdpUF+Ps+RGsCwg==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-linux-arm-gnueabihf": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.29.2.tgz",
+            "integrity": "sha512-IRUrOrAF2Z+KExdExe3Rz7NSTuuJ2HvCGlMKoquK5pjvo2JY4Rybr+NrKnq0U0hZnx5AnGsuFHjGnNT14w26sg==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-linux-arm64-gnu": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.29.2.tgz",
+            "integrity": "sha512-KKCpOlmhdjvUTX/mBuaKemp0oeDIBBLFiU5Fnqxh1/DZ4JPZi4evEH7TKoSBFOSOV3J7iEmmBaw/8dpiUvRKlQ==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-linux-arm64-musl": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.29.2.tgz",
+            "integrity": "sha512-Q64eM1bPlOOUgxFmoPUefqzY1yV3ctFPE6d/Vt7WzLW4rKTv7MyYNky+FWxRpLkNASTnKQUaiMJ87zNODIrrKQ==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-linux-x64-gnu": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.29.2.tgz",
+            "integrity": "sha512-0v6idDCPG6epLXtBH/RPkHvYx74CVziHo6TMYga8O2EiQApnUPZsbR9nFNrg2cgBzk1AYqEd95TlrsL7nYABQg==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-linux-x64-musl": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.29.2.tgz",
+            "integrity": "sha512-rMpz2yawkgGT8RULc5S4WiZopVMOFWjiItBT7aSfDX4NQav6M44rhn5hjtkKzB+wMTRlLLqxkeYEtQ3dd9696w==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-win32-arm64-msvc": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.29.2.tgz",
+            "integrity": "sha512-nL7zRW6evGQqYVu/bKGK+zShyz8OVzsCotFgc7judbt6wnB2KbiKKJwBE4SGoDBQ1O94RjW4asrCjQL4i8Fhbw==",
+            "dev": true,
+            "optional": true
+        },
+        "lightningcss-win32-x64-msvc": {
+            "version": "1.29.2",
+            "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.29.2.tgz",
+            "integrity": "sha512-EdIUW3B2vLuHmv7urfzMI/h2fmlnOQBk1xlsDxkN1tCWKjNFjfLhGxYk8C8mzpSfr+A6jFFIi8fU6LbQGsRWjA==",
+            "dev": true,
+            "optional": true
+        },
         "lodash.castarray": {
             "version": "4.4.0",
             "dev": true
@@ -1781,6 +2562,12 @@
             "integrity": "sha512-1ZIUqtPITFbv/DxRmDr5/agPqJwF69d24m9qmM1939TJehgY539CtzeZRjbLt5G6fSy/7YqqYsfvoTEw9xUI2A==",
             "dev": true
         },
+        "tapable": {
+            "version": "2.2.1",
+            "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.1.tgz",
+            "integrity": "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ==",
+            "dev": true
+        },
         "terser": {
             "version": "5.36.0",
             "dev": true,
diff --git a/package.json b/package.json
index dce0a23b93f..6d2fd322259 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,7 @@
     },
     "devDependencies": {
         "@tailwindcss/typography": "^0.5.15",
+        "@tailwindcss/vite": "^4.1.4",
         "autoprefixer": "^10.4.20",
         "hydefront": "^3.3.0",
         "postcss": "^8.4.49",
diff --git a/packages/hyde/package.json b/packages/hyde/package.json
index 39be96d027e..ac3b610384c 100644
--- a/packages/hyde/package.json
+++ b/packages/hyde/package.json
@@ -7,6 +7,7 @@
     },
     "devDependencies": {
         "@tailwindcss/typography": "^0.5.2",
+        "@tailwindcss/vite": "^4.1.4",
         "autoprefixer": "^10.4.5",
         "hydefront": "^3.4.1",
         "laravel-mix": "^6.0.49",
diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index 3b0bff62979..66bbac7357c 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -4,6 +4,7 @@
 
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
+import tailwindcss from "@tailwindcss/vite";
 import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
@@ -56,6 +57,7 @@ export default defineConfig({
     css: {
         postcss: {
             plugins: [
+                tailwindcss(),
                 autoprefixer
             ]
         }
diff --git a/vite.config.js b/vite.config.js
index 3b0bff62979..66bbac7357c 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -4,6 +4,7 @@
 
 import { defineConfig } from 'vite';
 import { resolve } from 'path';
+import tailwindcss from "@tailwindcss/vite";
 import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
@@ -56,6 +57,7 @@ export default defineConfig({
     css: {
         postcss: {
             plugins: [
+                tailwindcss(),
                 autoprefixer
             ]
         }

From fb86a27bc4a6f6bda7ff2f5ff8dee3de5fbc2004 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 21:19:59 +0200
Subject: [PATCH 3957/4023] Use ESM extension for Vite configuration

---
 packages/hyde/{vite.config.js => vite.config.mjs} | 0
 vite.config.js => vite.config.mjs                 | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename packages/hyde/{vite.config.js => vite.config.mjs} (100%)
 rename vite.config.js => vite.config.mjs (100%)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.mjs
similarity index 100%
rename from packages/hyde/vite.config.js
rename to packages/hyde/vite.config.mjs
diff --git a/vite.config.js b/vite.config.mjs
similarity index 100%
rename from vite.config.js
rename to vite.config.mjs

From 6063edca34bf8a59c9627aafb864b48a1f09a0c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 21:25:39 +0200
Subject: [PATCH 3958/4023] Register plugin under the right key

---
 packages/hyde/vite.config.mjs | 5 ++---
 vite.config.mjs               | 5 ++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/packages/hyde/vite.config.mjs b/packages/hyde/vite.config.mjs
index 66bbac7357c..d6fd59b1da6 100644
--- a/packages/hyde/vite.config.mjs
+++ b/packages/hyde/vite.config.mjs
@@ -53,12 +53,11 @@ export default defineConfig({
         },
         middlewareMode: false,
     },
-    plugins: [hydeVitePlugin()],
+    plugins: [hydeVitePlugin(), tailwindcss()],
     css: {
         postcss: {
             plugins: [
-                tailwindcss(),
-                autoprefixer
+                autoprefixer,
             ]
         }
     },
diff --git a/vite.config.mjs b/vite.config.mjs
index 66bbac7357c..d6fd59b1da6 100644
--- a/vite.config.mjs
+++ b/vite.config.mjs
@@ -53,12 +53,11 @@ export default defineConfig({
         },
         middlewareMode: false,
     },
-    plugins: [hydeVitePlugin()],
+    plugins: [hydeVitePlugin(), tailwindcss()],
     css: {
         postcss: {
             plugins: [
-                tailwindcss(),
-                autoprefixer
+                autoprefixer,
             ]
         }
     },

From 3b90e57cc85f138e974bd42036a4470394e763ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 21:26:09 +0200
Subject: [PATCH 3959/4023] Build assets with Tailwind v4

---
 _media/app.css                  | 2 +-
 packages/hydefront/dist/app.css | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/_media/app.css b/_media/app.css
index fa7fcb7bb09..70e8a33e7ed 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.torchlight summary:focus{outline:2px solid transparent;outline-offset:2px}.torchlight details>summary::marker,.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-0\.5{margin-top:.125rem;margin-bottom:.125rem}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-1{margin-left:.25rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:.5rem}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-amber-500{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.border-blue-500{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-green-500{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-red-600{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.ease-linear{transition-timing-function:linear}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.focus\:opacity-100:focus{opacity:1}.focus\:grayscale-0:focus{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.group:hover .group-hover\:opacity-100{opacity:1}.group:hover .group-hover\:grayscale-0{--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */@layer properties{@supports ((-webkit-hyphens:none) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer base{pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:calc(var(--spacing)*4)}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){filter:blur(.095rem);opacity:.65;transition:filter .35s,opacity .35s}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur();opacity:1}.torchlight summary:focus{--tw-outline-style:none;outline-style:none}.torchlight details>summary::marker{display:none}.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::-moz-placeholder{opacity:1}::placeholder{opacity:1}@supports (not (-webkit-appearance:-apple-pay-button)) or (contain-intrinsic-size:1px){::-moz-placeholder{color:currentColor}::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::-moz-placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-red-500:oklch(63.7% .237 25.331);--color-red-600:oklch(57.7% .245 27.325);--color-amber-500:oklch(76.9% .188 70.08);--color-yellow-300:oklch(90.5% .182 98.111);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-green-500:oklch(72.3% .219 149.579);--color-blue-500:oklch(62.3% .214 259.815);--color-indigo-400:oklch(67.3% .182 276.935);--color-indigo-600:oklch(51.1% .262 276.966);--color-indigo-700:oklch(45.7% .24 277.023);--color-slate-100:oklch(96.8% .007 247.896);--color-slate-800:oklch(27.9% .041 260.031);--color-gray-50:oklch(98.5% .002 247.839);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-gray-600:oklch(44.6% .03 256.802);--color-gray-700:oklch(37.3% .034 259.733);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-sm:24rem;--container-lg:32rem;--container-xl:36rem;--container-2xl:42rem;--container-3xl:48rem;--container-7xl:80rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--text-3xl:1.875rem;--text-3xl--line-height: 1.2 ;--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5/2.25);--text-5xl:3rem;--text-5xl--line-height:1;--text-6xl:3.75rem;--text-6xl--line-height:1;--text-7xl:4.5rem;--text-7xl--line-height:1;--font-weight-light:300;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--font-weight-black:900;--tracking-tight:-.025em;--tracking-normal:0em;--tracking-wide:.025em;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--drop-shadow-2xl:0 25px 25px #00000026;--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--animate-spin:spin 1s linear infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer components;@layer utilities{.invisible{visibility:hidden}.visible{visibility:visible}.sr-only{clip:rect(0,0,0,0);white-space:nowrap;border-width:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing)*0)}.end-0{inset-inline-end:calc(var(--spacing)*0)}.-top-1{top:calc(var(--spacing)*-1)}.top-0{top:calc(var(--spacing)*0)}.top-2\.5{top:calc(var(--spacing)*2.5)}.top-4{top:calc(var(--spacing)*4)}.top-16{top:calc(var(--spacing)*16)}.top-auto{top:auto}.right-0{right:calc(var(--spacing)*0)}.right-1{right:calc(var(--spacing)*1)}.right-3{right:calc(var(--spacing)*3)}.right-4{right:calc(var(--spacing)*4)}.bottom-0{bottom:calc(var(--spacing)*0)}.bottom-4{bottom:calc(var(--spacing)*4)}.-left-64{left:calc(var(--spacing)*-64)}.left-0{left:calc(var(--spacing)*0)}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.col-12{grid-column:12}.col-auto{grid-column:auto}.float-end{float:inline-end}.float-left{float:left}.float-right{float:right}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.m-1{margin:calc(var(--spacing)*1)}.m-2{margin:calc(var(--spacing)*2)}.m-8{margin:calc(var(--spacing)*8)}.-mx-4{margin-inline:calc(var(--spacing)*-4)}.mx-0{margin-inline:calc(var(--spacing)*0)}.mx-0\.5{margin-inline:calc(var(--spacing)*.5)}.mx-3{margin-inline:calc(var(--spacing)*3)}.mx-4{margin-inline:calc(var(--spacing)*4)}.mx-8{margin-inline:calc(var(--spacing)*8)}.mx-auto{margin-inline:auto}.my-0{margin-block:calc(var(--spacing)*0)}.my-0\.5{margin-block:calc(var(--spacing)*.5)}.my-1{margin-block:calc(var(--spacing)*1)}.my-2{margin-block:calc(var(--spacing)*2)}.my-3{margin-block:calc(var(--spacing)*3)}.my-4{margin-block:calc(var(--spacing)*4)}.my-8{margin-block:calc(var(--spacing)*8)}.my-auto{margin-block:auto}.me-0{margin-inline-end:calc(var(--spacing)*0)}.me-2{margin-inline-end:calc(var(--spacing)*2)}.me-auto{margin-inline-end:auto}.prose{color:var(--tw-prose-body);--tw-prose-body:oklch(37.3% .034 259.733);--tw-prose-headings:oklch(21% .034 264.665);--tw-prose-lead:oklch(44.6% .03 256.802);--tw-prose-links:oklch(21% .034 264.665);--tw-prose-bold:oklch(21% .034 264.665);--tw-prose-counters:oklch(55.1% .027 264.364);--tw-prose-bullets:oklch(87.2% .01 258.338);--tw-prose-hr:oklch(92.8% .006 264.531);--tw-prose-quotes:oklch(21% .034 264.665);--tw-prose-quote-borders:oklch(92.8% .006 264.531);--tw-prose-captions:oklch(55.1% .027 264.364);--tw-prose-kbd:oklch(21% .034 264.665);--tw-prose-kbd-shadows:NaN NaN NaN;--tw-prose-code:oklch(21% .034 264.665);--tw-prose-pre-code:oklch(92.8% .006 264.531);--tw-prose-pre-bg:oklch(27.8% .033 256.848);--tw-prose-th-borders:oklch(87.2% .01 258.338);--tw-prose-td-borders:oklch(92.8% .006 264.531);--tw-prose-invert-body:oklch(87.2% .01 258.338);--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:oklch(70.7% .022 261.325);--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:oklch(70.7% .022 261.325);--tw-prose-invert-bullets:oklch(44.6% .03 256.802);--tw-prose-invert-hr:oklch(37.3% .034 259.733);--tw-prose-invert-quotes:oklch(96.7% .003 264.542);--tw-prose-invert-quote-borders:oklch(37.3% .034 259.733);--tw-prose-invert-captions:oklch(70.7% .022 261.325);--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:oklch(87.2% .01 258.338);--tw-prose-invert-pre-bg:#00000080;--tw-prose-invert-th-borders:oklch(44.6% .03 256.802);--tw-prose-invert-td-borders:oklch(37.3% .034 259.733);max-width:96ch;font-size:1rem;line-height:1.5em}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);margin-top:1.2em;margin-bottom:1.2em;font-size:1.25em;line-height:1.6}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:decimal}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:disc}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.25em;font-weight:600}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;margin-top:1em;margin-bottom:1em;padding-top:.25em;padding-bottom:.25em;padding-left:.75em;line-height:1.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-top:.25em;margin-bottom:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before,.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:0;margin-bottom:.888889em;font-size:2.25em;font-weight:800;line-height:1.11111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.75em;font-size:1.5em;font-weight:700;line-height:1.33333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.6em;margin-bottom:.6em;font-size:1.25em;font-weight:600;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.5em;font-weight:600;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em;display:block}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px rgb(var(--tw-prose-kbd-shadows)/10%);padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;border-radius:.3125rem;padding-inline-start:.375em;font-family:inherit;font-size:.875em;font-weight:500}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-size:.875em;font-weight:600}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);padding-top:.857143em;padding-inline-end:1.14286em;padding-bottom:.857143em;background-color:#292d3e;border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;padding-inline-start:1.14286em;font-size:.875em;font-weight:400;line-height:1.71429;overflow-x:auto}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit;background-color:#0000;border-width:0;border-radius:0;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){table-layout:auto;width:100%;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.71429}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);vertical-align:bottom;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em;font-weight:600}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);margin-top:.857143em;font-size:.875em;line-height:1.42857}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.571429em;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;vertical-align:top;word-break:break-all;background-color:#80808033;border-radius:4px;max-width:80vw;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px;overflow-x:auto}.-mt-4{margin-top:calc(var(--spacing)*-4)}.mt-1{margin-top:calc(var(--spacing)*1)}.mt-2{margin-top:calc(var(--spacing)*2)}.mt-3{margin-top:calc(var(--spacing)*3)}.mt-4{margin-top:calc(var(--spacing)*4)}.mt-6{margin-top:calc(var(--spacing)*6)}.mt-8{margin-top:calc(var(--spacing)*8)}.mt-12{margin-top:calc(var(--spacing)*12)}.mt-auto{margin-top:auto}.mr-1{margin-right:calc(var(--spacing)*1)}.mr-3{margin-right:calc(var(--spacing)*3)}.mr-4{margin-right:calc(var(--spacing)*4)}.mr-auto{margin-right:auto}.mb-0{margin-bottom:calc(var(--spacing)*0)}.mb-1{margin-bottom:calc(var(--spacing)*1)}.mb-2{margin-bottom:calc(var(--spacing)*2)}.mb-3{margin-bottom:calc(var(--spacing)*3)}.mb-4{margin-bottom:calc(var(--spacing)*4)}.mb-8{margin-bottom:calc(var(--spacing)*8)}.mb-12{margin-bottom:calc(var(--spacing)*12)}.mb-auto{margin-bottom:auto}.-ml-2{margin-left:calc(var(--spacing)*-2)}.-ml-4{margin-left:calc(var(--spacing)*-4)}.-ml-6{margin-left:calc(var(--spacing)*-6)}.-ml-8{margin-left:calc(var(--spacing)*-8)}.ml-1{margin-left:calc(var(--spacing)*1)}.ml-3{margin-left:calc(var(--spacing)*3)}.ml-4{margin-left:calc(var(--spacing)*4)}.ml-auto{margin-left:auto}.block{display:block}.block\!{display:block!important}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-0\.5{height:calc(var(--spacing)*.5)}.h-1{height:calc(var(--spacing)*1)}.h-4{height:calc(var(--spacing)*4)}.h-5{height:calc(var(--spacing)*5)}.h-6{height:calc(var(--spacing)*6)}.h-8{height:calc(var(--spacing)*8)}.h-16{height:calc(var(--spacing)*16)}.h-24{height:calc(var(--spacing)*24)}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-5{width:calc(var(--spacing)*5)}.w-6{width:calc(var(--spacing)*6)}.w-8{width:calc(var(--spacing)*8)}.w-16{width:calc(var(--spacing)*16)}.w-64{width:calc(var(--spacing)*64)}.w-80{width:calc(var(--spacing)*80)}.w-96{width:calc(var(--spacing)*96)}.w-100{width:calc(var(--spacing)*100)}.w-\[70ch\]{width:70ch}.w-auto{width:auto}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:var(--container-3xl)}.max-w-7xl{max-width:var(--container-7xl)}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:var(--container-lg)}.max-w-sm{max-width:var(--container-sm)}.min-w-screen{min-width:100vw}.flex-shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.flex-grow,.flex-grow-1,.grow{flex-grow:1}.table-auto{table-layout:auto}.table-fixed{table-layout:fixed}.border-collapse{border-collapse:collapse}.border-separate{border-collapse:separate}.origin-center{transform-origin:50%}.-rotate-45{rotate:-45deg}.rotate-45{rotate:45deg}.transform{transform:var(--tw-rotate-x,)var(--tw-rotate-y,)var(--tw-rotate-z,)var(--tw-skew-x,)var(--tw-skew-y,)}.animate-spin{animation:var(--animate-spin)}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:calc(var(--spacing)*2)}.list-none{list-style-type:none}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.flex-col{flex-direction:column}.flex-row{flex-direction:row}.flex-nowrap{flex-wrap:nowrap}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-4{gap:calc(var(--spacing)*4)}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*4)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*4)*calc(1 - var(--tw-space-y-reverse)))}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px*var(--tw-divide-y-reverse));border-bottom-width:calc(1px*calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-gray-300>:not(:last-child)){border-color:var(--color-gray-300)}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.overflow-y-auto{overflow-y:auto}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.rounded{border-radius:.25rem}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-t{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.rounded-l{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-tl{border-top-left-radius:.25rem}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.rounded-tr{border-top-right-radius:.25rem}.rounded-b{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-br{border-bottom-right-radius:.25rem}.rounded-bl{border-bottom-left-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-4{border-style:var(--tw-border-style);border-width:4px}.border-x{border-inline-style:var(--tw-border-style);border-inline-width:1px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-l-4{border-left-style:var(--tw-border-style);border-left-width:4px}.border-l-\[0\.325rem\]{border-left-style:var(--tw-border-style);border-left-width:.325rem}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-dotted{--tw-border-style:dotted;border-style:dotted}.border-double{--tw-border-style:double;border-style:double}.border-none{--tw-border-style:none;border-style:none}.border-solid{--tw-border-style:solid;border-style:solid}.border-amber-500{border-color:var(--color-amber-500)}.border-blue-500{border-color:var(--color-blue-500)}.border-gray-200{border-color:var(--color-gray-200)}.border-gray-300{border-color:var(--color-gray-300)}.border-gray-500{border-color:var(--color-gray-500)}.border-gray-900{border-color:var(--color-gray-900)}.border-green-500{border-color:var(--color-green-500)}.border-indigo-500{border-color:#5956eb}.border-red-600{border-color:var(--color-red-600)}.border-transparent{border-color:#0000}.border-yellow-400{border-color:var(--color-yellow-400)}.border-t-transparent{border-top-color:#0000}.border-r-gray-900{border-right-color:var(--color-gray-900)}.bg-black{background-color:var(--color-black)}.bg-black\/5{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.bg-black\/5{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.bg-black\/50{background-color:#00000080}@supports (color:color-mix(in lab,red,red)){.bg-black\/50{background-color:color-mix(in oklab,var(--color-black)50%,transparent)}}.bg-current{background-color:currentColor}.bg-gray-50{background-color:var(--color-gray-50)}.bg-gray-100{background-color:var(--color-gray-100)}.bg-gray-200{background-color:var(--color-gray-200)}.bg-gray-500{background-color:var(--color-gray-500)}.bg-indigo-600{background-color:var(--color-indigo-600)}.bg-slate-100{background-color:var(--color-slate-100)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-yellow-400{background-color:var(--color-yellow-400)}.bg-linear-to-br{--tw-gradient-position:to bottom right;background-image:linear-gradient(var(--tw-gradient-stops))}@supports (background-image:linear-gradient(in lab,red,red)){.bg-linear-to-br{--tw-gradient-position:to bottom right in oklab}}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:var(--color-black)}.fill-current{fill:currentColor}.p-0{padding:calc(var(--spacing)*0)}.p-2{padding:calc(var(--spacing)*2)}.p-3{padding:calc(var(--spacing)*3)}.p-4{padding:calc(var(--spacing)*4)}.p-8{padding:calc(var(--spacing)*8)}.p-12{padding:calc(var(--spacing)*12)}.px-0{padding-inline:calc(var(--spacing)*0)}.px-1{padding-inline:calc(var(--spacing)*1)}.px-2{padding-inline:calc(var(--spacing)*2)}.px-3{padding-inline:calc(var(--spacing)*3)}.px-4{padding-inline:calc(var(--spacing)*4)}.px-5{padding-inline:calc(var(--spacing)*5)}.px-6{padding-inline:calc(var(--spacing)*6)}.px-8{padding-inline:calc(var(--spacing)*8)}.py-0{padding-block:calc(var(--spacing)*0)}.py-1{padding-block:calc(var(--spacing)*1)}.py-2{padding-block:calc(var(--spacing)*2)}.py-3{padding-block:calc(var(--spacing)*3)}.py-4{padding-block:calc(var(--spacing)*4)}.py-5{padding-block:calc(var(--spacing)*5)}.py-6{padding-block:calc(var(--spacing)*6)}.py-8{padding-block:calc(var(--spacing)*8)}.py-12{padding-block:calc(var(--spacing)*12)}.py-16{padding-block:calc(var(--spacing)*16)}.py-24{padding-block:calc(var(--spacing)*24)}.py-32{padding-block:calc(var(--spacing)*32)}.ps-0{padding-inline-start:calc(var(--spacing)*0)}.ps-2{padding-inline-start:calc(var(--spacing)*2)}.ps-3{padding-inline-start:calc(var(--spacing)*3)}.pe-0{padding-inline-end:calc(var(--spacing)*0)}.pe-2{padding-inline-end:calc(var(--spacing)*2)}.pe-4{padding-inline-end:calc(var(--spacing)*4)}.pt-3{padding-top:calc(var(--spacing)*3)}.pt-4{padding-top:calc(var(--spacing)*4)}.pt-8{padding-top:calc(var(--spacing)*8)}.pt-10{padding-top:calc(var(--spacing)*10)}.pb-2{padding-bottom:calc(var(--spacing)*2)}.pb-3{padding-bottom:calc(var(--spacing)*3)}.pb-4{padding-bottom:calc(var(--spacing)*4)}.pb-8{padding-bottom:calc(var(--spacing)*8)}.pb-12{padding-bottom:calc(var(--spacing)*12)}.pl-2{padding-left:calc(var(--spacing)*2)}.pl-4{padding-left:calc(var(--spacing)*4)}.pl-5{padding-left:calc(var(--spacing)*5)}.pl-8{padding-left:calc(var(--spacing)*8)}.text-center{text-align:center}.text-end{text-align:end}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.leading-7{--tw-leading:calc(var(--spacing)*7);line-height:calc(var(--spacing)*7)}.leading-8{--tw-leading:calc(var(--spacing)*8);line-height:calc(var(--spacing)*8)}.leading-10{--tw-leading:calc(var(--spacing)*10);line-height:calc(var(--spacing)*10)}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-black{--tw-font-weight:var(--font-weight-black);font-weight:var(--font-weight-black)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-extrabold{--tw-font-weight:var(--font-weight-extrabold);font-weight:var(--font-weight-extrabold)}.font-light{--tw-font-weight:var(--font-weight-light);font-weight:var(--font-weight-light)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-normal{--tw-tracking:var(--tracking-normal);letter-spacing:var(--tracking-normal)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.text-nowrap{text-wrap:nowrap}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.text-black{color:var(--color-black)}.text-blue-500{color:var(--color-blue-500)}.text-gray-100{color:var(--color-gray-100)}.text-gray-200{color:var(--color-gray-200)}.text-gray-400{color:var(--color-gray-400)}.text-gray-500{color:var(--color-gray-500)}.text-gray-600{color:var(--color-gray-600)}.text-gray-700{color:var(--color-gray-700)}.text-green-500{color:var(--color-green-500)}.text-indigo-500{color:#5956eb}.text-indigo-600{color:var(--color-indigo-600)}.text-red-500{color:var(--color-red-500)}.text-transparent{color:#0000}.text-white{color:var(--color-white)}.text-yellow-500{color:var(--color-yellow-500)}.capitalize{text-transform:capitalize}.lowercase{text-transform:lowercase}.uppercase{text-transform:uppercase}.italic{font-style:italic}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a),0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a),0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-1{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(1px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-gray-900\/5{--tw-ring-color:#1018280d}@supports (color:color-mix(in lab,red,red)){.ring-gray-900\/5{--tw-ring-color:color-mix(in oklab,var(--color-gray-900)5%,transparent)}}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.drop-shadow-2xl{--tw-drop-shadow-size:drop-shadow(0 25px 25px var(--tw-drop-shadow-color,#00000026));--tw-drop-shadow:drop-shadow(var(--drop-shadow-2xl));filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.invert{--tw-invert:invert(100%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-shadow{transition-property:box-shadow;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-75{--tw-duration:75ms;transition-duration:75ms}.duration-250{--tw-duration:.25s;transition-duration:.25s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.ease-linear{--tw-ease:linear;transition-timing-function:linear}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}@media (hover:hover){.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}.group-hover\:grayscale-0:is(:where(.group):hover *){--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.hover\:bg-black\/5:hover{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/5:hover{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.hover\:bg-black\/10:hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/10:hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-200\/20:hover{background-color:color-mix(in oklab,var(--color-gray-200)20%,transparent)}}.hover\:bg-gray-600:hover{background-color:var(--color-gray-600)}.hover\:bg-indigo-500:hover{background-color:#5956eb}.hover\:text-gray-700:hover{color:var(--color-gray-700)}.hover\:text-gray-900:hover{color:var(--color-gray-900)}.hover\:text-indigo-600:hover{color:var(--color-indigo-600)}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:shadow-xl:hover{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}.focus\:not-sr-only:focus{clip:auto;white-space:normal;width:auto;height:auto;margin:0;padding:0;position:static;overflow:visible}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-inline:auto}.focus\:mt-2:focus{margin-top:calc(var(--spacing)*2)}.focus\:w-64:focus{width:calc(var(--spacing)*64)}.focus\:bg-gray-700:focus{background-color:var(--color-gray-700)}.focus\:bg-indigo-700:focus{background-color:var(--color-indigo-700)}.focus\:p-2:focus{padding:calc(var(--spacing)*2)}.focus\:opacity-100:focus{opacity:1}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(2px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-gray-700:focus{--tw-ring-color:var(--color-gray-700)}.focus\:ring-indigo-600:focus{--tw-ring-color:var(--color-indigo-600)}.focus\:grayscale-0:focus{--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}@media (min-width:40rem){.sm\:-mx-6{margin-inline:calc(var(--spacing)*-6)}.sm\:mx-auto{margin-inline:auto}.sm\:mt-4{margin-top:calc(var(--spacing)*4)}.sm\:mb-0{margin-bottom:calc(var(--spacing)*0)}.sm\:block{display:block}.sm\:max-w-xl{max-width:var(--container-xl)}.sm\:rounded-lg{border-radius:var(--radius-lg)}.sm\:px-6{padding-inline:calc(var(--spacing)*6)}.sm\:px-10{padding-inline:calc(var(--spacing)*10)}.sm\:py-12{padding-block:calc(var(--spacing)*12)}.sm\:leading-none{--tw-leading:1;line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:48rem){.md\:visible{visibility:visible}.md\:top-0{top:calc(var(--spacing)*0)}.md\:left-0{left:calc(var(--spacing)*0)}.md\:left-64{left:calc(var(--spacing)*64)}.md\:mx-2{margin-inline:calc(var(--spacing)*2)}.md\:my-0{margin-block:calc(var(--spacing)*0)}.md\:my-6{margin-block:calc(var(--spacing)*6)}.md\:mt-0{margin-top:calc(var(--spacing)*0)}.md\:mt-8{margin-top:calc(var(--spacing)*8)}.md\:mb-12{margin-bottom:calc(var(--spacing)*12)}.md\:ml-0{margin-left:calc(var(--spacing)*0)}.md\:block{display:block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:inline-block{display:inline-block}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:var(--container-2xl)}.md\:max-w-none{max-width:none}.md\:grow{flex-grow:1}.md\:grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{--tw-border-style:none;border-style:none}.md\:bg-transparent{background-color:#0000}.md\:bg-white{background-color:var(--color-white)}.md\:bg-left{background-position:0}.md\:px-16{padding-inline:calc(var(--spacing)*16)}.md\:py-0{padding-block:calc(var(--spacing)*0)}.md\:py-16{padding-block:calc(var(--spacing)*16)}.md\:pb-0{padding-bottom:calc(var(--spacing)*0)}.md\:pl-0{padding-left:calc(var(--spacing)*0)}.md\:text-center{text-align:center}.md\:text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.md\:text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.md\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.md\:text-6xl{font-size:var(--text-6xl);line-height:var(--tw-leading,var(--text-6xl--line-height))}.md\:shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:64rem){.lg\:mb-12{margin-bottom:calc(var(--spacing)*12)}.lg\:ml-8{margin-left:calc(var(--spacing)*8)}.lg\:flex{display:flex}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.lg\:text-7xl{font-size:var(--text-7xl);line-height:var(--tw-leading,var(--text-7xl--line-height))}.lg\:text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}}@media (min-width:80rem){.xl\:mb-16{margin-bottom:calc(var(--spacing)*16)}}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}:where(.dark\:divide-gray-700:is(.dark *)>:not(:last-child)){border-color:var(--color-gray-700)}.dark\:border-\[\#1b2533\]:is(.dark *){border-color:#1b2533}.dark\:border-gray-700:is(.dark *){border-color:var(--color-gray-700)}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:bg-black\/10:is(.dark *){background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:bg-gray-600:is(.dark *){background-color:var(--color-gray-600)}.dark\:bg-gray-700:is(.dark *){background-color:var(--color-gray-700)}.dark\:bg-gray-800:is(.dark *){background-color:var(--color-gray-800)}.dark\:bg-gray-900:is(.dark *){background-color:var(--color-gray-900)}.dark\:bg-slate-800:is(.dark *){background-color:var(--color-slate-800)}.dark\:bg-yellow-300:is(.dark *){background-color:var(--color-yellow-300)}.dark\:fill-gray-200:is(.dark *){fill:var(--color-gray-200)}.dark\:fill-white:is(.dark *){fill:var(--color-white)}.dark\:font-medium:is(.dark *){--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.dark\:text-gray-100:is(.dark *){color:var(--color-gray-100)}.dark\:text-gray-200:is(.dark *){color:var(--color-gray-200)}.dark\:text-gray-300:is(.dark *){color:var(--color-gray-300)}.dark\:text-gray-400:is(.dark *){color:var(--color-gray-400)}.dark\:text-indigo-400:is(.dark *){color:var(--color-indigo-400)}.dark\:text-white:is(.dark *){color:var(--color-white)}@media (hover:hover){.dark\:group-hover\:text-white:is(.dark *):is(:where(.group):hover *){color:var(--color-white)}.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:hover\:bg-gray-500:is(.dark *):hover{background-color:var(--color-gray-500)}.dark\:hover\:text-white:is(.dark *):hover{color:var(--color-white)}}.dark\:focus\:text-white:is(.dark *):focus{color:var(--color-white)}.dark\:focus\:ring-indigo-500:is(.dark *):focus{--tw-ring-color:#5956eb}@media (min-width:48rem){.dark\:md\:bg-transparent:is(.dark *){background-color:#0000}}@media print{.print\:top-0{top:calc(var(--spacing)*0)}.print\:hidden{display:none}}.prose-h1\:mb-3 :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:calc(var(--spacing)*3)}.prose-p\:my-3 :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-block:calc(var(--spacing)*3)}.prose-img\:inline :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){display:inline}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}
diff --git a/packages/hydefront/dist/app.css b/packages/hydefront/dist/app.css
index 8cc270c5bc4..70e8a33e7ed 100644
--- a/packages/hydefront/dist/app.css
+++ b/packages/hydefront/dist/app.css
@@ -1 +1 @@
-.table-of-contents{padding-bottom:.75rem}.table-of-contents>li{margin-top:.35rem;margin-bottom:.35rem}.table-of-contents ul{padding-left:.5rem}.table-of-contents a{position:relative;margin-left:-2rem;display:block;padding-left:2rem;opacity:.8;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s}.table-of-contents a:hover{background-color:#e5e7eb33;opacity:1}.table-of-contents a:before{margin-right:.25rem;font-size:75%;opacity:.5;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;--tw-content: "#";content:var(--tw-content)}.table-of-contents a:hover:before{opacity:1}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{width:-moz-fit-content;width:fit-content}.prose :is(h1,h2,h3,h4,h5,h6):hover .heading-permalink,.prose :is(h1,h2,h3,h4,h5,h6):focus .heading-permalink{opacity:.75;--tw-grayscale: grayscale(100%);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.1s;transition-timing-function:cubic-bezier(0,0,.2,1)}.heading-permalink{margin-left:.25rem;scroll-margin:1rem;padding-left:.25rem;padding-right:.25rem;opacity:0;transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.3s;transition-timing-function:linear}.heading-permalink:before{--tw-content: "#";content:var(--tw-content)}.heading-permalink:hover,.heading-permalink:focus{opacity:1;--tw-grayscale: grayscale(0);filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:1rem}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){transition:filter .35s,opacity .35s;filter:blur(.095rem);opacity:.65}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur(0px);opacity:1}.prose blockquote.info{--tw-border-opacity: 1;border-color:rgb(59 130 246 / var(--tw-border-opacity, 1))}.prose blockquote.success{--tw-border-opacity: 1;border-color:rgb(34 197 94 / var(--tw-border-opacity, 1))}.prose blockquote.warning{--tw-border-opacity: 1;border-color:rgb(245 158 11 / var(--tw-border-opacity, 1))}.prose blockquote.danger{--tw-border-opacity: 1;border-color:rgb(220 38 38 / var(--tw-border-opacity, 1))}*,:before,:after{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgb(59 130 246 / .5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }*,:before,:after{box-sizing:border-box;border-width:0;border-style:solid;border-color:#e5e7eb}:before,:after{--tw-content: ""}html,:host{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji";font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dl,dd,h1,h2,h3,h4,h5,h6,hr,figure,p,pre{margin:0}fieldset{margin:0;padding:0}legend{padding:0}ol,ul,menu{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}button,[role=button]{cursor:pointer}:disabled{cursor:default}img,svg,video,canvas,audio,iframe,embed,object{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.container{width:100%}@media (min-width: 640px){.container{max-width:640px}}@media (min-width: 768px){.container{max-width:768px}}@media (min-width: 1024px){.container{max-width:1024px}}@media (min-width: 1280px){.container{max-width:1280px}}@media (min-width: 1536px){.container{max-width:1536px}}.prose{color:var(--tw-prose-body);max-width:96ch}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);font-size:1.25em;line-height:1.6;margin-top:1.2em;margin-bottom:1.2em}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;text-decoration:none;font-weight:500}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:disc;margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{font-weight:400;color:var(--tw-prose-counters)}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.25em}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";margin-top:1em;margin-bottom:1em;padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;line-height:1.25em;padding-left:.75em;padding-top:.25em;padding-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{padding-right:.25em;margin-top:.25em;margin-bottom:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before{content:unset}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:800;font-size:2.25em;margin-top:0;margin-bottom:.8888889em;line-height:1.1111111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:900;color:inherit}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:700;font-size:1.5em;margin-top:1.5em;margin-bottom:.75em;line-height:1.3333333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:800;color:inherit}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;font-size:1.25em;margin-top:1.6em;margin-bottom:.6em;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;margin-top:1.5em;margin-bottom:.5em;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:700;color:inherit}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){display:block;margin-top:2em;margin-bottom:2em}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-family:inherit;color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows) / 10%),0 3px rgb(var(--tw-prose-kbd-shadows) / 10%);font-size:.875em;border-radius:.3125rem;padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;padding-inline-start:.375em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:600;font-size:.875em}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:unset}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);background-color:#292d3e;overflow-x:auto;font-weight:400;font-size:.875em;line-height:1.7142857;margin-top:1rem;margin-bottom:1rem;border-radius:.25rem;padding-top:.8571429em;padding-inline-end:1.1428571em;padding-bottom:.8571429em;padding-inline-start:1.1428571em}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:"Fira Code Regular",Consolas,Monospace,"Courier New"}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){background-color:transparent;border-width:0;border-radius:0;padding:0;font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:none}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){width:100%;table-layout:auto;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.7142857}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);font-weight:600;vertical-align:bottom;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);font-size:.875em;line-height:1.4285714;margin-top:.8571429em}.prose{--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgb(0 0 0 / 50%);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;font-size:1rem;line-height:1.5em}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.5714286em;padding-inline-end:.5714286em;padding-bottom:.5714286em;padding-inline-start:.5714286em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;background-color:#80808033;padding-left:4px;padding-right:4px;margin-left:-2px;margin-right:1px;border-radius:4px;max-width:80vw;overflow-x:auto;vertical-align:top;word-break:break-all}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.visible{visibility:visible}.invisible{visibility:hidden}.static{position:static}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{top:0;right:0;bottom:0;left:0}.-left-64{left:-16rem}.-top-1{top:-.25rem}.bottom-0{bottom:0}.bottom-4{bottom:1rem}.left-0{left:0}.left-80{left:20rem}.right-0{right:0}.right-1{right:.25rem}.right-3{right:.75rem}.right-4{right:1rem}.top-0{top:0}.top-16{top:4rem}.top-2\.5{top:.625rem}.top-4{top:1rem}.top-auto{top:auto}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.float-right{float:right}.float-left{float:left}.m-2{margin:.5rem}.m-8{margin:2rem}.-mx-4{margin-left:-1rem;margin-right:-1rem}.mx-0{margin-left:0;margin-right:0}.mx-3{margin-left:.75rem;margin-right:.75rem}.mx-4{margin-left:1rem;margin-right:1rem}.mx-8{margin-left:2rem;margin-right:2rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-8{margin-top:2rem;margin-bottom:2rem}.my-auto{margin-top:auto;margin-bottom:auto}.-ml-2{margin-left:-.5rem}.-ml-4{margin-left:-1rem}.-ml-6{margin-left:-1.5rem}.-ml-8{margin-left:-2rem}.-mt-4{margin-top:-1rem}.mb-0{margin-bottom:0}.mb-2{margin-bottom:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.ml-4{margin-left:1rem}.ml-auto{margin-left:auto}.mr-1{margin-right:.25rem}.mr-4{margin-right:1rem}.mr-auto{margin-right:auto}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-3{margin-top:.75rem}.mt-4{margin-top:1rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.\!block{display:block!important}.block{display:block}.inline{display:inline}.flex{display:flex}.contents{display:contents}.hidden{display:none}.h-0\.5{height:.125rem}.h-1{height:.25rem}.h-16{height:4rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-1{width:.25rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-\[70ch\]{width:70ch}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:48rem}.max-w-7xl{max-width:80rem}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:32rem}.max-w-sm{max-width:24rem}.flex-shrink-0{flex-shrink:0}.flex-grow{flex-grow:1}.origin-center{transform-origin:center}.-rotate-45{--tw-rotate: -45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.rotate-45{--tw-rotate: 45deg;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skew(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(360deg)}}.animate-spin{animation:spin 1s linear infinite}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.list-none{list-style-type:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-4{gap:1rem}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse: 0;margin-top:calc(1rem * calc(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem * var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.overflow-x-hidden{overflow-x:hidden}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.whitespace-nowrap{white-space:nowrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border-2{border-width:2px}.border-4{border-width:4px}.border-y{border-top-width:1px;border-bottom-width:1px}.border-b{border-bottom-width:1px}.border-l-4{border-left-width:4px}.border-l-\[0\.325rem\]{border-left-width:.325rem}.border-t{border-top-width:1px}.border-gray-200{--tw-border-opacity: 1;border-color:rgb(229 231 235 / var(--tw-border-opacity, 1))}.border-gray-300{--tw-border-opacity: 1;border-color:rgb(209 213 219 / var(--tw-border-opacity, 1))}.border-gray-500{--tw-border-opacity: 1;border-color:rgb(107 114 128 / var(--tw-border-opacity, 1))}.border-indigo-500{--tw-border-opacity: 1;border-color:rgb(89 86 235 / var(--tw-border-opacity, 1))}.border-transparent{border-color:transparent}.border-yellow-400{--tw-border-opacity: 1;border-color:rgb(250 204 21 / var(--tw-border-opacity, 1))}.border-t-transparent{border-top-color:transparent}.bg-black{--tw-bg-opacity: 1;background-color:rgb(0 0 0 / var(--tw-bg-opacity, 1))}.bg-black\/5{background-color:#0000000d}.bg-black\/50{background-color:#00000080}.bg-current{background-color:currentColor}.bg-gray-100{--tw-bg-opacity: 1;background-color:rgb(243 244 246 / var(--tw-bg-opacity, 1))}.bg-gray-200{--tw-bg-opacity: 1;background-color:rgb(229 231 235 / var(--tw-bg-opacity, 1))}.bg-gray-50{--tw-bg-opacity: 1;background-color:rgb(249 250 251 / var(--tw-bg-opacity, 1))}.bg-slate-100{--tw-bg-opacity: 1;background-color:rgb(241 245 249 / var(--tw-bg-opacity, 1))}.bg-transparent{background-color:transparent}.bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.bg-yellow-400{--tw-bg-opacity: 1;background-color:rgb(250 204 21 / var(--tw-bg-opacity, 1))}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:#000}.fill-current{fill:currentColor}.p-0{padding:0}.p-12{padding:3rem}.p-2{padding:.5rem}.p-4{padding:1rem}.px-0{padding-left:0;padding-right:0}.px-1{padding-left:.25rem;padding-right:.25rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.px-8{padding-left:2rem;padding-right:2rem}.py-0{padding-top:0;padding-bottom:0}.py-1{padding-top:.25rem;padding-bottom:.25rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-16{padding-top:4rem;padding-bottom:4rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.py-24{padding-top:6rem;padding-bottom:6rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.py-32{padding-top:8rem;padding-bottom:8rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-8{padding-top:2rem;padding-bottom:2rem}.pb-12{padding-bottom:3rem}.pb-2{padding-bottom:.5rem}.pb-3{padding-bottom:.75rem}.pl-2{padding-left:.5rem}.pl-4{padding-left:1rem}.pl-5{padding-left:1.25rem}.pl-8{padding-left:2rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.font-sans{font-family:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji",Segoe UI Symbol,"Noto Color Emoji"}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-5xl{font-size:3rem;line-height:1}.text-\[90\%\]{font-size:90%}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.font-black{font-weight:900}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-light{font-weight:300}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.leading-10{line-height:2.5rem}.leading-8{line-height:2rem}.leading-normal{line-height:1.5}.leading-relaxed{line-height:1.625}.tracking-normal{letter-spacing:0em}.tracking-tight{letter-spacing:-.025em}.tracking-wide{letter-spacing:.025em}.text-black{--tw-text-opacity: 1;color:rgb(0 0 0 / var(--tw-text-opacity, 1))}.text-gray-100{--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.text-gray-200{--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.text-gray-500{--tw-text-opacity: 1;color:rgb(107 114 128 / var(--tw-text-opacity, 1))}.text-gray-600{--tw-text-opacity: 1;color:rgb(75 85 99 / var(--tw-text-opacity, 1))}.text-gray-700{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.text-indigo-500{--tw-text-opacity: 1;color:rgb(89 86 235 / var(--tw-text-opacity, 1))}.text-indigo-600{--tw-text-opacity: 1;color:rgb(79 70 229 / var(--tw-text-opacity, 1))}.text-transparent{color:transparent}.text-white{--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.shadow-lg{--tw-shadow: 0 10px 15px -3px rgb(0 0 0 / .1), 0 4px 6px -4px rgb(0 0 0 / .1);--tw-shadow-colored: 0 10px 15px -3px var(--tw-shadow-color), 0 4px 6px -4px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow: 0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1);--tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.drop-shadow-2xl{--tw-drop-shadow: drop-shadow(0 25px 25px rgb(0 0 0 / .15));filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-opacity{transition-property:opacity;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-300{transition-duration:.3s}.duration-75{transition-duration:75ms}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.dark\:prose-invert:is(.dark *){--tw-prose-body: var(--tw-prose-invert-body);--tw-prose-headings: var(--tw-prose-invert-headings);--tw-prose-lead: var(--tw-prose-invert-lead);--tw-prose-links: var(--tw-prose-invert-links);--tw-prose-bold: var(--tw-prose-invert-bold);--tw-prose-counters: var(--tw-prose-invert-counters);--tw-prose-bullets: var(--tw-prose-invert-bullets);--tw-prose-hr: var(--tw-prose-invert-hr);--tw-prose-quotes: var(--tw-prose-invert-quotes);--tw-prose-quote-borders: var(--tw-prose-invert-quote-borders);--tw-prose-captions: var(--tw-prose-invert-captions);--tw-prose-kbd: var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows: var(--tw-prose-invert-kbd-shadows);--tw-prose-code: var(--tw-prose-invert-code);--tw-prose-pre-code: var(--tw-prose-invert-pre-code);--tw-prose-pre-bg: var(--tw-prose-invert-pre-bg);--tw-prose-th-borders: var(--tw-prose-invert-th-borders);--tw-prose-td-borders: var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.hover\:bg-black\/10:hover{background-color:#0000001a}.hover\:bg-black\/5:hover{background-color:#0000000d}.hover\:text-gray-700:hover{--tw-text-opacity: 1;color:rgb(55 65 81 / var(--tw-text-opacity, 1))}.hover\:text-gray-900:hover{--tw-text-opacity: 1;color:rgb(17 24 39 / var(--tw-text-opacity, 1))}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.focus\:not-sr-only:focus{position:static;width:auto;height:auto;padding:0;margin:0;overflow:visible;clip:auto;white-space:normal}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-left:auto;margin-right:auto}.focus\:mt-2:focus{margin-top:.5rem}.focus\:w-64:focus{width:16rem}.focus\:p-2:focus{padding:.5rem}.group:hover .group-hover\:opacity-100{opacity:1}.prose-h1\:mb-3 :is(:where(h1):not(:where([class~=not-prose],[class~=not-prose] *))){margin-bottom:.75rem}.prose-p\:my-3 :is(:where(p):not(:where([class~=not-prose],[class~=not-prose] *))){margin-top:.75rem;margin-bottom:.75rem}.prose-img\:inline :is(:where(img):not(:where([class~=not-prose],[class~=not-prose] *))){display:inline}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}.dark\:border-\[\#1b2533\]:is(.dark *){--tw-border-opacity: 1;border-color:rgb(27 37 51 / var(--tw-border-opacity, 1))}.dark\:border-gray-700:is(.dark *){--tw-border-opacity: 1;border-color:rgb(55 65 81 / var(--tw-border-opacity, 1))}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}.dark\:bg-gray-700:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(55 65 81 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-800:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(31 41 55 / var(--tw-bg-opacity, 1))}.dark\:bg-gray-900:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(17 24 39 / var(--tw-bg-opacity, 1))}.dark\:bg-yellow-300:is(.dark *){--tw-bg-opacity: 1;background-color:rgb(253 224 71 / var(--tw-bg-opacity, 1))}.dark\:fill-gray-200:is(.dark *){fill:#e5e7eb}.dark\:fill-white:is(.dark *){fill:#fff}.dark\:font-medium:is(.dark *){font-weight:500}.dark\:text-gray-100:is(.dark *){--tw-text-opacity: 1;color:rgb(243 244 246 / var(--tw-text-opacity, 1))}.dark\:text-gray-200:is(.dark *){--tw-text-opacity: 1;color:rgb(229 231 235 / var(--tw-text-opacity, 1))}.dark\:text-gray-300:is(.dark *){--tw-text-opacity: 1;color:rgb(209 213 219 / var(--tw-text-opacity, 1))}.dark\:text-gray-400:is(.dark *){--tw-text-opacity: 1;color:rgb(156 163 175 / var(--tw-text-opacity, 1))}.dark\:text-indigo-400:is(.dark *){--tw-text-opacity: 1;color:rgb(129 140 248 / var(--tw-text-opacity, 1))}.dark\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.dark\:hover\:bg-black\/10:hover:is(.dark *){background-color:#0000001a}.dark\:hover\:text-white:hover:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}.group:hover .dark\:group-hover\:text-white:is(.dark *){--tw-text-opacity: 1;color:rgb(255 255 255 / var(--tw-text-opacity, 1))}@media (min-width: 640px){.sm\:mb-0{margin-bottom:0}.sm\:mt-4{margin-top:1rem}.sm\:block{display:block}.sm\:leading-none{line-height:1}.sm\:shadow-xl{--tw-shadow: 0 20px 25px -5px rgb(0 0 0 / .1), 0 8px 10px -6px rgb(0 0 0 / .1);--tw-shadow-colored: 0 20px 25px -5px var(--tw-shadow-color), 0 8px 10px -6px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}}@media (min-width: 768px){.md\:visible{visibility:visible}.md\:left-0{left:0}.md\:left-64{left:16rem}.md\:top-0{top:0}.md\:mx-2{margin-left:.5rem;margin-right:.5rem}.md\:my-0{margin-top:0;margin-bottom:0}.md\:my-6{margin-top:1.5rem;margin-bottom:1.5rem}.md\:mb-12{margin-bottom:3rem}.md\:ml-0{margin-left:0}.md\:mt-0{margin-top:0}.md\:mt-8{margin-top:2rem}.md\:block{display:block}.md\:inline-block{display:inline-block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:42rem}.md\:max-w-none{max-width:none}.md\:flex-grow{flex-grow:1}.md\:flex-grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{border-style:none}.md\:bg-transparent{background-color:transparent}.md\:bg-white{--tw-bg-opacity: 1;background-color:rgb(255 255 255 / var(--tw-bg-opacity, 1))}.md\:bg-left{background-position:left}.md\:px-16{padding-left:4rem;padding-right:4rem}.md\:py-0{padding-top:0;padding-bottom:0}.md\:py-16{padding-top:4rem;padding-bottom:4rem}.md\:pb-0{padding-bottom:0}.md\:pl-0{padding-left:0}.md\:text-center{text-align:center}.md\:text-3xl{font-size:1.875rem;line-height:2.25rem}.md\:text-4xl{font-size:2.25rem;line-height:2.5rem}.md\:text-5xl{font-size:3rem;line-height:1}.md\:text-6xl{font-size:3.75rem;line-height:1}.md\:shadow-none{--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.dark\:md\:bg-transparent:is(.dark *){background-color:transparent}}@media (min-width: 1024px){.lg\:mb-12{margin-bottom:3rem}.lg\:ml-8{margin-left:2rem}.lg\:bg-center{background-position:center}.lg\:text-5xl{font-size:3rem;line-height:1}.lg\:text-7xl{font-size:4.5rem;line-height:1}.lg\:text-lg{font-size:1.125rem;line-height:1.75rem}}@media (min-width: 1280px){.xl\:mb-16{margin-bottom:4rem}}@media print{.print\:top-0{top:0}.print\:hidden{display:none}}
+/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */@layer properties{@supports ((-webkit-hyphens:none) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer base{pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:calc(var(--spacing)*4)}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){filter:blur(.095rem);opacity:.65;transition:filter .35s,opacity .35s}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur();opacity:1}.torchlight summary:focus{--tw-outline-style:none;outline-style:none}.torchlight details>summary::marker{display:none}.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::-moz-placeholder{opacity:1}::placeholder{opacity:1}@supports (not (-webkit-appearance:-apple-pay-button)) or (contain-intrinsic-size:1px){::-moz-placeholder{color:currentColor}::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::-moz-placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-red-500:oklch(63.7% .237 25.331);--color-red-600:oklch(57.7% .245 27.325);--color-amber-500:oklch(76.9% .188 70.08);--color-yellow-300:oklch(90.5% .182 98.111);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-green-500:oklch(72.3% .219 149.579);--color-blue-500:oklch(62.3% .214 259.815);--color-indigo-400:oklch(67.3% .182 276.935);--color-indigo-600:oklch(51.1% .262 276.966);--color-indigo-700:oklch(45.7% .24 277.023);--color-slate-100:oklch(96.8% .007 247.896);--color-slate-800:oklch(27.9% .041 260.031);--color-gray-50:oklch(98.5% .002 247.839);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-gray-600:oklch(44.6% .03 256.802);--color-gray-700:oklch(37.3% .034 259.733);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-sm:24rem;--container-lg:32rem;--container-xl:36rem;--container-2xl:42rem;--container-3xl:48rem;--container-7xl:80rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--text-3xl:1.875rem;--text-3xl--line-height: 1.2 ;--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5/2.25);--text-5xl:3rem;--text-5xl--line-height:1;--text-6xl:3.75rem;--text-6xl--line-height:1;--text-7xl:4.5rem;--text-7xl--line-height:1;--font-weight-light:300;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--font-weight-black:900;--tracking-tight:-.025em;--tracking-normal:0em;--tracking-wide:.025em;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--drop-shadow-2xl:0 25px 25px #00000026;--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--animate-spin:spin 1s linear infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer components;@layer utilities{.invisible{visibility:hidden}.visible{visibility:visible}.sr-only{clip:rect(0,0,0,0);white-space:nowrap;border-width:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing)*0)}.end-0{inset-inline-end:calc(var(--spacing)*0)}.-top-1{top:calc(var(--spacing)*-1)}.top-0{top:calc(var(--spacing)*0)}.top-2\.5{top:calc(var(--spacing)*2.5)}.top-4{top:calc(var(--spacing)*4)}.top-16{top:calc(var(--spacing)*16)}.top-auto{top:auto}.right-0{right:calc(var(--spacing)*0)}.right-1{right:calc(var(--spacing)*1)}.right-3{right:calc(var(--spacing)*3)}.right-4{right:calc(var(--spacing)*4)}.bottom-0{bottom:calc(var(--spacing)*0)}.bottom-4{bottom:calc(var(--spacing)*4)}.-left-64{left:calc(var(--spacing)*-64)}.left-0{left:calc(var(--spacing)*0)}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.col-12{grid-column:12}.col-auto{grid-column:auto}.float-end{float:inline-end}.float-left{float:left}.float-right{float:right}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.m-1{margin:calc(var(--spacing)*1)}.m-2{margin:calc(var(--spacing)*2)}.m-8{margin:calc(var(--spacing)*8)}.-mx-4{margin-inline:calc(var(--spacing)*-4)}.mx-0{margin-inline:calc(var(--spacing)*0)}.mx-0\.5{margin-inline:calc(var(--spacing)*.5)}.mx-3{margin-inline:calc(var(--spacing)*3)}.mx-4{margin-inline:calc(var(--spacing)*4)}.mx-8{margin-inline:calc(var(--spacing)*8)}.mx-auto{margin-inline:auto}.my-0{margin-block:calc(var(--spacing)*0)}.my-0\.5{margin-block:calc(var(--spacing)*.5)}.my-1{margin-block:calc(var(--spacing)*1)}.my-2{margin-block:calc(var(--spacing)*2)}.my-3{margin-block:calc(var(--spacing)*3)}.my-4{margin-block:calc(var(--spacing)*4)}.my-8{margin-block:calc(var(--spacing)*8)}.my-auto{margin-block:auto}.me-0{margin-inline-end:calc(var(--spacing)*0)}.me-2{margin-inline-end:calc(var(--spacing)*2)}.me-auto{margin-inline-end:auto}.prose{color:var(--tw-prose-body);--tw-prose-body:oklch(37.3% .034 259.733);--tw-prose-headings:oklch(21% .034 264.665);--tw-prose-lead:oklch(44.6% .03 256.802);--tw-prose-links:oklch(21% .034 264.665);--tw-prose-bold:oklch(21% .034 264.665);--tw-prose-counters:oklch(55.1% .027 264.364);--tw-prose-bullets:oklch(87.2% .01 258.338);--tw-prose-hr:oklch(92.8% .006 264.531);--tw-prose-quotes:oklch(21% .034 264.665);--tw-prose-quote-borders:oklch(92.8% .006 264.531);--tw-prose-captions:oklch(55.1% .027 264.364);--tw-prose-kbd:oklch(21% .034 264.665);--tw-prose-kbd-shadows:NaN NaN NaN;--tw-prose-code:oklch(21% .034 264.665);--tw-prose-pre-code:oklch(92.8% .006 264.531);--tw-prose-pre-bg:oklch(27.8% .033 256.848);--tw-prose-th-borders:oklch(87.2% .01 258.338);--tw-prose-td-borders:oklch(92.8% .006 264.531);--tw-prose-invert-body:oklch(87.2% .01 258.338);--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:oklch(70.7% .022 261.325);--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:oklch(70.7% .022 261.325);--tw-prose-invert-bullets:oklch(44.6% .03 256.802);--tw-prose-invert-hr:oklch(37.3% .034 259.733);--tw-prose-invert-quotes:oklch(96.7% .003 264.542);--tw-prose-invert-quote-borders:oklch(37.3% .034 259.733);--tw-prose-invert-captions:oklch(70.7% .022 261.325);--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:oklch(87.2% .01 258.338);--tw-prose-invert-pre-bg:#00000080;--tw-prose-invert-th-borders:oklch(44.6% .03 256.802);--tw-prose-invert-td-borders:oklch(37.3% .034 259.733);max-width:96ch;font-size:1rem;line-height:1.5em}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);margin-top:1.2em;margin-bottom:1.2em;font-size:1.25em;line-height:1.6}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:decimal}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:disc}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.25em;font-weight:600}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;margin-top:1em;margin-bottom:1em;padding-top:.25em;padding-bottom:.25em;padding-left:.75em;line-height:1.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-top:.25em;margin-bottom:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before,.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:0;margin-bottom:.888889em;font-size:2.25em;font-weight:800;line-height:1.11111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.75em;font-size:1.5em;font-weight:700;line-height:1.33333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.6em;margin-bottom:.6em;font-size:1.25em;font-weight:600;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.5em;font-weight:600;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em;display:block}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px rgb(var(--tw-prose-kbd-shadows)/10%);padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;border-radius:.3125rem;padding-inline-start:.375em;font-family:inherit;font-size:.875em;font-weight:500}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-size:.875em;font-weight:600}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);padding-top:.857143em;padding-inline-end:1.14286em;padding-bottom:.857143em;background-color:#292d3e;border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;padding-inline-start:1.14286em;font-size:.875em;font-weight:400;line-height:1.71429;overflow-x:auto}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit;background-color:#0000;border-width:0;border-radius:0;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){table-layout:auto;width:100%;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.71429}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);vertical-align:bottom;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em;font-weight:600}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);margin-top:.857143em;font-size:.875em;line-height:1.42857}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.571429em;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;vertical-align:top;word-break:break-all;background-color:#80808033;border-radius:4px;max-width:80vw;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px;overflow-x:auto}.-mt-4{margin-top:calc(var(--spacing)*-4)}.mt-1{margin-top:calc(var(--spacing)*1)}.mt-2{margin-top:calc(var(--spacing)*2)}.mt-3{margin-top:calc(var(--spacing)*3)}.mt-4{margin-top:calc(var(--spacing)*4)}.mt-6{margin-top:calc(var(--spacing)*6)}.mt-8{margin-top:calc(var(--spacing)*8)}.mt-12{margin-top:calc(var(--spacing)*12)}.mt-auto{margin-top:auto}.mr-1{margin-right:calc(var(--spacing)*1)}.mr-3{margin-right:calc(var(--spacing)*3)}.mr-4{margin-right:calc(var(--spacing)*4)}.mr-auto{margin-right:auto}.mb-0{margin-bottom:calc(var(--spacing)*0)}.mb-1{margin-bottom:calc(var(--spacing)*1)}.mb-2{margin-bottom:calc(var(--spacing)*2)}.mb-3{margin-bottom:calc(var(--spacing)*3)}.mb-4{margin-bottom:calc(var(--spacing)*4)}.mb-8{margin-bottom:calc(var(--spacing)*8)}.mb-12{margin-bottom:calc(var(--spacing)*12)}.mb-auto{margin-bottom:auto}.-ml-2{margin-left:calc(var(--spacing)*-2)}.-ml-4{margin-left:calc(var(--spacing)*-4)}.-ml-6{margin-left:calc(var(--spacing)*-6)}.-ml-8{margin-left:calc(var(--spacing)*-8)}.ml-1{margin-left:calc(var(--spacing)*1)}.ml-3{margin-left:calc(var(--spacing)*3)}.ml-4{margin-left:calc(var(--spacing)*4)}.ml-auto{margin-left:auto}.block{display:block}.block\!{display:block!important}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-0\.5{height:calc(var(--spacing)*.5)}.h-1{height:calc(var(--spacing)*1)}.h-4{height:calc(var(--spacing)*4)}.h-5{height:calc(var(--spacing)*5)}.h-6{height:calc(var(--spacing)*6)}.h-8{height:calc(var(--spacing)*8)}.h-16{height:calc(var(--spacing)*16)}.h-24{height:calc(var(--spacing)*24)}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-5{width:calc(var(--spacing)*5)}.w-6{width:calc(var(--spacing)*6)}.w-8{width:calc(var(--spacing)*8)}.w-16{width:calc(var(--spacing)*16)}.w-64{width:calc(var(--spacing)*64)}.w-80{width:calc(var(--spacing)*80)}.w-96{width:calc(var(--spacing)*96)}.w-100{width:calc(var(--spacing)*100)}.w-\[70ch\]{width:70ch}.w-auto{width:auto}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:var(--container-3xl)}.max-w-7xl{max-width:var(--container-7xl)}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:var(--container-lg)}.max-w-sm{max-width:var(--container-sm)}.min-w-screen{min-width:100vw}.flex-shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.flex-grow,.flex-grow-1,.grow{flex-grow:1}.table-auto{table-layout:auto}.table-fixed{table-layout:fixed}.border-collapse{border-collapse:collapse}.border-separate{border-collapse:separate}.origin-center{transform-origin:50%}.-rotate-45{rotate:-45deg}.rotate-45{rotate:45deg}.transform{transform:var(--tw-rotate-x,)var(--tw-rotate-y,)var(--tw-rotate-z,)var(--tw-skew-x,)var(--tw-skew-y,)}.animate-spin{animation:var(--animate-spin)}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:calc(var(--spacing)*2)}.list-none{list-style-type:none}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.flex-col{flex-direction:column}.flex-row{flex-direction:row}.flex-nowrap{flex-wrap:nowrap}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-4{gap:calc(var(--spacing)*4)}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*4)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*4)*calc(1 - var(--tw-space-y-reverse)))}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px*var(--tw-divide-y-reverse));border-bottom-width:calc(1px*calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-gray-300>:not(:last-child)){border-color:var(--color-gray-300)}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.overflow-y-auto{overflow-y:auto}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.rounded{border-radius:.25rem}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-t{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.rounded-l{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-tl{border-top-left-radius:.25rem}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.rounded-tr{border-top-right-radius:.25rem}.rounded-b{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-br{border-bottom-right-radius:.25rem}.rounded-bl{border-bottom-left-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-4{border-style:var(--tw-border-style);border-width:4px}.border-x{border-inline-style:var(--tw-border-style);border-inline-width:1px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-l-4{border-left-style:var(--tw-border-style);border-left-width:4px}.border-l-\[0\.325rem\]{border-left-style:var(--tw-border-style);border-left-width:.325rem}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-dotted{--tw-border-style:dotted;border-style:dotted}.border-double{--tw-border-style:double;border-style:double}.border-none{--tw-border-style:none;border-style:none}.border-solid{--tw-border-style:solid;border-style:solid}.border-amber-500{border-color:var(--color-amber-500)}.border-blue-500{border-color:var(--color-blue-500)}.border-gray-200{border-color:var(--color-gray-200)}.border-gray-300{border-color:var(--color-gray-300)}.border-gray-500{border-color:var(--color-gray-500)}.border-gray-900{border-color:var(--color-gray-900)}.border-green-500{border-color:var(--color-green-500)}.border-indigo-500{border-color:#5956eb}.border-red-600{border-color:var(--color-red-600)}.border-transparent{border-color:#0000}.border-yellow-400{border-color:var(--color-yellow-400)}.border-t-transparent{border-top-color:#0000}.border-r-gray-900{border-right-color:var(--color-gray-900)}.bg-black{background-color:var(--color-black)}.bg-black\/5{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.bg-black\/5{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.bg-black\/50{background-color:#00000080}@supports (color:color-mix(in lab,red,red)){.bg-black\/50{background-color:color-mix(in oklab,var(--color-black)50%,transparent)}}.bg-current{background-color:currentColor}.bg-gray-50{background-color:var(--color-gray-50)}.bg-gray-100{background-color:var(--color-gray-100)}.bg-gray-200{background-color:var(--color-gray-200)}.bg-gray-500{background-color:var(--color-gray-500)}.bg-indigo-600{background-color:var(--color-indigo-600)}.bg-slate-100{background-color:var(--color-slate-100)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-yellow-400{background-color:var(--color-yellow-400)}.bg-linear-to-br{--tw-gradient-position:to bottom right;background-image:linear-gradient(var(--tw-gradient-stops))}@supports (background-image:linear-gradient(in lab,red,red)){.bg-linear-to-br{--tw-gradient-position:to bottom right in oklab}}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:var(--color-black)}.fill-current{fill:currentColor}.p-0{padding:calc(var(--spacing)*0)}.p-2{padding:calc(var(--spacing)*2)}.p-3{padding:calc(var(--spacing)*3)}.p-4{padding:calc(var(--spacing)*4)}.p-8{padding:calc(var(--spacing)*8)}.p-12{padding:calc(var(--spacing)*12)}.px-0{padding-inline:calc(var(--spacing)*0)}.px-1{padding-inline:calc(var(--spacing)*1)}.px-2{padding-inline:calc(var(--spacing)*2)}.px-3{padding-inline:calc(var(--spacing)*3)}.px-4{padding-inline:calc(var(--spacing)*4)}.px-5{padding-inline:calc(var(--spacing)*5)}.px-6{padding-inline:calc(var(--spacing)*6)}.px-8{padding-inline:calc(var(--spacing)*8)}.py-0{padding-block:calc(var(--spacing)*0)}.py-1{padding-block:calc(var(--spacing)*1)}.py-2{padding-block:calc(var(--spacing)*2)}.py-3{padding-block:calc(var(--spacing)*3)}.py-4{padding-block:calc(var(--spacing)*4)}.py-5{padding-block:calc(var(--spacing)*5)}.py-6{padding-block:calc(var(--spacing)*6)}.py-8{padding-block:calc(var(--spacing)*8)}.py-12{padding-block:calc(var(--spacing)*12)}.py-16{padding-block:calc(var(--spacing)*16)}.py-24{padding-block:calc(var(--spacing)*24)}.py-32{padding-block:calc(var(--spacing)*32)}.ps-0{padding-inline-start:calc(var(--spacing)*0)}.ps-2{padding-inline-start:calc(var(--spacing)*2)}.ps-3{padding-inline-start:calc(var(--spacing)*3)}.pe-0{padding-inline-end:calc(var(--spacing)*0)}.pe-2{padding-inline-end:calc(var(--spacing)*2)}.pe-4{padding-inline-end:calc(var(--spacing)*4)}.pt-3{padding-top:calc(var(--spacing)*3)}.pt-4{padding-top:calc(var(--spacing)*4)}.pt-8{padding-top:calc(var(--spacing)*8)}.pt-10{padding-top:calc(var(--spacing)*10)}.pb-2{padding-bottom:calc(var(--spacing)*2)}.pb-3{padding-bottom:calc(var(--spacing)*3)}.pb-4{padding-bottom:calc(var(--spacing)*4)}.pb-8{padding-bottom:calc(var(--spacing)*8)}.pb-12{padding-bottom:calc(var(--spacing)*12)}.pl-2{padding-left:calc(var(--spacing)*2)}.pl-4{padding-left:calc(var(--spacing)*4)}.pl-5{padding-left:calc(var(--spacing)*5)}.pl-8{padding-left:calc(var(--spacing)*8)}.text-center{text-align:center}.text-end{text-align:end}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.leading-7{--tw-leading:calc(var(--spacing)*7);line-height:calc(var(--spacing)*7)}.leading-8{--tw-leading:calc(var(--spacing)*8);line-height:calc(var(--spacing)*8)}.leading-10{--tw-leading:calc(var(--spacing)*10);line-height:calc(var(--spacing)*10)}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-black{--tw-font-weight:var(--font-weight-black);font-weight:var(--font-weight-black)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-extrabold{--tw-font-weight:var(--font-weight-extrabold);font-weight:var(--font-weight-extrabold)}.font-light{--tw-font-weight:var(--font-weight-light);font-weight:var(--font-weight-light)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-normal{--tw-tracking:var(--tracking-normal);letter-spacing:var(--tracking-normal)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.text-nowrap{text-wrap:nowrap}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.text-black{color:var(--color-black)}.text-blue-500{color:var(--color-blue-500)}.text-gray-100{color:var(--color-gray-100)}.text-gray-200{color:var(--color-gray-200)}.text-gray-400{color:var(--color-gray-400)}.text-gray-500{color:var(--color-gray-500)}.text-gray-600{color:var(--color-gray-600)}.text-gray-700{color:var(--color-gray-700)}.text-green-500{color:var(--color-green-500)}.text-indigo-500{color:#5956eb}.text-indigo-600{color:var(--color-indigo-600)}.text-red-500{color:var(--color-red-500)}.text-transparent{color:#0000}.text-white{color:var(--color-white)}.text-yellow-500{color:var(--color-yellow-500)}.capitalize{text-transform:capitalize}.lowercase{text-transform:lowercase}.uppercase{text-transform:uppercase}.italic{font-style:italic}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a),0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a),0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-1{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(1px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-gray-900\/5{--tw-ring-color:#1018280d}@supports (color:color-mix(in lab,red,red)){.ring-gray-900\/5{--tw-ring-color:color-mix(in oklab,var(--color-gray-900)5%,transparent)}}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.drop-shadow-2xl{--tw-drop-shadow-size:drop-shadow(0 25px 25px var(--tw-drop-shadow-color,#00000026));--tw-drop-shadow:drop-shadow(var(--drop-shadow-2xl));filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.invert{--tw-invert:invert(100%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-shadow{transition-property:box-shadow;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-75{--tw-duration:75ms;transition-duration:75ms}.duration-250{--tw-duration:.25s;transition-duration:.25s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.ease-linear{--tw-ease:linear;transition-timing-function:linear}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}@media (hover:hover){.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}.group-hover\:grayscale-0:is(:where(.group):hover *){--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.hover\:bg-black\/5:hover{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/5:hover{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.hover\:bg-black\/10:hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/10:hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-200\/20:hover{background-color:color-mix(in oklab,var(--color-gray-200)20%,transparent)}}.hover\:bg-gray-600:hover{background-color:var(--color-gray-600)}.hover\:bg-indigo-500:hover{background-color:#5956eb}.hover\:text-gray-700:hover{color:var(--color-gray-700)}.hover\:text-gray-900:hover{color:var(--color-gray-900)}.hover\:text-indigo-600:hover{color:var(--color-indigo-600)}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:shadow-xl:hover{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}.focus\:not-sr-only:focus{clip:auto;white-space:normal;width:auto;height:auto;margin:0;padding:0;position:static;overflow:visible}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-inline:auto}.focus\:mt-2:focus{margin-top:calc(var(--spacing)*2)}.focus\:w-64:focus{width:calc(var(--spacing)*64)}.focus\:bg-gray-700:focus{background-color:var(--color-gray-700)}.focus\:bg-indigo-700:focus{background-color:var(--color-indigo-700)}.focus\:p-2:focus{padding:calc(var(--spacing)*2)}.focus\:opacity-100:focus{opacity:1}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(2px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-gray-700:focus{--tw-ring-color:var(--color-gray-700)}.focus\:ring-indigo-600:focus{--tw-ring-color:var(--color-indigo-600)}.focus\:grayscale-0:focus{--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}@media (min-width:40rem){.sm\:-mx-6{margin-inline:calc(var(--spacing)*-6)}.sm\:mx-auto{margin-inline:auto}.sm\:mt-4{margin-top:calc(var(--spacing)*4)}.sm\:mb-0{margin-bottom:calc(var(--spacing)*0)}.sm\:block{display:block}.sm\:max-w-xl{max-width:var(--container-xl)}.sm\:rounded-lg{border-radius:var(--radius-lg)}.sm\:px-6{padding-inline:calc(var(--spacing)*6)}.sm\:px-10{padding-inline:calc(var(--spacing)*10)}.sm\:py-12{padding-block:calc(var(--spacing)*12)}.sm\:leading-none{--tw-leading:1;line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:48rem){.md\:visible{visibility:visible}.md\:top-0{top:calc(var(--spacing)*0)}.md\:left-0{left:calc(var(--spacing)*0)}.md\:left-64{left:calc(var(--spacing)*64)}.md\:mx-2{margin-inline:calc(var(--spacing)*2)}.md\:my-0{margin-block:calc(var(--spacing)*0)}.md\:my-6{margin-block:calc(var(--spacing)*6)}.md\:mt-0{margin-top:calc(var(--spacing)*0)}.md\:mt-8{margin-top:calc(var(--spacing)*8)}.md\:mb-12{margin-bottom:calc(var(--spacing)*12)}.md\:ml-0{margin-left:calc(var(--spacing)*0)}.md\:block{display:block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:inline-block{display:inline-block}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:var(--container-2xl)}.md\:max-w-none{max-width:none}.md\:grow{flex-grow:1}.md\:grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{--tw-border-style:none;border-style:none}.md\:bg-transparent{background-color:#0000}.md\:bg-white{background-color:var(--color-white)}.md\:bg-left{background-position:0}.md\:px-16{padding-inline:calc(var(--spacing)*16)}.md\:py-0{padding-block:calc(var(--spacing)*0)}.md\:py-16{padding-block:calc(var(--spacing)*16)}.md\:pb-0{padding-bottom:calc(var(--spacing)*0)}.md\:pl-0{padding-left:calc(var(--spacing)*0)}.md\:text-center{text-align:center}.md\:text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.md\:text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.md\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.md\:text-6xl{font-size:var(--text-6xl);line-height:var(--tw-leading,var(--text-6xl--line-height))}.md\:shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:64rem){.lg\:mb-12{margin-bottom:calc(var(--spacing)*12)}.lg\:ml-8{margin-left:calc(var(--spacing)*8)}.lg\:flex{display:flex}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.lg\:text-7xl{font-size:var(--text-7xl);line-height:var(--tw-leading,var(--text-7xl--line-height))}.lg\:text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}}@media (min-width:80rem){.xl\:mb-16{margin-bottom:calc(var(--spacing)*16)}}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}:where(.dark\:divide-gray-700:is(.dark *)>:not(:last-child)){border-color:var(--color-gray-700)}.dark\:border-\[\#1b2533\]:is(.dark *){border-color:#1b2533}.dark\:border-gray-700:is(.dark *){border-color:var(--color-gray-700)}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:bg-black\/10:is(.dark *){background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:bg-gray-600:is(.dark *){background-color:var(--color-gray-600)}.dark\:bg-gray-700:is(.dark *){background-color:var(--color-gray-700)}.dark\:bg-gray-800:is(.dark *){background-color:var(--color-gray-800)}.dark\:bg-gray-900:is(.dark *){background-color:var(--color-gray-900)}.dark\:bg-slate-800:is(.dark *){background-color:var(--color-slate-800)}.dark\:bg-yellow-300:is(.dark *){background-color:var(--color-yellow-300)}.dark\:fill-gray-200:is(.dark *){fill:var(--color-gray-200)}.dark\:fill-white:is(.dark *){fill:var(--color-white)}.dark\:font-medium:is(.dark *){--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.dark\:text-gray-100:is(.dark *){color:var(--color-gray-100)}.dark\:text-gray-200:is(.dark *){color:var(--color-gray-200)}.dark\:text-gray-300:is(.dark *){color:var(--color-gray-300)}.dark\:text-gray-400:is(.dark *){color:var(--color-gray-400)}.dark\:text-indigo-400:is(.dark *){color:var(--color-indigo-400)}.dark\:text-white:is(.dark *){color:var(--color-white)}@media (hover:hover){.dark\:group-hover\:text-white:is(.dark *):is(:where(.group):hover *){color:var(--color-white)}.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:hover\:bg-gray-500:is(.dark *):hover{background-color:var(--color-gray-500)}.dark\:hover\:text-white:is(.dark *):hover{color:var(--color-white)}}.dark\:focus\:text-white:is(.dark *):focus{color:var(--color-white)}.dark\:focus\:ring-indigo-500:is(.dark *):focus{--tw-ring-color:#5956eb}@media (min-width:48rem){.dark\:md\:bg-transparent:is(.dark *){background-color:#0000}}@media print{.print\:top-0{top:calc(var(--spacing)*0)}.print\:hidden{display:none}}.prose-h1\:mb-3 :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:calc(var(--spacing)*3)}.prose-p\:my-3 :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-block:calc(var(--spacing)*3)}.prose-img\:inline :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){display:inline}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}

From 6a35b31040a32f9f5b73edcae74edf70edf54eff Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 22:56:34 +0200
Subject: [PATCH 3960/4023] Add todo comment for development builds

---
 packages/hyde/vite.config.mjs | 1 +
 vite.config.mjs               | 1 +
 2 files changed, 2 insertions(+)

diff --git a/packages/hyde/vite.config.mjs b/packages/hyde/vite.config.mjs
index d6fd59b1da6..c6f77c0d542 100644
--- a/packages/hyde/vite.config.mjs
+++ b/packages/hyde/vite.config.mjs
@@ -9,6 +9,7 @@ import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
 
+// Todo: This will be moved to a package instead of having it here.
 const hydeVitePlugin = () => ({
     name: 'hyde-vite',
     configureServer(server) {
diff --git a/vite.config.mjs b/vite.config.mjs
index d6fd59b1da6..c6f77c0d542 100644
--- a/vite.config.mjs
+++ b/vite.config.mjs
@@ -9,6 +9,7 @@ import autoprefixer from 'autoprefixer';
 import fs from 'fs';
 import path from 'path';
 
+// Todo: This will be moved to a package instead of having it here.
 const hydeVitePlugin = () => ({
     name: 'hyde-vite',
     configureServer(server) {

From 08481950d8dcc7f98c2767d018a0ce923f3d73d3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Mon, 21 Apr 2025 22:59:34 +0200
Subject: [PATCH 3961/4023] Fix watcher paths for Markdown pages

---
 packages/hyde/vite.config.mjs | 10 ++++++++++
 vite.config.mjs               | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/packages/hyde/vite.config.mjs b/packages/hyde/vite.config.mjs
index c6f77c0d542..4588d6a1141 100644
--- a/packages/hyde/vite.config.mjs
+++ b/packages/hyde/vite.config.mjs
@@ -53,6 +53,16 @@ export default defineConfig({
             port: 5173,
         },
         middlewareMode: false,
+        watch: {
+            additionalPaths: (watcher) => {
+                watcher.add('_pages/**');
+                watcher.add('_posts/**');
+                watcher.add('_docs/**');
+                watcher.add('_pages/**/**');
+                watcher.add('_posts/**/**');
+                watcher.add('_docs/**/**');
+            }
+        }
     },
     plugins: [hydeVitePlugin(), tailwindcss()],
     css: {
diff --git a/vite.config.mjs b/vite.config.mjs
index c6f77c0d542..4588d6a1141 100644
--- a/vite.config.mjs
+++ b/vite.config.mjs
@@ -53,6 +53,16 @@ export default defineConfig({
             port: 5173,
         },
         middlewareMode: false,
+        watch: {
+            additionalPaths: (watcher) => {
+                watcher.add('_pages/**');
+                watcher.add('_posts/**');
+                watcher.add('_docs/**');
+                watcher.add('_pages/**/**');
+                watcher.add('_posts/**/**');
+                watcher.add('_docs/**/**');
+            }
+        }
     },
     plugins: [hydeVitePlugin(), tailwindcss()],
     css: {

From 40d9fa4a1734e5d425c40d2e1935a0a4ad9d4531 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Tue, 22 Apr 2025 00:33:37 +0200
Subject: [PATCH 3962/4023] Fix return type so it allows ints and bools

---
 .../framework/src/Framework/Factories/BlogPostDataFactory.php   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
index 5704a4f72b7..57be18ecacb 100644
--- a/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
+++ b/packages/framework/src/Framework/Factories/BlogPostDataFactory.php
@@ -131,7 +131,7 @@ private function getOrCreateAuthor(): PostAuthor
         return PostAuthor::create($data);
     }
 
-    protected function getMatter(string $key): string|null|array
+    protected function getMatter(string $key): string|null|array|int|bool
     {
         /** @var string|null|array $value */
         $value = $this->matter->get($key);

From db037f470596900ad37d26948d94f7f31db678e7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 08:56:28 +0200
Subject: [PATCH 3963/4023] Move Vite hot file to runtime directory

---
 app/storage/framework/runtime/.gitignore                  | 2 ++
 packages/framework/src/Console/Commands/ServeCommand.php  | 2 +-
 packages/framework/src/Facades/Vite.php                   | 2 +-
 .../framework/tests/Feature/Commands/ServeCommandTest.php | 8 ++++----
 packages/framework/tests/Unit/Facades/ViteFacadeTest.php  | 4 ++--
 packages/hyde/vite.config.mjs                             | 4 ++--
 vite.config.mjs                                           | 4 ++--
 7 files changed, 14 insertions(+), 12 deletions(-)
 create mode 100644 app/storage/framework/runtime/.gitignore

diff --git a/app/storage/framework/runtime/.gitignore b/app/storage/framework/runtime/.gitignore
new file mode 100644
index 00000000000..c96a04f008e
--- /dev/null
+++ b/app/storage/framework/runtime/.gitignore
@@ -0,0 +1,2 @@
+*
+!.gitignore
\ No newline at end of file
diff --git a/packages/framework/src/Console/Commands/ServeCommand.php b/packages/framework/src/Console/Commands/ServeCommand.php
index 3fc2518e85d..c7132e4fc0a 100644
--- a/packages/framework/src/Console/Commands/ServeCommand.php
+++ b/packages/framework/src/Console/Commands/ServeCommand.php
@@ -192,7 +192,7 @@ protected function runViteProcess(): void
             );
         }
 
-        Filesystem::touch('app/storage/framework/cache/vite.hot');
+        Filesystem::touch('app/storage/framework/runtime/vite.hot');
 
         $this->vite = Process::forever()->start('npm run dev');
     }
diff --git a/packages/framework/src/Facades/Vite.php b/packages/framework/src/Facades/Vite.php
index 814aff2b07c..1a03d4dc8c8 100644
--- a/packages/framework/src/Facades/Vite.php
+++ b/packages/framework/src/Facades/Vite.php
@@ -17,7 +17,7 @@ class Vite
 
     public static function running(): bool
     {
-        return Filesystem::exists('app/storage/framework/cache/vite.hot');
+        return Filesystem::exists('app/storage/framework/runtime/vite.hot');
     }
 
     public static function asset(string $path): HtmlString
diff --git a/packages/framework/tests/Feature/Commands/ServeCommandTest.php b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
index d9d2e814078..858d35f4be9 100644
--- a/packages/framework/tests/Feature/Commands/ServeCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/ServeCommandTest.php
@@ -182,7 +182,7 @@ public function testWithFancyOutput()
 
     public function testHydeServeCommandWithViteOption()
     {
-        $this->cleanUpWhenDone('app/storage/framework/cache/vite.hot');
+        $this->cleanUpWhenDone('app/storage/framework/runtime/vite.hot');
 
         $mockViteProcess = mock(InvokedProcess::class);
         $mockViteProcess->shouldReceive('running')
@@ -227,12 +227,12 @@ public function testHydeServeCommandWithViteOption()
             ->expectsOutput('vite latest output')
             ->assertExitCode(0);
 
-        $this->assertFileExists('app/storage/framework/cache/vite.hot');
+        $this->assertFileExists('app/storage/framework/runtime/vite.hot');
     }
 
     public function testHydeServeCommandWithViteOptionButViteNotRunning()
     {
-        $this->cleanUpWhenDone('app/storage/framework/cache/vite.hot');
+        $this->cleanUpWhenDone('app/storage/framework/runtime/vite.hot');
 
         $mockViteProcess = mock(InvokedProcess::class);
         $mockViteProcess->shouldReceive('running')
@@ -270,7 +270,7 @@ public function testHydeServeCommandWithViteOptionButViteNotRunning()
             ->expectsOutput('Starting the HydeRC server... Use Ctrl+C to stop')
             ->assertExitCode(0);
 
-        $this->assertFileExists('app/storage/framework/cache/vite.hot');
+        $this->assertFileExists('app/storage/framework/runtime/vite.hot');
     }
 
     public function testHydeServeCommandWithViteOptionThrowsWhenPortIsInUse()
diff --git a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
index 45adda783c4..6e79e2865b1 100644
--- a/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/ViteFacadeTest.php
@@ -26,14 +26,14 @@ protected function tearDown(): void
 
     public function testRunningReturnsTrueWhenViteHotFileExists()
     {
-        $this->file('app/storage/framework/cache/vite.hot');
+        $this->file('app/storage/framework/runtime/vite.hot');
 
         $this->assertTrue(Vite::running());
     }
 
     public function testRunningReturnsFalseWhenViteHotFileDoesNotExist()
     {
-        $this->assertFileDoesNotExist('app/storage/framework/cache/vite.hot');
+        $this->assertFileDoesNotExist('app/storage/framework/runtime/vite.hot');
 
         $this->assertFalse(Vite::running());
     }
diff --git a/packages/hyde/vite.config.mjs b/packages/hyde/vite.config.mjs
index 4588d6a1141..149b4628ae5 100644
--- a/packages/hyde/vite.config.mjs
+++ b/packages/hyde/vite.config.mjs
@@ -14,12 +14,12 @@ const hydeVitePlugin = () => ({
     name: 'hyde-vite',
     configureServer(server) {
         // Create hot file when Vite server starts
-        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
+        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'), '');
 
         // Remove hot file when Vite server closes
         ['SIGINT', 'SIGTERM'].forEach(signal => {
             process.on(signal, () => {
-                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'));
                 process.exit();
             });
         });
diff --git a/vite.config.mjs b/vite.config.mjs
index 4588d6a1141..149b4628ae5 100644
--- a/vite.config.mjs
+++ b/vite.config.mjs
@@ -14,12 +14,12 @@ const hydeVitePlugin = () => ({
     name: 'hyde-vite',
     configureServer(server) {
         // Create hot file when Vite server starts
-        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'), '');
+        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'), '');
 
         // Remove hot file when Vite server closes
         ['SIGINT', 'SIGTERM'].forEach(signal => {
             process.on(signal, () => {
-                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/cache/vite.hot'));
+                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'));
                 process.exit();
             });
         });

From ec083332c3022f32bebd9e3c46b7fdcca5a7d999 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 10:21:52 +0200
Subject: [PATCH 3964/4023] Update Hyde to use ESM by default

---
 package.json               | 1 +
 packages/hyde/package.json | 1 +
 2 files changed, 2 insertions(+)

diff --git a/package.json b/package.json
index 6d2fd322259..b4f88a28269 100644
--- a/package.json
+++ b/package.json
@@ -1,5 +1,6 @@
 {
     "private": true,
+    "type": "module",
     "scripts": {
         "dev": "vite",
         "build": "vite build"
diff --git a/packages/hyde/package.json b/packages/hyde/package.json
index ac3b610384c..8d25c7148a2 100644
--- a/packages/hyde/package.json
+++ b/packages/hyde/package.json
@@ -1,5 +1,6 @@
 {
     "private": true,
+    "type": "module",
     "scripts": {
         "dev": " mix",
         "prod": "mix --production",

From cce03b4a05b76723596fb0d988d1b2f8da5aa62c Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 10:22:42 +0200
Subject: [PATCH 3965/4023] Update script component to load scripts as module

---
 .../resources/views/layouts/scripts.blade.php          |  2 +-
 .../tests/Unit/MediaDirectoryCanBeChangedTest.php      |  2 +-
 .../tests/Unit/Views/ScriptsComponentViewTest.php      | 10 +++++-----
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/packages/framework/resources/views/layouts/scripts.blade.php b/packages/framework/resources/views/layouts/scripts.blade.php
index 8f2a93343e3..656fb640952 100644
--- a/packages/framework/resources/views/layouts/scripts.blade.php
+++ b/packages/framework/resources/views/layouts/scripts.blade.php
@@ -2,7 +2,7 @@
 @if(Vite::running())
     {{ Vite::assets(['resources/assets/app.js']) }}
 @elseif(Asset::exists('app.js'))
-    <script defer src="{{ Asset::get('app.js') }}"></script>
+    <script type="module" defer src="{{ Asset::get('app.js') }}"></script>
 @endif
 
 {{-- Alpine.js --}}
diff --git a/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php b/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
index 741646b4c7e..585ffebfb06 100644
--- a/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
+++ b/packages/framework/tests/Unit/MediaDirectoryCanBeChangedTest.php
@@ -72,7 +72,7 @@ public function testCompiledPagesHaveLinksToTheRightMediaFileLocation()
         );
 
         $this->assertStringContainsString(
-            '<script defer src="assets/app.js?v='.hash_file('crc32', Hyde::path('_assets/app.js')).'"></script>',
+            '<script type="module" defer src="assets/app.js?v='.hash_file('crc32', Hyde::path('_assets/app.js')).'"></script>',
             $contents
         );
 
diff --git a/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php b/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
index d16027a70b0..8052d3176f8 100644
--- a/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
+++ b/packages/framework/tests/Unit/Views/ScriptsComponentViewTest.php
@@ -34,24 +34,24 @@ public function testComponentCanBeRendered()
     public function testComponentHasLinkToAppJsFileWhenItExists()
     {
         Filesystem::touch('_media/app.js');
-        $this->assertStringContainsString('<script defer src="media/app.js"', $this->renderTestView());
+        $this->assertStringContainsString('<script type="module" defer src="media/app.js"', $this->renderTestView());
         Filesystem::unlink('_media/app.js');
     }
 
     public function testComponentDoesNotRenderLinkToAppJsWhenItDoesNotExist()
     {
-        $this->assertStringNotContainsString('<script defer src="media/app.js"', $this->renderTestView());
+        $this->assertStringNotContainsString('<script type="module" defer src="media/app.js"', $this->renderTestView());
     }
 
     public function testComponentUsesRelativePathToAppJsFileForNestedPages()
     {
         Filesystem::touch('_media/app.js');
         $this->mockCurrentPage = 'foo';
-        $this->assertStringContainsString('<script defer src="media/app.js"', $this->renderTestView());
+        $this->assertStringContainsString('<script type="module" defer src="media/app.js"', $this->renderTestView());
         $this->mockCurrentPage = 'foo/bar';
-        $this->assertStringContainsString('<script defer src="../media/app.js"', $this->renderTestView());
+        $this->assertStringContainsString('<script type="module" defer src="../media/app.js"', $this->renderTestView());
         $this->mockCurrentPage = 'foo/bar/cat.html';
-        $this->assertStringContainsString('<script defer src="../../media/app.js"', $this->renderTestView());
+        $this->assertStringContainsString('<script type="module" defer src="../../media/app.js"', $this->renderTestView());
         $this->mockCurrentPage = null;
         Filesystem::unlink('_media/app.js');
     }

From fddf9c9fca213797dfdeebb2f830fb09611d3418 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 10:26:03 +0200
Subject: [PATCH 3966/4023] Update Tailwind config to use ESM

---
 tailwind.config.js | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/tailwind.config.js b/tailwind.config.js
index 083c2625df7..b3f3e6e5c92 100644
--- a/tailwind.config.js
+++ b/tailwind.config.js
@@ -1,6 +1,7 @@
-const defaultTheme = require('tailwindcss/defaultTheme');
+import defaultTheme from 'tailwindcss/defaultTheme';
+import typography from '@tailwindcss/typography';
 
-module.exports = {
+export default {
     darkMode: 'class',
     content: [
         './_pages/**/*.blade.php',
@@ -126,6 +127,6 @@ module.exports = {
     ],
 
     plugins: [
-        require('@tailwindcss/typography')
+        typography
     ],
 };

From 9e2954d20a29c9d655eb9117ef057757b0cb2154 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 10:28:59 +0200
Subject: [PATCH 3967/4023] Revert "Use ESM extension for Vite configuration"

This reverts commit fb86a27bc4a6f6bda7ff2f5ff8dee3de5fbc2004.
---
 packages/hyde/{vite.config.mjs => vite.config.js} | 0
 vite.config.mjs => vite.config.js                 | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename packages/hyde/{vite.config.mjs => vite.config.js} (100%)
 rename vite.config.mjs => vite.config.js (100%)

diff --git a/packages/hyde/vite.config.mjs b/packages/hyde/vite.config.js
similarity index 100%
rename from packages/hyde/vite.config.mjs
rename to packages/hyde/vite.config.js
diff --git a/vite.config.mjs b/vite.config.js
similarity index 100%
rename from vite.config.mjs
rename to vite.config.js

From 0c568623bb01a342da4e02f4d148714a7ffa91d9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 11:26:26 +0200
Subject: [PATCH 3968/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 3f88fe0ac0c..5eb8a3324f4 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -43,6 +43,7 @@ This serves two purposes:
 
 - **Breaking:** We now support PHP [8.2, 8.3, 8.4] instead of [8.1, 8.2, 8.3] in https://github.com/hydephp/develop/pull/2141
 - **Breaking:** We upgraded from the TailwindCSS version from v3 v4. You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details. Introduced in https://github.com/hydephp/develop/pull/2146.
+- **Breaking:** We switched from using CJS to ESM in the frontend tool scaffolding. If you have custom script includes you need to migrate them. See below and in https://github.com/hydephp/develop/pull/2159 for details.
 - **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
 - **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
 - **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
@@ -196,6 +197,12 @@ $ npx @tailwindcss/upgrade
 
 ## High impact
 
+### Switch frontend tooling to full ESM support
+
+The frontend tooling has been switched from CommonJS to ESM. This means that all JavaScript files are now ESM modules, and you will need to update your custom scripts to use ESM syntax.
+
+If you only used the default HydePHP frontend (without custom JavaScript), no action is needed. Otherwise, please read the upgrade guide here: https://github.com/hydephp/develop/pull/2159
+
 ### Navigation system rewrite
 
 The navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations, see more down below.

From 65d4f8bcd2b722a1a17182d6478372260a649ce9 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:23:43 +0200
Subject: [PATCH 3969/4023] Sync package files

---
 packages/hyde/package.json | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/packages/hyde/package.json b/packages/hyde/package.json
index 8d25c7148a2..b4f88a28269 100644
--- a/packages/hyde/package.json
+++ b/packages/hyde/package.json
@@ -2,18 +2,17 @@
     "private": true,
     "type": "module",
     "scripts": {
-        "dev": " mix",
-        "prod": "mix --production",
-        "watch": "mix watch"
+        "dev": "vite",
+        "build": "vite build"
     },
     "devDependencies": {
-        "@tailwindcss/typography": "^0.5.2",
+        "@tailwindcss/typography": "^0.5.15",
         "@tailwindcss/vite": "^4.1.4",
-        "autoprefixer": "^10.4.5",
-        "hydefront": "^3.4.1",
-        "laravel-mix": "^6.0.49",
-        "postcss": "^8.4.31",
-        "prettier": "3.5.3",
-        "tailwindcss": "^4.1.4"
+        "autoprefixer": "^10.4.20",
+        "hydefront": "^3.3.0",
+        "postcss": "^8.4.49",
+        "prettier": "3.3.3",
+        "tailwindcss": "^4.1.4",
+        "vite": "^5.0.0"
     }
 }

From cd9a33370855c3f7974d54cf227258d720e5f53b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 11:37:36 +0200
Subject: [PATCH 3970/4023] Use cleaner watcher syntax

---
 packages/hyde/vite.config.js | 9 +++------
 vite.config.js               | 9 +++------
 2 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index 149b4628ae5..58e732780b9 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -55,12 +55,9 @@ export default defineConfig({
         middlewareMode: false,
         watch: {
             additionalPaths: (watcher) => {
-                watcher.add('_pages/**');
-                watcher.add('_posts/**');
-                watcher.add('_docs/**');
-                watcher.add('_pages/**/**');
-                watcher.add('_posts/**/**');
-                watcher.add('_docs/**/**');
+                ['_pages', '_posts', '_docs'].forEach(folder => {
+                    watcher.add(`${folder}/**`);
+                });
             }
         }
     },
diff --git a/vite.config.js b/vite.config.js
index 149b4628ae5..58e732780b9 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -55,12 +55,9 @@ export default defineConfig({
         middlewareMode: false,
         watch: {
             additionalPaths: (watcher) => {
-                watcher.add('_pages/**');
-                watcher.add('_posts/**');
-                watcher.add('_docs/**');
-                watcher.add('_pages/**/**');
-                watcher.add('_posts/**/**');
-                watcher.add('_docs/**/**');
+                ['_pages', '_posts', '_docs'].forEach(folder => {
+                    watcher.add(`${folder}/**`);
+                });
             }
         }
     },

From 3e1c83082d5ca62484894adc51ca5db18a8975b7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:38:22 +0200
Subject: [PATCH 3971/4023] Initialize new Vite plugin

---
 packages/vite-plugin/.gitignore        |   1 +
 packages/vite-plugin/LICENSE.md        |  21 +
 packages/vite-plugin/README.md         |  39 ++
 packages/vite-plugin/package-lock.json | 894 +++++++++++++++++++++++++
 packages/vite-plugin/package.json      |  37 +
 packages/vite-plugin/tsconfig.json     |  15 +
 6 files changed, 1007 insertions(+)
 create mode 100644 packages/vite-plugin/.gitignore
 create mode 100644 packages/vite-plugin/LICENSE.md
 create mode 100644 packages/vite-plugin/README.md
 create mode 100644 packages/vite-plugin/package-lock.json
 create mode 100644 packages/vite-plugin/package.json
 create mode 100644 packages/vite-plugin/tsconfig.json

diff --git a/packages/vite-plugin/.gitignore b/packages/vite-plugin/.gitignore
new file mode 100644
index 00000000000..07e6e472cc7
--- /dev/null
+++ b/packages/vite-plugin/.gitignore
@@ -0,0 +1 @@
+/node_modules
diff --git a/packages/vite-plugin/LICENSE.md b/packages/vite-plugin/LICENSE.md
new file mode 100644
index 00000000000..7e800497572
--- /dev/null
+++ b/packages/vite-plugin/LICENSE.md
@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) Caen De Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
new file mode 100644
index 00000000000..1f19cf38cc9
--- /dev/null
+++ b/packages/vite-plugin/README.md
@@ -0,0 +1,39 @@
+# HydePHP Vite Plugin
+
+Official Vite plugin for HydePHP's realtime compiler integration.
+
+## Installation
+
+```bash
+npm install hyde-vite-plugin --save-dev
+```
+
+## Usage
+
+```js
+// vite.config.js
+import { defineConfig } from 'vite';
+import hyde from 'hyde-vite-plugin';
+import tailwindcss from '@tailwindcss/vite';
+
+export default defineConfig({
+    plugins: [
+        hyde({
+            // Optional configuration
+            input: ['resources/assets/app.css', 'resources/assets/app.js'],
+        }),
+        tailwindcss(),
+    ],
+});
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `input` | `string[]` | `['resources/assets/app.css', 'resources/assets/app.js']` | Asset entry points to process |
+| `refresh` | `boolean` | `true` | Enable hot reloading for content files |
+
+## License
+
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
diff --git a/packages/vite-plugin/package-lock.json b/packages/vite-plugin/package-lock.json
new file mode 100644
index 00000000000..39184bbe107
--- /dev/null
+++ b/packages/vite-plugin/package-lock.json
@@ -0,0 +1,894 @@
+{
+  "name": "hyde-vite-plugin",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "hyde-vite-plugin",
+      "version": "1.0.0",
+      "license": "MIT",
+      "devDependencies": {
+        "@types/node": "^20.0.0",
+        "typescript": "^5.0.0",
+        "vite": "^5.0.0"
+      },
+      "peerDependencies": {
+        "vite": "^4.0.0 || ^5.0.0"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
+      "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
+      "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
+      "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
+      "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
+      "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
+      "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
+      "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
+      "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
+      "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
+      "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
+      "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
+      "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
+      "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
+      "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
+      "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
+      "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
+      "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
+      "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
+      "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
+      "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
+      "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@rollup/rollup-android-arm-eabi": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.40.0.tgz",
+      "integrity": "sha512-+Fbls/diZ0RDerhE8kyC6hjADCXA1K4yVNlH0EYfd2XjyH0UGgzaQ8MlT0pCXAThfxv3QUAczHaL+qSv1E4/Cg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-android-arm64": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.40.0.tgz",
+      "integrity": "sha512-PPA6aEEsTPRz+/4xxAmaoWDqh67N7wFbgFUJGMnanCFs0TV99M0M8QhhaSCks+n6EbQoFvLQgYOGXxlMGQe/6w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "android"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-arm64": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.40.0.tgz",
+      "integrity": "sha512-GwYOcOakYHdfnjjKwqpTGgn5a6cUX7+Ra2HeNj/GdXvO2VJOOXCiYYlRFU4CubFM67EhbmzLOmACKEfvp3J1kQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-darwin-x64": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.40.0.tgz",
+      "integrity": "sha512-CoLEGJ+2eheqD9KBSxmma6ld01czS52Iw0e2qMZNpPDlf7Z9mj8xmMemxEucinev4LgHalDPczMyxzbq+Q+EtA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-arm64": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.40.0.tgz",
+      "integrity": "sha512-r7yGiS4HN/kibvESzmrOB/PxKMhPTlz+FcGvoUIKYoTyGd5toHp48g1uZy1o1xQvybwwpqpe010JrcGG2s5nkg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-freebsd-x64": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.40.0.tgz",
+      "integrity": "sha512-mVDxzlf0oLzV3oZOr0SMJ0lSDd3xC4CmnWJ8Val8isp9jRGl5Dq//LLDSPFrasS7pSm6m5xAcKaw3sHXhBjoRw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "freebsd"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.40.0.tgz",
+      "integrity": "sha512-y/qUMOpJxBMy8xCXD++jeu8t7kzjlOCkoxxajL58G62PJGBZVl/Gwpm7JK9+YvlB701rcQTzjUZ1JgUoPTnoQA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm-musleabihf": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.40.0.tgz",
+      "integrity": "sha512-GoCsPibtVdJFPv/BOIvBKO/XmwZLwaNWdyD8TKlXuqp0veo2sHE+A/vpMQ5iSArRUz/uaoj4h5S6Pn0+PdhRjg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.40.0.tgz",
+      "integrity": "sha512-L5ZLphTjjAD9leJzSLI7rr8fNqJMlGDKlazW2tX4IUF9P7R5TMQPElpH82Q7eNIDQnQlAyiNVfRPfP2vM5Avvg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-arm64-musl": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.40.0.tgz",
+      "integrity": "sha512-ATZvCRGCDtv1Y4gpDIXsS+wfFeFuLwVxyUBSLawjgXK2tRE6fnsQEkE4csQQYWlBlsFztRzCnBvWVfcae/1qxQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-loongarch64-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.40.0.tgz",
+      "integrity": "sha512-wG9e2XtIhd++QugU5MD9i7OnpaVb08ji3P1y/hNbxrQ3sYEelKJOq1UJ5dXczeo6Hj2rfDEL5GdtkMSVLa/AOg==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-powerpc64le-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.40.0.tgz",
+      "integrity": "sha512-vgXfWmj0f3jAUvC7TZSU/m/cOE558ILWDzS7jBhiCAFpY2WEBn5jqgbqvmzlMjtp8KlLcBlXVD2mkTSEQE6Ixw==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.40.0.tgz",
+      "integrity": "sha512-uJkYTugqtPZBS3Z136arevt/FsKTF/J9dEMTX/cwR7lsAW4bShzI2R0pJVw+hcBTWF4dxVckYh72Hk3/hWNKvA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-riscv64-musl": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.40.0.tgz",
+      "integrity": "sha512-rKmSj6EXQRnhSkE22+WvrqOqRtk733x3p5sWpZilhmjnkHkpeCgWsFFo0dGnUGeA+OZjRl3+VYq+HyCOEuwcxQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-s390x-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.40.0.tgz",
+      "integrity": "sha512-SpnYlAfKPOoVsQqmTFJ0usx0z84bzGOS9anAC0AZ3rdSo3snecihbhFTlJZ8XMwzqAcodjFU4+/SM311dqE5Sw==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-gnu": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.40.0.tgz",
+      "integrity": "sha512-RcDGMtqF9EFN8i2RYN2W+64CdHruJ5rPqrlYw+cgM3uOVPSsnAQps7cpjXe9be/yDp8UC7VLoCoKC8J3Kn2FkQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-linux-x64-musl": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.40.0.tgz",
+      "integrity": "sha512-HZvjpiUmSNx5zFgwtQAV1GaGazT2RWvqeDi0hV+AtC8unqqDSsaFjPxfsO6qPtKRRg25SisACWnJ37Yio8ttaw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "linux"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-arm64-msvc": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.40.0.tgz",
+      "integrity": "sha512-UtZQQI5k/b8d7d3i9AZmA/t+Q4tk3hOC0tMOMSq2GlMYOfxbesxG4mJSeDp0EHs30N9bsfwUvs3zF4v/RzOeTQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-ia32-msvc": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.40.0.tgz",
+      "integrity": "sha512-+m03kvI2f5syIqHXCZLPVYplP8pQch9JHyXKZ3AGMKlg8dCyr2PKHjwRLiW53LTrN/Nc3EqHOKxUxzoSPdKddA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@rollup/rollup-win32-x64-msvc": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.40.0.tgz",
+      "integrity": "sha512-lpPE1cLfP5oPzVjKMx10pgBmKELQnFJXHgvtHCtuJWOv8MxqdEIMNtgHgBFf7Ea2/7EuVwa9fodWUfXAlXZLZQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "optional": true,
+      "os": [
+        "win32"
+      ]
+    },
+    "node_modules/@types/estree": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz",
+      "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==",
+      "dev": true
+    },
+    "node_modules/@types/node": {
+      "version": "20.17.31",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.31.tgz",
+      "integrity": "sha512-quODOCNXQAbNf1Q7V+fI8WyErOCh0D5Yd31vHnKu4GkSztGQ7rlltAaqXhHhLl33tlVyUXs2386MkANSwgDn6A==",
+      "dev": true,
+      "dependencies": {
+        "undici-types": "~6.19.2"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.21.5",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
+      "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.21.5",
+        "@esbuild/android-arm": "0.21.5",
+        "@esbuild/android-arm64": "0.21.5",
+        "@esbuild/android-x64": "0.21.5",
+        "@esbuild/darwin-arm64": "0.21.5",
+        "@esbuild/darwin-x64": "0.21.5",
+        "@esbuild/freebsd-arm64": "0.21.5",
+        "@esbuild/freebsd-x64": "0.21.5",
+        "@esbuild/linux-arm": "0.21.5",
+        "@esbuild/linux-arm64": "0.21.5",
+        "@esbuild/linux-ia32": "0.21.5",
+        "@esbuild/linux-loong64": "0.21.5",
+        "@esbuild/linux-mips64el": "0.21.5",
+        "@esbuild/linux-ppc64": "0.21.5",
+        "@esbuild/linux-riscv64": "0.21.5",
+        "@esbuild/linux-s390x": "0.21.5",
+        "@esbuild/linux-x64": "0.21.5",
+        "@esbuild/netbsd-x64": "0.21.5",
+        "@esbuild/openbsd-x64": "0.21.5",
+        "@esbuild/sunos-x64": "0.21.5",
+        "@esbuild/win32-arm64": "0.21.5",
+        "@esbuild/win32-ia32": "0.21.5",
+        "@esbuild/win32-x64": "0.21.5"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true
+    },
+    "node_modules/postcss": {
+      "version": "8.5.3",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.3.tgz",
+      "integrity": "sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "dependencies": {
+        "nanoid": "^3.3.8",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "4.40.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.40.0.tgz",
+      "integrity": "sha512-Noe455xmA96nnqH5piFtLobsGbCij7Tu+tb3c1vYjNbTkfzGqXqQXG3wJaYXkRZuQ0vEYN4bhwg7QnIrqB5B+w==",
+      "dev": true,
+      "dependencies": {
+        "@types/estree": "1.0.7"
+      },
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "@rollup/rollup-android-arm-eabi": "4.40.0",
+        "@rollup/rollup-android-arm64": "4.40.0",
+        "@rollup/rollup-darwin-arm64": "4.40.0",
+        "@rollup/rollup-darwin-x64": "4.40.0",
+        "@rollup/rollup-freebsd-arm64": "4.40.0",
+        "@rollup/rollup-freebsd-x64": "4.40.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.40.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.40.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.40.0",
+        "@rollup/rollup-linux-arm64-musl": "4.40.0",
+        "@rollup/rollup-linux-loongarch64-gnu": "4.40.0",
+        "@rollup/rollup-linux-powerpc64le-gnu": "4.40.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.40.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.40.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.40.0",
+        "@rollup/rollup-linux-x64-gnu": "4.40.0",
+        "@rollup/rollup-linux-x64-musl": "4.40.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.40.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.40.0",
+        "@rollup/rollup-win32-x64-msvc": "4.40.0",
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.8.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.8.3.tgz",
+      "integrity": "sha512-p1diW6TqL9L07nNxvRMM7hMMw4c5XOo/1ibL4aAIGmSAt9slTE1Xgw5KWuof2uTOvCg9BY7ZRi+GaF+7sfgPeQ==",
+      "dev": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.19.8",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
+      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+      "dev": true
+    },
+    "node_modules/vite": {
+      "version": "5.4.18",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.18.tgz",
+      "integrity": "sha512-1oDcnEp3lVyHCuQ2YFelM4Alm2o91xNoMncRm1U7S+JdYfYOvbiGZ3/CxGttrOu2M/KcGz7cRC2DoNUA6urmMA==",
+      "dev": true,
+      "dependencies": {
+        "esbuild": "^0.21.3",
+        "postcss": "^8.4.43",
+        "rollup": "^4.20.0"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^18.0.0 || >=20.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      },
+      "peerDependencies": {
+        "@types/node": "^18.0.0 || >=20.0.0",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "sass-embedded": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "sass-embedded": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        }
+      }
+    }
+  }
+}
diff --git a/packages/vite-plugin/package.json b/packages/vite-plugin/package.json
new file mode 100644
index 00000000000..b0085cecffb
--- /dev/null
+++ b/packages/vite-plugin/package.json
@@ -0,0 +1,37 @@
+{
+  "name": "hyde-vite-plugin",
+  "version": "1.0.0",
+  "description": "HydePHP Vite plugin for realtime compiler integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hydephp/framework.git"
+  },
+  "keywords": [
+    "hydephp",
+    "hyde",
+    "vite",
+    "plugin"
+  ],
+  "author": "Caen De Silva",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/hydephp/framework/issues"
+  },
+  "homepage": "https://github.com/hydephp/framework/tree/master/packages/vite-plugin",
+  "peerDependencies": {
+    "vite": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "vite": "^5.0.0"
+  }
+}
diff --git a/packages/vite-plugin/tsconfig.json b/packages/vite-plugin/tsconfig.json
new file mode 100644
index 00000000000..975c01ca556
--- /dev/null
+++ b/packages/vite-plugin/tsconfig.json
@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

From 98ee53a42cf54eba233d22f59acb6496101c7e65 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:38:41 +0200
Subject: [PATCH 3972/4023] Create main Vite plugin code

---
 packages/vite-plugin/src/index.ts | 167 ++++++++++++++++++++++++++++++
 1 file changed, 167 insertions(+)
 create mode 100644 packages/vite-plugin/src/index.ts

diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
new file mode 100644
index 00000000000..98945e44f8c
--- /dev/null
+++ b/packages/vite-plugin/src/index.ts
@@ -0,0 +1,167 @@
+import { Plugin, ResolvedConfig } from 'vite';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Define the hot file path as a constant
+const HOT_FILE_PATH = 'app/storage/framework/runtime/vite.hot';
+
+export interface HydePluginOptions {
+  /**
+   * Asset entry points to process
+   * @default ['resources/assets/app.css', 'resources/assets/app.js']
+   */
+  input?: string[];
+
+  /**
+   * Enable hot reloading for content files
+   * @default true
+   */
+  refresh?: boolean;
+}
+
+/**
+ * Resolve the path to a resource
+ * This function ensures that the path works when used as an ESM package as well
+ */
+function resolveResource(resource: string): string {
+  // In ESM context, __dirname is not available, so we use fileURLToPath
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    
+    return path.resolve(__dirname, '../resources', resource);
+  } catch (e) {
+    // Fallback for CommonJS
+    return path.resolve(__dirname, '../resources', resource);
+  }
+}
+
+/**
+ * Check if a file exists
+ */
+function fileExists(file: string): boolean {
+  try {
+    return fs.statSync(file).isFile();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if the JavaScript file has actual content
+ * This prevents empty app.js files from being compiled
+ */
+function hasJavaScriptContent(filePath: string): boolean {
+  try {
+    if (!fs.existsSync(filePath)) return false;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    // Remove comments and check if there's any actual code
+    return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * HydePHP Vite plugin for realtime compiler integration
+ */
+export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
+  const {
+    input = ['resources/assets/app.css', 'resources/assets/app.js'],
+    refresh = true,
+  } = options;
+
+  let config: ResolvedConfig;
+  let hotFilePath: string;
+
+  return {
+    name: 'hyde-vite-plugin',
+
+    config(config, { command }) {
+      // Only modify build configuration
+      if (command === 'build') {
+        // Process input files - only include app.js if it has content
+        const resolvedInput = [];
+        
+        for (const entry of input) {
+          const resolvedPath = path.resolve(process.cwd(), entry);
+          
+          // Only include app.js if it has actual content
+          if (entry.endsWith('app.js')) {
+            if (hasJavaScriptContent(resolvedPath) && fileExists(resolvedPath)) {
+              resolvedInput.push(resolvedPath);
+            }
+          } else if (fileExists(resolvedPath)) {
+            resolvedInput.push(resolvedPath);
+          }
+        }
+
+        return {
+          build: {
+            outDir: '_media',
+            emptyOutDir: false,
+            rollupOptions: {
+              input: resolvedInput,
+              output: {
+                entryFileNames: '[name].js',
+                chunkFileNames: '[name].js',
+                assetFileNames: '[name].[ext]'
+              }
+            }
+          }
+        };
+      }
+    },
+
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+      hotFilePath = path.resolve(process.cwd(), HOT_FILE_PATH);
+    },
+
+    configureServer(server) {
+      // Create hot file when Vite server starts
+      fs.mkdirSync(path.dirname(hotFilePath), { recursive: true });
+      fs.writeFileSync(hotFilePath, '');
+
+      // Remove hot file when Vite server closes
+      ['SIGINT', 'SIGTERM'].forEach(signal => {
+        process.on(signal, () => {
+          try {
+            fs.rmSync(hotFilePath);
+          } catch (e) {
+            // Ignore errors when removing hot file
+          }
+          process.exit();
+        });
+      });
+
+      // Render the Vite index page when the root URL is requested
+      server.middlewares.use((req, res, next) => {
+        if (req.url === '/') {
+          try {
+            const indexPath = resolveResource('vite-index-page.html');
+            const content = fs.readFileSync(indexPath, 'utf-8');
+            res.end(content);
+          } catch (e) {
+            next();
+          }
+        } else {
+          next();
+        }
+      });
+
+      // Add additional watch paths for content files if refresh option is enabled
+      if (refresh) {
+        const contentDirs = ['_pages', '_posts', '_docs'];
+        contentDirs.forEach(dir => {
+          const contentPath = path.resolve(process.cwd(), dir);
+          if (fs.existsSync(contentPath)) {
+            server.watcher.add(path.join(contentPath, '**'));
+            server.watcher.add(path.join(contentPath, '**/**'));
+          }
+        });
+      }
+    }
+  };
+} 
\ No newline at end of file

From f6e49a7b8325b88d986dc5795738baa1ba6ee456 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:38:50 +0200
Subject: [PATCH 3973/4023] Compile Vite plugin

---
 packages/vite-plugin/dist/index.d.ts |  17 ++++
 packages/vite-plugin/dist/index.js   | 140 +++++++++++++++++++++++++++
 2 files changed, 157 insertions(+)
 create mode 100644 packages/vite-plugin/dist/index.d.ts
 create mode 100644 packages/vite-plugin/dist/index.js

diff --git a/packages/vite-plugin/dist/index.d.ts b/packages/vite-plugin/dist/index.d.ts
new file mode 100644
index 00000000000..b78b7136ee3
--- /dev/null
+++ b/packages/vite-plugin/dist/index.d.ts
@@ -0,0 +1,17 @@
+import { Plugin } from 'vite';
+export interface HydePluginOptions {
+    /**
+     * Asset entry points to process
+     * @default ['resources/assets/app.css', 'resources/assets/app.js']
+     */
+    input?: string[];
+    /**
+     * Enable hot reloading for content files
+     * @default true
+     */
+    refresh?: boolean;
+}
+/**
+ * HydePHP Vite plugin for realtime compiler integration
+ */
+export default function hydePlugin(options?: HydePluginOptions): Plugin;
diff --git a/packages/vite-plugin/dist/index.js b/packages/vite-plugin/dist/index.js
new file mode 100644
index 00000000000..af9d5836118
--- /dev/null
+++ b/packages/vite-plugin/dist/index.js
@@ -0,0 +1,140 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+// Define the hot file path as a constant
+const HOT_FILE_PATH = 'app/storage/framework/runtime/vite.hot';
+/**
+ * Resolve the path to a resource
+ * This function ensures that the path works when used as an ESM package as well
+ */
+function resolveResource(resource) {
+    // In ESM context, __dirname is not available, so we use fileURLToPath
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        return path.resolve(__dirname, '../resources', resource);
+    }
+    catch (e) {
+        // Fallback for CommonJS
+        return path.resolve(__dirname, '../resources', resource);
+    }
+}
+/**
+ * Check if a file exists
+ */
+function fileExists(file) {
+    try {
+        return fs.statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if the JavaScript file has actual content
+ * This prevents empty app.js files from being compiled
+ */
+function hasJavaScriptContent(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return false;
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Remove comments and check if there's any actual code
+        return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
+    }
+    catch (e) {
+        return false;
+    }
+}
+/**
+ * HydePHP Vite plugin for realtime compiler integration
+ */
+export default function hydePlugin(options = {}) {
+    const { input = ['resources/assets/app.css', 'resources/assets/app.js'], refresh = true, } = options;
+    let config;
+    let hotFilePath;
+    return {
+        name: 'hyde-vite-plugin',
+        config(config, { command }) {
+            // Only modify build configuration
+            if (command === 'build') {
+                // Process input files - only include app.js if it has content
+                const resolvedInput = [];
+                for (const entry of input) {
+                    const resolvedPath = path.resolve(process.cwd(), entry);
+                    // Only include app.js if it has actual content
+                    if (entry.endsWith('app.js')) {
+                        if (hasJavaScriptContent(resolvedPath) && fileExists(resolvedPath)) {
+                            resolvedInput.push(resolvedPath);
+                        }
+                    }
+                    else if (fileExists(resolvedPath)) {
+                        resolvedInput.push(resolvedPath);
+                    }
+                }
+                return {
+                    build: {
+                        outDir: '_media',
+                        emptyOutDir: false,
+                        rollupOptions: {
+                            input: resolvedInput,
+                            output: {
+                                entryFileNames: '[name].js',
+                                chunkFileNames: '[name].js',
+                                assetFileNames: '[name].[ext]'
+                            }
+                        }
+                    }
+                };
+            }
+        },
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            hotFilePath = path.resolve(process.cwd(), HOT_FILE_PATH);
+        },
+        configureServer(server) {
+            // Create hot file when Vite server starts
+            fs.mkdirSync(path.dirname(hotFilePath), { recursive: true });
+            fs.writeFileSync(hotFilePath, '');
+            // Remove hot file when Vite server closes
+            ['SIGINT', 'SIGTERM'].forEach(signal => {
+                process.on(signal, () => {
+                    try {
+                        fs.rmSync(hotFilePath);
+                    }
+                    catch (e) {
+                        // Ignore errors when removing hot file
+                    }
+                    process.exit();
+                });
+            });
+            // Render the Vite index page when the root URL is requested
+            server.middlewares.use((req, res, next) => {
+                if (req.url === '/') {
+                    try {
+                        const indexPath = resolveResource('vite-index-page.html');
+                        const content = fs.readFileSync(indexPath, 'utf-8');
+                        res.end(content);
+                    }
+                    catch (e) {
+                        next();
+                    }
+                }
+                else {
+                    next();
+                }
+            });
+            // Add additional watch paths for content files if refresh option is enabled
+            if (refresh) {
+                const contentDirs = ['_pages', '_posts', '_docs'];
+                contentDirs.forEach(dir => {
+                    const contentPath = path.resolve(process.cwd(), dir);
+                    if (fs.existsSync(contentPath)) {
+                        server.watcher.add(path.join(contentPath, '**'));
+                        server.watcher.add(path.join(contentPath, '**/**'));
+                    }
+                });
+            }
+        }
+    };
+}

From aa9807e0444a9ddf12e0d28bfcb7f79a1f5605a2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:38:55 +0200
Subject: [PATCH 3974/4023] Create Vite index page file

---
 .../resources/vite-index-page.html            | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 packages/vite-plugin/resources/vite-index-page.html

diff --git a/packages/vite-plugin/resources/vite-index-page.html b/packages/vite-plugin/resources/vite-index-page.html
new file mode 100644
index 00000000000..aee5828f9c3
--- /dev/null
+++ b/packages/vite-plugin/resources/vite-index-page.html
@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+
+        <title>HydePHP Vite</title>
+
+        <link href="https://fonts.googleapis.com/css2?family=Nunito:wght@400;600;700&display=swap" rel="stylesheet">
+
+        <script src="https://cdn.tailwindcss.com"></script>
+    </head>
+    <body class="antialiased">
+        <div class="relative flex min-h-screen flex-col justify-center overflow-hidden bg-gray-100 text-gray-600 dark:text-gray-400 dark:bg-gray-900 py-6 sm:py-12">
+            <div class="relative bg-white dark:bg-gray-800 px-6 pt-10 pb-8 shadow-xl ring-1 ring-gray-900/5 sm:mx-auto sm:max-w-xl sm:rounded-lg sm:px-10">
+                <div class="mx-auto">
+                    <div class="flex items-center justify-center">
+                        <a href="https://hydephp.com">
+                           <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:serif="http://www.serif.com/" width="4rem" class="h-24 w-auto" viewBox="0 0 4267 4267" version="1.1" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><rect id="masked" x="0" y="0" width="4266.67" height="4266.67" style="fill:none;"/><g id="base"/><g id="src"><path d="M3099.01,2876.31l142.659,-1865.88c-0,-10.687 -0.634,-20.82 -1.663,-29.529c0.238,-2.612 1.663,-5.937 1.663,-8.708c-0,-142.817 -496.296,-258.638 -1108.33,-258.638c-612.116,0 -1108.33,115.742 -1108.33,258.638c-0,2.771 1.346,5.383 1.742,8.075c-1.109,8.708 -1.742,18.208 -1.742,28.896l142.658,1867.15c-277.4,72.041 -459.325,173.454 -459.325,286.187c0,218.658 681.704,395.833 1425,395.833c743.296,0 1425,-177.175 1425,-395.833c0,-112.733 -181.925,-214.146 -459.325,-286.188Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/><path d="M2096.6,1230.44c-387.125,-0.001 -680.992,-70.934 -859.117,-130.309c-41.483,-13.854 -63.966,-58.662 -50.112,-100.146c13.854,-41.483 58.504,-63.966 100.146,-50.112c228.712,76.237 851.991,228.871 1695.83,-1.267c41.879,-11.242 85.658,13.3 97.137,55.575c11.559,42.196 -13.379,85.738 -55.575,97.217c-348.808,95.158 -660.804,129.041 -928.308,129.041Z" style="fill:#66757f;fill-opacity:0.1;fill-rule:nonzero;"/><path d="M3099.01,2876.31l35.309,-461.463c-609.98,170.763 -1392.15,174.721 -2004.18,-29.846l31.113,407.075c5.462,24.067 8.946,51.459 8.946,85.184c-0,138.541 102.045,223.883 219.37,268.85c352.925,135.216 1105.01,130.308 1488.89,11.795c116.137,-35.862 219.767,-137.195 219.767,-252.62c-0,-9.421 1.187,-19.08 1.9,-28.58l-1.109,-0.395Z" style="fill:url(#_Linear2);fill-rule:nonzero;"/><g id="gradient.svg"/></g><defs><linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(2850,0,0,2844.78,708.333,2135.95)"><stop offset="0" style="stop-color:#141e30;stop-opacity:1"/><stop offset="1" style="stop-color:#243b55;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(3008.33,-1187.5,510.846,1294.14,945.833,3320.83)"><stop offset="0" style="stop-color:#8a2387;stop-opacity:1"/><stop offset="0.5" style="stop-color:#e94057;stop-opacity:1"/><stop offset="1" style="stop-color:#f27121;stop-opacity:1"/></linearGradient></defs></svg>
+                        </a>
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6  text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" width="2rem">
+                            <path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" />
+                        </svg>
+                        <a href="https://vitejs.dev">
+                            <svg viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg" width="4rem" class="h-16 ml-3 w-auto">
+                                <path d="M399.641 59.5246L215.643 388.545C211.844 395.338 202.084 395.378 198.228 388.618L10.5817 59.5563C6.38087 52.1896 12.6802 43.2665 21.0281 44.7586L205.223 77.6824C206.398 77.8924 207.601 77.8904 208.776 77.6763L389.119 44.8058C397.439 43.2894 403.768 52.1434 399.641 59.5246Z" fill="url(#paint0_linear)" />
+                                <path d="M292.965 1.5744L156.801 28.2552C154.563 28.6937 152.906 30.5903 152.771 32.8664L144.395 174.33C144.198 177.662 147.258 180.248 150.51 179.498L188.42 170.749C191.967 169.931 195.172 173.055 194.443 176.622L183.18 231.775C182.422 235.487 185.907 238.661 189.532 237.56L212.947 230.446C216.577 229.344 220.065 232.527 219.297 236.242L201.398 322.875C200.278 328.294 207.486 331.249 210.492 326.603L212.5 323.5L323.454 102.072C325.312 98.3645 322.108 94.137 318.036 94.9228L279.014 102.454C275.347 103.161 272.227 99.746 273.262 96.1583L298.731 7.86689C299.767 4.27314 296.636 0.855181 292.965 1.5744Z" fill="url(#paint1_linear)" />
+                                <defs>
+                                    <linearGradient id="paint0_linear" x1="6.00017" y1="32.9999" x2="235" y2="344" gradientUnits="userSpaceOnUse">
+                                        <stop stop-color="#41D1FF" />
+                                        <stop offset="1" stop-color="#BD34FE" />
+                                    </linearGradient>
+                                    <linearGradient id="paint1_linear" x1="194.651" y1="8.81818" x2="236.076" y2="292.989" gradientUnits="userSpaceOnUse">
+                                        <stop stop-color="#FFEA83" />
+                                        <stop offset="0.0833333" stop-color="#FFDD35" />
+                                        <stop offset="1" stop-color="#FFA800" />
+                                    </linearGradient>
+                                </defs>
+                            </svg>
+                        </a>
+                    </div>
+                    <div class="divide-y divide-gray-300 dark:divide-gray-700">
+                        <div class="py-8 text-base leading-7">
+                            <p>This is the Vite development server that provides Hot Module Replacement for your HydePHP site.</p>
+                            <p class="mt-6">Your HydePHP site is running on the Realtime Compiler server.</p>
+                            <h2 class="mt-6"><a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Realtime Compiler</a></h2>
+                            <p>The main development server for your HydePHP site.</p>
+                            <h2 class="mt-6"><a href="http://localhost:8080/dashboard" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Dashboard</a></h2>
+                            <p>Access the realtime compiler dashboard to monitor your site.</p>
+                        </div>
+                        <div class="pt-8 text-base leading-7">
+                            <p>
+                                Your HydePHP site is running at:<br />
+                                <a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">http://localhost:8080</a>
+                            </p>
+                            <p class="mt-6">Want to learn more about HydePHP?</p>
+                            <p>
+                                <a href="https://hydephp.com/docs" class="font-semibold text-indigo-500 hover:text-indigo-600">Read the docs &rarr;</a>
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </body>
+</html>

From 9a0a8ae5f3c57f71fc5ad38d904d57ff8d28fecc Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:39:00 +0200
Subject: [PATCH 3975/4023] Create CHANGELOG.md

---
 packages/vite-plugin/CHANGELOG.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 packages/vite-plugin/CHANGELOG.md

diff --git a/packages/vite-plugin/CHANGELOG.md b/packages/vite-plugin/CHANGELOG.md
new file mode 100644
index 00000000000..59bc0459819
--- /dev/null
+++ b/packages/vite-plugin/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+## 1.0.0 (Initial Release)
+
+- Initial release of the HydePHP Vite Plugin
+- Extracted Vite server functionality from the main vite.config.js into a dedicated plugin
+- Added TypeScript support
+- Added configuration options for customizing input files and content refresh
+- Implemented internal IPC hot file handling

From 2880f39ec873ce98f1ab02926c3b8753cac71d91 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:39:09 +0200
Subject: [PATCH 3976/4023] Use the new Vite plugin

---
 packages/hyde/vite.config.js | 88 +++++-------------------------------
 vite.config.js               | 88 +++++-------------------------------
 2 files changed, 22 insertions(+), 154 deletions(-)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index 58e732780b9..c7ec7f5b3b3 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -3,85 +3,19 @@
 // to compile the assets. See https://hydephp.com/docs/1.x/managing-assets.html.
 
 import { defineConfig } from 'vite';
-import { resolve } from 'path';
 import tailwindcss from "@tailwindcss/vite";
-import autoprefixer from 'autoprefixer';
-import fs from 'fs';
-import path from 'path';
 
-// Todo: This will be moved to a package instead of having it here.
-const hydeVitePlugin = () => ({
-    name: 'hyde-vite',
-    configureServer(server) {
-        // Create hot file when Vite server starts
-        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'), '');
-
-        // Remove hot file when Vite server closes
-        ['SIGINT', 'SIGTERM'].forEach(signal => {
-            process.on(signal, () => {
-                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'));
-                process.exit();
-            });
-        });
-
-        // Render the Vite index page when the root URL is requested
-        server.middlewares.use((req, res, next) => {
-            if (req.url === '/') {
-                res.end(fs.readFileSync(
-                    path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
-                    'utf-8'
-                ));
-            } else {
-                next();
-            }
-        });
-    }
-});
-
-const hasJavaScriptContent = () => {
-    const appJsPath = resolve(__dirname, 'resources/assets/app.js');
-    if (!fs.existsSync(appJsPath)) return false;
-    const content = fs.readFileSync(appJsPath, 'utf-8');
-    return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
-};
+// Import the HydePHP Vite plugin
+// In a real-world scenario, this would be:
+// import hyde from 'hyde-vite-plugin';
+import hyde from './packages/vite-plugin/dist/index.js';
 
 export default defineConfig({
-    server: {
-        port: 5173,
-        hmr: {
-            host: 'localhost',
-            port: 5173,
-        },
-        middlewareMode: false,
-        watch: {
-            additionalPaths: (watcher) => {
-                ['_pages', '_posts', '_docs'].forEach(folder => {
-                    watcher.add(`${folder}/**`);
-                });
-            }
-        }
-    },
-    plugins: [hydeVitePlugin(), tailwindcss()],
-    css: {
-        postcss: {
-            plugins: [
-                autoprefixer,
-            ]
-        }
-    },
-    build: {
-        outDir: '_media',
-        emptyOutDir: false,
-        rollupOptions: {
-            input: [
-                ...(hasJavaScriptContent() ? [resolve(__dirname, 'resources/assets/app.js')] : []),
-                resolve(__dirname, 'resources/assets/app.css')
-            ],
-            output: {
-                entryFileNames: '[name].js',
-                chunkFileNames: '[name].js',
-                assetFileNames: '[name].[ext]'
-            }
-        }
-    }
+    plugins: [
+        hyde({
+            input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            refresh: true,
+        }),
+        tailwindcss(),
+    ],
 });
diff --git a/vite.config.js b/vite.config.js
index 58e732780b9..c7ec7f5b3b3 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -3,85 +3,19 @@
 // to compile the assets. See https://hydephp.com/docs/1.x/managing-assets.html.
 
 import { defineConfig } from 'vite';
-import { resolve } from 'path';
 import tailwindcss from "@tailwindcss/vite";
-import autoprefixer from 'autoprefixer';
-import fs from 'fs';
-import path from 'path';
 
-// Todo: This will be moved to a package instead of having it here.
-const hydeVitePlugin = () => ({
-    name: 'hyde-vite',
-    configureServer(server) {
-        // Create hot file when Vite server starts
-        fs.writeFileSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'), '');
-
-        // Remove hot file when Vite server closes
-        ['SIGINT', 'SIGTERM'].forEach(signal => {
-            process.on(signal, () => {
-                fs.rmSync(path.resolve(process.cwd(), 'app/storage/framework/runtime/vite.hot'));
-                process.exit();
-            });
-        });
-
-        // Render the Vite index page when the root URL is requested
-        server.middlewares.use((req, res, next) => {
-            if (req.url === '/') {
-                res.end(fs.readFileSync(
-                    path.resolve(__dirname, 'vendor/hyde/realtime-compiler/resources/vite-index-page.html'),
-                    'utf-8'
-                ));
-            } else {
-                next();
-            }
-        });
-    }
-});
-
-const hasJavaScriptContent = () => {
-    const appJsPath = resolve(__dirname, 'resources/assets/app.js');
-    if (!fs.existsSync(appJsPath)) return false;
-    const content = fs.readFileSync(appJsPath, 'utf-8');
-    return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
-};
+// Import the HydePHP Vite plugin
+// In a real-world scenario, this would be:
+// import hyde from 'hyde-vite-plugin';
+import hyde from './packages/vite-plugin/dist/index.js';
 
 export default defineConfig({
-    server: {
-        port: 5173,
-        hmr: {
-            host: 'localhost',
-            port: 5173,
-        },
-        middlewareMode: false,
-        watch: {
-            additionalPaths: (watcher) => {
-                ['_pages', '_posts', '_docs'].forEach(folder => {
-                    watcher.add(`${folder}/**`);
-                });
-            }
-        }
-    },
-    plugins: [hydeVitePlugin(), tailwindcss()],
-    css: {
-        postcss: {
-            plugins: [
-                autoprefixer,
-            ]
-        }
-    },
-    build: {
-        outDir: '_media',
-        emptyOutDir: false,
-        rollupOptions: {
-            input: [
-                ...(hasJavaScriptContent() ? [resolve(__dirname, 'resources/assets/app.js')] : []),
-                resolve(__dirname, 'resources/assets/app.css')
-            ],
-            output: {
-                entryFileNames: '[name].js',
-                chunkFileNames: '[name].js',
-                assetFileNames: '[name].[ext]'
-            }
-        }
-    }
+    plugins: [
+        hyde({
+            input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            refresh: true,
+        }),
+        tailwindcss(),
+    ],
 });

From b7cdc524679d250ee1ee29e6b1914356c4579337 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:44:38 +0200
Subject: [PATCH 3977/4023] Create option to set watchers

---
 packages/vite-plugin/README.md    |  2 ++
 packages/vite-plugin/src/index.ts | 10 ++++++++--
 vite.config.js                    |  1 +
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index 1f19cf38cc9..b8ee7bf0a1d 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -21,6 +21,7 @@ export default defineConfig({
         hyde({
             // Optional configuration
             input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            watch: ['_pages', '_posts', '_docs'],
         }),
         tailwindcss(),
     ],
@@ -33,6 +34,7 @@ export default defineConfig({
 |--------|------|---------|-------------|
 | `input` | `string[]` | `['resources/assets/app.css', 'resources/assets/app.js']` | Asset entry points to process |
 | `refresh` | `boolean` | `true` | Enable hot reloading for content files |
+| `watch` | `string[]` | `['_pages', '_posts', '_docs']` | Content directories to watch for changes |
 
 ## License
 
diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
index 98945e44f8c..e035d303481 100644
--- a/packages/vite-plugin/src/index.ts
+++ b/packages/vite-plugin/src/index.ts
@@ -18,6 +18,12 @@ export interface HydePluginOptions {
    * @default true
    */
   refresh?: boolean;
+
+  /**
+   * Content directories to watch for changes
+   * @default ['_pages', '_posts', '_docs']
+   */
+  watch?: string[];
 }
 
 /**
@@ -69,6 +75,7 @@ function hasJavaScriptContent(filePath: string): boolean {
 export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
   const {
     input = ['resources/assets/app.css', 'resources/assets/app.js'],
+    watch = ['_pages', '_posts', '_docs'],
     refresh = true,
   } = options;
 
@@ -153,8 +160,7 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
 
       // Add additional watch paths for content files if refresh option is enabled
       if (refresh) {
-        const contentDirs = ['_pages', '_posts', '_docs'];
-        contentDirs.forEach(dir => {
+        watch.forEach(dir => {
           const contentPath = path.resolve(process.cwd(), dir);
           if (fs.existsSync(contentPath)) {
             server.watcher.add(path.join(contentPath, '**'));
diff --git a/vite.config.js b/vite.config.js
index c7ec7f5b3b3..b24862789b5 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -14,6 +14,7 @@ export default defineConfig({
     plugins: [
         hyde({
             input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            watch: ['_pages', '_posts', '_docs'],
             refresh: true,
         }),
         tailwindcss(),

From 1aa2f92d0efbf7888e1843e5a75a1596929d2fa6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:46:10 +0200
Subject: [PATCH 3978/4023] Add changelog disclaimer

---
 packages/vite-plugin/CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/vite-plugin/CHANGELOG.md b/packages/vite-plugin/CHANGELOG.md
index 59bc0459819..8fced5d4875 100644
--- a/packages/vite-plugin/CHANGELOG.md
+++ b/packages/vite-plugin/CHANGELOG.md
@@ -1,5 +1,7 @@
 # Changelog
 
+Please note that this package is a companion package to `hyde/hyde` and `hyde/realtime-compiler` and is not intended to be used outside of those environments. No such support will be given, and the major version ranges used for all three must match the compatibility matrix.
+
 ## 1.0.0 (Initial Release)
 
 - Initial release of the HydePHP Vite Plugin

From 779bcee72bd674eb8f5a3d85da9486bdbed65749 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:48:51 +0200
Subject: [PATCH 3979/4023] Clarify documentation

---
 packages/vite-plugin/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index b8ee7bf0a1d..21ce3dfd9ef 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -21,6 +21,7 @@ export default defineConfig({
         hyde({
             // Optional configuration
             input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            // Files to watch for changes, in addition to input paths
             watch: ['_pages', '_posts', '_docs'],
         }),
         tailwindcss(),

From a11a45a5eb96c0c613913e539768d917d53c14c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:49:01 +0200
Subject: [PATCH 3980/4023] Reformat table

---
 packages/vite-plugin/README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index 21ce3dfd9ef..22f24050804 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -31,11 +31,11 @@ export default defineConfig({
 
 ## Options
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `input` | `string[]` | `['resources/assets/app.css', 'resources/assets/app.js']` | Asset entry points to process |
-| `refresh` | `boolean` | `true` | Enable hot reloading for content files |
-| `watch` | `string[]` | `['_pages', '_posts', '_docs']` | Content directories to watch for changes |
+| Option    | Type       | Default                                                   | Description                              |
+|-----------|------------|-----------------------------------------------------------|------------------------------------------|
+| `input`   | `string[]` | `['resources/assets/app.css', 'resources/assets/app.js']` | Asset entry points to process            |
+| `refresh` | `boolean`  | `true`                                                    | Enable hot reloading for content files   |
+| `watch`   | `string[]` | `['_pages', '_posts', '_docs']`                           | Content directories to watch for changes |
 
 ## License
 

From ce8dae8d0eff563cdb12b6877b17b56c1ed6c44e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:49:10 +0200
Subject: [PATCH 3981/4023] Format whitespace

---
 packages/vite-plugin/src/index.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
index e035d303481..25d306ee26c 100644
--- a/packages/vite-plugin/src/index.ts
+++ b/packages/vite-plugin/src/index.ts
@@ -35,7 +35,7 @@ function resolveResource(resource: string): string {
   try {
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = path.dirname(__filename);
-    
+
     return path.resolve(__dirname, '../resources', resource);
   } catch (e) {
     // Fallback for CommonJS
@@ -90,10 +90,10 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
       if (command === 'build') {
         // Process input files - only include app.js if it has content
         const resolvedInput = [];
-        
+
         for (const entry of input) {
           const resolvedPath = path.resolve(process.cwd(), entry);
-          
+
           // Only include app.js if it has actual content
           if (entry.endsWith('app.js')) {
             if (hasJavaScriptContent(resolvedPath) && fileExists(resolvedPath)) {
@@ -170,4 +170,4 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
       }
     }
   };
-} 
\ No newline at end of file
+}

From 3f4c1682fb7525ee59a7c4ab3f272870636b3228 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:52:32 +0200
Subject: [PATCH 3982/4023] Clean up comments

---
 packages/vite-plugin/src/index.ts | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
index 25d306ee26c..3a5b1a30ef6 100644
--- a/packages/vite-plugin/src/index.ts
+++ b/packages/vite-plugin/src/index.ts
@@ -3,32 +3,34 @@ import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
-// Define the hot file path as a constant
+// The interprocess communication signal file for the web server
 const HOT_FILE_PATH = 'app/storage/framework/runtime/vite.hot';
 
 export interface HydePluginOptions {
   /**
    * Asset entry points to process
+   *
    * @default ['resources/assets/app.css', 'resources/assets/app.js']
    */
   input?: string[];
 
   /**
    * Enable hot reloading for content files
+   *
    * @default true
    */
   refresh?: boolean;
 
   /**
    * Content directories to watch for changes
+   *
    * @default ['_pages', '_posts', '_docs']
    */
   watch?: string[];
 }
 
 /**
- * Resolve the path to a resource
- * This function ensures that the path works when used as an ESM package as well
+ * Resolve the path to a resource, ensuring that the path works when used as an ESM package.
  */
 function resolveResource(resource: string): string {
   // In ESM context, __dirname is not available, so we use fileURLToPath
@@ -44,7 +46,7 @@ function resolveResource(resource: string): string {
 }
 
 /**
- * Check if a file exists
+ * Check if a file exists and is a file
  */
 function fileExists(file: string): boolean {
   try {
@@ -55,8 +57,7 @@ function fileExists(file: string): boolean {
 }
 
 /**
- * Check if the JavaScript file has actual content
- * This prevents empty app.js files from being compiled
+ * Check if the JavaScript file has actual content to prevent empty app.js files from being compiled
  */
 function hasJavaScriptContent(filePath: string): boolean {
   try {

From 41ab5a8a4f0bad6ab599acbc53decd937e2759ca Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:54:35 +0200
Subject: [PATCH 3983/4023] Sync file

---
 packages/hyde/vite.config.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index c7ec7f5b3b3..b24862789b5 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -14,6 +14,7 @@ export default defineConfig({
     plugins: [
         hyde({
             input: ['resources/assets/app.css', 'resources/assets/app.js'],
+            watch: ['_pages', '_posts', '_docs'],
             refresh: true,
         }),
         tailwindcss(),

From 2da23a1db53fddfbdc3848e42ad63ed9e3f79734 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 14:55:13 +0200
Subject: [PATCH 3984/4023] Clean up code

---
 packages/vite-plugin/src/index.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
index 3a5b1a30ef6..d7cd4dbe0b7 100644
--- a/packages/vite-plugin/src/index.ts
+++ b/packages/vite-plugin/src/index.ts
@@ -39,7 +39,7 @@ function resolveResource(resource: string): string {
     const __dirname = path.dirname(__filename);
 
     return path.resolve(__dirname, '../resources', resource);
-  } catch (e) {
+  } catch (error) {
     // Fallback for CommonJS
     return path.resolve(__dirname, '../resources', resource);
   }
@@ -65,7 +65,7 @@ function hasJavaScriptContent(filePath: string): boolean {
     const content = fs.readFileSync(filePath, 'utf-8');
     // Remove comments and check if there's any actual code
     return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
-  } catch (e) {
+  } catch (error) {
     return false;
   }
 }
@@ -137,7 +137,7 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
         process.on(signal, () => {
           try {
             fs.rmSync(hotFilePath);
-          } catch (e) {
+          } catch (error) {
             // Ignore errors when removing hot file
           }
           process.exit();
@@ -151,7 +151,7 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
             const indexPath = resolveResource('vite-index-page.html');
             const content = fs.readFileSync(indexPath, 'utf-8');
             res.end(content);
-          } catch (e) {
+          } catch (error) {
             next();
           }
         } else {

From b42f7d91c0670b7ce21a68e268f716834138e2a7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:03:35 +0200
Subject: [PATCH 3985/4023] Build plugin

---
 packages/vite-plugin/dist/index.d.ts |  8 ++++++++
 packages/vite-plugin/dist/index.js   | 23 ++++++++++-------------
 2 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/packages/vite-plugin/dist/index.d.ts b/packages/vite-plugin/dist/index.d.ts
index b78b7136ee3..17b46bbf6b2 100644
--- a/packages/vite-plugin/dist/index.d.ts
+++ b/packages/vite-plugin/dist/index.d.ts
@@ -2,14 +2,22 @@ import { Plugin } from 'vite';
 export interface HydePluginOptions {
     /**
      * Asset entry points to process
+     *
      * @default ['resources/assets/app.css', 'resources/assets/app.js']
      */
     input?: string[];
     /**
      * Enable hot reloading for content files
+     *
      * @default true
      */
     refresh?: boolean;
+    /**
+     * Content directories to watch for changes
+     *
+     * @default ['_pages', '_posts', '_docs']
+     */
+    watch?: string[];
 }
 /**
  * HydePHP Vite plugin for realtime compiler integration
diff --git a/packages/vite-plugin/dist/index.js b/packages/vite-plugin/dist/index.js
index af9d5836118..a8533189c43 100644
--- a/packages/vite-plugin/dist/index.js
+++ b/packages/vite-plugin/dist/index.js
@@ -1,11 +1,10 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-// Define the hot file path as a constant
+// The interprocess communication signal file for the web server
 const HOT_FILE_PATH = 'app/storage/framework/runtime/vite.hot';
 /**
- * Resolve the path to a resource
- * This function ensures that the path works when used as an ESM package as well
+ * Resolve the path to a resource, ensuring that the path works when used as an ESM package.
  */
 function resolveResource(resource) {
     // In ESM context, __dirname is not available, so we use fileURLToPath
@@ -14,13 +13,13 @@ function resolveResource(resource) {
         const __dirname = path.dirname(__filename);
         return path.resolve(__dirname, '../resources', resource);
     }
-    catch (e) {
+    catch (error) {
         // Fallback for CommonJS
         return path.resolve(__dirname, '../resources', resource);
     }
 }
 /**
- * Check if a file exists
+ * Check if a file exists and is a file
  */
 function fileExists(file) {
     try {
@@ -31,8 +30,7 @@ function fileExists(file) {
     }
 }
 /**
- * Check if the JavaScript file has actual content
- * This prevents empty app.js files from being compiled
+ * Check if the JavaScript file has actual content to prevent empty app.js files from being compiled
  */
 function hasJavaScriptContent(filePath) {
     try {
@@ -42,7 +40,7 @@ function hasJavaScriptContent(filePath) {
         // Remove comments and check if there's any actual code
         return content.replace(/\/\*[\s\S]*?\*\/|\/\/.*/g, '').trim().length > 0;
     }
-    catch (e) {
+    catch (error) {
         return false;
     }
 }
@@ -50,7 +48,7 @@ function hasJavaScriptContent(filePath) {
  * HydePHP Vite plugin for realtime compiler integration
  */
 export default function hydePlugin(options = {}) {
-    const { input = ['resources/assets/app.css', 'resources/assets/app.js'], refresh = true, } = options;
+    const { input = ['resources/assets/app.css', 'resources/assets/app.js'], watch = ['_pages', '_posts', '_docs'], refresh = true, } = options;
     let config;
     let hotFilePath;
     return {
@@ -102,7 +100,7 @@ export default function hydePlugin(options = {}) {
                     try {
                         fs.rmSync(hotFilePath);
                     }
-                    catch (e) {
+                    catch (error) {
                         // Ignore errors when removing hot file
                     }
                     process.exit();
@@ -116,7 +114,7 @@ export default function hydePlugin(options = {}) {
                         const content = fs.readFileSync(indexPath, 'utf-8');
                         res.end(content);
                     }
-                    catch (e) {
+                    catch (error) {
                         next();
                     }
                 }
@@ -126,8 +124,7 @@ export default function hydePlugin(options = {}) {
             });
             // Add additional watch paths for content files if refresh option is enabled
             if (refresh) {
-                const contentDirs = ['_pages', '_posts', '_docs'];
-                contentDirs.forEach(dir => {
+                watch.forEach(dir => {
                     const contentPath = path.resolve(process.cwd(), dir);
                     if (fs.existsSync(contentPath)) {
                         server.watcher.add(path.join(contentPath, '**'));

From ba1db3a1aac6f9504e084d7851c0a4607ce256c6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:07:27 +0200
Subject: [PATCH 3986/4023] Create compile TypeScript action

---
 .github/workflows/compile-typescript.yml | 48 ++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 .github/workflows/compile-typescript.yml

diff --git a/.github/workflows/compile-typescript.yml b/.github/workflows/compile-typescript.yml
new file mode 100644
index 00000000000..101ee37b4a2
--- /dev/null
+++ b/.github/workflows/compile-typescript.yml
@@ -0,0 +1,48 @@
+name: Compile TypeScript
+
+on:
+  push:
+    paths:
+      - 'packages/**/src/**/*.ts'
+
+jobs:
+  compile:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Needed for the git commit step
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          cd packages/vite-plugin && npm ci
+          cd ../..
+
+      - name: Compile TypeScript
+        run: |
+          cd packages/vite-plugin
+          npm run build
+          cd ../..
+
+      - name: Check for changes
+        id: check_changes
+        run: |
+          git diff --exit-code --quiet packages/vite-plugin/dist || echo "changes=true" >> $GITHUB_OUTPUT
+
+      - name: Commit changes
+        if: steps.check_changes.outputs.changes == 'true'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add packages/vite-plugin/dist
+          git commit -m "Compile TypeScript"
+          git push

From 87b234818df35ba19e4545f27ee076b1b976b8eb Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:08:39 +0200
Subject: [PATCH 3987/4023] Document contributing

---
 packages/vite-plugin/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index 22f24050804..466fbf3dbb9 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -37,6 +37,10 @@ export default defineConfig({
 | `refresh` | `boolean`  | `true`                                                    | Enable hot reloading for content files   |
 | `watch`   | `string[]` | `['_pages', '_posts', '_docs']`                           | Content directories to watch for changes |
 
+## Contributing
+
+Contributions to this package are made in the development monorepo [hydephp/develop](https://github.com/hydephp/develop) in the `packages/vite-plugin` directory.
+
 ## License
 
 The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

From b9a5d0cdd007ac927f3a1347b503bfb9d2fcdd58 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:19:50 +0200
Subject: [PATCH 3988/4023] Update order to match

---
 packages/vite-plugin/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index 466fbf3dbb9..9108adc10a3 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -34,8 +34,8 @@ export default defineConfig({
 | Option    | Type       | Default                                                   | Description                              |
 |-----------|------------|-----------------------------------------------------------|------------------------------------------|
 | `input`   | `string[]` | `['resources/assets/app.css', 'resources/assets/app.js']` | Asset entry points to process            |
-| `refresh` | `boolean`  | `true`                                                    | Enable hot reloading for content files   |
 | `watch`   | `string[]` | `['_pages', '_posts', '_docs']`                           | Content directories to watch for changes |
+| `refresh` | `boolean`  | `true`                                                    | Enable hot reloading for content files   |
 
 ## Contributing
 

From 67bef01b78cdda9e80f9338171e31657f0de5025 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:23:40 +0200
Subject: [PATCH 3989/4023] Set up proper package

---
 packages/hyde/vite.config.js   | 6 +-----
 packages/vite-plugin/README.md | 2 +-
 vite.config.js                 | 6 +-----
 3 files changed, 3 insertions(+), 11 deletions(-)

diff --git a/packages/hyde/vite.config.js b/packages/hyde/vite.config.js
index b24862789b5..dab5adade35 100644
--- a/packages/hyde/vite.config.js
+++ b/packages/hyde/vite.config.js
@@ -4,11 +4,7 @@
 
 import { defineConfig } from 'vite';
 import tailwindcss from "@tailwindcss/vite";
-
-// Import the HydePHP Vite plugin
-// In a real-world scenario, this would be:
-// import hyde from 'hyde-vite-plugin';
-import hyde from './packages/vite-plugin/dist/index.js';
+import hyde from 'hyde-vite-plugin';
 
 export default defineConfig({
     plugins: [
diff --git a/packages/vite-plugin/README.md b/packages/vite-plugin/README.md
index 9108adc10a3..c9d745dacf4 100644
--- a/packages/vite-plugin/README.md
+++ b/packages/vite-plugin/README.md
@@ -39,7 +39,7 @@ export default defineConfig({
 
 ## Contributing
 
-Contributions to this package are made in the development monorepo [hydephp/develop](https://github.com/hydephp/develop) in the `packages/vite-plugin` directory.
+Contributions to this package are made in the development monorepo [hydephp/develop](https://github.com/hydephp/develop) in the `packages/vite-plugin` directory. Make sure to link your local NPM package!
 
 ## License
 
diff --git a/vite.config.js b/vite.config.js
index b24862789b5..dab5adade35 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -4,11 +4,7 @@
 
 import { defineConfig } from 'vite';
 import tailwindcss from "@tailwindcss/vite";
-
-// Import the HydePHP Vite plugin
-// In a real-world scenario, this would be:
-// import hyde from 'hyde-vite-plugin';
-import hyde from './packages/vite-plugin/dist/index.js';
+import hyde from 'hyde-vite-plugin';
 
 export default defineConfig({
     plugins: [

From 6854077024b872f2ffbd662cdd21be8905b8d44a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 26 Apr 2025 15:25:41 +0200
Subject: [PATCH 3990/4023] Split the new Vite plugin

---
 .github/workflows/split-monorepo.yml | 50 ++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/.github/workflows/split-monorepo.yml b/.github/workflows/split-monorepo.yml
index bf45381112b..cc605dc92de 100644
--- a/.github/workflows/split-monorepo.yml
+++ b/.github/workflows/split-monorepo.yml
@@ -390,3 +390,53 @@ jobs:
           git commit --author="$COMMIT_AUTHOR_NAME <$COMMIT_AUTHOR_EMAIL>" -m "$COMMIT_MESSAGE https://github.com/hydephp/develop/commit/${{ github.sha }}"
 
           git push upstream master
+
+  vite-plugin:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    environment:
+      name: hydephp/vite-plugin
+      url: https://github.com/hydephp/vite-plugin/tree/master
+
+    steps:
+      - name: Checkout hydephp/develop
+        uses: actions/checkout@v4
+        with:
+          path: develop
+          persist-credentials: false
+
+      - name: Checkout hydephp/vite-plugin
+        uses: actions/checkout@v4
+        with:
+          repository: hydephp/vite-plugin
+          path: vite-plugin
+          ref: master
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Empty the destination directory
+        run: rm -rf vite-plugin/*
+
+      - name: Copy over files
+        run: cp -rf develop/packages/vite-plugin/. vite-plugin -v
+
+      - name: Commit and push changes
+        env:
+          COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
+          COMMIT_AUTHOR_NAME: ${{ github.event.head_commit.author.name }}
+          COMMIT_AUTHOR_EMAIL: ${{ github.event.head_commit.author.email }}
+        run: |
+          cd vite-plugin
+          if ! [[ `git status --porcelain` ]]; then
+            echo "No changes to this package. Exiting gracefully.";
+            exit 0;
+          fi
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git remote add upstream https://oauth2:${{ secrets.SPLIT_MONOREPO_TOKEN }}@github.com/hydephp/vite-plugin.git
+
+          git add .
+          git commit --author="$COMMIT_AUTHOR_NAME <$COMMIT_AUTHOR_EMAIL>" -m "$COMMIT_MESSAGE https://github.com/hydephp/develop/commit/${{ github.sha }}"
+
+          git push upstream master

From 38c0959daaa16d57d5d4839992e6a6b5e30e244d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:22:53 +0200
Subject: [PATCH 3991/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 5eb8a3324f4..a7babf43504 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -12,6 +12,7 @@ This serves two purposes:
 ### Added
 
 - Added support for PHP 8.4 in https://github.com/hydephp/develop/pull/2141
+- Added a new Hyde Vite plugin in https://github.com/hydephp/develop/pull/2160
 - You can now specify sidebar item priorities by adding a numeric prefix to doc umentation page source file names in https://github.com/hydephp/develop/pull/1709
 - Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
 - Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.

From 12198c97651e725cc75246abc112a90a141a49b1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:25:30 +0200
Subject: [PATCH 3992/4023] Remove extra index file

---
 .../resources/vite-index-page.html            | 66 -------------------
 1 file changed, 66 deletions(-)
 delete mode 100644 packages/realtime-compiler/resources/vite-index-page.html

diff --git a/packages/realtime-compiler/resources/vite-index-page.html b/packages/realtime-compiler/resources/vite-index-page.html
deleted file mode 100644
index aee5828f9c3..00000000000
--- a/packages/realtime-compiler/resources/vite-index-page.html
+++ /dev/null
@@ -1,66 +0,0 @@
-<!DOCTYPE html>
-<html>
-    <head>
-        <meta charset="utf-8">
-        <meta name="viewport" content="width=device-width, initial-scale=1">
-
-        <title>HydePHP Vite</title>
-
-        <link href="https://fonts.googleapis.com/css2?family=Nunito:wght@400;600;700&display=swap" rel="stylesheet">
-
-        <script src="https://cdn.tailwindcss.com"></script>
-    </head>
-    <body class="antialiased">
-        <div class="relative flex min-h-screen flex-col justify-center overflow-hidden bg-gray-100 text-gray-600 dark:text-gray-400 dark:bg-gray-900 py-6 sm:py-12">
-            <div class="relative bg-white dark:bg-gray-800 px-6 pt-10 pb-8 shadow-xl ring-1 ring-gray-900/5 sm:mx-auto sm:max-w-xl sm:rounded-lg sm:px-10">
-                <div class="mx-auto">
-                    <div class="flex items-center justify-center">
-                        <a href="https://hydephp.com">
-                           <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:serif="http://www.serif.com/" width="4rem" class="h-24 w-auto" viewBox="0 0 4267 4267" version="1.1" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><rect id="masked" x="0" y="0" width="4266.67" height="4266.67" style="fill:none;"/><g id="base"/><g id="src"><path d="M3099.01,2876.31l142.659,-1865.88c-0,-10.687 -0.634,-20.82 -1.663,-29.529c0.238,-2.612 1.663,-5.937 1.663,-8.708c-0,-142.817 -496.296,-258.638 -1108.33,-258.638c-612.116,0 -1108.33,115.742 -1108.33,258.638c-0,2.771 1.346,5.383 1.742,8.075c-1.109,8.708 -1.742,18.208 -1.742,28.896l142.658,1867.15c-277.4,72.041 -459.325,173.454 -459.325,286.187c0,218.658 681.704,395.833 1425,395.833c743.296,0 1425,-177.175 1425,-395.833c0,-112.733 -181.925,-214.146 -459.325,-286.188Z" style="fill:url(#_Linear1);fill-rule:nonzero;"/><path d="M2096.6,1230.44c-387.125,-0.001 -680.992,-70.934 -859.117,-130.309c-41.483,-13.854 -63.966,-58.662 -50.112,-100.146c13.854,-41.483 58.504,-63.966 100.146,-50.112c228.712,76.237 851.991,228.871 1695.83,-1.267c41.879,-11.242 85.658,13.3 97.137,55.575c11.559,42.196 -13.379,85.738 -55.575,97.217c-348.808,95.158 -660.804,129.041 -928.308,129.041Z" style="fill:#66757f;fill-opacity:0.1;fill-rule:nonzero;"/><path d="M3099.01,2876.31l35.309,-461.463c-609.98,170.763 -1392.15,174.721 -2004.18,-29.846l31.113,407.075c5.462,24.067 8.946,51.459 8.946,85.184c-0,138.541 102.045,223.883 219.37,268.85c352.925,135.216 1105.01,130.308 1488.89,11.795c116.137,-35.862 219.767,-137.195 219.767,-252.62c-0,-9.421 1.187,-19.08 1.9,-28.58l-1.109,-0.395Z" style="fill:url(#_Linear2);fill-rule:nonzero;"/><g id="gradient.svg"/></g><defs><linearGradient id="_Linear1" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(2850,0,0,2844.78,708.333,2135.95)"><stop offset="0" style="stop-color:#141e30;stop-opacity:1"/><stop offset="1" style="stop-color:#243b55;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" y1="0" x2="1" y2="0" gradientUnits="userSpaceOnUse" gradientTransform="matrix(3008.33,-1187.5,510.846,1294.14,945.833,3320.83)"><stop offset="0" style="stop-color:#8a2387;stop-opacity:1"/><stop offset="0.5" style="stop-color:#e94057;stop-opacity:1"/><stop offset="1" style="stop-color:#f27121;stop-opacity:1"/></linearGradient></defs></svg>
-                        </a>
-                        <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6  text-gray-500" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" width="2rem">
-                            <path stroke-linecap="round" stroke-linejoin="round" d="M12 4v16m8-8H4" />
-                        </svg>
-                        <a href="https://vitejs.dev">
-                            <svg viewBox="0 0 410 404" fill="none" xmlns="http://www.w3.org/2000/svg" width="4rem" class="h-16 ml-3 w-auto">
-                                <path d="M399.641 59.5246L215.643 388.545C211.844 395.338 202.084 395.378 198.228 388.618L10.5817 59.5563C6.38087 52.1896 12.6802 43.2665 21.0281 44.7586L205.223 77.6824C206.398 77.8924 207.601 77.8904 208.776 77.6763L389.119 44.8058C397.439 43.2894 403.768 52.1434 399.641 59.5246Z" fill="url(#paint0_linear)" />
-                                <path d="M292.965 1.5744L156.801 28.2552C154.563 28.6937 152.906 30.5903 152.771 32.8664L144.395 174.33C144.198 177.662 147.258 180.248 150.51 179.498L188.42 170.749C191.967 169.931 195.172 173.055 194.443 176.622L183.18 231.775C182.422 235.487 185.907 238.661 189.532 237.56L212.947 230.446C216.577 229.344 220.065 232.527 219.297 236.242L201.398 322.875C200.278 328.294 207.486 331.249 210.492 326.603L212.5 323.5L323.454 102.072C325.312 98.3645 322.108 94.137 318.036 94.9228L279.014 102.454C275.347 103.161 272.227 99.746 273.262 96.1583L298.731 7.86689C299.767 4.27314 296.636 0.855181 292.965 1.5744Z" fill="url(#paint1_linear)" />
-                                <defs>
-                                    <linearGradient id="paint0_linear" x1="6.00017" y1="32.9999" x2="235" y2="344" gradientUnits="userSpaceOnUse">
-                                        <stop stop-color="#41D1FF" />
-                                        <stop offset="1" stop-color="#BD34FE" />
-                                    </linearGradient>
-                                    <linearGradient id="paint1_linear" x1="194.651" y1="8.81818" x2="236.076" y2="292.989" gradientUnits="userSpaceOnUse">
-                                        <stop stop-color="#FFEA83" />
-                                        <stop offset="0.0833333" stop-color="#FFDD35" />
-                                        <stop offset="1" stop-color="#FFA800" />
-                                    </linearGradient>
-                                </defs>
-                            </svg>
-                        </a>
-                    </div>
-                    <div class="divide-y divide-gray-300 dark:divide-gray-700">
-                        <div class="py-8 text-base leading-7">
-                            <p>This is the Vite development server that provides Hot Module Replacement for your HydePHP site.</p>
-                            <p class="mt-6">Your HydePHP site is running on the Realtime Compiler server.</p>
-                            <h2 class="mt-6"><a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Realtime Compiler</a></h2>
-                            <p>The main development server for your HydePHP site.</p>
-                            <h2 class="mt-6"><a href="http://localhost:8080/dashboard" class="font-semibold text-indigo-500 hover:text-indigo-600">HydePHP Dashboard</a></h2>
-                            <p>Access the realtime compiler dashboard to monitor your site.</p>
-                        </div>
-                        <div class="pt-8 text-base leading-7">
-                            <p>
-                                Your HydePHP site is running at:<br />
-                                <a href="http://localhost:8080" class="font-semibold text-indigo-500 hover:text-indigo-600">http://localhost:8080</a>
-                            </p>
-                            <p class="mt-6">Want to learn more about HydePHP?</p>
-                            <p>
-                                <a href="https://hydephp.com/docs" class="font-semibold text-indigo-500 hover:text-indigo-600">Read the docs &rarr;</a>
-                            </p>
-                        </div>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </body>
-</html>

From 1ea19b43d1c25b3d86ead3e4247405c1341776c4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:25:58 +0200
Subject: [PATCH 3993/4023] Rename index file

---
 .../vite-plugin/resources/{vite-index-page.html => index.html}  | 0
 packages/vite-plugin/src/index.ts                               | 2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename packages/vite-plugin/resources/{vite-index-page.html => index.html} (100%)

diff --git a/packages/vite-plugin/resources/vite-index-page.html b/packages/vite-plugin/resources/index.html
similarity index 100%
rename from packages/vite-plugin/resources/vite-index-page.html
rename to packages/vite-plugin/resources/index.html
diff --git a/packages/vite-plugin/src/index.ts b/packages/vite-plugin/src/index.ts
index d7cd4dbe0b7..c51bf900f47 100644
--- a/packages/vite-plugin/src/index.ts
+++ b/packages/vite-plugin/src/index.ts
@@ -148,7 +148,7 @@ export default function hydePlugin(options: HydePluginOptions = {}): Plugin {
       server.middlewares.use((req, res, next) => {
         if (req.url === '/') {
           try {
-            const indexPath = resolveResource('vite-index-page.html');
+            const indexPath = resolveResource('index.html');
             const content = fs.readFileSync(indexPath, 'utf-8');
             res.end(content);
           } catch (error) {

From 9cfe63ba4ab0704bb897b336340a527d007b56ac Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:27:15 +0200
Subject: [PATCH 3994/4023] Update vcs.xml

---
 .idea/vcs.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.idea/vcs.xml b/.idea/vcs.xml
index f5c7bf895ad..dea01c435ab 100644
--- a/.idea/vcs.xml
+++ b/.idea/vcs.xml
@@ -5,5 +5,6 @@
     <mapping directory="$PROJECT_DIR$/packages/framework" vcs="Git" />
     <mapping directory="$PROJECT_DIR$/packages/hydefront" vcs="Git" />
     <mapping directory="$PROJECT_DIR$/packages/realtime-compiler" vcs="Git" />
+    <mapping directory="$PROJECT_DIR$/packages/vite-plugin" vcs="Git" />
   </component>
 </project>
\ No newline at end of file

From 1bfe78beb1ea01e1a5dc284c627a1600b4933e9a Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 27 Apr 2025 11:28:21 +0000
Subject: [PATCH 3995/4023] Compile TypeScript

---
 packages/vite-plugin/dist/index.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/vite-plugin/dist/index.js b/packages/vite-plugin/dist/index.js
index a8533189c43..ebc9c5efc79 100644
--- a/packages/vite-plugin/dist/index.js
+++ b/packages/vite-plugin/dist/index.js
@@ -110,7 +110,7 @@ export default function hydePlugin(options = {}) {
             server.middlewares.use((req, res, next) => {
                 if (req.url === '/') {
                     try {
-                        const indexPath = resolveResource('vite-index-page.html');
+                        const indexPath = resolveResource('index.html');
                         const content = fs.readFileSync(indexPath, 'utf-8');
                         res.end(content);
                     }

From f73643f64824bebb22ad62e2902d3508768b3817 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 13:41:21 +0200
Subject: [PATCH 3996/4023] Build assets

---
 _media/app.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_media/app.css b/_media/app.css
index 70e8a33e7ed..f4bbbd9907e 100644
--- a/_media/app.css
+++ b/_media/app.css
@@ -1 +1 @@
-/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */@layer properties{@supports ((-webkit-hyphens:none) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer base{pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:calc(var(--spacing)*4)}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){filter:blur(.095rem);opacity:.65;transition:filter .35s,opacity .35s}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur();opacity:1}.torchlight summary:focus{--tw-outline-style:none;outline-style:none}.torchlight details>summary::marker{display:none}.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::-moz-placeholder{opacity:1}::placeholder{opacity:1}@supports (not (-webkit-appearance:-apple-pay-button)) or (contain-intrinsic-size:1px){::-moz-placeholder{color:currentColor}::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::-moz-placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-red-500:oklch(63.7% .237 25.331);--color-red-600:oklch(57.7% .245 27.325);--color-amber-500:oklch(76.9% .188 70.08);--color-yellow-300:oklch(90.5% .182 98.111);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-green-500:oklch(72.3% .219 149.579);--color-blue-500:oklch(62.3% .214 259.815);--color-indigo-400:oklch(67.3% .182 276.935);--color-indigo-600:oklch(51.1% .262 276.966);--color-indigo-700:oklch(45.7% .24 277.023);--color-slate-100:oklch(96.8% .007 247.896);--color-slate-800:oklch(27.9% .041 260.031);--color-gray-50:oklch(98.5% .002 247.839);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-gray-600:oklch(44.6% .03 256.802);--color-gray-700:oklch(37.3% .034 259.733);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-sm:24rem;--container-lg:32rem;--container-xl:36rem;--container-2xl:42rem;--container-3xl:48rem;--container-7xl:80rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--text-3xl:1.875rem;--text-3xl--line-height: 1.2 ;--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5/2.25);--text-5xl:3rem;--text-5xl--line-height:1;--text-6xl:3.75rem;--text-6xl--line-height:1;--text-7xl:4.5rem;--text-7xl--line-height:1;--font-weight-light:300;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--font-weight-black:900;--tracking-tight:-.025em;--tracking-normal:0em;--tracking-wide:.025em;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--drop-shadow-2xl:0 25px 25px #00000026;--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--animate-spin:spin 1s linear infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer components;@layer utilities{.invisible{visibility:hidden}.visible{visibility:visible}.sr-only{clip:rect(0,0,0,0);white-space:nowrap;border-width:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing)*0)}.end-0{inset-inline-end:calc(var(--spacing)*0)}.-top-1{top:calc(var(--spacing)*-1)}.top-0{top:calc(var(--spacing)*0)}.top-2\.5{top:calc(var(--spacing)*2.5)}.top-4{top:calc(var(--spacing)*4)}.top-16{top:calc(var(--spacing)*16)}.top-auto{top:auto}.right-0{right:calc(var(--spacing)*0)}.right-1{right:calc(var(--spacing)*1)}.right-3{right:calc(var(--spacing)*3)}.right-4{right:calc(var(--spacing)*4)}.bottom-0{bottom:calc(var(--spacing)*0)}.bottom-4{bottom:calc(var(--spacing)*4)}.-left-64{left:calc(var(--spacing)*-64)}.left-0{left:calc(var(--spacing)*0)}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.col-12{grid-column:12}.col-auto{grid-column:auto}.float-end{float:inline-end}.float-left{float:left}.float-right{float:right}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.m-1{margin:calc(var(--spacing)*1)}.m-2{margin:calc(var(--spacing)*2)}.m-8{margin:calc(var(--spacing)*8)}.-mx-4{margin-inline:calc(var(--spacing)*-4)}.mx-0{margin-inline:calc(var(--spacing)*0)}.mx-0\.5{margin-inline:calc(var(--spacing)*.5)}.mx-3{margin-inline:calc(var(--spacing)*3)}.mx-4{margin-inline:calc(var(--spacing)*4)}.mx-8{margin-inline:calc(var(--spacing)*8)}.mx-auto{margin-inline:auto}.my-0{margin-block:calc(var(--spacing)*0)}.my-0\.5{margin-block:calc(var(--spacing)*.5)}.my-1{margin-block:calc(var(--spacing)*1)}.my-2{margin-block:calc(var(--spacing)*2)}.my-3{margin-block:calc(var(--spacing)*3)}.my-4{margin-block:calc(var(--spacing)*4)}.my-8{margin-block:calc(var(--spacing)*8)}.my-auto{margin-block:auto}.me-0{margin-inline-end:calc(var(--spacing)*0)}.me-2{margin-inline-end:calc(var(--spacing)*2)}.me-auto{margin-inline-end:auto}.prose{color:var(--tw-prose-body);--tw-prose-body:oklch(37.3% .034 259.733);--tw-prose-headings:oklch(21% .034 264.665);--tw-prose-lead:oklch(44.6% .03 256.802);--tw-prose-links:oklch(21% .034 264.665);--tw-prose-bold:oklch(21% .034 264.665);--tw-prose-counters:oklch(55.1% .027 264.364);--tw-prose-bullets:oklch(87.2% .01 258.338);--tw-prose-hr:oklch(92.8% .006 264.531);--tw-prose-quotes:oklch(21% .034 264.665);--tw-prose-quote-borders:oklch(92.8% .006 264.531);--tw-prose-captions:oklch(55.1% .027 264.364);--tw-prose-kbd:oklch(21% .034 264.665);--tw-prose-kbd-shadows:NaN NaN NaN;--tw-prose-code:oklch(21% .034 264.665);--tw-prose-pre-code:oklch(92.8% .006 264.531);--tw-prose-pre-bg:oklch(27.8% .033 256.848);--tw-prose-th-borders:oklch(87.2% .01 258.338);--tw-prose-td-borders:oklch(92.8% .006 264.531);--tw-prose-invert-body:oklch(87.2% .01 258.338);--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:oklch(70.7% .022 261.325);--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:oklch(70.7% .022 261.325);--tw-prose-invert-bullets:oklch(44.6% .03 256.802);--tw-prose-invert-hr:oklch(37.3% .034 259.733);--tw-prose-invert-quotes:oklch(96.7% .003 264.542);--tw-prose-invert-quote-borders:oklch(37.3% .034 259.733);--tw-prose-invert-captions:oklch(70.7% .022 261.325);--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:oklch(87.2% .01 258.338);--tw-prose-invert-pre-bg:#00000080;--tw-prose-invert-th-borders:oklch(44.6% .03 256.802);--tw-prose-invert-td-borders:oklch(37.3% .034 259.733);max-width:96ch;font-size:1rem;line-height:1.5em}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);margin-top:1.2em;margin-bottom:1.2em;font-size:1.25em;line-height:1.6}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:decimal}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:disc}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.25em;font-weight:600}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;margin-top:1em;margin-bottom:1em;padding-top:.25em;padding-bottom:.25em;padding-left:.75em;line-height:1.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-top:.25em;margin-bottom:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before,.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:0;margin-bottom:.888889em;font-size:2.25em;font-weight:800;line-height:1.11111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.75em;font-size:1.5em;font-weight:700;line-height:1.33333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.6em;margin-bottom:.6em;font-size:1.25em;font-weight:600;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.5em;font-weight:600;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em;display:block}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px rgb(var(--tw-prose-kbd-shadows)/10%);padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;border-radius:.3125rem;padding-inline-start:.375em;font-family:inherit;font-size:.875em;font-weight:500}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-size:.875em;font-weight:600}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);padding-top:.857143em;padding-inline-end:1.14286em;padding-bottom:.857143em;background-color:#292d3e;border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;padding-inline-start:1.14286em;font-size:.875em;font-weight:400;line-height:1.71429;overflow-x:auto}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit;background-color:#0000;border-width:0;border-radius:0;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){table-layout:auto;width:100%;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.71429}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);vertical-align:bottom;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em;font-weight:600}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);margin-top:.857143em;font-size:.875em;line-height:1.42857}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.571429em;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;vertical-align:top;word-break:break-all;background-color:#80808033;border-radius:4px;max-width:80vw;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px;overflow-x:auto}.-mt-4{margin-top:calc(var(--spacing)*-4)}.mt-1{margin-top:calc(var(--spacing)*1)}.mt-2{margin-top:calc(var(--spacing)*2)}.mt-3{margin-top:calc(var(--spacing)*3)}.mt-4{margin-top:calc(var(--spacing)*4)}.mt-6{margin-top:calc(var(--spacing)*6)}.mt-8{margin-top:calc(var(--spacing)*8)}.mt-12{margin-top:calc(var(--spacing)*12)}.mt-auto{margin-top:auto}.mr-1{margin-right:calc(var(--spacing)*1)}.mr-3{margin-right:calc(var(--spacing)*3)}.mr-4{margin-right:calc(var(--spacing)*4)}.mr-auto{margin-right:auto}.mb-0{margin-bottom:calc(var(--spacing)*0)}.mb-1{margin-bottom:calc(var(--spacing)*1)}.mb-2{margin-bottom:calc(var(--spacing)*2)}.mb-3{margin-bottom:calc(var(--spacing)*3)}.mb-4{margin-bottom:calc(var(--spacing)*4)}.mb-8{margin-bottom:calc(var(--spacing)*8)}.mb-12{margin-bottom:calc(var(--spacing)*12)}.mb-auto{margin-bottom:auto}.-ml-2{margin-left:calc(var(--spacing)*-2)}.-ml-4{margin-left:calc(var(--spacing)*-4)}.-ml-6{margin-left:calc(var(--spacing)*-6)}.-ml-8{margin-left:calc(var(--spacing)*-8)}.ml-1{margin-left:calc(var(--spacing)*1)}.ml-3{margin-left:calc(var(--spacing)*3)}.ml-4{margin-left:calc(var(--spacing)*4)}.ml-auto{margin-left:auto}.block{display:block}.block\!{display:block!important}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-0\.5{height:calc(var(--spacing)*.5)}.h-1{height:calc(var(--spacing)*1)}.h-4{height:calc(var(--spacing)*4)}.h-5{height:calc(var(--spacing)*5)}.h-6{height:calc(var(--spacing)*6)}.h-8{height:calc(var(--spacing)*8)}.h-16{height:calc(var(--spacing)*16)}.h-24{height:calc(var(--spacing)*24)}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-5{width:calc(var(--spacing)*5)}.w-6{width:calc(var(--spacing)*6)}.w-8{width:calc(var(--spacing)*8)}.w-16{width:calc(var(--spacing)*16)}.w-64{width:calc(var(--spacing)*64)}.w-80{width:calc(var(--spacing)*80)}.w-96{width:calc(var(--spacing)*96)}.w-100{width:calc(var(--spacing)*100)}.w-\[70ch\]{width:70ch}.w-auto{width:auto}.w-fit{width:-moz-fit-content;width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:var(--container-3xl)}.max-w-7xl{max-width:var(--container-7xl)}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:var(--container-lg)}.max-w-sm{max-width:var(--container-sm)}.min-w-screen{min-width:100vw}.flex-shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.flex-grow,.flex-grow-1,.grow{flex-grow:1}.table-auto{table-layout:auto}.table-fixed{table-layout:fixed}.border-collapse{border-collapse:collapse}.border-separate{border-collapse:separate}.origin-center{transform-origin:50%}.-rotate-45{rotate:-45deg}.rotate-45{rotate:45deg}.transform{transform:var(--tw-rotate-x,)var(--tw-rotate-y,)var(--tw-rotate-z,)var(--tw-skew-x,)var(--tw-skew-y,)}.animate-spin{animation:var(--animate-spin)}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:calc(var(--spacing)*2)}.list-none{list-style-type:none}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.flex-col{flex-direction:column}.flex-row{flex-direction:row}.flex-nowrap{flex-wrap:nowrap}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-4{gap:calc(var(--spacing)*4)}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*4)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*4)*calc(1 - var(--tw-space-y-reverse)))}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px*var(--tw-divide-y-reverse));border-bottom-width:calc(1px*calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-gray-300>:not(:last-child)){border-color:var(--color-gray-300)}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.overflow-y-auto{overflow-y:auto}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.rounded{border-radius:.25rem}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-t{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.rounded-l{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-tl{border-top-left-radius:.25rem}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.rounded-tr{border-top-right-radius:.25rem}.rounded-b{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-br{border-bottom-right-radius:.25rem}.rounded-bl{border-bottom-left-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-4{border-style:var(--tw-border-style);border-width:4px}.border-x{border-inline-style:var(--tw-border-style);border-inline-width:1px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-l-4{border-left-style:var(--tw-border-style);border-left-width:4px}.border-l-\[0\.325rem\]{border-left-style:var(--tw-border-style);border-left-width:.325rem}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-dotted{--tw-border-style:dotted;border-style:dotted}.border-double{--tw-border-style:double;border-style:double}.border-none{--tw-border-style:none;border-style:none}.border-solid{--tw-border-style:solid;border-style:solid}.border-amber-500{border-color:var(--color-amber-500)}.border-blue-500{border-color:var(--color-blue-500)}.border-gray-200{border-color:var(--color-gray-200)}.border-gray-300{border-color:var(--color-gray-300)}.border-gray-500{border-color:var(--color-gray-500)}.border-gray-900{border-color:var(--color-gray-900)}.border-green-500{border-color:var(--color-green-500)}.border-indigo-500{border-color:#5956eb}.border-red-600{border-color:var(--color-red-600)}.border-transparent{border-color:#0000}.border-yellow-400{border-color:var(--color-yellow-400)}.border-t-transparent{border-top-color:#0000}.border-r-gray-900{border-right-color:var(--color-gray-900)}.bg-black{background-color:var(--color-black)}.bg-black\/5{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.bg-black\/5{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.bg-black\/50{background-color:#00000080}@supports (color:color-mix(in lab,red,red)){.bg-black\/50{background-color:color-mix(in oklab,var(--color-black)50%,transparent)}}.bg-current{background-color:currentColor}.bg-gray-50{background-color:var(--color-gray-50)}.bg-gray-100{background-color:var(--color-gray-100)}.bg-gray-200{background-color:var(--color-gray-200)}.bg-gray-500{background-color:var(--color-gray-500)}.bg-indigo-600{background-color:var(--color-indigo-600)}.bg-slate-100{background-color:var(--color-slate-100)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-yellow-400{background-color:var(--color-yellow-400)}.bg-linear-to-br{--tw-gradient-position:to bottom right;background-image:linear-gradient(var(--tw-gradient-stops))}@supports (background-image:linear-gradient(in lab,red,red)){.bg-linear-to-br{--tw-gradient-position:to bottom right in oklab}}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:var(--color-black)}.fill-current{fill:currentColor}.p-0{padding:calc(var(--spacing)*0)}.p-2{padding:calc(var(--spacing)*2)}.p-3{padding:calc(var(--spacing)*3)}.p-4{padding:calc(var(--spacing)*4)}.p-8{padding:calc(var(--spacing)*8)}.p-12{padding:calc(var(--spacing)*12)}.px-0{padding-inline:calc(var(--spacing)*0)}.px-1{padding-inline:calc(var(--spacing)*1)}.px-2{padding-inline:calc(var(--spacing)*2)}.px-3{padding-inline:calc(var(--spacing)*3)}.px-4{padding-inline:calc(var(--spacing)*4)}.px-5{padding-inline:calc(var(--spacing)*5)}.px-6{padding-inline:calc(var(--spacing)*6)}.px-8{padding-inline:calc(var(--spacing)*8)}.py-0{padding-block:calc(var(--spacing)*0)}.py-1{padding-block:calc(var(--spacing)*1)}.py-2{padding-block:calc(var(--spacing)*2)}.py-3{padding-block:calc(var(--spacing)*3)}.py-4{padding-block:calc(var(--spacing)*4)}.py-5{padding-block:calc(var(--spacing)*5)}.py-6{padding-block:calc(var(--spacing)*6)}.py-8{padding-block:calc(var(--spacing)*8)}.py-12{padding-block:calc(var(--spacing)*12)}.py-16{padding-block:calc(var(--spacing)*16)}.py-24{padding-block:calc(var(--spacing)*24)}.py-32{padding-block:calc(var(--spacing)*32)}.ps-0{padding-inline-start:calc(var(--spacing)*0)}.ps-2{padding-inline-start:calc(var(--spacing)*2)}.ps-3{padding-inline-start:calc(var(--spacing)*3)}.pe-0{padding-inline-end:calc(var(--spacing)*0)}.pe-2{padding-inline-end:calc(var(--spacing)*2)}.pe-4{padding-inline-end:calc(var(--spacing)*4)}.pt-3{padding-top:calc(var(--spacing)*3)}.pt-4{padding-top:calc(var(--spacing)*4)}.pt-8{padding-top:calc(var(--spacing)*8)}.pt-10{padding-top:calc(var(--spacing)*10)}.pb-2{padding-bottom:calc(var(--spacing)*2)}.pb-3{padding-bottom:calc(var(--spacing)*3)}.pb-4{padding-bottom:calc(var(--spacing)*4)}.pb-8{padding-bottom:calc(var(--spacing)*8)}.pb-12{padding-bottom:calc(var(--spacing)*12)}.pl-2{padding-left:calc(var(--spacing)*2)}.pl-4{padding-left:calc(var(--spacing)*4)}.pl-5{padding-left:calc(var(--spacing)*5)}.pl-8{padding-left:calc(var(--spacing)*8)}.text-center{text-align:center}.text-end{text-align:end}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.leading-7{--tw-leading:calc(var(--spacing)*7);line-height:calc(var(--spacing)*7)}.leading-8{--tw-leading:calc(var(--spacing)*8);line-height:calc(var(--spacing)*8)}.leading-10{--tw-leading:calc(var(--spacing)*10);line-height:calc(var(--spacing)*10)}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-black{--tw-font-weight:var(--font-weight-black);font-weight:var(--font-weight-black)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-extrabold{--tw-font-weight:var(--font-weight-extrabold);font-weight:var(--font-weight-extrabold)}.font-light{--tw-font-weight:var(--font-weight-light);font-weight:var(--font-weight-light)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-normal{--tw-tracking:var(--tracking-normal);letter-spacing:var(--tracking-normal)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.text-nowrap{text-wrap:nowrap}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.text-black{color:var(--color-black)}.text-blue-500{color:var(--color-blue-500)}.text-gray-100{color:var(--color-gray-100)}.text-gray-200{color:var(--color-gray-200)}.text-gray-400{color:var(--color-gray-400)}.text-gray-500{color:var(--color-gray-500)}.text-gray-600{color:var(--color-gray-600)}.text-gray-700{color:var(--color-gray-700)}.text-green-500{color:var(--color-green-500)}.text-indigo-500{color:#5956eb}.text-indigo-600{color:var(--color-indigo-600)}.text-red-500{color:var(--color-red-500)}.text-transparent{color:#0000}.text-white{color:var(--color-white)}.text-yellow-500{color:var(--color-yellow-500)}.capitalize{text-transform:capitalize}.lowercase{text-transform:lowercase}.uppercase{text-transform:uppercase}.italic{font-style:italic}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a),0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a),0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-1{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(1px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-gray-900\/5{--tw-ring-color:#1018280d}@supports (color:color-mix(in lab,red,red)){.ring-gray-900\/5{--tw-ring-color:color-mix(in oklab,var(--color-gray-900)5%,transparent)}}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.drop-shadow-2xl{--tw-drop-shadow-size:drop-shadow(0 25px 25px var(--tw-drop-shadow-color,#00000026));--tw-drop-shadow:drop-shadow(var(--drop-shadow-2xl));filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.invert{--tw-invert:invert(100%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-shadow{transition-property:box-shadow;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-75{--tw-duration:75ms;transition-duration:75ms}.duration-250{--tw-duration:.25s;transition-duration:.25s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.ease-linear{--tw-ease:linear;transition-timing-function:linear}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}@media (hover:hover){.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}.group-hover\:grayscale-0:is(:where(.group):hover *){--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.hover\:bg-black\/5:hover{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/5:hover{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.hover\:bg-black\/10:hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/10:hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-200\/20:hover{background-color:color-mix(in oklab,var(--color-gray-200)20%,transparent)}}.hover\:bg-gray-600:hover{background-color:var(--color-gray-600)}.hover\:bg-indigo-500:hover{background-color:#5956eb}.hover\:text-gray-700:hover{color:var(--color-gray-700)}.hover\:text-gray-900:hover{color:var(--color-gray-900)}.hover\:text-indigo-600:hover{color:var(--color-indigo-600)}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:shadow-xl:hover{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}.focus\:not-sr-only:focus{clip:auto;white-space:normal;width:auto;height:auto;margin:0;padding:0;position:static;overflow:visible}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-inline:auto}.focus\:mt-2:focus{margin-top:calc(var(--spacing)*2)}.focus\:w-64:focus{width:calc(var(--spacing)*64)}.focus\:bg-gray-700:focus{background-color:var(--color-gray-700)}.focus\:bg-indigo-700:focus{background-color:var(--color-indigo-700)}.focus\:p-2:focus{padding:calc(var(--spacing)*2)}.focus\:opacity-100:focus{opacity:1}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(2px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-gray-700:focus{--tw-ring-color:var(--color-gray-700)}.focus\:ring-indigo-600:focus{--tw-ring-color:var(--color-indigo-600)}.focus\:grayscale-0:focus{--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}@media (min-width:40rem){.sm\:-mx-6{margin-inline:calc(var(--spacing)*-6)}.sm\:mx-auto{margin-inline:auto}.sm\:mt-4{margin-top:calc(var(--spacing)*4)}.sm\:mb-0{margin-bottom:calc(var(--spacing)*0)}.sm\:block{display:block}.sm\:max-w-xl{max-width:var(--container-xl)}.sm\:rounded-lg{border-radius:var(--radius-lg)}.sm\:px-6{padding-inline:calc(var(--spacing)*6)}.sm\:px-10{padding-inline:calc(var(--spacing)*10)}.sm\:py-12{padding-block:calc(var(--spacing)*12)}.sm\:leading-none{--tw-leading:1;line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:48rem){.md\:visible{visibility:visible}.md\:top-0{top:calc(var(--spacing)*0)}.md\:left-0{left:calc(var(--spacing)*0)}.md\:left-64{left:calc(var(--spacing)*64)}.md\:mx-2{margin-inline:calc(var(--spacing)*2)}.md\:my-0{margin-block:calc(var(--spacing)*0)}.md\:my-6{margin-block:calc(var(--spacing)*6)}.md\:mt-0{margin-top:calc(var(--spacing)*0)}.md\:mt-8{margin-top:calc(var(--spacing)*8)}.md\:mb-12{margin-bottom:calc(var(--spacing)*12)}.md\:ml-0{margin-left:calc(var(--spacing)*0)}.md\:block{display:block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:inline-block{display:inline-block}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:var(--container-2xl)}.md\:max-w-none{max-width:none}.md\:grow{flex-grow:1}.md\:grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{--tw-border-style:none;border-style:none}.md\:bg-transparent{background-color:#0000}.md\:bg-white{background-color:var(--color-white)}.md\:bg-left{background-position:0}.md\:px-16{padding-inline:calc(var(--spacing)*16)}.md\:py-0{padding-block:calc(var(--spacing)*0)}.md\:py-16{padding-block:calc(var(--spacing)*16)}.md\:pb-0{padding-bottom:calc(var(--spacing)*0)}.md\:pl-0{padding-left:calc(var(--spacing)*0)}.md\:text-center{text-align:center}.md\:text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.md\:text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.md\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.md\:text-6xl{font-size:var(--text-6xl);line-height:var(--tw-leading,var(--text-6xl--line-height))}.md\:shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:64rem){.lg\:mb-12{margin-bottom:calc(var(--spacing)*12)}.lg\:ml-8{margin-left:calc(var(--spacing)*8)}.lg\:flex{display:flex}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.lg\:text-7xl{font-size:var(--text-7xl);line-height:var(--tw-leading,var(--text-7xl--line-height))}.lg\:text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}}@media (min-width:80rem){.xl\:mb-16{margin-bottom:calc(var(--spacing)*16)}}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}:where(.dark\:divide-gray-700:is(.dark *)>:not(:last-child)){border-color:var(--color-gray-700)}.dark\:border-\[\#1b2533\]:is(.dark *){border-color:#1b2533}.dark\:border-gray-700:is(.dark *){border-color:var(--color-gray-700)}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:bg-black\/10:is(.dark *){background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:bg-gray-600:is(.dark *){background-color:var(--color-gray-600)}.dark\:bg-gray-700:is(.dark *){background-color:var(--color-gray-700)}.dark\:bg-gray-800:is(.dark *){background-color:var(--color-gray-800)}.dark\:bg-gray-900:is(.dark *){background-color:var(--color-gray-900)}.dark\:bg-slate-800:is(.dark *){background-color:var(--color-slate-800)}.dark\:bg-yellow-300:is(.dark *){background-color:var(--color-yellow-300)}.dark\:fill-gray-200:is(.dark *){fill:var(--color-gray-200)}.dark\:fill-white:is(.dark *){fill:var(--color-white)}.dark\:font-medium:is(.dark *){--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.dark\:text-gray-100:is(.dark *){color:var(--color-gray-100)}.dark\:text-gray-200:is(.dark *){color:var(--color-gray-200)}.dark\:text-gray-300:is(.dark *){color:var(--color-gray-300)}.dark\:text-gray-400:is(.dark *){color:var(--color-gray-400)}.dark\:text-indigo-400:is(.dark *){color:var(--color-indigo-400)}.dark\:text-white:is(.dark *){color:var(--color-white)}@media (hover:hover){.dark\:group-hover\:text-white:is(.dark *):is(:where(.group):hover *){color:var(--color-white)}.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:hover\:bg-gray-500:is(.dark *):hover{background-color:var(--color-gray-500)}.dark\:hover\:text-white:is(.dark *):hover{color:var(--color-white)}}.dark\:focus\:text-white:is(.dark *):focus{color:var(--color-white)}.dark\:focus\:ring-indigo-500:is(.dark *):focus{--tw-ring-color:#5956eb}@media (min-width:48rem){.dark\:md\:bg-transparent:is(.dark *){background-color:#0000}}@media print{.print\:top-0{top:calc(var(--spacing)*0)}.print\:hidden{display:none}}.prose-h1\:mb-3 :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:calc(var(--spacing)*3)}.prose-p\:my-3 :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-block:calc(var(--spacing)*3)}.prose-img\:inline :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){display:inline}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}
+/*! tailwindcss v4.1.4 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-space-y-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}@layer base{pre code.torchlight .line-number,pre code.torchlight .summary-caret{margin-right:calc(var(--spacing)*4)}.prose .torchlight-link,.torchlight-link{text-decoration-line:underline}.torchlight.has-focus-lines .line:not(.line-focus){filter:blur(.095rem);opacity:.65;transition:filter .35s,opacity .35s}.torchlight.has-focus-lines:hover .line:not(.line-focus){filter:blur();opacity:1}.torchlight summary:focus{--tw-outline-style:none;outline-style:none}.torchlight details>summary::marker{display:none}.torchlight details>summary::-webkit-details-marker{display:none}.torchlight details .summary-caret:after{pointer-events:none}.torchlight .summary-caret-empty:after,.torchlight details .summary-caret-middle:after,.torchlight details .summary-caret-end:after{content:" "}.torchlight details[open] .summary-caret-start:after{content:"-"}.torchlight details:not([open]) .summary-caret-start:after{content:"+"}.torchlight details[open] .summary-hide-when-open{display:none}.torchlight details:not([open]) .summary-hide-when-open{display:block}*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer theme{:root,:host{--font-sans:ui-sans-serif,system-ui,sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-mono:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;--color-red-500:oklch(63.7% .237 25.331);--color-red-600:oklch(57.7% .245 27.325);--color-amber-500:oklch(76.9% .188 70.08);--color-yellow-300:oklch(90.5% .182 98.111);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-green-500:oklch(72.3% .219 149.579);--color-blue-500:oklch(62.3% .214 259.815);--color-indigo-400:oklch(67.3% .182 276.935);--color-indigo-600:oklch(51.1% .262 276.966);--color-indigo-700:oklch(45.7% .24 277.023);--color-slate-100:oklch(96.8% .007 247.896);--color-slate-800:oklch(27.9% .041 260.031);--color-gray-50:oklch(98.5% .002 247.839);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-gray-600:oklch(44.6% .03 256.802);--color-gray-700:oklch(37.3% .034 259.733);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-sm:24rem;--container-lg:32rem;--container-xl:36rem;--container-2xl:42rem;--container-3xl:48rem;--container-7xl:80rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2/1.5);--text-3xl:1.875rem;--text-3xl--line-height: 1.2 ;--text-4xl:2.25rem;--text-4xl--line-height:calc(2.5/2.25);--text-5xl:3rem;--text-5xl--line-height:1;--text-6xl:3.75rem;--text-6xl--line-height:1;--text-7xl:4.5rem;--text-7xl--line-height:1;--font-weight-light:300;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--font-weight-extrabold:800;--font-weight-black:900;--tracking-tight:-.025em;--tracking-normal:0em;--tracking-wide:.025em;--leading-normal:1.5;--leading-relaxed:1.625;--radius-sm:.25rem;--radius-md:.375rem;--radius-lg:.5rem;--drop-shadow-2xl:0 25px 25px #00000026;--ease-out:cubic-bezier(0,0,.2,1);--ease-in-out:cubic-bezier(.4,0,.2,1);--animate-spin:spin 1s linear infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer components;@layer utilities{.invisible{visibility:hidden}.visible{visibility:visible}.sr-only{clip:rect(0,0,0,0);white-space:nowrap;border-width:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-0{inset:calc(var(--spacing)*0)}.end-0{inset-inline-end:calc(var(--spacing)*0)}.-top-1{top:calc(var(--spacing)*-1)}.top-0{top:calc(var(--spacing)*0)}.top-2\.5{top:calc(var(--spacing)*2.5)}.top-4{top:calc(var(--spacing)*4)}.top-16{top:calc(var(--spacing)*16)}.top-auto{top:auto}.right-0{right:calc(var(--spacing)*0)}.right-1{right:calc(var(--spacing)*1)}.right-3{right:calc(var(--spacing)*3)}.right-4{right:calc(var(--spacing)*4)}.bottom-0{bottom:calc(var(--spacing)*0)}.bottom-4{bottom:calc(var(--spacing)*4)}.-left-64{left:calc(var(--spacing)*-64)}.left-0{left:calc(var(--spacing)*0)}.z-10{z-index:10}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.col-12{grid-column:12}.col-auto{grid-column:auto}.float-end{float:inline-end}.float-left{float:left}.float-right{float:right}.container{width:100%}@media (min-width:40rem){.container{max-width:40rem}}@media (min-width:48rem){.container{max-width:48rem}}@media (min-width:64rem){.container{max-width:64rem}}@media (min-width:80rem){.container{max-width:80rem}}@media (min-width:96rem){.container{max-width:96rem}}.m-1{margin:calc(var(--spacing)*1)}.m-2{margin:calc(var(--spacing)*2)}.m-8{margin:calc(var(--spacing)*8)}.-mx-4{margin-inline:calc(var(--spacing)*-4)}.mx-0{margin-inline:calc(var(--spacing)*0)}.mx-0\.5{margin-inline:calc(var(--spacing)*.5)}.mx-3{margin-inline:calc(var(--spacing)*3)}.mx-4{margin-inline:calc(var(--spacing)*4)}.mx-8{margin-inline:calc(var(--spacing)*8)}.mx-auto{margin-inline:auto}.my-0{margin-block:calc(var(--spacing)*0)}.my-0\.5{margin-block:calc(var(--spacing)*.5)}.my-1{margin-block:calc(var(--spacing)*1)}.my-2{margin-block:calc(var(--spacing)*2)}.my-3{margin-block:calc(var(--spacing)*3)}.my-4{margin-block:calc(var(--spacing)*4)}.my-8{margin-block:calc(var(--spacing)*8)}.my-auto{margin-block:auto}.me-0{margin-inline-end:calc(var(--spacing)*0)}.me-2{margin-inline-end:calc(var(--spacing)*2)}.me-auto{margin-inline-end:auto}.prose{color:var(--tw-prose-body);--tw-prose-body:oklch(37.3% .034 259.733);--tw-prose-headings:oklch(21% .034 264.665);--tw-prose-lead:oklch(44.6% .03 256.802);--tw-prose-links:oklch(21% .034 264.665);--tw-prose-bold:oklch(21% .034 264.665);--tw-prose-counters:oklch(55.1% .027 264.364);--tw-prose-bullets:oklch(87.2% .01 258.338);--tw-prose-hr:oklch(92.8% .006 264.531);--tw-prose-quotes:oklch(21% .034 264.665);--tw-prose-quote-borders:oklch(92.8% .006 264.531);--tw-prose-captions:oklch(55.1% .027 264.364);--tw-prose-kbd:oklch(21% .034 264.665);--tw-prose-kbd-shadows:NaN NaN NaN;--tw-prose-code:oklch(21% .034 264.665);--tw-prose-pre-code:oklch(92.8% .006 264.531);--tw-prose-pre-bg:oklch(27.8% .033 256.848);--tw-prose-th-borders:oklch(87.2% .01 258.338);--tw-prose-td-borders:oklch(92.8% .006 264.531);--tw-prose-invert-body:oklch(87.2% .01 258.338);--tw-prose-invert-headings:#fff;--tw-prose-invert-lead:oklch(70.7% .022 261.325);--tw-prose-invert-links:#fff;--tw-prose-invert-bold:#fff;--tw-prose-invert-counters:oklch(70.7% .022 261.325);--tw-prose-invert-bullets:oklch(44.6% .03 256.802);--tw-prose-invert-hr:oklch(37.3% .034 259.733);--tw-prose-invert-quotes:oklch(96.7% .003 264.542);--tw-prose-invert-quote-borders:oklch(37.3% .034 259.733);--tw-prose-invert-captions:oklch(70.7% .022 261.325);--tw-prose-invert-kbd:#fff;--tw-prose-invert-kbd-shadows:255 255 255;--tw-prose-invert-code:#fff;--tw-prose-invert-pre-code:oklch(87.2% .01 258.338);--tw-prose-invert-pre-bg:#00000080;--tw-prose-invert-th-borders:oklch(44.6% .03 256.802);--tw-prose-invert-td-borders:oklch(37.3% .034 259.733);max-width:96ch;font-size:1rem;line-height:1.5em}.prose :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where([class~=lead]):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-lead);margin-top:1.2em;margin-bottom:1.2em;font-size:1.25em;line-height:1.6}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#5956eb;font-weight:500;text-decoration:none}.prose :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#4f46e5}.prose :where(strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-bold);font-weight:600}.prose :where(a strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote strong):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:decimal}.prose :where(ol[type=A]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=A s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-alpha}.prose :where(ol[type=a s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-alpha}.prose :where(ol[type=I]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type=I s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:upper-roman}.prose :where(ol[type=i s]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:lower-roman}.prose :where(ol[type="1"]):not(:where([class~=not-prose],[class~=not-prose] *)){list-style-type:decimal}.prose :where(ul):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em;padding-inline-start:1.625em;list-style-type:disc}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-counters);font-weight:400}.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *))::marker{color:var(--tw-prose-bullets)}.prose :where(dt):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.25em;font-weight:600}.prose :where(hr):not(:where([class~=not-prose],[class~=not-prose] *)){border-color:var(--tw-prose-hr);border-top-width:1px;margin-top:3em;margin-bottom:3em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:500;font-style:unset;color:unset;border-inline-start-width:.25rem;border-inline-start-color:var(--tw-prose-quote-borders);quotes:"“""”""‘""’";padding-inline-start:1em;background-color:#80808020;border-left-color:#d1d5db;margin-top:1em;margin-bottom:1em;padding-top:.25em;padding-bottom:.25em;padding-left:.75em;line-height:1.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p{margin-top:.25em;margin-bottom:.25em;padding-right:.25em}.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:before,.prose :where(blockquote):not(:where([class~=not-prose],[class~=not-prose] *)) p:after{content:unset}.prose :where(blockquote p:first-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):before{content:open-quote}.prose :where(blockquote p:last-of-type):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:close-quote}.prose :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:0;margin-bottom:.888889em;font-size:2.25em;font-weight:800;line-height:1.11111}.prose :where(h1 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:900}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.75em;font-size:1.5em;font-weight:700;line-height:1.33333}.prose :where(h2 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:800}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.6em;margin-bottom:.6em;font-size:1.25em;font-weight:600;line-height:1.6}.prose :where(h3 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);margin-top:1.5em;margin-bottom:.5em;font-weight:600;line-height:1.5}.prose :where(h4 strong):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-weight:700}.prose :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(picture):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em;display:block}.prose :where(video):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(kbd):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-kbd);box-shadow:0 0 0 1px rgb(var(--tw-prose-kbd-shadows)/10%),0 3px rgb(var(--tw-prose-kbd-shadows)/10%);padding-top:.1875em;padding-inline-end:.375em;padding-bottom:.1875em;border-radius:.3125rem;padding-inline-start:.375em;font-family:inherit;font-size:.875em;font-weight:500}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-size:.875em;font-weight:600}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:unset}.prose :where(a code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h1 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(h2 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.875em}.prose :where(h3 code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit;font-size:.9em}.prose :where(h4 code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(blockquote code):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(thead th code):not(:where([class~=not-prose],[class~=not-prose] *)){color:inherit}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-pre-code);padding-top:.857143em;padding-inline-end:1.14286em;padding-bottom:.857143em;background-color:#292d3e;border-radius:.25rem;margin-top:1rem;margin-bottom:1rem;padding-inline-start:1.14286em;font-size:.875em;font-weight:400;line-height:1.71429;overflow-x:auto}.prose :where(pre):not(:where([class~=not-prose],[class~=not-prose] *)) code{font-family:Fira Code Regular,Consolas,monospace,Courier New}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)){font-weight:inherit;color:inherit;font-size:inherit;font-family:inherit;line-height:inherit;background-color:#0000;border-width:0;border-radius:0;padding:0}.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):before,.prose :where(pre code):not(:where([class~=not-prose],[class~=not-prose] *)):after{content:none}.prose :where(table):not(:where([class~=not-prose],[class~=not-prose] *)){table-layout:auto;width:100%;margin-top:2em;margin-bottom:2em;font-size:.875em;line-height:1.71429}.prose :where(thead):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-th-borders)}.prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-headings);vertical-align:bottom;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em;font-weight:600}.prose :where(tbody tr):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:1px;border-bottom-color:var(--tw-prose-td-borders)}.prose :where(tbody tr:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){border-bottom-width:0}.prose :where(tbody td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:baseline}.prose :where(tfoot):not(:where([class~=not-prose],[class~=not-prose] *)){border-top-width:1px;border-top-color:var(--tw-prose-th-borders)}.prose :where(tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){vertical-align:top}.prose :where(th,td):not(:where([class~=not-prose],[class~=not-prose] *)){text-align:start}.prose :where(figure>*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(figcaption):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-captions);margin-top:.857143em;font-size:.875em;line-height:1.42857}.prose :where(picture>img):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0;margin-bottom:0}.prose :where(li):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;margin-bottom:.5em}.prose :where(ol>li):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(ul>li):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:.375em}.prose :where(.prose>ul>li p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(.prose>ul>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ul>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(.prose>ol>li>p:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em}.prose :where(.prose>ol>li>p:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:1.25em}.prose :where(ul ul,ul ol,ol ul,ol ol):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.75em;margin-bottom:.75em}.prose :where(dl):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.25em;margin-bottom:1.25em}.prose :where(dd):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:.5em;padding-inline-start:1.625em}.prose :where(hr+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h2+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h3+*):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4+*):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(thead th:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(thead th:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(tbody td,tfoot td):not(:where([class~=not-prose],[class~=not-prose] *)){padding-top:.571429em;padding-inline-end:.571429em;padding-bottom:.571429em;padding-inline-start:.571429em}.prose :where(tbody td:first-child,tfoot td:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-start:0}.prose :where(tbody td:last-child,tfoot td:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){padding-inline-end:0}.prose :where(figure):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:2em;margin-bottom:2em}.prose :where(.prose>:first-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:0}.prose :where(.prose>:last-child):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:0}.prose :where(code:not(pre code)):not(:where([class~=not-prose],[class~=not-prose] *)){font:unset;vertical-align:top;word-break:break-all;background-color:#80808033;border-radius:4px;max-width:80vw;margin-left:-2px;margin-right:1px;padding-left:4px;padding-right:4px;overflow-x:auto}.-mt-4{margin-top:calc(var(--spacing)*-4)}.mt-1{margin-top:calc(var(--spacing)*1)}.mt-2{margin-top:calc(var(--spacing)*2)}.mt-3{margin-top:calc(var(--spacing)*3)}.mt-4{margin-top:calc(var(--spacing)*4)}.mt-6{margin-top:calc(var(--spacing)*6)}.mt-8{margin-top:calc(var(--spacing)*8)}.mt-12{margin-top:calc(var(--spacing)*12)}.mt-auto{margin-top:auto}.mr-1{margin-right:calc(var(--spacing)*1)}.mr-3{margin-right:calc(var(--spacing)*3)}.mr-4{margin-right:calc(var(--spacing)*4)}.mr-auto{margin-right:auto}.mb-0{margin-bottom:calc(var(--spacing)*0)}.mb-1{margin-bottom:calc(var(--spacing)*1)}.mb-2{margin-bottom:calc(var(--spacing)*2)}.mb-3{margin-bottom:calc(var(--spacing)*3)}.mb-4{margin-bottom:calc(var(--spacing)*4)}.mb-8{margin-bottom:calc(var(--spacing)*8)}.mb-12{margin-bottom:calc(var(--spacing)*12)}.mb-auto{margin-bottom:auto}.-ml-2{margin-left:calc(var(--spacing)*-2)}.-ml-4{margin-left:calc(var(--spacing)*-4)}.-ml-6{margin-left:calc(var(--spacing)*-6)}.-ml-8{margin-left:calc(var(--spacing)*-8)}.ml-1{margin-left:calc(var(--spacing)*1)}.ml-3{margin-left:calc(var(--spacing)*3)}.ml-4{margin-left:calc(var(--spacing)*4)}.ml-auto{margin-left:auto}.block{display:block}.block\!{display:block!important}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-0\.5{height:calc(var(--spacing)*.5)}.h-1{height:calc(var(--spacing)*1)}.h-4{height:calc(var(--spacing)*4)}.h-5{height:calc(var(--spacing)*5)}.h-6{height:calc(var(--spacing)*6)}.h-8{height:calc(var(--spacing)*8)}.h-16{height:calc(var(--spacing)*16)}.h-24{height:calc(var(--spacing)*24)}.h-auto{height:auto}.h-full{height:100%}.h-screen{height:100vh}.max-h-\[60vh\]{max-height:60vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[300px\]{min-height:300px}.min-h-\[calc\(100vh_-_4rem\)\]{min-height:calc(100vh - 4rem)}.min-h-screen{min-height:100vh}.w-5{width:calc(var(--spacing)*5)}.w-6{width:calc(var(--spacing)*6)}.w-8{width:calc(var(--spacing)*8)}.w-16{width:calc(var(--spacing)*16)}.w-64{width:calc(var(--spacing)*64)}.w-80{width:calc(var(--spacing)*80)}.w-96{width:calc(var(--spacing)*96)}.w-100{width:calc(var(--spacing)*100)}.w-\[70ch\]{width:70ch}.w-auto{width:auto}.w-fit{width:fit-content}.w-full{width:100%}.w-screen{width:100vw}.max-w-3xl{max-width:var(--container-3xl)}.max-w-7xl{max-width:var(--container-7xl)}.max-w-\[1000px\]{max-width:1000px}.max-w-full{max-width:100%}.max-w-lg{max-width:var(--container-lg)}.max-w-sm{max-width:var(--container-sm)}.min-w-screen{min-width:100vw}.flex-shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.flex-grow,.flex-grow-1,.grow{flex-grow:1}.table-auto{table-layout:auto}.table-fixed{table-layout:fixed}.border-collapse{border-collapse:collapse}.border-separate{border-collapse:separate}.origin-center{transform-origin:50%}.-rotate-45{rotate:-45deg}.rotate-45{rotate:45deg}.transform{transform:var(--tw-rotate-x,)var(--tw-rotate-y,)var(--tw-rotate-z,)var(--tw-skew-x,)var(--tw-skew-y,)}.animate-spin{animation:var(--animate-spin)}.cursor-auto{cursor:auto}.cursor-pointer{cursor:pointer}.scroll-mt-2{scroll-margin-top:calc(var(--spacing)*2)}.list-none{list-style-type:none}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.flex-col{flex-direction:column}.flex-row{flex-direction:row}.flex-nowrap{flex-wrap:nowrap}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-4{gap:calc(var(--spacing)*4)}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*4)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*4)*calc(1 - var(--tw-space-y-reverse)))}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px*var(--tw-divide-y-reverse));border-bottom-width:calc(1px*calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-gray-300>:not(:last-child)){border-color:var(--color-gray-300)}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-hidden{overflow-x:hidden}.overflow-y-auto{overflow-y:auto}.overflow-y-hidden{overflow-y:hidden}.scroll-smooth{scroll-behavior:smooth}.rounded{border-radius:.25rem}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-sm{border-radius:var(--radius-sm)}.rounded-t{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.rounded-l{border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-tl{border-top-left-radius:.25rem}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.rounded-tr{border-top-right-radius:.25rem}.rounded-b{border-bottom-right-radius:.25rem;border-bottom-left-radius:.25rem}.rounded-br{border-bottom-right-radius:.25rem}.rounded-bl{border-bottom-left-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-4{border-style:var(--tw-border-style);border-width:4px}.border-x{border-inline-style:var(--tw-border-style);border-inline-width:1px}.border-y{border-block-style:var(--tw-border-style);border-block-width:1px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-l{border-left-style:var(--tw-border-style);border-left-width:1px}.border-l-4{border-left-style:var(--tw-border-style);border-left-width:4px}.border-l-\[0\.325rem\]{border-left-style:var(--tw-border-style);border-left-width:.325rem}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-dotted{--tw-border-style:dotted;border-style:dotted}.border-double{--tw-border-style:double;border-style:double}.border-none{--tw-border-style:none;border-style:none}.border-solid{--tw-border-style:solid;border-style:solid}.border-amber-500{border-color:var(--color-amber-500)}.border-blue-500{border-color:var(--color-blue-500)}.border-gray-200{border-color:var(--color-gray-200)}.border-gray-300{border-color:var(--color-gray-300)}.border-gray-500{border-color:var(--color-gray-500)}.border-gray-900{border-color:var(--color-gray-900)}.border-green-500{border-color:var(--color-green-500)}.border-indigo-500{border-color:#5956eb}.border-red-600{border-color:var(--color-red-600)}.border-transparent{border-color:#0000}.border-yellow-400{border-color:var(--color-yellow-400)}.border-t-transparent{border-top-color:#0000}.border-r-gray-900{border-right-color:var(--color-gray-900)}.bg-black{background-color:var(--color-black)}.bg-black\/5{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.bg-black\/5{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.bg-black\/50{background-color:#00000080}@supports (color:color-mix(in lab,red,red)){.bg-black\/50{background-color:color-mix(in oklab,var(--color-black)50%,transparent)}}.bg-current{background-color:currentColor}.bg-gray-50{background-color:var(--color-gray-50)}.bg-gray-100{background-color:var(--color-gray-100)}.bg-gray-200{background-color:var(--color-gray-200)}.bg-gray-500{background-color:var(--color-gray-500)}.bg-indigo-600{background-color:var(--color-indigo-600)}.bg-slate-100{background-color:var(--color-slate-100)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.bg-yellow-400{background-color:var(--color-yellow-400)}.bg-linear-to-br{--tw-gradient-position:to bottom right;background-image:linear-gradient(var(--tw-gradient-stops))}@supports (background-image:linear-gradient(in lab,red,red)){.bg-linear-to-br{--tw-gradient-position:to bottom right in oklab}}.bg-cover{background-size:cover}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.bg-no-repeat{background-repeat:no-repeat}.fill-black{fill:var(--color-black)}.fill-current{fill:currentColor}.p-0{padding:calc(var(--spacing)*0)}.p-2{padding:calc(var(--spacing)*2)}.p-3{padding:calc(var(--spacing)*3)}.p-4{padding:calc(var(--spacing)*4)}.p-8{padding:calc(var(--spacing)*8)}.p-12{padding:calc(var(--spacing)*12)}.px-0{padding-inline:calc(var(--spacing)*0)}.px-1{padding-inline:calc(var(--spacing)*1)}.px-2{padding-inline:calc(var(--spacing)*2)}.px-3{padding-inline:calc(var(--spacing)*3)}.px-4{padding-inline:calc(var(--spacing)*4)}.px-5{padding-inline:calc(var(--spacing)*5)}.px-6{padding-inline:calc(var(--spacing)*6)}.px-8{padding-inline:calc(var(--spacing)*8)}.py-0{padding-block:calc(var(--spacing)*0)}.py-1{padding-block:calc(var(--spacing)*1)}.py-2{padding-block:calc(var(--spacing)*2)}.py-3{padding-block:calc(var(--spacing)*3)}.py-4{padding-block:calc(var(--spacing)*4)}.py-5{padding-block:calc(var(--spacing)*5)}.py-6{padding-block:calc(var(--spacing)*6)}.py-8{padding-block:calc(var(--spacing)*8)}.py-12{padding-block:calc(var(--spacing)*12)}.py-16{padding-block:calc(var(--spacing)*16)}.py-24{padding-block:calc(var(--spacing)*24)}.py-32{padding-block:calc(var(--spacing)*32)}.ps-0{padding-inline-start:calc(var(--spacing)*0)}.ps-2{padding-inline-start:calc(var(--spacing)*2)}.ps-3{padding-inline-start:calc(var(--spacing)*3)}.pe-0{padding-inline-end:calc(var(--spacing)*0)}.pe-2{padding-inline-end:calc(var(--spacing)*2)}.pe-4{padding-inline-end:calc(var(--spacing)*4)}.pt-3{padding-top:calc(var(--spacing)*3)}.pt-4{padding-top:calc(var(--spacing)*4)}.pt-8{padding-top:calc(var(--spacing)*8)}.pt-10{padding-top:calc(var(--spacing)*10)}.pb-2{padding-bottom:calc(var(--spacing)*2)}.pb-3{padding-bottom:calc(var(--spacing)*3)}.pb-4{padding-bottom:calc(var(--spacing)*4)}.pb-8{padding-bottom:calc(var(--spacing)*8)}.pb-12{padding-bottom:calc(var(--spacing)*12)}.pl-2{padding-left:calc(var(--spacing)*2)}.pl-4{padding-left:calc(var(--spacing)*4)}.pl-5{padding-left:calc(var(--spacing)*5)}.pl-8{padding-left:calc(var(--spacing)*8)}.text-center{text-align:center}.text-end{text-align:end}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.font-sans{font-family:var(--font-sans)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-\[75\%\]{font-size:75%}.text-\[90\%\]{font-size:90%}.leading-7{--tw-leading:calc(var(--spacing)*7);line-height:calc(var(--spacing)*7)}.leading-8{--tw-leading:calc(var(--spacing)*8);line-height:calc(var(--spacing)*8)}.leading-10{--tw-leading:calc(var(--spacing)*10);line-height:calc(var(--spacing)*10)}.leading-normal{--tw-leading:var(--leading-normal);line-height:var(--leading-normal)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-black{--tw-font-weight:var(--font-weight-black);font-weight:var(--font-weight-black)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-extrabold{--tw-font-weight:var(--font-weight-extrabold);font-weight:var(--font-weight-extrabold)}.font-light{--tw-font-weight:var(--font-weight-light);font-weight:var(--font-weight-light)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-normal{--tw-tracking:var(--tracking-normal);letter-spacing:var(--tracking-normal)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.text-nowrap{text-wrap:nowrap}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.text-black{color:var(--color-black)}.text-blue-500{color:var(--color-blue-500)}.text-gray-100{color:var(--color-gray-100)}.text-gray-200{color:var(--color-gray-200)}.text-gray-400{color:var(--color-gray-400)}.text-gray-500{color:var(--color-gray-500)}.text-gray-600{color:var(--color-gray-600)}.text-gray-700{color:var(--color-gray-700)}.text-green-500{color:var(--color-green-500)}.text-indigo-500{color:#5956eb}.text-indigo-600{color:var(--color-indigo-600)}.text-red-500{color:var(--color-red-500)}.text-transparent{color:#0000}.text-white{color:var(--color-white)}.text-yellow-500{color:var(--color-yellow-500)}.capitalize{text-transform:capitalize}.lowercase{text-transform:lowercase}.uppercase{text-transform:uppercase}.italic{font-style:italic}.antialiased{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.opacity-0{opacity:0}.opacity-50{opacity:.5}.opacity-75{opacity:.75}.opacity-80{opacity:.8}.shadow{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a),0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px var(--tw-shadow-color,#0000001a),0 2px 4px -2px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a),0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-1{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(1px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.ring-gray-900\/5{--tw-ring-color:#1018280d}@supports (color:color-mix(in lab,red,red)){.ring-gray-900\/5{--tw-ring-color:color-mix(in oklab,var(--color-gray-900)5%,transparent)}}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.drop-shadow-2xl{--tw-drop-shadow-size:drop-shadow(0 25px 25px var(--tw-drop-shadow-color,#00000026));--tw-drop-shadow:drop-shadow(var(--drop-shadow-2xl));filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.invert{--tw-invert:invert(100%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-shadow{transition-property:box-shadow;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-75{--tw-duration:75ms;transition-duration:75ms}.duration-250{--tw-duration:.25s;transition-duration:.25s}.duration-300{--tw-duration:.3s;transition-duration:.3s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.ease-linear{--tw-ease:linear;transition-timing-function:linear}.ease-out{--tw-ease:var(--ease-out);transition-timing-function:var(--ease-out)}@media (hover:hover){.group-hover\:opacity-100:is(:where(.group):hover *){opacity:1}.group-hover\:grayscale-0:is(:where(.group):hover *){--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.hover\:bg-black\/5:hover{background-color:#0000000d}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/5:hover{background-color:color-mix(in oklab,var(--color-black)5%,transparent)}}.hover\:bg-black\/10:hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.hover\:bg-black\/10:hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.hover\:bg-gray-200\/20:hover{background-color:#e5e7eb33}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-200\/20:hover{background-color:color-mix(in oklab,var(--color-gray-200)20%,transparent)}}.hover\:bg-gray-600:hover{background-color:var(--color-gray-600)}.hover\:bg-indigo-500:hover{background-color:#5956eb}.hover\:text-gray-700:hover{color:var(--color-gray-700)}.hover\:text-gray-900:hover{color:var(--color-gray-900)}.hover\:text-indigo-600:hover{color:var(--color-indigo-600)}.hover\:underline:hover{text-decoration-line:underline}.hover\:opacity-100:hover{opacity:1}.hover\:shadow-xl:hover{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}.focus\:not-sr-only:focus{clip:auto;white-space:normal;width:auto;height:auto;margin:0;padding:0;position:static;overflow:visible}.focus\:absolute:focus{position:absolute}.focus\:mx-auto:focus{margin-inline:auto}.focus\:mt-2:focus{margin-top:calc(var(--spacing)*2)}.focus\:w-64:focus{width:calc(var(--spacing)*64)}.focus\:bg-gray-700:focus{background-color:var(--color-gray-700)}.focus\:bg-indigo-700:focus{background-color:var(--color-indigo-700)}.focus\:p-2:focus{padding:calc(var(--spacing)*2)}.focus\:opacity-100:focus{opacity:1}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,)0 0 0 calc(2px + var(--tw-ring-offset-width))var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-gray-700:focus{--tw-ring-color:var(--color-gray-700)}.focus\:ring-indigo-600:focus{--tw-ring-color:var(--color-indigo-600)}.focus\:grayscale-0:focus{--tw-grayscale:grayscale(0%);filter:var(--tw-blur,)var(--tw-brightness,)var(--tw-contrast,)var(--tw-grayscale,)var(--tw-hue-rotate,)var(--tw-invert,)var(--tw-saturate,)var(--tw-sepia,)var(--tw-drop-shadow,)}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}@media (min-width:40rem){.sm\:-mx-6{margin-inline:calc(var(--spacing)*-6)}.sm\:mx-auto{margin-inline:auto}.sm\:mt-4{margin-top:calc(var(--spacing)*4)}.sm\:mb-0{margin-bottom:calc(var(--spacing)*0)}.sm\:block{display:block}.sm\:max-w-xl{max-width:var(--container-xl)}.sm\:rounded-lg{border-radius:var(--radius-lg)}.sm\:px-6{padding-inline:calc(var(--spacing)*6)}.sm\:px-10{padding-inline:calc(var(--spacing)*10)}.sm\:py-12{padding-block:calc(var(--spacing)*12)}.sm\:leading-none{--tw-leading:1;line-height:1}.sm\:shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a),0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:48rem){.md\:visible{visibility:visible}.md\:top-0{top:calc(var(--spacing)*0)}.md\:left-0{left:calc(var(--spacing)*0)}.md\:left-64{left:calc(var(--spacing)*64)}.md\:mx-2{margin-inline:calc(var(--spacing)*2)}.md\:my-0{margin-block:calc(var(--spacing)*0)}.md\:my-6{margin-block:calc(var(--spacing)*6)}.md\:mt-0{margin-top:calc(var(--spacing)*0)}.md\:mt-8{margin-top:calc(var(--spacing)*8)}.md\:mb-12{margin-bottom:calc(var(--spacing)*12)}.md\:ml-0{margin-left:calc(var(--spacing)*0)}.md\:block{display:block}.md\:flex{display:flex}.md\:hidden{display:none}.md\:inline-block{display:inline-block}.md\:min-h-screen{min-height:100vh}.md\:w-1\/2{width:50%}.md\:w-\[calc\(100vw_-_16rem\)\]{width:calc(100vw - 16rem)}.md\:w-auto{width:auto}.md\:max-w-2xl{max-width:var(--container-2xl)}.md\:max-w-none{max-width:none}.md\:grow{flex-grow:1}.md\:grow-0{flex-grow:0}.md\:items-center{align-items:center}.md\:border-none{--tw-border-style:none;border-style:none}.md\:bg-transparent{background-color:#0000}.md\:bg-white{background-color:var(--color-white)}.md\:bg-left{background-position:0}.md\:px-16{padding-inline:calc(var(--spacing)*16)}.md\:py-0{padding-block:calc(var(--spacing)*0)}.md\:py-16{padding-block:calc(var(--spacing)*16)}.md\:pb-0{padding-bottom:calc(var(--spacing)*0)}.md\:pl-0{padding-left:calc(var(--spacing)*0)}.md\:text-center{text-align:center}.md\:text-3xl{font-size:var(--text-3xl);line-height:var(--tw-leading,var(--text-3xl--line-height))}.md\:text-4xl{font-size:var(--text-4xl);line-height:var(--tw-leading,var(--text-4xl--line-height))}.md\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.md\:text-6xl{font-size:var(--text-6xl);line-height:var(--tw-leading,var(--text-6xl--line-height))}.md\:shadow-none{--tw-shadow:0 0 #0000;box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}}@media (min-width:64rem){.lg\:mb-12{margin-bottom:calc(var(--spacing)*12)}.lg\:ml-8{margin-left:calc(var(--spacing)*8)}.lg\:flex{display:flex}.lg\:bg-center{background-position:50%}.lg\:text-5xl{font-size:var(--text-5xl);line-height:var(--tw-leading,var(--text-5xl--line-height))}.lg\:text-7xl{font-size:var(--text-7xl);line-height:var(--tw-leading,var(--text-7xl--line-height))}.lg\:text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}}@media (min-width:80rem){.xl\:mb-16{margin-bottom:calc(var(--spacing)*16)}}.dark\:block:is(.dark *){display:block}.dark\:hidden:is(.dark *){display:none}:where(.dark\:divide-gray-700:is(.dark *)>:not(:last-child)){border-color:var(--color-gray-700)}.dark\:border-\[\#1b2533\]:is(.dark *){border-color:#1b2533}.dark\:border-gray-700:is(.dark *){border-color:var(--color-gray-700)}.dark\:bg-black\/10:is(.dark *){background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:bg-black\/10:is(.dark *){background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:bg-gray-600:is(.dark *){background-color:var(--color-gray-600)}.dark\:bg-gray-700:is(.dark *){background-color:var(--color-gray-700)}.dark\:bg-gray-800:is(.dark *){background-color:var(--color-gray-800)}.dark\:bg-gray-900:is(.dark *){background-color:var(--color-gray-900)}.dark\:bg-slate-800:is(.dark *){background-color:var(--color-slate-800)}.dark\:bg-yellow-300:is(.dark *){background-color:var(--color-yellow-300)}.dark\:fill-gray-200:is(.dark *){fill:var(--color-gray-200)}.dark\:fill-white:is(.dark *){fill:var(--color-white)}.dark\:font-medium:is(.dark *){--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.dark\:prose-invert:is(.dark *){--tw-prose-body:var(--tw-prose-invert-body);--tw-prose-headings:var(--tw-prose-invert-headings);--tw-prose-lead:var(--tw-prose-invert-lead);--tw-prose-links:var(--tw-prose-invert-links);--tw-prose-bold:var(--tw-prose-invert-bold);--tw-prose-counters:var(--tw-prose-invert-counters);--tw-prose-bullets:var(--tw-prose-invert-bullets);--tw-prose-hr:var(--tw-prose-invert-hr);--tw-prose-quotes:var(--tw-prose-invert-quotes);--tw-prose-quote-borders:var(--tw-prose-invert-quote-borders);--tw-prose-captions:var(--tw-prose-invert-captions);--tw-prose-kbd:var(--tw-prose-invert-kbd);--tw-prose-kbd-shadows:var(--tw-prose-invert-kbd-shadows);--tw-prose-code:var(--tw-prose-invert-code);--tw-prose-pre-code:var(--tw-prose-invert-pre-code);--tw-prose-pre-bg:var(--tw-prose-invert-pre-bg);--tw-prose-th-borders:var(--tw-prose-invert-th-borders);--tw-prose-td-borders:var(--tw-prose-invert-td-borders)}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)){color:#818cf8}.dark\:prose-invert:is(.dark *) :where(a):not(:where([class~=not-prose],[class~=not-prose] *)):hover{color:#6366f1}.dark\:text-gray-100:is(.dark *){color:var(--color-gray-100)}.dark\:text-gray-200:is(.dark *){color:var(--color-gray-200)}.dark\:text-gray-300:is(.dark *){color:var(--color-gray-300)}.dark\:text-gray-400:is(.dark *){color:var(--color-gray-400)}.dark\:text-indigo-400:is(.dark *){color:var(--color-indigo-400)}.dark\:text-white:is(.dark *){color:var(--color-white)}@media (hover:hover){.dark\:group-hover\:text-white:is(.dark *):is(:where(.group):hover *){color:var(--color-white)}.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:#0000001a}@supports (color:color-mix(in lab,red,red)){.dark\:hover\:bg-black\/10:is(.dark *):hover{background-color:color-mix(in oklab,var(--color-black)10%,transparent)}}.dark\:hover\:bg-gray-500:is(.dark *):hover{background-color:var(--color-gray-500)}.dark\:hover\:text-white:is(.dark *):hover{color:var(--color-white)}}.dark\:focus\:text-white:is(.dark *):focus{color:var(--color-white)}.dark\:focus\:ring-indigo-500:is(.dark *):focus{--tw-ring-color:#5956eb}@media (min-width:48rem){.dark\:md\:bg-transparent:is(.dark *){background-color:#0000}}@media print{.print\:top-0{top:calc(var(--spacing)*0)}.print\:hidden{display:none}}.prose-h1\:mb-3 :where(h1):not(:where([class~=not-prose],[class~=not-prose] *)){margin-bottom:calc(var(--spacing)*3)}.prose-p\:my-3 :where(p):not(:where([class~=not-prose],[class~=not-prose] *)){margin-block:calc(var(--spacing)*3)}.prose-img\:inline :where(img):not(:where([class~=not-prose],[class~=not-prose] *)){display:inline}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}

From 9df2d650c901b013593c444c5990dc465e4d1d40 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 14:14:06 +0200
Subject: [PATCH 3997/4023] Upgrade to Vite 6

---
 package-lock.json                 | 986 ++++++++++++++++++------------
 package.json                      |   4 +-
 packages/hyde/package.json        |   4 +-
 packages/vite-plugin/package.json |   4 +-
 4 files changed, 592 insertions(+), 406 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 9a6fc19c37b..052b9425086 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -8,17 +8,17 @@
                 "@tailwindcss/typography": "^0.5.15",
                 "@tailwindcss/vite": "^4.1.4",
                 "autoprefixer": "^10.4.20",
-                "hydefront": "^3.3.0",
+                "hydefront": "^3.4.1",
                 "postcss": "^8.4.49",
                 "prettier": "3.3.3",
                 "tailwindcss": "^4.1.4",
-                "vite": "^5.0.0"
+                "vite": "^6.3.3"
             }
         },
         "node_modules/@esbuild/aix-ppc64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
-            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.3.tgz",
+            "integrity": "sha512-W8bFfPA8DowP8l//sxjJLSLkD8iEjMc7cBVyP+u4cEv9sM7mdUCkgsj+t0n/BWPFtv7WWCN5Yzj0N6FJNUUqBQ==",
             "cpu": [
                 "ppc64"
             ],
@@ -28,13 +28,13 @@
                 "aix"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/android-arm": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
-            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.3.tgz",
+            "integrity": "sha512-PuwVXbnP87Tcff5I9ngV0lmiSu40xw1At6i3GsU77U7cjDDB4s0X2cyFuBiDa1SBk9DnvWwnGvVaGBqoFWPb7A==",
             "cpu": [
                 "arm"
             ],
@@ -44,13 +44,13 @@
                 "android"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/android-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
-            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.3.tgz",
+            "integrity": "sha512-XelR6MzjlZuBM4f5z2IQHK6LkK34Cvv6Rj2EntER3lwCBFdg6h2lKbtRjpTTsdEjD/WSe1q8UyPBXP1x3i/wYQ==",
             "cpu": [
                 "arm64"
             ],
@@ -60,13 +60,13 @@
                 "android"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/android-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
-            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.3.tgz",
+            "integrity": "sha512-ogtTpYHT/g1GWS/zKM0cc/tIebFjm1F9Aw1boQ2Y0eUQ+J89d0jFY//s9ei9jVIlkYi8AfOjiixcLJSGNSOAdQ==",
             "cpu": [
                 "x64"
             ],
@@ -76,13 +76,13 @@
                 "android"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/darwin-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
-            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.3.tgz",
+            "integrity": "sha512-eESK5yfPNTqpAmDfFWNsOhmIOaQA59tAcF/EfYvo5/QWQCzXn5iUSOnqt3ra3UdzBv073ykTtmeLJZGt3HhA+w==",
             "cpu": [
                 "arm64"
             ],
@@ -92,13 +92,13 @@
                 "darwin"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/darwin-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
-            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.3.tgz",
+            "integrity": "sha512-Kd8glo7sIZtwOLcPbW0yLpKmBNWMANZhrC1r6K++uDR2zyzb6AeOYtI6udbtabmQpFaxJ8uduXMAo1gs5ozz8A==",
             "cpu": [
                 "x64"
             ],
@@ -108,13 +108,13 @@
                 "darwin"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/freebsd-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
-            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-EJiyS70BYybOBpJth3M0KLOus0n+RRMKTYzhYhFeMwp7e/RaajXvP+BWlmEXNk6uk+KAu46j/kaQzr6au+JcIw==",
             "cpu": [
                 "arm64"
             ],
@@ -124,13 +124,13 @@
                 "freebsd"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/freebsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
-            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.3.tgz",
+            "integrity": "sha512-Q+wSjaLpGxYf7zC0kL0nDlhsfuFkoN+EXrx2KSB33RhinWzejOd6AvgmP5JbkgXKmjhmpfgKZq24pneodYqE8Q==",
             "cpu": [
                 "x64"
             ],
@@ -140,13 +140,13 @@
                 "freebsd"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-arm": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
-            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.3.tgz",
+            "integrity": "sha512-dUOVmAUzuHy2ZOKIHIKHCm58HKzFqd+puLaS424h6I85GlSDRZIA5ycBixb3mFgM0Jdh+ZOSB6KptX30DD8YOQ==",
             "cpu": [
                 "arm"
             ],
@@ -156,13 +156,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
-            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.3.tgz",
+            "integrity": "sha512-xCUgnNYhRD5bb1C1nqrDV1PfkwgbswTTBRbAd8aH5PhYzikdf/ddtsYyMXFfGSsb/6t6QaPSzxtbfAZr9uox4A==",
             "cpu": [
                 "arm64"
             ],
@@ -172,13 +172,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-ia32": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
-            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.3.tgz",
+            "integrity": "sha512-yplPOpczHOO4jTYKmuYuANI3WhvIPSVANGcNUeMlxH4twz/TeXuzEP41tGKNGWJjuMhotpGabeFYGAOU2ummBw==",
             "cpu": [
                 "ia32"
             ],
@@ -188,13 +188,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-loong64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
-            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.3.tgz",
+            "integrity": "sha512-P4BLP5/fjyihmXCELRGrLd793q/lBtKMQl8ARGpDxgzgIKJDRJ/u4r1A/HgpBpKpKZelGct2PGI4T+axcedf6g==",
             "cpu": [
                 "loong64"
             ],
@@ -204,13 +204,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-mips64el": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
-            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.3.tgz",
+            "integrity": "sha512-eRAOV2ODpu6P5divMEMa26RRqb2yUoYsuQQOuFUexUoQndm4MdpXXDBbUoKIc0iPa4aCO7gIhtnYomkn2x+bag==",
             "cpu": [
                 "mips64el"
             ],
@@ -220,13 +220,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-ppc64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
-            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.3.tgz",
+            "integrity": "sha512-ZC4jV2p7VbzTlnl8nZKLcBkfzIf4Yad1SJM4ZMKYnJqZFD4rTI+pBG65u8ev4jk3/MPwY9DvGn50wi3uhdaghg==",
             "cpu": [
                 "ppc64"
             ],
@@ -236,13 +236,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-riscv64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
-            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.3.tgz",
+            "integrity": "sha512-LDDODcFzNtECTrUUbVCs6j9/bDVqy7DDRsuIXJg6so+mFksgwG7ZVnTruYi5V+z3eE5y+BJZw7VvUadkbfg7QA==",
             "cpu": [
                 "riscv64"
             ],
@@ -252,13 +252,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-s390x": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
-            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.3.tgz",
+            "integrity": "sha512-s+w/NOY2k0yC2p9SLen+ymflgcpRkvwwa02fqmAwhBRI3SC12uiS10edHHXlVWwfAagYSY5UpmT/zISXPMW3tQ==",
             "cpu": [
                 "s390x"
             ],
@@ -268,13 +268,13 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/linux-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
-            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.3.tgz",
+            "integrity": "sha512-nQHDz4pXjSDC6UfOE1Fw9Q8d6GCAd9KdvMZpfVGWSJztYCarRgSDfOVBY5xwhQXseiyxapkiSJi/5/ja8mRFFA==",
             "cpu": [
                 "x64"
             ],
@@ -284,13 +284,29 @@
                 "linux"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/netbsd-arm64": {
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-1QaLtOWq0mzK6tzzp0jRN3eccmN3hezey7mhLnzC6oNlJoUJz4nym5ZD7mDnS/LZQgkrhEbEiTn515lPeLpgWA==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "netbsd"
+            ],
+            "engines": {
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/netbsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
-            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.3.tgz",
+            "integrity": "sha512-i5Hm68HXHdgv8wkrt+10Bc50zM0/eonPb/a/OFVfB6Qvpiirco5gBA5bz7S2SHuU+Y4LWn/zehzNX14Sp4r27g==",
             "cpu": [
                 "x64"
             ],
@@ -300,13 +316,29 @@
                 "netbsd"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
+            }
+        },
+        "node_modules/@esbuild/openbsd-arm64": {
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-zGAVApJEYTbOC6H/3QBr2mq3upG/LBEXr85/pTtKiv2IXcgKV0RT0QA/hSXZqSvLEpXeIxah7LczB4lkiYhTAQ==",
+            "cpu": [
+                "arm64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "openbsd"
+            ],
+            "engines": {
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/openbsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
-            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.3.tgz",
+            "integrity": "sha512-fpqctI45NnCIDKBH5AXQBsD0NDPbEFczK98hk/aa6HJxbl+UtLkJV2+Bvy5hLSLk3LHmqt0NTkKNso1A9y1a4w==",
             "cpu": [
                 "x64"
             ],
@@ -316,13 +348,13 @@
                 "openbsd"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/sunos-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
-            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.3.tgz",
+            "integrity": "sha512-ROJhm7d8bk9dMCUZjkS8fgzsPAZEjtRJqCAmVgB0gMrvG7hfmPmz9k1rwO4jSiblFjYmNvbECL9uhaPzONMfgA==",
             "cpu": [
                 "x64"
             ],
@@ -332,13 +364,13 @@
                 "sunos"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/win32-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
-            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.3.tgz",
+            "integrity": "sha512-YWcow8peiHpNBiIXHwaswPnAXLsLVygFwCB3A7Bh5jRkIBFWHGmNQ48AlX4xDvQNoMZlPYzjVOQDYEzWCqufMQ==",
             "cpu": [
                 "arm64"
             ],
@@ -348,13 +380,13 @@
                 "win32"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/win32-ia32": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
-            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.3.tgz",
+            "integrity": "sha512-qspTZOIGoXVS4DpNqUYUs9UxVb04khS1Degaw/MnfMe7goQ3lTfQ13Vw4qY/Nj0979BGvMRpAYbs/BAxEvU8ew==",
             "cpu": [
                 "ia32"
             ],
@@ -364,13 +396,13 @@
                 "win32"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@esbuild/win32-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
-            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.3.tgz",
+            "integrity": "sha512-ICgUR+kPimx0vvRzf+N/7L7tVSQeE3BYY+NhHRHXS1kBuPO7z2+7ea2HbhDyZdTephgvNvKrlDDKUexuCVBVvg==",
             "cpu": [
                 "x64"
             ],
@@ -380,7 +412,7 @@
                 "win32"
             ],
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             }
         },
         "node_modules/@jridgewell/gen-mapping": {
@@ -448,9 +480,9 @@
             }
         },
         "node_modules/@rollup/rollup-android-arm-eabi": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
-            "integrity": "sha512-CC/ZqFZwlAIbU1wUPisHyV/XRc5RydFrNLtgl3dGYskdwPZdt4HERtKm50a/+DtTlKeCq9IXFEWR+P6blwjqBA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.40.0.tgz",
+            "integrity": "sha512-+Fbls/diZ0RDerhE8kyC6hjADCXA1K4yVNlH0EYfd2XjyH0UGgzaQ8MlT0pCXAThfxv3QUAczHaL+qSv1E4/Cg==",
             "cpu": [
                 "arm"
             ],
@@ -461,9 +493,9 @@
             ]
         },
         "node_modules/@rollup/rollup-android-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.25.0.tgz",
-            "integrity": "sha512-/Y76tmLGUJqVBXXCfVS8Q8FJqYGhgH4wl4qTA24E9v/IJM0XvJCGQVSW1QZ4J+VURO9h8YCa28sTFacZXwK7Rg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.40.0.tgz",
+            "integrity": "sha512-PPA6aEEsTPRz+/4xxAmaoWDqh67N7wFbgFUJGMnanCFs0TV99M0M8QhhaSCks+n6EbQoFvLQgYOGXxlMGQe/6w==",
             "cpu": [
                 "arm64"
             ],
@@ -474,9 +506,9 @@
             ]
         },
         "node_modules/@rollup/rollup-darwin-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.25.0.tgz",
-            "integrity": "sha512-YVT6L3UrKTlC0FpCZd0MGA7NVdp7YNaEqkENbWQ7AOVOqd/7VzyHpgIpc1mIaxRAo1ZsJRH45fq8j4N63I/vvg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.40.0.tgz",
+            "integrity": "sha512-GwYOcOakYHdfnjjKwqpTGgn5a6cUX7+Ra2HeNj/GdXvO2VJOOXCiYYlRFU4CubFM67EhbmzLOmACKEfvp3J1kQ==",
             "cpu": [
                 "arm64"
             ],
@@ -487,9 +519,9 @@
             ]
         },
         "node_modules/@rollup/rollup-darwin-x64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.25.0.tgz",
-            "integrity": "sha512-ZRL+gexs3+ZmmWmGKEU43Bdn67kWnMeWXLFhcVv5Un8FQcx38yulHBA7XR2+KQdYIOtD0yZDWBCudmfj6lQJoA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.40.0.tgz",
+            "integrity": "sha512-CoLEGJ+2eheqD9KBSxmma6ld01czS52Iw0e2qMZNpPDlf7Z9mj8xmMemxEucinev4LgHalDPczMyxzbq+Q+EtA==",
             "cpu": [
                 "x64"
             ],
@@ -500,9 +532,9 @@
             ]
         },
         "node_modules/@rollup/rollup-freebsd-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.25.0.tgz",
-            "integrity": "sha512-xpEIXhiP27EAylEpreCozozsxWQ2TJbOLSivGfXhU4G1TBVEYtUPi2pOZBnvGXHyOdLAUUhPnJzH3ah5cqF01g==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.40.0.tgz",
+            "integrity": "sha512-r7yGiS4HN/kibvESzmrOB/PxKMhPTlz+FcGvoUIKYoTyGd5toHp48g1uZy1o1xQvybwwpqpe010JrcGG2s5nkg==",
             "cpu": [
                 "arm64"
             ],
@@ -513,9 +545,9 @@
             ]
         },
         "node_modules/@rollup/rollup-freebsd-x64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.25.0.tgz",
-            "integrity": "sha512-sC5FsmZGlJv5dOcURrsnIK7ngc3Kirnx3as2XU9uER+zjfyqIjdcMVgzy4cOawhsssqzoAX19qmxgJ8a14Qrqw==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.40.0.tgz",
+            "integrity": "sha512-mVDxzlf0oLzV3oZOr0SMJ0lSDd3xC4CmnWJ8Val8isp9jRGl5Dq//LLDSPFrasS7pSm6m5xAcKaw3sHXhBjoRw==",
             "cpu": [
                 "x64"
             ],
@@ -526,9 +558,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.25.0.tgz",
-            "integrity": "sha512-uD/dbLSs1BEPzg564TpRAQ/YvTnCds2XxyOndAO8nJhaQcqQGFgv/DAVko/ZHap3boCvxnzYMa3mTkV/B/3SWA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.40.0.tgz",
+            "integrity": "sha512-y/qUMOpJxBMy8xCXD++jeu8t7kzjlOCkoxxajL58G62PJGBZVl/Gwpm7JK9+YvlB701rcQTzjUZ1JgUoPTnoQA==",
             "cpu": [
                 "arm"
             ],
@@ -539,9 +571,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.25.0.tgz",
-            "integrity": "sha512-ZVt/XkrDlQWegDWrwyC3l0OfAF7yeJUF4fq5RMS07YM72BlSfn2fQQ6lPyBNjt+YbczMguPiJoCfaQC2dnflpQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.40.0.tgz",
+            "integrity": "sha512-GoCsPibtVdJFPv/BOIvBKO/XmwZLwaNWdyD8TKlXuqp0veo2sHE+A/vpMQ5iSArRUz/uaoj4h5S6Pn0+PdhRjg==",
             "cpu": [
                 "arm"
             ],
@@ -552,9 +584,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.25.0.tgz",
-            "integrity": "sha512-qboZ+T0gHAW2kkSDPHxu7quaFaaBlynODXpBVnPxUgvWYaE84xgCKAPEYE+fSMd3Zv5PyFZR+L0tCdYCMAtG0A==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.40.0.tgz",
+            "integrity": "sha512-L5ZLphTjjAD9leJzSLI7rr8fNqJMlGDKlazW2tX4IUF9P7R5TMQPElpH82Q7eNIDQnQlAyiNVfRPfP2vM5Avvg==",
             "cpu": [
                 "arm64"
             ],
@@ -565,9 +597,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-musl": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.25.0.tgz",
-            "integrity": "sha512-ndWTSEmAaKr88dBuogGH2NZaxe7u2rDoArsejNslugHZ+r44NfWiwjzizVS1nUOHo+n1Z6qV3X60rqE/HlISgw==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.40.0.tgz",
+            "integrity": "sha512-ATZvCRGCDtv1Y4gpDIXsS+wfFeFuLwVxyUBSLawjgXK2tRE6fnsQEkE4csQQYWlBlsFztRzCnBvWVfcae/1qxQ==",
             "cpu": [
                 "arm64"
             ],
@@ -577,10 +609,23 @@
                 "linux"
             ]
         },
+        "node_modules/@rollup/rollup-linux-loongarch64-gnu": {
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.40.0.tgz",
+            "integrity": "sha512-wG9e2XtIhd++QugU5MD9i7OnpaVb08ji3P1y/hNbxrQ3sYEelKJOq1UJ5dXczeo6Hj2rfDEL5GdtkMSVLa/AOg==",
+            "cpu": [
+                "loong64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
         "node_modules/@rollup/rollup-linux-powerpc64le-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.25.0.tgz",
-            "integrity": "sha512-BVSQvVa2v5hKwJSy6X7W1fjDex6yZnNKy3Kx1JGimccHft6HV0THTwNtC2zawtNXKUu+S5CjXslilYdKBAadzA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.40.0.tgz",
+            "integrity": "sha512-vgXfWmj0f3jAUvC7TZSU/m/cOE558ILWDzS7jBhiCAFpY2WEBn5jqgbqvmzlMjtp8KlLcBlXVD2mkTSEQE6Ixw==",
             "cpu": [
                 "ppc64"
             ],
@@ -591,9 +636,22 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.25.0.tgz",
-            "integrity": "sha512-G4hTREQrIdeV0PE2JruzI+vXdRnaK1pg64hemHq2v5fhv8C7WjVaeXc9P5i4Q5UC06d/L+zA0mszYIKl+wY8oA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.40.0.tgz",
+            "integrity": "sha512-uJkYTugqtPZBS3Z136arevt/FsKTF/J9dEMTX/cwR7lsAW4bShzI2R0pJVw+hcBTWF4dxVckYh72Hk3/hWNKvA==",
+            "cpu": [
+                "riscv64"
+            ],
+            "dev": true,
+            "optional": true,
+            "os": [
+                "linux"
+            ]
+        },
+        "node_modules/@rollup/rollup-linux-riscv64-musl": {
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.40.0.tgz",
+            "integrity": "sha512-rKmSj6EXQRnhSkE22+WvrqOqRtk733x3p5sWpZilhmjnkHkpeCgWsFFo0dGnUGeA+OZjRl3+VYq+HyCOEuwcxQ==",
             "cpu": [
                 "riscv64"
             ],
@@ -604,9 +662,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-s390x-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.25.0.tgz",
-            "integrity": "sha512-9T/w0kQ+upxdkFL9zPVB6zy9vWW1deA3g8IauJxojN4bnz5FwSsUAD034KpXIVX5j5p/rn6XqumBMxfRkcHapQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.40.0.tgz",
+            "integrity": "sha512-SpnYlAfKPOoVsQqmTFJ0usx0z84bzGOS9anAC0AZ3rdSo3snecihbhFTlJZ8XMwzqAcodjFU4+/SM311dqE5Sw==",
             "cpu": [
                 "s390x"
             ],
@@ -617,9 +675,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.25.0.tgz",
-            "integrity": "sha512-ThcnU0EcMDn+J4B9LD++OgBYxZusuA7iemIIiz5yzEcFg04VZFzdFjuwPdlURmYPZw+fgVrFzj4CA64jSTG4Ig==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.40.0.tgz",
+            "integrity": "sha512-RcDGMtqF9EFN8i2RYN2W+64CdHruJ5rPqrlYw+cgM3uOVPSsnAQps7cpjXe9be/yDp8UC7VLoCoKC8J3Kn2FkQ==",
             "cpu": [
                 "x64"
             ],
@@ -630,9 +688,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-musl": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.25.0.tgz",
-            "integrity": "sha512-zx71aY2oQxGxAT1JShfhNG79PnjYhMC6voAjzpu/xmMjDnKNf6Nl/xv7YaB/9SIa9jDYf8RBPWEnjcdlhlv1rQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.40.0.tgz",
+            "integrity": "sha512-HZvjpiUmSNx5zFgwtQAV1GaGazT2RWvqeDi0hV+AtC8unqqDSsaFjPxfsO6qPtKRRg25SisACWnJ37Yio8ttaw==",
             "cpu": [
                 "x64"
             ],
@@ -643,9 +701,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-arm64-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.25.0.tgz",
-            "integrity": "sha512-JT8tcjNocMs4CylWY/CxVLnv8e1lE7ff1fi6kbGocWwxDq9pj30IJ28Peb+Y8yiPNSF28oad42ApJB8oUkwGww==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.40.0.tgz",
+            "integrity": "sha512-UtZQQI5k/b8d7d3i9AZmA/t+Q4tk3hOC0tMOMSq2GlMYOfxbesxG4mJSeDp0EHs30N9bsfwUvs3zF4v/RzOeTQ==",
             "cpu": [
                 "arm64"
             ],
@@ -656,9 +714,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-ia32-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.25.0.tgz",
-            "integrity": "sha512-dRLjLsO3dNOfSN6tjyVlG+Msm4IiZnGkuZ7G5NmpzwF9oOc582FZG05+UdfTbz5Jd4buK/wMb6UeHFhG18+OEg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.40.0.tgz",
+            "integrity": "sha512-+m03kvI2f5syIqHXCZLPVYplP8pQch9JHyXKZ3AGMKlg8dCyr2PKHjwRLiW53LTrN/Nc3EqHOKxUxzoSPdKddA==",
             "cpu": [
                 "ia32"
             ],
@@ -669,9 +727,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-x64-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.25.0.tgz",
-            "integrity": "sha512-/RqrIFtLB926frMhZD0a5oDa4eFIbyNEwLLloMTEjmqfwZWXywwVVOVmwTsuyhC9HKkVEZcOOi+KV4U9wmOdlg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.40.0.tgz",
+            "integrity": "sha512-lpPE1cLfP5oPzVjKMx10pgBmKELQnFJXHgvtHCtuJWOv8MxqdEIMNtgHgBFf7Ea2/7EuVwa9fodWUfXAlXZLZQ==",
             "cpu": [
                 "x64"
             ],
@@ -950,9 +1008,10 @@
             }
         },
         "node_modules/@types/estree": {
-            "version": "1.0.6",
-            "dev": true,
-            "license": "MIT"
+            "version": "1.0.7",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz",
+            "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==",
+            "dev": true
         },
         "node_modules/@types/node": {
             "version": "22.9.0",
@@ -1109,41 +1168,43 @@
             }
         },
         "node_modules/esbuild": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
-            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.3.tgz",
+            "integrity": "sha512-qKA6Pvai73+M2FtftpNKRxJ78GIjmFXFxd/1DVBqGo/qNhLSfv+G12n9pNoWdytJC8U00TrViOwpjT0zgqQS8Q==",
             "dev": true,
             "hasInstallScript": true,
             "bin": {
                 "esbuild": "bin/esbuild"
             },
             "engines": {
-                "node": ">=12"
+                "node": ">=18"
             },
             "optionalDependencies": {
-                "@esbuild/aix-ppc64": "0.21.5",
-                "@esbuild/android-arm": "0.21.5",
-                "@esbuild/android-arm64": "0.21.5",
-                "@esbuild/android-x64": "0.21.5",
-                "@esbuild/darwin-arm64": "0.21.5",
-                "@esbuild/darwin-x64": "0.21.5",
-                "@esbuild/freebsd-arm64": "0.21.5",
-                "@esbuild/freebsd-x64": "0.21.5",
-                "@esbuild/linux-arm": "0.21.5",
-                "@esbuild/linux-arm64": "0.21.5",
-                "@esbuild/linux-ia32": "0.21.5",
-                "@esbuild/linux-loong64": "0.21.5",
-                "@esbuild/linux-mips64el": "0.21.5",
-                "@esbuild/linux-ppc64": "0.21.5",
-                "@esbuild/linux-riscv64": "0.21.5",
-                "@esbuild/linux-s390x": "0.21.5",
-                "@esbuild/linux-x64": "0.21.5",
-                "@esbuild/netbsd-x64": "0.21.5",
-                "@esbuild/openbsd-x64": "0.21.5",
-                "@esbuild/sunos-x64": "0.21.5",
-                "@esbuild/win32-arm64": "0.21.5",
-                "@esbuild/win32-ia32": "0.21.5",
-                "@esbuild/win32-x64": "0.21.5"
+                "@esbuild/aix-ppc64": "0.25.3",
+                "@esbuild/android-arm": "0.25.3",
+                "@esbuild/android-arm64": "0.25.3",
+                "@esbuild/android-x64": "0.25.3",
+                "@esbuild/darwin-arm64": "0.25.3",
+                "@esbuild/darwin-x64": "0.25.3",
+                "@esbuild/freebsd-arm64": "0.25.3",
+                "@esbuild/freebsd-x64": "0.25.3",
+                "@esbuild/linux-arm": "0.25.3",
+                "@esbuild/linux-arm64": "0.25.3",
+                "@esbuild/linux-ia32": "0.25.3",
+                "@esbuild/linux-loong64": "0.25.3",
+                "@esbuild/linux-mips64el": "0.25.3",
+                "@esbuild/linux-ppc64": "0.25.3",
+                "@esbuild/linux-riscv64": "0.25.3",
+                "@esbuild/linux-s390x": "0.25.3",
+                "@esbuild/linux-x64": "0.25.3",
+                "@esbuild/netbsd-arm64": "0.25.3",
+                "@esbuild/netbsd-x64": "0.25.3",
+                "@esbuild/openbsd-arm64": "0.25.3",
+                "@esbuild/openbsd-x64": "0.25.3",
+                "@esbuild/sunos-x64": "0.25.3",
+                "@esbuild/win32-arm64": "0.25.3",
+                "@esbuild/win32-ia32": "0.25.3",
+                "@esbuild/win32-x64": "0.25.3"
             }
         },
         "node_modules/escalade": {
@@ -1154,6 +1215,20 @@
                 "node": ">=6"
             }
         },
+        "node_modules/fdir": {
+            "version": "6.4.4",
+            "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.4.4.tgz",
+            "integrity": "sha512-1NZP+GK4GfuAv3PqKvxQRDMjdSRZjnkq7KfhlNrCNNlZ0ygQFpebfrnfnq/W7fpUnAv9aGWmY1zKx7FYL3gwhg==",
+            "dev": true,
+            "peerDependencies": {
+                "picomatch": "^3 || ^4"
+            },
+            "peerDependenciesMeta": {
+                "picomatch": {
+                    "optional": true
+                }
+            }
+        },
         "node_modules/fraction.js": {
             "version": "4.3.7",
             "dev": true,
@@ -1188,8 +1263,9 @@
         },
         "node_modules/hydefront": {
             "version": "3.4.1",
-            "dev": true,
-            "license": "MIT"
+            "resolved": "https://registry.npmjs.org/hydefront/-/hydefront-3.4.1.tgz",
+            "integrity": "sha512-CoLVeM0IfGxPLk8PVCKUN4v/SuvY8CIELOTQ1LE4IkvEHTKqgddOatuCbL8HQUMW6L/RcBEBZ766xSfoi3lkiA==",
+            "dev": true
         },
         "node_modules/jiti": {
             "version": "2.4.2",
@@ -1444,7 +1520,9 @@
             "license": "MIT"
         },
         "node_modules/nanoid": {
-            "version": "3.3.7",
+            "version": "3.3.11",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+            "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
             "dev": true,
             "funding": [
                 {
@@ -1452,7 +1530,6 @@
                     "url": "https://github.com/sponsors/ai"
                 }
             ],
-            "license": "MIT",
             "bin": {
                 "nanoid": "bin/nanoid.cjs"
             },
@@ -1478,10 +1555,22 @@
             "dev": true,
             "license": "ISC"
         },
+        "node_modules/picomatch": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz",
+            "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==",
+            "dev": true,
+            "engines": {
+                "node": ">=12"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/jonschlinkert"
+            }
+        },
         "node_modules/postcss": {
-            "version": "8.4.49",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz",
-            "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==",
+            "version": "8.5.3",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.3.tgz",
+            "integrity": "sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A==",
             "dev": true,
             "funding": [
                 {
@@ -1498,7 +1587,7 @@
                 }
             ],
             "dependencies": {
-                "nanoid": "^3.3.7",
+                "nanoid": "^3.3.8",
                 "picocolors": "^1.1.1",
                 "source-map-js": "^1.2.1"
             },
@@ -1538,12 +1627,12 @@
             }
         },
         "node_modules/rollup": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
-            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.40.0.tgz",
+            "integrity": "sha512-Noe455xmA96nnqH5piFtLobsGbCij7Tu+tb3c1vYjNbTkfzGqXqQXG3wJaYXkRZuQ0vEYN4bhwg7QnIrqB5B+w==",
             "dev": true,
             "dependencies": {
-                "@types/estree": "1.0.6"
+                "@types/estree": "1.0.7"
             },
             "bin": {
                 "rollup": "dist/bin/rollup"
@@ -1553,24 +1642,26 @@
                 "npm": ">=8.0.0"
             },
             "optionalDependencies": {
-                "@rollup/rollup-android-arm-eabi": "4.25.0",
-                "@rollup/rollup-android-arm64": "4.25.0",
-                "@rollup/rollup-darwin-arm64": "4.25.0",
-                "@rollup/rollup-darwin-x64": "4.25.0",
-                "@rollup/rollup-freebsd-arm64": "4.25.0",
-                "@rollup/rollup-freebsd-x64": "4.25.0",
-                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
-                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
-                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
-                "@rollup/rollup-linux-arm64-musl": "4.25.0",
-                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
-                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
-                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-musl": "4.25.0",
-                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
-                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
-                "@rollup/rollup-win32-x64-msvc": "4.25.0",
+                "@rollup/rollup-android-arm-eabi": "4.40.0",
+                "@rollup/rollup-android-arm64": "4.40.0",
+                "@rollup/rollup-darwin-arm64": "4.40.0",
+                "@rollup/rollup-darwin-x64": "4.40.0",
+                "@rollup/rollup-freebsd-arm64": "4.40.0",
+                "@rollup/rollup-freebsd-x64": "4.40.0",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.40.0",
+                "@rollup/rollup-linux-arm-musleabihf": "4.40.0",
+                "@rollup/rollup-linux-arm64-gnu": "4.40.0",
+                "@rollup/rollup-linux-arm64-musl": "4.40.0",
+                "@rollup/rollup-linux-loongarch64-gnu": "4.40.0",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.40.0",
+                "@rollup/rollup-linux-riscv64-gnu": "4.40.0",
+                "@rollup/rollup-linux-riscv64-musl": "4.40.0",
+                "@rollup/rollup-linux-s390x-gnu": "4.40.0",
+                "@rollup/rollup-linux-x64-gnu": "4.40.0",
+                "@rollup/rollup-linux-x64-musl": "4.40.0",
+                "@rollup/rollup-win32-arm64-msvc": "4.40.0",
+                "@rollup/rollup-win32-ia32-msvc": "4.40.0",
+                "@rollup/rollup-win32-x64-msvc": "4.40.0",
                 "fsevents": "~2.3.2"
             }
         },
@@ -1644,6 +1735,22 @@
             "optional": true,
             "peer": true
         },
+        "node_modules/tinyglobby": {
+            "version": "0.2.13",
+            "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.13.tgz",
+            "integrity": "sha512-mEwzpUgrLySlveBwEVDMKk5B57bhLPYovRfPAXD5gA/98Opn0rCDj3GtLwFvCvH5RK9uPCExUROW5NjDwvqkxw==",
+            "dev": true,
+            "dependencies": {
+                "fdir": "^6.4.4",
+                "picomatch": "^4.0.2"
+            },
+            "engines": {
+                "node": ">=12.0.0"
+            },
+            "funding": {
+                "url": "https://github.com/sponsors/SuperchupuDev"
+            }
+        },
         "node_modules/undici-types": {
             "version": "6.19.8",
             "dev": true,
@@ -1686,20 +1793,23 @@
             "license": "MIT"
         },
         "node_modules/vite": {
-            "version": "5.4.10",
-            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.10.tgz",
-            "integrity": "sha512-1hvaPshuPUtxeQ0hsVH3Mud0ZanOLwVTneA1EgbAM5LhaZEqyPWGRQ7BtaMvUrTDeEaC8pxtj6a6jku3x4z6SQ==",
+            "version": "6.3.3",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-6.3.3.tgz",
+            "integrity": "sha512-5nXH+QsELbFKhsEfWLkHrvgRpTdGJzqOZ+utSdmPTvwHmvU6ITTm3xx+mRusihkcI8GeC7lCDyn3kDtiki9scw==",
             "dev": true,
             "dependencies": {
-                "esbuild": "^0.21.3",
-                "postcss": "^8.4.43",
-                "rollup": "^4.20.0"
+                "esbuild": "^0.25.0",
+                "fdir": "^6.4.4",
+                "picomatch": "^4.0.2",
+                "postcss": "^8.5.3",
+                "rollup": "^4.34.9",
+                "tinyglobby": "^0.2.13"
             },
             "bin": {
                 "vite": "bin/vite.js"
             },
             "engines": {
-                "node": "^18.0.0 || >=20.0.0"
+                "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
             },
             "funding": {
                 "url": "https://github.com/vitejs/vite?sponsor=1"
@@ -1708,19 +1818,25 @@
                 "fsevents": "~2.3.3"
             },
             "peerDependencies": {
-                "@types/node": "^18.0.0 || >=20.0.0",
+                "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0",
+                "jiti": ">=1.21.0",
                 "less": "*",
                 "lightningcss": "^1.21.0",
                 "sass": "*",
                 "sass-embedded": "*",
                 "stylus": "*",
                 "sugarss": "*",
-                "terser": "^5.4.0"
+                "terser": "^5.16.0",
+                "tsx": "^4.8.1",
+                "yaml": "^2.4.2"
             },
             "peerDependenciesMeta": {
                 "@types/node": {
                     "optional": true
                 },
+                "jiti": {
+                    "optional": true
+                },
                 "less": {
                     "optional": true
                 },
@@ -1741,169 +1857,189 @@
                 },
                 "terser": {
                     "optional": true
+                },
+                "tsx": {
+                    "optional": true
+                },
+                "yaml": {
+                    "optional": true
                 }
             }
         }
     },
     "dependencies": {
         "@esbuild/aix-ppc64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.21.5.tgz",
-            "integrity": "sha512-1SDgH6ZSPTlggy1yI6+Dbkiz8xzpHJEVAlF/AM1tHPLsf5STom9rwtjE4hKAF20FfXXNTFqEYXyJNWh1GiZedQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.3.tgz",
+            "integrity": "sha512-W8bFfPA8DowP8l//sxjJLSLkD8iEjMc7cBVyP+u4cEv9sM7mdUCkgsj+t0n/BWPFtv7WWCN5Yzj0N6FJNUUqBQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/android-arm": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.21.5.tgz",
-            "integrity": "sha512-vCPvzSjpPHEi1siZdlvAlsPxXl7WbOVUBBAowWug4rJHb68Ox8KualB+1ocNvT5fjv6wpkX6o/iEpbDrf68zcg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.3.tgz",
+            "integrity": "sha512-PuwVXbnP87Tcff5I9ngV0lmiSu40xw1At6i3GsU77U7cjDDB4s0X2cyFuBiDa1SBk9DnvWwnGvVaGBqoFWPb7A==",
             "dev": true,
             "optional": true
         },
         "@esbuild/android-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.21.5.tgz",
-            "integrity": "sha512-c0uX9VAUBQ7dTDCjq+wdyGLowMdtR/GoC2U5IYk/7D1H1JYC0qseD7+11iMP2mRLN9RcCMRcjC4YMclCzGwS/A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.3.tgz",
+            "integrity": "sha512-XelR6MzjlZuBM4f5z2IQHK6LkK34Cvv6Rj2EntER3lwCBFdg6h2lKbtRjpTTsdEjD/WSe1q8UyPBXP1x3i/wYQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/android-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.21.5.tgz",
-            "integrity": "sha512-D7aPRUUNHRBwHxzxRvp856rjUHRFW1SdQATKXH2hqA0kAZb1hKmi02OpYRacl0TxIGz/ZmXWlbZgjwWYaCakTA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.3.tgz",
+            "integrity": "sha512-ogtTpYHT/g1GWS/zKM0cc/tIebFjm1F9Aw1boQ2Y0eUQ+J89d0jFY//s9ei9jVIlkYi8AfOjiixcLJSGNSOAdQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/darwin-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.21.5.tgz",
-            "integrity": "sha512-DwqXqZyuk5AiWWf3UfLiRDJ5EDd49zg6O9wclZ7kUMv2WRFr4HKjXp/5t8JZ11QbQfUS6/cRCKGwYhtNAY88kQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.3.tgz",
+            "integrity": "sha512-eESK5yfPNTqpAmDfFWNsOhmIOaQA59tAcF/EfYvo5/QWQCzXn5iUSOnqt3ra3UdzBv073ykTtmeLJZGt3HhA+w==",
             "dev": true,
             "optional": true
         },
         "@esbuild/darwin-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.21.5.tgz",
-            "integrity": "sha512-se/JjF8NlmKVG4kNIuyWMV/22ZaerB+qaSi5MdrXtd6R08kvs2qCN4C09miupktDitvh8jRFflwGFBQcxZRjbw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.3.tgz",
+            "integrity": "sha512-Kd8glo7sIZtwOLcPbW0yLpKmBNWMANZhrC1r6K++uDR2zyzb6AeOYtI6udbtabmQpFaxJ8uduXMAo1gs5ozz8A==",
             "dev": true,
             "optional": true
         },
         "@esbuild/freebsd-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.21.5.tgz",
-            "integrity": "sha512-5JcRxxRDUJLX8JXp/wcBCy3pENnCgBR9bN6JsY4OmhfUtIHe3ZW0mawA7+RDAcMLrMIZaf03NlQiX9DGyB8h4g==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-EJiyS70BYybOBpJth3M0KLOus0n+RRMKTYzhYhFeMwp7e/RaajXvP+BWlmEXNk6uk+KAu46j/kaQzr6au+JcIw==",
             "dev": true,
             "optional": true
         },
         "@esbuild/freebsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.21.5.tgz",
-            "integrity": "sha512-J95kNBj1zkbMXtHVH29bBriQygMXqoVQOQYA+ISs0/2l3T9/kj42ow2mpqerRBxDJnmkUDCaQT/dfNXWX/ZZCQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.3.tgz",
+            "integrity": "sha512-Q+wSjaLpGxYf7zC0kL0nDlhsfuFkoN+EXrx2KSB33RhinWzejOd6AvgmP5JbkgXKmjhmpfgKZq24pneodYqE8Q==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-arm": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.21.5.tgz",
-            "integrity": "sha512-bPb5AHZtbeNGjCKVZ9UGqGwo8EUu4cLq68E95A53KlxAPRmUyYv2D6F0uUI65XisGOL1hBP5mTronbgo+0bFcA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.3.tgz",
+            "integrity": "sha512-dUOVmAUzuHy2ZOKIHIKHCm58HKzFqd+puLaS424h6I85GlSDRZIA5ycBixb3mFgM0Jdh+ZOSB6KptX30DD8YOQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.21.5.tgz",
-            "integrity": "sha512-ibKvmyYzKsBeX8d8I7MH/TMfWDXBF3db4qM6sy+7re0YXya+K1cem3on9XgdT2EQGMu4hQyZhan7TeQ8XkGp4Q==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.3.tgz",
+            "integrity": "sha512-xCUgnNYhRD5bb1C1nqrDV1PfkwgbswTTBRbAd8aH5PhYzikdf/ddtsYyMXFfGSsb/6t6QaPSzxtbfAZr9uox4A==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-ia32": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.21.5.tgz",
-            "integrity": "sha512-YvjXDqLRqPDl2dvRODYmmhz4rPeVKYvppfGYKSNGdyZkA01046pLWyRKKI3ax8fbJoK5QbxblURkwK/MWY18Tg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.3.tgz",
+            "integrity": "sha512-yplPOpczHOO4jTYKmuYuANI3WhvIPSVANGcNUeMlxH4twz/TeXuzEP41tGKNGWJjuMhotpGabeFYGAOU2ummBw==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-loong64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.21.5.tgz",
-            "integrity": "sha512-uHf1BmMG8qEvzdrzAqg2SIG/02+4/DHB6a9Kbya0XDvwDEKCoC8ZRWI5JJvNdUjtciBGFQ5PuBlpEOXQj+JQSg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.3.tgz",
+            "integrity": "sha512-P4BLP5/fjyihmXCELRGrLd793q/lBtKMQl8ARGpDxgzgIKJDRJ/u4r1A/HgpBpKpKZelGct2PGI4T+axcedf6g==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-mips64el": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.21.5.tgz",
-            "integrity": "sha512-IajOmO+KJK23bj52dFSNCMsz1QP1DqM6cwLUv3W1QwyxkyIWecfafnI555fvSGqEKwjMXVLokcV5ygHW5b3Jbg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.3.tgz",
+            "integrity": "sha512-eRAOV2ODpu6P5divMEMa26RRqb2yUoYsuQQOuFUexUoQndm4MdpXXDBbUoKIc0iPa4aCO7gIhtnYomkn2x+bag==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-ppc64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.21.5.tgz",
-            "integrity": "sha512-1hHV/Z4OEfMwpLO8rp7CvlhBDnjsC3CttJXIhBi+5Aj5r+MBvy4egg7wCbe//hSsT+RvDAG7s81tAvpL2XAE4w==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.3.tgz",
+            "integrity": "sha512-ZC4jV2p7VbzTlnl8nZKLcBkfzIf4Yad1SJM4ZMKYnJqZFD4rTI+pBG65u8ev4jk3/MPwY9DvGn50wi3uhdaghg==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-riscv64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.21.5.tgz",
-            "integrity": "sha512-2HdXDMd9GMgTGrPWnJzP2ALSokE/0O5HhTUvWIbD3YdjME8JwvSCnNGBnTThKGEB91OZhzrJ4qIIxk/SBmyDDA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.3.tgz",
+            "integrity": "sha512-LDDODcFzNtECTrUUbVCs6j9/bDVqy7DDRsuIXJg6so+mFksgwG7ZVnTruYi5V+z3eE5y+BJZw7VvUadkbfg7QA==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-s390x": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.21.5.tgz",
-            "integrity": "sha512-zus5sxzqBJD3eXxwvjN1yQkRepANgxE9lgOW2qLnmr8ikMTphkjgXu1HR01K4FJg8h1kEEDAqDcZQtbrRnB41A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.3.tgz",
+            "integrity": "sha512-s+w/NOY2k0yC2p9SLen+ymflgcpRkvwwa02fqmAwhBRI3SC12uiS10edHHXlVWwfAagYSY5UpmT/zISXPMW3tQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/linux-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.21.5.tgz",
-            "integrity": "sha512-1rYdTpyv03iycF1+BhzrzQJCdOuAOtaqHTWJZCWvijKD2N5Xu0TtVC8/+1faWqcP9iBCWOmjmhoH94dH82BxPQ==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.3.tgz",
+            "integrity": "sha512-nQHDz4pXjSDC6UfOE1Fw9Q8d6GCAd9KdvMZpfVGWSJztYCarRgSDfOVBY5xwhQXseiyxapkiSJi/5/ja8mRFFA==",
+            "dev": true,
+            "optional": true
+        },
+        "@esbuild/netbsd-arm64": {
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-1QaLtOWq0mzK6tzzp0jRN3eccmN3hezey7mhLnzC6oNlJoUJz4nym5ZD7mDnS/LZQgkrhEbEiTn515lPeLpgWA==",
             "dev": true,
             "optional": true
         },
         "@esbuild/netbsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.21.5.tgz",
-            "integrity": "sha512-Woi2MXzXjMULccIwMnLciyZH4nCIMpWQAs049KEeMvOcNADVxo0UBIQPfSmxB3CWKedngg7sWZdLvLczpe0tLg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.3.tgz",
+            "integrity": "sha512-i5Hm68HXHdgv8wkrt+10Bc50zM0/eonPb/a/OFVfB6Qvpiirco5gBA5bz7S2SHuU+Y4LWn/zehzNX14Sp4r27g==",
+            "dev": true,
+            "optional": true
+        },
+        "@esbuild/openbsd-arm64": {
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.3.tgz",
+            "integrity": "sha512-zGAVApJEYTbOC6H/3QBr2mq3upG/LBEXr85/pTtKiv2IXcgKV0RT0QA/hSXZqSvLEpXeIxah7LczB4lkiYhTAQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/openbsd-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.21.5.tgz",
-            "integrity": "sha512-HLNNw99xsvx12lFBUwoT8EVCsSvRNDVxNpjZ7bPn947b8gJPzeHWyNVhFsaerc0n3TsbOINvRP2byTZ5LKezow==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.3.tgz",
+            "integrity": "sha512-fpqctI45NnCIDKBH5AXQBsD0NDPbEFczK98hk/aa6HJxbl+UtLkJV2+Bvy5hLSLk3LHmqt0NTkKNso1A9y1a4w==",
             "dev": true,
             "optional": true
         },
         "@esbuild/sunos-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.21.5.tgz",
-            "integrity": "sha512-6+gjmFpfy0BHU5Tpptkuh8+uw3mnrvgs+dSPQXQOv3ekbordwnzTVEb4qnIvQcYXq6gzkyTnoZ9dZG+D4garKg==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.3.tgz",
+            "integrity": "sha512-ROJhm7d8bk9dMCUZjkS8fgzsPAZEjtRJqCAmVgB0gMrvG7hfmPmz9k1rwO4jSiblFjYmNvbECL9uhaPzONMfgA==",
             "dev": true,
             "optional": true
         },
         "@esbuild/win32-arm64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.21.5.tgz",
-            "integrity": "sha512-Z0gOTd75VvXqyq7nsl93zwahcTROgqvuAcYDUr+vOv8uHhNSKROyU961kgtCD1e95IqPKSQKH7tBTslnS3tA8A==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.3.tgz",
+            "integrity": "sha512-YWcow8peiHpNBiIXHwaswPnAXLsLVygFwCB3A7Bh5jRkIBFWHGmNQ48AlX4xDvQNoMZlPYzjVOQDYEzWCqufMQ==",
             "dev": true,
             "optional": true
         },
         "@esbuild/win32-ia32": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.21.5.tgz",
-            "integrity": "sha512-SWXFF1CL2RVNMaVs+BBClwtfZSvDgtL//G/smwAc5oVK/UPu2Gu9tIaRgFmYFFKrmg3SyAjSrElf0TiJ1v8fYA==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.3.tgz",
+            "integrity": "sha512-qspTZOIGoXVS4DpNqUYUs9UxVb04khS1Degaw/MnfMe7goQ3lTfQ13Vw4qY/Nj0979BGvMRpAYbs/BAxEvU8ew==",
             "dev": true,
             "optional": true
         },
         "@esbuild/win32-x64": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.21.5.tgz",
-            "integrity": "sha512-tQd/1efJuzPC6rCFwEvLtci/xNFcTZknmXs98FYDfGE4wP9ClFV98nyKrzJKVPMhdDnjzLhdUyMX4PsQAPjwIw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.3.tgz",
+            "integrity": "sha512-ICgUR+kPimx0vvRzf+N/7L7tVSQeE3BYY+NhHRHXS1kBuPO7z2+7ea2HbhDyZdTephgvNvKrlDDKUexuCVBVvg==",
             "dev": true,
             "optional": true
         },
@@ -1957,128 +2093,142 @@
             }
         },
         "@rollup/rollup-android-arm-eabi": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.25.0.tgz",
-            "integrity": "sha512-CC/ZqFZwlAIbU1wUPisHyV/XRc5RydFrNLtgl3dGYskdwPZdt4HERtKm50a/+DtTlKeCq9IXFEWR+P6blwjqBA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.40.0.tgz",
+            "integrity": "sha512-+Fbls/diZ0RDerhE8kyC6hjADCXA1K4yVNlH0EYfd2XjyH0UGgzaQ8MlT0pCXAThfxv3QUAczHaL+qSv1E4/Cg==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-android-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.25.0.tgz",
-            "integrity": "sha512-/Y76tmLGUJqVBXXCfVS8Q8FJqYGhgH4wl4qTA24E9v/IJM0XvJCGQVSW1QZ4J+VURO9h8YCa28sTFacZXwK7Rg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.40.0.tgz",
+            "integrity": "sha512-PPA6aEEsTPRz+/4xxAmaoWDqh67N7wFbgFUJGMnanCFs0TV99M0M8QhhaSCks+n6EbQoFvLQgYOGXxlMGQe/6w==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-darwin-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.25.0.tgz",
-            "integrity": "sha512-YVT6L3UrKTlC0FpCZd0MGA7NVdp7YNaEqkENbWQ7AOVOqd/7VzyHpgIpc1mIaxRAo1ZsJRH45fq8j4N63I/vvg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.40.0.tgz",
+            "integrity": "sha512-GwYOcOakYHdfnjjKwqpTGgn5a6cUX7+Ra2HeNj/GdXvO2VJOOXCiYYlRFU4CubFM67EhbmzLOmACKEfvp3J1kQ==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-darwin-x64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.25.0.tgz",
-            "integrity": "sha512-ZRL+gexs3+ZmmWmGKEU43Bdn67kWnMeWXLFhcVv5Un8FQcx38yulHBA7XR2+KQdYIOtD0yZDWBCudmfj6lQJoA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.40.0.tgz",
+            "integrity": "sha512-CoLEGJ+2eheqD9KBSxmma6ld01czS52Iw0e2qMZNpPDlf7Z9mj8xmMemxEucinev4LgHalDPczMyxzbq+Q+EtA==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-freebsd-arm64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.25.0.tgz",
-            "integrity": "sha512-xpEIXhiP27EAylEpreCozozsxWQ2TJbOLSivGfXhU4G1TBVEYtUPi2pOZBnvGXHyOdLAUUhPnJzH3ah5cqF01g==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.40.0.tgz",
+            "integrity": "sha512-r7yGiS4HN/kibvESzmrOB/PxKMhPTlz+FcGvoUIKYoTyGd5toHp48g1uZy1o1xQvybwwpqpe010JrcGG2s5nkg==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-freebsd-x64": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.25.0.tgz",
-            "integrity": "sha512-sC5FsmZGlJv5dOcURrsnIK7ngc3Kirnx3as2XU9uER+zjfyqIjdcMVgzy4cOawhsssqzoAX19qmxgJ8a14Qrqw==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.40.0.tgz",
+            "integrity": "sha512-mVDxzlf0oLzV3oZOr0SMJ0lSDd3xC4CmnWJ8Val8isp9jRGl5Dq//LLDSPFrasS7pSm6m5xAcKaw3sHXhBjoRw==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-arm-gnueabihf": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.25.0.tgz",
-            "integrity": "sha512-uD/dbLSs1BEPzg564TpRAQ/YvTnCds2XxyOndAO8nJhaQcqQGFgv/DAVko/ZHap3boCvxnzYMa3mTkV/B/3SWA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.40.0.tgz",
+            "integrity": "sha512-y/qUMOpJxBMy8xCXD++jeu8t7kzjlOCkoxxajL58G62PJGBZVl/Gwpm7JK9+YvlB701rcQTzjUZ1JgUoPTnoQA==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-arm-musleabihf": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.25.0.tgz",
-            "integrity": "sha512-ZVt/XkrDlQWegDWrwyC3l0OfAF7yeJUF4fq5RMS07YM72BlSfn2fQQ6lPyBNjt+YbczMguPiJoCfaQC2dnflpQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.40.0.tgz",
+            "integrity": "sha512-GoCsPibtVdJFPv/BOIvBKO/XmwZLwaNWdyD8TKlXuqp0veo2sHE+A/vpMQ5iSArRUz/uaoj4h5S6Pn0+PdhRjg==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-arm64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.25.0.tgz",
-            "integrity": "sha512-qboZ+T0gHAW2kkSDPHxu7quaFaaBlynODXpBVnPxUgvWYaE84xgCKAPEYE+fSMd3Zv5PyFZR+L0tCdYCMAtG0A==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.40.0.tgz",
+            "integrity": "sha512-L5ZLphTjjAD9leJzSLI7rr8fNqJMlGDKlazW2tX4IUF9P7R5TMQPElpH82Q7eNIDQnQlAyiNVfRPfP2vM5Avvg==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-arm64-musl": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.25.0.tgz",
-            "integrity": "sha512-ndWTSEmAaKr88dBuogGH2NZaxe7u2rDoArsejNslugHZ+r44NfWiwjzizVS1nUOHo+n1Z6qV3X60rqE/HlISgw==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.40.0.tgz",
+            "integrity": "sha512-ATZvCRGCDtv1Y4gpDIXsS+wfFeFuLwVxyUBSLawjgXK2tRE6fnsQEkE4csQQYWlBlsFztRzCnBvWVfcae/1qxQ==",
+            "dev": true,
+            "optional": true
+        },
+        "@rollup/rollup-linux-loongarch64-gnu": {
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.40.0.tgz",
+            "integrity": "sha512-wG9e2XtIhd++QugU5MD9i7OnpaVb08ji3P1y/hNbxrQ3sYEelKJOq1UJ5dXczeo6Hj2rfDEL5GdtkMSVLa/AOg==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-powerpc64le-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.25.0.tgz",
-            "integrity": "sha512-BVSQvVa2v5hKwJSy6X7W1fjDex6yZnNKy3Kx1JGimccHft6HV0THTwNtC2zawtNXKUu+S5CjXslilYdKBAadzA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.40.0.tgz",
+            "integrity": "sha512-vgXfWmj0f3jAUvC7TZSU/m/cOE558ILWDzS7jBhiCAFpY2WEBn5jqgbqvmzlMjtp8KlLcBlXVD2mkTSEQE6Ixw==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-riscv64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.25.0.tgz",
-            "integrity": "sha512-G4hTREQrIdeV0PE2JruzI+vXdRnaK1pg64hemHq2v5fhv8C7WjVaeXc9P5i4Q5UC06d/L+zA0mszYIKl+wY8oA==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.40.0.tgz",
+            "integrity": "sha512-uJkYTugqtPZBS3Z136arevt/FsKTF/J9dEMTX/cwR7lsAW4bShzI2R0pJVw+hcBTWF4dxVckYh72Hk3/hWNKvA==",
+            "dev": true,
+            "optional": true
+        },
+        "@rollup/rollup-linux-riscv64-musl": {
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.40.0.tgz",
+            "integrity": "sha512-rKmSj6EXQRnhSkE22+WvrqOqRtk733x3p5sWpZilhmjnkHkpeCgWsFFo0dGnUGeA+OZjRl3+VYq+HyCOEuwcxQ==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-s390x-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.25.0.tgz",
-            "integrity": "sha512-9T/w0kQ+upxdkFL9zPVB6zy9vWW1deA3g8IauJxojN4bnz5FwSsUAD034KpXIVX5j5p/rn6XqumBMxfRkcHapQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.40.0.tgz",
+            "integrity": "sha512-SpnYlAfKPOoVsQqmTFJ0usx0z84bzGOS9anAC0AZ3rdSo3snecihbhFTlJZ8XMwzqAcodjFU4+/SM311dqE5Sw==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-x64-gnu": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.25.0.tgz",
-            "integrity": "sha512-ThcnU0EcMDn+J4B9LD++OgBYxZusuA7iemIIiz5yzEcFg04VZFzdFjuwPdlURmYPZw+fgVrFzj4CA64jSTG4Ig==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.40.0.tgz",
+            "integrity": "sha512-RcDGMtqF9EFN8i2RYN2W+64CdHruJ5rPqrlYw+cgM3uOVPSsnAQps7cpjXe9be/yDp8UC7VLoCoKC8J3Kn2FkQ==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-linux-x64-musl": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.25.0.tgz",
-            "integrity": "sha512-zx71aY2oQxGxAT1JShfhNG79PnjYhMC6voAjzpu/xmMjDnKNf6Nl/xv7YaB/9SIa9jDYf8RBPWEnjcdlhlv1rQ==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.40.0.tgz",
+            "integrity": "sha512-HZvjpiUmSNx5zFgwtQAV1GaGazT2RWvqeDi0hV+AtC8unqqDSsaFjPxfsO6qPtKRRg25SisACWnJ37Yio8ttaw==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-win32-arm64-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.25.0.tgz",
-            "integrity": "sha512-JT8tcjNocMs4CylWY/CxVLnv8e1lE7ff1fi6kbGocWwxDq9pj30IJ28Peb+Y8yiPNSF28oad42ApJB8oUkwGww==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.40.0.tgz",
+            "integrity": "sha512-UtZQQI5k/b8d7d3i9AZmA/t+Q4tk3hOC0tMOMSq2GlMYOfxbesxG4mJSeDp0EHs30N9bsfwUvs3zF4v/RzOeTQ==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-win32-ia32-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.25.0.tgz",
-            "integrity": "sha512-dRLjLsO3dNOfSN6tjyVlG+Msm4IiZnGkuZ7G5NmpzwF9oOc582FZG05+UdfTbz5Jd4buK/wMb6UeHFhG18+OEg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.40.0.tgz",
+            "integrity": "sha512-+m03kvI2f5syIqHXCZLPVYplP8pQch9JHyXKZ3AGMKlg8dCyr2PKHjwRLiW53LTrN/Nc3EqHOKxUxzoSPdKddA==",
             "dev": true,
             "optional": true
         },
         "@rollup/rollup-win32-x64-msvc": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.25.0.tgz",
-            "integrity": "sha512-/RqrIFtLB926frMhZD0a5oDa4eFIbyNEwLLloMTEjmqfwZWXywwVVOVmwTsuyhC9HKkVEZcOOi+KV4U9wmOdlg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.40.0.tgz",
+            "integrity": "sha512-lpPE1cLfP5oPzVjKMx10pgBmKELQnFJXHgvtHCtuJWOv8MxqdEIMNtgHgBFf7Ea2/7EuVwa9fodWUfXAlXZLZQ==",
             "dev": true,
             "optional": true
         },
@@ -2228,7 +2378,9 @@
             }
         },
         "@types/estree": {
-            "version": "1.0.6",
+            "version": "1.0.7",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz",
+            "integrity": "sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==",
             "dev": true
         },
         "@types/node": {
@@ -2303,40 +2455,49 @@
             }
         },
         "esbuild": {
-            "version": "0.21.5",
-            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.21.5.tgz",
-            "integrity": "sha512-mg3OPMV4hXywwpoDxu3Qda5xCKQi+vCTZq8S9J/EpkhB2HzKXq4SNFZE3+NK93JYxc8VMSep+lOUSC/RVKaBqw==",
+            "version": "0.25.3",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.3.tgz",
+            "integrity": "sha512-qKA6Pvai73+M2FtftpNKRxJ78GIjmFXFxd/1DVBqGo/qNhLSfv+G12n9pNoWdytJC8U00TrViOwpjT0zgqQS8Q==",
             "dev": true,
             "requires": {
-                "@esbuild/aix-ppc64": "0.21.5",
-                "@esbuild/android-arm": "0.21.5",
-                "@esbuild/android-arm64": "0.21.5",
-                "@esbuild/android-x64": "0.21.5",
-                "@esbuild/darwin-arm64": "0.21.5",
-                "@esbuild/darwin-x64": "0.21.5",
-                "@esbuild/freebsd-arm64": "0.21.5",
-                "@esbuild/freebsd-x64": "0.21.5",
-                "@esbuild/linux-arm": "0.21.5",
-                "@esbuild/linux-arm64": "0.21.5",
-                "@esbuild/linux-ia32": "0.21.5",
-                "@esbuild/linux-loong64": "0.21.5",
-                "@esbuild/linux-mips64el": "0.21.5",
-                "@esbuild/linux-ppc64": "0.21.5",
-                "@esbuild/linux-riscv64": "0.21.5",
-                "@esbuild/linux-s390x": "0.21.5",
-                "@esbuild/linux-x64": "0.21.5",
-                "@esbuild/netbsd-x64": "0.21.5",
-                "@esbuild/openbsd-x64": "0.21.5",
-                "@esbuild/sunos-x64": "0.21.5",
-                "@esbuild/win32-arm64": "0.21.5",
-                "@esbuild/win32-ia32": "0.21.5",
-                "@esbuild/win32-x64": "0.21.5"
+                "@esbuild/aix-ppc64": "0.25.3",
+                "@esbuild/android-arm": "0.25.3",
+                "@esbuild/android-arm64": "0.25.3",
+                "@esbuild/android-x64": "0.25.3",
+                "@esbuild/darwin-arm64": "0.25.3",
+                "@esbuild/darwin-x64": "0.25.3",
+                "@esbuild/freebsd-arm64": "0.25.3",
+                "@esbuild/freebsd-x64": "0.25.3",
+                "@esbuild/linux-arm": "0.25.3",
+                "@esbuild/linux-arm64": "0.25.3",
+                "@esbuild/linux-ia32": "0.25.3",
+                "@esbuild/linux-loong64": "0.25.3",
+                "@esbuild/linux-mips64el": "0.25.3",
+                "@esbuild/linux-ppc64": "0.25.3",
+                "@esbuild/linux-riscv64": "0.25.3",
+                "@esbuild/linux-s390x": "0.25.3",
+                "@esbuild/linux-x64": "0.25.3",
+                "@esbuild/netbsd-arm64": "0.25.3",
+                "@esbuild/netbsd-x64": "0.25.3",
+                "@esbuild/openbsd-arm64": "0.25.3",
+                "@esbuild/openbsd-x64": "0.25.3",
+                "@esbuild/sunos-x64": "0.25.3",
+                "@esbuild/win32-arm64": "0.25.3",
+                "@esbuild/win32-ia32": "0.25.3",
+                "@esbuild/win32-x64": "0.25.3"
             }
         },
         "escalade": {
             "version": "3.2.0",
             "dev": true
         },
+        "fdir": {
+            "version": "6.4.4",
+            "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.4.4.tgz",
+            "integrity": "sha512-1NZP+GK4GfuAv3PqKvxQRDMjdSRZjnkq7KfhlNrCNNlZ0ygQFpebfrnfnq/W7fpUnAv9aGWmY1zKx7FYL3gwhg==",
+            "dev": true,
+            "requires": {}
+        },
         "fraction.js": {
             "version": "4.3.7",
             "dev": true
@@ -2356,6 +2517,8 @@
         },
         "hydefront": {
             "version": "3.4.1",
+            "resolved": "https://registry.npmjs.org/hydefront/-/hydefront-3.4.1.tgz",
+            "integrity": "sha512-CoLVeM0IfGxPLk8PVCKUN4v/SuvY8CIELOTQ1LE4IkvEHTKqgddOatuCbL8HQUMW6L/RcBEBZ766xSfoi3lkiA==",
             "dev": true
         },
         "jiti": {
@@ -2466,7 +2629,9 @@
             "dev": true
         },
         "nanoid": {
-            "version": "3.3.7",
+            "version": "3.3.11",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+            "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
             "dev": true
         },
         "node-releases": {
@@ -2481,13 +2646,19 @@
             "version": "1.1.1",
             "dev": true
         },
+        "picomatch": {
+            "version": "4.0.2",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz",
+            "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==",
+            "dev": true
+        },
         "postcss": {
-            "version": "8.4.49",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz",
-            "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==",
+            "version": "8.5.3",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.3.tgz",
+            "integrity": "sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A==",
             "dev": true,
             "requires": {
-                "nanoid": "^3.3.7",
+                "nanoid": "^3.3.8",
                 "picocolors": "^1.1.1",
                 "source-map-js": "^1.2.1"
             }
@@ -2509,30 +2680,32 @@
             "dev": true
         },
         "rollup": {
-            "version": "4.25.0",
-            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.25.0.tgz",
-            "integrity": "sha512-uVbClXmR6wvx5R1M3Od4utyLUxrmOcEm3pAtMphn73Apq19PDtHpgZoEvqH2YnnaNUuvKmg2DgRd2Sqv+odyqg==",
+            "version": "4.40.0",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.40.0.tgz",
+            "integrity": "sha512-Noe455xmA96nnqH5piFtLobsGbCij7Tu+tb3c1vYjNbTkfzGqXqQXG3wJaYXkRZuQ0vEYN4bhwg7QnIrqB5B+w==",
             "dev": true,
             "requires": {
-                "@rollup/rollup-android-arm-eabi": "4.25.0",
-                "@rollup/rollup-android-arm64": "4.25.0",
-                "@rollup/rollup-darwin-arm64": "4.25.0",
-                "@rollup/rollup-darwin-x64": "4.25.0",
-                "@rollup/rollup-freebsd-arm64": "4.25.0",
-                "@rollup/rollup-freebsd-x64": "4.25.0",
-                "@rollup/rollup-linux-arm-gnueabihf": "4.25.0",
-                "@rollup/rollup-linux-arm-musleabihf": "4.25.0",
-                "@rollup/rollup-linux-arm64-gnu": "4.25.0",
-                "@rollup/rollup-linux-arm64-musl": "4.25.0",
-                "@rollup/rollup-linux-powerpc64le-gnu": "4.25.0",
-                "@rollup/rollup-linux-riscv64-gnu": "4.25.0",
-                "@rollup/rollup-linux-s390x-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-gnu": "4.25.0",
-                "@rollup/rollup-linux-x64-musl": "4.25.0",
-                "@rollup/rollup-win32-arm64-msvc": "4.25.0",
-                "@rollup/rollup-win32-ia32-msvc": "4.25.0",
-                "@rollup/rollup-win32-x64-msvc": "4.25.0",
-                "@types/estree": "1.0.6",
+                "@rollup/rollup-android-arm-eabi": "4.40.0",
+                "@rollup/rollup-android-arm64": "4.40.0",
+                "@rollup/rollup-darwin-arm64": "4.40.0",
+                "@rollup/rollup-darwin-x64": "4.40.0",
+                "@rollup/rollup-freebsd-arm64": "4.40.0",
+                "@rollup/rollup-freebsd-x64": "4.40.0",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.40.0",
+                "@rollup/rollup-linux-arm-musleabihf": "4.40.0",
+                "@rollup/rollup-linux-arm64-gnu": "4.40.0",
+                "@rollup/rollup-linux-arm64-musl": "4.40.0",
+                "@rollup/rollup-linux-loongarch64-gnu": "4.40.0",
+                "@rollup/rollup-linux-powerpc64le-gnu": "4.40.0",
+                "@rollup/rollup-linux-riscv64-gnu": "4.40.0",
+                "@rollup/rollup-linux-riscv64-musl": "4.40.0",
+                "@rollup/rollup-linux-s390x-gnu": "4.40.0",
+                "@rollup/rollup-linux-x64-gnu": "4.40.0",
+                "@rollup/rollup-linux-x64-musl": "4.40.0",
+                "@rollup/rollup-win32-arm64-msvc": "4.40.0",
+                "@rollup/rollup-win32-ia32-msvc": "4.40.0",
+                "@rollup/rollup-win32-x64-msvc": "4.40.0",
+                "@types/estree": "1.0.7",
                 "fsevents": "~2.3.2"
             }
         },
@@ -2588,6 +2761,16 @@
                 }
             }
         },
+        "tinyglobby": {
+            "version": "0.2.13",
+            "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.13.tgz",
+            "integrity": "sha512-mEwzpUgrLySlveBwEVDMKk5B57bhLPYovRfPAXD5gA/98Opn0rCDj3GtLwFvCvH5RK9uPCExUROW5NjDwvqkxw==",
+            "dev": true,
+            "requires": {
+                "fdir": "^6.4.4",
+                "picomatch": "^4.0.2"
+            }
+        },
         "undici-types": {
             "version": "6.19.8",
             "dev": true,
@@ -2607,15 +2790,18 @@
             "dev": true
         },
         "vite": {
-            "version": "5.4.10",
-            "resolved": "https://registry.npmjs.org/vite/-/vite-5.4.10.tgz",
-            "integrity": "sha512-1hvaPshuPUtxeQ0hsVH3Mud0ZanOLwVTneA1EgbAM5LhaZEqyPWGRQ7BtaMvUrTDeEaC8pxtj6a6jku3x4z6SQ==",
+            "version": "6.3.3",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-6.3.3.tgz",
+            "integrity": "sha512-5nXH+QsELbFKhsEfWLkHrvgRpTdGJzqOZ+utSdmPTvwHmvU6ITTm3xx+mRusihkcI8GeC7lCDyn3kDtiki9scw==",
             "dev": true,
             "requires": {
-                "esbuild": "^0.21.3",
+                "esbuild": "^0.25.0",
+                "fdir": "^6.4.4",
                 "fsevents": "~2.3.3",
-                "postcss": "^8.4.43",
-                "rollup": "^4.20.0"
+                "picomatch": "^4.0.2",
+                "postcss": "^8.5.3",
+                "rollup": "^4.34.9",
+                "tinyglobby": "^0.2.13"
             }
         }
     }
diff --git a/package.json b/package.json
index b4f88a28269..3a1a04ca7c4 100644
--- a/package.json
+++ b/package.json
@@ -9,10 +9,10 @@
         "@tailwindcss/typography": "^0.5.15",
         "@tailwindcss/vite": "^4.1.4",
         "autoprefixer": "^10.4.20",
-        "hydefront": "^3.3.0",
+        "hydefront": "^3.4.1",
         "postcss": "^8.4.49",
         "prettier": "3.3.3",
         "tailwindcss": "^4.1.4",
-        "vite": "^5.0.0"
+        "vite": "^6.3.3"
     }
 }
diff --git a/packages/hyde/package.json b/packages/hyde/package.json
index b4f88a28269..3a1a04ca7c4 100644
--- a/packages/hyde/package.json
+++ b/packages/hyde/package.json
@@ -9,10 +9,10 @@
         "@tailwindcss/typography": "^0.5.15",
         "@tailwindcss/vite": "^4.1.4",
         "autoprefixer": "^10.4.20",
-        "hydefront": "^3.3.0",
+        "hydefront": "^3.4.1",
         "postcss": "^8.4.49",
         "prettier": "3.3.3",
         "tailwindcss": "^4.1.4",
-        "vite": "^5.0.0"
+        "vite": "^6.3.3"
     }
 }
diff --git a/packages/vite-plugin/package.json b/packages/vite-plugin/package.json
index b0085cecffb..1872bf6c0db 100644
--- a/packages/vite-plugin/package.json
+++ b/packages/vite-plugin/package.json
@@ -27,11 +27,11 @@
   },
   "homepage": "https://github.com/hydephp/framework/tree/master/packages/vite-plugin",
   "peerDependencies": {
-    "vite": "^4.0.0 || ^5.0.0"
+    "vite": "^6.0.0"
   },
   "devDependencies": {
     "typescript": "^5.0.0",
     "@types/node": "^20.0.0",
-    "vite": "^5.0.0"
+    "vite": "^6.0.0"
   }
 }

From dbf6b8c20d43605269ca9ceccbd87d861760f807 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 16:11:46 +0200
Subject: [PATCH 3998/4023] Update package.json

---
 packages/vite-plugin/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/vite-plugin/package.json b/packages/vite-plugin/package.json
index 1872bf6c0db..38c5870948a 100644
--- a/packages/vite-plugin/package.json
+++ b/packages/vite-plugin/package.json
@@ -1,6 +1,6 @@
 {
   "name": "hyde-vite-plugin",
-  "version": "1.0.0",
+  "version": "0.1.0",
   "description": "HydePHP Vite plugin for realtime compiler integration",
   "type": "module",
   "main": "dist/index.js",

From eb4bab3d25229d43af6c08dbfaa62d6b85e7f6e4 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 16:12:07 +0200
Subject: [PATCH 3999/4023] Remove the experimental navigation menu
 configuration builder

Fixes https://github.com/hydephp/develop/issues/2153 and reverts https://github.com/hydephp/develop/pull/1827
---
 config/hyde.php                               |  37 ++--
 packages/framework/config/hyde.php            |  37 ++--
 packages/framework/src/Facades/Navigation.php |  14 --
 .../NavigationMenuConfigurationBuilder.php    | 128 --------------
 .../AutomaticNavigationConfigurationsTest.php |  50 +-----
 .../Unit/Facades/NavigationFacadeTest.php     |  79 +++------
 ...NavigationMenuConfigurationBuilderTest.php | 162 ------------------
 7 files changed, 77 insertions(+), 430 deletions(-)
 delete mode 100644 packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
 delete mode 100644 packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php

diff --git a/config/hyde.php b/config/hyde.php
index 3a4bdf7b9b8..408ababf05e 100644
--- a/config/hyde.php
+++ b/config/hyde.php
@@ -332,23 +332,40 @@
     |
     */
 
-    'navigation' => Navigation::configure()
-        ->setPagePriorities([
+    'navigation' => [
+        // This configuration sets the priorities used to determine the order of the menu.
+        // The default values have been added below for reference and easy editing.
+        // The array key is the page's route key, the value is the priority.
+        // Lower values show up first in the menu. The default is 999.
+        'order' => [
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
-        ])
-        ->setPageLabels([
+        ],
+
+        // In case you want to customize the labels for the menu items, you can do so here.
+        // Simply add the route key as the array key, and the label as the value.
+        'labels' => [
             'index' => 'Home',
             'docs/index' => 'Docs',
-        ])
-        ->excludePages([
+        ],
+
+        // These are the route keys of pages that should not show up in the navigation menu.
+        'exclude' => [
             '404',
-        ])
-        ->addNavigationItems([
+        ],
+
+        // Any extra links you want to add to the navigation menu can be added here.
+        // To get started quickly, you can uncomment the defaults here.
+        // See the documentation link above for more information.
+        'custom' => [
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ])
-        ->setSubdirectoryDisplayMode('hidden'),
+        ],
+
+        // How should pages in subdirectories be displayed in the menu?
+        // You can choose between 'dropdown', 'flat', and 'hidden'.
+        'subdirectory_display' => 'hidden',
+    ],
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/config/hyde.php b/packages/framework/config/hyde.php
index 3a4bdf7b9b8..408ababf05e 100644
--- a/packages/framework/config/hyde.php
+++ b/packages/framework/config/hyde.php
@@ -332,23 +332,40 @@
     |
     */
 
-    'navigation' => Navigation::configure()
-        ->setPagePriorities([
+    'navigation' => [
+        // This configuration sets the priorities used to determine the order of the menu.
+        // The default values have been added below for reference and easy editing.
+        // The array key is the page's route key, the value is the priority.
+        // Lower values show up first in the menu. The default is 999.
+        'order' => [
             'index' => 0,
             'posts' => 10,
             'docs/index' => 100,
-        ])
-        ->setPageLabels([
+        ],
+
+        // In case you want to customize the labels for the menu items, you can do so here.
+        // Simply add the route key as the array key, and the label as the value.
+        'labels' => [
             'index' => 'Home',
             'docs/index' => 'Docs',
-        ])
-        ->excludePages([
+        ],
+
+        // These are the route keys of pages that should not show up in the navigation menu.
+        'exclude' => [
             '404',
-        ])
-        ->addNavigationItems([
+        ],
+
+        // Any extra links you want to add to the navigation menu can be added here.
+        // To get started quickly, you can uncomment the defaults here.
+        // See the documentation link above for more information.
+        'custom' => [
             // Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-        ])
-        ->setSubdirectoryDisplayMode('hidden'),
+        ],
+
+        // How should pages in subdirectories be displayed in the menu?
+        // You can choose between 'dropdown', 'flat', and 'hidden'.
+        'subdirectory_display' => 'hidden',
+    ],
 
     /*
     |--------------------------------------------------------------------------
diff --git a/packages/framework/src/Facades/Navigation.php b/packages/framework/src/Facades/Navigation.php
index 2eb846b0613..df2f5861683 100644
--- a/packages/framework/src/Facades/Navigation.php
+++ b/packages/framework/src/Facades/Navigation.php
@@ -4,8 +4,6 @@
 
 namespace Hyde\Facades;
 
-use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
-
 use function compact;
 
 /**
@@ -30,16 +28,4 @@ public static function item(string $destination, ?string $label = null, ?int $pr
     {
         return compact('destination', 'label', 'priority', 'attributes');
     }
-
-    /**
-     * Configuration helper method to define the navigation menu configuration with better IDE support.
-     *
-     * The builder is an array object that will be used by the framework to set the navigation menu configuration.
-     *
-     * @experimental This method is experimental and may change or be removed before the final release.
-     */
-    public static function configure(): NavigationMenuConfigurationBuilder
-    {
-        return new NavigationMenuConfigurationBuilder();
-    }
 }
diff --git a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php b/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
deleted file mode 100644
index 4f5d9957628..00000000000
--- a/packages/framework/src/Framework/Features/Navigation/NavigationMenuConfigurationBuilder.php
+++ /dev/null
@@ -1,128 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Features\Navigation;
-
-use TypeError;
-use ArrayObject;
-use Illuminate\Contracts\Support\Arrayable;
-
-/**
- * Configuration helper class to define the navigation menu configuration with better IDE support.
- *
- * The configured data will then be used by the framework to set the navigation menu configuration.
- *
- * @see \Hyde\Facades\Navigation::configure()
- *
- * @experimental This class is experimental and may change or be removed before the final release.
- */
-class NavigationMenuConfigurationBuilder extends ArrayObject implements Arrayable
-{
-    /**
-     * Set the order of the navigation items.
-     *
-     * Either define a map of route keys to priorities, or just a list of route keys and we'll try to match that order.
-     *
-     * @param  array<string, int>|array<string>  $order
-     * @return $this
-     */
-    public function setPagePriorities(array $order): static
-    {
-        $this['order'] = $order;
-
-        return $this;
-    }
-
-    /**
-     * Set the labels for the navigation items.
-     *
-     * Each key should be a route key, and the value should be the label to display.
-     *
-     * @param  array<string, string>  $labels
-     * @return $this
-     */
-    public function setPageLabels(array $labels): static
-    {
-        $this['labels'] = $labels;
-
-        return $this;
-    }
-
-    /**
-     * Exclude certain items from the navigation.
-     *
-     * Each item should be a route key for the page to exclude.
-     *
-     * @param  array<string>  $exclude
-     * @return $this
-     */
-    public function excludePages(array $exclude): static
-    {
-        $this['exclude'] = $exclude;
-
-        return $this;
-    }
-
-    /**
-     * Add custom items to the navigation.
-     *
-     * @example `[Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200, ['target' => '_blank'])]`
-     *
-     * @param  array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>  $custom
-     * @return $this
-     */
-    public function addNavigationItems(array $custom): static
-    {
-        $this['custom'] = $custom;
-
-        return $this;
-    }
-
-    /**
-     * Set the display mode for pages in subdirectories.
-     *
-     * You can choose between 'dropdown', 'flat', and 'hidden'. The default is 'hidden'.
-     *
-     * @param  'dropdown'|'flat'|'hidden'  $displayMode
-     * @return $this
-     */
-    public function setSubdirectoryDisplayMode(string $displayMode): static
-    {
-        self::assertType(['dropdown', 'flat', 'hidden'], $displayMode);
-
-        $this['subdirectory_display'] = $displayMode;
-
-        return $this;
-    }
-
-    /**
-     * Hide pages in subdirectories from the navigation.
-     *
-     * @experimental This method is experimental and may change or be removed before the final release.
-     *
-     * @return $this
-     */
-    public function hideSubdirectoriesFromNavigation(): static
-    {
-        return $this->setSubdirectoryDisplayMode('hidden');
-    }
-
-    /**
-     * Get the instance as an array.
-     *
-     * @return array{order: array<string, int>, labels: array<string, string>, exclude: array<string>, custom: array<array{destination: string, label: ?string, priority: ?int, attributes: array<string, scalar>}>, subdirectory_display: string}
-     */
-    public function toArray(): array
-    {
-        return $this->getArrayCopy();
-    }
-
-    /** @experimental May be moved to a separate helper class in the future. */
-    protected static function assertType(array $types, string $value): void
-    {
-        if (! in_array($value, $types)) {
-            throw new TypeError('Value must be one of: '.implode(', ', $types));
-        }
-    }
-}
diff --git a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
index 4b48029f1bf..235e5aaee98 100644
--- a/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
+++ b/packages/framework/tests/Feature/AutomaticNavigationConfigurationsTest.php
@@ -4,13 +4,13 @@
 
 namespace Hyde\Framework\Testing\Feature;
 
+use Hyde\Pages\Page;
 use Hyde\Pages\HtmlPage;
 use Hyde\Pages\BladePage;
 use Hyde\Testing\TestCase;
 use Hyde\Pages\MarkdownPage;
 use Hyde\Pages\MarkdownPost;
 use Hyde\Pages\InMemoryPage;
-use Hyde\Facades\Navigation;
 use Hyde\Foundation\HydeKernel;
 use JetBrains\PhpStorm\NoReturn;
 use Hyde\Pages\Concerns\HydePage;
@@ -1290,54 +1290,6 @@ public function testCanConfigureMainMenuUsingArraySettings()
         ]);
     }
 
-    public function testCanConfigureMainMenuUsingBuilderSettings()
-    {
-        $config = [
-            'navigation' => Navigation::configure()
-                ->setPagePriorities([
-                    'foo' => 3,
-                    'bar' => 2,
-                    'baz' => 1,
-                ])
-                ->setPageLabels([
-                    'foo' => 'Foo Page',
-                    'bar' => 'Bar Page',
-                    'baz' => 'Baz Page',
-                    'dropdown/item' => 'Dropdown Item Page',
-                ])
-                ->excludePages([
-                    'qux',
-                ])
-                ->addNavigationItems([
-                    [
-                        'label' => 'Custom',
-                        'destination' => 'https://example.com',
-                        'priority' => 120,
-                        'attributes' => [
-                            'target' => '_blank',
-                        ],
-                    ],
-                ])
-                ->setSubdirectoryDisplayMode('flat'),
-        ];
-
-        config(['hyde' => $config]);
-
-        $this->assertMenuEquals([
-            ['label' => 'Baz Page', 'priority' => 1],
-            ['label' => 'Bar Page', 'priority' => 2],
-            ['label' => 'Foo Page', 'priority' => 3],
-            ['label' => 'Custom', 'priority' => 120, 'attributes' => ['target' => '_blank']],
-            ['label' => 'Dropdown Item Page', 'priority' => 999],
-        ], [
-            new MarkdownPage('foo'),
-            new MarkdownPage('bar'),
-            new MarkdownPage('baz'),
-            new MarkdownPage('qux'),
-            new MarkdownPage('dropdown/item'),
-        ]);
-    }
-
     // Testing helpers
 
     protected function assertSidebarEquals(array $expected, array $menuPages): AssertableNavigationMenu
diff --git a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
index fa2350fda8f..7ece76bdb66 100644
--- a/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/NavigationFacadeTest.php
@@ -6,92 +6,57 @@
 
 use Hyde\Facades\Navigation;
 use Hyde\Testing\UnitTestCase;
-use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
 
 /**
  * @covers \Hyde\Facades\Navigation
  */
 class NavigationFacadeTest extends UnitTestCase
 {
-    public function testItem()
+    public function testItemWithoutLabel()
     {
-        $item = Navigation::item('home', 'Home', 100);
+        $item = Navigation::item('foo');
 
         $this->assertSame([
-            'destination' => 'home',
-            'label' => 'Home',
-            'priority' => 100,
+            'destination' => 'foo',
+            'label' => null,
+            'priority' => null,
             'attributes' => [],
         ], $item);
     }
 
-    public function testItemWithOnlyDestination()
+    public function testItemWithLabel()
     {
-        $item = Navigation::item('home');
+        $item = Navigation::item('foo', 'Foo');
 
         $this->assertSame([
-            'destination' => 'home',
-            'label' => null,
+            'destination' => 'foo',
+            'label' => 'Foo',
             'priority' => null,
             'attributes' => [],
         ], $item);
     }
 
-    public function testItemWithUrl()
+    public function testItemWithPriority()
     {
-        $item = Navigation::item('https://example.com', 'External', 200);
+        $item = Navigation::item('foo', 'Foo', 100);
 
         $this->assertSame([
-            'destination' => 'https://example.com',
-            'label' => 'External',
-            'priority' => 200,
+            'destination' => 'foo',
+            'label' => 'Foo',
+            'priority' => 100,
             'attributes' => [],
         ], $item);
     }
 
-    public function testConfigure()
-    {
-        $builder = Navigation::configure();
-
-        $this->assertInstanceOf(NavigationMenuConfigurationBuilder::class, $builder);
-    }
-
-    public function testConfigureWithChainedMethods()
-    {
-        $config = Navigation::configure()
-            ->setPagePriorities(['index' => 0, 'posts' => 10])
-            ->setPageLabels(['index' => 'Home'])
-            ->excludePages(['404'])
-            ->addNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
-            ->setSubdirectoryDisplayMode('dropdown')
-            ->toArray();
-
-        $this->assertIsArray($config);
-        $this->assertArrayHasKey('order', $config);
-        $this->assertArrayHasKey('labels', $config);
-        $this->assertArrayHasKey('exclude', $config);
-        $this->assertArrayHasKey('custom', $config);
-        $this->assertArrayHasKey('subdirectory_display', $config);
-
-        $this->assertSame(['index' => 0, 'posts' => 10], $config['order']);
-        $this->assertSame(['index' => 'Home'], $config['labels']);
-        $this->assertSame(['404'], $config['exclude']);
-        $this->assertSame([Navigation::item('https://github.com', 'GitHub', 200)], $config['custom']);
-        $this->assertSame('dropdown', $config['subdirectory_display']);
-    }
-
-    public function testConfigureWithSomeChainedMethods()
+    public function testItemWithUrl()
     {
-        $config = Navigation::configure()
-            ->setPagePriorities(['about' => 1, 'contact' => 2])
-            ->setPageLabels(['about' => 'About Us'])
-            ->setSubdirectoryDisplayMode('flat')
-            ->toArray();
+        $item = Navigation::item('https://example.com');
 
-        $this->assertSame(['about' => 1, 'contact' => 2], $config['order']);
-        $this->assertSame(['about' => 'About Us'], $config['labels']);
-        $this->assertSame('flat', $config['subdirectory_display']);
-        $this->assertArrayNotHasKey('exclude', $config);
-        $this->assertArrayNotHasKey('custom', $config);
+        $this->assertSame([
+            'destination' => 'https://example.com',
+            'label' => null,
+            'priority' => null,
+            'attributes' => [],
+        ], $item);
     }
 }
diff --git a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php b/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
deleted file mode 100644
index 2a7fb3a1f24..00000000000
--- a/packages/framework/tests/Unit/NavigationMenuConfigurationBuilderTest.php
+++ /dev/null
@@ -1,162 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use Hyde\Testing\UnitTestCase;
-use Illuminate\Contracts\Support\Arrayable;
-use Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder;
-use Hyde\Facades\Navigation;
-
-/**
- * @covers \Hyde\Framework\Features\Navigation\NavigationMenuConfigurationBuilder
- */
-class NavigationMenuConfigurationBuilderTest extends UnitTestCase
-{
-    private NavigationMenuConfigurationBuilder $builder;
-
-    protected function setUp(): void
-    {
-        $this->builder = new NavigationMenuConfigurationBuilder();
-    }
-
-    public function testSetPagePriorities()
-    {
-        $order = ['index' => 0, 'posts' => 10, 'docs/index' => 100];
-        $result = $this->builder->setPagePriorities($order)->toArray();
-
-        $this->assertArrayHasKey('order', $result);
-        $this->assertSame($order, $result['order']);
-    }
-
-    public function testSetPageLabels()
-    {
-        $labels = ['index' => 'Home', 'docs/index' => 'Docs'];
-        $result = $this->builder->setPageLabels($labels)->toArray();
-
-        $this->assertArrayHasKey('labels', $result);
-        $this->assertSame($labels, $result['labels']);
-    }
-
-    public function testExcludePages()
-    {
-        $exclude = ['404', 'admin'];
-        $result = $this->builder->excludePages($exclude)->toArray();
-
-        $this->assertArrayHasKey('exclude', $result);
-        $this->assertSame($exclude, $result['exclude']);
-    }
-
-    public function testAddNavigationItems()
-    {
-        $custom = [
-            Navigation::item('https://example.com', 'Example', 200),
-            Navigation::item('https://github.com', 'GitHub', 300),
-        ];
-
-        $result = $this->builder->addNavigationItems($custom)->toArray();
-
-        $this->assertArrayHasKey('custom', $result);
-        $this->assertSame($custom, $result['custom']);
-    }
-
-    public function testSetSubdirectoryDisplayMode()
-    {
-        $displayModes = ['dropdown', 'flat', 'hidden'];
-
-        foreach ($displayModes as $mode) {
-            $result = $this->builder->setSubdirectoryDisplayMode($mode)->toArray();
-
-            $this->assertArrayHasKey('subdirectory_display', $result);
-            $this->assertSame($mode, $result['subdirectory_display']);
-        }
-    }
-
-    public function testChainedMethods()
-    {
-        $result = $this->builder
-            ->setPagePriorities(['index' => 0, 'posts' => 10])
-            ->setPageLabels(['index' => 'Home'])
-            ->excludePages(['404'])
-            ->addNavigationItems([Navigation::item('https://github.com', 'GitHub', 200)])
-            ->setSubdirectoryDisplayMode('dropdown')
-            ->toArray();
-
-        $this->assertArrayHasKey('order', $result);
-        $this->assertArrayHasKey('labels', $result);
-        $this->assertArrayHasKey('exclude', $result);
-        $this->assertArrayHasKey('custom', $result);
-        $this->assertArrayHasKey('subdirectory_display', $result);
-    }
-
-    public function testEmptyConfiguration()
-    {
-        $result = $this->builder->toArray();
-
-        $this->assertEmpty($result);
-    }
-
-    public function testInvalidSubdirectoryDisplay()
-    {
-        $this->expectException(\TypeError::class);
-        $this->builder->setSubdirectoryDisplayMode('invalid');
-    }
-
-    public function testRealLifeUsageScenario()
-    {
-        $result = $this->builder
-            ->setPagePriorities([
-                'index' => 0,
-                'posts' => 10,
-                'docs/index' => 100,
-            ])
-            ->setPageLabels([
-                'index' => 'Home',
-                'docs/index' => 'Docs',
-            ])
-            ->excludePages([
-                '404',
-            ])
-            ->addNavigationItems([
-                Navigation::item('https://github.com/hydephp/hyde', 'GitHub', 200),
-            ])
-            ->setSubdirectoryDisplayMode('dropdown')
-            ->toArray();
-
-        $this->assertSame([
-            'order' => ['index' => 0, 'posts' => 10, 'docs/index' => 100],
-            'labels' => ['index' => 'Home', 'docs/index' => 'Docs'],
-            'exclude' => ['404'],
-            'custom' => [
-                ['destination' => 'https://github.com/hydephp/hyde', 'label' => 'GitHub', 'priority' => 200, 'attributes' => []],
-            ],
-            'subdirectory_display' => 'dropdown',
-        ], $result);
-    }
-
-    public function testHideSubdirectoriesFromNavigationShorthand()
-    {
-        $result = $this->builder->hideSubdirectoriesFromNavigation()->toArray();
-
-        $this->assertSame('hidden', $result['subdirectory_display']);
-    }
-
-    public function testArrayableInterface()
-    {
-        $this->assertInstanceOf(Arrayable::class, $this->builder);
-    }
-
-    public function testArrayObjectBehavior()
-    {
-        $this->builder->setPagePriorities(['index' => 0]);
-
-        $this->assertCount(1, $this->builder);
-        $this->assertSame(['order' => ['index' => 0]], $this->builder->getArrayCopy());
-    }
-
-    public function testToArrayMethodReturnsSameResultAsArrayObject()
-    {
-        $this->builder->setPagePriorities(['index' => 0]);
-
-        $this->assertSame(['order' => ['index' => 0]], $this->builder->toArray());
-    }
-}

From df188ec3ae1e1208cc32aa356f67ed23302a88c1 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 27 Apr 2025 21:50:32 +0200
Subject: [PATCH 4000/4023] Change "category" to "group" in PublishViewsCommand

Fixes https://github.com/hydephp/develop/issues/2142
---
 RELEASE_NOTES.md                                   |  1 +
 docs/getting-started/console-commands.md           |  8 ++++----
 .../src/Console/Commands/PublishViewsCommand.php   | 14 +++++++-------
 .../Feature/Commands/PublishViewsCommandTest.php   | 12 ++++++------
 4 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index a7babf43504..c400570c804 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -54,6 +54,7 @@ This serves two purposes:
 - **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
 - **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
 - **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in https://github.com/hydephp/develop/pull/1980
+- Renamed the parameter `category` to `group` in the `publish:views` command in https://github.com/hydephp/develop/pull/2166
 - Dependency: Upgraded from Laravel 10 to Laravel 11
 - Dependency: Updated minimum PHP requirement to 8.2
 - Dependency: Updated Symfony/yaml to ^7.0
diff --git a/docs/getting-started/console-commands.md b/docs/getting-started/console-commands.md
index f92f196e73b..2ba3f012216 100644
--- a/docs/getting-started/console-commands.md
+++ b/docs/getting-started/console-commands.md
@@ -222,16 +222,16 @@ Publish one of the default homepages as `index.blade.php`.
 <a name="publish-views" style="display: inline-block; position: absolute; margin-top: -5rem;"></a>
 
 ```bash
-php hyde publish:views [<category>]
+php hyde publish:views [<group>]
 ```
 
 Publish the hyde components for customization. Note that existing files will be overwritten.
 
 #### Arguments
 
-|            |                         |
-|------------|-------------------------|
-| `category` | The category to publish |
+|          |                       |
+|----------|-------------------------|
+| `group`  | The group to publish |
 
 ## Display All Registered Routes.
 
diff --git a/packages/framework/src/Console/Commands/PublishViewsCommand.php b/packages/framework/src/Console/Commands/PublishViewsCommand.php
index c66aadecc84..96e47972f80 100644
--- a/packages/framework/src/Console/Commands/PublishViewsCommand.php
+++ b/packages/framework/src/Console/Commands/PublishViewsCommand.php
@@ -25,7 +25,7 @@
 class PublishViewsCommand extends Command
 {
     /** @var string */
-    protected $signature = 'publish:views {category? : The category to publish}';
+    protected $signature = 'publish:views {group? : The group to publish}';
 
     /** @var string */
     protected $description = 'Publish the Hyde components for customization. Note that existing files will be overwritten';
@@ -40,10 +40,10 @@ public function handle(): int
             ViewPublishGroup::fromGroup('hyde-components', 'Blade Components', 'More or less self contained components, extracted for customizability and DRY code'),
         ]);
 
-        $selected = ($this->argument('category') ?? $this->promptForCategory()) ?: 'all';
+        $selected = ($this->argument('group') ?? $this->promptForGroup()) ?: 'all';
 
-        if ($selected !== 'all' && (bool) $this->argument('category') === false && ConsoleHelper::canUseLaravelPrompts($this->input)) {
-            $this->infoComment(sprintf('Selected category [%s]', $selected));
+        if ($selected !== 'all' && (bool) $this->argument('group') === false && ConsoleHelper::canUseLaravelPrompts($this->input)) {
+            $this->infoComment(sprintf('Selected group [%s]', $selected));
         }
 
         if (! in_array($selected, $allowed = array_merge(['all'], array_keys($this->options)), true)) {
@@ -64,14 +64,14 @@ public function handle(): int
         return Command::SUCCESS;
     }
 
-    protected function promptForCategory(): string
+    protected function promptForGroup(): string
     {
         SelectPrompt::fallbackUsing(function (SelectPrompt $prompt): string {
             return $this->choice($prompt->label, $prompt->options, $prompt->default);
         });
 
         return $this->parseChoiceIntoKey(
-            select('Which category do you want to publish?', $this->formatPublishableChoices(), 0) ?: 'all'
+            select('Which group do you want to publish?', $this->formatPublishableChoices(), 0) ?: 'all'
         );
     }
 
@@ -79,7 +79,7 @@ protected function formatPublishableChoices(): array
     {
         return collect($this->options)
             ->map(fn (ViewPublishGroup $option, string $key): string => sprintf('<comment>%s</comment>: %s', $key, $option->description))
-            ->prepend('Publish all categories listed below')
+            ->prepend('Publish all groups listed below')
             ->values()
             ->all();
     }
diff --git a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
index e049b2001dc..ed6ed3b6489 100644
--- a/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/PublishViewsCommandTest.php
@@ -30,8 +30,8 @@ public function testCommandPublishesViews()
             + Filesystem::findFiles('vendor/hyde/framework/resources/views/layouts', '.blade.php', true)->count();
 
         $this->artisan('publish:views')
-            ->expectsQuestion('Which category do you want to publish?', 'all')
-            ->doesntExpectOutputToContain('Selected category')
+            ->expectsQuestion('Which group do you want to publish?', 'all')
+            ->doesntExpectOutputToContain('Selected group')
             ->expectsOutput("Published all $count files to [resources/views/vendor/hyde]")
             ->assertExitCode(0);
 
@@ -76,7 +76,7 @@ public function testCanSelectGroupWithQuestion()
         ConsoleHelper::disableLaravelPrompts();
 
         $this->artisan('publish:views')
-            ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
+            ->expectsQuestion('Which group do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
             ->expectsOutput('Published all [layout] files to [resources/views/vendor/hyde/layouts]')
             ->assertExitCode(0);
 
@@ -213,8 +213,8 @@ public function testCanSelectGroupWithQuestionAndPrompts()
         }
 
         $this->artisan('publish:views')
-            ->expectsQuestion('Which category do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
-            ->expectsOutput('Selected category [layouts]')
+            ->expectsQuestion('Which group do you want to publish?', '<comment>layouts</comment>: Shared layout views, such as the app layout, navigation menu, and Markdown page templates')
+            ->expectsOutput('Selected group [layouts]')
             ->expectsQuestion('Select the files you want to publish', [(is_dir(Hyde::path('packages')) ? 'packages' : 'vendor/hyde').'/framework/resources/views/layouts/app.blade.php'])
             ->expectsOutput('Published selected file to [resources/views/vendor/hyde/layouts/app.blade.php]')
             ->assertExitCode(0);
@@ -229,7 +229,7 @@ public function testCanSelectGroupWithQuestionAndPrompts()
     protected function executePublishViewsCommand(): BufferedOutput
     {
         $command = (new PublishViewsCommand());
-        $input = new ArrayInput(['category' => 'layouts'], $command->getDefinition());
+        $input = new ArrayInput(['group' => 'layouts'], $command->getDefinition());
         $output = new BufferedOutput();
         $command->setInput($input);
         $command->setOutput(new OutputStyle($input, $output));

From 1bacf0a8a8c6640858b1f393060ca67bce1888f0 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 13:01:52 +0200
Subject: [PATCH 4001/4023] Add a new simplified image front matter schema

---
 .../views/components/post/image.blade.php     |  4 ++
 .../Factories/FeaturedImageFactory.php        |  7 ++-
 .../Blogging/Models/FeaturedImage.php         | 19 +++++++-
 .../SubSchemas/FeaturedImageSchema.php        |  6 ++-
 .../Feature/FeaturedImageFactoryTest.php      | 38 ++++++++++++++++
 .../tests/Feature/FeaturedImageTest.php       |  9 ++++
 .../tests/Unit/SchemaContractsTest.php        |  2 +
 .../Unit/Views/FeaturedImageViewTest.php      | 45 +++++++++++++++++++
 8 files changed, 124 insertions(+), 6 deletions(-)

diff --git a/packages/framework/resources/views/components/post/image.blade.php b/packages/framework/resources/views/components/post/image.blade.php
index a8d649bb96a..3a25e2a5221 100644
--- a/packages/framework/resources/views/components/post/image.blade.php
+++ b/packages/framework/resources/views/components/post/image.blade.php
@@ -6,6 +6,10 @@
 <figure aria-label="Cover image" itemprop="image" itemscope itemtype="https://schema.org/ImageObject" role="doc-cover">
     <img src="{{ $image->getSource() }}" alt="{{ $image->getAltText() ?? '' }}" title="{{ $image->getTitleText() ?? '' }}" itemprop="image" class="mb-0">
     <figcaption aria-label="Image caption" itemprop="caption">
+        @if($image->hasCaption())
+            <span>{{ $image->getCaption() }}</span>
+        @endif
+
         @if($image->hasAuthorName())
             <span>Image by</span>
             <span itemprop="creator" itemscope="" itemtype="https://schema.org/Person">
diff --git a/packages/framework/src/Framework/Factories/FeaturedImageFactory.php b/packages/framework/src/Framework/Factories/FeaturedImageFactory.php
index 4c2fdb0195c..937ced9e868 100644
--- a/packages/framework/src/Framework/Factories/FeaturedImageFactory.php
+++ b/packages/framework/src/Framework/Factories/FeaturedImageFactory.php
@@ -28,23 +28,25 @@ class FeaturedImageFactory extends Concerns\PageDataFactory implements FeaturedI
     protected readonly ?string $copyrightText;
     protected readonly ?string $licenseName;
     protected readonly ?string $licenseUrl;
+    protected readonly ?string $caption;
 
     public function __construct(
         private readonly FrontMatter $matter,
         private readonly ?string $filePath = null,
     ) {
         $this->source = $this->makeSource();
-        $this->altText = $this->getStringMatter('image.altText');
+        $this->altText = $this->getStringMatter('image.altText') ?? $this->getStringMatter('image.alt');
         $this->titleText = $this->getStringMatter('image.titleText');
         $this->authorName = $this->getStringMatter('image.authorName');
         $this->authorUrl = $this->getStringMatter('image.authorUrl');
         $this->copyrightText = $this->getStringMatter('image.copyright');
         $this->licenseName = $this->getStringMatter('image.licenseName');
         $this->licenseUrl = $this->getStringMatter('image.licenseUrl');
+        $this->caption = $this->getStringMatter('image.caption');
     }
 
     /**
-     * @return array{source: string, altText: string|null, titleText: string|null, authorName: string|null, authorUrl: string|null, copyrightText: string|null, licenseName: string|null, licenseUrl: string|null}
+     * @return array{source: string, altText: string|null, titleText: string|null, authorName: string|null, authorUrl: string|null, copyrightText: string|null, licenseName: string|null, licenseUrl: string|null, caption: string|null}
      */
     public function toArray(): array
     {
@@ -57,6 +59,7 @@ public function toArray(): array
             'copyrightText' => $this->copyrightText,
             'licenseName' => $this->licenseName,
             'licenseUrl' => $this->licenseUrl,
+            'caption' => $this->caption,
         ];
     }
 
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
index e1cb2d34ea6..9b710ff7a42 100644
--- a/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
+++ b/packages/framework/src/Framework/Features/Blogging/Models/FeaturedImage.php
@@ -58,7 +58,8 @@ public function __construct(
         protected readonly ?string $authorUrl = null,
         protected readonly ?string $licenseName = null,
         protected readonly ?string $licenseUrl = null,
-        protected readonly ?string $copyrightText = null
+        protected readonly ?string $copyrightText = null,
+        protected readonly ?string $caption = null
     ) {
         $this->type = Hyperlinks::isRemote($source) ? self::TYPE_REMOTE : self::TYPE_LOCAL;
         $this->source = $this->setSource($source);
@@ -127,6 +128,10 @@ public function getMetadataArray(): array
             $metadata['name'] = $this->getTitleText();
         }
 
+        if ($this->hasCaption()) {
+            $metadata['caption'] = $this->getCaption();
+        }
+
         $metadata['url'] = $this->getSource();
         $metadata['contentUrl'] = $this->getSource();
 
@@ -135,7 +140,7 @@ public function getMetadataArray(): array
 
     public function getAltText(): ?string
     {
-        return $this->altText;
+        return $this->altText ?? $this->caption;
     }
 
     public function getTitleText(): ?string
@@ -168,6 +173,11 @@ public function getLicenseUrl(): ?string
         return $this->licenseUrl;
     }
 
+    public function getCaption(): ?string
+    {
+        return $this->caption;
+    }
+
     public function hasAltText(): bool
     {
         return $this->has('altText');
@@ -203,6 +213,11 @@ public function hasLicenseUrl(): bool
         return $this->has('licenseUrl');
     }
 
+    public function hasCaption(): bool
+    {
+        return $this->has('caption');
+    }
+
     protected function has(string $property): bool
     {
         return $this->$property !== null;
diff --git a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/FeaturedImageSchema.php b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/FeaturedImageSchema.php
index ad356ee5775..7c2b6e8827e 100644
--- a/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/FeaturedImageSchema.php
+++ b/packages/framework/src/Markdown/Contracts/FrontMatter/SubSchemas/FeaturedImageSchema.php
@@ -14,8 +14,10 @@ interface FeaturedImageSchema extends BlogPostSchema
 {
     public const FEATURED_IMAGE_SCHEMA = [
         'source' => 'string', // Name of a file in _media/ or a remote URL (required)
-        'altText' => 'string', // The alt text (important for accessibility) // todo: Support alt, description
-        'titleText' => 'string', // The title text (hover tooltip & metadata) // todo: Support title, caption
+        'altText' => 'string', // The alt text (important for accessibility)
+        'alt' => 'string',     // Alternative to altText (simplified schema)
+        'titleText' => 'string', // The title text (hover tooltip & metadata)
+        'caption' => 'string', // The caption text (simplified schema)
         'licenseName' => 'string', // The name of the license (e.g. "CC BY 4.0")
         'licenseUrl' => 'string', // The URL of the license (e.g. "https://creativecommons.org/licenses/by/4.0/")
         'authorName' => 'string', // The name of the author/photographer of the image (e.g. "John Doe", Wikimedia Commons)
diff --git a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
index b38f0b77bd3..fd3f7f1caa6 100644
--- a/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageFactoryTest.php
@@ -47,6 +47,7 @@ public function testWithDataFromSchema()
             'copyrightText' => 'copyright',
             'licenseName' => 'license',
             'licenseUrl' => 'licenseUrl',
+            'caption' => null,
         ];
 
         $factory = new FeaturedImageFactory(new FrontMatter($array));
@@ -146,6 +147,43 @@ public function testImagePathsWithCacheBusting()
         $this->assertSourceIsSame('media/foo?v=00000000', ['image' => ['source' => '_media/foo']]);
     }
 
+    public function testSupportsSimplifiedImageSchema()
+    {
+        $array = [
+            'image' => [
+                'source' => 'source',
+                'alt' => 'Alternative text',
+                'caption' => 'Static website from GitHub Readme',
+            ],
+        ];
+
+        $factory = new FeaturedImageFactory(new FrontMatter($array));
+        $image = FeaturedImageFactory::make(new FrontMatter($array));
+
+        $this->assertSame('source', $factory->toArray()['source']);
+        $this->assertSame('Alternative text', $factory->toArray()['altText']);
+        $this->assertSame('Static website from GitHub Readme', $factory->toArray()['caption']);
+
+        $this->assertSame('Alternative text', $image->getAltText());
+        $this->assertSame('Static website from GitHub Readme', $image->getCaption());
+    }
+
+    public function testFallsBackToCaptionWhenAltIsMissing()
+    {
+        $array = [
+            'image' => [
+                'source' => 'source',
+                'caption' => 'This caption should be used as alt text',
+            ],
+        ];
+
+        $image = FeaturedImageFactory::make(new FrontMatter($array));
+
+        $this->assertFalse($image->hasAltText());
+        $this->assertSame('This caption should be used as alt text', $image->getAltText());
+        $this->assertSame('This caption should be used as alt text', $image->getCaption());
+    }
+
     protected function makeFromArray(array $matter): FeaturedImage
     {
         return FeaturedImageFactory::make(new FrontMatter($matter));
diff --git a/packages/framework/tests/Feature/FeaturedImageTest.php b/packages/framework/tests/Feature/FeaturedImageTest.php
index 031018a0d22..929fe34ea08 100644
--- a/packages/framework/tests/Feature/FeaturedImageTest.php
+++ b/packages/framework/tests/Feature/FeaturedImageTest.php
@@ -41,6 +41,15 @@ public function testGetMetadataArray()
             'contentUrl' => 'media/source',
         ], (new FilledImage)->getMetadataArray());
 
+        // Test with caption
+        $this->assertSame([
+            'text' => 'alt',
+            'name' => 'title',
+            'caption' => 'This is a caption',
+            'url' => 'media/source',
+            'contentUrl' => 'media/source',
+        ], (new FeaturedImage('source', 'alt', 'title', null, null, null, null, null, 'This is a caption'))->getMetadataArray());
+
         $this->assertSame([
             'url' => 'media/source',
             'contentUrl' => 'media/source',
diff --git a/packages/framework/tests/Unit/SchemaContractsTest.php b/packages/framework/tests/Unit/SchemaContractsTest.php
index b4f7be907c5..6e83b0f1674 100644
--- a/packages/framework/tests/Unit/SchemaContractsTest.php
+++ b/packages/framework/tests/Unit/SchemaContractsTest.php
@@ -69,7 +69,9 @@ public function testSchemasAreNotAccidentallyChanged()
         $this->assertSame([
             'source' => 'string',
             'altText' => 'string',
+            'alt' => 'string',
             'titleText' => 'string',
+            'caption' => 'string',
             'licenseName' => 'string',
             'licenseUrl' => 'string',
             'authorName' => 'string',
diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index a15ade44528..347bc875724 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -273,6 +273,51 @@ public function testImagePathNormalization()
         $this->assertStringContainsString('src="custom_media/bar.png"', $component);
     }
 
+    public function testCaptionIsRenderedWhenPresent()
+    {
+        $component = $this->renderComponent([
+            'image.source' => 'foo.jpg',
+            'image.caption' => 'This is a caption for the image',
+            'image.altText' => 'Alt text for the image',
+        ]);
+
+        $this->assertStringContainsString('This is a caption for the image', $component);
+        $this->assertStringContainsString('alt="Alt text for the image"', $component);
+    }
+
+    public function testAltTextFallsBackToCaptionWhenMissing()
+    {
+        $component = $this->renderComponent([
+            'image.source' => 'foo.jpg',
+            'image.caption' => 'This caption is used as alt text',
+        ]);
+
+        $this->assertStringContainsString('This caption is used as alt text', $component);
+        $this->assertStringContainsString('alt="This caption is used as alt text"', $component);
+    }
+
+    public function testSupportsSimplifiedImageSchema()
+    {
+        $this->file('_media/simple.jpg', 'test content');
+
+        $image = new FeaturedImage(
+            'simple.jpg',
+            null, // altText
+            null, // titleText
+            null, // authorName
+            null, // authorUrl
+            null, // licenseName
+            null, // licenseUrl
+            null, // copyrightText
+            'Static website from GitHub Readme' // caption
+        );
+
+        $component = $this->renderComponent($image);
+
+        $this->assertStringContainsString('Static website from GitHub Readme', $component);
+        $this->assertStringContainsString('alt="Static website from GitHub Readme"', $component);
+    }
+
     protected function stripHtml(string $string): string
     {
         return trim($this->stripWhitespace(strip_tags($string)), "\t ");

From eeb98f8ba5176d652bb65c22e1eba1b5b2b4fa07 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:17:35 +0200
Subject: [PATCH 4002/4023] Support inline Markdown for image captions

---
 .../views/components/post/image.blade.php     |  4 ++-
 .../Unit/Views/FeaturedImageViewTest.php      | 35 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/packages/framework/resources/views/components/post/image.blade.php b/packages/framework/resources/views/components/post/image.blade.php
index 3a25e2a5221..a35205ff319 100644
--- a/packages/framework/resources/views/components/post/image.blade.php
+++ b/packages/framework/resources/views/components/post/image.blade.php
@@ -2,12 +2,14 @@
     /** @var \Hyde\Pages\MarkdownPost $page  */
     /** @var \Hyde\Framework\Features\Blogging\Models\FeaturedImage $image  */
     $image = $page->image;
+    
+    use Illuminate\Support\Str;
 @endphp
 <figure aria-label="Cover image" itemprop="image" itemscope itemtype="https://schema.org/ImageObject" role="doc-cover">
     <img src="{{ $image->getSource() }}" alt="{{ $image->getAltText() ?? '' }}" title="{{ $image->getTitleText() ?? '' }}" itemprop="image" class="mb-0">
     <figcaption aria-label="Image caption" itemprop="caption">
         @if($image->hasCaption())
-            <span>{{ $image->getCaption() }}</span>
+            <span>{!! Str::inlineMarkdown($image->getCaption()) !!}</span>
         @endif
 
         @if($image->hasAuthorName())
diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index 347bc875724..63c3bc15b4e 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -318,6 +318,41 @@ public function testSupportsSimplifiedImageSchema()
         $this->assertStringContainsString('alt="Static website from GitHub Readme"', $component);
     }
 
+    public function testCaptionSupportsMarkdown()
+    {
+        $component = $this->renderComponent([
+            'image.source' => 'foo.jpg',
+            'image.caption' => 'This is a caption with **bold** and *italic* text and [a link](https://example.com)',
+        ]);
+
+        // Check that Markdown is rendered correctly
+        $this->assertStringContainsString('<strong>bold</strong>', $component);
+        $this->assertStringContainsString('<em>italic</em>', $component);
+        $this->assertStringContainsString('<a href="https://example.com">a link</a>', $component);
+    }
+
+    public function testCaptionWithSimplifiedSchemaSupportsMarkdown()
+    {
+        $this->file('_media/markdown.jpg', 'test content');
+        
+        $image = new FeaturedImage(
+            'markdown.jpg',
+            null, // altText
+            null, // titleText
+            null, // authorName
+            null, // authorUrl
+            null, // licenseName
+            null, // licenseUrl
+            null, // copyrightText
+            'Caption with **bold** and *italic* text' // caption with markdown
+        );
+        
+        $component = $this->renderComponent($image);
+        
+        $this->assertStringContainsString('<strong>bold</strong>', $component);
+        $this->assertStringContainsString('<em>italic</em>', $component);
+    }
+
     protected function stripHtml(string $string): string
     {
         return trim($this->stripWhitespace(strip_tags($string)), "\t ");

From f903084eda67fe573a147fb052a2a0937738b76b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:27:02 +0200
Subject: [PATCH 4003/4023] Update the documentation for new image schema

---
 docs/creating-content/blog-posts.md | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/creating-content/blog-posts.md b/docs/creating-content/blog-posts.md
index 5dc5061b85e..23b19eedc8c 100644
--- a/docs/creating-content/blog-posts.md
+++ b/docs/creating-content/blog-posts.md
@@ -212,7 +212,7 @@ The image source will be used as-is, and no additional processing is done.
 image: https://cdn.example.com/image.jpg
 ```
 
-#### Data-rich image
+#### Data-rich image and captions
 
 You can also supply an array of data to construct a rich image with a fluent caption.
 
@@ -226,9 +226,20 @@ image:
     licenseUrl: https://example.com/license/
     authorUrl: https://photographer.example.com/
     authorName: "John Doe"
+    caption: "Overrides the fluent caption feature"
 ```
 
->info See [posts/introducing-images](https://hydephp.com/posts/introducing-images) for a detailed blog post with examples and schema information!
+The data will then be used for metadata and to render a fluently worded caption. If you just want to add a quick caption, you can instead simply set the "caption field" to override the caption; or if you simply want a caption and no metadata this is a quick option as well.
+```yaml
+image:
+    source: how-to-turn-your-github-readme-into-a-static-website-cropped.png
+    alt: Example of a static website created from a GitHub Readme
+    caption: Static website from GitHub Readme with **Markdown** support!
+```
+
+The caption field supports inline Markdown formatting like **bold**, *italic*, and [links](https://example.com). This makes it easy to add rich text formatting to your image captions.
+
+If the `alt` field is missing, the caption will be used as the alt text as well.
 
 ## Using Images in Posts
 

From fbf764c6ade158ab0b465221c6e929ef40ba236d Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:27:03 +0200
Subject: [PATCH 4004/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index c400570c804..41e8d8fc335 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -39,6 +39,7 @@ This serves two purposes:
 - Added Vite facade in https://github.com/hydephp/develop/pull/2016
 - Added a custom Blade-based heading renderer for Markdown conversions in https://github.com/hydephp/develop/pull/2047
 - The `publish:views` command is now interactive for Unix-like systems in https://github.com/hydephp/develop/pull/2062
+- Added a new simplified blog post image front matter schema using a new "caption" field in https://github.com/hydephp/develop/pull/2175
 
 ### Changed
 

From f417c2b933f752ed058d1de1e4f54490e2163870 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:29:51 +0200
Subject: [PATCH 4005/4023] Update managing-assets.md

---
 docs/creating-content/managing-assets.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/creating-content/managing-assets.md b/docs/creating-content/managing-assets.md
index fc51664d9d6..ec7ced8ee15 100644
--- a/docs/creating-content/managing-assets.md
+++ b/docs/creating-content/managing-assets.md
@@ -183,4 +183,4 @@ To improve accessibility, you should always add an `alt` text. Here is a full ex
 
 Hyde offers great support for creating data-rich and accessible featured images for blog posts.
 
-You can read more about this on the [creating blog posts page](blog-posts#image).
+You can read more about this on the [creating blog posts page](blog-posts#data-rich-image-and-captions).

From 2316390f660168a9792037dee83ac020fa406caf Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:30:14 +0200
Subject: [PATCH 4006/4023] Use the custom caption feature to override dynamic

---
 .../views/components/post/image.blade.php     | 44 +++++++++----------
 .../Unit/Views/FeaturedImageViewTest.php      | 34 ++++++++++++++
 2 files changed, 56 insertions(+), 22 deletions(-)

diff --git a/packages/framework/resources/views/components/post/image.blade.php b/packages/framework/resources/views/components/post/image.blade.php
index a35205ff319..ad39adca29b 100644
--- a/packages/framework/resources/views/components/post/image.blade.php
+++ b/packages/framework/resources/views/components/post/image.blade.php
@@ -10,31 +10,31 @@
     <figcaption aria-label="Image caption" itemprop="caption">
         @if($image->hasCaption())
             <span>{!! Str::inlineMarkdown($image->getCaption()) !!}</span>
-        @endif
-
-        @if($image->hasAuthorName())
-            <span>Image by</span>
-            <span itemprop="creator" itemscope="" itemtype="https://schema.org/Person">
-                @if($image->hasAuthorUrl())
-                    <a href="{{ $image->getAuthorUrl() }}" rel="author noopener nofollow" itemprop="url">
+        @else
+            @if($image->hasAuthorName())
+                <span>Image by</span>
+                <span itemprop="creator" itemscope="" itemtype="https://schema.org/Person">
+                    @if($image->hasAuthorUrl())
+                        <a href="{{ $image->getAuthorUrl() }}" rel="author noopener nofollow" itemprop="url">
+                            <span itemprop="name">{{ $image->getAuthorName() }}</span>.
+                        </a>
+                    @else
                         <span itemprop="name">{{ $image->getAuthorName() }}</span>.
-                    </a>
-                @else
-                    <span itemprop="name">{{ $image->getAuthorName() }}</span>.
-                @endif
-            </span>
-        @endif
+                    @endif
+                </span>
+            @endif
 
-        @if($image->hasCopyrightText())
-            <span itemprop="copyrightNotice">{{ $image->getCopyrightText() }}</span>.
-        @endif
+            @if($image->hasCopyrightText())
+                <span itemprop="copyrightNotice">{{ $image->getCopyrightText() }}</span>.
+            @endif
 
-        @if($image->hasLicenseName())
-            <span>License</span>
-            @if($image->hasLicenseUrl())
-                <a href="{{ $image->getLicenseUrl() }}" rel="license nofollow noopener" itemprop="license">{{ $image->getLicenseName() }}</a>.
-            @else
-                <span itemprop="license">{{ $image->getLicenseName() }}</span>.
+            @if($image->hasLicenseName())
+                <span>License</span>
+                @if($image->hasLicenseUrl())
+                    <a href="{{ $image->getLicenseUrl() }}" rel="license nofollow noopener" itemprop="license">{{ $image->getLicenseName() }}</a>.
+                @else
+                    <span itemprop="license">{{ $image->getLicenseName() }}</span>.
+                @endif
             @endif
         @endif
     </figcaption>
diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index 63c3bc15b4e..f365f36e010 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -353,6 +353,40 @@ public function testCaptionWithSimplifiedSchemaSupportsMarkdown()
         $this->assertStringContainsString('<em>italic</em>', $component);
     }
 
+    public function testCaptionOverridesFeaturedImage()
+    {
+        $component = $this->renderComponent([
+            'image.source' => 'foo.jpg',
+            'image.caption' => 'This custom caption should override the fluent caption',
+            'image.authorName' => 'John Doe',
+            'image.licenseName' => 'MIT License',
+        ]);
+
+        // The caption should be present
+        $this->assertStringContainsString('This custom caption should override the fluent caption', $component);
+        
+        // The fluent caption elements should NOT be present
+        $this->assertStringNotContainsString('Image by', $component);
+        $this->assertStringNotContainsString('John Doe', $component);
+        $this->assertStringNotContainsString('License', $component);
+        $this->assertStringNotContainsString('MIT License', $component);
+    }
+    
+    public function testFluentCaptionUsedWhenNoCaptionIsSet()
+    {
+        $component = $this->renderComponent([
+            'image.source' => 'foo.jpg',
+            'image.authorName' => 'John Doe',
+            'image.licenseName' => 'MIT License',
+        ]);
+
+        // The fluent caption elements should be present
+        $this->assertStringContainsString('Image by', $component);
+        $this->assertStringContainsString('John Doe', $component);
+        $this->assertStringContainsString('License', $component);
+        $this->assertStringContainsString('MIT License', $component);
+    }
+
     protected function stripHtml(string $string): string
     {
         return trim($this->stripWhitespace(strip_tags($string)), "\t ");

From 6de0493c9f2e8c442da65cf96bca23830948f1b3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sat, 10 May 2025 19:30:36 +0200
Subject: [PATCH 4007/4023] Fix style

---
 .../tests/Unit/Views/FeaturedImageViewTest.php         | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
index f365f36e010..cd4c39b7026 100644
--- a/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
+++ b/packages/framework/tests/Unit/Views/FeaturedImageViewTest.php
@@ -334,7 +334,7 @@ public function testCaptionSupportsMarkdown()
     public function testCaptionWithSimplifiedSchemaSupportsMarkdown()
     {
         $this->file('_media/markdown.jpg', 'test content');
-        
+
         $image = new FeaturedImage(
             'markdown.jpg',
             null, // altText
@@ -346,9 +346,9 @@ public function testCaptionWithSimplifiedSchemaSupportsMarkdown()
             null, // copyrightText
             'Caption with **bold** and *italic* text' // caption with markdown
         );
-        
+
         $component = $this->renderComponent($image);
-        
+
         $this->assertStringContainsString('<strong>bold</strong>', $component);
         $this->assertStringContainsString('<em>italic</em>', $component);
     }
@@ -364,14 +364,14 @@ public function testCaptionOverridesFeaturedImage()
 
         // The caption should be present
         $this->assertStringContainsString('This custom caption should override the fluent caption', $component);
-        
+
         // The fluent caption elements should NOT be present
         $this->assertStringNotContainsString('Image by', $component);
         $this->assertStringNotContainsString('John Doe', $component);
         $this->assertStringNotContainsString('License', $component);
         $this->assertStringNotContainsString('MIT License', $component);
     }
-    
+
     public function testFluentCaptionUsedWhenNoCaptionIsSet()
     {
         $component = $this->renderComponent([

From 754dc85149d0666ac3dcf7595b3b8f31c19d3633 Mon Sep 17 00:00:00 2001
From: StyleCI Bot <bot@styleci.io>
Date: Sun, 11 May 2025 06:48:04 +0000
Subject: [PATCH 4008/4023] Apply fixes from StyleCI

---
 packages/framework/tests/Unit/Facades/RouteFacadeTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
index 89d74243755..0227acd899c 100644
--- a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
@@ -9,7 +9,6 @@
 use Hyde\Hyde;
 use Hyde\Pages\BladePage;
 use Hyde\Pages\MarkdownPage;
-use Hyde\Pages\MarkdownPost;
 use Hyde\Support\Models\Route;
 use Hyde\Testing\UnitTestCase;
 

From ac8362b7fa137fb79914c92b6f211bdfe1d3ff5b Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 09:21:06 +0200
Subject: [PATCH 4009/4023] Rename `Routes::get` to `Routes::find`

---
 _pages/404.blade.php                                            | 2 +-
 .../views/components/navigation/navigation-brand.blade.php      | 2 +-
 packages/framework/resources/views/pages/404.blade.php          | 2 +-
 packages/framework/src/Foundation/Facades/Routes.php            | 2 +-
 .../src/Framework/Views/Components/BreadcrumbsComponent.php     | 2 +-
 packages/framework/src/Pages/Concerns/HydePage.php              | 2 +-
 packages/framework/src/Pages/DocumentationPage.php              | 2 +-
 packages/framework/tests/Unit/Facades/RouteFacadeTest.php       | 2 +-
 packages/realtime-compiler/src/Routing/PageRouter.php           | 2 +-
 9 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/_pages/404.blade.php b/_pages/404.blade.php
index 7a4328b1fde..0360a58111d 100644
--- a/_pages/404.blade.php
+++ b/_pages/404.blade.php
@@ -31,7 +31,7 @@
                     Sorry, the page you are looking for could not be found.
                 </p>
 
-                <a href="{{ Routes::get('index') ?? '/' }}">
+                <a href="{{ Routes::find('index') ?? '/' }}">
                     <button class="bg-transparent text-grey-darkest font-bold uppercase tracking-wide py-3 px-6 border-2 border-grey-light hover:border-grey rounded-lg">
                         Go Home
                     </button>
diff --git a/packages/framework/resources/views/components/navigation/navigation-brand.blade.php b/packages/framework/resources/views/components/navigation/navigation-brand.blade.php
index 4fd5045a65f..39d38fcc663 100644
--- a/packages/framework/resources/views/components/navigation/navigation-brand.blade.php
+++ b/packages/framework/resources/views/components/navigation/navigation-brand.blade.php
@@ -1,3 +1,3 @@
-<a href="{{ Routes::get('index') }}" class="font-bold px-4" aria-label="Home page">
+<a href="{{ Routes::find('index') }}" class="font-bold px-4" aria-label="Home page">
     {{ config('hyde.name', 'HydePHP') }}
 </a>
\ No newline at end of file
diff --git a/packages/framework/resources/views/pages/404.blade.php b/packages/framework/resources/views/pages/404.blade.php
index 7a4328b1fde..0360a58111d 100644
--- a/packages/framework/resources/views/pages/404.blade.php
+++ b/packages/framework/resources/views/pages/404.blade.php
@@ -31,7 +31,7 @@
                     Sorry, the page you are looking for could not be found.
                 </p>
 
-                <a href="{{ Routes::get('index') ?? '/' }}">
+                <a href="{{ Routes::find('index') ?? '/' }}">
                     <button class="bg-transparent text-grey-darkest font-bold uppercase tracking-wide py-3 px-6 border-2 border-grey-light hover:border-grey rounded-lg">
                         Go Home
                     </button>
diff --git a/packages/framework/src/Foundation/Facades/Routes.php b/packages/framework/src/Foundation/Facades/Routes.php
index f82acc2695e..e4d87041c53 100644
--- a/packages/framework/src/Foundation/Facades/Routes.php
+++ b/packages/framework/src/Foundation/Facades/Routes.php
@@ -29,7 +29,7 @@ public static function exists(string $routeKey): bool
         return static::getFacadeRoot()->has($routeKey);
     }
 
-    public static function get(string $routeKey): ?Route
+    public static function find(string $routeKey): ?Route
     {
         return static::getFacadeRoot()->get($routeKey);
     }
diff --git a/packages/framework/src/Framework/Views/Components/BreadcrumbsComponent.php b/packages/framework/src/Framework/Views/Components/BreadcrumbsComponent.php
index 0b220e1939c..1d6f3ac334e 100644
--- a/packages/framework/src/Framework/Views/Components/BreadcrumbsComponent.php
+++ b/packages/framework/src/Framework/Views/Components/BreadcrumbsComponent.php
@@ -31,7 +31,7 @@ public function render(): ViewContract
     protected function makeBreadcrumbs(): array
     {
         $identifier = Hyde::currentRoute()->getPage()->getIdentifier();
-        $breadcrumbs = [(Routes::get('index')?->getLink() ?? '/') => 'Home'];
+        $breadcrumbs = [(Routes::find('index')?->getLink() ?? '/') => 'Home'];
 
         if ($identifier === 'index') {
             return $breadcrumbs;
diff --git a/packages/framework/src/Pages/Concerns/HydePage.php b/packages/framework/src/Pages/Concerns/HydePage.php
index 08a730ea5fa..e60e44dc187 100644
--- a/packages/framework/src/Pages/Concerns/HydePage.php
+++ b/packages/framework/src/Pages/Concerns/HydePage.php
@@ -309,7 +309,7 @@ public function getRouteKey(): string
      */
     public function getRoute(): Route
     {
-        return Routes::get($this->getRouteKey()) ?? new Route($this);
+        return Routes::find($this->getRouteKey()) ?? new Route($this);
     }
 
     /**
diff --git a/packages/framework/src/Pages/DocumentationPage.php b/packages/framework/src/Pages/DocumentationPage.php
index 4eb092b28ca..4e0c5fc9d07 100644
--- a/packages/framework/src/Pages/DocumentationPage.php
+++ b/packages/framework/src/Pages/DocumentationPage.php
@@ -30,7 +30,7 @@ class DocumentationPage extends BaseMarkdownPage
 
     public static function home(): ?Route
     {
-        return Routes::get(static::homeRouteName());
+        return Routes::find(static::homeRouteName());
     }
 
     public static function homeRouteName(): string
diff --git a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
index 0227acd899c..0a02f7386c1 100644
--- a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
@@ -44,7 +44,7 @@ public function testGetReturnsRouteFromRouterIndexForTheRightPage()
 
     public function testGetFromReturnsNullIfRouteIsNotFound()
     {
-        $this->assertNull(Routes::get('not-found'));
+        $this->assertNull(Routes::find('not-found'));
     }
 
     public function testCurrentReturnsCurrentRoute()
diff --git a/packages/realtime-compiler/src/Routing/PageRouter.php b/packages/realtime-compiler/src/Routing/PageRouter.php
index 24847498d19..71d13d53e43 100644
--- a/packages/realtime-compiler/src/Routing/PageRouter.php
+++ b/packages/realtime-compiler/src/Routing/PageRouter.php
@@ -84,7 +84,7 @@ protected function getPageFromRoute(): HydePage
         try {
             return Routes::getOrFail($this->normalizePath($this->request->path))->getPage();
         } catch (RouteNotFoundException $exception) {
-            $index = Routes::get($this->normalizePath($this->request->path).'/index');
+            $index = Routes::find($this->normalizePath($this->request->path).'/index');
 
             if ($index) {
                 return $index->getPage();

From d822a1dba1837551274654c7608db3bd766f57d7 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 09:22:04 +0200
Subject: [PATCH 4010/4023] Rename `Routes::getOrFail` to `Routes::get`

---
 packages/framework/src/Foundation/Facades/Routes.php        | 2 +-
 packages/framework/tests/Unit/Facades/RouteFacadeTest.php   | 2 +-
 packages/realtime-compiler/src/Http/DashboardController.php | 2 +-
 packages/realtime-compiler/src/Routing/PageRouter.php       | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/framework/src/Foundation/Facades/Routes.php b/packages/framework/src/Foundation/Facades/Routes.php
index e4d87041c53..69ea628e6db 100644
--- a/packages/framework/src/Foundation/Facades/Routes.php
+++ b/packages/framework/src/Foundation/Facades/Routes.php
@@ -35,7 +35,7 @@ public static function find(string $routeKey): ?Route
     }
 
     /** @throws \Hyde\Framework\Exceptions\RouteNotFoundException */
-    public static function getOrFail(string $routeKey): Route
+    public static function get(string $routeKey): Route
     {
         return static::getFacadeRoot()->getRoute($routeKey);
     }
diff --git a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
index 0a02f7386c1..e1018322834 100644
--- a/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
+++ b/packages/framework/tests/Unit/Facades/RouteFacadeTest.php
@@ -29,7 +29,7 @@ public function testGetOrFailThrowsExceptionIfRouteIsNotFound()
     {
         $this->expectException(RouteNotFoundException::class);
 
-        Routes::getOrFail('not-found');
+        Routes::get('not-found');
     }
 
     public function testGetReturnsRouteFromRouterIndex()
diff --git a/packages/realtime-compiler/src/Http/DashboardController.php b/packages/realtime-compiler/src/Http/DashboardController.php
index 172c90d8172..d73126bf7d8 100644
--- a/packages/realtime-compiler/src/Http/DashboardController.php
+++ b/packages/realtime-compiler/src/Http/DashboardController.php
@@ -296,7 +296,7 @@ protected function openInExplorer(): void
     protected function openPageInEditor(): void
     {
         $routeKey = $this->request->data['routeKey'] ?? $this->abort(400, 'Must provide routeKey');
-        $page = Routes::getOrFail($routeKey)->getPage();
+        $page = Routes::get($routeKey)->getPage();
 
         $binary = $this->findGeneralOpenBinary();
         $path = Hyde::path($page->getSourcePath());
diff --git a/packages/realtime-compiler/src/Routing/PageRouter.php b/packages/realtime-compiler/src/Routing/PageRouter.php
index 71d13d53e43..6348cde04ae 100644
--- a/packages/realtime-compiler/src/Routing/PageRouter.php
+++ b/packages/realtime-compiler/src/Routing/PageRouter.php
@@ -82,7 +82,7 @@ public static function handle(Request $request): Response
     protected function getPageFromRoute(): HydePage
     {
         try {
-            return Routes::getOrFail($this->normalizePath($this->request->path))->getPage();
+            return Routes::get($this->normalizePath($this->request->path))->getPage();
         } catch (RouteNotFoundException $exception) {
             $index = Routes::find($this->normalizePath($this->request->path).'/index');
 

From ea8455f7d193babdcdbe4894b1dff8200c680e5e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 18:31:00 +0200
Subject: [PATCH 4011/4023] Improve the class documentation

---
 .../src/Foundation/Facades/Routes.php         | 22 +++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/packages/framework/src/Foundation/Facades/Routes.php b/packages/framework/src/Foundation/Facades/Routes.php
index 69ea628e6db..7378f375b62 100644
--- a/packages/framework/src/Foundation/Facades/Routes.php
+++ b/packages/framework/src/Foundation/Facades/Routes.php
@@ -24,28 +24,46 @@ public static function getFacadeRoot(): RouteCollection
         return HydeKernel::getInstance()->routes();
     }
 
+    /**
+     * Check if a route exists by its route key.
+     */
     public static function exists(string $routeKey): bool
     {
         return static::getFacadeRoot()->has($routeKey);
     }
 
+    /**
+     * Try to get a route by its route key. If it doesn't exist, null is returned.
+     */
     public static function find(string $routeKey): ?Route
     {
         return static::getFacadeRoot()->get($routeKey);
     }
 
-    /** @throws \Hyde\Framework\Exceptions\RouteNotFoundException */
+    /**
+     * Get a route by its route key. If it doesn't exist, an exception is thrown.
+     *
+     * @throws \Hyde\Framework\Exceptions\RouteNotFoundException
+     */
     public static function get(string $routeKey): Route
     {
         return static::getFacadeRoot()->getRoute($routeKey);
     }
 
+    /**
+     * Get all the routes for the site as a collection of route instances, keyed by route key.
+     *
+     * @return \Hyde\Foundation\Kernel\RouteCollection<string, \Hyde\Support\Models\Route>
+     */
     public static function all(): RouteCollection
     {
         return static::getFacadeRoot()->getRoutes();
     }
 
-    /** Get the current route for the page being rendered. */
+    /**
+     * Get the route instance for the page currently being rendered.
+     * If a render is not in progress, this will return null.
+     */
     public static function current(): ?Route
     {
         return Hyde::currentRoute();

From f8537d4649634f72c66cf931be58814cd2650241 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 18:51:56 +0200
Subject: [PATCH 4012/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 41e8d8fc335..da44f86032c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -121,6 +121,10 @@ This serves two purposes:
 - Markdown headings are now compiled using our custom Blade-based heading renderer in https://github.com/hydephp/develop/pull/2047
     - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
 - Colored Markdown blockquotes are now rendered using Blade and TailwindCSS, this change is not visible in the rendered result, but the HTML output has changed in https://github.com/hydephp/develop/pull/2056
+- **Improved Routes facade API with more intuitive method names** in https://github.com/hydephp/develop/pull/2179
+    - **Breaking:** Renamed `Routes::get()` to `Routes::find()` to better indicate it may return null
+    - **Breaking:** Renamed `Routes::getOrFail()` to `Routes::get()` to make the exception-throwing behavior the default and match Laravel conventions
+    - This change requires code updates if you were using these methods - see upgrade guide below
 
 ### Deprecated
 
@@ -536,6 +540,33 @@ Hyperlinks::isRemote($source);
 
 This change was implemented in https://github.com/hydephp/develop/pull/1883. Make sure to update any instances of `FeaturedImage::isRemote()` in your codebase to ensure compatibility with HydePHP v2.0.
 
+### Routes facade API changes
+
+The Routes facade API has been improved to better follow Laravel naming conventions and make the API more intuitive. This change affects code that directly uses the Routes facade methods.
+
+#### Changes
+
+- The `Routes::get()` method has been renamed to `Routes::find()` to better indicate that it may return null if a route is not found
+- The `Routes::getOrFail()` method has been renamed to `Routes::get()` to make the exception-throwing behavior the default, matching Laravel conventions
+
+#### Upgrade guide
+
+If you have used the Routes facade in your custom code, update it as follows:
+
+```php
+// Old code:
+$route = Routes::get('some-route'); // Returns null if not found
+$route = Routes::getOrFail('some-route'); // Throws exception if not found
+
+// New code:
+$route = Routes::find('some-route'); // Returns null if not found
+$route = Routes::get('some-route'); // Throws exception if not found
+```
+
+This change provides more intuitive method names and better type safety, with `find()` returning `?Route` and `get()` returning `Route`.
+
+This change was implemented in https://github.com/hydephp/develop/pull/2179.
+
 ## New Asset System
 
 ### Abstract

From b4621905dd93c8149432ec70f93decb1457dcfc2 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 22:00:55 +0200
Subject: [PATCH 4013/4023] Add null safe new line helper to build tasks

---
 .../src/Framework/Features/BuildTasks/BuildTask.php          | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php b/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
index 26c6a470519..ac226bdde98 100644
--- a/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
+++ b/packages/framework/src/Framework/Features/BuildTasks/BuildTask.php
@@ -90,6 +90,11 @@ public function writeln(string $message): void
         $this->output?->writeln($message);
     }
 
+    public function newLine(int $count = 1): void
+    {
+        $this->output?->newLine($count);
+    }
+
     /**
      * Write a fluent message to the output that the task is skipping and halt the execution.
      *

From 2f2ec3e7f5b097b344edb2e9595b5d0103b01d2e Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 21:32:16 +0200
Subject: [PATCH 4014/4023] Skip transferring media files when using CDN

---
 .../Framework/Actions/PreBuildTasks/TransferMediaAssets.php  | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 05dda5e7c00..65f20503fef 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -4,6 +4,7 @@
 
 namespace Hyde\Framework\Actions\PreBuildTasks;
 
+use Hyde\Facades\Config;
 use Hyde\Facades\Filesystem;
 use Hyde\Support\Filesystem\MediaFile;
 use Hyde\Framework\Features\BuildTasks\PreBuildTask;
@@ -23,6 +24,10 @@ public function handle(): void
             $this->skip("No media files to transfer.\n");
         }
 
+        if (Config::getBool('hyde.load_app_styles_from_cdn') && MediaFile::files() === ['app.css']) {
+            $this->skip("No media files to transfer, using CDN.\n");
+        }
+
         $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {
             $sitePath = $file->getOutputPath();
             $this->needsParentDirectory($sitePath);

From 9e2c9d3607ee801ab9d28b8c1cbfb5e0d64e29f6 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 21:36:25 +0200
Subject: [PATCH 4015/4023] Smartly skip just app styles when using CDN

---
 .../Actions/PreBuildTasks/TransferMediaAssets.php    | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index 65f20503fef..f00dcbf7ee0 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -20,15 +20,17 @@ public function handle(): void
     {
         $this->newLine();
 
-        if (MediaFile::all()->isEmpty()) {
-            $this->skip("No media files to transfer.\n");
+        $files = MediaFile::all();
+
+        if (Config::getBool('hyde.load_app_styles_from_cdn')) {
+            $files->forget('app.css');
         }
 
-        if (Config::getBool('hyde.load_app_styles_from_cdn') && MediaFile::files() === ['app.css']) {
-            $this->skip("No media files to transfer, using CDN.\n");
+        if ($files->isEmpty()) {
+            $this->skip("No media files to transfer.\n");
         }
 
-        $this->withProgressBar(MediaFile::all(), function (MediaFile $file): void {
+        $this->withProgressBar($files, function (MediaFile $file): void {
             $sitePath = $file->getOutputPath();
             $this->needsParentDirectory($sitePath);
             Filesystem::putContents($sitePath, $file->getContents());

From d5d25e27938f3112216ac43072e1fc37d1091017 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 21:52:35 +0200
Subject: [PATCH 4016/4023] Set default value

---
 .../src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
index f00dcbf7ee0..ac6d3783204 100644
--- a/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
+++ b/packages/framework/src/Framework/Actions/PreBuildTasks/TransferMediaAssets.php
@@ -22,7 +22,7 @@ public function handle(): void
 
         $files = MediaFile::all();
 
-        if (Config::getBool('hyde.load_app_styles_from_cdn')) {
+        if (Config::getBool('hyde.load_app_styles_from_cdn', false)) {
             $files->forget('app.css');
         }
 

From accc4713ad87772c7967d8088ff0b83310879e53 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 21:52:54 +0200
Subject: [PATCH 4017/4023] Draft new unit test

---
 .../Unit/TransferMediaAssetsUnitTest.php      | 185 ++++++++++++++++++
 1 file changed, 185 insertions(+)
 create mode 100644 packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php

diff --git a/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php b/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php
new file mode 100644
index 00000000000..96a354d2b48
--- /dev/null
+++ b/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php
@@ -0,0 +1,185 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Hyde\Framework\Testing\Unit;
+
+use Hyde\Facades\Config;
+use Hyde\Facades\Filesystem;
+use Hyde\Foundation\HydeKernel;
+use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
+use Hyde\Framework\Features\BuildTasks\BuildTaskSkippedException;
+use Hyde\Support\Filesystem\MediaFile;
+use Hyde\Testing\UnitTestCase;
+use Illuminate\Console\OutputStyle;
+use Mockery;
+use Symfony\Component\Console\Input\ArrayInput;
+use Symfony\Component\Console\Output\BufferedOutput;
+
+/**
+ * @covers \Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets
+ */
+class TransferMediaAssetsUnitTest extends UnitTestCase
+{
+    protected TransferMediaAssets $task;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->task = new TransferMediaAssets();
+    }
+
+    public function testItCanBeInstantiated()
+    {
+        $this->assertInstanceOf(TransferMediaAssets::class, $this->task);
+    }
+
+    public function testGetMessage()
+    {
+        $this->assertSame('Transferring Media Assets', $this->task->getMessage());
+    }
+
+    public function testSkipsWhenNoMediaFiles()
+    {
+        // Mock MediaFile::all to return empty collection
+        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) {
+            $mock->shouldReceive('assets')->once()->andReturn(collect());
+        }));
+
+        $this->expectException(BuildTaskSkippedException::class);
+        $this->expectExceptionMessage("No media files to transfer.\n");
+
+        $this->task->handle();
+    }
+
+    public function testSkipsWhenOnlyAppCssAndUsingCdn()
+    {
+        // Mock Config::getBool to return true for hyde.load_app_styles_from_cdn
+        self::mockConfig(['hyde.load_app_styles_from_cdn' => true]);
+
+        // Mock MediaFile::files to return only app.css
+        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) {
+            $mock->shouldReceive('assets')->once()->andReturn(collect(['app.css' => new MediaFile('app.css')]));
+        }));
+
+        $this->expectException(BuildTaskSkippedException::class);
+        $this->expectExceptionMessage("No media files to transfer.\n");
+
+        $this->task->handle();
+    }
+
+    public function testExcludesAppCssWhenUsingCdn()
+    {
+        // Create a collection with multiple files including app.css
+        $mediaFiles = collect([
+            'app.css' => new MediaFile('app.css'),
+            'style.css' => new MediaFile('style.css'),
+            'image.jpg' => new MediaFile('image.jpg')
+        ]);
+
+        // The collection after forgetting app.css
+        $expectedFiles = collect([
+            'style.css' => new MediaFile('style.css'),
+            'image.jpg' => new MediaFile('image.jpg')
+        ]);
+
+        // Mock Config::getBool to return true for hyde.load_app_styles_from_cdn
+        self::mockConfig(['hyde.load_app_styles_from_cdn' => true]);
+
+        // Mock MediaFile::all to return our collection
+        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) use ($mediaFiles) {
+            $mock->shouldReceive('assets')->once()->andReturn($mediaFiles);
+        }));
+
+        // Mock methods on the task to prevent actual execution but verify correct flow
+        $taskMock = Mockery::mock(TransferMediaAssets::class)->makePartial();
+        $taskMock->shouldReceive('withProgressBar')
+            ->once()
+            ->with(Mockery::on(function ($arg) use ($expectedFiles) {
+                // Verify app.css is not in the collection
+                return !$arg->has('app.css') && $arg->count() === 2;
+            }), Mockery::type('Closure'))
+            ->andReturn(null);
+
+        $taskMock->shouldReceive('newLine')->twice();
+
+        $taskMock->handle();
+    }
+
+    public function testTransfersMediaFiles()
+    {
+        // Create a collection with media files
+        $file1 = new MediaFile('style.css');
+        $file2 = new MediaFile('image.jpg');
+
+        $mediaFiles = collect([
+            'style.css' => $file1,
+            'image.jpg' => $file2
+        ]);
+
+        // Mock Config::getBool to return false for hyde.load_app_styles_from_cdn
+        self::mockConfig(['hyde.load_app_styles_from_cdn' => false]);
+
+        // Mock MediaFile::all to return our collection
+        $this->mock(MediaFile::class, function ($mock) use ($mediaFiles) {
+            $mock->shouldReceive('all')->once()->andReturn($mediaFiles);
+            $mock->shouldReceive('files')->never();
+        });
+
+        // Create a mock for the TransferMediaAssets class
+        $taskMock = Mockery::mock(TransferMediaAssets::class)->makePartial();
+
+        // Mock withProgressBar to execute the callback for each file
+        $taskMock->shouldReceive('withProgressBar')
+            ->once()
+            ->with(Mockery::type('Illuminate\Support\Collection'), Mockery::type('Closure'))
+            ->andReturnUsing(function ($files, $callback) {
+                foreach ($files as $file) {
+                    $callback($file);
+                }
+            });
+
+        // Mock needsParentDirectory to prevent actual directory creation
+        $taskMock->shouldReceive('needsParentDirectory')->twice();
+
+        // Mock Filesystem::putContents to verify it's called with the right parameters
+        $this->mock(Filesystem::class, function ($mock) use ($file1, $file2) {
+            $mock->shouldReceive('putContents')
+                ->once()
+                ->with($file1->getOutputPath(), $file1->getContents());
+
+            $mock->shouldReceive('putContents')
+                ->once()
+                ->with($file2->getOutputPath(), $file2->getContents());
+        });
+
+        $taskMock->shouldReceive('newLine')->twice();
+
+        $taskMock->handle();
+    }
+
+    public function testPrintFinishMessageDoesNothing()
+    {
+        ob_start();
+        $this->task->printFinishMessage();
+        $output = ob_get_clean();
+
+        $this->assertEmpty($output);
+    }
+
+    public function testNeedsParentDirectoryCreatesDirectory()
+    {
+        // Mock Filesystem::makeDirectory to verify it's called
+        $this->mock(Filesystem::class, function ($mock) {
+            $mock->shouldReceive('makeDirectory')
+                ->once()
+                ->with('path/to', true);
+        });
+
+        // Use reflection to call protected method
+        $method = new \ReflectionMethod(TransferMediaAssets::class, 'needsParentDirectory');
+        $method->setAccessible(true);
+        $method->invoke($this->task, 'path/to/file.txt');
+    }
+}
\ No newline at end of file

From ec8c637f286616d5f8110c52c51528fc4dd9c8e3 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 22:10:28 +0200
Subject: [PATCH 4018/4023] Revert "Draft new unit test"

This reverts commit d03636b7f87e7f37ec6ce52e448308f6b103f968.
---
 .../Unit/TransferMediaAssetsUnitTest.php      | 185 ------------------
 1 file changed, 185 deletions(-)
 delete mode 100644 packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php

diff --git a/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php b/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php
deleted file mode 100644
index 96a354d2b48..00000000000
--- a/packages/framework/tests/Unit/TransferMediaAssetsUnitTest.php
+++ /dev/null
@@ -1,185 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Hyde\Framework\Testing\Unit;
-
-use Hyde\Facades\Config;
-use Hyde\Facades\Filesystem;
-use Hyde\Foundation\HydeKernel;
-use Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets;
-use Hyde\Framework\Features\BuildTasks\BuildTaskSkippedException;
-use Hyde\Support\Filesystem\MediaFile;
-use Hyde\Testing\UnitTestCase;
-use Illuminate\Console\OutputStyle;
-use Mockery;
-use Symfony\Component\Console\Input\ArrayInput;
-use Symfony\Component\Console\Output\BufferedOutput;
-
-/**
- * @covers \Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets
- */
-class TransferMediaAssetsUnitTest extends UnitTestCase
-{
-    protected TransferMediaAssets $task;
-
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        $this->task = new TransferMediaAssets();
-    }
-
-    public function testItCanBeInstantiated()
-    {
-        $this->assertInstanceOf(TransferMediaAssets::class, $this->task);
-    }
-
-    public function testGetMessage()
-    {
-        $this->assertSame('Transferring Media Assets', $this->task->getMessage());
-    }
-
-    public function testSkipsWhenNoMediaFiles()
-    {
-        // Mock MediaFile::all to return empty collection
-        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) {
-            $mock->shouldReceive('assets')->once()->andReturn(collect());
-        }));
-
-        $this->expectException(BuildTaskSkippedException::class);
-        $this->expectExceptionMessage("No media files to transfer.\n");
-
-        $this->task->handle();
-    }
-
-    public function testSkipsWhenOnlyAppCssAndUsingCdn()
-    {
-        // Mock Config::getBool to return true for hyde.load_app_styles_from_cdn
-        self::mockConfig(['hyde.load_app_styles_from_cdn' => true]);
-
-        // Mock MediaFile::files to return only app.css
-        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) {
-            $mock->shouldReceive('assets')->once()->andReturn(collect(['app.css' => new MediaFile('app.css')]));
-        }));
-
-        $this->expectException(BuildTaskSkippedException::class);
-        $this->expectExceptionMessage("No media files to transfer.\n");
-
-        $this->task->handle();
-    }
-
-    public function testExcludesAppCssWhenUsingCdn()
-    {
-        // Create a collection with multiple files including app.css
-        $mediaFiles = collect([
-            'app.css' => new MediaFile('app.css'),
-            'style.css' => new MediaFile('style.css'),
-            'image.jpg' => new MediaFile('image.jpg')
-        ]);
-
-        // The collection after forgetting app.css
-        $expectedFiles = collect([
-            'style.css' => new MediaFile('style.css'),
-            'image.jpg' => new MediaFile('image.jpg')
-        ]);
-
-        // Mock Config::getBool to return true for hyde.load_app_styles_from_cdn
-        self::mockConfig(['hyde.load_app_styles_from_cdn' => true]);
-
-        // Mock MediaFile::all to return our collection
-        HydeKernel::setInstance(Mockery::mock(new HydeKernel(), function ($mock) use ($mediaFiles) {
-            $mock->shouldReceive('assets')->once()->andReturn($mediaFiles);
-        }));
-
-        // Mock methods on the task to prevent actual execution but verify correct flow
-        $taskMock = Mockery::mock(TransferMediaAssets::class)->makePartial();
-        $taskMock->shouldReceive('withProgressBar')
-            ->once()
-            ->with(Mockery::on(function ($arg) use ($expectedFiles) {
-                // Verify app.css is not in the collection
-                return !$arg->has('app.css') && $arg->count() === 2;
-            }), Mockery::type('Closure'))
-            ->andReturn(null);
-
-        $taskMock->shouldReceive('newLine')->twice();
-
-        $taskMock->handle();
-    }
-
-    public function testTransfersMediaFiles()
-    {
-        // Create a collection with media files
-        $file1 = new MediaFile('style.css');
-        $file2 = new MediaFile('image.jpg');
-
-        $mediaFiles = collect([
-            'style.css' => $file1,
-            'image.jpg' => $file2
-        ]);
-
-        // Mock Config::getBool to return false for hyde.load_app_styles_from_cdn
-        self::mockConfig(['hyde.load_app_styles_from_cdn' => false]);
-
-        // Mock MediaFile::all to return our collection
-        $this->mock(MediaFile::class, function ($mock) use ($mediaFiles) {
-            $mock->shouldReceive('all')->once()->andReturn($mediaFiles);
-            $mock->shouldReceive('files')->never();
-        });
-
-        // Create a mock for the TransferMediaAssets class
-        $taskMock = Mockery::mock(TransferMediaAssets::class)->makePartial();
-
-        // Mock withProgressBar to execute the callback for each file
-        $taskMock->shouldReceive('withProgressBar')
-            ->once()
-            ->with(Mockery::type('Illuminate\Support\Collection'), Mockery::type('Closure'))
-            ->andReturnUsing(function ($files, $callback) {
-                foreach ($files as $file) {
-                    $callback($file);
-                }
-            });
-
-        // Mock needsParentDirectory to prevent actual directory creation
-        $taskMock->shouldReceive('needsParentDirectory')->twice();
-
-        // Mock Filesystem::putContents to verify it's called with the right parameters
-        $this->mock(Filesystem::class, function ($mock) use ($file1, $file2) {
-            $mock->shouldReceive('putContents')
-                ->once()
-                ->with($file1->getOutputPath(), $file1->getContents());
-
-            $mock->shouldReceive('putContents')
-                ->once()
-                ->with($file2->getOutputPath(), $file2->getContents());
-        });
-
-        $taskMock->shouldReceive('newLine')->twice();
-
-        $taskMock->handle();
-    }
-
-    public function testPrintFinishMessageDoesNothing()
-    {
-        ob_start();
-        $this->task->printFinishMessage();
-        $output = ob_get_clean();
-
-        $this->assertEmpty($output);
-    }
-
-    public function testNeedsParentDirectoryCreatesDirectory()
-    {
-        // Mock Filesystem::makeDirectory to verify it's called
-        $this->mock(Filesystem::class, function ($mock) {
-            $mock->shouldReceive('makeDirectory')
-                ->once()
-                ->with('path/to', true);
-        });
-
-        // Use reflection to call protected method
-        $method = new \ReflectionMethod(TransferMediaAssets::class, 'needsParentDirectory');
-        $method->setAccessible(true);
-        $method->invoke($this->task, 'path/to/file.txt');
-    }
-}
\ No newline at end of file

From 026cd1fe2c90efc10cfd6b1a761c03b34de1f4ef Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 22:17:42 +0200
Subject: [PATCH 4019/4023] Test the app CSS file skipping

---
 .../tests/Feature/StaticSiteServiceTest.php   | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/packages/framework/tests/Feature/StaticSiteServiceTest.php b/packages/framework/tests/Feature/StaticSiteServiceTest.php
index 64376c3aa23..fc4449b162f 100644
--- a/packages/framework/tests/Feature/StaticSiteServiceTest.php
+++ b/packages/framework/tests/Feature/StaticSiteServiceTest.php
@@ -391,4 +391,60 @@ public function testSiteOutputDirectoryCanBeChangedInConfiguration()
 
         File::deleteDirectory(Hyde::path('_site/build'));
     }
+
+    public function testAppCssIsTransferredWhenLoadAppStylesFromCdnIsFalse()
+    {
+        config(['hyde.load_app_styles_from_cdn' => false]);
+
+        $this->artisan('build')->assertExitCode(0);
+
+        $this->assertFileExists(Hyde::path('_site/media/app.css'));
+        $this->assertFileEquals(Hyde::path('_media/app.css'), Hyde::path('_site/media/app.css'));
+    }
+
+    public function testAppCssIsNotTransferredWhenLoadAppStylesFromCdnIsTrue()
+    {
+        config(['hyde.load_app_styles_from_cdn' => true]);
+
+        $this->artisan('build')->assertExitCode(0);
+
+        $this->assertFileDoesNotExist(Hyde::path('_site/media/app.css'));
+    }
+
+    public function testOtherAssetsAreTransferredWhenLoadAppStylesFromCdnIsTrue()
+    {
+        config(['hyde.load_app_styles_from_cdn' => true]);
+        $this->file('_media/image.png', 'fake image data');
+
+        $this->artisan('build')->assertExitCode(0);
+
+        $this->assertFileDoesNotExist(Hyde::path('_site/media/app.css'));
+        $this->assertFileExists(Hyde::path('_site/media/image.png'));
+        $this->assertFileEquals(Hyde::path('_media/image.png'), Hyde::path('_site/media/image.png'));
+    }
+
+    public function testSkipMessageWhenOnlyAppCssExistsAndLoadAppStylesFromCdnIsTrue()
+    {
+        config(['hyde.load_app_styles_from_cdn' => true]);
+
+        $this->artisan('build')
+            ->expectsOutputToContain('Transferring Media Assets... ')
+            ->expectsOutputToContain('Skipped')
+            ->expectsOutputToContain('> No media files to transfer.')
+            ->assertExitCode(0);
+    }
+
+    public function testNormalTransferWhenMultipleAssetsExistAndLoadAppStylesFromCdnIsTrue()
+    {
+        config(['hyde.load_app_styles_from_cdn' => true]);
+        $this->file('_media/image.png', 'fake image data');
+
+        $this->artisan('build')
+            ->expectsOutputToContain('Transferring Media Assets...')
+            ->doesntExpectOutputToContain('Skipped')
+            ->assertExitCode(0);
+
+        $this->assertFileDoesNotExist(Hyde::path('_site/media/app.css'));
+        $this->assertFileExists(Hyde::path('_site/media/image.png'));
+    }
 }

From 790ce0dfb39f4033c66443c1bf600ff6a97e8d56 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 11 May 2025 22:27:25 +0200
Subject: [PATCH 4020/4023] Update RELEASE_NOTES.md

---
 RELEASE_NOTES.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index da44f86032c..36a9147980b 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -162,6 +162,7 @@ This serves two purposes:
 
 - Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
 - The `app.js` file will now only be compiled if it has scripts in https://github.com/hydephp/develop/pull/2028
+- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in https://github.com/hydephp/develop/pull/2180
 
 ### Security
 

From cbc3ed4a99138f1a20d59e772eb787e1f1744f0a Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 May 2025 09:20:15 +0200
Subject: [PATCH 4021/4023] Update supported versions for v2

---
 SECURITY.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/SECURITY.md b/SECURITY.md
index a155f70d1d5..5c325d806cd 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -6,7 +6,8 @@ These are the version ranges of HydePHP, and their support status. We follow [Se
 
 | Version | Supported          | Classification       |
 |---------|--------------------|----------------------|
-| 1.x LTS | :white_check_mark: | General Availability |
+| 2.x     | :white_check_mark: | General Availability |
+| 1.x LTS | :white_check_mark: | Long Term Support     |
 | < 0.64  | :x:                | Beta                 |
 | < 0.8   | :x:                | Alpha                |
 

From bd7dff98be3bc0629fcf8db54e0197362b6e5602 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 May 2025 09:20:25 +0200
Subject: [PATCH 4022/4023] Format whitespace

---
 docs/architecture-concepts/extensions-api.md  |  2 +-
 .../gh-pages/gh-pages-config/_docs/readme.md  |  1 -
 .../_posts/what-is-this-site.md               |  2 +-
 .../tests/Feature/AssetAPIFeatureTest.php     |  4 ++--
 .../Feature/Commands/MakePostCommandTest.php  |  4 ++--
 .../DynamicMarkdownLinksFeatureTest.php       |  4 ++--
 .../HighLevelYamlConfigurationFeatureTest.php |  2 +-
 .../tests/Feature/IncludesFacadeTest.php      | 24 +++++++++----------
 .../Feature/InternationalizationTest.php      |  4 ++--
 .../Feature/MarkdownHeadingRendererTest.php   | 10 ++++----
 .../Feature/PostsAuthorIntegrationTest.php    |  6 ++---
 .../Feature/YamlConfigurationFeatureTest.php  |  4 ++--
 .../tests/Unit/HeadingRendererUnitTest.php    |  2 +-
 .../tests/Unit/MarkdownHelpersTest.php        |  4 ++--
 packages/hyde/CONTRIBUTING.md                 |  2 +-
 15 files changed, 37 insertions(+), 38 deletions(-)

diff --git a/docs/architecture-concepts/extensions-api.md b/docs/architecture-concepts/extensions-api.md
index 7c6f4c7928e..8c5dbffa187 100644
--- a/docs/architecture-concepts/extensions-api.md
+++ b/docs/architecture-concepts/extensions-api.md
@@ -112,7 +112,7 @@ class JsonPageExtension extends HydeExtension {
 
 The `booting` callback can be used to set up the system with information needed to discover pages, while the `booted` callback can can be used to perform operations requiring knowledge of discovered data, even modifying them if needed.
 
-These callbacks provide powerful hooks into the Hyde system, allowing your extensions to integrate deeply and modify Hyde's behavior as needed. 
+These callbacks provide powerful hooks into the Hyde system, allowing your extensions to integrate deeply and modify Hyde's behavior as needed.
 
 #### Discovery handler example
 
diff --git a/monorepo/gh-pages/gh-pages-config/_docs/readme.md b/monorepo/gh-pages/gh-pages-config/_docs/readme.md
index b466100a7fe..febc9febdc6 100644
--- a/monorepo/gh-pages/gh-pages-config/_docs/readme.md
+++ b/monorepo/gh-pages/gh-pages-config/_docs/readme.md
@@ -40,4 +40,3 @@ Lorem ipsum, dolor sit amet consectetur adipisicing elit. Nesciunt unde, eum lab
 And they have smooth scrolling and support up to 4 levels of nesting by default
 
 Try it out on the [headings](headings.html) page.
-
diff --git a/monorepo/gh-pages/gh-pages-config/_posts/what-is-this-site.md b/monorepo/gh-pages/gh-pages-config/_posts/what-is-this-site.md
index 71448ff62e8..5c33b63e261 100644
--- a/monorepo/gh-pages/gh-pages-config/_posts/what-is-this-site.md
+++ b/monorepo/gh-pages/gh-pages-config/_posts/what-is-this-site.md
@@ -4,7 +4,7 @@ description: Wondering what this site is for? Read this!
 category: information
 author: Mr Hyde
 date: 2022-06-08 18:34
-image: 
+image:
   source: cover.png
   author: Pixabay
   credit: https://pixabay.com/illustrations/banner-background-bright-design-1989514/
diff --git a/packages/framework/tests/Feature/AssetAPIFeatureTest.php b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
index c80f9a75814..73c26047125 100644
--- a/packages/framework/tests/Feature/AssetAPIFeatureTest.php
+++ b/packages/framework/tests/Feature/AssetAPIFeatureTest.php
@@ -76,7 +76,7 @@ public function testAssetAPIUsagesInBladeViews()
             <link rel="stylesheet" href="{{ Hyde::asset('app.css') }}">
             <link rel="stylesheet" href="{{ asset('app.css') }}">
         @endif
-        
+
         @if(Asset::exists('missing.png'))
             Found missing.png
         @else
@@ -90,7 +90,7 @@ public function testAssetAPIUsagesInBladeViews()
         <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
             <link rel="stylesheet" href="media/app.css?v={$this->getAppStylesVersion()}">
-        
+
             Missing missing.png
 
         HTML, $html);
diff --git a/packages/framework/tests/Feature/Commands/MakePostCommandTest.php b/packages/framework/tests/Feature/Commands/MakePostCommandTest.php
index e94b3a53a4a..2967ab31fd5 100644
--- a/packages/framework/tests/Feature/Commands/MakePostCommandTest.php
+++ b/packages/framework/tests/Feature/Commands/MakePostCommandTest.php
@@ -47,9 +47,9 @@ public function testCommandHasExpectedOutputAndCreatesValidFile()
             author: 'Mr Hyde'
             date: '2024-01-01 12:00'
             ---
-            
+
             ## Write something awesome.
-            
+
             MARKDOWN,
             Hyde::path('_posts/test-post.md')
         );
diff --git a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
index 98cfb893193..458160b2ee7 100644
--- a/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
+++ b/packages/framework/tests/Feature/DynamicMarkdownLinksFeatureTest.php
@@ -270,7 +270,7 @@ public function testDynamicMarkdownLinksForDifferentPageTypes()
         [Contact](/_pages/about/contact.md)
         [About](/_pages/about/index.md)
         [Post](/_posts/hello-world.md)
-        
+
         ![Logo](/_media/logo.png)
         MARKDOWN);
 
@@ -313,7 +313,7 @@ public function testDynamicMarkdownLinksUseTheSitePrettyUrlConfiguration()
         [Contact](/_pages/about/contact.md)
         [About](/_pages/about/index.md)
         [Post](/_posts/hello-world.md)
-        
+
         ![Logo](/_media/logo.png)
         MARKDOWN);
 
diff --git a/packages/framework/tests/Feature/HighLevelYamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/HighLevelYamlConfigurationFeatureTest.php
index 59e28cd5519..a31b7a29427 100644
--- a/packages/framework/tests/Feature/HighLevelYamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/HighLevelYamlConfigurationFeatureTest.php
@@ -51,7 +51,7 @@ protected function setUpConfigurationBeforeApplicationBoots(): void
         YAML);
 
         file_put_contents('config/custom.php', <<<'PHP'
-        <?php   
+        <?php
         return [
             'setting_one' => 'Default',
             'setting_three' => 'Inherited'
diff --git a/packages/framework/tests/Feature/IncludesFacadeTest.php b/packages/framework/tests/Feature/IncludesFacadeTest.php
index 3ee7b835836..1b6229e566b 100644
--- a/packages/framework/tests/Feature/IncludesFacadeTest.php
+++ b/packages/framework/tests/Feature/IncludesFacadeTest.php
@@ -135,29 +135,29 @@ public function testAdvancedMarkdownDocumentIsCompiledToHtml()
     {
         $markdown = <<<'MARKDOWN'
         # Heading
-        
+
         This is a paragraph. It has some **bold** and *italic* text.
-        
+
         >info Info Blockquote
-        
+
         ```php
         // filepath: hello.php
         echo 'Hello, World!';
         ```
-        
+
         ## Subheading
-        
-        
+
+
         - [x] Checked task list
         - [ ] Unchecked task list
-        
+
         ### Table
-        
+
         | Syntax | Description |
         | ----------- | ----------- |
         | Header | Title |
         | Paragraph | Text |
-        
+
         MARKDOWN;
 
         $expected = <<<'HTML'
@@ -215,7 +215,7 @@ public function testAdvancedBladePartialIsCompiledToHtml()
             <p>Paragraph 1</p>
             <p>Paragraph 2</p>
             <p>Paragraph 3</p>
-        
+
         foo bar
         HTML;
 
@@ -236,12 +236,12 @@ public function testIncludesUsageFromBladeView()
         {!! Includes::html('foo.html') !!}
         {!! Includes::blade('foo.blade.php') !!}
         {!! Includes::markdown('foo.md') !!}
-        
+
         // Without extension
         {!! Includes::html('foo') !!}
         {!! Includes::blade('foo') !!}
         {!! Includes::markdown('foo') !!}
-        
+
         // With escaped
         {{ Includes::html('foo.html') }}
         {{ Includes::blade('foo.blade.php') }}
diff --git a/packages/framework/tests/Feature/InternationalizationTest.php b/packages/framework/tests/Feature/InternationalizationTest.php
index 04e6d6fa861..450e342c030 100644
--- a/packages/framework/tests/Feature/InternationalizationTest.php
+++ b/packages/framework/tests/Feature/InternationalizationTest.php
@@ -52,9 +52,9 @@ public function testCanCreateBlogPostFilesWithInternationalCharacterSets(
         author: default
         date: '2024-12-22 10:45'
         ---
-        
+
         ## Write something awesome.
-        
+
         EOF, $contents);
 
         Filesystem::unlink($path);
diff --git a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
index a254be2949d..be3bb352183 100644
--- a/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
+++ b/packages/framework/tests/Feature/MarkdownHeadingRendererTest.php
@@ -77,7 +77,7 @@ public function testSetextStyleHeadings()
         $markdown = <<<'MARKDOWN'
         Heading 1
         =========
-        
+
         Heading 2
         ---------
         MARKDOWN;
@@ -104,7 +104,7 @@ public function testHeadingsWithCustomAttributes()
         $this->assertSame(<<<'HTML'
         <h2 class="custom-class" id="custom-id">Heading</h2>
         <h3 data-test="value" >Another Heading</h3>
-        
+
         HTML, $html);
     }
 
@@ -123,7 +123,7 @@ public function testHeadingsWithCustomAttributesAndPermalinks()
         $this->assertSame(<<<'HTML'
         <h2 class="custom-class group w-fit scroll-mt-2" id="heading">Heading<a href="#heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
         <h3 data-test="value" id="another-heading" class="group w-fit scroll-mt-2">Another Heading<a href="#another-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
-        
+
         HTML, $html);
     }
 
@@ -157,7 +157,7 @@ public function testPermalinkConfigurationLevels()
         <h4 id="h4-has-permalink" class="group w-fit scroll-mt-2">H4 Has Permalink<a href="#h4-has-permalink" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
         <h5>H5 No Permalink</h5>
         <h6>H6 No Permalink</h6>
-        
+
         HTML, $html);
     }
 
@@ -270,7 +270,7 @@ public function testItHandlesMultipleHeadingsWithTheSameName()
         <h2 id="heading-3" class="group w-fit scroll-mt-2">Heading<a href="#heading-3" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h2>
         <h3 id="heading-4" class="group w-fit scroll-mt-2">Heading<a href="#heading-4" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h3>
         <h4 id="heading-5" class="group w-fit scroll-mt-2">Heading<a href="#heading-5" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a></h4>
-        
+
         HTML, $html);
     }
 
diff --git a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
index c88d2389929..85c653095ec 100644
--- a/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
+++ b/packages/framework/tests/Feature/PostsAuthorIntegrationTest.php
@@ -106,7 +106,7 @@ public function testAllPostAuthorFieldsCanBeSetInFrontMatter()
                     twitter: "@HydeFramework"
                     github: hydephp
             ---
-            
+
             # Post with all author fields
             MD
         );
@@ -151,7 +151,7 @@ public function testConfiguredPostAuthorFieldsCanBeOverriddenInFrontMatter()
             ---
             author: mr_hyde
             ---
-            
+
             # Using the configured author
             MD
         );
@@ -162,7 +162,7 @@ public function testConfiguredPostAuthorFieldsCanBeOverriddenInFrontMatter()
                 username: mr_hyde
                 name: Dr. Jekyll
             ---
-            
+
             # Modifying the configured author
             MD
         );
diff --git a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
index 5f2eefb0870..ccb9ed4f8ee 100644
--- a/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
+++ b/packages/framework/tests/Feature/YamlConfigurationFeatureTest.php
@@ -420,14 +420,14 @@ public function testCanSetAuthorsInTheYamlConfig()
             socials:
               twitter: '@user1'
               github: 'user1'
-        
+
           username2:
             name: 'User 2'
             bio: 'Bio of user 2'
             socials:
               twitter: '@user2'
               github: 'user2'
-        
+
           test:
             name: 'Test user'
             bio: 'Bio of test user' # TODO: support 'biography'
diff --git a/packages/framework/tests/Unit/HeadingRendererUnitTest.php b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
index 2b71abb4677..3724f0f2293 100644
--- a/packages/framework/tests/Unit/HeadingRendererUnitTest.php
+++ b/packages/framework/tests/Unit/HeadingRendererUnitTest.php
@@ -183,7 +183,7 @@ public function testPostProcessMethodNormalizesInputToMatchCommonMark()
         <h2 >
             Test Heading
                     <a id="test-heading" href="#test-heading" class="heading-permalink opacity-0 ml-1 transition-opacity duration-300 ease-linear px-1 group-hover:opacity-100 focus:opacity-100 group-hover:grayscale-0 focus:grayscale-0" title="Permalink">#</a>
-            </h2> 
+            </h2>
         HTML;
 
         // What CommonMark would generate from the same input Markdown
diff --git a/packages/framework/tests/Unit/MarkdownHelpersTest.php b/packages/framework/tests/Unit/MarkdownHelpersTest.php
index e0784327102..963a9714f32 100644
--- a/packages/framework/tests/Unit/MarkdownHelpersTest.php
+++ b/packages/framework/tests/Unit/MarkdownHelpersTest.php
@@ -121,9 +121,9 @@ public function testRenderWithCustomHydeMarkdownFeatures()
     {
         $html = Markdown::render(<<<'MARKDOWN'
         # Hello World
-        
+
         >info Colored blockquote
-        
+
         [Home](/_pages/index.blade.php)
         MARKDOWN);
 
diff --git a/packages/hyde/CONTRIBUTING.md b/packages/hyde/CONTRIBUTING.md
index 186b61f1180..f98cd799d73 100644
--- a/packages/hyde/CONTRIBUTING.md
+++ b/packages/hyde/CONTRIBUTING.md
@@ -83,4 +83,4 @@ Please note that this project adheres to a Code of Conduct. By participating, yo
 
 ---
 
-**Thank you for contributing to HydePHP!**
\ No newline at end of file
+**Thank you for contributing to HydePHP!**

From 1e7397032f567cd1d8fe87a9f96c902208b10939 Mon Sep 17 00:00:00 2001
From: Caen De Silva <caen@desilva.se>
Date: Sun, 18 May 2025 13:26:35 +0200
Subject: [PATCH 4023/4023] Parse and process release notes

---
 RELEASE_NOTES.md | 265 +++++++++++++++++++++--------------------------
 input.csv        | 109 +++++++++++++++++++
 output.md        | 127 +++++++++++++++++++++++
 parse.php        | 128 +++++++++++++++++++++++
 4 files changed, 481 insertions(+), 148 deletions(-)
 create mode 100644 input.csv
 create mode 100644 output.md
 create mode 100644 parse.php

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 36a9147980b..5e60ccdfe1c 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -11,162 +11,131 @@ This serves two purposes:
 
 ### Added
 
-- Added support for PHP 8.4 in https://github.com/hydephp/develop/pull/2141
-- Added a new Hyde Vite plugin in https://github.com/hydephp/develop/pull/2160
-- You can now specify sidebar item priorities by adding a numeric prefix to doc umentation page source file names in https://github.com/hydephp/develop/pull/1709
-- Added support for resolving dynamic links to source files in Markdown documents in https://github.com/hydephp/develop/pull/1590
-- Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task handle media assets transfers for site builds.
-- Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in https://github.com/hydephp/develop/pull/1732
-- Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in https://github.com/hydephp/develop/pull/1799
-- The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.
-- Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily in https://github.com/hydephp/develop/pull/1847
-- Added support for setting custom navigation items in the YAML configuration in https://github.com/hydephp/develop/pull/1818
-- Added support for setting extra attributes for navigation items in https://github.com/hydephp/develop/pull/1824
-- Added support for setting the blog post publishing date as a prefix in the source file name in https://github.com/hydephp/develop/pull/2000
-- Introduced a new navigation config builder class to simplify navigation configuration in https://github.com/hydephp/develop/pull/1827
-- You can now add custom posts to the blog post feed component when including it directly in https://github.com/hydephp/develop/pull/1893
-- Added a `Feature::fromName()` enum helper in https://github.com/hydephp/develop/pull/1895
-- Added environment variable support for saving previews in https://github.com/hydephp/develop/pull/1996
-- Added support for specifying features in the YAML configuration in https://github.com/hydephp/develop/pull/1896
-- Added Vite as a build tool in https://github.com/hydephp/develop/pull/2010
-- **Added a new consolidated Asset API to better handle media files.**
-    - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.
-    - Added new `HydeFront` facade to handle CDN links and Tailwind config injection.
-    - Added method `Asset::exists()` has to check if a media file exists.
-    - Added a `Hyde::assets()` method to get all media file instances in the site.
-- Added new `npm run build` command for compiling frontend assets with Vite
-- Added a Vite HMR support for the realtime compiler in https://github.com/hydephp/develop/pull/2016
-- Added Vite facade in https://github.com/hydephp/develop/pull/2016
-- Added a custom Blade-based heading renderer for Markdown conversions in https://github.com/hydephp/develop/pull/2047
-- The `publish:views` command is now interactive for Unix-like systems in https://github.com/hydephp/develop/pull/2062
-- Added a new simplified blog post image front matter schema using a new "caption" field in https://github.com/hydephp/develop/pull/2175
-
-### Changed
-
-- **Breaking:** We now support PHP [8.2, 8.3, 8.4] instead of [8.1, 8.2, 8.3] in https://github.com/hydephp/develop/pull/2141
-- **Breaking:** We upgraded from the TailwindCSS version from v3 v4. You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details. Introduced in https://github.com/hydephp/develop/pull/2146.
-- **Breaking:** We switched from using CJS to ESM in the frontend tool scaffolding. If you have custom script includes you need to migrate them. See below and in https://github.com/hydephp/develop/pull/2159 for details.
-- **Breaking:** The internals of the navigation system has been rewritten into a new Navigation API. This change is breaking for custom navigation implementations. For more information, see below.
-- **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls. For more information, see below.
-- **Breaking:** Renamed class `DataCollections` to `DataCollection`. For more information, see below.
-- **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames. For more information, see below.
-- **Breaking:** The `Author::create()` method now returns an array instead of a `PostAuthor` instance. For more information, see below.
-- **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance. For more information, see below.
-- **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format. For more information, see the upgrade guide below.
-- **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.
-- **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in https://github.com/hydephp/develop/pull/1980
-- Renamed the parameter `category` to `group` in the `publish:views` command in https://github.com/hydephp/develop/pull/2166
-- Dependency: Upgraded from Laravel 10 to Laravel 11
-- Dependency: Updated minimum PHP requirement to 8.2
-- Dependency: Updated Symfony/yaml to ^7.0
-- Dependency: Updated illuminate/support and illuminate/view to ^11.0
-- Dependency: Switched to forked version of the Torchlight client
-- Medium: The `route` function will now throw a `RouteNotFoundException` if the route does not exist in https://github.com/hydephp/develop/pull/1741
-- Minor: Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in https://github.com/hydephp/develop/pull/1573
-- Minor: Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
-- Minor: The documentation article component now supports disabling the semantic rendering using a falsy value in https://github.com/hydephp/develop/pull/1566
-- Minor: Changed the default build task message to make it more concise in https://github.com/hydephp/develop/pull/1659
-- Minor: Data collection files are now validated for syntax errors during discovery in https://github.com/hydephp/develop/pull/1732
-- Minor: Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in https://github.com/hydephp/develop/pull/1738. For more information, see below.
-- Minor: `Includes::path()` and `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in https://github.com/hydephp/develop/pull/1738. This means that nested directories are no longer supported, as you should use a data collection for that.
-- Minor: The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in https://github.com/hydephp/develop/pull/1744
-- Minor: Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in https://github.com/hydephp/develop/pull/1760 and https://github.com/hydephp/develop/pull/1890
-- Minor: Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in https://github.com/hydephp/develop/pull/1887
-- Updated default configuration to no longer save previewed pages in https://github.com/hydephp/develop/pull/1995
-- Added more rich markup data to blog post components in https://github.com/hydephp/develop/pull/1888 (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
-- Overhauled the blog post author feature in https://github.com/hydephp/develop/pull/1782
-- Improved the sitemap data generation to be smarter and more dynamic in https://github.com/hydephp/develop/pull/1744
-- Skipped build tasks will now exit with an exit code of 3 instead of 0 in https://github.com/hydephp/develop/pull/1749
-- The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.
-- Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.
-- Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.
-- Calling the `Include::path()` method will no longer create the includes directory in https://github.com/hydephp/develop/pull/1707
-- Calling the `DataCollection` methods will no longer create the data collections directory in https://github.com/hydephp/develop/pull/1732
-- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in https://github.com/hydephp/develop/pull/1738
-- Markdown returned from includes are now trimmed of trailing whitespace and newlines in https://github.com/hydephp/develop/pull/1738
-- Reorganized and cleaned up the navigation and sidebar documentation for improved clarity.
-- Moved the sidebar documentation to the documentation pages section for better organization.
-- The build command now groups together all `InMemoryPage` instances under one progress bar group in https://github.com/hydephp/develop/pull/1897
-- The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in https://github.com/hydephp/develop/pull/1900
-- Improved how the `MarkdownService` class is accessed, by binding it into the service container, in https://github.com/hydephp/develop/pull/1922
-- Improved the media asset transfer build task to have better output in https://github.com/hydephp/develop/pull/1904
-- The full page documentation search now generates it's heading using smarter natural language processing based on the configured sidebar header in https://github.com/hydephp/develop/pull/2032
-- Moved Blade view `hyde::pages.documentation-search` to `hyde::pages.docs.search` in https://github.com/hydephp/develop/pull/2033
-- **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.
-    - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.
-    - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.
-    - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).
-    - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.
-    - Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957
-    - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904
-    - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911
-    - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in https://github.com/hydephp/develop/pull/1911
-    - We will now throw an exception if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in https://github.com/hydephp/develop/pull/1932
+- **Added a new consolidated Asset API to better handle media files.** in [#2006](https://github.com/hydephp/develop/pull/2006)
+  - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc
+  - Added new `HydeFront` facade to handle CDN links and Tailwind config injection
+  - Added method `Asset::exists()` to check if a media file exists
+  - Added a `Hyde::assets()` method to get all media file instances in the site
+- **Improved Routes facade API with more intuitive method names** in [#2179](https://github.com/hydephp/develop/pull/2179)
+  - **Breaking:** Renamed `Routes::get()` to `Routes::find()` to better indicate it may return null
+  - **Breaking:** Renamed `Routes::getOrFail()` to `Routes::get()` to make the exception-throwing behavior the default and match Laravel conventions
+  - This change requires code updates if you were using these methods - see upgrade guide below
+- **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files
+  - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it
+  - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class
+  - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior)
+  - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist
+  - Renamed method `Asset::hasMediaFile` to `Asset::exists` in [#1957](https://github.com/hydephp/develop/pull/1957)
+  - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in [#1904](https://github.com/hydephp/develop/pull/1904)
+  - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in [#1911](https://github.com/hydephp/develop/pull/1911)
+  - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in [#1911](https://github.com/hydephp/develop/pull/1911)
+  - An exception will now be thrown if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in [#1932](https://github.com/hydephp/develop/pull/1932)
 - **MediaFile performance improvements:**
-    - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917
-    - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933
-    - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918
-- **Replaced Laravel Mix with Vite for frontend asset compilation** in https://github.com/hydephp/develop/pull/2010
-    - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
-    - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011
-- The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in https://github.com/hydephp/develop/pull/2012
-- **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in https://github.com/hydephp/develop/pull/2013
-- Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in https://github.com/hydephp/develop/pull/2013
-- Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
-    - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029
-    - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
-- Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in https://github.com/hydephp/develop/pull/2036.
-- Extracted CSS component partials in HydeFront in https://github.com/hydephp/develop/pull/2038
-- Replaced HydeFront styles with Tailwind in https://github.com/hydephp/develop/pull/2024
-- Markdown headings are now compiled using our custom Blade-based heading renderer in https://github.com/hydephp/develop/pull/2047
-    - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
-- Colored Markdown blockquotes are now rendered using Blade and TailwindCSS, this change is not visible in the rendered result, but the HTML output has changed in https://github.com/hydephp/develop/pull/2056
-- **Improved Routes facade API with more intuitive method names** in https://github.com/hydephp/develop/pull/2179
-    - **Breaking:** Renamed `Routes::get()` to `Routes::find()` to better indicate it may return null
-    - **Breaking:** Renamed `Routes::getOrFail()` to `Routes::get()` to make the exception-throwing behavior the default and match Laravel conventions
-    - This change requires code updates if you were using these methods - see upgrade guide below
-
-### Deprecated
-
-- for soon-to-be removed features.
+  - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in [#1917](https://github.com/hydephp/develop/pull/1917)
+  - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in [#1933](https://github.com/hydephp/develop/pull/1933)
+  - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in [#1918](https://github.com/hydephp/develop/pull/1918)
+- **Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation** in [#2029](https://github.com/hydephp/develop/pull/2029)
+  - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in [#2029](https://github.com/hydephp/develop/pull/2029)
+  - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in [#2031](https://github.com/hydephp/develop/pull/2031)
+- **Replaced Laravel Mix with Vite for frontend asset compilation** in [#2010](https://github.com/hydephp/develop/pull/2010)
+  - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
+  - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in [#2011](https://github.com/hydephp/develop/pull/2011)
+- Added Vite as a build tool in [#2010](https://github.com/hydephp/develop/pull/2010)
+- Added Vite facade in [#2016](https://github.com/hydephp/develop/pull/2016)
+- Added a Vite HMR support for the realtime compiler in [#2016](https://github.com/hydephp/develop/pull/2016)
+- Added a `Feature::fromName()` enum helper in [#1895](https://github.com/hydephp/develop/pull/1895)
+- Added a custom Blade-based heading renderer for Markdown conversions in [#2047](https://github.com/hydephp/develop/pull/2047)
+- Added a new Hyde Vite plugin in [#2160](https://github.com/hydephp/develop/pull/2160)
+- Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task to handle media assets transfers for site builds in [#1536](https://github.com/hydephp/develop/pull/1536)
+- Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in [#1799](https://github.com/hydephp/develop/pull/1799)
+- Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in [#1732](https://github.com/hydephp/develop/pull/1732)
+- Added a new simplified blog post image front matter schema using a new "caption" field in [#2175](https://github.com/hydephp/develop/pull/2175)
+- Added environment variable support for saving previews in [#1996](https://github.com/hydephp/develop/pull/1996)
+- Added new `npm run build` command for compiling frontend assets with Vite in [#2010](https://github.com/hydephp/develop/pull/2010)
+- Added support for PHP 8.4 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- Added support for resolving dynamic links to source files in Markdown documents in [#1590](https://github.com/hydephp/develop/pull/1590)
+- Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily in [#1847](https://github.com/hydephp/develop/pull/1847)
+- Added support for setting custom navigation items in the YAML configuration in [#1818](https://github.com/hydephp/develop/pull/1818)
+- Added support for setting extra attributes for navigation items in [#1824](https://github.com/hydephp/develop/pull/1824)
+- Added support for setting the blog post publishing date as a prefix in the source file name in [#2000](https://github.com/hydephp/develop/pull/2000)
+- Added support for specifying features in the YAML configuration in [#1896](https://github.com/hydephp/develop/pull/1896)
+- Introduced a new navigation config builder class to simplify navigation configuration in [#1827](https://github.com/hydephp/develop/pull/1827)
+- Markdown headings are now compiled using our custom Blade-based heading renderer in [#2047](https://github.com/hydephp/develop/pull/2047) - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in [#2052](https://github.com/hydephp/develop/pull/2052)
+- The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API in [#1647](https://github.com/hydephp/develop/pull/1647)
+- The `publish:views` command is now interactive on Unix-like systems in [#2062](https://github.com/hydephp/develop/pull/2062)
+- You can now add custom posts to the blog post feed component when including it directly in [#1893](https://github.com/hydephp/develop/pull/1893)
+- You can now specify sidebar item priorities by adding a numeric prefix to documentation page source file names in [#1709](https://github.com/hydephp/develop/pull/1709)
 
-### Removed
+### Changed
 
-- Breaking: Removed support for PHP 8.1 in https://github.com/hydephp/develop/pull/2141.
-- Breaking: Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch` (see upgrade guide below)
-- Breaking: Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method (see upgrade guide below)
-- Breaking: Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents in https://github.com/hydephp/develop/pull/2045
-- Breaking: Removed the `DocumentationPage::hasTableOfContents()` method as it is now unused by the framework in https://github.com/hydephp/develop/pull/2006
-- Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function in https://github.com/hydephp/develop/pull/1754
-- Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set in https://github.com/hydephp/develop/pull/1760
-- Removed: The deprecated `PostAuthor::getName()` method is now removed (use `$author->name`) in https://github.com/hydephp/develop/pull/1782
-- Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused in https://github.com/hydephp/develop/pull/1569
-- Removed the deprecated `FeaturedImage::isRemote()` method in https://github.com/hydephp/develop/pull/1883. Use `Hyperlinks::isRemote()` instead.
-- **With the new Asset API, a few features had to be moved/removed:**
-    - `AssetService` class has been removed (was merged into the `Asset` facade) in https://github.com/hydephp/develop/pull/1908
-    - Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907
-    - The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)
-    - Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932
-    - Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911
-    - Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911
-- Removed Laravel Mix as a dependency in https://github.com/hydephp/develop/pull/2010 (replaced with Vite)
-- **Breaking:** Removed `npm run prod` command (replaced with `npm run build`)
-- Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation in https://github.com/hydephp/develop/pull/2029
-    - This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component.
-- Removed the `.torchlight-enabled` CSS class in https://github.com/hydephp/develop/pull/2036.
-- Removed The `hyde.css` file from HydeFront in https://github.com/hydephp/develop/pull/2037 as all styles were refactored to Tailwind in https://github.com/hydephp/develop/pull/2024.
-- Removed the `MarkdownService::withPermalinks` method in https://github.com/hydephp/develop/pull/2047
-- Removed the `MarkdownService::canEnablePermalinks` method in https://github.com/hydephp/develop/pull/2047
+- **Breaking:** Renamed class `DataCollections` to `DataCollection` in [#1732](https://github.com/hydephp/develop/pull/1732)  For more information, see below.
+- **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in [#1980](https://github.com/hydephp/develop/pull/1980)
+- **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display` in [#1818](https://github.com/hydephp/develop/pull/1818)
+- **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in [#2013](https://github.com/hydephp/develop/pull/2013)
+- **Breaking:** The `Author::create()` method now returns an array instead of a `PostAuthor` instance in [#1798](https://github.com/hydephp/develop/pull/1798) For more information, see below.
+- **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance in [#1798](https://github.com/hydephp/develop/pull/1798)  For more information, see below.
+- **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames in [#1782](https://github.com/hydephp/develop/pull/1782) For more information, see below.
+- **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls in [#1649](https://github.com/hydephp/develop/pull/1649)  For more information, see below.
+- **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format in [#1818](https://github.com/hydephp/develop/pull/1818)  For more information, see the upgrade guide below.
+- **Breaking:** The navigation system internals have been rewritten into a new Navigation API in [#1568](https://github.com/hydephp/develop/pull/1568) This change is breaking for custom navigation implementations. For more information, see below.
+- **Breaking:** We now support PHP 8.2–8.4 instead of 8.1–8.3 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Breaking:** We switched from using CJS to ESM in the frontend tool scaffolding. If you have custom script includes you need to migrate them. See below and the pull request for details in [#2159](https://github.com/hydephp/develop/pull/2159)
+- **Breaking:** We upgraded from the TailwindCSS version from v3 to v4 in [#2146](https://github.com/hydephp/develop/pull/2146) You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details.
+- **Dependency:** Switched to forked version of the Torchlight client in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated Symfony/yaml to ^7.0 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated illuminate/support and illuminate/view to ^11.0 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated minimum PHP requirement to 8.2 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Upgraded from Laravel 10 to Laravel 11 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Medium:** The `route` function will now throw a `RouteNotFoundException` if the route does not exist in [#1741](https://github.com/hydephp/develop/pull/1741)
+- **Minor:** Changed the default build task message to make it more concise in [#1659](https://github.com/hydephp/develop/pull/1659)
+- **Minor:** Data collection files are now validated for syntax errors during discovery in [#1732](https://github.com/hydephp/develop/pull/1732)
+- **Minor:** Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
+- **Minor:** Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in [#1738](https://github.com/hydephp/develop/pull/1738) For more information, see below.
+- **Minor:** Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in [#1573](https://github.com/hydephp/develop/pull/1573)
+- **Minor:** The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in [#1744](https://github.com/hydephp/develop/pull/1744)
+- **Minor:** The documentation article component now supports disabling the semantic rendering using a falsy value in [#1566](https://github.com/hydephp/develop/pull/1566)
+- **Minor:** Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in [#1890](https://github.com/hydephp/develop/pull/1890)
+- **Minor:** Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in [#1887](https://github.com/hydephp/develop/pull/1887)
+- **Minor:** `Includes::path()` and `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in [#1738](https://github.com/hydephp/develop/pull/1738) This means that nested directories are no longer supported, as you should use a data collection for these
+- Added more rich markup data to blog post components in [#1888](https://github.com/hydephp/develop/pull/1888) (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
+- Calling the `DataCollection` methods will no longer create the data collections directory in [#1732](https://github.com/hydephp/develop/pull/1732)
+- Calling the `Include::path()` method will no longer create the includes directory in [#1707](https://github.com/hydephp/develop/pull/1707)
+- Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task in [#1498](https://github.com/hydephp/develop/pull/1498)
+- Colored Markdown blockquotes are now rendered using Blade and TailwindCSS in [#2056](https://github.com/hydephp/develop/pull/2056) This change is not visible in the rendered result, but the HTML output has changed
+- Extracted CSS component partials in HydeFront in [#2038](https://github.com/hydephp/develop/pull/2038)
+- Improved how the `MarkdownService` class is accessed by binding it into the service container in [#1922](https://github.com/hydephp/develop/pull/1922)
+- Improved the media asset transfer build task to have better output in [#1904](https://github.com/hydephp/develop/pull/1904)
+- Improved the sitemap data generation to be smarter and more dynamic in [#1744](https://github.com/hydephp/develop/pull/1744)
+- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in [#1738](https://github.com/hydephp/develop/pull/1738)
+- Markdown returned from includes are now trimmed of trailing whitespace and newlines in [#1738](https://github.com/hydephp/develop/pull/1738)
+- Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method in [#2024](https://github.com/hydephp/develop/pull/2024)
+- Moved Blade view `hyde::pages.documentation-search` to `hyde::pages.docs.search` in [#2033](https://github.com/hydephp/develop/pull/2033)
+- Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in [#2013](https://github.com/hydephp/develop/pull/2013)
+- Moved the sidebar documentation to the documentation pages section for better organization
+- Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in [#2036](https://github.com/hydephp/develop/pull/2036)
+- Overhauled the blog post author feature in [#1782](https://github.com/hydephp/develop/pull/1782)
+- Renamed the parameter `category` to `group` in the `publish:views` command in [#2166](https://github.com/hydephp/develop/pull/2166)
+- Reorganized and cleaned up the navigation and sidebar documentation for improved clarity
+- Replaced HydeFront styles with Tailwind in [#2024](https://github.com/hydephp/develop/pull/2024)
+- Skipped build tasks will now exit with an exit code of 3 instead of 0 in [#1749](https://github.com/hydephp/develop/pull/1749)
+- The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in [#1900](https://github.com/hydephp/develop/pull/1900)
+- The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter in [#1650](https://github.com/hydephp/develop/pull/1650)
+- The build command now groups together all `InMemoryPage` instances under one progress bar group in [#1897](https://github.com/hydephp/develop/pull/1897)
+- The full page documentation search now generates its heading using smarter natural language processing based on the configured sidebar header in [#2032](https://github.com/hydephp/develop/pull/2032)
+- The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in [#2012](https://github.com/hydephp/develop/pull/2012)
+- Updated default configuration to no longer save previewed pages in [#1995](https://github.com/hydephp/develop/pull/1995)
 
 ### Fixed
 
-- Added missing collection key types in Hyde facade method annotations in https://github.com/hydephp/develop/pull/1784
-- The `app.js` file will now only be compiled if it has scripts in https://github.com/hydephp/develop/pull/2028
-- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in https://github.com/hydephp/develop/pull/2180
+- Added missing collection key types in Hyde facade method annotations in [#1784](https://github.com/hydephp/develop/pull/1784)
+- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in [#2180](https://github.com/hydephp/develop/pull/2180)
+- The `app.js` file will now only be compiled if it has scripts in [#2028](https://github.com/hydephp/develop/pull/2028)
 
-### Security
+### Removed
 
-- in case of vulnerabilities.
+- Added missing collection key types in Hyde facade method annotations in [#1784](https://github.com/hydephp/develop/pull/1784)
+- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in [#2180](https://github.com/hydephp/develop/pull/2180)
+- The `app.js` file will now only be compiled if it has scripts in [#2028](https://github.com/hydephp/develop/pull/2028)
 
 ### Package updates
 
diff --git a/input.csv b/input.csv
new file mode 100644
index 00000000000..3ca26b4d8a5
--- /dev/null
+++ b/input.csv
@@ -0,0 +1,109 @@
+Type,Status,Description,Pull request number,Details
+Added,null,Added support for resolving dynamic links to source files in Markdown documents,1590,
+Added,null,You can now specify sidebar item priorities by adding a numeric prefix to documentation page source file names,1709,
+Added,null,Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files,1732,
+Added,null,Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions,1799,
+Added,null,Added support for setting custom navigation items in the YAML configuration,1818,
+Added,null,Added support for setting extra attributes for navigation items,1824,
+Added,null,Introduced a new navigation config builder class to simplify navigation configuration,1827,
+Added,null,"Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily",1847,
+Added,null,You can now add custom posts to the blog post feed component when including it directly,1893,
+Added,null,Added a `Feature::fromName()` enum helper,1895,
+Added,null,Added support for specifying features in the YAML configuration,1896,
+Added,null,Added environment variable support for saving previews,1996,
+Added,null,Added support for setting the blog post publishing date as a prefix in the source file name,2000,
+Added,null,Added Vite as a build tool,2010,
+Added,null,Added a Vite HMR support for the realtime compiler,2016,
+Added,null,Added Vite facade,2016,
+Added,null,Added a custom Blade-based heading renderer for Markdown conversions,2047,
+Added,null,The `publish:views` command is now interactive on Unix-like systems,2062,
+Added,null,Added support for PHP 8.4,2141,
+Added,null,Added a new Hyde Vite plugin,2160,
+Added,null,"Added a new simplified blog post image front matter schema using a new ""caption"" field",2175,
+Added,null,Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task to handle media assets transfers for site builds.,1536,
+Added,null,"The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API.",1647,
+Added,null,Added new `npm run build` command for compiling frontend assets with Vite,2010,
+Changed,Minor,The documentation article component now supports disabling the semantic rendering using a falsy value,1566,
+Changed,Minor,Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu),1573,
+Changed,Minor,Changed the default build task message to make it more concise,1659,
+Changed,null,Calling the `Include::path()` method will no longer create the includes directory,1707,
+Changed,Minor,Data collection files are now validated for syntax errors during discovery,1732,
+Changed,null,Calling the `DataCollection` methods will no longer create the data collections directory,1732,
+Changed,null,"Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels",1738,
+Changed,null,Markdown returned from includes are now trimmed of trailing whitespace and newlines,1738,
+Changed,Minor,Methods in the `Includes` facade now return `HtmlString` objects instead of `string`,1738,"For more information, see below."
+Changed,Minor,`Includes::path()` and `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods,1738,"This means that nested directories are no longer supported, as you should use a data collection for these"
+Changed,Medium,The `route` function will now throw a `RouteNotFoundException` if the route does not exist,1741,
+Changed,Minor,The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed,1744,
+Changed,null,Improved the sitemap data generation to be smarter and more dynamic,1744,
+Changed,null,Skipped build tasks will now exit with an exit code of 3 instead of 0,1749,
+Changed,Minor,Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method,1890,
+Changed,null,Overhauled the blog post author feature,1782,
+Changed,Minor,Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article`,1887,
+Changed,null,Added more rich markup data to blog post components,1888,"(Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)"
+Changed,null,The build command now groups together all `InMemoryPage` instances under one progress bar group,1897,
+Changed,null,The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors),1900,
+Changed,null,Improved the media asset transfer build task to have better output,1904,
+Changed,null,Improved how the `MarkdownService` class is accessed by binding it into the service container,1922,
+Changed,Breaking,Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting`,1980,
+Changed,null,Updated default configuration to no longer save previewed pages,1995,
+Changed,null,"The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`)",2012,
+Changed,Breaking,Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets,2013,
+Changed,null,Moved the Vite build step to run before the site build to prevent duplicate media asset transfers,2013,
+Changed,null,Replaced HydeFront styles with Tailwind,2024,
+Changed,null,The full page documentation search now generates its heading using smarter natural language processing based on the configured sidebar header,2032,
+Changed,null,Moved Blade view `hyde::pages.documentation-search` to `hyde::pages.docs.search`,2033,
+Changed,null,"Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks",2036,
+Changed,null,Extracted CSS component partials in HydeFront,2038,
+Changed,null,Colored Markdown blockquotes are now rendered using Blade and TailwindCSS,2056,"This change is not visible in the rendered result, but the HTML output has changed"
+Changed,Breaking,We now support PHP 8.2–8.4 instead of 8.1–8.3,2141,
+Changed,Breaking,We upgraded from the TailwindCSS version from v3 to v4,2146,You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details.
+Changed,Breaking,We switched from using CJS to ESM in the frontend tool scaffolding. If you have custom script includes you need to migrate them. See below and the pull request for details.,2159,
+Changed,null,Renamed the parameter `category` to `group` in the `publish:views` command,2166,
+Changed,Breaking,The navigation system internals have been rewritten into a new Navigation API,1568,"This change is breaking for custom navigation implementations. For more information, see below."
+Changed,Breaking,The `hyde.features` configuration format has changed to use Enums instead of static method calls,1649," For more information, see below."
+Changed,Breaking,Renamed class `DataCollections` to `DataCollection`.,1732," For more information, see below."
+Changed,Breaking,The `hyde.authors` config setting should now be keyed by the usernames.,1782,"For more information, see below."
+Changed,Breaking,The `Author::create()` method now returns an array instead of a `PostAuthor` instance.,1798,"For more information, see below."
+Changed,Breaking,"The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance.",1798," For more information, see below."
+Changed,Breaking,The custom navigation item configuration now uses array inputs instead of the previous format.,1818," For more information, see the upgrade guide below."
+Changed,Breaking,Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display`.,1818,
+Changed,Dependency,Upgraded from Laravel 10 to Laravel 11,2141,
+Changed,Dependency,Updated minimum PHP requirement to 8.2,2141,
+Changed,Dependency,Updated Symfony/yaml to ^7.0,2141,
+Changed,Dependency,Updated illuminate/support and illuminate/view to ^11.0,2141,
+Changed,Dependency,Switched to forked version of the Torchlight client,2141,
+Changed,Minor,"Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)",,
+Changed,null,The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter.,1650,
+Changed,null,"Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task.",1498,
+Changed,null,Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method.,2024,
+Changed,null,Reorganized and cleaned up the navigation and sidebar documentation for improved clarity.,,
+Changed,null,Moved the sidebar documentation to the documentation pages section for better organization.,,
+Fixed,null,Added missing collection key types in Hyde facade method annotations,1784,
+Fixed,null,The `app.js` file will now only be compiled if it has scripts,2028,
+Fixed,null,The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN,2180,
+Removed,null,Internal: Removed the internal `DocumentationSearchPage::generate()` method as it was unused,1569,
+Removed,null,"Removed the deprecated global `unslash()` function, replaced with the namespaced `\Hyde\unslash()` function",1754,
+Removed,null,"Removed the deprecated `BaseUrlNotSetException` class, with the `Hyde::url()` helper now throwing `BadMethodCallException` if no base URL is set",1760,
+Removed,null,Removed: The deprecated `PostAuthor::getName()` method is now removed,1782, (use `$author->name`)
+Removed,null,Removed the deprecated `FeaturedImage::isRemote()` method,1883,Use `Hyperlinks::isRemote()` instead.
+Removed,Breaking,Removed the `DocumentationPage::hasTableOfContents()` method as it is now unused by the framework,2006,
+Removed,null,Removed Laravel Mix as a dependency,2010, (replaced with Vite)
+Removed,null,Removed the `.torchlight-enabled` CSS class,2036,
+Removed,null,Removed The `hyde.css` file from HydeFront  as all styles were refactored to Tailwind,2037,
+Removed,Breaking,Removed the `DocumentationPage::getTableOfContents()` method as we now use Blade to generate the table of contents,2045,
+Removed,null,Removed the `MarkdownService::withPermalinks` method,2047,
+Removed,null,Removed the `MarkdownService::canEnablePermalinks` method,2047,
+Removed,Breaking,Removed support for PHP 8.1,2141,
+Removed,Breaking,Removed `npm run prod` command (replaced with `npm run build`),2010,
+Removed,Breaking,Removed the build task `\Hyde\Framework\Actions\PostBuildTasks\GenerateSearch`,1498,See upgrade guide below
+Removed,Breaking,Removed the deprecated `\Hyde\Framework\Services\BuildService::transferMediaAssets()` method,1536,See upgrade guide below
+Added,null,**Added a new consolidated Asset API to better handle media files.**,2006,"- Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc.PHP_EOL- Added new `HydeFront` facade to handle CDN links and Tailwind config injection.PHP_EOL- Added method `Asset::exists()` to check if a media file exists.PHP_EOL- Added a `Hyde::assets()` method to get all media file instances in the site."
+Added,null,**Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files.,,"- **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it.PHP_EOL- The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class.PHP_EOL- All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior).PHP_EOL- The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist.PHP_EOL- Renamed method `Asset::hasMediaFile` to `Asset::exists` in https://github.com/hydephp/develop/pull/1957PHP_EOL- Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in https://github.com/hydephp/develop/pull/1904PHP_EOL- Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in https://github.com/hydephp/develop/pull/1911PHP_EOL- Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in https://github.com/hydephp/develop/pull/1911PHP_EOL- An exception will now be thrown if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in https://github.com/hydephp/develop/pull/1932PHP_EOL"
+Added,null,**MediaFile performance improvements:**,,"- Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in https://github.com/hydephp/develop/pull/1917PHP_EOL- Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in https://github.com/hydephp/develop/pull/1933PHP_EOL- We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in https://github.com/hydephp/develop/pull/1918"
+Added,null,**Replaced Laravel Mix with Vite for frontend asset compilation**,2010,"- **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`PHP_EOL- Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in https://github.com/hydephp/develop/pull/2011"
+Added,null,Markdown headings are now compiled using our custom Blade-based heading renderer,2047,- The `id` attributes for heading permalinks have been moved from the anchor to the heading element in https://github.com/hydephp/develop/pull/2052
+Added,null,**Improved Routes facade API with more intuitive method names**,2179,- **Breaking:** Renamed `Routes::get()` to `Routes::find()` to better indicate it may return nullPHP_EOL- **Breaking:** Renamed `Routes::getOrFail()` to `Routes::get()` to make the exception-throwing behavior the default and match Laravel conventionsPHP_EOL- This change requires code updates if you were using these methods - see upgrade guide below
+Added,null,**Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation**,2029,- Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in https://github.com/hydephp/develop/pull/2029PHP_EOL- Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in https://github.com/hydephp/develop/pull/2031
+Removed,null,"**With the new Asset API, a few features had to be moved/removed:**",,"- `AssetService` class has been removed (was merged into the `Asset` facade) in https://github.com/hydephp/develop/pull/1908PHP_EOL- Removed HydeFront methods from the `Asset` facade (moved to the new HydeFront facade) in https://github.com/hydephp/develop/pull/1907PHP_EOL- The config options `hyde.hydefront_version` and `hyde.hydefront_cdn_url` have been removed in https://github.com/hydephp/develop/pull/1909 (as changing these could lead to incompatible asset versions, defeating the feature's purpose)PHP_EOL- Removed `Hyde::mediaLink()` method replaced by `Hyde::asset()` in https://github.com/hydephp/develop/pull/1932PHP_EOL- Removed `Hyde::mediaPath()` method replaced by `MediaFile::sourcePath()` in https://github.com/hydephp/develop/pull/1911PHP_EOL- Removed `Hyde::siteMediaPath()` method replaced by `MediaFile::outputPath()` in https://github.com/hydephp/develop/pull/1911"
+Removed,null,**Removed CDN include for the HydeSearch plugin replaced by Alpine.js implementation**,2029,"- This also removes the `<x-hyde::docs.search-input />` and `<x-hyde::docs.search-scripts />` Blade components, replaced by the new `<x-hyde::docs.hyde-search />` component."
\ No newline at end of file
diff --git a/output.md b/output.md
new file mode 100644
index 00000000000..f48e062296c
--- /dev/null
+++ b/output.md
@@ -0,0 +1,127 @@
+### Added
+
+- **Added a new consolidated Asset API to better handle media files.** in [#2006](https://github.com/hydephp/develop/pull/2006)
+    - Added several new fluent methods to the `MediaFile` class, like `getLink()`, `getLength()`, `getMimeType()`, etc
+    - Added new `HydeFront` facade to handle CDN links and Tailwind config injection
+    - Added method `Asset::exists()` to check if a media file exists
+    - Added a `Hyde::assets()` method to get all media file instances in the site
+- **Improved Routes facade API with more intuitive method names** in [#2179](https://github.com/hydephp/develop/pull/2179)
+    - **Breaking:** Renamed `Routes::get()` to `Routes::find()` to better indicate it may return null
+    - **Breaking:** Renamed `Routes::getOrFail()` to `Routes::get()` to make the exception-throwing behavior the default and match Laravel conventions
+    - This change requires code updates if you were using these methods - see upgrade guide below
+- **Many MediaFile related helpers have been changed or completely rewritten** to provide a simplified API for interacting with media files
+    - **Note:** For most end users, the changes will have minimal direct impact, but if you have custom code that interacts with media files, you may need to update it
+    - The `Asset` facade has been restructured to be more scoped and easier to use, splitting out a separate `HydeFront` facade and inlining the `AssetService` class
+    - All asset retrieval methods now return a `MediaFile` instance, which can be fluently interacted with, or cast to a string to get the link (which was the previous behavior)
+    - The `Hyde::asset()` method and `asset()` function now return `MediaFile` instances instead of strings, and will throw an exception if the asset does not exist
+    - Renamed method `Asset::hasMediaFile` to `Asset::exists` in [#1957](https://github.com/hydephp/develop/pull/1957)
+    - Renamed method `MediaFile::getContentLength` to `MediaFile::getLength` in [#1904](https://github.com/hydephp/develop/pull/1904)
+    - Replaced method `Hyde::mediaPath` with `MediaFile::sourcePath` in [#1911](https://github.com/hydephp/develop/pull/1911)
+    - Replaced method `Hyde::siteMediaPath` with `MediaFile::outputPath` in [#1911](https://github.com/hydephp/develop/pull/1911)
+    - An exception will now be thrown if you try to get a media file that does not exist in order to prevent missing assets from going unnoticed in [#1932](https://github.com/hydephp/develop/pull/1932)
+- **MediaFile performance improvements:**
+    - Media assets are now cached in the HydeKernel, giving a massive performance boost and making it easier to access the instances in [#1917](https://github.com/hydephp/develop/pull/1917)
+    - Media file metadata is now lazy loaded and then cached in memory, providing performance improvements for files that may not be used in a build in [#1933](https://github.com/hydephp/develop/pull/1933)
+    - We now use the much faster `CRC32` hashing algorithm instead of `MD5` for cache busting keys in [#1918](https://github.com/hydephp/develop/pull/1918)
+- **Ported the HydeSearch plugin used for the documentation search to be an Alpine.js implementation** in [#2029](https://github.com/hydephp/develop/pull/2029)
+    - Renamed Blade component `hyde::components.docs.search-widget` to `hyde::components.docs.search-modal` in [#2029](https://github.com/hydephp/develop/pull/2029)
+    - Added support for customizing the search implementation by creating a `resources/js/HydeSearch.js` file in [#2031](https://github.com/hydephp/develop/pull/2031)
+- **Replaced Laravel Mix with Vite for frontend asset compilation** in [#2010](https://github.com/hydephp/develop/pull/2010)
+    - **Breaking:** You must now use `npm run build` to compile your assets, instead of `npm run prod`
+    - Bundled assets are now compiled directly into the `_media` folder, and will not be copied to the `_site/media` folder by the NPM command in [#2011](https://github.com/hydephp/develop/pull/2011)
+- Added Vite as a build tool in [#2010](https://github.com/hydephp/develop/pull/2010)
+- Added Vite facade in [#2016](https://github.com/hydephp/develop/pull/2016)
+- Added a Vite HMR support for the realtime compiler in [#2016](https://github.com/hydephp/develop/pull/2016)
+- Added a `Feature::fromName()` enum helper in [#1895](https://github.com/hydephp/develop/pull/1895)
+- Added a custom Blade-based heading renderer for Markdown conversions in [#2047](https://github.com/hydephp/develop/pull/2047)
+- Added a new Hyde Vite plugin in [#2160](https://github.com/hydephp/develop/pull/2160)
+- Added a new `\Hyde\Framework\Actions\PreBuildTasks\TransferMediaAssets` build task to handle media assets transfers for site builds in [#1536](https://github.com/hydephp/develop/pull/1536)
+- Added a new `\Hyde\Framework\Exceptions\InvalidConfigurationException` exception class to handle invalid configuration exceptions in [#1799](https://github.com/hydephp/develop/pull/1799)
+- Added a new `\Hyde\Framework\Exceptions\ParseException` exception class to handle parsing exceptions in data collection files in [#1732](https://github.com/hydephp/develop/pull/1732)
+- Added a new simplified blog post image front matter schema using a new "caption" field in [#2175](https://github.com/hydephp/develop/pull/2175)
+- Added environment variable support for saving previews in [#1996](https://github.com/hydephp/develop/pull/1996)
+- Added new `npm run build` command for compiling frontend assets with Vite in [#2010](https://github.com/hydephp/develop/pull/2010)
+- Added support for PHP 8.4 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- Added support for resolving dynamic links to source files in Markdown documents in [#1590](https://github.com/hydephp/develop/pull/1590)
+- Added support for setting `booting()` and `booted()` callbacks in `HydeExtension` classes, allowing extension developers to hook into the kernel boot process more easily in [#1847](https://github.com/hydephp/develop/pull/1847)
+- Added support for setting custom navigation items in the YAML configuration in [#1818](https://github.com/hydephp/develop/pull/1818)
+- Added support for setting extra attributes for navigation items in [#1824](https://github.com/hydephp/develop/pull/1824)
+- Added support for setting the blog post publishing date as a prefix in the source file name in [#2000](https://github.com/hydephp/develop/pull/2000)
+- Added support for specifying features in the YAML configuration in [#1896](https://github.com/hydephp/develop/pull/1896)
+- Introduced a new navigation config builder class to simplify navigation configuration in [#1827](https://github.com/hydephp/develop/pull/1827)
+- Markdown headings are now compiled using our custom Blade-based heading renderer in [#2047](https://github.com/hydephp/develop/pull/2047) - The `id` attributes for heading permalinks have been moved from the anchor to the heading element in [#2052](https://github.com/hydephp/develop/pull/2052)
+- The `\Hyde\Facades\Features` class is no longer marked as internal, and is now thus part of the public API in [#1647](https://github.com/hydephp/develop/pull/1647)
+- The `publish:views` command is now interactive on Unix-like systems in [#2062](https://github.com/hydephp/develop/pull/2062)
+- You can now add custom posts to the blog post feed component when including it directly in [#1893](https://github.com/hydephp/develop/pull/1893)
+- You can now specify sidebar item priorities by adding a numeric prefix to documentation page source file names in [#1709](https://github.com/hydephp/develop/pull/1709)
+
+### Changed
+
+- **Breaking:** Renamed class `DataCollections` to `DataCollection` in [#1732](https://github.com/hydephp/develop/pull/1732)  For more information, see below.
+- **Breaking:** Renamed the `hyde.enable_cache_busting` configuration option to `hyde.cache_busting` in [#1980](https://github.com/hydephp/develop/pull/1980)
+- **Breaking:** Renamed the `hyde.navigation.subdirectories` configuration option to `hyde.navigation.subdirectory_display` in [#1818](https://github.com/hydephp/develop/pull/1818)
+- **Breaking:** Replaced `--run-dev` and `--run-prod` build command flags with a single `--run-vite` flag that uses Vite to build assets in [#2013](https://github.com/hydephp/develop/pull/2013)
+- **Breaking:** The `Author::create()` method now returns an array instead of a `PostAuthor` instance in [#1798](https://github.com/hydephp/develop/pull/1798) For more information, see below.
+- **Breaking:** The `Author::get()` method now returns `null` if an author is not found, rather than creating a new instance in [#1798](https://github.com/hydephp/develop/pull/1798)  For more information, see below.
+- **Breaking:** The `hyde.authors` config setting should now be keyed by the usernames in [#1782](https://github.com/hydephp/develop/pull/1782) For more information, see below.
+- **Breaking:** The `hyde.features` configuration format has changed to use Enums instead of static method calls in [#1649](https://github.com/hydephp/develop/pull/1649)  For more information, see below.
+- **Breaking:** The custom navigation item configuration now uses array inputs instead of the previous format in [#1818](https://github.com/hydephp/develop/pull/1818)  For more information, see the upgrade guide below.
+- **Breaking:** The navigation system internals have been rewritten into a new Navigation API in [#1568](https://github.com/hydephp/develop/pull/1568) This change is breaking for custom navigation implementations. For more information, see below.
+- **Breaking:** We now support PHP 8.2–8.4 instead of 8.1–8.3 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Breaking:** We switched from using CJS to ESM in the frontend tool scaffolding. If you have custom script includes you need to migrate them. See below and the pull request for details in [#2159](https://github.com/hydephp/develop/pull/2159)
+- **Breaking:** We upgraded from the TailwindCSS version from v3 to v4 in [#2146](https://github.com/hydephp/develop/pull/2146) You may want to run `npx @tailwindcss/upgrade` in your project if you have custom Tailwind classes in your project. See the information below for details.
+- **Dependency:** Switched to forked version of the Torchlight client in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated Symfony/yaml to ^7.0 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated illuminate/support and illuminate/view to ^11.0 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Updated minimum PHP requirement to 8.2 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Dependency:** Upgraded from Laravel 10 to Laravel 11 in [#2141](https://github.com/hydephp/develop/pull/2141)
+- **Medium:** The `route` function will now throw a `RouteNotFoundException` if the route does not exist in [#1741](https://github.com/hydephp/develop/pull/1741)
+- **Minor:** Changed the default build task message to make it more concise in [#1659](https://github.com/hydephp/develop/pull/1659)
+- **Minor:** Data collection files are now validated for syntax errors during discovery in [#1732](https://github.com/hydephp/develop/pull/1732)
+- **Minor:** Due to changes in the navigation system, it is possible that existing configuration files will need to be adjusted in order for menus to look the same (in terms of ordering etc.)
+- **Minor:** Methods in the `Includes` facade now return `HtmlString` objects instead of `string` in [#1738](https://github.com/hydephp/develop/pull/1738) For more information, see below.
+- **Minor:** Navigation menu items are now no longer filtered by duplicates (meaning two items with the same label can now exist in the same menu) in [#1573](https://github.com/hydephp/develop/pull/1573)
+- **Minor:** The `processing_time_ms` attribute in the `sitemap.xml` file has now been removed in [#1744](https://github.com/hydephp/develop/pull/1744)
+- **Minor:** The documentation article component now supports disabling the semantic rendering using a falsy value in [#1566](https://github.com/hydephp/develop/pull/1566)
+- **Minor:** Updated the `Hyde::url()` helper throw a `BadMethodCallException` instead `BaseUrlNotSetException` when no site URL is set and no path was provided to the method in [#1890](https://github.com/hydephp/develop/pull/1890)
+- **Minor:** Updated the blog post layout and post feed component to use the `BlogPosting` Schema.org type instead of `Article` in [#1887](https://github.com/hydephp/develop/pull/1887)
+- **Minor:** `Includes::path()` and `Includes::get()` methods now normalize paths to be basenames to match the behavior of the other include methods in [#1738](https://github.com/hydephp/develop/pull/1738) This means that nested directories are no longer supported, as you should use a data collection for these
+- Added more rich markup data to blog post components in [#1888](https://github.com/hydephp/develop/pull/1888) (Note that this inevitably changes the HTML output of the blog post components, and that any customized templates will need to be republished to reflect these changes)
+- Calling the `DataCollection` methods will no longer create the data collections directory in [#1732](https://github.com/hydephp/develop/pull/1732)
+- Calling the `Include::path()` method will no longer create the includes directory in [#1707](https://github.com/hydephp/develop/pull/1707)
+- Changed how the documentation search is generated, to be an `InMemoryPage` instead of a post-build task in [#1498](https://github.com/hydephp/develop/pull/1498)
+- Colored Markdown blockquotes are now rendered using Blade and TailwindCSS in [#2056](https://github.com/hydephp/develop/pull/2056) This change is not visible in the rendered result, but the HTML output has changed
+- Extracted CSS component partials in HydeFront in [#2038](https://github.com/hydephp/develop/pull/2038)
+- Improved how the `MarkdownService` class is accessed by binding it into the service container in [#1922](https://github.com/hydephp/develop/pull/1922)
+- Improved the media asset transfer build task to have better output in [#1904](https://github.com/hydephp/develop/pull/1904)
+- Improved the sitemap data generation to be smarter and more dynamic in [#1744](https://github.com/hydephp/develop/pull/1744)
+- Markdown includes are now converted to HTML using the custom HydePHP Markdown service, meaning they now support full GFM spec and custom Hyde features like colored blockquotes and code block filepath labels in [#1738](https://github.com/hydephp/develop/pull/1738)
+- Markdown returned from includes are now trimmed of trailing whitespace and newlines in [#1738](https://github.com/hydephp/develop/pull/1738)
+- Media asset files are now copied using the new build task instead of the deprecated `BuildService::transferMediaAssets()` method in [#2024](https://github.com/hydephp/develop/pull/2024)
+- Moved Blade view `hyde::pages.documentation-search` to `hyde::pages.docs.search` in [#2033](https://github.com/hydephp/develop/pull/2033)
+- Moved the Vite build step to run before the site build to prevent duplicate media asset transfers in [#2013](https://github.com/hydephp/develop/pull/2013)
+- Moved the sidebar documentation to the documentation pages section for better organization
+- Normalized default Tailwind Typography Prose code block styles to match Torchlight's theme, ensuring consistent styling across Markdown and Torchlight code blocks in [#2036](https://github.com/hydephp/develop/pull/2036)
+- Overhauled the blog post author feature in [#1782](https://github.com/hydephp/develop/pull/1782)
+- Renamed the parameter `category` to `group` in the `publish:views` command in [#2166](https://github.com/hydephp/develop/pull/2166)
+- Reorganized and cleaned up the navigation and sidebar documentation for improved clarity
+- Replaced HydeFront styles with Tailwind in [#2024](https://github.com/hydephp/develop/pull/2024)
+- Skipped build tasks will now exit with an exit code of 3 instead of 0 in [#1749](https://github.com/hydephp/develop/pull/1749)
+- The `Markdown::render()` method will now always render Markdown using the custom HydePHP Markdown service (thus getting smart features like our Markdown processors) in [#1900](https://github.com/hydephp/develop/pull/1900)
+- The `hasFeature` method on the Hyde facade and HydeKernel now only accepts a Feature enum value instead of a string for its parameter in [#1650](https://github.com/hydephp/develop/pull/1650)
+- The build command now groups together all `InMemoryPage` instances under one progress bar group in [#1897](https://github.com/hydephp/develop/pull/1897)
+- The full page documentation search now generates its heading using smarter natural language processing based on the configured sidebar header in [#2032](https://github.com/hydephp/develop/pull/2032)
+- The realtime compiler now only serves assets from the media source directory (`_media`), and no longer checks the site output directory (`_site/media`) in [#2012](https://github.com/hydephp/develop/pull/2012)
+- Updated default configuration to no longer save previewed pages in [#1995](https://github.com/hydephp/develop/pull/1995)
+
+### Fixed
+
+- Added missing collection key types in Hyde facade method annotations in [#1784](https://github.com/hydephp/develop/pull/1784)
+- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in [#2180](https://github.com/hydephp/develop/pull/2180)
+- The `app.js` file will now only be compiled if it has scripts in [#2028](https://github.com/hydephp/develop/pull/2028)
+
+### Removed
+
+- Added missing collection key types in Hyde facade method annotations in [#1784](https://github.com/hydephp/develop/pull/1784)
+- The `app.css` file will no longer be copied to the media output directory when app styles are configured to be loaded from a CDN in [#2180](https://github.com/hydephp/develop/pull/2180)
+- The `app.js` file will now only be compiled if it has scripts in [#2028](https://github.com/hydephp/develop/pull/2028)
diff --git a/parse.php b/parse.php
new file mode 100644
index 00000000000..f7daf74c78a
--- /dev/null
+++ b/parse.php
@@ -0,0 +1,128 @@
+<?php
+
+/**
+ * CSV Parser for Changelog
+ * Parses input.csv into a structured Markdown file with categories and headings.
+ */
+
+// Function to format details and handle PHP_EOL strings
+function formatDetails(string $details): string
+{
+    if (empty($details)) {
+        return '';
+    }
+
+    // Convert GitHub PR URLs to markdown links
+    $pattern = '~https://github\.com/hydephp/develop/pull/(\d+)~';
+    $details = preg_replace($pattern, '[#$1](https://github.com/hydephp/develop/pull/$1)', $details);
+
+    if (strpos($details, 'PHP_EOL') !== false) {
+        $items = explode('PHP_EOL', $details);
+        $formatted = "\n";
+        foreach ($items as $item) {
+            $item = trim($item);
+            $item = trim($item, '. ');
+            if (! empty($item)) {
+                $formatted .= '    '.$item."\n";
+            }
+        }
+
+        return rtrim($formatted);
+    }
+
+    return ' '.$details;
+}
+
+// Read CSV file
+$file = fopen('input.csv', 'r');
+if (! $file) {
+    exit('Unable to open input.csv');
+}
+
+// Skip header row
+$header = fgetcsv($file);
+
+// Define status priority for sorting
+$statusPriority = [
+    'Breaking' => 1,
+    'Dependency' => 2,
+    'Medium' => 3,
+    'Minor' => 4,
+    'Other' => 5,
+];
+
+// Initialize data structure by type and status
+$data = [];
+
+// Parse CSV data
+while (($row = fgetcsv($file)) !== false) {
+    if (count($row) < 5) {
+        continue;
+    } // Skip invalid rows
+
+    [$type, $status, $description, $pr, $details] = $row;
+
+    if (! isset($data[$type])) {
+        $data[$type] = [];
+    }
+
+    // If status is null, don't include a status prefix
+    $statusKey = ($status !== 'null') ? $status : '';
+
+    if (! isset($data[$type][$statusKey])) {
+        $data[$type][$statusKey] = [];
+    }
+
+    $data[$type][$statusKey][] = [
+        'description' => $description,
+        'pr' => $pr,
+        'details' => $details,
+    ];
+}
+fclose($file);
+
+// Sort entries within each category alphabetically
+foreach ($data as $type => &$statuses) {
+    foreach ($statuses as &$items) {
+        usort($items, function ($a, $b) {
+            return strcmp($a['description'], $b['description']);
+        });
+    }
+}
+
+// Generate Markdown output
+$output = '';
+
+// Process each category
+foreach ($data as $type => $statuses) {
+    $output .= "### {$type}\n\n";
+
+    // Get all status keys
+    $statusKeys = array_keys($statuses);
+
+    // Sort status keys by priority
+    usort($statusKeys, function ($a, $b) use ($statusPriority) {
+        $aPriority = $statusPriority[$a] ?? 999;
+        $bPriority = $statusPriority[$b] ?? 999;
+
+        return $aPriority - $bPriority;
+    });
+
+    // Process all items with their status prefix
+    foreach ($statusKeys as $status) {
+        foreach ($statuses[$status] as $item) {
+            $details = formatDetails($item['details']);
+            $statusPrefix = ! empty($status) ? "**{$status}:** " : '';
+            $prSuffix = ! empty($item['pr']) ? " in [#{$item['pr']}](https://github.com/hydephp/develop/pull/{$item['pr']})" : '';
+
+            $description = trim($item['description'], '. ');
+            $output .= "- {$statusPrefix}$description{$prSuffix}{$details}\n";
+        }
+    }
+
+    $output .= "\n";
+}
+
+// Write to output file
+file_put_contents('output.md', trim($output)."\n");
+echo "Successfully created output.md\n";